@interf/compiler 0.7.1 → 0.7.3

package/dist/cli/commands/init.js

@@ -1,10 +1,10 @@
 import chalk from "chalk";
 import * as p from "@clack/prompts";
 import { resolve } from "node:path";
-import { detectInterf, readInterfConfig, resolveSourceControlPath, } from "../../packages/project-model/interf.js";
-import { SOURCE_FOLDER_CONFIG_FILE, syncCompiledInterfConfigFromSourceDatasetConfig, upsertSourceDatasetConfig, } from "../../packages/project-model/source-config.js";
+import { detectInterf, ensurePortableContextScaffold, readInterfConfig, resolveSourceControlPath, } from "../../packages/project-model/interf.js";
+import { SOURCE_FOLDER_CONFIG_PATH, migrateLegacySourceFolderConfig, syncCompiledInterfConfigFromSourceDatasetConfig, upsertSourceDatasetConfig, } from "../../packages/project-model/source-config.js";
 import { DEFAULT_COMPILED_NAME, describeCompileLoopSelection, promptSingleCompiledConfig, } from "./source-config-wizard.js";
-import { buildCompiledWorkflowOptions, chooseCompiledWorkflow, createWorkflowWizard, } from "./create-workflow-wizard.js";
+import { chooseOrCreateCompiledWorkflowForDataset, createWorkflowWizard, } from "./create-workflow-wizard.js";
 import { seedLocalDefaultWorkflow } from "../../packages/workflow-package/local-workflows.js";
 import { findBuiltCompiledPath, findSavedCompiledConfig, listSavedCompiledEntries, } from "./compiled-flow.js";
 import { readCurrentSavedTestComparison, } from "./test-flow.js";
