@interf/compiler 0.33.0 → 0.50.0

package/dist/packages/runtime/schemas/context-graphs.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { ArtifactRefSchema, } from "../execution/lib/schema.js";
+import { BuildPlanIdSchema, BuildEvidenceResourceSchema, GraphManifestSchema, GraphManifestStageSummarySchema, GraphReadinessRollupSchema, MetricCountSchema, ProjectIntentSchema, ProjectIdSchema, ReadinessSchema, ResourceRefSchema, } from "../../contracts/lib/schema.js";
+import { ContextGraphArtifactHandoffSchema, ContextGraphPortableHandoffSchema, } from "../../contracts/lib/project-schema.js";
+import { StageExecutionSessionSchema, } from "../build/lib/schema.js";
+export const ContextGraphSemanticNodeKindSchema = z.enum([
+    "project",
+    "home",
+    "claim",
+    "entity",
+    "index",
+    "knowledge",
+    "summary",
+    "artifact",
+    "source",
+    "note",
+]);
+export const ContextGraphSemanticEdgeKindSchema = z.enum([
+    "links-to",
+    "source-ref",
+    "contains",
+    "handoff",
+]);
+export const ContextGraphSemanticNodeSchema = z.object({
+    id: z.string().min(1),
+    kind: ContextGraphSemanticNodeKindSchema,
+    label: z.string().min(1),
+    path: z.string().min(1).nullable().optional(),
+    summary: z.string().min(1).nullable().optional(),
+    source_refs: z.array(z.string().min(1)).default([]),
+    link_count: z.number().int().nonnegative().default(0),
+    backlink_count: z.number().int().nonnegative().default(0),
+}).strict();
+export const ContextGraphSemanticEdgeSchema = z.object({
+    id: z.string().min(1),
+    kind: ContextGraphSemanticEdgeKindSchema,
+    source: z.string().min(1),
+    target: z.string().min(1),
+    label: z.string().min(1),
+    detail: z.string().min(1),
+}).strict();
+export const ContextGraphSemanticGraphSchema = z.object({
+    kind: z.literal("interf-context-graph-semantic-graph"),
+    version: z.literal(1),
+    generated_at: z.string().min(1),
+    nodes: z.array(ContextGraphSemanticNodeSchema),
+    edges: z.array(ContextGraphSemanticEdgeSchema),
+    stats: z.object({
+        notes: z.number().int().nonnegative(),
+        links: z.number().int().nonnegative(),
+        source_refs: z.number().int().nonnegative(),
+        unresolved_links: z.number().int().nonnegative(),
+    }).strict(),
+}).strict();
+export const ContextGraphResourceSchema = z.object({
+    kind: z.literal("interf-context-graph"),
+    version: z.literal(1),
+    graph_id: z.string().min(1).optional(),
+    project_id: ProjectIdSchema.optional(),
+    intent: ProjectIntentSchema,
+    build_run_id: z.string().min(1).nullable().optional(),
+    source_manifest_id: z.string().min(1).nullable().optional(),
+    created_at: z.string().min(1).optional(),
+    is_latest: z.boolean().optional(),
+    project: ProjectIdSchema,
+    path: z.string().min(1),
+    exists: z.boolean(),
+    readiness: ReadinessSchema,
+    build_plan: BuildPlanIdSchema.nullable().optional(),
+    latest_build_run_id: z.string().min(1).nullable().optional(),
+    latest_benchmark_run_id: z.string().min(1).nullable().optional(),
+    // COMPAT — entrypoint_artifact / artifact_handoffs / artifacts / build_evidence /
+    // semantic_graph are pre-refactor handoff fields. Primary handlers populate
+    // entrypoints + resources + graph_manifest + primary_metrics + readiness_rollup
+    // instead. Removal trigger: once no live client reads these legacy fields,
+    // drop them from this schema and ContextGraphResource.
+    entrypoint_artifact: ContextGraphArtifactHandoffSchema.nullable().optional(),
+    artifact_handoffs: z.array(ContextGraphArtifactHandoffSchema).default([]),
+    portable_handoff: ContextGraphPortableHandoffSchema.nullable().optional(),
+    artifacts: z.array(ArtifactRefSchema).default([]),
+    build_evidence: BuildEvidenceResourceSchema.optional(),
+    semantic_graph: ContextGraphSemanticGraphSchema.optional(),
+    graph_manifest: GraphManifestSchema.nullable().optional(),
+    primary_metrics: z.array(MetricCountSchema).default([]),
+    stage_summaries: z.array(GraphManifestStageSummarySchema).default([]),
+    entrypoints: z.array(ResourceRefSchema).default([]),
+    resources: z.array(ResourceRefSchema).default([]),
+    readiness_rollup: GraphReadinessRollupSchema.nullable().optional(),
+    stage_sessions: z.array(StageExecutionSessionSchema).default([]),
+}).strict();
+export const ContextGraphListResponseSchema = z.object({
+    graphs: z.array(ContextGraphResourceSchema),
+}).strict();
+/**
+ * `GET /v1/projects/<id>/context-graph/sessions` — the replayable per-stage
+ * execution shell sessions for the latest Build run. One shape, reused by the
+ * service operation registry, the CLI `graphs sessions` reader, and MCP.
+ */
+export const ContextGraphSessionsResponseSchema = z.object({
+    sessions: z.array(StageExecutionSessionSchema),
+}).strict();
+/**
+ * `GET /v1/projects/<id>/context-graph/sessions/<stage-run-id>` — one preserved
+ * execution shell session. Same single-session shape across service, CLI, MCP.
+ */
+export const ContextGraphSessionResponseSchema = z.object({
+    session: StageExecutionSessionSchema,
+}).strict();
+export { BuildEvidenceResourceSchema };
+export { StageExecutionSessionSchema };

