sdd-agent-platform 0.3.0 → 0.4.1

package/node_modules/@sdd-agent-platform/core/dist/execution/stage-team-runtime.js

@@ -0,0 +1,145 @@
+import { STAGE_TEAM_RUNTIME_CONTRACT_VERSION } from '../contracts.js';
+const FORBIDDEN_LIFECYCLE_FIELDS = new Set([
+    'stage_passed',
+    'stagePassed',
+    'task_completed',
+    'taskCompleted',
+    'sync_back_approved',
+    'syncBackApproved',
+    'ship_ready',
+    'shipReady',
+    'final_pass',
+    'finalPass'
+]);
+export function assertValidStageRoleResult(value) {
+    const forbidden = firstForbiddenLifecycleField(value);
+    if (forbidden) {
+        throw new Error(`RoleResult cannot carry lifecycle transition field ${forbidden}.`);
+    }
+    const outputKind = value.outputKind;
+    if (!isStageRoleResultKind(outputKind)) {
+        throw new Error(`RoleResult outputKind must be one of evidence, review, gap, proposal, diagnostic, gate_assessment.`);
+    }
+    const authorityCeiling = value.authorityCeiling;
+    if (!isStageRoleAuthorityCeiling(authorityCeiling)) {
+        throw new Error(`RoleResult authorityCeiling is invalid.`);
+    }
+}
+export function assertAdvisoryAssessment(value) {
+    const forbidden = firstForbiddenLifecycleField(value);
+    if (forbidden) {
+        throw new Error(`LLM advisor assessment cannot carry lifecycle transition field ${forbidden}.`);
+    }
+    if (value.advisoryOnly !== true) {
+        throw new Error('LLM advisor assessment must be advisoryOnly=true.');
+    }
+    const validity = value.validity;
+    if (validity !== 'valid' && validity !== 'invalid') {
+        throw new Error('LLM advisor assessment validity must be valid or invalid.');
+    }
+    const confidence = value.confidence;
+    if (confidence !== 'low' && confidence !== 'medium' && confidence !== 'high') {
+        throw new Error('LLM advisor assessment confidence must be low, medium, or high.');
+    }
+}
+export function assertValidFanInEvidenceSet(value) {
+    const forbidden = firstForbiddenLifecycleField(value);
+    if (forbidden) {
+        throw new Error(`FanInEvidenceSet cannot carry lifecycle transition field ${forbidden}.`);
+    }
+    if (value.gateInputOnly !== true) {
+        throw new Error('FanInEvidenceSet must be gateInputOnly=true.');
+    }
+}
+export function buildFanInEvidenceSet(input) {
+    assertValidFanInEvidenceSet({ ...input, gateInputOnly: true });
+    return {
+        contract: STAGE_TEAM_RUNTIME_CONTRACT_VERSION,
+        ...input,
+        roleResultIds: sortedUnique(input.roleResultIds),
+        durableGapIds: sortedUnique(input.durableGapIds),
+        proposalRefs: sortedUnique(input.proposalRefs),
+        advisorAssessmentIds: sortedUnique(input.advisorAssessmentIds),
+        evidenceRefs: sortedUnique(input.evidenceRefs),
+        canonicalEvidenceRefs: sortedUnique(input.canonicalEvidenceRefs),
+        gateInputOnly: true
+    };
+}
+export function describeStageTeamActivation(profile) {
+    const roles = activationRoles(profile);
+    return {
+        contract: STAGE_TEAM_RUNTIME_CONTRACT_VERSION,
+        profile,
+        requiredTeam: profile !== 'direct',
+        roles,
+        reason: activationReason(profile)
+    };
+}
+function activationRoles(profile) {
+    switch (profile) {
+        case 'direct':
+            return [];
+        case 'compact':
+            return [activationRole('role.implementation-reviewer', true, false, 'Compact profile adds one independent reviewer for bounded risk.')];
+        case 'full':
+            return [
+                activationRole('role.norm-scout', true, true, 'Full profile checks project norms before stage output.'),
+                activationRole('role.implementation-reviewer', true, false, 'Full profile requires implementation or contract review.'),
+                activationRole('role.evidence-runner', true, false, 'Full profile requires evidence collection as gate input.')
+            ];
+        case 'research':
+            return [
+                activationRole('role.norm-scout', true, true, 'Research profile gathers external and project norm context.'),
+                activationRole('role.uncertainty-reviewer', true, true, 'Research profile records unresolved ambiguity as advisory input.'),
+                activationRole('role.performance-planner', false, true, 'Research profile can add performance/token planning when relevant.')
+            ];
+        case 'recover':
+            return [
+                activationRole('role.context-curator', true, true, 'Recover profile reconstructs trusted context.'),
+                activationRole('role.sync-risk-reviewer', true, false, 'Recover profile reviews shared-state/writeback risk.'),
+                activationRole('role.verification-designer', true, false, 'Recover profile rebuilds validation needs before retry.')
+            ];
+    }
+}
+function activationRole(roleId, required, advisory, reason) {
+    return { roleId, required, advisory, reason };
+}
+function activationReason(profile) {
+    switch (profile) {
+        case 'direct':
+            return 'Direct profile does not require team activation; deterministic checks and explicit artifacts remain sufficient.';
+        case 'compact':
+            return 'Compact profile activates a minimal independent role for moderate risk without slowing simple flows.';
+        case 'full':
+            return 'Full profile activates norm, review, and evidence roles for high-risk implementation paths.';
+        case 'research':
+            return 'Research profile activates context and uncertainty roles for decisions that need broader evidence.';
+        case 'recover':
+            return 'Recover profile activates context, sync-risk, and verification roles because prior workflow evidence is blocked or stale.';
+    }
+}
+function isStageRoleResultKind(value) {
+    return value === 'evidence' || value === 'review' || value === 'gap' || value === 'proposal' || value === 'diagnostic' || value === 'gate_assessment';
+}
+function isStageRoleAuthorityCeiling(value) {
+    return value === 'advisory_only' || value === 'evidence_input' || value === 'proposal_input' || value === 'gate_input';
+}
+function firstForbiddenLifecycleField(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_LIFECYCLE_FIELDS.has(key)) {
+            return key;
+        }
+        const nested = firstForbiddenLifecycleField(child);
+        if (nested) {
+            return nested;
+        }
+    }
+    return null;
+}
+function sortedUnique(values) {
+    return [...new Set(values.filter(Boolean))].sort();
+}
+//# sourceMappingURL=stage-team-runtime.js.map

