sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/context/build-package.js

@@ -0,0 +1,244 @@
+import { CONTEXT_PACKAGE_CONTRACT_VERSION } from '../contracts.js';
+import { recordRuntimeProjection } from '../storage/runtime-store.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { parseSddBranch } from '../sdd-docs/task-parser.js';
+import { inspectSddTask } from '../sdd-docs/task-inspection.js';
+import { contextBudgetForProfile } from './budget.js';
+import { contextSourceRefForAbsolutePath, contextSourceRefForProjectPath, uniqueContextSourceRefs } from './source-refs.js';
+export async function buildContextBuildPackage(projectRoot, options) {
+    const profile = options.profile ?? 'brief';
+    const branch = options.branch ?? (await resolveSddContext(projectRoot)).partition;
+    const model = await parseSddBranch(projectRoot, branch);
+    const inspected = inspectSddTask(model, options.taskId);
+    if (!inspected.task) {
+        throw new Error(`Task not found: ${options.taskId}`);
+    }
+    const role = contextBuildRole(options.agent);
+    const task = inspected.task;
+    const docRefs = await Promise.all([
+        contextSourceRefForAbsolutePath(projectRoot, model.tasksPath, 'document'),
+        contextSourceRefForAbsolutePath(projectRoot, model.planPath, 'document'),
+        contextSourceRefForAbsolutePath(projectRoot, model.specPath, 'document')
+    ]);
+    const affectedRefs = await Promise.all(task.affectedFiles.map((file) => contextSourceRefForProjectPath(projectRoot, file, 'document')));
+    const artifactRefs = await Promise.all(task.requiredArtifacts.map((artifact) => contextSourceRefForProjectPath(projectRoot, artifact, 'artifact')));
+    const routeRef = await contextSourceRefForProjectPath(projectRoot, `.sdd/cache/routes`, 'derived');
+    const runIndexRef = await contextSourceRefForProjectPath(projectRoot, `.sdd/run-index.json`, 'derived');
+    const candidateMustRead = uniqueContextSourceRefs(contextMustReadRefs(options.mode, role, docRefs, affectedRefs, artifactRefs, routeRef, runIndexRef));
+    const candidateOptionalRead = uniqueContextSourceRefs(contextOptionalRefs(options.mode, role, docRefs, affectedRefs, artifactRefs, routeRef, runIndexRef));
+    const candidateDeferredRead = uniqueContextSourceRefs(contextDeferredRefs(options.mode, role, docRefs, affectedRefs, artifactRefs, routeRef, runIndexRef));
+    const budgeted = applyContextBudget(contextBudgetForProfile(profile), candidateMustRead, candidateOptionalRead, candidateDeferredRead);
+    const contextPackage = {
+        contract: CONTEXT_PACKAGE_CONTRACT_VERSION,
+        profile,
+        mode: options.mode,
+        agent: options.agent ?? null,
+        role,
+        authoritative: false,
+        usableForPass: false,
+        taskId: task.id,
+        branch,
+        budget: budgeted.accounting,
+        mustRead: budgeted.mustRead,
+        optionalRead: budgeted.optionalRead,
+        doNotReadUnlessNeeded: budgeted.doNotReadUnlessNeeded,
+        nextCommands: contextNextCommands(task.id, branch, options.mode, options.agent),
+        warnings: [
+            'Context package is derived guidance only and cannot satisfy PASS evidence.',
+            ...inspected.gaps.map((gap) => `${gap.field}: ${gap.message}`)
+        ]
+    };
+    enforceContextPackageOutputBudget(contextPackage);
+    await recordRuntimeProjection(projectRoot, 'context_build', `${branch}:${task.id}:${options.mode}:${options.agent ?? 'none'}:${profile}`, contextPackage);
+    return contextPackage;
+}
+function applyContextBudget(budget, mustRead, optionalRead, deferredRead) {
+    const includedRefs = [];
+    const deferredRefs = [];
+    const excludedRefs = [];
+    const truncatedSummaries = [];
+    const nextMustRead = [];
+    const nextOptionalRead = [];
+    const nextDeferredRead = [];
+    let estimatedBytes = 0;
+    for (const ref of mustRead) {
+        const summary = summarizeBudgetRef(ref, 'required');
+        if (estimatedBytes + summary.estimatedBytes <= budget.maxBytes || nextMustRead.length === 0) {
+            nextMustRead.push(ref);
+            includedRefs.push(summary);
+            estimatedBytes += summary.estimatedBytes;
+        }
+        else {
+            nextDeferredRead.push(ref);
+            deferredRefs.push({ ...summary, reason: 'required_ref_deferred_by_context_budget' });
+        }
+    }
+    for (const ref of optionalRead) {
+        const summary = summarizeBudgetRef(ref, 'optional');
+        if (estimatedBytes + summary.estimatedBytes <= budget.maxBytes) {
+            nextOptionalRead.push(ref);
+            includedRefs.push(summary);
+            estimatedBytes += summary.estimatedBytes;
+        }
+        else {
+            nextDeferredRead.push(ref);
+            deferredRefs.push({ ...summary, reason: 'optional_ref_deferred_by_context_budget' });
+        }
+    }
+    const seenDeferred = new Set(nextDeferredRead.map((ref) => `${ref.kind}:${ref.path}`));
+    for (const ref of deferredRead) {
+        const summary = summarizeBudgetRef(ref, 'deferred');
+        if (includedRefs.some((included) => included.path === ref.path && included.kind === ref.kind)) {
+            excludedRefs.push({ ...summary, reason: 'duplicate_ref_excluded' });
+        }
+        else if (!seenDeferred.has(`${ref.kind}:${ref.path}`)) {
+            nextDeferredRead.push(ref);
+            deferredRefs.push(summary);
+        }
+    }
+    if (deferredRefs.length > 8) {
+        truncatedSummaries.push(`deferred_refs_truncated=${deferredRefs.length - 8}`);
+    }
+    if (excludedRefs.length > 8) {
+        truncatedSummaries.push(`excluded_refs_truncated=${excludedRefs.length - 8}`);
+    }
+    const accounting = {
+        profile: budget.profile,
+        maxBytes: budget.maxBytes,
+        estimatedBytes: Math.min(estimatedBytes, budget.maxBytes),
+        estimatedTokens: estimateTokens(Math.min(estimatedBytes, budget.maxBytes)),
+        includedRefs: includedRefs.slice(0, 12),
+        deferredRefs: deferredRefs.slice(0, 8),
+        excludedRefs: excludedRefs.slice(0, 8),
+        truncatedSummaries
+    };
+    return {
+        mustRead: nextMustRead,
+        optionalRead: nextOptionalRead,
+        doNotReadUnlessNeeded: uniqueContextSourceRefs(nextDeferredRead),
+        accounting
+    };
+}
+function enforceContextPackageOutputBudget(contextPackage) {
+    let trimmedOptional = 0;
+    let trimmedDeferred = 0;
+    let trimmedAccounting = 0;
+    while (contextPackage.optionalRead.length > 0 && contextPackageOutputBytes(contextPackage) > contextPackage.budget.maxBytes) {
+        contextPackage.optionalRead.pop();
+        contextPackage.budget.includedRefs.pop();
+        trimmedOptional += 1;
+    }
+    while (contextPackage.doNotReadUnlessNeeded.length > 0 && contextPackageOutputBytes(contextPackage) > contextPackage.budget.maxBytes) {
+        contextPackage.doNotReadUnlessNeeded.pop();
+        trimmedDeferred += 1;
+    }
+    while (contextPackage.budget.excludedRefs.length > 0 && contextPackageOutputBytes(contextPackage) > contextPackage.budget.maxBytes) {
+        contextPackage.budget.excludedRefs.pop();
+        trimmedAccounting += 1;
+    }
+    while (contextPackage.budget.deferredRefs.length > 0 && contextPackageOutputBytes(contextPackage) > contextPackage.budget.maxBytes) {
+        contextPackage.budget.deferredRefs.pop();
+        trimmedAccounting += 1;
+    }
+    const trims = [
+        trimmedOptional > 0 ? `optional_refs_output_trimmed=${trimmedOptional}` : null,
+        trimmedDeferred > 0 ? `deferred_refs_output_trimmed=${trimmedDeferred}` : null,
+        trimmedAccounting > 0 ? `budget_accounting_output_trimmed=${trimmedAccounting}` : null
+    ].filter((item) => item !== null);
+    if (trims.length > 0) {
+        contextPackage.budget.truncatedSummaries = trims;
+    }
+    contextPackage.budget.estimatedBytes = Math.min(contextPackageOutputBytes(contextPackage), contextPackage.budget.maxBytes);
+    contextPackage.budget.estimatedTokens = estimateTokens(contextPackage.budget.estimatedBytes);
+}
+function contextPackageOutputBytes(contextPackage) {
+    return Buffer.byteLength(JSON.stringify(contextPackage), 'utf8');
+}
+function summarizeBudgetRef(ref, reason) {
+    return {
+        path: ref.path,
+        kind: ref.kind,
+        estimatedBytes: Buffer.byteLength(JSON.stringify(ref), 'utf8'),
+        reason
+    };
+}
+function estimateTokens(bytes) {
+    return Math.ceil(bytes / 4);
+}
+function contextMustReadRefs(mode, role, docs, affected, artifacts, routeRef, runIndexRef) {
+    if (role === 'implementer') {
+        return [docs[0], docs[1], ...affected];
+    }
+    if (role === 'reviewer') {
+        return [docs[0], docs[1], runIndexRef, ...affected];
+    }
+    if (role === 'validator') {
+        return [docs[0], ...artifacts, runIndexRef];
+    }
+    if (role === 'context-curator') {
+        return [docs[0], docs[2], routeRef];
+    }
+    if (mode === 'do') {
+        return [docs[0], docs[1], ...affected];
+    }
+    if (mode === 'verify') {
+        return [docs[0], ...artifacts];
+    }
+    if (mode === 'sync-back') {
+        return [docs[0], ...affected];
+    }
+    return [docs[0]];
+}
+function contextOptionalRefs(mode, role, docs, affected, artifacts, routeRef, runIndexRef) {
+    if (role === 'implementer') {
+        return [docs[2], ...artifacts, routeRef];
+    }
+    if (role === 'reviewer') {
+        return [docs[2], ...artifacts, routeRef];
+    }
+    if (role === 'validator') {
+        return [docs[1], docs[2], routeRef];
+    }
+    if (role === 'context-curator') {
+        return [docs[1], runIndexRef];
+    }
+    return mode === 'doctor' ? [docs[1], docs[2], runIndexRef, routeRef, ...artifacts] : [docs[2], ...artifacts];
+}
+function contextDeferredRefs(mode, role, docs, affected, artifacts, routeRef, runIndexRef) {
+    if (role === 'context-curator') {
+        return [...affected, ...artifacts];
+    }
+    if (mode === 'verify') {
+        return [...affected, routeRef];
+    }
+    return [runIndexRef, ...artifacts, docs[2]];
+}
+function contextBuildRole(agent) {
+    if (agent === 'implementer' || agent === 'reviewer' || agent === 'validator' || agent === 'context-curator') {
+        return agent;
+    }
+    if (agent === 'role.context-curator') {
+        return 'context-curator';
+    }
+    if (agent === 'role.implementation-reviewer') {
+        return 'reviewer';
+    }
+    if (agent === 'role.verification-designer' || agent === 'role.evidence-runner') {
+        return 'validator';
+    }
+    return 'default';
+}
+function contextNextCommands(taskId, branch, mode, agent) {
+    if (mode === 'do') {
+        return [`sdd do task ${taskId} --branch ${branch}`];
+    }
+    if (mode === 'verify') {
+        return [`sdd test task ${taskId} --branch ${branch}`, `sdd evidence summary <run_id> --task ${taskId} --json`];
+    }
+    if (mode === 'sync-back') {
+        return [`sdd sync-back inspect --branch ${branch} --task ${taskId}`];
+    }
+    const agentSuffix = agent ? ` --agent ${agent}` : '';
+    return [`sdd doctor fast --branch ${branch}`, `sdd context build --task ${taskId} --branch ${branch} --mode verify${agentSuffix} --json`];
+}
+//# sourceMappingURL=build-package.js.map

