sdd-agent-platform 0.3.0 → 0.4.1

package/node_modules/@sdd-agent-platform/core/dist/delegation/state-machine.js

@@ -0,0 +1,56 @@
+export const DELEGATION_STATE_MACHINE_VERSION = 'phase-3.4-delegation-state-machine-v1';
+export const DELEGATION_STATUSES = ['PENDING', 'RUNNING', 'COMPLETED', 'FAILED', 'TIMED_OUT', 'CANCELLED', 'RECOVERABLE', 'STALE'];
+export const TERMINAL_DELEGATION_STATUSES = ['COMPLETED', 'FAILED', 'TIMED_OUT', 'CANCELLED'];
+const DELEGATION_STATE_TRANSITIONS = [
+    { from: 'PENDING', to: 'RUNNING', event: 'delegation_started', terminal: false },
+    { from: 'PENDING', to: 'CANCELLED', event: 'delegation_cancelled', terminal: true },
+    { from: 'RUNNING', to: 'COMPLETED', event: 'delegation_completed', terminal: true },
+    { from: 'RUNNING', to: 'FAILED', event: 'delegation_failed', terminal: true },
+    { from: 'RUNNING', to: 'TIMED_OUT', event: 'delegation_timeout', terminal: true },
+    { from: 'RUNNING', to: 'CANCELLED', event: 'delegation_cancelled', terminal: true },
+    { from: 'RUNNING', to: 'RECOVERABLE', event: 'artifact_invalid', terminal: false },
+    { from: 'RUNNING', to: 'STALE', event: 'delegation_stale', terminal: false },
+    { from: 'RECOVERABLE', to: 'RUNNING', event: 'delegation_retry_started', terminal: false },
+    { from: 'RECOVERABLE', to: 'FAILED', event: 'delegation_failed', terminal: true },
+    { from: 'RECOVERABLE', to: 'CANCELLED', event: 'delegation_cancelled', terminal: true },
+    { from: 'STALE', to: 'RUNNING', event: 'delegation_heartbeat', terminal: false },
+    { from: 'STALE', to: 'TIMED_OUT', event: 'delegation_timeout', terminal: true },
+    { from: 'STALE', to: 'FAILED', event: 'delegation_failed', terminal: true },
+    { from: 'STALE', to: 'CANCELLED', event: 'delegation_cancelled', terminal: true }
+];
+export function getDelegationStateMachine() {
+    return {
+        version: DELEGATION_STATE_MACHINE_VERSION,
+        statuses: [...DELEGATION_STATUSES],
+        terminalStatuses: [...TERMINAL_DELEGATION_STATUSES],
+        transitions: DELEGATION_STATE_TRANSITIONS.map((transition) => ({ ...transition }))
+    };
+}
+export function validateDelegationStateTransition(from, to, event = null) {
+    const issues = [];
+    if (!DELEGATION_STATUSES.includes(from)) {
+        issues.push(contractIssue('from', `Unsupported delegation status ${from}.`, 'Use a status declared by the Phase 3.4 delegation state machine.'));
+    }
+    if (!DELEGATION_STATUSES.includes(to)) {
+        issues.push(contractIssue('to', `Unsupported delegation status ${to}.`, 'Use a status declared by the Phase 3.4 delegation state machine.'));
+    }
+    if (TERMINAL_DELEGATION_STATUSES.includes(from)) {
+        issues.push(contractIssue('from', `Terminal delegation status ${from} cannot transition to ${to}.`, 'Create a new delegation id for retry instead of reopening a terminal delegation.'));
+    }
+    const transition = DELEGATION_STATE_TRANSITIONS.find((candidate) => candidate.from === from && candidate.to === to && (event === null || candidate.event === event));
+    if (!transition) {
+        const eventText = event === null ? '' : ` on ${event}`;
+        issues.push(contractIssue('transition', `Transition ${from} -> ${to}${eventText} is not allowed.`, 'Use one of the declared Phase 3.4 delegation state machine transitions.'));
+    }
+    return {
+        valid: issues.length === 0,
+        from,
+        to,
+        event,
+        issues
+    };
+}
+function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+//# sourceMappingURL=state-machine.js.map

package/node_modules/@sdd-agent-platform/core/dist/delegation/state-machine.js.map

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

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