package/node_modules/@sdd-agent-platform/core/dist/execution/stage-team-runtime.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/execution/wave-executor.d.ts

@@ -0,0 +1,45 @@
+import { WAVE_EXECUTOR_CONTRACT_VERSION } from '../contracts.js';
+import { type ContractValidationIssue } from '../contracts/issues.js';
+import type { RuntimeEvent } from '../run-state/model.js';
+import type { WavePlanGate } from '../planning/wave-plan.js';
+import type { BackgroundExecutorInspection, BackgroundExecutorResult } from './background-executor.js';
+export type WaveExecutorStrategy = 'fast-stop' | 'safe-continue';
+export type WaveExecutorStatus = 'claimed' | 'completed' | 'failed' | 'blocked';
+export interface WaveExecutorRunOptions {
+    branch?: string;
+    runId?: string;
+    capabilityId?: string;
+    agent?: string;
+    workerAdapterId?: string;
+    strategy?: WaveExecutorStrategy;
+    artifactPaths?: Record<string, string>;
+}
+export interface WaveExecutorTaskResult {
+    waveIndex: number;
+    taskId: string;
+    result: BackgroundExecutorResult;
+}
+export interface WaveExecutorResult {
+    version: typeof WAVE_EXECUTOR_CONTRACT_VERSION;
+    runId: string;
+    branch: string;
+    strategy: WaveExecutorStrategy;
+    status: WaveExecutorStatus;
+    plannedWaves: number;
+    executedWaves: number;
+    taskResults: WaveExecutorTaskResult[];
+    manualGates: WavePlanGate[];
+    blockedTasks: WavePlanGate[];
+    issues: ContractValidationIssue[];
+    message: string;
+}
+export interface WaveExecutorInspection {
+    version: typeof WAVE_EXECUTOR_CONTRACT_VERSION;
+    runId: string;
+    background: BackgroundExecutorInspection;
+    waveEvents: RuntimeEvent[];
+    valid: boolean;
+    issues: ContractValidationIssue[];
+}
+export declare function inspectWaveExecutor(projectRoot: string, runId: string): Promise<WaveExecutorInspection>;
+export declare function runWaveExecutor(projectRoot: string, options?: WaveExecutorRunOptions): Promise<WaveExecutorResult>;

