create-universal-ai-context 2.5.0 → 2.6.0-final

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 (153) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +331 -294
  3. package/bin/create-ai-context.js +1507 -775
  4. package/lib/adapters/aider.js +131 -131
  5. package/lib/adapters/antigravity.js +205 -205
  6. package/lib/adapters/claude.js +397 -397
  7. package/lib/adapters/cline.js +125 -125
  8. package/lib/adapters/continue.js +138 -138
  9. package/lib/adapters/copilot.js +131 -131
  10. package/lib/adapters/index.js +78 -78
  11. package/lib/adapters/windsurf.js +138 -138
  12. package/lib/ai-context-generator.js +234 -234
  13. package/lib/ai-orchestrator.js +432 -432
  14. package/lib/call-tracer.js +444 -444
  15. package/lib/content-preservation.js +243 -243
  16. package/lib/cross-tool-sync/file-watcher.js +274 -274
  17. package/lib/cross-tool-sync/index.js +41 -40
  18. package/lib/cross-tool-sync/sync-manager.js +540 -512
  19. package/lib/cross-tool-sync/sync-service.js +297 -297
  20. package/lib/detector.js +726 -726
  21. package/lib/doc-discovery.js +741 -741
  22. package/lib/drift-checker.js +920 -920
  23. package/lib/environment-detector.js +239 -239
  24. package/lib/index.js +399 -399
  25. package/lib/install-hooks.js +82 -82
  26. package/lib/installer.js +419 -419
  27. package/lib/migrate.js +328 -328
  28. package/lib/placeholder.js +632 -632
  29. package/lib/prompts.js +341 -341
  30. package/lib/smart-merge.js +540 -540
  31. package/lib/spinner.js +60 -60
  32. package/lib/static-analyzer.js +729 -729
  33. package/lib/template-coordination.js +148 -148
  34. package/lib/template-populator.js +843 -843
  35. package/lib/template-renderer.js +392 -392
  36. package/lib/utils/fs-wrapper.js +79 -79
  37. package/lib/utils/path-utils.js +60 -60
  38. package/lib/validate.js +155 -155
  39. package/package.json +1 -1
  40. package/templates/AI_CONTEXT.md.template +245 -245
  41. package/templates/base/README.md +260 -257
  42. package/templates/base/RPI_WORKFLOW_PLAN.md +325 -320
  43. package/templates/base/agents/api-developer.md +76 -76
  44. package/templates/base/agents/context-engineer.md +525 -525
  45. package/templates/base/agents/core-architect.md +76 -76
  46. package/templates/base/agents/database-ops.md +76 -76
  47. package/templates/base/agents/deployment-ops.md +76 -76
  48. package/templates/base/agents/integration-hub.md +76 -76
  49. package/templates/base/analytics/README.md +114 -114
  50. package/templates/base/automation/config.json +58 -58
  51. package/templates/base/automation/generators/code-mapper.js +308 -308
  52. package/templates/base/automation/generators/index-builder.js +321 -321
  53. package/templates/base/automation/hooks/post-commit.sh +83 -83
  54. package/templates/base/automation/hooks/pre-commit.sh +103 -103
  55. package/templates/base/ci-templates/README.md +108 -108
  56. package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
  57. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
  58. package/templates/base/commands/analytics.md +238 -238
  59. package/templates/base/commands/auto-sync.md +172 -172
  60. package/templates/base/commands/collab.md +194 -194
  61. package/templates/base/commands/context-optimize.md +226 -0
  62. package/templates/base/commands/help.md +485 -450
  63. package/templates/base/commands/rpi-implement.md +164 -115
  64. package/templates/base/commands/rpi-plan.md +147 -93
  65. package/templates/base/commands/rpi-research.md +145 -88
  66. package/templates/base/commands/session-resume.md +144 -144
  67. package/templates/base/commands/session-save.md +112 -112
  68. package/templates/base/commands/validate-all.md +77 -77
  69. package/templates/base/commands/verify-docs-current.md +86 -86
  70. package/templates/base/config/base.json +57 -57
  71. package/templates/base/config/environments/development.json +13 -13
  72. package/templates/base/config/environments/production.json +17 -17
  73. package/templates/base/config/environments/staging.json +13 -13
  74. package/templates/base/config/local.json.example +21 -21
  75. package/templates/base/context/.meta/generated-at.json +18 -18
  76. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
  77. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
  78. package/templates/base/context/FILE_OWNERSHIP.md +57 -57
  79. package/templates/base/context/INTEGRATION_POINTS.md +92 -92
  80. package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
  81. package/templates/base/context/TESTING_MAP.md +95 -95
  82. package/templates/base/context/WORKFLOW_INDEX.md +129 -129
  83. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
  84. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
  85. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
  86. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
  87. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
  88. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
  89. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
  90. package/templates/base/knowledge/README.md +98 -98
  91. package/templates/base/knowledge/sessions/README.md +88 -88
  92. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
  93. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
  94. package/templates/base/knowledge/shared/decisions/README.md +49 -49
  95. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
  96. package/templates/base/knowledge/shared/patterns/README.md +62 -62
  97. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
  98. package/templates/base/plans/PLAN_TEMPLATE.md +316 -250
  99. package/templates/base/research/RESEARCH_TEMPLATE.md +245 -153
  100. package/templates/base/schemas/agent.schema.json +141 -141
  101. package/templates/base/schemas/anchors.schema.json +54 -54
  102. package/templates/base/schemas/automation.schema.json +93 -93
  103. package/templates/base/schemas/command.schema.json +134 -134
  104. package/templates/base/schemas/hashes.schema.json +40 -40
  105. package/templates/base/schemas/manifest.schema.json +117 -117
  106. package/templates/base/schemas/plan.schema.json +136 -136
  107. package/templates/base/schemas/research.schema.json +115 -115
  108. package/templates/base/schemas/roles.schema.json +34 -34
  109. package/templates/base/schemas/session.schema.json +77 -77
  110. package/templates/base/schemas/settings.schema.json +244 -244
  111. package/templates/base/schemas/staleness.schema.json +53 -53
  112. package/templates/base/schemas/team-config.schema.json +42 -42
  113. package/templates/base/schemas/workflow.schema.json +126 -126
  114. package/templates/base/session/checkpoints/.gitkeep +2 -2
  115. package/templates/base/session/current/state.json +20 -20
  116. package/templates/base/session/history/.gitkeep +2 -2
  117. package/templates/base/settings.json +3 -3
  118. package/templates/base/standards/COMPATIBILITY.md +219 -219
  119. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
  120. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
  121. package/templates/base/standards/README.md +66 -66
  122. package/templates/base/sync/anchors.json +6 -6
  123. package/templates/base/sync/hashes.json +6 -6
  124. package/templates/base/sync/staleness.json +10 -10
  125. package/templates/base/team/README.md +168 -168
  126. package/templates/base/team/config.json +79 -79
  127. package/templates/base/team/roles.json +145 -145
  128. package/templates/base/tools/bin/claude-context.js +151 -151
  129. package/templates/base/tools/lib/anchor-resolver.js +276 -276
  130. package/templates/base/tools/lib/config-loader.js +363 -363
  131. package/templates/base/tools/lib/detector.js +350 -350
  132. package/templates/base/tools/lib/diagnose.js +206 -206
  133. package/templates/base/tools/lib/drift-detector.js +373 -373
  134. package/templates/base/tools/lib/errors.js +199 -199
  135. package/templates/base/tools/lib/index.js +36 -36
  136. package/templates/base/tools/lib/init.js +192 -192
  137. package/templates/base/tools/lib/logger.js +230 -230
  138. package/templates/base/tools/lib/placeholder.js +201 -201
  139. package/templates/base/tools/lib/session-manager.js +354 -354
  140. package/templates/base/tools/lib/validate.js +521 -521
  141. package/templates/base/tools/package.json +49 -49
  142. package/templates/handlebars/aider-config.hbs +146 -80
  143. package/templates/handlebars/antigravity.hbs +377 -377
  144. package/templates/handlebars/claude.hbs +183 -183
  145. package/templates/handlebars/cline.hbs +62 -62
  146. package/templates/handlebars/continue-config.hbs +116 -116
  147. package/templates/handlebars/copilot.hbs +130 -130
  148. package/templates/handlebars/partials/gotcha-list.hbs +11 -11
  149. package/templates/handlebars/partials/header.hbs +3 -3
  150. package/templates/handlebars/partials/workflow-summary.hbs +16 -16
  151. package/templates/handlebars/windsurf-rules.hbs +69 -69
  152. package/templates/hooks/post-commit.hbs +28 -29
  153. package/templates/hooks/pre-commit.hbs +46 -46
