@interf/compiler 0.18.0 → 0.21.0

package/dist/packages/engine/action-definitions.d.ts

@@ -1,4 +1,6 @@
 import { z } from "zod";
+import { type RequestedArtifact, type SourceProfile } from "../project/lib/schema.js";
+import { artifactRequirementsFromRequestedArtifacts } from "./requested-artifacts.js";
 export declare const ActionValueIdPattern: RegExp;
 export declare const ActionValueIdSchema: z.ZodString;
 export declare const OptionalActionValueIdSchema: z.ZodString;
@@ -6,6 +8,56 @@ export declare const SourceReadinessCheckActionValueSchema: z.ZodObject<{
     question: z.ZodString;
     answer: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
+export declare const RequestedArtifactActionValueSchema: z.ZodPreprocess<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.$loose>]>>>;
+    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";
+                min_file_count: "min_file_count";
+                min_file_count_matches_source: "min_file_count_matches_source";
+                frontmatter_valid: "frontmatter_valid";
+                frontmatter_required_keys: "frontmatter_required_keys";
+                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 SourceProfileActionValueSchema: 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.$loose>>>;
+    observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
 export declare const PreparationSetupActionValuesSchema: z.ZodObject<{
     name: z.ZodString;
     path: z.ZodString;
@@ -15,6 +67,56 @@ export declare const PreparationSetupActionValuesSchema: z.ZodObject<{
         question: z.ZodString;
         answer: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
+    requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPreprocess<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.$loose>]>>>;
+        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";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    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>>>>;
+    source_profile: z.ZodOptional<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.$loose>>>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>;
     max_attempts: z.ZodOptional<z.ZodNumber>;
     max_loops: z.ZodOptional<z.ZodNumber>;
     readiness_notes: z.ZodOptional<z.ZodString>;
@@ -32,6 +134,56 @@ export declare const MethodAuthoringActionValuesSchema: z.ZodObject<{
     hint: z.ZodOptional<z.ZodString>;
     task_prompt: z.ZodString;
     portable_output: z.ZodOptional<z.ZodString>;
+    requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPreprocess<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.$loose>]>>>;
+        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";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    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>>>>;
+    source_profile: 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.$loose>>>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>>;
     readiness_notes: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type PreparationSetupActionValues = z.infer<typeof PreparationSetupActionValuesSchema>;
@@ -42,31 +194,31 @@ export declare const INTERF_SERVICE_ACTIONS: {
         readonly id: "create-preparation";
         readonly serviceAction: "preparation-setup";
         readonly title: "Create Preparation";
-        readonly description: "Save a Source Folder + Method binding so future runs can be invoked by name.";
+        readonly description: "Save a Source, requested Artifacts, Build Plan, and run history under one Preparation.";
     };
     readonly compileRun: {
         readonly id: "compile-run";
         readonly serviceAction: "compile";
-        readonly title: "Compile Method";
-        readonly description: "Run the chosen Method against this Source Folder and write portable context.";
+        readonly title: "Compile Artifacts";
+        readonly description: "Run the saved Build Plan against this Source and write portable context.";
     };
     readonly selectMethod: {
         readonly id: "select-method";
         readonly serviceAction: "preparation-setup";
-        readonly title: "Select Method";
-        readonly description: "Choose which Method this saved binding should use for future runs.";
+        readonly title: "Select Build Plan";
+        readonly description: "Choose the Build Plan that will compile this Preparation's requested Artifacts.";
     };
     readonly createMethod: {
         readonly id: "create-method";
         readonly serviceAction: "method-authoring";
-        readonly title: "Draft Method";
-        readonly description: "Draft a reusable local Method that captures a repeatable agent-work pattern.";
+        readonly title: "Draft Build Plan";
+        readonly description: "Draft a Build Plan for the Artifacts this Preparation should compile.";
     };
     readonly methodChange: {
         readonly id: "method-change";
         readonly serviceAction: "method-change";
-        readonly title: "Method Change";
-        readonly description: "Modify, duplicate, or remove an existing Method.";
+        readonly title: "Build Plan Change";
+        readonly description: "Modify, duplicate, or remove an existing Build Plan.";
     };
     readonly preparationChange: {
         readonly id: "preparation-change";
@@ -95,8 +247,8 @@ export declare const INTERF_SERVICE_ACTIONS: {
     readonly improvePreparation: {
         readonly id: "improve-preparation";
         readonly serviceAction: "method-improvement";
-        readonly title: "Improve Method";
-        readonly description: "Use readiness evidence to refine the Method this saved binding uses.";
+        readonly title: "Improve Build Plan";
+        readonly description: "Use readiness evidence to refine the Build Plan this Preparation uses.";
     };
 };
 export type InterfServiceActionKey = keyof typeof INTERF_SERVICE_ACTIONS;
@@ -158,11 +310,13 @@ export type CompileRunActionContext = {
 export type SelectMethodActionContext = {
     about: string;
     checks?: SourceReadinessCheckActionValue[];
-    currentMethodId: string;
+    currentMethodId?: string | null;
     maxAttempts?: number;
     maxLoops?: number;
     methods: MethodActionChoice[];
     name: string;
+    requestedArtifacts?: RequestedArtifact[];
+    sourceProfile?: SourceProfile | null;
     sourceFolderPath: string;
 };
 export type CreateMethodActionContext = {
@@ -202,9 +356,11 @@ export declare function preparationSetupRequestFromActionValues(input: unknown):
         checks: SourceReadinessCheckActionValue[];
         max_attempts?: number;
         max_loops?: number;
-        method: string;
+        method?: string;
         name: string;
         path: string;
+        requested_artifacts?: RequestedArtifact[];
+        source_profile?: SourceProfile;
     };
     prepare_after_setup: boolean;
     setup_mode: "create" | "select-method";
@@ -212,8 +368,11 @@ export declare function preparationSetupRequestFromActionValues(input: unknown):
 export declare function methodAuthoringRequestFromActionValues(input: unknown, context: {
     checks?: SourceReadinessCheckActionValue[];
     preparation?: string | null;
+    requestedArtifacts?: RequestedArtifact[];
+    sourceProfile?: SourceProfile | null;
     sourceFolderPath: string;
 }): {
+    artifact_requirements: ReturnType<typeof artifactRequirementsFromRequestedArtifacts>;
     base_method_id?: string;
     checks: SourceReadinessCheckActionValue[];
     hint: string;
@@ -221,6 +380,8 @@ export declare function methodAuthoringRequestFromActionValues(input: unknown, c
     method_id: string;
     preparation?: string;
     reference_method_id?: string;
+    requested_artifacts: RequestedArtifact[];
+    source_profile?: SourceProfile | null;
     source_folder_path: string;
     task_prompt: string;
 };