@ai-agent-context/core 0.1.0

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 (236) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +285 -0
  3. package/dist/.tsbuildinfo +1 -0
  4. package/dist/adapters/filesystem/fs-adapter.d.ts +50 -0
  5. package/dist/adapters/filesystem/fs-adapter.d.ts.map +1 -0
  6. package/dist/adapters/filesystem/fs-adapter.js +168 -0
  7. package/dist/adapters/filesystem/fs-adapter.js.map +1 -0
  8. package/dist/adapters/filesystem/sensitive.d.ts +26 -0
  9. package/dist/adapters/filesystem/sensitive.d.ts.map +1 -0
  10. package/dist/adapters/filesystem/sensitive.js +67 -0
  11. package/dist/adapters/filesystem/sensitive.js.map +1 -0
  12. package/dist/adapters/git/git-adapter.d.ts +47 -0
  13. package/dist/adapters/git/git-adapter.d.ts.map +1 -0
  14. package/dist/adapters/git/git-adapter.js +109 -0
  15. package/dist/adapters/git/git-adapter.js.map +1 -0
  16. package/dist/adapters/language/json/adapter.d.ts +24 -0
  17. package/dist/adapters/language/json/adapter.d.ts.map +1 -0
  18. package/dist/adapters/language/json/adapter.js +54 -0
  19. package/dist/adapters/language/json/adapter.js.map +1 -0
  20. package/dist/adapters/language/markdown/adapter.d.ts +41 -0
  21. package/dist/adapters/language/markdown/adapter.d.ts.map +1 -0
  22. package/dist/adapters/language/markdown/adapter.js +124 -0
  23. package/dist/adapters/language/markdown/adapter.js.map +1 -0
  24. package/dist/adapters/language/package-json/adapter.d.ts +47 -0
  25. package/dist/adapters/language/package-json/adapter.d.ts.map +1 -0
  26. package/dist/adapters/language/package-json/adapter.js +153 -0
  27. package/dist/adapters/language/package-json/adapter.js.map +1 -0
  28. package/dist/adapters/language/registry.d.ts +35 -0
  29. package/dist/adapters/language/registry.d.ts.map +1 -0
  30. package/dist/adapters/language/registry.js +79 -0
  31. package/dist/adapters/language/registry.js.map +1 -0
  32. package/dist/adapters/language/ts-js/adapter.d.ts +14 -0
  33. package/dist/adapters/language/ts-js/adapter.d.ts.map +1 -0
  34. package/dist/adapters/language/ts-js/adapter.js +59 -0
  35. package/dist/adapters/language/ts-js/adapter.js.map +1 -0
  36. package/dist/adapters/language/ts-js/extractor.d.ts +21 -0
  37. package/dist/adapters/language/ts-js/extractor.d.ts.map +1 -0
  38. package/dist/adapters/language/ts-js/extractor.js +779 -0
  39. package/dist/adapters/language/ts-js/extractor.js.map +1 -0
  40. package/dist/adapters/language/ts-js/lexer.d.ts +30 -0
  41. package/dist/adapters/language/ts-js/lexer.d.ts.map +1 -0
  42. package/dist/adapters/language/ts-js/lexer.js +446 -0
  43. package/dist/adapters/language/ts-js/lexer.js.map +1 -0
  44. package/dist/adapters/language/ts-js/package-signals.d.ts +5 -0
  45. package/dist/adapters/language/ts-js/package-signals.d.ts.map +1 -0
  46. package/dist/adapters/language/ts-js/package-signals.js +113 -0
  47. package/dist/adapters/language/ts-js/package-signals.js.map +1 -0
  48. package/dist/adapters/language/tsconfig/adapter.d.ts +38 -0
  49. package/dist/adapters/language/tsconfig/adapter.d.ts.map +1 -0
  50. package/dist/adapters/language/tsconfig/adapter.js +130 -0
  51. package/dist/adapters/language/tsconfig/adapter.js.map +1 -0
  52. package/dist/adapters/language/types.d.ts +152 -0
  53. package/dist/adapters/language/types.d.ts.map +1 -0
  54. package/dist/adapters/language/types.js +51 -0
  55. package/dist/adapters/language/types.js.map +1 -0
  56. package/dist/agent-context.d.ts +122 -0
  57. package/dist/agent-context.d.ts.map +1 -0
  58. package/dist/agent-context.js +243 -0
  59. package/dist/agent-context.js.map +1 -0
  60. package/dist/config/defaults.d.ts +13 -0
  61. package/dist/config/defaults.d.ts.map +1 -0
  62. package/dist/config/defaults.js +98 -0
  63. package/dist/config/defaults.js.map +1 -0
  64. package/dist/config/load.d.ts +25 -0
  65. package/dist/config/load.d.ts.map +1 -0
  66. package/dist/config/load.js +106 -0
  67. package/dist/config/load.js.map +1 -0
  68. package/dist/config/types.d.ts +95 -0
  69. package/dist/config/types.d.ts.map +1 -0
  70. package/dist/config/types.js +8 -0
  71. package/dist/config/types.js.map +1 -0
  72. package/dist/config/validate.d.ts +15 -0
  73. package/dist/config/validate.d.ts.map +1 -0
  74. package/dist/config/validate.js +202 -0
  75. package/dist/config/validate.js.map +1 -0
  76. package/dist/core/architecture/detector.d.ts +10 -0
  77. package/dist/core/architecture/detector.d.ts.map +1 -0
  78. package/dist/core/architecture/detector.js +37 -0
  79. package/dist/core/architecture/detector.js.map +1 -0
  80. package/dist/core/architecture/entry-points.d.ts +20 -0
  81. package/dist/core/architecture/entry-points.d.ts.map +1 -0
  82. package/dist/core/architecture/entry-points.js +190 -0
  83. package/dist/core/architecture/entry-points.js.map +1 -0
  84. package/dist/core/architecture/role-detector.d.ts +32 -0
  85. package/dist/core/architecture/role-detector.d.ts.map +1 -0
  86. package/dist/core/architecture/role-detector.js +240 -0
  87. package/dist/core/architecture/role-detector.js.map +1 -0
  88. package/dist/core/context/explain.d.ts +36 -0
  89. package/dist/core/context/explain.d.ts.map +1 -0
  90. package/dist/core/context/explain.js +199 -0
  91. package/dist/core/context/explain.js.map +1 -0
  92. package/dist/core/context/repository-context.d.ts +16 -0
  93. package/dist/core/context/repository-context.d.ts.map +1 -0
  94. package/dist/core/context/repository-context.js +134 -0
  95. package/dist/core/context/repository-context.js.map +1 -0
  96. package/dist/core/context/types.d.ts +94 -0
  97. package/dist/core/context/types.d.ts.map +1 -0
  98. package/dist/core/context/types.js +2 -0
  99. package/dist/core/context/types.js.map +1 -0
  100. package/dist/core/conventions/detector.d.ts +55 -0
  101. package/dist/core/conventions/detector.d.ts.map +1 -0
  102. package/dist/core/conventions/detector.js +438 -0
  103. package/dist/core/conventions/detector.js.map +1 -0
  104. package/dist/core/conventions/renderer.d.ts +16 -0
  105. package/dist/core/conventions/renderer.d.ts.map +1 -0
  106. package/dist/core/conventions/renderer.js +42 -0
  107. package/dist/core/conventions/renderer.js.map +1 -0
  108. package/dist/core/decisions/detector.d.ts +45 -0
  109. package/dist/core/decisions/detector.d.ts.map +1 -0
  110. package/dist/core/decisions/detector.js +256 -0
  111. package/dist/core/decisions/detector.js.map +1 -0
  112. package/dist/core/diff/differ.d.ts +26 -0
  113. package/dist/core/diff/differ.d.ts.map +1 -0
  114. package/dist/core/diff/differ.js +159 -0
  115. package/dist/core/diff/differ.js.map +1 -0
  116. package/dist/core/git-analysis/activity.d.ts +35 -0
  117. package/dist/core/git-analysis/activity.d.ts.map +1 -0
  118. package/dist/core/git-analysis/activity.js +123 -0
  119. package/dist/core/git-analysis/activity.js.map +1 -0
  120. package/dist/core/graph/aliases.d.ts +20 -0
  121. package/dist/core/graph/aliases.d.ts.map +1 -0
  122. package/dist/core/graph/aliases.js +99 -0
  123. package/dist/core/graph/aliases.js.map +1 -0
  124. package/dist/core/graph/knowledge-graph.d.ts +91 -0
  125. package/dist/core/graph/knowledge-graph.d.ts.map +1 -0
  126. package/dist/core/graph/knowledge-graph.js +572 -0
  127. package/dist/core/graph/knowledge-graph.js.map +1 -0
  128. package/dist/core/graph/modules.d.ts +28 -0
  129. package/dist/core/graph/modules.d.ts.map +1 -0
  130. package/dist/core/graph/modules.js +139 -0
  131. package/dist/core/graph/modules.js.map +1 -0
  132. package/dist/core/graph/resolver.d.ts +50 -0
  133. package/dist/core/graph/resolver.d.ts.map +1 -0
  134. package/dist/core/graph/resolver.js +180 -0
  135. package/dist/core/graph/resolver.js.map +1 -0
  136. package/dist/core/scanner/cache.d.ts +49 -0
  137. package/dist/core/scanner/cache.d.ts.map +1 -0
  138. package/dist/core/scanner/cache.js +101 -0
  139. package/dist/core/scanner/cache.js.map +1 -0
  140. package/dist/core/scanner/scanner.d.ts +60 -0
  141. package/dist/core/scanner/scanner.d.ts.map +1 -0
  142. package/dist/core/scanner/scanner.js +304 -0
  143. package/dist/core/scanner/scanner.js.map +1 -0
  144. package/dist/core/scanner/types.d.ts +47 -0
  145. package/dist/core/scanner/types.d.ts.map +1 -0
  146. package/dist/core/scanner/types.js +18 -0
  147. package/dist/core/scanner/types.js.map +1 -0
  148. package/dist/core/search/analyzer.d.ts +16 -0
  149. package/dist/core/search/analyzer.d.ts.map +1 -0
  150. package/dist/core/search/analyzer.js +165 -0
  151. package/dist/core/search/analyzer.js.map +1 -0
  152. package/dist/core/search/bm25.d.ts +21 -0
  153. package/dist/core/search/bm25.d.ts.map +1 -0
  154. package/dist/core/search/bm25.js +108 -0
  155. package/dist/core/search/bm25.js.map +1 -0
  156. package/dist/core/search/documents.d.ts +20 -0
  157. package/dist/core/search/documents.d.ts.map +1 -0
  158. package/dist/core/search/documents.js +106 -0
  159. package/dist/core/search/documents.js.map +1 -0
  160. package/dist/core/search/service.d.ts +30 -0
  161. package/dist/core/search/service.d.ts.map +1 -0
  162. package/dist/core/search/service.js +54 -0
  163. package/dist/core/search/service.js.map +1 -0
  164. package/dist/core/search/types.d.ts +44 -0
  165. package/dist/core/search/types.d.ts.map +1 -0
  166. package/dist/core/search/types.js +2 -0
  167. package/dist/core/search/types.js.map +1 -0
  168. package/dist/core/serialization/documents.d.ts +26 -0
  169. package/dist/core/serialization/documents.d.ts.map +1 -0
  170. package/dist/core/serialization/documents.js +224 -0
  171. package/dist/core/serialization/documents.js.map +1 -0
  172. package/dist/core/serialization/reader.d.ts +22 -0
  173. package/dist/core/serialization/reader.d.ts.map +1 -0
  174. package/dist/core/serialization/reader.js +65 -0
  175. package/dist/core/serialization/reader.js.map +1 -0
  176. package/dist/core/serialization/types.d.ts +184 -0
  177. package/dist/core/serialization/types.d.ts.map +1 -0
  178. package/dist/core/serialization/types.js +2 -0
  179. package/dist/core/serialization/types.js.map +1 -0
  180. package/dist/core/serialization/writer.d.ts +17 -0
  181. package/dist/core/serialization/writer.d.ts.map +1 -0
  182. package/dist/core/serialization/writer.js +64 -0
  183. package/dist/core/serialization/writer.js.map +1 -0
  184. package/dist/core/workspace/package-facts.d.ts +12 -0
  185. package/dist/core/workspace/package-facts.d.ts.map +1 -0
  186. package/dist/core/workspace/package-facts.js +50 -0
  187. package/dist/core/workspace/package-facts.js.map +1 -0
  188. package/dist/core/workspace/workspace.d.ts +32 -0
  189. package/dist/core/workspace/workspace.d.ts.map +1 -0
  190. package/dist/core/workspace/workspace.js +167 -0
  191. package/dist/core/workspace/workspace.js.map +1 -0
  192. package/dist/errors.d.ts +50 -0
  193. package/dist/errors.d.ts.map +1 -0
  194. package/dist/errors.js +64 -0
  195. package/dist/errors.js.map +1 -0
  196. package/dist/index.d.ts +80 -0
  197. package/dist/index.d.ts.map +1 -0
  198. package/dist/index.js +66 -0
  199. package/dist/index.js.map +1 -0
  200. package/dist/logging/diagnostics.d.ts +64 -0
  201. package/dist/logging/diagnostics.d.ts.map +1 -0
  202. package/dist/logging/diagnostics.js +92 -0
  203. package/dist/logging/diagnostics.js.map +1 -0
  204. package/dist/model/canonical.d.ts +24 -0
  205. package/dist/model/canonical.d.ts.map +1 -0
  206. package/dist/model/canonical.js +69 -0
  207. package/dist/model/canonical.js.map +1 -0
  208. package/dist/model/schema.d.ts +37 -0
  209. package/dist/model/schema.d.ts.map +1 -0
  210. package/dist/model/schema.js +42 -0
  211. package/dist/model/schema.js.map +1 -0
  212. package/dist/model/types.d.ts +402 -0
  213. package/dist/model/types.d.ts.map +1 -0
  214. package/dist/model/types.js +10 -0
  215. package/dist/model/types.js.map +1 -0
  216. package/dist/pipeline/scan-pipeline.d.ts +69 -0
  217. package/dist/pipeline/scan-pipeline.d.ts.map +1 -0
  218. package/dist/pipeline/scan-pipeline.js +270 -0
  219. package/dist/pipeline/scan-pipeline.js.map +1 -0
  220. package/dist/util/concurrency.d.ts +17 -0
  221. package/dist/util/concurrency.d.ts.map +1 -0
  222. package/dist/util/concurrency.js +46 -0
  223. package/dist/util/concurrency.js.map +1 -0
  224. package/dist/util/glob.d.ts +26 -0
  225. package/dist/util/glob.d.ts.map +1 -0
  226. package/dist/util/glob.js +198 -0
  227. package/dist/util/glob.js.map +1 -0
  228. package/dist/util/paths.d.ts +23 -0
  229. package/dist/util/paths.d.ts.map +1 -0
  230. package/dist/util/paths.js +115 -0
  231. package/dist/util/paths.js.map +1 -0
  232. package/dist/util/text.d.ts +22 -0
  233. package/dist/util/text.d.ts.map +1 -0
  234. package/dist/util/text.js +66 -0
  235. package/dist/util/text.js.map +1 -0
  236. package/package.json +52 -0
