@interf/compiler 0.2.5 → 0.3.0

package/dist/lib/{workflows-kb.js → workspace-compile.js}

@@ -1,32 +1,30 @@
 import { join } from "node:path";
 import { countFilesRecursive } from "./filesystem.js";
-import { readInterfConfig, refreshWorkspaceBootstrapGuidance, resolveKnowledgeBaseSourcePath, } from "./interf.js";
+import { readInterfConfig, refreshWorkspaceBootstrapGuidance, resolveSourceFolderPath, } from "./interf.js";
 import { buildSummarizePlan, writeSummarizePlan } from "./summarize-plan.js";
-import { reconcileKnowledgeBaseCompileRun, reconcileKnowledgeBaseSummarizeRun, } from "./runtime-reconcile.js";
-import { loadState, refreshKnowledgeBaseArtifacts, } from "./state.js";
-import { buildKnowledgeBaseSummarizeContract, validateStageContractAcceptance, } from "./runtime.js";
+import { reconcileWorkspaceCompileRun, reconcileWorkspaceSummarizeRun, } from "./runtime-reconcile.js";
+import { loadState, refreshWorkspaceArtifacts, } from "./state.js";
+import { buildWorkspaceSummarizeContract, validateStageContractAcceptance, } from "./runtime.js";
 import { readJsonFileUnchecked } from "./parse.js";
-import { formatKnowledgeBaseWorkflowStageStep, getKnowledgeBaseWorkflow, getWorkflowStagePolicyNotes, resolveKnowledgeBaseWorkflowFromConfig, } from "./workflow-definitions.js";
-import { validateKnowledgeBaseSummarize, validateKnowledgeBaseCompile, } from "./validate.js";
-import { reportLine, reportBlankLine, reportValidationFailure, buildLocalSkillContractExtension, buildStageInstructions, bundledSkillForContractType, resolveStageAcceptance, workflowCompileStageDirectory, } from "./workflow-helpers.js";
+import { formatWorkspaceWorkflowStageStep, getWorkflowStagePolicyNotes, getWorkspaceWorkflow, resolveWorkspaceWorkflowFromConfig, } from "./workflow-definitions.js";
+import { validateWorkspaceSummarize, validateWorkspaceCompile, } from "./validate.js";
+import { reportBlankLine, reportLine, reportValidationFailure, buildLocalSkillContractExtension, buildStageInstructions, bundledSkillForContractType, resolveStageAcceptance, workflowCompileStageDirectory, } from "./workflow-helpers.js";
 import { executeValidatedStage, executeValidatedSummarizeStage, findStageByContractType, } from "./workflow-stage-runner.js";
