@nerviq/cli 1.18.0 → 1.19.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 (187) hide show
  1. package/LICENSE +23 -23
  2. package/README.md +2 -2
  3. package/bin/cli.js +130 -130
  4. package/package.json +1 -1
  5. package/src/activity.js +1039 -1039
  6. package/src/adoption-advisor.js +299 -299
  7. package/src/aider/config-parser.js +166 -166
  8. package/src/aider/context.js +158 -158
  9. package/src/aider/deep-review.js +316 -316
  10. package/src/aider/domain-packs.js +303 -303
  11. package/src/aider/freshness.js +93 -93
  12. package/src/aider/governance.js +253 -253
  13. package/src/aider/interactive.js +334 -334
  14. package/src/aider/mcp-packs.js +329 -329
  15. package/src/aider/patch.js +214 -214
  16. package/src/aider/plans.js +186 -186
  17. package/src/aider/premium.js +360 -360
  18. package/src/aider/setup.js +404 -404
  19. package/src/aider/techniques.js +16 -16
  20. package/src/analyze.js +951 -951
  21. package/src/anti-patterns.js +485 -485
  22. package/src/audit/instruction-files.js +180 -180
  23. package/src/audit/recommendations.js +577 -577
  24. package/src/auto-suggest.js +154 -154
  25. package/src/badge.js +13 -13
  26. package/src/behavioral-drift.js +801 -801
  27. package/src/benchmark.js +67 -67
  28. package/src/catalog.js +103 -103
  29. package/src/certification.js +128 -128
  30. package/src/codex/config-parser.js +183 -183
  31. package/src/codex/context.js +223 -223
  32. package/src/codex/deep-review.js +493 -493
  33. package/src/codex/domain-packs.js +394 -394
  34. package/src/codex/freshness.js +84 -84
  35. package/src/codex/governance.js +192 -192
  36. package/src/codex/interactive.js +618 -618
  37. package/src/codex/mcp-packs.js +914 -914
  38. package/src/codex/patch.js +209 -209
  39. package/src/codex/plans.js +251 -251
  40. package/src/codex/premium.js +614 -614
  41. package/src/codex/setup.js +591 -591
  42. package/src/context.js +320 -320
  43. package/src/continuous-ops.js +681 -681
  44. package/src/copilot/activity.js +309 -309
  45. package/src/copilot/deep-review.js +346 -346
  46. package/src/copilot/domain-packs.js +372 -372
  47. package/src/copilot/freshness.js +57 -57
  48. package/src/copilot/governance.js +222 -222
  49. package/src/copilot/interactive.js +406 -406
  50. package/src/copilot/mcp-packs.js +826 -826
  51. package/src/copilot/plans.js +253 -253
  52. package/src/copilot/premium.js +451 -451
  53. package/src/copilot/setup.js +488 -488
  54. package/src/cost-tracking.js +61 -61
  55. package/src/cursor/activity.js +301 -301
  56. package/src/cursor/config-parser.js +265 -265
  57. package/src/cursor/context.js +256 -256
  58. package/src/cursor/deep-review.js +334 -334
  59. package/src/cursor/domain-packs.js +368 -368
  60. package/src/cursor/freshness.js +65 -65
  61. package/src/cursor/governance.js +229 -229
  62. package/src/cursor/interactive.js +391 -391
  63. package/src/cursor/mcp-packs.js +828 -828
  64. package/src/cursor/plans.js +254 -254
  65. package/src/cursor/premium.js +469 -469
  66. package/src/cursor/setup.js +488 -488
  67. package/src/dashboard.js +493 -493
  68. package/src/deep-review.js +428 -428
  69. package/src/deprecation.js +98 -98
  70. package/src/diff-only.js +280 -280
  71. package/src/doctor.js +119 -119
  72. package/src/domain-pack-expansion.js +1033 -1033
  73. package/src/domain-packs.js +387 -387
  74. package/src/feedback.js +178 -178
  75. package/src/fix-engine.js +783 -783
  76. package/src/fix-prompts.js +122 -122
  77. package/src/formatters/sarif.js +115 -115
  78. package/src/freshness.js +74 -74
  79. package/src/gemini/config-parser.js +275 -275
  80. package/src/gemini/context.js +221 -221
  81. package/src/gemini/deep-review.js +559 -559
  82. package/src/gemini/domain-packs.js +393 -393
  83. package/src/gemini/freshness.js +66 -66
  84. package/src/gemini/governance.js +201 -201
  85. package/src/gemini/interactive.js +860 -860
  86. package/src/gemini/mcp-packs.js +915 -915
  87. package/src/gemini/plans.js +269 -269
  88. package/src/gemini/premium.js +760 -760
  89. package/src/gemini/setup.js +692 -692
  90. package/src/gemini/techniques.js +14 -14
  91. package/src/governance.js +72 -72
  92. package/src/harmony/add.js +68 -68
  93. package/src/harmony/advisor.js +333 -333
  94. package/src/harmony/canon.js +565 -565
  95. package/src/harmony/cli.js +591 -591
  96. package/src/harmony/drift.js +401 -401
  97. package/src/harmony/governance.js +313 -313
  98. package/src/harmony/memory.js +239 -239
  99. package/src/harmony/sync.js +475 -475
  100. package/src/harmony/watch.js +370 -370
  101. package/src/hook-validation.js +342 -342
  102. package/src/index.js +271 -271
  103. package/src/init.js +184 -184
  104. package/src/instruction-surfaces.js +185 -185
  105. package/src/integrations.js +144 -144
  106. package/src/interactive.js +118 -118
  107. package/src/locales/en.json +1 -1
  108. package/src/locales/es.json +1 -1
  109. package/src/mcp-packs.js +830 -830
  110. package/src/mcp-server.js +726 -726
  111. package/src/mcp-validation.js +337 -337
  112. package/src/nerviq-sync.json +7 -7
  113. package/src/opencode/config-parser.js +109 -109
  114. package/src/opencode/context.js +247 -247
  115. package/src/opencode/deep-review.js +313 -313
  116. package/src/opencode/domain-packs.js +262 -262
  117. package/src/opencode/freshness.js +66 -66
  118. package/src/opencode/governance.js +159 -159
  119. package/src/opencode/interactive.js +392 -392
  120. package/src/opencode/mcp-packs.js +705 -705
  121. package/src/opencode/patch.js +184 -184
  122. package/src/opencode/plans.js +231 -231
  123. package/src/opencode/premium.js +413 -413
  124. package/src/opencode/setup.js +449 -449
  125. package/src/opencode/techniques.js +27 -27
  126. package/src/operating-profile.js +574 -574
  127. package/src/org.js +152 -152
  128. package/src/permission-rules.js +218 -218
  129. package/src/plans.js +839 -839
  130. package/src/platform-change-manifest.js +86 -86
  131. package/src/plugins.js +110 -110
  132. package/src/policy-layers.js +210 -210
  133. package/src/profiles.js +124 -124
  134. package/src/prompt-injection.js +74 -74
  135. package/src/public-api.js +173 -173
  136. package/src/recommendation-rules.js +84 -84
  137. package/src/repo-archetype.js +386 -386
  138. package/src/secret-patterns.js +39 -39
  139. package/src/server.js +527 -527
  140. package/src/setup/analysis.js +607 -607
  141. package/src/setup/runtime.js +172 -172
  142. package/src/setup.js +677 -677
  143. package/src/shared/capabilities.js +194 -194
  144. package/src/source-urls.js +132 -132
  145. package/src/stack-checks.js +565 -565
  146. package/src/supplemental-checks.js +13 -13
  147. package/src/synergy/adaptive.js +261 -261
  148. package/src/synergy/compensation.js +137 -137
  149. package/src/synergy/evidence.js +193 -193
  150. package/src/synergy/learning.js +199 -199
  151. package/src/synergy/patterns.js +227 -227
  152. package/src/synergy/ranking.js +83 -83
  153. package/src/synergy/report.js +165 -165
  154. package/src/synergy/routing.js +146 -146
  155. package/src/techniques/api.js +407 -407
  156. package/src/techniques/automation.js +316 -316
  157. package/src/techniques/compliance.js +257 -257
  158. package/src/techniques/hygiene.js +294 -294
  159. package/src/techniques/instructions.js +243 -243
  160. package/src/techniques/observability.js +226 -226
  161. package/src/techniques/optimization.js +142 -142
  162. package/src/techniques/quality.js +318 -318
  163. package/src/techniques/security.js +237 -237
  164. package/src/techniques/shared.js +443 -443
  165. package/src/techniques/stacks.js +2294 -2294
  166. package/src/techniques/tools.js +106 -106
  167. package/src/techniques/workflow.js +413 -413
  168. package/src/techniques.js +81 -81
  169. package/src/terminology.js +73 -73
  170. package/src/token-estimate.js +35 -35
  171. package/src/usage-patterns.js +99 -99
  172. package/src/verification-metadata.js +145 -145
  173. package/src/watch.js +247 -247
  174. package/src/windsurf/activity.js +302 -302
  175. package/src/windsurf/config-parser.js +267 -267
  176. package/src/windsurf/context.js +249 -249
  177. package/src/windsurf/deep-review.js +337 -337
  178. package/src/windsurf/domain-packs.js +370 -370
  179. package/src/windsurf/freshness.js +36 -36
  180. package/src/windsurf/governance.js +231 -231
  181. package/src/windsurf/interactive.js +388 -388
  182. package/src/windsurf/mcp-packs.js +792 -792
  183. package/src/windsurf/plans.js +247 -247
  184. package/src/windsurf/premium.js +468 -468
  185. package/src/windsurf/setup.js +471 -471
  186. package/src/windsurf/techniques.js +17 -17
  187. package/src/workspace.js +375 -375
