thehood 0.1.0-preview.0

package/dist/runtime/types.d.ts

@@ -0,0 +1,505 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export declare const runModes: readonly ["plan", "research", "implement", "review"];
+export type RunMode = (typeof runModes)[number];
+export declare const runStates: readonly ["created", "planning", "awaiting_approval", "delegating", "implementing", "verifying", "critiquing", "integrating", "completed", "failed", "aborted"];
+export type RunState = (typeof runStates)[number];
+export declare const runtimeRoles: readonly ["orchestrator", "planner", "researcher", "implementer", "qa", "verifier", "critic", "integrator", "citation"];
+export type RuntimeRole = (typeof runtimeRoles)[number];
+export declare const approvalDecisions: readonly ["approve", "reject", "revise"];
+export type ApprovalDecision = (typeof approvalDecisions)[number];
+export interface RoleAssignment {
+    provider: string;
+    model: string;
+}
+export type RoleMap = Partial<Record<RuntimeRole, RoleAssignment>>;
+export declare const providerAccessModes: readonly ["agent-bridge", "api-agent", "mcp-connector"];
+export type ProviderAccessMode = (typeof providerAccessModes)[number];
+export interface RuntimeDefaults {
+    maxIterations: number;
+    fanoutMaxItems: number;
+    editRequiresApproval: boolean;
+    dependencyInstallRequiresApproval: boolean;
+    networkRequiresApproval: boolean;
+    protectedTestPaths: string[];
+}
+export type ApprovalPolicyMode = "manual" | "auto_low_risk" | "autopilot";
+export type ExternalTransferApprovalMode = "manual" | "auto_low_risk";
+export type ExternalTransferPolicyDecision = "manual" | "auto_approve";
+export interface ExternalTransferPolicyRule {
+    provider?: string;
+    model?: string;
+    purposes?: ExternalTransferPurpose[];
+    riskClasses?: ExternalTransferRiskClass[];
+    maxBytes?: number;
+    decision: ExternalTransferPolicyDecision;
+}
+export interface ExternalTransferApprovalPolicy {
+    mode: ExternalTransferApprovalMode;
+    maxAutoApproveBytes: number;
+    rules: ExternalTransferPolicyRule[];
+}
+export interface ApprovalPolicy {
+    mode: ApprovalPolicyMode;
+    externalTransfers: ExternalTransferApprovalPolicy;
+}
+export interface ProviderConfig {
+    enabled: boolean;
+    models: string[];
+    accessModes?: ProviderAccessMode[];
+    defaultAccessMode?: ProviderAccessMode;
+    apiKeyEnv?: string;
+    browserProfile?: string;
+}
+export interface TheHoodConfig {
+    version: 1;
+    defaults: RuntimeDefaults;
+    approvalPolicy: ApprovalPolicy;
+    providers: Record<string, ProviderConfig>;
+    roles: RoleMap;
+}
+export type RunArtifactKind = "plan" | "diff" | "log" | "report" | "metadata" | "status" | "agent" | "directive" | "context" | "remote_context" | "progress" | "reconciliation" | "critic_trigger" | "revision_packet" | "review_routing" | "fanout" | "provider_invocation" | "transfer_manifest";
+export interface RunArtifact {
+    kind: RunArtifactKind;
+    ref: string;
+    summary: string;
+}
+export type CommandSafetyCategory = "read_only" | "local_write" | "dependency_install" | "network" | "destructive" | "credential_sensitive" | "unknown";
+export interface ApprovalEvent {
+    id: string;
+    createdAt: string;
+    decision: ApprovalDecision;
+    reason: string;
+}
+export interface ToolEvent {
+    id: string;
+    createdAt: string;
+    tool: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    exitCode: number;
+    durationMs: number;
+    safetyCategory: CommandSafetyCategory;
+    permissionDecision: "allowed" | "allowed_explicit_user" | "denied";
+    stdoutRef?: string;
+    stderrRef?: string;
+}
+export interface RunEvent {
+    id: string;
+    createdAt: string;
+    type: string;
+    message: string;
+    data?: JsonObject;
+}
+export type RunHandoffKind = "agent_handoff" | "approval_gate" | "approval_auto_approved" | "completion";
+export interface RunHandoffEvent {
+    id: string;
+    createdAt: string;
+    kind: RunHandoffKind;
+    reason: string;
+    stateBefore: RunState;
+    stateAfter: RunState;
+    fromRole?: RuntimeRole;
+    fromProvider?: string;
+    fromModel?: string;
+    toRole?: RuntimeRole;
+    toProvider?: string;
+    toModel?: string;
+    gate?: string;
+    approvalEventId?: string;
+    artifactRefs?: string[];
+}
+export interface RunRecord {
+    runId: string;
+    createdAt: string;
+    updatedAt: string;
+    repoPath: string;
+    userGoal: string;
+    mode: RunMode;
+    state: RunState;
+    preferredRole?: RuntimeRole;
+    roleMapping: RoleMap;
+    constraints: string[];
+    maxIterations: number;
+    approvalRequired: boolean;
+    approvalReason?: string;
+    stopReason?: string;
+    artifacts: RunArtifact[];
+    approvalEvents: ApprovalEvent[];
+    toolEvents: ToolEvent[];
+    events: RunEvent[];
+    handoffs: RunHandoffEvent[];
+}
+export type ProgressPacketSourceKind = "run_record" | "run_artifact" | "run_event" | "approval_event" | "tool_event";
+export interface ProgressPacketSourceRef {
+    kind: ProgressPacketSourceKind;
+    runId: string;
+    id?: string;
+    ref?: string;
+    eventType?: string;
+}
+export type ReviewLaneKind = "reviewer" | "tester" | "qa" | "critic";
+export type ReviewLaneState = "pending" | "satisfied" | "needs_revision" | "blocked" | "failed";
+export type ReviewLaneSourceKind = "required_gate" | "verifier_response" | "qa_response" | "critic_response" | "validation_evidence" | "summon_evidence";
+export type ReviewLaneOwnerKind = "role" | "runtime";
+export interface ReviewLaneOwner {
+    kind: ReviewLaneOwnerKind;
+    label: string;
+    readOnly: boolean;
+    role?: RuntimeRole;
+    provider?: string;
+    model?: string;
+    assignment?: string;
+}
+export interface ReviewLaneEvidence {
+    sourceKind: ReviewLaneSourceKind;
+    summary: string;
+    sourceRefs: ProgressPacketSourceRef[];
+    artifactRefs: string[];
+    eventRefs: string[];
+    canSatisfyRequired: boolean;
+}
+export interface ReviewLane {
+    id: string;
+    label: string;
+    kind: ReviewLaneKind;
+    state: ReviewLaneState;
+    required: boolean;
+    sourceKind: ReviewLaneSourceKind;
+    summary: string;
+    sourceRefs: ProgressPacketSourceRef[];
+    artifactRefs: string[];
+    eventRefs: string[];
+    owner: ReviewLaneOwner;
+    canSatisfyRequired: boolean;
+    satisfiesRequired: boolean;
+    sidecarEvidence: ReviewLaneEvidence[];
+    role?: RuntimeRole;
+}
+export type OperatorNextActionKind = "review_approval_reason" | "inspect_artifact" | "inspect_final_report" | "inspect_progress_packet" | "preview_external_transfer" | "continue_with_approval" | "reject_or_revise" | "continue" | "inspect_status" | "inspect_artifacts" | "reconcile" | "wait_for_provider" | "review_required" | "validation_required" | "terminal_complete" | "terminal_failed" | "terminal_aborted";
+export type OperatorNextActionOwnerKind = "runtime" | "role";
+export interface OperatorNextActionOwner {
+    kind: OperatorNextActionOwnerKind;
+    label: string;
+    role?: RuntimeRole;
+}
+export interface OperatorNextActionArtifact {
+    kind: RunArtifactKind;
+    ref: string;
+    summary: string;
+}
+export interface OperatorNextAction {
+    action: OperatorNextActionKind;
+    label: string;
+    description: string;
+    owner: OperatorNextActionOwner;
+    blocking: boolean;
+    required: boolean;
+    state: string;
+    reason: string;
+    generatedAt: string;
+    artifactRefs: string[];
+    eventRefs: string[];
+    commandHint?: string;
+    mcpToolHint?: string;
+    tool?: string;
+    arguments?: JsonObject;
+    artifact?: OperatorNextActionArtifact;
+}
+export type LoopResponsibilityKind = "plan" | "implement" | "test" | "verify" | "qa" | "critique" | "reconcile" | "integrate" | "operator_approval" | "complete";
+export type LoopResponsibilityStatus = "pending" | "ready" | "in_progress" | "satisfied" | "blocked" | "skipped" | "advisory";
+export type LoopResponsibilityOwnerKind = "runtime" | "role";
+export interface LoopResponsibilityOwner {
+    kind: LoopResponsibilityOwnerKind;
+    label: string;
+    role?: RuntimeRole;
+    provider?: string;
+    model?: string;
+    assignment?: string;
+    readOnly?: boolean;
+}
+export interface LoopResponsibility {
+    id: string;
+    kind: LoopResponsibilityKind;
+    label: string;
+    owner: LoopResponsibilityOwner;
+    required: boolean;
+    blocking: boolean;
+    status: LoopResponsibilityStatus;
+    state: RunState;
+    reason: string;
+    canSatisfyGate: boolean;
+    artifactRefs: string[];
+    eventRefs: string[];
+    handoffRefs: string[];
+    sidecarOnly?: boolean;
+}
+export interface LoopResponsibilitySchedule {
+    schemaVersion: 1;
+    kind: "loop_responsibility_schedule";
+    runId: string;
+    generatedAt: string;
+    phase: RunState;
+    responsibilities: LoopResponsibility[];
+    blockers: LoopResponsibility[];
+}
+export type CrewLaneAuthority = "runtime" | "edit" | "read_only" | "operator";
+export type CrewLaneSourceKind = "loop_responsibility" | "review_lane";
+export interface CrewLane {
+    id: string;
+    kind: LoopResponsibilityKind;
+    label: string;
+    owner: LoopResponsibilityOwner;
+    authority: CrewLaneAuthority;
+    required: boolean;
+    blocking: boolean;
+    status: LoopResponsibilityStatus;
+    state: RunState;
+    sourceKind: CrewLaneSourceKind;
+    summary: string;
+    responsibilityId: string;
+    reviewLaneId?: string;
+    canSatisfyGate: boolean;
+    satisfiesRequired: boolean;
+    artifactRefs: string[];
+    eventRefs: string[];
+    handoffRefs: string[];
+    sourceRefs: ProgressPacketSourceRef[];
+    sidecarOnly?: boolean;
+}
+export interface CrewLaneTrail {
+    schemaVersion: 1;
+    kind: "crew_lane_trail";
+    runId: string;
+    generatedAt: string;
+    phase: RunState;
+    lanes: CrewLane[];
+    blockers: CrewLane[];
+}
+export type RevisionTrailStatus = "packet_written" | "delegated" | "repairing" | "repair_reported" | "awaiting_review" | "reviewed" | "superseded";
+export interface RevisionTrailItem {
+    id: string;
+    status: RevisionTrailStatus;
+    active: boolean;
+    packetArtifactRef: string;
+    sourceRole?: RuntimeRole;
+    reasonCode?: string;
+    repairObjective?: string;
+    sourceResponseRef?: string;
+    criticTriggerRef?: string;
+    repairResponseRef?: string;
+    completedEventRef?: string;
+    evidenceRefs: string[];
+    validationArtifactRefs: string[];
+    reviewResponseRefs: string[];
+    artifactRefs: string[];
+    eventRefs: string[];
+    handoffRefs: string[];
+    sourceRefs: ProgressPacketSourceRef[];
+}
+export interface RevisionTrail {
+    schemaVersion: 1;
+    kind: "revision_trail";
+    runId: string;
+    generatedAt: string;
+    phase: RunState;
+    items: RevisionTrailItem[];
+    latest?: RevisionTrailItem;
+}
+export interface ProgressPacketLimits {
+    maxArtifacts: number;
+    maxProviderResponses: number;
+    maxApprovalEvents: number;
+    maxToolEvents: number;
+    maxRunEvents: number;
+    maxOpenQuestions: number;
+    maxReviewLanes: number;
+    maxOperatorNextActions: number;
+    maxLoopResponsibilities: number;
+    maxCrewLanes: number;
+    maxRevisionTrailItems: number;
+    maxStringLength: number;
+}
+export interface ProgressPacketSectionBounds {
+    included: number;
+    omitted: number;
+    truncated: boolean;
+}
+export interface ProgressPacketBounds {
+    limits: ProgressPacketLimits;
+    sections: Record<string, ProgressPacketSectionBounds>;
+    truncated: boolean;
+    textFieldsTruncated: number;
+}
+export interface ProgressPacketBoundedSection<T> {
+    items: T[];
+    omitted: number;
+    truncated: boolean;
+}
+export interface ProgressPacketArtifactRef {
+    kind: RunArtifactKind;
+    ref: string;
+    summary: string;
+    canonical: true;
+    source: ProgressPacketSourceRef;
+}
+export interface ProgressPacketApproval {
+    id: string;
+    createdAt: string;
+    decision: ApprovalDecision;
+    reason: string;
+    source: ProgressPacketSourceRef;
+}
+export interface ProgressPacketToolEvidence {
+    id: string;
+    createdAt: string;
+    tool: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    exitCode: number;
+    durationMs: number;
+    safetyCategory: CommandSafetyCategory;
+    permissionDecision: ToolEvent["permissionDecision"];
+    stdoutRef?: string;
+    stderrRef?: string;
+    source: ProgressPacketSourceRef;
+}
+export interface ProgressPacketRunEvent {
+    id: string;
+    createdAt: string;
+    type: string;
+    message: string;
+    data?: JsonObject;
+    source: ProgressPacketSourceRef;
+}
+export interface ProgressPacketProviderResponse {
+    role?: RuntimeRole;
+    provider?: string;
+    model?: string;
+    status?: string;
+    summary: string;
+    artifact?: ProgressPacketArtifactRef;
+    event?: ProgressPacketRunEvent;
+    sourceRefs: ProgressPacketSourceRef[];
+}
+export interface ProgressPacketEvidenceGroup {
+    artifacts: ProgressPacketBoundedSection<ProgressPacketArtifactRef>;
+    events: ProgressPacketBoundedSection<ProgressPacketRunEvent>;
+    toolEvents: ProgressPacketBoundedSection<ProgressPacketToolEvidence>;
+}
+export interface ProgressPacketOpenQuestion {
+    severity: "info" | "risk" | "blocking";
+    question: string;
+    sourceRefs: ProgressPacketSourceRef[];
+}
+export interface ProgressPacketRunSnapshot {
+    runId: string;
+    repoPath: string;
+    userGoal: string;
+    mode: RunMode;
+    state: RunState;
+    createdAt: string;
+    updatedAt: string;
+    approvalRequired: boolean;
+    approvalReason?: string;
+    stopReason?: string;
+    maxIterations: number;
+    artifactCount: number;
+    approvalEventCount: number;
+    toolEventCount: number;
+    runEventCount: number;
+    providerResponseCount: number;
+    source: ProgressPacketSourceRef;
+}
+export interface ProgressPacketLatestState {
+    plan?: ProgressPacketArtifactRef;
+    providerResponse?: ProgressPacketProviderResponse;
+    providerExecution?: ProgressPacketArtifactRef;
+    verifierResponse?: ProgressPacketProviderResponse;
+    criticTrigger?: ProgressPacketArtifactRef;
+    revisionPacket?: ProgressPacketArtifactRef;
+    finalReport?: ProgressPacketArtifactRef;
+    repoContext?: ProgressPacketArtifactRef;
+}
+export interface ProgressPacketEvidence {
+    artifacts: ProgressPacketBoundedSection<ProgressPacketArtifactRef>;
+    providerResponses: ProgressPacketBoundedSection<ProgressPacketProviderResponse>;
+    approvals: ProgressPacketBoundedSection<ProgressPacketApproval>;
+    toolEvents: ProgressPacketBoundedSection<ProgressPacketToolEvidence>;
+    runEvents: ProgressPacketBoundedSection<ProgressPacketRunEvent>;
+    git: ProgressPacketEvidenceGroup;
+    validation: ProgressPacketEvidenceGroup;
+    verifierVerdicts: ProgressPacketBoundedSection<ProgressPacketProviderResponse>;
+}
+export interface ProgressPacketProvenance {
+    canonicalSources: ProgressPacketSourceRef[];
+    derivedFields: string[];
+    notes: string[];
+}
+export interface ProgressPacket {
+    schemaVersion: 1;
+    kind: "progress_packet";
+    ontologyVersion: "initial";
+    ontologyTerms: string[];
+    run: ProgressPacketRunSnapshot;
+    roleMapping: RoleMap;
+    latest: ProgressPacketLatestState;
+    reviewLanes: ProgressPacketBoundedSection<ReviewLane>;
+    operatorNextActions: ProgressPacketBoundedSection<OperatorNextAction>;
+    loopResponsibilities: ProgressPacketBoundedSection<LoopResponsibility>;
+    crewLanes: ProgressPacketBoundedSection<CrewLane>;
+    revisionTrail: ProgressPacketBoundedSection<RevisionTrailItem>;
+    evidence: ProgressPacketEvidence;
+    openQuestions: ProgressPacketBoundedSection<ProgressPacketOpenQuestion>;
+    provenance: ProgressPacketProvenance;
+    bounds: ProgressPacketBounds;
+}
+export type ExternalTransferPurpose = "repo_context" | "progress_packet" | "memory_packet" | "reconciliation";
+export type ExternalTransferRiskClass = "public" | "repo_context" | "private_runtime_memory" | "secret_risk";
+export interface ExternalTransferArtifactRef {
+    kind: RunArtifactKind;
+    ref: string;
+    summary: string;
+    byteLength: number;
+    truncated: boolean;
+    sha256: string;
+}
+export interface ExternalTransferRisk {
+    class: ExternalTransferRiskClass;
+    reasons: string[];
+    secretPatternHits: number;
+}
+export interface ExternalTransferManifest {
+    schemaVersion: 1;
+    kind: "external_transfer_manifest";
+    runId: string;
+    createdAt: string;
+    destination: RoleAssignment;
+    role: RuntimeRole;
+    purpose: ExternalTransferPurpose;
+    approvalPhrase: string;
+    approvalHint: string;
+    artifacts: ExternalTransferArtifactRef[];
+    totalBytes: number;
+    risk: ExternalTransferRisk;
+    redaction: {
+        status: "not_applied" | "applied";
+        notes: string[];
+    };
+    preview: {
+        maxBytes: number;
+        content: string;
+        truncated: boolean;
+    };
+    provenance: {
+        sourceArtifactRefs: string[];
+        notes: string[];
+    };
+}