@@ -0,0 +1,28 @@
+import type { DelegationRecord, DelegationStatus } from './model.js';
+export interface ContractValidationIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface DelegationValidationReport {
+    valid: boolean;
+    delegation: DelegationRecord;
+    terminal: boolean;
+    stale: boolean;
+    issues: ContractValidationIssue[];
+}
+export declare function createDelegationRecord(input: {
+    delegationId: string;
+    task: string;
+    agent: string;
+    expectedArtifact: string;
+    runMode?: DelegationRecord['runMode'];
+    blocking?: boolean;
+    requiredForPhaseExit?: boolean;
+    startedAt?: string;
+    timeoutSeconds?: number;
+    status?: DelegationStatus;
+}): DelegationRecord;
+export declare function isDelegationTerminal(status: DelegationStatus): boolean;
+export declare function isDelegationStale(delegation: DelegationRecord, now?: Date): boolean;
+export declare function validateDelegationRecord(projectRoot: string, runId: string, delegation: DelegationRecord, now?: Date): Promise<DelegationValidationReport>;

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

@@ -0,0 +1,100 @@
+import { DELEGATION_LIVENESS_CONTRACT, DELEGATION_LIVENESS_VERSION } from '../contracts.js';
+import { toArtifactRootRelativePath } from '../runtime-paths.js';
+import { validateSddResultArtifact } from '../artifacts/sdd-result.js';
+export function createDelegationRecord(input) {
+    return {
+        contract: DELEGATION_LIVENESS_CONTRACT,
+        version: DELEGATION_LIVENESS_VERSION,
+        delegationId: input.delegationId,
+        task: input.task,
+        agent: input.agent,
+        runMode: input.runMode ?? 'foreground',
+        blocking: input.blocking ?? true,
+        requiredForPhaseExit: input.requiredForPhaseExit ?? true,
+        status: input.status ?? 'RUNNING',
+        startedAt: input.startedAt ?? new Date().toISOString(),
+        lastHeartbeatAt: null,
+        timeoutSeconds: input.timeoutSeconds ?? 900,
+        expectedArtifact: input.expectedArtifact,
+        terminalEventRequired: true,
+        terminalEventAt: null
+    };
+}
+export function isDelegationTerminal(status) {
+    return status === 'COMPLETED' || status === 'FAILED' || status === 'TIMED_OUT' || status === 'CANCELLED';
+}
+export function isDelegationStale(delegation, now = new Date()) {
+    if (delegation.status !== 'RUNNING') {
+        return false;
+    }
+    const heartbeatOrStart = delegation.lastHeartbeatAt ?? delegation.startedAt;
+    const timestamp = Date.parse(heartbeatOrStart);
+    if (Number.isNaN(timestamp) || delegation.timeoutSeconds <= 0) {
+        return true;
+    }
+    return now.getTime() - timestamp > delegation.timeoutSeconds * 1000;
+}
+export async function validateDelegationRecord(projectRoot, runId, delegation, now = new Date()) {
+    const issues = [];
+    const terminal = isDelegationTerminal(delegation.status);
+    const stale = isDelegationStale(delegation, now);
+    issues.push(...validateDelegationShape(delegation));
+    if (stale) {
+        issues.push(contractIssue('status', `Delegation ${delegation.delegationId} is RUNNING but stale.`, 'Record TIMED_OUT/FAILED/CANCELLED or heartbeat before phase exit.'));
+    }
+    if (delegation.requiredForPhaseExit && delegation.terminalEventRequired && terminal && !delegation.terminalEventAt) {
+        issues.push(contractIssue('terminalEventAt', `Delegation ${delegation.delegationId} is terminal without a terminal event timestamp.`, 'Append and persist the terminal delegation event timestamp.'));
+    }
+    if (delegation.status === 'COMPLETED') {
+        const resultReport = await validateSddResultArtifact(projectRoot, runId, delegation.expectedArtifact, { expectedTask: delegation.task, expectedAgent: delegation.agent });
+        issues.push(...resultReport.issues);
+    }
+    return { valid: issues.length === 0, delegation, terminal, stale, issues };
+}
+function validateDelegationShape(delegation) {
+    const issues = [];
+    if (delegation.contract !== DELEGATION_LIVENESS_CONTRACT) {
+        issues.push(contractIssue('contract', `Expected ${DELEGATION_LIVENESS_CONTRACT}, got ${delegation.contract}.`, 'Use the delegation liveness contract id.'));
+    }
+    if (delegation.version !== DELEGATION_LIVENESS_VERSION) {
+        issues.push(contractIssue('version', `Expected ${DELEGATION_LIVENESS_VERSION}, got ${delegation.version}.`, 'Use version: 1.3.0 until a new contract version is introduced.'));
+    }
+    if (!delegation.delegationId) {
+        issues.push(contractIssue('delegationId', 'delegationId is required.', 'Persist a stable delegation id.'));
+    }
+    if (!delegation.task) {
+        issues.push(contractIssue('task', 'delegation task is required.', 'Persist the delegated task id.'));
+    }
+    if (!delegation.agent) {
+        issues.push(contractIssue('agent', 'delegation agent is required.', 'Persist the delegated agent name.'));
+    }
+    if (delegation.runMode !== 'foreground' && delegation.runMode !== 'background') {
+        issues.push(contractIssue('runMode', `Unsupported runMode ${delegation.runMode}.`, 'Use foreground or background.'));
+    }
+    if (!isDelegationStatus(delegation.status)) {
+        issues.push(contractIssue('status', `Unsupported delegation status ${delegation.status}.`, 'Use a status from the delegation liveness contract.'));
+    }
+    if (!Number.isInteger(delegation.timeoutSeconds) || delegation.timeoutSeconds <= 0) {
+        issues.push(contractIssue('timeoutSeconds', 'timeoutSeconds must be a positive integer.', 'Set an explicit positive timeout.'));
+    }
+    validateRunRelativeArtifactReference(delegation.expectedArtifact, issues, 'expectedArtifact');
+    return issues;
+}
+function validateRunRelativeArtifactReference(value, issues, field = 'artifacts') {
+    try {
+        toArtifactRootRelativePath(value);
+    }
+    catch (error) {
+        issues.push(contractIssue(field, messageFromError(error), 'Use run-relative artifacts/<file> paths that stay under the run artifact directory.'));
+    }
+}
+function isDelegationStatus(value) {
+    return value === 'PENDING' || value === 'RUNNING' || value === 'COMPLETED' || value === 'FAILED' || value === 'TIMED_OUT' || value === 'CANCELLED' || value === 'RECOVERABLE' || value === 'STALE';
+}
+function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+function messageFromError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=validation.js.map

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

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

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