package/packages/core/dist/context/build-package.js.map

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

package/packages/core/dist/context/command-summary.d.ts

@@ -0,0 +1,14 @@
+import { COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION } from '../contracts.js';
+import type { ContextProfile } from './budget.js';
+import type { ContextSourceRef } from './source-refs.js';
+export type ContextSummaryStatus = 'PASS' | 'FAIL' | 'BLOCKED' | 'UNKNOWN';
+export interface CommandOutputSummary {
+    contract: typeof COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION;
+    authoritative: false;
+    usableForPass: false;
+    source: ContextSourceRef;
+    status: ContextSummaryStatus;
+    highlights: string[];
+    omittedLines: number;
+}
+export declare function summarizeCommandOutput(rawOutput: string, source: ContextSourceRef, profile?: ContextProfile): CommandOutputSummary;

package/packages/core/dist/context/command-summary.js

@@ -0,0 +1,34 @@
+import { COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION } from '../contracts.js';
+export function summarizeCommandOutput(rawOutput, source, profile = 'brief') {
+    const lines = rawOutput.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    const failureLines = lines.filter((line) => /\b(fail(?:ed|ure)?|error|blocked|exception|traceback|timed out|timeout)\b/i.test(line));
+    const successLines = lines.filter((line) => /\b(pass(?:ed)?|success|completed|ok)\b/i.test(line));
+    let maxHighlights = 5;
+    if (profile === 'normal') {
+        maxHighlights = 12;
+    }
+    else if (profile === 'forensic') {
+        maxHighlights = lines.length;
+    }
+    const selected = [...failureLines, ...successLines, ...lines].filter((line, index, all) => all.indexOf(line) === index).slice(0, maxHighlights);
+    let status = 'UNKNOWN';
+    if (failureLines.some((line) => /\bblocked\b/i.test(line))) {
+        status = 'BLOCKED';
+    }
+    else if (failureLines.length > 0) {
+        status = 'FAIL';
+    }
+    else if (successLines.length > 0) {
+        status = 'PASS';
+    }
+    return {
+        contract: COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION,
+        authoritative: false,
+        usableForPass: false,
+        source,
+        status,
+        highlights: selected,
+        omittedLines: Math.max(0, lines.length - selected.length)
+    };
+}
+//# sourceMappingURL=command-summary.js.map

