kirograph 0.28.0 → 0.28.1

package/dist/data/parsers/pdf.test.js

@@ -1,125 +0,0 @@
-"use strict";
-var import_vitest = require("vitest");
-var import_pdf = require("./pdf");
-import_vitest.vi.mock("fs", async (importOriginal) => {
-  const actual = await importOriginal();
-  return { ...actual, readFileSync: import_vitest.vi.fn().mockReturnValue(Buffer.from("fake-pdf")) };
-});
-const mockExtractPages = import_vitest.vi.fn();
-const mockProcessPdf = import_vitest.vi.fn();
-function makeMockResult(pages, opts) {
-  return {
-    pages,
-    pagesWithTables: opts?.pagesWithTables ?? [],
-    pagesWithColumns: opts?.pagesWithColumns ?? []
-  };
-}
-(0, import_vitest.describe)("pdfParser", () => {
-  (0, import_vitest.beforeEach)(() => {
-    import_vitest.vi.clearAllMocks();
-    (0, import_pdf._setPdfInspectorForTesting)({ extractPagesMarkdown: mockExtractPages, processPdf: mockProcessPdf });
-  });
-  (0, import_vitest.afterEach)(() => {
-    (0, import_pdf._resetPdfInspectorForTesting)();
-  });
-  (0, import_vitest.it)("isAvailable returns true when module is injected", () => {
-    (0, import_vitest.expect)(import_pdf.pdfParser.isAvailable()).toBe(true);
-  });
-  (0, import_vitest.it)("isAvailable returns false when module is not available", () => {
-    (0, import_pdf._resetPdfInspectorForTesting)();
-    (0, import_vitest.expect)(import_pdf.pdfParser.isAvailable()).toBe(false);
-  });
-  (0, import_vitest.it)("parse returns empty result when library is unavailable", async () => {
-    (0, import_pdf._resetPdfInspectorForTesting)();
-    const batches = [];
-    const result = await import_pdf.pdfParser.parse("/fake/doc.pdf", {
-      maxRows: 1e3,
-      onBatch: (rows, cols) => batches.push({ rows, cols })
-    });
-    (0, import_vitest.expect)(result.columns).toEqual([]);
-    (0, import_vitest.expect)(result.totalRows).toBe(0);
-    (0, import_vitest.expect)(batches).toHaveLength(0);
-  });
-  (0, import_vitest.it)("happy path: text-based PDF produces correct rows and metadata", async () => {
-    mockExtractPages.mockReturnValue(makeMockResult([
-      { page: 0, markdown: "# Title\n\nSome content here.", needsOcr: false },
-      { page: 1, markdown: "Page two content.", needsOcr: false }
-    ], { pagesWithTables: [1], pagesWithColumns: [] }));
-    mockProcessPdf.mockReturnValue({
-      pdfType: "TextBased",
-      confidence: 0.97,
-      title: "Test Doc",
-      hasEncodingIssues: false,
-      isComplexLayout: false
-    });
-    const batches = [];
-    const result = await import_pdf.pdfParser.parse("/fake/report.pdf", {
-      maxRows: 1e3,
-      onBatch: (rows, cols) => batches.push({ rows, cols })
-    });
-    (0, import_vitest.expect)(result.columns).toEqual(["page", "content", "needs_ocr", "has_tables", "has_columns"]);
-    (0, import_vitest.expect)(result.totalRows).toBe(2);
-    (0, import_vitest.expect)(batches).toHaveLength(1);
-    (0, import_vitest.expect)(batches[0].rows[0]).toMatchObject({ page: "0", needs_ocr: "false", has_tables: "false" });
-    (0, import_vitest.expect)(batches[0].rows[1]).toMatchObject({ page: "1", needs_ocr: "false", has_tables: "true" });
-    (0, import_vitest.expect)(result.metadataJson).toBeTruthy();
-    const meta = JSON.parse(result.metadataJson);
-    (0, import_vitest.expect)(meta.pdfType).toBe("TextBased");
-    (0, import_vitest.expect)(meta.confidence).toBe(0.97);
-    (0, import_vitest.expect)(meta.hasEncodingIssues).toBe(false);
-  });
-  (0, import_vitest.it)("mixed PDF: text pages indexed normally, scanned pages flagged", async () => {
-    mockExtractPages.mockReturnValue(makeMockResult([
-      { page: 0, markdown: "Text content", needsOcr: false },
-      { page: 1, markdown: "", needsOcr: true },
-      { page: 2, markdown: "More text", needsOcr: false },
-      { page: 3, markdown: "", needsOcr: true }
-    ]));
-    mockProcessPdf.mockReturnValue({ pdfType: "Mixed", confidence: 0.85, hasEncodingIssues: false, isComplexLayout: false });
-    const batches = [];
-    await import_pdf.pdfParser.parse("/fake/mixed.pdf", {
-      maxRows: 1e3,
-      onBatch: (rows2) => batches.push({ rows: rows2 })
-    });
-    (0, import_vitest.expect)(batches).toHaveLength(1);
-    const rows = batches[0].rows;
-    (0, import_vitest.expect)(rows).toHaveLength(4);
-    (0, import_vitest.expect)(rows.filter((r) => r.needs_ocr === "true")).toHaveLength(2);
-    (0, import_vitest.expect)(rows.filter((r) => r.needs_ocr === "false")).toHaveLength(2);
-  });
-  (0, import_vitest.it)("hasEncodingIssues is captured in metadataJson", async () => {
-    mockExtractPages.mockReturnValue(makeMockResult([{ page: 0, markdown: "garbled", needsOcr: false }]));
-    mockProcessPdf.mockReturnValue({ pdfType: "TextBased", confidence: 0.4, hasEncodingIssues: true, isComplexLayout: false });
-    const result = await import_pdf.pdfParser.parse("/fake/garbled.pdf", { maxRows: 1e3, onBatch: () => {
-    } });
-    (0, import_vitest.expect)(result.metadataJson).toBeTruthy();
-    const meta = JSON.parse(result.metadataJson);
-    (0, import_vitest.expect)(meta.hasEncodingIssues).toBe(true);
-  });
-  (0, import_vitest.it)("empty PDF returns no rows and no batch", async () => {
-    mockExtractPages.mockReturnValue({ pages: [], pagesWithTables: [], pagesWithColumns: [] });
-    mockProcessPdf.mockReturnValue({ pdfType: "TextBased", confidence: 1, hasEncodingIssues: false, isComplexLayout: false });
-    const batches = [];
-    const result = await import_pdf.pdfParser.parse("/fake/empty.pdf", {
-      maxRows: 1e3,
-      onBatch: (rows, cols) => batches.push({ rows, cols })
-    });
-    (0, import_vitest.expect)(result.totalRows).toBe(0);
-    (0, import_vitest.expect)(batches).toHaveLength(0);
-  });
-  (0, import_vitest.it)("gracefully handles processPdf failure \u2014 still returns rows", async () => {
-    mockExtractPages.mockReturnValue(makeMockResult([{ page: 0, markdown: "content", needsOcr: false }]));
-    mockProcessPdf.mockImplementation(() => {
-      throw new Error("processPdf failed");
-    });
-    const batches = [];
-    const result = await import_pdf.pdfParser.parse("/fake/broken-meta.pdf", {
-      maxRows: 1e3,
-      onBatch: (rows, cols) => batches.push({ rows, cols })
-    });
-    (0, import_vitest.expect)(result.totalRows).toBe(1);
-    (0, import_vitest.expect)(batches).toHaveLength(1);
-    (0, import_vitest.expect)(result.metadataJson).toBeNull();
-  });
-});
-//# sourceMappingURL=pdf.test.js.map

