@windagency/codemap-gen-for-agents 1.0.3 → 1.1.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/THIRD_PARTY_LICENSES.md +446 -55
  2. package/dist/core/cache/cache-schema.js +1 -0
  3. package/dist/core/cache/cache-schema.js.map +1 -1
  4. package/dist/core/cache/extraction-cache.d.ts +1 -0
  5. package/dist/core/cache/extraction-cache.js +1 -0
  6. package/dist/core/cache/extraction-cache.js.map +1 -1
  7. package/dist/core/cli-args-schema.d.ts +5 -1
  8. package/dist/core/cli-args-schema.js +42 -1
  9. package/dist/core/cli-args-schema.js.map +1 -1
  10. package/dist/core/cli-args.js +18 -8
  11. package/dist/core/cli-args.js.map +1 -1
  12. package/dist/core/compose.d.ts +1 -0
  13. package/dist/core/compose.js +5 -0
  14. package/dist/core/compose.js.map +1 -1
  15. package/dist/core/config-schema.d.ts +7 -0
  16. package/dist/core/config-schema.js +5 -0
  17. package/dist/core/config-schema.js.map +1 -1
  18. package/dist/core/config.d.ts +6 -0
  19. package/dist/core/config.js +14 -0
  20. package/dist/core/config.js.map +1 -1
  21. package/dist/core/generate-command.d.ts +5 -1
  22. package/dist/core/generate-command.js +15 -1
  23. package/dist/core/generate-command.js.map +1 -1
  24. package/dist/core/generate-map.d.ts +10 -0
  25. package/dist/core/generate-map.js +100 -13
  26. package/dist/core/generate-map.js.map +1 -1
  27. package/dist/core/index-warning.d.ts +9 -0
  28. package/dist/core/index-warning.js +17 -0
  29. package/dist/core/index-warning.js.map +1 -0
  30. package/dist/core/languages.d.ts +2 -0
  31. package/dist/core/languages.js +3 -0
  32. package/dist/core/languages.js.map +1 -1
  33. package/dist/core/read-command.d.ts +2 -0
  34. package/dist/core/read-command.js +6 -1
  35. package/dist/core/read-command.js.map +1 -1
  36. package/dist/core/types.d.ts +2 -0
  37. package/dist/core/types.js.map +1 -1
  38. package/dist/extraction/scip/index-hashes-schema.d.ts +8 -0
  39. package/dist/extraction/scip/index-hashes-schema.js +14 -0
  40. package/dist/extraction/scip/index-hashes-schema.js.map +1 -0
  41. package/dist/extraction/scip/indexer-process.d.ts +20 -0
  42. package/dist/extraction/scip/indexer-process.js +55 -0
  43. package/dist/extraction/scip/indexer-process.js.map +1 -0
  44. package/dist/extraction/scip/scip-call-refinement.d.ts +11 -0
  45. package/dist/extraction/scip/scip-call-refinement.js +88 -0
  46. package/dist/extraction/scip/scip-call-refinement.js.map +1 -0
  47. package/dist/extraction/scip/scip-index-reader.d.ts +9 -0
  48. package/dist/extraction/scip/scip-index-reader.js +38 -0
  49. package/dist/extraction/scip/scip-index-reader.js.map +1 -0
  50. package/dist/extraction/scip/scip-index-schema.d.ts +29 -0
  51. package/dist/extraction/scip/scip-index-schema.js +64 -0
  52. package/dist/extraction/scip/scip-index-schema.js.map +1 -0
  53. package/dist/extraction/scip/scip-index.d.ts +20 -0
  54. package/dist/extraction/scip/scip-index.js +5 -0
  55. package/dist/extraction/scip/scip-index.js.map +1 -0
  56. package/dist/extraction/scip/scip-staleness.d.ts +6 -0
  57. package/dist/extraction/scip/scip-staleness.js +65 -0
  58. package/dist/extraction/scip/scip-staleness.js.map +1 -0
  59. package/dist/extraction/scip/scip-symbol.d.ts +19 -0
  60. package/dist/extraction/scip/scip-symbol.js +68 -0
  61. package/dist/extraction/scip/scip-symbol.js.map +1 -0
  62. package/dist/extraction/scip-indexer.d.ts +32 -0
  63. package/dist/extraction/scip-indexer.js +210 -0
  64. package/dist/extraction/scip-indexer.js.map +1 -0
  65. package/dist/extraction/scip-resolver.d.ts +20 -0
  66. package/dist/extraction/scip-resolver.js +148 -0
  67. package/dist/extraction/scip-resolver.js.map +1 -0
  68. package/dist/integration/cli/cli-help.d.ts +2 -2
  69. package/dist/integration/cli/cli-help.js +9 -1
  70. package/dist/integration/cli/cli-help.js.map +1 -1
  71. package/dist/integration/mcp/tool-input-schema.d.ts +13 -0
  72. package/dist/integration/mcp/tool-input-schema.js +14 -6
  73. package/dist/integration/mcp/tool-input-schema.js.map +1 -1
  74. package/dist/integration/skill/SKILL.md +5 -2
  75. package/dist/integration/skill/skill-help.d.ts +2 -2
  76. package/dist/integration/skill/skill-help.js +9 -1
  77. package/dist/integration/skill/skill-help.js.map +1 -1
  78. package/package.json +3 -1