package/dist/runtime/types.js

@@ -0,0 +1,28 @@
+export const runModes = ["plan", "research", "implement", "review"];
+export const runStates = [
+    "created",
+    "planning",
+    "awaiting_approval",
+    "delegating",
+    "implementing",
+    "verifying",
+    "critiquing",
+    "integrating",
+    "completed",
+    "failed",
+    "aborted"
+];
+export const runtimeRoles = [
+    "orchestrator",
+    "planner",
+    "researcher",
+    "implementer",
+    "qa",
+    "verifier",
+    "critic",
+    "integrator",
+    "citation"
+];
+export const approvalDecisions = ["approve", "reject", "revise"];
+export const providerAccessModes = ["agent-bridge", "api-agent", "mcp-connector"];
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAG7E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS;IACT,UAAU;IACV,mBAAmB;IACnB,YAAY;IACZ,cAAc;IACd,WAAW;IACX,YAAY;IACZ,aAAa;IACb,WAAW;IACX,QAAQ;IACR,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,cAAc;IACd,SAAS;IACT,YAAY;IACZ,aAAa;IACb,IAAI;IACJ,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,UAAU;CACF,CAAC;AAGX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAU1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,eAAe,CAAU,CAAC"}

package/dist/runtime/validationCommands.d.ts

