docs: align README and architecture with SHA-256 hashes and adapters

- Fix content_hash docs (was Bun.hash; use src/hash.ts SHA-256)
- Layering table + CLI/agents + export list; packaging library row

Author: SutuSebastian

README.md

@@ -18,7 +18,7 @@ bun add @stainless-code/codemap
 
 (`0.0.0` until the first npm release; use a git dependency or `bun link` until then.)
 
-The package exposes a **`codemap`** binary, a **library** entry (`import` / `exports`), and ships compiled **`dist/`** — see [docs/packaging.md](docs/packaging.md).
+The package exposes a **`codemap`** binary, a **library** entry (`import` / `exports`), compiled **`dist/`**, and **`templates/agents`** for **`codemap agents init`** — see [docs/packaging.md](docs/packaging.md).
 
 **Engines:** Node **≥20** and/or Bun **≥1.1** (see `package.json`).
 
@@ -94,7 +94,7 @@ bun run check    # build + format:check + lint + test + typecheck
 bun run fix      # oxlint --fix, then oxfmt
 ```
 
-**Readability & DX:** Prefer clear names and small functions over cleverness. **Public API** surface (`createCodemap`, `Codemap`, config types, `runCodemapIndex`) should stay **documented with JSDoc** so consumers get good hovers and published `.d.ts` stay useful. **Layering** (`cli` → `application` → parsers / SQLite): see [docs/architecture.md](docs/architecture.md). More for contributors: [.github/CONTRIBUTING.md](.github/CONTRIBUTING.md).
+**Readability & DX:** Prefer clear names and small functions over cleverness. **Public API** surface (`createCodemap`, `Codemap`, config types, `runCodemapIndex`, adapter exports) should stay **documented with JSDoc** so consumers get good hovers and published `.d.ts` stay useful. **Layering** (`cli` → `application` → `adapters` / parsers → SQLite): see [docs/architecture.md](docs/architecture.md). More for contributors: [.github/CONTRIBUTING.md](.github/CONTRIBUTING.md).
 
 ---
 

docs/architecture.md

@@ -15,7 +15,8 @@ A local SQLite database (`.codemap.db`) indexes the project tree and stores stru
 | **`cli.ts`**                                 | Parses argv (`--root`, `--config`, `query`, `agents init`, `--files`, `--full`), wires bootstrap → `runCodemapIndex` / `printQueryResult`.                        |
 | **`api.ts`**                                 | Public programmatic surface: `createCodemap()`, `Codemap` (`query`, `index`), re-exports `runCodemapIndex` for advanced use.                                      |
 | **`application/`**                           | Use cases: `run-index.ts` (incremental / full / targeted orchestration), `index-engine.ts` (collect files, git diff, `indexFiles`, workers via `worker-pool.ts`). |
-| **`runtime.ts` / `config.ts` / `db.ts` / …** | Infrastructure and parsing — unchanged responsibilities.                                                                                                          |
+| **`adapters/`**                              | `LanguageAdapter` registry; built-ins call `parser.ts` / `css-parser.ts` / `markers.ts` from `parse-worker-core`.                                                 |
+| **`runtime.ts` / `config.ts` / `db.ts` / …** | Config, SQLite, resolver, workers.                                                                                                                                |
 
 `index.ts` is the package entry: re-exports the public API and runs `cli.ts` only when executed as the main module (Node/Bun `codemap` binary).
 
@@ -88,7 +89,7 @@ A local SQLite database (`.codemap.db`) indexes the project tree and stores stru
 | File              | Purpose                                                                                          |
 | ----------------- | ------------------------------------------------------------------------------------------------ |
 | `index.ts`        | Package entry — re-exports `api` / `config`, runs CLI when main                                  |
-| `cli.ts`          | CLI adapter — argv parsing, `query` / index commands                                             |
+| `cli.ts`          | CLI — argv parsing, `query`, `agents init`, `--files`, index modes                               |
 | `api.ts`          | Programmatic API — `createCodemap`, `Codemap`, `runCodemapIndex`                                 |
 | `application/`    | Indexing use cases and engine (`run-index`, `index-engine`, types)                               |
 | `worker-pool.ts`  | Parallel parse workers (Bun / Node)                                                              |
@@ -130,7 +131,7 @@ When specific file paths are passed via `--files`, the indexer skips git diff, g
 
 ## Programmatic usage
 
-The npm package exports **`createCodemap`**, **`Codemap`** (`query`, `index`), **`runCodemapIndex`** (advanced), and config helpers — see **`src/api.ts`** and **`dist/index.d.mts`**. Typical flow:
+The npm package exports **`createCodemap`**, **`Codemap`** (`query`, `index`), **`runCodemapIndex`** (advanced), config helpers, **`CodemapDatabase`** (type), adapter types (`LanguageAdapter`, `getAdapterForExtension`, …), and **`ParsedFile`** — see **`src/api.ts`** / **`src/index.ts`** and **`dist/index.d.mts`**. Typical flow:
 
 1. **`await createCodemap({ root, configFile?, config? })`** — loads `codemap.config.*`, calls **`initCodemap`** and **`configureResolver`**.
 2. **`await cm.index({ mode, files?, quiet? })`** — same pipeline as the CLI (incremental / full / targeted).
@@ -146,15 +147,15 @@ All tables use `STRICT` mode. Tables marked with `WITHOUT ROWID` store data dire
 
 ### `files` — Every indexed file (`STRICT`)
 
-| Column        | Type    | Description                           |
-| ------------- | ------- | ------------------------------------- |
-| path          | TEXT PK | Relative path from project root       |
-| content_hash  | TEXT    | `Bun.hash` (wyhash) as base-36 string |
-| size          | INTEGER | File size in bytes                    |
-| line_count    | INTEGER | Total lines                           |
-| language      | TEXT    | `ts`, `tsx`, `css`, `md`, etc.        |
-| last_modified | INTEGER | File mtime (epoch ms)                 |
-| indexed_at    | INTEGER | When this row was written             |
+| Column        | Type    | Description                                       |
+| ------------- | ------- | ------------------------------------------------- |
+| path          | TEXT PK | Relative path from project root                   |
+| content_hash  | TEXT    | SHA-256 hex (`src/hash.ts`, same on Node and Bun) |
+| size          | INTEGER | File size in bytes                                |
+| line_count    | INTEGER | Total lines                                       |
+| language      | TEXT    | `ts`, `tsx`, `css`, `md`, etc.                    |
+| last_modified | INTEGER | File mtime (epoch ms)                             |
+| indexed_at    | INTEGER | When this row was written                         |
 
 ### `symbols` — Functions, variables, classes, interfaces, type aliases, enums (`STRICT`)
 

docs/benchmark.md

@@ -62,7 +62,7 @@ Each scenario runs both approaches back-to-back on the same machine, same data.
 
 ## Results
 
-Example snapshot from `bun src/benchmark.ts` immediately after `bun src/index.ts --full` on **this repository** (small tree; many scenario result counts are zero — that is expected here). Numbers vary by machine and project shape. Settings: schema v2, `Bun.hash` content fingerprints, `db.query()` caching, covering/partial indexes, mmap, worker threads, deferred indexes, `batchInsert` helper.
+Example snapshot from `bun src/benchmark.ts` immediately after `bun src/index.ts --full` on **this repository** (small tree; many scenario result counts are zero — that is expected here). Numbers vary by machine and project shape. Settings: schema v2, SHA-256 content fingerprints (`src/hash.ts`), `db.query()` caching, covering/partial indexes, mmap, worker threads, deferred indexes, `batchInsert` helper.
 
 | Scenario                                | Index Time | Results | Trad. Time | Results | Files Read | Bytes Read | Speedup  |
 | --------------------------------------- | ---------- | ------- | ---------- | ------- | ---------- | ---------- | -------- |

docs/packaging.md

@@ -10,11 +10,11 @@ How **@stainless-code/codemap** is built and consumed on npm.
 
 ## Entry points
 
-| Surface             | Location                                                                                                                                                                             |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **CLI**             | `package.json` → `"bin": { "codemap": "./dist/index.mjs" }` — same file as the library entry; **shebang** prepended at build time (tsdown `banner`) for `npx` / `node_modules/.bin`. |
-| **Library**         | `"exports"` / `"main"` / `"types"` → **`./dist/index.mjs`** and **`./dist/index.d.mts`** — `createCodemap`, `Codemap`, `defineConfig`, config types, `runCodemapIndex`, etc.         |
-| **Published files** | `package.json` → `"files": ["dist", "templates"]` — `src/` is not published; **`templates/agents`** supports `codemap agents init`.                                                  |
+| Surface             | Location                                                                                                                                                                                      |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **CLI**             | `package.json` → `"bin": { "codemap": "./dist/index.mjs" }` — same file as the library entry; **shebang** prepended at build time (tsdown `banner`) for `npx` / `node_modules/.bin`.          |
+| **Library**         | `"exports"` / `"main"` / `"types"` → **`./dist/index.mjs`** and **`./dist/index.d.mts`** — `createCodemap`, `Codemap`, `defineConfig`, config types, `runCodemapIndex`, adapter helpers, etc. |
+| **Published files** | `package.json` → `"files": ["dist", "templates"]` — `src/` is not published; **`templates/agents`** supports `codemap agents init`.                                                           |
 
 ## Install