project-librarian 0.4.0 → 0.4.1

package/README.ko.md

@@ -85,7 +85,7 @@ npm run benchmark:release -- --allow-codex-run
 | 중형 | 53.4% 적음 | 4.4% 적음 | 68.5% 적음 |
 | 대형 | 71.6% 적음* | 12.8% 적음 | 66.0% 적음 |
 
-최신 합성 위키 트랙 릴리스 후보는 2026-06-16에 `gpt-5.5`로 측정했으며, 42개 시나리오를 각 3회 측정하고 1회 예열했습니다. 전체 주장 게이트는 **실패**했습니다. 42개 중 41개 시나리오는 정확성 검사를 통과했지만, Project Librarian이 없는 대형 `decision_lookup` 대조군이 3회 중 2회만 정답이었습니다. 실패한 대조군 실행은 기대한 최신 benchmark evidence 결정인 `2026-06-10` decision log 항목 대신, dated history 파일의 `2026-05-04` 항목을 골랐습니다. 따라서 이 표는 공개 릴리스 주장이 아니라 진단 근거로만 보아야 하며, 깨끗한 릴리스 실행이 주장 게이트를 통과해야 공개 주장으로 쓸 수 있습니다. 숨기지 않는 한계도 그대로 남습니다. 소형 `aggregation`은 위키를 켰을 때 훨씬 비싸고, 소형 `multi_session`도 약간 더 비싸며, `aggregation`은 토큰 비용이 줄어드는 규모에서도 실행 시간은 매번 더 느립니다.
+최신 합성 위키 트랙 릴리스 후보는 2026-06-16에 `gpt-5.5`로 측정했으며, 42개 시나리오를 각 3회 측정하고 1회 예열했습니다. 전체 주장 게이트는 **실패**했습니다. 42개 중 41개 시나리오는 정확성 검사를 통과했지만, Project Librarian이 없는 대형 `decision_lookup` 대조군이 3회 중 2회만 정답이었습니다. 실패한 대조군 실행은 날짜가 붙은 히스토리 파일에서 `2026-05-04`를 골랐고, 기대값은 결정 로그의 최신 벤치마크 근거 결정인 `2026-06-10`이었습니다. 따라서 이 표는 공개 릴리스 주장이 아니라 진단 근거로만 보아야 하며, 깨끗한 릴리스 실행이 주장 게이트를 통과해야 공개 주장으로 쓸 수 있습니다. 숨기지 않는 한계도 그대로 남습니다. 소형 `aggregation`은 위키를 켰을 때 훨씬 비싸고, 소형 `multi_session`도 약간 더 비싸며, `aggregation`은 토큰 비용이 줄어드는 규모에서도 실행 시간은 매번 더 느립니다.
 
 ### 코드 그래프 트랙 (코드 근거 인덱스, 실제 저장소)
 
@@ -188,6 +188,7 @@ npx project-librarian install-skill --scope project --agents all
 | 증분 갱신 요구 | "Project Librarian 코드 근거 인덱스를 증분 갱신해줘." | `--code-index --incremental` |
 | 전체 재생성 강제 | "Project Librarian 코드 근거 인덱스를 전체 재생성해줘." | `--code-index --code-index-full` |
 | 선택적 Tree-sitter 백엔드 사용 | "Tree-sitter 파서로 Project Librarian 코드 근거를 만들어줘." | `--code-index --code-parser tree-sitter` |
+| 캐시 호환성 진단 | "Project Librarian 코드 근거 캐시 health를 확인해줘." | `--code-index-health` |
 | 캐시 상태 보기 | "Project Librarian 코드 근거 상태를 보여줘." | `--code-status` |
 | 인덱싱된 파일 목록 | "Project Librarian 코드 근거에 인덱싱된 파일을 보여줘." | `--code-files` |
 | 아키텍처/소유권 보고서 출력 | "Project Librarian 코드 보고서를 보여줘." | `--code-report` |
@@ -240,7 +241,7 @@ Git 훅 파일:
 - `wiki/index.md`
 - `wiki/meta/document-taxonomy.md`
 
