create-universal-ai-context 2.0.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 (136) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +171 -0
  3. package/bin/create-ai-context.js +337 -0
  4. package/lib/adapters/antigravity.js +160 -0
  5. package/lib/adapters/claude.js +122 -0
  6. package/lib/adapters/cline.js +111 -0
  7. package/lib/adapters/copilot.js +117 -0
  8. package/lib/adapters/index.js +69 -0
  9. package/lib/ai-context-generator.js +234 -0
  10. package/lib/ai-orchestrator.js +431 -0
  11. package/lib/call-tracer.js +444 -0
  12. package/lib/detector.js +726 -0
  13. package/lib/environment-detector.js +239 -0
  14. package/lib/index.js +310 -0
  15. package/lib/installer.js +418 -0
  16. package/lib/migrate.js +319 -0
  17. package/lib/placeholder.js +541 -0
  18. package/lib/prompts.js +287 -0
  19. package/lib/spinner.js +60 -0
  20. package/lib/static-analyzer.js +729 -0
  21. package/lib/template-populator.js +843 -0
  22. package/lib/template-renderer.js +382 -0
  23. package/lib/validate.js +155 -0
  24. package/package.json +70 -0
  25. package/templates/AI_CONTEXT.md.template +245 -0
  26. package/templates/base/README.md +257 -0
  27. package/templates/base/RPI_WORKFLOW_PLAN.md +320 -0
  28. package/templates/base/agents/api-developer.md +76 -0
  29. package/templates/base/agents/context-engineer.md +525 -0
  30. package/templates/base/agents/core-architect.md +76 -0
  31. package/templates/base/agents/database-ops.md +76 -0
  32. package/templates/base/agents/deployment-ops.md +76 -0
  33. package/templates/base/agents/integration-hub.md +76 -0
  34. package/templates/base/analytics/README.md +114 -0
  35. package/templates/base/automation/config.json +58 -0
  36. package/templates/base/automation/generators/code-mapper.js +308 -0
  37. package/templates/base/automation/generators/index-builder.js +321 -0
  38. package/templates/base/automation/hooks/post-commit.sh +83 -0
  39. package/templates/base/automation/hooks/pre-commit.sh +103 -0
  40. package/templates/base/ci-templates/README.md +108 -0
  41. package/templates/base/ci-templates/github-actions/context-check.yml +144 -0
  42. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -0
  43. package/templates/base/commands/analytics.md +238 -0
  44. package/templates/base/commands/auto-sync.md +172 -0
  45. package/templates/base/commands/collab.md +194 -0
  46. package/templates/base/commands/help.md +450 -0
  47. package/templates/base/commands/rpi-implement.md +115 -0
  48. package/templates/base/commands/rpi-plan.md +93 -0
  49. package/templates/base/commands/rpi-research.md +88 -0
  50. package/templates/base/commands/session-resume.md +144 -0
  51. package/templates/base/commands/session-save.md +112 -0
  52. package/templates/base/commands/validate-all.md +77 -0
  53. package/templates/base/commands/verify-docs-current.md +86 -0
  54. package/templates/base/config/base.json +57 -0
  55. package/templates/base/config/environments/development.json +13 -0
  56. package/templates/base/config/environments/production.json +17 -0
  57. package/templates/base/config/environments/staging.json +13 -0
  58. package/templates/base/config/local.json.example +21 -0
  59. package/templates/base/context/.meta/generated-at.json +18 -0
  60. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -0
  61. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -0
  62. package/templates/base/context/FILE_OWNERSHIP.md +57 -0
  63. package/templates/base/context/INTEGRATION_POINTS.md +92 -0
  64. package/templates/base/context/KNOWN_GOTCHAS.md +195 -0
  65. package/templates/base/context/TESTING_MAP.md +95 -0
  66. package/templates/base/context/WORKFLOW_INDEX.md +129 -0
  67. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -0
  68. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -0
  69. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -0
  70. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -0
  71. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -0
  72. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -0
  73. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -0
  74. package/templates/base/knowledge/README.md +98 -0
  75. package/templates/base/knowledge/sessions/README.md +88 -0
  76. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -0
  77. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -0
  78. package/templates/base/knowledge/shared/decisions/README.md +49 -0
  79. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -0
  80. package/templates/base/knowledge/shared/patterns/README.md +62 -0
  81. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -0
  82. package/templates/base/plans/PLAN_TEMPLATE.md +250 -0
  83. package/templates/base/plans/active/.gitkeep +0 -0
  84. package/templates/base/plans/completed/.gitkeep +0 -0
  85. package/templates/base/research/RESEARCH_TEMPLATE.md +153 -0
  86. package/templates/base/research/active/.gitkeep +0 -0
  87. package/templates/base/research/completed/.gitkeep +0 -0
  88. package/templates/base/schemas/agent.schema.json +141 -0
  89. package/templates/base/schemas/anchors.schema.json +54 -0
  90. package/templates/base/schemas/automation.schema.json +93 -0
  91. package/templates/base/schemas/command.schema.json +134 -0
  92. package/templates/base/schemas/hashes.schema.json +40 -0
  93. package/templates/base/schemas/manifest.schema.json +117 -0
  94. package/templates/base/schemas/plan.schema.json +136 -0
  95. package/templates/base/schemas/research.schema.json +115 -0
  96. package/templates/base/schemas/roles.schema.json +34 -0
  97. package/templates/base/schemas/session.schema.json +77 -0
  98. package/templates/base/schemas/settings.schema.json +244 -0
  99. package/templates/base/schemas/staleness.schema.json +53 -0
  100. package/templates/base/schemas/team-config.schema.json +42 -0
  101. package/templates/base/schemas/workflow.schema.json +126 -0
  102. package/templates/base/session/checkpoints/.gitkeep +2 -0
  103. package/templates/base/session/current/state.json +20 -0
  104. package/templates/base/session/history/.gitkeep +2 -0
  105. package/templates/base/settings.json +3 -0
  106. package/templates/base/standards/COMPATIBILITY.md +219 -0
  107. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -0
  108. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -0
  109. package/templates/base/standards/README.md +66 -0
  110. package/templates/base/sync/anchors.json +6 -0
  111. package/templates/base/sync/hashes.json +6 -0
  112. package/templates/base/sync/staleness.json +10 -0
  113. package/templates/base/team/README.md +168 -0
  114. package/templates/base/team/config.json +79 -0
  115. package/templates/base/team/roles.json +145 -0
  116. package/templates/base/tools/bin/claude-context.js +151 -0
  117. package/templates/base/tools/lib/anchor-resolver.js +276 -0
  118. package/templates/base/tools/lib/config-loader.js +363 -0
  119. package/templates/base/tools/lib/detector.js +350 -0
  120. package/templates/base/tools/lib/diagnose.js +206 -0
  121. package/templates/base/tools/lib/drift-detector.js +373 -0
  122. package/templates/base/tools/lib/errors.js +199 -0
  123. package/templates/base/tools/lib/index.js +36 -0
  124. package/templates/base/tools/lib/init.js +192 -0
  125. package/templates/base/tools/lib/logger.js +230 -0
  126. package/templates/base/tools/lib/placeholder.js +201 -0
  127. package/templates/base/tools/lib/session-manager.js +354 -0
  128. package/templates/base/tools/lib/validate.js +521 -0
  129. package/templates/base/tools/package.json +49 -0
  130. package/templates/handlebars/antigravity.hbs +337 -0
  131. package/templates/handlebars/claude.hbs +184 -0
  132. package/templates/handlebars/cline.hbs +63 -0
  133. package/templates/handlebars/copilot.hbs +131 -0
  134. package/templates/handlebars/partials/gotcha-list.hbs +11 -0
  135. package/templates/handlebars/partials/header.hbs +3 -0
  136. package/templates/handlebars/partials/workflow-summary.hbs +16 -0
