Skip to content

feat: add exhaustive Factory feature verification#86

Merged
miyaontherelay merged 2 commits into
mainfrom
feat/feature-manifest-verify
Jul 17, 2026
Merged

feat: add exhaustive Factory feature verification#86
miyaontherelay merged 2 commits into
mainfrom
feat/feature-manifest-verify

Conversation

@kjgbot

@kjgbot kjgbot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • catalog 238 Factory features across 19 categories with exact source locations and tiered verification procedures
  • document critical end-to-end paths and add an hourly feature guardian that validates catalog totals before cycling checks
  • add an executable verification workflow with deterministic package/config gates, optional provider/fleet/cloud tiers, and explicit manual live checks
  • make missing or malformed tier results fail closed; a deterministic missing-T1 regression prevents NOT_RUN from being certified as PASS

Final-main coverage

Validation

  • verification workflow: 10/10 steps passed; T1/T2 passed, opt-in live tiers explicitly skipped, T6 explicitly manual
  • focused retained-regression matrix: 10 files, 503/503 passed
  • full npm test: 39 files, 812/812 passed
  • npm run build
  • npm pack --dry-run --json: 266 files with required root/types/bin artifacts
  • git diff --check
  • manifest contract: 19 categories, 238 unique features, exact tier counts, every location exists, every feature appears in the correct procedure tier

Independent audit

  • frozen commit: 7c06cc9
  • base: 321c623
  • binary diff SHA-256: 7f91f08da1fccf868008aceb510ecb420f721e5c4d3bc509db8da0c13fbd665d
  • first audit found the NOT_RUN false-positive; it was fixed and fully revalidated
  • final exact-delta Codex shadow audit: explicit SIGN-OFF, no findings

@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@miyaontherelay, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 27 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: af6360c7-495b-4542-a965-f82524d24aea

📥 Commits

Reviewing files that changed from the base of the PR and between 7c06cc9 and c194abc.

📒 Files selected for processing (2)
  • .agentworkforce/agents/factory-feature-guardian/agent.ts
  • workflows/verify-features.ts
📝 Walkthrough

Walkthrough

Adds a checked-in Factory feature catalog, tiered verification documentation, an hourly Slack feature guardian with persisted progress, and a workflow that runs deterministic and optional live verification tiers with aggregated results.

Changes

Factory verification

Layer / File(s) Summary
Feature catalog and verification procedures
.agentworkforce/features/manifest.yaml, .agentworkforce/features/verify/procedures.md
Defines categorized feature metadata, verification tiers, coverage mappings, and commands for package through manual live checks.
Critical execution paths
.agentworkforce/features/critical-paths.md
Documents nine end-to-end paths covering discovery, dispatch, PR handling, lifecycle operations, human clarification, recovery, and fleet placement.
Scheduled feature guardian
.agentworkforce/agents/factory-feature-guardian/*, .gitignore
Validates the manifest, selects unchecked features by priority, generates Slack checks, persists cycle progress, and excludes local relay artifacts.
Automated verification workflow
workflows/verify-features.ts
Runs deterministic package and fixture checks, optional provider/fleet/cloud tiers, manual guidance, result aggregation, and reporting.

Estimated code review effort: 5 (Critical) | ~90+ minutes

Sequence Diagram(s)

sequenceDiagram
  participant Scheduler
  participant GuardianHandler
  participant ManifestLoader
  participant WorkspaceMemory
  participant Slack
  Scheduler->>GuardianHandler: invoke hourly handler
  GuardianHandler->>ManifestLoader: load and validate manifest
  GuardianHandler->>WorkspaceMemory: read checked feature progress
  GuardianHandler->>Slack: post selected feature check
  GuardianHandler->>WorkspaceMemory: persist updated cycle progress
Loading

Poem

A rabbit checks the feature trail,
With Slack messages in a tidy rail.
Tiers bloom bright, reports align,
Memory marks each checked design.
Hop, hop—verification’s fine!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: adding exhaustive Factory feature verification.
Description check ✅ Passed The description directly matches the added catalog, guardian, workflow, and validation changes.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/feature-manifest-verify

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.

Catalog Factory's full CLI, orchestration, integration, API, and configuration surface; document critical paths and tiered procedures; and add proactive guardian and deterministic verification workflows.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@miyaontherelay
miyaontherelay force-pushed the feat/feature-manifest-verify branch from 8029f30 to 7c06cc9 Compare July 17, 2026 10:35
@miyaontherelay

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@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: 4

🤖 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-feature-guardian/agent.ts:
- Around line 79-100: Clear the inherited categoryCriticality state at each
category heading in the guardian parser before processing the heading’s
criticality, so a missing value is rejected instead of reusing the previous
category’s value. Also update workflows/verify-features.ts lines 137-159 to
validate every category criticality against critical, hot, or standard,
preserving the existing manifest validation flow.
- Around line 286-299: Update the fallback message in the LLM completion catch
block to include feature.location alongside featureSurface(feature), preserving
the guardian’s exact source-surface information while leaving the existing
fallback structure unchanged.

In `@workflows/verify-features.ts`:
- Around line 424-464: Make the tier parsing in the verification collector fail
closed: when processing tier N, only accept an exact final marker for that same
tier with no suffix (for example, TIER1_PASS), and classify mismatched or
malformed markers such as TIER2_PASS or TIER1_PASS_EXTRA as UNKNOWN with FAIL=1.
Update the NOT_RUN self-test invocation to pass zero so it verifies
overall_result’s grep guard rather than being unconditionally failed by the
supplied fail_count.
- Around line 476-496: Update the workflow completion handling after wf.run() so
a report command that exits nonzero propagates failure to the process exit code.
Either enable failure propagation on the report step or inspect the returned
WorkflowRunRow and throw when its status is not completed, while preserving
successful completion behavior.
🪄 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: af119005-7d2c-4647-814b-c70d2ff9a9d5

📥 Commits

Reviewing files that changed from the base of the PR and between 321c623 and 7c06cc9.

📒 Files selected for processing (7)
  • .agentworkforce/agents/factory-feature-guardian/agent.ts
  • .agentworkforce/agents/factory-feature-guardian/persona.json
  • .agentworkforce/features/critical-paths.md
  • .agentworkforce/features/manifest.yaml
  • .agentworkforce/features/verify/procedures.md
  • .gitignore
  • workflows/verify-features.ts

Comment thread .agentworkforce/agents/factory-feature-guardian/agent.ts
Comment thread .agentworkforce/agents/factory-feature-guardian/agent.ts
Comment thread workflows/verify-features.ts
Comment thread workflows/verify-features.ts
@miyaontherelay
miyaontherelay merged commit 96ada2f into main Jul 17, 2026
3 checks passed
@miyaontherelay
miyaontherelay deleted the feat/feature-manifest-verify branch July 17, 2026 11:12
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.

2 participants