package/packages/core/dist/context/command-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-summary.js","sourceRoot":"","sources":["../../src/context/command-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,iBAAiB,CAAC;AAgB1E,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,MAAwB,EAAE,UAA0B,OAAO;IACnH,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,4EAA4E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrI,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClG,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,aAAa,GAAG,EAAE,CAAC;IACrB,CAAC;SAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAChJ,IAAI,MAAM,GAAyB,SAAS,CAAC;IAC7C,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;SAAM,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;SAAM,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,uCAAuC;QACjD,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,KAAK;QACpB,MAAM;QACN,MAAM;QACN,UAAU,EAAE,QAAQ;QACpB,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/packages/core/dist/context/evidence-summary.d.ts

@@ -0,0 +1,50 @@
+import { EVIDENCE_SUMMARY_CONTRACT_VERSION, SDD_EVIDENCE_CONTRACT, SDD_EVIDENCE_VERSION } from '../contracts.js';
+import type { ContextSourceRef } from './source-refs.js';
+type EvidenceCoverageStatus = 'PASS' | 'FAIL' | 'BLOCKED' | 'REFERENCED_ONLY' | 'MISSING';
+export type EvidenceQualityIssue = 'EMPTY_EVIDENCE' | 'TODO_PLACEHOLDER' | 'TEMPLATE_TEXT' | 'MENTION_ONLY' | 'UNSOURCED_PASS' | 'MISSING_COMMAND_OUTPUT' | 'MISSING_ARTIFACT_REFERENCE' | 'MISSING_MATERIAL_REFERENCE' | 'PROVENANCE_GAP' | 'POLICY_RULE_FAILED' | 'DERIVED_SOURCE_EVIDENCE' | 'PARTITION_SCOPE_VIOLATION';
+interface ContractValidationIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+interface EvidenceItem {
+    kind: string;
+    ref: string;
+    summary: string | null;
+}
+export interface EvidenceClaim {
+    contract: typeof SDD_EVIDENCE_CONTRACT;
+    version: typeof SDD_EVIDENCE_VERSION;
+    task: string;
+    acceptance: string;
+    status: EvidenceCoverageStatus;
+    claim: string;
+    sourceArtifact: string;
+    evidence: EvidenceItem[];
+    provenance: string[];
+    policy: string[];
+    rawMetadata: Record<string, string | string[]>;
+}
+export interface EvidenceSummaryProjection {
+    contract: typeof EVIDENCE_SUMMARY_CONTRACT_VERSION;
+    authoritative: false;
+    usableForPass: false;
+    runId: string;
+    taskId: string | null;
+    sources: ContextSourceRef[];
+    passCount: number;
+    blockedCount: number;
+    failCount: number;
+    issueCodes: EvidenceQualityIssue[];
+    policyRefs: string[];
+    highlights: string[];
+}
+export interface EvidenceSummaryOptions {
+    runId: string;
+    taskId?: string;
+}
+export declare function buildEvidenceSummaryProjection(projectRoot: string, options: EvidenceSummaryOptions): Promise<EvidenceSummaryProjection>;
+export declare function readRuntimeEvidenceClaims(projectRoot: string, runId: string, taskId: string | null): Promise<EvidenceClaim[]>;
+export declare function hasRuntimeEvidenceScopeViolation(projectRoot: string, runId: string, taskId: string | null): Promise<boolean>;
+export declare function uniqueEvidenceIssueCodes(issues: ContractValidationIssue[]): EvidenceQualityIssue[];
+export {};