package/dist/data/parsers/pdf.test.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/data/parsers/pdf.test.ts"],
-  "sourcesContent": ["import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';\nimport { pdfParser, _setPdfInspectorForTesting, _resetPdfInspectorForTesting } from './pdf';\n\n// \u2500\u2500 Mock fs.readFileSync so tests never touch the filesystem \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nvi.mock('fs', async (importOriginal) => {\n  const actual = await importOriginal<typeof import('fs')>();\n  return { ...actual, readFileSync: vi.fn().mockReturnValue(Buffer.from('fake-pdf')) };\n});\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst mockExtractPages = vi.fn();\nconst mockProcessPdf = vi.fn();\n\nfunction makeMockResult(\n  pages: Array<{ page: number; markdown: string; needsOcr: boolean }>,\n  opts?: { pagesWithTables?: number[]; pagesWithColumns?: number[] },\n) {\n  return {\n    pages,\n    pagesWithTables: opts?.pagesWithTables ?? [],\n    pagesWithColumns: opts?.pagesWithColumns ?? [],\n  };\n}\n\n// \u2500\u2500 Tests \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ndescribe('pdfParser', () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n    _setPdfInspectorForTesting({ extractPagesMarkdown: mockExtractPages, processPdf: mockProcessPdf });\n  });\n\n  afterEach(() => {\n    _resetPdfInspectorForTesting();\n  });\n\n  it('isAvailable returns true when module is injected', () => {\n    expect(pdfParser.isAvailable()).toBe(true);\n  });\n\n  it('isAvailable returns false when module is not available', () => {\n    _resetPdfInspectorForTesting(); // clears pdfModule\n    // Simulate require() failure by resetting the module\n    expect(pdfParser.isAvailable()).toBe(false);\n  });\n\n  it('parse returns empty result when library is unavailable', async () => {\n    _resetPdfInspectorForTesting();\n    const batches: any[] = [];\n    const result = await pdfParser.parse('/fake/doc.pdf', {\n      maxRows: 1000,\n      onBatch: (rows, cols) => batches.push({ rows, cols }),\n    });\n    expect(result.columns).toEqual([]);\n    expect(result.totalRows).toBe(0);\n    expect(batches).toHaveLength(0);\n  });\n\n  it('happy path: text-based PDF produces correct rows and metadata', async () => {\n    mockExtractPages.mockReturnValue(makeMockResult([\n      { page: 0, markdown: '# Title\\n\\nSome content here.', needsOcr: false },\n      { page: 1, markdown: 'Page two content.', needsOcr: false },\n    ], { pagesWithTables: [1], pagesWithColumns: [] }));\n    mockProcessPdf.mockReturnValue({\n      pdfType: 'TextBased', confidence: 0.97, title: 'Test Doc',\n      hasEncodingIssues: false, isComplexLayout: false,\n    });\n\n    const batches: Array<{ rows: any[]; cols: string[] }> = [];\n    const result = await pdfParser.parse('/fake/report.pdf', {\n      maxRows: 1000,\n      onBatch: (rows, cols) => batches.push({ rows, cols }),\n    });\n\n    expect(result.columns).toEqual(['page', 'content', 'needs_ocr', 'has_tables', 'has_columns']);\n    expect(result.totalRows).toBe(2);\n    expect(batches).toHaveLength(1);\n    expect(batches[0]!.rows[0]).toMatchObject({ page: '0', needs_ocr: 'false', has_tables: 'false' });\n    expect(batches[0]!.rows[1]).toMatchObject({ page: '1', needs_ocr: 'false', has_tables: 'true' });\n\n    expect(result.metadataJson).toBeTruthy();\n    const meta = JSON.parse(result.metadataJson!);\n    expect(meta.pdfType).toBe('TextBased');\n    expect(meta.confidence).toBe(0.97);\n    expect(meta.hasEncodingIssues).toBe(false);\n  });\n\n  it('mixed PDF: text pages indexed normally, scanned pages flagged', async () => {\n    mockExtractPages.mockReturnValue(makeMockResult([\n      { page: 0, markdown: 'Text content', needsOcr: false },\n      { page: 1, markdown: '', needsOcr: true },\n      { page: 2, markdown: 'More text', needsOcr: false },\n      { page: 3, markdown: '', needsOcr: true },\n    ]));\n    mockProcessPdf.mockReturnValue({ pdfType: 'Mixed', confidence: 0.85, hasEncodingIssues: false, isComplexLayout: false });\n\n    const batches: Array<{ rows: any[] }> = [];\n    await pdfParser.parse('/fake/mixed.pdf', {\n      maxRows: 1000,\n      onBatch: (rows) => batches.push({ rows }),\n    });\n\n    expect(batches).toHaveLength(1);\n    const rows = batches[0]!.rows;\n    expect(rows).toHaveLength(4);\n    expect(rows.filter((r: any) => r.needs_ocr === 'true')).toHaveLength(2);\n    expect(rows.filter((r: any) => r.needs_ocr === 'false')).toHaveLength(2);\n  });\n\n  it('hasEncodingIssues is captured in metadataJson', async () => {\n    mockExtractPages.mockReturnValue(makeMockResult([{ page: 0, markdown: 'garbled', needsOcr: false }]));\n    mockProcessPdf.mockReturnValue({ pdfType: 'TextBased', confidence: 0.4, hasEncodingIssues: true, isComplexLayout: false });\n\n    const result = await pdfParser.parse('/fake/garbled.pdf', { maxRows: 1000, onBatch: () => {} });\n\n    expect(result.metadataJson).toBeTruthy();\n    const meta = JSON.parse(result.metadataJson!);\n    expect(meta.hasEncodingIssues).toBe(true);\n  });\n\n  it('empty PDF returns no rows and no batch', async () => {\n    mockExtractPages.mockReturnValue({ pages: [], pagesWithTables: [], pagesWithColumns: [] });\n    mockProcessPdf.mockReturnValue({ pdfType: 'TextBased', confidence: 1, hasEncodingIssues: false, isComplexLayout: false });\n\n    const batches: any[] = [];\n    const result = await pdfParser.parse('/fake/empty.pdf', {\n      maxRows: 1000,\n      onBatch: (rows, cols) => batches.push({ rows, cols }),\n    });\n\n    expect(result.totalRows).toBe(0);\n    expect(batches).toHaveLength(0);\n  });\n\n  it('gracefully handles processPdf failure \u2014 still returns rows', async () => {\n    mockExtractPages.mockReturnValue(makeMockResult([{ page: 0, markdown: 'content', needsOcr: false }]));\n    mockProcessPdf.mockImplementation(() => { throw new Error('processPdf failed'); });\n\n    const batches: any[] = [];\n    const result = await pdfParser.parse('/fake/broken-meta.pdf', {\n      maxRows: 1000,\n      onBatch: (rows, cols) => batches.push({ rows, cols }),\n    });\n\n    expect(result.totalRows).toBe(1);\n    expect(batches).toHaveLength(1);\n    expect(result.metadataJson).toBeNull();\n  });\n});\n"],
-  "mappings": "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",
-  "names": ["rows"]
-}

