@interf/compiler 0.33.0 → 0.50.0

package/dist/packages/runtime/service/operations.d.ts

@@ -93,32 +93,73 @@ export declare const SERVICE_OPERATIONS: readonly [{
     readonly visibility: "public";
     readonly response_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     readonly success_status: 200;
+}, {
+    readonly id: "listProjects";
+    readonly method: "GET";
+    readonly path: "/v1/projects";
+    readonly tags: ["Projects"];
+    readonly summary: "List Projects";
+    readonly description: "Return Projects registered on this instance with Source bindings, intent, Build Plan selection, and Context Graph locators.";
+    readonly visibility: "app";
+    readonly response_schema: z.ZodObject<{
+        projects: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            project_id: z.ZodOptional<z.ZodString>;
+            source: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "local-folder": "local-folder";
+                }>;
+                locator: z.ZodString;
+            }, z.core.$strict>;
+            intent: z.ZodString;
+            build_plan_id: z.ZodNullable<z.ZodString>;
+            config_path: z.ZodString;
+            updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            context_graph: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "local-path": "local-path";
+                    "remote-url": "remote-url";
+                    "api-served": "api-served";
+                }>;
+                value: z.ZodString;
+            }, z.core.$strict>;
+            context_graph_path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
 }, {
     readonly id: "createProject";
     readonly method: "POST";
     readonly path: "/v1/projects";
     readonly tags: ["Projects"];
     readonly summary: "Create Project";
-    readonly description: "Create a Project bound to one Source. Project ids may be generated by clients.";
+    readonly description: "Create a Project bound to one Source and one agent task intent. Project ids may be generated by clients.";
     readonly visibility: "app";
     readonly workflow_step: 1;
     readonly request_schema: z.ZodObject<{
         id: z.ZodString;
         source: z.ZodObject<{
-            kind: z.ZodLiteral<"local-folder">;
+            kind: z.ZodEnum<{
+                "local-folder": "local-folder";
+            }>;
             locator: z.ZodString;
         }, z.core.$strict>;
+        intent: z.ZodString;
         build_plan_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>;
     readonly response_schema: z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodOptional<z.ZodString>;
         source: z.ZodObject<{
-            kind: z.ZodLiteral<"local-folder">;
+            kind: z.ZodEnum<{
+                "local-folder": "local-folder";
+            }>;
             locator: z.ZodString;
         }, z.core.$strict>;
+        intent: z.ZodString;
         build_plan_id: z.ZodNullable<z.ZodString>;
         config_path: z.ZodString;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         context_graph: z.ZodObject<{
             kind: z.ZodEnum<{
                 "local-path": "local-path";
@@ -141,22 +182,178 @@ export declare const SERVICE_OPERATIONS: readonly [{
     readonly parameters: [ServiceOperationParameter];
     readonly response_schema: z.ZodObject<{
         id: z.ZodString;
-        project_id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
         source: z.ZodObject<{
-            kind: z.ZodLiteral<"local-folder">;
+            kind: z.ZodEnum<{
+                "local-folder": "local-folder";
+            }>;
             locator: z.ZodString;
         }, z.core.$strict>;
-        build_plan_id: z.ZodNullable<z.ZodString>;
+        intent: z.ZodString;
+        config: z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            intent: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
+            path: z.ZodString;
+            build_plan: z.ZodOptional<z.ZodString>;
+            latest_context_graph_run_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
         config_path: z.ZodString;
+        source_path: z.ZodString;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        build_plan_id: z.ZodNullable<z.ZodString>;
         context_graph: z.ZodObject<{
-            kind: z.ZodEnum<{
-                "local-path": "local-path";
-                "remote-url": "remote-url";
-                "api-served": "api-served";
+            project: z.ZodString;
+            path: z.ZodNullable<z.ZodString>;
+            exists: z.ZodBoolean;
+            intent: z.ZodString;
+            build_plan_id: z.ZodNullable<z.ZodString>;
+            latest_build_run_id: z.ZodNullable<z.ZodString>;
+            latest_benchmark_run_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        context_graph_path: z.ZodNullable<z.ZodString>;
+        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";
             }>;
-            value: z.ZodString;
+            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>;
-        context_graph_path: z.ZodOptional<z.ZodString>;
+        runs: z.ZodObject<{
+            latest_build_run_id: z.ZodNullable<z.ZodString>;
+            latest_benchmark_run_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            artifact_id: z.ZodString;
+            status: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
+                skipped: "skipped";
+                not_ready: "not_ready";
+            }>;
+            built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            check_results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                check_id: z.ZodString;
+                kind: z.ZodEnum<{
+                    file_exists: "file_exists";
+                    source_manifest_valid: "source_manifest_valid";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    source_summary_folders: "source_summary_folders";
+                    source_page_coverage: "source_page_coverage";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                    source_refs_required: "source_refs_required";
+                    summary_backlinks_present: "summary_backlinks_present";
+                    knowledge_web_connectivity: "knowledge_web_connectivity";
+                    graph_notes_connected: "graph_notes_connected";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                passed: z.ZodBoolean;
+                required: z.ZodBoolean;
+                summary: z.ZodString;
+                details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                evaluated_at: z.ZodString;
+            }, z.core.$strict>>>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
     }, z.core.$strict>;
     readonly success_status: 200;
 }, {
@@ -165,7 +362,7 @@ export declare const SERVICE_OPERATIONS: readonly [{
     readonly path: "/v1/projects/{project_id}/build-plan-drafts";
     readonly tags: ["Build Plans"];
     readonly summary: "Prepare Build Plan";
-    readonly description: "Draft a Build Plan from the approved intent, Context Checks, and requested Artifacts. This does not run a Build.";
+    readonly description: "Draft a Build Plan from the Project intent, requested outputs, and coverage expectations. This does not run a Build.";
     readonly visibility: "app";
     readonly workflow_step: 2;
     readonly parameters: [ServiceOperationParameter];
@@ -189,7 +386,6 @@ export declare const SERVICE_OPERATIONS: readonly [{
             backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
             required: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>>;
-        intent: z.ZodString;
         requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             title: z.ZodString;
@@ -221,6 +417,9 @@ export declare const SERVICE_OPERATIONS: readonly [{
                         frontmatter_required_keys: "frontmatter_required_keys";
                         frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
                         source_refs_required: "source_refs_required";
+                        summary_backlinks_present: "summary_backlinks_present";
+                        knowledge_web_connectivity: "knowledge_web_connectivity";
+                        graph_notes_connected: "graph_notes_connected";
                         wikilinks_valid: "wikilinks_valid";
                         must_not_contain: "must_not_contain";
                         must_contain: "must_contain";
@@ -270,6 +469,9 @@ export declare const SERVICE_OPERATIONS: readonly [{
                     frontmatter_required_keys: "frontmatter_required_keys";
                     frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
                     source_refs_required: "source_refs_required";
+                    summary_backlinks_present: "summary_backlinks_present";
+                    knowledge_web_connectivity: "knowledge_web_connectivity";
+                    graph_notes_connected: "graph_notes_connected";
                     wikilinks_valid: "wikilinks_valid";
                     must_not_contain: "must_not_contain";
                     must_contain: "must_contain";
@@ -285,6 +487,7 @@ export declare const SERVICE_OPERATIONS: readonly [{
         hint: z.ZodOptional<z.ZodString>;
         base_build_plan_id: z.ZodOptional<z.ZodString>;
         reference_build_plan_id: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
     readonly response_schema: z.ZodObject<{
         kind: z.ZodLiteral<"interf-local-job-run">;
@@ -378,8 +581,8 @@ export declare const SERVICE_OPERATIONS: readonly [{
     readonly workflow_step: 3;
     readonly parameters: [ServiceOperationParameter];
     readonly request_schema: z.ZodDefault<z.ZodObject<{
-        max_attempts: z.ZodOptional<z.ZodNumber>;
         max_loops: z.ZodOptional<z.ZodNumber>;
+        max_attempts: z.ZodOptional<z.ZodNumber>;
         preserve_stage_shells: z.ZodOptional<z.ZodEnum<{
             "on-failure": "on-failure";
             always: "always";
@@ -647,14 +850,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                     generated_at: z.ZodString;
                     project: z.ZodString;
                     status: z.ZodEnum<{
-                        failed: "failed";
                         ready: "ready";
+                        "not-ready": "not-ready";
+                        failed: "failed";
                         "not-configured": "not-configured";
                         "not-built": "not-built";
                         building: "building";
                         built: "built";
                         checking: "checking";
-                        "not-ready": "not-ready";
                         stale: "stale";
                     }>;
                     ready: z.ZodBoolean;
@@ -674,14 +877,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                         }>;
                         ok: z.ZodBoolean;
                         status: z.ZodOptional<z.ZodEnum<{
-                            failed: "failed";
                             ready: "ready";
+                            "not-ready": "not-ready";
+                            failed: "failed";
                             "not-configured": "not-configured";
                             "not-built": "not-built";
                             building: "building";
                             built: "built";
                             checking: "checking";
-                            "not-ready": "not-ready";
                             stale: "stale";
                         }>>;
                         summary: z.ZodString;
@@ -723,14 +926,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                         }>;
                         ok: z.ZodBoolean;
                         status: z.ZodOptional<z.ZodEnum<{
-                            failed: "failed";
                             ready: "ready";
+                            "not-ready": "not-ready";
+                            failed: "failed";
                             "not-configured": "not-configured";
                             "not-built": "not-built";
                             building: "building";
                             built: "built";
                             checking: "checking";
-                            "not-ready": "not-ready";
                             stale: "stale";
                         }>>;
                         summary: z.ZodString;
@@ -773,14 +976,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                 generated_at: z.ZodString;
                 project: z.ZodString;
                 status: z.ZodEnum<{
-                    failed: "failed";
                     ready: "ready";
+                    "not-ready": "not-ready";
+                    failed: "failed";
                     "not-configured": "not-configured";
                     "not-built": "not-built";
                     building: "building";
                     built: "built";
                     checking: "checking";
-                    "not-ready": "not-ready";
                     stale: "stale";
                 }>;
                 ready: z.ZodBoolean;
@@ -800,14 +1003,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                     }>;
                     ok: z.ZodBoolean;
                     status: z.ZodOptional<z.ZodEnum<{
-                        failed: "failed";
                         ready: "ready";
+                        "not-ready": "not-ready";
+                        failed: "failed";
                         "not-configured": "not-configured";
                         "not-built": "not-built";
                         building: "building";
                         built: "built";
                         checking: "checking";
-                        "not-ready": "not-ready";
                         stale: "stale";
                     }>>;
                     summary: z.ZodString;
@@ -849,14 +1052,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                     }>;
                     ok: z.ZodBoolean;
                     status: z.ZodOptional<z.ZodEnum<{
-                        failed: "failed";
                         ready: "ready";
+                        "not-ready": "not-ready";
+                        failed: "failed";
                         "not-configured": "not-configured";
                         "not-built": "not-built";
                         building: "building";
                         built: "built";
                         checking: "checking";
-                        "not-ready": "not-ready";
                         stale: "stale";
                     }>>;
                     summary: z.ZodString;
@@ -885,9 +1088,9 @@ export declare const SERVICE_OPERATIONS: readonly [{
             artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 artifact_id: z.ZodString;
                 status: z.ZodEnum<{
+                    ready: "ready";
                     failed: "failed";
                     skipped: "skipped";
-                    ready: "ready";
                     not_ready: "not_ready";
                 }>;
                 built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -904,6 +1107,9 @@ export declare const SERVICE_OPERATIONS: readonly [{
                         frontmatter_required_keys: "frontmatter_required_keys";
                         frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
                         source_refs_required: "source_refs_required";
+                        summary_backlinks_present: "summary_backlinks_present";
+                        knowledge_web_connectivity: "knowledge_web_connectivity";
+                        graph_notes_connected: "graph_notes_connected";
                         wikilinks_valid: "wikilinks_valid";
                         must_not_contain: "must_not_contain";
                         must_contain: "must_contain";
@@ -968,14 +1174,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
             generated_at: z.ZodString;
             project: z.ZodString;
             status: z.ZodEnum<{
-                failed: "failed";
                 ready: "ready";
+                "not-ready": "not-ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                "not-ready": "not-ready";
                 stale: "stale";
             }>;
             ready: z.ZodBoolean;
@@ -995,14 +1201,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                 }>;
                 ok: z.ZodBoolean;
                 status: z.ZodOptional<z.ZodEnum<{
-                    failed: "failed";
                     ready: "ready";
+                    "not-ready": "not-ready";
+                    failed: "failed";
                     "not-configured": "not-configured";
                     "not-built": "not-built";
                     building: "building";
                     built: "built";
                     checking: "checking";
-                    "not-ready": "not-ready";
                     stale: "stale";
                 }>>;
                 summary: z.ZodString;
@@ -1044,14 +1250,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                 }>;
                 ok: z.ZodBoolean;
                 status: z.ZodOptional<z.ZodEnum<{
-                    failed: "failed";
                     ready: "ready";
+                    "not-ready": "not-ready";
+                    failed: "failed";
                     "not-configured": "not-configured";
                     "not-built": "not-built";
                     building: "building";
                     built: "built";
                     checking: "checking";
-                    "not-ready": "not-ready";
                     stale: "stale";
                 }>>;
                 summary: z.ZodString;
@@ -1091,59 +1297,321 @@ export declare const SERVICE_OPERATIONS: readonly [{
     }, z.core.$strict>;
     readonly success_status: 200;
 }, {
-    readonly id: "readRunFile";
+    readonly id: "getRunEvents";
     readonly method: "GET";
-    readonly path: "/v1/runs/{run_id}/files";
+    readonly path: "/v1/runs/{run_id}/events";
     readonly tags: ["Runs"];
-    readonly summary: "Read Run file";
-    readonly description: "Read a prompt log, status log, event stream, stage contract, or evidence file from the exact Build run output. Use this instead of latest Context Graph file reads when debugging historical runs.";
-    readonly visibility: "app";
-    readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
-    readonly response_schema: z.ZodString;
-    readonly response_content_type: "text/plain";
-    readonly success_status: 200;
-}, {
-    readonly id: "getLatestContextGraph";
-    readonly method: "GET";
-    readonly path: "/v1/projects/{project_id}/context-graph";
-    readonly tags: ["Context Graphs"];
-    readonly summary: "Get latest Context Graph";
-    readonly description: "Return the latest successful Context Graph locator and readiness state for a Project. This is a compact locator/status read; read artifacts/ handoff files before answering.";
+    readonly summary: "Get Run events";
+    readonly description: "Read the durable event log for a Build run: stage start/pass/fail, files processed, artifacts written, evidence, checks, and readiness. Use compact status for polling; read events to inspect or replay what happened.";
     readonly visibility: "app";
     readonly parameters: [ServiceOperationParameter];
     readonly response_schema: z.ZodObject<{
-        kind: z.ZodOptional<z.ZodLiteral<"interf-context-graph">>;
-        version: z.ZodOptional<z.ZodLiteral<1>>;
-        graph_id: z.ZodOptional<z.ZodString>;
-        project_id: z.ZodOptional<z.ZodString>;
-        build_run_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;
+        events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"run.started">;
             project: z.ZodString;
-            status: z.ZodEnum<{
-                failed: "failed";
-                ready: "ready";
-                "not-configured": "not-configured";
-                "not-built": "not-built";
-                building: "building";
-                built: "built";
-                checking: "checking";
-                "not-ready": "not-ready";
-                stale: "stale";
+            build_plan: z.ZodOptional<z.ZodString>;
+            context_graph_path: z.ZodOptional<z.ZodString>;
+            backend: z.ZodEnum<{
+                native: "native";
             }>;
-            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<{
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"stage.started">;
+            stage_id: z.ZodString;
+            stage_index: z.ZodOptional<z.ZodNumber>;
+            stage_total: z.ZodOptional<z.ZodNumber>;
+            logs: z.ZodOptional<z.ZodObject<{
+                prompt_path: z.ZodOptional<z.ZodString>;
+                event_stream_path: z.ZodOptional<z.ZodString>;
+                status_path: z.ZodOptional<z.ZodString>;
+                contract_path: z.ZodOptional<z.ZodString>;
+                evidence_path: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"file.processed">;
+            stage_id: z.ZodString;
+            path: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"artifact.written">;
+            stage_id: z.ZodString;
+            artifact: 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>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"evidence.updated">;
+            stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            evidence: z.ZodObject<{
+                id: z.ZodString;
+                run_id: z.ZodString;
+                stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                generated_at: z.ZodString;
+                summary: z.ZodString;
+                files_processed: z.ZodOptional<z.ZodNumber>;
+                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>>>;
+                checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    ok: z.ZodBoolean;
+                    detail: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"log.appended">;
+            stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stream: z.ZodEnum<{
+                status: "status";
+                trace: "trace";
+                system: "system";
+            }>;
+            message: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"stage.passed">;
+            stage_id: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"stage.failed">;
+            stage_id: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"run.completed">;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"run.failed">;
+            error: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"run.cancelled">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"checks.evaluated">;
+            passed: z.ZodNumber;
+            total: z.ZodNumber;
+            target: z.ZodOptional<z.ZodEnum<{
+                "source-files": "source-files";
+                "context-graph": "context-graph";
+            }>>;
+            checks_fingerprint: z.ZodOptional<z.ZodString>;
+            stale: z.ZodOptional<z.ZodBoolean>;
+            test_run_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodLiteral<"readiness.updated">;
+            project: z.ZodString;
+            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>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "readRunFile";
+    readonly method: "GET";
+    readonly path: "/v1/runs/{run_id}/files";
+    readonly tags: ["Runs"];
+    readonly summary: "Read Run file";
+    readonly description: "Read a prompt log, status log, event stream, stage contract, or evidence file from the exact Build run output. Use this instead of latest Context Graph file reads when debugging historical runs.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
+    readonly response_schema: z.ZodString;
+    readonly response_content_type: "text/plain";
+    readonly success_status: 200;
+}, {
+    readonly id: "getLatestContextGraph";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get latest Context Graph";
+    readonly description: "Return the latest successful Context Graph locator, GraphManifest, primary metrics, StageManifest summaries, entrypoints, and ready/not ready rollup for a Project.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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";
@@ -1155,14 +1623,14 @@ export declare const SERVICE_OPERATIONS: readonly [{
                 }>;
                 ok: z.ZodBoolean;
                 status: z.ZodOptional<z.ZodEnum<{
-                    failed: "failed";
                     ready: "ready";
+                    "not-ready": "not-ready";
+                    failed: "failed";
                     "not-configured": "not-configured";
                     "not-built": "not-built";
                     building: "building";
                     built: "built";
                     checking: "checking";
-                    "not-ready": "not-ready";
                     stale: "stale";
                 }>>;
                 summary: z.ZodString;
@@ -1202,81 +1670,1060 @@ export declare const SERVICE_OPERATIONS: readonly [{
                     benchmarks: "benchmarks";
                     "benchmarks-current": "benchmarks-current";
                 }>;
-                ok: z.ZodBoolean;
-                status: z.ZodOptional<z.ZodEnum<{
+                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>;
+    readonly success_status: 200;
+}, {
+    readonly id: "listContextGraphStages";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/stages";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "List Context Graph StageManifests";
+    readonly description: "Return StageManifest summaries for the latest Context Graph.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        stages: 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>>;
+        readiness: 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>>;
+        primary_metrics: 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>;
+    readonly success_status: 200;
+}, {
+    readonly id: "listContextGraphResources";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/resources";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "List Context Graph resources";
+    readonly description: "Return the ResourceRef index from the latest GraphManifest.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        resources: 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>>;
+        entrypoints: 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.ZodNullable<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>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "listContextGraphSessions";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/sessions";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "List Context Graph execution sessions";
+    readonly description: "Return replayable per-stage execution shell sessions for the latest Build run, including workspace, prompt, logs, validation attempts, and stage contract paths.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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";
-                    ready: "ready";
-                    "not-configured": "not-configured";
-                    "not-built": "not-built";
-                    building: "building";
-                    built: "built";
-                    checking: "checking";
-                    "not-ready": "not-ready";
-                    stale: "stale";
-                }>>;
+                    succeeded: "succeeded";
+                }>;
                 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>>>;
+            summary: z.ZodNullable<z.ZodString>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getContextGraphResource";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/resources/{resource_id}";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get Context Graph resource";
+    readonly description: "Return one ResourceRef from the latest GraphManifest for inspector drilldown.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        resource: 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>;
-        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>>;
-        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
+        stage: z.ZodNullable<z.ZodObject<{
+            stage_id: z.ZodString;
+            stage_label: z.ZodString;
             role: z.ZodEnum<{
-                runtime: "runtime";
-                output: "output";
                 source: "source";
-                evidence: "evidence";
-                benchmark: "benchmark";
+                summary: "summary";
+                other: "other";
+                knowledge: "knowledge";
+                entrypoint: "entrypoint";
+                diagnostic: "diagnostic";
             }>;
-            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;
+            manifest_path: z.ZodString;
             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>;
+            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";
                 }>>;
-                issue: z.ZodOptional<z.ZodString>;
+                detail: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        linked_resources: 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>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getContextGraphSession";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/sessions/{stage_run_id}";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get Context Graph execution session";
+    readonly description: "Return one replayable stage execution shell session for inspector drilldown.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
+    readonly response_schema: 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>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getProjectReadiness";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/readiness";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get Project readiness";
+    readonly description: "Read the ready/not ready verdict for the latest Context Graph against the Project intent.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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>;
     readonly success_status: 200;
 }, {
@@ -1359,6 +2806,7 @@ export declare const SERVICE_OPERATIONS: readonly [{
                 page_count: z.ZodOptional<z.ZodNumber>;
                 inspectable_units: z.ZodDefault<z.ZodArray<z.ZodObject<{
                     kind: z.ZodEnum<{
+                        file: "file";
                         page: "page";
                         slide: "slide";
                         sheet: "sheet";
@@ -1387,13 +2835,86 @@ export declare const SERVICE_OPERATIONS: readonly [{
         }, z.core.$strict>;
     }, z.core.$strict>;
     readonly success_status: 200;
+}, {
+    readonly id: "getContextGraphEntrypoint";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/entrypoint";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get Context Graph entrypoint";
+    readonly description: "Return the primary downstream entrypoint for the latest Context Graph. Agents should start from home.md.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-context-graph-handoff">;
+        version: z.ZodLiteral<1>;
+        entrypoint: 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>;
+        artifacts: 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: z.ZodOptional<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>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
 }, {
     readonly id: "readContextGraphFile";
     readonly method: "GET";
     readonly path: "/v1/projects/{project_id}/context-graph/file";
     readonly tags: ["Context Graphs"];
     readonly summary: "Read Context Graph file";
-    readonly description: "Read one file from the latest Context Graph by relative path. Start with artifacts/ task handoffs; use summaries/ for coverage proof and knowledge/ for drilldown.";
+    readonly description: "Read one file from the latest Context Graph by relative path. Start with home.md; use knowledge/ for task-specific notes and summaries/ for source-backed coverage.";
     readonly visibility: "app";
     readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
     readonly response_schema: z.ZodString;
@@ -1437,8 +2958,8 @@ export declare const SERVICE_OPERATIONS: readonly [{
     readonly method: "GET";
     readonly path: "/v1/projects/{project_id}/context-graph/evidence";
     readonly tags: ["Context Graphs"];
-    readonly summary: "Get Build evidence";
-    readonly description: "Read checks, Artifact diagnostics, and readiness evidence for the latest Context Graph.";
+    readonly summary: "Get graph diagnostics";
+    readonly description: "Read supplemental diagnostic rows for the latest Context Graph. GraphManifest primary metrics are the authoritative coverage summary.";
     readonly visibility: "app";
     readonly parameters: [ServiceOperationParameter];
     readonly response_schema: z.ZodObject<{
@@ -1485,6 +3006,6 @@ export declare const SERVICE_OPERATIONS: readonly [{
     readonly success_status: 200;
 }];
 export type ServiceOperationId = typeof SERVICE_OPERATIONS[number]["id"];
-export declare const APP_PROFILE_OPERATION_IDS: ("createProject" | "getProject" | "prepareBuildPlan" | "runBuild" | "getRunStatus" | "getRunArtifacts" | "readRunFile" | "getLatestContextGraph" | "listSourceFiles" | "getSourceManifest" | "readContextGraphFile" | "getContextGraphTraces" | "getBuildEvidence")[];
+export declare const APP_PROFILE_OPERATION_IDS: ("createProject" | "listProjects" | "getProject" | "prepareBuildPlan" | "runBuild" | "getRunStatus" | "getRunArtifacts" | "getRunEvents" | "readRunFile" | "getLatestContextGraph" | "listContextGraphStages" | "listContextGraphResources" | "listContextGraphSessions" | "getContextGraphResource" | "getContextGraphSession" | "getProjectReadiness" | "listSourceFiles" | "getSourceManifest" | "getContextGraphEntrypoint" | "readContextGraphFile" | "getContextGraphTraces" | "getBuildEvidence")[];
 export declare function serviceOperationById(id: string): ServiceOperation | undefined;
 export { EmptyObjectSchema };