soturail 0.2.1

package/dist/core/document-ingest.js

@@ -0,0 +1,45 @@
+import { createHash } from "node:crypto";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export function isIngestType(value) {
+    return ["rules", "requirements", "docs", "course"].includes(value);
+}
+export async function ingestDocument(file, type, root = process.cwd()) {
+    const absolute = path.resolve(root, file);
+    const extension = path.extname(file).toLowerCase();
+    if (extension === ".pdf") {
+        throw new Error("PDF extraction is experimental in v0.2.0 and not enabled without a safe text extractor.");
+    }
+    const raw = await fs.readFile(absolute, "utf8");
+    const text = extension === ".json" ? JSON.stringify(JSON.parse(raw), null, 2) : raw;
+    const sourceFile = path.normalize(path.relative(root, absolute)).replace(/\\/g, "/");
+    return {
+        source_file: sourceFile,
+        type,
+        text,
+        content_hash: createHash("sha256").update(text).digest("hex"),
+        sections: splitSections(text)
+    };
+}
+function splitSections(text) {
+    const lines = text.split(/\r?\n/);
+    const sections = [];
+    let current = { title: "Document", content: "", start_line: 1 };
+    lines.forEach((line, index) => {
+        const heading = line.match(/^(#{1,6})\s+(.+)$/);
+        if (heading) {
+            if (current.content.trim().length > 0 || sections.length === 0) {
+                sections.push(current);
+            }
+            current = { title: heading[2]?.trim() ?? "Untitled", content: "", start_line: index + 1 };
+        }
+        else {
+            current.content += `${line}\n`;
+        }
+    });
+    if (current.content.trim().length > 0) {
+        sections.push(current);
+    }
+    return sections.filter((section) => section.content.trim().length > 0);
+}
+//# sourceMappingURL=document-ingest.js.map

package/dist/core/document-ingest.js.map

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

package/dist/core/file-scanner.d.ts

@@ -0,0 +1,47 @@
+import type { SotuRailConfig } from "./config.js";
+export interface GitignoreRule {
+    pattern: string;
+    negate: boolean;
+    directoryOnly: boolean;
+    anchored: boolean;
+}
+export interface ExtractedSymbol {
+    name: string;
+    kind: string;
+    line: number;
+}
+export interface ExtractedContract {
+    kind: string;
+    value: string;
+    line: number;
+}
+export interface RepoMapFile {
+    path: string;
+    size_bytes: number;
+    language: string;
+    symbols: ExtractedSymbol[];
+    contracts: ExtractedContract[];
+}
+export interface ScanStats {
+    scanned_files: number;
+    ignored_files: number;
+    ignored_directories: number;
+}
+export interface RepoMap {
+    title: "Heuristic Repo Map";
+    generated_at: string;
+    root: string;
+    total_files: number;
+    stats: ScanStats;
+    files: RepoMapFile[];
+}
+export declare function normalizeForIgnore(inputPath: string): string;
+export declare function parseGitignore(content: string): GitignoreRule[];
+export declare function isIgnoredByRules(relativePath: string, isDirectory: boolean, rules: GitignoreRule[]): boolean;
+export declare function isAlwaysIgnored(relativePath: string, isDirectory: boolean): boolean;
+export declare function scanRepository(root: string, config: SotuRailConfig): Promise<RepoMap>;
+export declare function buildTreeText(repoMap: RepoMap): string;
+export declare function writeRepoMap(root: string, repoMap: RepoMap): Promise<{
+    repoMapPath: string;
+    treePath: string;
+}>;

package/dist/core/file-scanner.js

@@ -0,0 +1,248 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { writeJson } from "./config.js";
+const ALWAYS_IGNORED_DIRS = new Set([".git", "node_modules", "dist", "build", "coverage"]);
+const ALWAYS_IGNORED_PATH_PREFIXES = [".soturail/raw"];
+export function normalizeForIgnore(inputPath) {
+    return path
+        .normalize(inputPath)
+        .replace(/\\/g, "/")
+        .replace(/^\.\//, "")
+        .replace(/^\/+/, "");
+}
+export function parseGitignore(content) {
+    return content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("#"))
+        .map((line) => {
+        const negate = line.startsWith("!");
+        const withoutNegation = negate ? line.slice(1) : line;
+        const directoryOnly = withoutNegation.endsWith("/");
+        const anchored = withoutNegation.startsWith("/");
+        const clean = normalizeForIgnore(withoutNegation.replace(/^\/+/, "").replace(/\/+$/, ""));
+        return { pattern: clean, negate, directoryOnly, anchored };
+    })
+        .filter((rule) => rule.pattern.length > 0);
+}
+function globToRegExp(pattern) {
+    const escaped = pattern
+        .split("*")
+        .map((part) => part.replace(/[.+?^${}()|[\]\\]/g, "\\$&"))
+        .join("[^/]*");
+    return new RegExp(`^${escaped}$`);
+}
+function basename(relativePath) {
+    const normalized = normalizeForIgnore(relativePath);
+    const parts = normalized.split("/");
+    return parts[parts.length - 1] ?? normalized;
+}
+function ruleMatches(rule, relativePath, isDirectory) {
+    const normalized = normalizeForIgnore(relativePath);
+    if (rule.directoryOnly && !isDirectory && !normalized.startsWith(`${rule.pattern}/`)) {
+        return false;
+    }
+    if (rule.directoryOnly) {
+        return normalized === rule.pattern || normalized.startsWith(`${rule.pattern}/`);
+    }
+    if (rule.pattern.includes("*")) {
+        const target = rule.anchored || rule.pattern.includes("/") ? normalized : basename(normalized);
+        return globToRegExp(rule.pattern).test(target);
+    }
+    if (rule.anchored || rule.pattern.includes("/")) {
+        return normalized === rule.pattern || normalized.startsWith(`${rule.pattern}/`);
+    }
+    return normalized.split("/").includes(rule.pattern) || basename(normalized) === rule.pattern;
+}
+export function isIgnoredByRules(relativePath, isDirectory, rules) {
+    let ignored = false;
+    for (const rule of rules) {
+        if (ruleMatches(rule, relativePath, isDirectory)) {
+            ignored = !rule.negate;
+        }
+    }
+    return ignored;
+}
+export function isAlwaysIgnored(relativePath, isDirectory) {
+    const normalized = normalizeForIgnore(relativePath);
+    const firstSegment = normalized.split("/")[0] ?? normalized;
+    if (isDirectory && ALWAYS_IGNORED_DIRS.has(firstSegment)) {
+        return true;
+    }
+    if (ALWAYS_IGNORED_DIRS.has(firstSegment)) {
+        return true;
+    }
+    return ALWAYS_IGNORED_PATH_PREFIXES.some((prefix) => normalized === prefix || normalized.startsWith(`${prefix}/`));
+}
+function extensionOf(relativePath) {
+    return path.extname(relativePath).replace(".", "").toLowerCase();
+}
+function languageFor(relativePath) {
+    const ext = extensionOf(relativePath);
+    if (["ts", "tsx", "js", "jsx", "mjs", "cjs"].includes(ext)) {
+        return "typescript/javascript";
+    }
+    if (ext === "py") {
+        return "python";
+    }
+    if (ext === "java") {
+        return "java";
+    }
+    if (ext === "json") {
+        return "json";
+    }
+    if (["md", "mdx"].includes(ext)) {
+        return "markdown";
+    }
+    return ext.length > 0 ? ext : "text";
+}
+function extractSymbols(relativePath, text) {
+    const language = languageFor(relativePath);
+    const lines = text.split(/\r?\n/);
+    const symbols = [];
+    const contracts = [];
+    lines.forEach((line, index) => {
+        const lineNumber = index + 1;
+        const trimmed = line.trim();
+        const contractMatch = trimmed.match(/^(?:import|export)\s+.+/);
+        if (contractMatch && ["typescript/javascript", "python"].includes(language)) {
+            contracts.push({ kind: "module-boundary", value: trimmed.slice(0, 200), line: lineNumber });
+        }
+        if (language === "typescript/javascript") {
+            const symbolMatch = trimmed.match(/^(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:class|interface|type|function|const|let|var)\s+([A-Za-z_$][\w$]*)/);
+            if (symbolMatch?.[1]) {
+                const kind = trimmed.includes("class")
+                    ? "class"
+                    : trimmed.includes("interface")
+                        ? "interface"
+                        : trimmed.includes("type")
+                            ? "type"
+                            : trimmed.includes("function")
+                                ? "function"
+                                : "value";
+                symbols.push({ name: symbolMatch[1], kind, line: lineNumber });
+            }
+            return;
+        }
+        if (language === "python") {
+            const symbolMatch = trimmed.match(/^(?:async\s+)?(?:def|class)\s+([A-Za-z_][\w]*)/);
+            if (symbolMatch?.[1]) {
+                symbols.push({ name: symbolMatch[1], kind: trimmed.startsWith("class") ? "class" : "function", line: lineNumber });
+            }
+            return;
+        }
+        if (language === "java") {
+            const classMatch = trimmed.match(/\b(?:class|interface|enum|record)\s+([A-Za-z_][\w]*)/);
+            if (classMatch?.[1]) {
+                symbols.push({ name: classMatch[1], kind: "type", line: lineNumber });
+            }
+            const methodMatch = trimmed.match(/^(?:public|private|protected)?\s*(?:static\s+)?(?:final\s+)?[\w<>\[\]]+\s+([A-Za-z_][\w]*)\s*\([^)]*\)\s*(?:throws\s+[\w,\s]+)?\{?$/);
+            if (methodMatch?.[1] && !["if", "for", "while", "switch"].includes(methodMatch[1])) {
+                symbols.push({ name: methodMatch[1], kind: "method", line: lineNumber });
+            }
+        }
+    });
+    return { symbols, contracts };
+}
+async function readGitignore(root) {
+    try {
+        const raw = await fs.readFile(path.resolve(root, ".gitignore"), "utf8");
+        return parseGitignore(raw);
+    }
+    catch {
+        return [];
+    }
+}
+export async function scanRepository(root, config) {
+    const resolvedRoot = path.resolve(root);
+    const rules = await readGitignore(resolvedRoot);
+    const files = [];
+    const stats = { scanned_files: 0, ignored_files: 0, ignored_directories: 0 };
+    const ignoredExtensions = new Set(config.ignore_extensions.map((ext) => ext.replace(/^\./, "").toLowerCase()));
+    const maxBytes = config.max_file_size_kb * 1024;
+    async function walk(current) {
+        const entries = await fs.readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const absolute = path.resolve(current, entry.name);
+            const relative = normalizeForIgnore(path.relative(resolvedRoot, absolute));
+            if (entry.isSymbolicLink()) {
+                stats.ignored_files += 1;
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (isAlwaysIgnored(relative, true) || isIgnoredByRules(relative, true, rules)) {
+                    stats.ignored_directories += 1;
+                    continue;
+                }
+                await walk(absolute);
+                continue;
+            }
+            if (!entry.isFile()) {
+                stats.ignored_files += 1;
+                continue;
+            }
+            if (isAlwaysIgnored(relative, false) || isIgnoredByRules(relative, false, rules)) {
+                stats.ignored_files += 1;
+                continue;
+            }
+            if (ignoredExtensions.has(extensionOf(relative))) {
+                stats.ignored_files += 1;
+                continue;
+            }
+            const fileStats = await fs.stat(absolute);
+            if (fileStats.size > maxBytes) {
+                stats.ignored_files += 1;
+                continue;
+            }
+            let text = "";
+            try {
+                text = await fs.readFile(absolute, "utf8");
+            }
+            catch {
+                stats.ignored_files += 1;
+                continue;
+            }
+            const extracted = extractSymbols(relative, text);
+            files.push({
+                path: relative,
+                size_bytes: fileStats.size,
+                language: languageFor(relative),
+                symbols: extracted.symbols,
+                contracts: extracted.contracts
+            });
+            stats.scanned_files += 1;
+        }
+    }
+    await walk(resolvedRoot);
+    files.sort((left, right) => left.path.localeCompare(right.path));
+    return {
+        title: "Heuristic Repo Map",
+        generated_at: new Date().toISOString(),
+        root: path.basename(resolvedRoot),
+        total_files: files.length,
+        stats,
+        files
+    };
+}
+export function buildTreeText(repoMap) {
+    const lines = [
+        "Heuristic Repo Map",
+        `Root: ${repoMap.root}`,
+        `Files indexed: ${repoMap.total_files}`,
+        ""
+    ];
+    for (const file of repoMap.files) {
+        const symbols = file.symbols.map((symbol) => `${symbol.kind}:${symbol.name}`).join(", ");
+        lines.push(`${file.path} (${file.language}, ${file.size_bytes} bytes)${symbols ? ` - ${symbols}` : ""}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+export async function writeRepoMap(root, repoMap) {
+    const indexesDir = path.resolve(root, ".soturail", "indexes");
+    const repoMapPath = path.resolve(indexesDir, "repo-map.json");
+    const treePath = path.resolve(indexesDir, "tree.txt");
+    await writeJson(repoMapPath, repoMap);
+    await fs.writeFile(treePath, buildTreeText(repoMap), "utf8");
+    return { repoMapPath, treePath };
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/core/file-scanner.js.map

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

package/dist/core/git.d.ts

@@ -0,0 +1,2 @@
+export declare function getCurrentGitCommit(root?: string): Promise<string | null>;
+export declare function hashFile(filePath: string): Promise<string | null>;

package/dist/core/git.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { promises as fs } from "node:fs";
+import { createHash } from "node:crypto";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function getCurrentGitCommit(root = process.cwd()) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
+            cwd: root,
+            timeout: 3000,
+            windowsHide: true
+        });
+        const hash = stdout.trim();
+        return hash.length > 0 ? hash : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function hashFile(filePath) {
+    try {
+        const buffer = await fs.readFile(filePath);
+        return createHash("sha256").update(buffer).digest("hex");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5D,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;YACnE,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/metrics-store.d.ts

@@ -0,0 +1,20 @@
+export type MetricEventType = "command_run" | "expand" | "omission_report" | "doctor_cache" | "response_format" | "rules_ingest" | "rules_check" | "hook_install" | "dedupe_hit" | "bench_run";
+export interface MetricEvent {
+    type: MetricEventType;
+    created_at: string;
+    raw_id?: string;
+    command?: string;
+    exit_code?: number;
+    raw_tokens_estimated?: number;
+    compressed_tokens_estimated?: number;
+    estimated_cache_stability_score?: number;
+    details?: Record<string, unknown>;
+}
+export declare class MetricsStore {
+    private readonly root;
+    constructor(root?: string);
+    append(event: Omit<MetricEvent, "created_at"> & {
+        created_at?: string;
+    }): Promise<void>;
+    readAll(): Promise<MetricEvent[]>;
+}

package/dist/core/metrics-store.js

@@ -0,0 +1,19 @@
+import { getWorkspacePaths, appendJsonl, readJsonl } from "./config.js";
+export class MetricsStore {
+    root;
+    constructor(root = process.cwd()) {
+        this.root = root;
+    }
+    async append(event) {
+        const paths = getWorkspacePaths(this.root);
+        await appendJsonl(paths.metricsFile, {
+            ...event,
+            created_at: event.created_at ?? new Date().toISOString()
+        });
+    }
+    async readAll() {
+        const paths = getWorkspacePaths(this.root);
+        return readJsonl(paths.metricsFile);
+    }
+}
+//# sourceMappingURL=metrics-store.js.map

package/dist/core/metrics-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-store.js","sourceRoot":"","sources":["../../src/core/metrics-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA0BxE,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,OAAO,OAAO,CAAC,GAAG,EAAE;QAApB,SAAI,GAAJ,IAAI,CAAgB;IAAG,CAAC;IAErD,KAAK,CAAC,MAAM,CAAC,KAAgE;QAC3E,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE;YACnC,GAAG,KAAK;YACR,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACzD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,SAAS,CAAc,KAAK,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/core/native-engine.d.ts

@@ -0,0 +1,25 @@
+import type { Writable } from "node:stream";
+export type ReductionKind = "reduce-generic" | "reduce-git" | "reduce-test" | "reduce-json";
+export type ReducerEngine = "ts" | "native" | "auto";
+export interface NativeEngineInfo {
+    available: boolean;
+    path: string | null;
+    version: string | null;
+    checked_paths: string[];
+}
+export declare function detectNativeEngine(root?: string): Promise<NativeEngineInfo>;
+export interface NativeRunOptions {
+    commandParts: string[];
+    rawLogPath: string;
+    summaryJsonPath: string;
+    cwd?: string;
+    interactive?: boolean;
+    terminalStdout?: Writable;
+    terminalStderr?: Writable;
+}
+export interface NativeRunResult {
+    exitCode: number;
+    summary: Record<string, unknown>;
+}
+export declare function runWithNative(options: NativeRunOptions, root?: string): Promise<NativeRunResult | null>;
+export declare function reduceWithNative(kind: ReductionKind, input: string, rawId: string, root?: string): Promise<string | null>;

package/dist/core/native-engine.js

@@ -0,0 +1,137 @@
+import { execFile, spawn } from "node:child_process";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+function executableName() {
+    return process.platform === "win32" ? "soturail-native.exe" : "soturail-native";
+}
+async function isExecutable(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        return stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function pathLookup() {
+    const command = process.platform === "win32" ? "where" : "which";
+    try {
+        const { stdout } = await execFileAsync(command, ["soturail-native"], { windowsHide: true, timeout: 3000 });
+        const first = stdout.split(/\r?\n/).find((line) => line.trim().length > 0);
+        return first?.trim() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectNativeEngine(root = process.cwd()) {
+    const name = executableName();
+    const candidates = [
+        path.resolve(root, "native", "soturail-native", "target", "release", name),
+        path.resolve(root, "native", "soturail-native", "target", "debug", name),
+        path.resolve(root, "dist", "native", name)
+    ];
+    const checked = [...candidates];
+    const onPath = await pathLookup();
+    if (onPath) {
+        candidates.push(onPath);
+        checked.push(onPath);
+    }
+    const found = await firstExisting(candidates);
+    if (!found) {
+        return { available: false, path: null, version: null, checked_paths: checked };
+    }
+    try {
+        const { stdout } = await execFileAsync(found, ["--version"], { windowsHide: true, timeout: 3000 });
+        return { available: true, path: found, version: stdout.trim(), checked_paths: checked };
+    }
+    catch {
+        return { available: true, path: found, version: null, checked_paths: checked };
+    }
+}
+export async function runWithNative(options, root = process.cwd()) {
+    const info = await detectNativeEngine(root);
+    if (!info.path) {
+        return null;
+    }
+    const args = [
+        "run",
+        "--raw-log",
+        options.rawLogPath,
+        "--summary-json",
+        options.summaryJsonPath,
+        "--reducer",
+        "auto"
+    ];
+    if (options.interactive) {
+        args.push("--interactive");
+    }
+    args.push("--", ...nativeCommandParts(options.commandParts));
+    return new Promise((resolve) => {
+        const child = spawn(info.path, args, {
+            cwd: options.cwd ?? root,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: !options.interactive
+        });
+        child.stdout.on("data", (chunk) => (options.terminalStdout ?? process.stdout).write(chunk));
+        child.stderr.on("data", (chunk) => (options.terminalStderr ?? process.stderr).write(chunk));
+        if (options.interactive && child.stdin && process.stdin.readable) {
+            process.stdin.pipe(child.stdin);
+        }
+        else {
+            child.stdin.end();
+        }
+        child.on("error", () => resolve(null));
+        child.on("close", async (code) => {
+            if (options.interactive && child.stdin) {
+                process.stdin.unpipe(child.stdin);
+            }
+            let summary = {};
+            try {
+                summary = JSON.parse(await fs.readFile(options.summaryJsonPath, "utf8"));
+            }
+            catch {
+                summary = {};
+            }
+            resolve({ exitCode: typeof code === "number" ? code : 1, summary });
+        });
+    });
+}
+function nativeCommandParts(parts) {
+    if (parts.length === 1 && /\s/.test(parts[0] ?? "")) {
+        const command = parts[0] ?? "";
+        return process.platform === "win32" ? ["cmd.exe", "/d", "/s", "/c", command] : ["sh", "-c", command];
+    }
+    return parts;
+}
+async function firstExisting(candidates) {
+    for (const candidate of candidates) {
+        if (await isExecutable(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+export async function reduceWithNative(kind, input, rawId, root = process.cwd()) {
+    const info = await detectNativeEngine(root);
+    if (!info.path) {
+        return null;
+    }
+    return new Promise((resolve) => {
+        const child = spawn(info.path, [kind, "--raw-id", rawId], {
+            cwd: root,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true
+        });
+        const stdout = [];
+        child.stdout.on("data", (chunk) => stdout.push(Buffer.from(chunk)));
+        child.on("error", () => resolve(null));
+        child.on("close", (code) => {
+            resolve(code === 0 ? Buffer.concat(stdout).toString("utf8") : null);
+        });
+        child.stdin.end(input);
+    });
+}
+//# sourceMappingURL=native-engine.js.map

package/dist/core/native-engine.js.map

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

package/dist/core/native-runner-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { Writable } from "node:stream";
+export interface RunnerOptions {
+    command: string;
+    cwd?: string;
+    interactive?: boolean;
+    rawLogStream: Writable;
+    terminalStdout?: Writable;
+    terminalStderr?: Writable;
+    env?: NodeJS.ProcessEnv;
+}
+export interface RunnerResult {
+    exitCode: number;
+    signal: NodeJS.Signals | null;
+    rawText: string;
+}
+export declare class NativeRunnerAdapter {
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}