@@ -0,0 +1,7 @@
+export * from './delegation/model.js';
+export * from './delegation/queue.js';
+export { persistDelegation } from './delegation/run-state.js';
+export { DELEGATION_STATE_MACHINE_VERSION, DELEGATION_STATUSES, TERMINAL_DELEGATION_STATUSES, getDelegationStateMachine, validateDelegationStateTransition } from './delegation/state-machine.js';
+export type { ContractValidationIssue as DelegationStateContractValidationIssue, DelegationStateMachine, DelegationStateTransition, DelegationStateTransitionValidation } from './delegation/state-machine.js';
+export { createDelegationRecord, isDelegationStale, isDelegationTerminal, validateDelegationRecord } from './delegation/validation.js';
+export type { ContractValidationIssue as DelegationRecordContractValidationIssue, DelegationValidationReport } from './delegation/validation.js';

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

@@ -0,0 +1,6 @@
+export * from './delegation/model.js';
+export * from './delegation/queue.js';
+export { persistDelegation } from './delegation/run-state.js';
+export { DELEGATION_STATE_MACHINE_VERSION, DELEGATION_STATUSES, TERMINAL_DELEGATION_STATUSES, getDelegationStateMachine, validateDelegationStateTransition } from './delegation/state-machine.js';
+export { createDelegationRecord, isDelegationStale, isDelegationTerminal, validateDelegationRecord } from './delegation/validation.js';
+//# sourceMappingURL=delegation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.js","sourceRoot":"","sources":["../src/delegation.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,4BAA4B,EAC5B,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/ai-entries.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from '../model.js';
+export declare function inspectAiToolEntryEvidence(projectRoot: string): Promise<DoctorCheck[]>;

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/ai-entries.js