-// ---------------------------------------------------------------------------
-// KB-specific helpers
-// ---------------------------------------------------------------------------
-export function resolveKnowledgeBaseContext(knowledgeBasePath) {
-    const config = readInterfConfig(knowledgeBasePath);
-    const workflowId = resolveKnowledgeBaseWorkflowFromConfig(config);
+export function resolveWorkspaceContext(workspacePath) {
+    const config = readInterfConfig(workspacePath);
+    const workflowId = resolveWorkspaceWorkflowFromConfig(config);
     return {
-        knowledgeBaseName: config?.name ?? "knowledge-base",
-        sourcePath: resolveKnowledgeBaseSourcePath(knowledgeBasePath, config),
+        workspaceName: config?.name ?? "workspace",
+        sourcePath: resolveSourceFolderPath(workspacePath, config),
         workflowId,
     };
 }
-export function knowledgeBaseExecutionStages(workflowId, knowledgeBasePath) {
-    return getKnowledgeBaseWorkflow(workflowId, { workspacePath: knowledgeBasePath }).stages;
+export function workspaceExecutionStages(workflowId, workspacePath) {
+    return getWorkspaceWorkflow(workflowId, { sourcePath: resolveSourceFolderPath(workspacePath) })
+        .stages;
 }
-function readKnowledgeBaseInventoryTotal(knowledgeBasePath) {
-    const inventory = readJsonFileUnchecked(join(knowledgeBasePath, ".interf", "inventory.json"), "knowledge-base inventory");
+function readWorkspaceInventoryTotal(workspacePath) {
+    const inventory = readJsonFileUnchecked(join(workspacePath, ".interf", "inventory.json"), "workspace inventory");
     if (!inventory)
         return 0;
     if (typeof inventory.total === "number")
@@ -39,13 +37,15 @@ function readKnowledgeBaseInventoryTotal(knowledgeBasePath) {
         return inventory.summaries.length;
     if (Array.isArray(inventory.files))
         return inventory.files.length;
+    if (Array.isArray(inventory.items))
+        return inventory.items.length;
     return 0;
 }
-function isKnowledgeBaseSummarizeStageComplete(knowledgeBasePath, expectedSummaryTotal) {
-    const validation = validateKnowledgeBaseSummarize(knowledgeBasePath);
-    const acceptance = validateStageContractAcceptance(knowledgeBasePath);
-    const state = loadState(knowledgeBasePath);
-    const inventoryTotal = readKnowledgeBaseInventoryTotal(knowledgeBasePath);
+function isWorkspaceSummarizeStageComplete(workspacePath, expectedSummaryTotal) {
+    const validation = validateWorkspaceSummarize(workspacePath);
+    const acceptance = validateStageContractAcceptance(workspacePath);
+    const state = loadState(workspacePath);
+    const inventoryTotal = readWorkspaceInventoryTotal(workspacePath);
     return Boolean(validation.ok &&
         acceptance.ok &&
         state?.inventory_complete === true &&
@@ -54,13 +54,10 @@ function isKnowledgeBaseSummarizeStageComplete(knowledgeBasePath, expectedSummar
         (state.summarized ?? 0) >= expectedSummaryTotal &&
         inventoryTotal >= expectedSummaryTotal);
 }
-// ---------------------------------------------------------------------------
-// KB compile contract builder
-// ---------------------------------------------------------------------------
-export function buildKnowledgeBaseCompileContract(knowledgeBasePath, workflowId, summaryCount, instructions, stageId = "compile", stageSkillDir = "compile") {
-    const sourcePath = resolveKnowledgeBaseSourcePath(knowledgeBasePath);
-    const acceptance = resolveStageAcceptance("knowledge-base", workflowId, stageId, sourcePath, knowledgeBasePath);
-    const localSkills = buildLocalSkillContractExtension(knowledgeBasePath, [workflowCompileStageDirectory(stageSkillDir)], "Use them to refine knowledge-base compile behavior, entity/claim extraction, and retrieval structure.");
+export function buildWorkspaceCompileContract(workspacePath, workflowId, summaryCount, instructions, stageId = "compile", stageSkillDir = "compile") {
+    const sourcePath = resolveSourceFolderPath(workspacePath);
+    const acceptance = resolveStageAcceptance(workflowId, stageId, sourcePath);
+    const localSkills = buildLocalSkillContractExtension(workspacePath, [workflowCompileStageDirectory(stageSkillDir)], "Use them to refine workspace compile behavior, entity extraction, claim extraction, and retrieval structure.");
     return {
         instructions,
         counts: {
@@ -91,20 +88,20 @@ export function buildKnowledgeBaseCompileContract(knowledgeBasePath, workflowId,
             notes: [
                 "Build or refresh `.interf/inventory.json` first, then use it as the progress ledger for the rest of the run.",
                 "Prefer the current inventory runtime shape: `.interf/inventory.json` should use `entries` plus `total`, and each entry should carry `source`, `summary`, `frontmatter_scanned: true`, and the abstract/overview-read proof needed for compile verification.",
-                "This stage is the knowledge-base compile pass. Treat synthesis outputs as evidence objects, not final truth.",
+                "This stage is the cross-file workspace compile pass. Treat synthesis outputs as working retrieval artifacts, not final truth.",
                 "Use a multi-pass approach: inventory -> local evidence reading -> canonicalization -> retrieval optimization.",
-                "Build retrieval-oriented outputs: canonical entities, cross-file claims, timelines, themes, and navigation indexes that make interface retrieval easier later.",
+                "Build retrieval-oriented outputs: canonical entities, cross-file claims, timelines, themes, and navigation indexes.",
                 "Write structured knowledge outputs under `knowledge/entities/`, `knowledge/claims/`, and `knowledge/indexes/`.",
-                "Do not collapse the knowledge-base knowledge layer into flat files like `knowledge/entities.md` or `knowledge/claims.md`.",
+                "Do not collapse the knowledge layer into flat files like `knowledge/entities.md` or `knowledge/claims.md`.",
                 "Do not start compile by deleting prior outputs with `rm`, wildcard cleanup, `;`, or `&&` chains. Rewrite the required files directly and remove stale artifacts only with narrow, explicit path writes when truly needed.",
                 ...(summaryCount <= 3
                     ? [
                         `This run has ${summaryCount} summary file${summaryCount === 1 ? "" : "s"}. Treat it as a tiny compile: read every summary overview, write the smallest truthful substrate immediately, then stop.`,
-                        "For a tiny compile, do not spend time designing a broad ontology or rereading the same evidence loop. A compact landing layer plus a small grounded retrieval surface is enough.",
+                        "For a tiny compile, do not spend time designing a broad ontology or rereading the same evidence loop.",
                         "For a tiny compile, finish as soon as `home.md`, the stable core indexes, and at least one grounded entity or claim note exist together with a valid inventory.",
                     ]
                     : []),
-                ...getWorkflowStagePolicyNotes("knowledge-base", workflowId, stageId, sourcePath, knowledgeBasePath),
+                ...getWorkflowStagePolicyNotes(workflowId, stageId, sourcePath),
                 ...localSkills.notes,
             ],
             evidence_weighting: {
@@ -118,28 +115,25 @@ export function buildKnowledgeBaseCompileContract(knowledgeBasePath, workflowId,
         },
     };
 }
-// ---------------------------------------------------------------------------
-// KB orchestration functions
-// ---------------------------------------------------------------------------
-export async function runKnowledgeBaseSummarize(options) {
-    const context = resolveKnowledgeBaseContext(options.knowledgeBasePath);
+export async function runWorkspaceSummarize(options) {
+    const context = resolveWorkspaceContext(options.workspacePath);
     const sourcePath = options.sourcePath ?? context.sourcePath;
     const workflowId = context.workflowId;
-    const stageDefinition = options.stageDefinition ?? findStageByContractType(knowledgeBaseExecutionStages(workflowId, options.knowledgeBasePath), "kb-file-evidence");
+    const stageDefinition = options.stageDefinition ?? findStageByContractType(workspaceExecutionStages(workflowId, options.workspacePath), "workspace-file-evidence");
     const stageStatusLabel = stageDefinition.label.toLowerCase();
-    const plan = buildSummarizePlan(sourcePath, options.knowledgeBasePath, options.fullPass ? "all" : "pending");
+    const plan = buildSummarizePlan(sourcePath, options.workspacePath, options.fullPass ? "all" : "pending");
     const expectedSummaryTotal = plan.summaryCount + plan.targetCount;
-    const planPath = writeSummarizePlan(options.knowledgeBasePath, plan);
-    const localSkills = buildLocalSkillContractExtension(options.knowledgeBasePath, [workflowCompileStageDirectory(stageDefinition.skillDir)], "Use them to refine summary structure, evidence grouping, and summarization heuristics.");
+    const planPath = writeSummarizePlan(options.workspacePath, plan);
+    const localSkills = buildLocalSkillContractExtension(options.workspacePath, [workflowCompileStageDirectory(stageDefinition.skillDir)], "Use them to refine summary structure, evidence grouping, and summarization heuristics.");
     const instructions = buildStageInstructions(bundledSkillForContractType(stageDefinition.contractType), localSkills);
     if (options.reportSummary !== false) {
         reportLine(options.reporter, `${plan.sourceCount} source files, ${plan.summaryCount} summarized, ${plan.targetCount} to summarize`);
     }
     if (plan.targetCount === 0) {
-        refreshKnowledgeBaseArtifacts(options.knowledgeBasePath, { ensureViewSpec: true });
-        const validation = validateKnowledgeBaseSummarize(options.knowledgeBasePath);
+        refreshWorkspaceArtifacts(options.workspacePath, { ensureViewSpec: true });
+        const validation = validateWorkspaceSummarize(options.workspacePath);
         if (options.reportStep !== false) {
-            reportLine(options.reporter, `${formatKnowledgeBaseWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })} skipped (no work required)`);
+            reportLine(options.reporter, `${formatWorkspaceWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })} skipped (no work required)`);
         }
         if (!validation.ok) {
             reportValidationFailure(options.reporter, validation.summary);
@@ -152,28 +146,27 @@ export async function runKnowledgeBaseSummarize(options) {
         };
     }
     if (options.reportStep !== false) {
-        reportLine(options.reporter, `${formatKnowledgeBaseWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })} (${plan.targetCount} files)`);
+        reportLine(options.reporter, `${formatWorkspaceWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })} (${plan.targetCount} files)`);
     }
     const stageResult = await executeValidatedSummarizeStage({
         executor: options.executor,
-        workspacePath: options.knowledgeBasePath,
-        targetType: "knowledge-base",
-        targetName: context.knowledgeBaseName,
+        workspacePath: options.workspacePath,
+        targetName: context.workspaceName,
         workflow: workflowId,
         workflowSourcePath: sourcePath,
         stageDefinition,
         instructions,
         summary: `Preparing ${stageDefinition.label.toLowerCase()} for ${plan.targetCount} source files.`,
-        contract: buildKnowledgeBaseSummarizeContract({
-            knowledgeBaseName: context.knowledgeBaseName,
+        contract: buildWorkspaceSummarizeContract({
+            workspaceName: context.workspaceName,
             targetCount: plan.targetCount,
             expectedSummaryTotal,
             sourcePath,
             planPath,
-            workflowNotes: getWorkflowStagePolicyNotes("knowledge-base", workflowId, stageDefinition.id, sourcePath, options.knowledgeBasePath),
+            workflowNotes: getWorkflowStagePolicyNotes(workflowId, stageDefinition.id, sourcePath),
             localSkillDocs: localSkills.reads,
             instructions,
-            acceptance: resolveStageAcceptance("knowledge-base", workflowId, stageDefinition.id, sourcePath, options.knowledgeBasePath),
+            acceptance: resolveStageAcceptance(workflowId, stageDefinition.id, sourcePath),
         }),
         statusLines: [
             `Emit exactly one startup line: STATUS: loaded ${stageStatusLabel} plan ${plan.targetCount} files.`,
@@ -183,10 +176,10 @@ export async function runKnowledgeBaseSummarize(options) {
             `Emit DONE: ${stageStatusLabel} complete ${plan.targetCount}/${plan.targetCount} when finished.`,
         ],
         reporter: options.reporter,
-        completionCheck: () => isKnowledgeBaseSummarizeStageComplete(options.knowledgeBasePath, expectedSummaryTotal),
-        reconcile: () => reconcileKnowledgeBaseSummarizeRun(options.knowledgeBasePath, expectedSummaryTotal),
-        refreshArtifacts: () => refreshKnowledgeBaseArtifacts(options.knowledgeBasePath, { ensureViewSpec: true }),
-        validate: () => validateKnowledgeBaseSummarize(options.knowledgeBasePath),
+        completionCheck: () => isWorkspaceSummarizeStageComplete(options.workspacePath, expectedSummaryTotal),
+        reconcile: () => reconcileWorkspaceSummarizeRun(options.workspacePath, expectedSummaryTotal),
+        refreshArtifacts: () => refreshWorkspaceArtifacts(options.workspacePath, { ensureViewSpec: true }),
+        validate: () => validateWorkspaceSummarize(options.workspacePath),
         startingSummaryCount: plan.summaryCount,
         targetCount: plan.targetCount,
     });
@@ -205,30 +198,29 @@ export async function runKnowledgeBaseSummarize(options) {
         plan,
     };
 }
-export async function runKnowledgeBaseCompile(options) {
-    const knowledgeBaseConfig = readInterfConfig(options.knowledgeBasePath);
-    const knowledgeBaseName = knowledgeBaseConfig?.name ?? "knowledge-base";
-    const workflowId = resolveKnowledgeBaseWorkflowFromConfig(knowledgeBaseConfig);
-    const sourcePath = options.sourcePath ?? resolveKnowledgeBaseSourcePath(options.knowledgeBasePath, knowledgeBaseConfig);
-    const stageDefinition = options.stageDefinition ?? findStageByContractType(knowledgeBaseExecutionStages(workflowId, options.knowledgeBasePath), "kb-knowledge-layer");
+export async function runWorkspaceCompile(options) {
+    const workspaceConfig = readInterfConfig(options.workspacePath);
+    const workspaceName = workspaceConfig?.name ?? "workspace";
+    const workflowId = resolveWorkspaceWorkflowFromConfig(workspaceConfig);
+    const sourcePath = options.sourcePath ?? resolveSourceFolderPath(options.workspacePath, workspaceConfig);
+    const stageDefinition = options.stageDefinition ?? findStageByContractType(workspaceExecutionStages(workflowId, options.workspacePath), "workspace-knowledge-layer");
     const stageStatusLabel = stageDefinition.label.toLowerCase();
-    const summaryCount = countFilesRecursive(join(options.knowledgeBasePath, "summaries"));
+    const summaryCount = countFilesRecursive(join(options.workspacePath, "summaries"));
     if (options.reportStep !== false) {
         reportBlankLine(options.reporter);
-        reportLine(options.reporter, `${formatKnowledgeBaseWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })} (building graph)`);
+        reportLine(options.reporter, `${formatWorkspaceWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })} (building knowledge layer)`);
     }
-    const instructions = buildStageInstructions(bundledSkillForContractType(stageDefinition.contractType), buildLocalSkillContractExtension(options.knowledgeBasePath, [workflowCompileStageDirectory(stageDefinition.skillDir)], "Use them to refine knowledge-base compile behavior, entity/claim extraction, and retrieval structure."));
+    const instructions = buildStageInstructions(bundledSkillForContractType(stageDefinition.contractType), buildLocalSkillContractExtension(options.workspacePath, [workflowCompileStageDirectory(stageDefinition.skillDir)], "Use them to refine workspace compile behavior, entity extraction, claim extraction, and retrieval structure."));
     return executeValidatedStage({
         executor: options.executor,
-        workspacePath: options.knowledgeBasePath,
-        targetType: "knowledge-base",
-        targetName: knowledgeBaseName,
+        workspacePath: options.workspacePath,
+        targetName: workspaceName,
         workflow: workflowId,
         workflowSourcePath: sourcePath,
         stageDefinition,
         instructions,
         summary: `Preparing ${stageDefinition.label.toLowerCase()} for ${summaryCount} summary files.`,
-        contract: buildKnowledgeBaseCompileContract(options.knowledgeBasePath, workflowId, summaryCount, instructions, stageDefinition.id, stageDefinition.skillDir),
+        contract: buildWorkspaceCompileContract(options.workspacePath, workflowId, summaryCount, instructions, stageDefinition.id, stageDefinition.skillDir),
         statusLines: [
             `Emit exactly one startup line: STATUS: loaded ${stageStatusLabel} plan ${summaryCount} summary files.`,
             `Emit STATUS: inventoried summaries ${summaryCount}/${summaryCount} after the inventory pass completes.`,
@@ -237,30 +229,30 @@ export async function runKnowledgeBaseCompile(options) {
             `Emit DONE: ${stageStatusLabel} complete ${summaryCount}/${summaryCount} when the required outputs are on disk.`,
         ],
         reporter: options.reporter,
-        completionCheck: () => validateKnowledgeBaseCompile(options.knowledgeBasePath).ok &&
-            validateStageContractAcceptance(options.knowledgeBasePath).ok,
-        reconcile: () => reconcileKnowledgeBaseCompileRun(options.knowledgeBasePath),
-        refreshArtifacts: () => refreshKnowledgeBaseArtifacts(options.knowledgeBasePath, { ensureViewSpec: true }),
-        validate: () => validateKnowledgeBaseCompile(options.knowledgeBasePath),
+        completionCheck: () => validateWorkspaceCompile(options.workspacePath).ok &&
+            validateStageContractAcceptance(options.workspacePath).ok,
+        reconcile: () => reconcileWorkspaceCompileRun(options.workspacePath),
+        refreshArtifacts: () => refreshWorkspaceArtifacts(options.workspacePath, { ensureViewSpec: true }),
+        validate: () => validateWorkspaceCompile(options.workspacePath),
     });
 }
-export async function compileKnowledgeBase(options) {
-    refreshWorkspaceBootstrapGuidance(options.knowledgeBasePath);
-    const { sourcePath, workflowId } = resolveKnowledgeBaseContext(options.knowledgeBasePath);
-    const stages = knowledgeBaseExecutionStages(workflowId, options.knowledgeBasePath);
+export async function compileWorkspace(options) {
+    refreshWorkspaceBootstrapGuidance(options.workspacePath);
+    const { sourcePath, workflowId } = resolveWorkspaceContext(options.workspacePath);
+    const stages = workspaceExecutionStages(workflowId, options.workspacePath);
     let summarize = {
         ok: true,
         code: 0,
         skipped: true,
-        plan: buildSummarizePlan(sourcePath, options.knowledgeBasePath),
+        plan: buildSummarizePlan(sourcePath, options.workspacePath),
     };
     let compile = null;
     let evidencePassCount = 0;
     for (const stageDefinition of stages) {
-        if (stageDefinition.contractType === "kb-file-evidence") {
-            summarize = await runKnowledgeBaseSummarize({
+        if (stageDefinition.contractType === "workspace-file-evidence") {
+            summarize = await runWorkspaceSummarize({
                 executor: options.executor,
-                knowledgeBasePath: options.knowledgeBasePath,
+                workspacePath: options.workspacePath,
                 sourcePath,
                 reporter: options.reporter,
                 reportSummary: evidencePassCount === 0,
@@ -279,9 +271,9 @@ export async function compileKnowledgeBase(options) {
             }
             continue;
         }
-        compile = await runKnowledgeBaseCompile({
+        compile = await runWorkspaceCompile({
             executor: options.executor,
-            knowledgeBasePath: options.knowledgeBasePath,
+            workspacePath: options.workspacePath,
             sourcePath,
             reporter: options.reporter,
             reportStep: true,
@@ -303,4 +295,4 @@ export async function compileKnowledgeBase(options) {
         failedStage: null,
     };
 }
-//# sourceMappingURL=workflows-kb.js.map
+//# sourceMappingURL=workspace-compile.js.map

package/dist/lib/workspace-compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-compile.js","sourceRoot":"","sources":["../../src/lib/workspace-compile.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@interf/compiler",
-  "version": "0.2.5",
-  "description": "Knowledge compiler that prepares local folders for agent use and lets you test the result on your evals.",
+  "version": "0.3.0",
+  "description": "Open-source knowledge compiler that measures local-agent accuracy on your files and builds compiled workspaces on top of them.",
   "type": "module",
   "bin": {
     "interf": "dist/bin.js"
@@ -26,9 +26,9 @@
     "test:e2e": "npm run test:acceptance-live",
     "test:e2e:claude": "npm run test:acceptance-live -- --agent claude-code",
     "test:e2e:codex": "npm run test:acceptance-live -- --agent codex",
-    "test:e2e:quick": "npm run test:acceptance-quick:create-interface && npm run test:acceptance-quick:query-interface",
-    "test:e2e:quick:claude": "npm run test:acceptance-quick:create-interface -- --agent claude-code && npm run test:acceptance-quick:query-interface -- --agent claude-code",
-    "test:e2e:quick:codex": "npm run test:acceptance-quick:create-interface -- --agent codex && npm run test:acceptance-quick:query-interface -- --agent codex",
+    "test:e2e:quick": "npm run test:acceptance-quick:create-workspace && npm run test:acceptance-quick:query-workspace",
+    "test:e2e:quick:claude": "npm run test:acceptance-quick:create-workspace -- --agent claude-code && npm run test:acceptance-quick:query-workspace -- --agent claude-code",
+    "test:e2e:quick:codex": "npm run test:acceptance-quick:create-workspace -- --agent codex && npm run test:acceptance-quick:query-workspace -- --agent codex",
     "test:e2e:quick:matrix": "npm run test:e2e:quick:claude && npm run test:e2e:quick:codex",
     "test:e2e:compare": "npm run test:acceptance-compare",
     "test:e2e:release:claude": "npm run test:acceptance-live -- --agent claude-code",
@@ -37,11 +37,11 @@
     "test:release:evals": "npm run eval:pack -- --pack internal/eval-packs/cbre-chart-sanity.json",
     "test:release": "npm test && npm run test:e2e:release:claude && npm run test:e2e:release:codex && npm run test:release:evals",
     "test:acceptance-live": "npm run build && node scripts/acceptance-live.mjs",
-    "test:acceptance-compare": "npm run build && node scripts/acceptance-live.mjs --compare",
-    "test:acceptance-matrix": "npm run build && node scripts/acceptance-live.mjs --full-matrix",
+    "test:acceptance-compare": "npm run build && node scripts/acceptance-live.mjs --with-benchmark",
+    "test:acceptance-matrix": "npm run build && node scripts/acceptance-live.mjs --with-benchmark",
     "test:acceptance-cache:refresh": "npm run build && node scripts/acceptance-live.mjs --output-root .interf-test-cache/latest-quick",
-    "test:acceptance-quick:create-interface": "npm run build && node scripts/acceptance-targeted.mjs create-interface",
-    "test:acceptance-quick:query-interface": "npm run build && node scripts/acceptance-targeted.mjs interface-query",
+    "test:acceptance-quick:create-workspace": "npm run build && node scripts/acceptance-targeted.mjs create-workspace",
+    "test:acceptance-quick:query-workspace": "npm run build && node scripts/acceptance-targeted.mjs workspace-query",
     "prepublishOnly": "node scripts/prepublish-gate.mjs"
   },
   "files": [

package/skills/benchmark/SKILL.md

@@ -1,11 +1,11 @@
 ---
 {
   "name": "benchmark",
-  "description": "Compare compiled knowledge bases or interfaces with Interf's file-based benchmark specs. Use when asked to benchmark, compare workflows, compare interfaces, or run evals on already-compiled Interf targets."
+  "description": "Compare compiled workspaces with Interf's file-based benchmark specs. Use when asked to benchmark, compare workflows, compare compiled workspaces, or run checks on already-compiled Interf targets."
 }
 ---
 
-# Benchmark Compiled Knowledge Bases or Interfaces
+# Benchmark Compiled Workspaces
 
 Use this skill when the job is to compare compiled Interf outputs, not to build them from scratch.
 
@@ -16,14 +16,12 @@ interf benchmark [type]
 ```
 
 This skill is for:
-- comparing knowledge bases built from the same source folder
-- comparing interfaces built on top of the same knowledge base
+- comparing compiled workspaces built from the same source folder
 - creating or refining simple benchmark specs under `interf/benchmarks/`
-- summarizing which workflow or interface performed better on deterministic checks
+- summarizing which workflow or compiled workspace performed better on deterministic checks
 
 This skill is **not** for:
-- compiling a knowledge base
-- compiling an interface
+- compiling a workspace
 - inventing a second benchmark system outside Interf's filesystem contract
 
 ## Source of truth
@@ -39,32 +37,26 @@ When this skill is used inside a generated workspace, do not try to open SDK rep
 
 Interf benchmark specs are file-first and deterministic by default.
 
-They live under:
+They live under `interf/benchmarks/`.
 
-- `interf/benchmarks/knowledge-base/*.json`
-- `interf/benchmarks/interface/*.json`
-
-Saved benchmark runs live under:
-
-- `interf/benchmarks/runs/knowledge-base/*.json`
-- `interf/benchmarks/runs/interface/*.json`
+Saved benchmark runs live under `interf/benchmarks/runs/workspace/`.
 
 Minimal example:
 
 ```json
 {
-  "type": "interface",
+  "type": "workspace",
   "name": "Weekly Brief Quality",
-  "description": "Compare weekly briefing interfaces.",
+  "description": "Compare weekly briefing workspaces.",
   "cases": [
     {
       "id": "current-state",
-      "question": "Does this interface clearly say what changed and what matters next?",
-      "file": "briefs/current-state.md",
+      "question": "Does this workspace clearly say what changed and what matters next?",
+      "file": "home.md",
       "expect": {
-        "must_include": ["what changed", "next steps"],
+        "must_include": ["launch", "people"],
         "must_not_include": ["TODO"],
-        "min_words": 150
+        "min_words": 5
       }
     }
   ]
@@ -95,7 +87,7 @@ If a target is `stale`, `failed`, or `idle`, do not benchmark it yet. Recompile
 ## Recommended flow
 
 1. Confirm the source folder and target type.
-2. Confirm the selected knowledge bases or interfaces are compiled.
+2. Confirm the selected workspaces are compiled.
 3. Reuse an existing benchmark spec if one already expresses the user's assertion.
 4. Otherwise create a small benchmark spec with:
    - one clear question per case
@@ -103,7 +95,7 @@ If a target is `stale`, `failed`, or `idle`, do not benchmark it yet. Recompile
    - a few deterministic checks
 5. Run `interf benchmark`.
 6. Read the saved run artifact under `interf/benchmarks/runs/`.
-7. Summarize pass/fail differences and what they imply about the workflow or interface.
+7. Summarize pass/fail differences and what they imply about the workflow or workspace.
 
 ## Authoring guidance
 
@@ -125,5 +117,5 @@ When summarizing a benchmark run:
 - say which targets were compared
 - say which cases passed or failed
 - point to the saved run file
-- explain what the failures imply about the current workflow or interface
+- explain what the failures imply about the current workflow or workspace
 - keep benchmark conclusions separate from subjective product opinions

package/skills/workflow/create/SKILL.md

@@ -1,7 +1,7 @@
 ---
 {
   "name": "workflow/create",
-  "description": "Create or refine an Interf workflow package. Use when asked to define a KB or interface workflow, author workflow.json, shape compile stages, or add declarative stage acceptance criteria."
+  "description": "Create or refine an Interf workflow package. Use when asked to define a workspace workflow, author workflow.json, shape compile stages, or add declarative stage acceptance criteria."
 }
 ---
 
@@ -18,7 +18,7 @@ interf create workflow
 That wizard should create the initial package under:
 
 ```text
-interf/workflows/<type>/<workflow-id>/
+interf/workflows/<workflow-id>/
 ```
 
 Then refine the package in place.
@@ -35,7 +35,7 @@ It has two layers:
 Typical shape:
 
 ```text
-interf/workflows/knowledge-base/<workflow-id>/
+interf/workflows/<workflow-id>/
   workflow.json
   README.md
   create/
@@ -58,7 +58,6 @@ Keep it declarative.
 - `label`
 - `hint`
 - optional `extends`
-- optional `placeholder`
 - optional `stages`
 - optional `stage_policy_notes`
 
@@ -73,16 +72,10 @@ Each stage can define:
 
 ## Contract kinds
 
-Use the shipped contract families only.
+Use the shipped workspace contract families only:
 
-Knowledge-base stages:
-- `kb-file-evidence`
-- `kb-knowledge-layer`
-
-Interface stages:
-- `interface-retrieval`
-- `interface-analysis`
-- `interface-output`
+- `workspace-file-evidence`
+- `workspace-knowledge-layer`
 
 Do not invent new engine contract kinds in a local workflow package.
 
@@ -102,7 +95,7 @@ Use dynamic counts when possible.
 
 Good:
 - `"summarized": "target_files"`
-- `"frontmatter_scanned": "knowledge_base_summary_total"`
+- `"compiled": "summary_total"`
 
 Avoid hardcoding fixed file counts unless the workflow really requires them.
 

package/templates/workspace/README.md

@@ -0,0 +1,23 @@
+# Workspace Template
+
+This directory contains bundled helper files for compiled workspaces.
+
+Interf creates compiled workspaces under:
+
+```text
+interf/workspaces/<name>/
+```
+
+The generated workspace is a file-based layer on top of your raw files.
+
+Interf scaffolds:
+
+- `interf.json`
+- `AGENTS.md`
+- `CLAUDE.md`
+- `home.md`
+- `workflow/`
+- `.interf/`
+- `.interfignore`
+
+The source folder remains the human control plane. The compiled workspace is the agent-facing surface.

package/templates/workspace/interfignore

@@ -0,0 +1,2 @@
+.obsidian/
+.DS_Store

package/dist/lib/bundled-templates.d.ts

@@ -1,5 +0,0 @@
-type TemplateValue = string | number | Array<string | number> | null | undefined;
-export declare function loadBundledTemplate(relativePath: string): string;
-export declare function renderBundledTemplate(relativePath: string, replacements?: Record<string, TemplateValue>): string;
-export {};
-//# sourceMappingURL=bundled-templates.d.ts.map

package/dist/lib/bundled-templates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundled-templates.d.ts","sourceRoot":"","sources":["../../src/lib/bundled-templates.ts"],"names":[],"mappings":"AAIA,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAYjF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAM,GAC/C,MAAM,CAMR"}

package/dist/lib/bundled-templates.js

@@ -1,23 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { TEMPLATES_DIR } from "./config.js";
-function normalizeTemplateValue(value) {
-    if (Array.isArray(value)) {
-        return value.map((entry) => String(entry)).join("\n");
-    }
-    if (value === null || value === undefined) {
-        return "";
-    }
-    return String(value);
-}
-export function loadBundledTemplate(relativePath) {
-    return readFileSync(join(TEMPLATES_DIR, relativePath), "utf8");
-}
-export function renderBundledTemplate(relativePath, replacements = {}) {
-    let content = loadBundledTemplate(relativePath);
-    for (const [key, value] of Object.entries(replacements)) {
-        content = content.replaceAll(`{{${key}}}`, normalizeTemplateValue(value));
-    }
-    return content.endsWith("\n") ? content : `${content}\n`;
-}
-//# sourceMappingURL=bundled-templates.js.map

package/dist/lib/bundled-templates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundled-templates.js","sourceRoot":"","sources":["../../src/lib/bundled-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,SAAS,sBAAsB,CAAC,KAAoB;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,YAAoB,EACpB,eAA8C,EAAE;IAEhD,IAAI,OAAO,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC;AAC3D,CAAC"}

package/dist/lib/interf-compile-plan.d.ts

@@ -1,12 +0,0 @@
-import { type InterfaceWorkflowId, type WorkflowStageDefinition } from "./workflow-definitions.js";
-export declare function buildInterfaceStagePolicySection(notes: string[] | undefined): string[];
-export declare function formatWorkflowStageFolders(stages: WorkflowStageDefinition[]): string;
-export declare function formatWorkflowStageSequence(stages: WorkflowStageDefinition[]): string;
-export declare function writeInterfaceCompilePlanTemplate(dirPath: string, options: {
-    workflowId: InterfaceWorkflowId;
-    sourcePath?: string;
-    interfaceName?: string;
-    useCase?: string;
-    targetQuestions?: string[];
-}): void;
-//# sourceMappingURL=interf-compile-plan.d.ts.map

package/dist/lib/interf-compile-plan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interf-compile-plan.d.ts","sourceRoot":"","sources":["../../src/lib/interf-compile-plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAGnC,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAQtF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,CAEpF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,CAErF;AAiID,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,UAAU,EAAE,mBAAmB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,GACA,IAAI,CAmBN"}