Skip to content

Add Factory historian PR reviewer#193

Merged
khaliqgant merged 1 commit into
mainfrom
factory/180-agentworkforce-factory-f881b5ef
Jul 22, 2026
Merged

Add Factory historian PR reviewer#193
khaliqgant merged 1 commit into
mainfrom
factory/180-agentworkforce-factory-f881b5ef

Conversation

@kjgbot

@kjgbot kjgbot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

  • port the maintainability historian reviewer from HoopSheet into Factory using @agentworkforce/review-kit
  • add a repository-scoped, read-only deployment persona with full-history evidence and once-per-PR-revision triggers
  • add Factory's maintainability charter, compiled persona contract tests, feature-manifest registration, verification procedure, and documentation

Why

Factory's control-plane invariants are distributed across durable lifecycle code, provider boundaries, focused tests, the feature catalog, and the git history that established them. This reviewer gives each non-draft Factory PR a bounded maintainability review that recovers that history without editing or merging the checkout.

Validation

  • npx vitest run .agentworkforce/agents/factory-maintainability/persona.test.ts .agentworkforce/agents/factory-feature-guardian/manifest-contract.test.ts — 10 tests passed
  • npm run featuremap:check — 25 categories / 301 features, no advisories
  • npm run build
  • npm test — 166 suites and 1,321 tests passed

Closes #180.

@gemini-code-assist

Copy link
Copy Markdown

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@kjgbot kjgbot mentioned this pull request Jul 22, 2026
@coderabbitai

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Adds a repository-scoped maintainability historian reviewer with full-history evidence, read-only GitHub issue-tree delivery, charter guidance, manifest registration, verification procedures, contract tests, and README documentation.

Changes

Maintainability reviewer

Layer / File(s) Summary
Persona and review charter
.agentworkforce/agents/factory-maintainability/agent.ts, .agentworkforce/agents/factory-maintainability/persona.ts, .agentworkforce/workforce/personas/maintainability.md
Defines the maintainability agent, Claude-backed persona, full git-history access, read-only review behavior, and bounded historian charter.
Event and delivery contracts
.agentworkforce/agents/factory-maintainability/persona.json, .agentworkforce/agents/factory-maintainability/persona.test.ts, .agentworkforce/features/verify/procedures.md
Configures Factory PR triggers, issue-tree relayfile scope, disabled writeback, concurrency, idempotent delivery, and deterministic contract/deployed checks.
Feature registration and repository coverage
.agentworkforce/features/manifest.yaml, .agentworkforce/agents/factory-feature-guardian/manifest-contract.test.ts, README.md, package.json
Registers the review feature and verification category, updates catalog counts and coverage checks, documents the persona, and reorders unchanged dependency entries.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant FactoryPR
  participant MaintainabilityPersona
  participant ReviewKit
  participant GitHubIssueTree
  FactoryPR->>MaintainabilityPersona: opened or synchronized PR event
  MaintainabilityPersona->>ReviewKit: provide PR diff and full git history
  ReviewKit->>GitHubIssueTree: deliver bounded advisory review
  GitHubIssueTree-->>MaintainabilityPersona: retain one review for each head revision
Loading

Possibly related PRs

Suggested reviewers: khaliqgant

Poem

I’m a rabbit historian, ears held high,
I trace old commits as the changes pass by.
No edits, no merging, just notes in the tree,
One review per revision, carefully.
Hop hop—maintainability!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning package.json only reorders dependency entries, which is unrelated to adding the reviewer and its supporting assets. Remove unrelated package.json reordering unless it is required for the reviewer change, or explain it in the issue scope.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the addition of a Factory historian PR reviewer.
Description check ✅ Passed The description matches the change set and describes the new Factory maintainability reviewer and its supporting files.
Linked Issues check ✅ Passed The PR fulfills #180 by adding a Factory-scoped historian reviewer and related persona, tests, manifest, and docs.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch factory/180-agentworkforce-factory-f881b5ef

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.agentworkforce/agents/factory-maintainability/persona.test.ts:
- Around line 105-107: Extend the charter assertions in the persona test to
verify the bounded-output contract: require the verdict-first template, the
four-finding limit, and the 150-word maximum. Keep the existing title,
catalog-link, and “HoopSheet” assertions unchanged, and match the contract’s
established wording or patterns.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a3e59d14-495c-4c3b-a490-bd1f3638e828

📥 Commits

Reviewing files that changed from the base of the PR and between 2079ae0 and 806dac0.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (10)
  • .agentworkforce/agents/factory-feature-guardian/manifest-contract.test.ts
  • .agentworkforce/agents/factory-maintainability/agent.ts
  • .agentworkforce/agents/factory-maintainability/persona.json
  • .agentworkforce/agents/factory-maintainability/persona.test.ts
  • .agentworkforce/agents/factory-maintainability/persona.ts
  • .agentworkforce/features/manifest.yaml
  • .agentworkforce/features/verify/procedures.md
  • .agentworkforce/workforce/personas/maintainability.md
  • README.md
  • package.json

Comment on lines +105 to +107
expect(charter).toContain('# The Factory Maintainability Charter');
expect(charter).toContain('.agentworkforce/features/critical-paths.md');
expect(charter).not.toContain('HoopSheet');

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟠 Major | ⚡ Quick win

Cover the charter’s bounded output contract.

The verification procedure requires the verdict-first, 150-word, four-finding contract, but this test only checks the title, catalog link, and absence of “HoopSheet.” Add assertions for the required verdict template and bounded-output rules.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.agentworkforce/agents/factory-maintainability/persona.test.ts around lines
105 - 107, Extend the charter assertions in the persona test to verify the
bounded-output contract: require the verdict-first template, the four-finding
limit, and the 150-word maximum. Keep the existing title, catalog-link, and
“HoopSheet” assertions unchanged, and match the contract’s established wording
or patterns.

@khaliqgant
khaliqgant merged commit ffd7146 into main Jul 22, 2026
7 checks passed
@khaliqgant
khaliqgant deleted the factory/180-agentworkforce-factory-f881b5ef branch July 22, 2026 14:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add historian pr reviewer

2 participants