@interf/compiler 0.22.0 → 0.33.0

package/dist/cli/index.js

@@ -2,17 +2,20 @@ import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { agentsCommand } from "./commands/agents.js";
 import { buildCommand } from "./commands/build.js";
-import { testCommand } from "./commands/test.js";
+import { benchmarkCommand } from "./commands/benchmark.js";
 import { doctorCommand } from "./commands/doctor.js";
 import { buildPlanCommand } from "./commands/build-plan.js";
 import { mcpCommand } from "./commands/mcp.js";
 import { runsCommand } from "./commands/runs.js";
+import { graphsCommand } from "./commands/graphs.js";
+import { tracesCommand } from "./commands/traces.js";
 import { statusCommand } from "./commands/status.js";
 import { resetCommand } from "./commands/reset.js";
-import { webCommand } from "./commands/web.js";
-import { prepCommand } from "./commands/prep.js";
+import { runtimeCommand } from "./commands/runtime.js";
+import { projectCommand } from "./commands/project.js";
 import { loginCommand } from "./commands/login.js";
 import { logoutCommand } from "./commands/logout.js";
+import { authCommand } from "./commands/auth.js";
 import { wizardCommand, initCommand } from "./commands/wizard.js";
 export function buildCli(argv = hideBin(process.argv)) {
     return yargs(argv)
@@ -20,18 +23,21 @@ export function buildCli(argv = hideBin(process.argv)) {
         .command(wizardCommand)
         .command(initCommand)
         .command(buildCommand)
-        .command(testCommand)
+        .command(benchmarkCommand)
         .command(agentsCommand)
         .command(doctorCommand)
         .command(buildPlanCommand)
         .command(mcpCommand)
         .command(runsCommand)
+        .command(graphsCommand)
+        .command(tracesCommand)
         .command(statusCommand)
-        .command(webCommand)
+        .command(runtimeCommand)
         .command(resetCommand)
-        .command(prepCommand)
+        .command(projectCommand)
         .command(loginCommand)
         .command(logoutCommand)
+        .command(authCommand)
         .strict()
         .help()
         .version();
@@ -39,4 +45,4 @@ export function buildCli(argv = hideBin(process.argv)) {
 export function runCli(argv = hideBin(process.argv)) {
     return buildCli(argv).parse();
 }
-export { initCommand, buildCommand, testCommand, agentsCommand, doctorCommand, buildPlanCommand, mcpCommand, runsCommand, statusCommand, resetCommand, webCommand, prepCommand, loginCommand, logoutCommand, wizardCommand, };
+export { initCommand, buildCommand, benchmarkCommand, agentsCommand, doctorCommand, buildPlanCommand, mcpCommand, runsCommand, graphsCommand, tracesCommand, statusCommand, resetCommand, runtimeCommand, projectCommand, loginCommand, logoutCommand, authCommand, wizardCommand, };

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * as contracts from "./packages/contracts/index.js";
-export * as execution from "./packages/engine/execution/index.js";
-export * as localService from "./packages/engine/index.js";
+export * as execution from "./packages/runtime/execution/index.js";
+export * as localService from "./packages/runtime/index.js";

package/dist/index.js

@@ -1,3 +1,3 @@
 export * as contracts from "./packages/contracts/index.js";
-export * as execution from "./packages/engine/execution/index.js";
-export * as localService from "./packages/engine/index.js";
+export * as execution from "./packages/runtime/execution/index.js";
+export * as localService from "./packages/runtime/index.js";

package/dist/packages/build-plans/authoring/brief.d.ts

@@ -0,0 +1,517 @@
+import { z } from "zod";
+export declare const RequestedArtifactCheckSchema: z.ZodObject<{
+    label: z.ZodString;
+}, z.core.$strict>;
+export declare const RequestedArtifactOutputSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    shape: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        artifact_kind: z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>;
+    }, z.core.$strict>>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        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";
+            wikilinks_valid: "wikilinks_valid";
+            must_not_contain: "must_not_contain";
+            must_contain: "must_contain";
+            qa_match: "qa_match";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    stage_hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const RequestedArtifactSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    purpose: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        label: z.ZodString;
+    }, z.core.$strict>]>>>;
+    output: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        shape: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            artifact_kind: z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>;
+        }, z.core.$strict>>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            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";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        stage_hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export declare const SourceContextItemSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodString>;
+    page_count: z.ZodOptional<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const SourceContextSchema: z.ZodObject<{
+    summary: z.ZodOptional<z.ZodString>;
+    items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+        page_count: z.ZodOptional<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const BuildPlanContextCheckDraftSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodString>;
+    evidence_expectation: z.ZodOptional<z.ZodString>;
+    backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const BuildPlanAuthoringArtifactRequirementSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    shape: z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        artifact_kind: z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>;
+    }, z.core.$strict>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        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";
+            wikilinks_valid: "wikilinks_valid";
+            must_not_contain: "must_not_contain";
+            must_contain: "must_contain";
+            qa_match: "qa_match";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    stage_hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const BuildPlanAuthoringBriefInputSchema: z.ZodObject<{
+    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;
+        purpose: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strict>]>>>;
+        output: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            shape: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                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";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            stage_hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    user_prep_instructions: z.ZodOptional<z.ZodString>;
+    source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodString>;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
+            page_count: z.ZodOptional<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        shape: z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            artifact_kind: z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            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";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        stage_hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const BuildPlanAuthoringBriefSchema: z.ZodPipe<z.ZodObject<{
+    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;
+        purpose: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strict>]>>>;
+        output: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            shape: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                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";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            stage_hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodString>;
+        evidence_expectation: z.ZodOptional<z.ZodString>;
+        backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    user_prep_instructions: z.ZodOptional<z.ZodString>;
+    source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodString>;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodString>;
+            page_count: z.ZodOptional<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        shape: z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+            artifact_kind: z.ZodEnum<{
+                file: "file";
+                directory: "directory";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            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";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        stage_hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodTransform<{
+    requested_artifacts: {
+        title: string;
+        checks: (string | {
+            label: string;
+        })[];
+        id?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        output?: {
+            checks: {
+                id: string;
+                kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                required: boolean;
+                description?: string | undefined;
+                params?: Record<string, unknown> | undefined;
+            }[];
+            path?: string | undefined;
+            shape?: {
+                kind: "path";
+                path: string;
+                artifact_kind: "file" | "directory";
+            } | undefined;
+            stage_hint?: string | undefined;
+        } | undefined;
+    }[];
+    checks: {
+        label: string;
+        backed_by_artifact_ids: string[];
+        required: boolean;
+        id?: string | undefined;
+        description?: string | undefined;
+        evidence?: string | undefined;
+        evidence_expectation?: string | undefined;
+    }[];
+    artifact_requirements: {
+        id: string;
+        shape: {
+            kind: "path";
+            path: string;
+            artifact_kind: "file" | "directory";
+        };
+        checks: {
+            id: string;
+            kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+            required: boolean;
+            description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
+        }[];
+        description?: string | undefined;
+        stage_hint?: string | undefined;
+    }[];
+    intent: string;
+    user_prep_instructions?: string | undefined;
+    source_context?: {
+        items: {
+            name?: string | undefined;
+            path?: string | undefined;
+            kind?: string | undefined;
+            page_count?: number | undefined;
+            note?: string | undefined;
+        }[];
+        observations: string[];
+        limitations: string[];
+        summary?: string | undefined;
+    } | null | undefined;
+}, {
+    intent: string;
+    requested_artifacts?: {
+        title: string;
+        checks: (string | {
+            label: string;
+        })[];
+        id?: string | undefined;
+        purpose?: string | undefined;
+        description?: string | undefined;
+        output?: {
+            checks: {
+                id: string;
+                kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+                required: boolean;
+                description?: string | undefined;
+                params?: Record<string, unknown> | undefined;
+            }[];
+            path?: string | undefined;
+            shape?: {
+                kind: "path";
+                path: string;
+                artifact_kind: "file" | "directory";
+            } | undefined;
+            stage_hint?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    checks?: {
+        label: string;
+        backed_by_artifact_ids: string[];
+        required: boolean;
+        id?: string | undefined;
+        description?: string | undefined;
+        evidence?: string | undefined;
+        evidence_expectation?: string | undefined;
+    }[] | undefined;
+    context_checks?: {
+        label: string;
+        backed_by_artifact_ids: string[];
+        required: boolean;
+        id?: string | undefined;
+        description?: string | undefined;
+        evidence?: string | undefined;
+        evidence_expectation?: string | undefined;
+    }[] | undefined;
+    user_prep_instructions?: string | undefined;
+    source_context?: {
+        items: {
+            name?: string | undefined;
+            path?: string | undefined;
+            kind?: string | undefined;
+            page_count?: number | undefined;
+            note?: string | undefined;
+        }[];
+        observations: string[];
+        limitations: string[];
+        summary?: string | undefined;
+    } | null | undefined;
+    artifact_requirements?: {
+        id: string;
+        shape: {
+            kind: "path";
+            path: string;
+            artifact_kind: "file" | "directory";
+        };
+        checks: {
+            id: string;
+            kind: "file_exists" | "source_manifest_valid" | "min_file_count" | "min_file_count_matches_source" | "source_summary_folders" | "source_page_coverage" | "frontmatter_valid" | "frontmatter_required_keys" | "frontmatter_nonempty_keys" | "source_refs_required" | "wikilinks_valid" | "must_not_contain" | "must_contain" | "qa_match";
+            required: boolean;
+            description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
+        }[];
+        description?: string | undefined;
+        stage_hint?: string | undefined;
+    }[] | undefined;
+}>>;
+export type RequestedArtifactCheck = z.infer<typeof RequestedArtifactCheckSchema>;
+export type RequestedArtifactOutput = z.infer<typeof RequestedArtifactOutputSchema>;
+export type RequestedArtifact = z.infer<typeof RequestedArtifactSchema>;
+export type SourceContext = z.infer<typeof SourceContextSchema>;
+export type BuildPlanContextCheckDraft = z.infer<typeof BuildPlanContextCheckDraftSchema>;
+export type BuildPlanAuthoringArtifactRequirement = z.infer<typeof BuildPlanAuthoringArtifactRequirementSchema>;
+export type BuildPlanAuthoringBriefInput = z.infer<typeof BuildPlanAuthoringBriefInputSchema>;
+export type BuildPlanAuthoringBrief = z.infer<typeof BuildPlanAuthoringBriefSchema>;

package/dist/packages/build-plans/authoring/brief.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { ArtifactIdSchema, ArtifactPathShapeSchema, CheckSchema, InterfIdPattern, } from "../../contracts/lib/schema.js";
+import { slugify } from "../../contracts/utils/naming.js";
+export const RequestedArtifactCheckSchema = z.object({
+    label: z.string().min(1),
+}).strict();
+export const RequestedArtifactOutputSchema = z.object({
+    path: z.string().min(1).optional(),
+    shape: ArtifactPathShapeSchema.optional(),
+    checks: z.array(CheckSchema).default([]),
+    stage_hint: z.string().min(1).optional(),
+}).strict();
+const RequestedArtifactObjectSchema = z.object({
+    id: z.string().min(1).optional(),
+    title: z.string().min(1),
+    purpose: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    checks: z.array(z.union([z.string().min(1), RequestedArtifactCheckSchema])).default([]),
+    output: RequestedArtifactOutputSchema.optional(),
+}).strict();
+export const RequestedArtifactSchema = z.preprocess((value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const record = value;
+    const title = typeof record.label === "string"
+        ? record.label
+        : typeof record.name === "string"
+            ? record.name
+            : typeof record.title === "string"
+                ? record.title
+                : null;
+    if (!title || title.trim().length === 0)
+        return value;
+    const id = typeof record.id === "string" && record.id.trim().length > 0
+        ? record.id
+        : slugify(title);
+    return {
+        ...record,
+        title,
+        ...(id ? { id } : {}),
+    };
+}, RequestedArtifactObjectSchema);
+export const SourceContextItemSchema = z.object({
+    name: z.string().min(1).optional(),
+    path: z.string().min(1).optional(),
+    kind: z.string().min(1).optional(),
+    page_count: z.number().int().nonnegative().optional(),
+    note: z.string().min(1).optional(),
+}).strict();
+export const SourceContextSchema = z.object({
+    summary: z.string().min(1).optional(),
+    items: z.array(SourceContextItemSchema).default([]),
+    observations: z.array(z.string().min(1)).default([]),
+    limitations: z.array(z.string().min(1)).default([]),
+}).strict();
+export const BuildPlanContextCheckDraftSchema = z.object({
+    id: z.string().regex(InterfIdPattern).optional(),
+    label: z.string().min(1),
+    description: z.string().min(1).optional(),
+    evidence: z.string().min(1).optional(),
+    evidence_expectation: z.string().min(1).optional(),
+    backed_by_artifact_ids: z.array(ArtifactIdSchema).default([]),
+    required: z.boolean().default(true),
+}).strict();
+export const BuildPlanAuthoringArtifactRequirementSchema = z.object({
+    id: ArtifactIdSchema,
+    description: z.string().min(1).optional(),
+    shape: ArtifactPathShapeSchema,
+    checks: z.array(CheckSchema).default([]),
+    stage_hint: z.string().min(1).optional(),
+}).strict();
+export const BuildPlanAuthoringBriefInputSchema = z.object({
+    intent: z.string().min(1),
+    requested_artifacts: z.array(RequestedArtifactSchema).optional(),
+    checks: z.array(BuildPlanContextCheckDraftSchema).optional(),
+    context_checks: z.array(BuildPlanContextCheckDraftSchema).optional(),
+    user_prep_instructions: z.string().min(1).optional(),
+    source_context: SourceContextSchema.nullable().optional(),
+    artifact_requirements: z.array(BuildPlanAuthoringArtifactRequirementSchema).optional(),
+}).strict();
+export const BuildPlanAuthoringBriefSchema = BuildPlanAuthoringBriefInputSchema.transform((value) => {
+    const { context_checks: contextChecks, ...rest } = value;
+    return {
+        ...rest,
+        requested_artifacts: value.requested_artifacts ?? [],
+        checks: value.checks ?? contextChecks ?? [],
+        artifact_requirements: value.artifact_requirements ?? [],
+    };
+});