soturail 0.2.1

package/dist/commands/memory.d.ts

@@ -0,0 +1,39 @@
+import type { Command } from "commander";
+export interface MemoryRecord {
+    timestamp: string;
+    git_commit: string | null;
+    content: string;
+    scope?: string;
+    file_hash?: string;
+}
+export interface MemoryAddOptions {
+    file?: string;
+    source?: "manual" | "agent" | "import";
+}
+export interface PendingMemoryRecord {
+    id: string;
+    created_at: string;
+    git_commit: string | null;
+    text: string;
+    source: "manual" | "agent" | "import";
+    file_hashes?: Record<string, string>;
+    status: "pending" | "rejected";
+}
+export interface ApprovedMemoryRecord {
+    id: string;
+    created_at: string;
+    approved_at: string;
+    git_commit: string | null;
+    text: string;
+    source: "manual" | "agent" | "import";
+    file_hashes?: Record<string, string>;
+    stale?: boolean;
+}
+export declare function addMemory(content: string, options?: MemoryAddOptions, root?: string): Promise<MemoryRecord>;
+export declare function proposeMemory(text: string, options?: MemoryAddOptions, root?: string): Promise<PendingMemoryRecord>;
+export declare function approveMemory(id: string, root?: string): Promise<ApprovedMemoryRecord>;
+export declare function rejectMemory(id: string, root?: string): Promise<string>;
+export declare function listMemory(kind: "pending" | "approved", root?: string): Promise<string>;
+export declare function pruneStaleMemory(root?: string): Promise<string>;
+export declare function searchMemory(term: string, root?: string): Promise<string[]>;
+export declare function registerMemoryCommand(program: Command): void;

package/dist/commands/memory.js