package/packages/core/dist/context/evidence-summary.js

@@ -0,0 +1,86 @@
+import { ACCEPTANCE_POLICY_RULESET_VERSION, EVIDENCE_SUMMARY_CONTRACT_VERSION } from '../contracts.js';
+import { branchToSafePartition } from '../path-safety.js';
+import { listInvocationLedgerEntries } from '../run-state/invocation-ledger.js';
+import { readRunEvents } from '../run-state/events.js';
+import { readRunState } from '../run-state/run-state.js';
+import { recordRuntimeProjection, withRuntimeStore } from '../storage/runtime-store.js';
+import { contextSourceRefForProjectPath, uniqueContextSourceRefs } from './source-refs.js';
+export async function buildEvidenceSummaryProjection(projectRoot, options) {
+    const state = await readRunState(projectRoot, options.runId);
+    const [events, invocationLedger] = await Promise.all([
+        readRunEvents(projectRoot, options.runId),
+        listInvocationLedgerEntries(projectRoot, options.runId)
+    ]);
+    const taskId = options.taskId ?? state.currentTask ?? state.taskId;
+    const admittedClaims = await readRuntimeEvidenceClaims(projectRoot, state.runId, taskId ?? null);
+    const artifactIngestions = Object.values(state.artifactIngestions ?? {}).filter((record) => !taskId || record.task === taskId);
+    const artifacts = state.artifacts.filter((artifact) => !taskId || artifact.task === taskId);
+    const ledgerArtifactRefs = invocationLedger
+        .filter((entry) => entry.kind === 'artifact_hash' && entry.artifactPath)
+        .map((entry) => ({ path: entry.artifactPath, kind: 'artifact' }));
+    const branchEvidenceRoot = `.sdd/runs/${branchToSafePartition(state.gitBranch ?? state.partition ?? 'unscoped')}/evidence`;
+    const artifactSourceRefs = [
+        ...artifacts.map((artifact) => ({ path: `${branchEvidenceRoot}/${artifact.path}`, kind: 'artifact' })),
+        ...ledgerArtifactRefs.map((artifact) => ({ path: `${branchEvidenceRoot}/${artifact.path}`, kind: artifact.kind }))
+    ];
+    const sources = await uniqueContextSourceRefs([
+        await contextSourceRefForProjectPath(projectRoot, `.sdd/runtime.sqlite`, 'run_state'),
+        await contextSourceRefForProjectPath(projectRoot, `.sdd/runtime.sqlite`, 'command_output'),
+        await contextSourceRefForProjectPath(projectRoot, `.sdd/runtime.sqlite`, 'ledger'),
+        ...(await Promise.all(artifactSourceRefs.map((artifact) => contextSourceRefForProjectPath(projectRoot, artifact.path, artifact.kind))))
+    ]);
+    const issueCodes = uniqueEvidenceIssueCodes(artifactIngestions.flatMap((record) => record.issues));
+    const passCount = Math.max(admittedClaims.filter((claim) => claim.status === 'PASS').length, artifactIngestions.filter((record) => record.status === 'accepted' && (record.resultStatus === 'PASS' || record.resultStatus === 'PASS_WITH_GAPS')).length);
+    const failCount = Math.max(admittedClaims.filter((claim) => claim.status === 'FAIL').length, artifactIngestions.filter((record) => record.status === 'rejected' || record.resultStatus === 'FAIL').length);
+    const blockedCount = Math.max(admittedClaims.filter((claim) => claim.status === 'BLOCKED').length, artifactIngestions.filter((record) => record.resultStatus === 'BLOCKED' || record.resultStatus === 'TIMED_OUT' || record.resultStatus === 'CANCELLED' || record.gaps.length > 0).length);
+    const highlights = [
+        `run=${state.runId} status=${state.status} phase=${state.phase ?? 'none'}`,
+        `task=${taskId ?? 'none'} validation=${state.validation.status} sync_back=${state.syncBack.status}`,
+        `artifacts=${artifacts.length} ingestions=${artifactIngestions.length} admitted_claims=${admittedClaims.length} events=${events.length} ledger=${invocationLedger.length}`,
+        `pass=${passCount} blocked=${blockedCount} fail=${failCount}`
+    ];
+    if (issueCodes.length > 0) {
+        highlights.push(`issues=${issueCodes.join(',')}`);
+    }
+    const projection = {
+        contract: EVIDENCE_SUMMARY_CONTRACT_VERSION,
+        authoritative: false,
+        usableForPass: false,
+        runId: state.runId,
+        taskId: taskId ?? null,
+        sources,
+        passCount,
+        blockedCount,
+        failCount,
+        issueCodes,
+        policyRefs: [
+            `${ACCEPTANCE_POLICY_RULESET_VERSION}:require-source-evidence`,
+            `${ACCEPTANCE_POLICY_RULESET_VERSION}:require-provenance`,
+            `${ACCEPTANCE_POLICY_RULESET_VERSION}:reject-derived-source-evidence`
+        ],
+        highlights
+    };
+    await recordRuntimeProjection(projectRoot, 'evidence_summary', `${state.runId}:${taskId ?? 'all'}`, projection);
+    return projection;
+}
+export async function readRuntimeEvidenceClaims(projectRoot, runId, taskId) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const rows = taskId
+            ? db.prepare('SELECT c.payload_json FROM evidence_claims c JOIN runs r ON r.run_id = c.run_id WHERE c.run_id = ? AND c.task_id = ? AND (c.partition IS NULL OR r.partition IS NULL OR c.partition = r.partition) ORDER BY c.created_at ASC, c.claim_id ASC').all(runId, taskId)
+            : db.prepare('SELECT c.payload_json FROM evidence_claims c JOIN runs r ON r.run_id = c.run_id WHERE c.run_id = ? AND (c.partition IS NULL OR r.partition IS NULL OR c.partition = r.partition) ORDER BY c.created_at ASC, c.claim_id ASC').all(runId);
+        return rows.map((row) => JSON.parse(row.payload_json));
+    });
+}
+export async function hasRuntimeEvidenceScopeViolation(projectRoot, runId, taskId) {
+    return withRuntimeStore(projectRoot, ({ db }) => {
+        const row = taskId
+            ? db.prepare('SELECT COUNT(*) AS count FROM evidence_claims c JOIN runs r ON r.run_id = c.run_id WHERE c.run_id = ? AND c.task_id = ? AND c.partition IS NOT NULL AND r.partition IS NOT NULL AND c.partition <> r.partition').get(runId, taskId)
+            : db.prepare('SELECT COUNT(*) AS count FROM evidence_claims c JOIN runs r ON r.run_id = c.run_id WHERE c.run_id = ? AND c.partition IS NOT NULL AND r.partition IS NOT NULL AND c.partition <> r.partition').get(runId);
+        return (row?.count ?? 0) > 0;
+    });
+}
+export function uniqueEvidenceIssueCodes(issues) {
+    const known = ['EMPTY_EVIDENCE', 'TODO_PLACEHOLDER', 'TEMPLATE_TEXT', 'MENTION_ONLY', 'UNSOURCED_PASS', 'MISSING_COMMAND_OUTPUT', 'MISSING_ARTIFACT_REFERENCE', 'MISSING_MATERIAL_REFERENCE', 'PROVENANCE_GAP', 'POLICY_RULE_FAILED', 'DERIVED_SOURCE_EVIDENCE', 'PARTITION_SCOPE_VIOLATION'];
+    return known.filter((code) => issues.some((issue) => issue.message.includes(code)));
+}
+//# sourceMappingURL=evidence-summary.js.map

