@jcode.labs/ragmir 2.8.0 → 2.9.0

package/dist/ocr.js

@@ -0,0 +1,340 @@
+import { spawn } from "node:child_process";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { findProjectConfig, loadConfig } from "./config.js";
+import { isRecord } from "./guards.js";
+import { initProject } from "./init.js";
+import { MAX_EXTERNAL_TEXT_STDIO_BYTES } from "./limits.js";
+import { rgrCommand } from "./package-manager.js";
+import { hardenPrivateFile } from "./permissions.js";
+const OCR_COMMAND_TIMEOUT_MS = 120_000;
+const OCR_PROBE_TIMEOUT_MS = 10_000;
+const OCR_PROCESS_KILL_GRACE_MS = 1_000;
+const OCR_RENDER_DPI = 300;
+const MINIMUM_OCRMYPDF_VERSION = { major: 12, minor: 6 };
+export function parsePdfOcrEngine(value, allowAuto = false) {
+    const normalized = value?.trim().toLowerCase();
+    if (normalized === "ocrmypdf" || normalized === "tesseract") {
+        return normalized;
+    }
+    if (allowAuto && (normalized === undefined || normalized === "auto")) {
+        return "auto";
+    }
+    throw new Error(allowAuto ? "Expected auto, ocrmypdf, or tesseract." : "Expected ocrmypdf or tesseract.");
+}
+export function normalizeOcrLanguage(value = "eng") {
+    const normalized = value.trim().toLowerCase();
+    if (!/^[a-z0-9][a-z0-9_-]*(?:\+[a-z0-9][a-z0-9_-]*)*$/u.test(normalized)) {
+        throw new Error("OCR language must use Tesseract codes such as eng, fra, or eng+fra.");
+    }
+    return normalized;
+}
+export async function inspectPdfOcr(cwd = process.cwd()) {
+    const config = await loadConfig(cwd);
+    const [ocrmypdf, tesseract, pdftoppm] = await Promise.all([
+        probeExecutable("ocrmypdf", ["--version"]),
+        probeExecutable("tesseract", ["--version"]),
+        probeExecutable("pdftoppm", ["-v"]),
+    ]);
+    const languages = tesseract.available ? await listTesseractLanguages() : [];
+    const ocrmypdfSupported = ocrmypdf.available && isSupportedOcrMyPdfVersion(ocrmypdf.version);
+    const recommendedEngine = ocrmypdfSupported
+        ? "ocrmypdf"
+        : tesseract.available && pdftoppm.available
+            ? "tesseract"
+            : null;
+    return {
+        projectRoot: config.projectRoot,
+        privacyProfile: config.privacyProfile,
+        configured: config.pdfOcrCommand.length > 0,
+        configuredCommand: config.pdfOcrCommand,
+        recommendedEngine,
+        ocrmypdf: { ...ocrmypdf, supported: ocrmypdfSupported },
+        tesseract,
+        pdftoppm,
+        languages,
+    };
+}
+export async function configurePdfOcr(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await initProject(cwd);
+    const config = await loadConfig(cwd);
+    if (config.privacyProfile === "strict") {
+        throw new Error("The strict privacy profile disables external extractors. Use the private or custom profile before configuring local OCR.");
+    }
+    const status = await inspectPdfOcr(cwd);
+    const requestedEngine = parsePdfOcrEngine(options.engine, true);
+    const engine = resolveEngine(requestedEngine, status);
+    const language = normalizeOcrLanguage(options.language);
+    assertLanguagesAvailable(language, status.languages);
+    const timeoutMs = options.timeoutMs ?? config.pdfOcrTimeoutMs;
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new Error("OCR timeout must be a positive integer.");
+    }
+    const configuredCommand = await rgrCommand(config.projectRoot, [
+        "ocr",
+        "extract-page",
+        "--engine",
+        engine,
+        "--language",
+        language,
+        "--input",
+        "{input}",
+        "--page",
+        "{page}",
+        "--timeout-ms",
+        String(timeoutMs),
+    ]);
+    const pdfOcrCommand = [configuredCommand.command, ...configuredCommand.args];
+    const projectConfig = findProjectConfig(config.projectRoot);
+    const raw = JSON.parse(await readFile(projectConfig.configPath, "utf8"));
+    if (!isRecord(raw)) {
+        throw new Error(`${projectConfig.configPath} must contain a JSON object.`);
+    }
+    const nextConfig = {
+        ...raw,
+        pdfOcrCommand,
+        pdfOcrTimeoutMs: timeoutMs,
+    };
+    await writeFile(projectConfig.configPath, `${JSON.stringify(nextConfig, null, 2)}\n`, "utf8");
+    await hardenPrivateFile(projectConfig.configPath);
+    return {
+        configPath: projectConfig.configPath,
+        engine,
+        language,
+        timeoutMs,
+        pdfOcrCommand,
+    };
+}
+export async function extractPdfPage(options) {
+    if (!Number.isInteger(options.page) || options.page <= 0) {
+        throw new Error("PDF page must be a positive integer.");
+    }
+    const language = normalizeOcrLanguage(options.language);
+    const timeoutMs = options.timeoutMs ?? OCR_COMMAND_TIMEOUT_MS;
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new Error("OCR timeout must be a positive integer.");
+    }
+    const engine = parsePdfOcrEngine(options.engine);
+    const input = path.resolve(options.input);
+    const tempDir = await createOcrTempDirectory();
+    try {
+        if (engine === "ocrmypdf") {
+            return await extractWithOcrMyPdf({ input, page: options.page, language, timeoutMs, tempDir });
+        }
+        return await extractWithTesseract({ input, page: options.page, language, timeoutMs, tempDir });
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+function resolveEngine(selection, status) {
+    if (selection === "auto") {
+        if (status.recommendedEngine) {
+            return status.recommendedEngine;
+        }
+        throw new Error("No supported local PDF OCR engine found. Install OCRmyPDF 12.6+ or install both Tesseract and Poppler, then run `rgr ocr setup` again.");
+    }
+    if (selection === "ocrmypdf" && !status.ocrmypdf.supported) {
+        throw new Error("OCRmyPDF 12.6 or newer is required for sidecar-only page extraction.");
+    }
+    if (selection === "tesseract" && (!status.tesseract.available || !status.pdftoppm.available)) {
+        throw new Error("The Tesseract engine requires both `tesseract` and Poppler `pdftoppm` on PATH.");
+    }
+    return selection;
+}
+function assertLanguagesAvailable(language, installed) {
+    if (installed.length === 0) {
+        return;
+    }
+    const available = new Set(installed);
+    const missing = language.split("+").filter((entry) => !available.has(entry));
+    if (missing.length > 0) {
+        throw new Error(`Missing Tesseract language packs: ${missing.join(", ")}.`);
+    }
+}
+async function extractWithOcrMyPdf(options) {
+    const sidecarPath = path.join(options.tempDir, "page.txt");
+    await runProcess("ocrmypdf", [
+        "--quiet",
+        "--force-ocr",
+        "--pages",
+        String(options.page),
+        "--language",
+        options.language,
+        "--sidecar",
+        sidecarPath,
+        "--output-type",
+        "none",
+        options.input,
+        "-",
+    ], { timeoutMs: options.timeoutMs });
+    return readFile(sidecarPath, "utf8");
+}
+async function extractWithTesseract(options) {
+    const outputPrefix = path.join(options.tempDir, "page");
+    await runProcess("pdftoppm", [
+        "-f",
+        String(options.page),
+        "-l",
+        String(options.page),
+        "-singlefile",
+        "-r",
+        String(OCR_RENDER_DPI),
+        "-gray",
+        "-png",
+        options.input,
+        outputPrefix,
+    ], { timeoutMs: options.timeoutMs });
+    const result = await runProcess("tesseract", ["page.png", "stdout", "-l", options.language], {
+        cwd: options.tempDir,
+        timeoutMs: options.timeoutMs,
+    });
+    return result.stdout;
+}
+async function createOcrTempDirectory() {
+    return mkdtemp(path.join(os.tmpdir(), "ragmir-ocr-"));
+}
+async function probeExecutable(executable, args) {
+    try {
+        const result = await runProcess(executable, args, { timeoutMs: OCR_PROBE_TIMEOUT_MS });
+        const version = firstNonEmptyLine(`${result.stdout}\n${result.stderr}`);
+        return { available: true, version };
+    }
+    catch {
+        return { available: false, version: null };
+    }
+}
+async function listTesseractLanguages() {
+    try {
+        const result = await runProcess("tesseract", ["--list-langs"], {
+            timeoutMs: OCR_PROBE_TIMEOUT_MS,
+        });
+        return `${result.stdout}\n${result.stderr}`
+            .split(/\r?\n/u)
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && !line.startsWith("List of available languages"))
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        return [];
+    }
+}
+function isSupportedOcrMyPdfVersion(version) {
+    if (!version) {
+        return false;
+    }
+    const match = version.match(/(\d+)\.(\d+)/u);
+    if (!match) {
+        return false;
+    }
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return (major > MINIMUM_OCRMYPDF_VERSION.major ||
+        (major === MINIMUM_OCRMYPDF_VERSION.major && minor >= MINIMUM_OCRMYPDF_VERSION.minor));
+}
+function firstNonEmptyLine(value) {
+    return (value
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0) ?? null);
+}
+async function runProcess(executable, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, args, {
+            cwd: options.cwd,
+            detached: process.platform !== "win32",
+            env: externalCommandEnvironment(),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        let timedOut = false;
+        let outputTooLarge = false;
+        let terminationStarted = false;
+        let forceKillTimeout;
+        const terminateWithEscalation = () => {
+            if (terminationStarted) {
+                return;
+            }
+            terminationStarted = true;
+            terminateChild(child, "SIGTERM");
+            forceKillTimeout = setTimeout(() => terminateChild(child, "SIGKILL"), OCR_PROCESS_KILL_GRACE_MS);
+        };
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            terminateWithEscalation();
+        }, options.timeoutMs);
+        const finish = (error, result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timeout);
+            if (forceKillTimeout) {
+                clearTimeout(forceKillTimeout);
+            }
+            if (error) {
+                reject(error);
+            }
+            else if (result) {
+                resolve(result);
+            }
+        };
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+            if (Buffer.byteLength(stdout, "utf8") > MAX_EXTERNAL_TEXT_STDIO_BYTES) {
+                outputTooLarge = true;
+                terminateWithEscalation();
+            }
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+            if (Buffer.byteLength(stderr, "utf8") > MAX_EXTERNAL_TEXT_STDIO_BYTES) {
+                outputTooLarge = true;
+                terminateWithEscalation();
+            }
+        });
+        child.on("error", (error) => finish(error));
+        child.on("close", (code) => {
+            if (timedOut) {
+                finish(new Error(`${executable} timed out.`));
+                return;
+            }
+            if (outputTooLarge) {
+                finish(new Error(`${executable} produced too much output.`));
+                return;
+            }
+            if (code !== 0) {
+                const detail = stderr.trim();
+                finish(new Error(detail ? `${executable} failed: ${detail}` : `${executable} failed.`));
+                return;
+            }
+            finish(undefined, { stdout, stderr });
+        });
+    });
+}
+function terminateChild(child, signal) {
+    if (process.platform !== "win32" && child.pid) {
+        try {
+            process.kill(-child.pid, signal);
+            return;
+        }
+        catch {
+            // The child may have exited before the signal was sent.
+        }
+    }
+    child.kill(signal);
+}
+function externalCommandEnvironment() {
+    const allowed = ["HOME", "LANG", "LC_ALL", "PATH", "TEMP", "TMP", "TMPDIR"];
+    return Object.fromEntries(allowed.flatMap((name) => {
+        const value = process.env[name];
+        return value === undefined ? [] : [[name, value]];
+    }));
+}
+//# sourceMappingURL=ocr.js.map

