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,69 +1,69 @@
1
- {{!-- Windsurf Cascade Rules Template --}}
2
- # {{project.name}} - Windsurf Cascade Rules
3
-
4
- **Tech Stack:** {{join project.tech_stack ", "}}
5
- **Status:** Active
6
-
7
- <communication>
8
- - Speak to me in a professional, technical manner
9
- - Provide clear explanations for code changes
10
- - Reference specific files and line numbers when discussing changes
11
- - Ask clarifying questions when requirements are ambiguous
12
- </communication>
13
-
14
- <filesystem>
15
- {{#if key_files.entry_points}}
16
- - Key project files: {{join key_files.entry_points ", "}}
17
- {{/if}}
18
- - Models directory: {{#each architecture.layers}}{{#if (ifEquals name 'models')}}{{path}}{{/if}}{{/each}}
19
- - Migrations directory: {{#each architecture.layers}}{{#if (ifEquals name 'migrations')}}{{path}}{{/if}}{{/each}}
20
- - Treat node_modules, build, dist as read-only
21
- </filesystem>
22
-
23
- <coding>
24
- - Primary language: {{project.primary_language}}
25
- - Framework: {{#each architecture.layers}}{{#if (ifEquals name 'framework')}}{{name}}{{/if}}{{/each}}
26
- - Testing framework: jest
27
- - Follow existing code style and patterns
28
- - Add type hints/annotations for all functions
29
- - Write tests for new functionality (target: 80% coverage)
30
- - Use early returns when possible
31
- - Avoid deep nesting (>4 levels)
32
- - Keep functions focused and small (<50 lines)
33
- </coding>
34
-
35
- <commands>
36
- | Command | Purpose |
37
- |---------|---------|
38
- | {{commands.install}} | Install dependencies |
39
- | {{commands.dev}} | Start development server |
40
- | {{commands.test}} | Run tests |
41
- | {{commands.build}} | Build for production |
42
- </commands>
43
-
44
- <architecture>
45
- {{project.description}}
46
-
47
- Key patterns:
48
- - {{architecture.pattern}}
49
- {{#each architecture.layers}}
50
- - {{name}}: {{purpose}}
51
- {{/each}}
52
- </architecture>
53
-
54
- <testing>
55
- - Write tests before implementing features
56
- - Use jest for mocking
57
- - Test edge cases and error conditions
58
- - Keep tests independent and fast
59
- </testing>
60
-
61
- <security>
62
- - Never commit secrets or API keys
63
- - Validate all user inputs
64
- - Use parameterized queries to prevent injection
65
- - Follow OWASP security guidelines
66
- </security>
67
-
68
- ---
69
- {{{coordination.footer}}}
1
+ {{!-- Windsurf Cascade Rules Template --}}
2
+ # {{project.name}} - Windsurf Cascade Rules
3
+
4
+ **Tech Stack:** {{join project.tech_stack ", "}}
5
+ **Status:** Active
6
+
7
+ <communication>
8
+ - Speak to me in a professional, technical manner
9
+ - Provide clear explanations for code changes
10
+ - Reference specific files and line numbers when discussing changes
11
+ - Ask clarifying questions when requirements are ambiguous
12
+ </communication>
13
+
14
+ <filesystem>
15
+ {{#if key_files.entry_points}}
16
+ - Key project files: {{join key_files.entry_points ", "}}
17
+ {{/if}}
18
+ - Models directory: {{#each architecture.layers}}{{#if (ifEquals name 'models')}}{{path}}{{/if}}{{/each}}
19
+ - Migrations directory: {{#each architecture.layers}}{{#if (ifEquals name 'migrations')}}{{path}}{{/if}}{{/each}}
20
+ - Treat node_modules, build, dist as read-only
21
+ </filesystem>
22
+
23
+ <coding>
24
+ - Primary language: {{project.primary_language}}
25
+ - Framework: {{#each architecture.layers}}{{#if (ifEquals name 'framework')}}{{name}}{{/if}}{{/each}}
26
+ - Testing framework: jest
27
+ - Follow existing code style and patterns
28
+ - Add type hints/annotations for all functions
29
+ - Write tests for new functionality (target: 80% coverage)
30
+ - Use early returns when possible
31
+ - Avoid deep nesting (>4 levels)
32
+ - Keep functions focused and small (<50 lines)
33
+ </coding>
34
+
35
+ <commands>
36
+ | Command | Purpose |
37
+ |---------|---------|
38
+ | {{commands.install}} | Install dependencies |
39
+ | {{commands.dev}} | Start development server |
40
+ | {{commands.test}} | Run tests |
41
+ | {{commands.build}} | Build for production |
42
+ </commands>
43
+
44
+ <architecture>
45
+ {{project.description}}
46
+
47
+ Key patterns:
48
+ - {{architecture.pattern}}
49
+ {{#each architecture.layers}}
50
+ - {{name}}: {{purpose}}
51
+ {{/each}}
52
+ </architecture>
53
+
54
+ <testing>
55
+ - Write tests before implementing features
56
+ - Use jest for mocking
57
+ - Test edge cases and error conditions
58
+ - Keep tests independent and fast
59
+ </testing>
60
+
61
+ <security>
62
+ - Never commit secrets or API keys
63
+ - Validate all user inputs
64
+ - Use parameterized queries to prevent injection
65
+ - Follow OWASP security guidelines
66
+ </security>
67
+
68
+ ---
69
+ {{{coordination.footer}}}
@@ -1,29 +1,28 @@
1
- #!/bin/bash
2
- # Post-commit hook for AI context sync
3
- # This hook triggers sync after successful commits
4
-
5
- # Don't block commit if this fails
6
- set +e
7
-
8
- # Check if ai-context binary is available
9
- if ! command -v create-ai-context &> /dev/null; then
10
- # Try npx
11
- if command -v npx &> /dev/null; then
12
- AI_CONTEXT_CMD="npx create-universal-ai-context"
13
- else
14
- exit 0
15
- fi
16
- else
17
- AI_CONTEXT_CMD="create-ai-context"
18
- fi
19
-
20
- # Run background sync (async)
21
- echo "Syncing AI contexts in background..."
22
-
23
- # Use subshell to run in background
24
- (
25
- sleep 2 # Wait a bit to not interfere with commit
26
- $AI_CONTEXT_CMD sync:all --quiet > /dev/null 2>&1
27
- ) &
28
-
29
- exit 0
1
+ #!/bin/bash
2
+ # Post-commit hook for AI context sync
3
+ # This hook updates sync state after successful commits
4
+ # Does NOT regenerate files to avoid creating uncommitted changes
5
+
6
+ # Don't block commit if this fails
7
+ set +e
8
+
9
+ # Check if ai-context binary is available
10
+ if ! command -v create-ai-context &> /dev/null; then
11
+ # Try npx
12
+ if command -v npx &> /dev/null; then
13
+ AI_CONTEXT_CMD="npx create-universal-ai-context"
14
+ else
15
+ exit 0
16
+ fi
17
+ else
18
+ AI_CONTEXT_CMD="create-ai-context"
19
+ fi
20
+
21
+ # Update sync state only (no file regeneration to avoid creating uncommitted changes)
22
+ # Use sync:state instead of sync:all to prevent the revision loop bug
23
+ (
24
+ sleep 1 # Wait a bit to not interfere with commit
25
+ $AI_CONTEXT_CMD sync:state --quiet > /dev/null 2>&1
26
+ ) &
27
+
28
+ exit 0
@@ -1,46 +1,46 @@
1
- #!/bin/bash
2
- # Pre-commit hook for AI context sync
3
- # This hook checks if AI tool contexts are out of sync
4
-
5
- set -e
6
-
7
- # Colors for output
8
- RED='\033[0;31m'
9
- YELLOW='\033[1;33m'
10
- GREEN='\033[0;32m'
11
- NC='\033[0m' # No Color
12
-
13
- # Check if ai-context binary is available
14
- if ! command -v create-ai-context &> /dev/null; then
15
- # Try npx
16
- if command -v npx &> /dev/null; then
17
- AI_CONTEXT_CMD="npx create-universal-ai-context"
18
- else
19
- echo -e "${YELLOW}Warning: create-ai-context not found. Skipping sync check.${NC}"
20
- exit 0
21
- fi
22
- else
23
- AI_CONTEXT_CMD="create-ai-context"
24
- fi
25
-
26
- # Run sync check
27
- echo -e "${GREEN}Checking AI context sync status...${NC}"
28
-
29
- # Check for out-of-sync contexts
30
- CHECK_OUTPUT=$($AI_CONTEXT_CMD sync:check 2>&1)
31
- CHECK_EXIT_CODE=$?
32
-
33
- if [ $CHECK_EXIT_CODE -ne 0 ]; then
34
- echo -e "${RED}AI contexts are out of sync!${NC}"
35
- echo ""
36
- echo "$CHECK_OUTPUT"
37
- echo ""
38
- echo -e "${YELLOW}To sync all contexts, run:${NC}"
39
- echo " $AI_CONTEXT_CMD sync:all"
40
- echo ""
41
- echo -e "${YELLOW}To skip this check, use: git commit --no-verify${NC}"
42
- exit 1
43
- fi
44
-
45
- echo -e "${GREEN}AI contexts are in sync${NC}"
46
- exit 0
1
+ #!/bin/bash
2
+ # Pre-commit hook for AI context sync
3
+ # This hook checks if AI tool contexts are out of sync
4
+
5
+ set -e
6
+
7
+ # Colors for output
8
+ RED='\033[0;31m'
9
+ YELLOW='\033[1;33m'
10
+ GREEN='\033[0;32m'
11
+ NC='\033[0m' # No Color
12
+
13
+ # Check if ai-context binary is available
14
+ if ! command -v create-ai-context &> /dev/null; then
15
+ # Try npx
16
+ if command -v npx &> /dev/null; then
17
+ AI_CONTEXT_CMD="npx create-universal-ai-context"
18
+ else
19
+ echo -e "${YELLOW}Warning: create-ai-context not found. Skipping sync check.${NC}"
20
+ exit 0
21
+ fi
22
+ else
23
+ AI_CONTEXT_CMD="create-ai-context"
24
+ fi
25
+
26
+ # Run sync check
27
+ echo -e "${GREEN}Checking AI context sync status...${NC}"
28
+
29
+ # Check for out-of-sync contexts
30
+ CHECK_OUTPUT=$($AI_CONTEXT_CMD sync:check 2>&1)
31
+ CHECK_EXIT_CODE=$?
32
+
33
+ if [ $CHECK_EXIT_CODE -ne 0 ]; then
34
+ echo -e "${RED}AI contexts are out of sync!${NC}"
35
+ echo ""
36
+ echo "$CHECK_OUTPUT"
37
+ echo ""
38
+ echo -e "${YELLOW}To sync all contexts, run:${NC}"
39
+ echo " $AI_CONTEXT_CMD sync:all"
40
+ echo ""
41
+ echo -e "${YELLOW}To skip this check, use: git commit --no-verify${NC}"
42
+ exit 1
43
+ fi
44
+
45
+ echo -e "${GREEN}AI contexts are in sync${NC}"
46
+ exit 0