sdd-agent-platform 0.3.0 → 0.4.0

package/node_modules/@sdd-agent-platform/core/dist/registries/query-status.js

@@ -0,0 +1,84 @@
+import { readFile } from 'node:fs/promises';
+import { QUERY_STATUS_CONTRACT_VERSION } from '../contracts.js';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+const QUERY_STATUS_SURFACES = [
+    {
+        id: 'status',
+        command: 'sdd status --branch <branch>',
+        responsibility: 'Show current SDD route position and one recommended next action.',
+        includes: ['branch/source context', 'document/task counts', 'blocking gaps', 'latest run summary', 'recommended next command'],
+        excludes: ['full doctor audit', 'full event log', 'artifact body drill-down'],
+        nextActionRule: 'Always end with the next command or maintenance action.'
+    },
+    {
+        id: 'doctor',
+        command: 'sdd doctor [--latest-only|--all-runs]',
+        responsibility: 'Audit project health, generated entry drift, and run evidence consistency.',
+        includes: ['config health', 'managed asset drift categories', 'run evidence health', 'contract visibility'],
+        excludes: ['workflow next action selection', 'full artifact body dump'],
+        nextActionRule: 'Return maintenance action only when a health check fails or warns.'
+    },
+    {
+        id: 'run_inspect',
+        command: 'sdd run inspect <run_id>',
+        responsibility: 'Inspect one run as execution evidence.',
+        includes: ['run state', 'recent events', 'artifacts', 'artifact ingestions', 'validation', 'sync-back proposal', 'task-run evidence'],
+        excludes: ['project-wide health audit', 'branch route recommendation'],
+        nextActionRule: 'Point to evidence inspection, verify, or sync-back based on run state.'
+    },
+    {
+        id: 'debug',
+        command: 'sdd run index inspect|query and focused inspect commands',
+        responsibility: 'Provide drill-down views for maintainers without becoming the default user path.',
+        includes: ['derived indexes', 'contract internals', 'focused diagnostics'],
+        excludes: ['main route summary', 'automatic repair'],
+        nextActionRule: 'Use only after status, doctor, or run inspect identifies a specific drill-down target.'
+    }
+];
+export async function inspectQueryStatusContract(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        version: QUERY_STATUS_CONTRACT_VERSION,
+        sourceDocument: 'docs/architecture/command-information-architecture.md',
+        surfaces: [...QUERY_STATUS_SURFACES]
+    };
+}
+export async function validateQueryStatusContract(projectRoot) {
+    const contract = await inspectQueryStatusContract(projectRoot);
+    const issues = contract.surfaces.flatMap(validateQueryStatusSurface);
+    return {
+        version: QUERY_STATUS_CONTRACT_VERSION,
+        valid: issues.length === 0,
+        surfaces: contract.surfaces,
+        issues
+    };
+}
+function validateQueryStatusSurface(surface) {
+    const issues = [];
+    if (surface.command.trim().length === 0) {
+        issues.push(contractIssue(`${surface.id}.command`, 'Query surface has no command.', 'Declare the CLI command that owns this query responsibility.'));
+    }
+    if (surface.responsibility.trim().length === 0) {
+        issues.push(contractIssue(`${surface.id}.responsibility`, 'Query surface has no responsibility boundary.', 'Declare what this query surface is responsible for.'));
+    }
+    if (surface.includes.length === 0) {
+        issues.push(contractIssue(`${surface.id}.includes`, 'Query surface has no included evidence.', 'Declare what evidence this surface must include.'));
+    }
+    if (surface.excludes.length === 0) {
+        issues.push(contractIssue(`${surface.id}.excludes`, 'Query surface has no exclusion boundary.', 'Declare what belongs to a different query surface.'));
+    }
+    if (surface.nextActionRule.trim().length === 0) {
+        issues.push(contractIssue(`${surface.id}.nextActionRule`, 'Query surface has no next-action rule.', 'Declare how this surface should route the user after inspection.'));
+    }
+    return issues;
+}
+function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=query-status.js.map