@@ -0,0 +1,26 @@
+import { checkAiToolEntryDrift } from '../../ai-tools.js';
+export async function inspectAiToolEntryEvidence(projectRoot) {
+    const results = await checkAiToolEntryDrift(projectRoot);
+    const checks = results.flatMap((result) => result.entries.map((entry) => {
+        const check = `ai_entry_${entry.id}`;
+        const message = `${entry.relativePath}: ${entry.message}`;
+        if (entry.status === 'unchanged') {
+            return { level: 'PASS', check, message };
+        }
+        if (entry.status === 'missing' || entry.status === 'drifted') {
+            return { level: 'FAIL', check, message, action: entry.action ?? 'Run sdd update.' };
+        }
+        if (entry.status === 'user-modified') {
+            return { level: 'FAIL', check, message, action: entry.action ?? 'Review manually; sdd update will not overwrite user-modified entries by default.' };
+        }
+        if (entry.status === 'foreign' || entry.status === 'conflict') {
+            return { level: 'FAIL', check, message, action: entry.action ?? 'Review the target file before running sdd update.' };
+        }
+        return { level: 'WARN', check, message, action: entry.action };
+    }));
+    if (checks.length === 0) {
+        checks.push({ level: 'WARN', check: 'ai_entries', message: 'No AI tool adapters selected for drift inspection.', action: 'Run sdd init --ai claude-code if Claude Code entries are required.' });
+    }
+    return checks;
+}
+//# sourceMappingURL=ai-entries.js.map

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/ai-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-entries.js","sourceRoot":"","sources":["../../../src/doctor/checks/ai-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAmB;IAClE,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAe,EAAE;QACnF,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC3C,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACtF,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,kFAAkF,EAAE,CAAC;QACvJ,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,mDAAmD,EAAE,CAAC;QACxH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC,CAAC;IAEJ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,oDAAoD,EAAE,MAAM,EAAE,oEAAoE,EAAE,CAAC,CAAC;IACnM,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/document-chain.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from '../model.js';
+export declare function inspectDocumentChainEvidence(projectRoot: string, branch?: string | null): Promise<DoctorCheck[]>;

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/document-chain.js

@@ -0,0 +1,104 @@
+import { readFile } from 'node:fs/promises';
+import { messageFromError } from '../../contracts/issues.js';
+import { resolveSddContext } from '../../sdd-docs/context.js';
+import { parseSddBranch } from '../../sdd-docs/task-parser.js';
+import { inspectVerifyContract } from '../../verification/verify-contract.js';
+import { buildTaskRiskProfile } from '../../task-risk-profile.js';
+export async function inspectDocumentChainEvidence(projectRoot, branch) {
+    try {
+        const context = await resolveSddContext(projectRoot, branch ? { branch, branchSource: 'cli_option' } : {});
+        const model = await parseSddBranch(projectRoot, context.branch);
+        if (!model.documents.specExists || !model.documents.tasksExists) {
+            return [{
+                    level: 'WARN',
+                    check: 'document_chain',
+                    message: `Document chain skipped for ${context.branch}; spec.md or tasks.md is missing.`,
+                    action: 'Create specs/<branch>/spec.md and tasks.md before document-chain verification.'
+                }];
+        }
+        const checks = [];
+        const specRaw = await readFile(model.specPath, 'utf8');
+        const specAcceptanceIds = extractSpecAcceptanceIds(specRaw);
+        if (specAcceptanceIds.size === 0) {
+            checks.push({
+                level: 'WARN',
+                check: 'document_chain_spec_acceptance',
+                message: `No AC-* acceptance IDs found in ${sourceLocationEvidence({ filePath: model.specPath, heading: null, lineStart: 1, lineEnd: 1 })}.`,
+                action: 'Add stable acceptance IDs such as AC-1 in spec.md.'
+            });
+        }
+        for (const task of model.tasks) {
+            for (const ref of task.acceptanceRefs) {
+                if (!specAcceptanceIds.has(ref)) {
+                    checks.push({
+                        level: 'FAIL',
+                        check: 'document_chain_acceptance_ref',
+                        message: `Task ${task.id} references missing spec acceptance ${ref}.`,
+                        action: 'Fix acceptance_refs or add the referenced AC ID to spec.md.'
+                    });
+                }
+            }
+            if (isHighRiskTask(task)) {
+                if (task.requiredArtifacts.length === 0) {
+                    checks.push({
+                        level: 'FAIL',
+                        check: 'document_chain_high_risk_evidence',
+                        message: `High-risk task ${task.id} has no required_artifacts.`,
+                        action: 'Declare reviewer and validator artifacts before high-risk execution.'
+                    });
+                }
+                if (!task.requiredArtifacts.some((artifact) => /review/i.test(artifact)) || !task.requiredArtifacts.some((artifact) => /validation|validator/i.test(artifact))) {
+                    checks.push({
+                        level: 'WARN',
+                        check: 'document_chain_high_risk_evidence',
+                        message: `High-risk task ${task.id} should require explicit reviewer and validator evidence artifacts.`,
+                        action: 'Add artifacts/review-<task>.md and artifacts/validation-<task>.md or equivalent evidence paths.'
+                    });
+                }
+                if (task.verificationAvailability.length === 0) {
+                    checks.push({
+                        level: 'WARN',
+                        check: 'document_chain_high_risk_verification',
+                        message: `High-risk task ${task.id} has no verification_availability.`,
+                        action: 'Declare available unit/build/inspect/manual verification before high-risk execution.'
+                    });
+                }
+            }
+        }
+        const verifyInspection = await inspectVerifyContract(projectRoot, branch ? { branch, branchSource: 'cli_option' } : {});
+        for (const issue of verifyInspection.issues) {
+            checks.push({
+                level: issue.level === 'FAIL' ? 'FAIL' : 'WARN',
+                check: issue.field === 'verify.md' ? 'document_chain_verify_missing' : 'document_chain_verify_contract',
+                message: issue.message,
+                action: issue.action
+            });
+        }
+        if (checks.length === 0) {
+            checks.push({
+                level: 'PASS',
+                check: 'document_chain',
+                message: `Spec acceptance IDs, task evidence links, and verify.md contract are consistent for ${context.branch}.`
+            });
+        }
+        return checks;
+    }
+    catch (error) {
+        return [{
+                level: 'WARN',
+                check: 'document_chain',
+                message: `Document chain could not be inspected: ${messageFromError(error)}`,
+                action: 'Run sdd tasks gaps, sdd verifies inspect, and inspect specs/<branch>/spec.md/tasks.md manually.'
+            }];
+    }
+}
+function extractSpecAcceptanceIds(raw) {
+    return new Set(Array.from(raw.matchAll(/\bAC-[A-Za-z0-9._-]+\b/g)).map((match) => match[0]));
+}
+function isHighRiskTask(task) {
+    return buildTaskRiskProfile(task).riskLevel === 'high';
+}
+function sourceLocationEvidence(source) {
+    return `${source.filePath}:${source.lineStart}-${source.lineEnd}`;
+}
+//# sourceMappingURL=document-chain.js.map

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/document-chain.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/local-run-index.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from '../model.js';
+export declare function inspectLocalRunIndexEvidence(projectRoot: string): Promise<DoctorCheck[]>;

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/local-run-index.js

