sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/registries/command-team-runtime.js

@@ -0,0 +1,220 @@
+import { COMMAND_TEAM_RUNTIME_CONTRACT_VERSION } from '../contracts.js';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+import { readFile } from 'node:fs/promises';
+import { inspectAgentCapabilityCatalog } from './agent-capability-catalog.js';
+import { listRuntimeProjections, recordRuntimeProjection } from '../storage/runtime-store.js';
+const ROLES = [
+    role('role.norm-scout', 'scout', ['norm_discovery'], 'advisory_only', ['project-norms'], 'small', true, false),
+    role('role.uncertainty-reviewer', 'reviewer', ['uncertainty_resolution'], 'advisory_only', ['uncertainty-map'], 'tiny', true, false),
+    role('role.performance-planner', 'planner', ['performance_planning'], 'advisory_only', ['performance-risk'], 'tiny', true, false),
+    role('role.verification-designer', 'validator', ['verification_design'], 'gate_evidence', ['verification-design'], 'small', true, true),
+    role('role.evidence-runner', 'operator', ['evidence_collection'], 'validation_runner', ['verification-design'], 'small', true, true),
+    role('role.implementation-reviewer', 'reviewer', ['verification_design'], 'gate_evidence', ['verification-design'], 'small', true, true),
+    role('role.sync-risk-reviewer', 'risk-reviewer', ['sync_back_risk_review'], 'gate_evidence', ['sync-back-risk'], 'tiny', true, true),
+    role('role.release-summarizer', 'summarizer', ['release_summary'], 'advisory_only', ['sync-back-risk'], 'tiny', true, false),
+    role('role.context-curator', 'scout', ['context_curation'], 'advisory_only', ['project-norms', 'uncertainty-map', 'performance-risk'], 'tiny', true, false)
+];
+const COMMAND_PROFILES = [
+    profile('spec', 'team-lite', ['ambiguous', 'high_risk'], ['role.norm-scout', 'role.uncertainty-reviewer'], ['role.context-curator'], 'runner_decides', 'summary_only', 'small'),
+    profile('plan', 'team-lite', ['performance', 'context_budget', 'token_risk'], ['role.norm-scout', 'role.performance-planner'], ['role.uncertainty-reviewer', 'role.context-curator'], 'runner_decides', 'summary_only', 'tiny'),
+    profile('tasks', 'single', ['shared_state', 'architecture'], ['role.norm-scout'], ['role.performance-planner', 'role.context-curator'], 'runner_decides', 'summary_only', 'tiny'),
+    profile('verifies', 'team-lite', ['acceptance', 'evidence'], ['role.verification-designer'], ['role.context-curator'], 'gate_decides', 'route_when_triggered', 'small'),
+    profile('do', 'single', ['implementation_review', 'shared_state'], ['role.implementation-reviewer'], ['role.context-curator'], 'gate_decides', 'route_when_triggered', 'small'),
+    profile('test', 'single', ['validation', 'runtime_evidence'], ['role.evidence-runner'], ['role.verification-designer'], 'gate_decides', 'route_when_triggered', 'small'),
+    profile('verify', 'team-lite', ['acceptance', 'runtime_evidence'], ['role.verification-designer', 'role.evidence-runner'], ['role.context-curator'], 'gate_decides', 'route_when_triggered', 'small'),
+    profile('sync-back', 'team-lite', ['shared_state', 'semantic_update'], ['role.sync-risk-reviewer'], ['role.context-curator'], 'gate_decides', 'summary_only', 'tiny'),
+    profile('ship', 'team-lite', ['release', 'external_state'], ['role.release-summarizer', 'role.sync-risk-reviewer'], ['role.context-curator'], 'runner_decides', 'summary_only', 'tiny'),
+    profile('doctor-deep', 'team-lite', ['runtime_evidence', 'stale_evidence'], ['role.context-curator', 'role.sync-risk-reviewer'], ['role.release-summarizer'], 'runner_decides', 'summary_only', 'tiny'),
+    profile('recover', 'team-required', ['blocked', 'stale_evidence', 'shared_state'], ['role.context-curator', 'role.sync-risk-reviewer', 'role.verification-designer'], ['role.release-summarizer'], 'gate_decides', 'summary_only', 'small')
+];
+const INDEPENDENCE_RULES = [
+    independence('ind.verify.runner-designer', 'verify', 'role.evidence-runner', 'role.verification-designer', 'Verification design and executed evidence must remain distinguishable.'),
+    independence('ind.ship.summary-risk', 'ship', 'role.release-summarizer', 'role.sync-risk-reviewer', 'Release summary cannot replace shared-state risk review.'),
+    independence('ind.recover.context-risk', 'recover', 'role.context-curator', 'role.sync-risk-reviewer', 'Recovery context selection cannot approve its own shared-state changes.'),
+    independence('ind.test.runner-designer', 'test', 'role.evidence-runner', 'role.verification-designer', 'Validation command execution must not be treated as verification design when both roles are active.')
+];
+export async function inspectCommandTeamRuntime(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        version: COMMAND_TEAM_RUNTIME_CONTRACT_VERSION,
+        roles: [...ROLES].sort((left, right) => left.id.localeCompare(right.id)),
+        commandProfiles: [...COMMAND_PROFILES].sort((left, right) => left.command.localeCompare(right.command)),
+        independenceRules: [...INDEPENDENCE_RULES].sort((left, right) => left.id.localeCompare(right.id))
+    };
+}
+export async function validateCommandTeamRuntime(projectRoot) {
+    const [inspection, capabilityCatalog] = await Promise.all([
+        inspectCommandTeamRuntime(projectRoot),
+        inspectAgentCapabilityCatalog(projectRoot)
+    ]);
+    const issues = validateInspection(inspection, new Set(capabilityCatalog.capabilities.map((capability) => capability.domain)), new Set(capabilityCatalog.materialPacks.map((pack) => pack.id)));
+    return {
+        version: COMMAND_TEAM_RUNTIME_CONTRACT_VERSION,
+        valid: issues.length === 0,
+        issues,
+        inspection
+    };
+}
+export async function decideCommandTeamRuntime(projectRoot, options) {
+    const validation = await validateCommandTeamRuntime(projectRoot);
+    const profile = validation.inspection.commandProfiles.find((candidate) => candidate.command === options.command);
+    if (!validation.valid || !profile) {
+        return {
+            version: COMMAND_TEAM_RUNTIME_CONTRACT_VERSION,
+            command: options.command,
+            mode: 'blocked',
+            activation: options.activation ?? 'auto',
+            roleIds: [],
+            materialPackIds: [],
+            independenceRuleIds: [],
+            telemetryPolicy: null,
+            reason: profile ? `invalid command team runtime: ${validation.issues.join('; ')}` : `unknown command profile: ${options.command}`
+        };
+    }
+    const activation = options.activation ?? 'auto';
+    const tokenPressure = await hasContextTokenPressure(projectRoot);
+    const riskTags = new Set(options.riskTags ?? []);
+    const escalated = profile.escalationRiskTags.some((tag) => riskTags.has(tag));
+    const mode = activation === 'off' ? 'single' : activation === 'force' ? forceMode(profile.minMode) : escalated ? forceMode(profile.minMode) : profile.minMode;
+    const roleIds = commandTeamRoleIds(profile, mode, tokenPressure, activation);
+    const roles = validation.inspection.roles.filter((roleProfile) => roleIds.includes(roleProfile.id));
+    const materialPackIds = [...new Set(roles.flatMap((roleProfile) => roleProfile.materialPackIds))].sort();
+    const independenceRuleIds = validation.inspection.independenceRules
+        .filter((rule) => rule.command === profile.command && roleIds.includes(rule.leftRoleId) && roleIds.includes(rule.rightRoleId))
+        .map((rule) => rule.id)
+        .sort();
+    const decision = {
+        version: COMMAND_TEAM_RUNTIME_CONTRACT_VERSION,
+        command: options.command,
+        mode,
+        activation,
+        roleIds,
+        materialPackIds,
+        independenceRuleIds,
+        telemetryPolicy: profile.telemetry,
+        reason: teamRuntimeDecisionReason(activation, escalated, tokenPressure)
+    };
+    await recordRuntimeProjection(projectRoot, 'team_runtime_decision', options.command, decision);
+    return decision;
+}
+function role(id, roleKind, requiredDomains, authorityCeiling, materialPackIds, contextBudget, summaryOnly, evidenceRequired) {
+    return { id, role: roleKind, requiredDomains, authorityCeiling, materialPackIds, contextBudget, summaryOnly, evidenceRequired };
+}
+function commandTeamRoleIds(profile, mode, tokenPressure, activation) {
+    if (mode === 'single') {
+        return profile.requiredRoleIds.slice(0, 1);
+    }
+    if (tokenPressure && activation !== 'force') {
+        return profile.requiredRoleIds;
+    }
+    return [...profile.requiredRoleIds, ...profile.optionalRoleIds];
+}
+function teamRuntimeDecisionReason(activation, escalated, tokenPressure) {
+    if (activation === 'off') {
+        return 'team mode disabled for this command decision';
+    }
+    if (tokenPressure && activation !== 'force') {
+        return 'context/token pressure trimmed optional team roles and material packs';
+    }
+    return escalated ? 'risk tags triggered command team escalation' : 'command profile selected default bounded team runtime';
+}
+async function hasContextTokenPressure(projectRoot) {
+    const projections = await listRuntimeProjections(projectRoot, ['context_build', 'team_runtime_decision']);
+    return projections.some((projection) => {
+        if (projection.projectionType === 'context_build') {
+            const payload = projection.payload;
+            const deferredRefs = payload.budget?.deferredRefs?.length ?? 0;
+            const truncatedSummaries = payload.budget?.truncatedSummaries?.length ?? 0;
+            const estimatedBytes = payload.budget?.estimatedBytes;
+            const maxBytes = payload.budget?.maxBytes;
+            return deferredRefs > 0 || truncatedSummaries > 0 || (typeof estimatedBytes === 'number' && typeof maxBytes === 'number' && estimatedBytes >= maxBytes * 0.85);
+        }
+        const payload = projection.payload;
+        const roleCount = Array.isArray(payload.roleIds) ? payload.roleIds.length : 0;
+        return payload.mode === 'team-required' || roleCount > 2;
+    });
+}
+function profile(command, minMode, escalationRiskTags, requiredRoleIds, optionalRoleIds, evidenceAuthority, materialPolicy, contextBudget) {
+    return {
+        command,
+        minMode,
+        escalationRiskTags,
+        requiredRoleIds,
+        optionalRoleIds,
+        summaryContract: 'summary_only_artifact_backed',
+        evidenceAuthority,
+        materialPolicy,
+        telemetry: {
+            contextBudget,
+            recordContextBytes: true,
+            recordSummaryBytes: true,
+            recordEvidenceRefs: true,
+            tokenEstimatePolicy: 'estimated_only'
+        }
+    };
+}
+function independence(id, command, leftRoleId, rightRoleId, rationale) {
+    return { id, command, leftRoleId, rightRoleId, rationale };
+}
+function validateInspection(inspection, domains, packIds) {
+    const issues = [];
+    const roleIds = new Set(inspection.roles.map((roleProfile) => roleProfile.id));
+    const commandIds = new Set();
+    const expectedCommands = ['spec', 'plan', 'tasks', 'verifies', 'do', 'test', 'verify', 'sync-back', 'ship', 'doctor-deep', 'recover'];
+    for (const roleProfile of inspection.roles) {
+        if (roleProfile.requiredDomains.length === 0) {
+            issues.push(`${roleProfile.id}: required domains are required.`);
+        }
+        if (!roleProfile.summaryOnly) {
+            issues.push(`${roleProfile.id}: command roles must return summary-only output.`);
+        }
+        for (const domain of roleProfile.requiredDomains) {
+            if (!domains.has(domain)) {
+                issues.push(`${roleProfile.id}: unknown capability domain ${domain}.`);
+            }
+        }
+        for (const packId of roleProfile.materialPackIds) {
+            if (!packIds.has(packId)) {
+                issues.push(`${roleProfile.id}: unknown material pack ${packId}.`);
+            }
+        }
+    }
+    for (const commandProfile of inspection.commandProfiles) {
+        commandIds.add(commandProfile.command);
+        if (commandProfile.requiredRoleIds.length === 0) {
+            issues.push(`${commandProfile.command}: required roles are required.`);
+        }
+        for (const roleId of [...commandProfile.requiredRoleIds, ...commandProfile.optionalRoleIds]) {
+            if (!roleIds.has(roleId)) {
+                issues.push(`${commandProfile.command}: unknown role ${roleId}.`);
+            }
+        }
+        if (commandProfile.materialPolicy === 'never_inline') {
+            issues.push(`${commandProfile.command}: command team runtime may not inline full material packs.`);
+        }
+    }
+    for (const command of expectedCommands) {
+        if (!commandIds.has(command)) {
+            issues.push(`${command}: command profile is missing.`);
+        }
+    }
+    for (const rule of inspection.independenceRules) {
+        if (!commandIds.has(rule.command)) {
+            issues.push(`${rule.id}: unknown command ${rule.command}.`);
+        }
+        if (!roleIds.has(rule.leftRoleId) || !roleIds.has(rule.rightRoleId)) {
+            issues.push(`${rule.id}: independence roles must exist.`);
+        }
+    }
+    return issues;
+}
+function forceMode(mode) {
+    return mode === 'single' ? 'team-lite' : mode;
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=command-team-runtime.js.map

package/packages/core/dist/registries/command-team-runtime.js.map

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

package/packages/core/dist/registries/eval-learning-context.d.ts

@@ -0,0 +1,64 @@
+import { HARNESS_LEARNING_CONTRACT_VERSION, PROJECT_CONTEXT_PACK_CONTRACT_VERSION, SKILL_AGENT_EVAL_CONTRACT_VERSION } from '../contracts.js';
+export interface ContractValidationIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export type SkillAgentEvalDimensionId = 'novel_judgment' | 'risk_identification' | 'task_slicing' | 'agent_evidence' | 'output_concision' | 'verification_executability' | 'autonomy_correctness' | 'agent_fit' | 'verification_availability' | 'gap_closure';
+export interface SkillAgentEvalDimension {
+    id: SkillAgentEvalDimensionId;
+    expectation: string;
+    baselineFinding: string;
+    passThreshold: number;
+}
+export interface SkillAgentEvalContract {
+    version: typeof SKILL_AGENT_EVAL_CONTRACT_VERSION;
+    corpus: string[];
+    sourceReport: string;
+    dimensions: SkillAgentEvalDimension[];
+    regressionAssertions: string[];
+}
+export interface SkillAgentEvalValidation {
+    version: typeof SKILL_AGENT_EVAL_CONTRACT_VERSION;
+    valid: boolean;
+    contract: SkillAgentEvalContract;
+    issues: ContractValidationIssue[];
+}
+export type HarnessLearningSinkId = 'project_context_pack' | 'risk_vocabulary' | 'checklist' | 'doctor_check' | 'eval_assertion' | 'generated_entry_guidance';
+export interface HarnessLearningSink {
+    id: HarnessLearningSinkId;
+    output: string;
+    boundary: string;
+}
+export interface HarnessLearningContract {
+    version: typeof HARNESS_LEARNING_CONTRACT_VERSION;
+    sourceTrial: string;
+    allowedSinks: HarnessLearningSink[];
+    forbiddenOutputs: string[];
+    promotionRule: string;
+}
+export interface HarnessLearningValidation {
+    version: typeof HARNESS_LEARNING_CONTRACT_VERSION;
+    valid: boolean;
+    contract: HarnessLearningContract;
+    issues: ContractValidationIssue[];
+}
+export interface ProjectContextPackContract {
+    version: typeof PROJECT_CONTEXT_PACK_CONTRACT_VERSION;
+    entryPoint: string;
+    durableContext: string[];
+    runtimeSourcesOfTruth: string[];
+    boundaries: string[];
+}
+export interface ProjectContextPackValidation {
+    version: typeof PROJECT_CONTEXT_PACK_CONTRACT_VERSION;
+    valid: boolean;
+    contract: ProjectContextPackContract;
+    issues: ContractValidationIssue[];
+}
+export declare function inspectSkillAgentEvalContract(projectRoot: string): Promise<SkillAgentEvalContract>;
+export declare function validateSkillAgentEvalContract(projectRoot: string): Promise<SkillAgentEvalValidation>;
+export declare function inspectHarnessLearningContract(projectRoot: string): Promise<HarnessLearningContract>;
+export declare function validateHarnessLearningContract(projectRoot: string): Promise<HarnessLearningValidation>;
+export declare function inspectProjectContextPackContract(projectRoot: string): Promise<ProjectContextPackContract>;
+export declare function validateProjectContextPackContract(projectRoot: string): Promise<ProjectContextPackValidation>;

package/packages/core/dist/registries/eval-learning-context.js

@@ -0,0 +1,161 @@
+import path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { HARNESS_LEARNING_CONTRACT_VERSION, PROJECT_CONTEXT_PACK_CONTRACT_VERSION, SKILL_AGENT_EVAL_CONTRACT_VERSION } from '../contracts.js';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+const SKILL_AGENT_EVAL_CORPUS = [
+    'docs/research/real-project-trial-evaluation-20260507.md'
+];
+const SKILL_AGENT_EVAL_DIMENSIONS = [
+    { id: 'novel_judgment', expectation: 'Evaluator identifies what SDD added beyond restating the source requirement.', baselineFinding: 'ERP trial mostly normalized source text and missed independent state-machine judgment.', passThreshold: 7 },
+    { id: 'risk_identification', expectation: 'State-machine, concurrency, database, SQL, API/schema, CI/build, and external unknown risks are extracted without relying on manual flags.', baselineFinding: 'ERP state-flow and concurrency hard gates were downgraded to compact before Phase 5.1 risk extraction.', passThreshold: 8 },
+    { id: 'task_slicing', expectation: 'Large state-flow fixes split into reviewable slices while preserving file-overlap and serial execution constraints.', baselineFinding: 'ERP trial compressed four risk boundaries into one task, limiting review and validation visibility.', passThreshold: 7 },
+    { id: 'agent_evidence', expectation: 'Scout, planner, reviewer, debugger, or validator participation is visible through bounded artifacts or explicit non-use rationale.', baselineFinding: 'ERP trial did not show visible agent artifacts or role-specific evidence.', passThreshold: 7 },
+    { id: 'output_concision', expectation: 'User-visible output is delta-first, evidence-backed, and avoids repeated status boilerplate.', baselineFinding: 'ERP trial repeated branch/status/next-step boilerplate and obscured useful deltas.', passThreshold: 7 },
+    { id: 'verification_executability', expectation: 'Validation commands and acceptance checks are executable or state why they cannot run.', baselineFinding: 'ERP trial listed Maven compile but did not map each state-flow acceptance item to executable evidence.', passThreshold: 8 },
+    { id: 'autonomy_correctness', expectation: 'Autonomy ceiling matches hard gates, shared-state risk, and confirmation requirements.', baselineFinding: 'ERP trial treated high-risk state/concurrency work as compact instead of full.', passThreshold: 8 },
+    { id: 'agent_fit', expectation: 'Task metadata names which agent roles fit each slice and when they must stop.', baselineFinding: 'ERP trial task metadata had no agent-fit evidence despite role registry availability.', passThreshold: 7 },
+    { id: 'verification_availability', expectation: 'Task metadata records unit, build, CLI, manual, or unavailable verification sources.', baselineFinding: 'ERP trial had one compile command but no per-slice verification availability.', passThreshold: 7 },
+    { id: 'gap_closure', expectation: 'Blocking gaps route to checklist, eval assertion, doctor check, or generated-entry guidance instead of silent completion.', baselineFinding: 'ERP trial surfaced few actionable gap-closure paths beyond generic next commands.', passThreshold: 7 }
+];
+const HARNESS_LEARNING_SINKS = [
+    { id: 'project_context_pack', output: 'Durable project collaboration and positioning context.', boundary: 'May summarize stable strategy, but must not duplicate live specs, runs, task status, or generated command content.' },
+    { id: 'risk_vocabulary', output: 'Keywords and mappings for lifecycle risk extraction.', boundary: 'May add deterministic vocabulary; must not bypass lifecycle hard gates or user confirmation.' },
+    { id: 'checklist', output: 'Human-reviewable checklist for recurring failure classes.', boundary: 'May guide future runs; must not claim validation without runtime evidence.' },
+    { id: 'doctor_check', output: 'A new explicit health/audit check.', boundary: 'May inspect facts; must not auto-repair or mutate project state.' },
+    { id: 'eval_assertion', output: 'Regression assertion against a known trial failure.', boundary: 'May fail tests or eval; must not silently rewrite runtime behavior.' },
+    { id: 'generated_entry_guidance', output: 'Managed command or skill wording update.', boundary: 'Must remain sdd-managed and refresh through update rather than user-file overwrite.' }
+];
+const HARNESS_LEARNING_FORBIDDEN_OUTPUTS = ['self-modifying runtime', 'hidden background automation', 'unapproved sync-back apply', 'replacement of .sdd/project.yml/specs/runtime.sqlite/branch evidence as source of truth'];
+const PROJECT_CONTEXT_PACK = {
+    version: PROJECT_CONTEXT_PACK_CONTRACT_VERSION,
+    entryPoint: 'context/memory/MEMORY.md',
+    durableContext: [
+        'stable product positioning and phase direction',
+        'collaboration preferences that affect future SDD work',
+        'external reference pointers that remain useful across sessions'
+    ],
+    runtimeSourcesOfTruth: [
+        '.sdd/project.yml for project configuration',
+        'specs/<branch>/spec.md, plan.md, and tasks.md for semantic state',
+        '.sdd/runtime.sqlite for runtime execution facts',
+        '.sdd/runs/<branchSlug>/evidence/artifacts/*.md for agent and validation evidence'
+    ],
+    boundaries: [
+        'Context pack may prime future sessions but cannot mark tasks complete.',
+        'Context pack may describe repeated failures but cannot replace eval assertions or doctor checks.',
+        'Context pack must be verified against current files before acting on file, function, or flag claims.'
+    ]
+};
+export async function inspectSkillAgentEvalContract(projectRoot) {
+    await readProjectConfig(projectRoot);
+    return {
+        version: SKILL_AGENT_EVAL_CONTRACT_VERSION,
+        corpus: [...SKILL_AGENT_EVAL_CORPUS],
+        sourceReport: 'docs/research/real-project-trial-evaluation-20260507.md',
+        dimensions: [...SKILL_AGENT_EVAL_DIMENSIONS],
+        regressionAssertions: [
+            'ERP state-flow/concurrency work must not route to compact when risk evidence is present.',
+            'Generated tasks must expose agent_fit and verification_availability when agent registry and task graph metadata exist.',
+            'Output should state evidence deltas before repeating route/status boilerplate.'
+        ]
+    };
+}
+export async function validateSkillAgentEvalContract(projectRoot) {
+    const contract = await inspectSkillAgentEvalContract(projectRoot);
+    const issues = [];
+    if (await shouldValidatePlatformTrialCorpus(projectRoot)) {
+        for (const corpusPath of [...contract.corpus, contract.sourceReport]) {
+            if (!await exists(path.join(projectRoot, corpusPath))) {
+                issues.push(contractIssue('skillAgentEval.corpus', `Eval source is missing: ${corpusPath}.`, 'Restore the ERP trial corpus before treating Phase 5.5 eval as repeatable.'));
+            }
+        }
+    }
+    const requiredDimensions = ['novel_judgment', 'risk_identification', 'task_slicing', 'agent_evidence', 'output_concision', 'verification_executability', 'autonomy_correctness', 'agent_fit', 'verification_availability', 'gap_closure'];
+    for (const dimension of requiredDimensions) {
+        if (!contract.dimensions.some((candidate) => candidate.id === dimension)) {
+            issues.push(contractIssue('skillAgentEval.dimensions', `Missing eval dimension: ${dimension}.`, 'Add the missing Phase 5.5 eval dimension.'));
+        }
+    }
+    for (const dimension of contract.dimensions) {
+        if (dimension.passThreshold < 1 || dimension.passThreshold > 10) {
+            issues.push(contractIssue(`${dimension.id}.passThreshold`, 'Eval pass threshold must be a 1-10 score.', 'Use a bounded 1-10 threshold.'));
+        }
+    }
+    if (contract.regressionAssertions.length === 0) {
+        issues.push(contractIssue('skillAgentEval.regressionAssertions', 'Eval contract has no regression assertions.', 'Add assertions for known ERP trial failures.'));
+    }
+    return { version: SKILL_AGENT_EVAL_CONTRACT_VERSION, valid: issues.length === 0, contract, issues };
+}
+export async function inspectHarnessLearningContract(projectRoot) {
+    await readProjectConfig(projectRoot);
+    return {
+        version: HARNESS_LEARNING_CONTRACT_VERSION,
+        sourceTrial: 'docs/research/real-project-trial-evaluation-20260507.md',
+        allowedSinks: [...HARNESS_LEARNING_SINKS],
+        forbiddenOutputs: [...HARNESS_LEARNING_FORBIDDEN_OUTPUTS],
+        promotionRule: 'Repeated failures may become durable guidance only through reviewed context-pack, vocabulary, checklist, doctor, eval, or managed-entry changes.'
+    };
+}
+export async function validateHarnessLearningContract(projectRoot) {
+    const contract = await inspectHarnessLearningContract(projectRoot);
+    const issues = [];
+    const requiredSinks = ['project_context_pack', 'risk_vocabulary', 'checklist', 'doctor_check', 'eval_assertion', 'generated_entry_guidance'];
+    if (await shouldValidatePlatformTrialCorpus(projectRoot) && !await exists(path.join(projectRoot, contract.sourceTrial))) {
+        issues.push(contractIssue('harnessLearning.sourceTrial', `Learning source is missing: ${contract.sourceTrial}.`, 'Restore the trial evaluation report before promoting learning outputs.'));
+    }
+    for (const sink of requiredSinks) {
+        if (!contract.allowedSinks.some((candidate) => candidate.id === sink)) {
+            issues.push(contractIssue('harnessLearning.allowedSinks', `Missing learning sink: ${sink}.`, 'Add the missing allowed learning sink.'));
+        }
+    }
+    if (!contract.forbiddenOutputs.includes('self-modifying runtime')) {
+        issues.push(contractIssue('harnessLearning.forbiddenOutputs', 'Learning contract does not forbid self-modifying runtime.', 'Declare self-modifying runtime out of scope.'));
+    }
+    return { version: HARNESS_LEARNING_CONTRACT_VERSION, valid: issues.length === 0, contract, issues };
+}
+export async function inspectProjectContextPackContract(projectRoot) {
+    await readProjectConfig(projectRoot);
+    return {
+        ...PROJECT_CONTEXT_PACK,
+        durableContext: [...PROJECT_CONTEXT_PACK.durableContext],
+        runtimeSourcesOfTruth: [...PROJECT_CONTEXT_PACK.runtimeSourcesOfTruth],
+        boundaries: [...PROJECT_CONTEXT_PACK.boundaries]
+    };
+}
+export async function validateProjectContextPackContract(projectRoot) {
+    const contract = await inspectProjectContextPackContract(projectRoot);
+    const issues = [];
+    if (await shouldValidatePlatformProjectAssets(projectRoot) && !await exists(path.join(projectRoot, contract.entryPoint))) {
+        issues.push(contractIssue('projectContextPack.entryPoint', `Context pack entry point is missing: ${contract.entryPoint}.`, 'Restore context/memory/MEMORY.md or update the context pack entry point.'));
+    }
+    if (!contract.runtimeSourcesOfTruth.some((source) => source.includes('.sdd/project.yml')) || !contract.runtimeSourcesOfTruth.some((source) => source.includes('specs/<branch>')) || !contract.runtimeSourcesOfTruth.some((source) => source.includes('.sdd/runs'))) {
+        issues.push(contractIssue('projectContextPack.runtimeSourcesOfTruth', 'Context pack does not name the structured runtime sources of truth.', 'Declare .sdd/project.yml, specs/<branch>, and .sdd/runs as runtime sources of truth.'));
+    }
+    if (!contract.boundaries.some((boundary) => boundary.includes('cannot mark tasks complete'))) {
+        issues.push(contractIssue('projectContextPack.boundaries', 'Context pack boundary does not prevent runtime state mutation.', 'Declare that context memory cannot mark tasks complete or replace runtime evidence.'));
+    }
+    return { version: PROJECT_CONTEXT_PACK_CONTRACT_VERSION, valid: issues.length === 0, contract, issues };
+}
+async function shouldValidatePlatformTrialCorpus(projectRoot) {
+    return shouldValidatePlatformProjectAssets(projectRoot);
+}
+async function shouldValidatePlatformProjectAssets(projectRoot) {
+    try {
+        const config = await readProjectConfig(projectRoot);
+        return config.project.name === 'sdd-agent-platform';
+    }
+    catch {
+        return false;
+    }
+}
+function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+async function readProjectConfig(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    return parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=eval-learning-context.js.map

package/packages/core/dist/registries/eval-learning-context.js.map

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

package/packages/core/dist/registries/query-status.d.ts

@@ -0,0 +1,28 @@
+import { QUERY_STATUS_CONTRACT_VERSION } from '../contracts.js';
+export type QuerySurfaceId = 'status' | 'doctor' | 'run_inspect' | 'debug';
+export interface QueryStatusSurface {
+    id: QuerySurfaceId;
+    command: string;
+    responsibility: string;
+    includes: string[];
+    excludes: string[];
+    nextActionRule: string;
+}
+export interface QueryStatusContract {
+    version: typeof QUERY_STATUS_CONTRACT_VERSION;
+    sourceDocument: string;
+    surfaces: QueryStatusSurface[];
+}
+export interface ContractValidationIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface QueryStatusValidation {
+    version: typeof QUERY_STATUS_CONTRACT_VERSION;
+    valid: boolean;
+    surfaces: QueryStatusSurface[];
+    issues: ContractValidationIssue[];
+}
+export declare function inspectQueryStatusContract(projectRoot: string): Promise<QueryStatusContract>;
+export declare function validateQueryStatusContract(projectRoot: string): Promise<QueryStatusValidation>;

package/packages/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/packages/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":"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"}