package/node_modules/@sdd-agent-platform/core/dist/registries/query-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-status.js","sourceRoot":"","sources":["../../src/registries/query-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAgC3D,MAAM,qBAAqB,GAAyB;IAClD;QACE,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,8BAA8B;QACvC,cAAc,EAAE,kEAAkE;QAClF,QAAQ,EAAE,CAAC,uBAAuB,EAAE,sBAAsB,EAAE,eAAe,EAAE,oBAAoB,EAAE,0BAA0B,CAAC;QAC9H,QAAQ,EAAE,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,0BAA0B,CAAC;QAC7E,cAAc,EAAE,yDAAyD;KAC1E;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,uCAAuC;QAChD,cAAc,EAAE,4EAA4E;QAC5F,QAAQ,EAAE,CAAC,eAAe,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,qBAAqB,CAAC;QAC3G,QAAQ,EAAE,CAAC,gCAAgC,EAAE,yBAAyB,CAAC;QACvE,cAAc,EAAE,oEAAoE;KACrF;IACD;QACE,EAAE,EAAE,aAAa;QACjB,OAAO,EAAE,0BAA0B;QACnC,cAAc,EAAE,wCAAwC;QACxD,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,CAAC;QACrI,QAAQ,EAAE,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;QACtE,cAAc,EAAE,wEAAwE;KACzF;IACD;QACE,EAAE,EAAE,OAAO;QACX,OAAO,EAAE,0DAA0D;QACnE,cAAc,EAAE,kFAAkF;QAClG,QAAQ,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,CAAC;QAC1E,QAAQ,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;QACpD,cAAc,EAAE,wFAAwF;KACzG;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAmB;IAClE,MAAM,2BAA2B,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO;QACL,OAAO,EAAE,6BAA6B;QACtC,cAAc,EAAE,uDAAuD;QACvE,QAAQ,EAAE,CAAC,GAAG,qBAAqB,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,WAAmB;IACnE,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACrE,OAAO;QACL,OAAO,EAAE,6BAA6B;QACtC,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,OAA2B;IAC7D,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,EAAE,UAAU,EAAE,+BAA+B,EAAE,8DAA8D,CAAC,CAAC,CAAC;IACvJ,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,EAAE,iBAAiB,EAAE,+CAA+C,EAAE,qDAAqD,CAAC,CAAC,CAAC;IACrK,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,kDAAkD,CAAC,CAAC,CAAC;IACtJ,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,oDAAoD,CAAC,CAAC,CAAC;IACzJ,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,EAAE,iBAAiB,EAAE,wCAAwC,EAAE,kEAAkE,CAAC,CAAC,CAAC;IAC3K,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,OAAe,EAAE,cAAsB;IAC3E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,WAAmB;IAC5D,MAAM,UAAU,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,kBAAkB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/registries/skill-capabilities.d.ts

@@ -0,0 +1,22 @@
+import { AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION } from '../contracts.js';
+type LifecycleAutonomyCeiling = 'direct_execution_allowed' | 'compact_boundary_only' | 'full_sdd_with_checkpoint' | 'research_before_implementation';
+type CapabilityReuseDecision = 'reuse_direct' | 'adapt_via_host_adapter' | 'borrow_mechanism' | 'avoid';
+type SkillCapabilityKind = 'skill' | 'mcp' | 'cli_tool' | 'host_tool' | 'project_agent' | 'external_pattern';
+type SkillCapabilitySource = 'project' | 'user_global' | 'claude_code' | 'mcp' | 'open_source' | 'host';
+type SkillCapabilityEvidenceType = 'none' | 'command_output' | 'test_result' | 'browser_snapshot' | 'artifact' | 'external_source' | 'execution_record';
+interface BuiltInSkillCapabilityContract {
+    version: typeof AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION;
+    id: string;
+    name: string;
+    kind: SkillCapabilityKind;
+    source: SkillCapabilitySource;
+    sourceRef: string;
+    capabilityDomain: string[];
+    allowedStages: string[];
+    requiredRiskCeiling: LifecycleAutonomyCeiling;
+    evidenceType: SkillCapabilityEvidenceType;
+    reuseDecision: CapabilityReuseDecision;
+    buildExceptionReason: string | null;
+}
+export declare const BUILT_IN_SKILL_CAPABILITIES: BuiltInSkillCapabilityContract[];
+export {};

package/node_modules/@sdd-agent-platform/core/dist/registries/skill-capabilities.js