package/dist/ocr.js.map

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

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.8.0";
+export declare const VERSION = "2.9.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "2.8.0";
+export const VERSION = "2.9.0";
 //# sourceMappingURL=version.js.map

package/examples/document-evidence-benchmark/golden-queries.json

@@ -15,7 +15,7 @@
     },
     {
       "id": "runbook-evidence-pack",
-      "query": "What runbook evidence must be collected after a payment incident?",
+      "query": "What runbook evidence must be collected after a service incident?",
       "expectedPaths": ["raw/runbooks/incident-response-runbook.md"],
       "expectedCitations": ["raw/runbooks/incident-response-runbook.md:L1-L11#0"]
     },

package/examples/document-evidence-benchmark/raw/runbooks/incident-response-runbook.md

@@ -1,8 +1,8 @@
-# Synthetic Payment Incident Runbook
+# Synthetic Service Incident Runbook
 
-Trigger: payment queue latency above the internal threshold for ten minutes.
+Trigger: work queue latency above the internal threshold for ten minutes.
 
-The on-call engineer opens the local incident template and collects a payment incident evidence pack:
+The on-call engineer opens the local incident template and collects a service incident evidence pack:
 timeline, customer impact summary, rollback decision, command transcript, and links to cited runbook
 sections. The evidence pack remains under the local Ragmir reports folder until the incident lead
 approves external sharing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcode.labs/ragmir",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Ragmir Core: open-source sovereign local RAG for confidential datasets and AI agents.",
   "type": "module",
   "license": "MIT",
@@ -69,8 +69,8 @@
     "unpdf": "^1.4.0",
     "yaml": "^2.9.0",
     "zod": "^4.1.13",
-    "@jcode.labs/ragmir-tts": "2.8.0",
-    "@jcode.labs/ragmir-chat": "2.8.0"
+    "@jcode.labs/ragmir-chat": "2.9.0",
+    "@jcode.labs/ragmir-tts": "2.9.0"
   },
   "devDependencies": {
     "@types/html-to-text": "^9.0.4",