package/node_modules/@sdd-agent-platform/core/dist/execution/wave-executor.js

@@ -0,0 +1,178 @@
+import { WAVE_EXECUTOR_CONTRACT_VERSION } from '../contracts.js';
+import { contractIssue } from '../contracts/issues.js';
+import { evaluateGovernancePolicy } from '../governance/policy.js';
+import { inspectWavePlan } from '../planning/wave-plan.js';
+import { appendEvent, readRunEvents } from '../run-state/events.js';
+import { createRun, readRunState, writeRunState } from '../run-state/run-state.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { inspectBackgroundExecutor, runBackgroundExecutor } from './background-executor.js';
+export async function inspectWaveExecutor(projectRoot, runId) {
+    const [background, events] = await Promise.all([
+        inspectBackgroundExecutor(projectRoot, runId),
+        readRunEvents(projectRoot, runId)
+    ]);
+    const waveEvents = events.filter((event) => event.event.startsWith('wave_executor_'));
+    const issues = [...background.issues];
+    if (waveEvents.length === 0) {
+        issues.push(contractIssue('wave_executor', `Run ${runId} has no wave executor events.`, 'Run sdd wave run before inspecting wave executor evidence.'));
+    }
+    return {
+        version: WAVE_EXECUTOR_CONTRACT_VERSION,
+        runId,
+        background,
+        waveEvents,
+        valid: issues.length === 0,
+        issues
+    };
+}
+export async function runWaveExecutor(projectRoot, options = {}) {
+    const branch = options.branch ?? (await resolveSddContext(projectRoot)).branch;
+    const strategy = options.strategy ?? 'fast-stop';
+    const agent = options.agent ?? 'implementer';
+    const workerAdapterId = options.workerAdapterId ?? 'sdd-cli-task-worker';
+    const runState = options.runId ? await readRunState(projectRoot, options.runId) : await createRun(projectRoot);
+    const runId = runState.runId;
+    const plan = await inspectWavePlan(projectRoot, { branch, capabilityId: options.capabilityId ?? 'native-file-edit' });
+    const issues = [];
+    const taskResults = [];
+    const governance = await evaluateGovernancePolicy(projectRoot, {
+        operation: 'wave_executor',
+        runId,
+        workerAdapterId,
+        riskTags: plan.manualGates.flatMap((gate) => gate.reasons)
+    });
+    if (!governance.allowed) {
+        await appendEvent(projectRoot, runId, { event: 'governance_policy_blocked', runId, summary: `Governance policy blocked wave executor for ${branch}`, data: { branch, strategy, decision: governance } });
+        await writeRunState(projectRoot, { ...runState, status: 'blocked', phase: 'wave', currentTask: null });
+        return {
+            version: WAVE_EXECUTOR_CONTRACT_VERSION,
+            runId,
+            branch,
+            strategy,
+            status: 'blocked',
+            plannedWaves: plan.waves.length,
+            executedWaves: 0,
+            taskResults,
+            manualGates: plan.manualGates,
+            blockedTasks: plan.blockedTasks,
+            issues: governance.issues,
+            message: 'Wave executor blocked by governance policy.'
+        };
+    }
+    await writeRunState(projectRoot, {
+        ...runState,
+        status: 'running',
+        phase: 'wave',
+        currentTask: null
+    });
+    await appendEvent(projectRoot, runId, {
+        event: 'wave_executor_started',
+        runId,
+        summary: `Wave executor started for ${branch}`,
+        data: { branch, strategy, plannedWaves: plan.waves.length }
+    });
+    if (!plan.valid || plan.manualGates.length > 0 || plan.blockedTasks.length > 0) {
+        for (const gate of [...plan.manualGates, ...plan.blockedTasks]) {
+            issues.push(contractIssue(`task:${gate.taskId}`, gate.reasons.join(' | '), 'Resolve manual or blocked wave gates before running the wave executor.'));
+        }
+        await appendEvent(projectRoot, runId, {
+            event: 'wave_executor_blocked',
+            runId,
+            summary: `Wave executor blocked for ${branch}`,
+            data: { branch, manualGates: plan.manualGates, blockedTasks: plan.blockedTasks, issues }
+        });
+        const blockedState = await readRunState(projectRoot, runId);
+        await writeRunState(projectRoot, { ...blockedState, status: 'blocked', phase: 'wave', currentTask: null });
+        return {
+            version: WAVE_EXECUTOR_CONTRACT_VERSION,
+            runId,
+            branch,
+            strategy,
+            status: 'blocked',
+            plannedWaves: plan.waves.length,
+            executedWaves: 0,
+            taskResults,
+            manualGates: plan.manualGates,
+            blockedTasks: plan.blockedTasks,
+            issues,
+            message: 'Wave executor blocked before executing planned tasks.'
+        };
+    }
+    let executedWaves = 0;
+    let stopAfterWave = false;
+    for (const wave of plan.waves) {
+        executedWaves += 1;
+        await appendEvent(projectRoot, runId, {
+            event: 'wave_executor_wave_started',
+            runId,
+            summary: `Wave ${wave.index} started`,
+            data: { branch, waveIndex: wave.index, taskIds: wave.tasks.map((task) => task.taskId) }
+        });
+        let waveTerminalCompleted = true;
+        for (const task of wave.tasks) {
+            const result = await runBackgroundExecutor(projectRoot, {
+                branch,
+                runId,
+                taskId: task.taskId,
+                agent,
+                workerAdapterId,
+                artifactPath: options.artifactPaths?.[task.taskId],
+                delegationId: `W${wave.index}-${task.taskId}-${agent}-001`
+            });
+            taskResults.push({ waveIndex: wave.index, taskId: task.taskId, result });
+            issues.push(...result.issues);
+            if (result.status !== 'completed') {
+                waveTerminalCompleted = false;
+                stopAfterWave = true;
+                if (strategy === 'fast-stop') {
+                    break;
+                }
+            }
+        }
+        await appendEvent(projectRoot, runId, {
+            event: 'wave_executor_wave_completed',
+            runId,
+            summary: `Wave ${wave.index} ${waveTerminalCompleted ? 'completed' : 'stopped'}`,
+            data: { branch, waveIndex: wave.index, completed: waveTerminalCompleted }
+        });
+        if (stopAfterWave) {
+            break;
+        }
+    }
+    const statuses = taskResults.map((task) => task.result.status);
+    const status = statuses.includes('blocked')
+        ? 'blocked'
+        : statuses.includes('failed')
+            ? 'failed'
+            : statuses.includes('claimed') || taskResults.length < plan.summary.plannedTasks
+                ? 'claimed'
+                : 'completed';
+    const completedState = await readRunState(projectRoot, runId);
+    await writeRunState(projectRoot, {
+        ...completedState,
+        status: status === 'completed' ? 'completed' : status === 'failed' ? 'failed' : status === 'blocked' ? 'blocked' : 'running',
+        phase: 'wave',
+        currentTask: null
+    });
+    await appendEvent(projectRoot, runId, {
+        event: status === 'completed' ? 'wave_executor_completed' : 'wave_executor_stopped',
+        runId,
+        summary: `Wave executor ${status} for ${branch}`,
+        data: { branch, strategy, status, executedWaves, taskResults: taskResults.map((task) => ({ waveIndex: task.waveIndex, taskId: task.taskId, status: task.result.status })) }
+    });
+    return {
+        version: WAVE_EXECUTOR_CONTRACT_VERSION,
+        runId,
+        branch,
+        strategy,
+        status,
+        plannedWaves: plan.waves.length,
+        executedWaves,
+        taskResults,
+        manualGates: [],
+        blockedTasks: [],
+        issues,
+        message: `Wave executor ${status} after ${executedWaves} wave(s).`
+    };
+}
+//# sourceMappingURL=wave-executor.js.map

