sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/router/runtime-validation.js

@@ -0,0 +1,235 @@
+import { AGENT_REGISTRY_CONTRACT_VERSION, AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION, WORKFLOW_GATE_CONTRACT_VERSION } from '../contracts.js';
+import { contractIssue } from '../contracts/issues.js';
+import { listAgentRegistry } from '../registries/agent-registry.js';
+import { listWorkflowGates } from '../registries/workflow-gates.js';
+import { BUILT_IN_MODEL_POLICIES, buildAgentSkillRuntimeRegistry } from './runtime-registry.js';
+import { inspectAgentSkillTeamRuntime } from './runtime-inspection.js';
+export async function validateWorkflowGates(projectRoot) {
+    const registry = await listWorkflowGates(projectRoot);
+    const agentRegistry = await listAgentRegistry(projectRoot);
+    const agentIds = new Set(agentRegistry.agents.map((agent) => agent.id));
+    const issues = registry.workflows.flatMap((workflow) => validateWorkflowGate(workflow, agentIds));
+    return {
+        version: WORKFLOW_GATE_CONTRACT_VERSION,
+        valid: issues.length === 0,
+        workflows: registry.workflows,
+        issues
+    };
+}
+export async function validateAgentRegistry(projectRoot) {
+    const registry = await listAgentRegistry(projectRoot);
+    const issues = registry.agents.flatMap(validateAgentRegistryEntry);
+    return {
+        version: AGENT_REGISTRY_CONTRACT_VERSION,
+        valid: issues.length === 0,
+        agents: registry.agents,
+        issues
+    };
+}
+export async function validateAgentSkillTeamRuntime(projectRoot) {
+    const inspection = await inspectAgentSkillTeamRuntime(projectRoot);
+    const registry = await buildAgentSkillRuntimeRegistry(projectRoot);
+    const issues = [...registry.issues, ...validateAgentSkillTeamRuntimeInspection(inspection)];
+    return {
+        version: AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION,
+        valid: issues.length === 0,
+        inspection,
+        issues
+    };
+}
+function validateWorkflowGate(workflow, agentIds) {
+    const issues = [];
+    if (workflow.requiredInputs.length === 0) {
+        issues.push(contractIssue(`${workflow.id}.requiredInputs`, 'Workflow gate has no required inputs.', 'Declare required inputs before this workflow can run.'));
+    }
+    if (workflow.requiredArtifacts.length === 0) {
+        issues.push(contractIssue(`${workflow.id}.requiredArtifacts`, 'Workflow gate has no required artifacts.', 'Declare required artifacts for workflow evidence.'));
+    }
+    for (const agentId of workflow.allowedAgents) {
+        if (!agentIds.has(agentId)) {
+            issues.push(contractIssue(`${workflow.id}.allowedAgents`, `Workflow references unknown agent ${agentId}.`, 'Add the agent to AgentRegistryContract or remove it from the workflow.'));
+        }
+    }
+    return issues;
+}
+function validateAgentRegistryEntry(agent) {
+    const issues = [];
+    if (agent.allowedStages.length === 0) {
+        issues.push(contractIssue(`${agent.id}.allowedStages`, 'Agent has no allowed stages.', 'Declare where the agent may participate.'));
+    }
+    if (agent.readBoundary.length === 0 || agent.writeBoundary.length === 0) {
+        issues.push(contractIssue(`${agent.id}.boundary`, 'Agent read/write boundary is incomplete.', 'Declare read and write boundaries.'));
+    }
+    if (agent.toolAllowlist.length === 0) {
+        issues.push(contractIssue(`${agent.id}.toolAllowlist`, 'Agent has no tool allowlist.', 'Declare permitted tool categories.'));
+    }
+    return issues;
+}
+function validateAgentSkillTeamRuntimeInspection(inspection) {
+    const issues = [];
+    const profileIds = new Set(inspection.profiles.map((profile) => profile.id));
+    const capabilityIds = new Set(inspection.skillCapabilities.map((capability) => capability.id));
+    const sourceIds = new Set(inspection.capabilitySources.map((source) => source.id));
+    const modelPolicyIds = new Set(BUILT_IN_MODEL_POLICIES.map((policy) => policy.id));
+    for (const requiredProfile of ['planner', 'architect', 'implementer', 'reviewer', 'validator', 'researcher', 'orchestrator', 'security', 'domain_expert']) {
+        if (!profileIds.has(requiredProfile)) {
+            issues.push(contractIssue(`profiles.${requiredProfile}`, 'Required Phase 6 profile is missing.', 'Add the profile to AgentProfileContract.'));
+        }
+    }
+    for (const source of inspection.capabilitySources) {
+        if (!source.id.trim()) {
+            issues.push(contractIssue('capabilitySources.id', 'Capability source has no id.', 'Declare a stable capability source id.'));
+        }
+        if (!source.sourceRef.trim()) {
+            issues.push(contractIssue(`${source.id}.sourceRef`, 'Capability source has no source reference.', 'Declare the source_ref before runtime inspection can cite it.'));
+        }
+        if (!source.attribution.trim()) {
+            issues.push(contractIssue(`${source.id}.attribution`, 'Capability source has no attribution.', 'Declare attribution before external material can enter the runtime registry.'));
+        }
+        if (source.permissionModel.length === 0) {
+            issues.push(contractIssue(`${source.id}.permissionModel`, 'Capability source has no permission model.', 'Declare how host/tool permissions are bounded before routing this source.'));
+        }
+        if (source.provenanceRequirements.length === 0) {
+            issues.push(contractIssue(`${source.id}.provenanceRequirements`, 'Capability source has no provenance requirements.', 'Declare source, session, artifact, or tool provenance before external output can be cited.'));
+        }
+        if (source.hostCompatibility.length === 0) {
+            issues.push(contractIssue(`${source.id}.hostCompatibility`, 'Capability source has no host compatibility declaration.', 'Declare supported, future_adapter, or unsupported host compatibility.'));
+        }
+        if (source.allowedEvidenceTypes.length === 0) {
+            issues.push(contractIssue(`${source.id}.allowedEvidenceTypes`, 'Capability source has no allowed evidence type.', 'Declare whether output is none, candidate evidence, command output, browser snapshot, design context, execution record, or external reference.'));
+        }
+        if (source.forbiddenAuthority.length === 0 || !sourceForbidsRuntimeAuthority(source)) {
+            issues.push(contractIssue(`${source.id}.forbiddenAuthority`, 'Capability source does not forbid runtime authority.', 'External sources must forbid lifecycle, completion, sync-back, ship, and permission authority.'));
+        }
+        if (!source.quarantineRequired && source.quarantineStatus !== 'not_required') {
+            issues.push(contractIssue(`${source.id}.quarantineStatus`, 'Non-quarantined source has a quarantine status.', 'Use not_required unless quarantine is required.'));
+        }
+        if (source.quarantineRequired && source.quarantineStatus === 'not_required') {
+            issues.push(contractIssue(`${source.id}.quarantineStatus`, 'Quarantined source is missing active quarantine status.', 'Use required, quarantined, or denied for external sources that require quarantine.'));
+        }
+        if ((source.quarantineRequired || source.quarantineStatus === 'quarantined' || source.quarantineStatus === 'denied') && source.reuseDecision === 'reuse_direct') {
+            issues.push(contractIssue(`${source.id}.reuseDecision`, 'Quarantined source cannot be reused directly.', 'Use adapt_via_host_adapter, borrow_mechanism, or avoid until quarantine evidence promotes the source.'));
+        }
+        if ((source.quarantineRequired || source.quarantineStatus === 'quarantined') && sourceDeclaresUnsafeAuthority(source)) {
+            issues.push(contractIssue(`${source.id}.allowedUse`, 'Quarantined source requests prompt import, direct execution, or lifecycle authority.', 'Keep external material declarative and route only through validated profiles, capabilities, and adapter mappings.'));
+        }
+        if (source.quarantineStatus === 'denied' && source.reuseDecision !== 'avoid') {
+            issues.push(contractIssue(`${source.id}.reuseDecision`, 'Denied capability source is still routable.', 'Set reuse_decision to avoid for denied or unsupported sources.'));
+        }
+    }
+    for (const capability of inspection.skillCapabilities) {
+        const registrySource = inspectionRegistrySource(inspection, 'skill_capability', capability.id);
+        if (!capability.id.trim()) {
+            issues.push(contractIssue('skillCapabilities.id', 'Capability has no id.', 'Declare a stable capability id.'));
+        }
+        if (capability.allowedStages.length === 0) {
+            issues.push(contractIssue(`${capability.id}.allowedStages`, 'Capability has no allowed stages.', 'Declare the SDD stages where this capability may be used.'));
+        }
+        if (!capability.sourceRef.trim()) {
+            issues.push(contractIssue(`${capability.id}.sourceRef`, 'Capability has no source attribution.', 'Add source_ref before routing can cite this capability.'));
+        }
+        if (registrySource?.origin === 'project_config' && capability.evidenceType === 'none') {
+            issues.push(contractIssue(`${capability.id}.evidenceType`, 'Project-declared capability has no evidence type.', 'Declare evidence_type so runtime results can be verified.'));
+        }
+        if (registrySource?.sourceId && !sourceIds.has(registrySource.sourceId)) {
+            issues.push(contractIssue(`${capability.id}.sourceRef`, `Capability references missing source ${registrySource.sourceId}.`, 'Add the capability source or update the capability source_ref.'));
+        }
+    }
+    for (const profile of inspection.profiles) {
+        if (!profile.id.trim()) {
+            issues.push(contractIssue('profiles.id', 'Profile has no id.', 'Declare a stable profile id.'));
+        }
+        if (profile.stageScope.length === 0 || profile.boundaries.length === 0) {
+            issues.push(contractIssue(`${profile.id}.boundary`, 'Profile stage scope or boundary is incomplete.', 'Declare stage scope and execution boundaries.'));
+        }
+        if (profile.toolScope.length === 0) {
+            issues.push(contractIssue(`${profile.id}.toolScope`, 'Profile has no tool scope.', 'Declare allowed tool groups before routing can project permissions.'));
+        }
+        if (profile.requiredArtifacts.length === 0) {
+            issues.push(contractIssue(`${profile.id}.requiredArtifacts`, 'Profile has no required artifacts.', 'Declare the evidence artifacts expected from this profile.'));
+        }
+        if (!modelPolicyIds.has(profile.modelPolicyId)) {
+            issues.push(contractIssue(`${profile.id}.modelPolicyId`, `Profile references unknown model policy ${profile.modelPolicyId}.`, 'Use a registered model policy id.'));
+        }
+        for (const capabilityId of profile.hostCapabilityRequirements) {
+            if (!capabilityIds.has(capabilityId) && capabilityId !== 'claude_code.host_adapter') {
+                issues.push(contractIssue(`${profile.id}.hostCapabilityRequirements`, `Profile references unknown capability ${capabilityId}.`, 'Add the capability or remove the requirement.'));
+            }
+        }
+    }
+    for (const [alias, target] of Object.entries(inspection.aliases ?? {})) {
+        if (!alias.trim() || !target.trim()) {
+            issues.push(contractIssue('agent_runtime.aliases', 'Alias declaration is incomplete.', 'Declare alias and target profile id.'));
+            continue;
+        }
+        if (!inspectionProfileTokenResolves(target, profileIds)) {
+            issues.push(contractIssue(`agent_runtime.aliases.${alias}`, `Alias points to unknown profile ${target}.`, 'Point aliases at a registered built-in or project-config profile.'));
+        }
+    }
+    for (const rule of inspection.routingRules ?? []) {
+        if (!rule.id.trim()) {
+            issues.push(contractIssue('agent_runtime.routing_rules.id', 'Routing rule has no id.', 'Declare a stable routing rule id.'));
+        }
+        if (rule.when.keywords.length === 0 && rule.when.affectedFileGlobs.length === 0) {
+            issues.push(contractIssue(`${rule.id}.when`, 'Routing rule has no match condition.', 'Declare keywords or affected_file_globs before the rule can influence routing.'));
+        }
+        if (!inspectionProfileTokenResolves(rule.preferProfile, profileIds)) {
+            issues.push(contractIssue(`${rule.id}.preferProfile`, `Routing rule prefers unknown profile ${rule.preferProfile}.`, 'Add the profile or update prefer_profile.'));
+        }
+        for (const capabilityId of rule.requireCapabilities) {
+            if (!capabilityIds.has(capabilityId)) {
+                issues.push(contractIssue(`${rule.id}.requireCapabilities`, `Routing rule requires unknown capability ${capabilityId}.`, 'Add the capability or remove it from require_capabilities.'));
+            }
+        }
+    }
+    for (const mapping of inspection.adapterMappings ?? []) {
+        if (!inspectionProfileTokenResolves(mapping.profile, profileIds)) {
+            issues.push(contractIssue(`agent_runtime.adapter_mappings.${mapping.profile}`, `Adapter mapping references unknown profile ${mapping.profile}.`, 'Map adapters only to registered profiles.'));
+        }
+        if (!mapping.hostAdapter.trim() || !mapping.projection.trim() || !mapping.permissionPolicy.trim()) {
+            issues.push(contractIssue(`agent_runtime.adapter_mappings.${mapping.profile}`, 'Adapter mapping is incomplete.', 'Declare host_adapter, projection, and permission_policy.'));
+        }
+    }
+    if (inspection.teamMode.enabled) {
+        issues.push(contractIssue('teamMode.enabled', 'Runtime inspection without task context must keep team-mode disabled.', 'Use task routing to select adaptive team-mode for a concrete task.'));
+    }
+    return issues;
+}
+function inspectionRegistrySource(inspection, kind, id) {
+    return inspection.registrySources?.find((source) => source.kind === kind && source.id === id) ?? null;
+}
+function inspectionProfileTokenResolves(value, profileIds) {
+    const normalized = normalizeAgentToken(value);
+    if ([...profileIds].some((profileId) => normalizeAgentToken(profileId) === normalized)) {
+        return true;
+    }
+    const aliasTarget = builtInProfileAliasTarget(value);
+    return aliasTarget ? profileIds.has(aliasTarget) : false;
+}
+function sourceDeclaresUnsafeAuthority(source) {
+    return /prompt\s*(body|import)|direct\s+execution|execute\s+(third[- ]party|external)|run\s+(agent\s+)?pack|lifecycle\s+authority|completion\s+authority|unscoped\s+write|permission\s+escalation/i.test([source.allowedUse, source.rationale].join('\n'));
+}
+function sourceForbidsRuntimeAuthority(source) {
+    const forbidden = source.forbiddenAuthority.join('\n').toLowerCase();
+    return ['lifecycle', 'stage completion', 'sync-back', 'ship', 'permission'].every((term) => forbidden.includes(term));
+}
+function builtInProfileAliasTarget(value) {
+    const normalized = normalizeAgentToken(value);
+    if (normalized === 'scout') {
+        return 'researcher';
+    }
+    if (normalized === 'debugger') {
+        return 'implementer';
+    }
+    if (normalized === 'spec_reviewer') {
+        return 'reviewer';
+    }
+    if (normalized === 'domain') {
+        return 'domain_expert';
+    }
+    return null;
+}
+function normalizeAgentToken(value) {
+    return value.trim().toLowerCase().replace(/[\s_-]+/g, '_');
+}
+//# sourceMappingURL=runtime-validation.js.map

