@repo-prism/indexer

Workspace walk, ignore rules, content hashing, and repository index jobs.

Implemented: M-005 (inventory), M-007 (IndexJob), M-008 (SQLite cache)
Next: M-033 watch / incremental (uses this cache)
Depends on: @repo-prism/shared, @repo-prism/analyzer, better-sqlite3
Surfaces: must call via @repo-prism/core only (ADR-0004)

Index job (M-007)

import { runIndexJob } from "@repo-prism/indexer";

const result = await runIndexJob("/absolute/path/to/repo", {
  concurrency: 4,
  onProgress: (e) => console.log(e.phase, e.filesDone, e.path),
  signal: AbortSignal.timeout(30_000),
});

Pipeline: inventory → SQLite cache match → analyze changed → IndexSnapshot → persist.
Per-file analyze failures are recorded (status: "failed") and do not fail the job.

Cache (M-008 / ADR-0010)

| Item | Value | |---|---| | Path | <workspace>/.prism/cache/index.sqlite | | Hit | Unchanged contentHash → reuse symbols/imports/exports (no re-parse) | | Privacy | Local only; never uploaded | | Corrupt DB | Deleted and rebuilt on next open |

Disable with { cache: false } or override path with { cacheDbPath }.

Core façade:

const ws = Prism.create().openRepository(root).value;
await ws.index();
const snap = ws.getIndex();

Inventory API

import { inventoryWorkspace } from "@repo-prism/indexer";

const result = await inventoryWorkspace("/absolute/path/to/repo");

Ignore rules (applied in order)

1. Built-ins (node_modules/, .git/, .prism/, common binaries, …)
2. Root .gitignore
3. Root .prismignore
4. Optional extraIgnorePatterns

Policies

| Policy | Behavior | |---|---| | Hash | SHA-256 hex (hashAlgo: "sha256") | | Binary | NUL sniff → skipped_binary | | Oversized | Default > 5 MiB → skipped_oversized | | Unsupported ext | skipped_unsupported (no language plugin) | | Analyze error | failed + warning; job continues |

Timing note (M-007 fixture)

fixtures/m007-mini (4 files): warm runIndexJob typically < 50 ms on a developer Mac (not a CI gate).

See also

• ADR-0006 — hash algorithm
• Golden fixture: fixtures/m007-mini/