sdd-agent-platform 0.3.0 → 0.4.0

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

@@ -0,0 +1,138 @@
+import { inspectAiToolEntryEvidence } from './checks/ai-entries.js';
+import { inspectDocumentChainEvidence } from './checks/document-chain.js';
+import { inspectLocalRunIndexEvidence } from './checks/local-run-index.js';
+import { inspectGitRepository, inspectProjectConfig, inspectRunsDirectoryAccess, inspectSpecsDirectory } from './checks/project.js';
+import { inspectRunEvidence } from './checks/run-evidence.js';
+import { inspectAgentCapabilityCatalogDoctorContract, inspectAgentSkillTeamRuntimeDoctorContract, inspectCapabilityRegistry, inspectCommandTeamRuntimeDoctorContract, inspectGovernancePolicyContract, inspectHarnessLearningDoctorContract, inspectProjectContextPackDoctorContract, inspectQueryStatusBoundaryContract, inspectSkillAgentEvalDoctorContract, inspectToolPluginContracts } from './checks/registries.js';
+import { inspectBackgroundExecutorContract, inspectDelegationQueueContract, inspectDelegationStateMachineContract, inspectLocalRunIndexContract, inspectTaskGraphPlannerContract, inspectWaveExecutorContract, inspectWavePlannerContract, inspectWorkerAdapterContracts, inspectWorktreeIsolationContract, inspectWorktreeLifecycleContract } from './checks/runtime-contracts.js';
+import { inspectRuntimeStoreEvidence } from '../storage/runtime-store.js';
+import { getProjectStatus, statuslineProjectionFromStatus } from '../status/project-status.js';
+import { summarizeDoctorStatus } from './summary.js';
+export async function doctor(projectRoot, options = {}) {
+    const checks = [];
+    checks.push(...await inspectGitRepository(projectRoot));
+    const projectConfigInspection = await inspectProjectConfig(projectRoot);
+    checks.push(...projectConfigInspection.checks);
+    checks.push(...await inspectRuntimeStoreEvidence(projectRoot));
+    const runsDirectoryInspection = await inspectRunsDirectoryAccess(projectRoot);
+    checks.push(...runsDirectoryInspection.checks);
+    if (runsDirectoryInspection.available) {
+        checks.push(...await inspectRunEvidence(projectRoot, options));
+        checks.push(...await inspectLocalRunIndexEvidence(projectRoot));
+    }
+    checks.push(...await inspectSpecsDirectory(projectRoot));
+    checks.push(...await inspectDocumentChainEvidence(projectRoot, options.branch ?? undefined));
+    if (projectConfigInspection.exists) {
+        checks.push(...await inspectAiToolEntryEvidence(projectRoot));
+    }
+    checks.push(...await inspectCapabilityRegistry(projectRoot));
+    checks.push(...await inspectToolPluginContracts(projectRoot));
+    checks.push(...await inspectDelegationQueueContract(projectRoot));
+    checks.push(...await inspectDelegationStateMachineContract(projectRoot));
+    checks.push(...await inspectWorkerAdapterContracts(projectRoot));
+    checks.push(...await inspectWorktreeIsolationContract(projectRoot));
+    checks.push(...await inspectWorktreeLifecycleContract(projectRoot));
+    checks.push(...await inspectTaskGraphPlannerContract(projectRoot));
+    checks.push(...await inspectWavePlannerContract(projectRoot));
+    checks.push(...await inspectBackgroundExecutorContract(projectRoot));
+    checks.push(...await inspectWaveExecutorContract(projectRoot));
+    checks.push(...await inspectLocalRunIndexContract(projectRoot));
+    checks.push(...await inspectGovernancePolicyContract(projectRoot));
+    checks.push(...await inspectQueryStatusBoundaryContract(projectRoot));
+    checks.push(...await inspectAgentSkillTeamRuntimeDoctorContract(projectRoot));
+    checks.push(...await inspectAgentCapabilityCatalogDoctorContract(projectRoot));
+    checks.push(...await inspectCommandTeamRuntimeDoctorContract(projectRoot));
+    checks.push(...await inspectSkillAgentEvalDoctorContract(projectRoot));
+    checks.push(...await inspectHarnessLearningDoctorContract(projectRoot));
+    checks.push(...await inspectProjectContextPackDoctorContract(projectRoot));
+    const statusSnapshot = await readDoctorProjectStatus(projectRoot, options.branch ?? undefined);
+    checks.push(...inspectContextTokenRuntime(statusSnapshot));
+    checks.push(...inspectLifecycleRiskRuntime(statusSnapshot));
+    checks.push(...inspectWorkflowHandoffRuntime(statusSnapshot));
+    checks.push(...inspectContextOffloadRuntime(statusSnapshot));
+    checks.push(...inspectSubagentDispatchRuntime(statusSnapshot));
+    return {
+        status: summarizeDoctorStatus(checks),
+        checks
+    };
+}
+async function readDoctorProjectStatus(projectRoot, branch) {
+    try {
+        return {
+            status: await getProjectStatus(projectRoot, { branch, branchSource: branch ? 'cli_option' : undefined }),
+            error: null
+        };
+    }
+    catch (error) {
+        return { status: null, error };
+    }
+}
+function unavailableRuntimeCheck(check, label, error) {
+    return [{
+            level: 'WARN',
+            check,
+            message: `${label} unavailable: ${error instanceof Error ? error.message : String(error)}`,
+            action: 'Resolve SDD branch context, then rerun sdd doctor.'
+        }];
+}
+function inspectContextTokenRuntime(snapshot) {
+    if (!snapshot.status) {
+        return unavailableRuntimeCheck('context_token_runtime', 'token runtime projection', snapshot.error);
+    }
+    const statusline = statuslineProjectionFromStatus(snapshot.status);
+    return [{
+            level: statusline.tokenHealth === 'pressure' ? 'WARN' : 'PASS',
+            check: 'context_token_runtime',
+            message: `token_health=${statusline.tokenHealth} context_risk_tasks=${statusline.taskRisk.contextRiskTasks.length} token_risk_tasks=${statusline.taskRisk.tokenRiskTasks.length}`,
+            action: statusline.tokenHealth === 'pressure' ? `Run sdd context build --task <task_id> --branch ${statusline.branch} --mode doctor --profile brief and defer optional material.` : undefined
+        }];
+}
+function inspectLifecycleRiskRuntime(snapshot) {
+    if (!snapshot.status) {
+        return unavailableRuntimeCheck('lifecycle_risk_decision', 'lifecycle risk decision', snapshot.error);
+    }
+    const risk = snapshot.status.lifecycleRisk;
+    return [{
+            level: risk.status === 'blocked' || risk.status === 'incompatible' || risk.approvalPolicy === 'blocked' ? 'FAIL' : risk.status === 'missing' || risk.status === 'stale' || risk.approvalPolicy === 'human-required' ? 'WARN' : 'PASS',
+            check: 'lifecycle_risk_decision',
+            message: `status=${risk.status} profile=${risk.profile ?? 'none'} approval=${risk.approvalPolicy ?? 'none'} input=${risk.inputHash ?? 'none'} expected=${risk.expectedInputHash}`,
+            action: risk.status === 'fresh' ? undefined : `Run lifecycle risk projection for ${risk.scopeKey}; workflow gates now consume this decision directly.`
+        }];
+}
+function inspectWorkflowHandoffRuntime(snapshot) {
+    if (!snapshot.status) {
+        return unavailableRuntimeCheck('workflow_handoff_state', 'workflow handoff state', snapshot.error);
+    }
+    const handoff = snapshot.status.workflowHandoff;
+    return [{
+            level: handoff.status === 'blocked' || handoff.status === 'rejected' || handoff.status === 'incompatible' ? 'FAIL' : handoff.status === 'stale' ? 'WARN' : 'PASS',
+            check: 'workflow_handoff_state',
+            message: `status=${handoff.status} active_stage=${handoff.activeStage?.stage ?? 'none'} latest_stage=${handoff.latestStageRun?.stage ?? 'none'} latest_handoff=${handoff.latestHandoff ? `${handoff.latestHandoff.fromStage}->${handoff.latestHandoff.toStage}:${handoff.latestHandoff.status}` : 'none'} stage_projections=${handoff.projectionCounts.stageRuns} handoff_projections=${handoff.projectionCounts.handoffs}`,
+            action: handoff.status === 'fresh' || handoff.status === 'missing' ? undefined : `Resolve workflow handoff projection for ${snapshot.status.branch}; workflow gates now consume this state directly.`
+        }];
+}
+function inspectContextOffloadRuntime(snapshot) {
+    if (!snapshot.status) {
+        return unavailableRuntimeCheck('context_offload_state', 'context offload state', snapshot.error);
+    }
+    const context = snapshot.status.contextRuntime;
+    return [{
+            level: context.action === 'block-for-curation' ? 'FAIL' : 'PASS',
+            check: 'context_offload_state',
+            message: `level=${context.level} action=${context.action} load_signals=${context.loadSignals} offload_decisions=${context.offloadDecisions} dispatch_refs=${context.dispatchRefs}`,
+            action: context.action === 'block-for-curation' ? `Curate scoped context before stage output for ${snapshot.status.branch}.` : undefined
+        }];
+}
+function inspectSubagentDispatchRuntime(snapshot) {
+    if (!snapshot.status) {
+        return unavailableRuntimeCheck('subagent_dispatch_state', 'subagent dispatch state', snapshot.error);
+    }
+    const dispatches = snapshot.status.subagentDispatches;
+    return [{
+            level: dispatches.status === 'blocked' || dispatches.status === 'failed' || dispatches.status === 'stale' || dispatches.status === 'incompatible' ? 'FAIL' : 'PASS',
+            check: 'subagent_dispatch_state',
+            message: `status=${dispatches.status} dispatches=${dispatches.dispatches} blocking_open=${dispatches.blockingOpen} failed=${dispatches.failed} stale=${dispatches.stale} completed=${dispatches.completed} archived=${dispatches.archived} superseded=${dispatches.superseded}`,
+            action: dispatches.status === 'fresh' || dispatches.status === 'missing' ? undefined : dispatches.reasons.join(' ')
+        }];
+}
+//# sourceMappingURL=doctor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/doctor/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpI,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,2CAA2C,EAAE,0CAA0C,EAAE,yBAAyB,EAAE,uCAAuC,EAAE,+BAA+B,EAAE,oCAAoC,EAAE,uCAAuC,EAAE,kCAAkC,EAAE,mCAAmC,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC1Z,OAAO,EAAE,iCAAiC,EAAE,8BAA8B,EAAE,qCAAqC,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,gCAAgC,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACpX,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,8BAA8B,EAAsB,MAAM,6BAA6B,CAAC;AAEnH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,WAAmB,EAAE,UAA+E,EAAE;IACjI,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;IAExD,MAAM,uBAAuB,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACxE,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,2BAA2B,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/D,MAAM,uBAAuB,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,uBAAuB,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;IAEzD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,4BAA4B,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC;IAC7F,IAAI,uBAAuB,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,yBAAyB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,qCAAqC,CAAC,WAAW,CAAC,CAAC,CAAC;IACzE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,6BAA6B,CAAC,WAAW,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,+BAA+B,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,iCAAiC,CAAC,WAAW,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,2BAA2B,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,+BAA+B,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,kCAAkC,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,0CAA0C,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,2CAA2C,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/E,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,uCAAuC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3E,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,mCAAmC,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,oCAAoC,CAAC,WAAW,CAAC,CAAC,CAAC;IACxE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,uCAAuC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;IAC/F,MAAM,CAAC,IAAI,CAAC,GAAG,0BAA0B,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,6BAA6B,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,8BAA8B,CAAC,cAAc,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrC,MAAM;KACP,CAAC;AACJ,CAAC;AAOD,KAAK,UAAU,uBAAuB,CAAC,WAAmB,EAAE,MAAsB;IAChF,IAAI,CAAC;QACH,OAAO;YACL,MAAM,EAAE,MAAM,gBAAgB,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YACxG,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa,EAAE,KAAa,EAAE,KAAc;IAC3E,OAAO,CAAC;YACN,KAAK,EAAE,MAAM;YACb,KAAK;YACL,OAAO,EAAE,GAAG,KAAK,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC1F,MAAM,EAAE,oDAAoD;SAC7D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAqC;IACvE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,uBAAuB,CAAC,uBAAuB,EAAE,0BAA0B,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,UAAU,GAAG,8BAA8B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnE,OAAO,CAAC;YACN,KAAK,EAAE,UAAU,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC9D,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,gBAAgB,UAAU,CAAC,WAAW,uBAAuB,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,qBAAqB,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE;YACjL,MAAM,EAAE,UAAU,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,mDAAmD,UAAU,CAAC,MAAM,6DAA6D,CAAC,CAAC,CAAC,SAAS;SAC9L,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAqC;IACxE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,uBAAuB,CAAC,yBAAyB,EAAE,yBAAyB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC;IAC3C,OAAO,CAAC;YACN,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,cAAc,KAAK,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACrO,KAAK,EAAE,yBAAyB;YAChC,OAAO,EAAE,UAAU,IAAI,CAAC,MAAM,YAAY,IAAI,CAAC,OAAO,IAAI,MAAM,aAAa,IAAI,CAAC,cAAc,IAAI,MAAM,UAAU,IAAI,CAAC,SAAS,IAAI,MAAM,aAAa,IAAI,CAAC,iBAAiB,EAAE;YACjL,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qCAAqC,IAAI,CAAC,QAAQ,sDAAsD;SACvJ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B,CAAC,QAAqC;IAC1E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,uBAAuB,CAAC,wBAAwB,EAAE,wBAAwB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC;IAChD,OAAO,CAAC;YACN,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACjK,KAAK,EAAE,wBAAwB;YAC/B,OAAO,EAAE,UAAU,OAAO,CAAC,MAAM,iBAAiB,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,MAAM,iBAAiB,OAAO,CAAC,cAAc,EAAE,KAAK,IAAI,MAAM,mBAAmB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,sBAAsB,OAAO,CAAC,gBAAgB,CAAC,SAAS,wBAAwB,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YAC3Z,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2CAA2C,QAAQ,CAAC,MAAM,CAAC,MAAM,mDAAmD;SACtM,CAAC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B,CAAC,QAAqC;IACzE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,uBAAuB,CAAC,uBAAuB,EAAE,uBAAuB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC;IAC/C,OAAO,CAAC;YACN,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAChE,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,SAAS,OAAO,CAAC,KAAK,WAAW,OAAO,CAAC,MAAM,iBAAiB,OAAO,CAAC,WAAW,sBAAsB,OAAO,CAAC,gBAAgB,kBAAkB,OAAO,CAAC,YAAY,EAAE;YAClL,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,oBAAoB,CAAC,CAAC,CAAC,iDAAiD,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS;SACzI,CAAC,CAAC;AACL,CAAC;AAED,SAAS,8BAA8B,CAAC,QAAqC;IAC3E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,uBAAuB,CAAC,yBAAyB,EAAE,yBAAyB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC;IACtD,OAAO,CAAC;YACN,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,IAAI,UAAU,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACnK,KAAK,EAAE,yBAAyB;YAChC,OAAO,EAAE,UAAU,UAAU,CAAC,MAAM,eAAe,UAAU,CAAC,UAAU,kBAAkB,UAAU,CAAC,YAAY,WAAW,UAAU,CAAC,MAAM,UAAU,UAAU,CAAC,KAAK,cAAc,UAAU,CAAC,SAAS,aAAa,UAAU,CAAC,QAAQ,eAAe,UAAU,CAAC,UAAU,EAAE;YAC/Q,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,OAAO,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;SACpH,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,11 @@
+export type DoctorLevel = 'PASS' | 'WARN' | 'FAIL';
+export interface DoctorCheck {
+    level: DoctorLevel;
+    check: string;
+    message: string;
+    action?: string;
+}
+export interface DoctorReport {
+    status: DoctorLevel;
+    checks: DoctorCheck[];
+}

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

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

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

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

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