package/packages/core/dist/router/runtime-validation.js.map

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

package/packages/core/dist/router/team-mode.d.ts

@@ -0,0 +1,16 @@
+import type { LifecycleAutonomyCeiling } from '../lifecycle/decision-gate.js';
+import type { TeamModeActivation } from './route-cache.js';
+import type { AgentRouterCategory, TeamModePolicy } from './agent-runtime.js';
+import type { SddTask } from '../sdd-docs/task-parser.js';
+export declare function resolveTeamModeActivation(options: {
+    teamModeEnabled?: boolean;
+    teamModeActivation?: TeamModeActivation;
+}, defaultActivation: TeamModeActivation): TeamModeActivation;
+export declare function buildTeamModePolicy(options: {
+    activation: TeamModeActivation;
+    task?: SddTask | null;
+    category?: AgentRouterCategory;
+    risk?: string[];
+    autonomyCeiling?: LifecycleAutonomyCeiling;
+    blockedReason?: string | null;
+}): TeamModePolicy;

package/packages/core/dist/router/team-mode.js

@@ -0,0 +1,134 @@
+import { TEAM_MODE_POLICY_VERSION } from '../contracts.js';
+import { BUILT_IN_DELEGATION_WAVES } from './runtime-registry.js';
+import { buildTaskRiskProfile } from '../task-risk-profile.js';
+import { taskAutonomyCeiling } from './risk-policy.js';
+export function resolveTeamModeActivation(options, defaultActivation) {
+    if (options.teamModeActivation) {
+        return options.teamModeActivation;
+    }
+    if (options.teamModeEnabled === true) {
+        return 'force';
+    }
+    if (options.teamModeEnabled === false) {
+        return 'off';
+    }
+    return defaultActivation;
+}
+function baseTeamModePolicy(input) {
+    const allowedWaves = input.allowedWaves ?? [];
+    const memberProfiles = (input.memberProfiles ?? [...new Set(allowedWaves.flatMap((wave) => wave.memberProfiles))]).slice(0, input.maxMembers ?? 0);
+    return {
+        version: TEAM_MODE_POLICY_VERSION,
+        enabled: input.enabled,
+        decision: input.decision,
+        mode: input.mode,
+        activation: input.activation,
+        costClass: input.costClass,
+        reason: input.reason,
+        costRoute: input.costRoute ?? 'not_applicable',
+        downgradeReason: input.downgradeReason ?? null,
+        trustPolicyEnforced: input.trustPolicyEnforced ?? true,
+        chiefProfile: 'orchestrator',
+        memberProfiles,
+        allowedWaves,
+        maxMembers: input.maxMembers ?? memberProfiles.length,
+        requireArtifacts: true,
+        blockedReason: input.blockedReason ?? null,
+        waveRecommendation: allowedWaves.map((wave) => wave.id)
+    };
+}
+function selectTeamWaves(ids) {
+    return ids.map((id) => BUILT_IN_DELEGATION_WAVES.find((wave) => wave.id === id)).filter((wave) => Boolean(wave));
+}
+export function buildTeamModePolicy(options) {
+    const activation = options.activation;
+    if (options.blockedReason) {
+        return baseTeamModePolicy({
+            activation,
+            mode: 'off',
+            enabled: false,
+            decision: 'blocked',
+            costClass: 'none',
+            reason: options.blockedReason,
+            blockedReason: options.blockedReason,
+            costRoute: 'blocked',
+            trustPolicyEnforced: true
+        });
+    }
+    if (activation === 'off') {
+        return baseTeamModePolicy({
+            activation,
+            mode: 'off',
+            enabled: false,
+            decision: 'disabled',
+            costClass: 'none',
+            reason: 'Team-mode automation disabled for this route.',
+            costRoute: 'not_applicable',
+            trustPolicyEnforced: true
+        });
+    }
+    const task = options.task ?? null;
+    const profile = buildTaskRiskProfile(task ? { ...task, risk: options.risk ?? task.risk } : null);
+    const category = options.category ?? 'planning';
+    const autonomyCeiling = options.autonomyCeiling ?? (task ? taskAutonomyCeiling(task) : 'direct_execution_allowed');
+    const highRisk = profile.riskLevel === 'high' || autonomyCeiling === 'full_sdd_with_checkpoint' || autonomyCeiling === 'research_before_implementation';
+    const reviewNeeded = category === 'implementation_review' || category === 'validation' || profile.teamRecommendation === 'review-lite';
+    if (profile.securitySensitive || category === 'security_research') {
+        return baseTeamModePolicy({
+            activation,
+            mode: 'security-research',
+            enabled: true,
+            decision: 'enabled',
+            costClass: 'high',
+            reason: 'Security-sensitive task automatically requires bounded security-research team evidence.',
+            costRoute: 'no_downgrade',
+            trustPolicyEnforced: true,
+            allowedWaves: selectTeamWaves(['security_research', 'validation']),
+            memberProfiles: ['security', 'reviewer', 'validator'],
+            maxMembers: 3
+        });
+    }
+    if (highRisk || category === 'external_research') {
+        return baseTeamModePolicy({
+            activation,
+            mode: 'hyperplan',
+            enabled: true,
+            decision: 'enabled',
+            costClass: highRisk ? 'high' : 'medium',
+            reason: profile.sourceBoundary ? 'Source-boundary or high-risk task requires adversarial planning/review evidence.' : 'High-risk or research-before-implementation task automatically requires adversarial planning/review evidence.',
+            costRoute: 'no_downgrade',
+            trustPolicyEnforced: true,
+            allowedWaves: selectTeamWaves(['hyperplan', 'implementation_review', 'validation']),
+            memberProfiles: ['architect', 'reviewer', 'security', 'validator'],
+            maxMembers: 4
+        });
+    }
+    if (reviewNeeded || activation === 'force') {
+        return baseTeamModePolicy({
+            activation,
+            mode: 'review-lite',
+            enabled: true,
+            decision: 'enabled',
+            costClass: 'low',
+            reason: activation === 'force' ? 'Team-mode was forced, so router selects the lowest-cost review-lite team.' : 'Task metadata indicates review or validation evidence is useful, so router selects review-lite.',
+            costRoute: activation === 'force' ? 'no_downgrade' : 'downgraded',
+            downgradeReason: activation === 'force' ? null : 'Low-cost review-lite route keeps reviewer/validator artifacts and policy-backed verify mandatory.',
+            trustPolicyEnforced: true,
+            allowedWaves: selectTeamWaves(['implementation_review', 'validation']),
+            memberProfiles: ['reviewer', 'validator'],
+            maxMembers: 2
+        });
+    }
+    return baseTeamModePolicy({
+        activation,
+        mode: 'off',
+        enabled: false,
+        decision: 'disabled',
+        costClass: 'none',
+        reason: 'No shared task risk profile signals require an agent team.',
+        costRoute: 'downgraded',
+        downgradeReason: 'Shared risk profile is low; artifact trust policy and policy-backed verify remain mandatory.',
+        trustPolicyEnforced: true
+    });
+}
+//# sourceMappingURL=team-mode.js.map

