create-claude-context 1.0.0 → 1.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 (117) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +169 -146
  3. package/bin/create-claude-context.js +75 -61
  4. package/lib/ai-orchestrator.js +423 -0
  5. package/lib/call-tracer.js +444 -0
  6. package/lib/detector.js +456 -373
  7. package/lib/environment-detector.js +239 -0
  8. package/lib/index.js +271 -170
  9. package/lib/installer.js +371 -362
  10. package/lib/placeholder.js +269 -208
  11. package/lib/prompts.js +287 -287
  12. package/lib/spinner.js +60 -60
  13. package/lib/static-analyzer.js +729 -0
  14. package/lib/template-populator.js +835 -0
  15. package/lib/validate.js +147 -147
  16. package/package.json +59 -59
  17. package/templates/CLAUDE.md.template +235 -235
  18. package/templates/base/README.md +257 -257
  19. package/templates/base/RPI_WORKFLOW_PLAN.md +320 -320
  20. package/templates/base/agents/api-developer.md +76 -76
  21. package/templates/base/agents/context-engineer.md +525 -525
  22. package/templates/base/agents/core-architect.md +76 -76
  23. package/templates/base/agents/database-ops.md +76 -76
  24. package/templates/base/agents/deployment-ops.md +76 -76
  25. package/templates/base/agents/integration-hub.md +76 -76
  26. package/templates/base/analytics/README.md +114 -114
  27. package/templates/base/automation/config.json +58 -0
  28. package/templates/base/automation/generators/code-mapper.js +308 -0
  29. package/templates/base/automation/generators/index-builder.js +321 -0
  30. package/templates/base/automation/hooks/post-commit.sh +83 -0
  31. package/templates/base/automation/hooks/pre-commit.sh +103 -0
  32. package/templates/base/ci-templates/README.md +108 -108
  33. package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
  34. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
  35. package/templates/base/commands/analytics.md +238 -238
  36. package/templates/base/commands/auto-sync.md +172 -0
  37. package/templates/base/commands/collab.md +194 -194
  38. package/templates/base/commands/help.md +450 -450
  39. package/templates/base/commands/rpi-implement.md +115 -115
  40. package/templates/base/commands/rpi-plan.md +93 -93
  41. package/templates/base/commands/rpi-research.md +88 -88
  42. package/templates/base/commands/session-resume.md +144 -0
  43. package/templates/base/commands/session-save.md +112 -0
  44. package/templates/base/commands/validate-all.md +77 -77
  45. package/templates/base/commands/verify-docs-current.md +86 -86
  46. package/templates/base/config/base.json +57 -57
  47. package/templates/base/config/environments/development.json +13 -13
  48. package/templates/base/config/environments/production.json +17 -17
  49. package/templates/base/config/environments/staging.json +13 -13
  50. package/templates/base/config/local.json.example +21 -21
  51. package/templates/base/context/.meta/generated-at.json +18 -0
  52. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
  53. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
  54. package/templates/base/context/FILE_OWNERSHIP.md +57 -0
  55. package/templates/base/context/INTEGRATION_POINTS.md +92 -0
  56. package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
  57. package/templates/base/context/TESTING_MAP.md +95 -0
  58. package/templates/base/context/WORKFLOW_INDEX.md +129 -129
  59. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
  60. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
  61. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
  62. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
  63. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
  64. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
  65. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
  66. package/templates/base/knowledge/README.md +98 -98
  67. package/templates/base/knowledge/sessions/README.md +88 -88
  68. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
  69. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
  70. package/templates/base/knowledge/shared/decisions/README.md +49 -49
  71. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
  72. package/templates/base/knowledge/shared/patterns/README.md +62 -62
  73. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
  74. package/templates/base/plans/PLAN_TEMPLATE.md +250 -250
  75. package/templates/base/research/RESEARCH_TEMPLATE.md +153 -153
  76. package/templates/base/schemas/agent.schema.json +141 -141
  77. package/templates/base/schemas/anchors.schema.json +54 -0
  78. package/templates/base/schemas/automation.schema.json +93 -0
  79. package/templates/base/schemas/command.schema.json +134 -134
  80. package/templates/base/schemas/hashes.schema.json +40 -0
  81. package/templates/base/schemas/manifest.schema.json +117 -117
  82. package/templates/base/schemas/plan.schema.json +136 -136
  83. package/templates/base/schemas/research.schema.json +115 -115
  84. package/templates/base/schemas/roles.schema.json +34 -0
  85. package/templates/base/schemas/session.schema.json +77 -0
  86. package/templates/base/schemas/settings.schema.json +244 -244
  87. package/templates/base/schemas/staleness.schema.json +53 -0
  88. package/templates/base/schemas/team-config.schema.json +42 -0
  89. package/templates/base/schemas/workflow.schema.json +126 -126
  90. package/templates/base/session/checkpoints/.gitkeep +2 -0
  91. package/templates/base/session/current/state.json +20 -0
  92. package/templates/base/session/history/.gitkeep +2 -0
  93. package/templates/base/settings.json +3 -57
  94. package/templates/base/standards/COMPATIBILITY.md +219 -219
  95. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
  96. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
  97. package/templates/base/standards/README.md +66 -66
  98. package/templates/base/sync/anchors.json +6 -0
  99. package/templates/base/sync/hashes.json +6 -0
  100. package/templates/base/sync/staleness.json +10 -0
  101. package/templates/base/team/README.md +168 -168
  102. package/templates/base/team/config.json +79 -79
  103. package/templates/base/team/roles.json +145 -145
  104. package/templates/base/tools/bin/claude-context.js +151 -151
  105. package/templates/base/tools/lib/anchor-resolver.js +276 -0
  106. package/templates/base/tools/lib/config-loader.js +363 -363
  107. package/templates/base/tools/lib/detector.js +350 -350
  108. package/templates/base/tools/lib/diagnose.js +206 -206
  109. package/templates/base/tools/lib/drift-detector.js +373 -0
  110. package/templates/base/tools/lib/errors.js +199 -199
  111. package/templates/base/tools/lib/index.js +36 -24
  112. package/templates/base/tools/lib/init.js +192 -192
  113. package/templates/base/tools/lib/logger.js +230 -230
  114. package/templates/base/tools/lib/placeholder.js +201 -201
  115. package/templates/base/tools/lib/session-manager.js +354 -0
  116. package/templates/base/tools/lib/validate.js +521 -521
  117. package/templates/base/tools/package.json +49 -49
