@interf/compiler 0.22.0 → 0.33.0

package/dist/packages/runtime/actions/form-builders.js

@@ -0,0 +1,619 @@
+import { z } from "zod";
+import { BuildPlanAuthoringActionValuesSchema, ProjectSetupActionValuesSchema, optionalActionText, requiredActionText, } from "./schemas.js";
+import { INTERF_SERVICE_ACTIONS } from "./registry.js";
+import { packageSchemaFieldErrors } from "./errors.js";
+import { buildPlanChoiceOptions, buildPlanIntentFromInput, inputValue, maybeActionValue, titleFromActionId, uniqueActionId, } from "./helpers.js";
+import { buildPlanAuthoringSchema, buildPlanChangeSchema, createProjectSchema, prepareRunSchema, projectChangeSchema, selectBuildPlanSchema, } from "./form-validators.js";
+import { buildPlanAuthoringActionValues, buildPlanChangeActionValues, createProjectActionValues, duplicateProjectActionValues, normalizedBuildPlanActionValues, projectChangeActionValues, selectBuildPlanActionValues, } from "./requests.js";
+export function buildCreateProjectActionDefinition(context) {
+    const existingNames = new Set(context.existingNames);
+    const name = uniqueActionId(context.suggestedName, existingNames);
+    return {
+        id: INTERF_SERVICE_ACTIONS.createProject.id,
+        title: INTERF_SERVICE_ACTIONS.createProject.title,
+        description: "Create a Project by binding a Source. Draft or select a Build Plan after the Project exists.",
+        submitLabel: "Create Project",
+        initialValues: {
+            name,
+            path: context.projectDataDir,
+        },
+        schema: createProjectSchema(existingNames),
+        validateRequest: (values) => packageSchemaFieldErrors(ProjectSetupActionValuesSchema.safeParse(createProjectActionValues(values)), {
+            name: "name",
+            path: "path",
+            build_plan: "build_plan",
+        }),
+        valuesPreview: createProjectActionValues,
+        buildDraft: (values) => {
+            const actionValues = createProjectActionValues(values);
+            return {
+                project: inputValue(values, "name"),
+                values: actionValues,
+                message: [
+                    `Create Project ${inputValue(values, "name")}.`,
+                    `Source: ${inputValue(values, "path")}`,
+                    "Draft or select the Build Plan after this Project exists. Do not build yet.",
+                    "Use the attached typed action input as the source of truth.",
+                ].filter((line) => Boolean(line)).join("\n"),
+            };
+        },
+        fields: [
+            {
+                name: "name",
+                label: "Project id",
+                type: "text",
+                help: "Lowercase id for this Project. Use letters, numbers, and dashes.",
+                context: "Saved as the durable Project id.",
+                placeholder: name,
+            },
+            {
+                name: "path",
+                label: "Source",
+                type: "text",
+                help: "Absolute path to the folder Interf reads from. Files stay where they are; Interf reads them by reference. You can link this later if you don't have a folder yet.",
+                context: "Saved as the Project's Source binding.",
+                placeholder: context.projectDataDir || "/Users/you/Documents/your-folder",
+            },
+        ],
+    };
+}
+export function buildBuildRunActionDefinition(context) {
+    return {
+        id: INTERF_SERVICE_ACTIONS.buildRun.id,
+        title: INTERF_SERVICE_ACTIONS.buildRun.title,
+        description: "Build a Context Graph for this Project. Interf will run the saved Build Plan against the Source and record a Run.",
+        submitLabel: "Build Context Graph",
+        initialValues: {
+            project: context.name,
+            build_plan: context.buildPlanId,
+            source_folder_path: context.sourceFolderPath,
+        },
+        schema: prepareRunSchema(),
+        valuesPreview: (values) => ({
+            action_type: INTERF_SERVICE_ACTIONS.buildRun.serviceAction,
+            project: inputValue(values, "project"),
+            build_plan: inputValue(values, "build_plan"),
+            source_folder_path: inputValue(values, "source_folder_path"),
+        }),
+        buildDraft: (values) => ({
+            project: inputValue(values, "project"),
+            values: {
+                action_type: INTERF_SERVICE_ACTIONS.buildRun.serviceAction,
+                project: inputValue(values, "project"),
+            },
+            message: [
+                `Build Context Graph for Project ${inputValue(values, "project")}.`,
+                `Build Plan: ${inputValue(values, "build_plan") || "(saved selection)"}.`,
+                "Build a Context Graph from the saved Source and requested Artifacts.",
+                "Use the attached typed action input as the source of truth.",
+            ].filter((line) => Boolean(line)).join("\n"),
+        }),
+        fields: [
+            {
+                name: "project",
+                label: "Project",
+                type: "text",
+                readOnly: true,
+                help: "The saved Project that will be built.",
+                context: "Sent as the build target.",
+            },
+            {
+                name: "build_plan",
+                label: "Build Plan",
+                type: "text",
+                readOnly: true,
+                help: "The Build Plan Interf will run to build the Context Graph.",
+                context: "Read from the Project's saved Build Plan selection.",
+            },
+            {
+                name: "source_folder_path",
+                label: "Source",
+                type: "text",
+                readOnly: true,
+                advanced: true,
+                help: "The Source locator whose manifest is captured for this Project.",
+                context: "Resolved from the saved Project.",
+            },
+        ],
+    };
+}
+export function buildBuildRunActionDraft(context) {
+    const definition = buildBuildRunActionDefinition(context);
+    return definition.buildDraft(definition.initialValues);
+}
+export function buildSelectBuildPlanActionDefinition(context) {
+    const actionValues = (values) => selectBuildPlanActionValues(values);
+    return {
+        id: INTERF_SERVICE_ACTIONS.selectBuildPlan.id,
+        title: INTERF_SERVICE_ACTIONS.selectBuildPlan.title,
+        description: "Choose the Build Plan that builds this Project's Context Graph. This saves the selection without running a Build.",
+        submitLabel: "Save Build Plan",
+        initialValues: {
+            name: context.name,
+            path: context.sourceFolderPath,
+            current_build_plan: context.currentBuildPlanId ?? "",
+            build_plan: context.currentBuildPlanId ?? "",
+        },
+        schema: selectBuildPlanSchema(),
+        validateRequest: (values) => packageSchemaFieldErrors(ProjectSetupActionValuesSchema.safeParse(actionValues(values)), {
+            name: "name",
+            path: "path",
+            build_plan: "build_plan",
+        }),
+        valuesPreview: actionValues,
+        buildDraft: (values) => ({
+            project: inputValue(values, "name"),
+            values: actionValues(values),
+            message: [
+                `Select Build Plan ${inputValue(values, "build_plan")} for Project ${inputValue(values, "name")}.`,
+                "Save the selected Build Plan. Do not build yet.",
+                "Use the attached typed action input as the source of truth.",
+            ].join("\n"),
+        }),
+        fields: [
+            {
+                name: "build_plan",
+                label: "Build Plan",
+                type: "select",
+                help: "The Build Plan future Build runs should use.",
+                context: "Saved on the existing Project.",
+                options: buildPlanChoiceOptions(context.buildPlans),
+            },
+            {
+                name: "current_build_plan",
+                label: "Current Build Plan",
+                type: "text",
+                readOnly: true,
+                help: "The Build Plan currently saved for this Project.",
+                context: "Shown so the change is explicit before approval.",
+            },
+            {
+                name: "name",
+                label: "Project",
+                type: "text",
+                readOnly: true,
+                advanced: true,
+                help: "The Project whose Build Plan selection will be updated.",
+                context: "Sent with the setup action.",
+            },
+            {
+                name: "path",
+                label: "Source",
+                type: "text",
+                readOnly: true,
+                advanced: true,
+                help: "The saved local folder for this Source.",
+                context: "Preserved while updating the selected Build Plan.",
+            },
+        ],
+    };
+}
+export function buildCreateBuildPlanActionDefinition(context) {
+    const existingBuildPlanIds = new Set(context.existingBuildPlanIds);
+    const defaultSeed = context.defaultProject ? `${context.defaultProject}-build-plan` : context.suggestedBuildPlanId;
+    const buildPlanId = uniqueActionId(defaultSeed, existingBuildPlanIds);
+    const label = titleFromActionId(buildPlanId);
+    return {
+        id: INTERF_SERVICE_ACTIONS.createBuildPlan.id,
+        title: INTERF_SERVICE_ACTIONS.createBuildPlan.title,
+        description: "Describe the Artifacts the agent needs. Interf drafts the Build Plan from this description; the Build later records what was covered.",
+        submitLabel: "Draft Build Plan",
+        initialValues: {
+            build_plan_id: "",
+            label: "",
+            hint: "",
+            intent: "",
+            requested_artifacts_description: "",
+            user_prep_instructions: "",
+        },
+        normalizeValues: (values) => normalizedBuildPlanActionValues(values, existingBuildPlanIds, defaultSeed),
+        schema: buildPlanAuthoringSchema(existingBuildPlanIds),
+        validateRequest: (values) => packageSchemaFieldErrors(BuildPlanAuthoringActionValuesSchema.safeParse(buildPlanAuthoringActionValues(values)), {
+            build_plan_id: "build_plan_id",
+            label: "label",
+            hint: "hint",
+            intent: "intent",
+            requested_artifacts_description: "requested_artifacts_description",
+            user_prep_instructions: "user_prep_instructions",
+        }),
+        valuesPreview: (values) => ({
+            build_plan_id: inputValue(values, "build_plan_id"),
+            label: inputValue(values, "label"),
+            hint: inputValue(values, "hint"),
+            intent: buildPlanIntentFromInput(values),
+        }),
+        buildDraft: (values) => ({
+            project: context.defaultProject,
+            values: buildPlanAuthoringActionValues(values),
+            message: [
+                `Draft Build Plan ${inputValue(values, "build_plan_id")}${context.defaultProject ? ` for Project ${context.defaultProject}` : ""}.`,
+                `Label: ${inputValue(values, "label")}`,
+                `Summary: ${inputValue(values, "hint")}`,
+                buildPlanIntentFromInput(values),
+                "Use the attached typed action input as the Build Plan authoring request.",
+            ].join("\n"),
+        }),
+        fields: [
+            {
+                name: "intent",
+                label: "Intent",
+                type: "textarea",
+                rows: 4,
+                help: "The agent task this Project should unlock.",
+                context: "Used as the main Build Plan authoring instruction.",
+                placeholder: "Example: Analyze every report chart, extract annual take-up by location, and produce a source data file plus markdown summary.",
+            },
+            {
+                name: "requested_artifacts_description",
+                label: "Requested Artifacts",
+                type: "textarea",
+                rows: 3,
+                help: "Files, sections, or evidence agents should receive in the Context Graph.",
+                context: "Guides the requested Artifact shape and Build Plan stages before a Build records Source coverage.",
+                placeholder: "Describe the files or sections agents should receive.",
+            },
+            {
+                name: "user_prep_instructions",
+                label: "Build instructions",
+                type: "textarea",
+                rows: 3,
+                help: "Checks and evidence these Artifacts should satisfy.",
+                context: "Guides Build Plan checks and evidence expectations. Artifact contract checks stay separate.",
+                placeholder: "Describe the evidence that should make these Artifacts ready.",
+            },
+            {
+                name: "build_plan_id",
+                label: "Build Plan id",
+                type: "text",
+                advanced: true,
+                help: "Optional. Leave blank and Interf generates a stable id from the job.",
+                context: "Saved as the Build Plan id and referenced by Projects.",
+                placeholder: buildPlanId,
+            },
+            {
+                name: "label",
+                label: "Label",
+                type: "text",
+                advanced: true,
+                help: "Optional readable name people can choose later.",
+                context: "Shown in the UI and sent to the local agent while drafting the Build Plan.",
+                placeholder: label,
+            },
+            {
+                name: "hint",
+                label: "Summary",
+                type: "textarea",
+                advanced: true,
+                rows: 2,
+                help: "Optional short description. Interf derives one from the job if left blank.",
+                context: "Gives the local agent quick context before it drafts stages and outputs.",
+                placeholder: "Build charts, tables, and cited findings for analyst agents.",
+            },
+        ],
+    };
+}
+export function buildBuildPlanChangeActionDefinition(context) {
+    const existingBuildPlanIds = new Set(context.existingBuildPlanIds);
+    const actionLabel = titleFromActionId(context.action);
+    const newBuildPlanId = context.action === "duplicate"
+        ? uniqueActionId(`${context.buildPlanId}-copy`, existingBuildPlanIds)
+        : "";
+    const initialValues = {
+        action: `build-plan-${context.action}`,
+        build_plan: context.buildPlanId,
+        project: context.project,
+        ...(context.action === "modify" ? { change_request: "", label: context.label ?? "", hint: context.hint ?? "" } : {}),
+        ...(context.action === "duplicate" ? { new_build_plan_id: newBuildPlanId } : {}),
+        ...(context.action === "remove" ? { confirmation: "" } : {}),
+    };
+    const actionValues = (values) => buildPlanChangeActionValues(context.action, values);
+    const messageFor = (values) => {
+        if (context.action === "modify") {
+            return [
+                `Modify Build Plan ${inputValue(values, "build_plan")}.`,
+                `Requested change: ${inputValue(values, "change_request")}`,
+                "Use the attached typed Build Plan authoring input as the source of truth.",
+            ].join("\n");
+        }
+        if (context.action === "duplicate") {
+            return [
+                `Duplicate Build Plan ${inputValue(values, "build_plan")} as ${inputValue(values, "new_build_plan_id")}.`,
+                "Use the attached typed Build Plan change input as the source of truth.",
+            ].join("\n");
+        }
+        return [
+            `Remove Build Plan ${inputValue(values, "build_plan")}.`,
+            "The user typed the Build Plan id to confirm removal.",
+            "Use the attached typed Build Plan change input as the source of truth.",
+        ].join("\n");
+    };
+    const fields = [
+        {
+            name: "build_plan",
+            label: "Build Plan",
+            type: "text",
+            readOnly: true,
+            help: "The Build Plan this request targets.",
+            context: "Sent as the Build Plan change target.",
+        },
+        {
+            name: "change_request",
+            label: context.action === "duplicate" ? "Requested difference" : "Requested change",
+            type: "textarea",
+            rows: 4,
+            advanced: context.action === "remove",
+            help: context.action === "duplicate"
+                ? "What should be different in the duplicate Build Plan."
+                : "What should change in the existing Build Plan.",
+            context: "Sent as the human-authored Build Plan change request.",
+            placeholder: "Describe the concrete change Interf should make.",
+        },
+        {
+            name: "new_build_plan_id",
+            label: "New Build Plan id",
+            type: "text",
+            advanced: context.action !== "duplicate",
+            help: "Stable id for the duplicated Build Plan.",
+            context: "Used as the target Build Plan id for the duplicate request.",
+            placeholder: newBuildPlanId,
+        },
+        {
+            name: "confirmation",
+            label: "Confirm removal",
+            type: "text",
+            advanced: context.action !== "remove",
+            help: `Type ${context.buildPlanId} to confirm this removal request.`,
+            context: "Prevents accidental destructive Build Plan requests.",
+            placeholder: context.buildPlanId,
+        },
+        {
+            name: "label",
+            label: "Label",
+            type: "text",
+            advanced: true,
+            help: "Readable Build Plan name to keep while modifying this Build Plan.",
+            context: "Sent to the Build Plan authoring run.",
+            placeholder: context.label ?? context.buildPlanId,
+        },
+        {
+            name: "hint",
+            label: "Summary",
+            type: "textarea",
+            rows: 2,
+            advanced: true,
+            help: "Short Build Plan summary to keep while modifying this Build Plan.",
+            context: "Sent to the Build Plan authoring run.",
+            placeholder: context.hint ?? "Build Plan for requested Artifacts and Context Checks.",
+        },
+        {
+            name: "project",
+            label: "Project",
+            type: "text",
+            readOnly: true,
+            advanced: true,
+            help: "A related Project used as context for this request.",
+            context: "Sent with the proposal request when available.",
+            placeholder: "No Project selected",
+        },
+    ];
+    return {
+        id: `${INTERF_SERVICE_ACTIONS.buildPlanChange.id}-${context.action}`,
+        title: `${actionLabel} Build Plan`,
+        description: context.action === "remove"
+            ? "Confirm the Build Plan removal request. Interf will reject removal while any saved Project still uses it."
+            : context.action === "duplicate"
+                ? "Duplicate this Build Plan through the local Interf service."
+                : "Describe the change and Interf will run a visible Build Plan draft run.",
+        submitLabel: context.action === "modify" ? "Modify Build Plan" : "Confirm",
+        initialValues,
+        schema: buildPlanChangeSchema(context.action, context.buildPlanId, existingBuildPlanIds),
+        valuesPreview: actionValues,
+        buildDraft: (values) => ({
+            project: inputValue(values, "project"),
+            values: actionValues(values),
+            message: messageFor(values),
+        }),
+        fields: fields.filter((field) => {
+            if (field.name === "change_request")
+                return context.action === "modify";
+            if (field.name === "new_build_plan_id")
+                return context.action === "duplicate";
+            if (field.name === "confirmation")
+                return context.action === "remove";
+            if (field.name === "label" || field.name === "hint")
+                return context.action === "modify";
+            return true;
+        }),
+    };
+}
+export function buildProjectChangeActionDefinition(context) {
+    const existingNames = new Set(context.existingNames);
+    const actionLabel = titleFromActionId(context.action);
+    const duplicateName = context.action === "duplicate"
+        ? uniqueActionId(`${context.project}-copy`, existingNames)
+        : "";
+    const initialValues = {
+        action: `project-${context.action}`,
+        project: context.project,
+        ...(context.action === "modify" || context.action === "duplicate"
+            ? {
+                name: context.action === "duplicate" ? duplicateName : context.project,
+                path: context.sourceFolderPath,
+                build_plan: context.buildPlanId ?? "",
+            }
+            : {}),
+        ...(context.action === "remove" ? { confirmation: "" } : {}),
+    };
+    const actionValues = (values) => projectChangeActionValues(context.action, values);
+    const messageFor = (values) => {
+        if (context.action === "modify") {
+            return [
+                `Modify Project ${inputValue(values, "project")}.`,
+                maybeActionValue(inputValue(values, "build_plan")) ? `Build Plan: ${inputValue(values, "build_plan")}` : null,
+                `Source: ${inputValue(values, "path")}`,
+                "Use the attached typed Project setup input as the source of truth.",
+            ].filter((line) => Boolean(line)).join("\n");
+        }
+        if (context.action === "duplicate") {
+            return [
+                `Duplicate Project ${inputValue(values, "project")} as ${inputValue(values, "name")}.`,
+                maybeActionValue(inputValue(values, "build_plan")) ? `Build Plan: ${inputValue(values, "build_plan")}` : null,
+                `Source: ${inputValue(values, "path")}`,
+                "Use the attached typed Project setup input as the source of truth.",
+            ].filter((line) => Boolean(line)).join("\n");
+        }
+        return [
+            `Remove Project ${inputValue(values, "project")}.`,
+            "The user typed the Project id to confirm removal.",
+            "Use the attached typed Project change input as the source of truth.",
+        ].join("\n");
+    };
+    const fields = [
+        {
+            name: "project",
+            label: "Project",
+            type: "text",
+            readOnly: true,
+            help: "The saved Project this request targets.",
+            context: "Sent as the Project target.",
+        },
+        {
+            name: "name",
+            label: context.action === "duplicate" ? "New Project id" : "Project id",
+            type: "text",
+            readOnly: context.action === "modify",
+            help: context.action === "duplicate"
+                ? "Stable id for the duplicated Project."
+                : "Stable id for this Project.",
+            context: "Saved as the Project name.",
+            placeholder: duplicateName || context.project,
+        },
+        {
+            name: "build_plan",
+            label: "Build Plan",
+            type: "text",
+            help: "The Build Plan future Build runs should use.",
+            context: "Saved on this Project.",
+            placeholder: "interf-default",
+        },
+        {
+            name: "path",
+            label: "Source",
+            type: "text",
+            readOnly: true,
+            advanced: context.action === "modify",
+            help: "The local folder for this Project's Source.",
+            context: "Saved on this Project.",
+        },
+        {
+            name: "confirmation",
+            label: "Confirm removal",
+            type: "text",
+            help: `Type ${context.project} to confirm this removal request.`,
+            context: "Prevents accidental destructive Project requests.",
+            placeholder: context.project,
+        },
+    ];
+    return {
+        id: `${INTERF_SERVICE_ACTIONS.projectChange.id}-${context.action}`,
+        title: `${actionLabel} Project`,
+        description: context.action === "remove"
+            ? "Confirm the Project removal request before Interf removes it from the saved config."
+            : context.action === "duplicate"
+                ? "Describe the new Project created from this saved Source."
+                : "Update the saved Project fields through the local Interf service.",
+        submitLabel: "Confirm",
+        initialValues,
+        schema: projectChangeSchema(context.action, context.project, existingNames),
+        validateRequest: context.action === "modify" || context.action === "duplicate"
+            ? (values) => packageSchemaFieldErrors(ProjectSetupActionValuesSchema.safeParse(duplicateProjectActionValues(values)), {
+                name: "name",
+                path: "path",
+                build_plan: "build_plan",
+            })
+            : undefined,
+        valuesPreview: actionValues,
+        buildDraft: (values) => ({
+            project: inputValue(values, "project"),
+            values: actionValues(values),
+            message: messageFor(values),
+        }),
+        fields: fields.filter((field) => {
+            if (field.name === "name" || field.name === "build_plan" || field.name === "path")
+                return context.action === "modify" || context.action === "duplicate";
+            if (field.name === "confirmation")
+                return context.action === "remove";
+            return true;
+        }),
+    };
+}
+export function buildConfirmActionDefinition(draft) {
+    return {
+        id: INTERF_SERVICE_ACTIONS.confirmAction.id,
+        title: INTERF_SERVICE_ACTIONS.confirmAction.title,
+        description: "This request will be sent to the local Interf service to create an approval proposal.",
+        submitLabel: "Confirm Request",
+        initialValues: {
+            project: draft.project,
+            message: draft.message,
+        },
+        schema: z.object({
+            project: optionalActionText,
+            message: requiredActionText("Action"),
+        }).strict(),
+        valuesPreview: () => draft.values ?? { message: draft.message },
+        buildDraft: () => ({ ...draft, confirmed: true }),
+        fields: [
+            {
+                name: "project",
+                label: "Project",
+                type: "text",
+                readOnly: true,
+                help: "The Project this action targets.",
+                context: "Sent with the proposal request.",
+                placeholder: "No Project selected",
+            },
+            {
+                name: "message",
+                label: "Request to Interf service",
+                type: "textarea",
+                readOnly: true,
+                rows: 5,
+                help: "Interf sends this request with typed values so the local service can propose the concrete action.",
+                context: "Sent to the local Interf service together with typed action values when available.",
+            },
+        ],
+    };
+}
+export function buildBenchmarkActionDraft(options) {
+    if (options.action === "check") {
+        return {
+            project: options.project,
+            message: `Run benchmark for ${options.project}.`,
+            values: {
+                action_type: INTERF_SERVICE_ACTIONS.runBenchmark.serviceAction,
+                project: options.project,
+                target: "both",
+            },
+        };
+    }
+    if (options.action === "draft-checks") {
+        return {
+            project: options.project,
+            message: `Draft benchmark questions for ${options.project}.`,
+            values: {
+                action_type: INTERF_SERVICE_ACTIONS.draftBenchmarkQuestions.serviceAction,
+                project: options.project,
+            },
+        };
+    }
+    return {
+        project: options.project,
+        message: `Improve ${options.project} using the latest benchmark results and Build evidence.`,
+        values: {
+            action_type: INTERF_SERVICE_ACTIONS.improveProject.serviceAction,
+            ...(options.buildPlanId ? { build_plan: options.buildPlanId } : {}),
+            project: options.project,
+        },
+    };
+}

package/dist/packages/runtime/actions/form-validators.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import type { ActionInputValues, BuildPlanChangeAction, ProjectChangeAction } from "./fields.js";
+export declare function createProjectSchema(existingNames: Set<string>): z.ZodType<ActionInputValues>;
+export declare function prepareRunSchema(): z.ZodType<ActionInputValues>;
+export declare function selectBuildPlanSchema(): z.ZodType<ActionInputValues>;
+export declare function buildPlanAuthoringSchema(existingBuildPlanIds: Set<string>): z.ZodType<ActionInputValues>;
+export declare function buildPlanChangeSchema(action: BuildPlanChangeAction, buildPlanId: string, existingBuildPlanIds: Set<string>): z.ZodType<ActionInputValues>;
+export declare function projectChangeSchema(action: ProjectChangeAction, project: string, existingNames: Set<string>): z.ZodType<ActionInputValues>;