-`canonical/project-brief.md`, `canonical/open-questions.md`, `canonical/assumptions.md`, `canonical/risks.md`, ADR 템플릿처럼 실제 내용이 없는 빈 프로젝트 문서는 기본 생성하지 않습니다. 나중에 실제 내용이 생기면 문서를 만들고 `--refresh-index`로 라우팅할 수 있습니다. 마이그레이션 중 발견한 양식 전용 legacy 템플릿은 새 위키 페이지나 검토 row로 만들지 않고 `wiki/migration/inventory.md`에 스킵 사유만 남깁니다.
+`canonical/project-brief.md`, `canonical/open-questions.md`, `canonical/assumptions.md`, `canonical/risks.md`, ADR 템플릿처럼 실제 내용이 없는 빈 프로젝트 문서는 기본 생성하지 않습니다. 나중에 실제 내용이 생기면 문서를 만들고 `--refresh-index`로 라우팅할 수 있습니다. 마이그레이션 중 발견한 양식 전용 기존 템플릿은 새 위키 페이지나 검토 행으로 만들지 않고 `wiki/migration/inventory.md`에 스킵 사유만 남깁니다.
 
 MCP 서버 등록 (`mcpServers`에 기존 항목 보존하며 병합):
 
@@ -276,12 +277,12 @@ codex mcp add project-librarian -- node .codex/skills/project-librarian/dist/ini
 6. `--refresh-index`는 새로 발견한 위키 페이지를 라우팅하며, route가 많으면 `wiki/indexes/auto-*.md` 범위별 라우터로 분리합니다.
 7. `--code-index`는 `.project-wiki/` 아래 폐기 가능한 SQLite 근거 캐시를 만듭니다.
 8. `--code-report`, `--code-impact`, `--code-context-pack`, `--code-search-symbol`, `--code-query`가 계획 갱신용 코드 근거를 제공합니다.
-9. 읽기 전용 위키 소비자는 공통 concept read model을 사용해 canonical 위키 스키마를 다시 쓰지 않고 경로와 frontmatter에서 사용자용 페이지 유형을 파생합니다.
-10. 위키 생산자는 기존 markdown/YAML 정본 스키마를 계속 작성하고, 진단·MCP·시각화 같은 읽기 전용 소비자는 원본 문서를 바꾸지 않는 파생 보기를 사용합니다.
-11. `--wiki-visualize`는 데이터베이스나 서버를 추가하지 않고 기존 위키 그래프와 concept read model을 재사용해 `.project-wiki/` 아래 정적 그래프 산출물을 작성합니다.
+9. 읽기 전용 위키 소비자는 공통 개념 읽기 모델을 사용해 정본 위키 스키마를 다시 쓰지 않고 경로와 frontmatter에서 사용자용 페이지 유형을 파생합니다.
+10. 위키 생산자는 기존 Markdown/YAML 정본 스키마를 계속 작성하고, 진단·MCP·시각화 같은 읽기 전용 소비자는 원본 문서를 바꾸지 않는 파생 보기를 사용합니다.
+11. `--wiki-visualize`는 데이터베이스나 서버를 추가하지 않고 기존 위키 그래프와 개념 읽기 모델을 재사용해 `.project-wiki/` 아래 정적 그래프 산출물을 작성합니다.
 12. 진단은 깨진 링크, 중복 route, 고아 페이지, 오래된 페이지, 누락된 TL;DR, 근거 누락, 마이그레이션 정책 위반을 보고합니다.
 
-마이그레이션은 검토를 우선합니다. `--migrate`는 기존 `wiki/`를 `wiki_legacy*`로 보존하고, 양식 전용 legacy 파일은 제외한 뒤, 여러 성격의 내용이 섞인 기존 페이지를 의미 단위로 나눕니다. 이후 각 단위를 문서 분류 체계에 따라 분류해 `wiki/migration/` 아래 검토 파일을 작성합니다.
+마이그레이션은 검토를 우선합니다. `--migrate`는 기존 `wiki/`를 `wiki_legacy*`로 보존하고, 양식 전용 기존 파일은 제외한 뒤, 여러 성격의 내용이 섞인 기존 페이지를 의미 단위로 나눕니다. 이후 각 단위를 문서 분류 체계에 따라 분류해 `wiki/migration/` 아래 검토 파일을 작성합니다.
 
 - `inventory.md`는 기존 마크다운 파일 목록과 파일 단위 분류를 기록합니다.
 - `unit-map.md`는 각 제목, 문단, 목록 항목, 표 행, 코드 블록의 권장 분류 영역과 대상 페이지를 기록합니다.
