soturail 0.2.1 → 0.2.3

package/dist/core/release-preflight.js

@@ -0,0 +1,199 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+export async function runReleasePreflight(root = process.cwd(), options = {}) {
+    const resolvedRoot = path.resolve(root);
+    const runAudit = options.runAudit ?? true;
+    const runPack = options.runPack ?? true;
+    const gates = [];
+    const packageJson = await readOptionalJson(path.join(resolvedRoot, "package.json"));
+    const packageName = typeof packageJson?.name === "string" ? packageJson.name : null;
+    const version = typeof packageJson?.version === "string" ? packageJson.version : null;
+    addGate(gates, "package_version", "package.json version", Boolean(version && SEMVER_PATTERN.test(version)), version ?? "missing");
+    const packageLock = await readOptionalJson(path.join(resolvedRoot, "package-lock.json"));
+    const lockVersion = typeof packageLock?.version === "string" ? packageLock.version : null;
+    const lockRootVersion = packageLock && typeof packageLock === "object"
+        && "packages" in packageLock
+        && packageLock.packages
+        && typeof packageLock.packages === "object"
+        && "" in packageLock.packages
+        && packageLock.packages[""]
+        && typeof packageLock.packages[""] === "object"
+        && "version" in packageLock.packages[""]
+        && typeof packageLock.packages[""].version === "string"
+        ? packageLock.packages[""].version
+        : null;
+    addGate(gates, "package_lock_version", "package-lock version sync", Boolean(version && lockVersion === version && lockRootVersion === version), `package-lock.version=${lockVersion ?? "missing"}, packages[\"\"].version=${lockRootVersion ?? "missing"}`);
+    const cliVersion = await readCliVersion(resolvedRoot, options.cliCommand);
+    addGate(gates, "cli_version", "CLI runtime version sync", Boolean(version && cliVersion.code === 0 && cliVersion.stdout.trim() === version), cliVersion.code === 0 ? `cli=${cliVersion.stdout.trim() || "empty"}, package=${version ?? "missing"}` : cliVersion.stderr.trim());
+    if (runPack) {
+        const pack = await runProcess("npm", ["pack", "--dry-run"], resolvedRoot, true);
+        const combined = `${pack.stdout}\n${pack.stderr}`;
+        const expectedTarball = packageName && version ? `${packageName}-${version}.tgz` : null;
+        addGate(gates, "npm_pack_metadata", "npm pack metadata", Boolean(pack.code === 0 && expectedTarball && combined.includes(expectedTarball)), expectedTarball ? `expected ${expectedTarball}` : "missing package name or version");
+    }
+    else {
+        addGate(gates, "npm_pack_metadata", "npm pack metadata", true, "skipped by test options", false);
+    }
+    const readme = await readOptionalText(path.join(resolvedRoot, "README.md"));
+    addGate(gates, "readme_install", "README install instructions", Boolean(readme && /npx\s+soturail/.test(readme) && readme.includes("npm install -g soturail") && readme.includes("soturail --version")), readme ? "README.md contains npm/npx/global install guidance" : "README.md missing");
+    const changelog = await readOptionalText(path.join(resolvedRoot, "CHANGELOG.md"));
+    addGate(gates, "changelog_entry", "CHANGELOG version entry", Boolean(version && changelog?.includes(`## [${version}]`)), version ? `expected ## [${version}]` : "missing version");
+    const releaseNotesPath = version ? path.join(resolvedRoot, `RELEASE_NOTES_v${version}.md`) : "";
+    addGate(gates, "release_notes", "release notes file", Boolean(version && existsSync(releaseNotesPath)), version ? path.relative(resolvedRoot, releaseNotesPath) : "missing version");
+    addGate(gates, "license", "LICENSE file", existsSync(path.join(resolvedRoot, "LICENSE")), "LICENSE");
+    let fullAudit = { total: 0, names: [] };
+    let runtimeAudit = { total: 0, names: [] };
+    if (runAudit) {
+        const runtime = await runProcess("npm", ["audit", "--omit=dev", "--json"], resolvedRoot, true);
+        runtimeAudit = parseAudit(runtime.stdout);
+        addGate(gates, "runtime_audit", "runtime npm audit", runtime.code === 0 && runtimeAudit.total === 0, runtimeAudit.total === 0 ? "0 runtime vulnerabilities" : `${runtimeAudit.total} runtime findings: ${runtimeAudit.names.join(", ")}`);
+        const full = await runProcess("npm", ["audit", "--json"], resolvedRoot, true);
+        fullAudit = parseAudit(full.stdout);
+    }
+    else {
+        addGate(gates, "runtime_audit", "runtime npm audit", true, "skipped by test options", false);
+    }
+    const fullAuditDevOnly = fullAudit.total === 0 || (runtimeAudit.total === 0 && fullAudit.total >= runtimeAudit.total);
+    addGate(gates, "full_audit_explained", "full npm audit explanation", fullAuditDevOnly, fullAudit.total === 0
+        ? "0 full audit findings"
+        : `${fullAudit.total} full audit findings treated as dev-only: ${fullAudit.names.join(", ")}`);
+    return {
+        ok: gates.every((gate) => !gate.required || gate.ok),
+        version,
+        packageName,
+        fullAuditDevOnly,
+        fullAuditFindings: fullAudit.names,
+        gates
+    };
+}
+export function formatReleasePreflight(result) {
+    const lines = [
+        `Release preflight: ${result.ok ? "passed" : "failed"}`,
+        `package: ${result.packageName ?? "unknown"}`,
+        `version: ${result.version ?? "unknown"}`,
+        `full_audit_dev_only: ${result.fullAuditDevOnly}`,
+        "gates:"
+    ];
+    for (const gate of result.gates) {
+        lines.push(`- ${gate.ok ? "PASS" : "FAIL"} ${gate.id}: ${gate.details}`);
+    }
+    return lines.join("\n");
+}
+async function readCliVersion(root, cliCommand) {
+    if (cliCommand && cliCommand.length > 0) {
+        const command = cliCommand[0];
+        const args = cliCommand.slice(1);
+        if (!command)
+            return { code: 1, stdout: "", stderr: "empty CLI command" };
+        return runProcess(command, args, root, true);
+    }
+    const cliPath = path.join(root, "dist", "cli.js");
+    if (!existsSync(cliPath)) {
+        return { code: 1, stdout: "", stderr: "dist/cli.js is missing; run npm run build first" };
+    }
+    return runProcess(process.execPath, [cliPath, "--version"], root, true);
+}
+async function readOptionalText(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+async function readOptionalJson(filePath) {
+    const text = await readOptionalText(filePath);
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function addGate(gates, id, label, ok, details, required = true) {
+    gates.push({ id, label, ok, details, required });
+}
+function parseAudit(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return {
+            total: parsed.metadata?.vulnerabilities?.total ?? 0,
+            names: Object.keys(parsed.vulnerabilities ?? {})
+        };
+    }
+    catch {
+        return { total: -1, names: [] };
+    }
+}
+async function runProcess(command, args, cwd, allowFailure = false) {
+    return new Promise((resolve, reject) => {
+        const spawnSpec = resolveSpawn(command, args);
+        const child = spawn(spawnSpec.command, spawnSpec.args, {
+            cwd,
+            shell: false,
+            windowsHide: true,
+            env: process.env
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            const result = { code: code ?? 1, stdout, stderr };
+            if ((code ?? 1) !== 0 && !allowFailure) {
+                reject(new Error(`${command} ${args.join(" ")} failed with exit code ${code ?? 1}`));
+            }
+            else {
+                resolve(result);
+            }
+        });
+    });
+}
+function resolveSpawn(command, args) {
+    if (process.platform !== "win32")
+        return { command, args };
+    if (command === "npm" || command === "npx") {
+        const cli = npmCliPath(command);
+        if (cli)
+            return { command: process.execPath, args: [cli, ...args] };
+    }
+    if (command === "node")
+        return { command: process.execPath, args };
+    return { command: resolveWindowsCommand(command), args };
+}
+function npmCliPath(command) {
+    const npmExecPath = process.env.npm_execpath;
+    const candidates = [];
+    if (npmExecPath) {
+        const dir = path.dirname(npmExecPath);
+        candidates.push(path.resolve(dir, command === "npm" ? "npm-cli.js" : "npx-cli.js"));
+    }
+    const nodeDir = path.dirname(process.execPath);
+    candidates.push(path.resolve(nodeDir, "node_modules", "npm", "bin", command === "npm" ? "npm-cli.js" : "npx-cli.js"));
+    return candidates.find((candidate) => existsSync(candidate));
+}
+function resolveWindowsCommand(command) {
+    if (path.isAbsolute(command) && existsSync(command))
+        return command;
+    const extensions = path.extname(command) ? [""] : [".exe", ".cmd", ".bat", ""];
+    const entries = (process.env.PATH ?? "").split(path.delimiter).filter(Boolean);
+    for (const entry of entries) {
+        for (const extension of extensions) {
+            const candidate = path.resolve(entry, `${command}${extension}`);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return command;
+}
+//# sourceMappingURL=release-preflight.js.map

package/dist/core/release-preflight.js.map

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

package/dist/core/self-dogfood.d.ts

@@ -0,0 +1,56 @@
+import { type Writable } from "node:stream";
+import { type BenchResult } from "../commands/bench.js";
+export interface SelfDoctorResult {
+    ok: boolean;
+    root: string;
+    package_name: string | null;
+    package_version: string | null;
+    missing: string[];
+}
+export interface SelfIndexResult {
+    indexed_files_count: number;
+    ignored_files_count: number;
+    ignored_directories_count: number;
+}
+export interface SelfRunStep {
+    ok: boolean;
+    exit_code: number | null;
+    raw_id: string | null;
+    raw_tokens: number;
+    reduced_tokens: number;
+    summary: string;
+    error?: string;
+}
+export interface SelfBenchResult {
+    ok: boolean;
+    raw_id: string | null;
+    cases_count: number;
+    summary: string;
+    results: BenchResult[];
+    error?: string;
+}
+export interface SelfDogfoodState {
+    doctor?: SelfDoctorResult;
+    index?: SelfIndexResult;
+    build?: SelfRunStep;
+    test?: SelfRunStep;
+    bench?: SelfBenchResult;
+    report_path?: string;
+    errors: string[];
+}
+export interface SelfReportInput extends SelfDogfoodState {
+    root?: string;
+}
+export declare function createEmptySelfState(): SelfDogfoodState;
+export declare function selfDoctor(root?: string): Promise<SelfDoctorResult>;
+export declare function assertSotuRailRepository(root?: string): Promise<SelfDoctorResult>;
+export declare function selfIndex(root?: string): Promise<SelfIndexResult>;
+export declare function selfBuild(root?: string, terminalStdout?: Writable, terminalStderr?: Writable): Promise<SelfRunStep>;
+export declare function selfTest(root?: string, terminalStdout?: Writable, terminalStderr?: Writable): Promise<SelfRunStep>;
+export declare function selfBench(root?: string, terminalStdout?: Writable, terminalStderr?: Writable): Promise<SelfBenchResult>;
+export declare function writeSelfReport(input: SelfReportInput): Promise<string>;
+export declare function selfAll(root?: string, terminalStdout?: Writable, terminalStderr?: Writable): Promise<SelfDogfoodState>;
+export declare function formatSelfDoctor(result: SelfDoctorResult): string;
+export declare function formatSelfIndex(result: SelfIndexResult): string;
+export declare function formatSelfRunStep(label: string, result: SelfRunStep): string;
+export declare function formatSelfBench(result: SelfBenchResult): string;

package/dist/core/self-dogfood.js

@@ -0,0 +1,323 @@
+import { execFile } from "node:child_process";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { PassThrough } from "node:stream";
+import { promisify } from "node:util";
+import { runBenchmarks, summarizeBenchmarkResults } from "../commands/bench.js";
+import { executeRunCommand } from "../commands/run.js";
+import { ensureWorkspace, getWorkspacePaths, loadConfig } from "./config.js";
+import { scanRepository, writeRepoMap } from "./file-scanner.js";
+import { getCurrentGitCommit } from "./git.js";
+import { estimateTokens } from "./token-estimator.js";
+const execFileAsync = promisify(execFile);
+const REQUIRED_SOTURAIL_PATHS = [
+    "package.json",
+    "README.md",
+    "CHANGELOG.md",
+    "ROADMAP.md",
+    path.join("src", "cli.ts"),
+    path.join("src", "commands"),
+    path.join("src", "core"),
+    "tests",
+    "docs"
+];
+export function createEmptySelfState() {
+    return { errors: [] };
+}
+export async function selfDoctor(root = process.cwd()) {
+    const resolvedRoot = path.resolve(root);
+    const missing = [];
+    for (const required of REQUIRED_SOTURAIL_PATHS) {
+        const absolute = path.resolve(resolvedRoot, required);
+        try {
+            await fs.access(absolute);
+        }
+        catch {
+            missing.push(path.normalize(required));
+        }
+    }
+    const packageJson = await readPackageJson(resolvedRoot);
+    if (packageJson.name !== "soturail") {
+        missing.push("package.json:name=soturail");
+    }
+    return {
+        ok: missing.length === 0,
+        root: resolvedRoot,
+        package_name: typeof packageJson.name === "string" ? packageJson.name : null,
+        package_version: typeof packageJson.version === "string" ? packageJson.version : null,
+        missing
+    };
+}
+export async function assertSotuRailRepository(root = process.cwd()) {
+    const doctor = await selfDoctor(root);
+    if (!doctor.ok) {
+        throw new Error(`This directory does not look like the SotuRail repository. Missing: ${doctor.missing.join(", ")}`);
+    }
+    return doctor;
+}
+export async function selfIndex(root = process.cwd()) {
+    await assertSotuRailRepository(root);
+    await ensureWorkspace(root);
+    const config = await loadConfig(root);
+    const repoMap = await scanRepository(root, config);
+    await writeRepoMap(root, repoMap);
+    return {
+        indexed_files_count: repoMap.total_files,
+        ignored_files_count: repoMap.stats.ignored_files,
+        ignored_directories_count: repoMap.stats.ignored_directories
+    };
+}
+export async function selfBuild(root = process.cwd(), terminalStdout, terminalStderr) {
+    return selfRunCommand(["npm", "run", "build"], root, terminalStdout, terminalStderr);
+}
+export async function selfTest(root = process.cwd(), terminalStdout, terminalStderr) {
+    return selfRunCommand(["npm", "test"], root, terminalStdout, terminalStderr);
+}
+export async function selfBench(root = process.cwd(), terminalStdout, terminalStderr) {
+    await assertSotuRailRepository(root);
+    const cliPath = path.resolve(root, "dist", "cli.js");
+    let runResult = null;
+    try {
+        await fs.access(cliPath);
+        runResult = await executeRunCommand([`"${process.execPath}" "${cliPath}" bench run --engine ts`], {
+            terminalStdout: terminalStdout ?? drainedStream(),
+            terminalStderr: terminalStderr ?? drainedStream(),
+            engine: "ts"
+        }, root);
+    }
+    catch {
+        // If the built CLI is unavailable, the in-process benchmark path still gives a real report.
+    }
+    const results = runResult ? await readLatestBenchmarkResults(root) : await runBenchmarks({ engine: "ts" }, root);
+    return {
+        ok: runResult ? runResult.exitCode === 0 : true,
+        raw_id: runResult?.rawId ?? null,
+        cases_count: results.length,
+        summary: summarizeBenchmarkResults(results),
+        results
+    };
+}
+export async function writeSelfReport(input) {
+    const root = path.resolve(input.root ?? process.cwd());
+    await ensureWorkspace(root);
+    const paths = getWorkspacePaths(root);
+    const reportsDir = path.resolve(paths.workspace, "reports");
+    await fs.mkdir(reportsDir, { recursive: true });
+    const reportPath = path.resolve(reportsDir, "self-dogfood.md");
+    const packageJson = await readPackageJson(root);
+    const commit = await getCurrentGitCommit(root);
+    const branch = await getCurrentGitBranch(root);
+    const accounting = selfTokenAccounting(input);
+    const report = [
+        "# SotuRail Self-Dogfood Report",
+        "",
+        "## Stable Project Description",
+        "",
+        "SotuRail aims to unify terminal compression, progressive repo reading, Spec-Driven workflows, local memory, rules extraction, agent hooks, benchmarks and cache-friendly payloads into one local-first workflow.",
+        "",
+        `- package_name: ${stringOrUnknown(packageJson.name)}`,
+        `- package_version: ${stringOrUnknown(packageJson.version)}`,
+        "- report_schema: self-dogfood-v1",
+        "",
+        "## Stable Quality Rails",
+        "",
+        "- Build, test and benchmark commands should run through SotuRail so raw logs are recoverable.",
+        "- Token counts are deterministic estimates unless provider metadata is explicitly imported.",
+        "- Dynamic raw IDs, timestamps, logs and volatile command status stay below this stable section.",
+        "",
+        "## Dynamic Execution Data",
+        "",
+        `- repository_path: ${path.normalize(root)}`,
+        `- current_git_commit_hash: ${commit ?? "unknown"}`,
+        `- current_branch: ${branch ?? "unknown"}`,
+        `- doctor_ok: ${input.doctor?.ok ?? false}`,
+        `- indexed_files_count: ${input.index?.indexed_files_count ?? 0}`,
+        `- ignored_files_directories_count: ${(input.index?.ignored_files_count ?? 0) + (input.index?.ignored_directories_count ?? 0)}`,
+        `- build_result: ${formatStep(input.build)}`,
+        `- test_result: ${formatStep(input.test)}`,
+        `- benchmark_summary: ${input.bench?.summary.replace(/\r?\n/g, " | ") ?? "not run"}`,
+        `- build_raw_id: ${input.build?.raw_id ?? "n/a"}`,
+        `- test_raw_id: ${input.test?.raw_id ?? "n/a"}`,
+        `- benchmark_raw_id: ${input.bench?.raw_id ?? "n/a"}`,
+        `- estimated_raw_tokens: ${accounting.estimated_raw_tokens}`,
+        `- estimated_reduced_tokens: ${accounting.estimated_reduced_tokens}`,
+        `- estimated_metadata_overhead_tokens: ${accounting.estimated_metadata_overhead_tokens}`,
+        `- compression_effective: ${accounting.compression_effective}`,
+        "",
+        "## Known Limitations",
+        "",
+        "- Native benchmark rows are marked unavailable when the optional native binary is not built.",
+        "- Self-dogfood reports are local evidence, not provider cache-hit evidence.",
+        "- Small command outputs may cost more after metadata, but recovery and audit paths remain valuable.",
+        "",
+        "## Recommended Next Action",
+        "",
+        input.errors.length > 0
+            ? `Review partial failures: ${input.errors.join("; ")}`
+            : "Keep running `soturail self all` before release-oriented commits.",
+        ""
+    ].join("\n");
+    await fs.writeFile(reportPath, report, "utf8");
+    return reportPath;
+}
+export async function selfAll(root = process.cwd(), terminalStdout, terminalStderr) {
+    const state = createEmptySelfState();
+    try {
+        state.doctor = await selfDoctor(root);
+        if (!state.doctor.ok) {
+            state.errors.push(`doctor failed: ${state.doctor.missing.join(", ")}`);
+            state.report_path = await writeSelfReport({ ...state, root });
+            return state;
+        }
+        state.index = await selfIndex(root);
+        state.build = await selfBuild(root, terminalStdout, terminalStderr);
+        if (!state.build.ok) {
+            state.errors.push(`build failed: raw_id=${state.build.raw_id ?? "n/a"}`);
+            state.report_path = await writeSelfReport({ ...state, root });
+            return state;
+        }
+        state.test = await selfTest(root, terminalStdout, terminalStderr);
+        if (!state.test.ok) {
+            state.errors.push(`test failed: raw_id=${state.test.raw_id ?? "n/a"}`);
+            state.report_path = await writeSelfReport({ ...state, root });
+            return state;
+        }
+        state.bench = await selfBench(root, terminalStdout, terminalStderr);
+        if (!state.bench.ok) {
+            state.errors.push(`bench failed: raw_id=${state.bench.raw_id ?? "n/a"}`);
+        }
+    }
+    catch (error) {
+        state.errors.push(error instanceof Error ? error.message : String(error));
+    }
+    state.report_path = await writeSelfReport({ ...state, root });
+    return state;
+}
+export function formatSelfDoctor(result) {
+    return [
+        "SotuRail self doctor",
+        `ok: ${result.ok}`,
+        `root: ${path.normalize(result.root)}`,
+        `package_name: ${result.package_name ?? "unknown"}`,
+        `package_version: ${result.package_version ?? "unknown"}`,
+        `missing: ${result.missing.length === 0 ? "none" : result.missing.join(", ")}`
+    ].join("\n") + "\n";
+}
+export function formatSelfIndex(result) {
+    return [
+        "SotuRail self index",
+        `indexed_files_count: ${result.indexed_files_count}`,
+        `ignored_files_count: ${result.ignored_files_count}`,
+        `ignored_directories_count: ${result.ignored_directories_count}`
+    ].join("\n") + "\n";
+}
+export function formatSelfRunStep(label, result) {
+    return [
+        `SotuRail self ${label}`,
+        `ok: ${result.ok}`,
+        `exit_code: ${result.exit_code ?? "n/a"}`,
+        `raw_id: ${result.raw_id ?? "n/a"}`
+    ].join("\n") + "\n";
+}
+export function formatSelfBench(result) {
+    return [
+        "SotuRail self bench",
+        `ok: ${result.ok}`,
+        `raw_id: ${result.raw_id ?? "n/a"}`,
+        `cases_count: ${result.cases_count}`,
+        result.summary
+    ].join("\n") + "\n";
+}
+function selfTokenAccounting(input) {
+    const estimatedRaw = (input.build?.raw_tokens ?? 0) + (input.test?.raw_tokens ?? 0);
+    const estimatedReduced = (input.build?.reduced_tokens ?? 0) + (input.test?.reduced_tokens ?? 0);
+    const metadata = estimateTokens(JSON.stringify({
+        doctor: input.doctor?.ok,
+        index: input.index,
+        build_raw_id: input.build?.raw_id,
+        test_raw_id: input.test?.raw_id,
+        bench_raw_id: input.bench?.raw_id
+    }));
+    return {
+        estimated_raw_tokens: estimatedRaw,
+        estimated_reduced_tokens: estimatedReduced,
+        estimated_metadata_overhead_tokens: metadata,
+        compression_effective: estimatedReduced + metadata <= estimatedRaw
+    };
+}
+async function selfRunCommand(commandParts, root, terminalStdout, terminalStderr) {
+    await assertSotuRailRepository(root);
+    try {
+        const result = await executeRunCommand(commandParts, {
+            terminalStdout: terminalStdout ?? drainedStream(),
+            terminalStderr: terminalStderr ?? drainedStream(),
+            engine: "ts"
+        }, root);
+        return {
+            ok: result.exitCode === 0,
+            exit_code: result.exitCode,
+            raw_id: result.rawId,
+            raw_tokens: result.record.raw_tokens_estimated,
+            reduced_tokens: result.record.compressed_tokens_estimated,
+            summary: result.summary
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            exit_code: null,
+            raw_id: null,
+            raw_tokens: 0,
+            reduced_tokens: 0,
+            summary: "",
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+async function readPackageJson(root) {
+    try {
+        return JSON.parse(await fs.readFile(path.resolve(root, "package.json"), "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+async function readLatestBenchmarkResults(root) {
+    const filePath = path.resolve(root, "benchmarks", "results", "latest.json");
+    try {
+        const parsed = JSON.parse(await fs.readFile(filePath, "utf8"));
+        return Array.isArray(parsed.results) ? parsed.results : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function getCurrentGitBranch(root) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+            cwd: root,
+            timeout: 3000,
+            windowsHide: true
+        });
+        const branch = stdout.trim();
+        return branch.length > 0 ? branch : null;
+    }
+    catch {
+        return null;
+    }
+}
+function drainedStream() {
+    const stream = new PassThrough();
+    stream.resume();
+    return stream;
+}
+function formatStep(step) {
+    if (!step) {
+        return "not run";
+    }
+    return step.ok ? `pass exit_code=${step.exit_code}` : `fail exit_code=${step.exit_code ?? "n/a"}`;
+}
+function stringOrUnknown(value) {
+    return typeof value === "string" && value.length > 0 ? value : "unknown";
+}
+//# sourceMappingURL=self-dogfood.js.map

package/dist/core/self-dogfood.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-dogfood.js","sourceRoot":"","sources":["../../src/core/self-dogfood.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAA2B,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,uBAAuB,GAAG;IAC9B,cAAc;IACd,WAAW;IACX,cAAc;IACd,YAAY;IACZ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,OAAO;IACP,MAAM;CACP,CAAC;AAiDF,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,QAAQ,IAAI,uBAAuB,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,WAAW,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QACxB,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC5E,eAAe,EAAE,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACrF,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uEAAuE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IAClD,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO;QACL,mBAAmB,EAAE,OAAO,CAAC,WAAW;QACxC,mBAAmB,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa;QAChD,yBAAyB,EAAE,OAAO,CAAC,KAAK,CAAC,mBAAmB;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,cAAyB,EAAE,cAAyB;IACxG,OAAO,cAAc,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,cAAyB,EAAE,cAAyB;IACvG,OAAO,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,cAAyB,EAAE,cAAyB;IACxG,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,SAAS,GAA8B,IAAI,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,SAAS,GAAG,MAAM,iBAAiB,CACjC,CAAC,IAAI,OAAO,CAAC,QAAQ,MAAM,OAAO,yBAAyB,CAAC,EAC5D;YACE,cAAc,EAAE,cAAc,IAAI,aAAa,EAAE;YACjD,cAAc,EAAE,cAAc,IAAI,aAAa,EAAE;YACjD,MAAM,EAAE,IAAI;SACb,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,4FAA4F;IAC9F,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACjH,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/C,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,IAAI;QAChC,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC;QAC3C,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAsB;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG;QACb,gCAAgC;QAChC,EAAE;QACF,+BAA+B;QAC/B,EAAE;QACF,kNAAkN;QAClN,EAAE;QACF,mBAAmB,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QACtD,sBAAsB,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QAC5D,kCAAkC;QAClC,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,+FAA+F;QAC/F,6FAA6F;QAC7F,iGAAiG;QACjG,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QAC5C,8BAA8B,MAAM,IAAI,SAAS,EAAE;QACnD,qBAAqB,MAAM,IAAI,SAAS,EAAE;QAC1C,gBAAgB,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,KAAK,EAAE;QAC3C,0BAA0B,KAAK,CAAC,KAAK,EAAE,mBAAmB,IAAI,CAAC,EAAE;QACjE,sCAAsC,CAAC,KAAK,CAAC,KAAK,EAAE,mBAAmB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,yBAAyB,IAAI,CAAC,CAAC,EAAE;QAC/H,mBAAmB,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAC5C,kBAAkB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAC1C,wBAAwB,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE;QACpF,mBAAmB,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE;QACjD,kBAAkB,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,EAAE;QAC/C,uBAAuB,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE;QACrD,2BAA2B,UAAU,CAAC,oBAAoB,EAAE;QAC5D,+BAA+B,UAAU,CAAC,wBAAwB,EAAE;QACpE,yCAAyC,UAAU,CAAC,kCAAkC,EAAE;QACxF,4BAA4B,UAAU,CAAC,qBAAqB,EAAE;QAC9D,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,8FAA8F;QAC9F,6EAA6E;QAC7E,qGAAqG;QACrG,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,4BAA4B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACvD,CAAC,CAAC,mEAAmE;QACvE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,cAAyB,EAAE,cAAyB;IACtG,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,KAAK,CAAC,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACrB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvE,KAAK,CAAC,WAAW,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,CAAC,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACpB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;YACzE,KAAK,CAAC,WAAW,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;YACvE,KAAK,CAAC,WAAW,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACpB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,KAAK,CAAC,WAAW,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,OAAO;QACL,sBAAsB;QACtB,OAAO,MAAM,CAAC,EAAE,EAAE;QAClB,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACtC,iBAAiB,MAAM,CAAC,YAAY,IAAI,SAAS,EAAE;QACnD,oBAAoB,MAAM,CAAC,eAAe,IAAI,SAAS,EAAE;QACzD,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO;QACL,qBAAqB;QACrB,wBAAwB,MAAM,CAAC,mBAAmB,EAAE;QACpD,wBAAwB,MAAM,CAAC,mBAAmB,EAAE;QACpD,8BAA8B,MAAM,CAAC,yBAAyB,EAAE;KACjE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,MAAmB;IAClE,OAAO;QACL,iBAAiB,KAAK,EAAE;QACxB,OAAO,MAAM,CAAC,EAAE,EAAE;QAClB,cAAc,MAAM,CAAC,SAAS,IAAI,KAAK,EAAE;QACzC,WAAW,MAAM,CAAC,MAAM,IAAI,KAAK,EAAE;KACpC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO;QACL,qBAAqB;QACrB,OAAO,MAAM,CAAC,EAAE,EAAE;QAClB,WAAW,MAAM,CAAC,MAAM,IAAI,KAAK,EAAE;QACnC,gBAAgB,MAAM,CAAC,WAAW,EAAE;QACpC,MAAM,CAAC,OAAO;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAsB;IAMjD,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC;IACpF,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC;IAChG,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7C,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM;QACjC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM;QAC/B,YAAY,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM;KAClC,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,oBAAoB,EAAE,YAAY;QAClC,wBAAwB,EAAE,gBAAgB;QAC1C,kCAAkC,EAAE,QAAQ;QAC5C,qBAAqB,EAAE,gBAAgB,GAAG,QAAQ,IAAI,YAAY;KACnE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,YAAsB,EAAE,IAAY,EAAE,cAAyB,EAAE,cAAyB;IACtH,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE;YACnD,cAAc,EAAE,cAAc,IAAI,aAAa,EAAE;YACjD,cAAc,EAAE,cAAc,IAAI,aAAa,EAAE;YACjD,MAAM,EAAE,IAAI;SACb,EAAE,IAAI,CAAC,CAAC;QACT,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;YACzB,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,MAAM,EAAE,MAAM,CAAC,KAAK;YACpB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB;YAC9C,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,2BAA2B;YACzD,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,CAAC;YACb,cAAc,EAAE,CAAC;YACjB,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;IAC9G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,IAAY;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAgC,CAAC;QAC9F,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;YACnF,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IACjC,MAAM,CAAC,MAAM,EAAE,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,IAA6B;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;AACpG,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/core/version.d.ts

@@ -0,0 +1 @@
+export declare const SOTURAIL_VERSION = "0.2.3";

package/dist/core/version.js

@@ -0,0 +1,3 @@
+// Generated by scripts/sync-version.mjs from package.json. Do not edit manually.
+export const SOTURAIL_VERSION = "0.2.3";
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}

package/docs/benchmarking.md

@@ -18,9 +18,11 @@ The suite groups results as:
 
 - terminal compression;
 - agent response compression;
-- JSON/tool payload compression;
 - knowledge structuring;
-- native performance when available.
+- cache stability;
+- native engine availability/performance when available.
+
+Terminal compression includes npm install noise, Vitest failures, TypeScript diagnostics, git diff/status noise and JSON/tool payload output.
 
 Knowledge-to-Rules is not judged as pure compression. It creates reusable structured rules, citations and validator metadata.