Skip to content

feat(claude): record agents-component parity evidence under G5 gate #346

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ScriptedAlchemy merged 1 commit into from
Sep 3, 2026
Merged

feat(claude): record agents-component parity evidence under G5 gate #346

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/quiet-agents-evidence.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"agent-bundle": patch
---

Record Claude plugin-agent capability and native validation evidence while keeping agents directory emission deliberately deferred by the G5 gate.
125 changes: 125 additions & 0 deletions packages/agent-bundle/src/adapters/capabilities/claude-2.1.250.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,131 @@
},
"observedCliVersion": "2.1.250",
"plugin": {
"agents": {

@chatgpt-codex-connector chatgpt-codex-connector Bot Sep 3, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Reconcile the added agent row with existing provenance

Adding plugin.agents makes the capability table internally contradictory: the pre-existing provenance entry at claude-2.1.250.json:553 still states that no agents capability row will be published until the component is admitted, while this change publishes fifteen such rows without admitting it. Consumers auditing the pinned evidence cannot determine whether the gate prohibits only emission or also capability rows, so update that provenance statement to reflect the new unavailable-row policy.

Useful? React with 👍 / 👎.

@ScriptedAlchemy ScriptedAlchemy Sep 3, 2026

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Fixed on main in #364 (merge 305161a).

"component": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers Agent Bundle's authored plugin agents/ component until a separate evidence-backed increment.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/plugins-reference documents plugin agents as Markdown files in the plugin-root agents/ directory, recursively scanned and registered under plugin-scoped identifiers.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 record the #100 stage-2 G5 narrowing: re-admitting agents requires its own evidence-backed increment, so this compiler emits no agents/ directory."
]
},
"name": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent name field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents name as the agent identifier using lowercase letters and hyphens, while https://code.claude.com/docs/en/plugins-reference documents that a plugin agent without name falls back to its filename.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"description": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent description field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents description as the delegation signal that tells Claude when to invoke the subagent.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"model": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent model field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents model as sonnet, opus, haiku, fable, a full model ID, or inherit, with host model-order selection when omitted.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"effort": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent effort field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents effort as a per-agent override of the session effort level with low, medium, high, xhigh, and max values subject to model availability.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"maxTurns": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent maxTurns field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents maxTurns as the maximum agentic turns before the subagent stops and returns partial output that can be resumed.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"tools": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent tools field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents tools as an allowlist, with all tools available to subagents inherited when the field is omitted.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"disallowedTools": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent disallowedTools field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents disallowedTools as a denylist removed from the inherited or explicitly selected tool pool.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"skills": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent skills field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents skills as startup preloads whose full content is injected into the subagent context without preventing invocation of other discoverable skills.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"memory": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent memory field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents memory as persistent cross-session learning scoped to user, project, or local storage.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"background": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent background field together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/sub-agents documents background: true as forcing the subagent to remain in the background even when Claude requests a foreground run.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"isolationWorktree": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds authored plugin-agent isolation: worktree together with agents/ emission.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/plugins-reference documents worktree as the only valid isolation value for plugin agents, and https://code.claude.com/docs/en/sub-agents documents that it runs the subagent in a temporary isolated git worktree.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep every authored plugin-agent field behind the #100 stage-2 G5 re-admission increment."
]
},
"hooks": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers the plugin-agent surface on which Agent Bundle would omit hooks under the host security contract.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/plugins-reference and https://code.claude.com/docs/en/sub-agents document that hooks is unsupported and ignored when an agent is loaded from a plugin.",
"retrieved 2026-09-02: local Claude Code 2.1.257 `claude plugin validate --strict` accepts a plugin agent declaring hooks without warning, proving the validator does not enforce the loader's ignore contract.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep plugin-agent omission enforcement behind the #100 stage-2 G5 re-admission increment."
]
},
"mcpServers": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers the plugin-agent surface on which Agent Bundle would omit mcpServers under the host security contract.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/plugins-reference and https://code.claude.com/docs/en/sub-agents document that mcpServers is unsupported and ignored when an agent is loaded from a plugin.",
"retrieved 2026-09-02: local Claude Code 2.1.257 `claude plugin validate --strict` accepts a plugin agent declaring mcpServers without warning, proving the validator does not enforce the loader's ignore contract.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep plugin-agent omission enforcement behind the #100 stage-2 G5 re-admission increment."
]
},
"permissionMode": {
"state": "unavailable",
"reason": "The #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers the plugin-agent surface on which Agent Bundle would omit permissionMode under the host security contract.",
"evidence": [
"retrieved 2026-09-02: https://code.claude.com/docs/en/plugins-reference and https://code.claude.com/docs/en/sub-agents document that permissionMode is unsupported and ignored when an agent is loaded from a plugin.",
"retrieved 2026-09-02: local Claude Code 2.1.257 `claude plugin validate --strict` accepts a plugin agent declaring permissionMode: bypassPermissions without warning, proving the validator does not enforce the loader's ignore contract.",
"retrieved 2026-09-02: https://github.com/ScriptedAlchemy/agent-bundle/pull/220 and https://github.com/ScriptedAlchemy/agent-bundle/issues/107 revision 3 keep plugin-agent omission enforcement behind the #100 stage-2 G5 re-admission increment."
]
}
},
"bin": {
"bareCommands": true,
"bashPath": true,
Expand Down
9 changes: 8 additions & 1 deletion packages/agent-bundle/src/adapters/claude.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -424,12 +424,18 @@ const hookContract = Object.freeze({
wrapperSource: (entry) => nativeHookWrapperSource(entry, 'Claude'),
} satisfies TargetHookContract);
const metadata = Object.freeze({
adapterRevision: '1.17.0',
adapterRevision: '1.18.0',
observedVersion: capabilityTable.observedCliVersion,
schemas: schemaDescriptorsFrom(schemaProvenance, schemaProvenance.observedCliVersion),
});
const evidence = capabilityEvidence(claudeName, metadata);
const distributionPolicy = capabilityTable.plugin.distributionPolicy;
const agentCapabilities = Object.freeze(Object.fromEntries(
Object.entries(capabilityTable.plugin.agents).map(([rowName, row]) => [
rowName === 'component' ? 'agents' : `agents.${rowName}`,
unavailableCapability(row.reason),
]),
));

export const claudeArtifactValidation = deepFreeze({
documents: [
Expand Down Expand Up @@ -3138,6 +3144,7 @@ export const claudeAdapter: TargetAdapter = Object.freeze({
artifactValidation: claudeArtifactValidation,
artifactLayout,
capabilities: Object.freeze({
...agentCapabilities,
...eventRouteCapabilitiesFrom(capabilityTable.hooks.eventRoutes, evidence),
bin: capabilityStateFromSupport(
capabilityTable.plugin.bin.directory === 'bin' &&
Expand Down
18 changes: 17 additions & 1 deletion packages/agent-bundle/src/adapters/plugin.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ const artifactValidation = deepFreeze({
});

const metadata = Object.freeze({
adapterRevision: '1.15.0',
adapterRevision: '1.16.0',
observedVersion: `${claudeAdapter.metadata.observedVersion}+${codexAdapter.metadata.observedVersion}+${cursorAdapter.metadata.observedVersion}`,
// Metadata schemas must exactly match the validation contract: each host's
// documents, with one shared Claude-format hook schema (the pinned Codex
Expand Down Expand Up @@ -579,10 +579,26 @@ const componentCapabilities = Object.freeze(Object.fromEntries(
]),
));

const agentCapabilities = Object.freeze(Object.fromEntries(
Object.keys(claudeCapabilityTable.plugin.agents).map((rowName) => {
const capability = rowName === 'component' ? 'agents' : `agents.${rowName}`;
return [
capability,
intersectCapabilityStates(
claudeAdapter.capabilities[capability]!,
unavailableCapability(
'The pinned Codex and Cursor plugin contracts publish no shared plugin agents component or agent-frontmatter surface.',
),
),
];
}),
));

export const pluginAdapter: TargetAdapter = Object.freeze({
artifactValidation,
artifactLayout,
capabilities: Object.freeze({
...agentCapabilities,
...compositeEventCapabilities,
bin: unavailableCapability(
'The unified bundle emits the Claude-only bin directory, but the pinned Codex and Cursor contracts declare no shared plugin executable surface.',
Expand Down
Loading
Loading