package/node_modules/@sdd-agent-platform/core/dist/execution/wave-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave-executor.js","sourceRoot":"","sources":["../../src/execution/wave-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAgC,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA8C5F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB,EAAE,KAAa;IAC1E,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC;QAC7C,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC;KAClC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,OAAO,KAAK,+BAA+B,EAAE,4DAA4D,CAAC,CAAC,CAAC;IACzJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,8BAA8B;QACvC,KAAK;QACL,UAAU;QACV,UAAU;QACV,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,UAAkC,EAAE;IAC7F,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,qBAAqB,CAAC;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,kBAAkB,EAAE,CAAC,CAAC;IACtH,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,MAAM,WAAW,GAA6B,EAAE,CAAC;IAEjD,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,WAAW,EAAE;QAC7D,SAAS,EAAE,eAAe;QAC1B,KAAK;QACL,eAAe;QACf,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;KAC3D,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,KAAK,EAAE,OAAO,EAAE,+CAA+C,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACzM,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvG,OAAO;YACL,OAAO,EAAE,8BAA8B;YACvC,KAAK;YACL,MAAM;YACN,QAAQ;YACR,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YAC/B,aAAa,EAAE,CAAC;YAChB,WAAW;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,6CAA6C;SACvD,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,CAAC,WAAW,EAAE;QAC/B,GAAG,QAAQ;QACX,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IACH,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE;QACpC,KAAK,EAAE,uBAAuB;QAC9B,KAAK;QACL,OAAO,EAAE,6BAA6B,MAAM,EAAE;QAC9C,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;KAC5D,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,wEAAwE,CAAC,CAAC,CAAC;QACxJ,CAAC;QACD,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE;YACpC,KAAK,EAAE,uBAAuB;YAC9B,KAAK;YACL,OAAO,EAAE,6BAA6B,MAAM,EAAE;YAC9C,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE;SACzF,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC5D,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,GAAG,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3G,OAAO;YACL,OAAO,EAAE,8BAA8B;YACvC,KAAK;YACL,MAAM;YACN,QAAQ;YACR,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YAC/B,aAAa,EAAE,CAAC;YAChB,WAAW;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM;YACN,OAAO,EAAE,uDAAuD;SACjE,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,aAAa,IAAI,CAAC,CAAC;QACnB,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE;YACpC,KAAK,EAAE,4BAA4B;YACnC,KAAK;YACL,OAAO,EAAE,QAAQ,IAAI,CAAC,KAAK,UAAU;YACrC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;SACxF,CAAC,CAAC;QACH,IAAI,qBAAqB,GAAG,IAAI,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE;gBACtD,MAAM;gBACN,KAAK;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK;gBACL,eAAe;gBACf,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;gBAClD,YAAY,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,MAAM;aAC3D,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,qBAAqB,GAAG,KAAK,CAAC;gBAC9B,aAAa,GAAG,IAAI,CAAC;gBACrB,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;oBAC7B,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE;YACpC,KAAK,EAAE,8BAA8B;YACrC,KAAK;YACL,OAAO,EAAE,QAAQ,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE;YAChF,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE;SAC1E,CAAC,CAAC;QACH,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAuB,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC7D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY;gBAC9E,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,WAAW,CAAC;IACpB,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,aAAa,CAAC,WAAW,EAAE;QAC/B,GAAG,cAAc;QACjB,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC5H,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IACH,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE;QACpC,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,uBAAuB;QACnF,KAAK;QACL,OAAO,EAAE,iBAAiB,MAAM,QAAQ,MAAM,EAAE;QAChD,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;KAC5K,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,8BAA8B;QACvC,KAAK;QACL,MAAM;QACN,QAAQ;QACR,MAAM;QACN,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QAC/B,aAAa;QACb,WAAW;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,EAAE;QAChB,MAAM;QACN,OAAO,EAAE,iBAAiB,MAAM,UAAU,aAAa,WAAW;KACnE,CAAC;AACJ,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/execution.d.ts