@@ -0,0 +1,16 @@
+import { AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION } from '../contracts.js';
+export const BUILT_IN_SKILL_CAPABILITIES = [
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'claude.subagent.researcher', name: 'Claude Code researcher subagent', kind: 'host_tool', source: 'claude_code', sourceRef: 'Claude Code Agent tool', capabilityDomain: ['research', 'search'], allowedStages: ['spec', 'plan', 'tasks', 'review'], requiredRiskCeiling: 'research_before_implementation', evidenceType: 'execution_record', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'claude.subagent.implementer', name: 'Claude Code implementer subagent', kind: 'host_tool', source: 'claude_code', sourceRef: 'Claude Code Agent tool', capabilityDomain: ['edit', 'test'], allowedStages: ['do'], requiredRiskCeiling: 'compact_boundary_only', evidenceType: 'execution_record', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'claude.skill.sdd', name: 'SDD workflow skill', kind: 'skill', source: 'project', sourceRef: '.claude/skills/sdd/SKILL.md', capabilityDomain: ['planning', 'validation'], allowedStages: ['spec', 'plan', 'tasks', 'do', 'verify'], requiredRiskCeiling: 'full_sdd_with_checkpoint', evidenceType: 'artifact', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'context7.docs', name: 'Context7 documentation lookup', kind: 'mcp', source: 'mcp', sourceRef: 'Context7 MCP', capabilityDomain: ['docs', 'api'], allowedStages: ['spec', 'plan', 'review'], requiredRiskCeiling: 'research_before_implementation', evidenceType: 'external_source', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'playwright.browser_validation', name: 'Playwright browser validation', kind: 'mcp', source: 'mcp', sourceRef: 'Playwright MCP/CLI', capabilityDomain: ['browser', 'validation'], allowedStages: ['verify'], requiredRiskCeiling: 'compact_boundary_only', evidenceType: 'browser_snapshot', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'host.search.grep_glob', name: 'Host file and content search', kind: 'host_tool', source: 'host', sourceRef: 'Grep/Glob/Read tools', capabilityDomain: ['search'], allowedStages: ['spec', 'plan', 'tasks', 'do', 'review'], requiredRiskCeiling: 'direct_execution_allowed', evidenceType: 'command_output', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'host.edit.hashline', name: 'Hashline UTF-8 edit capability', kind: 'host_tool', source: 'host', sourceRef: 'hashline-edit MCP', capabilityDomain: ['edit'], allowedStages: ['do'], requiredRiskCeiling: 'compact_boundary_only', evidenceType: 'artifact', reuseDecision: 'reuse_direct', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'host.cli.shell', name: 'Host shell command execution', kind: 'cli_tool', source: 'host', sourceRef: 'PowerShell/Bash', capabilityDomain: ['test', 'build', 'git'], allowedStages: ['do', 'verify'], requiredRiskCeiling: 'compact_boundary_only', evidenceType: 'command_output', reuseDecision: 'adapt_via_host_adapter', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'pattern.opencode.plugin_registry', name: 'OpenCode plugin registry mechanism', kind: 'external_pattern', source: 'open_source', sourceRef: 'OpenCode plugin/agent mechanism', capabilityDomain: ['host_adapter'], allowedStages: ['plan'], requiredRiskCeiling: 'research_before_implementation', evidenceType: 'none', reuseDecision: 'borrow_mechanism', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'pattern.ohmy.agent_routing', name: 'Oh My OpenAgent routing pattern', kind: 'external_pattern', source: 'open_source', sourceRef: 'Oh My OpenAgent/OpenCode', capabilityDomain: ['routing', 'model_policy'], allowedStages: ['plan', 'tasks'], requiredRiskCeiling: 'research_before_implementation', evidenceType: 'none', reuseDecision: 'borrow_mechanism', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'pattern.ohmy.security_research', name: 'Oh My security-research team pattern', kind: 'external_pattern', source: 'open_source', sourceRef: 'Oh My OpenCode team-mode/security-research', capabilityDomain: ['security', 'review'], allowedStages: ['plan', 'review', 'verify'], requiredRiskCeiling: 'research_before_implementation', evidenceType: 'artifact', reuseDecision: 'borrow_mechanism', buildExceptionReason: null },
+    { version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, id: 'external.agency_agents.material', name: 'Agency agents domain material', kind: 'external_pattern', source: 'open_source', sourceRef: 'msitarzewski/agency-agents', capabilityDomain: ['domain_expert', 'source_material'], allowedStages: ['spec', 'plan', 'review'], requiredRiskCeiling: 'research_before_implementation', evidenceType: 'external_source', reuseDecision: 'adapt_via_host_adapter', buildExceptionReason: null }
+];
+//# sourceMappingURL=skill-capabilities.js.map