package/lib/prompts.js CHANGED
@@ -1,341 +1,341 @@
1
- /**
2
- * Interactive prompts for create-universal-ai-context
3
- *
4
- * Uses enquirer for beautiful, user-friendly prompts
5
- */
6
-
7
- const { prompt } = require('enquirer');
8
- const path = require('path');
9
- const chalk = require('chalk');
10
- const { detectTechStack } = require('./detector');
11
-
12
- // Available tech stack presets
13
- const PRESETS = {
14
- 'python-fastapi': {
15
- name: 'Python + FastAPI + PostgreSQL',
16
- stack: 'Python, FastAPI, PostgreSQL',
17
- commands: {
18
- install: 'pip install -r requirements.txt',
19
- dev: 'uvicorn main:app --reload',
20
- test: 'pytest',
21
- migrate: 'alembic upgrade head'
22
- }
23
- },
24
- 'node-express': {
25
- name: 'Node.js + Express + MongoDB',
26
- stack: 'Node.js, Express, MongoDB',
27
- commands: {
28
- install: 'npm install',
29
- dev: 'npm run dev',
30
- test: 'npm test',
31
- migrate: 'npm run migrate'
32
- }
33
- },
34
- 'typescript-nextjs': {
35
- name: 'TypeScript + Next.js + Prisma',
36
- stack: 'TypeScript, Next.js, Prisma, PostgreSQL',
37
- commands: {
38
- install: 'npm install',
39
- dev: 'npm run dev',
40
- test: 'npm test',
41
- migrate: 'npx prisma migrate dev'
42
- }
43
- },
44
- 'go-gin': {
45
- name: 'Go + Gin + PostgreSQL',
46
- stack: 'Go, Gin, PostgreSQL',
47
- commands: {
48
- install: 'go mod download',
49
- dev: 'go run main.go',
50
- test: 'go test ./...',
51
- migrate: 'migrate -path migrations -database $DATABASE_URL up'
52
- }
53
- },
54
- 'rust-actix': {
55
- name: 'Rust + Actix + SQLx',
56
- stack: 'Rust, Actix-web, SQLx, PostgreSQL',
57
- commands: {
58
- install: 'cargo build',
59
- dev: 'cargo run',
60
- test: 'cargo test',
61
- migrate: 'sqlx migrate run'
62
- }
63
- },
64
- 'ruby-rails': {
65
- name: 'Ruby + Rails + PostgreSQL',
66
- stack: 'Ruby, Rails, PostgreSQL',
67
- commands: {
68
- install: 'bundle install',
69
- dev: 'rails server',
70
- test: 'rails test',
71
- migrate: 'rails db:migrate'
72
- }
73
- },
74
- 'python-django': {
75
- name: 'Python + Django + PostgreSQL',
76
- stack: 'Python, Django, PostgreSQL',
77
- commands: {
78
- install: 'pip install -r requirements.txt',
79
- dev: 'python manage.py runserver',
80
- test: 'python manage.py test',
81
- migrate: 'python manage.py migrate'
82
- }
83
- },
84
- 'node-nestjs': {
85
- name: 'Node.js + NestJS + TypeORM',
86
- stack: 'Node.js, NestJS, TypeORM, PostgreSQL',
87
- commands: {
88
- install: 'npm install',
89
- dev: 'npm run start:dev',
90
- test: 'npm run test',
91
- migrate: 'npm run migration:run'
92
- }
93
- },
94
- 'typescript-remix': {
95
- name: 'TypeScript + Remix + Prisma',
96
- stack: 'TypeScript, Remix, Prisma, PostgreSQL',
97
- commands: {
98
- install: 'npm install',
99
- dev: 'npm run dev',
100
- test: 'npm test',
101
- migrate: 'npx prisma migrate dev'
102
- }
103
- },
104
- 'java-spring': {
105
- name: 'Java + Spring Boot + PostgreSQL',
106
- stack: 'Java, Spring Boot, PostgreSQL',
107
- commands: {
108
- install: 'mvn install',
109
- dev: 'mvn spring-boot:run',
110
- test: 'mvn test',
111
- migrate: 'mvn flyway:migrate'
112
- }
113
- },
114
- 'csharp-dotnet': {
115
- name: 'C# + .NET Core + Entity Framework',
116
- stack: 'C#, .NET Core, Entity Framework, PostgreSQL',
117
- commands: {
118
- install: 'dotnet restore',
119
- dev: 'dotnet run',
120
- test: 'dotnet test',
121
- migrate: 'dotnet ef database update'
122
- }
123
- },
124
- 'php-laravel': {
125
- name: 'PHP + Laravel + MySQL',
126
- stack: 'PHP, Laravel, MySQL',
127
- commands: {
128
- install: 'composer install',
129
- dev: 'php artisan serve',
130
- test: 'php artisan test',
131
- migrate: 'php artisan migrate'
132
- }
133
- }
134
- };
135
-
136
- /**
137
- * Run interactive prompts
138
- */
139
- async function runPrompts(targetDir, presetName = null) {
140
- // Detect tech stack for auto-suggestion
141
- const detected = await detectTechStack(targetDir);
142
-
143
- console.log(chalk.gray('\nLet\'s set up context engineering for your project.\n'));
144
-
145
- const answers = await prompt([
146
- {
147
- type: 'input',
148
- name: 'projectName',
149
- message: 'Project name:',
150
- initial: path.basename(targetDir),
151
- validate: (value) => {
152
- if (!value.trim()) return 'Project name is required';
153
- if (!/^[a-zA-Z0-9_-]+$/.test(value)) {
154
- return 'Project name can only contain letters, numbers, hyphens, and underscores';
155
- }
156
- return true;
157
- }
158
- },
159
- {
160
- type: 'select',
161
- name: 'techStackChoice',
162
- message: 'Technology stack:',
163
- choices: [
164
- {
165
- name: 'auto',
166
- message: detected.summary
167
- ? `Confirm: ${detected.summary}`
168
- : 'Auto-detect from project files'
169
- },
170
- { name: 'preset', message: 'Select from presets' },
171
- { name: 'manual', message: 'Enter manually' },
172
- { name: 'skip', message: 'Skip (use generic template)' }
173
- ],
174
- initial: 0
175
- },
176
- {
177
- type: 'select',
178
- name: 'preset',
179
- message: 'Select a tech stack preset:',
180
- choices: Object.entries(PRESETS).map(([key, value]) => ({
181
- name: key,
182
- message: value.name
183
- })),
184
- skip() {
185
- return this.state.answers.techStackChoice !== 'preset';
186
- }
187
- },
188
- {
189
- type: 'input',
190
- name: 'manualStack',
191
- message: 'Enter your tech stack (e.g., "Python, Django, PostgreSQL"):',
192
- skip() {
193
- return this.state.answers.techStackChoice !== 'manual';
194
- }
195
- },
196
- {
197
- type: 'multiselect',
198
- name: 'features',
199
- message: 'Features to include:',
200
- choices: [
201
- { name: 'rpi', message: 'RPI Workflow (Research-Plan-Implement)', value: true },
202
- { name: 'agents', message: 'Specialized Agents (6 agents)', value: true },
203
- { name: 'validation', message: 'Validation Commands', value: true },
204
- { name: 'ci', message: 'CI/CD Templates', value: false },
205
- { name: 'team', message: 'Team Collaboration', value: false },
206
- { name: 'analytics', message: 'Analytics Dashboard', value: false }
207
- ],
208
- initial: ['rpi', 'agents', 'validation']
209
- },
210
- {
211
- type: 'confirm',
212
- name: 'installPlugin',
213
- message: 'Install Claude Code plugin for ongoing commands?',
214
- initial: true
215
- }
216
- ]);
217
-
218
- // Process tech stack choice
219
- let techStack = detected;
220
- if (answers.techStackChoice === 'preset' && answers.preset) {
221
- const preset = PRESETS[answers.preset];
222
- techStack = {
223
- ...techStack,
224
- summary: preset.stack,
225
- preset: answers.preset,
226
- commands: preset.commands
227
- };
228
- } else if (answers.techStackChoice === 'manual' && answers.manualStack) {
229
- techStack = {
230
- ...techStack,
231
- summary: answers.manualStack,
232
- preset: null
233
- };
234
- }
235
-
236
- return {
237
- projectName: answers.projectName,
238
- techStack,
239
- features: {
240
- rpi: answers.features.includes('rpi'),
241
- agents: answers.features.includes('agents'),
242
- validation: answers.features.includes('validation'),
243
- ci: answers.features.includes('ci'),
244
- team: answers.features.includes('team'),
245
- analytics: answers.features.includes('analytics')
246
- },
247
- installPlugin: answers.installPlugin
248
- };
249
- }
250
-
251
- /**
252
- * Get default configuration (for --yes flag)
253
- */
254
- async function getDefaults(targetDir, presetName = null) {
255
- const detected = await detectTechStack(targetDir);
256
-
257
- let techStack = detected;
258
- if (presetName && PRESETS[presetName]) {
259
- const preset = PRESETS[presetName];
260
- techStack = {
261
- ...techStack,
262
- summary: preset.stack,
263
- preset: presetName,
264
- commands: preset.commands
265
- };
266
- }
267
-
268
- return {
269
- projectName: path.basename(targetDir),
270
- techStack,
271
- features: {
272
- rpi: true,
273
- agents: true,
274
- validation: true,
275
- ci: false,
276
- team: false,
277
- analytics: false
278
- },
279
- installPlugin: true
280
- };
281
- }
282
-
283
- /**
284
- * Run discovery prompts for handling existing documentation
285
- * @param {object} discovery - Discovery results from doc-discovery.js
286
- * @returns {Promise<object>} User's choices for handling existing docs
287
- */
288
- async function runDiscoveryPrompts(discovery) {
289
- if (!discovery || !discovery.hasExistingDocs) {
290
- return { existingDocsStrategy: 'fresh' };
291
- }
292
-
293
- const { generateDiscoveryPrompts } = require('./doc-discovery');
294
- const prompts = generateDiscoveryPrompts(discovery);
295
-
296
- if (prompts.length === 0) {
297
- return { existingDocsStrategy: 'fresh' };
298
- }
299
-
300
- console.log(chalk.gray('\nExisting documentation detected.\n'));
301
-
302
- const answers = await prompt(prompts);
303
-
304
- // Handle conflict resolution if user chose 'ask'
305
- if (answers.conflictResolution === 'ask' && discovery.conflicts.length > 0) {
306
- const conflictResolutions = {};
307
-
308
- for (const conflict of discovery.conflicts) {
309
- const conflictAnswer = await prompt([{
310
- type: 'select',
311
- name: 'resolution',
312
- message: `Conflict for ${chalk.cyan(conflict.key)}:\n Existing (${conflict.existingSource}): "${truncate(conflict.existingValue, 40)}"\n New (${conflict.newSource}): "${truncate(conflict.newValue, 40)}"`,
313
- choices: [
314
- { name: 'existing', message: 'Keep existing value' },
315
- { name: 'new', message: 'Use new value' }
316
- ]
317
- }]);
318
- conflictResolutions[conflict.key] = conflictAnswer.resolution;
319
- }
320
-
321
- answers.conflictResolutions = conflictResolutions;
322
- }
323
-
324
- return answers;
325
- }
326
-
327
- /**
328
- * Truncate a string with ellipsis
329
- */
330
- function truncate(str, maxLength) {
331
- if (!str) return '';
332
- if (str.length <= maxLength) return str;
333
- return str.substring(0, maxLength - 3) + '...';
334
- }
335
-
336
- module.exports = {
337
- runPrompts,
338
- getDefaults,
339
- runDiscoveryPrompts,
340
- PRESETS
341
- };
1
+ /**
2
+ * Interactive prompts for create-universal-ai-context
3
+ *
4
+ * Uses enquirer for beautiful, user-friendly prompts
5
+ */
6
+
7
+ const { prompt } = require('enquirer');
8
+ const path = require('path');
9
+ const chalk = require('chalk');
10
+ const { detectTechStack } = require('./detector');
11
+
12
+ // Available tech stack presets
13
+ const PRESETS = {
14
+ 'python-fastapi': {
15
+ name: 'Python + FastAPI + PostgreSQL',
16
+ stack: 'Python, FastAPI, PostgreSQL',
17
+ commands: {
18
+ install: 'pip install -r requirements.txt',
19
+ dev: 'uvicorn main:app --reload',
20
+ test: 'pytest',
21
+ migrate: 'alembic upgrade head'
22
+ }
23
+ },
24
+ 'node-express': {
25
+ name: 'Node.js + Express + MongoDB',
26
+ stack: 'Node.js, Express, MongoDB',
27
+ commands: {
28
+ install: 'npm install',
29
+ dev: 'npm run dev',
30
+ test: 'npm test',
31
+ migrate: 'npm run migrate'
32
+ }
33
+ },
34
+ 'typescript-nextjs': {
35
+ name: 'TypeScript + Next.js + Prisma',
36
+ stack: 'TypeScript, Next.js, Prisma, PostgreSQL',
37
+ commands: {
38
+ install: 'npm install',
39
+ dev: 'npm run dev',
40
+ test: 'npm test',
41
+ migrate: 'npx prisma migrate dev'
42
+ }
43
+ },
44
+ 'go-gin': {
45
+ name: 'Go + Gin + PostgreSQL',
46
+ stack: 'Go, Gin, PostgreSQL',
47
+ commands: {
48
+ install: 'go mod download',
49
+ dev: 'go run main.go',
50
+ test: 'go test ./...',
51
+ migrate: 'migrate -path migrations -database $DATABASE_URL up'
52
+ }
53
+ },
54
+ 'rust-actix': {
55
+ name: 'Rust + Actix + SQLx',
56
+ stack: 'Rust, Actix-web, SQLx, PostgreSQL',
57
+ commands: {
58
+ install: 'cargo build',
59
+ dev: 'cargo run',
60
+ test: 'cargo test',
61
+ migrate: 'sqlx migrate run'
62
+ }
63
+ },
64
+ 'ruby-rails': {
65
+ name: 'Ruby + Rails + PostgreSQL',
66
+ stack: 'Ruby, Rails, PostgreSQL',
67
+ commands: {
68
+ install: 'bundle install',
69
+ dev: 'rails server',
70
+ test: 'rails test',
71
+ migrate: 'rails db:migrate'
72
+ }
73
+ },
74
+ 'python-django': {
75
+ name: 'Python + Django + PostgreSQL',
76
+ stack: 'Python, Django, PostgreSQL',
77
+ commands: {
78
+ install: 'pip install -r requirements.txt',
79
+ dev: 'python manage.py runserver',
80
+ test: 'python manage.py test',
81
+ migrate: 'python manage.py migrate'
82
+ }
83
+ },
84
+ 'node-nestjs': {
85
+ name: 'Node.js + NestJS + TypeORM',
86
+ stack: 'Node.js, NestJS, TypeORM, PostgreSQL',
87
+ commands: {
88
+ install: 'npm install',
89
+ dev: 'npm run start:dev',
90
+ test: 'npm run test',
91
+ migrate: 'npm run migration:run'
92
+ }
93
+ },
94
+ 'typescript-remix': {
95
+ name: 'TypeScript + Remix + Prisma',
96
+ stack: 'TypeScript, Remix, Prisma, PostgreSQL',
97
+ commands: {
98
+ install: 'npm install',
99
+ dev: 'npm run dev',
100
+ test: 'npm test',
101
+ migrate: 'npx prisma migrate dev'
102
+ }
103
+ },
104
+ 'java-spring': {
105
+ name: 'Java + Spring Boot + PostgreSQL',
106
+ stack: 'Java, Spring Boot, PostgreSQL',
107
+ commands: {
108
+ install: 'mvn install',
109
+ dev: 'mvn spring-boot:run',
110
+ test: 'mvn test',
111
+ migrate: 'mvn flyway:migrate'
112
+ }
113
+ },
114
+ 'csharp-dotnet': {
115
+ name: 'C# + .NET Core + Entity Framework',
116
+ stack: 'C#, .NET Core, Entity Framework, PostgreSQL',
117
+ commands: {
118
+ install: 'dotnet restore',
119
+ dev: 'dotnet run',
120
+ test: 'dotnet test',
121
+ migrate: 'dotnet ef database update'
122
+ }
123
+ },
124
+ 'php-laravel': {
125
+ name: 'PHP + Laravel + MySQL',
126
+ stack: 'PHP, Laravel, MySQL',
127
+ commands: {
128
+ install: 'composer install',
129
+ dev: 'php artisan serve',
130
+ test: 'php artisan test',
131
+ migrate: 'php artisan migrate'
132
+ }
133
+ }
134
+ };
135
+
136
+ /**
137
+ * Run interactive prompts
138
+ */
139
+ async function runPrompts(targetDir, presetName = null) {
140
+ // Detect tech stack for auto-suggestion
141
+ const detected = await detectTechStack(targetDir);
142
+
143
+ console.log(chalk.gray('\nLet\'s set up context engineering for your project.\n'));
144
+
145
+ const answers = await prompt([
146
+ {
147
+ type: 'input',
148
+ name: 'projectName',
149
+ message: 'Project name:',
150
+ initial: path.basename(targetDir),
151
+ validate: (value) => {
152
+ if (!value.trim()) return 'Project name is required';
153
+ if (!/^[a-zA-Z0-9_-]+$/.test(value)) {
154
+ return 'Project name can only contain letters, numbers, hyphens, and underscores';
155
+ }
156
+ return true;
157
+ }
158
+ },
159
+ {
160
+ type: 'select',
161
+ name: 'techStackChoice',
162
+ message: 'Technology stack:',
163
+ choices: [
164
+ {
165
+ name: 'auto',
166
+ message: detected.summary
167
+ ? `Confirm: ${detected.summary}`
168
+ : 'Auto-detect from project files'
169
+ },
170
+ { name: 'preset', message: 'Select from presets' },
171
+ { name: 'manual', message: 'Enter manually' },
172
+ { name: 'skip', message: 'Skip (use generic template)' }
173
+ ],
174
+ initial: 0
175
+ },
176
+ {
177
+ type: 'select',
178
+ name: 'preset',
179
+ message: 'Select a tech stack preset:',
180
+ choices: Object.entries(PRESETS).map(([key, value]) => ({
181
+ name: key,
182
+ message: value.name
183
+ })),
184
+ skip() {
185
+ return this.state.answers.techStackChoice !== 'preset';
186
+ }
187
+ },
188
+ {
189
+ type: 'input',
190
+ name: 'manualStack',
191
+ message: 'Enter your tech stack (e.g., "Python, Django, PostgreSQL"):',
192
+ skip() {
193
+ return this.state.answers.techStackChoice !== 'manual';
194
+ }
195
+ },
196
+ {
197
+ type: 'multiselect',
198
+ name: 'features',
199
+ message: 'Features to include:',
200
+ choices: [
201
+ { name: 'rpi', message: 'RPI Workflow (Research-Plan-Implement)', value: true },
202
+ { name: 'agents', message: 'Specialized Agents (6 agents)', value: true },
203
+ { name: 'validation', message: 'Validation Commands', value: true },
204
+ { name: 'ci', message: 'CI/CD Templates', value: false },
205
+ { name: 'team', message: 'Team Collaboration', value: false },
206
+ { name: 'analytics', message: 'Analytics Dashboard', value: false }
207
+ ],
208
+ initial: ['rpi', 'agents', 'validation']
209
+ },
210
+ {
211
+ type: 'confirm',
212
+ name: 'installPlugin',
213
+ message: 'Install Claude Code plugin for ongoing commands?',
214
+ initial: true
215
+ }
216
+ ]);
217
+
218
+ // Process tech stack choice
219
+ let techStack = detected;
220
+ if (answers.techStackChoice === 'preset' && answers.preset) {
221
+ const preset = PRESETS[answers.preset];
222
+ techStack = {
223
+ ...techStack,
224
+ summary: preset.stack,
225
+ preset: answers.preset,
226
+ commands: preset.commands
227
+ };
228
+ } else if (answers.techStackChoice === 'manual' && answers.manualStack) {
229
+ techStack = {
230
+ ...techStack,
231
+ summary: answers.manualStack,
232
+ preset: null
233
+ };
234
+ }
235
+
236
+ return {
237
+ projectName: answers.projectName,
238
+ techStack,
239
+ features: {
240
+ rpi: answers.features.includes('rpi'),
241
+ agents: answers.features.includes('agents'),
242
+ validation: answers.features.includes('validation'),
243
+ ci: answers.features.includes('ci'),
244
+ team: answers.features.includes('team'),
245
+ analytics: answers.features.includes('analytics')
246
+ },
247
+ installPlugin: answers.installPlugin
248
+ };
249
+ }
250
+
251
+ /**
252
+ * Get default configuration (for --yes flag)
253
+ */
254
+ async function getDefaults(targetDir, presetName = null) {
255
+ const detected = await detectTechStack(targetDir);
256
+
257
+ let techStack = detected;
258
+ if (presetName && PRESETS[presetName]) {
259
+ const preset = PRESETS[presetName];
260
+ techStack = {
261
+ ...techStack,
262
+ summary: preset.stack,
263
+ preset: presetName,
264
+ commands: preset.commands
265
+ };
266
+ }
267
+
268
+ return {
269
+ projectName: path.basename(targetDir),
270
+ techStack,
271
+ features: {
272
+ rpi: true,
273
+ agents: true,
274
+ validation: true,
275
+ ci: false,
276
+ team: false,
277
+ analytics: false
278
+ },
279
+ installPlugin: true
280
+ };
281
+ }
282
+
283
+ /**
284
+ * Run discovery prompts for handling existing documentation
285
+ * @param {object} discovery - Discovery results from doc-discovery.js
286
+ * @returns {Promise<object>} User's choices for handling existing docs
287
+ */
288
+ async function runDiscoveryPrompts(discovery) {
289
+ if (!discovery || !discovery.hasExistingDocs) {
290
+ return { existingDocsStrategy: 'fresh' };
291
+ }
292
+
293
+ const { generateDiscoveryPrompts } = require('./doc-discovery');
294
+ const prompts = generateDiscoveryPrompts(discovery);
295
+
296
+ if (prompts.length === 0) {
297
+ return { existingDocsStrategy: 'fresh' };
298
+ }
299
+
300
+ console.log(chalk.gray('\nExisting documentation detected.\n'));
301
+
302
+ const answers = await prompt(prompts);
303
+
304
+ // Handle conflict resolution if user chose 'ask'
305
+ if (answers.conflictResolution === 'ask' && discovery.conflicts.length > 0) {
306
+ const conflictResolutions = {};
307
+
308
+ for (const conflict of discovery.conflicts) {
309
+ const conflictAnswer = await prompt([{
310
+ type: 'select',
311
+ name: 'resolution',
312
+ message: `Conflict for ${chalk.cyan(conflict.key)}:\n Existing (${conflict.existingSource}): "${truncate(conflict.existingValue, 40)}"\n New (${conflict.newSource}): "${truncate(conflict.newValue, 40)}"`,
313
+ choices: [
314
+ { name: 'existing', message: 'Keep existing value' },
315
+ { name: 'new', message: 'Use new value' }
316
+ ]
317
+ }]);
318
+ conflictResolutions[conflict.key] = conflictAnswer.resolution;
319
+ }
320
+
321
+ answers.conflictResolutions = conflictResolutions;
322
+ }
323
+
324
+ return answers;
325
+ }
326
+
327
+ /**
328
+ * Truncate a string with ellipsis
329
+ */
330
+ function truncate(str, maxLength) {
331
+ if (!str) return '';
332
+ if (str.length <= maxLength) return str;
333
+ return str.substring(0, maxLength - 3) + '...';
334
+ }
335
+
336
+ module.exports = {
337
+ runPrompts,
338
+ getDefaults,
339
+ runDiscoveryPrompts,
340
+ PRESETS
341
+ };