@interf/compiler 0.6.3 → 0.6.5

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

@@ -5,7 +5,7 @@ import { createRawTestTarget, createCompiledTestTarget, runTargetTestsAuto, save
 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 { testRootForCompiled } from "../../packages/project-model/compiled-paths.js";
-import { readJsonFileWithSchema } from "../../lib/parse.js";
+import { readJsonFileWithSchema } from "../../packages/shared/parse.js";
 import { TestRunComparisonSchema } from "../../packages/testing/lib/schema.js";
 import { resolveOrConfigureLocalExecutor } from "./executor-flow.js";
 import { findBuiltCompiledPath } from "./compiled-flow.js";
@@ -58,56 +58,56 @@ export function readCurrentSavedTestComparison(options) {
 }
 function renderLatestSummaryMarkdown(payload) {
     const lines = [
-        "# Latest Test Result",
+        "# Latest Test Results",
         "",
-        "| Target | Truth checks |",
+        "| Target | Questions |",
         "| --- | --- |",
     ];
     if (payload.raw) {
-        lines.push(`| Files as-is | \`${payload.raw.passed_cases}/${payload.raw.total_cases}\` |`);
+        lines.push(`| Source files | \`${payload.raw.passed_cases}/${payload.raw.total_cases}\` |`);
     }
     if (payload.compiled) {
-        lines.push(`| Context folder | \`${payload.compiled.passed_cases}/${payload.compiled.total_cases}\` |`);
+        lines.push(`| Portable context | \`${payload.compiled.passed_cases}/${payload.compiled.total_cases}\` |`);
     }
     lines.push("");
     if (payload.summary.raw_pass_rate != null && payload.summary.compiled_pass_rate != null) {
         const direction = (payload.summary.pass_rate_delta ?? 0) >= 0 ? "improved" : "decreased";
-        lines.push(`Truth-check pass rate ${direction} from ${payload.summary.raw_pass_rate}% to ${payload.summary.compiled_pass_rate}%.`, "");
+        lines.push(`Question pass rate ${direction} from ${payload.summary.raw_pass_rate}% to ${payload.summary.compiled_pass_rate}%.`, "");
     }
     if (payload.raw) {
-        lines.push(`- Latest files-as-is run: ${payload.raw.run_path}`);
+        lines.push(`- Latest source-files run: ${payload.raw.run_path}`);
     }
     if (payload.compiled) {
-        lines.push(`- Latest compiled run: ${payload.compiled.run_path}`);
+        lines.push(`- Latest portable-context run: ${payload.compiled.run_path}`);
     }
     return `${lines.join("\n")}\n`;
 }
 export function printSavedTestComparisonState(payload, comparisonRunPath) {
     console.log();
-    console.log(chalk.bold("  Latest saved test"));
+    console.log(chalk.bold("  Latest saved questions"));
     console.log();
-    console.log("  | Target | Truth checks |");
+    console.log("  | Target | Questions |");
     console.log("  | --- | --- |");
     if (payload.raw) {
-        console.log(`  | Files as-is | \`${payload.raw.passed_cases}/${payload.raw.total_cases}\` |`);
+        console.log(`  | Source files | \`${payload.raw.passed_cases}/${payload.raw.total_cases}\` |`);
     }
     if (payload.compiled) {
-        console.log(`  | Context folder | \`${payload.compiled.passed_cases}/${payload.compiled.total_cases}\` |`);
+        console.log(`  | Portable context | \`${payload.compiled.passed_cases}/${payload.compiled.total_cases}\` |`);
     }
     if (!payload.raw || !payload.compiled) {
         console.log();
         if (!payload.raw) {
-            console.log(chalk.dim("  No saved files-as-is baseline yet."));
+            console.log(chalk.dim("  No saved source-files baseline yet."));
         }
         if (!payload.compiled) {
-            console.log(chalk.dim("  No saved compiled-context run yet."));
+            console.log(chalk.dim("  No saved portable-context run yet."));
         }
     }
     if (payload.summary.raw_pass_rate != null && payload.summary.compiled_pass_rate != null) {
         const direction = (payload.summary.pass_rate_delta ?? 0) >= 0 ? "improved" : "decreased";
         const color = (payload.summary.pass_rate_delta ?? 0) >= 0 ? chalk.green : chalk.red;
         console.log();
-        console.log(color(`  Truth-check pass rate ${direction} from ${payload.summary.raw_pass_rate}% to ${payload.summary.compiled_pass_rate}%.`));
+        console.log(color(`  Question pass rate ${direction} from ${payload.summary.raw_pass_rate}% to ${payload.summary.compiled_pass_rate}%.`));
     }
     if (comparisonRunPath) {
         console.log();
@@ -136,7 +136,7 @@ export function printAgentTestMatrix(rows) {
     const includeDelta = includeRaw && includeCompiled;
     const headers = [
         "Agent",
-        ...(includeRaw ? ["Files as-is"] : []),
+        ...(includeRaw ? ["Source files"] : []),
         ...(includeCompiled ? ["Context folder"] : []),
         ...(includeDelta ? ["Delta"] : []),
     ];
@@ -161,7 +161,7 @@ export function printAgentTestFailures(rows) {
     for (const row of rows) {
         const failures = [];
         for (const [label, outcome] of [
-            ["Files as-is", row.rawOutcome ?? null],
+            ["Source files", row.rawOutcome ?? null],
             ["Context folder", row.compiledOutcome ?? null],
         ]) {
             if (!outcome || outcome.result.ok)
@@ -170,7 +170,7 @@ export function printAgentTestFailures(rows) {
                 if (caseResult.ok)
                     continue;
                 const reason = caseResult.checks.find((entry) => !entry.ok)?.detail ?? "failed";
-                failures.push(`${label} · Truth Check ${index + 1}: ${reason}`);
+                failures.push(`${label} · Question ${index + 1}: ${reason}`);
             }
         }
         if (failures.length === 0)
@@ -204,11 +204,11 @@ export function printSavedTestOutcome(prefix, outcome) {
     const status = outcome.result.ok ? chalk.green("PASS") : chalk.red("FAIL");
     console.log(chalk.bold(`  ${prefix}`));
     console.log();
-    console.log(color(`  ${status} ${outcome.result.passedCases}/${outcome.result.totalCases} questions`));
+    console.log(color(`  ${status} ${outcome.result.passedCases}/${outcome.result.totalCases} tests`));
     console.log();
     for (const [index, caseResult] of outcome.result.caseResults.entries()) {
         const caseStatus = caseResult.ok ? chalk.green("PASS") : chalk.red("FAIL");
-        console.log(`  ${caseStatus} Truth Check ${index + 1}`);
+        console.log(`  ${caseStatus} Question ${index + 1}`);
         console.log(chalk.dim(`       ${caseResult.question}`));
         const failedChecks = caseResult.checks.filter((entry) => !entry.ok).slice(0, 3);
         for (const failedCheck of failedChecks) {
@@ -227,7 +227,7 @@ export function printSavedTestComparison(rawOutcome, compiledOutcome, comparison
         return;
     console.log();
     if (rawOutcome) {
-        printSavedTestOutcome("Files as-is", rawOutcome);
+        printSavedTestOutcome("Source files", rawOutcome);
     }
     if (compiledOutcome) {
         if (rawOutcome)
@@ -241,7 +241,7 @@ export function printSavedTestComparison(rawOutcome, compiledOutcome, comparison
         const color = delta >= 0 ? chalk.green : chalk.red;
         const direction = delta >= 0 ? "improved" : "decreased";
         console.log();
-        console.log(color(`  Truth-check pass rate ${direction} from ${rawQuestions}% to ${compiledQuestions}%.`));
+        console.log(color(`  Question pass rate ${direction} from ${rawQuestions}% to ${compiledQuestions}%.`));
     }
     if (comparisonRunPath) {
         console.log();
@@ -254,10 +254,10 @@ export function printSavedTestComparisonSummary(rawOutcome, compiledOutcome, com
     console.log();
     console.log(chalk.bold("  Comparison"));
     console.log();
-    console.log("  | Target | Truth checks |");
+    console.log("  | Target | Questions |");
     console.log("  | --- | --- |");
     if (rawOutcome) {
-        console.log(`  | Files as-is | \`${rawOutcome.result.passedCases}/${rawOutcome.result.totalCases}\` |`);
+        console.log(`  | Source files | \`${rawOutcome.result.passedCases}/${rawOutcome.result.totalCases}\` |`);
     }
     if (compiledOutcome) {
         console.log(`  | Context folder | \`${compiledOutcome.result.passedCases}/${compiledOutcome.result.totalCases}\` |`);
@@ -269,7 +269,7 @@ export function printSavedTestComparisonSummary(rawOutcome, compiledOutcome, com
         const color = delta >= 0 ? chalk.green : chalk.red;
         const direction = delta >= 0 ? "improved" : "decreased";
         console.log();
-        console.log(color(`  Truth-check pass rate ${direction} from ${rawQuestions}% to ${compiledQuestions}%.`));
+        console.log(color(`  Question pass rate ${direction} from ${rawQuestions}% to ${compiledQuestions}%.`));
     }
     if (comparisonRunPath) {
         console.log();
@@ -279,7 +279,7 @@ export function printSavedTestComparisonSummary(rawOutcome, compiledOutcome, com
 export function saveTestComparisonRun(options) {
     const generatedAt = new Date().toISOString();
     const rawSummary = options.rawOutcome
-        ? summarizeSavedTestOutcome("Files as-is", options.rawOutcome)
+        ? summarizeSavedTestOutcome("Source files", options.rawOutcome)
         : null;
     const compiledSummary = options.compiledOutcome
         ? summarizeSavedTestOutcome("Context folder", options.compiledOutcome)

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 files as-is and a compiled context on checks",
+    describe: "Compare source files and the portable context your agents would use 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 files as-is, the compiled context, or both. Default: both when a compiled context exists, otherwise files as-is.",
+        describe: "Test source files, the portable context your agents would use, or both. Default: both when portable context exists, otherwise source files.",
     })
         .option("keep-sandboxes", {
         type: "boolean",
@@ -49,18 +49,18 @@ async function promptTestMode(hasBuiltCompiled) {
         options: [
             {
                 value: "both",
-                label: "Compare files-as-is and compiled context (Recommended)",
-                hint: "Measure whether compilation helps on the checks",
+                label: "Compare source files and the portable context your agents would use (Recommended)",
+                hint: "Measure whether the portable context helps your agents on the saved questions",
             },
             {
                 value: "raw",
-                label: "Files-as-is only",
+                label: "Source files only",
                 hint: "Measure the current baseline on the dataset files",
             },
             {
                 value: "compiled",
-                label: "Compiled context only",
-                hint: "Measure the current compiled context on the checks",
+                label: "Portable context only",
+                hint: "Measure the current portable context for your agents on the saved questions",
             },
         ],
     });
@@ -221,8 +221,8 @@ export async function runTestCommand(argv = {}) {
     }
     if (selectedCompiled.checks.length === 0) {
         process.exitCode = 1;
-        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have any checks yet.`));
-        console.log(chalk.dim("  Run `interf`, edit this setup, and add a few checks first."));
+        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have any questions yet.`));
+        console.log(chalk.dim("  Run `interf`, edit this setup, and add a few questions first."));
         console.log(chalk.dim("  Then rerun `interf test`."));
         return false;
     }
@@ -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 a context folder yet.`));
+        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context for your agents 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 a context folder yet, so Interf cannot compare files-as-is and the context folder.`));
+        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.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 a context folder yet.`));
+        console.log(chalk.red(`  Setup "${selectedCompiled.name}" does not have portable context for your agents yet.`));
         console.log(chalk.dim("  Run `interf compile` first."));
         return false;
     }

package/dist/lib/chart-guidance.d.ts

@@ -1 +1 @@
-export declare const CHART_APPROXIMATION_NOTES: readonly ["When a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.", "Match the granularity of the visible axis labels or bands. Do not invent finer precision than the chart supports.", "Keep the answer inside the visible tick band unless the chart supports a tighter bound.", "Use an upper-half or lower-half band only when the mark clearly sits there.", "If a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.", "Do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty."];
+export * from "../packages/agents/lib/chart-guidance.js";

package/dist/lib/chart-guidance.js

@@ -1,8 +1 @@
-export const CHART_APPROXIMATION_NOTES = [
-    "When a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.",
-    "Match the granularity of the visible axis labels or bands. Do not invent finer precision than the chart supports.",
-    "Keep the answer inside the visible tick band unless the chart supports a tighter bound.",
-    "Use an upper-half or lower-half band only when the mark clearly sits there.",
-    "If a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.",
-    "Do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty.",
-];
+export * from "../packages/agents/lib/chart-guidance.js";

package/dist/lib/discovery.d.ts

@@ -1,7 +1 @@
-export interface DiscoveryResult {
-    sourceFiles: string[];
-    totalCount: number;
-    ignoredCount: number;
-}
-export declare function discoverSourceFiles(sourcePath: string, compiledPath: string): DiscoveryResult;
-export declare function loadIgnorePatterns(compiledPath: string): string[];
+export * from "../packages/compiler/discovery.js";

package/dist/lib/discovery.js

@@ -1,84 +1 @@
-import { existsSync, readFileSync } from "node:fs";
-import { join, relative } from "node:path";
-import { listFilesRecursive } from "./filesystem.js";
-const DEFAULT_IGNORE_DIRS = new Set([
-    "interf",
-    ".interf",
-    ".git",
-    ".obsidian",
-    ".claude",
-    "node_modules",
-]);
-const DEFAULT_IGNORE_FILES = new Set([
-    "interf.json",
-]);
-export function discoverSourceFiles(sourcePath, compiledPath) {
-    const userPatterns = loadIgnorePatterns(compiledPath);
-    let ignoredCount = 0;
-    const allFiles = listFilesRecursive(sourcePath, (filePath) => {
-        const rel = relative(sourcePath, filePath);
-        if (isIgnored(rel)) {
-            ignoredCount++;
-            return false;
-        }
-        if (userPatterns.length > 0 && matchesUserPattern(rel, userPatterns)) {
-            ignoredCount++;
-            return false;
-        }
-        return true;
-    });
-    const sourceFiles = allFiles
-        .map((f) => relative(sourcePath, f))
-        .sort((a, b) => a.localeCompare(b));
-    return {
-        sourceFiles,
-        totalCount: sourceFiles.length,
-        ignoredCount,
-    };
-}
-export function loadIgnorePatterns(compiledPath) {
-    const ignorePath = join(compiledPath, ".interfignore");
-    if (!existsSync(ignorePath))
-        return [];
-    return readFileSync(ignorePath, "utf-8")
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0 && !line.startsWith("#"));
-}
-function isIgnored(relativePath) {
-    if (DEFAULT_IGNORE_FILES.has(relativePath))
-        return true;
-    const segments = relativePath.split("/");
-    for (const segment of segments) {
-        if (segment.startsWith("."))
-            return true;
-        if (DEFAULT_IGNORE_DIRS.has(segment))
-            return true;
-    }
-    return false;
-}
-function matchesUserPattern(relativePath, patterns) {
-    for (const pattern of patterns) {
-        if (matchGlob(relativePath, pattern))
-            return true;
-    }
-    return false;
-}
-function matchGlob(path, pattern) {
-    // Exact directory match: "build/" matches "build/..." or "sub/build/..."
-    if (pattern.endsWith("/")) {
-        const dir = pattern.slice(0, -1);
-        return path === dir || path.startsWith(dir + "/") || path.includes("/" + dir + "/");
-    }
-    // Extension match: "*.log" matches any file ending in .log
-    if (pattern.startsWith("*.")) {
-        return path.endsWith(pattern.slice(1));
-    }
-    // Exact filename match: ".env" matches ".env" at any depth
-    if (!pattern.includes("/") && !pattern.includes("*")) {
-        const filename = path.split("/").pop() ?? "";
-        return filename === pattern;
-    }
-    // Prefix match: "dist/foo" matches "dist/foo" and "dist/foo/bar"
-    return path === pattern || path.startsWith(pattern + "/");
-}
+export * from "../packages/compiler/discovery.js";

package/dist/lib/filesystem.d.ts

@@ -1,2 +1 @@
-export declare function countFilesRecursive(dirPath: string): number;
-export declare function listFilesRecursive(dirPath: string, predicate?: (filePath: string) => boolean): string[];
+export * from "../packages/shared/filesystem.js";

package/dist/lib/filesystem.js

@@ -1,55 +1 @@
-import { existsSync, readdirSync, realpathSync, statSync } from "node:fs";
-import { join } from "node:path";
-export function countFilesRecursive(dirPath) {
-    if (!existsSync(dirPath))
-        return 0;
-    let total = 0;
-    walkFilesRecursive(dirPath, () => {
-        total += 1;
-    });
-    return total;
-}
-export function listFilesRecursive(dirPath, predicate) {
-    const files = [];
-    if (!existsSync(dirPath))
-        return files;
-    walkFilesRecursive(dirPath, (filePath) => {
-        if (!predicate || predicate(filePath)) {
-            files.push(filePath);
-        }
-    });
-    return files;
-}
-function walkFilesRecursive(dirPath, onFile, visitedDirs = new Set()) {
-    if (!existsSync(dirPath))
-        return;
-    walkFilesRecursiveInternal(dirPath, onFile, visitedDirs);
-}
-function walkFilesRecursiveInternal(dirPath, onFile, visitedDirs) {
-    let resolvedDir;
-    try {
-        resolvedDir = realpathSync(dirPath);
-    }
-    catch {
-        return;
-    }
-    if (visitedDirs.has(resolvedDir))
-        return;
-    visitedDirs.add(resolvedDir);
-    for (const entry of readdirSync(dirPath)) {
-        const fullPath = join(dirPath, entry);
-        let stat;
-        try {
-            stat = statSync(fullPath);
-        }
-        catch {
-            continue;
-        }
-        if (stat.isDirectory()) {
-            walkFilesRecursiveInternal(fullPath, onFile, visitedDirs);
-        }
-        else if (stat.isFile()) {
-            onFile(fullPath);
-        }
-    }
-}
+export * from "../packages/shared/filesystem.js";

package/dist/lib/logger.d.ts

@@ -1,3 +1 @@
-export type InterfWarningHandler = (message: string) => void;
-export declare function setInterfWarningHandler(handler?: InterfWarningHandler): void;
-export declare function warnInterf(message: string): void;
+export * from "../packages/shared/logger.js";

package/dist/lib/logger.js

@@ -1,10 +1 @@
-const defaultWarningHandler = (message) => {
-    console.warn(message);
-};
-let currentWarningHandler = defaultWarningHandler;
-export function setInterfWarningHandler(handler) {
-    currentWarningHandler = handler ?? defaultWarningHandler;
-}
-export function warnInterf(message) {
-    currentWarningHandler(message);
-}
+export * from "../packages/shared/logger.js";

package/dist/lib/parse.d.ts

@@ -1,8 +1 @@
-import type { ZodType } from "zod";
-export declare function readJsonFileUnchecked<T>(filePath: string, label: string): T | null;
-export declare function readJsonFileWithSchema<T>(filePath: string, label: string, schema: ZodType<T>): T | null;
-export declare function renderJsonFrontmatter(frontmatter: Record<string, unknown>): string;
-export declare function parseJsonFrontmatter(content: string): {
-    frontmatter: Record<string, unknown>;
-    body: string;
-} | null;
+export * from "../packages/shared/parse.js";

package/dist/lib/parse.js

@@ -1,145 +1 @@
-import { readFileSync } from "node:fs";
-import { warnInterf } from "./logger.js";
-function formatError(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-export function readJsonFileUnchecked(filePath, label) {
-    try {
-        return JSON.parse(readFileSync(filePath, "utf-8"));
-    }
-    catch (error) {
-        warnInterf(`Warning: failed to parse ${label} at ${filePath}: ${formatError(error)}`);
-        return null;
-    }
-}
-export function readJsonFileWithSchema(filePath, label, schema) {
-    const raw = readJsonFileUnchecked(filePath, label);
-    if (raw === null)
-        return null;
-    const parsed = schema.safeParse(raw);
-    if (!parsed.success) {
-        warnInterf(`Warning: failed to validate ${label} at ${filePath}: ${parsed.error.issues.map((issue) => issue.message).join("; ")}`);
-        return null;
-    }
-    return parsed.data;
-}
-export function renderJsonFrontmatter(frontmatter) {
-    return [
-        "---",
-        JSON.stringify(frontmatter, null, 2),
-        "---",
-    ].join("\n");
-}
-function parseQuotedString(value) {
-    if (value.length < 2)
-        return null;
-    const quote = value[0];
-    if ((quote !== "\"" && quote !== "'") || value[value.length - 1] !== quote)
-        return null;
-    const inner = value.slice(1, -1);
-    if (quote === "\"") {
-        try {
-            return JSON.parse(value);
-        }
-        catch {
-            return null;
-        }
-    }
-    return inner.replace(/\\'/g, "'");
-}
-function parseYamlScalar(value) {
-    const trimmed = value.trim();
-    if (trimmed.length === 0)
-        return "";
-    const quoted = parseQuotedString(trimmed);
-    if (quoted !== null)
-        return quoted;
-    if (trimmed === "true")
-        return true;
-    if (trimmed === "false")
-        return false;
-    if (trimmed === "null")
-        return null;
-    if (/^-?\d+(?:\.\d+)?$/.test(trimmed))
-        return Number(trimmed);
-    if ((trimmed.startsWith("[") && trimmed.endsWith("]"))
-        || (trimmed.startsWith("{") && trimmed.endsWith("}"))) {
-        try {
-            return JSON.parse(trimmed);
-        }
-        catch {
-            return trimmed;
-        }
-    }
-    return trimmed;
-}
-function parseYamlFrontmatter(frontmatterText) {
-    const lines = frontmatterText.split("\n");
-    const frontmatter = {};
-    for (let index = 0; index < lines.length; index += 1) {
-        const line = lines[index] ?? "";
-        const trimmed = line.trim();
-        if (trimmed.length === 0 || trimmed.startsWith("#"))
-            continue;
-        const match = line.match(/^([A-Za-z0-9_-]+):(?:\s+(.*))?$/);
-        if (!match)
-            return null;
-        const [, key, inlineValue] = match;
-        if (!key)
-            return null;
-        if (inlineValue && inlineValue.trim().length > 0) {
-            frontmatter[key] = parseYamlScalar(inlineValue);
-            continue;
-        }
-        const items = [];
-        let cursor = index + 1;
-        while (cursor < lines.length) {
-            const nextLine = lines[cursor] ?? "";
-            const nextTrimmed = nextLine.trim();
-            if (nextTrimmed.length === 0) {
-                cursor += 1;
-                continue;
-            }
-            const itemMatch = nextLine.match(/^\s*-\s+(.*)$/);
-            if (!itemMatch || !/^\s+/.test(nextLine))
-                break;
-            items.push(parseYamlScalar(itemMatch[1] ?? ""));
-            cursor += 1;
-        }
-        if (items.length > 0) {
-            frontmatter[key] = items;
-            index = cursor - 1;
-            continue;
-        }
-        frontmatter[key] = "";
-    }
-    return Object.keys(frontmatter).length > 0 ? frontmatter : null;
-}
-export function parseJsonFrontmatter(content) {
-    const normalized = content.replace(/\r\n/g, "\n");
-    const match = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
-    if (!match)
-        return null;
-    const [, frontmatterText, body = ""] = match;
-    if (frontmatterText === undefined)
-        return null;
-    try {
-        const frontmatter = JSON.parse(frontmatterText);
-        if (!frontmatter || typeof frontmatter !== "object" || Array.isArray(frontmatter)) {
-            return null;
-        }
-        return {
-            frontmatter: frontmatter,
-            body,
-        };
-    }
-    catch {
-        const frontmatter = parseYamlFrontmatter(frontmatterText);
-        if (!frontmatter)
-            return null;
-        return {
-            frontmatter,
-            body,
-        };
-    }
-}
+export * from "../packages/shared/parse.js";

package/dist/lib/util.d.ts

@@ -1,4 +1 @@
-export declare function slugify(input: string): string;
-export declare function isMarkdownFile(filePath: string): boolean;
-export declare function isPathWithinRoot(rootPath: string, candidatePath: string): boolean;
-export declare function assertPathWithinRoot(rootPath: string, candidatePath: string, label: string): string;
+export * from "../packages/shared/util.js";

package/dist/lib/util.js

@@ -1,25 +1 @@
-import { extname, isAbsolute, relative, resolve, sep } from "node:path";
-export function slugify(input) {
-    return input
-        .toLowerCase()
-        .trim()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 80);
-}
-export function isMarkdownFile(filePath) {
-    return extname(filePath).toLowerCase() === ".md";
-}
-export function isPathWithinRoot(rootPath, candidatePath) {
-    const root = resolve(rootPath);
-    const candidate = resolve(candidatePath);
-    const relativePath = relative(root, candidate);
-    return relativePath === "" || (!isAbsolute(relativePath) && relativePath !== ".." && !relativePath.startsWith(`..${sep}`));
-}
-export function assertPathWithinRoot(rootPath, candidatePath, label) {
-    const resolvedPath = resolve(candidatePath);
-    if (!isPathWithinRoot(rootPath, resolvedPath)) {
-        throw new Error(`${label} must stay inside ${resolve(rootPath)}: ${resolvedPath}`);
-    }
-    return resolvedPath;
-}
+export * from "../packages/shared/util.js";

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

@@ -13,5 +13,6 @@ export * as executionProfile from "./lib/execution-profile.js";
 export * as executors from "./lib/executors.js";
 export * as schema from "./lib/schema.js";
 export * as userConfig from "./lib/user-config.js";
+export * as compiledBootstrap from "./lib/compiled-bootstrap.js";
 export type { Agent, } from "./lib/types.js";
 export type { WorkflowExecutionProfile, WorkflowExecutor, WorkflowExecutorKind, } from "./lib/executors.js";

package/dist/packages/agents/index.js

@@ -13,3 +13,4 @@ export * as executionProfile from "./lib/execution-profile.js";
 export * as executors from "./lib/executors.js";
 export * as schema from "./lib/schema.js";
 export * as userConfig from "./lib/user-config.js";
+export * as compiledBootstrap from "./lib/compiled-bootstrap.js";

package/dist/packages/agents/lib/chart-guidance.d.ts

@@ -0,0 +1 @@
+export declare const CHART_APPROXIMATION_NOTES: readonly ["When a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.", "Match the granularity of the visible axis labels or bands. Do not invent finer precision than the chart supports.", "Keep the answer inside the visible tick band unless the chart supports a tighter bound.", "Use an upper-half or lower-half band only when the mark clearly sits there.", "If a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.", "Do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty."];

package/dist/packages/agents/lib/chart-guidance.js

@@ -0,0 +1,8 @@
+export const CHART_APPROXIMATION_NOTES = [
+    "When a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.",
+    "Match the granularity of the visible axis labels or bands. Do not invent finer precision than the chart supports.",
+    "Keep the answer inside the visible tick band unless the chart supports a tighter bound.",
+    "Use an upper-half or lower-half band only when the mark clearly sits there.",
+    "If a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.",
+    "Do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty.",
+];