@interf/compiler 0.9.5 → 0.16.0

package/dist/packages/{local-service → engine}/action-definitions.js

@@ -33,25 +33,25 @@ export const INTERF_SERVICE_ACTIONS = {
         id: "create-preparation",
         serviceAction: "preparation-setup",
         title: "Create Preparation",
-        description: "Save a Source Folder and agent job as a Preparation.",
+        description: "Save a Source Folder + Method binding so future runs can be invoked by name.",
     },
-    runPreparation: {
-        id: "prepare-run",
+    compileRun: {
+        id: "compile-run",
         serviceAction: "compile",
-        title: "Run Preparation",
-        description: "Build portable context for a saved Preparation.",
+        title: "Compile Method",
+        description: "Run the chosen Method against this Source Folder and write portable context.",
     },
     selectMethod: {
         id: "select-method",
         serviceAction: "preparation-setup",
         title: "Select Method",
-        description: "Save the Method a Preparation should use for future prepare runs.",
+        description: "Choose which Method this saved binding should use for future runs.",
     },
     createMethod: {
         id: "create-method",
         serviceAction: "method-authoring",
-        title: "Create Method",
-        description: "Draft a reusable local Method for an agent-work pattern.",
+        title: "Draft Method",
+        description: "Draft a reusable local Method that captures a repeatable agent-work pattern.",
     },
     methodChange: {
         id: "method-change",
@@ -86,8 +86,8 @@ export const INTERF_SERVICE_ACTIONS = {
     improvePreparation: {
         id: "improve-preparation",
         serviceAction: "method-improvement",
-        title: "Improve Preparation",
-        description: "Use readiness evidence to improve the Method for this Preparation.",
+        title: "Improve Method",
+        description: "Use readiness evidence to refine the Method this saved binding uses.",
     },
 };
 function optionalLine(label, value) {
@@ -470,11 +470,11 @@ export function buildCreatePreparationActionDefinition(context) {
     return {
         id: INTERF_SERVICE_ACTIONS.createPreparation.id,
         title: INTERF_SERVICE_ACTIONS.createPreparation.title,
-        description: "Describe the agent job. Interf saves the Preparation through the local service and starts its first prepare run.",
+        description: "Describe the agent job. Interf saves the Preparation through the local service and starts its first compile run.",
         submitLabel: "Confirm",
         initialValues: {
             name,
-            path: context.sourcePath,
+            path: context.prepDataDir,
             about: "",
             method: "interf-default",
             readiness_notes: "",
@@ -505,6 +505,14 @@ export function buildCreatePreparationActionDefinition(context) {
             };
         },
         fields: [
+            {
+                name: "path",
+                label: "Source folder",
+                type: "text",
+                help: "Absolute path to the folder Interf will read from. Files stay where they are; Interf reads them by reference.",
+                context: "Saved as the Preparation's source binding and sent as typed action input.",
+                placeholder: context.prepDataDir || "/Users/you/Documents/your-folder",
+            },
             {
                 name: "about",
                 label: "Agent job",
@@ -543,10 +551,10 @@ export function buildCreatePreparationActionDefinition(context) {
         ],
     };
 }
-export function buildPrepareRunActionDefinition(context) {
+export function buildCompileRunActionDefinition(context) {
     return {
-        id: INTERF_SERVICE_ACTIONS.runPreparation.id,
-        title: INTERF_SERVICE_ACTIONS.runPreparation.title,
+        id: INTERF_SERVICE_ACTIONS.compileRun.id,
+        title: INTERF_SERVICE_ACTIONS.compileRun.title,
         description: "Build portable context for this Preparation. Interf will run the saved Method against the source folder and record a visible run.",
         submitLabel: "Run",
         initialValues: {
@@ -557,7 +565,7 @@ export function buildPrepareRunActionDefinition(context) {
         },
         schema: prepareRunSchema(),
         valuesPreview: (values) => ({
-            action_type: INTERF_SERVICE_ACTIONS.runPreparation.serviceAction,
+            action_type: INTERF_SERVICE_ACTIONS.compileRun.serviceAction,
             preparation: inputValue(values, "preparation"),
             method: inputValue(values, "method"),
             source_folder_path: inputValue(values, "source_folder_path"),
@@ -566,13 +574,12 @@ export function buildPrepareRunActionDefinition(context) {
         buildDraft: (values) => ({
             preparation: inputValue(values, "preparation"),
             values: {
-                action_type: INTERF_SERVICE_ACTIONS.runPreparation.serviceAction,
+                action_type: INTERF_SERVICE_ACTIONS.compileRun.serviceAction,
                 preparation: inputValue(values, "preparation"),
                 ...(maybeActionValue(inputValue(values, "method")) ? { method: inputValue(values, "method") } : {}),
             },
             message: [
-                `Run Preparation ${inputValue(values, "preparation")}.`,
-                maybeActionValue(inputValue(values, "method")) ? `Method: ${inputValue(values, "method")}` : null,
+                `Compile Method ${inputValue(values, "method") || "(saved selection)"} for Preparation ${inputValue(values, "preparation")}.`,
                 maybeActionValue(inputValue(values, "about")) ? `Agent work: ${inputValue(values, "about")}` : null,
                 "Build portable context from the saved Source Folder and selected Method.",
                 "Use the attached typed action input as the source of truth.",
@@ -602,7 +609,7 @@ export function buildPrepareRunActionDefinition(context) {
                 readOnly: true,
                 advanced: true,
                 help: "The work this Preparation is meant to support.",
-                context: "Preserved as context for the prepare-run proposal.",
+                context: "Preserved as context for the compile-run proposal.",
                 placeholder: "No saved job description.",
             },
             {
@@ -617,8 +624,8 @@ export function buildPrepareRunActionDefinition(context) {
         ],
     };
 }
-export function buildPrepareRunActionDraft(context) {
-    const definition = buildPrepareRunActionDefinition(context);
+export function buildCompileRunActionDraft(context) {
+    const definition = buildCompileRunActionDefinition(context);
     return definition.buildDraft(definition.initialValues);
 }
 export function buildSelectMethodActionDefinition(context) {
@@ -631,7 +638,7 @@ export function buildSelectMethodActionDefinition(context) {
     return {
         id: INTERF_SERVICE_ACTIONS.selectMethod.id,
         title: INTERF_SERVICE_ACTIONS.selectMethod.title,
-        description: "Choose which Method this Preparation uses for future prepare runs. This saves the selection without running prepare.",
+        description: "Choose which Method this Preparation uses for future compile runs. This saves the selection without running prepare.",
         submitLabel: "Confirm",
         initialValues: {
             name: context.name,
@@ -662,7 +669,7 @@ export function buildSelectMethodActionDefinition(context) {
                 name: "method",
                 label: "Method",
                 type: "select",
-                help: "The Method future prepare runs should use.",
+                help: "The Method future compile runs should use.",
                 context: "Saved on the existing Preparation.",
                 options: methodChoiceOptions(context.methods),
             },
@@ -773,9 +780,9 @@ export function buildCreateMethodActionDefinition(context) {
                 label: "Readiness guidance",
                 type: "textarea",
                 rows: 3,
-                help: "What a Preparation using this Method should be able to prove.",
-                context: "Guides Preparation-level readiness checks. Method acceptance criteria stay separate.",
-                placeholder: "Describe the evidence that should make a Preparation ready.",
+                help: "What this Method output should be able to prove.",
+                context: "Guides readiness checks. Method acceptance criteria stay separate.",
+                placeholder: "Describe the evidence that should make this Method output ready.",
             },
             {
                 name: "method_id",
@@ -1020,7 +1027,7 @@ export function buildPreparationChangeActionDefinition(context) {
             name: "method",
             label: "Method",
             type: "text",
-            help: "The Method future prepare runs should use.",
+            help: "The Method future compile runs should use.",
             context: "Saved on this Preparation.",
             placeholder: "interf-default",
         },
@@ -1122,7 +1129,6 @@ export function buildReadinessActionDraft(options) {
             values: {
                 action_type: INTERF_SERVICE_ACTIONS.checkReadiness.serviceAction,
                 preparation: options.preparation,
-                mode: "both",
             },
         };
     }

package/dist/packages/{local-service → engine}/action-planner.d.ts

@@ -1,4 +1,4 @@
-import type { MethodExecutor } from "../agents/lib/executors.js";
+import type { MethodExecutor } from "./agents/lib/executors.js";
 import type { LocalServiceActionPlanningContext } from "./runtime.js";
 import { type ActionProposalCreateRequest, type ActionProposalPlan } from "./lib/schema.js";
 export declare function buildActionPlannerPrompt(request: ActionProposalCreateRequest, context: LocalServiceActionPlanningContext, outputPath: string): string;

package/dist/packages/{local-service → engine}/action-planner.js

@@ -1,7 +1,8 @@
 import { existsSync, mkdirSync, readFileSync, } from "node:fs";
 import { join } from "node:path";
 import { methodIdForSourcePreparationConfig, } from "../methods/method-resolution.js";
-import { PACKAGE_ROOT } from "../method-package/lib/package-root.js";
+import { PACKAGE_ROOT } from "../methods/package/lib/package-root.js";
+import { asPreparationDataDir, preparationServiceActionPlansRoot, } from "../contracts/lib/preparation-paths.js";
 import { ActionProposalPlanSchema, } from "./lib/schema.js";
 function extractJsonObject(text) {
     try {
@@ -105,7 +106,7 @@ JSON schema:
 `;
 }
 export async function planActionProposalWithExecutor(options) {
-    const planRoot = join(options.context.sourcePath, "interf", ".service", "action-plans", Date.now().toString(36));
+    const planRoot = join(preparationServiceActionPlansRoot(asPreparationDataDir(options.context.sourcePath)), Date.now().toString(36));
     mkdirSync(planRoot, { recursive: true });
     const outputPath = join(planRoot, "proposal.json");
     const prompt = buildActionPlannerPrompt(options.request, options.context, outputPath);

package/dist/packages/{agents → engine/agents}/index.d.ts

@@ -14,5 +14,8 @@ export * as executors from "./lib/executors.js";
 export * as schema from "./lib/schema.js";
 export * as userConfig from "./lib/user-config.js";
 export * as compiledBootstrap from "./lib/compiled-bootstrap.js";
+export * as registry from "./registry.js";
+export * as roleRouter from "./role-router.js";
+export * as roleExecutors from "./role-executors.js";
 export type { Agent, } from "./lib/types.js";
 export type { MethodExecutionProfile, MethodExecutor, MethodExecutorKind, } from "./lib/executors.js";

package/dist/packages/{agents → engine/agents}/index.js

@@ -14,3 +14,6 @@ export * as executors from "./lib/executors.js";
 export * as schema from "./lib/schema.js";
 export * as userConfig from "./lib/user-config.js";
 export * as compiledBootstrap from "./lib/compiled-bootstrap.js";
+export * as registry from "./registry.js";
+export * as roleRouter from "./role-router.js";
+export * as roleExecutors from "./role-executors.js";

package/dist/packages/{agents → engine/agents}/lib/compiled-bootstrap.js

@@ -1,6 +1,6 @@
 import { basename } from "node:path";
-import { readInterfConfig } from "../../project-model/interf-detect.js";
-import { resolveMethodId } from "../../methods/method-resolution.js";
+import { readInterfConfig } from "../../../project/interf-detect.js";
+import { resolveMethodId } from "../../../methods/method-resolution.js";
 import { projectCompiledQueryShell, renderClaudeBootstrap } from "./shells.js";
 export { renderClaudeBootstrap };
 export function refreshCompiledBootstrapGuidance(dirPath) {

package/dist/packages/engine/agents/lib/detection.d.ts

@@ -0,0 +1,13 @@
+import type { Agent } from "./types.js";
+export declare function detectAgents(): Agent[];
+/**
+ * Whether the executable named in an agent's `command` field resolves on
+ * PATH. Custom agents may register commands like `"opencode --prompt"`,
+ * so we only check the first whitespace-separated token.
+ */
+export declare function agentCommandAvailable(command: string): boolean;
+export declare function supportsAutomatedRuns(agent: Agent): boolean;
+export declare function resolveAgent(): {
+    agent: Agent | null;
+    error?: string;
+};

package/dist/packages/{agents → engine/agents}/lib/detection.js

@@ -19,6 +19,17 @@ function commandExists(command) {
         return false;
     }
 }
+/**
+ * Whether the executable named in an agent's `command` field resolves on
+ * PATH. Custom agents may register commands like `"opencode --prompt"`,
+ * so we only check the first whitespace-separated token.
+ */
+export function agentCommandAvailable(command) {
+    const firstToken = command.trim().split(/\s+/)[0];
+    if (!firstToken)
+        return false;
+    return commandExists(firstToken);
+}
 export function supportsAutomatedRuns(agent) {
     return agent.name === "claude-code" || agent.name === "codex";
 }

package/dist/packages/{agents → engine/agents}/lib/executors.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeExecutorInfo } from "../../contracts/lib/schema.js";
+import type { RuntimeExecutorInfo } from "../../../contracts/lib/schema.js";
 import type { Agent } from "./types.js";
 export type MethodExecutorKind = "local-agent" | "connected-provider" | "managed";
 export interface MethodExecutionProfile {
@@ -21,7 +21,7 @@ export interface MethodExecutor {
     executionProfile?: MethodExecutionProfile;
     execute(rootPath: string, prompt: string, options?: MethodExecuteOptions): Promise<number>;
 }
-export type { RuntimeExecutorInfo } from "../../contracts/lib/schema.js";
+export type { RuntimeExecutorInfo } from "../../../contracts/lib/schema.js";
 export declare function buildRuntimeExecutorInfo(executor: MethodExecutor): RuntimeExecutorInfo;
 export declare function createLocalAgentExecutor(agent: Agent, executionProfile?: MethodExecutionProfile): MethodExecutor;
 export declare function resolveLocalExecutor(options?: {

package/dist/packages/{agents → engine/agents}/lib/shells.d.ts

@@ -1,7 +1,7 @@
-import type { MethodImprovementContext } from "../../compiler/lib/schema.js";
-import type { RuntimeContractType } from "../../contracts/lib/schema.js";
-import type { SourceReadinessCheck } from "../../project-model/lib/schema.js";
-import { type ContextInterfaceZoneId as MethodZoneId } from "../../method-package/context-interface.js";
+import type { MethodImprovementContext } from "../../compile/lib/schema.js";
+import type { RuntimeContractType } from "../../../contracts/lib/schema.js";
+import type { SourceReadinessCheck } from "../../../project/lib/schema.js";
+import { type ContextInterfaceZoneId as MethodZoneId } from "../../../methods/package/context-interface.js";
 export interface NativeStageDefinition {
     id: string;
     label: string;
@@ -40,7 +40,7 @@ export declare function projectCompiledQueryShell(compiledPath: string, compiled
     methodOriginSelected?: string | null;
     methodLocalDraft?: boolean;
 }): boolean;
-export declare function projectRawTestQueryShell(rootPath: string): boolean;
+export declare function projectSourceFilesTestQueryShell(rootPath: string): boolean;
 export declare function createStageExecutionShell(compiledPath: string, compiledName: string, methodId: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): {
     rootPath: string;
 };