@@ -0,0 +1,26 @@
+import { inspectLocalRunIndex } from '../../run-state/run-index.js';
+export async function inspectLocalRunIndexEvidence(projectRoot) {
+    const inspection = await inspectLocalRunIndex(projectRoot);
+    if (!inspection.exists) {
+        return [{
+                level: 'WARN',
+                check: 'local_run_index',
+                message: 'Local run index projection is missing; runtime.sqlite remains the source of truth.',
+                action: 'Run sdd run index rebuild to create the derived index.'
+            }];
+    }
+    if (!inspection.valid) {
+        return inspection.issues.map((issue) => ({
+            level: 'WARN',
+            check: 'local_run_index',
+            message: issue.message,
+            action: issue.recommendation
+        }));
+    }
+    return [{
+            level: 'PASS',
+            check: 'local_run_index',
+            message: `Local run index is current with ${inspection.index?.runs.length ?? 0} run(s), ${inspection.index?.delegations.length ?? 0} delegation(s), and ${inspection.index?.artifacts.length ?? 0} artifact(s).`
+        }];
+}
+//# sourceMappingURL=local-run-index.js.map

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/local-run-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-run-index.js","sourceRoot":"","sources":["../../../src/doctor/checks/local-run-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,WAAmB;IACpE,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC;gBACN,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,iBAAiB;gBACxB,OAAO,EAAE,oFAAoF;gBAC7F,MAAM,EAAE,wDAAwD;aACjE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK,EAAE,MAAe;YACtB,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,cAAc;SAC7B,CAAC,CAAC,CAAC;IACN,CAAC;IACD,OAAO,CAAC;YACN,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,mCAAmC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,IAAI,CAAC,uBAAuB,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC,eAAe;SACjN,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/project.d.ts

