@interf/compiler 0.22.2 → 0.50.0

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

@@ -0,0 +1,366 @@
+import { z } from "zod";
+export { SourceBindingSchema, type SourceBinding } from "../../contracts/lib/schema.js";
+/** Body of `POST /v1/projects` — the project create request. */
+export declare const ProjectCreateRequestSchema: z.ZodObject<{
+    id: 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.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/** Body of `PATCH /v1/projects/<id>` — update mutable project fields. */
+export declare const ProjectUpdateRequestSchema: z.ZodObject<{
+    intent: z.ZodOptional<z.ZodString>;
+    build_plan_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const ProjectDeleteResponseSchema: z.ZodObject<{
+    deleted: z.ZodBoolean;
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const ProjectWireShapeSchema: 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>;
+export declare const ContextGraphMappingSchema: z.ZodObject<{
+    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>;
+export declare const ProjectRunLinkageSchema: z.ZodObject<{
+    latest_build_run_id: z.ZodNullable<z.ZodString>;
+    latest_benchmark_run_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const ProjectResourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "local-folder": "local-folder";
+        }>;
+        locator: z.ZodString;
+    }, z.core.$strict>;
+    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<{
+        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";
+        }>;
+        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>;
+    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>;
+export declare const ProjectSetupResultSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-project-setup-result">;
+    version: z.ZodLiteral<1>;
+    operation: z.ZodEnum<{
+        create: "create";
+        "select-build-plan": "select-build-plan";
+    }>;
+    project: z.ZodString;
+    build_plan: z.ZodNullable<z.ZodString>;
+    source_folder_path: z.ZodString;
+    config_path: z.ZodString;
+    context_graph_path: z.ZodString;
+    changed: z.ZodBoolean;
+    message: z.ZodString;
+    submitted_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    submitted_run_type: z.ZodOptional<z.ZodNullable<z.ZodLiteral<"build-run">>>;
+}, z.core.$strict>;
+export declare const ProjectChangeResultSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-project-change-result">;
+    version: z.ZodLiteral<1>;
+    operation: z.ZodLiteral<"remove">;
+    project: z.ZodString;
+    config_path: z.ZodString;
+    context_graph_path: z.ZodString;
+    context_graph_retained: z.ZodBoolean;
+    changed: z.ZodBoolean;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const ResetRequestSchema: z.ZodObject<{
+    project: z.ZodString;
+    scope: z.ZodEnum<{
+        build: "build";
+        all: "all";
+    }>;
+}, z.core.$strict>;
+export declare const ProjectResetRequestSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodEnum<{
+        build: "build";
+        all: "all";
+    }>>;
+}, z.core.$strict>;
+export declare const ResetResultSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-reset-result">;
+    version: z.ZodLiteral<1>;
+    project: z.ZodString;
+    scope: z.ZodEnum<{
+        build: "build";
+        all: "all";
+    }>;
+    context_graph_path: z.ZodString;
+    changed: z.ZodBoolean;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const BenchmarkQuestionDraftCreateRequestSchema: z.ZodObject<{
+    project: z.ZodString;
+    source_folder_path: z.ZodOptional<z.ZodString>;
+    intent: z.ZodOptional<z.ZodString>;
+    target_count: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const ProjectBenchmarkQuestionDraftCreateRequestSchema: z.ZodObject<{
+    intent: z.ZodOptional<z.ZodString>;
+    target_count: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const BenchmarkQuestionDraftRuntimeRequestSchema: z.ZodObject<{
+    project: z.ZodString;
+    intent: z.ZodOptional<z.ZodString>;
+    target_count: z.ZodDefault<z.ZodNumber>;
+    source_folder_path: z.ZodString;
+}, z.core.$strict>;
+export declare const BenchmarkQuestionDraftResultSchema: z.ZodObject<{
+    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        question: z.ZodString;
+        answer: z.ZodOptional<z.ZodString>;
+        expect: z.ZodOptional<z.ZodObject<{
+            must_include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            must_include_one_of: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
+            must_not_include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            min_words: z.ZodOptional<z.ZodNumber>;
+            max_words: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        strictness: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    spec_paths: z.ZodOptional<z.ZodObject<{
+        source_files: z.ZodOptional<z.ZodString>;
+        context_graph: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    shell_path: z.ZodOptional<z.ZodString>;
+    reasoning_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const ProjectListResponseSchema: 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>;
+export type ProjectCreateRequest = z.infer<typeof ProjectCreateRequestSchema>;
+export type ProjectUpdateRequest = z.infer<typeof ProjectUpdateRequestSchema>;
+export type ProjectDeleteResponse = z.infer<typeof ProjectDeleteResponseSchema>;
+export type ProjectWireShape = z.infer<typeof ProjectWireShapeSchema>;
+export type ContextGraphMapping = z.infer<typeof ContextGraphMappingSchema>;
+export type ProjectRunLinkage = z.infer<typeof ProjectRunLinkageSchema>;
+export type ProjectResource = z.infer<typeof ProjectResourceSchema>;
+export type ProjectSetupResult = z.infer<typeof ProjectSetupResultSchema>;
+export type ProjectChangeResult = z.infer<typeof ProjectChangeResultSchema>;
+export type ResetRequest = z.infer<typeof ResetRequestSchema>;
+export type ProjectResetRequest = z.infer<typeof ProjectResetRequestSchema>;
+export type ResetResult = z.infer<typeof ResetResultSchema>;
+export type BenchmarkQuestionDraftCreateRequest = z.infer<typeof BenchmarkQuestionDraftCreateRequestSchema>;
+export type ProjectBenchmarkQuestionDraftCreateRequest = z.infer<typeof ProjectBenchmarkQuestionDraftCreateRequestSchema>;
+export type BenchmarkQuestionDraftRuntimeRequest = z.infer<typeof BenchmarkQuestionDraftRuntimeRequestSchema>;
+export type BenchmarkQuestionDraftResult = z.infer<typeof BenchmarkQuestionDraftResultSchema>;
+export type ProjectListResponse = z.infer<typeof ProjectListResponseSchema>;

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

@@ -0,0 +1,160 @@
+import { z } from "zod";
+import { ProjectConfigSchema, BenchmarkCheckSchema, } from "../../projects/lib/schema.js";
+import { ArtifactStatusSchema, ProjectIdSchema, ProjectIntentSchema, ReadinessSchema, BuildPlanIdSchema, SourceBindingSchema, } from "../../contracts/lib/schema.js";
+import { ArtifactLocatorSchema } from "./files.js";
+export { SourceBindingSchema } from "../../contracts/lib/schema.js";
+/** Body of `POST /v1/projects` — the project create request. */
+export const ProjectCreateRequestSchema = z.object({
+    id: ProjectIdSchema,
+    source: SourceBindingSchema,
+    intent: ProjectIntentSchema,
+    /**
+     * Selected Build Plan id. Optional because a Project can be created
+     * before a Build Plan is selected or drafted.
+     */
+    build_plan_id: BuildPlanIdSchema.nullable().optional(),
+}).strict();
+/** Body of `PATCH /v1/projects/<id>` — update mutable project fields. */
+export const ProjectUpdateRequestSchema = z.object({
+    intent: ProjectIntentSchema.optional(),
+    build_plan_id: BuildPlanIdSchema.nullable().optional(),
+}).strict();
+export const ProjectDeleteResponseSchema = z.object({
+    deleted: z.boolean(),
+    id: ProjectIdSchema,
+}).strict();
+export const ProjectWireShapeSchema = z.object({
+    id: ProjectIdSchema,
+    /** Stable alias for `id` — agents and clients should prefer `project_id`. */
+    project_id: ProjectIdSchema.optional(),
+    source: SourceBindingSchema,
+    intent: ProjectIntentSchema,
+    build_plan_id: BuildPlanIdSchema.nullable(),
+    config_path: z.string().min(1),
+    /**
+     * Last-modified time of the Project's `interf.json` (ISO 8601). Recency
+     * signal the Projects list sorts newest-first by. Null when unreadable.
+     */
+    updated_at: z.string().min(1).nullable().optional(),
+    /** Locator pointing at the Context Graph for this Project. */
+    context_graph: ArtifactLocatorSchema,
+    /** Filesystem path inside the Context Graph locator (convenience for local clients). */
+    context_graph_path: z.string().min(1).optional(),
+}).strict();
+export const ContextGraphMappingSchema = z.object({
+    project: ProjectIdSchema,
+    path: z.string().min(1).nullable(),
+    exists: z.boolean(),
+    intent: ProjectIntentSchema,
+    build_plan_id: BuildPlanIdSchema.nullable(),
+    latest_build_run_id: z.string().min(1).nullable(),
+    latest_benchmark_run_id: z.string().min(1).nullable(),
+}).strict();
+export const ProjectRunLinkageSchema = z.object({
+    latest_build_run_id: z.string().min(1).nullable(),
+    latest_benchmark_run_id: z.string().min(1).nullable(),
+}).strict();
+export const ProjectResourceSchema = z.object({
+    id: ProjectIdSchema,
+    name: ProjectIdSchema,
+    source: SourceBindingSchema,
+    intent: ProjectIntentSchema,
+    config: ProjectConfigSchema,
+    config_path: z.string().min(1),
+    source_path: z.string().min(1),
+    /**
+     * Last-modified time of the Project's config file (`interf.json`), ISO 8601.
+     * Migration-free recency signal: clients sort the Projects list newest-first
+     * by this. Null when the config file mtime can't be read.
+     */
+    updated_at: z.string().min(1).nullable().optional(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
+    context_graph: ContextGraphMappingSchema,
+    context_graph_path: z.string().min(1).nullable(),
+    readiness: ReadinessSchema,
+    runs: ProjectRunLinkageSchema,
+    latest_build_run_id: z.string().min(1).nullable().optional(),
+    latest_benchmark_run_id: z.string().min(1).nullable().optional(),
+    // Per-Artifact status from the latest Build run, mirrored
+    // here so the UI/CLI can render artifact rows without a separate
+    // GET /v1/projects/<id>/runs fetch. Empty when no Build run has
+    // produced artifacts yet.
+    artifacts: z.array(ArtifactStatusSchema).default([]),
+}).strict();
+// ───────────────────────────────────────────────────────────────────────────
+// Project actions: setup, change, reset, benchmark-question draft
+// ───────────────────────────────────────────────────────────────────────────
+export const ProjectSetupResultSchema = z.object({
+    kind: z.literal("interf-project-setup-result"),
+    version: z.literal(1),
+    operation: z.enum(["create", "select-build-plan"]),
+    project: ProjectIdSchema,
+    build_plan: BuildPlanIdSchema.nullable(),
+    source_folder_path: z.string().min(1),
+    config_path: z.string().min(1),
+    context_graph_path: z.string().min(1),
+    changed: z.boolean(),
+    message: z.string().min(1),
+    submitted_run_id: z.string().min(1).nullable().optional(),
+    submitted_run_type: z.literal("build-run").nullable().optional(),
+}).strict();
+export const ProjectChangeResultSchema = z.object({
+    kind: z.literal("interf-project-change-result"),
+    version: z.literal(1),
+    operation: z.literal("remove"),
+    project: ProjectIdSchema,
+    config_path: z.string().min(1),
+    context_graph_path: z.string().min(1),
+    context_graph_retained: z.boolean(),
+    changed: z.boolean(),
+    message: z.string().min(1),
+}).strict();
+export const ResetRequestSchema = z.object({
+    project: ProjectIdSchema,
+    scope: z.enum(["build", "all"]),
+}).strict();
+export const ProjectResetRequestSchema = ResetRequestSchema
+    .omit({ project: true })
+    .extend({
+    scope: ResetRequestSchema.shape.scope.default("build"),
+})
+    .strict();
+export const ResetResultSchema = z.object({
+    kind: z.literal("interf-reset-result"),
+    version: z.literal(1),
+    project: ProjectIdSchema,
+    scope: z.enum(["build", "all"]),
+    context_graph_path: z.string().min(1),
+    changed: z.boolean(),
+    message: z.string().min(1),
+}).strict();
+export const BenchmarkQuestionDraftCreateRequestSchema = z.object({
+    project: ProjectIdSchema,
+    /** Runtime-only Source locator. Project-scoped routes fill this from the saved Project binding. */
+    source_folder_path: z.string().min(1).optional(),
+    intent: z.string().min(1).optional(),
+    target_count: z.number().int().min(1).max(8).default(4),
+}).strict();
+export const ProjectBenchmarkQuestionDraftCreateRequestSchema = BenchmarkQuestionDraftCreateRequestSchema
+    .omit({ project: true, source_folder_path: true })
+    .strict();
+export const BenchmarkQuestionDraftRuntimeRequestSchema = BenchmarkQuestionDraftCreateRequestSchema.extend({
+    source_folder_path: z.string().min(1),
+}).strict();
+export const BenchmarkQuestionDraftResultSchema = z.object({
+    checks: z.array(BenchmarkCheckSchema).default([]),
+    spec_paths: z.object({
+        source_files: z.string().min(1).optional(),
+        context_graph: z.string().min(1).optional(),
+    }).strict().optional(),
+    // Preserved, inspectable drafting shell: the absolute path to the frozen shell
+    // and to its agent-reasoning transcript. Present when the draft ran with
+    // durable Project job storage (the launched path). They index the rich
+    // artifact from the LocalJobRun record, the graph-less analogue of a stage
+    // session's shell_path + reasoning_path.
+    shell_path: z.string().min(1).optional(),
+    reasoning_path: z.string().min(1).optional(),
+}).strict();
+export const ProjectListResponseSchema = z.object({
+    projects: z.array(ProjectWireShapeSchema),
+}).strict();