@mfittko/repo-wiki 0.2.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 (190) hide show
  1. package/.llmwiki/schema.md +107 -0
  2. package/AGENTS.md +42 -0
  3. package/CHANGELOG.md +91 -0
  4. package/LICENSE +21 -0
  5. package/README.md +254 -0
  6. package/dist/bin/repo-wiki.d.ts +2 -0
  7. package/dist/bin/repo-wiki.js +7 -0
  8. package/dist/bin/repo-wiki.js.map +1 -0
  9. package/dist/src/cli.d.ts +1 -0
  10. package/dist/src/cli.js +404 -0
  11. package/dist/src/cli.js.map +1 -0
  12. package/dist/src/compiler.d.ts +55 -0
  13. package/dist/src/compiler.js +2046 -0
  14. package/dist/src/compiler.js.map +1 -0
  15. package/dist/src/config.d.ts +63 -0
  16. package/dist/src/config.js +86 -0
  17. package/dist/src/config.js.map +1 -0
  18. package/dist/src/context-assembler.d.ts +68 -0
  19. package/dist/src/context-assembler.js +378 -0
  20. package/dist/src/context-assembler.js.map +1 -0
  21. package/dist/src/data-model-signals.d.ts +1 -0
  22. package/dist/src/data-model-signals.js +13 -0
  23. package/dist/src/data-model-signals.js.map +1 -0
  24. package/dist/src/docs-ingestor.d.ts +138 -0
  25. package/dist/src/docs-ingestor.js +844 -0
  26. package/dist/src/docs-ingestor.js.map +1 -0
  27. package/dist/src/docs-linter.d.ts +14 -0
  28. package/dist/src/docs-linter.js +164 -0
  29. package/dist/src/docs-linter.js.map +1 -0
  30. package/dist/src/docs-validation.d.ts +36 -0
  31. package/dist/src/docs-validation.js +297 -0
  32. package/dist/src/docs-validation.js.map +1 -0
  33. package/dist/src/extractors.d.ts +50 -0
  34. package/dist/src/extractors.js +2275 -0
  35. package/dist/src/extractors.js.map +1 -0
  36. package/dist/src/frontmatter.d.ts +46 -0
  37. package/dist/src/frontmatter.js +377 -0
  38. package/dist/src/frontmatter.js.map +1 -0
  39. package/dist/src/index.d.ts +26 -0
  40. package/dist/src/index.js +18 -0
  41. package/dist/src/index.js.map +1 -0
  42. package/dist/src/init.d.ts +12 -0
  43. package/dist/src/init.js +121 -0
  44. package/dist/src/init.js.map +1 -0
  45. package/dist/src/language.d.ts +2 -0
  46. package/dist/src/language.js +62 -0
  47. package/dist/src/language.js.map +1 -0
  48. package/dist/src/linter.d.ts +33 -0
  49. package/dist/src/linter.js +398 -0
  50. package/dist/src/linter.js.map +1 -0
  51. package/dist/src/llm-provider.d.ts +267 -0
  52. package/dist/src/llm-provider.js +474 -0
  53. package/dist/src/llm-provider.js.map +1 -0
  54. package/dist/src/page-ownership.d.ts +38 -0
  55. package/dist/src/page-ownership.js +96 -0
  56. package/dist/src/page-ownership.js.map +1 -0
  57. package/dist/src/planner.d.ts +55 -0
  58. package/dist/src/planner.js +422 -0
  59. package/dist/src/planner.js.map +1 -0
  60. package/dist/src/prompts.d.ts +103 -0
  61. package/dist/src/prompts.js +344 -0
  62. package/dist/src/prompts.js.map +1 -0
  63. package/dist/src/publisher.d.ts +68 -0
  64. package/dist/src/publisher.js +662 -0
  65. package/dist/src/publisher.js.map +1 -0
  66. package/dist/src/repository-analysis.d.ts +88 -0
  67. package/dist/src/repository-analysis.js +485 -0
  68. package/dist/src/repository-analysis.js.map +1 -0
  69. package/dist/src/scanner.d.ts +122 -0
  70. package/dist/src/scanner.js +309 -0
  71. package/dist/src/scanner.js.map +1 -0
  72. package/dist/src/search.d.ts +71 -0
  73. package/dist/src/search.js +410 -0
  74. package/dist/src/search.js.map +1 -0
  75. package/dist/src/secret-patterns.d.ts +3 -0
  76. package/dist/src/secret-patterns.js +14 -0
  77. package/dist/src/secret-patterns.js.map +1 -0
  78. package/dist/src/utils/args.d.ts +2 -0
  79. package/dist/src/utils/args.js +19 -0
  80. package/dist/src/utils/args.js.map +1 -0
  81. package/dist/src/utils/dotenv.d.ts +7 -0
  82. package/dist/src/utils/dotenv.js +73 -0
  83. package/dist/src/utils/dotenv.js.map +1 -0
  84. package/dist/src/utils/fs.d.ts +22 -0
  85. package/dist/src/utils/fs.js +83 -0
  86. package/dist/src/utils/fs.js.map +1 -0
  87. package/dist/src/utils/git.d.ts +13 -0
  88. package/dist/src/utils/git.js +39 -0
  89. package/dist/src/utils/git.js.map +1 -0
  90. package/dist/src/wiki-graph.d.ts +74 -0
  91. package/dist/src/wiki-graph.js +335 -0
  92. package/dist/src/wiki-graph.js.map +1 -0
  93. package/dist/src/wiki-patch.d.ts +152 -0
  94. package/dist/src/wiki-patch.js +489 -0
  95. package/dist/src/wiki-patch.js.map +1 -0
  96. package/dist/src/wiki-query.d.ts +63 -0
  97. package/dist/src/wiki-query.js +255 -0
  98. package/dist/src/wiki-query.js.map +1 -0
  99. package/dist/test/cli.test.d.ts +1 -0
  100. package/dist/test/cli.test.js +514 -0
  101. package/dist/test/cli.test.js.map +1 -0
  102. package/dist/test/compiler-eval.test.d.ts +1 -0
  103. package/dist/test/compiler-eval.test.js +234 -0
  104. package/dist/test/compiler-eval.test.js.map +1 -0
  105. package/dist/test/compiler.test.d.ts +1 -0
  106. package/dist/test/compiler.test.js +2537 -0
  107. package/dist/test/compiler.test.js.map +1 -0
  108. package/dist/test/context-assembler.test.d.ts +1 -0
  109. package/dist/test/context-assembler.test.js +379 -0
  110. package/dist/test/context-assembler.test.js.map +1 -0
  111. package/dist/test/docs-linter.test.d.ts +1 -0
  112. package/dist/test/docs-linter.test.js +900 -0
  113. package/dist/test/docs-linter.test.js.map +1 -0
  114. package/dist/test/dotenv.test.d.ts +1 -0
  115. package/dist/test/dotenv.test.js +77 -0
  116. package/dist/test/dotenv.test.js.map +1 -0
  117. package/dist/test/extractors-go.test.d.ts +1 -0
  118. package/dist/test/extractors-go.test.js +393 -0
  119. package/dist/test/extractors-go.test.js.map +1 -0
  120. package/dist/test/extractors-rust.test.d.ts +1 -0
  121. package/dist/test/extractors-rust.test.js +219 -0
  122. package/dist/test/extractors-rust.test.js.map +1 -0
  123. package/dist/test/extractors-utils.test.d.ts +1 -0
  124. package/dist/test/extractors-utils.test.js +786 -0
  125. package/dist/test/extractors-utils.test.js.map +1 -0
  126. package/dist/test/fixtures/compiler-e2e/basic-node-service/repo/infra/deploy.d.ts +1 -0
  127. package/dist/test/fixtures/compiler-e2e/basic-node-service/repo/infra/deploy.js +4 -0
  128. package/dist/test/fixtures/compiler-e2e/basic-node-service/repo/infra/deploy.js.map +1 -0
  129. package/dist/test/frontmatter.test.d.ts +1 -0
  130. package/dist/test/frontmatter.test.js +287 -0
  131. package/dist/test/frontmatter.test.js.map +1 -0
  132. package/dist/test/init-planner.test.d.ts +1 -0
  133. package/dist/test/init-planner.test.js +688 -0
  134. package/dist/test/init-planner.test.js.map +1 -0
  135. package/dist/test/linter.test.d.ts +1 -0
  136. package/dist/test/linter.test.js +426 -0
  137. package/dist/test/linter.test.js.map +1 -0
  138. package/dist/test/llm-provider.test.d.ts +1 -0
  139. package/dist/test/llm-provider.test.js +783 -0
  140. package/dist/test/llm-provider.test.js.map +1 -0
  141. package/dist/test/page-ownership.test.d.ts +1 -0
  142. package/dist/test/page-ownership.test.js +247 -0
  143. package/dist/test/page-ownership.test.js.map +1 -0
  144. package/dist/test/publisher.test.d.ts +1 -0
  145. package/dist/test/publisher.test.js +1297 -0
  146. package/dist/test/publisher.test.js.map +1 -0
  147. package/dist/test/repository-analysis.test.d.ts +1 -0
  148. package/dist/test/repository-analysis.test.js +182 -0
  149. package/dist/test/repository-analysis.test.js.map +1 -0
  150. package/dist/test/run-compiled-tests.d.ts +1 -0
  151. package/dist/test/run-compiled-tests.js +48 -0
  152. package/dist/test/run-compiled-tests.js.map +1 -0
  153. package/dist/test/scanner.test.d.ts +1 -0
  154. package/dist/test/scanner.test.js +551 -0
  155. package/dist/test/scanner.test.js.map +1 -0
  156. package/dist/test/search.test.d.ts +1 -0
  157. package/dist/test/search.test.js +92 -0
  158. package/dist/test/search.test.js.map +1 -0
  159. package/dist/test/update-changelog.test.d.ts +1 -0
  160. package/dist/test/update-changelog.test.js +125 -0
  161. package/dist/test/update-changelog.test.js.map +1 -0
  162. package/dist/test/wiki-graph.test.d.ts +1 -0
  163. package/dist/test/wiki-graph.test.js +164 -0
  164. package/dist/test/wiki-graph.test.js.map +1 -0
  165. package/dist/test/wiki-patch.test.d.ts +1 -0
  166. package/dist/test/wiki-patch.test.js +610 -0
  167. package/dist/test/wiki-patch.test.js.map +1 -0
  168. package/dist/test/wiki-query.test.d.ts +1 -0
  169. package/dist/test/wiki-query.test.js +163 -0
  170. package/dist/test/wiki-query.test.js.map +1 -0
  171. package/docs/PLAN.md +993 -0
  172. package/docs/WHY.md +61 -0
  173. package/docs/plans/agent-integration.md +85 -0
  174. package/docs/plans/ci-publishing.md +111 -0
  175. package/docs/plans/doc-validation.md +92 -0
  176. package/docs/plans/github-action.md +113 -0
  177. package/docs/plans/incremental-mode.md +98 -0
  178. package/docs/plans/karpathy-llm-wiki-alignment.md +84 -0
  179. package/docs/plans/llm-compiler.md +160 -0
  180. package/docs/plans/production-scanner.md +104 -0
  181. package/docs/plans/query-and-file-back.md +103 -0
  182. package/docs/plans/search-index.md +118 -0
  183. package/docs/plans/trust-hardening.md +74 -0
  184. package/docs/plans/wiki-graph.md +183 -0
  185. package/docs/plans/wiki-health.md +76 -0
  186. package/package.json +83 -0
  187. package/prompts/compiler.md +16 -0
  188. package/prompts/lint.md +18 -0
  189. package/prompts/page-templates.md +25 -0
  190. package/skills/repo-wiki-cli/SKILL.md +139 -0