@@ -0,0 +1,11 @@
+import type { DoctorCheck } from '../model.js';
+export declare function inspectGitRepository(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectProjectConfig(projectRoot: string): Promise<{
+    exists: boolean;
+    checks: DoctorCheck[];
+}>;
+export declare function inspectRunsDirectoryAccess(projectRoot: string): Promise<{
+    available: boolean;
+    checks: DoctorCheck[];
+}>;
+export declare function inspectSpecsDirectory(projectRoot: string): Promise<DoctorCheck[]>;

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/project.js

@@ -0,0 +1,78 @@
+import { execFile } from 'node:child_process';
+import { constants } from 'node:fs';
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { PROJECT_CONFIG_CONTRACT } from '../../contracts.js';
+import { messageFromError } from '../../contracts/issues.js';
+import { readProjectConfig as readProjectConfigFile } from '../../config/project-config.js';
+import { getProjectConfigPath, getRunsDir } from '../../runtime-paths.js';
+import { parseAgentRuntimeConfig } from '../../router/agent-runtime-config.js';
+import { exists } from '../../storage/json-io.js';
+const execFileAsync = promisify(execFile);
+export async function inspectGitRepository(projectRoot) {
+    const gitRoot = await getGitRoot(projectRoot);
+    return [gitRoot
+            ? { level: 'PASS', check: 'git_repo', message: `Git repository detected at ${gitRoot}` }
+            : { level: 'FAIL', check: 'git_repo', message: 'Current directory is not inside a Git repository; doctor and run-index checks expect git context.', action: 'Run from a project Git repository, or run git init first for a fresh temporary/project sandbox.' }];
+}
+export async function inspectProjectConfig(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    if (!(await exists(configPath))) {
+        return {
+            exists: false,
+            checks: [{ level: 'FAIL', check: 'project_config', message: '.sdd/project.yml is missing.', action: 'Run sdd init.' }]
+        };
+    }
+    try {
+        await readProjectConfigFile(projectRoot, parseAgentRuntimeConfig);
+        return {
+            exists: true,
+            checks: [{ level: 'PASS', check: 'project_config', message: `.sdd/project.yml is readable and uses ${PROJECT_CONFIG_CONTRACT}.` }]
+        };
+    }
+    catch (error) {
+        return {
+            exists: true,
+            checks: [{ level: 'FAIL', check: 'project_config', message: `Cannot parse .sdd/project.yml: ${messageFromError(error)}`, action: 'Run sdd init or fix the required project.yml keys.' }]
+        };
+    }
+}
+export async function inspectRunsDirectoryAccess(projectRoot) {
+    const runsDir = getRunsDir(projectRoot);
+    if (!(await exists(runsDir))) {
+        return {
+            available: false,
+            checks: [{ level: 'WARN', check: 'runs_dir', message: '.sdd/runs does not exist yet.', action: 'Run sdd init or sdd run create.' }]
+        };
+    }
+    try {
+        await access(runsDir, constants.R_OK | constants.W_OK);
+        return {
+            available: true,
+            checks: [{ level: 'PASS', check: 'runs_dir', message: '.sdd/runs exists and is readable/writable.' }]
+        };
+    }
+    catch {
+        return {
+            available: false,
+            checks: [{ level: 'FAIL', check: 'runs_dir', message: '.sdd/runs is not readable/writable.', action: 'Fix filesystem permissions for .sdd/runs.' }]
+        };
+    }
+}
+export async function inspectSpecsDirectory(projectRoot) {
+    const specsDir = path.join(projectRoot, 'specs');
+    return [await exists(specsDir)
+            ? { level: 'PASS', check: 'specs_dir', message: 'specs directory exists.' }
+            : { level: 'WARN', check: 'specs_dir', message: 'specs directory is missing.', action: 'Create specs/<branch>/ documents before full SDD execution.' }];
+}
+async function getGitRoot(projectRoot) {
+    try {
+        const result = await execFileAsync('git', ['-C', projectRoot, 'rev-parse', '--show-toplevel']);
+        return result.stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=project.js.map

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/project.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/doctor/checks/registries.d.ts

@@ -0,0 +1,11 @@
+import type { DoctorCheck } from '../model.js';
+export declare function inspectCapabilityRegistry(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectToolPluginContracts(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectGovernancePolicyContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectQueryStatusBoundaryContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectAgentSkillTeamRuntimeDoctorContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectAgentCapabilityCatalogDoctorContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectCommandTeamRuntimeDoctorContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectSkillAgentEvalDoctorContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectHarnessLearningDoctorContract(projectRoot: string): Promise<DoctorCheck[]>;
+export declare function inspectProjectContextPackDoctorContract(projectRoot: string): Promise<DoctorCheck[]>;