@interf/compiler 0.18.0 → 0.21.0

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

@@ -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 [
@@ -96,7 +89,7 @@ JSON schema:
 {
   "action_type": "preparation-setup" | "preparation-change" | "compile" | "test" | "readiness-check-draft" | "method-authoring" | "method-change" | "method-improvement" | "clarification",
   "preparation": "Preparation id if applicable",
-  "method": "Method id if applicable",
+  "method": "Build Plan / Method package 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/agents/lib/shells.d.ts

@@ -1,6 +1,6 @@
 import type { MethodImprovementContext } from "../../compile/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 { RequestedArtifact, SourceProfile, SourceReadinessCheck } from "../../../project/lib/schema.js";
 import { type ContextInterfaceArtifactId as MethodArtifactId } from "../../../methods/package/context-interface.js";
 export interface NativeStageDefinition {
     id: string;
@@ -34,6 +34,8 @@ export declare function createMethodAuthoringShell(options: {
     sourceFolderPath: string;
     taskPrompt: string;
     checks: SourceReadinessCheck[];
+    requestedArtifacts?: RequestedArtifact[];
+    sourceProfile?: SourceProfile | null;
     artifactRequirements?: MethodAuthoringArtifactRequirement[];
 }): {
     rootPath: string;

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

@@ -60,12 +60,12 @@ export function renderCompiledAgents(compiledPath, name, methodId, about, option
         "## How this portable context works",
         "",
         "- The Method package defines the context interface this portable context implements on disk.",
-        "- `.interf/interf.json` records the selected source binding and back-reference to the Interf Workspace.",
+        "- `.interf/interf.json` records the selected Source binding and Preparation metadata.",
         `- Method seed: \`${methodOriginSelected}\`.`,
         ...(methodLocalDraft
             ? ["- This portable context now carries a local Method draft improved from that seed. Recompiling this portable context reuses the local `.interf/method/` package."]
             : []),
-        `- Active local Method id: \`${methodId}\`.`,
+        `- Selected Build Plan / Method package id: \`${methodId}\`.`,
         "- `.interf/method/` is the local editable Method package for this portable context.",
         `- \`.interf/method/${METHOD_SCHEMA_FILE}\` is the deterministic context interface for this portable context.`,
         "- `.interf/method/improve/` is the editable source for Method-improvement loops.",
@@ -91,7 +91,7 @@ export function renderCompiledAgents(compiledPath, name, methodId, about, option
         "",
         "```",
         "interf compile            build this portable context",
-        "interf verify               run checks against this portable context",
+        "interf test               run readiness checks against this portable context",
         "interf status             show deterministic health",
         "```",
         "",
@@ -760,6 +760,7 @@ function renderMethodAuthoringAgents(options) {
         "- replace the neutral scaffold topology with the stage graph this agent work needs",
         "- define Artifacts and checks so Interf can show whether the data is ready",
         "- satisfy every `artifact_requirements[]` entry from `runtime/authoring-context.json` when entries are present",
+        "- otherwise draft the Build Plan Artifacts from every `requested_artifacts[]` entry; do not ignore or truncate them",
         "- preserve deterministic stage and context-interface contracts",
         "- stop once the Method edits are complete",
         "",
@@ -783,8 +784,9 @@ function renderMethodAuthoringSkill() {
         `- keep \`method.json\`, \`${METHOD_SCHEMA_FILE}\`, and any changed stage docs aligned`,
         "- put deterministic validation on Artifact `checks[]`; do not add stage `acceptance` blocks",
         "- use only CheckKind values listed in `runtime/authoring-context.json`; do not invent aliases",
-        "- keep Artifact checks and the producing stage docs aligned",
+        "- keep Artifact checks aligned with produced outputs; use stage docs to describe the output contract without requiring exact source-specific phrases in the stage docs",
         "- satisfy every `artifact_requirements[]` entry from `runtime/authoring-context.json` when entries are present",
+        "- otherwise draft the Build Plan Artifacts from every `requested_artifacts[]` entry; do not ignore or truncate them",
         "- design the stage graph from the source data and preparation-and-evidence brief",
         "- use kebab-case ids everywhere: stage ids, skill_dir values, Artifact ids, reads/writes values, and package ids; never use underscores",
         "- replace the placeholder `prepare` stage unless that exact stage is truly the final method",
@@ -817,9 +819,11 @@ export function createMethodAuthoringShell(options) {
         ...(options.referenceMethodId ? { reference_method_id: options.referenceMethodId } : {}),
         task_prompt: options.taskPrompt,
         allowed_check_kinds: CHECK_KINDS,
+        requested_artifacts: options.requestedArtifacts ?? [],
         artifact_requirements: options.artifactRequirements ?? [],
         preparation: {
             source_folder_path: options.sourceFolderPath,
+            source_profile: options.sourceProfile ?? null,
             checks: {
                 count: options.checks.length,
                 questions: options.checks.map((check, index) => ({

package/dist/packages/engine/agents/role-executors.js

@@ -4,7 +4,7 @@
  * Bridges the registry layer (`AgentRecord` / `RoleMap`) to the runtime
  * layer (`MethodExecutor`). Builds a per-agent-name `MethodExecutor`
  * map up front and exposes a `resolveExecutorForRole(role)` helper that
- * the compile / verify pipelines can call per-stage.
+ * the compile / readiness-check pipelines can call per-stage.
  *
  * Falls back gracefully: when a role isn't mapped, or the mapped agent
  * is missing, we fall through to `general` and ultimately to the

package/dist/packages/engine/compile/compiled-paths.js

@@ -101,17 +101,17 @@ export function compiledRuntimeStageContractPath(compiledPath) {
     return compiledRuntimeFilePath(compiledPath, COMPILED_RUNTIME_STAGE_CONTRACT_FILE);
 }
 export function resolveSourceControlPathForCompiled(compiledPath) {
-    // Flat workspace layout: the portable context lives at
-    // `<workspace>/<preparation>/`, so the workspace root is the parent of the
-    // portable context. Reject the filesystem root (which has no parent) and the
-    // legacy `<workspace>/interf/<preparation>/` shape so stale fixtures fail loudly.
+    // Flat preparation data layout: the portable context lives at
+    // `<preparation-data-dir>/<preparation>/`, so the preparation data folder is
+    // the parent of the portable context. Reject the filesystem root and the
+    // legacy `<root>/interf/<preparation>/` shape so stale fixtures fail loudly.
     const compiledAbsolute = resolve(compiledPath);
     const parent = dirname(compiledAbsolute);
     if (parent === compiledAbsolute) {
-        throw new Error(`Portable context is not under the canonical Interf Workspace layout: ${compiledPath}`);
+        throw new Error(`Portable context is not under the canonical Interf preparation data layout: ${compiledPath}`);
     }
     if (basename(parent) === "interf") {
-        throw new Error(`Portable context is not under the canonical Interf Workspace layout: ${compiledPath}`);
+        throw new Error(`Portable context is not under the canonical Interf preparation data layout: ${compiledPath}`);
     }
     return parent;
 }

package/dist/packages/engine/connection-config.js

@@ -72,4 +72,4 @@ export function ensureInterfHome() {
 }
 /** Canonical message printed when a CLI command needs a connection but has none. */
 export const CONNECT_OR_ERROR_HINT = "Not connected to any Interf instance.\n" +
-    "Start one with `interf web`, or set --url / `interf login` for a remote one.";
+    "Start one with `interf web` or `interf web start`, or set --url / `interf login` for a remote one.";

package/dist/packages/engine/execution/lib/schema.d.ts

@@ -306,6 +306,7 @@ export declare const RunObservabilitySchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -353,6 +354,7 @@ export declare const RunObservabilitySchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -658,6 +660,7 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -705,6 +708,7 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -896,6 +900,7 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -943,6 +948,7 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -1324,6 +1330,7 @@ export declare const CompileRunSchema: z.ZodObject<{
                     "portable-context": "portable-context";
                     "preparation-config": "preparation-config";
                     "compile-run": "compile-run";
+                    "artifact-checks": "artifact-checks";
                     "readiness-checks": "readiness-checks";
                     "checks-current": "checks-current";
                 }>;
@@ -1371,6 +1378,7 @@ export declare const CompileRunSchema: z.ZodObject<{
                     "portable-context": "portable-context";
                     "preparation-config": "preparation-config";
                     "compile-run": "compile-run";
+                    "artifact-checks": "artifact-checks";
                     "readiness-checks": "readiness-checks";
                     "checks-current": "checks-current";
                 }>;
@@ -1446,6 +1454,7 @@ export declare const CompileRunSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
@@ -1493,6 +1502,7 @@ export declare const CompileRunSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;

package/dist/packages/engine/instance-paths.d.ts

@@ -1,18 +1,24 @@
 /**
- * Source of truth for every Interf path on disk in 0.13.
+ * Interf Home path helpers used by the local service.
  *
  * The instance is a black box that owns its preparation state. Storage lives
  * under `~/.interf/`. The CLI never opens these files directly — it asks the
  * API where things are and reads from the locator the API returns.
  *
+ * Current preparation config and portable-context paths live in
+ * `contracts/lib/preparation-paths.ts` and are bridged by
+ * `preparation-store.ts` for the existing compile runtime. Keep the old
+ * `config.json` / `portable-context` constants below as a migration boundary
+ * only; do not cite them as current user-visible layout.
+ *
  * Layout:
  *   ~/.interf/
  *     connection.json            ← single CLI connection record
  *     services.json              ← internal stop-lookup registry
  *     methods/<id>/              ← user-installed methods (cross-preparation)
  *     preparations/<prep-id>/    ← per-preparation state owned by the engine
- *       config.json              ← preparation config (id, source, method, …)
- *       portable-context/        ← compiled portable context output
+ *       interf.json              ← current preparation config bridge
+ *       <prep-id>/               ← current portable context output
  *         .interf/               ← per-preparation runtime/method/tests state
  *       runs/                    ← persisted run records
  *       jobs/                    ← service job runs
@@ -65,9 +71,9 @@ export declare function userMethodPackagePath(methodId: string): string;
 export declare function preparationsRoot(): string;
 /** `~/.interf/preparations/<prep-id>/` — one preparation's state dir. */
 export declare function preparationDataDir(prepId: string): PreparationDataDir;
-/** `<prep-data>/config.json` — preparation config source of truth. */
+/** Legacy planned path: `<prep-data>/config.json`. Current runtime uses `interf.json`. */
 export declare function preparationConfigPath(prepId: string): string;
-/** `<prep-data>/portable-context/` — compiled portable context output. */
+/** Legacy planned path: `<prep-data>/portable-context/`. Current runtime uses `<prep-data>/<prep-id>/`. */
 export declare function preparationPortableContextDir(prepId: string): PortableContextPath;
 /** `<prep-data>/runs/` — compile/test run records. */
 export declare function preparationRunsRoot(prepId: string): string;
@@ -88,13 +94,13 @@ export declare function portableContextRuntimeRoot(portableContext: PortableCont
 /** `<portable-context>/.interf/tests/`. */
 export declare function portableContextTestsRoot(portableContext: PortableContextPath): string;
 export type PreparationTestTargetLabel = "source-files" | "compiled";
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
 export declare function preparationTestRunsRoot(prepId: string, target: PreparationTestTargetLabel): string;
-/** `<prep-data>/portable-context/.interf/tests/latest.json`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.json`. */
 export declare function preparationLatestReadinessRunPath(prepId: string): string;
-/** `<prep-data>/portable-context/.interf/tests/latest.md`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.md`. */
 export declare function preparationLatestReadinessSummaryPath(prepId: string): string;
 /** Normalize a free-form string into a stable kebab-cased id (≤80 chars). */
 export declare function normalizePreparationTestRunId(input: string): string;
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
 export declare function preparationTestRunPath(prepId: string, target: PreparationTestTargetLabel, generatedAt: string, runId: string, runSuffix?: string | null): string;

package/dist/packages/engine/instance-paths.js

@@ -1,18 +1,24 @@
 /**
- * Source of truth for every Interf path on disk in 0.13.
+ * Interf Home path helpers used by the local service.
  *
  * The instance is a black box that owns its preparation state. Storage lives
  * under `~/.interf/`. The CLI never opens these files directly — it asks the
  * API where things are and reads from the locator the API returns.
  *
+ * Current preparation config and portable-context paths live in
+ * `contracts/lib/preparation-paths.ts` and are bridged by
+ * `preparation-store.ts` for the existing compile runtime. Keep the old
+ * `config.json` / `portable-context` constants below as a migration boundary
+ * only; do not cite them as current user-visible layout.
+ *
  * Layout:
  *   ~/.interf/
  *     connection.json            ← single CLI connection record
  *     services.json              ← internal stop-lookup registry
  *     methods/<id>/              ← user-installed methods (cross-preparation)
  *     preparations/<prep-id>/    ← per-preparation state owned by the engine
- *       config.json              ← preparation config (id, source, method, …)
- *       portable-context/        ← compiled portable context output
+ *       interf.json              ← current preparation config bridge
+ *       <prep-id>/               ← current portable context output
  *         .interf/               ← per-preparation runtime/method/tests state
  *       runs/                    ← persisted run records
  *       jobs/                    ← service job runs
@@ -90,11 +96,11 @@ export function preparationsRoot() {
 export function preparationDataDir(prepId) {
     return asPreparationDataDir(join(preparationsRoot(), prepId));
 }
-/** `<prep-data>/config.json` — preparation config source of truth. */
+/** Legacy planned path: `<prep-data>/config.json`. Current runtime uses `interf.json`. */
 export function preparationConfigPath(prepId) {
     return join(preparationDataDir(prepId), PREPARATION_CONFIG_FILENAME);
 }
-/** `<prep-data>/portable-context/` — compiled portable context output. */
+/** Legacy planned path: `<prep-data>/portable-context/`. Current runtime uses `<prep-data>/<prep-id>/`. */
 export function preparationPortableContextDir(prepId) {
     return asPortableContextPath(join(preparationDataDir(prepId), PREPARATION_PORTABLE_CONTEXT_DIR));
 }
@@ -137,15 +143,15 @@ export function portableContextRuntimeRoot(portableContext) {
 export function portableContextTestsRoot(portableContext) {
     return join(portableContextStateRoot(portableContext), PORTABLE_CONTEXT_TESTS_DIR);
 }
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
 export function preparationTestRunsRoot(prepId, target) {
     return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), target, "runs");
 }
-/** `<prep-data>/portable-context/.interf/tests/latest.json`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.json`. */
 export function preparationLatestReadinessRunPath(prepId) {
     return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), "latest.json");
 }
-/** `<prep-data>/portable-context/.interf/tests/latest.md`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.md`. */
 export function preparationLatestReadinessSummaryPath(prepId) {
     return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), "latest.md");
 }
@@ -158,7 +164,7 @@ export function normalizePreparationTestRunId(input) {
         .replace(/^-+|-+$/g, "")
         .slice(0, 80);
 }
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
 export function preparationTestRunPath(prepId, target, generatedAt, runId, runSuffix) {
     const suffix = runSuffix ? `-${normalizePreparationTestRunId(runSuffix)}` : "";
     return join(preparationTestRunsRoot(prepId, target), `${generatedAt.replace(/[:.]/g, "-")}-${runId}${suffix}.json`);