@@ -0,0 +1,2 @@
+import type { DoctorReport } from './model.js';
+export declare function renderDoctorReport(report: DoctorReport): string;

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

@@ -0,0 +1,44 @@
+export function renderDoctorReport(report) {
+    const failures = report.checks.filter((check) => check.level === 'FAIL');
+    const warnings = report.checks.filter((check) => check.level === 'WARN');
+    const passes = report.checks.filter((check) => check.level === 'PASS');
+    const lines = ['SDD doctor', 'decision'];
+    lines.push(`- status=${report.status}`);
+    lines.push(`- checks pass=${passes.length} warn=${warnings.length} fail=${failures.length}`);
+    lines.push('evidence');
+    const visibleChecks = [...failures, ...warnings, ...passes.slice(0, failures.length === 0 && warnings.length === 0 ? 5 : 2)];
+    if (visibleChecks.length === 0) {
+        lines.push('- no checks reported');
+    }
+    else {
+        for (const check of visibleChecks) {
+            const action = check.action ? ` action=${check.action}` : '';
+            lines.push(`- [${check.level}] ${check.check}: ${check.message}${action}`);
+        }
+    }
+    const hiddenPasses = passes.length - visibleChecks.filter((check) => check.level === 'PASS').length;
+    if (hiddenPasses > 0) {
+        lines.push(`- ${hiddenPasses} passing check(s) hidden; use --json for full details`);
+    }
+    lines.push('gaps');
+    if (failures.length === 0 && warnings.length === 0) {
+        lines.push('- none');
+    }
+    else {
+        for (const check of [...failures, ...warnings]) {
+            lines.push(`- [${check.level}] ${check.check}: ${check.action ?? check.message}`);
+        }
+    }
+    lines.push('next');
+    if (failures[0]?.action) {
+        lines.push(`- ${failures[0].action}`);
+    }
+    else if (warnings[0]?.action) {
+        lines.push(`- ${warnings[0].action}`);
+    }
+    else {
+        lines.push('- sdd status');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=render.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { DoctorCheck, DoctorLevel } from './model.js';
+export declare function summarizeDoctorStatus(checks: DoctorCheck[]): DoctorLevel;

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

@@ -0,0 +1,10 @@
+export function summarizeDoctorStatus(checks) {
+    if (checks.some((check) => check.level === 'FAIL')) {
+        return 'FAIL';
+    }
+    if (checks.some((check) => check.level === 'WARN')) {
+        return 'WARN';
+    }
+    return 'PASS';
+}
+//# sourceMappingURL=summary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/doctor/summary.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './doctor/model.js';
+export * from './doctor/doctor.js';

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

@@ -0,0 +1,3 @@
+export * from './doctor/model.js';
+export * from './doctor/doctor.js';
+//# sourceMappingURL=doctor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/evidence-runtime/contracts.d.ts

@@ -0,0 +1,33 @@
+import type { RuntimeRef, RuntimeScope } from '../contracts.js';
+import { TEST_EVIDENCE_RUN_CONTRACT_VERSION } from '../contracts.js';
+export type TestEvidenceStatus = 'PASS' | 'FAIL' | 'BLOCKED';
+export type EvidenceCoverageStatus = 'complete' | 'partial' | 'missing' | 'stale';
+export interface TestCommandEvidence {
+    command: string;
+    status: TestEvidenceStatus;
+    outputRef?: RuntimeRef;
+    evidenceRefs: RuntimeRef[];
+    acceptanceRefs: string[];
+    startedAt: string;
+    completedAt?: string;
+}
+export interface AcceptanceEvidenceCoverage {
+    acceptanceRef: string;
+    status: EvidenceCoverageStatus;
+    evidenceRefs: RuntimeRef[];
+    gaps: string[];
+}
+export interface UnifiedTestEvidenceRun {
+    contract: typeof TEST_EVIDENCE_RUN_CONTRACT_VERSION;
+    id: string;
+    scope: RuntimeScope;
+    commandStatus: TestEvidenceStatus;
+    evidenceCoverage: EvidenceCoverageStatus;
+    policyJudgment: TestEvidenceStatus;
+    commands: TestCommandEvidence[];
+    acceptanceCoverage: AcceptanceEvidenceCoverage[];
+    syncBackReady: boolean;
+    gaps: string[];
+    next: string;
+    generatedAt: string;
+}

package/node_modules/@sdd-agent-platform/core/dist/evidence-runtime/contracts.js

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

package/node_modules/@sdd-agent-platform/core/dist/evidence-runtime/contracts.js.map

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

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

@@ -0,0 +1 @@
+export * from './evidence-runtime/contracts.js';

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

@@ -0,0 +1,2 @@
+export * from './evidence-runtime/contracts.js';
+//# sourceMappingURL=evidence-runtime.js.map

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

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

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

@@ -0,0 +1,31 @@
+import type { ArtifactResultIngestionRecord } from '../artifacts/ingestion.js';
+import type { AgentExecutionRecord, AgentExecutionRecordStatus, AgentProfileId, AgentRouterDecision, TeamSessionRecord, TeamSessionRecordStatus } from '../router/agent-runtime.js';
+export declare function writeAgentExecutionRecord(projectRoot: string, record: AgentExecutionRecord): Promise<AgentExecutionRecord>;
+export declare function writeTeamSessionRecord(projectRoot: string, record: TeamSessionRecord): Promise<TeamSessionRecord>;
+export declare function listAgentExecutionRecords(projectRoot: string, runId: string): Promise<AgentExecutionRecord[]>;
+export declare function listTeamSessionRecords(projectRoot: string, runId: string): Promise<TeamSessionRecord[]>;
+export declare function routeRecordSnapshot(route: AgentRouterDecision): AgentExecutionRecord['routeDecision'];
+export declare function routeRecordId(route: AgentRouterDecision, profile: AgentProfileId): string;
+export declare function sourceAttributionForCapabilities(capabilityIds: string[], route?: AgentRouterDecision): string[];
+export declare function executionProfile(agent: string, route: AgentRouterDecision): AgentProfileId;
+export declare function buildAgentExecutionRecord(input: {
+    runId: string;
+    taskId: string;
+    agent: string;
+    route: AgentRouterDecision;
+    status: AgentExecutionRecordStatus;
+    delegationId?: string | null;
+    queueItemId?: string | null;
+    artifactPath?: string | null;
+    ingestion?: ArtifactResultIngestionRecord | null;
+    evidenceSummary: string;
+}): AgentExecutionRecord;
+export declare function buildTeamSessionRecord(input: {
+    runId: string;
+    taskId: string | null;
+    route: AgentRouterDecision;
+    status: TeamSessionRecordStatus;
+    artifacts: string[];
+    evidenceSummary: string;
+}): TeamSessionRecord;
+export declare function toSafeRecordId(value: string): string;

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

@@ -0,0 +1,163 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { AGENT_EXECUTION_RECORD_CONTRACT_VERSION, TEAM_SESSION_RECORD_CONTRACT_VERSION } from '../contracts.js';
+import { getAgentExecutionRecordPath, getAgentExecutionsDir, getTeamSessionRecordPath, getTeamSessionsDir } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+import { BUILT_IN_SKILL_CAPABILITIES } from '../registries/skill-capabilities.js';
+export async function writeAgentExecutionRecord(projectRoot, record) {
+    await mkdir(getAgentExecutionsDir(projectRoot, record.runId), { recursive: true });
+    await writeFile(getAgentExecutionRecordPath(projectRoot, record.runId, record.executionId), `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+    return record;
+}
+export async function writeTeamSessionRecord(projectRoot, record) {
+    await mkdir(getTeamSessionsDir(projectRoot, record.runId), { recursive: true });
+    await writeFile(getTeamSessionRecordPath(projectRoot, record.runId, record.teamId), `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+    return record;
+}
+export async function listAgentExecutionRecords(projectRoot, runId) {
+    const recordsDir = getAgentExecutionsDir(projectRoot, runId);
+    if (!await exists(recordsDir)) {
+        return [];
+    }
+    const entries = await readdir(recordsDir, { withFileTypes: true });
+    const records = [];
+    for (const entry of entries.filter((candidate) => candidate.isFile() && candidate.name.endsWith('.json'))) {
+        try {
+            const raw = await readFile(path.join(recordsDir, entry.name), 'utf8');
+            records.push(JSON.parse(raw));
+        }
+        catch {
+            continue;
+        }
+    }
+    return records.sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.executionId.localeCompare(right.executionId));
+}
+export async function listTeamSessionRecords(projectRoot, runId) {
+    const recordsDir = getTeamSessionsDir(projectRoot, runId);
+    if (!await exists(recordsDir)) {
+        return [];
+    }
+    const entries = await readdir(recordsDir, { withFileTypes: true });
+    const records = [];
+    for (const entry of entries.filter((candidate) => candidate.isFile() && candidate.name.endsWith('.json'))) {
+        try {
+            const raw = await readFile(path.join(recordsDir, entry.name), 'utf8');
+            records.push(JSON.parse(raw));
+        }
+        catch {
+            continue;
+        }
+    }
+    return records.sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.teamId.localeCompare(right.teamId));
+}
+export function routeRecordSnapshot(route) {
+    return {
+        version: route.version,
+        category: route.category,
+        recommendedProfile: route.recommendedProfile,
+        autonomyCeiling: route.autonomyCeiling,
+        requiredCapabilities: route.requiredCapabilities,
+        blockedReason: route.blockedReason
+    };
+}
+export function routeRecordId(route, profile) {
+    const content = JSON.stringify({
+        version: route.version,
+        taskId: route.taskId,
+        branch: route.branch,
+        category: route.category,
+        profile,
+        recommendedProfile: route.recommendedProfile,
+        autonomyCeiling: route.autonomyCeiling,
+        requiredCapabilities: route.requiredCapabilities,
+        toolPermissionProfile: route.toolPermission?.profile ?? null,
+        toolPermissionPolicy: route.toolPermission?.policy ?? null,
+        blockedReason: route.blockedReason
+    });
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+export function sourceAttributionForCapabilities(capabilityIds, route) {
+    return capabilityIds.map((capabilityId) => {
+        const routeSource = route?.registrySources?.find((source) => source.kind === 'skill_capability' && source.id === capabilityId);
+        if (routeSource) {
+            return `${capabilityId}:${routeSource.sourceId ?? routeSource.origin}`;
+        }
+        const capability = BUILT_IN_SKILL_CAPABILITIES.find((candidate) => candidate.id === capabilityId);
+        return capability ? `${capability.id}:${capability.sourceRef}` : capabilityId;
+    });
+}
+export function executionProfile(agent, route) {
+    const normalized = normalizeAgentToken(agent);
+    return route.allowedProfiles.find((profile) => normalizeAgentToken(profile) === normalized) ?? toAgentProfileId(agent) ?? route.recommendedProfile ?? 'implementer';
+}
+export function buildAgentExecutionRecord(input) {
+    const now = new Date().toISOString();
+    const profile = executionProfile(input.agent, input.route);
+    return {
+        version: AGENT_EXECUTION_RECORD_CONTRACT_VERSION,
+        executionId: toSafeRecordId(input.delegationId ?? `${input.taskId}-${input.agent}`),
+        runId: input.runId,
+        taskId: input.taskId,
+        profile,
+        category: input.route.category,
+        host: 'sdd-cli',
+        hostSessionId: input.runId,
+        hostTaskId: input.delegationId ?? null,
+        modelPolicy: input.route.modelPolicy,
+        toolPermission: input.route.toolPermission,
+        capabilitiesUsed: input.route.requiredCapabilities,
+        sourceAttribution: sourceAttributionForCapabilities(input.route.requiredCapabilities, input.route),
+        artifacts: input.artifactPath ? [input.artifactPath] : input.ingestion?.artifactPath ? [input.ingestion.artifactPath] : [],
+        status: input.status,
+        delegationId: input.delegationId ?? null,
+        queueItemId: input.queueItemId ?? null,
+        ingestionStatus: input.ingestion?.status ?? null,
+        resultStatus: input.ingestion?.resultStatus ?? null,
+        routeId: routeRecordId(input.route, profile),
+        routeDecision: routeRecordSnapshot(input.route),
+        evidenceSummary: input.evidenceSummary,
+        createdAt: now,
+        updatedAt: now
+    };
+}
+export function buildTeamSessionRecord(input) {
+    const now = new Date().toISOString();
+    return {
+        version: TEAM_SESSION_RECORD_CONTRACT_VERSION,
+        teamId: toSafeRecordId(`team-${input.runId}-${input.taskId ?? 'branch'}`),
+        runId: input.runId,
+        taskId: input.taskId,
+        status: input.status,
+        chiefProfile: input.route.teamMode.chiefProfile,
+        memberProfiles: input.route.teamMode.memberProfiles,
+        hostLayout: null,
+        teamMode: input.route.teamMode,
+        waves: input.route.teamMode.allowedWaves,
+        messages: [{
+                sender: 'runtime',
+                receiver: 'team',
+                taskRef: input.taskId,
+                artifactRefs: input.artifacts,
+                blocker: input.route.teamMode.blockedReason,
+                evidenceSummary: input.evidenceSummary,
+                createdAt: now
+            }],
+        artifacts: input.artifacts,
+        evidenceSummary: input.evidenceSummary,
+        createdAt: now,
+        updatedAt: now
+    };
+}
+export function toSafeRecordId(value) {
+    const sanitized = value.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
+    return sanitized || 'record';
+}
+function normalizeAgentToken(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+}
+function toAgentProfileId(agent) {
+    const normalized = normalizeAgentToken(agent);
+    return normalized.length > 0 ? normalized : null;
+}
+//# sourceMappingURL=agent-execution-records.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { BACKGROUND_EXECUTOR_CONTRACT_VERSION } from '../contracts.js';
+import { type ContractValidationIssue } from '../contracts/issues.js';
+import type { ArtifactResultIngestionRecord } from '../artifacts/ingestion.js';
+import type { DelegationQueueItem } from '../run-state/run-index.js';
+import { type HostInvocationCommandOptions, type HostInvocationResult } from './host-invocation.js';
+export type BackgroundExecutorStatus = 'claimed' | 'completed' | 'failed' | 'blocked';
+export interface BackgroundExecutorRunOptions {
+    branch?: string;
+    runId?: string;
+    taskId: string;
+    agent?: string;
+    workerAdapterId?: string;
+    artifactPath?: string;
+    delegationId?: string;
+    timeoutSeconds?: number;
+    hostInvocation?: HostInvocationCommandOptions;
+    approved?: boolean;
+}
+export interface BackgroundExecutorResult {
+    version: typeof BACKGROUND_EXECUTOR_CONTRACT_VERSION;
+    runId: string;
+    taskId: string;
+    delegationId: string | null;
+    queueItemId: string | null;
+    workerAdapterId: string;
+    status: BackgroundExecutorStatus;
+    artifactPath: string | null;
+    ingestion: ArtifactResultIngestionRecord | null;
+    hostInvocation: HostInvocationResult | null;
+    issues: ContractValidationIssue[];
+    message: string;
+}
+export interface BackgroundExecutorInspection {
+    version: typeof BACKGROUND_EXECUTOR_CONTRACT_VERSION;
+    runId: string;
+    delegations: DelegationQueueItem[];
+    artifactIngestions: ArtifactResultIngestionRecord[];
+    runningDelegations: number;
+    terminalDelegations: number;
+    valid: boolean;
+    issues: ContractValidationIssue[];
+}
+export declare function inspectBackgroundExecutor(projectRoot: string, runId: string): Promise<BackgroundExecutorInspection>;
+export declare function runBackgroundExecutor(projectRoot: string, options: BackgroundExecutorRunOptions): Promise<BackgroundExecutorResult>;