package/node_modules/@sdd-agent-platform/core/dist/registries/skill-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-capabilities.js","sourceRoot":"","sources":["../../src/registries/skill-capabilities.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/registries/tool-capabilities.d.ts

@@ -0,0 +1,20 @@
+export type ToolCapabilityCategory = 'runtime' | 'editing' | 'git' | 'validation' | 'browser' | 'artifact' | 'governance';
+export type ToolCapabilitySideEffect = 'read_only' | 'local_write' | 'command_execution' | 'external_interaction';
+export interface ToolCapability {
+    id: string;
+    title: string;
+    category: ToolCapabilityCategory;
+    summary: string;
+    sideEffect: ToolCapabilitySideEffect;
+    defaultAvailable: boolean;
+    allowedStages: string[];
+    requiredEvidence: string[];
+    forbiddenUses: string[];
+}
+export interface ToolCapabilityRegistry {
+    version: string;
+    capabilities: ToolCapability[];
+}
+export declare const TOOL_CAPABILITY_REGISTRY_VERSION = "phase-3.1-tool-capability-registry-v1";
+export declare function listToolCapabilities(projectRoot: string): Promise<ToolCapabilityRegistry>;
+export declare function inspectToolCapability(projectRoot: string, capabilityId: string): Promise<ToolCapability | null>;

package/node_modules/@sdd-agent-platform/core/dist/registries/tool-capabilities.js

