tool(B-0171): map agentic-organization OpenSpec artifacts#6207
Merged
AceHack merged 3 commits intoMay 31, 2026
Conversation
Scope: map the existing agentic-organization OpenSpec capability in the inventory for B-0171.\n\nAgency-Signature-Version: 1\nAgent: Vera\nAgent-Runtime: OpenAI Codex desktop heartbeat loop\nAgent-Model: GPT-5\nCredential-Identity: aaron-codex-desktop\nCredential-Mode: shared\nHuman-Review: none\nHuman-Review-Evidence: none\nAction-Mode: autonomous-fail-open\nTask: B-0171\nCo-Authored-By: Codex <noreply@openai.com>
Why: - B-0171's current inventory checkpoint still had one mapped-spec gap: agentic-organization had an OpenSpec capability but no concrete module or artifact mapping. - The strict unmapped-spec gate should be able to validate that existing spec against repo substrate. What: - Map agentic-organization to representative source, test, package, and documentation artifacts in the OpenSpec inventory. - Add mapping-table and real-repo regression coverage. - Update the B-0171 checkpoint with the new measured inventory counts and release the claim file. Proof: - bun test tools/openspec/inventory.test.ts - bun tools/openspec/inventory.ts --enforce --fail-on-unmapped-specs - bun run typecheck - git diff --check - bunx prettier --check tools/openspec/inventory.ts tools/openspec/inventory.test.ts docs/backlog/P1/B-0171-openspec-catch-up-canonical-source-of-truth-aaron-2026-05-03.md Limits: - This does not close B-0171; 64 Core modules remain uncovered and the next slices should continue artifact/capability mapping or child-row reconciliation. - PR #6200 remains separate and blocked on another dirty worktree. Agency-Signature-Version: 1 Agent: Vera Agent-Runtime: OpenAI Codex desktop heartbeat loop Agent-Model: GPT-5 Credential-Identity: aaron-codex-desktop Credential-Mode: shared Human-Review: none Human-Review-Evidence: none Action-Mode: autonomous-fail-open Task: B-0171 Co-Authored-By: Codex <noreply@openai.com>
There was a problem hiding this comment.
Pull request overview
This PR maps the agentic-organization OpenSpec capability to concrete repository artifacts so the OpenSpec inventory can account for non-Core implementation/documentation coverage.
Changes:
- Adds
agentic-organizationto the OpenSpec artifact mapping table. - Adds regression coverage for the new mapping and real-repo scan behavior.
- Updates the B-0171 backlog checkpoint to reflect the expanded artifact mapping.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
tools/openspec/inventory.ts |
Adds 12 agentic-organization package, source, test, and documentation artifacts to the capability artifact map. |
tools/openspec/inventory.test.ts |
Locks the new artifact list and verifies the real spec is artifact-mapped with no missing mapped artifacts. |
docs/backlog/P1/B-0171-openspec-catch-up-canonical-source-of-truth-aaron-2026-05-03.md |
Updates the B-0171 checkpoint counts and artifact coverage narrative. |
Why: - Copilot review flagged `openspec/specs/retraction-native/` as a possible unmapped capability. - The inventory scanner only treats directories with `spec.md` as strict spec inputs; `retraction-native` currently has only `README.md`. What: - Add a real-repo regression that README-only capability directories are not strict unmapped-spec inputs. - Clarify the B-0171 checkpoint wording so the 9-spec count means directories with `spec.md` files. Proof: - bun test tools/openspec/inventory.test.ts - bun tools/openspec/inventory.ts --enforce --fail-on-unmapped-specs - bun run typecheck - git diff --check - bunx prettier --check tools/openspec/inventory.test.ts docs/backlog/P1/B-0171-openspec-catch-up-canonical-source-of-truth-aaron-2026-05-03.md Agency-Signature-Version: 1 Agent: Vera Agent-Runtime: OpenAI Codex desktop heartbeat loop Agent-Model: GPT-5 Credential-Identity: aaron-codex-desktop Credential-Mode: shared Human-Review: copilot-pull-request-reviewer comment Human-Review-Evidence: #6207 (comment) Action-Mode: autonomous-fail-open Task: B-0171 Co-Authored-By: Codex <noreply@openai.com>
AceHack
deleted the
claim/codex-loop-b0171-agentic-org-artifact-map-20260531
branch
AceHack
added a commit
that referenced
this pull request
May 31, 2026
* claim: codex-loop-b0171-3-spec-path-20260531 Why: - B-0171.3 has a narrow row-level correction available after #6207 clarified that strict OpenSpec inventory reads only `spec.md` files. - The claim needs to be visible before editing the row. Scope: - docs/backlog/P1/B-0171.3-author-retraction-native-spec.md - docs/claims/codex-loop-b0171-3-spec-path-20260531.md Agency-Signature-Version: 1 Agent: Vera Agent-Runtime: OpenAI Codex desktop heartbeat loop Agent-Model: GPT-5 Credential-Identity: aaron-codex-desktop Credential-Mode: shared Human-Review: none Human-Review-Evidence: none Action-Mode: autonomous-fail-open Task: B-0171.3 Co-Authored-By: Codex <noreply@openai.com> * docs(B-0171.3): target retraction-native spec.md Why: - B-0171.3 still pointed acceptance at `openspec/specs/retraction-native/README.md`. - The current OpenSpec inventory gate discovers capability specs only at `<capability>/spec.md`, so the child row should not direct implementation to a README-only artifact. What: - Update B-0171.3 acceptance criteria to require `openspec/specs/retraction-native/spec.md`. - Note that the existing README can remain background material but is not inventory-discovered. - Release the claim file in the same PR branch. Proof: - bun tools/openspec/inventory.ts --enforce --fail-on-unmapped-specs - git diff --check - bunx prettier --check docs/backlog/P1/B-0171.3-author-retraction-native-spec.md Agency-Signature-Version: 1 Agent: Vera Agent-Runtime: OpenAI Codex desktop heartbeat loop Agent-Model: GPT-5 Credential-Identity: aaron-codex-desktop Credential-Mode: shared Human-Review: none Human-Review-Evidence: none Action-Mode: autonomous-fail-open Task: B-0171.3 Co-Authored-By: Codex <noreply@openai.com> * docs(B-0171.3): require retraction-native inventory mapping Why: - Codex review correctly noted that adding `openspec/specs/retraction-native/spec.md` without an inventory map entry would make the strict unmapped-spec gate fail. - B-0171.3 acceptance criteria should preserve the inventory invariant for the implementer. What: - Require `retraction-native` to be mapped in `CAPABILITY_MODULE_MAP` or `CAPABILITY_ARTIFACT_MAP` when the spec is authored. - Keep the strict inventory gate command in the acceptance criterion. Proof: - bun tools/openspec/inventory.ts --enforce --fail-on-unmapped-specs - git diff --check - bunx prettier --check docs/backlog/P1/B-0171.3-author-retraction-native-spec.md Agency-Signature-Version: 1 Agent: Vera Agent-Runtime: OpenAI Codex desktop heartbeat loop Agent-Model: GPT-5 Credential-Identity: aaron-codex-desktop Credential-Mode: shared Human-Review: chatgpt-codex-connector review comment Human-Review-Evidence: #6208 (comment) Action-Mode: autonomous-fail-open Task: B-0171.3 Co-Authored-By: Codex <noreply@openai.com> --------- Co-authored-by: Lior <lior@zeta.dev> Co-authored-by: Codex <noreply@openai.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
agentic-organizationOpenSpec to concrete source, test, package, and documentation artifactsWhy
B-0171's current checkpoint named
agentic-organizationas the remaining unmapped OpenSpec capability. This slice makes the inventory strict unmapped-spec gate pass while keeping Core module coverage unchanged.Checks
bun test tools/openspec/inventory.test.tsbun tools/openspec/inventory.ts --enforce --fail-on-unmapped-specsbun run typecheckgit diff --checkbunx prettier --check tools/openspec/inventory.ts tools/openspec/inventory.test.ts docs/backlog/P1/B-0171-openspec-catch-up-canonical-source-of-truth-aaron-2026-05-03.mdLimits