package/packages/core/dist/context/evidence-summary.js.map

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

package/packages/core/dist/context/log-worker.d.ts

@@ -0,0 +1,19 @@
+import { LOG_WORKER_SUMMARY_CONTRACT_VERSION } from '../contracts.js';
+import type { ContractValidationIssue } from '../delegation/state-machine.js';
+import type { ContextSourceRef } from './source-refs.js';
+export interface LogWorkerSummary {
+    contract: typeof LOG_WORKER_SUMMARY_CONTRACT_VERSION;
+    authoritative: false;
+    usableForPass: false;
+    runId: string;
+    taskId: string | null;
+    workerId: string;
+    sources: ContextSourceRef[];
+    highlights: string[];
+    forbiddenAuthority: string[];
+}
+export interface LogWorkerSummaryValidation {
+    valid: boolean;
+    issues: ContractValidationIssue[];
+}
+export declare function validateLogWorkerSummary(summary: LogWorkerSummary): LogWorkerSummaryValidation;

package/packages/core/dist/context/log-worker.js

@@ -0,0 +1,28 @@
+import { LOG_WORKER_SUMMARY_CONTRACT_VERSION } from '../contracts.js';
+export function validateLogWorkerSummary(summary) {
+    const issues = [];
+    const candidate = summary;
+    if (candidate.contract !== LOG_WORKER_SUMMARY_CONTRACT_VERSION) {
+        issues.push(contractIssue('contract', 'Log worker summary contract is invalid.', `Use ${LOG_WORKER_SUMMARY_CONTRACT_VERSION}.`));
+    }
+    if (candidate.authoritative !== false) {
+        issues.push(contractIssue('authoritative', 'Log worker summary must be non-authoritative.', 'Set authoritative=false and keep workflow decisions in core runtime.'));
+    }
+    if (candidate.usableForPass !== false) {
+        issues.push(contractIssue('usableForPass', 'Log worker summary cannot be used for PASS evidence.', 'Set usableForPass=false and reference source artifacts for PASS evidence.'));
+    }
+    const forbiddenAuthority = Array.isArray(candidate.forbiddenAuthority) ? candidate.forbiddenAuthority.filter((item) => typeof item === 'string') : [];
+    if (forbiddenAuthority.length > 0) {
+        issues.push(contractIssue('forbiddenAuthority', `Log worker summary claims forbidden workflow authority: ${forbiddenAuthority.join(', ')}.`, 'Remove PASS/BLOCKED/route/doctor/sync-back decisions from worker summaries.'));
+    }
+    for (const field of ['status', 'verdict', 'routeDecision', 'doctorVerdict', 'syncBackReady']) {
+        if (field in candidate) {
+            issues.push(contractIssue(field, `Log worker summary must not expose workflow decision field ${field}.`, 'Keep decision fields in core runtime outputs only.'));
+        }
+    }
+    return { valid: issues.length === 0, issues };
+}
+function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+//# sourceMappingURL=log-worker.js.map