@@ -0,0 +1,5 @@
+export * from './execution/agent-execution-records.js';
+export * from './execution/background-executor.js';
+export * from './execution/foreground-subagents.js';
+export * from './execution/resident-worker.js';
+export * from './execution/wave-executor.js';

package/node_modules/@sdd-agent-platform/core/dist/execution.js

@@ -0,0 +1,6 @@
+export * from './execution/agent-execution-records.js';
+export * from './execution/background-executor.js';
+export * from './execution/foreground-subagents.js';
+export * from './execution/resident-worker.js';
+export * from './execution/wave-executor.js';
+//# sourceMappingURL=execution.js.map

package/node_modules/@sdd-agent-platform/core/dist/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/governance/policy.d.ts

@@ -0,0 +1,53 @@
+import { GOVERNANCE_POLICY_CONTRACT_VERSION } from '../contracts.js';
+export type GovernancePolicyOperation = 'background_executor' | 'wave_executor' | 'sync_back_apply' | 'destructive_git' | 'external_interaction' | 'cleanup';
+export type GovernancePolicyDecisionStatus = 'allow' | 'block' | 'confirm';
+export interface GovernancePolicy {
+    version: typeof GOVERNANCE_POLICY_CONTRACT_VERSION;
+    concurrency: {
+        maxBackgroundDelegations: number;
+        maxWaveExecutors: number;
+    };
+    manualConfirmation: {
+        operations: GovernancePolicyOperation[];
+        workerAdapters: string[];
+        riskTags: string[];
+    };
+    cleanup: {
+        archiveOnly: true;
+        deleteRunHistory: false;
+    };
+    retry: {
+        reopenTerminalDelegation: false;
+        maxAttemptsPerDelegation: number;
+    };
+    stopConditions: string[];
+    audit: {
+        requiredEvents: string[];
+        requiredEvidence: string[];
+    };
+}
+export interface GovernancePolicyDecisionInput {
+    operation: GovernancePolicyOperation;
+    runId?: string;
+    taskId?: string;
+    workerAdapterId?: string;
+    riskTags?: string[];
+    approved?: boolean;
+    excludeQueueItemId?: string;
+}
+export interface GovernancePolicyIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface GovernancePolicyDecision {
+    version: typeof GOVERNANCE_POLICY_CONTRACT_VERSION;
+    operation: GovernancePolicyOperation;
+    status: GovernancePolicyDecisionStatus;
+    allowed: boolean;
+    reasons: string[];
+    issues: GovernancePolicyIssue[];
+    policy: GovernancePolicy;
+}
+export declare function inspectGovernancePolicy(projectRoot: string): Promise<GovernancePolicy>;
+export declare function evaluateGovernancePolicy(projectRoot: string, input: GovernancePolicyDecisionInput): Promise<GovernancePolicyDecision>;