package/dist/packages/runtime/schemas/files.d.ts

@@ -1,5 +1,4 @@
 import { z } from "zod";
-import { BuildEvidenceResourceSchema, type BuildEvidenceResource } from "../../contracts/lib/schema.js";
 /**
  * Discriminated locator for an artifact returned by the API. Aliases the
  * canonical `LocatorSchema` from contracts so all three kinds —
@@ -14,356 +13,20 @@ export declare const ArtifactLocatorSchema: z.ZodObject<{
     }>;
     value: z.ZodString;
 }, z.core.$strict>;
-export declare const ContextGraphResourceSchema: 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;
-        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";
-        }>;
-        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<{
-                failed: "failed";
-                ready: "ready";
-                "not-configured": "not-configured";
-                "not-built": "not-built";
-                building: "building";
-                built: "built";
-                checking: "checking";
-                "not-ready": "not-ready";
-                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<{
-                failed: "failed";
-                ready: "ready";
-                "not-configured": "not-configured";
-                "not-built": "not-built";
-                building: "building";
-                built: "built";
-                checking: "checking";
-                "not-ready": "not-ready";
-                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>>;
-    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>>;
-}, z.core.$strict>;
-export declare const ContextGraphListResponseSchema: z.ZodObject<{
-    graphs: z.ZodArray<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;
-            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";
-            }>;
-            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<{
-                    failed: "failed";
-                    ready: "ready";
-                    "not-configured": "not-configured";
-                    "not-built": "not-built";
-                    building: "building";
-                    built: "built";
-                    checking: "checking";
-                    "not-ready": "not-ready";
-                    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<{
-                    failed: "failed";
-                    ready: "ready";
-                    "not-configured": "not-configured";
-                    "not-built": "not-built";
-                    building: "building";
-                    built: "built";
-                    checking: "checking";
-                    "not-ready": "not-ready";
-                    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>>;
-        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>>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
 export declare const ReadinessResourceSchema: z.ZodObject<{
     kind: z.ZodLiteral<"interf-readiness-state">;
     version: z.ZodLiteral<1>;
     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;
@@ -383,14 +46,14 @@ export declare const ReadinessResourceSchema: z.ZodObject<{
         }>;
         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;
@@ -432,14 +95,14 @@ export declare const ReadinessResourceSchema: z.ZodObject<{
         }>;
         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;
@@ -529,6 +192,7 @@ export declare const SourceManifestResourceSchema: z.ZodObject<{
             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";
@@ -557,10 +221,6 @@ export declare const SourceManifestResourceSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type ArtifactLocator = z.infer<typeof ArtifactLocatorSchema>;
-export type ContextGraphResource = z.infer<typeof ContextGraphResourceSchema>;
-export type ContextGraphListResponse = z.infer<typeof ContextGraphListResponseSchema>;
-export { BuildEvidenceResourceSchema };
-export type { BuildEvidenceResource };
 export type ReadinessResource = z.infer<typeof ReadinessResourceSchema>;
 export type SourceFileResource = z.infer<typeof SourceFileResourceSchema>;
 export type SourceFileListResponse = z.infer<typeof SourceFileListResponseSchema>;

package/dist/packages/runtime/schemas/files.js

@@ -1,6 +1,5 @@
 import { z } from "zod";
-import { ArtifactRefSchema, } from "../execution/lib/schema.js";
-import { LocatorSchema, ProjectIdSchema, ReadinessSchema, BuildPlanIdSchema, SourceManifestSchema, SourceManifestFileKindSchema, BuildEvidenceResourceSchema, } from "../../contracts/lib/schema.js";
+import { LocatorSchema, ProjectIdSchema, ReadinessSchema, SourceManifestSchema, SourceManifestFileKindSchema, } from "../../contracts/lib/schema.js";
 /**
  * Discriminated locator for an artifact returned by the API. Aliases the
  * canonical `LocatorSchema` from contracts so all three kinds —
@@ -8,27 +7,6 @@ import { LocatorSchema, ProjectIdSchema, ReadinessSchema, BuildPlanIdSchema, Sou
  * resource-access pattern.
  */
 export const ArtifactLocatorSchema = LocatorSchema;