package/dist/data/pixelrag-bridge.js

@@ -1,93 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var pixelrag_bridge_exports = {};
-__export(pixelrag_bridge_exports, {
-  getStatus: () => getStatus,
-  isServerRunning: () => isServerRunning,
-  searchVisual: () => searchVisual
-});
-module.exports = __toCommonJS(pixelrag_bridge_exports);
-async function isServerRunning(endpoint) {
-  try {
-    const res = await fetch(`${endpoint}/health`, { signal: AbortSignal.timeout(2e3) });
-    return res.ok;
-  } catch {
-    return false;
-  }
-}
-async function searchVisual(endpoint, query, opts = {}) {
-  const limit = opts.limit ?? 3;
-  const minTileHeight = opts.minTileHeight ?? 50;
-  const idMap = opts.idMap ?? {};
-  const res = await fetch(`${endpoint}/search`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ queries: [{ text: query }], n_docs: limit }),
-    signal: AbortSignal.timeout(3e4)
-  });
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(`PixelRAG /search returned ${res.status}: ${body}`);
-  }
-  const data = await res.json();
-  const hits = data.results?.[0]?.hits ?? [];
-  const out = [];
-  for (const hit of hits) {
-    const h = hit;
-    const tileHeight = typeof h.tile_height === "number" ? h.tile_height : 0;
-    if (tileHeight < minTileHeight) continue;
-    const articleId = String(h.article_id ?? h.url ?? "");
-    const filePath = idMap[articleId] ?? articleId;
-    out.push({
-      score: typeof h.score === "number" ? h.score : 0,
-      filePath,
-      tileIndex: typeof h.tile_index === "number" ? h.tile_index : 0,
-      chunkIndex: typeof h.chunk_index === "number" ? h.chunk_index : 0,
-      yOffset: typeof h.y_offset === "number" ? h.y_offset : 0,
-      chunkHeight: tileHeight,
-      chunkImagePath: typeof h.path === "string" ? h.path : ""
-    });
-    if (out.length >= limit) break;
-  }
-  return out;
-}
-async function getStatus(endpoint, indexPath) {
-  const running = await isServerRunning(endpoint);
-  let tileCount = null;
-  let lastBuilt = null;
-  if (running) {
-    try {
-      const res = await fetch(`${endpoint}/status`, { signal: AbortSignal.timeout(3e3) });
-      if (res.ok) {
-        const data = await res.json();
-        if (typeof data.tile_count === "number") tileCount = data.tile_count;
-        if (typeof data.built_at === "number") lastBuilt = data.built_at * 1e3;
-      }
-    } catch {
-    }
-  }
-  return { running, endpoint, indexPath, tileCount, lastBuilt };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getStatus,
-  isServerRunning,
-  searchVisual
-});
-//# sourceMappingURL=pixelrag-bridge.js.map