@@ -14,11 +14,11 @@
14
14
  const os = require('os');
15
15
  const path = require('path');
16
16
  const { GeminiProjectContext } = require('./context');
17
- const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
18
- const { attachSourceUrls } = require('../source-urls');
19
- const { buildSupplementalChecks } = require('../supplemental-checks');
20
- const { buildStackChecks } = require('../stack-checks');
21
- const { resolveProjectStateReadPath } = require('../state-paths');
17
+ const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
18
+ const { attachSourceUrls } = require('../source-urls');
19
+ const { buildSupplementalChecks } = require('../supplemental-checks');
20
+ const { buildStackChecks } = require('../stack-checks');
21
+ const { resolveProjectStateReadPath } = require('../state-paths');
22
22
 
23
23
  const GEMINI_SUPPLEMENTAL_SOURCE_URLS = {
24
24
  'testing-strategy': 'https://geminicli.com/docs/get-started/',
@@ -2063,23 +2063,23 @@ const GEMINI_TECHNIQUES = {
2063
2063
  },
2064
2064
 
2065
2065
  // CP-08: O. Repeat-Usage Hygiene (3 checks)
2066
- geminiSnapshotRetention: {
2067
- id: 'GM-O01', name: 'At least one prior audit snapshot exists',
2068
- check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
2066
+ geminiSnapshotRetention: {
2067
+ id: 'GM-O01', name: 'At least one prior audit snapshot exists',
2068
+ check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
2069
2069
  impact: 'medium', rating: 3, category: 'repeat-usage',
2070
2070
  fix: 'Run `npx nerviq --platform gemini --snapshot` to save your first snapshot.',
2071
2071
  template: null, file: () => null, line: () => null,
2072
2072
  },
2073
- geminiFeedbackLoopHealth: {
2074
- id: 'GM-O02', name: 'Feedback loop functional when feedback submitted',
2075
- check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'outcomes', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
2073
+ geminiFeedbackLoopHealth: {
2074
+ id: 'GM-O02', name: 'Feedback loop functional when feedback submitted',
2075
+ check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'outcomes', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
2076
2076
  impact: 'medium', rating: 3, category: 'repeat-usage',
2077
2077
  fix: 'Submit feedback using `npx nerviq --platform gemini feedback`.',
2078
2078
  template: null, file: () => null, line: () => null,
2079
2079
  },
2080
- geminiTrendDataAvailability: {
2081
- id: 'GM-O03', name: 'Trend data computable (2+ snapshots)',
2082
- check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return (Array.isArray(e) ? e : []).filter(x => x.snapshotKind === 'audit').length >= 2; } catch { return null; } },
2080
+ geminiTrendDataAvailability: {
2081
+ id: 'GM-O03', name: 'Trend data computable (2+ snapshots)',
2082
+ check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return (Array.isArray(e) ? e : []).filter(x => x.snapshotKind === 'audit').length >= 2; } catch { return null; } },
2083
2083
  impact: 'low', rating: 2, category: 'repeat-usage',
2084
2084
  fix: 'Run at least 2 audits with --snapshot for trend tracking.',
2085
2085
  template: null, file: () => null, line: () => null,
package/src/governance.js CHANGED
@@ -1,7 +1,7 @@
1
- const { DOMAIN_PACKS } = require('./domain-packs');
2
- const { MCP_PACKS, mergeMcpServers, normalizeMcpPackKeys } = require('./mcp-packs');
3
- const { getCodexGovernanceSummary } = require('./codex/governance');
4
- const { formatTerminologyLines } = require('./terminology');
1
+ const { DOMAIN_PACKS } = require('./domain-packs');
2
+ const { MCP_PACKS, mergeMcpServers, normalizeMcpPackKeys } = require('./mcp-packs');
3
+ const { getCodexGovernanceSummary } = require('./codex/governance');
4
+ const { formatTerminologyLines } = require('./terminology');
5
5
 
6
6
  const PERMISSION_PROFILES = [
7
7
  {
@@ -104,19 +104,19 @@ const HOOK_REGISTRY = [
104
104
  dryRunExample: 'Edit a catalog file and verify duplicate check runs without blocking.',
105
105
  rollbackPath: 'Remove the PostToolUse hook entry from settings.',
106
106
  },
107
- {
108
- key: 'injection-defense',
109
- file: '.claude/hooks/injection-defense.js',
110
- triggerPoint: 'PostToolUse',
111
- matcher: 'WebFetch|WebSearch|Read|Grep|Glob|mcp__.*',
112
- purpose: 'Scans external content flows for common prompt injection patterns and logs suspicious findings.',
113
- filesTouched: ['.claude/logs/prompt-injection-alerts.log'],
114
- sideEffects: ['Appends an alert line when suspicious external content is detected.'],
115
- risk: 'low',
116
- riskLevel: 'low',
117
- dryRunExample: 'Run a WebFetch or MCP-backed tool call and verify suspicious content is logged for review.',
118
- rollbackPath: 'Remove the PostToolUse hook entry from settings.',
119
- },
107
+ {
108
+ key: 'injection-defense',
109
+ file: '.claude/hooks/injection-defense.js',
110
+ triggerPoint: 'PostToolUse',
111
+ matcher: 'WebFetch|WebSearch|Read|Grep|Glob|mcp__.*',
112
+ purpose: 'Scans external content flows for common prompt injection patterns and logs suspicious findings.',
113
+ filesTouched: ['.claude/logs/prompt-injection-alerts.log'],
114
+ sideEffects: ['Appends an alert line when suspicious external content is detected.'],
115
+ risk: 'low',
116
+ riskLevel: 'low',
117
+ dryRunExample: 'Run a WebFetch or MCP-backed tool call and verify suspicious content is logged for review.',
118
+ rollbackPath: 'Remove the PostToolUse hook entry from settings.',
119
+ },
120
120
  {
121
121
  key: 'trust-drift-check',
122
122
  file: '.claude/hooks/trust-drift-check.sh',
@@ -299,24 +299,24 @@ function buildHookConfig(hookFiles, profileKey) {
299
299
  return {};
300
300
  }
301
301
 
302
- // Detect hook runtime: .js files use node, .sh files use bash
303
- const hookCommand = (file) => {
304
- if (file.endsWith('.js')) return `node .claude/hooks/${file}`;
305
- return `bash .claude/hooks/${file}`;
306
- };
307
- const isSecrets = (f) => f === 'protect-secrets.sh' || f === 'protect-secrets.js';
308
- const isSession = (f) => f === 'session-start.sh' || f === 'session-start.js';
309
- const isInjection = (f) => f === 'injection-defense.sh' || f === 'injection-defense.js';
310
-
311
- const hookConfig = {
312
- PostToolUse: [{
313
- matcher: 'Write|Edit',
314
- hooks: uniqueFiles
315
- .filter(file => !isSecrets(file) && !isSession(file) && !isInjection(file))
316
- .map(file => ({
317
- type: 'command',
318
- command: hookCommand(file),
319
- timeout: 10,
302
+ // Detect hook runtime: .js files use node, .sh files use bash
303
+ const hookCommand = (file) => {
304
+ if (file.endsWith('.js')) return `node .claude/hooks/${file}`;
305
+ return `bash .claude/hooks/${file}`;
306
+ };
307
+ const isSecrets = (f) => f === 'protect-secrets.sh' || f === 'protect-secrets.js';
308
+ const isSession = (f) => f === 'session-start.sh' || f === 'session-start.js';
309
+ const isInjection = (f) => f === 'injection-defense.sh' || f === 'injection-defense.js';
310
+
311
+ const hookConfig = {
312
+ PostToolUse: [{
313
+ matcher: 'Write|Edit',
314
+ hooks: uniqueFiles
315
+ .filter(file => !isSecrets(file) && !isSession(file) && !isInjection(file))
316
+ .map(file => ({
317
+ type: 'command',
318
+ command: hookCommand(file),
319
+ timeout: 10,
320
320
  })),
321
321
  }],
322
322
  };
@@ -334,29 +334,29 @@ function buildHookConfig(hookFiles, profileKey) {
334
334
  }
335
335
 
336
336
  const sessionFile = uniqueFiles.find(isSession);
337
- if (sessionFile) {
338
- hookConfig.SessionStart = [{
339
- matcher: '*',
340
- hooks: [{
341
- type: 'command',
337
+ if (sessionFile) {
338
+ hookConfig.SessionStart = [{
339
+ matcher: '*',
340
+ hooks: [{
341
+ type: 'command',
342
342
  command: hookCommand(sessionFile),
343
343
  timeout: 5,
344
- }],
345
- }];
346
- }
347
-
348
- const injectionFile = uniqueFiles.find(isInjection);
349
- if (injectionFile) {
350
- hookConfig.PostToolUse = hookConfig.PostToolUse || [];
351
- hookConfig.PostToolUse.push({
352
- matcher: 'WebFetch|WebSearch|Read|Grep|Glob|mcp__.*',
353
- hooks: [{
354
- type: 'command',
355
- command: hookCommand(injectionFile),
356
- timeout: 5,
357
- }],
358
- });
359
- }
344
+ }],
345
+ }];
346
+ }
347
+
348
+ const injectionFile = uniqueFiles.find(isInjection);
349
+ if (injectionFile) {
350
+ hookConfig.PostToolUse = hookConfig.PostToolUse || [];
351
+ hookConfig.PostToolUse.push({
352
+ matcher: 'WebFetch|WebSearch|Read|Grep|Glob|mcp__.*',
353
+ hooks: [{
354
+ type: 'command',
355
+ command: hookCommand(injectionFile),
356
+ timeout: 5,
357
+ }],
358
+ });
359
+ }
360
360
 
361
361
  if ((hookConfig.PostToolUse[0].hooks || []).length === 0) {
362
362
  delete hookConfig.PostToolUse;
@@ -421,15 +421,15 @@ function printGovernanceSummary(summary, options = {}) {
421
421
  console.log('');
422
422
  console.log(` nerviq ${summary.platformLabel.toLowerCase()} governance`);
423
423
  console.log(' ═══════════════════════════════════════');
424
- console.log(` Safe defaults, hook transparency, and pilot guidance for ${summary.platformLabel}.`);
425
- console.log('');
426
-
427
- for (const line of formatTerminologyLines(['governance', 'hooks', 'denyRules', 'mcp'])) {
428
- console.log(line);
429
- }
430
- console.log('');
431
-
432
- console.log(' Permission Profiles');
424
+ console.log(` Safe defaults, hook transparency, and pilot guidance for ${summary.platformLabel}.`);
425
+ console.log('');
426
+
427
+ for (const line of formatTerminologyLines(['governance', 'hooks', 'denyRules', 'mcp'])) {
428
+ console.log(line);
429
+ }
430
+ console.log('');
431
+
432
+ console.log(' Permission Profiles');
433
433
  for (const profile of summary.permissionProfiles) {
434
434
  console.log(` - ${profile.label} [${profile.risk}]`);
435
435
  console.log(` ${profile.useWhen}`);
@@ -590,13 +590,13 @@ function renderGovernanceMarkdown(summary) {
590
590
  return lines.join('\n');
591
591
  }
592
592
 
593
- module.exports = {
594
- PERMISSION_PROFILES,
595
- HOOK_REGISTRY,
596
- POLICY_PACKS,
597
- getPermissionProfile,
598
- isWritableProfile,
599
- ensureWritableProfile,
593
+ module.exports = {
594
+ PERMISSION_PROFILES,
595
+ HOOK_REGISTRY,
596
+ POLICY_PACKS,
597
+ getPermissionProfile,
598
+ isWritableProfile,
599
+ ensureWritableProfile,
600
600
  buildSettingsForProfile,
601
601
  getGovernanceSummary,
602
602
  printGovernanceSummary,
@@ -1,68 +1,68 @@
1
- /**
2
- * Platform Addition Wizard
3
- * Helps users add a new platform config to their project.
4
- */
5
-
6
- const fs = require('fs');
7
- const path = require('path');
8
- const { detectActivePlatforms, PLATFORM_SIGNATURES } = require('./canon');
9
- const { applyHarmonySync } = require('./sync');
10
-
11
- const PLATFORM_BOOTSTRAPS = {
12
- claude: { files: [{ path: 'CLAUDE.md', content: '# Project Instructions\n\nAdd your Claude Code instructions here.\n' }] },
13
- codex: { files: [{ path: 'AGENTS.md', content: '# Agents Instructions\n\nAdd your Codex instructions here.\n' }] },
14
- gemini: { files: [{ path: 'GEMINI.md', content: '# Gemini Instructions\n\nAdd your Gemini CLI instructions here.\n' }] },
15
- copilot: { files: [{ path: '.github/copilot-instructions.md', content: '# Copilot Instructions\n\nAdd your GitHub Copilot instructions here.\n' }] },
16
- cursor: { files: [{ path: '.cursorrules', content: '# Cursor Rules\n\nAdd your Cursor rules here.\n' }] },
17
- windsurf: { files: [{ path: '.windsurfrules', content: '# Windsurf Rules\n\nAdd your Windsurf rules here.\n' }] },
18
- aider: { files: [{ path: '.aider.conf.yml', content: '# Aider Configuration\n# See: https://aider.chat/docs/config/aider_conf.html\n' }] },
19
- opencode: { files: [{ path: 'opencode.json', content: '{\n "instructions": "Add your OpenCode instructions here."\n}\n' }] },
20
- };
21
-
22
- function addPlatform(dir, platformKey) {
23
- // Validate platform
24
- if (!PLATFORM_SIGNATURES[platformKey]) {
25
- return { success: false, error: `Unknown platform: ${platformKey}. Available: ${Object.keys(PLATFORM_SIGNATURES).join(', ')}` };
26
- }
27
-
28
- // Check if already active
29
- const active = detectActivePlatforms(dir);
30
- const alreadyActive = active.find(p => p.platform === platformKey);
31
- if (alreadyActive) {
32
- return { success: false, error: `${platformKey} is already active in this project.` };
33
- }
34
-
35
- const beforeCount = active.length;
36
- const bootstrap = PLATFORM_BOOTSTRAPS[platformKey];
37
- const created = [];
38
-
39
- // Create bootstrap files
40
- for (const file of bootstrap.files) {
41
- const fullPath = path.join(dir, file.path);
42
- if (fs.existsSync(fullPath)) continue;
43
- const dirName = path.dirname(fullPath);
44
- fs.mkdirSync(dirName, { recursive: true });
45
- fs.writeFileSync(fullPath, file.content, 'utf8');
46
- created.push(file.path);
47
- }
48
-
49
- // Run harmony sync to populate managed blocks
50
- let syncResult = null;
51
- try {
52
- syncResult = applyHarmonySync(dir);
53
- } catch { /* sync is optional */ }
54
-
55
- const afterActive = detectActivePlatforms(dir);
56
- const afterCount = afterActive.length;
57
-
58
- return {
59
- success: true,
60
- platform: platformKey,
61
- created,
62
- beforeCount,
63
- afterCount,
64
- syncApplied: syncResult ? syncResult.applied.length : 0,
65
- };
66
- }
67
-
68
- module.exports = { addPlatform, PLATFORM_BOOTSTRAPS };
1
+ /**
2
+ * Platform Addition Wizard
3
+ * Helps users add a new platform config to their project.
4
+ */
5
+
6
+ const fs = require('fs');
7
+ const path = require('path');
8
+ const { detectActivePlatforms, PLATFORM_SIGNATURES } = require('./canon');
9
+ const { applyHarmonySync } = require('./sync');
10
+
11
+ const PLATFORM_BOOTSTRAPS = {
12
+ claude: { files: [{ path: 'CLAUDE.md', content: '# Project Instructions\n\nAdd your Claude Code instructions here.\n' }] },
13
+ codex: { files: [{ path: 'AGENTS.md', content: '# Agents Instructions\n\nAdd your Codex instructions here.\n' }] },
14
+ gemini: { files: [{ path: 'GEMINI.md', content: '# Gemini Instructions\n\nAdd your Gemini CLI instructions here.\n' }] },
15
+ copilot: { files: [{ path: '.github/copilot-instructions.md', content: '# Copilot Instructions\n\nAdd your GitHub Copilot instructions here.\n' }] },
16
+ cursor: { files: [{ path: '.cursorrules', content: '# Cursor Rules\n\nAdd your Cursor rules here.\n' }] },
17
+ windsurf: { files: [{ path: '.windsurfrules', content: '# Windsurf Rules\n\nAdd your Windsurf rules here.\n' }] },
18
+ aider: { files: [{ path: '.aider.conf.yml', content: '# Aider Configuration\n# See: https://aider.chat/docs/config/aider_conf.html\n' }] },
19
+ opencode: { files: [{ path: 'opencode.json', content: '{\n "instructions": "Add your OpenCode instructions here."\n}\n' }] },
20
+ };
21
+
22
+ function addPlatform(dir, platformKey) {
23
+ // Validate platform
24
+ if (!PLATFORM_SIGNATURES[platformKey]) {
25
+ return { success: false, error: `Unknown platform: ${platformKey}. Available: ${Object.keys(PLATFORM_SIGNATURES).join(', ')}` };
26
+ }
27
+
28
+ // Check if already active
29
+ const active = detectActivePlatforms(dir);
30
+ const alreadyActive = active.find(p => p.platform === platformKey);
31
+ if (alreadyActive) {
32
+ return { success: false, error: `${platformKey} is already active in this project.` };
33
+ }
34
+
35
+ const beforeCount = active.length;
36
+ const bootstrap = PLATFORM_BOOTSTRAPS[platformKey];
37
+ const created = [];
38
+
39
+ // Create bootstrap files
40
+ for (const file of bootstrap.files) {
41
+ const fullPath = path.join(dir, file.path);
42
+ if (fs.existsSync(fullPath)) continue;
43
+ const dirName = path.dirname(fullPath);
44
+ fs.mkdirSync(dirName, { recursive: true });
45
+ fs.writeFileSync(fullPath, file.content, 'utf8');
46
+ created.push(file.path);
47
+ }
48
+
49
+ // Run harmony sync to populate managed blocks
50
+ let syncResult = null;
51
+ try {
52
+ syncResult = applyHarmonySync(dir);
53
+ } catch { /* sync is optional */ }
54
+
55
+ const afterActive = detectActivePlatforms(dir);
56
+ const afterCount = afterActive.length;
57
+
58
+ return {
59
+ success: true,
60
+ platform: platformKey,
61
+ created,
62
+ beforeCount,
63
+ afterCount,
64
+ syncApplied: syncResult ? syncResult.applied.length : 0,
65
+ };
66
+ }
67
+
68
+ module.exports = { addPlatform, PLATFORM_BOOTSTRAPS };