package/packages/core/dist/router/team-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-mode.js","sourceRoot":"","sources":["../../src/router/team-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAYlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,UAAU,yBAAyB,CAAC,OAA+E,EAAE,iBAAqC;IAC9J,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,kBAAkB,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,kBAAkB,CAAC,KAc3B;IACC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IACnJ,OAAO;QACL,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,gBAAgB;QAC9C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;QAC9C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI;QACtD,YAAY,EAAE,cAAc;QAC5B,cAAc;QACd,YAAY;QACZ,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,cAAc,CAAC,MAAM;QACrD,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,IAAI;QAC1C,kBAAkB,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAsC;IAC7D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAgC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACjJ,CAAC;AAGD,MAAM,UAAU,mBAAmB,CAAC,OAA8L;IAChO,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,kBAAkB,CAAC;YACxB,UAAU;YACV,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,OAAO,CAAC,aAAa;YAC7B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,SAAS;YACpB,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;YACxB,UAAU;YACV,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,+CAA+C;YACvD,SAAS,EAAE,gBAAgB;YAC3B,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC;IAChD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACnH,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,KAAK,MAAM,IAAI,eAAe,KAAK,0BAA0B,IAAI,eAAe,KAAK,gCAAgC,CAAC;IACxJ,MAAM,YAAY,GAAG,QAAQ,KAAK,uBAAuB,IAAI,QAAQ,KAAK,YAAY,IAAI,OAAO,CAAC,kBAAkB,KAAK,aAAa,CAAC;IAEvI,IAAI,OAAO,CAAC,iBAAiB,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;QAClE,OAAO,kBAAkB,CAAC;YACxB,UAAU;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,yFAAyF;YACjG,SAAS,EAAE,cAAc;YACzB,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,eAAe,CAAC,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;YAClE,cAAc,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC;YACrD,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;QACjD,OAAO,kBAAkB,CAAC;YACxB,UAAU;YACV,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YACvC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,kFAAkF,CAAC,CAAC,CAAC,+GAA+G;YACrO,SAAS,EAAE,cAAc;YACzB,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,eAAe,CAAC,CAAC,WAAW,EAAE,uBAAuB,EAAE,YAAY,CAAC,CAAC;YACnF,cAAc,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC;YAClE,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3C,OAAO,kBAAkB,CAAC;YACxB,UAAU;YACV,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,2EAA2E,CAAC,CAAC,CAAC,iGAAiG;YAChN,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY;YACjE,eAAe,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mGAAmG;YACpJ,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,eAAe,CAAC,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC;YACtE,cAAc,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;YACzC,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,kBAAkB,CAAC;QACxB,UAAU;QACV,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,4DAA4D;QACpE,SAAS,EAAE,YAAY;QACvB,eAAe,EAAE,8FAA8F;QAC/G,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/packages/core/dist/router.d.ts