@@ -0,0 +1,184 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { appendJsonl, ensureWorkspace, getWorkspacePaths, readJsonl } from "../core/config.js";
+import { getCurrentGitCommit, hashFile } from "../core/git.js";
+export async function addMemory(content, options = {}, root = process.cwd()) {
+    await ensureWorkspace(root);
+    const paths = getWorkspacePaths(root);
+    const record = {
+        timestamp: new Date().toISOString(),
+        git_commit: await getCurrentGitCommit(root),
+        content
+    };
+    if (options.file) {
+        const absolute = path.resolve(root, options.file);
+        const digest = await hashFile(absolute);
+        record.scope = path.normalize(path.relative(root, absolute)).replace(/\\/g, "/");
+        if (digest) {
+            record.file_hash = digest;
+        }
+    }
+    await appendJsonl(paths.memoryFile, record);
+    return record;
+}
+function memoryId(text) {
+    let hash = 0;
+    for (const char of `${text}${Date.now()}`) {
+        hash = ((hash << 5) - hash + char.charCodeAt(0)) | 0;
+    }
+    return `mem_${Math.abs(hash).toString(36)}`;
+}
+async function fileHashes(root, file) {
+    if (!file) {
+        return undefined;
+    }
+    const absolute = path.resolve(root, file);
+    const digest = await hashFile(absolute);
+    return digest ? { [path.normalize(path.relative(root, absolute)).replace(/\\/g, "/")]: digest } : undefined;
+}
+export async function proposeMemory(text, options = {}, root = process.cwd()) {
+    await ensureWorkspace(root);
+    const paths = getWorkspacePaths(root);
+    const record = {
+        id: memoryId(text),
+        created_at: new Date().toISOString(),
+        git_commit: await getCurrentGitCommit(root),
+        text,
+        source: options.source ?? "manual",
+        status: "pending"
+    };
+    const hashes = await fileHashes(root, options.file);
+    if (hashes) {
+        record.file_hashes = hashes;
+    }
+    await appendJsonl(paths.memoryPendingFile, record);
+    return record;
+}
+export async function approveMemory(id, root = process.cwd()) {
+    await ensureWorkspace(root);
+    const paths = getWorkspacePaths(root);
+    const pending = await readJsonl(paths.memoryPendingFile);
+    const record = pending.find((item) => item.id === id && item.status === "pending");
+    if (!record) {
+        throw new Error(`Pending memory ${id} not found.`);
+    }
+    const approved = {
+        id: record.id,
+        created_at: record.created_at,
+        approved_at: new Date().toISOString(),
+        git_commit: record.git_commit,
+        text: record.text,
+        source: record.source
+    };
+    if (record.file_hashes) {
+        approved.file_hashes = record.file_hashes;
+    }
+    await appendJsonl(paths.memoryApprovedFile, approved);
+    await appendJsonl(paths.memoryFile, { ...approved, content: `[approved] ${approved.text}`, approved: true });
+    return approved;
+}
+export async function rejectMemory(id, root = process.cwd()) {
+    await ensureWorkspace(root);
+    const paths = getWorkspacePaths(root);
+    const pending = await readJsonl(paths.memoryPendingFile);
+    let found = false;
+    const next = pending.map((item) => {
+        if (item.id === id) {
+            found = true;
+            return { ...item, status: "rejected" };
+        }
+        return item;
+    });
+    await fs.writeFile(paths.memoryPendingFile, next.map((item) => JSON.stringify(item)).join("\n") + "\n", "utf8");
+    if (!found) {
+        throw new Error(`Pending memory ${id} not found.`);
+    }
+    return `Rejected memory ${id}\n`;
+}
+export async function listMemory(kind, root = process.cwd()) {
+    const paths = getWorkspacePaths(root);
+    if (kind === "pending") {
+        const records = (await readJsonl(paths.memoryPendingFile)).filter((item) => item.status === "pending");
+        return records.length > 0 ? `${records.map((item) => `${item.id} ${item.text}`).join("\n")}\n` : "No pending memory.\n";
+    }
+    const records = await readJsonl(paths.memoryApprovedFile);
+    return records.length > 0 ? `${records.map((item) => `${item.id}${item.stale ? " [stale]" : ""} ${item.text}`).join("\n")}\n` : "No approved memory.\n";
+}
+export async function pruneStaleMemory(root = process.cwd()) {
+    const paths = getWorkspacePaths(root);
+    const approved = await readJsonl(paths.memoryApprovedFile);
+    let staleCount = 0;
+    const next = [];
+    for (const record of approved) {
+        let stale = false;
+        for (const [file, expected] of Object.entries(record.file_hashes ?? {})) {
+            const actual = await hashFile(path.resolve(root, file));
+            if (actual && actual !== expected) {
+                stale = true;
+            }
+        }
+        if (stale) {
+            staleCount += 1;
+            next.push({ ...record, stale: true });
+        }
+        else {
+            next.push(record);
+        }
+    }
+    await fs.writeFile(paths.memoryApprovedFile, next.map((item) => JSON.stringify(item)).join("\n") + (next.length > 0 ? "\n" : ""), "utf8");
+    return `Marked stale approved memory entries: ${staleCount}\n`;
+}
+export async function searchMemory(term, root = process.cwd()) {
+    const paths = getWorkspacePaths(root);
+    try {
+        const raw = await fs.readFile(paths.memoryFile, "utf8");
+        const needle = term.toLowerCase();
+        return raw
+            .split(/\r?\n/)
+            .filter((line) => line.trim().length > 0 && line.toLowerCase().includes(needle));
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+}
+export function registerMemoryCommand(program) {
+    const memory = program.command("memory").description("Manage local Git-linked memory records.");
+    memory
+        .command("add")
+        .description("Append a local memory JSONL record.")
+        .argument("<content>", "Memory content")
+        .option("--file <path>", "Optional file scope to hash and link")
+        .action(async (content, options) => {
+        const record = await addMemory(content, options);
+        process.stdout.write(`Memory added at ${record.timestamp}\n`);
+    });
+    memory
+        .command("search")
+        .description("Search local memory JSONL records by string.")
+        .argument("<term>", "Search term")
+        .action(async (term) => {
+        const matches = await searchMemory(term);
+        process.stdout.write(matches.length > 0 ? `${matches.join("\n")}\n` : "No memory records matched.\n");
+    });
+    memory.command("propose").description("Create a pending memory record.").argument("<text>", "Memory text").option("--file <path>", "Optional file scope").option("--source <source>", "manual, agent, or import", "manual").action(async (text, options) => {
+        const record = await proposeMemory(text, options);
+        process.stdout.write(`Proposed memory ${record.id}\n`);
+    });
+    memory.command("approve").description("Approve a pending memory record.").argument("<id>", "Memory id").action(async (id) => {
+        const record = await approveMemory(id);
+        process.stdout.write(`Approved memory ${record.id}\n`);
+    });
+    memory.command("reject").description("Reject a pending memory record.").argument("<id>", "Memory id").action(async (id) => {
+        process.stdout.write(await rejectMemory(id));
+    });
+    memory.command("list").description("List pending or approved memory.").option("--pending", "List pending memory").option("--approved", "List approved memory").action(async (options) => {
+        process.stdout.write(await listMemory(options.approved ? "approved" : "pending"));
+    });
+    memory.command("prune").description("Mark approved memory stale when linked file hashes changed.").option("--stale", "Prune stale entries").action(async () => {
+        process.stdout.write(await pruneStaleMemory());
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/commands/memory.js.map

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

package/dist/commands/native.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerNativeCommand(program: Command): void;

package/dist/commands/native.js

@@ -0,0 +1,17 @@
+import { detectNativeEngine } from "../core/native-engine.js";
+export function registerNativeCommand(program) {
+    const native = program.command("native").description("Inspect the optional Rust native reducer engine.");
+    native.command("doctor").description("Check native reducer availability.").action(async () => {
+        const info = await detectNativeEngine();
+        const lines = [
+            "SotuRail native doctor",
+            `available: ${info.available}`,
+            `path: ${info.path ?? "not found"}`,
+            `version: ${info.version ?? "unknown"}`,
+            "checked_paths:",
+            ...info.checked_paths.map((item) => `  - ${item}`)
+        ];
+        process.stdout.write(`${lines.join("\n")}\n`);
+    });
+}
+//# sourceMappingURL=native.js.map

package/dist/commands/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/commands/native.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,kDAAkD,CAAC,CAAC;IAEzG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;QAC3F,MAAM,IAAI,GAAG,MAAM,kBAAkB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG;YACZ,wBAAwB;YACxB,cAAc,IAAI,CAAC,SAAS,EAAE;YAC9B,SAAS,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE;YACnC,YAAY,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE;YACvC,gBAAgB;YAChB,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;SACnD,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/read.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+export interface ReadOptions {
+    query?: string;
+    full?: boolean;
+}
+export declare function formatProgressiveRead(filePath: string, content: string, options?: ReadOptions): string;
+export declare function readCommand(file: string, options: ReadOptions, root?: string): Promise<string>;
+export declare function registerReadCommand(program: Command): void;

package/dist/commands/read.js

@@ -0,0 +1,87 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+function prefixLine(lineNumber, content) {
+    return `[Line ${lineNumber}]: ${content}`;
+}
+function mergeRanges(ranges, maxLine) {
+    const normalized = ranges
+        .map((range) => ({
+        start: Math.max(1, Math.min(maxLine, range.start)),
+        end: Math.max(1, Math.min(maxLine, range.end))
+    }))
+        .filter((range) => range.start <= range.end)
+        .sort((left, right) => left.start - right.start);
+    const merged = [];
+    for (const range of normalized) {
+        const last = merged[merged.length - 1];
+        if (!last || range.start > last.end + 1) {
+            merged.push({ ...range });
+        }
+        else {
+            last.end = Math.max(last.end, range.end);
+        }
+    }
+    return merged;
+}
+function queryMatches(lines, query) {
+    const trimmed = query.trim().toLowerCase();
+    if (trimmed.length === 0) {
+        return [];
+    }
+    const terms = trimmed.split(/\s+/).filter((term) => term.length > 2);
+    const needles = terms.length > 0 ? terms : [trimmed];
+    return lines.flatMap((line, index) => {
+        const lower = line.toLowerCase();
+        if (needles.some((term) => lower.includes(term))) {
+            const lineNumber = index + 1;
+            return [{ start: lineNumber - 5, end: lineNumber + 5 }];
+        }
+        return [];
+    });
+}
+export function formatProgressiveRead(filePath, content, options = {}) {
+    const lines = content.split(/\r?\n/);
+    const shouldPrintFull = options.full === true || lines.length <= 150;
+    if (shouldPrintFull) {
+        return `${lines.map((line, index) => prefixLine(index + 1, line)).join("\n")}\n`;
+    }
+    const ranges = mergeRanges([
+        { start: 1, end: 15 },
+        ...queryMatches(lines, options.query ?? ""),
+        { start: Math.max(1, lines.length - 9), end: lines.length }
+    ], lines.length);
+    const output = [];
+    let previousEnd = 0;
+    for (const range of ranges) {
+        if (range.start > previousEnd + 1) {
+            output.push(`[Collapsed lines ${previousEnd + 1}-${range.start - 1}. Re-expand with: soturail read ${filePath} --full]`);
+        }
+        for (let lineNumber = range.start; lineNumber <= range.end; lineNumber += 1) {
+            output.push(prefixLine(lineNumber, lines[lineNumber - 1] ?? ""));
+        }
+        previousEnd = range.end;
+    }
+    if (previousEnd < lines.length) {
+        output.push(`[Collapsed lines ${previousEnd + 1}-${lines.length}. Re-expand with: soturail read ${filePath} --full]`);
+    }
+    output.push("", `Full file escape hatch: soturail read ${filePath} --full`);
+    return `${output.join("\n")}\n`;
+}
+export async function readCommand(file, options, root = process.cwd()) {
+    const absolute = path.resolve(root, file);
+    const content = await fs.readFile(absolute, "utf8");
+    return formatProgressiveRead(file, content, options);
+}
+export function registerReadCommand(program) {
+    program
+        .command("read")
+        .description("Read a file progressively with line prefixes.")
+        .argument("<file>", "File to read")
+        .option("-q, --query <query>", "Goal/query used to select relevant blocks")
+        .option("--full", "Print the full file")
+        .action(async (file, options) => {
+        const output = await readCommand(file, options);
+        process.stdout.write(output);
+    });
+}
+//# sourceMappingURL=read.js.map

package/dist/commands/read.js.map

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

package/dist/commands/rules.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+export declare function listRules(root?: string): Promise<string>;
+export declare function checkRules(root?: string): Promise<string>;
+export declare function exportRules(format: string, root?: string): Promise<string>;
+export declare function registerRulesCommand(program: Command): void;

package/dist/commands/rules.js

@@ -0,0 +1,62 @@
+import { promises as fs } from "node:fs";
+import { ensureWorkspace, getWorkspacePaths } from "../core/config.js";
+import { MetricsStore } from "../core/metrics-store.js";
+import { parseRulesYaml, rulesToYaml } from "../core/rule-extractor.js";
+import { validateRules } from "../core/rule-validator.js";
+async function readRules(root = process.cwd()) {
+    const paths = getWorkspacePaths(root);
+    try {
+        return parseRulesYaml(await fs.readFile(paths.rulesFile, "utf8"));
+    }
+    catch {
+        return [];
+    }
+}
+export async function listRules(root = process.cwd()) {
+    const rules = await readRules(root);
+    if (rules.length === 0) {
+        return "No rules found. Run soturail ingest <file> --type docs first.\n";
+    }
+    return `${rules.map((rule) => `${rule.id} [${rule.severity}] ${rule.title} (${rule.validation_type})`).join("\n")}\n`;
+}
+export async function checkRules(root = process.cwd()) {
+    await ensureWorkspace(root);
+    const rules = await readRules(root);
+    const results = await validateRules(rules, root);
+    const success = results.filter((item) => item.ok).length;
+    const failure = results.length - success;
+    await new MetricsStore(root).append({
+        type: "rules_check",
+        details: { validator_success_count: success, validator_failure_count: failure, rules_count: rules.length }
+    });
+    return [
+        "SotuRail rules check",
+        `rules: ${rules.length}`,
+        `validator_success_count: ${success}`,
+        `validator_failure_count: ${failure}`,
+        ...results.map((item) => `${item.ok ? "OK" : "FAIL"} ${item.rule_id} ${item.title}: ${item.message}`)
+    ].join("\n") + "\n";
+}
+export async function exportRules(format, root = process.cwd()) {
+    const rules = await readRules(root);
+    if (format === "json") {
+        return `${JSON.stringify(rules, null, 2)}\n`;
+    }
+    if (format === "yaml") {
+        return rulesToYaml(rules);
+    }
+    throw new Error(`Unknown export format "${format}".`);
+}
+export function registerRulesCommand(program) {
+    const rules = program.command("rules").description("List, validate and export extracted SotuRail rules.");
+    rules.command("list").description("List extracted rules.").action(async () => {
+        process.stdout.write(await listRules());
+    });
+    rules.command("check").description("Run deterministic rule validators.").action(async () => {
+        process.stdout.write(await checkRules());
+    });
+    rules.command("export").description("Export rules as yaml or json.").option("--format <format>", "yaml or json", "yaml").action(async (options) => {
+        process.stdout.write(await exportRules(options.format));
+    });
+}
+//# sourceMappingURL=rules.js.map

package/dist/commands/rules.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,22 @@
+import type { Writable } from "node:stream";
+import type { Command } from "commander";
+import { type RawRunRecord } from "../core/raw-store.js";
+import { type ReducerEngine } from "../core/native-engine.js";
+export interface RunCliOptions {
+    interactive?: boolean;
+    unsafeConfirm?: string;
+    native?: boolean;
+    engine?: ReducerEngine;
+}
+export interface RunExecutionOptions extends RunCliOptions {
+    terminalStdout?: Writable;
+    terminalStderr?: Writable;
+}
+export interface RunExecutionResult {
+    rawId: string;
+    exitCode: number;
+    summary: string;
+    record: RawRunRecord;
+}
+export declare function executeRunCommand(commandParts: string[], options?: RunExecutionOptions, root?: string): Promise<RunExecutionResult>;
+export declare function registerRunCommand(program: Command): void;