@@ -0,0 +1,50 @@
1
+ function stringRecord(value) {
2
+ if (typeof value !== 'object' || value === null || Array.isArray(value))
3
+ return {};
4
+ const result = {};
5
+ for (const [key, entry] of Object.entries(value)) {
6
+ if (typeof entry === 'string')
7
+ result[key] = entry;
8
+ }
9
+ return result;
10
+ }
11
+ function stringArray(value) {
12
+ return Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : [];
13
+ }
14
+ /** Reads {@link PackageFacts} back from a parsed `package.json` file. */
15
+ export function packageFactsFromParsed(parsed) {
16
+ if (parsed.language !== 'package-json')
17
+ return null;
18
+ const metadata = parsed.metadata;
19
+ const rawEntries = metadata['package.entries'];
20
+ const entries = [];
21
+ if (Array.isArray(rawEntries)) {
22
+ for (const entry of rawEntries) {
23
+ if (typeof entry !== 'object' || entry === null)
24
+ continue;
25
+ const record = entry;
26
+ if (typeof record.field !== 'string' || typeof record.value !== 'string')
27
+ continue;
28
+ if (!['main', 'module', 'types', 'browser', 'exports', 'bin'].includes(record.field))
29
+ continue;
30
+ entries.push({ field: record.field, value: record.value });
31
+ }
32
+ }
33
+ const typeValue = metadata['package.type'];
34
+ return {
35
+ name: typeof metadata['package.name'] === 'string' ? metadata['package.name'] : null,
36
+ version: typeof metadata['package.version'] === 'string' ? metadata['package.version'] : null,
37
+ private: metadata['package.private'] === true,
38
+ type: typeValue === 'module' ? 'module' : typeValue === 'commonjs' ? 'commonjs' : null,
39
+ scripts: stringRecord(metadata['package.scripts']),
40
+ dependencies: stringArray(metadata['package.dependencies']),
41
+ devDependencies: stringArray(metadata['package.devDependencies']),
42
+ peerDependencies: stringArray(metadata['package.peerDependencies']),
43
+ workspaces: stringArray(metadata['package.workspaces']),
44
+ entries: entries.sort((a, b) => a.field === b.field ? (a.value < b.value ? -1 : 1) : a.field < b.field ? -1 : 1),
45
+ packageManager: typeof metadata['package.packageManagerField'] === 'string'
46
+ ? metadata['package.packageManagerField']
47
+ : null,
48
+ };
49
+ }
50
+ //# sourceMappingURL=package-facts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"package-facts.js","sourceRoot":"","sources":["../../../src/core/workspace/package-facts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Workspace and package manager detection.
3
+ *
4
+ * A lockfile is a *repository signal*, not proof of how the project is built or
5
+ * run, so every conclusion here carries evidence and the wording stays neutral.
6
+ * Supported workspace models: npm, yarn, pnpm, bun.
7
+ */
8
+ import type { WorkspaceInfo, WorkspacePackage } from '../../model/types.ts';
9
+ import type { PackageFacts } from '../../adapters/language/package-json/adapter.ts';
10
+ export declare const LOCKFILE_CANDIDATES: string[];
11
+ export interface WorkspaceInput {
12
+ /** Facts of every parsed package.json, keyed by repository-relative path. */
13
+ packageJsonFiles: Array<{
14
+ path: string;
15
+ facts: PackageFacts;
16
+ }>;
17
+ /** Repository-relative file names that exist in the working tree. */
18
+ presentFiles: Set<string>;
19
+ /** Contents of `pnpm-workspace.yaml`, when present. */
20
+ pnpmWorkspaceYaml?: string | null;
21
+ }
22
+ /** Workspace globs declared by pnpm-workspace.yaml (`packages:` list). */
23
+ export declare function parsePnpmWorkspaceYaml(contents: string): string[];
24
+ /** Builds the {@link WorkspaceInfo} of a repository (single package or monorepo). */
25
+ export declare function detectWorkspace(input: WorkspaceInput): WorkspaceInfo;
26
+ /** Nearest workspace package for a file path, when the file lives inside one. */
27
+ export declare function owningPackage(info: WorkspaceInfo, filePath: string): WorkspacePackage | null;
28
+ /** Maps workspace package directories to their package names. */
29
+ export declare function packageNameByDirectory(info: WorkspaceInfo): Map<string, string>;
30
+ /** Package names declared as internal workspaces, used for dependency classification. */
31
+ export declare function workspacePackageNames(info: WorkspaceInfo): string[];
32
+ //# sourceMappingURL=workspace.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAY,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAKpF,eAAO,MAAM,mBAAmB,UAO/B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAC/D,qEAAqE;IACrE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAkBD,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBjE;AAwDD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CA0CpE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQ5F;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI/E;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAEnE"}
@@ -0,0 +1,167 @@
1
+ import { compileGlob } from "../../util/glob.js";
2
+ import { dirname, normalizeRelative } from "../../util/paths.js";
3
+ import { compareStrings } from "../../model/canonical.js";
4
+ export const LOCKFILE_CANDIDATES = [
5
+ 'package-lock.json',
6
+ 'npm-shrinkwrap.json',
7
+ 'pnpm-lock.yaml',
8
+ 'yarn.lock',
9
+ 'bun.lock',
10
+ 'bun.lockb',
11
+ ];
12
+ function toWorkspacePackage(relativePath, facts) {
13
+ const directory = normalizeRelative(dirname(relativePath));
14
+ return {
15
+ name: facts.name ?? (directory.length === 0 ? 'root' : (directory.split('/').pop() ?? 'root')),
16
+ path: directory,
17
+ version: facts.version,
18
+ private: facts.private,
19
+ type: facts.type,
20
+ runtimeDependencies: facts.dependencies,
21
+ developmentDependencies: facts.devDependencies,
22
+ peerDependencies: facts.peerDependencies,
23
+ scripts: facts.scripts,
24
+ entries: facts.entries,
25
+ };
26
+ }
27
+ /** Workspace globs declared by pnpm-workspace.yaml (`packages:` list). */
28
+ export function parsePnpmWorkspaceYaml(contents) {
29
+ const globs = [];
30
+ let inPackages = false;
31
+ for (const rawLine of contents.split('\n')) {
32
+ const line = rawLine.replace(/\r$/, '');
33
+ if (/^[A-Za-z]/.test(line)) {
34
+ inPackages = /^packages\s*:/.test(line.trim());
35
+ continue;
36
+ }
37
+ if (!inPackages)
38
+ continue;
39
+ const match = /^\s*-\s*['"]?([^'"#]+)['"]?\s*(#.*)?$/.exec(line);
40
+ if (match === null)
41
+ continue;
42
+ const value = match[1].trim();
43
+ if (value.length > 0)
44
+ globs.push(value);
45
+ }
46
+ return globs;
47
+ }
48
+ function managerForLockfile(lockfile) {
49
+ if (lockfile.startsWith('package-lock') || lockfile === 'npm-shrinkwrap.json')
50
+ return 'npm';
51
+ if (lockfile === 'pnpm-lock.yaml')
52
+ return 'pnpm';
53
+ if (lockfile === 'yarn.lock')
54
+ return 'yarn';
55
+ return 'bun';
56
+ }
57
+ function detectPackageManager(input, rootFacts) {
58
+ const evidence = [];
59
+ const candidates = new Set();
60
+ for (const lockfile of LOCKFILE_CANDIDATES) {
61
+ if (!input.presentFiles.has(lockfile))
62
+ continue;
63
+ candidates.add(managerForLockfile(lockfile));
64
+ evidence.push({
65
+ source: lockfile,
66
+ detail: 'lockfile present (repository signal only, not proof of runtime usage)',
67
+ });
68
+ }
69
+ if (input.presentFiles.has('pnpm-workspace.yaml')) {
70
+ candidates.add('pnpm');
71
+ evidence.push({ source: 'pnpm-workspace.yaml', detail: 'pnpm workspace definition present' });
72
+ }
73
+ const declared = rootFacts?.packageManager ?? null;
74
+ if (declared !== null) {
75
+ const manager = declared.split('@')[0];
76
+ if (manager !== 'npm' && manager !== 'pnpm' && manager !== 'yarn' && manager !== 'bun') {
77
+ evidence.push({ source: 'package.json', detail: `unknown packageManager field "${declared}"` });
78
+ }
79
+ else {
80
+ evidence.push({ source: 'package.json', detail: `package.json declares packageManager "${declared}"` });
81
+ if (candidates.size > 1) {
82
+ evidence.push({ source: 'package.json', detail: 'multiple lockfiles present; the declared packageManager wins' });
83
+ }
84
+ return { manager, evidence };
85
+ }
86
+ }
87
+ if (candidates.size === 1)
88
+ return { manager: [...candidates][0], evidence };
89
+ if (candidates.size > 1) {
90
+ evidence.push({
91
+ source: '<repository>',
92
+ detail: `multiple package managers detected (${[...candidates].sort(compareStrings).join(', ')}); reported as unknown`,
93
+ });
94
+ return { manager: 'unknown', evidence };
95
+ }
96
+ evidence.push({ source: '<repository>', detail: 'no lockfile or packageManager field found' });
97
+ return { manager: 'unknown', evidence };
98
+ }
99
+ /** Builds the {@link WorkspaceInfo} of a repository (single package or monorepo). */
100
+ export function detectWorkspace(input) {
101
+ const rootEntry = input.packageJsonFiles.find((entry) => entry.path === 'package.json');
102
+ const rootFacts = rootEntry?.facts ?? null;
103
+ const lockfiles = LOCKFILE_CANDIDATES.filter((candidate) => input.presentFiles.has(candidate));
104
+ const managerSignal = detectPackageManager(input, rootFacts);
105
+ const pnpmGlobs = input.pnpmWorkspaceYaml ? parsePnpmWorkspaceYaml(input.pnpmWorkspaceYaml) : [];
106
+ const declaredGlobs = [...new Set([...(rootFacts?.workspaces ?? []), ...pnpmGlobs])].sort(compareStrings);
107
+ const hasWorkspaces = declaredGlobs.length > 0;
108
+ const workspaceModel = !hasWorkspaces
109
+ ? 'single-package'
110
+ : pnpmGlobs.length > 0
111
+ ? 'pnpm-workspaces'
112
+ : managerSignal.manager === 'yarn'
113
+ ? 'yarn-workspaces'
114
+ : managerSignal.manager === 'bun'
115
+ ? 'bun-workspaces'
116
+ : 'npm-workspaces';
117
+ const matchers = declaredGlobs.map((glob) => compileGlob(glob.endsWith('/') ? `${glob}**` : glob));
118
+ const packages = [];
119
+ for (const entry of input.packageJsonFiles) {
120
+ if (entry.path === 'package.json')
121
+ continue;
122
+ if (entry.path.split('/').includes('node_modules'))
123
+ continue;
124
+ if (!hasWorkspaces)
125
+ continue;
126
+ const directory = normalizeRelative(dirname(entry.path));
127
+ if (matchers.some((match) => match(directory)))
128
+ packages.push(toWorkspacePackage(entry.path, entry.facts));
129
+ }
130
+ if (!hasWorkspaces && rootFacts !== null)
131
+ packages.push(toWorkspacePackage('package.json', rootFacts));
132
+ packages.sort((a, b) => compareStrings(a.path, b.path));
133
+ return {
134
+ packageManager: managerSignal.manager,
135
+ packageManagerEvidence: [...managerSignal.evidence].sort((a, b) => compareStrings(a.source, b.source)),
136
+ lockfiles: [...lockfiles].sort(compareStrings),
137
+ isMonorepo: hasWorkspaces,
138
+ workspaceModel,
139
+ workspaceGlobs: declaredGlobs,
140
+ rootPackage: rootFacts !== null ? toWorkspacePackage('package.json', rootFacts) : null,
141
+ packages,
142
+ };
143
+ }
144
+ /** Nearest workspace package for a file path, when the file lives inside one. */
145
+ export function owningPackage(info, filePath) {
146
+ const normalized = normalizeRelative(filePath);
147
+ const candidates = [...info.packages].sort((a, b) => b.path.length - a.path.length);
148
+ for (const entry of candidates) {
149
+ if (entry.path.length === 0)
150
+ return entry;
151
+ if (normalized.startsWith(`${entry.path}/`))
152
+ return entry;
153
+ }
154
+ return null;
155
+ }
156
+ /** Maps workspace package directories to their package names. */
157
+ export function packageNameByDirectory(info) {
158
+ const map = new Map();
159
+ for (const entry of info.packages)
160
+ map.set(normalizeRelative(entry.path), entry.name);
161
+ return map;
162
+ }
163
+ /** Package names declared as internal workspaces, used for dependency classification. */
164
+ export function workspacePackageNames(info) {
165
+ return info.packages.map((entry) => entry.name).sort(compareStrings);
166
+ }
167
+ //# sourceMappingURL=workspace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/core/workspace/workspace.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Error model of the package.
3
+ *
4
+ * Every error carries a stable machine-readable `code`, a human readable
5
+ * message and at least one actionable hint, so the CLI can print guidance such
6
+ * as:
7
+ *
8
+ * ```text
9
+ * Cannot analyze repository:
10
+ * TypeScript project detected but tsconfig.json is invalid.
11
+ *
12
+ * Run:
13
+ * agent-context status
14
+ * ```
15
+ */
16
+ import type { DiagnosticPayload } from './model/types.ts';
17
+ export interface AgentContextErrorOptions {
18
+ code: string;
19
+ message: string;
20
+ hints?: string[];
21
+ cause?: unknown;
22
+ source?: string;
23
+ }
24
+ export declare class AgentContextError extends Error {
25
+ readonly code: string;
26
+ readonly hints: string[];
27
+ readonly source?: string;
28
+ constructor(options: AgentContextErrorOptions);
29
+ toJSON(): DiagnosticPayload;
30
+ }
31
+ /** Invalid `agent-context` configuration. */
32
+ export declare class ConfigError extends AgentContextError {
33
+ constructor(message: string, hints?: string[], cause?: unknown);
34
+ }
35
+ /** Repository level analysis failure (not a per-file parse failure). */
36
+ export declare class AnalysisError extends AgentContextError {
37
+ constructor(message: string, hints?: string[], cause?: unknown, source?: string);
38
+ }
39
+ /** `.agent/` is missing or has an unsupported schema version. */
40
+ export declare class ContextStateError extends AgentContextError {
41
+ constructor(message: string, hints?: string[], cause?: unknown);
42
+ }
43
+ /** Raised by adapters when an optional capability is unavailable (git, fs). */
44
+ export declare class AdapterUnavailableError extends AgentContextError {
45
+ constructor(message: string, hints?: string[], cause?: unknown);
46
+ }
47
+ export declare function isAgentContextError(error: unknown): error is AgentContextError;
48
+ /** Converts any thrown value into a printable diagnostic payload. */
49
+ export declare function toDiagnosticPayload(error: unknown): DiagnosticPayload;
50
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,wBAAwB;IAQ7C,MAAM,IAAI,iBAAiB;CAU5B;AAED,6CAA6C;AAC7C,qBAAa,WAAY,SAAQ,iBAAiB;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAiE,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7H;AAED,wEAAwE;AACxE,qBAAa,aAAc,SAAQ,iBAAiB;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAkC,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM;CAI/G;AAED,iEAAiE;AACjE,qBAAa,iBAAkB,SAAQ,iBAAiB;gBAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAgC,EAAE,KAAK,CAAC,EAAE,OAAO;CAI5F;AAED,+EAA+E;AAC/E,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,EAAE,KAAK,CAAC,EAAE,OAAO;CAInE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAIrE"}
package/dist/errors.js ADDED
@@ -0,0 +1,64 @@
1
+ export class AgentContextError extends Error {
2
+ code;
3
+ hints;
4
+ source;
5
+ constructor(options) {
6
+ super(options.message, options.cause !== undefined ? { cause: options.cause } : undefined);
7
+ this.name = 'AgentContextError';
8
+ this.code = options.code;
9
+ this.hints = options.hints ?? [];
10
+ if (options.source !== undefined)
11
+ this.source = options.source;
12
+ }
13
+ toJSON() {
14
+ const payload = {
15
+ code: this.code,
16
+ severity: 'error',
17
+ message: this.message,
18
+ };
19
+ if (this.source !== undefined)
20
+ payload.source = this.source;
21
+ if (this.hints.length > 0)
22
+ payload.hint = this.hints[0];
23
+ return payload;
24
+ }
25
+ }
26
+ /** Invalid `agent-context` configuration. */
27
+ export class ConfigError extends AgentContextError {
28
+ constructor(message, hints = ['Fix .agent/config.json or pass CLI flags to override it.'], cause) {
29
+ super({ code: 'ERR_CONFIG', message, hints, cause });
30
+ this.name = 'ConfigError';
31
+ }
32
+ }
33
+ /** Repository level analysis failure (not a per-file parse failure). */
34
+ export class AnalysisError extends AgentContextError {
35
+ constructor(message, hints = ['Run: agent-context status'], cause, source) {
36
+ super({ code: 'ERR_ANALYSIS', message, hints, cause, source });
37
+ this.name = 'AnalysisError';
38
+ }
39
+ }
40
+ /** `.agent/` is missing or has an unsupported schema version. */
41
+ export class ContextStateError extends AgentContextError {
42
+ constructor(message, hints = ['Run: agent-context scan'], cause) {
43
+ super({ code: 'ERR_CONTEXT_STATE', message, hints, cause });
44
+ this.name = 'ContextStateError';
45
+ }
46
+ }
47
+ /** Raised by adapters when an optional capability is unavailable (git, fs). */
48
+ export class AdapterUnavailableError extends AgentContextError {
49
+ constructor(message, hints = [], cause) {
50
+ super({ code: 'ERR_ADAPTER_UNAVAILABLE', message, hints, cause });
51
+ this.name = 'AdapterUnavailableError';
52
+ }
53
+ }
54
+ export function isAgentContextError(error) {
55
+ return error instanceof AgentContextError;
56
+ }
57
+ /** Converts any thrown value into a printable diagnostic payload. */
58
+ export function toDiagnosticPayload(error) {
59
+ if (isAgentContextError(error))
60
+ return error.toJSON();
61
+ const message = error instanceof Error ? error.message : String(error);
62
+ return { code: 'ERR_UNEXPECTED', severity: 'error', message };
63
+ }
64
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,80 @@
1
+ /**
2
+ * `@ai-agent-context/core` — public API.
3
+ *
4
+ * The package is local-first, deterministic and dependency free: it analyses a
5
+ * repository into a knowledge graph, persists a versionable `.agent/` context and
6
+ * answers questions about architecture, dependencies, conventions and decisions.
7
+ * No LLM and no network access are involved.
8
+ */
9
+ export { AgentContext } from './agent-context.ts';
10
+ export type { AgentContextOptions, ScanOptions, StatusReport, InitResult } from './agent-context.ts';
11
+ export { runPipeline, detectWorkspaceFromScan, documentHash } from './pipeline/scan-pipeline.ts';
12
+ export type { PipelineOptions, PipelineResult } from './pipeline/scan-pipeline.ts';
13
+ export * from './model/types.ts';
14
+ export { SCHEMA_VERSION, GENERATOR_NAME, AGENT_DIR, LOCAL_DIR, CONFIG_FILE, STATE_FILE, CONTEXT_FILES, CONFIDENCE, } from './model/schema.ts';
15
+ export { canonicalize, stringifyCanonical, hashValue, sha256, shortHash, compareStrings, sortBy, uniqueSorted, clampConfidence, } from './model/canonical.ts';
16
+ export { AgentContextError, ConfigError, AnalysisError, ContextStateError, AdapterUnavailableError, isAgentContextError, toDiagnosticPayload, } from './errors.ts';
17
+ export { DEFAULT_CONFIG, DEFAULT_EXCLUDE, DEFAULT_INCLUDE, DEFAULT_SENSITIVE_PATTERNS } from './config/defaults.ts';
18
+ export { loadConfig, applyOverrides, writeConfigFile, normalizeConfig, initConfigTemplate } from './config/load.ts';
19
+ export { validateConfig, parseConfigText } from './config/validate.ts';
20
+ export type { AgentContextConfig, ConfigOverrides, FeaturesConfig, LoadedConfig } from './config/types.ts';
21
+ export { FileSystemAdapter } from './adapters/filesystem/fs-adapter.ts';
22
+ export type { WalkedFile, WalkOptions } from './adapters/filesystem/fs-adapter.ts';
23
+ export { SensitivePathFilter, redactSecrets, containsSecret, SECRET_VALUE_PATTERNS, REDACTED, } from './adapters/filesystem/sensitive.ts';
24
+ export { GitAdapter, parseGitLog } from './adapters/git/git-adapter.ts';
25
+ export type { GitCommit, GitAvailability } from './adapters/git/git-adapter.ts';
26
+ export { LanguageRegistry, createDefaultRegistry } from './adapters/language/registry.ts';
27
+ export { SIGNALS, createParsedFile, normalizeSignals } from './adapters/language/types.ts';
28
+ export type { LanguageAdapter, ParsedFile, FileDescriptor, ImportRecord, ExportRecord, SymbolRecord, CallRecord, RouteRecord, } from './adapters/language/types.ts';
29
+ export { TsJsAdapter } from './adapters/language/ts-js/adapter.ts';
30
+ export { tokenize } from './adapters/language/ts-js/lexer.ts';
31
+ export { extractModuleFacts } from './adapters/language/ts-js/extractor.ts';
32
+ export { JsonAdapter } from './adapters/language/json/adapter.ts';
33
+ export { MarkdownAdapter } from './adapters/language/markdown/adapter.ts';
34
+ export { PackageJsonAdapter, readPackageFacts } from './adapters/language/package-json/adapter.ts';
35
+ export { TsConfigAdapter, readTsConfigFacts, relaxJson } from './adapters/language/tsconfig/adapter.ts';
36
+ export { scanRepository, classifyFile } from './core/scanner/scanner.ts';
37
+ export type { ScanOutput, ScanOptions as ScannerOptions } from './core/scanner/scanner.ts';
38
+ export { LocalStateStore, ParseCache } from './core/scanner/cache.ts';
39
+ export type { LocalState, FileStateRecord } from './core/scanner/cache.ts';
40
+ export { buildKnowledgeGraph, buildSymbols, findModuleCycles, classifyExternalImportance, } from './core/graph/knowledge-graph.ts';
41
+ export type { KnowledgeGraph, KnowledgeGraphInput, UnresolvedImport } from './core/graph/knowledge-graph.ts';
42
+ export { ImportResolver, withExtensions } from './core/graph/resolver.ts';
43
+ export type { AliasEntry, ResolvedImport } from './core/graph/resolver.ts';
44
+ export { buildModules } from './core/graph/modules.ts';
45
+ export { collectAliases } from './core/graph/aliases.ts';
46
+ export { detectWorkspace, owningPackage, parsePnpmWorkspaceYaml, LOCKFILE_CANDIDATES, } from './core/workspace/workspace.ts';
47
+ export { packageFactsFromParsed } from './core/workspace/package-facts.ts';
48
+ export { applyArchitectureDetection } from './core/architecture/detector.ts';
49
+ export { detectEntryPoints } from './core/architecture/entry-points.ts';
50
+ export { detectModuleRoles, detectResponsibilities, roleValues } from './core/architecture/role-detector.ts';
51
+ export { detectConventions, MIN_SAMPLE } from './core/conventions/detector.ts';
52
+ export { renderConventionsMarkdown } from './core/conventions/renderer.ts';
53
+ export { detectDecisions, parseAdrDocument, collectAdrPaths } from './core/decisions/detector.ts';
54
+ export { computeGitActivity, applyGitSignals, bucket } from './core/git-analysis/activity.ts';
55
+ export type { GitActivityInput, GitActivityResult } from './core/git-analysis/activity.ts';
56
+ export { diffContext, hashDocuments } from './core/diff/differ.ts';
57
+ export type { DiffOptions } from './core/diff/differ.ts';
58
+ export { explainModule, resolveTarget, transitiveDependents } from './core/context/explain.ts';
59
+ export type { ExplainInput, ResolvedTarget } from './core/context/explain.ts';
60
+ export { buildRepositoryContext, collectCommands } from './core/context/repository-context.ts';
61
+ export type { RepositoryContext, RepositoryContextPayload, ContextCommand } from './core/context/types.ts';
62
+ export { SearchService, toSearchResult } from './core/search/service.ts';
63
+ export type { SearchOptions } from './core/search/service.ts';
64
+ export { Bm25Index } from './core/search/bm25.ts';
65
+ export { buildSearchDocuments, snippetFor } from './core/search/documents.ts';
66
+ export { analyze, expandQueryTerms, SYNONYMS, stem } from './core/search/analyzer.ts';
67
+ export type { SearchBackend, SearchDocument, SearchQuery, RankedDocument, Reranker, SearchNodeType, } from './core/search/types.ts';
68
+ export { buildContextDocuments, buildIndexDocument, buildArchitectureDocument, buildDependenciesDocument, buildConventionsDocuments, buildDecisionsDocument, } from './core/serialization/documents.ts';
69
+ export type { ArchitectureDocument, ArchitectureModule, ConventionsDocument, DecisionsDocument, DependenciesDocument, IndexDocument, ContextDocuments, DocumentBuildOptions, } from './core/serialization/types.ts';
70
+ export { readPersistedContext, hasUsableContext, contextFileNames } from './core/serialization/reader.ts';
71
+ export type { PersistedContext } from './core/serialization/reader.ts';
72
+ export { writeContext, serializeContextDocuments, removeContextDirectory } from './core/serialization/writer.ts';
73
+ export type { WriteContextResult } from './core/serialization/writer.ts';
74
+ export { PatternSet, compileGlob, compileRule } from './util/glob.ts';
75
+ export { toPosix, normalizeRelative, dirname, basename, extname, stem as pathStem, join, isInside, ancestors, relativeTo, } from './util/paths.ts';
76
+ export { mapWithConcurrency, runWithConcurrency, defaultConcurrency } from './util/concurrency.ts';
77
+ export { Logger, DiagnosticsCollector, silentLogger } from './logging/diagnostics.ts';
78
+ export type { LogLevel, ProgressEvent, ProgressReporter } from './logging/diagnostics.ts';
79
+ export { classifyIdentifierCase, splitIdentifier, truncate, formatDate, ratio, pluralize } from './util/text.ts';
80
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js ADDED
@@ -0,0 +1,66 @@
1
+ /**
2
+ * `@ai-agent-context/core` — public API.
3
+ *
4
+ * The package is local-first, deterministic and dependency free: it analyses a
5
+ * repository into a knowledge graph, persists a versionable `.agent/` context and
6
+ * answers questions about architecture, dependencies, conventions and decisions.
7
+ * No LLM and no network access are involved.
8
+ */
9
+ export { AgentContext } from "./agent-context.js";
10
+ export { runPipeline, detectWorkspaceFromScan, documentHash } from "./pipeline/scan-pipeline.js";
11
+ /* Model */
12
+ export * from "./model/types.js";
13
+ export { SCHEMA_VERSION, GENERATOR_NAME, AGENT_DIR, LOCAL_DIR, CONFIG_FILE, STATE_FILE, CONTEXT_FILES, CONFIDENCE, } from "./model/schema.js";
14
+ export { canonicalize, stringifyCanonical, hashValue, sha256, shortHash, compareStrings, sortBy, uniqueSorted, clampConfidence, } from "./model/canonical.js";
15
+ /* Errors */
16
+ export { AgentContextError, ConfigError, AnalysisError, ContextStateError, AdapterUnavailableError, isAgentContextError, toDiagnosticPayload, } from "./errors.js";
17
+ /* Configuration */
18
+ export { DEFAULT_CONFIG, DEFAULT_EXCLUDE, DEFAULT_INCLUDE, DEFAULT_SENSITIVE_PATTERNS } from "./config/defaults.js";
19
+ export { loadConfig, applyOverrides, writeConfigFile, normalizeConfig, initConfigTemplate } from "./config/load.js";
20
+ export { validateConfig, parseConfigText } from "./config/validate.js";
21
+ /* Adapters */
22
+ export { FileSystemAdapter } from "./adapters/filesystem/fs-adapter.js";
23
+ export { SensitivePathFilter, redactSecrets, containsSecret, SECRET_VALUE_PATTERNS, REDACTED, } from "./adapters/filesystem/sensitive.js";
24
+ export { GitAdapter, parseGitLog } from "./adapters/git/git-adapter.js";
25
+ export { LanguageRegistry, createDefaultRegistry } from "./adapters/language/registry.js";
26
+ export { SIGNALS, createParsedFile, normalizeSignals } from "./adapters/language/types.js";
27
+ export { TsJsAdapter } from "./adapters/language/ts-js/adapter.js";
28
+ export { tokenize } from "./adapters/language/ts-js/lexer.js";
29
+ export { extractModuleFacts } from "./adapters/language/ts-js/extractor.js";
30
+ export { JsonAdapter } from "./adapters/language/json/adapter.js";
31
+ export { MarkdownAdapter } from "./adapters/language/markdown/adapter.js";
32
+ export { PackageJsonAdapter, readPackageFacts } from "./adapters/language/package-json/adapter.js";
33
+ export { TsConfigAdapter, readTsConfigFacts, relaxJson } from "./adapters/language/tsconfig/adapter.js";
34
+ /* Core analysis */
35
+ export { scanRepository, classifyFile } from "./core/scanner/scanner.js";
36
+ export { LocalStateStore, ParseCache } from "./core/scanner/cache.js";
37
+ export { buildKnowledgeGraph, buildSymbols, findModuleCycles, classifyExternalImportance, } from "./core/graph/knowledge-graph.js";
38
+ export { ImportResolver, withExtensions } from "./core/graph/resolver.js";
39
+ export { buildModules } from "./core/graph/modules.js";
40
+ export { collectAliases } from "./core/graph/aliases.js";
41
+ export { detectWorkspace, owningPackage, parsePnpmWorkspaceYaml, LOCKFILE_CANDIDATES, } from "./core/workspace/workspace.js";
42
+ export { packageFactsFromParsed } from "./core/workspace/package-facts.js";
43
+ export { applyArchitectureDetection } from "./core/architecture/detector.js";
44
+ export { detectEntryPoints } from "./core/architecture/entry-points.js";
45
+ export { detectModuleRoles, detectResponsibilities, roleValues } from "./core/architecture/role-detector.js";
46
+ export { detectConventions, MIN_SAMPLE } from "./core/conventions/detector.js";
47
+ export { renderConventionsMarkdown } from "./core/conventions/renderer.js";
48
+ export { detectDecisions, parseAdrDocument, collectAdrPaths } from "./core/decisions/detector.js";
49
+ export { computeGitActivity, applyGitSignals, bucket } from "./core/git-analysis/activity.js";
50
+ export { diffContext, hashDocuments } from "./core/diff/differ.js";
51
+ export { explainModule, resolveTarget, transitiveDependents } from "./core/context/explain.js";
52
+ export { buildRepositoryContext, collectCommands } from "./core/context/repository-context.js";
53
+ export { SearchService, toSearchResult } from "./core/search/service.js";
54
+ export { Bm25Index } from "./core/search/bm25.js";
55
+ export { buildSearchDocuments, snippetFor } from "./core/search/documents.js";
56
+ export { analyze, expandQueryTerms, SYNONYMS, stem } from "./core/search/analyzer.js";
57
+ export { buildContextDocuments, buildIndexDocument, buildArchitectureDocument, buildDependenciesDocument, buildConventionsDocuments, buildDecisionsDocument, } from "./core/serialization/documents.js";
58
+ export { readPersistedContext, hasUsableContext, contextFileNames } from "./core/serialization/reader.js";
59
+ export { writeContext, serializeContextDocuments, removeContextDirectory } from "./core/serialization/writer.js";
60
+ /* Utilities (public because adapters and the CLI build on them) */
61
+ export { PatternSet, compileGlob, compileRule } from "./util/glob.js";
62
+ export { toPosix, normalizeRelative, dirname, basename, extname, stem as pathStem, join, isInside, ancestors, relativeTo, } from "./util/paths.js";
63
+ export { mapWithConcurrency, runWithConcurrency, defaultConcurrency } from "./util/concurrency.js";
64
+ export { Logger, DiagnosticsCollector, silentLogger } from "./logging/diagnostics.js";
65
+ export { classifyIdentifierCase, splitIdentifier, truncate, formatDate, ratio, pluralize } from "./util/text.js";
66
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}