@interf/compiler 0.22.2 → 0.50.0

package/dist/packages/runtime/schemas/context-graphs.d.ts

@@ -0,0 +1,1522 @@
+import { z } from "zod";
+import { BuildEvidenceResourceSchema, type BuildEvidenceResource } from "../../contracts/lib/schema.js";
+import { StageExecutionSessionSchema } from "../build/lib/schema.js";
+export declare const ContextGraphSemanticNodeKindSchema: z.ZodEnum<{
+    source: "source";
+    index: "index";
+    summary: "summary";
+    project: "project";
+    knowledge: "knowledge";
+    artifact: "artifact";
+    note: "note";
+    home: "home";
+    claim: "claim";
+    entity: "entity";
+}>;
+export declare const ContextGraphSemanticEdgeKindSchema: z.ZodEnum<{
+    "links-to": "links-to";
+    "source-ref": "source-ref";
+    contains: "contains";
+    handoff: "handoff";
+}>;
+export declare const ContextGraphSemanticNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        source: "source";
+        index: "index";
+        summary: "summary";
+        project: "project";
+        knowledge: "knowledge";
+        artifact: "artifact";
+        note: "note";
+        home: "home";
+        claim: "claim";
+        entity: "entity";
+    }>;
+    label: z.ZodString;
+    path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    link_count: z.ZodDefault<z.ZodNumber>;
+    backlink_count: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const ContextGraphSemanticEdgeSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        "links-to": "links-to";
+        "source-ref": "source-ref";
+        contains: "contains";
+        handoff: "handoff";
+    }>;
+    source: z.ZodString;
+    target: z.ZodString;
+    label: z.ZodString;
+    detail: z.ZodString;
+}, z.core.$strict>;
+export declare const ContextGraphSemanticGraphSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-context-graph-semantic-graph">;
+    version: z.ZodLiteral<1>;
+    generated_at: z.ZodString;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            source: "source";
+            index: "index";
+            summary: "summary";
+            project: "project";
+            knowledge: "knowledge";
+            artifact: "artifact";
+            note: "note";
+            home: "home";
+            claim: "claim";
+            entity: "entity";
+        }>;
+        label: z.ZodString;
+        path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        link_count: z.ZodDefault<z.ZodNumber>;
+        backlink_count: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            "links-to": "links-to";
+            "source-ref": "source-ref";
+            contains: "contains";
+            handoff: "handoff";
+        }>;
+        source: z.ZodString;
+        target: z.ZodString;
+        label: z.ZodString;
+        detail: z.ZodString;
+    }, z.core.$strict>>;
+    stats: z.ZodObject<{
+        notes: z.ZodNumber;
+        links: z.ZodNumber;
+        source_refs: z.ZodNumber;
+        unresolved_links: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const ContextGraphResourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-context-graph">;
+    version: z.ZodLiteral<1>;
+    graph_id: z.ZodOptional<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
+    intent: z.ZodString;
+    build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source_manifest_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodString>;
+    is_latest: z.ZodOptional<z.ZodBoolean>;
+    project: z.ZodString;
+    path: z.ZodString;
+    exists: z.ZodBoolean;
+    readiness: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-readiness-state">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        project: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            "not-ready": "not-ready";
+            failed: "failed";
+            "not-configured": "not-configured";
+            "not-built": "not-built";
+            building: "building";
+            built: "built";
+            checking: "checking";
+            stale: "stale";
+        }>;
+        ready: z.ZodBoolean;
+        summary: z.ZodString;
+        context_graph_path: z.ZodNullable<z.ZodString>;
+        latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        build: z.ZodNullable<z.ZodObject<{
+            gate: z.ZodEnum<{
+                "context-graph": "context-graph";
+                "project-config": "project-config";
+                "build-run": "build-run";
+                "artifact-diagnostics": "artifact-diagnostics";
+                "context-checks": "context-checks";
+                benchmarks: "benchmarks";
+                "benchmarks-current": "benchmarks-current";
+            }>;
+            ok: z.ZodBoolean;
+            status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+                failed: "failed";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                stale: "stale";
+            }>>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        check_results: z.ZodObject<{
+            configured: z.ZodNumber;
+            fingerprint: z.ZodNullable<z.ZodString>;
+            source_files: z.ZodNullable<z.ZodObject<{
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                pass_rate: z.ZodNullable<z.ZodNumber>;
+                checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stale: z.ZodDefault<z.ZodBoolean>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+            context_graph: z.ZodNullable<z.ZodObject<{
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                pass_rate: z.ZodNullable<z.ZodNumber>;
+                checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stale: z.ZodDefault<z.ZodBoolean>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            gate: z.ZodEnum<{
+                "context-graph": "context-graph";
+                "project-config": "project-config";
+                "build-run": "build-run";
+                "artifact-diagnostics": "artifact-diagnostics";
+                "context-checks": "context-checks";
+                benchmarks: "benchmarks";
+                "benchmarks-current": "benchmarks-current";
+            }>;
+            ok: z.ZodBoolean;
+            status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+                failed: "failed";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                stale: "stale";
+            }>>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    build_plan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    entrypoint_artifact: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        artifact_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        path: z.ZodOptional<z.ZodString>;
+        artifact_kind: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        role: z.ZodDefault<z.ZodEnum<{
+            entrypoint: "entrypoint";
+            artifact: "artifact";
+            guidance: "guidance";
+            "source-index": "source-index";
+        }>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    artifact_handoffs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        artifact_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        path: z.ZodOptional<z.ZodString>;
+        artifact_kind: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        role: z.ZodDefault<z.ZodEnum<{
+            entrypoint: "entrypoint";
+            artifact: "artifact";
+            guidance: "guidance";
+            "source-index": "source-index";
+        }>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    portable_handoff: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            runtime: "runtime";
+            output: "output";
+            source: "source";
+            evidence: "evidence";
+            benchmark: "benchmark";
+        }>;
+        stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        label: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    build_evidence: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-build-evidence">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        project_id: z.ZodString;
+        build_run_id: z.ZodNullable<z.ZodString>;
+        ready: z.ZodBoolean;
+        summary: z.ZodString;
+        rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            assertion: z.ZodString;
+            metric: z.ZodObject<{
+                observed: z.ZodNumber;
+                total: z.ZodOptional<z.ZodNumber>;
+                unit: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            evidence: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    output: "output";
+                    "source-inventory": "source-inventory";
+                    "stage-record": "stage-record";
+                    validator: "validator";
+                    trace: "trace";
+                    "stage-evidence": "stage-evidence";
+                }>;
+                label: z.ZodString;
+                ref: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                run_id: z.ZodOptional<z.ZodString>;
+                stage_id: z.ZodOptional<z.ZodString>;
+                artifact_id: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            issue_state: z.ZodOptional<z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+                missing: "missing";
+                review: "review";
+            }>>;
+            issue: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    semantic_graph: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-context-graph-semantic-graph">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                source: "source";
+                index: "index";
+                summary: "summary";
+                project: "project";
+                knowledge: "knowledge";
+                artifact: "artifact";
+                note: "note";
+                home: "home";
+                claim: "claim";
+                entity: "entity";
+            }>;
+            label: z.ZodString;
+            path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            link_count: z.ZodDefault<z.ZodNumber>;
+            backlink_count: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        edges: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                "links-to": "links-to";
+                "source-ref": "source-ref";
+                contains: "contains";
+                handoff: "handoff";
+            }>;
+            source: z.ZodString;
+            target: z.ZodString;
+            label: z.ZodString;
+            detail: z.ZodString;
+        }, z.core.$strict>>;
+        stats: z.ZodObject<{
+            notes: z.ZodNumber;
+            links: z.ZodNumber;
+            source_refs: z.ZodNumber;
+            unresolved_links: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    graph_manifest: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-graph-manifest">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        project: z.ZodString;
+        graph_id: z.ZodString;
+        run_id: z.ZodNullable<z.ZodString>;
+        build_plan: z.ZodString;
+        intent: z.ZodNullable<z.ZodString>;
+        graph_path: z.ZodString;
+        primary_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            value: z.ZodNumber;
+            total: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            primary: z.ZodDefault<z.ZodBoolean>;
+            issue_state: z.ZodOptional<z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+                missing: "missing";
+                review: "review";
+            }>>;
+            detail: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            stage_id: z.ZodString;
+            stage_label: z.ZodString;
+            role: z.ZodEnum<{
+                source: "source";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
+            }>;
+            manifest_path: z.ZodString;
+            summary: z.ZodString;
+            produced_total: z.ZodNumber;
+            missing_required_total: z.ZodNumber;
+            metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+                total: z.ZodOptional<z.ZodNumber>;
+                unit: z.ZodOptional<z.ZodString>;
+                primary: z.ZodDefault<z.ZodBoolean>;
+                issue_state: z.ZodOptional<z.ZodEnum<{
+                    pass: "pass";
+                    fail: "fail";
+                    missing: "missing";
+                    review: "review";
+                }>>;
+                detail: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>>;
+        entrypoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            role: z.ZodEnum<{
+                source: "source";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
+            }>;
+            kind: z.ZodString;
+            label: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+            locator: z.ZodOptional<z.ZodString>;
+            stage_id: z.ZodOptional<z.ZodString>;
+            source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            role: z.ZodEnum<{
+                source: "source";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
+            }>;
+            kind: z.ZodString;
+            label: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+            locator: z.ZodOptional<z.ZodString>;
+            stage_id: z.ZodOptional<z.ZodString>;
+            source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        graph_outputs: z.ZodObject<{
+            nodes: z.ZodNumber;
+            edges: z.ZodNumber;
+            notes: z.ZodNumber;
+            links: z.ZodNumber;
+            source_refs: z.ZodNumber;
+            claims: z.ZodOptional<z.ZodNumber>;
+            entities: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        readiness: z.ZodObject<{
+            status: z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+            }>;
+            ready: z.ZodBoolean;
+            summary: z.ZodString;
+            context_graph_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            missing_required_total: z.ZodNumber;
+            missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                resource_id: z.ZodString;
+                status: z.ZodEnum<{
+                    missing: "missing";
+                    blocked: "blocked";
+                    "not-relevant": "not-relevant";
+                }>;
+                reason: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>>;
+    primary_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodNumber;
+        total: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        primary: z.ZodDefault<z.ZodBoolean>;
+        issue_state: z.ZodOptional<z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            missing: "missing";
+            review: "review";
+        }>>;
+        detail: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+    stage_summaries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        stage_id: z.ZodString;
+        stage_label: z.ZodString;
+        role: z.ZodEnum<{
+            source: "source";
+            summary: "summary";
+            other: "other";
+            knowledge: "knowledge";
+            entrypoint: "entrypoint";
+            diagnostic: "diagnostic";
+        }>;
+        manifest_path: z.ZodString;
+        summary: z.ZodString;
+        produced_total: z.ZodNumber;
+        missing_required_total: z.ZodNumber;
+        metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            value: z.ZodNumber;
+            total: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            primary: z.ZodDefault<z.ZodBoolean>;
+            issue_state: z.ZodOptional<z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+                missing: "missing";
+                review: "review";
+            }>>;
+            detail: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    entrypoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<{
+            source: "source";
+            summary: "summary";
+            other: "other";
+            knowledge: "knowledge";
+            entrypoint: "entrypoint";
+            diagnostic: "diagnostic";
+        }>;
+        kind: z.ZodString;
+        label: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        locator: z.ZodOptional<z.ZodString>;
+        stage_id: z.ZodOptional<z.ZodString>;
+        source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+    resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<{
+            source: "source";
+            summary: "summary";
+            other: "other";
+            knowledge: "knowledge";
+            entrypoint: "entrypoint";
+            diagnostic: "diagnostic";
+        }>;
+        kind: z.ZodString;
+        label: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        locator: z.ZodOptional<z.ZodString>;
+        stage_id: z.ZodOptional<z.ZodString>;
+        source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+    readiness_rollup: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            ready: "ready";
+            "not-ready": "not-ready";
+        }>;
+        ready: z.ZodBoolean;
+        summary: z.ZodString;
+        context_graph_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        missing_required_total: z.ZodNumber;
+        missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            resource_id: z.ZodString;
+            status: z.ZodEnum<{
+                missing: "missing";
+                blocked: "blocked";
+                "not-relevant": "not-relevant";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    stage_sessions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-stage-execution-session">;
+        version: z.ZodLiteral<1>;
+        job_type: z.ZodDefault<z.ZodEnum<{
+            stage: "stage";
+            "source-inventory": "source-inventory";
+        }>>;
+        generated_at: z.ZodString;
+        updated_at: z.ZodString;
+        project: z.ZodString;
+        project_intent: z.ZodNullable<z.ZodString>;
+        context_graph_path: z.ZodString;
+        build_plan: z.ZodString;
+        build_run_id: z.ZodNullable<z.ZodString>;
+        stage_id: z.ZodNullable<z.ZodString>;
+        stage_label: z.ZodNullable<z.ZodString>;
+        contract_type: z.ZodNullable<z.ZodString>;
+        stage_run_id: z.ZodString;
+        attempt: z.ZodNumber;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        executor: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-agent": "local-agent";
+                "connected-provider": "connected-provider";
+                managed: "managed";
+            }>;
+            name: z.ZodString;
+            display_name: z.ZodString;
+            command: z.ZodNullable<z.ZodString>;
+            model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            timeout_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>;
+        shell: z.ZodObject<{
+            root_path: z.ZodString;
+            workspace_manifest_path: z.ZodNullable<z.ZodString>;
+            preserved_shell_manifest_path: z.ZodNullable<z.ZodString>;
+            replay_ready: z.ZodBoolean;
+            retention_reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        logs: z.ZodObject<{
+            prompt_path: z.ZodNullable<z.ZodString>;
+            event_stream_path: z.ZodNullable<z.ZodString>;
+            status_path: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        runtime_files: z.ZodObject<{
+            project_path: z.ZodNullable<z.ZodString>;
+            contract_path: z.ZodNullable<z.ZodString>;
+            paths_path: z.ZodNullable<z.ZodString>;
+            source_locator_path: z.ZodNullable<z.ZodString>;
+            source_manifest_path: z.ZodNullable<z.ZodString>;
+            source_state_path: z.ZodNullable<z.ZodString>;
+            stage_inputs_path: z.ZodNullable<z.ZodString>;
+            expected_inputs_path: z.ZodNullable<z.ZodString>;
+            reviewed_inputs_path: z.ZodNullable<z.ZodString>;
+            previous_attempts_path: z.ZodNullable<z.ZodString>;
+            retry_feedback_path: z.ZodNullable<z.ZodString>;
+            last_validation_failure_path: z.ZodNullable<z.ZodString>;
+            verifier_path: z.ZodNullable<z.ZodString>;
+            stage_evidence_path: z.ZodNullable<z.ZodString>;
+            reasoning_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        artifacts: z.ZodObject<{
+            reads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                artifact_path: z.ZodString;
+                shell_root_path: z.ZodString;
+                input_mount_path: z.ZodNullable<z.ZodString>;
+                output_mount_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>>;
+            writes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                artifact_path: z.ZodString;
+                shell_root_path: z.ZodString;
+                input_mount_path: z.ZodNullable<z.ZodString>;
+                output_mount_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strict>;
+        validation_attempts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            attempt: z.ZodNumber;
+            recorded_at: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+            }>;
+            summary: z.ZodString;
+        }, z.core.$strict>>>;
+        summary: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const ContextGraphListResponseSchema: z.ZodObject<{
+    graphs: z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-context-graph">;
+        version: z.ZodLiteral<1>;
+        graph_id: z.ZodOptional<z.ZodString>;
+        project_id: z.ZodOptional<z.ZodString>;
+        intent: z.ZodString;
+        build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source_manifest_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodOptional<z.ZodString>;
+        is_latest: z.ZodOptional<z.ZodBoolean>;
+        project: z.ZodString;
+        path: z.ZodString;
+        exists: z.ZodBoolean;
+        readiness: z.ZodObject<{
+            kind: z.ZodLiteral<"interf-readiness-state">;
+            version: z.ZodLiteral<1>;
+            generated_at: z.ZodString;
+            project: z.ZodString;
+            status: z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+                failed: "failed";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                stale: "stale";
+            }>;
+            ready: z.ZodBoolean;
+            summary: z.ZodString;
+            context_graph_path: z.ZodNullable<z.ZodString>;
+            latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            build: z.ZodNullable<z.ZodObject<{
+                gate: z.ZodEnum<{
+                    "context-graph": "context-graph";
+                    "project-config": "project-config";
+                    "build-run": "build-run";
+                    "artifact-diagnostics": "artifact-diagnostics";
+                    "context-checks": "context-checks";
+                    benchmarks: "benchmarks";
+                    "benchmarks-current": "benchmarks-current";
+                }>;
+                ok: z.ZodBoolean;
+                status: z.ZodOptional<z.ZodEnum<{
+                    ready: "ready";
+                    "not-ready": "not-ready";
+                    failed: "failed";
+                    "not-configured": "not-configured";
+                    "not-built": "not-built";
+                    building: "building";
+                    built: "built";
+                    checking: "checking";
+                    stale: "stale";
+                }>>;
+                summary: z.ZodString;
+                detail: z.ZodOptional<z.ZodString>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+            check_results: z.ZodObject<{
+                configured: z.ZodNumber;
+                fingerprint: z.ZodNullable<z.ZodString>;
+                source_files: z.ZodNullable<z.ZodObject<{
+                    passed: z.ZodNumber;
+                    total: z.ZodNumber;
+                    pass_rate: z.ZodNullable<z.ZodNumber>;
+                    checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    stale: z.ZodDefault<z.ZodBoolean>;
+                    run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>;
+                context_graph: z.ZodNullable<z.ZodObject<{
+                    passed: z.ZodNumber;
+                    total: z.ZodNumber;
+                    pass_rate: z.ZodNullable<z.ZodNumber>;
+                    checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    stale: z.ZodDefault<z.ZodBoolean>;
+                    run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                gate: z.ZodEnum<{
+                    "context-graph": "context-graph";
+                    "project-config": "project-config";
+                    "build-run": "build-run";
+                    "artifact-diagnostics": "artifact-diagnostics";
+                    "context-checks": "context-checks";
+                    benchmarks: "benchmarks";
+                    "benchmarks-current": "benchmarks-current";
+                }>;
+                ok: z.ZodBoolean;
+                status: z.ZodOptional<z.ZodEnum<{
+                    ready: "ready";
+                    "not-ready": "not-ready";
+                    failed: "failed";
+                    "not-configured": "not-configured";
+                    "not-built": "not-built";
+                    building: "building";
+                    built: "built";
+                    checking: "checking";
+                    stale: "stale";
+                }>>;
+                summary: z.ZodString;
+                detail: z.ZodOptional<z.ZodString>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        build_plan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        entrypoint_artifact: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            artifact_id: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            locator: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "local-path": "local-path";
+                    "remote-url": "remote-url";
+                    "api-served": "api-served";
+                }>;
+                value: z.ZodString;
+            }, z.core.$strict>;
+            path: z.ZodOptional<z.ZodString>;
+            artifact_kind: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>>;
+            role: z.ZodDefault<z.ZodEnum<{
+                entrypoint: "entrypoint";
+                artifact: "artifact";
+                guidance: "guidance";
+                "source-index": "source-index";
+            }>>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        artifact_handoffs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            artifact_id: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            locator: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "local-path": "local-path";
+                    "remote-url": "remote-url";
+                    "api-served": "api-served";
+                }>;
+                value: z.ZodString;
+            }, z.core.$strict>;
+            path: z.ZodOptional<z.ZodString>;
+            artifact_kind: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>>;
+            role: z.ZodDefault<z.ZodEnum<{
+                entrypoint: "entrypoint";
+                artifact: "artifact";
+                guidance: "guidance";
+                "source-index": "source-index";
+            }>>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        portable_handoff: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            locator: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "local-path": "local-path";
+                    "remote-url": "remote-url";
+                    "api-served": "api-served";
+                }>;
+                value: z.ZodString;
+            }, z.core.$strict>;
+            instructions: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            role: z.ZodEnum<{
+                runtime: "runtime";
+                output: "output";
+                source: "source";
+                evidence: "evidence";
+                benchmark: "benchmark";
+            }>;
+            stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            label: z.ZodOptional<z.ZodString>;
+            sha256: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        build_evidence: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"interf-build-evidence">;
+            version: z.ZodLiteral<1>;
+            generated_at: z.ZodString;
+            project_id: z.ZodString;
+            build_run_id: z.ZodNullable<z.ZodString>;
+            ready: z.ZodBoolean;
+            summary: z.ZodString;
+            rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                assertion: z.ZodString;
+                metric: z.ZodObject<{
+                    observed: z.ZodNumber;
+                    total: z.ZodOptional<z.ZodNumber>;
+                    unit: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                evidence: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        output: "output";
+                        "source-inventory": "source-inventory";
+                        "stage-record": "stage-record";
+                        validator: "validator";
+                        trace: "trace";
+                        "stage-evidence": "stage-evidence";
+                    }>;
+                    label: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    path: z.ZodOptional<z.ZodString>;
+                    run_id: z.ZodOptional<z.ZodString>;
+                    stage_id: z.ZodOptional<z.ZodString>;
+                    artifact_id: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                issue_state: z.ZodOptional<z.ZodEnum<{
+                    pass: "pass";
+                    fail: "fail";
+                    missing: "missing";
+                    review: "review";
+                }>>;
+                issue: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        semantic_graph: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"interf-context-graph-semantic-graph">;
+            version: z.ZodLiteral<1>;
+            generated_at: z.ZodString;
+            nodes: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    source: "source";
+                    index: "index";
+                    summary: "summary";
+                    project: "project";
+                    knowledge: "knowledge";
+                    artifact: "artifact";
+                    note: "note";
+                    home: "home";
+                    claim: "claim";
+                    entity: "entity";
+                }>;
+                label: z.ZodString;
+                path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                link_count: z.ZodDefault<z.ZodNumber>;
+                backlink_count: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            edges: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    "links-to": "links-to";
+                    "source-ref": "source-ref";
+                    contains: "contains";
+                    handoff: "handoff";
+                }>;
+                source: z.ZodString;
+                target: z.ZodString;
+                label: z.ZodString;
+                detail: z.ZodString;
+            }, z.core.$strict>>;
+            stats: z.ZodObject<{
+                notes: z.ZodNumber;
+                links: z.ZodNumber;
+                source_refs: z.ZodNumber;
+                unresolved_links: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        graph_manifest: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            kind: z.ZodLiteral<"interf-graph-manifest">;
+            version: z.ZodLiteral<1>;
+            generated_at: z.ZodString;
+            project: z.ZodString;
+            graph_id: z.ZodString;
+            run_id: z.ZodNullable<z.ZodString>;
+            build_plan: z.ZodString;
+            intent: z.ZodNullable<z.ZodString>;
+            graph_path: z.ZodString;
+            primary_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+                total: z.ZodOptional<z.ZodNumber>;
+                unit: z.ZodOptional<z.ZodString>;
+                primary: z.ZodDefault<z.ZodBoolean>;
+                issue_state: z.ZodOptional<z.ZodEnum<{
+                    pass: "pass";
+                    fail: "fail";
+                    missing: "missing";
+                    review: "review";
+                }>>;
+                detail: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+            stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                stage_id: z.ZodString;
+                stage_label: z.ZodString;
+                role: z.ZodEnum<{
+                    source: "source";
+                    summary: "summary";
+                    other: "other";
+                    knowledge: "knowledge";
+                    entrypoint: "entrypoint";
+                    diagnostic: "diagnostic";
+                }>;
+                manifest_path: z.ZodString;
+                summary: z.ZodString;
+                produced_total: z.ZodNumber;
+                missing_required_total: z.ZodNumber;
+                metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    key: z.ZodString;
+                    label: z.ZodString;
+                    value: z.ZodNumber;
+                    total: z.ZodOptional<z.ZodNumber>;
+                    unit: z.ZodOptional<z.ZodString>;
+                    primary: z.ZodDefault<z.ZodBoolean>;
+                    issue_state: z.ZodOptional<z.ZodEnum<{
+                        pass: "pass";
+                        fail: "fail";
+                        missing: "missing";
+                        review: "review";
+                    }>>;
+                    detail: z.ZodOptional<z.ZodString>;
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            entrypoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                role: z.ZodEnum<{
+                    source: "source";
+                    summary: "summary";
+                    other: "other";
+                    knowledge: "knowledge";
+                    entrypoint: "entrypoint";
+                    diagnostic: "diagnostic";
+                }>;
+                kind: z.ZodString;
+                label: z.ZodString;
+                path: z.ZodOptional<z.ZodString>;
+                locator: z.ZodOptional<z.ZodString>;
+                stage_id: z.ZodOptional<z.ZodString>;
+                source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+            resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                role: z.ZodEnum<{
+                    source: "source";
+                    summary: "summary";
+                    other: "other";
+                    knowledge: "knowledge";
+                    entrypoint: "entrypoint";
+                    diagnostic: "diagnostic";
+                }>;
+                kind: z.ZodString;
+                label: z.ZodString;
+                path: z.ZodOptional<z.ZodString>;
+                locator: z.ZodOptional<z.ZodString>;
+                stage_id: z.ZodOptional<z.ZodString>;
+                source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+            graph_outputs: z.ZodObject<{
+                nodes: z.ZodNumber;
+                edges: z.ZodNumber;
+                notes: z.ZodNumber;
+                links: z.ZodNumber;
+                source_refs: z.ZodNumber;
+                claims: z.ZodOptional<z.ZodNumber>;
+                entities: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>;
+            readiness: z.ZodObject<{
+                status: z.ZodEnum<{
+                    ready: "ready";
+                    "not-ready": "not-ready";
+                }>;
+                ready: z.ZodBoolean;
+                summary: z.ZodString;
+                context_graph_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                missing_required_total: z.ZodNumber;
+                missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    resource_id: z.ZodString;
+                    status: z.ZodEnum<{
+                        missing: "missing";
+                        blocked: "blocked";
+                        "not-relevant": "not-relevant";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>>;
+        primary_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            value: z.ZodNumber;
+            total: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            primary: z.ZodDefault<z.ZodBoolean>;
+            issue_state: z.ZodOptional<z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+                missing: "missing";
+                review: "review";
+            }>>;
+            detail: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        stage_summaries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            stage_id: z.ZodString;
+            stage_label: z.ZodString;
+            role: z.ZodEnum<{
+                source: "source";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
+            }>;
+            manifest_path: z.ZodString;
+            summary: z.ZodString;
+            produced_total: z.ZodNumber;
+            missing_required_total: z.ZodNumber;
+            metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodNumber;
+                total: z.ZodOptional<z.ZodNumber>;
+                unit: z.ZodOptional<z.ZodString>;
+                primary: z.ZodDefault<z.ZodBoolean>;
+                issue_state: z.ZodOptional<z.ZodEnum<{
+                    pass: "pass";
+                    fail: "fail";
+                    missing: "missing";
+                    review: "review";
+                }>>;
+                detail: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>>;
+        entrypoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            role: z.ZodEnum<{
+                source: "source";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
+            }>;
+            kind: z.ZodString;
+            label: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+            locator: z.ZodOptional<z.ZodString>;
+            stage_id: z.ZodOptional<z.ZodString>;
+            source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            role: z.ZodEnum<{
+                source: "source";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
+            }>;
+            kind: z.ZodString;
+            label: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+            locator: z.ZodOptional<z.ZodString>;
+            stage_id: z.ZodOptional<z.ZodString>;
+            source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        readiness_rollup: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+            }>;
+            ready: z.ZodBoolean;
+            summary: z.ZodString;
+            context_graph_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            missing_required_total: z.ZodNumber;
+            missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                resource_id: z.ZodString;
+                status: z.ZodEnum<{
+                    missing: "missing";
+                    blocked: "blocked";
+                    "not-relevant": "not-relevant";
+                }>;
+                reason: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>>;
+        stage_sessions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodLiteral<"interf-stage-execution-session">;
+            version: z.ZodLiteral<1>;
+            job_type: z.ZodDefault<z.ZodEnum<{
+                stage: "stage";
+                "source-inventory": "source-inventory";
+            }>>;
+            generated_at: z.ZodString;
+            updated_at: z.ZodString;
+            project: z.ZodString;
+            project_intent: z.ZodNullable<z.ZodString>;
+            context_graph_path: z.ZodString;
+            build_plan: z.ZodString;
+            build_run_id: z.ZodNullable<z.ZodString>;
+            stage_id: z.ZodNullable<z.ZodString>;
+            stage_label: z.ZodNullable<z.ZodString>;
+            contract_type: z.ZodNullable<z.ZodString>;
+            stage_run_id: z.ZodString;
+            attempt: z.ZodNumber;
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                succeeded: "succeeded";
+            }>;
+            executor: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "local-agent": "local-agent";
+                    "connected-provider": "connected-provider";
+                    managed: "managed";
+                }>;
+                name: z.ZodString;
+                display_name: z.ZodString;
+                command: z.ZodNullable<z.ZodString>;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                timeout_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            shell: z.ZodObject<{
+                root_path: z.ZodString;
+                workspace_manifest_path: z.ZodNullable<z.ZodString>;
+                preserved_shell_manifest_path: z.ZodNullable<z.ZodString>;
+                replay_ready: z.ZodBoolean;
+                retention_reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>;
+            logs: z.ZodObject<{
+                prompt_path: z.ZodNullable<z.ZodString>;
+                event_stream_path: z.ZodNullable<z.ZodString>;
+                status_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+            runtime_files: z.ZodObject<{
+                project_path: z.ZodNullable<z.ZodString>;
+                contract_path: z.ZodNullable<z.ZodString>;
+                paths_path: z.ZodNullable<z.ZodString>;
+                source_locator_path: z.ZodNullable<z.ZodString>;
+                source_manifest_path: z.ZodNullable<z.ZodString>;
+                source_state_path: z.ZodNullable<z.ZodString>;
+                stage_inputs_path: z.ZodNullable<z.ZodString>;
+                expected_inputs_path: z.ZodNullable<z.ZodString>;
+                reviewed_inputs_path: z.ZodNullable<z.ZodString>;
+                previous_attempts_path: z.ZodNullable<z.ZodString>;
+                retry_feedback_path: z.ZodNullable<z.ZodString>;
+                last_validation_failure_path: z.ZodNullable<z.ZodString>;
+                verifier_path: z.ZodNullable<z.ZodString>;
+                stage_evidence_path: z.ZodNullable<z.ZodString>;
+                reasoning_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>;
+            artifacts: z.ZodObject<{
+                reads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    artifact_id: z.ZodString;
+                    artifact_path: z.ZodString;
+                    shell_root_path: z.ZodString;
+                    input_mount_path: z.ZodNullable<z.ZodString>;
+                    output_mount_path: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>>;
+                writes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    artifact_id: z.ZodString;
+                    artifact_path: z.ZodString;
+                    shell_root_path: z.ZodString;
+                    input_mount_path: z.ZodNullable<z.ZodString>;
+                    output_mount_path: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>>;
+            }, z.core.$strict>;
+            validation_attempts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                attempt: z.ZodNumber;
+                recorded_at: z.ZodString;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    succeeded: "succeeded";
+                }>;
+                summary: z.ZodString;
+            }, z.core.$strict>>>;
+            summary: z.ZodNullable<z.ZodString>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * `GET /v1/projects/<id>/context-graph/sessions` — the replayable per-stage
+ * execution shell sessions for the latest Build run. One shape, reused by the
+ * service operation registry, the CLI `graphs sessions` reader, and MCP.
+ */
+export declare const ContextGraphSessionsResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-stage-execution-session">;
+        version: z.ZodLiteral<1>;
+        job_type: z.ZodDefault<z.ZodEnum<{
+            stage: "stage";
+            "source-inventory": "source-inventory";
+        }>>;
+        generated_at: z.ZodString;
+        updated_at: z.ZodString;
+        project: z.ZodString;
+        project_intent: z.ZodNullable<z.ZodString>;
+        context_graph_path: z.ZodString;
+        build_plan: z.ZodString;
+        build_run_id: z.ZodNullable<z.ZodString>;
+        stage_id: z.ZodNullable<z.ZodString>;
+        stage_label: z.ZodNullable<z.ZodString>;
+        contract_type: z.ZodNullable<z.ZodString>;
+        stage_run_id: z.ZodString;
+        attempt: z.ZodNumber;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        executor: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-agent": "local-agent";
+                "connected-provider": "connected-provider";
+                managed: "managed";
+            }>;
+            name: z.ZodString;
+            display_name: z.ZodString;
+            command: z.ZodNullable<z.ZodString>;
+            model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            timeout_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>;
+        shell: z.ZodObject<{
+            root_path: z.ZodString;
+            workspace_manifest_path: z.ZodNullable<z.ZodString>;
+            preserved_shell_manifest_path: z.ZodNullable<z.ZodString>;
+            replay_ready: z.ZodBoolean;
+            retention_reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        logs: z.ZodObject<{
+            prompt_path: z.ZodNullable<z.ZodString>;
+            event_stream_path: z.ZodNullable<z.ZodString>;
+            status_path: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        runtime_files: z.ZodObject<{
+            project_path: z.ZodNullable<z.ZodString>;
+            contract_path: z.ZodNullable<z.ZodString>;
+            paths_path: z.ZodNullable<z.ZodString>;
+            source_locator_path: z.ZodNullable<z.ZodString>;
+            source_manifest_path: z.ZodNullable<z.ZodString>;
+            source_state_path: z.ZodNullable<z.ZodString>;
+            stage_inputs_path: z.ZodNullable<z.ZodString>;
+            expected_inputs_path: z.ZodNullable<z.ZodString>;
+            reviewed_inputs_path: z.ZodNullable<z.ZodString>;
+            previous_attempts_path: z.ZodNullable<z.ZodString>;
+            retry_feedback_path: z.ZodNullable<z.ZodString>;
+            last_validation_failure_path: z.ZodNullable<z.ZodString>;
+            verifier_path: z.ZodNullable<z.ZodString>;
+            stage_evidence_path: z.ZodNullable<z.ZodString>;
+            reasoning_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        artifacts: z.ZodObject<{
+            reads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                artifact_path: z.ZodString;
+                shell_root_path: z.ZodString;
+                input_mount_path: z.ZodNullable<z.ZodString>;
+                output_mount_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>>;
+            writes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                artifact_path: z.ZodString;
+                shell_root_path: z.ZodString;
+                input_mount_path: z.ZodNullable<z.ZodString>;
+                output_mount_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strict>;
+        validation_attempts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            attempt: z.ZodNumber;
+            recorded_at: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+            }>;
+            summary: z.ZodString;
+        }, z.core.$strict>>>;
+        summary: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * `GET /v1/projects/<id>/context-graph/sessions/<stage-run-id>` — one preserved
+ * execution shell session. Same single-session shape across service, CLI, MCP.
+ */
+export declare const ContextGraphSessionResponseSchema: z.ZodObject<{
+    session: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-stage-execution-session">;
+        version: z.ZodLiteral<1>;
+        job_type: z.ZodDefault<z.ZodEnum<{
+            stage: "stage";
+            "source-inventory": "source-inventory";
+        }>>;
+        generated_at: z.ZodString;
+        updated_at: z.ZodString;
+        project: z.ZodString;
+        project_intent: z.ZodNullable<z.ZodString>;
+        context_graph_path: z.ZodString;
+        build_plan: z.ZodString;
+        build_run_id: z.ZodNullable<z.ZodString>;
+        stage_id: z.ZodNullable<z.ZodString>;
+        stage_label: z.ZodNullable<z.ZodString>;
+        contract_type: z.ZodNullable<z.ZodString>;
+        stage_run_id: z.ZodString;
+        attempt: z.ZodNumber;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        executor: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-agent": "local-agent";
+                "connected-provider": "connected-provider";
+                managed: "managed";
+            }>;
+            name: z.ZodString;
+            display_name: z.ZodString;
+            command: z.ZodNullable<z.ZodString>;
+            model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            timeout_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>;
+        shell: z.ZodObject<{
+            root_path: z.ZodString;
+            workspace_manifest_path: z.ZodNullable<z.ZodString>;
+            preserved_shell_manifest_path: z.ZodNullable<z.ZodString>;
+            replay_ready: z.ZodBoolean;
+            retention_reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        logs: z.ZodObject<{
+            prompt_path: z.ZodNullable<z.ZodString>;
+            event_stream_path: z.ZodNullable<z.ZodString>;
+            status_path: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        runtime_files: z.ZodObject<{
+            project_path: z.ZodNullable<z.ZodString>;
+            contract_path: z.ZodNullable<z.ZodString>;
+            paths_path: z.ZodNullable<z.ZodString>;
+            source_locator_path: z.ZodNullable<z.ZodString>;
+            source_manifest_path: z.ZodNullable<z.ZodString>;
+            source_state_path: z.ZodNullable<z.ZodString>;
+            stage_inputs_path: z.ZodNullable<z.ZodString>;
+            expected_inputs_path: z.ZodNullable<z.ZodString>;
+            reviewed_inputs_path: z.ZodNullable<z.ZodString>;
+            previous_attempts_path: z.ZodNullable<z.ZodString>;
+            retry_feedback_path: z.ZodNullable<z.ZodString>;
+            last_validation_failure_path: z.ZodNullable<z.ZodString>;
+            verifier_path: z.ZodNullable<z.ZodString>;
+            stage_evidence_path: z.ZodNullable<z.ZodString>;
+            reasoning_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        artifacts: z.ZodObject<{
+            reads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                artifact_path: z.ZodString;
+                shell_root_path: z.ZodString;
+                input_mount_path: z.ZodNullable<z.ZodString>;
+                output_mount_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>>;
+            writes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                artifact_path: z.ZodString;
+                shell_root_path: z.ZodString;
+                input_mount_path: z.ZodNullable<z.ZodString>;
+                output_mount_path: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strict>;
+        validation_attempts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            attempt: z.ZodNumber;
+            recorded_at: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+            }>;
+            summary: z.ZodString;
+        }, z.core.$strict>>>;
+        summary: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ContextGraphResource = z.infer<typeof ContextGraphResourceSchema>;
+export type ContextGraphListResponse = z.infer<typeof ContextGraphListResponseSchema>;
+export type ContextGraphSessionsResponse = z.infer<typeof ContextGraphSessionsResponseSchema>;
+export type ContextGraphSessionResponse = z.infer<typeof ContextGraphSessionResponseSchema>;
+export type ContextGraphSemanticEdge = z.infer<typeof ContextGraphSemanticEdgeSchema>;
+export type ContextGraphSemanticEdgeKind = z.infer<typeof ContextGraphSemanticEdgeKindSchema>;
+export type ContextGraphSemanticGraph = z.infer<typeof ContextGraphSemanticGraphSchema>;
+export type ContextGraphSemanticNode = z.infer<typeof ContextGraphSemanticNodeSchema>;
+export type ContextGraphSemanticNodeKind = z.infer<typeof ContextGraphSemanticNodeKindSchema>;
+export { BuildEvidenceResourceSchema };
+export { StageExecutionSessionSchema };
+export type { StageExecutionSession } from "../build/lib/schema.js";
+export type { BuildEvidenceResource };