@@ -0,0 +1,65 @@
1
+ import { lastDescriptor, parseScipSymbol, } from "./scip-symbol.js";
2
+ // documentation/adr/0056 decision 4: whether a document still describes the file on disk, judged by
3
+ // content, never by modification time. Stored text is compared exactly. Without it, an index the
4
+ // generator ran itself compares the file's content hash with the one recorded at index time.
5
+ // Without either, every occurrence naming a declaration must still sit on that declaration's name
6
+ // (the anchor check).
7
+ // Suffixes whose occurrence range covers exactly the descriptor's own name. A namespace or meta
8
+ // occurrence covers a module path instead (`app.storage` for `app.storage/__init__:`).
9
+ const ANCHORED_SUFFIXES = new Set([
10
+ "type",
11
+ "term",
12
+ "method",
13
+ "parameter",
14
+ "typeParameter",
15
+ "macro",
16
+ ]);
17
+ function sliceCharacters(line, start, end, encoding) {
18
+ switch (encoding) {
19
+ case "utf8":
20
+ return Buffer.from(line, "utf8").subarray(start, end).toString("utf8");
21
+ case "utf32":
22
+ return Array.from(line).slice(start, end).join("");
23
+ case "utf16":
24
+ return line.slice(start, end);
25
+ }
26
+ }
27
+ // rust-analyzer anchors an operator-trait method on its operator token, sometimes on whitespace,
28
+ // and an impl's own type on `Self`. Such text holds no name to compare. An empty slice, or one
29
+ // holding any letter or digit, still has to be the name itself.
30
+ const OPERATOR_OR_SPACE = /^[^\p{L}\p{N}_]+$/u;
31
+ function isAnchored(text, name) {
32
+ return text === name || text === "Self" || OPERATOR_OR_SPACE.test(text);
33
+ }
34
+ // The name an occurrence's text must read as. scip-java anchors a constructor, `<init>`, on its
35
+ // class's name, the descriptor before it.
36
+ function anchorNameOf(descriptors) {
37
+ const last = descriptors.at(-1);
38
+ return last?.name === "<init>" ? (descriptors.at(-2)?.name ?? last.name) : last?.name;
39
+ }
40
+ // Whether one occurrence still matches the file. A local symbol, a module-path occurrence, a
41
+ // zero-width one, and one spanning lines carry no checkable name, so only their line must exist.
42
+ function isOccurrenceCurrent(occurrence, lines, encoding) {
43
+ const parsed = parseScipSymbol(occurrence.symbol);
44
+ if (parsed?.kind === "local")
45
+ return true;
46
+ if (occurrence.endLine >= lines.length)
47
+ return false;
48
+ const descriptor = lastDescriptor(parsed);
49
+ const isSingleLine = occurrence.startLine === occurrence.endLine;
50
+ const isZeroWidth = isSingleLine && occurrence.startCharacter === occurrence.endCharacter;
51
+ if (!descriptor || !ANCHORED_SUFFIXES.has(descriptor.suffix) || isZeroWidth || !isSingleLine)
52
+ return true;
53
+ const line = lines[occurrence.startLine] ?? "";
54
+ const name = parsed?.kind === "global" ? anchorNameOf(parsed.descriptors) : undefined;
55
+ return isAnchored(sliceCharacters(line, occurrence.startCharacter, occurrence.endCharacter, encoding), name ?? descriptor.name);
56
+ }
57
+ export function isDocumentCurrent(document, sourceText, hashes) {
58
+ if (document.text !== undefined)
59
+ return document.text === sourceText;
60
+ if (hashes !== undefined)
61
+ return hashes.recorded === hashes.current;
62
+ const lines = sourceText.split("\n").map((line) => (line.endsWith("\r") ? line.slice(0, -1) : line));
63
+ return document.occurrences.every((occurrence) => isOccurrenceCurrent(occurrence, lines, document.positionEncoding));
64
+ }
65
+ //# sourceMappingURL=scip-staleness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scip-staleness.js","sourceRoot":"","sources":["../../../src/extraction/scip/scip-staleness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ export type DescriptorSuffix = "namespace" | "type" | "term" | "method" | "typeParameter" | "parameter" | "meta" | "macro";
2
+ export interface ScipDescriptor {
3
+ name: string;
4
+ suffix: DescriptorSuffix;
5
+ }
6
+ export type ParsedScipSymbol = {
7
+ kind: "local";
8
+ } | {
9
+ kind: "global";
10
+ scheme: string;
11
+ package: {
12
+ manager: string;
13
+ name: string;
14
+ version: string;
15
+ };
16
+ descriptors: ScipDescriptor[];
17
+ };
18
+ export declare function parseScipSymbol(symbol: string): ParsedScipSymbol | undefined;
19
+ export declare function lastDescriptor(parsed: ParsedScipSymbol | undefined): ScipDescriptor | undefined;
@@ -0,0 +1,68 @@
1
+ // Parses a SCIP symbol string, per the grammar documented on `Symbol` in `scip.proto`:
2
+ // <scheme> ' ' <manager> ' ' <package-name> ' ' <version> ' ' <descriptor>+
3
+ // or `local <id>`. A space inside one of the four leading fields is written as two spaces, and a
4
+ // lone `.` stands for an empty field.
5
+ // One leading field: any run of non-space characters and doubled spaces.
6
+ const LEADING_FIELDS = /^((?:[^ ]| {2})+) ((?:[^ ]| {2})+) ((?:[^ ]| {2})+) ((?:[^ ]| {2})+) (.+)$/s;
7
+ // A name is a run of simple identifier characters, or backtick-quoted with "``" for a backtick.
8
+ const NAME = "([\\w+\\-$]+|`(?:[^`]|``)*`)";
9
+ // Tried in order: parameter `(name)`, type parameter `[name]`, method `name(disambiguator).`, then
10
+ // a name followed by its one-character suffix.
11
+ const DESCRIPTOR = new RegExp(`\\(${NAME}\\)|\\[${NAME}\\]|${NAME}\\([^)]*\\)\\.|${NAME}([/#.:!])`, "y");
12
+ const SUFFIX_BY_CHARACTER = {
13
+ "/": "namespace",
14
+ "#": "type",
15
+ ".": "term",
16
+ ":": "meta",
17
+ "!": "macro",
18
+ };
19
+ function unescapeField(field) {
20
+ return field === "." ? "" : field.replaceAll(" ", " ");
21
+ }
22
+ function unescapeName(name) {
23
+ return name.startsWith("`") ? name.slice(1, -1).replaceAll("``", "`") : name;
24
+ }
25
+ function toDescriptor(match) {
26
+ const [, parameter, typeParameter, method, name, suffixCharacter] = match;
27
+ if (parameter !== undefined)
28
+ return { name: unescapeName(parameter), suffix: "parameter" };
29
+ if (typeParameter !== undefined)
30
+ return { name: unescapeName(typeParameter), suffix: "typeParameter" };
31
+ if (method !== undefined)
32
+ return { name: unescapeName(method), suffix: "method" };
33
+ const suffix = SUFFIX_BY_CHARACTER[suffixCharacter ?? ""];
34
+ return name !== undefined && suffix ? { name: unescapeName(name), suffix } : undefined;
35
+ }
36
+ function parseDescriptors(text) {
37
+ const descriptors = [];
38
+ DESCRIPTOR.lastIndex = 0;
39
+ while (DESCRIPTOR.lastIndex < text.length) {
40
+ const match = DESCRIPTOR.exec(text);
41
+ const descriptor = match ? toDescriptor(match) : undefined;
42
+ if (!descriptor)
43
+ return undefined;
44
+ descriptors.push(descriptor);
45
+ }
46
+ return descriptors;
47
+ }
48
+ export function parseScipSymbol(symbol) {
49
+ if (symbol.startsWith("local "))
50
+ return { kind: "local" };
51
+ const fields = LEADING_FIELDS.exec(symbol);
52
+ if (!fields)
53
+ return undefined;
54
+ const [, scheme = "", manager = "", name = "", version = "", rest = ""] = fields;
55
+ const descriptors = parseDescriptors(rest);
56
+ if (!descriptors)
57
+ return undefined;
58
+ return {
59
+ kind: "global",
60
+ scheme: unescapeField(scheme),
61
+ package: { manager: unescapeField(manager), name: unescapeField(name), version: unescapeField(version) },
62
+ descriptors,
63
+ };
64
+ }
65
+ export function lastDescriptor(parsed) {
66
+ return parsed?.kind === "global" ? parsed.descriptors.at(-1) : undefined;
67
+ }
68
+ //# sourceMappingURL=scip-symbol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scip-symbol.js","sourceRoot":"","sources":["../../../src/extraction/scip/scip-symbol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { type ScipLanguage } from "../core/languages.js";
2
+ import type { Logger } from "../core/observability/logger.js";
3
+ import type { DiscoveredStructure } from "../core/types.js";
4
+ import { type IndexerProcess } from "./scip/indexer-process.js";
5
+ import type { IndexSource } from "./scip-resolver.js";
6
+ export interface IndexerRequest {
7
+ rootDir: string;
8
+ outDir: string;
9
+ structure: DiscoveredStructure;
10
+ languages: readonly ScipLanguage[];
11
+ timeoutSeconds: number;
12
+ }
13
+ export interface IndexerFailure {
14
+ packageId: string;
15
+ indexer: string;
16
+ reason: string;
17
+ }
18
+ export interface IndexerCheckFailure {
19
+ packageId: string;
20
+ check: string;
21
+ reason: string;
22
+ }
23
+ export interface IndexerResult {
24
+ sources: IndexSource[];
25
+ failures: IndexerFailure[];
26
+ checkFailures: IndexerCheckFailure[];
27
+ }
28
+ export interface ScipIndexer {
29
+ index(request: IndexerRequest): IndexerResult;
30
+ }
31
+ export declare function createScipIndexer(indexerProcess: IndexerProcess, logger: Logger): ScipIndexer;
32
+ export declare function createDefaultScipIndexer(logger: Logger): ScipIndexer;
@@ -0,0 +1,210 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { hashFile } from "../core/cache/extraction-cache.js";
5
+ import { DEPENDENCY_FILE_NAMES, extensionOf, familyOfLanguage, languageOfExtension, parsePackageDir, } from "../core/languages.js";
6
+ import { parseIndexHashes } from "./scip/index-hashes-schema.js";
7
+ import { createIndexerProcess, firstErrorLine, } from "./scip/indexer-process.js";
8
+ // The first line that names a problem, skipping `go build`'s `# <package>` headers; the last one
9
+ // is often `too many errors` or the `go get` hint under a missing dependency.
10
+ function firstProblemLine(stderr) {
11
+ return stderr
12
+ .split("\n")
13
+ .map((line) => line.trim())
14
+ .find((line) => line !== "" && !line.startsWith("#"));
15
+ }
16
+ // Fixed argv, checked against `scip-python index --help` 0.6.6, `scip-go index --help` 0.2.7, and
17
+ // `rust-analyzer --help` 1.99.0. The working directory is the Package root, which is also what
18
+ // each indexer indexes. scip-go writes progress to stdout, which is discarded; its `--quiet` would
19
+ // also silence the stderr a failure reason comes from.
20
+ const INDEXERS = {
21
+ python: { command: "scip-python", args: (outputPath) => ["index", "--output", outputPath, "--quiet"] },
22
+ // scip-go exits 0 with an empty stderr on a syntax error, a type error, or a missing
23
+ // dependency. `go build` reports each; `-o` to the null device writes no binary into the repo.
24
+ go: {
25
+ command: "scip-go",
26
+ args: (outputPath) => ["index", "--output", outputPath],
27
+ check: { label: "go build", command: "go", args: ["build", "-o", os.devNull, "./..."], reasonOf: firstProblemLine },
28
+ },
29
+ // rust-analyzer exits 0 on a syntax error, a type error, or a missing dependency, and ends a
30
+ // failure with a backtrace. `cargo check` reports each; `--locked` keeps it from writing a
31
+ // Cargo.lock into the repo. Both would otherwise write build output to the repo's `target/`.
32
+ rust: {
33
+ command: "rust-analyzer",
34
+ args: (outputPath) => ["scip", ".", "--output", outputPath],
35
+ // biome-ignore lint/style/useNamingConvention: environment variable name
36
+ env: (scipDir) => ({ CARGO_TARGET_DIR: path.join(scipDir, "cargo-target") }),
37
+ detail: "first-error",
38
+ check: {
39
+ label: "cargo check",
40
+ command: "cargo",
41
+ args: ["check", "--locked", "--all-targets", "--message-format=short", "--quiet"],
42
+ reasonOf: firstErrorLine,
43
+ },
44
+ },
45
+ // `scip-java index` runs the project's build, for Maven `mvn clean verify`, which deletes and
46
+ // rebuilds `target/`. Without `clean`, an up-to-date build compiles nothing and writes no index.
47
+ java: { notRun: "scip-java rebuilds the repo's own build output; supply an index instead" },
48
+ };
49
+ const SCIP_DIR_NAME = "scip";
50
+ // `encodeURIComponent` keeps every Package id distinct as a file name: `.` becomes `%2E`, a `/`
51
+ // becomes `%2F`.
52
+ function outputBaseOf(outDir, packageId) {
53
+ const fileName = packageId === "." ? "%2E" : encodeURIComponent(packageId);
54
+ return path.join(outDir, SCIP_DIR_NAME, fileName);
55
+ }
56
+ function readHashes(hashesPath) {
57
+ try {
58
+ return parseIndexHashes(JSON.parse(fs.readFileSync(hashesPath, "utf8")));
59
+ }
60
+ catch {
61
+ return undefined;
62
+ }
63
+ }
64
+ function sameHashes(left, right) {
65
+ const leftKeys = Object.keys(left);
66
+ return leftKeys.length === Object.keys(right).length && leftKeys.every((key) => left[key] === right[key]);
67
+ }
68
+ function filesOf(structure, pkg, language) {
69
+ return structure.programFiles.filter((file) => structure.fileOwners[file]?.packageId === pkg.id && languageOfExtension(extensionOf(file)) === language);
70
+ }
71
+ // The Package directory, then each directory above it, up to the repo root.
72
+ function selfAndAncestorDirs(dir) {
73
+ const dirs = [dir];
74
+ for (let current = dir; current !== ".";) {
75
+ current = path.posix.dirname(current);
76
+ dirs.push(current);
77
+ }
78
+ return dirs;
79
+ }
80
+ // The manifests and lockfiles of the Package's family, such as `Cargo.toml` and `Cargo.lock`, in
81
+ // its directory and every one above it: a Cargo workspace keeps its one lockfile at the workspace
82
+ // root. None is a source file, but a change to one can change the index or clear a check failure.
83
+ // A manifest above that does not govern the Package only costs an extra run.
84
+ function dependencyFilesOf(rootDir, pkg, language) {
85
+ const names = DEPENDENCY_FILE_NAMES[familyOfLanguage(language)];
86
+ return selfAndAncestorDirs(parsePackageDir(pkg.id))
87
+ .flatMap((dir) => names.map((name) => (dir === "." ? name : `${dir}/${name}`)))
88
+ .filter((file) => fs.existsSync(path.join(rootDir, file)));
89
+ }
90
+ // A tool may name a file by its absolute path, such as cargo's lock-file error. Each warning
91
+ // names it relative to the repo root instead, so codemap.json is the same on every machine.
92
+ function relativeToRoot(text, rootDir) {
93
+ return text.split(`${rootDir}${path.sep}`).join("");
94
+ }
95
+ // Every Package of a requested language that owns at least one file of it.
96
+ function packagesToIndex(request) {
97
+ return request.languages.flatMap((language) => request.structure.packages.flatMap((pkg) => {
98
+ if (pkg.language !== language)
99
+ return [];
100
+ const files = filesOf(request.structure, pkg, language);
101
+ return files.length === 0 ? [] : [{ pkg, language, files }];
102
+ }));
103
+ }
104
+ // The Packages whose language has an indexer that runs, each with that indexer's spec.
105
+ function withSpecs(packages) {
106
+ return packages.flatMap((entry) => {
107
+ const spec = INDEXERS[entry.language];
108
+ return "notRun" in spec ? [] : [{ ...entry, spec }];
109
+ });
110
+ }
111
+ // Each requested language that has Packages to index but whose indexer never runs.
112
+ function notRunLanguages(packages) {
113
+ return [...new Set(packages.map((entry) => entry.language))].flatMap((language) => {
114
+ const entry = INDEXERS[language];
115
+ return "notRun" in entry ? [[language, entry.notRun]] : [];
116
+ });
117
+ }
118
+ function runPlaceOf(spec, request, pkg, indexPath) {
119
+ return {
120
+ cwd: path.join(request.rootDir, parsePackageDir(pkg.id)),
121
+ timeoutMs: request.timeoutSeconds * 1000,
122
+ ...(spec.env && { env: spec.env(path.dirname(indexPath)) }),
123
+ };
124
+ }
125
+ function indexerCommandOf(spec, indexPath, place) {
126
+ return { command: spec.command, args: spec.args(indexPath), ...place, ...(spec.detail && { detail: spec.detail }) };
127
+ }
128
+ export function createScipIndexer(indexerProcess, logger) {
129
+ function runCheck(spec, place, rootDir, run) {
130
+ if (!spec.check)
131
+ return undefined;
132
+ const startedAt = performance.now();
133
+ const exit = indexerProcess.run({ command: spec.check.command, args: spec.check.args, ...place });
134
+ if (exit.ok)
135
+ return undefined;
136
+ const reason = relativeToRoot(spec.check.reasonOf(exit.stderr) ?? exit.reason, rootDir);
137
+ const durationMs = Math.round(performance.now() - startedAt);
138
+ logger.warn("scip indexer check failed", { ...run, check: spec.check.label, reason, durationMs });
139
+ return reason;
140
+ }
141
+ function indexPackage(spec, request, pkg, language, files) {
142
+ const base = outputBaseOf(request.outDir, pkg.id);
143
+ const indexPath = `${base}.scip`;
144
+ const hashesPath = `${base}.hashes.json`;
145
+ const inputs = [...files, ...dependencyFilesOf(request.rootDir, pkg, language)];
146
+ const hashes = Object.fromEntries(inputs.map((file) => [file, hashFile(path.join(request.rootDir, file))]));
147
+ const source = {
148
+ language,
149
+ indexPath,
150
+ fileHashes: Object.fromEntries(files.map((file) => [path.join(request.rootDir, file), hashes[file] ?? ""])),
151
+ };
152
+ const run = { language, packageId: pkg.id, indexer: spec.command };
153
+ const indexed = (checkFailure) => checkFailure === undefined || !spec.check
154
+ ? { source }
155
+ : { source, checkFailure: { packageId: pkg.id, check: spec.check.label, reason: checkFailure } };
156
+ const previous = readHashes(hashesPath);
157
+ if (previous && fs.existsSync(indexPath) && sameHashes(previous.files, hashes)) {
158
+ logger.info("scip index reused", run);
159
+ return indexed(previous.checkFailure);
160
+ }
161
+ // An index from an earlier run must never be read against files that have since changed.
162
+ fs.rmSync(indexPath, { force: true });
163
+ fs.rmSync(hashesPath, { force: true });
164
+ fs.mkdirSync(path.dirname(indexPath), { recursive: true });
165
+ const place = runPlaceOf(spec, request, pkg, indexPath);
166
+ const checkFailure = runCheck(spec, place, request.rootDir, run);
167
+ logger.info("scip indexer started", run);
168
+ const startedAt = performance.now();
169
+ const exit = indexerProcess.run(indexerCommandOf(spec, indexPath, place));
170
+ const durationMs = Math.round(performance.now() - startedAt);
171
+ const reason = exit.ok
172
+ ? fs.existsSync(indexPath)
173
+ ? undefined
174
+ : "exited cleanly but wrote no index"
175
+ : relativeToRoot(exit.reason, request.rootDir);
176
+ if (reason !== undefined) {
177
+ logger.warn("scip indexer failed", { ...run, reason, durationMs });
178
+ return { packageId: pkg.id, indexer: spec.command, reason };
179
+ }
180
+ logger.info("scip indexer finished", { ...run, durationMs });
181
+ fs.writeFileSync(hashesPath, JSON.stringify({ files: hashes, checkFailure }));
182
+ return indexed(checkFailure);
183
+ }
184
+ return {
185
+ index(request) {
186
+ const result = { sources: [], failures: [], checkFailures: [] };
187
+ const packages = packagesToIndex(request);
188
+ for (const [language, reason] of notRunLanguages(packages)) {
189
+ logger.info("scip indexer not run", { language, reason });
190
+ }
191
+ for (const { spec, pkg, language, files } of withSpecs(packages)) {
192
+ const outcome = indexPackage(spec, request, pkg, language, files);
193
+ if (!("source" in outcome)) {
194
+ result.failures.push(outcome);
195
+ continue;
196
+ }
197
+ result.sources.push(outcome.source);
198
+ if (outcome.checkFailure)
199
+ result.checkFailures.push(outcome.checkFailure);
200
+ }
201
+ return result;
202
+ },
203
+ };
204
+ }
205
+ // The composition root's entry point: `core/` may not import `scip/` directly, so the real
206
+ // process adapter is attached here.
207
+ export function createDefaultScipIndexer(logger) {
208
+ return createScipIndexer(createIndexerProcess(), logger);
209
+ }
210
+ //# sourceMappingURL=scip-indexer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scip-indexer.js","sourceRoot":"","sources":["../../src/extraction/scip-indexer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import { type ScipLanguage } from "../core/languages.js";
2
+ import type { ExtractedSymbols } from "../core/types.js";
3
+ export interface IndexSource {
4
+ language: ScipLanguage;
5
+ indexPath: string;
6
+ fileHashes?: Readonly<Record<string, string>>;
7
+ }
8
+ export interface UnreadableIndex {
9
+ indexPath: string;
10
+ reason: string;
11
+ }
12
+ export interface IndexResolution {
13
+ symbols: ExtractedSymbols[];
14
+ unreadableIndexes: UnreadableIndex[];
15
+ }
16
+ export interface IndexResolver {
17
+ languagesIn(indexPath: string): ScipLanguage[] | undefined;
18
+ resolve(sources: IndexSource[], fresh: ExtractedSymbols[], symbolsByFile: ReadonlyMap<string, ExtractedSymbols>): IndexResolution;
19
+ }
20
+ export declare function createScipIndexResolver(): IndexResolver;
@@ -0,0 +1,148 @@
1
+ import crypto from "node:crypto";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { extensionOf, languageOfExtension, SCIP_LANGUAGES } from "../core/languages.js";
6
+ import { buildDefinitionIndex, refineCalls } from "./scip/scip-call-refinement.js";
7
+ import { readScipIndex } from "./scip/scip-index-reader.js";
8
+ import { isDocumentCurrent } from "./scip/scip-staleness.js";
9
+ function realpathOrSelf(dir) {
10
+ try {
11
+ return fs.realpathSync(dir);
12
+ }
13
+ catch {
14
+ return dir;
15
+ }
16
+ }
17
+ function isDirectory(dir) {
18
+ try {
19
+ return fs.statSync(dir).isDirectory();
20
+ }
21
+ catch {
22
+ return false;
23
+ }
24
+ }
25
+ // The recorded project root first, then the directory holding the index and each of its
26
+ // ancestors: an index built on another machine (CI, a committed fixture) names a root that does
27
+ // not exist here, and may have been stored anywhere below the tree it describes.
28
+ function candidateRootsOf(index, indexPath) {
29
+ const candidates = [];
30
+ if (index.projectRoot.startsWith("file://")) {
31
+ const projectRoot = fileURLToPath(index.projectRoot);
32
+ if (isDirectory(projectRoot))
33
+ candidates.push(projectRoot);
34
+ }
35
+ for (let dir = path.dirname(path.resolve(indexPath));; dir = path.dirname(dir)) {
36
+ candidates.push(dir);
37
+ if (path.dirname(dir) === dir)
38
+ break;
39
+ }
40
+ return candidates;
41
+ }
42
+ // Documents are relative to the index's project root. Picks the candidate under which the most
43
+ // documents exist on disk; the earliest candidate wins a tie.
44
+ function documentRootOf(index, indexPath) {
45
+ let best = { root: path.dirname(path.resolve(indexPath)), hits: -1 };
46
+ for (const root of candidateRootsOf(index, indexPath)) {
47
+ const hits = index.documents.filter((document) => fs.existsSync(path.join(root, ...document.relativePath.split("/")))).length;
48
+ if (hits > best.hits)
49
+ best = { root, hits };
50
+ }
51
+ return realpathOrSelf(best.root);
52
+ }
53
+ // scip-python leaves `Document.language` empty, so an empty one falls back to the extension.
54
+ function isDocumentFor(document, language) {
55
+ if (document.language !== "")
56
+ return document.language.toLowerCase() === language;
57
+ return languageOfExtension(extensionOf(document.relativePath)) === language;
58
+ }
59
+ function readSource(filePath) {
60
+ try {
61
+ return fs.readFileSync(filePath);
62
+ }
63
+ catch {
64
+ return undefined;
65
+ }
66
+ }
67
+ // One index can serve several languages; it is decoded, and reported unreadable, once.
68
+ function loadDocuments(sources) {
69
+ const loaded = {
70
+ documentsByFile: new Map(),
71
+ recordedHashes: new Map(),
72
+ indexedLanguages: new Set(),
73
+ unreadableIndexes: [],
74
+ };
75
+ const reads = new Map();
76
+ for (const source of sources) {
77
+ const known = reads.get(source.indexPath);
78
+ const read = known ?? readScipIndex(source.indexPath);
79
+ reads.set(source.indexPath, read);
80
+ if (read.ok)
81
+ addDocuments(loaded, source, read.index);
82
+ else if (!known)
83
+ loaded.unreadableIndexes.push({ indexPath: source.indexPath, reason: read.reason });
84
+ }
85
+ return loaded;
86
+ }
87
+ function addDocuments(loaded, source, index) {
88
+ loaded.indexedLanguages.add(source.language);
89
+ for (const [filePath, contentHash] of Object.entries(source.fileHashes ?? {})) {
90
+ loaded.recordedHashes.set(filePath, contentHash);
91
+ }
92
+ const root = documentRootOf(index, source.indexPath);
93
+ for (const document of index.documents) {
94
+ if (isDocumentFor(document, source.language)) {
95
+ loaded.documentsByFile.set(path.join(root, ...document.relativePath.split("/")), document);
96
+ }
97
+ }
98
+ }
99
+ // Every indexed file is checked, not just the freshly extracted ones: a call into an unchanged
100
+ // file still needs that file's definitions to be current.
101
+ function findStaleFiles(documentsByFile, recordedHashes) {
102
+ const staleFiles = new Set();
103
+ for (const [filePath, document] of documentsByFile) {
104
+ const source = readSource(filePath);
105
+ const recorded = recordedHashes.get(filePath);
106
+ // The same sha256 of the raw bytes that `hashFile` recorded in the sidecar.
107
+ const hashes = source === undefined || recorded === undefined
108
+ ? undefined
109
+ : { recorded, current: crypto.createHash("sha256").update(source).digest("hex") };
110
+ if (source === undefined || !isDocumentCurrent(document, source.toString("utf8"), hashes)) {
111
+ staleFiles.add(filePath);
112
+ }
113
+ }
114
+ return staleFiles;
115
+ }
116
+ function isIndexedLanguage(filePath, indexedLanguages) {
117
+ const language = languageOfExtension(extensionOf(filePath));
118
+ return indexedLanguages.has(language ?? "");
119
+ }
120
+ export function createScipIndexResolver() {
121
+ return {
122
+ languagesIn(indexPath) {
123
+ const read = readScipIndex(indexPath);
124
+ if (!read.ok)
125
+ return undefined;
126
+ return SCIP_LANGUAGES.filter((language) => read.index.documents.some((document) => isDocumentFor(document, language)));
127
+ },
128
+ resolve(sources, fresh, symbolsByFile) {
129
+ const { documentsByFile, recordedHashes, indexedLanguages, unreadableIndexes } = loadDocuments(sources);
130
+ if (indexedLanguages.size === 0)
131
+ return { symbols: fresh, unreadableIndexes };
132
+ const staleFiles = findStaleFiles(documentsByFile, recordedHashes);
133
+ const definitions = buildDefinitionIndex(documentsByFile, staleFiles);
134
+ const symbols = fresh.map((extracted) => {
135
+ if (!isIndexedLanguage(extracted.filePath, indexedLanguages))
136
+ return extracted;
137
+ const document = documentsByFile.get(extracted.filePath);
138
+ if (!document)
139
+ return { ...extracted, indexFallback: "index-uncovered" };
140
+ if (staleFiles.has(extracted.filePath))
141
+ return { ...extracted, indexFallback: "index-stale" };
142
+ return { ...extracted, calls: refineCalls(extracted, document, definitions, symbolsByFile) };
143
+ });
144
+ return { symbols, unreadableIndexes };
145
+ },
146
+ };
147
+ }
148
+ //# sourceMappingURL=scip-resolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scip-resolver.js","sourceRoot":"","sources":["../../src/extraction/scip-resolver.ts"],"names":[],"mappings":"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"}
@@ -1,2 +1,2 @@
1
- export declare const CLI_USAGE = "Usage: codemap generate [--root <dir>] [--out <dir>] [--config <path>] [--force] [--include-tests]";
2
- export declare const CLI_HELP = "Usage: codemap generate [--root <dir>] [--out <dir>] [--config <path>] [--force] [--include-tests]\n\nGenerates codemap.json and codemap.html for the repo at --root.\n\nOptions:\n --root <dir> Repo root to analyse (default: current directory)\n --out <dir> Output directory (default: .codemap, or the config's outDir)\n --config <path> Config file path (default: <root>/codemap.config.json)\n --force Skip the incremental cache and re-extract every file\n --include-tests Include test files in discovery and Module clustering\n -h, --help Show this help and exit";
1
+ export declare const CLI_USAGE = "Usage: codemap generate [--root <dir>] [--out <dir>] [--config <path>] [--force] [--include-tests] [--scip-index <language>=<path>] [--run-indexers]";
2
+ export declare const CLI_HELP = "Usage: codemap generate [--root <dir>] [--out <dir>] [--config <path>] [--force] [--include-tests] [--scip-index <language>=<path>] [--run-indexers]\n\nGenerates codemap.json and codemap.html for the repo at --root.\n\nOptions:\n --root <dir> Repo root to analyse (default: current directory)\n --out <dir> Output directory (default: .codemap, or the config's outDir)\n --config <path> Config file path (default: <root>/codemap.config.json)\n --force Skip the incremental cache and re-extract every file\n --include-tests Include test files in discovery and Module clustering\n --scip-index <language>=<path>\n SCIP index refining that language's call targets (python, go, rust,\n or java, repeatable per language; default: <root>/index.scip if present)\n --run-indexers Run scip-python, scip-go, or rust-analyzer for each Python, Go,\n or Rust Package with no supplied index, writing under <out>/scip/.\n Never runs scip-java: Java needs a supplied index.\n Runs the repo's own tooling: only use it on a repo you would build\n yourself\n -h, --help Show this help and exit";
@@ -1,4 +1,4 @@
1
- export const CLI_USAGE = "Usage: codemap generate [--root <dir>] [--out <dir>] [--config <path>] [--force] [--include-tests]";
1
+ export const CLI_USAGE = "Usage: codemap generate [--root <dir>] [--out <dir>] [--config <path>] [--force] [--include-tests] [--scip-index <language>=<path>] [--run-indexers]";
2
2
  export const CLI_HELP = `${CLI_USAGE}
3
3
 
4
4
  Generates codemap.json and codemap.html for the repo at --root.
@@ -9,5 +9,13 @@ Options:
9
9
  --config <path> Config file path (default: <root>/codemap.config.json)
10
10
  --force Skip the incremental cache and re-extract every file
11
11
  --include-tests Include test files in discovery and Module clustering
12
+ --scip-index <language>=<path>
13
+ SCIP index refining that language's call targets (python, go, rust,
14
+ or java, repeatable per language; default: <root>/index.scip if present)
15
+ --run-indexers Run scip-python, scip-go, or rust-analyzer for each Python, Go,
16
+ or Rust Package with no supplied index, writing under <out>/scip/.
17
+ Never runs scip-java: Java needs a supplied index.
18
+ Runs the repo's own tooling: only use it on a repo you would build
19
+ yourself
12
20
  -h, --help Show this help and exit`;
13
21
  //# sourceMappingURL=cli-help.js.map