@@ -0,0 +1,122 @@
1
+ type ScannerOptions = {
2
+ mode: string;
3
+ repoPath: string;
4
+ outDir: string;
5
+ baseRef?: string;
6
+ headRef?: string;
7
+ };
8
+ export declare function scanRepository({ mode, repoPath, outDir, baseRef, headRef }: ScannerOptions): Promise<{
9
+ manifest: {
10
+ schema_version: number;
11
+ mode: string;
12
+ repo_path: string;
13
+ remote: string;
14
+ commit: string;
15
+ base_ref: string;
16
+ head_ref: string;
17
+ generated_at: string;
18
+ config: {
19
+ source: any;
20
+ documentation: any;
21
+ compiler: any;
22
+ lint: any;
23
+ wiki: any;
24
+ };
25
+ totals: {
26
+ languages: Record<string, number>;
27
+ categories: Record<string, number>;
28
+ runtime_hints: Record<string, number>;
29
+ documentation: {
30
+ files: number;
31
+ statuses: Record<string, number>;
32
+ stale: number;
33
+ claims: number;
34
+ commands: number;
35
+ env_vars: number;
36
+ file_paths: number;
37
+ };
38
+ };
39
+ analysis: {
40
+ package_scripts: {
41
+ path: string;
42
+ name: string;
43
+ scripts: Record<string, string>;
44
+ script_sources: {
45
+ end_line?: number;
46
+ line?: number;
47
+ name: string;
48
+ }[];
49
+ }[];
50
+ ci_workflow_commands: string[];
51
+ ci_workflow_command_sources: {
52
+ end_line?: number;
53
+ line?: number;
54
+ path: string;
55
+ command: string;
56
+ }[];
57
+ make_targets: string[];
58
+ make_target_sources: {
59
+ line?: number;
60
+ path: string;
61
+ target: string;
62
+ }[];
63
+ task_runner_targets: string[];
64
+ task_runner_target_sources: {
65
+ line?: number;
66
+ path: string;
67
+ target: string;
68
+ runner: "just" | "taskfile";
69
+ }[];
70
+ dependency_graph: {
71
+ nodes: any[];
72
+ edges: any[];
73
+ summary: {
74
+ edges: number;
75
+ importers: number;
76
+ imported_files: number;
77
+ imported_packages: number;
78
+ };
79
+ };
80
+ test_to_source: {
81
+ mappings: any;
82
+ summary: {
83
+ mapped_tests: any;
84
+ source_files: number;
85
+ };
86
+ };
87
+ };
88
+ documentation: {
89
+ enabled: boolean;
90
+ authority: any;
91
+ files: any[];
92
+ summary: {
93
+ files: number;
94
+ statuses: Record<string, number>;
95
+ stale: number;
96
+ claims: number;
97
+ commands: number;
98
+ env_vars: number;
99
+ file_paths: number;
100
+ };
101
+ };
102
+ files: any[];
103
+ };
104
+ summary: {
105
+ mode: string;
106
+ commit: string;
107
+ files: number;
108
+ languages: Record<string, number>;
109
+ categories: Record<string, number>;
110
+ documentation: {
111
+ files: number;
112
+ statuses: Record<string, number>;
113
+ stale: number;
114
+ claims: number;
115
+ commands: number;
116
+ env_vars: number;
117
+ file_paths: number;
118
+ };
119
+ outDir: string;
120
+ };
121
+ }>;
122
+ export {};
@@ -0,0 +1,309 @@
1
+ import { createReadStream, promises as fs } from 'node:fs';
2
+ import path from 'node:path';
3
+ import crypto from 'node:crypto';
4
+ import { Writable } from 'node:stream';
5
+ import { pipeline } from 'node:stream/promises';
6
+ import { DEFAULT_WALK_EXCLUDES, ensureDir, walkFiles, writeJson } from './utils/fs.js';
7
+ import { getGitCommit, getGitRemote } from './utils/git.js';
8
+ import { classifyPath, detectLanguage } from './language.js';
9
+ import { detectRuntimeHints, extractEnvironmentVariables, extractExportedSymbols, extractGoPackage, extractImports, extractMigrationSurfaces, extractModelSurfaces, extractRouteSurfaces, extractSymbols } from './extractors.js';
10
+ import { buildRepositoryAnalysis, extractPackageMetadata } from './repository-analysis.js';
11
+ import { loadConfig } from './config.js';
12
+ import { isDocumentationFile, createDocumentationCard, extractCiCommandSources, extractMakeTargetSources, extractJustfileTargetSources, extractTaskfileTargetSources } from './docs-ingestor.js';
13
+ const MAX_TEXT_BYTES = 512_000;
14
+ export async function scanRepository({ mode, repoPath, outDir, baseRef, headRef }) {
15
+ const absoluteRepo = path.resolve(repoPath);
16
+ const absoluteOut = path.resolve(outDir);
17
+ await ensureDir(absoluteOut);
18
+ await ensureDir(path.join(absoluteOut, 'cards'));
19
+ const config = await loadConfig(absoluteRepo);
20
+ const commit = headRef || await getGitCommit(absoluteRepo);
21
+ const remote = await getGitRemote(absoluteRepo);
22
+ const sourceExclude = Array.isArray(config?.source?.exclude) ? config.source.exclude : [];
23
+ const suppressedNestedRepositories = [];
24
+ const files = await walkFiles(absoluteRepo, {
25
+ additionalExclude: sourceExclude,
26
+ suppressNestedRepositories: config?.source?.suppress_nested_repositories !== false,
27
+ onSuppressNestedRepository(relativePath) {
28
+ suppressedNestedRepositories.push(relativePath);
29
+ }
30
+ });
31
+ const cards = [];
32
+ const documentationCards = [];
33
+ for (const file of files) {
34
+ const stat = await fs.stat(file.absolute);
35
+ const language = detectLanguage(file.relative);
36
+ const kind = classifyPath(file.relative);
37
+ let hash;
38
+ let content = '';
39
+ let contentAvailable = false;
40
+ if (stat.size <= MAX_TEXT_BYTES) {
41
+ const buffer = await fs.readFile(file.absolute);
42
+ hash = hashBuffer(buffer);
43
+ contentAvailable = isLikelyText(file.relative, buffer);
44
+ content = contentAvailable ? buffer.toString('utf8') : '';
45
+ }
46
+ else {
47
+ hash = await hashFile(file.absolute);
48
+ }
49
+ const packageMetadata = contentAvailable ? extractPackageMetadata(file.relative, content) : null;
50
+ const ciWorkflowCommandSources = contentAvailable && kind === 'ci' ? extractCiCommandSources(content) : [];
51
+ const ciWorkflowCommands = [...new Set(ciWorkflowCommandSources.map((entry) => entry.command))];
52
+ const lowerBaseName = path.basename(file.relative).toLowerCase();
53
+ const makeTargetSources = contentAvailable && lowerBaseName === 'makefile' ? extractMakeTargetSources(content) : [];
54
+ const makeTargets = [...new Set(makeTargetSources.map((entry) => entry.target))];
55
+ const taskRunnerTargetSources = getTaskRunnerTargetSources(lowerBaseName, content, contentAvailable);
56
+ const taskRunnerTargets = [...new Set(taskRunnerTargetSources.map((entry) => entry.target))];
57
+ const goPackage = (language === 'Go' && contentAvailable) ? extractGoPackage(content, language) : null;
58
+ const imports = contentAvailable ? extractImports(content, language) : [];
59
+ const symbols = contentAvailable ? extractSymbols(content, language) : [];
60
+ const exportedSymbols = contentAvailable ? extractExportedSymbols(content, language) : [];
61
+ const environmentVariables = contentAvailable ? mergeEnvironmentVariables(extractEnvironmentVariables(content, language), extractConfiguredEnvironmentVariables(file.relative, content)) : [];
62
+ const routeSurfaces = contentAvailable ? extractRouteSurfaces(file.relative, content, language) : [];
63
+ const migrationSurfaces = extractMigrationSurfaces(file.relative, language);
64
+ const modelSurfaces = contentAvailable ? extractModelSurfaces(file.relative, content, language) : [];
65
+ let runtimeHints = [];
66
+ if (contentAvailable) {
67
+ runtimeHints = detectRuntimeHints(file.relative, content, {
68
+ language,
69
+ environmentVariables,
70
+ routeSurfaces,
71
+ migrationSurfaces,
72
+ modelSurfaces
73
+ });
74
+ }
75
+ else if (migrationSurfaces.length > 0) {
76
+ runtimeHints = detectRuntimeHints(file.relative, '', { language, migrationSurfaces, modelSurfaces });
77
+ }
78
+ const card = {
79
+ kind: 'source_card',
80
+ path: file.relative,
81
+ language,
82
+ category: kind,
83
+ bytes: stat.size,
84
+ lines: contentAvailable ? countLines(content) : null,
85
+ sha256: hash,
86
+ imports,
87
+ symbols,
88
+ exported_symbols: exportedSymbols,
89
+ environment_variables: environmentVariables,
90
+ route_surfaces: routeSurfaces,
91
+ migration_surfaces: migrationSurfaces,
92
+ model_surfaces: modelSurfaces,
93
+ runtime_hints: runtimeHints,
94
+ ...(packageMetadata || {}),
95
+ ...(ciWorkflowCommands.length ? { ci_workflow_commands: ciWorkflowCommands } : {}),
96
+ ...(ciWorkflowCommandSources.length ? { ci_workflow_command_sources: ciWorkflowCommandSources } : {}),
97
+ ...(makeTargets.length ? { make_targets: makeTargets } : {}),
98
+ ...(makeTargetSources.length ? { make_target_sources: makeTargetSources } : {}),
99
+ ...(taskRunnerTargets.length ? { task_runner_targets: taskRunnerTargets } : {}),
100
+ ...(taskRunnerTargetSources.length ? { task_runner_target_sources: taskRunnerTargetSources } : {}),
101
+ ...(goPackage !== null ? { go_package: goPackage } : {}),
102
+ skipped_content: !contentAvailable,
103
+ reasons: inferReasons(file.relative, kind, content, { environmentVariables, routeSurfaces, migrationSurfaces, modelSurfaces })
104
+ };
105
+ cards.push(card);
106
+ await writeJson(path.join(absoluteOut, 'cards', `${safeFileName(file.relative)}.json`), card);
107
+ if (contentAvailable && isDocumentationFile(file.relative, config)) {
108
+ const documentationCard = await createDocumentationCard({ file, content, config, repoPath: absoluteRepo });
109
+ documentationCards.push(documentationCard);
110
+ await writeJson(path.join(absoluteOut, 'docs', `${safeFileName(file.relative)}.json`), documentationCard);
111
+ }
112
+ }
113
+ const analysis = buildRepositoryAnalysis(cards);
114
+ const manifest = {
115
+ schema_version: 1,
116
+ mode,
117
+ repo_path: absoluteRepo,
118
+ remote,
119
+ commit,
120
+ base_ref: baseRef || null,
121
+ head_ref: headRef || commit,
122
+ generated_at: new Date().toISOString(),
123
+ config: {
124
+ source: {
125
+ ...config.source,
126
+ effective_exclude: [...new Set([...DEFAULT_WALK_EXCLUDES, ...sourceExclude])],
127
+ suppressed_nested_repositories: [...new Set(suppressedNestedRepositories)].sort()
128
+ },
129
+ documentation: config.documentation,
130
+ compiler: redactSecretConfig(config.compiler),
131
+ lint: config.lint,
132
+ wiki: config.wiki
133
+ },
134
+ totals: summarize(cards, documentationCards),
135
+ analysis,
136
+ documentation: {
137
+ enabled: config.documentation?.ingest !== false,
138
+ authority: config.documentation?.authority || 'secondary',
139
+ files: documentationCards,
140
+ summary: summarizeDocumentation(documentationCards)
141
+ },
142
+ files: cards
143
+ };
144
+ await writeJson(path.join(absoluteOut, 'manifest.json'), manifest);
145
+ return {
146
+ manifest,
147
+ summary: {
148
+ mode,
149
+ commit,
150
+ files: cards.length,
151
+ languages: manifest.totals.languages,
152
+ categories: manifest.totals.categories,
153
+ documentation: manifest.documentation.summary,
154
+ outDir: absoluteOut
155
+ }
156
+ };
157
+ }
158
+ function redactSecretConfig(value) {
159
+ if (Array.isArray(value)) {
160
+ return value.map((entry) => redactSecretConfig(entry));
161
+ }
162
+ if (value && typeof value === 'object') {
163
+ const redacted = {};
164
+ for (const [key, entry] of Object.entries(value)) {
165
+ redacted[key] = isSecretConfigKey(key) ? '[REDACTED]' : redactSecretConfig(entry);
166
+ }
167
+ return redacted;
168
+ }
169
+ return value;
170
+ }
171
+ function isSecretConfigKey(key) {
172
+ if (/env$/i.test(key)) {
173
+ return false;
174
+ }
175
+ if (/api[_-]?key/i.test(key)) {
176
+ return true;
177
+ }
178
+ return /(?:^|[_-])(?:access[_-]?token|auth[_-]?token|refresh[_-]?token|id[_-]?token|client[_-]?secret|secret[_-]?key|private[_-]?key|password|credentials?|token|secret)(?:$|[_-](?:value|file|path))$/i.test(key);
179
+ }
180
+ function summarize(cards, documentationCards = []) {
181
+ const languages = {};
182
+ const categories = {};
183
+ const runtimeHints = {};
184
+ for (const card of cards) {
185
+ languages[card.language] = (languages[card.language] || 0) + 1;
186
+ categories[card.category] = (categories[card.category] || 0) + 1;
187
+ for (const hint of card.runtime_hints) {
188
+ runtimeHints[hint] = (runtimeHints[hint] || 0) + 1;
189
+ }
190
+ }
191
+ return { languages, categories, runtime_hints: runtimeHints, documentation: summarizeDocumentation(documentationCards) };
192
+ }
193
+ function mergeEnvironmentVariables(...groups) {
194
+ return [...new Set(groups.flat())].sort();
195
+ }
196
+ function extractConfiguredEnvironmentVariables(filePath, content) {
197
+ const lower = filePath.toLowerCase();
198
+ const names = new Set();
199
+ if (/(^|\/)\.env(?:\.|$)/.test(lower) || lower.endsWith('/.env') || lower === '.env') {
200
+ for (const line of content.split('\n')) {
201
+ const match = /^\s*(?:export\s+)?([A-Z][A-Z0-9_]{2,})\s*=/.exec(line);
202
+ if (match)
203
+ names.add(match[1]);
204
+ }
205
+ }
206
+ if (lower.endsWith('dockerfile') || lower.includes('/dockerfile')) {
207
+ for (const line of content.split('\n')) {
208
+ const instruction = /^\s*(ENV|ARG)\s+(.+)$/i.exec(line);
209
+ if (!instruction)
210
+ continue;
211
+ for (const token of tokenizeDockerEnvInstruction(instruction[2])) {
212
+ const match = /^([A-Z][A-Z0-9_]{2,})(?:=.*)?$/.exec(token);
213
+ if (match)
214
+ names.add(match[1]);
215
+ }
216
+ }
217
+ }
218
+ if (/\.(ya?ml|json|toml)$/.test(lower) || lower.includes('schema') || lower.includes('config')) {
219
+ for (const match of content.matchAll(/\b(?:env|env_var|env_vars|environment_variable|environment_variables)\b\s*[:=]\s*['"]?([A-Z][A-Z0-9_]{2,})['"]?/gi)) {
220
+ names.add(match[1]);
221
+ }
222
+ }
223
+ return [...names].sort();
224
+ }
225
+ function tokenizeDockerEnvInstruction(value) {
226
+ return value.match(/"[^"]*"|'[^']*'|\S+/g)?.map((token) => token.replace(/^['"]|['"]$/g, '')) || [];
227
+ }
228
+ function hashBuffer(buffer) {
229
+ return crypto.createHash('sha256').update(buffer).digest('hex');
230
+ }
231
+ async function hashFile(filePath) {
232
+ const hash = crypto.createHash('sha256');
233
+ await pipeline(createReadStream(filePath), new Writable({
234
+ write(chunk, encoding, callback) {
235
+ hash.update(typeof chunk === 'string' ? Buffer.from(chunk, encoding) : chunk);
236
+ callback();
237
+ }
238
+ }));
239
+ return hash.digest('hex');
240
+ }
241
+ function safeFileName(filePath) {
242
+ return filePath.replace(/[^A-Za-z0-9._-]+/g, '__');
243
+ }
244
+ function countLines(content) {
245
+ if (!content) {
246
+ return 0;
247
+ }
248
+ return content.split('\n').length;
249
+ }
250
+ function isLikelyText(filePath, buffer) {
251
+ const lower = filePath.toLowerCase();
252
+ const binaryExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.webp', '.pdf', '.zip', '.gz', '.tar', '.ico', '.woff', '.woff2', '.ttf', '.otf'];
253
+ if (binaryExtensions.some((ext) => lower.endsWith(ext))) {
254
+ return false;
255
+ }
256
+ const sample = buffer.subarray(0, Math.min(buffer.length, 4096));
257
+ return !sample.includes(0);
258
+ }
259
+ function inferReasons(filePath, category, content, metadata = {}) {
260
+ const reasons = new Set([category]);
261
+ const lower = filePath.toLowerCase();
262
+ if (lower.endsWith('package.json'))
263
+ reasons.add('package-manifest');
264
+ if (lower.endsWith('readme.md'))
265
+ reasons.add('readme');
266
+ if (lower.includes('auth'))
267
+ reasons.add('auth');
268
+ if (lower.includes('billing') || lower.includes('payment'))
269
+ reasons.add('billing-or-payment');
270
+ if (lower.includes('route') || lower.includes('controller') || (metadata.routeSurfaces || []).length > 0)
271
+ reasons.add('api-surface');
272
+ if (lower.includes('migration') || lower.includes('schema') || (metadata.migrationSurfaces || []).length > 0 || (metadata.modelSurfaces || []).length > 0)
273
+ reasons.add('data-model');
274
+ if ((metadata.migrationSurfaces || []).length > 0)
275
+ reasons.add('database-migration');
276
+ if ((metadata.modelSurfaces || []).length > 0)
277
+ reasons.add('orm-model');
278
+ if ((metadata.environmentVariables || []).length > 0 || (content && /process\.env\.[A-Z0-9_]+/.test(content)))
279
+ reasons.add('configuration');
280
+ return [...reasons].sort();
281
+ }
282
+ function summarizeDocumentation(cards) {
283
+ const statuses = {};
284
+ let stale = 0;
285
+ let claims = 0;
286
+ let commands = 0;
287
+ let envVars = 0;
288
+ let filePaths = 0;
289
+ for (const card of cards || []) {
290
+ statuses[card.status] = (statuses[card.status] || 0) + 1;
291
+ if (card.stale)
292
+ stale += 1;
293
+ claims += card.claims?.length || 0;
294
+ commands += card.validation?.commands?.length || 0;
295
+ envVars += card.validation?.env_vars?.length || 0;
296
+ filePaths += card.file_paths?.length || 0;
297
+ }
298
+ return { files: cards.length, statuses, stale, claims, commands, env_vars: envVars, file_paths: filePaths };
299
+ }
300
+ function getTaskRunnerTargetSources(lowerBaseName, content, contentAvailable) {
301
+ if (!contentAvailable)
302
+ return [];
303
+ if (lowerBaseName === 'justfile')
304
+ return extractJustfileTargetSources(content);
305
+ if (lowerBaseName === 'taskfile.yml' || lowerBaseName === 'taskfile.yaml')
306
+ return extractTaskfileTargetSources(content);
307
+ return [];
308
+ }
309
+ //# sourceMappingURL=scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/scanner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ export declare const SEARCH_INDEX_VERSION = 1;
2
+ export type SearchIndexEntry = {
3
+ pagePath: string;
4
+ title: string;
5
+ kind: string | null;
6
+ pageState: string | null;
7
+ summary: string | null;
8
+ snippet: string;
9
+ sourceCommit: string | null;
10
+ sourcePaths: string[];
11
+ headings: string[];
12
+ outboundLinks: string[];
13
+ inboundLinks: string[];
14
+ searchText: string;
15
+ };
16
+ export type SearchIndex = {
17
+ version: number;
18
+ wikiDir: string;
19
+ sourceCommits: string[];
20
+ entries: SearchIndexEntry[];
21
+ };
22
+ export type SearchResult = {
23
+ rank: number;
24
+ score: number;
25
+ pagePath: string;
26
+ title: string;
27
+ kind: string | null;
28
+ pageState: string | null;
29
+ summary: string | null;
30
+ snippet: string;
31
+ sourcePaths: string[];
32
+ graph: {
33
+ outboundLinks: string[];
34
+ inboundLinks: string[];
35
+ };
36
+ };
37
+ export declare function defaultSearchDirForWiki(wikiDir: string): string;
38
+ export declare function buildSearchIndex({ wikiDir, outDir }: {
39
+ wikiDir: string;
40
+ outDir?: string;
41
+ }): Promise<{
42
+ index: SearchIndex;
43
+ summary: {
44
+ outDir: string;
45
+ outFile: string;
46
+ pages: number;
47
+ sourceCommits: string[];
48
+ };
49
+ }>;
50
+ export declare function searchWiki({ query, wikiDir, outDir, limit }: {
51
+ query: string;
52
+ wikiDir: string;
53
+ outDir?: string;
54
+ limit?: number;
55
+ }): Promise<{
56
+ index: SearchIndex;
57
+ results: SearchResult[];
58
+ summary: {
59
+ query: string;
60
+ limit: number;
61
+ totalResults: number;
62
+ index: {
63
+ outDir: string;
64
+ outFile: string;
65
+ pages: number;
66
+ sourceCommits: string[];
67
+ };
68
+ };
69
+ }>;
70
+ export declare function searchIndex(index: SearchIndex, query: string, limit?: number): SearchResult[];
71
+ export declare function formatSearchResults(query: string, results: SearchResult[]): string;