create-universal-ai-context 2.4.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 -764
  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
@@ -1,145 +1,145 @@
1
- {
2
- "$schema": "../schemas/roles.schema.json",
3
- "$comment": "Role definitions for team collaboration",
4
-
5
- "roles": {
6
- "team-lead": {
7
- "displayName": "Team Lead",
8
- "description": "Full access to all features, manages team settings and approvals",
9
- "permissions": [
10
- "read",
11
- "write",
12
- "execute",
13
- "approve",
14
- "configure",
15
- "manage-members",
16
- "manage-knowledge",
17
- "manage-sessions"
18
- ],
19
- "capabilities": {
20
- "can_approve_plans": true,
21
- "can_modify_team_config": true,
22
- "can_add_members": true,
23
- "can_remove_members": true,
24
- "can_access_all_sessions": true,
25
- "can_override_policies": true
26
- },
27
- "context_access": {
28
- "shared_knowledge": "full",
29
- "session_history": "all",
30
- "sensitive_configs": true
31
- }
32
- },
33
-
34
- "senior-developer": {
35
- "displayName": "Senior Developer",
36
- "description": "Full development access with plan approval capabilities",
37
- "permissions": [
38
- "read",
39
- "write",
40
- "execute",
41
- "approve"
42
- ],
43
- "capabilities": {
44
- "can_approve_plans": true,
45
- "can_modify_team_config": false,
46
- "can_add_members": false,
47
- "can_remove_members": false,
48
- "can_access_all_sessions": true,
49
- "can_override_policies": false
50
- },
51
- "context_access": {
52
- "shared_knowledge": "full",
53
- "session_history": "team",
54
- "sensitive_configs": false
55
- }
56
- },
57
-
58
- "developer": {
59
- "displayName": "Developer",
60
- "description": "Standard development access for implementing features and fixes",
61
- "permissions": [
62
- "read",
63
- "write",
64
- "execute"
65
- ],
66
- "capabilities": {
67
- "can_approve_plans": false,
68
- "can_modify_team_config": false,
69
- "can_add_members": false,
70
- "can_remove_members": false,
71
- "can_access_all_sessions": false,
72
- "can_override_policies": false
73
- },
74
- "context_access": {
75
- "shared_knowledge": "full",
76
- "session_history": "own",
77
- "sensitive_configs": false
78
- }
79
- },
80
-
81
- "reviewer": {
82
- "displayName": "Code Reviewer",
83
- "description": "Read access with approval capabilities for code review",
84
- "permissions": [
85
- "read",
86
- "approve"
87
- ],
88
- "capabilities": {
89
- "can_approve_plans": true,
90
- "can_modify_team_config": false,
91
- "can_add_members": false,
92
- "can_remove_members": false,
93
- "can_access_all_sessions": true,
94
- "can_override_policies": false
95
- },
96
- "context_access": {
97
- "shared_knowledge": "read-only",
98
- "session_history": "team",
99
- "sensitive_configs": false
100
- }
101
- },
102
-
103
- "observer": {
104
- "displayName": "Observer",
105
- "description": "Read-only access for monitoring and learning",
106
- "permissions": [
107
- "read"
108
- ],
109
- "capabilities": {
110
- "can_approve_plans": false,
111
- "can_modify_team_config": false,
112
- "can_add_members": false,
113
- "can_remove_members": false,
114
- "can_access_all_sessions": false,
115
- "can_override_policies": false
116
- },
117
- "context_access": {
118
- "shared_knowledge": "read-only",
119
- "session_history": "none",
120
- "sensitive_configs": false
121
- }
122
- }
123
- },
124
-
125
- "permission_definitions": {
126
- "read": "View files, documentation, and session history",
127
- "write": "Create and modify files, documentation",
128
- "execute": "Run commands, scripts, and Claude Code operations",
129
- "approve": "Approve plans, pull requests, and changes",
130
- "configure": "Modify project and team configuration",
131
- "manage-members": "Add, remove, and modify team members",
132
- "manage-knowledge": "Create, edit, and delete shared knowledge",
133
- "manage-sessions": "Access and manage all team sessions"
134
- },
135
-
136
- "default_role": "developer",
137
-
138
- "role_hierarchy": [
139
- "team-lead",
140
- "senior-developer",
141
- "developer",
142
- "reviewer",
143
- "observer"
144
- ]
145
- }
1
+ {
2
+ "$schema": "../schemas/roles.schema.json",
3
+ "$comment": "Role definitions for team collaboration",
4
+
5
+ "roles": {
6
+ "team-lead": {
7
+ "displayName": "Team Lead",
8
+ "description": "Full access to all features, manages team settings and approvals",
9
+ "permissions": [
10
+ "read",
11
+ "write",
12
+ "execute",
13
+ "approve",
14
+ "configure",
15
+ "manage-members",
16
+ "manage-knowledge",
17
+ "manage-sessions"
18
+ ],
19
+ "capabilities": {
20
+ "can_approve_plans": true,
21
+ "can_modify_team_config": true,
22
+ "can_add_members": true,
23
+ "can_remove_members": true,
24
+ "can_access_all_sessions": true,
25
+ "can_override_policies": true
26
+ },
27
+ "context_access": {
28
+ "shared_knowledge": "full",
29
+ "session_history": "all",
30
+ "sensitive_configs": true
31
+ }
32
+ },
33
+
34
+ "senior-developer": {
35
+ "displayName": "Senior Developer",
36
+ "description": "Full development access with plan approval capabilities",
37
+ "permissions": [
38
+ "read",
39
+ "write",
40
+ "execute",
41
+ "approve"
42
+ ],
43
+ "capabilities": {
44
+ "can_approve_plans": true,
45
+ "can_modify_team_config": false,
46
+ "can_add_members": false,
47
+ "can_remove_members": false,
48
+ "can_access_all_sessions": true,
49
+ "can_override_policies": false
50
+ },
51
+ "context_access": {
52
+ "shared_knowledge": "full",
53
+ "session_history": "team",
54
+ "sensitive_configs": false
55
+ }
56
+ },
57
+
58
+ "developer": {
59
+ "displayName": "Developer",
60
+ "description": "Standard development access for implementing features and fixes",
61
+ "permissions": [
62
+ "read",
63
+ "write",
64
+ "execute"
65
+ ],
66
+ "capabilities": {
67
+ "can_approve_plans": false,
68
+ "can_modify_team_config": false,
69
+ "can_add_members": false,
70
+ "can_remove_members": false,
71
+ "can_access_all_sessions": false,
72
+ "can_override_policies": false
73
+ },
74
+ "context_access": {
75
+ "shared_knowledge": "full",
76
+ "session_history": "own",
77
+ "sensitive_configs": false
78
+ }
79
+ },
80
+
81
+ "reviewer": {
82
+ "displayName": "Code Reviewer",
83
+ "description": "Read access with approval capabilities for code review",
84
+ "permissions": [
85
+ "read",
86
+ "approve"
87
+ ],
88
+ "capabilities": {
89
+ "can_approve_plans": true,
90
+ "can_modify_team_config": false,
91
+ "can_add_members": false,
92
+ "can_remove_members": false,
93
+ "can_access_all_sessions": true,
94
+ "can_override_policies": false
95
+ },
96
+ "context_access": {
97
+ "shared_knowledge": "read-only",
98
+ "session_history": "team",
99
+ "sensitive_configs": false
100
+ }
101
+ },
102
+
103
+ "observer": {
104
+ "displayName": "Observer",
105
+ "description": "Read-only access for monitoring and learning",
106
+ "permissions": [
107
+ "read"
108
+ ],
109
+ "capabilities": {
110
+ "can_approve_plans": false,
111
+ "can_modify_team_config": false,
112
+ "can_add_members": false,
113
+ "can_remove_members": false,
114
+ "can_access_all_sessions": false,
115
+ "can_override_policies": false
116
+ },
117
+ "context_access": {
118
+ "shared_knowledge": "read-only",
119
+ "session_history": "none",
120
+ "sensitive_configs": false
121
+ }
122
+ }
123
+ },
124
+
125
+ "permission_definitions": {
126
+ "read": "View files, documentation, and session history",
127
+ "write": "Create and modify files, documentation",
128
+ "execute": "Run commands, scripts, and Claude Code operations",
129
+ "approve": "Approve plans, pull requests, and changes",
130
+ "configure": "Modify project and team configuration",
131
+ "manage-members": "Add, remove, and modify team members",
132
+ "manage-knowledge": "Create, edit, and delete shared knowledge",
133
+ "manage-sessions": "Access and manage all team sessions"
134
+ },
135
+
136
+ "default_role": "developer",
137
+
138
+ "role_hierarchy": [
139
+ "team-lead",
140
+ "senior-developer",
141
+ "developer",
142
+ "reviewer",
143
+ "observer"
144
+ ]
145
+ }
@@ -1,151 +1,151 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * Claude Context Engineering CLI
5
- *
6
- * Main entry point for the claude-context command line tool.
7
- * Provides commands for initialization, validation, and management
8
- * of the Claude context engineering system.
9
- */
10
-
11
- const { program } = require('commander');
12
- const chalk = require('chalk');
13
- const path = require('path');
14
- const fs = require('fs');
15
-
16
- // Import command handlers
17
- const { init } = require('../lib/init');
18
- const { validate } = require('../lib/validate');
19
- const { diagnose } = require('../lib/diagnose');
20
- const { configLoader } = require('../lib/config-loader');
21
-
22
- // Package info
23
- const pkg = require('../package.json');
24
-
25
- // ASCII banner
26
- const banner = `
27
- ${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
28
- ${chalk.cyan('║')} ${chalk.bold.white('Claude Context Engineering')} ${chalk.cyan('║')}
29
- ${chalk.cyan('║')} ${chalk.gray('Optimize AI-assisted development with pre-computed')} ${chalk.cyan('║')}
30
- ${chalk.cyan('║')} ${chalk.gray('system knowledge and structured documentation.')} ${chalk.cyan('║')}
31
- ${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
32
- `;
33
-
34
- program
35
- .name('claude-context')
36
- .description('CLI tools for Claude Context Engineering')
37
- .version(pkg.version)
38
- .hook('preAction', () => {
39
- // Show banner on all commands
40
- if (process.argv.includes('--no-banner')) return;
41
- console.log(banner);
42
- });
43
-
44
- // Init command
45
- program
46
- .command('init')
47
- .description('Initialize context engineering for a repository')
48
- .option('-c, --config <path>', 'Path to configuration file')
49
- .option('-i, --interactive', 'Run in interactive mode', true)
50
- .option('--no-interactive', 'Run in non-interactive mode')
51
- .option('--resume', 'Resume interrupted initialization')
52
- .option('--validate-only', 'Only validate existing initialization')
53
- .option('--tech-stack <stack>', 'Specify tech stack (e.g., "python-fastapi")')
54
- .option('--project-name <name>', 'Specify project name')
55
- .action(async (options) => {
56
- try {
57
- await init(options);
58
- } catch (error) {
59
- console.error(chalk.red('Error:'), error.message);
60
- process.exit(1);
61
- }
62
- });
63
-
64
- // Validate command
65
- program
66
- .command('validate')
67
- .description('Validate the context engineering setup')
68
- .option('-a, --all', 'Run all validations', false)
69
- .option('--links', 'Validate markdown links')
70
- .option('--lines', 'Check line number accuracy')
71
- .option('--placeholders', 'Check for remaining placeholders')
72
- .option('--schema', 'Validate JSON files against schemas')
73
- .option('--structure', 'Validate directory structure')
74
- .option('-t, --threshold <percent>', 'Minimum accuracy threshold', '60')
75
- .option('-o, --output <format>', 'Output format: console, json, markdown', 'console')
76
- .option('-f, --file <path>', 'Validate specific file')
77
- .action(async (options) => {
78
- try {
79
- // If no specific option, run all
80
- if (!options.links && !options.lines && !options.placeholders &&
81
- !options.schema && !options.structure && !options.file) {
82
- options.all = true;
83
- }
84
- await validate(options);
85
- } catch (error) {
86
- console.error(chalk.red('Error:'), error.message);
87
- process.exit(1);
88
- }
89
- });
90
-
91
- // Diagnose command
92
- program
93
- .command('diagnose')
94
- .description('Diagnose issues with the context engineering setup')
95
- .option('--fix', 'Attempt to fix detected issues')
96
- .option('-v, --verbose', 'Show detailed diagnostics')
97
- .action(async (options) => {
98
- try {
99
- await diagnose(options);
100
- } catch (error) {
101
- console.error(chalk.red('Error:'), error.message);
102
- process.exit(1);
103
- }
104
- });
105
-
106
- // Config command
107
- program
108
- .command('config')
109
- .description('Manage configuration')
110
- .argument('[action]', 'Action: get, set, list, path')
111
- .argument('[key]', 'Configuration key')
112
- .argument('[value]', 'Configuration value (for set)')
113
- .option('-e, --env <environment>', 'Environment (development, staging, production)')
114
- .action(async (action, key, value, options) => {
115
- try {
116
- const config = await configLoader.load({ env: options.env });
117
-
118
- switch (action) {
119
- case 'get':
120
- if (!key) {
121
- console.log(JSON.stringify(config, null, 2));
122
- } else {
123
- const val = key.split('.').reduce((o, k) => o?.[k], config);
124
- console.log(val !== undefined ? JSON.stringify(val, null, 2) : 'Key not found');
125
- }
126
- break;
127
- case 'list':
128
- console.log(JSON.stringify(config, null, 2));
129
- break;
130
- case 'path':
131
- console.log(configLoader.getConfigPath());
132
- break;
133
- case 'set':
134
- console.log(chalk.yellow('Config set not yet implemented. Edit files directly.'));
135
- break;
136
- default:
137
- console.log(JSON.stringify(config, null, 2));
138
- }
139
- } catch (error) {
140
- console.error(chalk.red('Error:'), error.message);
141
- process.exit(1);
142
- }
143
- });
144
-
145
- // Parse and execute
146
- program.parse();
147
-
148
- // Show help if no command
149
- if (!process.argv.slice(2).length) {
150
- program.outputHelp();
151
- }
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Claude Context Engineering CLI
5
+ *
6
+ * Main entry point for the claude-context command line tool.
7
+ * Provides commands for initialization, validation, and management
8
+ * of the Claude context engineering system.
9
+ */
10
+
11
+ const { program } = require('commander');
12
+ const chalk = require('chalk');
13
+ const path = require('path');
14
+ const fs = require('fs');
15
+
16
+ // Import command handlers
17
+ const { init } = require('../lib/init');
18
+ const { validate } = require('../lib/validate');
19
+ const { diagnose } = require('../lib/diagnose');
20
+ const { configLoader } = require('../lib/config-loader');
21
+
22
+ // Package info
23
+ const pkg = require('../package.json');
24
+
25
+ // ASCII banner
26
+ const banner = `
27
+ ${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
28
+ ${chalk.cyan('║')} ${chalk.bold.white('Claude Context Engineering')} ${chalk.cyan('║')}
29
+ ${chalk.cyan('║')} ${chalk.gray('Optimize AI-assisted development with pre-computed')} ${chalk.cyan('║')}
30
+ ${chalk.cyan('║')} ${chalk.gray('system knowledge and structured documentation.')} ${chalk.cyan('║')}
31
+ ${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
32
+ `;
33
+
34
+ program
35
+ .name('claude-context')
36
+ .description('CLI tools for Claude Context Engineering')
37
+ .version(pkg.version)
38
+ .hook('preAction', () => {
39
+ // Show banner on all commands
40
+ if (process.argv.includes('--no-banner')) return;
41
+ console.log(banner);
42
+ });
43
+
44
+ // Init command
45
+ program
46
+ .command('init')
47
+ .description('Initialize context engineering for a repository')
48
+ .option('-c, --config <path>', 'Path to configuration file')
49
+ .option('-i, --interactive', 'Run in interactive mode', true)
50
+ .option('--no-interactive', 'Run in non-interactive mode')
51
+ .option('--resume', 'Resume interrupted initialization')
52
+ .option('--validate-only', 'Only validate existing initialization')
53
+ .option('--tech-stack <stack>', 'Specify tech stack (e.g., "python-fastapi")')
54
+ .option('--project-name <name>', 'Specify project name')
55
+ .action(async (options) => {
56
+ try {
57
+ await init(options);
58
+ } catch (error) {
59
+ console.error(chalk.red('Error:'), error.message);
60
+ process.exit(1);
61
+ }
62
+ });
63
+
64
+ // Validate command
65
+ program
66
+ .command('validate')
67
+ .description('Validate the context engineering setup')
68
+ .option('-a, --all', 'Run all validations', false)
69
+ .option('--links', 'Validate markdown links')
70
+ .option('--lines', 'Check line number accuracy')
71
+ .option('--placeholders', 'Check for remaining placeholders')
72
+ .option('--schema', 'Validate JSON files against schemas')
73
+ .option('--structure', 'Validate directory structure')
74
+ .option('-t, --threshold <percent>', 'Minimum accuracy threshold', '60')
75
+ .option('-o, --output <format>', 'Output format: console, json, markdown', 'console')
76
+ .option('-f, --file <path>', 'Validate specific file')
77
+ .action(async (options) => {
78
+ try {
79
+ // If no specific option, run all
80
+ if (!options.links && !options.lines && !options.placeholders &&
81
+ !options.schema && !options.structure && !options.file) {
82
+ options.all = true;
83
+ }
84
+ await validate(options);
85
+ } catch (error) {
86
+ console.error(chalk.red('Error:'), error.message);
87
+ process.exit(1);
88
+ }
89
+ });
90
+
91
+ // Diagnose command
92
+ program
93
+ .command('diagnose')
94
+ .description('Diagnose issues with the context engineering setup')
95
+ .option('--fix', 'Attempt to fix detected issues')
96
+ .option('-v, --verbose', 'Show detailed diagnostics')
97
+ .action(async (options) => {
98
+ try {
99
+ await diagnose(options);
100
+ } catch (error) {
101
+ console.error(chalk.red('Error:'), error.message);
102
+ process.exit(1);
103
+ }
104
+ });
105
+
106
+ // Config command
107
+ program
108
+ .command('config')
109
+ .description('Manage configuration')
110
+ .argument('[action]', 'Action: get, set, list, path')
111
+ .argument('[key]', 'Configuration key')
112
+ .argument('[value]', 'Configuration value (for set)')
113
+ .option('-e, --env <environment>', 'Environment (development, staging, production)')
114
+ .action(async (action, key, value, options) => {
115
+ try {
116
+ const config = await configLoader.load({ env: options.env });
117
+
118
+ switch (action) {
119
+ case 'get':
120
+ if (!key) {
121
+ console.log(JSON.stringify(config, null, 2));
122
+ } else {
123
+ const val = key.split('.').reduce((o, k) => o?.[k], config);
124
+ console.log(val !== undefined ? JSON.stringify(val, null, 2) : 'Key not found');
125
+ }
126
+ break;
127
+ case 'list':
128
+ console.log(JSON.stringify(config, null, 2));
129
+ break;
130
+ case 'path':
131
+ console.log(configLoader.getConfigPath());
132
+ break;
133
+ case 'set':
134
+ console.log(chalk.yellow('Config set not yet implemented. Edit files directly.'));
135
+ break;
136
+ default:
137
+ console.log(JSON.stringify(config, null, 2));
138
+ }
139
+ } catch (error) {
140
+ console.error(chalk.red('Error:'), error.message);
141
+ process.exit(1);
142
+ }
143
+ });
144
+
145
+ // Parse and execute
146
+ program.parse();
147
+
148
+ // Show help if no command
149
+ if (!process.argv.slice(2).length) {
150
+ program.outputHelp();
151
+ }