-export const ContextGraphResourceSchema = z.object({
-    kind: z.literal("interf-context-graph").optional(),
-    version: z.literal(1).optional(),
-    graph_id: z.string().min(1).optional(),
-    project_id: ProjectIdSchema.optional(),
-    build_run_id: z.string().min(1).nullable().optional(),
-    created_at: z.string().min(1).optional(),
-    is_latest: z.boolean().optional(),
-    project: ProjectIdSchema,
-    path: z.string().min(1),
-    exists: z.boolean(),
-    readiness: ReadinessSchema,
-    build_plan: BuildPlanIdSchema.nullable().optional(),
-    latest_build_run_id: z.string().min(1).nullable().optional(),
-    latest_benchmark_run_id: z.string().min(1).nullable().optional(),
-    artifacts: z.array(ArtifactRefSchema).default([]),
-    build_evidence: BuildEvidenceResourceSchema.optional(),
-}).strict();
-export const ContextGraphListResponseSchema = z.object({
-    graphs: z.array(ContextGraphResourceSchema),
-}).strict();
 export const ReadinessResourceSchema = ReadinessSchema;
 export const SourceFileResourceSchema = z.object({
     project: ProjectIdSchema,
@@ -48,4 +26,3 @@ export const SourceFileListResponseSchema = z.object({
 export const SourceManifestResourceSchema = z.object({
     source_manifest: SourceManifestSchema,
 }).strict();
-export { BuildEvidenceResourceSchema };

package/dist/packages/runtime/schemas/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./context-graphs.js";
 export * from "./files.js";
 export * from "./instance.js";
 export * from "./projects.js";

package/dist/packages/runtime/schemas/index.js

@@ -2,6 +2,7 @@
 // no schemas are defined here. Prefer importing directly from a
 // resource module (e.g. `./projects.js`) when a single file
 // needs only a few shapes.
+export * from "./context-graphs.js";
 export * from "./files.js";
 export * from "./instance.js";
 export * from "./projects.js";

package/dist/packages/runtime/schemas/jobs.js

@@ -3,6 +3,10 @@ import { ArtifactRefSchema, } from "../execution/lib/schema.js";
 import { ProjectIdSchema, BuildPlanIdSchema, RuntimeExecutorInfoSchema, } from "../../contracts/lib/schema.js";
 import { BenchmarkRunSchema, } from "../verify/lib/schema.js";
 const JsonObjectSchema = z.record(z.string(), z.unknown());
+// Graph-less `LocalJobRun` kinds. Intentionally omits `judge`: the judge/verify
+// path is not a LocalJobRun — it writes a `verdict.json` and a preserved
+// `test-judge` shell (see verify-execution.ts), driven by the verify path rather
+// than a job_type. Do not add `judge` here.
 export const LocalJobTypeSchema = z.enum([
     "benchmark-question-draft",
     "build-plan-draft",