package/packages/core/dist/context/log-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-worker.js","sourceRoot":"","sources":["../../src/context/log-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,iBAAiB,CAAC;AAqBtE,MAAM,UAAU,wBAAwB,CAAC,OAAyB;IAChE,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAqD,CAAC;IACxE,IAAI,SAAS,CAAC,QAAQ,KAAK,mCAAmC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,yCAAyC,EAAE,OAAO,mCAAmC,GAAG,CAAC,CAAC,CAAC;IACnI,CAAC;IACD,IAAI,SAAS,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,+CAA+C,EAAE,sEAAsE,CAAC,CAAC,CAAC;IACvK,CAAC;IACD,IAAI,SAAS,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,sDAAsD,EAAE,2EAA2E,CAAC,CAAC,CAAC;IACnL,CAAC;IACD,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtJ,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,2DAA2D,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,6EAA6E,CAAC,CAAC,CAAC;IAC/N,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC;QAC7F,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,8DAA8D,KAAK,GAAG,EAAE,oDAAoD,CAAC,CAAC,CAAC;QAClK,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,OAAe,EAAE,cAAsB;IAC3E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC5C,CAAC"}

package/packages/core/dist/context/source-refs.d.ts

@@ -0,0 +1,9 @@
+export type ContextSourceKind = 'artifact' | 'run_state' | 'ledger' | 'document' | 'command_output' | 'derived';
+export interface ContextSourceRef {
+    path: string;
+    hash: string;
+    kind: ContextSourceKind;
+}
+export declare function contextSourceRefForProjectPath(projectRoot: string, relativePath: string, kind: ContextSourceKind): Promise<ContextSourceRef>;
+export declare function contextSourceRefForAbsolutePath(projectRoot: string, absolutePath: string, kind: ContextSourceKind, displayPath?: string): Promise<ContextSourceRef>;
+export declare function uniqueContextSourceRefs(refs: ContextSourceRef[]): ContextSourceRef[];

