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
@@ -1,49 +1,49 @@
1
- {
2
- "name": "@claude-context/tools",
3
- "version": "1.0.0",
4
- "description": "CLI tools for Claude Context Engineering template",
5
- "main": "lib/index.js",
6
- "bin": {
7
- "claude-context": "./bin/claude-context.js"
8
- },
9
- "scripts": {
10
- "test": "jest",
11
- "test:watch": "jest --watch",
12
- "test:coverage": "jest --coverage",
13
- "lint": "eslint lib/",
14
- "validate": "node bin/claude-context.js validate"
15
- },
16
- "keywords": [
17
- "claude",
18
- "claude-code",
19
- "context-engineering",
20
- "ai-development",
21
- "documentation"
22
- ],
23
- "author": "Claude Context Engineering Team",
24
- "license": "MIT",
25
- "repository": {
26
- "type": "git",
27
- "url": "https://github.com/yourusername/claude-code-context-engineering-template"
28
- },
29
- "engines": {
30
- "node": ">=16.0.0"
31
- },
32
- "dependencies": {
33
- "ajv": "^8.12.0",
34
- "ajv-formats": "^2.1.1",
35
- "chalk": "^4.1.2",
36
- "commander": "^11.1.0",
37
- "glob": "^10.3.10",
38
- "yaml": "^2.3.4"
39
- },
40
- "devDependencies": {
41
- "eslint": "^8.55.0",
42
- "jest": "^29.7.0"
43
- },
44
- "files": [
45
- "bin/",
46
- "lib/",
47
- "schemas/"
48
- ]
49
- }
1
+ {
2
+ "name": "@claude-context/tools",
3
+ "version": "1.0.0",
4
+ "description": "CLI tools for Claude Context Engineering template",
5
+ "main": "lib/index.js",
6
+ "bin": {
7
+ "claude-context": "./bin/claude-context.js"
8
+ },
9
+ "scripts": {
10
+ "test": "jest",
11
+ "test:watch": "jest --watch",
12
+ "test:coverage": "jest --coverage",
13
+ "lint": "eslint lib/",
14
+ "validate": "node bin/claude-context.js validate"
15
+ },
16
+ "keywords": [
17
+ "claude",
18
+ "claude-code",
19
+ "context-engineering",
20
+ "ai-development",
21
+ "documentation"
22
+ ],
23
+ "author": "Claude Context Engineering Team",
24
+ "license": "MIT",
25
+ "repository": {
26
+ "type": "git",
27
+ "url": "https://github.com/yourusername/claude-code-context-engineering-template"
28
+ },
29
+ "engines": {
30
+ "node": ">=16.0.0"
31
+ },
32
+ "dependencies": {
33
+ "ajv": "^8.12.0",
34
+ "ajv-formats": "^2.1.1",
35
+ "chalk": "^4.1.2",
36
+ "commander": "^11.1.0",
37
+ "glob": "^10.3.10",
38
+ "yaml": "^2.3.4"
39
+ },
40
+ "devDependencies": {
41
+ "eslint": "^8.55.0",
42
+ "jest": "^29.7.0"
43
+ },
44
+ "files": [
45
+ "bin/",
46
+ "lib/",
47
+ "schemas/"
48
+ ]
49
+ }
@@ -1,80 +1,146 @@
1
- {{!-- Aider Configuration Template --}}
2
- # {{project.name}} - Aider Configuration
3
- # Generated: {{metadata.timestamp}}
4
-
5
- # Model selection (uncomment and configure as needed)
6
- # model: gpt-4
7
- # model: claude-3-opus-20240229
8
- # model: deepseek-coder
9
-
10
- # Auto-commit settings
11
- auto-commits: true
12
- auto-commit: false
13
- commit_prompt: "docs: update {path} per AI pair-programming session"
14
-
15
- # File handling
16
- {{#if key_files.entry_points}}
17
- # Add only these files to context
18
- add: {{join key_files.entry_points ","}}
19
- {{/if}}
20
-
21
- # Exclude patterns
22
- exclude:
23
- - node_modules/
24
- - build/
25
- - dist/
26
- - .git/
27
- - coverage/
28
- - "*.min.js"
29
- - "*.min.css"
30
-
31
- # Git settings
32
- gitignore: true
33
- git-detect: true
34
-
35
- # Editor settings
36
- editor: vscode
37
- # editor-model: gpt-4
38
-
39
- # Language detection
40
- {{#if project.primary_language}}
41
- language: {{project.primary_language}}
42
- {{/if}}
43
-
44
- # Testing
45
- test-cmd: {{commands.test}}
46
-
47
- # Linting (configure as needed)
48
- # lint-cmd: npm run lint
49
- # lint-cmd: python -m flake8 .
50
-
51
- # Security
52
- # unsafe-install: false # Set to true to allow pip installs without confirmation
53
-
54
- # Shell commands
55
- # shell-commands: true # Allow aider to run shell commands
56
-
57
- # Voice input (experimental)
58
- # voice-input: false
59
-
60
- # Chat history
61
- # chat-history: .aider.chat.history
62
- # chat-history-file: .aider.chat.history
63
-
64
- # Display settings
65
- # color: true
66
- # progress-spinner: true
67
-
68
- # Map tokens (for context optimization)
69
- # map-tokens: 2048
70
-
71
- # Message formatting
72
- # stream: true
73
- # dark-mode: false
74
-
75
- # Advanced settings
76
- # attribute-author: true
77
- # attribute-committer: true
78
-
79
- ---
80
- {{{coordination.footer}}}
1
+ {{!-- Aider Configuration Template --}}
2
+ # {{project.name}} - Aider Configuration
3
+ # Generated: {{metadata.timestamp}}
4
+ # Documentation: https://aider.chat/docs/config.html
5
+
6
+ #=============================================================================
7
+ # MODEL CONFIGURATION
8
+ #=============================================================================
9
+ # Recommended: Claude Sonnet for best code understanding
10
+ # Uncomment ONE of the following based on your API access:
11
+
12
+ # model: claude-3-5-sonnet-20241022 # Best overall (Anthropic API)
13
+ # model: gpt-4o # Good alternative (OpenAI API)
14
+ # model: deepseek-coder # Budget option
15
+
16
+ #=============================================================================
17
+ # GIT & AUTO-COMMIT SETTINGS
18
+ #=============================================================================
19
+ # Auto-commit is disabled by default for safety
20
+ # This prevents accidental commits - you review changes first
21
+ # Note: Both 'auto-commits' (plural) and 'auto-commit' (singular) are
22
+ # included for compatibility with different Aider versions
23
+ auto-commits: false
24
+ auto-commit: false
25
+
26
+ # Commit message format when auto-commit is enabled
27
+ commit-prompt: "feat({{project.name}}): {{message}}"
28
+
29
+ # Git integration
30
+ gitignore: true
31
+ git: true
32
+
33
+ #=============================================================================
34
+ # CONTEXT OPTIMIZATION
35
+ #=============================================================================
36
+ # Map tokens control how much context Aider uses for file mapping
37
+ # Higher = more context awareness, but uses more tokens
38
+ map-tokens: 2048
39
+ map-refresh: auto
40
+
41
+ # Subtree mode - only work with files in current directory tree
42
+ subtree-only: false
43
+
44
+ #=============================================================================
45
+ # FILE HANDLING
46
+ #=============================================================================
47
+ {{#if key_files.entry_points}}
48
+ # Auto-add entry point files to context
49
+ read:
50
+ {{#each key_files.entry_points}}
51
+ - {{this}}
52
+ {{/each}}
53
+ {{/if}}
54
+
55
+ # Exclude patterns (sensible defaults for most projects)
56
+ # These files/directories are never added to context
57
+ # Note: Uses .gitignore patterns
58
+ {{#if project.type}}
59
+ {{#if (eq project.type "python")}}
60
+ # Python-specific excludes
61
+ # exclude patterns handled by .gitignore
62
+ {{else if (eq project.type "node")}}
63
+ # Node.js-specific excludes
64
+ # exclude patterns handled by .gitignore
65
+ {{/if}}
66
+ {{/if}}
67
+
68
+ #=============================================================================
69
+ # LANGUAGE & FRAMEWORK
70
+ #=============================================================================
71
+ {{#if project.primary_language}}
72
+ # Detected primary language
73
+ # language: {{project.primary_language}}
74
+ {{/if}}
75
+
76
+ #=============================================================================
77
+ # EDITOR INTEGRATION
78
+ #=============================================================================
79
+ # Your preferred editor for file viewing
80
+ editor: vscode
81
+
82
+ #=============================================================================
83
+ # TESTING INTEGRATION
84
+ #=============================================================================
85
+ {{#if commands.test}}
86
+ # Run tests automatically after changes
87
+ test-cmd: {{commands.test}}
88
+ auto-test: false
89
+ {{else}}
90
+ # Configure your test command
91
+ # test-cmd: npm test
92
+ # auto-test: false
93
+ {{/if}}
94
+
95
+ #=============================================================================
96
+ # LINTING INTEGRATION
97
+ #=============================================================================
98
+ {{#if commands.lint}}
99
+ # Run linter automatically after changes
100
+ lint-cmd: {{commands.lint}}
101
+ auto-lint: false
102
+ {{else}}
103
+ # Configure your lint command
104
+ # lint-cmd: npm run lint
105
+ # auto-lint: false
106
+ {{/if}}
107
+
108
+ #=============================================================================
109
+ # DISPLAY & OUTPUT
110
+ #=============================================================================
111
+ # Stream output for real-time feedback
112
+ stream: true
113
+
114
+ # Pretty formatting
115
+ pretty: true
116
+
117
+ # Dark mode for terminals with dark backgrounds
118
+ # dark-mode: auto
119
+
120
+ #=============================================================================
121
+ # CHAT HISTORY
122
+ #=============================================================================
123
+ # Save chat history for reference
124
+ chat-history-file: .aider.chat.history.md
125
+
126
+ #=============================================================================
127
+ # SAFETY SETTINGS
128
+ #=============================================================================
129
+ # Suggest shell commands instead of running automatically
130
+ suggest-shell-commands: true
131
+
132
+ # Require confirmation for pip installs
133
+ # unsafe-install: false
134
+
135
+ #=============================================================================
136
+ # ADVANCED SETTINGS
137
+ #=============================================================================
138
+ # Git author attribution
139
+ # attribute-author: true
140
+ # attribute-committer: true
141
+
142
+ # Voice input (experimental)
143
+ # voice-input: false
144
+
145
+ ---
146
+ {{{coordination.footer}}}