@@ -0,0 +1,4 @@
+export * from './router/agent-runtime-config.js';
+export * from './router/agent-runtime.js';
+export * from './router/route-cache.js';
+export * from './router/route-sdd-task.js';

package/packages/core/dist/router.js

@@ -0,0 +1,5 @@
+export * from './router/agent-runtime-config.js';
+export * from './router/agent-runtime.js';
+export * from './router/route-cache.js';
+export * from './router/route-sdd-task.js';
+//# sourceMappingURL=router.js.map

package/packages/core/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/packages/core/dist/run-state/artifacts.d.ts

@@ -0,0 +1,6 @@
+export declare function writeArtifact(projectRoot: string, runId: string, artifactRootRelativePath: string, content: string): Promise<{
+    absolutePath: string;
+    runRelativePath: string;
+}>;
+export declare function readArtifact(projectRoot: string, runId: string, artifactRootRelativePath: string): Promise<string>;
+export declare function artifactKind(artifactPath: string): string;

package/packages/core/dist/run-state/artifacts.js

@@ -0,0 +1,113 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getEvidenceAttachmentPath, getLegacyArtifactPath, getRunRelativeArtifactPath, normalizeArtifactRootRelativePath } from '../runtime-paths.js';
+import { readRuntimeRunState, recordRuntimeArtifactPayload, recordRuntimeEvidenceAttachment, resolveRuntimeArtifactPayload, runtimeScopedId, withRuntimeStore } from '../storage/runtime-store.js';
+import { appendArtifactHashLedgerEntry } from './invocation-ledger.js';
+export async function writeArtifact(projectRoot, runId, artifactRootRelativePath, content) {
+    const normalized = normalizeArtifactRootRelativePath(artifactRootRelativePath);
+    const runRelativePath = getRunRelativeArtifactPath(normalized);
+    const runScope = await resolveRunScope(projectRoot, runId);
+    const contentHash = hashDocumentContent(content);
+    const physicalPayloadPath = uniquePhysicalPayloadPath(runRelativePath, runId, contentHash);
+    const absolutePath = getEvidenceAttachmentPath(projectRoot, runScope.branchSlug, physicalPayloadPath);
+    await mkdir(path.dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, content, 'utf8');
+    await appendArtifactHashLedgerEntry(projectRoot, {
+        runId,
+        artifactPath: runRelativePath,
+        content,
+        status: 'written'
+    });
+    await recordRuntimeArtifact(projectRoot, { runId, path: runRelativePath, content, status: 'written', taskId: runScope.taskId });
+    await recordRuntimeArtifactPayload(projectRoot, {
+        payloadId: runtimeScopedId(runId, runRelativePath, contentHash),
+        runId,
+        sourceRunId: runId,
+        branchSlug: runScope.branchSlug,
+        taskId: runScope.taskId,
+        logicalRef: runRelativePath,
+        physicalPayloadPath,
+        artifactRole: artifactKind(runRelativePath),
+        digest: contentHash,
+        status: 'active',
+        payload: { logicalRef: runRelativePath, physicalPayloadPath, artifactPath: runRelativePath, status: 'written' }
+    });
+    await recordRuntimeEvidenceAttachment(projectRoot, {
+        branchSlug: runScope.branchSlug,
+        runId,
+        taskId: runScope.taskId,
+        kind: artifactKind(runRelativePath),
+        relativePath: physicalPayloadPath,
+        contentHash,
+        bytes: Buffer.byteLength(content, 'utf8'),
+        payload: { logicalRef: runRelativePath, physicalPayloadPath, status: 'written' }
+    });
+    return { absolutePath, runRelativePath };
+}
+export async function readArtifact(projectRoot, runId, artifactRootRelativePath) {
+    const normalized = normalizeArtifactRootRelativePath(artifactRootRelativePath);
+    const runRelativePath = getRunRelativeArtifactPath(normalized);
+    const payload = await resolveRuntimeArtifactPayload(projectRoot, runId, runRelativePath);
+    const runScope = await resolveRunScope(projectRoot, runId);
+    const evidencePath = getEvidenceAttachmentPath(projectRoot, runScope.branchSlug, payload?.physicalPayloadPath ?? runRelativePath);
+    if (payload) {
+        return readFile(evidencePath, 'utf8');
+    }
+    try {
+        return await readFile(evidencePath, 'utf8');
+    }
+    catch {
+        return readFile(getLegacyArtifactPath(projectRoot, runId, normalized), 'utf8');
+    }
+}
+function uniquePhysicalPayloadPath(logicalRef, runId, digest) {
+    const parsed = path.posix.parse(logicalRef.replace(/\\/g, '/'));
+    const suffix = `${runId}-${digest.slice(0, 12)}`;
+    return path.posix.join(parsed.dir, `${parsed.name}-${suffix}${parsed.ext}`);
+}
+export function artifactKind(artifactPath) {
+    const fileName = path.posix.basename(artifactPath.replace(/\\/g, '/'));
+    if (fileName.startsWith('implement-')) {
+        return 'implement';
+    }
+    if (fileName.startsWith('review-')) {
+        return 'review';
+    }
+    if (fileName.startsWith('debug-')) {
+        return 'debug';
+    }
+    if (fileName.startsWith('test-validation-')) {
+        return 'test-validation';
+    }
+    if (fileName.startsWith('validation-')) {
+        return 'validation';
+    }
+    if (fileName.startsWith('gap-report-')) {
+        return 'gap-report';
+    }
+    if (fileName === 'sync-back-proposal.md') {
+        return 'sync-back-proposal';
+    }
+    return 'artifact';
+}
+async function recordRuntimeArtifact(projectRoot, input) {
+    const contentHash = hashDocumentContent(input.content);
+    const now = new Date().toISOString();
+    const payload = JSON.stringify({ path: input.path, status: input.status, taskId: input.taskId ?? null, agent: input.agent ?? null });
+    await withRuntimeStore(projectRoot, ({ db }) => {
+        db.prepare('INSERT OR REPLACE INTO artifacts (artifact_id, run_id, path, kind, task_id, agent, content_hash, bytes, status, created_at, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+            .run(runtimeScopedId(input.runId, input.path, contentHash), input.runId, input.path, artifactKind(input.path), input.taskId ?? null, input.agent ?? null, contentHash, Buffer.byteLength(input.content, 'utf8'), input.status, now, payload);
+    });
+}
+async function resolveRunScope(projectRoot, runId) {
+    const state = await readRuntimeRunState(projectRoot, runId);
+    return {
+        branchSlug: state?.gitBranch ?? state?.partition ?? 'unscoped',
+        taskId: state?.taskId ?? state?.currentTask ?? null
+    };
+}
+function hashDocumentContent(raw) {
+    return createHash('sha256').update(raw.replace(/\r\n/g, '\n'), 'utf8').digest('hex');
+}
+//# sourceMappingURL=artifacts.js.map

package/packages/core/dist/run-state/artifacts.js.map

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

package/packages/core/dist/run-state/events.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeEvent } from './model.js';
+export declare function appendEvent(projectRoot: string, runId: string, event: Omit<RuntimeEvent, 'contract' | 'time'>): Promise<RuntimeEvent>;
+export declare function readRunEvents(projectRoot: string, runId: string): Promise<RuntimeEvent[]>;