@@ -47,7 +47,7 @@ function printDatasetSummary(options) {
     p.log.info(describeSavedQuestions(options.dataset));
     p.log.info(options.built ? "Portable context is available." : "Portable context has not been built yet.");
     if (options.latestComparison?.raw && options.latestComparison?.compiled) {
-        p.log.info(`Latest saved comparison: source files ${options.latestComparison.raw.passed_cases}/${options.latestComparison.raw.total_cases}, portable context for your agents ${options.latestComparison.compiled.passed_cases}/${options.latestComparison.compiled.total_cases}.`);
+        p.log.info(`Latest saved comparison: source files ${options.latestComparison.raw.passed_cases}/${options.latestComparison.raw.total_cases}, portable context ${options.latestComparison.compiled.passed_cases}/${options.latestComparison.compiled.total_cases}.`);
     }
     else if (options.latestComparison?.raw) {
         p.log.info(`Latest saved source-files run: ${options.latestComparison.raw.passed_cases}/${options.latestComparison.raw.total_cases}.`);
@@ -67,34 +67,44 @@ async function promptDatasetAction(dataset, built, latestComparison) {
     const hasSavedRawBaseline = Boolean(latestComparison?.raw);
     const latestRawPasses = latestComparison?.raw &&
         latestComparison.raw.passed_cases === latestComparison.raw.total_cases;
+    const compileOption = {
+        value: "compile",
+        label: built ? "Rebuild portable context agents can use" : "Build portable context agents can use (Recommended)",
+        hint: built
+            ? "Refresh it from the current source files"
+            : dataset.checks.length > 0
+                ? latestRawPasses
+                    ? "Build portable context agents can use for a side-by-side comparison with the latest saved source-files run"
+                    : hasSavedRawBaseline
+                        ? "Some questions still fail on the source files. Build portable context agents can use and compare it on the same questions"
+                        : "Run the selected workflow and write portable context agents can use"
+                : "Build it for agents first, then measure it",
+    };
     if (dataset.checks.length > 0) {
-        options.push({
+        const testOption = {
             value: "test",
             label: built
-                ? "Compare source files and the portable context your agents would use (Recommended)"
+                ? "Compare source files and portable context (Recommended)"
                 : hasSavedRawBaseline
                     ? "Rerun the source-files baseline"
-                    : "Measure the source-files baseline (Recommended)",
+                    : "Measure the source-files baseline",
             hint: built
                 ? "See whether the portable context helps your agents on the saved questions"
                 : hasSavedRawBaseline
                     ? "Refresh the saved source-files baseline on the current questions"
-                    : "See whether the source files are already good enough before compiling",
-        });
+                    : "Optional benchmark before Interf builds portable context",
+        };
+        if (built) {
+            options.push(testOption, compileOption);
+        }
+        else {
+            options.push(compileOption, testOption);
+        }
+    }
+    else {
+        options.push(compileOption);
     }
     options.push({
-        value: "compile",
-        label: built ? "Rebuild portable context for your agents" : "Build portable context for your agents",
-        hint: built
-            ? "Refresh it from the current source files"
-            : dataset.checks.length > 0
-                ? latestRawPasses
-                    ? "Optional: build portable context for your agents for a side-by-side comparison with the latest saved source-files run"
-                    : hasSavedRawBaseline
-                        ? "Some questions still fail on the source files. Build portable context for your agents and compare it on the same questions"
-                        : "Build portable context for your agents and compare it on the same questions"
-                : "Build it for your agents first, then measure it",
-    }, {
         value: "dataset",
         label: "Add another setup",
         hint: "Add a separate folder, focus, or question set",
@@ -127,14 +137,14 @@ function printDatasetRecommendation(dataset, built, latestComparison) {
     if (!built) {
         if (latestComparison?.raw) {
             p.log.info(latestComparison.raw.passed_cases === latestComparison.raw.total_cases
-                ? `Latest source-files run: ${latestComparison.raw.passed_cases}/${latestComparison.raw.total_cases}. Rerun the baseline if you want current numbers for a different agent set, or build portable context for your agents if you want a side-by-side comparison.`
-                : `Latest source-files run: ${latestComparison.raw.passed_cases}/${latestComparison.raw.total_cases}. Some questions still fail on the source files. Build portable context for your agents if you want Interf to prepare context for this work and compare it on the same questions.`);
+                ? `Latest source-files run: ${latestComparison.raw.passed_cases}/${latestComparison.raw.total_cases}. Build portable context agents can use if you want a side-by-side comparison.`
+                : `Latest source-files run: ${latestComparison.raw.passed_cases}/${latestComparison.raw.total_cases}. Some questions still fail on the source files. Build portable context agents can use if you want Interf to process this data and compare it on the same questions.`);
             return;
         }
-        p.log.info("Recommended first step: measure the source-files baseline before compiling.");
+        p.log.info("Recommended first step: choose a workflow and build portable context agents can use.");
         return;
     }
-    p.log.info("Recommended first step: compare the source-files baseline and the portable context your agents would use.");
+    p.log.info("Recommended first step: compare the source-files baseline and portable context.");
 }
 async function promptPostBaselineAction(rows) {
     const status = currentRunTargetStatus(rows, "raw");
@@ -155,13 +165,13 @@ async function promptPostBaselineAction(rows) {
             {
                 value: "compile",
                 label: compileRecommended
-                    ? "Build portable context for your agents (Recommended)"
-                    : "Build portable context for your agents",
+                    ? "Build portable context agents can use (Recommended)"
+                    : "Build portable context agents can use",
                 hint: compileRecommended
                     ? status === "mixed"
-                        ? "Some selected agents still failed on the source files. Build portable context for your agents and compare it on the same questions"
-                        : "Build portable context for your agents and compare it on the same questions"
-                    : "Build portable context for your agents and compare it on the same questions",
+                        ? "Some selected agents still failed on the source files. Build portable context agents can use and compare it on the same questions"
+                        : "Build portable context agents can use and compare it on the same questions"
+                    : "Build portable context agents can use and compare it on the same questions",
             },
             {
                 value: "edit",
@@ -220,29 +230,21 @@ async function chooseCompiledForWizard(options) {
     return findSavedCompiledConfig(options.sourcePath, String(selected));
 }
 async function promptCompiledSetup(options) {
-    let workflowId = options.initial?.workflow ?? "interf-default";
-    let workflowLabel = buildCompiledWorkflowOptions(options.sourcePath)
-        .find((option) => option.value === workflowId)?.label ?? workflowId;
-    if (options.introStyle === "edit") {
-        const workflowChoice = await chooseCompiledWorkflow(options.sourcePath, {
-            currentWorkflowId: workflowId,
-            message: "Which workflow should this dataset use?",
-        });
-        if (p.isCancel(workflowChoice))
-            return null;
-        workflowId = workflowChoice;
-        workflowLabel = buildCompiledWorkflowOptions(options.sourcePath)
-            .find((option) => option.value === workflowId)?.label ?? workflowId;
-    }
     const compiledConfig = await promptSingleCompiledConfig({
         projectPath: options.sourcePath,
         initial: options.initial,
         ...(options.fixedName ? { fixedName: options.fixedName } : {}),
         introStyle: options.introStyle,
-        selectedWorkflowLabel: workflowLabel,
     });
     if (!compiledConfig)
         return null;
+    const workflowChoice = await chooseOrCreateCompiledWorkflowForDataset(options.sourcePath, compiledConfig, {
+        currentWorkflowId: options.initial?.workflow ?? "interf-default",
+        executionProfile: options.executionProfile,
+    });
+    if (!workflowChoice || p.isCancel(workflowChoice))
+        return null;
+    const workflowId = String(workflowChoice);
     const compiledConfigWithWorkflow = {
         ...compiledConfig,
         workflow: workflowId,
@@ -254,12 +256,15 @@ async function promptCompiledSetup(options) {
     if (builtCompiledPath) {
         syncCompiledInterfConfigFromSourceDatasetConfig(builtCompiledPath, compiledConfigWithWorkflow);
     }
+    else {
+        ensurePortableContextScaffold(options.sourcePath, compiledConfigWithWorkflow.name, compiledConfigWithWorkflow.workflow ?? "interf-default");
+    }
     console.log();
-    console.log(chalk.green(`  ✓ Saved setup in ${SOURCE_FOLDER_CONFIG_FILE}`));
+    console.log(chalk.green(`  ✓ Saved setup in ${SOURCE_FOLDER_CONFIG_PATH}`));
     console.log(chalk.dim(`  Project folder: ${options.sourcePath}`));
     console.log(chalk.dim(`  Setup: ${compiledConfigWithWorkflow.name}`));
     console.log(chalk.dim(`  Source folder: ${compiledConfigWithWorkflow.path}`));
-    console.log(chalk.dim(`  Workflow: ${workflowLabel} · interf/workflows/${workflowId}/`));
+    console.log(chalk.dim(`  Workflow: ${workflowId} · interf/workflows/${workflowId}/`));
     console.log(chalk.dim(`  Compile mode: ${describeCompileLoopSelection({
         maxAttempts: compiledConfigWithWorkflow.max_attempts,
         maxLoops: compiledConfigWithWorkflow.max_loops,
@@ -318,6 +323,9 @@ async function runCompiledActionMenu(sourcePath, compiledConfig, options = {}) {
             if (builtCompiledPath) {
                 syncCompiledInterfConfigFromSourceDatasetConfig(builtCompiledPath, nextConfig);
             }
+            else {
+                ensurePortableContextScaffold(sourcePath, nextConfig.name, nextConfig.workflow ?? "interf-default");
+            }
             p.log.info(`Assigned workflow "${workflowId}" to dataset "${compiledConfig.name}".`);
             p.log.info("Next: run `interf compile`, then `interf test`.");
         }
@@ -408,7 +416,7 @@ async function runCompiledActionMenu(sourcePath, compiledConfig, options = {}) {
             return;
         }
         if (compileResult.testedDuringCompile) {
-            p.log.info("This compile run already checked the portable context for your agents on the saved questions.");
+            p.log.info("This compile run already checked the portable context on the saved questions.");
             p.log.info("Run `interf test` later if you want a fresh side-by-side comparison summary.");
             return;
         }
@@ -427,14 +435,14 @@ async function runCompiledActionMenu(sourcePath, compiledConfig, options = {}) {
         if (compiledConfig.checks.length === 0)
             return;
         if (compileResult.testedDuringCompile) {
-            p.log.info("This compile run already checked the portable context for your agents on the compile agent.");
+            p.log.info("This compile run already checked the portable context on the compile agent.");
         }
         const runCompiledTest = await p.confirm({
             message: compileResult.testedDuringCompile
                 ? "Run a fresh source-files versus portable-context comparison now?"
                 : builtCompiledPath
-                    ? "Run source files and the portable context your agents would use on the saved questions now?"
-                    : "Compare source files and the portable context your agents would use on the saved questions now?",
+                    ? "Run source files and portable context on the saved questions now?"
+                    : "Compare source files and portable context on the saved questions now?",
             initialValue: true,
         });
         if (p.isCancel(runCompiledTest) || !runCompiledTest)
@@ -457,17 +465,20 @@ export const initCommand = {
 };
 export async function runInitCommand() {
     p.intro(chalk.bold("Interf"));
-    p.log.info("Interf prepares portable context for your agents.");
-    p.log.info("Pick a source folder, review the suggested questions, and build when the files need more structure.");
+    p.log.info("Interf prepares data for agent work.");
+    p.log.info("Run locally, process files, show evidence that your data is ready, and write verifiable outputs as portable context for agents.");
     const cwd = process.cwd();
     const detected = detectInterf(cwd);
     const sourcePath = detected ? resolveSourceControlPath(detected.path) : cwd;
     if (detected) {
         p.log.info(`Working from the project folder: ${sourcePath}`);
     }
+    if (migrateLegacySourceFolderConfig(sourcePath)) {
+        p.log.info(`Moved saved setup to ${SOURCE_FOLDER_CONFIG_PATH}.`);
+    }
     const seeded = seedLocalDefaultWorkflow({ sourcePath });
     if (!seeded.alreadyExisted) {
-        p.log.info(`Copied built-in compilation workflow to interf/workflows/${seeded.workflowId}/ — inspect or fork it anytime.`);
+        p.log.info(`Copied built-in workflow package to interf/workflows/${seeded.workflowId}/ — inspect or fork it anytime.`);
     }
     const savedEntries = listSavedCompiledEntries(sourcePath);
     if (savedEntries.length === 0) {

package/dist/cli/commands/source-config-wizard.d.ts

@@ -48,5 +48,4 @@ export declare function promptSingleCompiledConfig(options?: {
     fixedName?: string;
     skipAboutPrompt?: boolean;
     introStyle?: "first" | "additional" | "edit";
-    selectedWorkflowLabel?: string;
 }): Promise<SourceDatasetConfig | null>;

package/dist/cli/commands/source-config-wizard.js

@@ -544,7 +544,7 @@ export async function promptCompileLoopSelection(options) {
         once: {
             value: "once",
             label: "Compile once",
-            hint: "Build portable context for your agents once with the selected workflow",
+            hint: "Build portable context agents can use once with the selected workflow",
         },
         "self-improving": {
             value: "self-improving",
@@ -651,9 +651,6 @@ export async function promptSingleCompiledConfig(options = {}) {
             p.log.info(`Dataset name: ${name}`);
         }
     }
-    if (options.selectedWorkflowLabel) {
-        p.log.info(`Workflow: ${options.selectedWorkflowLabel}`);
-    }
     let compileLoopSelection = {
         ...(typeof initial?.max_attempts === "number" ? { max_attempts: initial.max_attempts } : {}),
         ...(typeof initial?.max_loops === "number" ? { max_loops: initial.max_loops } : {}),

package/dist/cli/commands/status.js

@@ -18,7 +18,7 @@ function statusColor(status) {
 }
 export const statusCommand = {
     command: "status",
-    describe: "Show deterministic health for the portable context your agents use",
+    describe: "Show deterministic health for the portable context agents use",
     handler: async () => {
         let compiledPath = null;
         const detected = detectInterf(process.cwd());
@@ -34,7 +34,7 @@ export const statusCommand = {
             if (local.length === 0) {
                 process.exitCode = 1;
                 console.log(chalk.red("  No portable contexts found."));
-                console.log(chalk.dim("  Run `interf`, save questions, and compile portable context for your agents first."));
+                console.log(chalk.dim("  Run `interf`, save questions, and compile portable context agents can use first."));
                 return;
             }
             if (local.length === 1) {
@@ -75,7 +75,7 @@ export const statusCommand = {
             console.log();
             console.log(chalk.dim(latestComparisonState.stale
                 ? "  Saved test results are stale for the current questions. Run `interf test` again."
-                : "  No saved comparison yet. Run `interf test` to measure source files and the portable context your agents would use."));
+                : "  No saved comparison yet. Run `interf test` to measure source files and portable context."));
         }
         console.log();
         const metricOrder = [

package/dist/cli/commands/test-flow.js

@@ -3,7 +3,8 @@ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { createRawTestTarget, createCompiledTestTarget, runTargetTestsAuto, saveTargetTestRun, } from "../../packages/testing/test.js";
 import { buildTestSpecFromSourceFolderConfig, buildTestSpecFromCompiledDatasetConfig, fingerprintTruthChecks, resolveSourceDatasetPath, } from "../../packages/project-model/source-config.js";
-import { datasetLatestTestStatePath, datasetLatestTestSummaryPath, normalizeDatasetTestRunId, datasetTestRunPath, datasetTestRunsRoot, datasetTestsRoot, } from "../../packages/project-model/project-paths.js";
+import { ensurePortableContextScaffold, } from "../../packages/project-model/interf.js";
+import { datasetLatestTestStatePath, datasetLatestTestSummaryPath, normalizeDatasetTestRunId, datasetTestRunPath, datasetTestRunsRoot, } from "../../packages/project-model/project-paths.js";
 import { testRootForCompiled } from "../../packages/project-model/compiled-paths.js";
 import { readJsonFileWithSchema } from "../../packages/shared/parse.js";
 import { TestRunComparisonSchema } from "../../packages/testing/lib/schema.js";
@@ -137,7 +138,7 @@ export function printAgentTestMatrix(rows) {
     const headers = [
         "Agent",
         ...(includeRaw ? ["Source files"] : []),
-        ...(includeCompiled ? ["Context folder"] : []),
+        ...(includeCompiled ? ["Portable context"] : []),
         ...(includeDelta ? ["Delta"] : []),
     ];
     const body = rows.map((row) => [
@@ -162,7 +163,7 @@ export function printAgentTestFailures(rows) {
         const failures = [];
         for (const [label, outcome] of [
             ["Source files", row.rawOutcome ?? null],
-            ["Context folder", row.compiledOutcome ?? null],
+            ["Portable context", row.compiledOutcome ?? null],
         ]) {
             if (!outcome || outcome.result.ok)
                 continue;
@@ -232,7 +233,7 @@ export function printSavedTestComparison(rawOutcome, compiledOutcome, comparison
     if (compiledOutcome) {
         if (rawOutcome)
             console.log();
-        printSavedTestOutcome("Context folder", compiledOutcome);
+        printSavedTestOutcome("Portable context", compiledOutcome);
     }
     if (rawOutcome && compiledOutcome) {
         const rawQuestions = questionPassRate(rawOutcome);
@@ -260,7 +261,7 @@ export function printSavedTestComparisonSummary(rawOutcome, compiledOutcome, com
         console.log(`  | Source files | \`${rawOutcome.result.passedCases}/${rawOutcome.result.totalCases}\` |`);
     }
     if (compiledOutcome) {
-        console.log(`  | Context folder | \`${compiledOutcome.result.passedCases}/${compiledOutcome.result.totalCases}\` |`);
+        console.log(`  | Portable context | \`${compiledOutcome.result.passedCases}/${compiledOutcome.result.totalCases}\` |`);
     }
     if (rawOutcome && compiledOutcome) {
         const rawQuestions = questionPassRate(rawOutcome);
@@ -282,7 +283,7 @@ export function saveTestComparisonRun(options) {
         ? summarizeSavedTestOutcome("Source files", options.rawOutcome)
         : null;
     const compiledSummary = options.compiledOutcome
-        ? summarizeSavedTestOutcome("Context folder", options.compiledOutcome)
+        ? summarizeSavedTestOutcome("Portable context", options.compiledOutcome)
         : null;
     const effectiveMode = rawSummary && compiledSummary
         ? "both"
@@ -343,11 +344,12 @@ export async function runSavedRawTest(options) {
         return null;
     }
     const datasetSourcePath = resolveSourceDatasetPath(options.sourcePath, options.datasetConfig);
+    const portableContextPath = ensurePortableContextScaffold(options.sourcePath, options.datasetConfig.name, options.datasetConfig.workflow ?? "interf");
     const target = createRawTestTarget(datasetSourcePath);
     const run = await runTargetTestsAuto(datasetSourcePath, spec, [target], {
         executor,
         preserveSandboxes: options.preserveSandboxes ?? "on-failure",
-        artifactRootPath: datasetTestsRoot(options.sourcePath, options.datasetConfig.name),
+        artifactRootPath: testRootForCompiled(portableContextPath),
     });
     const result = run.results[0];
     if (!result)

package/dist/cli/commands/test.js

@@ -9,7 +9,7 @@ import { printAgentTestFailures, printAgentTestMatrix, printSavedTestComparisonS
 import { listRunAgentOptions, promptForTestAgents, resolveNamedLocalExecutor, resolveOrConfigureLocalExecutor, } from "./executor-flow.js";
 export const testCommand = {
     command: "test",
-    describe: "Compare source files and the portable context your agents would use on saved questions",
+    describe: "Compare source files and portable context on saved questions",
     builder: (yargs) => addExecutionProfileOptions(yargs)
         .option("dataset", {
         type: "string",
@@ -17,7 +17,7 @@ export const testCommand = {
     })
         .option("target", {
         choices: ["both", "raw", "compiled"],
-        describe: "Test source files, the portable context your agents would use, or both. Default: both when portable context exists, otherwise source files.",
+        describe: "Test source files, portable context, or both. Default: both when portable context exists, otherwise source files.",
     })
         .option("keep-sandboxes", {
         type: "boolean",
@@ -49,7 +49,7 @@ async function promptTestMode(hasBuiltCompiled) {
         options: [
             {
                 value: "both",
-                label: "Compare source files and the portable context your agents would use (Recommended)",
+                label: "Compare source files and portable context (Recommended)",
                 hint: "Measure whether the portable context helps your agents on the saved questions",
             },
             {
@@ -60,7 +60,7 @@ async function promptTestMode(hasBuiltCompiled) {
             {
                 value: "compiled",
                 label: "Portable context only",
-                hint: "Measure the current portable context for your agents on the saved questions",
+                hint: "Measure the current portable context on the saved questions",
             },
         ],
     });
@@ -240,13 +240,13 @@ export async function runTestCommand(argv = {}) {
         return false;
     if (selectedMode === "compiled" && !hasBuiltCompiled) {
         process.exitCode = 1;
-        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context for your agents yet.`));
+        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context agents can use yet.`));
         console.log(chalk.dim("  Run `interf compile` first."));
         return false;
     }
     if (selectedMode === "both" && !hasBuiltCompiled) {
         process.exitCode = 1;
-        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context for your agents yet, so Interf cannot compare source files and the portable context your agents would use.`));
+        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context agents can use yet, so Interf cannot compare source files and portable context.`));
         console.log(chalk.dim("  Run `interf compile` first, or rerun with `--target raw`."));
         return false;
     }
@@ -268,7 +268,7 @@ export async function runTestCommand(argv = {}) {
     })));
     if ((mode === "compiled" || mode === "both") && rows.some((row) => !row.compiledOutcome)) {
         process.exitCode = 1;
-        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context for your agents yet.`));
+        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context agents can use yet.`));
         console.log(chalk.dim("  Run `interf compile` first."));
         return false;
     }

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { createCompiled, } from "./packages/project-model/interf.js";
 export { compileCompiled, runCompiledSummarize, runCompiledCompile, } from "./packages/compiler/workflows.js";
 export { createRawTestTarget, createCompiledTestTarget, listTestSpecs, loadTestSpec, loadTestSpecFromFile, writeTestSpec, listTestTargets, runTargetTests, runTargetTestsWithJudge, runTargetTestsAuto, saveTargetTestRun, } from "./packages/testing/test.js";
 export { computeCompiledHealth, } from "./packages/compiler/state.js";
-export { SOURCE_FOLDER_CONFIG_FILE, loadSourceFolderConfig, buildTestSpecFromSourceFolderConfig, } from "./packages/project-model/source-config.js";
+export { SOURCE_FOLDER_CONFIG_FILE, SOURCE_FOLDER_CONFIG_PATH, legacySourceFolderConfigPath, loadSourceFolderConfig, migrateLegacySourceFolderConfig, resolveSourceFolderConfigPath, sourceFolderConfigPath, buildTestSpecFromSourceFolderConfig, } from "./packages/project-model/source-config.js";
 export { validateCompiledSummarize, validateCompiledCompile, } from "./packages/compiler/validate.js";
 export { InterfConfigSchema, SourceFolderConfigSchema, } from "./packages/project-model/lib/schema.js";
 export { TestSpecSchema, } from "./packages/testing/lib/schema.js";

package/dist/index.js

@@ -8,7 +8,7 @@ export { createCompiled, } from "./packages/project-model/interf.js";
 export { compileCompiled, runCompiledSummarize, runCompiledCompile, } from "./packages/compiler/workflows.js";
 export { createRawTestTarget, createCompiledTestTarget, listTestSpecs, loadTestSpec, loadTestSpecFromFile, writeTestSpec, listTestTargets, runTargetTests, runTargetTestsWithJudge, runTargetTestsAuto, saveTargetTestRun, } from "./packages/testing/test.js";
 export { computeCompiledHealth, } from "./packages/compiler/state.js";
-export { SOURCE_FOLDER_CONFIG_FILE, loadSourceFolderConfig, buildTestSpecFromSourceFolderConfig, } from "./packages/project-model/source-config.js";
+export { SOURCE_FOLDER_CONFIG_FILE, SOURCE_FOLDER_CONFIG_PATH, legacySourceFolderConfigPath, loadSourceFolderConfig, migrateLegacySourceFolderConfig, resolveSourceFolderConfigPath, sourceFolderConfigPath, buildTestSpecFromSourceFolderConfig, } from "./packages/project-model/source-config.js";
 export { validateCompiledSummarize, validateCompiledCompile, } from "./packages/compiler/validate.js";
 export { InterfConfigSchema, SourceFolderConfigSchema, } from "./packages/project-model/lib/schema.js";
 export { TestSpecSchema, } from "./packages/testing/lib/schema.js";

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

@@ -42,7 +42,7 @@ export function renderCompiledAgents(compiledPath, name, workflowId, about, opti
         `# ${name}`,
         "",
         "This is portable context built by Interf.",
-        "Technically, it is the compiled context for this dataset entry: a file-based context layer on top of the raw files, prepared for agents to navigate, retrieve evidence, and answer more reliably from the source files.",
+        "This folder gives agents prepared evidence, structure, and cross-file connections so they do not have to rediscover the full picture from source files during the job.",
         "",
         ...(about
             ? [
@@ -56,17 +56,17 @@ export function renderCompiledAgents(compiledPath, name, workflowId, about, opti
         "2. Let the workflow docs and declared output zones guide retrieval instead of assuming a fixed note layout.",
         "3. Use `raw/` when you need direct quotes, exact chart values, table lookups, or verification.",
         "",
-        "## How this compiled context works",
+        "## How this portable context works",
         "",
-        "- The workflow package defines the context interface this compiled context implements on disk.",
+        "- The workflow package defines the context interface this portable context implements on disk.",
         "- `.interf/interf.json` points to the local `raw/` snapshot via `source.path` and back to the project root via `source.control_path`.",
         `- Workflow seed: \`${workflowOriginSelected}\`.`,
         ...(workflowLocalDraft
-            ? ["- This compiled context now carries a local workflow draft improved from that seed. Recompiling this portable context reuses the local `.interf/workflow/` package."]
+            ? ["- This portable context now carries a local workflow draft improved from that seed. Recompiling this portable context reuses the local `.interf/workflow/` package."]
             : []),
         `- Active local workflow id: \`${workflowId}\`.`,
-        "- `.interf/workflow/` is the local editable method package for this compiled context.",
-        `- \`.interf/workflow/${WORKFLOW_SCHEMA_FILE}\` is the deterministic context interface for this compiled context.`,
+        "- `.interf/workflow/` is the local editable method package for this portable context.",
+        `- \`.interf/workflow/${WORKFLOW_SCHEMA_FILE}\` is the deterministic context interface for this portable context.`,
         "- `.interf/workflow/improve/` is the editable source for workflow-improvement loops.",
         "- `.interf/workflow/use/query/` is the editable source for the generated native query shell.",
         "- `.interf/workflow/compile/stages/` defines stage-specific docs that Interf projects into native execution shells for automated runs.",
@@ -83,7 +83,7 @@ export function renderCompiledAgents(compiledPath, name, workflowId, about, opti
         "- Prefer the workflow-declared context outputs before `raw/`.",
         "- Use the generated native `interf-query` skill for manual querying. The editable source lives at `.interf/workflow/use/query/SKILL.md`.",
         "- Treat `.interf/` as method/runtime metadata, not answer evidence, unless explicitly asked to inspect workflow or test history.",
-        "- Use `raw/` for quotes, verification, ambiguity, or evidence the compiled context does not expose well.",
+        "- Use `raw/` for quotes, verification, ambiguity, or evidence the portable context does not expose well.",
         "- If exact chart, table, or image-derived evidence matters, inspect the raw source and say whether the answer was text-derived, table-derived, or chart-derived.",
         "",
         "## Commands",
@@ -92,14 +92,14 @@ export function renderCompiledAgents(compiledPath, name, workflowId, about, opti
         "interf compile            build this portable context",
         "interf test               run checks against this portable context",
         "interf verify stage <id>  verify one workflow stage",
-        "interf verify compiled    verify the full compiled context output",
+        "interf verify compiled    verify the full portable context output",
         "interf status             show deterministic health",
         "```",
         "",
         "## Rules",
         "",
         "- Do not modify files under `raw/`.",
-        "- Treat compiled notes as working context artifacts, not final truth.",
+        "- Treat prepared notes as working context, not final truth.",
         "- When confidence is low, verify against `raw/` before answering strongly.",
         "",
     ].join("\n");
@@ -113,15 +113,15 @@ export function renderCompiledQuerySkill() {
         "Default loop:",
         "1. Read `workflow/README.md` and this file first.",
         `2. Use the workflow zones declared in \`workflow/${WORKFLOW_SCHEMA_FILE}\` before falling back to \`raw/\`.`,
-        "3. Use `raw/` for direct quotes, verification, exact lookups, and cases where the compiled context is missing the needed evidence or is ambiguous.",
+        "3. Use `raw/` for direct quotes, verification, exact lookups, and cases where the portable context is missing the needed evidence or is ambiguous.",
         "",
         "Answering rule:",
         "- do not modify files under `raw/`",
-        "- treat the workflow as the method layer and the compiled zones as the working retrieval surface",
+        "- treat the workflow as the method layer and the portable-context zones as the working retrieval surface",
         "- say explicitly when an answer depends on approximation, bounded inference, or a raw-source re-check",
-        "- use `raw/` to confirm source page, metric family, provenance, or exact wording when the compiled context is missing the needed evidence or is ambiguous",
+        "- use `raw/` to confirm source page, metric family, provenance, or exact wording when the portable context is missing the needed evidence or is ambiguous",
         "- do not invent navigation or note structure beyond what this workflow declares",
-        "- when the compiled context is insufficient, verify in `raw/` and then answer",
+        "- when the portable context is insufficient, verify in `raw/` and then answer",
         "",
         "You can edit this file to bias manual question-answering behavior for this portable context.",
         "",
@@ -398,14 +398,13 @@ function renderCompiledQueryNativeSkill(querySkillContent) {
         "---",
         "name: interf-query",
         "description: >",
-        "  Native local query skill for this portable context built by Interf",
-        "  Compiler. Use it for manual questions against the compiled context",
-        "  and its raw fallback.",
+        "  Native local query skill for this portable context built by Interf.",
+        "  Use it for manual questions against the portable context and raw fallback.",
         "---",
         "",
         "# Interf Query",
         "",
-        "This is the native local query skill for a compiled context built by Interf.",
+        "This is the native local query skill for portable context built by Interf.",
         "Use it when reading this portable context manually.",
         "Editable source: `.interf/workflow/use/query/SKILL.md`.",
         "",
@@ -667,7 +666,7 @@ function renderWorkflowAuthoringAgents(options) {
         `# ${options.label} — Workflow Authoring Shell`,
         "",
         "This is an automated workflow-authoring shell generated by Interf.",
-        "It exists to create or refine one standalone workflow for the files and checks in this task.",
+        "It exists to create or refine one standalone workflow from the source data, desired portable-context outputs, and proof requirements in this task.",
         "",
         "## Start Here",
         "",
@@ -683,12 +682,14 @@ function renderWorkflowAuthoringAgents(options) {
         "- Edit only files under `workflow/`.",
         "- Do not edit raw files or preview artifacts.",
         "- Keep the workflow valid for the current compiler API and workflow schema.",
+        "- For acceptance rules, use `zone_counts_at_least` for numeric fixed minimums and `zone_counts_at_least_counts` only for runtime count-key strings such as `source_total`.",
         "- Prefer direct file-reading and search tools over shell commands for routine file inspection.",
         "- Do not use shell helpers like `cat`, `sed`, `ls`, or `find` when a native read/search tool can inspect the same files.",
         "",
         "## Goal",
         "",
-        "- produce one standalone workflow tuned to the files and checks in this task",
+        "- produce one standalone workflow tuned to the source data, desired outputs, and checks in this task",
+        "- define output zones and stage proof so Interf can show whether the data is ready",
         "- preserve deterministic stage and context-interface contracts",
         "- stop once the workflow edits are complete",
         "",
@@ -710,6 +711,7 @@ function renderWorkflowAuthoringSkill() {
         "Rules:",
         "- edit only `workflow/`",
         `- keep \`workflow.json\`, \`${WORKFLOW_SCHEMA_FILE}\`, and any changed stage docs aligned`,
+        "- use `zone_counts_at_least` for numeric fixed minimums; use `zone_counts_at_least_counts` only for runtime count-key strings such as `source_total`",
         "- prefer small, defensible package edits over random churn",
         "- keep the package standalone; do not introduce runtime inheritance or fallback assumptions",
         "- do not introduce wikilinks unless the workflow also creates the target note by exact basename or explicit relative path",
@@ -852,6 +854,7 @@ function renderWorkflowImprovementAgents(compiledName, workflowId, loopIndex) {
         "- Do not edit checks, test specs, raw files, or generated context outputs.",
         "- Review context outputs under `artifacts/compiled-view/` and test/runtime evidence under `artifacts/`.",
         "- Keep the workflow valid for the current compiler API and workflow schema.",
+        "- For acceptance rules, use `zone_counts_at_least` for numeric fixed minimums and `zone_counts_at_least_counts` only for runtime count-key strings such as `source_total`.",
         "",
         "## Goal",
         "",

package/dist/packages/compiler/compiled-paths.js

@@ -98,7 +98,7 @@ export function resolveSourceControlPathForCompiled(compiledPath) {
             break;
         cursor = parent;
     }
-    throw new Error(`Context folder is not under the canonical project layout: ${compiledPath}`);
+    throw new Error(`Compiled context is not under the canonical project layout: ${compiledPath}`);
 }
 export function defaultControlPathForCompiled(compiledPath) {
     const relativePath = relative(compiledPath, resolveSourceControlPathForCompiled(compiledPath));

package/dist/packages/compiler/runtime-prompt.js

@@ -28,7 +28,7 @@ export function buildStagePrompt(instructions, contractPath, statusLines) {
         "Prefer direct file-reading and search tools over shell commands when you inspect inputs, docs, or generated outputs.",
         "Do not use shell helpers like `cat`, `sed`, `ls`, or `find` for routine file inspection if a native read/search tool can do the same job.",
         "If the contract lists `instructions.local_docs`, open every one of those files before you write artifacts or declare the stage complete.",
-        "If `AGENTS.md` is listed in the contract, use it only for context-folder routing that is directly relevant to this stage.",
+        "If `AGENTS.md` is listed in the contract, use it only for portable-context routing that is directly relevant to this stage.",
         "`.interf/runtime/run.json`, `.interf/runtime/state.json`, `.interf/runtime/health.json`, and `.interf/runtime/view-spec.json` are runtime artifacts written by Interf. You may read them, but do not create, edit, or replace them unless the contract explicitly marks a different proof artifact as stage-owned.",
         "If a contract-listed output file does not exist yet, create it in one whole-file write. Do not attempt patch-style edits against a missing runtime path.",
         "Stay inside the current compiled context. Do not try to open repo docs, repo source files, or other paths outside the compiled context unless the stage contract explicitly requires them.",