package/node_modules/@sdd-agent-platform/core/dist/governance/policy.js

@@ -0,0 +1,111 @@
+import { GOVERNANCE_POLICY_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 { listDelegationQueueItems } from '../delegation/queue.js';
+import { readAllRunStates } from '../run-state/run-state.js';
+const BUILT_IN_GOVERNANCE_POLICY = {
+    version: GOVERNANCE_POLICY_CONTRACT_VERSION,
+    concurrency: {
+        maxBackgroundDelegations: 4,
+        maxWaveExecutors: 1
+    },
+    manualConfirmation: {
+        operations: ['sync_back_apply', 'destructive_git', 'external_interaction', 'cleanup'],
+        workerAdapters: ['manual-handoff-worker'],
+        riskTags: ['database', 'security', 'permission', 'external', 'destructive-git', 'data-loss']
+    },
+    cleanup: {
+        archiveOnly: true,
+        deleteRunHistory: false
+    },
+    retry: {
+        reopenTerminalDelegation: false,
+        maxAttemptsPerDelegation: 1
+    },
+    stopConditions: ['manual_confirmation_required', 'concurrency_limit_reached', 'terminal_delegation_reopen', 'planner_manual_gate', 'invalid_artifact_evidence'],
+    audit: {
+        requiredEvents: ['governance_policy_blocked', 'governance_policy_confirmed'],
+        requiredEvidence: ['policy version', 'operation', 'decision status', 'reason']
+    }
+};
+export async function inspectGovernancePolicy(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        ...BUILT_IN_GOVERNANCE_POLICY,
+        concurrency: { ...BUILT_IN_GOVERNANCE_POLICY.concurrency },
+        manualConfirmation: {
+            operations: [...BUILT_IN_GOVERNANCE_POLICY.manualConfirmation.operations],
+            workerAdapters: [...BUILT_IN_GOVERNANCE_POLICY.manualConfirmation.workerAdapters],
+            riskTags: [...BUILT_IN_GOVERNANCE_POLICY.manualConfirmation.riskTags]
+        },
+        cleanup: { ...BUILT_IN_GOVERNANCE_POLICY.cleanup },
+        retry: { ...BUILT_IN_GOVERNANCE_POLICY.retry },
+        stopConditions: [...BUILT_IN_GOVERNANCE_POLICY.stopConditions],
+        audit: {
+            requiredEvents: [...BUILT_IN_GOVERNANCE_POLICY.audit.requiredEvents],
+            requiredEvidence: [...BUILT_IN_GOVERNANCE_POLICY.audit.requiredEvidence]
+        }
+    };
+}
+export async function evaluateGovernancePolicy(projectRoot, input) {
+    const policy = await inspectGovernancePolicy(projectRoot);
+    const issues = [];
+    const reasons = [];
+    const queue = await listDelegationQueueItems(projectRoot);
+    const runningDelegations = queue.items.filter((item) => item.status === 'RUNNING' && item.id !== input.excludeQueueItemId).length;
+    const runningWaveExecutors = (await readAllRunStates(projectRoot)).filter((state) => state.status === 'running' && state.phase === 'wave').length;
+    if ((input.operation === 'background_executor' || input.operation === 'wave_executor') && runningDelegations >= policy.concurrency.maxBackgroundDelegations) {
+        const reason = `Running delegation count ${runningDelegations} reached governance limit ${policy.concurrency.maxBackgroundDelegations}.`;
+        reasons.push(reason);
+        issues.push(governanceIssue('governance.concurrency', reason, 'Wait for existing delegations to finish, archive stale exploratory runs, or inspect governance policy before starting more background work.'));
+    }
+    if (input.operation === 'wave_executor' && runningWaveExecutors >= policy.concurrency.maxWaveExecutors) {
+        const reason = `Running wave executor count ${runningWaveExecutors} reached governance limit ${policy.concurrency.maxWaveExecutors}.`;
+        reasons.push(reason);
+        issues.push(governanceIssue('governance.wave_concurrency', reason, 'Wait for the running wave executor to finish or archive the stale run before starting another wave.'));
+    }
+    const confirmationReasons = [];
+    if (policy.manualConfirmation.operations.includes(input.operation)) {
+        confirmationReasons.push(`Operation ${input.operation} requires explicit confirmation.`);
+    }
+    if (input.workerAdapterId && policy.manualConfirmation.workerAdapters.includes(input.workerAdapterId)) {
+        confirmationReasons.push(`Worker adapter ${input.workerAdapterId} requires manual confirmation.`);
+    }
+    const riskHits = (input.riskTags ?? []).filter((tag) => policy.manualConfirmation.riskTags.includes(tag));
+    if (riskHits.length > 0) {
+        confirmationReasons.push(`Risk tag(s) require confirmation: ${riskHits.join(', ')}.`);
+    }
+    if (confirmationReasons.length > 0 && !input.approved) {
+        reasons.push(...confirmationReasons);
+        for (const reason of confirmationReasons) {
+            issues.push(governanceIssue('governance.confirmation', reason, 'Get explicit user confirmation before continuing this governed operation.'));
+        }
+    }
+    if (confirmationReasons.length > 0 && input.approved) {
+        reasons.push(...confirmationReasons.map((reason) => `${reason} Approval recorded.`));
+    }
+    const status = issues.length > 0
+        ? confirmationReasons.length > 0 && issues.every((issue) => issue.field === 'governance.confirmation')
+            ? 'confirm'
+            : 'block'
+        : 'allow';
+    return {
+        version: GOVERNANCE_POLICY_CONTRACT_VERSION,
+        operation: input.operation,
+        status,
+        allowed: status === 'allow',
+        reasons: reasons.length > 0 ? reasons : [`Operation ${input.operation} is allowed by governance policy.`],
+        issues,
+        policy
+    };
+}
+function governanceIssue(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=policy.js.map

package/node_modules/@sdd-agent-platform/core/dist/governance/policy.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/governance.d.ts

@@ -0,0 +1 @@
+export * from './governance/policy.js';

package/node_modules/@sdd-agent-platform/core/dist/governance.js

@@ -0,0 +1,2 @@
+export * from './governance/policy.js';
+//# sourceMappingURL=governance.js.map

package/node_modules/@sdd-agent-platform/core/dist/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/node_modules/@sdd-agent-platform/core/dist/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/node_modules/@sdd-agent-platform/core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/{dist/packages/core/src → node_modules/@sdd-agent-platform/core/dist}/instructions.d.ts

@@ -1,5 +1,5 @@
 export declare const SDD_INSTRUCTIONS_CONTRACT = "sdd-instructions-v1";
-export type InstructionAction = 'overview' | 'init' | 'doctor' | 'update' | 'spec' | 'plan' | 'tasks' | 'do' | 'verify' | 'run-task' | 'verify-task';
+export type InstructionAction = 'overview' | 'init' | 'doctor' | 'update' | 'spec' | 'plan' | 'tasks' | 'verifies' | 'test' | 'do' | 'verify' | 'sync-back' | 'ship' | 'run-task' | 'verify-task';
 export interface SddInstructionPayload {
     contract: typeof SDD_INSTRUCTIONS_CONTRACT;
     version: string;