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.
- package/LICENSE +21 -21
- package/README.md +331 -294
- package/bin/create-ai-context.js +1507 -764
- package/lib/adapters/aider.js +131 -131
- package/lib/adapters/antigravity.js +205 -205
- package/lib/adapters/claude.js +397 -397
- package/lib/adapters/cline.js +125 -125
- package/lib/adapters/continue.js +138 -138
- package/lib/adapters/copilot.js +131 -131
- package/lib/adapters/index.js +78 -78
- package/lib/adapters/windsurf.js +138 -138
- package/lib/ai-context-generator.js +234 -234
- package/lib/ai-orchestrator.js +432 -432
- package/lib/call-tracer.js +444 -444
- package/lib/content-preservation.js +243 -243
- package/lib/cross-tool-sync/file-watcher.js +274 -274
- package/lib/cross-tool-sync/index.js +41 -40
- package/lib/cross-tool-sync/sync-manager.js +540 -512
- package/lib/cross-tool-sync/sync-service.js +297 -297
- package/lib/detector.js +726 -726
- package/lib/doc-discovery.js +741 -741
- package/lib/drift-checker.js +920 -920
- package/lib/environment-detector.js +239 -239
- package/lib/index.js +399 -399
- package/lib/install-hooks.js +82 -82
- package/lib/installer.js +419 -419
- package/lib/migrate.js +328 -328
- package/lib/placeholder.js +632 -632
- package/lib/prompts.js +341 -341
- package/lib/smart-merge.js +540 -540
- package/lib/spinner.js +60 -60
- package/lib/static-analyzer.js +729 -729
- package/lib/template-coordination.js +148 -148
- package/lib/template-populator.js +843 -843
- package/lib/template-renderer.js +392 -392
- package/lib/utils/fs-wrapper.js +79 -79
- package/lib/utils/path-utils.js +60 -60
- package/lib/validate.js +155 -155
- package/package.json +1 -1
- package/templates/AI_CONTEXT.md.template +245 -245
- package/templates/base/README.md +260 -257
- package/templates/base/RPI_WORKFLOW_PLAN.md +325 -320
- package/templates/base/agents/api-developer.md +76 -76
- package/templates/base/agents/context-engineer.md +525 -525
- package/templates/base/agents/core-architect.md +76 -76
- package/templates/base/agents/database-ops.md +76 -76
- package/templates/base/agents/deployment-ops.md +76 -76
- package/templates/base/agents/integration-hub.md +76 -76
- package/templates/base/analytics/README.md +114 -114
- package/templates/base/automation/config.json +58 -58
- package/templates/base/automation/generators/code-mapper.js +308 -308
- package/templates/base/automation/generators/index-builder.js +321 -321
- package/templates/base/automation/hooks/post-commit.sh +83 -83
- package/templates/base/automation/hooks/pre-commit.sh +103 -103
- package/templates/base/ci-templates/README.md +108 -108
- package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
- package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
- package/templates/base/commands/analytics.md +238 -238
- package/templates/base/commands/auto-sync.md +172 -172
- package/templates/base/commands/collab.md +194 -194
- package/templates/base/commands/context-optimize.md +226 -0
- package/templates/base/commands/help.md +485 -450
- package/templates/base/commands/rpi-implement.md +164 -115
- package/templates/base/commands/rpi-plan.md +147 -93
- package/templates/base/commands/rpi-research.md +145 -88
- package/templates/base/commands/session-resume.md +144 -144
- package/templates/base/commands/session-save.md +112 -112
- package/templates/base/commands/validate-all.md +77 -77
- package/templates/base/commands/verify-docs-current.md +86 -86
- package/templates/base/config/base.json +57 -57
- package/templates/base/config/environments/development.json +13 -13
- package/templates/base/config/environments/production.json +17 -17
- package/templates/base/config/environments/staging.json +13 -13
- package/templates/base/config/local.json.example +21 -21
- package/templates/base/context/.meta/generated-at.json +18 -18
- package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
- package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
- package/templates/base/context/FILE_OWNERSHIP.md +57 -57
- package/templates/base/context/INTEGRATION_POINTS.md +92 -92
- package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
- package/templates/base/context/TESTING_MAP.md +95 -95
- package/templates/base/context/WORKFLOW_INDEX.md +129 -129
- package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
- package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
- package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
- package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
- package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
- package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
- package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
- package/templates/base/knowledge/README.md +98 -98
- package/templates/base/knowledge/sessions/README.md +88 -88
- package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
- package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
- package/templates/base/knowledge/shared/decisions/README.md +49 -49
- package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
- package/templates/base/knowledge/shared/patterns/README.md +62 -62
- package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
- package/templates/base/plans/PLAN_TEMPLATE.md +316 -250
- package/templates/base/research/RESEARCH_TEMPLATE.md +245 -153
- package/templates/base/schemas/agent.schema.json +141 -141
- package/templates/base/schemas/anchors.schema.json +54 -54
- package/templates/base/schemas/automation.schema.json +93 -93
- package/templates/base/schemas/command.schema.json +134 -134
- package/templates/base/schemas/hashes.schema.json +40 -40
- package/templates/base/schemas/manifest.schema.json +117 -117
- package/templates/base/schemas/plan.schema.json +136 -136
- package/templates/base/schemas/research.schema.json +115 -115
- package/templates/base/schemas/roles.schema.json +34 -34
- package/templates/base/schemas/session.schema.json +77 -77
- package/templates/base/schemas/settings.schema.json +244 -244
- package/templates/base/schemas/staleness.schema.json +53 -53
- package/templates/base/schemas/team-config.schema.json +42 -42
- package/templates/base/schemas/workflow.schema.json +126 -126
- package/templates/base/session/checkpoints/.gitkeep +2 -2
- package/templates/base/session/current/state.json +20 -20
- package/templates/base/session/history/.gitkeep +2 -2
- package/templates/base/settings.json +3 -3
- package/templates/base/standards/COMPATIBILITY.md +219 -219
- package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
- package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
- package/templates/base/standards/README.md +66 -66
- package/templates/base/sync/anchors.json +6 -6
- package/templates/base/sync/hashes.json +6 -6
- package/templates/base/sync/staleness.json +10 -10
- package/templates/base/team/README.md +168 -168
- package/templates/base/team/config.json +79 -79
- package/templates/base/team/roles.json +145 -145
- package/templates/base/tools/bin/claude-context.js +151 -151
- package/templates/base/tools/lib/anchor-resolver.js +276 -276
- package/templates/base/tools/lib/config-loader.js +363 -363
- package/templates/base/tools/lib/detector.js +350 -350
- package/templates/base/tools/lib/diagnose.js +206 -206
- package/templates/base/tools/lib/drift-detector.js +373 -373
- package/templates/base/tools/lib/errors.js +199 -199
- package/templates/base/tools/lib/index.js +36 -36
- package/templates/base/tools/lib/init.js +192 -192
- package/templates/base/tools/lib/logger.js +230 -230
- package/templates/base/tools/lib/placeholder.js +201 -201
- package/templates/base/tools/lib/session-manager.js +354 -354
- package/templates/base/tools/lib/validate.js +521 -521
- package/templates/base/tools/package.json +49 -49
- package/templates/handlebars/aider-config.hbs +146 -80
- package/templates/handlebars/antigravity.hbs +377 -377
- package/templates/handlebars/claude.hbs +183 -183
- package/templates/handlebars/cline.hbs +62 -62
- package/templates/handlebars/continue-config.hbs +116 -116
- package/templates/handlebars/copilot.hbs +130 -130
- package/templates/handlebars/partials/gotcha-list.hbs +11 -11
- package/templates/handlebars/partials/header.hbs +3 -3
- package/templates/handlebars/partials/workflow-summary.hbs +16 -16
- package/templates/handlebars/windsurf-rules.hbs +69 -69
- package/templates/hooks/post-commit.hbs +28 -29
- 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
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
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
|