package/packages/core/dist/context/source-refs.js

@@ -0,0 +1,30 @@
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { exists } from '../storage/json-io.js';
+import { normalizePortablePath } from '../path-safety.js';
+export async function contextSourceRefForProjectPath(projectRoot, relativePath, kind) {
+    const normalized = normalizePortablePath(relativePath);
+    return contextSourceRefForAbsolutePath(projectRoot, path.join(projectRoot, normalized), kind, normalized);
+}
+export async function contextSourceRefForAbsolutePath(projectRoot, absolutePath, kind, displayPath) {
+    const relativePath = displayPath ?? normalizePortablePath(path.relative(projectRoot, absolutePath));
+    if (!relativePath || relativePath.startsWith('../') || path.isAbsolute(relativePath)) {
+        return { path: normalizePortablePath(absolutePath), hash: hashDocumentContent(`external:${absolutePath}`), kind };
+    }
+    if (!await exists(absolutePath)) {
+        return { path: relativePath, hash: hashDocumentContent(`missing:${relativePath}`), kind };
+    }
+    const fileStat = await stat(absolutePath);
+    if (fileStat.isDirectory()) {
+        return { path: relativePath, hash: hashDocumentContent(`directory:${relativePath}`), kind };
+    }
+    return { path: relativePath, hash: hashDocumentContent(await readFile(absolutePath, 'utf8')), kind };
+}
+export function uniqueContextSourceRefs(refs) {
+    return [...new Map(refs.map((ref) => [`${ref.kind}:${ref.path}`, ref])).values()];
+}
+function hashDocumentContent(raw) {
+    return createHash('sha256').update(raw.replace(/\r\n/g, '\n'), 'utf8').digest('hex');
+}
+//# sourceMappingURL=source-refs.js.map