package/dist/data/pixelrag-bridge.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/data/pixelrag-bridge.ts"],
-  "sourcesContent": ["/**\n * PixelRAG HTTP bridge \u2014 pure client, no lifecycle management.\n * All lifecycle (install, index build, server spawn) lives in pixelrag-manager.ts.\n *\n * EXPERIMENTAL: This module is experimental and may change without notice.\n */\n\nimport type { VisualSearchResult, PixelRAGStatus } from './types';\n\nexport async function isServerRunning(endpoint: string): Promise<boolean> {\n  try {\n    const res = await fetch(`${endpoint}/health`, { signal: AbortSignal.timeout(2000) });\n    return res.ok;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Actual /search response shape (from live testing with pixelrag 0.3.x):\n *   { \"results\": [ { \"hits\": [ { score, article_id, tile_index, chunk_index,\n *                                y_offset, tile_height, path, url, \u2026 } ] } ] }\n *\n * @param idMap  Optional mapping from article_id (string) \u2192 original PDF absolute path.\n *               Loaded from <kirographDir>/pixelrag-id-map.json by the caller.\n */\nexport async function searchVisual(\n  endpoint: string,\n  query: string,\n  opts: { limit?: number; minTileHeight?: number; idMap?: Record<string, string> } = {},\n): Promise<VisualSearchResult[]> {\n  const limit         = opts.limit ?? 3;\n  const minTileHeight = opts.minTileHeight ?? 50;\n  const idMap         = opts.idMap ?? {};\n\n  const res = await fetch(`${endpoint}/search`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ queries: [{ text: query }], n_docs: limit }),\n    signal: AbortSignal.timeout(30_000),\n  });\n\n  if (!res.ok) {\n    const body = await res.text().catch(() => '');\n    throw new Error(`PixelRAG /search returned ${res.status}: ${body}`);\n  }\n\n  // results[0].hits contains the actual hit list\n  const data = await res.json() as { results?: { hits?: unknown[] }[] };\n  const hits = data.results?.[0]?.hits ?? [];\n\n  const out: VisualSearchResult[] = [];\n  for (const hit of hits) {\n    const h = hit as Record<string, unknown>;\n\n    const tileHeight = typeof h.tile_height === 'number' ? h.tile_height : 0;\n    if (tileHeight < minTileHeight) continue;\n\n    const articleId = String(h.article_id ?? h.url ?? '');\n    const filePath  = idMap[articleId] ?? articleId;\n\n    out.push({\n      score:          typeof h.score === 'number' ? h.score : 0,\n      filePath,\n      tileIndex:      typeof h.tile_index   === 'number' ? h.tile_index   : 0,\n      chunkIndex:     typeof h.chunk_index  === 'number' ? h.chunk_index  : 0,\n      yOffset:        typeof h.y_offset     === 'number' ? h.y_offset     : 0,\n      chunkHeight:    tileHeight,\n      chunkImagePath: typeof h.path === 'string' ? h.path : '',\n    });\n\n    if (out.length >= limit) break;\n  }\n\n  return out;\n}\n\nexport async function getStatus(endpoint: string, indexPath: string | null): Promise<PixelRAGStatus> {\n  const running = await isServerRunning(endpoint);\n  let tileCount: number | null = null;\n  let lastBuilt: number | null = null;\n\n  if (running) {\n    try {\n      const res = await fetch(`${endpoint}/status`, { signal: AbortSignal.timeout(3000) });\n      if (res.ok) {\n        const data = await res.json() as Record<string, unknown>;\n        if (typeof data.tile_count === 'number') tileCount = data.tile_count;\n        if (typeof data.built_at === 'number') lastBuilt = data.built_at * 1000;\n      }\n    } catch { /* best-effort */ }\n  }\n\n  return { running, endpoint, indexPath, tileCount, lastBuilt };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,eAAsB,gBAAgB,UAAoC;AACxE,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,WAAW,EAAE,QAAQ,YAAY,QAAQ,GAAI,EAAE,CAAC;AACnF,WAAO,IAAI;AAAA,EACb,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAUA,eAAsB,aACpB,UACA,OACA,OAAmF,CAAC,GACrD;AAC/B,QAAM,QAAgB,KAAK,SAAS;AACpC,QAAM,gBAAgB,KAAK,iBAAiB;AAC5C,QAAM,QAAgB,KAAK,SAAS,CAAC;AAErC,QAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,WAAW;AAAA,IAC5C,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC,GAAG,QAAQ,MAAM,CAAC;AAAA,IAClE,QAAQ,YAAY,QAAQ,GAAM;AAAA,EACpC,CAAC;AAED,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,EAAE;AAC5C,UAAM,IAAI,MAAM,6BAA6B,IAAI,MAAM,KAAK,IAAI,EAAE;AAAA,EACpE;AAGA,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAM,OAAO,KAAK,UAAU,CAAC,GAAG,QAAQ,CAAC;AAEzC,QAAM,MAA4B,CAAC;AACnC,aAAW,OAAO,MAAM;AACtB,UAAM,IAAI;AAEV,UAAM,aAAa,OAAO,EAAE,gBAAgB,WAAW,EAAE,cAAc;AACvE,QAAI,aAAa,cAAe;AAEhC,UAAM,YAAY,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE;AACpD,UAAM,WAAY,MAAM,SAAS,KAAK;AAEtC,QAAI,KAAK;AAAA,MACP,OAAgB,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ;AAAA,MACxD;AAAA,MACA,WAAgB,OAAO,EAAE,eAAiB,WAAW,EAAE,aAAe;AAAA,MACtE,YAAgB,OAAO,EAAE,gBAAiB,WAAW,EAAE,cAAe;AAAA,MACtE,SAAgB,OAAO,EAAE,aAAiB,WAAW,EAAE,WAAe;AAAA,MACtE,aAAgB;AAAA,MAChB,gBAAgB,OAAO,EAAE,SAAS,WAAW,EAAE,OAAO;AAAA,IACxD,CAAC;AAED,QAAI,IAAI,UAAU,MAAO;AAAA,EAC3B;AAEA,SAAO;AACT;AAEA,eAAsB,UAAU,UAAkB,WAAmD;AACnG,QAAM,UAAU,MAAM,gBAAgB,QAAQ;AAC9C,MAAI,YAA2B;AAC/B,MAAI,YAA2B;AAE/B,MAAI,SAAS;AACX,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,WAAW,EAAE,QAAQ,YAAY,QAAQ,GAAI,EAAE,CAAC;AACnF,UAAI,IAAI,IAAI;AACV,cAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAI,OAAO,KAAK,eAAe,SAAU,aAAY,KAAK;AAC1D,YAAI,OAAO,KAAK,aAAa,SAAU,aAAY,KAAK,WAAW;AAAA,MACrE;AAAA,IACF,QAAQ;AAAA,IAAoB;AAAA,EAC9B;AAEA,SAAO,EAAE,SAAS,UAAU,WAAW,WAAW,UAAU;AAC9D;",
-  "names": []
-}