@@ -0,0 +1,111 @@
+import { readFile } from 'node:fs/promises';
+import { getProjectConfigPath } from '../runtime-paths.js';
+import { parseProjectConfig } from '../config/project-config.js';
+export const TOOL_CAPABILITY_REGISTRY_VERSION = 'phase-3.1-tool-capability-registry-v1';
+const BUILT_IN_TOOL_CAPABILITIES = [
+    {
+        id: 'artifact-run-hygiene',
+        title: 'Artifact and run hygiene',
+        category: 'artifact',
+        summary: 'Generate and validate sdd-result artifacts, archive exploratory runs, and scope doctor run evidence checks.',
+        sideEffect: 'local_write',
+        defaultAvailable: true,
+        allowedStages: ['do', 'verify', 'doctor'],
+        requiredEvidence: ['sdd-result artifact', 'run event log', 'doctor report'],
+        forbiddenUses: ['delete run evidence', 'auto apply sync-back', 'mark acceptance without validator evidence']
+    },
+    {
+        id: 'browser-ui-check',
+        title: 'Browser UI check',
+        category: 'browser',
+        summary: 'Use a browser to inspect frontend behavior when UI changes need manual verification.',
+        sideEffect: 'external_interaction',
+        defaultAvailable: true,
+        allowedStages: ['validation', 'review'],
+        requiredEvidence: ['manual UI observation', 'console/network findings when relevant'],
+        forbiddenUses: ['bypass authentication policy', 'perform destructive production actions', 'publish sensitive data to third-party tools']
+    },
+    {
+        id: 'git-local',
+        title: 'Local Git inspection',
+        category: 'git',
+        summary: 'Inspect local repository status, diffs, and history for coordination and safety checks.',
+        sideEffect: 'read_only',
+        defaultAvailable: true,
+        allowedStages: ['status', 'review', 'doctor'],
+        requiredEvidence: ['git status or diff summary when used for decisions'],
+        forbiddenUses: ['force push', 'destructive reset', 'delete branches without explicit approval']
+    },
+    {
+        id: 'hashline-edit',
+        title: 'Hashline UTF-8 text editing',
+        category: 'editing',
+        summary: 'Edit UTF-8 text files through stable line anchors for safer targeted modifications.',
+        sideEffect: 'local_write',
+        defaultAvailable: true,
+        allowedStages: ['implementation', 'docs'],
+        requiredEvidence: ['read anchors before edit', 'diff or readback after important edits'],
+        forbiddenUses: ['edit binary files', 'retry stale anchors without rereading', 'overwrite unrelated user changes']
+    },
+    {
+        id: 'native-file-edit',
+        title: 'Native file read/edit/write fallback',
+        category: 'editing',
+        summary: 'Use native file tools for reads and targeted edits when hashline editing is unsuitable.',
+        sideEffect: 'local_write',
+        defaultAvailable: true,
+        allowedStages: ['implementation', 'docs'],
+        requiredEvidence: ['read before write', 'diff or readback after important edits'],
+        forbiddenUses: ['create unsolicited docs', 'overwrite existing files without reading', 'write secrets']
+    },
+    {
+        id: 'sdd-cli',
+        title: 'SDD local CLI/runtime',
+        category: 'runtime',
+        summary: 'Read and update local SDD runtime state, semantic docs, artifacts, and generated entries through explicit commands.',
+        sideEffect: 'command_execution',
+        defaultAvailable: true,
+        allowedStages: ['status', 'do', 'verify', 'sync-back', 'doctor'],
+        requiredEvidence: ['command output', 'state/event/artifact path when runtime changes'],
+        forbiddenUses: ['unapproved complex sync-back apply', 'automatic commit or push', 'background write orchestration']
+    },
+    {
+        id: 'validation-command',
+        title: 'Project validation commands',
+        category: 'validation',
+        summary: 'Run project-specific checks such as typecheck, tests, build, lint, or smoke commands.',
+        sideEffect: 'command_execution',
+        defaultAvailable: true,
+        allowedStages: ['validation', 'verify', 'doctor'],
+        requiredEvidence: ['command name', 'pass/fail status', 'relevant output excerpt'],
+        forbiddenUses: ['skip failing checks without explanation', 'run destructive commands as validation', 'hide hook failures']
+    },
+    {
+        id: 'governance-policy',
+        title: 'Governance policy gate',
+        category: 'governance',
+        summary: 'Evaluate concurrency, confirmation, retry, cleanup, and risky-operation gates before runtime execution.',
+        sideEffect: 'read_only',
+        defaultAvailable: true,
+        allowedStages: ['status', 'do', 'verify', 'doctor'],
+        requiredEvidence: ['policy decision', 'blocked or confirmed operation reason', 'runtime event when execution is gated'],
+        forbiddenUses: ['auto approve destructive operations', 'bypass permission prompts', 'delete run history']
+    }
+];
+export async function listToolCapabilities(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        version: TOOL_CAPABILITY_REGISTRY_VERSION,
+        capabilities: [...BUILT_IN_TOOL_CAPABILITIES].sort((left, right) => left.id.localeCompare(right.id))
+    };
+}
+export async function inspectToolCapability(projectRoot, capabilityId) {
+    const registry = await listToolCapabilities(projectRoot);
+    return registry.capabilities.find((capability) => capability.id === capabilityId) ?? null;
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=tool-capabilities.js.map

package/node_modules/@sdd-agent-platform/core/dist/registries/tool-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-capabilities.js","sourceRoot":"","sources":["../../src/registries/tool-capabilities.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/registries/tool-plugins.d.ts

@@ -0,0 +1,21 @@
+export type ToolPluginEntryKind = 'cli' | 'adapter' | 'command' | 'manual';
+export type ToolPluginLoadMode = 'static_manifest' | 'readonly_asset';
+export interface ToolPluginContract {
+    id: string;
+    title: string;
+    version: string;
+    capabilityId: string;
+    entryKind: ToolPluginEntryKind;
+    assetPath: string;
+    loadMode: ToolPluginLoadMode;
+    checksum: string | null;
+    requiredEvidence: string[];
+    forbiddenUses: string[];
+}
+export interface ToolPluginContractRegistry {
+    version: string;
+    contracts: ToolPluginContract[];
+}
+export declare const TOOL_PLUGIN_CONTRACT_REGISTRY_VERSION = "phase-3.2-tool-plugin-loading-contract-v1";
+export declare function listToolPluginContracts(projectRoot: string): Promise<ToolPluginContractRegistry>;
+export declare function inspectToolPluginContract(projectRoot: string, pluginId: string): Promise<ToolPluginContract | null>;

package/node_modules/@sdd-agent-platform/core/dist/registries/tool-plugins.js

@@ -0,0 +1,107 @@
+import { readFile } from 'node:fs/promises';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+export const TOOL_PLUGIN_CONTRACT_REGISTRY_VERSION = 'phase-3.2-tool-plugin-loading-contract-v1';
+const BUILT_IN_TOOL_PLUGIN_CONTRACTS = [
+    {
+        id: 'artifact-run-hygiene-tools',
+        title: 'Artifact/run hygiene tools contract',
+        version: '1.0.0',
+        capabilityId: 'artifact-run-hygiene',
+        entryKind: 'command',
+        assetPath: 'packages/core/src/index.ts#artifact-run-hygiene',
+        loadMode: 'static_manifest',
+        checksum: null,
+        requiredEvidence: ['sdd-result artifact', 'run event log', 'doctor report'],
+        forbiddenUses: ['dynamic plugin execution', 'delete run evidence', 'auto apply sync-back', 'background write orchestration']
+    },
+    {
+        id: 'browser-ui-check-adapter',
+        title: 'Browser UI check adapter contract',
+        version: '1.0.0',
+        capabilityId: 'browser-ui-check',
+        entryKind: 'manual',
+        assetPath: 'claude-code/browser-tools',
+        loadMode: 'readonly_asset',
+        checksum: null,
+        requiredEvidence: ['manual UI observation', 'console/network findings when relevant'],
+        forbiddenUses: ['dynamic browser automation plugin execution', 'destructive production actions', 'publish sensitive data to third-party tools']
+    },
+    {
+        id: 'git-local-inspection',
+        title: 'Local git inspection contract',
+        version: '1.0.0',
+        capabilityId: 'git-local',
+        entryKind: 'cli',
+        assetPath: 'git',
+        loadMode: 'readonly_asset',
+        checksum: null,
+        requiredEvidence: ['git status or diff summary when used for decisions'],
+        forbiddenUses: ['force push', 'destructive reset', 'delete branches without explicit approval', 'background write orchestration']
+    },
+    {
+        id: 'hashline-edit-adapter',
+        title: 'Hashline edit adapter contract',
+        version: '1.0.0',
+        capabilityId: 'hashline-edit',
+        entryKind: 'adapter',
+        assetPath: 'mcp:hashline-edit',
+        loadMode: 'readonly_asset',
+        checksum: null,
+        requiredEvidence: ['read anchors before edit', 'diff or readback after important edits'],
+        forbiddenUses: ['dynamic external plugin scan', 'retry stale anchors without rereading', 'overwrite unrelated user changes']
+    },
+    {
+        id: 'native-file-edit-adapter',
+        title: 'Native file edit adapter contract',
+        version: '1.0.0',
+        capabilityId: 'native-file-edit',
+        entryKind: 'adapter',
+        assetPath: 'claude-code:file-tools',
+        loadMode: 'readonly_asset',
+        checksum: null,
+        requiredEvidence: ['read before write', 'diff or readback after important edits'],
+        forbiddenUses: ['permission injection', 'overwrite existing files without reading', 'write secrets']
+    },
+    {
+        id: 'sdd-cli-runtime',
+        title: 'SDD CLI/runtime contract',
+        version: '1.0.0',
+        capabilityId: 'sdd-cli',
+        entryKind: 'cli',
+        assetPath: 'dist/packages/cli/src/main.js',
+        loadMode: 'static_manifest',
+        checksum: null,
+        requiredEvidence: ['command output', 'state/event/artifact path when runtime changes'],
+        forbiddenUses: ['dynamic plugin execution', 'unapproved complex sync-back apply', 'automatic commit or push', 'background write orchestration']
+    },
+    {
+        id: 'validation-command-runner',
+        title: 'Validation command runner contract',
+        version: '1.0.0',
+        capabilityId: 'validation-command',
+        entryKind: 'command',
+        assetPath: '.sdd/project.yml#validation.default',
+        loadMode: 'static_manifest',
+        checksum: null,
+        requiredEvidence: ['command name', 'pass/fail status', 'relevant output excerpt'],
+        forbiddenUses: ['dynamic plugin execution', 'run destructive commands as validation', 'hide hook failures']
+    }
+];
+export async function listToolPluginContracts(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        version: TOOL_PLUGIN_CONTRACT_REGISTRY_VERSION,
+        contracts: [...BUILT_IN_TOOL_PLUGIN_CONTRACTS].sort((left, right) => left.id.localeCompare(right.id))
+    };
+}
+export async function inspectToolPluginContract(projectRoot, pluginId) {
+    const registry = await listToolPluginContracts(projectRoot);
+    return registry.contracts.find((contract) => contract.id === pluginId) ?? null;
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=tool-plugins.js.map

package/node_modules/@sdd-agent-platform/core/dist/registries/tool-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-plugins.js","sourceRoot":"","sources":["../../src/registries/tool-plugins.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/registries/worker-adapters.d.ts

@@ -0,0 +1,38 @@
+import type { ToolCapabilitySideEffect } from './tool-capabilities.js';
+export type WorkerAdapterKind = 'claude_code_subagent' | 'sdd_cli_task' | 'manual_handoff';
+export type WorkerAdapterExitStatus = 'completed' | 'failed' | 'cancelled' | 'timed_out' | 'blocked';
+export type WorkerAdapterTerminalStatus = 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'CANCELLED';
+export interface WorkerAdapterPayloadContract {
+    queueItemId: string;
+    runId: string;
+    taskId: string;
+    delegationId: string;
+    stateMachineVersion: string;
+}
+export interface WorkerAdapterOutputContract {
+    artifactReference: string;
+    terminalStatus: WorkerAdapterTerminalStatus[];
+    exitStatuses: WorkerAdapterExitStatus[];
+    requiredEvents: string[];
+}
+export interface WorkerAdapterContract {
+    id: string;
+    title: string;
+    version: string;
+    kind: WorkerAdapterKind;
+    capabilityId: string;
+    pluginContractId: string;
+    input: WorkerAdapterPayloadContract;
+    output: WorkerAdapterOutputContract;
+    sideEffect: ToolCapabilitySideEffect;
+    permissionPrompt: string;
+    requiredEvidence: string[];
+    forbiddenUses: string[];
+}
+export interface WorkerAdapterContractRegistry {
+    version: string;
+    adapters: WorkerAdapterContract[];
+}
+export declare const WORKER_ADAPTER_CONTRACT_REGISTRY_VERSION = "phase-3.5-worker-adapter-contract-v1";
+export declare function listWorkerAdapterContracts(projectRoot: string): Promise<WorkerAdapterContractRegistry>;
+export declare function inspectWorkerAdapterContract(projectRoot: string, adapterId: string): Promise<WorkerAdapterContract | null>;

package/node_modules/@sdd-agent-platform/core/dist/registries/worker-adapters.js

@@ -0,0 +1,99 @@
+import { readFile } from 'node:fs/promises';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+export const WORKER_ADAPTER_CONTRACT_REGISTRY_VERSION = 'phase-3.5-worker-adapter-contract-v1';
+const DELEGATION_STATE_MACHINE_VERSION = 'phase-3.4-delegation-state-machine-v1';
+const BUILT_IN_WORKER_ADAPTER_CONTRACTS = [
+    {
+        id: 'claude-code-subagent-worker',
+        title: 'Claude Code subagent worker adapter',
+        version: '1.0.0',
+        kind: 'claude_code_subagent',
+        capabilityId: 'sdd-cli',
+        pluginContractId: 'sdd-cli-runtime',
+        input: {
+            queueItemId: '<run_id>:<delegation_id>',
+            runId: '<run_id>',
+            taskId: '<task_id>',
+            delegationId: '<delegation_id>',
+            stateMachineVersion: DELEGATION_STATE_MACHINE_VERSION
+        },
+        output: {
+            artifactReference: 'artifacts/<agent>-<task_id>.md',
+            terminalStatus: ['COMPLETED', 'FAILED', 'TIMED_OUT', 'CANCELLED'],
+            exitStatuses: ['completed', 'failed', 'timed_out', 'cancelled', 'blocked'],
+            requiredEvents: ['delegation_started', 'delegation_completed', 'delegation_failed', 'delegation_timeout', 'delegation_cancelled']
+        },
+        sideEffect: 'command_execution',
+        permissionPrompt: 'Run a Claude Code/subagent task for one queued delegation and persist only declared run events/artifact references.',
+        requiredEvidence: ['queue item id', 'delegation state transition event', 'sdd-result artifact reference'],
+        forbiddenUses: ['bypass Claude Code permission prompts', 'execute undeclared wave scheduling', 'write outside .sdd/runs or declared artifacts', 'reopen terminal delegation ids']
+    },
+    {
+        id: 'manual-handoff-worker',
+        title: 'Manual handoff worker adapter',
+        version: '1.0.0',
+        kind: 'manual_handoff',
+        capabilityId: 'sdd-cli',
+        pluginContractId: 'sdd-cli-runtime',
+        input: {
+            queueItemId: '<run_id>:<delegation_id>',
+            runId: '<run_id>',
+            taskId: '<task_id>',
+            delegationId: '<delegation_id>',
+            stateMachineVersion: DELEGATION_STATE_MACHINE_VERSION
+        },
+        output: {
+            artifactReference: 'artifacts/<agent>-<task_id>.md',
+            terminalStatus: ['COMPLETED', 'FAILED', 'CANCELLED'],
+            exitStatuses: ['completed', 'failed', 'cancelled', 'blocked'],
+            requiredEvents: ['delegation_started', 'delegation_completed', 'delegation_failed', 'delegation_cancelled']
+        },
+        sideEffect: 'read_only',
+        permissionPrompt: 'Prepare a manual delegation handoff without starting a background process.',
+        requiredEvidence: ['queue item id', 'manual handoff instructions', 'expected artifact reference'],
+        forbiddenUses: ['start background worker', 'claim queue item', 'mark delegation completed without artifact evidence']
+    },
+    {
+        id: 'sdd-cli-task-worker',
+        title: 'SDD CLI task worker adapter',
+        version: '1.0.0',
+        kind: 'sdd_cli_task',
+        capabilityId: 'artifact-run-hygiene',
+        pluginContractId: 'artifact-run-hygiene-tools',
+        input: {
+            queueItemId: '<run_id>:<delegation_id>',
+            runId: '<run_id>',
+            taskId: '<task_id>',
+            delegationId: '<delegation_id>',
+            stateMachineVersion: DELEGATION_STATE_MACHINE_VERSION
+        },
+        output: {
+            artifactReference: 'artifacts/<agent>-<task_id>.md',
+            terminalStatus: ['COMPLETED', 'FAILED', 'TIMED_OUT', 'CANCELLED'],
+            exitStatuses: ['completed', 'failed', 'timed_out', 'cancelled', 'blocked'],
+            requiredEvents: ['delegation_started', 'delegation_completed', 'delegation_failed', 'delegation_timeout', 'delegation_cancelled']
+        },
+        sideEffect: 'local_write',
+        permissionPrompt: 'Run a bounded SDD CLI task adapter and write only declared artifact/run evidence.',
+        requiredEvidence: ['queue item id', 'command output', 'sdd-result artifact reference'],
+        forbiddenUses: ['unapproved complex sync-back apply', 'dynamic plugin execution', 'background wave execution', 'write undeclared artifacts']
+    }
+];
+export async function listWorkerAdapterContracts(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        version: WORKER_ADAPTER_CONTRACT_REGISTRY_VERSION,
+        adapters: [...BUILT_IN_WORKER_ADAPTER_CONTRACTS].sort((left, right) => left.id.localeCompare(right.id))
+    };
+}
+export async function inspectWorkerAdapterContract(projectRoot, adapterId) {
+    const registry = await listWorkerAdapterContracts(projectRoot);
+    return registry.adapters.find((adapter) => adapter.id === adapterId) ?? null;
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=worker-adapters.js.map

package/node_modules/@sdd-agent-platform/core/dist/registries/worker-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-adapters.js","sourceRoot":"","sources":["../../src/registries/worker-adapters.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/registries/workflow-gates.d.ts

@@ -0,0 +1,19 @@
+import { WORKFLOW_GATE_CONTRACT_VERSION } from '../contracts.js';
+export type WorkflowGateId = 'spec' | 'plan' | 'tasks' | 'do' | 'test' | 'doctor';
+export interface WorkflowGateContract {
+    version: typeof WORKFLOW_GATE_CONTRACT_VERSION;
+    id: WorkflowGateId;
+    command: string;
+    requiredInputs: string[];
+    allowedAgents: string[];
+    requiredArtifacts: string[];
+    gateConditions: string[];
+    gapClosureBehavior: string;
+    nextAction: string;
+}
+export interface WorkflowGateRegistry {
+    version: typeof WORKFLOW_GATE_CONTRACT_VERSION;
+    workflows: WorkflowGateContract[];
+}
+export declare function listWorkflowGates(projectRoot: string): Promise<WorkflowGateRegistry>;
+export declare function inspectWorkflowGate(projectRoot: string, workflowId: string): Promise<WorkflowGateContract | null>;