@@ -351,6 +352,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install-skill [--
 | `--review-migration`, `--semantic-migrate` | 마이그레이션 coverage와 수신함 상태를 마이그레이션 검토 파일에 동기화합니다. |
 | `--no-git-config` | `git core.hooksPath`를 바꾸지 않고 훅 파일을 설치합니다. |
 | `--code-index` | 폐기 가능한 코드 근거 인덱스를 빌드합니다. |
+| `--code-index-health` | 코드 근거 캐시 호환성을 검사하고 쓰기 없이 재빌드 안내를 출력합니다. |
 | `--code-report` | 근거 인덱스에서 아키텍처/소유권 요약을 출력합니다. |
 | `--code-report-section <section>` | 한 섹션만 출력: `coverage`, `ownership`, `languages`, `parsers`, `workspaces`, `workspace-graph`, `routes`, `hotspots`, `configs`, `edges`. |
 | `--code-impact <term>` | 파일, 심볼, route, import, edge, 소유자 영향 근거를 보여줍니다. |
@@ -367,13 +369,26 @@ npm install
 npm run typecheck
 npm run build
 npm test
+npm run benchmark:claim-ledger
+npm run release:check
 npm pack --dry-run
 ```
 
 `src/` 아래 TypeScript를 수정할 때는 커밋 전에 빌드해 `dist/`를 최신 상태로 유지하세요.
 
+`npm run release:check`는 로컬 전용 관리자 게이트입니다. 테스트, 벤치마크 파서 smoke, 벤치마크 release preview, 벤치마크 claim ledger 분류, package dry-run 검사, dist 실행 가능 여부, README 벤치마크 claim 경계 문구를 확인합니다. publish하지 않고 measured Codex 벤치마크도 실행하지 않습니다.
+
 관리자 벤치마크 명령은 [benchmarks/README.md](benchmarks/README.md)에 있습니다. 이 명령은 릴리스 근거와 공개 주장 검증을 위한 것이며, 일반 사용자 설정 절차가 아닙니다.
 
+코드 근거 런타임/스토리지 점검에는 `npm run perf:code-efficiency`를 사용합니다. 이 명령은 3k/10k/50k 픽스처를 생성하고 `benchmarks/reports/code-performance-efficiency/current.json`과 `.md`를 작성합니다. 명령 시간에는 CLI 시작과 freshness 확인이 포함되며, `query_groups` 섹션은 대표 file/symbol/route/import/edge 쿼리의 직접 DB 시간을 따로 보고합니다. 보고서에는 `mixed-monorepo`를 포함한 체크인 샘플 corpus도 합성 scale fixture와 분리해 포함됩니다.
+
+무시된 오래된 LLM 벤치마크 raw 출력은 격리 Codex home을 삭제하기 전에 dry-run-first 헬퍼로 먼저 감사할 수 있습니다.
+
+```bash
+npm run benchmark:llm:prune-raw -- --older-than-days 14
+npm run benchmark:llm:prune-raw -- --older-than-days 14 --execute
+```
+
 ## 영감
 
 이 프로젝트는 Andrej Karpathy의 [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 패턴에서 영감을 받았습니다. 긴 대화 기록에서 프로젝트 상태를 재구성하는 대신, 지속되는 markdown 컨텍스트를 작업 가까이에 둡니다.

package/README.md

@@ -351,6 +351,7 @@ Important options:
 | `--review-migration`, `--semantic-migrate` | Sync migration coverage and inbox statuses into migration review files. |
 | `--no-git-config` | Install hook files without changing `git core.hooksPath`. |
 | `--code-index` | Build the disposable code evidence index. |
+| `--code-index-health` | Inspect code evidence cache compatibility and print rebuild guidance without writing. |
 | `--code-report` | Print architecture and ownership summaries from the evidence index. |
 | `--code-report-section <section>` | Print one section: `coverage`, `ownership`, `languages`, `parsers`, `workspaces`, `workspace-graph`, `routes`, `hotspots`, `configs`, or `edges`. |
 | `--code-impact <term>` | Show file, symbol, route, import, edge, and owner impact evidence. |
@@ -367,13 +368,26 @@ npm install
 npm run typecheck
 npm run build
 npm test
+npm run benchmark:claim-ledger
+npm run release:check
 npm pack --dry-run
 ```
 
 When editing TypeScript under `src/`, rebuild before committing so `dist/` stays current.
 
+`npm run release:check` is a local-only maintainer gate: it runs tests, benchmark parser smoke, benchmark release preview, benchmark claim-ledger classification, package dry-run inspection, dist executable checks, and README benchmark-claim boundary checks. It never publishes and never launches a measured Codex benchmark.
+
 Maintainer benchmark commands live in [benchmarks/README.md](benchmarks/README.md). They are for release evidence and public claim validation, not normal end-user setup.
 
+For code-evidence runtime/storage checks, `npm run perf:code-efficiency` generates 3k/10k/50k fixtures and writes `benchmarks/reports/code-performance-efficiency/current.json` plus `.md`. Command timings include CLI startup and freshness checks; the `query_groups` section reports direct DB timings for representative file/symbol/route/import/edge queries. The report also includes checked-in sample corpora, including `mixed-monorepo`, separately from synthetic scale fixtures.
+
+Old ignored LLM benchmark raw output can be audited with the dry-run-first helper before deleting retained isolated Codex homes:
+
+```bash
+npm run benchmark:llm:prune-raw -- --older-than-days 14
+npm run benchmark:llm:prune-raw -- --older-than-days 14 --execute
+```
+
 ## Inspiration
 
 This project is inspired by Andrej Karpathy's [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) pattern: keep persistent markdown context close to the work instead of reconstructing project state from long chat history.

package/dist/args.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = exports.codeImpactTarget = exports.codeContextPackTarget = exports.wikiVisualizeOutput = exports.wikiVisualizeMode = exports.wikiImpactTarget = exports.wikiImpactMode = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeContextPackMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexFullMode = exports.codeIndexIncrementalMode = exports.codeIndexMode = exports.acknowledgeSmallRepoMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.migrationQualityCheckMode = exports.migrationLintMode = exports.migrationDoctorMode = exports.lintMode = exports.migrateMode = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.parsedArgs = exports.rawArgs = void 0;
-exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = void 0;
+exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = exports.codeImpactTarget = exports.codeContextPackTarget = exports.wikiVisualizeOutput = exports.wikiVisualizeMode = exports.wikiImpactTarget = exports.wikiImpactMode = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeContextPackMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexHealthMode = exports.codeIndexFullMode = exports.codeIndexIncrementalMode = exports.codeIndexMode = exports.acknowledgeSmallRepoMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.migrationQualityCheckMode = exports.migrationLintMode = exports.migrationDoctorMode = exports.lintMode = exports.migrateMode = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.parsedArgs = exports.rawArgs = void 0;
+exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = void 0;
 exports.parseArgs = parseArgs;
 exports.argValue = argValue;
 exports.argValues = argValues;
@@ -18,6 +18,7 @@ const flagsWithoutValues = new Set([
     "--code-incremental",
     "--code-index",
     "--code-index-full",
+    "--code-index-health",
     "--code-index-incremental",
     "--code-evidence-index-full",
     "--code-evidence-index-incremental",
@@ -151,6 +152,7 @@ function parseArgs(argv) {
         codeImpactMode: hasFlag("--code-impact") || hasFlag("--code-evidence-impact"),
         codeImpactTarget,
         codeIndexFullMode: args.has("--code-index-full") || args.has("--code-evidence-index-full"),
+        codeIndexHealthMode: args.has("--code-index-health"),
         codeIndexIncrementalMode: args.has("--incremental") || args.has("--code-incremental") || args.has("--code-index-incremental") || args.has("--code-evidence-index-incremental"),
         codeIndexMode: args.has("--code-index") || args.has("--code-evidence-index"),
         codeIndexOutput: argValue("--code-index-out") || argValue("--code-evidence-out") || ".project-wiki/code-evidence.sqlite",
@@ -233,6 +235,7 @@ exports.acknowledgeSmallRepoMode = exports.parsedArgs.acknowledgeSmallRepoMode;
 exports.codeIndexMode = exports.parsedArgs.codeIndexMode;
 exports.codeIndexIncrementalMode = exports.parsedArgs.codeIndexIncrementalMode;
 exports.codeIndexFullMode = exports.parsedArgs.codeIndexFullMode;
+exports.codeIndexHealthMode = exports.parsedArgs.codeIndexHealthMode;
 exports.codeReportMode = exports.parsedArgs.codeReportMode;
 exports.codeStatusMode = exports.parsedArgs.codeStatusMode;
 exports.codeFilesMode = exports.parsedArgs.codeFilesMode;

package/dist/code-index/evidence.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectCodeEvidence = collectCodeEvidence;
+const ownership_1 = require("./ownership");
+const search_1 = require("./search");
+function sortedUnique(values) {
+    return Array.from(new Set(values.filter(Boolean))).sort();
+}
+function ownerRowsForFilePaths(filePaths, options) {
+    const ownership = (0, ownership_1.ownershipContext)();
+    const ownersByName = new Map();
+    for (const filePath of filePaths) {
+        const info = (0, ownership_1.ownershipInfo)(filePath, ownership);
+        const current = ownersByName.get(info.owner) ?? {
+            codeowners: new Set(),
+            files: 0,
+            owner: info.owner,
+            owner_source: info.owner_source,
+            sample_files: [],
+        };
+        current.files += 1;
+        if (current.sample_files.length < options.ownerSampleLimit)
+            current.sample_files.push(filePath);
+        if (options.includeOwnerCodeowners && info.codeowners) {
+            for (const owner of info.codeowners.split(", ").filter(Boolean))
+                current.codeowners.add(owner);
+        }
+        ownersByName.set(info.owner, current);
+    }
+    return Array.from(ownersByName.values()).map((owner) => {
+        const row = {
+            files: owner.files,
+            owner: owner.owner,
+            owner_source: owner.owner_source,
+            sample_files: owner.sample_files,
+        };
+        if (options.includeOwnerCodeowners)
+            row.codeowners = Array.from(owner.codeowners).sort().join(", ");
+        return row;
+    }).sort((left, right) => right.files - left.files || left.owner.localeCompare(right.owner));
+}
+function collectCodeEvidence(database, query, options) {
+    const normalized = query.trim();
+    const like = (0, search_1.containsLikePattern)(normalized);
+    const files = (0, search_1.searchFiles)(database, normalized, options.fileLimit);
+    const symbols = (0, search_1.searchSymbols)(database, normalized, options.symbolLimit);
+    const routes = database.prepare("SELECT method, route, file_path, line, handler FROM routes WHERE route LIKE ? ESCAPE '\\' OR handler LIKE ? ESCAPE '\\' OR file_path LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT ?").all(like, like, like, options.routeLimit);
+    const imports = database.prepare("SELECT from_file, to_ref, imported, line, raw FROM imports WHERE from_file LIKE ? ESCAPE '\\' OR to_ref LIKE ? ESCAPE '\\' OR imported LIKE ? ESCAPE '\\' ORDER BY from_file, line LIMIT ?").all(like, like, like, options.importLimit);
+    const outgoingEdges = options.includeEdgeEvidenceMatches
+        ? database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE file_path LIKE ? ESCAPE '\\' OR source LIKE ? ESCAPE '\\' OR evidence LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT ?").all(like, like, like, options.edgeLimit)
+        : database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE file_path LIKE ? ESCAPE '\\' OR source LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT ?").all(like, like, options.edgeLimit);
+    const incomingEdges = options.includeEdgeEvidenceMatches
+        ? database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE target LIKE ? ESCAPE '\\' OR evidence LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT ?").all(like, like, options.edgeLimit)
+        : database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE target LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT ?").all(like, options.edgeLimit);
+    const routeTargets = routes.map((row) => `${String(row.method)} ${String(row.route)}`);
+    const routeEdges = options.includeRouteEdges && routeTargets.length > 0
+        ? database.prepare(`SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE source IN (${routeTargets.map(() => "?").join(", ")}) ORDER BY file_path, line LIMIT ?`).all(...routeTargets, options.routeEdgeLimit)
+        : [];
+    const relatedFilePaths = sortedUnique([
+        ...files.map((row) => String(row.path ?? "")),
+        ...symbols.map((row) => String(row.file_path ?? "")),
+        ...routes.map((row) => String(row.file_path ?? "")),
+        ...imports.map((row) => String(row.from_file ?? "")),
+        ...outgoingEdges.map((row) => String(row.file_path ?? "")),
+        ...incomingEdges.map((row) => String(row.file_path ?? "")),
+        ...routeEdges.map((row) => String(row.file_path ?? "")),
+    ]);
+    return {
+        files,
+        imports,
+        incomingEdges,
+        owners: ownerRowsForFilePaths(relatedFilePaths, options),
+        relatedFilePaths,
+        outgoingEdges,
+        routeEdges,
+        routes,
+        symbols,
+    };
+}

package/dist/code-index/extractors/config.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexConfigs = indexConfigs;
+const path = __importStar(require("node:path"));
+const shared_1 = require("./shared");
+function indexConfigs(file, insertConfig) {
+    if (path.basename(file.path) === "package.json") {
+        try {
+            const parsed = JSON.parse(file.text);
+            for (const [name, value] of Object.entries(parsed.scripts ?? {}))
+                insertConfig.run(`script:${name}`, value, file.path, 1);
+            for (const [name, value] of Object.entries(parsed.dependencies ?? {}))
+                insertConfig.run(`dependency:${name}`, value, file.path, 1);
+            for (const [name, value] of Object.entries(parsed.devDependencies ?? {}))
+                insertConfig.run(`devDependency:${name}`, value, file.path, 1);
+        }
+        catch {
+            insertConfig.run("parse-error", "package.json is not valid JSON", file.path, 1);
+        }
+        return;
+    }
+    (0, shared_1.insertMatches)(file, /^\s*([A-Za-z0-9_.-]+)\s*[:=]\s*(.+)$/gm, (match, line) => {
+        insertConfig.run(match[1] ?? "", (match[2] ?? "").trim(), file.path, line);
+    });
+}

package/dist/code-index/extractors/light-languages.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexPythonLight = indexPythonLight;
+exports.indexGoLight = indexGoLight;
+const shared_1 = require("./shared");
+function indexPythonLight(file, statements) {
+    const symbolPatterns = [
+        [/^\s*def\s+([A-Za-z_]\w*)\s*\(([^)]*)\)/gm, "function", (match) => `def ${match[1] ?? ""}(${match[2] ?? ""})`],
+        [/^\s*class\s+([A-Za-z_]\w*)/gm, "class", (match) => `class ${match[1] ?? ""}`],
+    ];
+    for (const [regex, kind, signature] of symbolPatterns) {
+        (0, shared_1.insertMatches)(file, regex, (match, line) => (0, shared_1.insertSymbol)(statements, match[1] ?? "", kind, file, line, signature(match)));
+    }
+    const importPatterns = [
+        [/^\s*from\s+([A-Za-z0-9_.$]+)\s+import\s+(.+)$/gm, (match) => [match[1] ?? "", match[2] ?? ""]],
+        [/^\s*import\s+([A-Za-z0-9_.$, \t]+)$/gm, (match) => [match[1] ?? "", ""]],
+    ];
+    for (const [regex, fields] of importPatterns) {
+        (0, shared_1.insertMatches)(file, regex, (match, line) => {
+            const [toRef, imported] = fields(match);
+            statements.insertImport.run(file.path, toRef, imported.trim(), line, match[0].trim());
+            (0, shared_1.insertEdge)(statements, "import", "file", file.path, "module", toRef, file, line, match[0].trim());
+        });
+    }
+}
+function indexGoLight(file, statements) {
+    const symbolPatterns = [
+        [/^\s*func\s*\(\s*[^)]*\)\s*([A-Za-z_]\w*)\s*\(([^)]*)\)/gm, "method", (match) => match[1] ?? "", (match) => `func (...) ${match[1] ?? ""}(${match[2] ?? ""})`],
+        [/^\s*func\s+([A-Za-z_]\w*)\s*\(([^)]*)\)/gm, "function", (match) => match[1] ?? "", (match) => `func ${match[1] ?? ""}(${match[2] ?? ""})`],
+        [/^\s*type\s+([A-Za-z_]\w*)\s+(struct|interface)?/gm, "type", (match) => match[1] ?? "", (match) => `type ${match[1] ?? ""} ${match[2] ?? ""}`.trim()],
+        [/^\s*const\s+([A-Za-z_]\w*)\b/gm, "constant", (match) => match[1] ?? "", (match) => `const ${match[1] ?? ""}`],
+        [/^\s*var\s+([A-Za-z_]\w*)\b/gm, "variable", (match) => match[1] ?? "", (match) => `var ${match[1] ?? ""}`],
+    ];
+    for (const [regex, kind, name, signature] of symbolPatterns) {
+        (0, shared_1.insertMatches)(file, regex, (match, line) => (0, shared_1.insertSymbol)(statements, name(match), kind, file, line, signature(match)));
+    }
+    (0, shared_1.insertMatches)(file, /^\s*import\s+(?:(?:([A-Za-z_]\w*|[_.])\s+)?\"([^\"]+)\"|`([^`]+)`)/gm, (match, line) => {
+        const imported = match[1] ?? "";
+        const toRef = match[2] ?? match[3] ?? "";
+        (0, shared_1.insertGoImport)(file, statements, toRef, imported, line, match[0].trim());
+    });
+    (0, shared_1.insertMatches)(file, /^\s*import\s*\(([\s\S]*?)^\s*\)/gm, (blockMatch) => {
+        const block = blockMatch[1] ?? "";
+        const blockStart = blockMatch.index ?? 0;
+        for (const lineMatch of block.matchAll(/^\s*(?:([A-Za-z_]\w*|[_.])\s+)?\"([^\"]+)\"/gm)) {
+            const imported = lineMatch[1] ?? "";
+            const toRef = lineMatch[2] ?? "";
+            const line = (0, shared_1.lineNumber)(file.text, blockStart + (lineMatch.index ?? 0));
+            (0, shared_1.insertGoImport)(file, statements, toRef, imported, line, lineMatch[0].trim());
+        }
+    });
+}

package/dist/code-index/extractors/registry.js

@@ -0,0 +1,137 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractionProfile = extractionProfile;
+exports.createExtractionBackendRegistry = createExtractionBackendRegistry;
+const path = __importStar(require("node:path"));
+const config_1 = require("./config");
+const light_languages_1 = require("./light-languages");
+const tree_sitter_1 = require("./tree-sitter");
+const typescript_1 = require("./typescript");
+function treeSitterProfile(relativePath) {
+    const extension = path.extname(relativePath).toLowerCase();
+    if ([".ts", ".mts", ".cts"].includes(extension))
+        return "tree-sitter-typescript";
+    if (extension === ".tsx")
+        return "tree-sitter-tsx";
+    if ([".js", ".mjs", ".cjs", ".jsx"].includes(extension))
+        return "tree-sitter-javascript";
+    if (extension === ".py")
+        return "tree-sitter-python";
+    if (extension === ".go")
+        return "tree-sitter-go";
+    if ([".c", ".h"].includes(extension))
+        return "tree-sitter-c";
+    if ([".cc", ".cpp", ".cxx", ".hpp", ".hh", ".hxx"].includes(extension))
+        return "tree-sitter-cpp";
+    if (extension === ".cs")
+        return "tree-sitter-csharp";
+    if (extension === ".java")
+        return "tree-sitter-java";
+    if ([".kt", ".kts"].includes(extension))
+        return "tree-sitter-kotlin";
+    if (extension === ".php")
+        return "tree-sitter-php";
+    if (extension === ".rs")
+        return "tree-sitter-rust";
+    if (extension === ".swift")
+        return "tree-sitter-swift";
+    return "inventory-only";
+}
+function extractionProfile(relativePath, language, parserMode) {
+    if (language === "config")
+        return "config";
+    if (parserMode === "tree-sitter")
+        return treeSitterProfile(relativePath);
+    if (isJavaScriptLikeProfileInput(language))
+        return "typescript-ast";
+    if (language === "python")
+        return "python-light";
+    if (language === "go")
+        return "go-light";
+    return "inventory-only";
+}
+function isJavaScriptLikeProfileInput(language) {
+    return language === "javascript" || language === "typescript";
+}
+function createExtractionBackendRegistry(fail) {
+    const extractionBackends = [
+        {
+            id: "typescript-compiler",
+            index: typescript_1.indexJavaScriptLike,
+            label: "TypeScript compiler API",
+            profile: "typescript-ast",
+            strength: "structural",
+        },
+        {
+            id: "regex-light",
+            index: light_languages_1.indexPythonLight,
+            label: "Python lightweight regex",
+            profile: "python-light",
+            strength: "light",
+        },
+        {
+            id: "regex-light",
+            index: light_languages_1.indexGoLight,
+            label: "Go lightweight regex",
+            profile: "go-light",
+            strength: "light",
+        },
+        ...(0, tree_sitter_1.treeSitterBackends)(fail),
+        {
+            id: "config-key-value",
+            index: (file, statements) => (0, config_1.indexConfigs)(file, statements.insertConfig),
+            label: "Configuration key/value extractor",
+            profile: "config",
+            strength: "config",
+        },
+        {
+            id: "inventory-only",
+            index: () => undefined,
+            label: "Inventory-only file listing",
+            profile: "inventory-only",
+            strength: "inventory",
+        },
+    ];
+    const extractionBackendsByProfile = new Map(extractionBackends.map((backend) => [backend.profile, backend]));
+    return {
+        backendForProfile(profile) {
+            const backend = extractionBackendsByProfile.get(profile);
+            if (!backend)
+                fail(`missing extraction backend for profile: ${profile}`);
+            return backend;
+        },
+    };
+}

package/dist/code-index/extractors/shared.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneLine = oneLine;
+exports.lineNumber = lineNumber;
+exports.insertSymbol = insertSymbol;
+exports.insertEdge = insertEdge;
+exports.insertMatches = insertMatches;
+exports.insertGoImport = insertGoImport;
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim().slice(0, 240);
+}
+function lineNumber(text, index) {
+    return text.slice(0, index).split(/\r?\n/).length;
+}
+function insertSymbol(statements, name, kind, file, line, signature) {
+    if (!name)
+        return;
+    statements.insertSymbol.run(name, kind, file.path, line, signature);
+    statements.insertSymbolFts.run(name, kind, file.path, signature);
+}
+function insertEdge(statements, kind, sourceKind, source, targetKind, target, file, line, evidence) {
+    if (!target)
+        return;
+    statements.insertEdge.run(kind, sourceKind, source, targetKind, target, file.path, line, evidence);
+}
+function insertMatches(file, regex, insert) {
+    for (const match of file.text.matchAll(regex)) {
+        insert(match, lineNumber(file.text, match.index ?? 0));
+    }
+}
+function insertGoImport(file, statements, toRef, imported, line, raw) {
+    if (!toRef)
+        return;
+    statements.insertImport.run(file.path, toRef, imported, line, raw);
+    insertEdge(statements, "import", "file", file.path, "module", toRef, file, line, raw);
+}