@interf/compiler 0.33.0 → 0.50.0

package/dist/packages/contracts/lib/project-schema.d.ts

@@ -80,15 +80,216 @@ export declare const ContextGraphLocatorSchema: z.ZodObject<{
     value: z.ZodString;
 }, z.core.$strict>;
 export type ContextGraphLocator = z.infer<typeof ContextGraphLocatorSchema>;
+export declare const ContextGraphArtifactHandoffSchema: 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>;
+export type ContextGraphArtifactHandoff = z.infer<typeof ContextGraphArtifactHandoffSchema>;
+export declare const ContextGraphPortableHandoffSchema: 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>;
+export type ContextGraphPortableHandoff = z.infer<typeof ContextGraphPortableHandoffSchema>;
+export declare const ContextGraphHandoffSchema: 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>;
+export type ContextGraphHandoff = z.infer<typeof ContextGraphHandoffSchema>;
 export declare const ContextGraphSchema: z.ZodObject<{
     kind: z.ZodLiteral<"interf-context-graph">;
     version: z.ZodLiteral<1>;
     graph_id: z.ZodString;
     project_id: z.ZodString;
+    intent: z.ZodOptional<z.ZodString>;
     build_run_id: z.ZodString;
     source_state_id: z.ZodString;
+    source_manifest_id: z.ZodOptional<z.ZodString>;
     created_at: z.ZodString;
     ready: z.ZodBoolean;
+    readiness: z.ZodOptional<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>>;
     locator: z.ZodObject<{
         kind: z.ZodEnum<{
             "local-path": "local-path";
@@ -97,12 +298,71 @@ export declare const ContextGraphSchema: z.ZodObject<{
         }>;
         value: z.ZodString;
     }, z.core.$strict>;
+    entrypoint_artifact: z.ZodOptional<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.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<{
         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>>;
@@ -119,6 +379,9 @@ export declare const ContextGraphSchema: 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";

package/dist/packages/contracts/lib/project-schema.js

@@ -1,23 +1,23 @@
 import { z } from "zod";
-import { ArtifactStatusSchema, InterfIdPattern, isInterfRelativePath, } from "./schema.js";
+import { ArtifactIdSchema, ArtifactStatusSchema, InterfIdPattern, LocatorSchema, ProjectIdPattern, ProjectIdSchema, ProjectIntentSchema, ReadinessSchema, isInterfRelativePath, } from "./schema.js";
 // ───────────────────────────────────────────────────────────────────────────
 // Project — the durable Source binding and selected Build Plan container.
 //
-// A Project binds a Source (folder), execution agents, Project activity,
-// and one selected Build Plan. The Build Plan owns intent, requested
-// Artifacts, checks, Build instructions, and optional source context.
+// A Project binds a Source (folder), Project intent, execution agents, Project
+// activity, and one selected Build Plan. The Build Plan is the recipe for
+// preparing a Context Graph for that Project intent.
 // Each Build produces one Context Graph.
 //
 // Project identity = `path + machine_id` (same folder on different machines
 // is a different Project). The `id` here is the user-facing handle, derived
 // from the source folder basename + locator hash at create time.
 // ───────────────────────────────────────────────────────────────────────────
-export const ProjectNamePattern = /^[a-z0-9][a-z0-9-]*$/;
-const RESERVED_PROJECT_NAMES = new Set(["tests", "build-plans"]);
-export const ProjectNameSchema = z
-    .string()
-    .regex(ProjectNamePattern, "Project names must use lowercase letters, numbers, and dashes only.")
-    .refine((value) => !RESERVED_PROJECT_NAMES.has(value), "Project name is reserved.");
+// A Project's user-facing handle and its internal id share one identity rule:
+// same regex, same reserved set, same messages. Both names alias the single
+// source in `schema.ts` (`ProjectIdPattern` / `ProjectIdSchema`) so the rule is
+// defined once. The aliases preserve the `projectSchema.*` namespace surface.
+export const ProjectNamePattern = ProjectIdPattern;
+export const ProjectNameSchema = ProjectIdSchema;
 /**
  * Drift verdict for a Project's source binding.
  *
@@ -89,20 +89,45 @@ export const TracesSchema = z.object({
 // The Context Graph wraps the per-build output and surfaces artifacts
 // + traces as first-class fields.
 // ───────────────────────────────────────────────────────────────────────────
-export const ContextGraphLocatorSchema = z.object({
-    kind: z.enum(["local-path", "remote-url", "api-served"]),
-    value: z.string().min(1),
+export const ContextGraphLocatorSchema = LocatorSchema;
+export const ContextGraphArtifactHandoffSchema = z.object({
+    artifact_id: ArtifactIdSchema.optional(),
+    label: z.string().min(1),
+    locator: LocatorSchema,
+    path: z.string().min(1).refine(isInterfRelativePath, {
+        message: "Context Graph handoff paths must stay inside the Context Graph root.",
+    }).optional(),
+    artifact_kind: z.enum(["file", "directory"]).optional(),
+    role: z.enum(["entrypoint", "artifact", "guidance", "source-index"]).default("artifact"),
+    summary: z.string().min(1).optional(),
+}).strict();
+export const ContextGraphPortableHandoffSchema = z.object({
+    locator: LocatorSchema,
+    instructions: z.string().min(1).optional(),
+}).strict();
+export const ContextGraphHandoffSchema = z.object({
+    kind: z.literal("interf-context-graph-handoff"),
+    version: z.literal(1),
+    entrypoint: ContextGraphArtifactHandoffSchema,
+    artifacts: z.array(ContextGraphArtifactHandoffSchema).default([]),
+    portable: ContextGraphPortableHandoffSchema.optional(),
 }).strict();
 export const ContextGraphSchema = z.object({
     kind: z.literal("interf-context-graph"),
     version: z.literal(1),
     graph_id: z.string().min(1),
     project_id: z.string().min(1),
+    intent: ProjectIntentSchema.optional(),
     build_run_id: z.string().min(1),
     source_state_id: z.string().min(1),
+    source_manifest_id: z.string().min(1).optional(),
     created_at: z.string().min(1),
     ready: z.boolean(),
+    readiness: ReadinessSchema.optional(),
     locator: ContextGraphLocatorSchema,
+    entrypoint_artifact: ContextGraphArtifactHandoffSchema.optional(),
+    artifact_handoffs: z.array(ContextGraphArtifactHandoffSchema).default([]),
+    portable_handoff: ContextGraphPortableHandoffSchema.optional(),
     artifacts: z.array(ArtifactStatusSchema).default([]),
     traces: TracesSchema,
 }).strict();