@@ -1,350 +1,350 @@
1
- /**
2
- * Claude Context Engineering - Tech Stack Detector
3
- *
4
- * Auto-detects technology stack from project files.
5
- */
6
-
7
- const fs = require('fs');
8
- const path = require('path');
9
- const { glob } = require('glob');
10
-
11
- /**
12
- * Tech stack detection signatures
13
- */
14
- const TECH_SIGNATURES = {
15
- // Languages
16
- languages: {
17
- python: {
18
- files: ['requirements.txt', 'pyproject.toml', 'setup.py', 'Pipfile', 'poetry.lock'],
19
- extensions: ['.py'],
20
- },
21
- javascript: {
22
- files: ['package.json', 'yarn.lock', 'pnpm-lock.yaml'],
23
- extensions: ['.js', '.mjs', '.cjs'],
24
- },
25
- typescript: {
26
- files: ['tsconfig.json'],
27
- extensions: ['.ts', '.tsx'],
28
- },
29
- go: {
30
- files: ['go.mod', 'go.sum'],
31
- extensions: ['.go'],
32
- },
33
- rust: {
34
- files: ['Cargo.toml', 'Cargo.lock'],
35
- extensions: ['.rs'],
36
- },
37
- java: {
38
- files: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
39
- extensions: ['.java'],
40
- },
41
- csharp: {
42
- files: ['*.csproj', '*.sln'],
43
- extensions: ['.cs'],
44
- },
45
- ruby: {
46
- files: ['Gemfile', 'Gemfile.lock'],
47
- extensions: ['.rb'],
48
- },
49
- php: {
50
- files: ['composer.json', 'composer.lock'],
51
- extensions: ['.php'],
52
- },
53
- },
54
-
55
- // Frameworks
56
- frameworks: {
57
- // Python
58
- fastapi: {
59
- language: 'python',
60
- patterns: ['fastapi', 'FastAPI', '@router', 'APIRouter'],
61
- files: [],
62
- },
63
- django: {
64
- language: 'python',
65
- patterns: ['django.conf', 'INSTALLED_APPS', 'from django'],
66
- files: ['manage.py'],
67
- },
68
- flask: {
69
- language: 'python',
70
- patterns: ['Flask(__name__)', '@app.route', 'from flask'],
71
- files: [],
72
- },
73
-
74
- // JavaScript/TypeScript
75
- react: {
76
- language: 'javascript',
77
- patterns: ['react', 'React', 'useState', 'useEffect'],
78
- packageDeps: ['react', 'react-dom'],
79
- },
80
- nextjs: {
81
- language: 'javascript',
82
- patterns: ['next/'],
83
- files: ['next.config.js', 'next.config.mjs'],
84
- packageDeps: ['next'],
85
- },
86
- express: {
87
- language: 'javascript',
88
- patterns: ['express()', 'app.use', 'app.get', 'router.'],
89
- packageDeps: ['express'],
90
- },
91
- nestjs: {
92
- language: 'typescript',
93
- patterns: ['@nestjs/', '@Controller', '@Injectable'],
94
- packageDeps: ['@nestjs/core'],
95
- },
96
- vue: {
97
- language: 'javascript',
98
- patterns: ['<template>', 'Vue.'],
99
- packageDeps: ['vue'],
100
- },
101
-
102
- // Go
103
- gin: {
104
- language: 'go',
105
- patterns: ['gin.', 'gin-gonic'],
106
- files: [],
107
- },
108
- echo: {
109
- language: 'go',
110
- patterns: ['echo.', 'labstack/echo'],
111
- files: [],
112
- },
113
-
114
- // Ruby
115
- rails: {
116
- language: 'ruby',
117
- patterns: ['Rails.application', 'ActionController', 'ActiveRecord'],
118
- files: ['config/routes.rb'],
119
- },
120
-
121
- // Rust
122
- actix: {
123
- language: 'rust',
124
- patterns: ['actix_web', 'actix-web'],
125
- files: [],
126
- },
127
- axum: {
128
- language: 'rust',
129
- patterns: ['axum::'],
130
- files: [],
131
- },
132
- },
133
-
134
- // Databases
135
- databases: {
136
- postgresql: {
137
- patterns: ['postgresql', 'postgres', 'psycopg', 'pg'],
138
- envVars: ['DATABASE_URL', 'POSTGRES_'],
139
- },
140
- mysql: {
141
- patterns: ['mysql', 'mariadb'],
142
- envVars: ['MYSQL_'],
143
- },
144
- mongodb: {
145
- patterns: ['mongodb', 'mongoose', 'pymongo'],
146
- envVars: ['MONGO_'],
147
- },
148
- redis: {
149
- patterns: ['redis', 'ioredis'],
150
- envVars: ['REDIS_'],
151
- },
152
- sqlite: {
153
- patterns: ['sqlite', 'sqlite3'],
154
- files: ['*.db', '*.sqlite'],
155
- },
156
- },
157
- };
158
-
159
- /**
160
- * Detect technology stack
161
- */
162
- async function detectTechStack(projectRoot, options = {}) {
163
- const { hint = null } = options;
164
-
165
- const result = {
166
- stack: '',
167
- languages: [],
168
- frameworks: [],
169
- databases: [],
170
- projectName: path.basename(projectRoot),
171
- fileCount: 0,
172
- loc: 0,
173
- };
174
-
175
- // If hint provided, use it
176
- if (hint) {
177
- result.stack = hint;
178
- return result;
179
- }
180
-
181
- // Detect languages
182
- for (const [lang, signature] of Object.entries(TECH_SIGNATURES.languages)) {
183
- // Check for signature files
184
- for (const sigFile of signature.files) {
185
- if (fs.existsSync(path.join(projectRoot, sigFile))) {
186
- if (!result.languages.includes(lang)) {
187
- result.languages.push(lang);
188
- }
189
- break;
190
- }
191
- }
192
-
193
- // Check for file extensions
194
- if (signature.extensions) {
195
- for (const ext of signature.extensions) {
196
- const files = await glob(`**/*${ext}`, {
197
- cwd: projectRoot,
198
- ignore: ['node_modules/**', 'vendor/**', '.git/**', 'dist/**', 'build/**'],
199
- nodir: true,
200
- });
201
-
202
- if (files.length > 0) {
203
- if (!result.languages.includes(lang)) {
204
- result.languages.push(lang);
205
- }
206
- result.fileCount += files.length;
207
- break;
208
- }
209
- }
210
- }
211
- }
212
-
213
- // Detect frameworks
214
- for (const [framework, signature] of Object.entries(TECH_SIGNATURES.frameworks)) {
215
- // Check for package.json dependencies
216
- if (signature.packageDeps) {
217
- const pkgPath = path.join(projectRoot, 'package.json');
218
- if (fs.existsSync(pkgPath)) {
219
- try {
220
- const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
221
- const allDeps = {
222
- ...pkg.dependencies,
223
- ...pkg.devDependencies,
224
- };
225
-
226
- for (const dep of signature.packageDeps) {
227
- if (allDeps[dep]) {
228
- if (!result.frameworks.includes(framework)) {
229
- result.frameworks.push(framework);
230
- }
231
- break;
232
- }
233
- }
234
- } catch {
235
- // Ignore JSON parse errors
236
- }
237
- }
238
- }
239
-
240
- // Check for signature files
241
- if (signature.files) {
242
- for (const sigFile of signature.files) {
243
- if (fs.existsSync(path.join(projectRoot, sigFile))) {
244
- if (!result.frameworks.includes(framework)) {
245
- result.frameworks.push(framework);
246
- }
247
- break;
248
- }
249
- }
250
- }
251
-
252
- // Check for patterns in source files (sample)
253
- if (signature.patterns && result.languages.includes(signature.language)) {
254
- // Sample a few source files
255
- const ext = TECH_SIGNATURES.languages[signature.language]?.extensions?.[0];
256
- if (ext) {
257
- const sampleFiles = await glob(`**/*${ext}`, {
258
- cwd: projectRoot,
259
- ignore: ['node_modules/**', 'vendor/**', '.git/**'],
260
- nodir: true,
261
- });
262
-
263
- // Check first 5 files
264
- for (const file of sampleFiles.slice(0, 5)) {
265
- const content = fs.readFileSync(path.join(projectRoot, file), 'utf8');
266
-
267
- for (const pattern of signature.patterns) {
268
- if (content.includes(pattern)) {
269
- if (!result.frameworks.includes(framework)) {
270
- result.frameworks.push(framework);
271
- }
272
- break;
273
- }
274
- }
275
- }
276
- }
277
- }
278
- }
279
-
280
- // Detect databases
281
- for (const [db, signature] of Object.entries(TECH_SIGNATURES.databases)) {
282
- // Check environment files
283
- const envFiles = ['.env', '.env.example', '.env.local'];
284
- for (const envFile of envFiles) {
285
- const envPath = path.join(projectRoot, envFile);
286
- if (fs.existsSync(envPath)) {
287
- const content = fs.readFileSync(envPath, 'utf8');
288
-
289
- if (signature.envVars) {
290
- for (const envVar of signature.envVars) {
291
- if (content.includes(envVar)) {
292
- if (!result.databases.includes(db)) {
293
- result.databases.push(db);
294
- }
295
- break;
296
- }
297
- }
298
- }
299
- }
300
- }
301
-
302
- // Check for patterns in config files
303
- if (signature.patterns) {
304
- const configFiles = ['package.json', 'requirements.txt', 'pyproject.toml', 'Cargo.toml'];
305
- for (const configFile of configFiles) {
306
- const configPath = path.join(projectRoot, configFile);
307
- if (fs.existsSync(configPath)) {
308
- const content = fs.readFileSync(configPath, 'utf8').toLowerCase();
309
-
310
- for (const pattern of signature.patterns) {
311
- if (content.includes(pattern.toLowerCase())) {
312
- if (!result.databases.includes(db)) {
313
- result.databases.push(db);
314
- }
315
- break;
316
- }
317
- }
318
- }
319
- }
320
- }
321
- }
322
-
323
- // Build stack string
324
- const stackParts = [];
325
- if (result.languages.length > 0) {
326
- stackParts.push(result.languages.map(l => capitalize(l)).join(', '));
327
- }
328
- if (result.frameworks.length > 0) {
329
- stackParts.push(result.frameworks.map(f => capitalize(f)).join(', '));
330
- }
331
- if (result.databases.length > 0) {
332
- stackParts.push(result.databases.map(d => capitalize(d)).join(', '));
333
- }
334
-
335
- result.stack = stackParts.join(' + ') || 'Unknown';
336
-
337
- return result;
338
- }
339
-
340
- /**
341
- * Capitalize first letter
342
- */
343
- function capitalize(str) {
344
- return str.charAt(0).toUpperCase() + str.slice(1);
345
- }
346
-
347
- module.exports = {
348
- detectTechStack,
349
- TECH_SIGNATURES,
350
- };
1
+ /**
2
+ * Claude Context Engineering - Tech Stack Detector
3
+ *
4
+ * Auto-detects technology stack from project files.
5
+ */
6
+
7
+ const fs = require('fs');
8
+ const path = require('path');
9
+ const { glob } = require('glob');
10
+
11
+ /**
12
+ * Tech stack detection signatures
13
+ */
14
+ const TECH_SIGNATURES = {
15
+ // Languages
16
+ languages: {
17
+ python: {
18
+ files: ['requirements.txt', 'pyproject.toml', 'setup.py', 'Pipfile', 'poetry.lock'],
19
+ extensions: ['.py'],
20
+ },
21
+ javascript: {
22
+ files: ['package.json', 'yarn.lock', 'pnpm-lock.yaml'],
23
+ extensions: ['.js', '.mjs', '.cjs'],
24
+ },
25
+ typescript: {
26
+ files: ['tsconfig.json'],
27
+ extensions: ['.ts', '.tsx'],
28
+ },
29
+ go: {
30
+ files: ['go.mod', 'go.sum'],
31
+ extensions: ['.go'],
32
+ },
33
+ rust: {
34
+ files: ['Cargo.toml', 'Cargo.lock'],
35
+ extensions: ['.rs'],
36
+ },
37
+ java: {
38
+ files: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
39
+ extensions: ['.java'],
40
+ },
41
+ csharp: {
42
+ files: ['*.csproj', '*.sln'],
43
+ extensions: ['.cs'],
44
+ },
45
+ ruby: {
46
+ files: ['Gemfile', 'Gemfile.lock'],
47
+ extensions: ['.rb'],
48
+ },
49
+ php: {
50
+ files: ['composer.json', 'composer.lock'],
51
+ extensions: ['.php'],
52
+ },
53
+ },
54
+
55
+ // Frameworks
56
+ frameworks: {
57
+ // Python
58
+ fastapi: {
59
+ language: 'python',
60
+ patterns: ['fastapi', 'FastAPI', '@router', 'APIRouter'],
61
+ files: [],
62
+ },
63
+ django: {
64
+ language: 'python',
65
+ patterns: ['django.conf', 'INSTALLED_APPS', 'from django'],
66
+ files: ['manage.py'],
67
+ },
68
+ flask: {
69
+ language: 'python',
70
+ patterns: ['Flask(__name__)', '@app.route', 'from flask'],
71
+ files: [],
72
+ },
73
+
74
+ // JavaScript/TypeScript
75
+ react: {
76
+ language: 'javascript',
77
+ patterns: ['react', 'React', 'useState', 'useEffect'],
78
+ packageDeps: ['react', 'react-dom'],
79
+ },
80
+ nextjs: {
81
+ language: 'javascript',
82
+ patterns: ['next/'],
83
+ files: ['next.config.js', 'next.config.mjs'],
84
+ packageDeps: ['next'],
85
+ },
86
+ express: {
87
+ language: 'javascript',
88
+ patterns: ['express()', 'app.use', 'app.get', 'router.'],
89
+ packageDeps: ['express'],
90
+ },
91
+ nestjs: {
92
+ language: 'typescript',
93
+ patterns: ['@nestjs/', '@Controller', '@Injectable'],
94
+ packageDeps: ['@nestjs/core'],
95
+ },
96
+ vue: {
97
+ language: 'javascript',
98
+ patterns: ['<template>', 'Vue.'],
99
+ packageDeps: ['vue'],
100
+ },
101
+
102
+ // Go
103
+ gin: {
104
+ language: 'go',
105
+ patterns: ['gin.', 'gin-gonic'],
106
+ files: [],
107
+ },
108
+ echo: {
109
+ language: 'go',
110
+ patterns: ['echo.', 'labstack/echo'],
111
+ files: [],
112
+ },
113
+
114
+ // Ruby
115
+ rails: {
116
+ language: 'ruby',
117
+ patterns: ['Rails.application', 'ActionController', 'ActiveRecord'],
118
+ files: ['config/routes.rb'],
119
+ },
120
+
121
+ // Rust
122
+ actix: {
123
+ language: 'rust',
124
+ patterns: ['actix_web', 'actix-web'],
125
+ files: [],
126
+ },
127
+ axum: {
128
+ language: 'rust',
129
+ patterns: ['axum::'],
130
+ files: [],
131
+ },
132
+ },
133
+
134
+ // Databases
135
+ databases: {
136
+ postgresql: {
137
+ patterns: ['postgresql', 'postgres', 'psycopg', 'pg'],
138
+ envVars: ['DATABASE_URL', 'POSTGRES_'],
139
+ },
140
+ mysql: {
141
+ patterns: ['mysql', 'mariadb'],
142
+ envVars: ['MYSQL_'],
143
+ },
144
+ mongodb: {
145
+ patterns: ['mongodb', 'mongoose', 'pymongo'],
146
+ envVars: ['MONGO_'],
147
+ },
148
+ redis: {
149
+ patterns: ['redis', 'ioredis'],
150
+ envVars: ['REDIS_'],
151
+ },
152
+ sqlite: {
153
+ patterns: ['sqlite', 'sqlite3'],
154
+ files: ['*.db', '*.sqlite'],
155
+ },
156
+ },
157
+ };
158
+
159
+ /**
160
+ * Detect technology stack
161
+ */
162
+ async function detectTechStack(projectRoot, options = {}) {
163
+ const { hint = null } = options;
164
+
165
+ const result = {
166
+ stack: '',
167
+ languages: [],
168
+ frameworks: [],
169
+ databases: [],
170
+ projectName: path.basename(projectRoot),
171
+ fileCount: 0,
172
+ loc: 0,
173
+ };
174
+
175
+ // If hint provided, use it
176
+ if (hint) {
177
+ result.stack = hint;
178
+ return result;
179
+ }
180
+
181
+ // Detect languages
182
+ for (const [lang, signature] of Object.entries(TECH_SIGNATURES.languages)) {
183
+ // Check for signature files
184
+ for (const sigFile of signature.files) {
185
+ if (fs.existsSync(path.join(projectRoot, sigFile))) {
186
+ if (!result.languages.includes(lang)) {
187
+ result.languages.push(lang);
188
+ }
189
+ break;
190
+ }
191
+ }
192
+
193
+ // Check for file extensions
194
+ if (signature.extensions) {
195
+ for (const ext of signature.extensions) {
196
+ const files = await glob(`**/*${ext}`, {
197
+ cwd: projectRoot,
198
+ ignore: ['node_modules/**', 'vendor/**', '.git/**', 'dist/**', 'build/**'],
199
+ nodir: true,
200
+ });
201
+
202
+ if (files.length > 0) {
203
+ if (!result.languages.includes(lang)) {
204
+ result.languages.push(lang);
205
+ }
206
+ result.fileCount += files.length;
207
+ break;
208
+ }
209
+ }
210
+ }
211
+ }
212
+
213
+ // Detect frameworks
214
+ for (const [framework, signature] of Object.entries(TECH_SIGNATURES.frameworks)) {
215
+ // Check for package.json dependencies
216
+ if (signature.packageDeps) {
217
+ const pkgPath = path.join(projectRoot, 'package.json');
218
+ if (fs.existsSync(pkgPath)) {
219
+ try {
220
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
221
+ const allDeps = {
222
+ ...pkg.dependencies,
223
+ ...pkg.devDependencies,
224
+ };
225
+
226
+ for (const dep of signature.packageDeps) {
227
+ if (allDeps[dep]) {
228
+ if (!result.frameworks.includes(framework)) {
229
+ result.frameworks.push(framework);
230
+ }
231
+ break;
232
+ }
233
+ }
234
+ } catch {
235
+ // Ignore JSON parse errors
236
+ }
237
+ }
238
+ }
239
+
240
+ // Check for signature files
241
+ if (signature.files) {
242
+ for (const sigFile of signature.files) {
243
+ if (fs.existsSync(path.join(projectRoot, sigFile))) {
244
+ if (!result.frameworks.includes(framework)) {
245
+ result.frameworks.push(framework);
246
+ }
247
+ break;
248
+ }
249
+ }
250
+ }
251
+
252
+ // Check for patterns in source files (sample)
253
+ if (signature.patterns && result.languages.includes(signature.language)) {
254
+ // Sample a few source files
255
+ const ext = TECH_SIGNATURES.languages[signature.language]?.extensions?.[0];
256
+ if (ext) {
257
+ const sampleFiles = await glob(`**/*${ext}`, {
258
+ cwd: projectRoot,
259
+ ignore: ['node_modules/**', 'vendor/**', '.git/**'],
260
+ nodir: true,
261
+ });
262
+
263
+ // Check first 5 files
264
+ for (const file of sampleFiles.slice(0, 5)) {
265
+ const content = fs.readFileSync(path.join(projectRoot, file), 'utf8');
266
+
267
+ for (const pattern of signature.patterns) {
268
+ if (content.includes(pattern)) {
269
+ if (!result.frameworks.includes(framework)) {
270
+ result.frameworks.push(framework);
271
+ }
272
+ break;
273
+ }
274
+ }
275
+ }
276
+ }
277
+ }
278
+ }
279
+
280
+ // Detect databases
281
+ for (const [db, signature] of Object.entries(TECH_SIGNATURES.databases)) {
282
+ // Check environment files
283
+ const envFiles = ['.env', '.env.example', '.env.local'];
284
+ for (const envFile of envFiles) {
285
+ const envPath = path.join(projectRoot, envFile);
286
+ if (fs.existsSync(envPath)) {
287
+ const content = fs.readFileSync(envPath, 'utf8');
288
+
289
+ if (signature.envVars) {
290
+ for (const envVar of signature.envVars) {
291
+ if (content.includes(envVar)) {
292
+ if (!result.databases.includes(db)) {
293
+ result.databases.push(db);
294
+ }
295
+ break;
296
+ }
297
+ }
298
+ }
299
+ }
300
+ }
301
+
302
+ // Check for patterns in config files
303
+ if (signature.patterns) {
304
+ const configFiles = ['package.json', 'requirements.txt', 'pyproject.toml', 'Cargo.toml'];
305
+ for (const configFile of configFiles) {
306
+ const configPath = path.join(projectRoot, configFile);
307
+ if (fs.existsSync(configPath)) {
308
+ const content = fs.readFileSync(configPath, 'utf8').toLowerCase();
309
+
310
+ for (const pattern of signature.patterns) {
311
+ if (content.includes(pattern.toLowerCase())) {
312
+ if (!result.databases.includes(db)) {
313
+ result.databases.push(db);
314
+ }
315
+ break;
316
+ }
317
+ }
318
+ }
319
+ }
320
+ }
321
+ }
322
+
323
+ // Build stack string
324
+ const stackParts = [];
325
+ if (result.languages.length > 0) {
326
+ stackParts.push(result.languages.map(l => capitalize(l)).join(', '));
327
+ }
328
+ if (result.frameworks.length > 0) {
329
+ stackParts.push(result.frameworks.map(f => capitalize(f)).join(', '));
330
+ }
331
+ if (result.databases.length > 0) {
332
+ stackParts.push(result.databases.map(d => capitalize(d)).join(', '));
333
+ }
334
+
335
+ result.stack = stackParts.join(' + ') || 'Unknown';
336
+
337
+ return result;
338
+ }
339
+
340
+ /**
341
+ * Capitalize first letter
342
+ */
343
+ function capitalize(str) {
344
+ return str.charAt(0).toUpperCase() + str.slice(1);
345
+ }
346
+
347
+ module.exports = {
348
+ detectTechStack,
349
+ TECH_SIGNATURES,
350
+ };