package/lib/prompts.js ADDED
@@ -0,0 +1,287 @@
1
+ /**
2
+ * Interactive prompts for create-claude-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
+ module.exports = {
284
+ runPrompts,
285
+ getDefaults,
286
+ PRESETS
287
+ };
package/lib/spinner.js ADDED
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Spinner utilities for create-claude-context
3
+ *
4
+ * Provides consistent progress indicators using ora
5
+ */
6
+
7
+ const ora = require('ora');
8
+ const chalk = require('chalk');
9
+
10
+ /**
11
+ * Create a spinner instance with consistent styling
12
+ */
13
+ function createSpinner(text = '') {
14
+ return ora({
15
+ text,
16
+ color: 'cyan',
17
+ spinner: 'dots'
18
+ });
19
+ }
20
+
21
+ /**
22
+ * Run a task with spinner feedback
23
+ * @param {string} text - Text to display while running
24
+ * @param {Function} task - Async function to run
25
+ * @returns {Promise<any>} - Result of the task
26
+ */
27
+ async function withSpinner(text, task) {
28
+ const spinner = createSpinner(text);
29
+ spinner.start();
30
+
31
+ try {
32
+ const result = await task();
33
+ spinner.succeed();
34
+ return result;
35
+ } catch (error) {
36
+ spinner.fail(chalk.red(error.message));
37
+ throw error;
38
+ }
39
+ }
40
+
41
+ /**
42
+ * Display a progress list
43
+ * @param {Array<{text: string, task: Function}>} items - List of tasks
44
+ */
45
+ async function progressList(items) {
46
+ const results = [];
47
+
48
+ for (const item of items) {
49
+ const result = await withSpinner(item.text, item.task);
50
+ results.push(result);
51
+ }
52
+
53
+ return results;
54
+ }
55
+
56
+ module.exports = {
57
+ createSpinner,
58
+ withSpinner,
59
+ progressList
60
+ };