@interf/compiler 0.33.0 → 0.50.0

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

@@ -1,24 +1,20 @@
 import { z } from "zod";
-/**
- * Source binding shape on the API. The only Source kind Interf accepts is
- * `local-folder`. Remote storage kinds will be re-introduced when a real
- * variant ships; see `internal/iterations/0.23-service-variant-parking-lot.md`.
- */
-export declare const SourceBindingSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"local-folder">;
-    locator: z.ZodString;
-}, z.core.$strict>;
+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.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>;
 /** 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<{
@@ -29,11 +25,15 @@ export declare const ProjectWireShapeSchema: 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";
@@ -48,6 +48,7 @@ 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>;
@@ -60,23 +61,29 @@ export declare const ProjectResourceSchema: z.ZodObject<{
     id: 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>;
+    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>;
@@ -88,14 +95,14 @@ export declare const ProjectResourceSchema: z.ZodObject<{
         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;
@@ -115,14 +122,14 @@ export declare const ProjectResourceSchema: 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;
@@ -164,14 +171,14 @@ export declare const ProjectResourceSchema: 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;
@@ -189,9 +196,9 @@ export declare const ProjectResourceSchema: z.ZodObject<{
     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>>;
@@ -208,6 +215,9 @@ export declare const ProjectResourceSchema: z.ZodObject<{
                 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";
@@ -257,6 +267,12 @@ export declare const ResetRequestSchema: z.ZodObject<{
         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>;
@@ -275,6 +291,10 @@ export declare const BenchmarkQuestionDraftCreateRequestSchema: z.ZodObject<{
     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>;
@@ -299,17 +319,23 @@ export declare const BenchmarkQuestionDraftResultSchema: 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.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";
@@ -321,7 +347,6 @@ export declare const ProjectListResponseSchema: z.ZodObject<{
         context_graph_path: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
-export type SourceBinding = z.infer<typeof SourceBindingSchema>;
 export type ProjectCreateRequest = z.infer<typeof ProjectCreateRequestSchema>;
 export type ProjectUpdateRequest = z.infer<typeof ProjectUpdateRequestSchema>;
 export type ProjectDeleteResponse = z.infer<typeof ProjectDeleteResponseSchema>;
@@ -332,8 +357,10 @@ 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

@@ -1,20 +1,13 @@
 import { z } from "zod";
 import { ProjectConfigSchema, BenchmarkCheckSchema, } from "../../projects/lib/schema.js";
-import { ArtifactStatusSchema, ProjectIdSchema, ReadinessSchema, BuildPlanIdSchema, } from "../../contracts/lib/schema.js";
+import { ArtifactStatusSchema, ProjectIdSchema, ProjectIntentSchema, ReadinessSchema, BuildPlanIdSchema, SourceBindingSchema, } from "../../contracts/lib/schema.js";
 import { ArtifactLocatorSchema } from "./files.js";
-/**
- * Source binding shape on the API. The only Source kind Interf accepts is
- * `local-folder`. Remote storage kinds will be re-introduced when a real
- * variant ships; see `internal/iterations/0.23-service-variant-parking-lot.md`.
- */
-export const SourceBindingSchema = z.object({
-    kind: z.literal("local-folder"),
-    locator: z.string().min(1),
-}).strict();
+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.
@@ -23,6 +16,7 @@ export const ProjectCreateRequestSchema = z.object({
 }).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({
@@ -34,8 +28,14 @@ export const ProjectWireShapeSchema = z.object({
     /** 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). */
@@ -45,6 +45,7 @@ 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(),
@@ -57,9 +58,16 @@ 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(),
@@ -105,6 +113,12 @@ 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),
@@ -121,6 +135,9 @@ export const BenchmarkQuestionDraftCreateRequestSchema = z.object({
     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();
@@ -130,6 +147,13 @@ export const BenchmarkQuestionDraftResultSchema = 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),