package/dist/data/pixelrag-manager.js

@@ -1,416 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var pixelrag_manager_exports = {};
-__export(pixelrag_manager_exports, {
-  buildIndex: () => buildIndex,
-  checkRam: () => checkRam,
-  detectPython: () => detectPython,
-  detectWSL2: () => detectWSL2,
-  downloadPixelRAGModel: () => downloadPixelRAGModel,
-  ensurePixelRAGInstalled: () => ensurePixelRAGInstalled,
-  ensurePython: () => ensurePython,
-  getFlaggedPdfs: () => getFlaggedPdfs,
-  installPixelRAG: () => installPixelRAG,
-  isPixelRAGInstalled: () => isPixelRAGInstalled,
-  startServer: () => startServer
-});
-module.exports = __toCommonJS(pixelrag_manager_exports);
-var fs = __toESM(require("fs"));
-var os = __toESM(require("os"));
-var path = __toESM(require("path"));
-var import_child_process = require("child_process");
-const PIXELRAG_ENV = {
-  ...process.env,
-  OMP_NUM_THREADS: "1",
-  KMP_DUPLICATE_LIB_OK: "TRUE"
-};
-function detectPython() {
-  for (const bin of ["python3", "python"]) {
-    try {
-      const result = (0, import_child_process.spawnSync)(bin, ["--version"], { encoding: "utf8", timeout: 5e3 });
-      if (result.status !== 0) continue;
-      const out = (result.stdout + result.stderr).trim();
-      const match = out.match(/Python (\d+)\.(\d+)/);
-      if (!match) continue;
-      const [, major, minor] = match;
-      if (Number(major) >= 3 && Number(minor) >= 12) return bin;
-    } catch {
-    }
-  }
-  return null;
-}
-function ensurePython() {
-  const bin = detectPython();
-  if (!bin) {
-    throw new Error(
-      "PixelRAG (visual PDF search) requires Python 3.12+.\nInstall from https://python.org or via brew: brew install python@3.12"
-    );
-  }
-  return bin;
-}
-function getPixelRAGBin(python) {
-  try {
-    const exe = (0, import_child_process.spawnSync)(python, ["-c", "import sys; print(sys.executable)"], {
-      encoding: "utf8",
-      timeout: 5e3
-    }).stdout?.trim() ?? "";
-    if (exe) {
-      const candidate = path.join(path.dirname(exe), "pixelrag");
-      if (fs.existsSync(candidate)) return candidate;
-    }
-  } catch {
-  }
-  try {
-    const which = (0, import_child_process.spawnSync)("which", ["pixelrag"], { encoding: "utf8", timeout: 3e3 });
-    if (which.status === 0) {
-      const bin = which.stdout.trim();
-      if (bin) return bin;
-    }
-  } catch {
-  }
-  for (const loc of ["/opt/homebrew/bin/pixelrag", "/usr/local/bin/pixelrag"]) {
-    if (fs.existsSync(loc)) return loc;
-  }
-  throw new Error(
-    "pixelrag binary not found.\nRun: pip install pixelrag[index,serve] pixelrag-render[pdf]\nAlso requires poppler: brew install poppler"
-  );
-}
-function detectWSL2() {
-  try {
-    const version = fs.readFileSync("/proc/version", "utf8");
-    return /microsoft|WSL/i.test(version);
-  } catch {
-    return false;
-  }
-}
-function freeRam() {
-  return os.freemem();
-}
-const WARN_RAM_BYTES = 4 * 1024 * 1024 * 1024;
-const BLOCK_RAM_BYTES = 2 * 1024 * 1024 * 1024;
-function checkRam() {
-  const free = freeRam();
-  if (free < BLOCK_RAM_BYTES) return "block";
-  if (free < WARN_RAM_BYTES) return "warn";
-  return "ok";
-}
-function isPixelRAGInstalled(python) {
-  try {
-    const bin = getPixelRAGBin(python);
-    const result = (0, import_child_process.spawnSync)(bin, ["--help"], { encoding: "utf8", timeout: 5e3 });
-    return result.status === 0;
-  } catch {
-  }
-  return false;
-}
-function installPixelRAG(python) {
-  console.log("  Installing PixelRAG (pip install pixelrag[index,serve] pixelrag-render[pdf])\u2026");
-  let exePath = "";
-  try {
-    exePath = (0, import_child_process.spawnSync)(python, ["-c", "import sys; print(sys.executable)"], {
-      encoding: "utf8",
-      timeout: 5e3
-    }).stdout?.trim() ?? "";
-  } catch {
-  }
-  const extraArgs = exePath.includes("/opt/homebrew/") || exePath.includes("/usr/local/") ? ["--break-system-packages"] : [];
-  const result = (0, import_child_process.spawnSync)(
-    python,
-    ["-m", "pip", "install", "pixelrag[index,serve]", "pixelrag-render[pdf]", ...extraArgs],
-    { stdio: "inherit", timeout: 3e5 }
-  );
-  if (result.status !== 0) {
-    throw new Error(
-      "pip install pixelrag failed. Check your Python environment.\nAlso ensure poppler is installed: brew install poppler"
-    );
-  }
-}
-function downloadPixelRAGModel(python) {
-  const pixelragBin = getPixelRAGBin(python);
-  console.log("  Pre-downloading Qwen3-VL-Embedding-2B model (~4 GB)\u2026");
-  const result = (0, import_child_process.spawnSync)(
-    pixelragBin,
-    ["embed", "--help"],
-    // lightweight call that triggers model cache check
-    { stdio: "inherit", timeout: 18e5, env: PIXELRAG_ENV }
-  );
-  if (result.status !== 0) {
-    console.warn("  \u26A0 Model pre-download may have failed \u2014 it will download on first use.");
-  }
-}
-function ensurePixelRAGInstalled(python) {
-  if (!isPixelRAGInstalled(python)) {
-    installPixelRAG(python);
-  }
-}
-function readManifest(manifestPath) {
-  try {
-    return JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-  } catch {
-    return [];
-  }
-}
-function writeManifest(manifestPath, entries) {
-  fs.writeFileSync(manifestPath, JSON.stringify(entries, null, 2));
-}
-function buildManifestEntries(absPaths) {
-  return absPaths.map((p) => {
-    try {
-      const st = fs.statSync(p);
-      return { path: p, mtime: st.mtimeMs, size: st.size };
-    } catch {
-      return { path: p, mtime: 0, size: 0 };
-    }
-  });
-}
-function manifestIsStale(current, fresh) {
-  if (current.length !== fresh.length) return true;
-  const map = new Map(current.map((e) => [e.path, e]));
-  for (const f of fresh) {
-    const c = map.get(f.path);
-    if (!c || c.mtime !== f.mtime || c.size !== f.size) return true;
-  }
-  return false;
-}
-function getFlaggedPdfs(rawDb, projectRoot) {
-  const datasets = rawDb.all(
-    `SELECT id, file_path FROM data_datasets WHERE format = 'pdf'`
-  );
-  const flagged = [];
-  for (const ds of datasets) {
-    const tableName = `data_rows_${ds.id.replace(/[^a-zA-Z0-9_]/g, "_")}`;
-    try {
-      const rows = rawDb.all(
-        `SELECT COUNT(*) as cnt FROM "${tableName}" WHERE needs_ocr = 'true' OR has_columns = 'true'`
-      );
-      if (rows[0]?.cnt > 0) {
-        const absPath = path.isAbsolute(ds.file_path) ? ds.file_path : path.join(projectRoot, ds.file_path);
-        flagged.push(absPath);
-      }
-    } catch {
-    }
-  }
-  return flagged;
-}
-function buildIndex(opts) {
-  const { python, flaggedPdfs, kirographDir, force } = opts;
-  const indexDir = path.join(kirographDir, "pixelrag-index");
-  const stagingDir = path.join(kirographDir, "pixelrag-staging");
-  const manifestFile = path.join(kirographDir, "pixelrag-manifest.json");
-  const idMapFile = path.join(kirographDir, "pixelrag-id-map.json");
-  if (flaggedPdfs.length === 0) {
-    console.log("  PixelRAG: no visually complex PDFs found \u2014 skipping index build.");
-    return;
-  }
-  const freshEntries = buildManifestEntries(flaggedPdfs);
-  const currentEntries = readManifest(manifestFile);
-  const indexExists = fs.existsSync(indexDir);
-  if (!force && indexExists && !manifestIsStale(currentEntries, freshEntries)) {
-    console.log(`  PixelRAG: index up to date (${flaggedPdfs.length} PDF${flaggedPdfs.length > 1 ? "s" : ""}).`);
-    return;
-  }
-  const pixelragBin = getPixelRAGBin(python);
-  if (fs.existsSync(stagingDir)) {
-    fs.rmSync(stagingDir, { recursive: true, force: true });
-  }
-  fs.mkdirSync(stagingDir, { recursive: true });
-  const idMap = {};
-  for (let i = 0; i < flaggedPdfs.length; i++) {
-    fs.symlinkSync(flaggedPdfs[i], path.join(stagingDir, `${i}.pdf`));
-    idMap[String(i)] = flaggedPdfs[i];
-  }
-  const tileEstimate = flaggedPdfs.length * 40;
-  const cpuMinutes = Math.round(tileEstimate * 10 / 60);
-  const mpsMinutes = Math.round(tileEstimate * 2 / 60);
-  console.log(
-    `  Building PixelRAG index: ~${tileEstimate} tiles (~${cpuMinutes} min on CPU, ~${mpsMinutes} min on MPS)\u2026`
-  );
-  const args = [
-    "index",
-    "build",
-    "--source",
-    stagingDir,
-    "--source-type",
-    "pdf",
-    "--output",
-    indexDir,
-    "--device",
-    "cpu"
-  ];
-  if (force) args.push("--force");
-  const result = (0, import_child_process.spawnSync)(pixelragBin, args, {
-    stdio: "inherit",
-    timeout: 72e5,
-    // 2h hard limit
-    env: PIXELRAG_ENV
-  });
-  try {
-    fs.rmSync(stagingDir, { recursive: true, force: true });
-  } catch {
-  }
-  if (result.status !== 0) {
-    throw new Error("PixelRAG index build failed. Check Python output above for details.");
-  }
-  fs.writeFileSync(idMapFile, JSON.stringify(idMap, null, 2));
-  writeManifest(manifestFile, freshEntries);
-  console.log(`  \u2713 PixelRAG index built (${flaggedPdfs.length} PDF${flaggedPdfs.length > 1 ? "s" : ""}).`);
-}
-let _serverProcess = null;
-let _cleanupRegistered = false;
-function registerCleanup() {
-  if (_cleanupRegistered) return;
-  _cleanupRegistered = true;
-  const cleanup = () => {
-    if (_serverProcess) {
-      try {
-        _serverProcess.kill("SIGTERM");
-      } catch {
-      }
-      setTimeout(() => {
-        try {
-          _serverProcess?.kill("SIGKILL");
-        } catch {
-        }
-      }, 5e3).unref();
-    }
-  };
-  process.on("exit", cleanup);
-  process.on("SIGINT", () => {
-    cleanup();
-    process.exit(0);
-  });
-  process.on("SIGTERM", () => {
-    cleanup();
-    process.exit(0);
-  });
-}
-async function pollHealth(endpoint, maxAttempts, intervalMs) {
-  for (let i = 0; i < maxAttempts; i++) {
-    await new Promise((r) => setTimeout(r, intervalMs));
-    try {
-      const res = await fetch(`${endpoint}/health`, { signal: AbortSignal.timeout(2e3) });
-      if (res.ok) return true;
-      if (res.status !== 404 && res.status !== 503) {
-        console.warn(`  \u26A0 Port ${endpoint}: unexpected response (${res.status}). Another process may be on this port.`);
-        return false;
-      }
-    } catch (e) {
-      const err = e;
-      if (err.code && err.code !== "ECONNREFUSED" && err.code !== "ECONNRESET" && err.code !== "UND_ERR_CONNECT_TIMEOUT") {
-        console.warn(`  \u26A0 PixelRAG health check: ${String(e)}`);
-      }
-    }
-    if ((i + 1) % 8 === 0) {
-      console.log(`  PixelRAG loading model\u2026 ${Math.round((i + 1) * intervalMs / 1e3)}s elapsed`);
-    }
-  }
-  return false;
-}
-async function startServer(python, port, kirographDir) {
-  const endpoint = `http://localhost:${port}`;
-  const indexDir = path.join(kirographDir, "pixelrag-index");
-  const ramState = checkRam();
-  if (ramState === "block") {
-    throw new Error(
-      `PixelRAG server requires at least 4 GB free RAM.
-Current free: ${(freeRam() / 1024 / 1024 / 1024).toFixed(1)} GB.
-Close other applications and retry, or disable enableVisualPDF.`
-    );
-  }
-  if (ramState === "warn") {
-    console.warn(
-      `  \u26A0 Low RAM: ${(freeRam() / 1024 / 1024 / 1024).toFixed(1)} GB free. PixelRAG may degrade system performance.`
-    );
-  }
-  if (detectWSL2()) {
-    console.warn(
-      "  \u26A0 WSL2 detected. Visual PDF search has known limitations:\n    \u2022 Ensure your project is on the Linux filesystem (/home/...), not /mnt/c/...\n    \u2022 Allocate at least 8 GB to WSL2 in %USERPROFILE%\\.wslconfig\n    \u2022 CUDA requires updated NVIDIA drivers with WSL2 support"
-    );
-  }
-  try {
-    const res = await fetch(`${endpoint}/health`, { signal: AbortSignal.timeout(2e3) });
-    if (res.ok) {
-      console.log(`  PixelRAG server already running on port ${port}.`);
-      return;
-    }
-  } catch {
-  }
-  if (!fs.existsSync(indexDir)) {
-    console.warn(
-      `  \u26A0 PixelRAG index not found at ${indexDir}.
-  Run: kirograph index \u2014 to build it first.`
-    );
-    return;
-  }
-  const pixelragBin = getPixelRAGBin(python);
-  console.log(`  Starting PixelRAG server on port ${port}\u2026`);
-  _serverProcess = (0, import_child_process.spawn)(
-    pixelragBin,
-    [
-      "serve",
-      "--index-dir",
-      indexDir,
-      "--tiles-dir",
-      path.join(indexDir, "tiles"),
-      "--articles-json",
-      path.join(indexDir, "articles.json"),
-      "--port",
-      String(port)
-    ],
-    { stdio: ["ignore", "ignore", "ignore"], detached: false, env: PIXELRAG_ENV }
-  );
-  _serverProcess.on("error", (err) => {
-    console.warn(`  \u26A0 PixelRAG server error: ${err.message}`);
-  });
-  registerCleanup();
-  const ready = await pollHealth(endpoint, 90, 2e3);
-  if (ready) {
-    console.log(`  \u2713 PixelRAG server ready on port ${port}.`);
-  } else {
-    console.warn(
-      `  \u26A0 PixelRAG server did not respond within 3 minutes.
-  Visual PDF search calls will fail until it is ready.`
-    );
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildIndex,
-  checkRam,
-  detectPython,
-  detectWSL2,
-  downloadPixelRAGModel,
-  ensurePixelRAGInstalled,
-  ensurePython,
-  getFlaggedPdfs,
-  installPixelRAG,
-  isPixelRAGInstalled,
-  startServer
-});
-//# sourceMappingURL=pixelrag-manager.js.map