@@ -0,0 +1,18 @@
+import type { RunArtifact, RunRecord, ToolEvent } from "./types.js";
+export interface ValidationCommand {
+    script: string;
+    command: string;
+    args: string[];
+}
+export interface ValidationCommandResult extends ValidationCommand {
+    event: ToolEvent;
+}
+export interface ValidationEvidenceResult {
+    run: RunRecord;
+    discoveredCommands: ValidationCommand[];
+    executedCommands: ValidationCommandResult[];
+    failedCommands: ValidationCommandResult[];
+    artifact: RunArtifact;
+}
+export declare const discoverValidationCommands: (repoPathInput: string) => Promise<ValidationCommand[]>;
+export declare const captureValidationEvidence: (run: RunRecord) => Promise<ValidationEvidenceResult>;

package/dist/runtime/validationCommands.js

@@ -0,0 +1,106 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { writeRunArtifact } from "./artifacts.js";
+import { runRuntimeCommand } from "./commandRunner.js";
+import { newId, nowIso } from "./ids.js";
+import { resolveRepoPath } from "./paths.js";
+import { loadRun, saveRun } from "./store.js";
+const preferredValidationScripts = ["typecheck", "test", "lint", "build"];
+const createEvent = (type, message, data) => ({
+    id: newId("event"),
+    createdAt: nowIso(),
+    type,
+    message,
+    ...(data ? { data } : {})
+});
+const readPackageJson = async (repoPath) => {
+    try {
+        const raw = await fs.readFile(path.join(repoPath, "package.json"), "utf8");
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+};
+export const discoverValidationCommands = async (repoPathInput) => {
+    const repoPath = resolveRepoPath(repoPathInput);
+    const packageJson = await readPackageJson(repoPath);
+    const scripts = packageJson?.scripts ?? {};
+    return preferredValidationScripts.flatMap((script) => typeof scripts[script] === "string"
+        ? [
+            {
+                script,
+                command: "npm",
+                args: ["run", script]
+            }
+        ]
+        : []);
+};
+export const captureValidationEvidence = async (run) => {
+    const discoveredCommands = await discoverValidationCommands(run.repoPath);
+    const selectedCommands = discoveredCommands.slice(0, 1);
+    const executedCommands = [];
+    let latestRun = run;
+    for (const command of selectedCommands) {
+        const result = await runRuntimeCommand({
+            repoPath: latestRun.repoPath,
+            runId: latestRun.runId,
+            tool: `validation_${command.script}`,
+            command: command.command,
+            args: command.args
+        });
+        latestRun = result.run;
+        executedCommands.push({
+            ...command,
+            event: result.event
+        });
+    }
+    const failedCommands = executedCommands.filter((command) => command.event.exitCode !== 0);
+    const artifact = await writeRunArtifact({
+        repoPath: latestRun.repoPath,
+        runId: latestRun.runId,
+        kind: "metadata",
+        name: "validation-summary.json",
+        content: `${JSON.stringify({
+            discoveredCommands,
+            executedCommands: executedCommands.map((command) => ({
+                script: command.script,
+                command: command.command,
+                args: command.args,
+                toolEventId: command.event.id,
+                exitCode: command.event.exitCode,
+                stdoutRef: command.event.stdoutRef,
+                stderrRef: command.event.stderrRef
+            })),
+            failedCommandCount: failedCommands.length
+        }, null, 2)}\n`,
+        summary: `Validation summary for ${executedCommands.length} command(s), ${failedCommands.length} failed.`
+    });
+    const currentRun = await loadRun(latestRun.repoPath, latestRun.runId);
+    const updated = {
+        ...currentRun,
+        updatedAt: nowIso(),
+        artifacts: [...currentRun.artifacts, artifact],
+        events: [
+            ...currentRun.events,
+            createEvent("validation_evidence_captured", "Captured runtime validation evidence.", {
+                discoveredCommandCount: discoveredCommands.length,
+                executedCommandCount: executedCommands.length,
+                failedCommandCount: failedCommands.length,
+                artifactRef: artifact.ref
+            })
+        ]
+    };
+    await saveRun(updated);
+    return {
+        run: updated,
+        discoveredCommands,
+        executedCommands,
+        failedCommands,
+        artifact
+    };
+};
+//# sourceMappingURL=validationCommands.js.map

package/dist/runtime/validationCommands.js.map

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