package/packages/core/dist/context/source-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-refs.js","sourceRoot":"","sources":["../../src/context/source-refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAU1D,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,WAAmB,EAAE,YAAoB,EAAE,IAAuB;IACrH,MAAM,UAAU,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACvD,OAAO,+BAA+B,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,WAAmB,EAAE,YAAoB,EAAE,IAAuB,EAAE,WAAoB;IAC5I,MAAM,YAAY,GAAG,WAAW,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IACpG,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACrF,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,YAAY,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACpH,CAAC;IACD,IAAI,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,CAAC,WAAW,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5F,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,CAAC,aAAa,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAC9F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAwB;IAC9D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC"}

package/packages/core/dist/context-offload/contracts.d.ts

@@ -0,0 +1,43 @@
+import type { RuntimeConfidence, RuntimeRef, RuntimeScope } from '../contracts.js';
+import { CONTEXT_LOAD_SIGNAL_CONTRACT_VERSION, CONTEXT_OFFLOAD_DECISION_CONTRACT_VERSION, SCOPED_CONTEXT_HANDOFF_CONTRACT_VERSION } from '../contracts.js';
+export type ContextLoadLevel = 'normal' | 'elevated' | 'high' | 'overloaded';
+export type ContextOffloadAction = 'inline' | 'summarize' | 'dispatch-subagent' | 'block-for-curation';
+export interface ContextLoadSignal {
+    contract: typeof CONTEXT_LOAD_SIGNAL_CONTRACT_VERSION;
+    scope: RuntimeScope;
+    level: ContextLoadLevel;
+    score: number;
+    fileCountScore: number;
+    artifactSizeScore: number;
+    dependencyFanoutScore: number;
+    unknownImpactScore: number;
+    staleEvidenceScore: number;
+    logVolumeScore: number;
+    confidence: RuntimeConfidence;
+    inputRefs: RuntimeRef[];
+    reasons: string[];
+    generatedAt: string;
+}
+export interface ContextOffloadDecision {
+    contract: typeof CONTEXT_OFFLOAD_DECISION_CONTRACT_VERSION;
+    scope: RuntimeScope;
+    action: ContextOffloadAction;
+    loadSignalRef: RuntimeRef;
+    requiredBefore: 'stage-output' | 'handoff' | 'sync-back' | 'ship' | 'never';
+    inlineRefs: RuntimeRef[];
+    summarizeRefs: RuntimeRef[];
+    dispatchRefs: RuntimeRef[];
+    blockingReasons: string[];
+    generatedAt: string;
+}
+export interface ScopedContextHandoff {
+    contract: typeof SCOPED_CONTEXT_HANDOFF_CONTRACT_VERSION;
+    id: string;
+    scope: RuntimeScope;
+    purpose: string;
+    mustReadRefs: RuntimeRef[];
+    summaryRefs: RuntimeRef[];
+    doNotReadUnlessNeededRefs: RuntimeRef[];
+    producedFor: 'main-agent' | 'co-main-agent' | 'subagent';
+    generatedAt: string;
+}

package/packages/core/dist/context-offload/contracts.js

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

package/packages/core/dist/context-offload/contracts.js.map

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