@interf/compiler 0.18.0 → 0.22.0

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

@@ -1,9 +1,9 @@
-import type { MethodExecutor } from "./agents/lib/executors.js";
+import type { AgentExecutor } 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;
 export declare function planActionProposalWithExecutor(options: {
     request: ActionProposalCreateRequest;
     context: LocalServiceActionPlanningContext;
-    executor: MethodExecutor;
+    executor: AgentExecutor;
 }): Promise<ActionProposalPlan>;

package/dist/packages/engine/action-planner.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, } from "node:fs";
 import { join } from "node:path";
-import { methodIdForSourcePreparationConfig, } from "../methods/method-resolution.js";
-import { PACKAGE_ROOT } from "../methods/package/lib/package-root.js";
+import { buildPlanIdForSourcePreparationConfig, } from "../build-plans/build-plan-resolution.js";
+import { PACKAGE_ROOT } from "../build-plans/package/lib/package-root.js";
 import { asPreparationDataDir, preparationServiceActionPlansRoot, } from "../contracts/lib/preparation-paths.js";
 import { ActionProposalPlanSchema, } from "./lib/schema.js";
 function extractJsonObject(text) {
@@ -16,17 +16,10 @@ function extractJsonObject(text) {
     }
 }
 function readActionSkill() {
-    const skillDir = join(PACKAGE_ROOT, "agent-skills", "interf-actions");
+    const skillDir = join(PACKAGE_ROOT, "public-repo", "skills", "interf");
     const skillPath = join(skillDir, "SKILL.md");
-    const cliReferencePath = join(skillDir, "references", "cli.md");
     try {
-        const skill = readFileSync(skillPath, "utf8");
-        const cliReference = readFileSync(cliReferencePath, "utf8");
-        return [
-            skill,
-            "## Bundled reference: references/cli.md",
-            cliReference,
-        ].join("\n\n");
+        return readFileSync(skillPath, "utf8");
     }
     catch {
         return [
@@ -42,7 +35,7 @@ export function buildActionPlannerPrompt(request, context, outputPath) {
         name: preparation.name,
         path: preparation.path,
         about: preparation.about ?? null,
-        method: methodIdForSourcePreparationConfig(preparation),
+        build_plan: buildPlanIdForSourcePreparationConfig(preparation),
         checks: preparation.checks?.length ?? 0,
     }));
     const recentProposals = context.recentProposals.map((proposal) => ({
@@ -94,9 +87,9 @@ ${outputPath}
 
 JSON schema:
 {
-  "action_type": "preparation-setup" | "preparation-change" | "compile" | "test" | "readiness-check-draft" | "method-authoring" | "method-change" | "method-improvement" | "clarification",
+  "action_type": "preparation-setup" | "preparation-change" | "build" | "test" | "readiness-check-draft" | "build-plan-draft" | "build-plan-change" | "build-plan-improvement" | "clarification",
   "preparation": "Preparation id if applicable",
-  "method": "Method id if applicable",
+  "build_plan": "Build Plan id if applicable",
   "values": {},
   "title": "short approval card title",
   "summary": "one sentence describing what will run",
@@ -129,7 +122,7 @@ export async function planActionProposalWithExecutor(options) {
         return ActionProposalPlanSchema.parse({
             action_type: "clarification",
             preparation: options.request.preparation,
-            assistant_message: "I can help with this Interf Workspace. Ask a question about Interf, or ask me to create a Preparation, prepare, check readiness, improve, or draft a Method and I will prepare an approval proposal.",
+            assistant_message: "I can help with this Interf instance. Ask a question about Interf, or ask me to create a Preparation, prepare, check readiness, improve, or draft a Build Plan and I will prepare an approval proposal.",
         });
     }
 }

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

@@ -1 +1 @@
-export { ActionValueIdPattern, ActionValueIdSchema, MethodAuthoringActionValuesSchema, OptionalActionValueIdSchema, PreparationSetupActionValuesSchema, SourceReadinessCheckActionValueSchema, methodAuthoringRequestFromActionValues, methodAuthoringTaskPrompt, preparationSetupRequestFromActionValues, type MethodAuthoringActionValues, type PreparationSetupActionValues, type SourceReadinessCheckActionValue, } from "./action-definitions.js";
+export { ActionValueIdPattern, ActionValueIdSchema, BuildPlanAuthoringActionValuesSchema, OptionalActionValueIdSchema, PreparationSetupActionValuesSchema, SourceReadinessCheckActionValueSchema, buildPlanAuthoringRequestFromActionValues, buildPlanAuthoringTaskPrompt, preparationSetupRequestFromActionValues, type BuildPlanAuthoringActionValues, type PreparationSetupActionValues, type SourceReadinessCheckActionValue, } from "./action-definitions.js";

package/dist/packages/engine/action-values.js

@@ -1 +1 @@
-export { ActionValueIdPattern, ActionValueIdSchema, MethodAuthoringActionValuesSchema, OptionalActionValueIdSchema, PreparationSetupActionValuesSchema, SourceReadinessCheckActionValueSchema, methodAuthoringRequestFromActionValues, methodAuthoringTaskPrompt, preparationSetupRequestFromActionValues, } from "./action-definitions.js";
+export { ActionValueIdPattern, ActionValueIdSchema, BuildPlanAuthoringActionValuesSchema, OptionalActionValueIdSchema, PreparationSetupActionValuesSchema, SourceReadinessCheckActionValueSchema, buildPlanAuthoringRequestFromActionValues, buildPlanAuthoringTaskPrompt, preparationSetupRequestFromActionValues, } from "./action-definitions.js";

package/dist/packages/engine/agents/index.d.ts

@@ -13,9 +13,9 @@ export * as executionProfile from "./lib/execution-profile.js";
 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 verifiableContextBootstrap from "./lib/verifiable-context-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";
+export type { AgentExecutionProfile, AgentExecutor, AgentExecutorKind, } from "./lib/executors.js";

package/dist/packages/engine/agents/index.js

@@ -13,7 +13,7 @@ export * as executionProfile from "./lib/execution-profile.js";
 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 verifiableContextBootstrap from "./lib/verifiable-context-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/engine/agents/lib/args.d.ts

@@ -1,4 +1,4 @@
-import type { MethodExecutionProfile } from "./executors.js";
+import type { AgentExecutionProfile } from "./executors.js";
 import type { Agent } from "./types.js";
 export declare function buildAgentEnv(agent: Agent, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function buildAgentArgs(agent: Agent, prompt: string, executionProfile?: MethodExecutionProfile): string[];
+export declare function buildAgentArgs(agent: Agent, prompt: string, executionProfile?: AgentExecutionProfile): string[];

package/dist/packages/engine/agents/lib/args.js

@@ -48,5 +48,5 @@ export function buildAgentArgs(agent, prompt, executionProfile = {}) {
         args.push(prompt);
         return args;
     }
-    throw new Error(`Agent "${agent.displayName}" is not yet supported for automated compile runs.`);
+    throw new Error(`Agent "${agent.displayName}" is not yet supported for automated Build runs.`);
 }

package/dist/packages/engine/agents/lib/constants.js

@@ -22,7 +22,7 @@ export const AGENTS = [
     },
 ];
 export const CODEX_NOISE_PATTERNS = [
-    /codex_core_skills::loader: failed to stat skills entry .*\/(interf-[^ ]+|compiled\/[^ ]+) \(symlink\): No such file or directory/,
+    /codex_core_skills::loader: failed to stat skills entry .*\/interf-[^ ]+ \(symlink\): No such file or directory/,
     /codex_core::codex: failed to load skill .*\/gstack\/SKILL\.md: invalid description: exceeds maximum length of 1024 characters/,
 ];
 export const VISIBLE_STATUS_PREFIXES = ["STATUS:", "DONE:", "BLOCKED:", "ERROR:"];

package/dist/packages/engine/agents/lib/execution-profile.d.ts

@@ -1,6 +1,6 @@
 import type { Argv } from "yargs";
 import type { Agent } from "./types.js";
-import type { MethodExecutionProfile } from "./executors.js";
+import type { AgentExecutionProfile } from "./executors.js";
 type AgentLike = Pick<Agent, "name"> | string | null | undefined;
 export declare function addExecutionProfileOptions<T extends Argv>(yargs: T): T;
 type ExecutionProfileArgSource = Record<string, unknown> & {
@@ -10,8 +10,8 @@ type ExecutionProfileArgSource = Record<string, unknown> & {
     timeoutMs?: unknown;
     "timeout-ms"?: unknown;
 };
-export declare function executionProfileFromArgv(argv: ExecutionProfileArgSource): MethodExecutionProfile;
-export declare function applyInternalAcceptanceExecutionProfileDefaults(agent: AgentLike, overrides?: MethodExecutionProfile): MethodExecutionProfile;
-export declare function hasMethodExecutionProfile(profile: MethodExecutionProfile | null | undefined): boolean;
-export declare function formatMethodExecutionProfile(profile: MethodExecutionProfile | null | undefined): string | null;
+export declare function executionProfileFromArgv(argv: ExecutionProfileArgSource): AgentExecutionProfile;
+export declare function applyInternalAcceptanceExecutionProfileDefaults(agent: AgentLike, overrides?: AgentExecutionProfile): AgentExecutionProfile;
+export declare function hasAgentExecutionProfile(profile: AgentExecutionProfile | null | undefined): boolean;
+export declare function formatAgentExecutionProfile(profile: AgentExecutionProfile | null | undefined): string | null;
 export {};

package/dist/packages/engine/agents/lib/execution-profile.js

@@ -67,14 +67,14 @@ export function applyInternalAcceptanceExecutionProfileDefaults(agent, overrides
         timeoutMs: overrides.timeoutMs ?? (defaults ? INTERNAL_ACCEPTANCE_TIMEOUT_MS : null),
     };
 }
-export function hasMethodExecutionProfile(profile) {
+export function hasAgentExecutionProfile(profile) {
     return Boolean(profile?.model ||
         profile?.profile ||
         profile?.effort ||
         profile?.timeoutMs);
 }
-export function formatMethodExecutionProfile(profile) {
-    if (!hasMethodExecutionProfile(profile))
+export function formatAgentExecutionProfile(profile) {
+    if (!hasAgentExecutionProfile(profile))
         return null;
     return JSON.stringify({
         ...(profile?.model ? { model: profile.model } : {}),

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

@@ -1,33 +1,33 @@
 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 {
+export type AgentExecutorKind = "local-agent" | "connected-provider" | "managed";
+export interface AgentExecutionProfile {
     model?: string | null;
     effort?: string | null;
     profile?: string | null;
     timeoutMs?: number | null;
 }
-export interface MethodExecuteOptions {
+export interface AgentExecuteOptions {
     eventLogPath?: string | null;
     statusLogPath?: string | null;
     completionCheck?: (() => boolean) | null;
     onStatus?: (line: string) => void;
 }
-export interface MethodExecutor {
-    kind: MethodExecutorKind;
+export interface AgentExecutor {
+    kind: AgentExecutorKind;
     name: string;
     displayName: string;
     command?: string | null;
-    executionProfile?: MethodExecutionProfile;
-    execute(rootPath: string, prompt: string, options?: MethodExecuteOptions): Promise<number>;
+    executionProfile?: AgentExecutionProfile;
+    execute(rootPath: string, prompt: string, options?: AgentExecuteOptions): Promise<number>;
 }
 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 buildRuntimeExecutorInfo(executor: AgentExecutor): RuntimeExecutorInfo;
+export declare function createLocalAgentExecutor(agent: Agent, executionProfile?: AgentExecutionProfile): AgentExecutor;
 export declare function resolveLocalExecutor(options?: {
     preflight?: boolean;
-    executionProfile?: MethodExecutionProfile;
+    executionProfile?: AgentExecutionProfile;
 }): {
-    executor: MethodExecutor | null;
+    executor: AgentExecutor | null;
     error?: string;
 };

package/dist/packages/engine/agents/lib/render.js

@@ -168,14 +168,14 @@ function summarizeToolUse(name, input) {
     const target = summarizeToolTarget(input);
     switch (name) {
         case "Read":
-            return target ? `reading ${target}` : "reading compiled files";
+            return target ? `reading ${target}` : "reading verifiable context files";
         case "Write":
-            return target ? `writing ${target}` : "writing compiled files";
+            return target ? `writing ${target}` : "writing verifiable context files";
         case "Edit":
-            return target ? `editing ${target}` : "editing compiled files";
+            return target ? `editing ${target}` : "editing verifiable context files";
         case "Glob":
         case "Grep":
-            return target ? `${name.toLowerCase()} on ${target}` : `${name.toLowerCase()}ing compiled files`;
+            return target ? `${name.toLowerCase()} on ${target}` : `${name.toLowerCase()}ing verifiable context files`;
         case "Bash":
             return target ? `running ${target}` : "running a local helper";
         default:

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

@@ -1,17 +1,17 @@
-import type { MethodImprovementContext } from "../../compile/lib/schema.js";
+import type { BuildPlanImprovementContext } from "../../build/lib/schema.js";
 import { type ArtifactPathShape, type Check, type RuntimeContractType } from "../../../contracts/lib/schema.js";
-import type { SourceReadinessCheck } from "../../../project/lib/schema.js";
-import { type ContextInterfaceArtifactId as MethodArtifactId } from "../../../methods/package/context-interface.js";
+import type { RequestedArtifact, SourceProfile, SourceReadinessCheck } from "../../../project/lib/schema.js";
+import { type ContextInterfaceArtifactId as BuildPlanArtifactId } from "../../../build-plans/package/context-interface.js";
 export interface NativeStageDefinition {
     id: string;
     label: string;
     description: string;
     contractType: RuntimeContractType;
     skillDir: string;
-    reads: MethodArtifactId[];
-    writes: MethodArtifactId[];
+    reads: BuildPlanArtifactId[];
+    writes: BuildPlanArtifactId[];
 }
-export interface MethodAuthoringArtifactRequirement {
+export interface BuildPlanAuthoringArtifactRequirement {
     id: string;
     description?: string;
     shape: ArtifactPathShape;
@@ -19,54 +19,56 @@ export interface MethodAuthoringArtifactRequirement {
     stage_hint?: string;
 }
 export declare function writeNativeAgentSurface(rootPath: string, agentsContent: string, skillName: string, skillContent: string): boolean;
-export declare function renderCompiledAgents(compiledPath: string, name: string, methodId: string, about?: string, options?: {
-    methodOriginSelected?: string | null;
-    methodLocalDraft?: boolean;
+export declare function renderVerifiableContextAgents(verifiableContextPath: string, name: string, buildPlanId: string, about?: string, options?: {
+    buildPlanOriginSelected?: string | null;
+    buildPlanLocalDraft?: boolean;
 }): string;
-export declare function renderCompiledQuerySkill(): string;
-export declare function syncStageExecutionShellWrites(compiledPath: string, shellRoot: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): void;
+export declare function renderVerifiableContextQuerySkill(): string;
+export declare function syncStageExecutionShellWrites(verifiableContextPath: string, shellRoot: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): void;
 export declare function renderClaudeBootstrap(content: string): string;
-export declare function createMethodAuthoringShell(options: {
-    methodPath: string;
-    methodId: string;
+export declare function createBuildPlanAuthoringShell(options: {
+    buildPlanPath: string;
+    buildPlanId: string;
     label: string;
-    referenceMethodId?: string | null;
+    referenceBuildPlanId?: string | null;
     sourceFolderPath: string;
     taskPrompt: string;
     checks: SourceReadinessCheck[];
-    artifactRequirements?: MethodAuthoringArtifactRequirement[];
+    requestedArtifacts?: RequestedArtifact[];
+    sourceProfile?: SourceProfile | null;
+    artifactRequirements?: BuildPlanAuthoringArtifactRequirement[];
 }): {
     rootPath: string;
-    methodBeforePath: string;
-    methodAfterPath: string;
+    buildPlanBeforePath: string;
+    buildPlanAfterPath: string;
     promptLogPath: string;
     eventLogPath: string;
     statusLogPath: string;
 };
-export declare function pruneStageExecutionShells(compiledPath: string): void;
-export declare function projectCompiledQueryShell(compiledPath: string, compiledName: string, methodId: string, about?: string, options?: {
-    methodOriginSelected?: string | null;
-    methodLocalDraft?: boolean;
+export declare function pruneStageExecutionShells(verifiableContextPath: string): void;
+export declare function projectVerifiableContextQueryShell(verifiableContextPath: string, verifiableContextName: string, buildPlanId: string, about?: string, options?: {
+    buildPlanOriginSelected?: string | null;
+    buildPlanLocalDraft?: boolean;
 }): boolean;
 export declare function projectSourceFilesTestQueryShell(rootPath: string): boolean;
-export declare function createStageExecutionShell(compiledPath: string, compiledName: string, methodId: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): {
+export declare function createStageExecutionShell(verifiableContextPath: string, verifiableContextName: string, buildPlanId: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): {
     rootPath: string;
 };
 export declare function freezeStageExecutionShell(rootPath: string): string | null;
-export declare function createMethodImprovementShell(options: {
-    compiledPath: string;
-    compiledName: string;
-    methodId: string;
+export declare function createBuildPlanImprovementShell(options: {
+    verifiableContextPath: string;
+    verifiableContextName: string;
+    buildPlanId: string;
     runId: string;
     loopIndex: number;
-    context: MethodImprovementContext;
+    context: BuildPlanImprovementContext;
 }): {
     rootPath: string;
     loopRootPath: string;
-    methodBeforePath: string;
-    methodAfterPath: string;
+    buildPlanBeforePath: string;
+    buildPlanAfterPath: string;
     promptLogPath: string;
     eventLogPath: string;
     statusLogPath: string;
 };
-export declare function freezeMethodImprovementShell(rootPath: string): string | null;
+export declare function freezeBuildPlanImprovementShell(rootPath: string): string | null;