package/packages/core/dist/run-state/events.js

@@ -0,0 +1,23 @@
+import path from 'node:path';
+import { EVENT_LOG_CONTRACT } from '../contracts.js';
+import { getLegacyRunDir } from '../runtime-paths.js';
+import { importLegacyRunEventsIfNeeded, readRuntimeRunEvents, recordRuntimeEvent } from '../storage/runtime-store.js';
+export async function appendEvent(projectRoot, runId, event) {
+    const nextEvent = {
+        contract: EVENT_LOG_CONTRACT,
+        time: new Date().toISOString(),
+        ...event
+    };
+    await recordRuntimeEvent(projectRoot, nextEvent);
+    return nextEvent;
+}
+export async function readRunEvents(projectRoot, runId) {
+    const storedEvents = await readRuntimeRunEvents(projectRoot, runId);
+    if (storedEvents.length > 0) {
+        return storedEvents;
+    }
+    const eventPath = path.join(getLegacyRunDir(projectRoot, runId), 'events.jsonl');
+    await importLegacyRunEventsIfNeeded(projectRoot, runId, eventPath);
+    return readRuntimeRunEvents(projectRoot, runId);
+}
+//# sourceMappingURL=events.js.map

package/packages/core/dist/run-state/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/run-state/events.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB,EAAE,KAAa,EAAE,KAA8C;IAClH,MAAM,SAAS,GAAiB;QAC9B,QAAQ,EAAE,kBAAkB;QAC5B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC9B,GAAG,KAAK;KACT,CAAC;IACF,MAAM,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,KAAa;IACpE,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACpE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;IACjF,MAAM,6BAA6B,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACnE,OAAO,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC"}