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,114 +1,114 @@
|
|
|
1
|
-
# Analytics Data
|
|
2
|
-
|
|
3
|
-
Local storage for usage analytics and metrics.
|
|
4
|
-
|
|
5
|
-
## Overview
|
|
6
|
-
|
|
7
|
-
This directory stores local analytics data collected during Claude Code sessions. All data is stored locally and never sent externally unless explicitly configured.
|
|
8
|
-
|
|
9
|
-
## Files
|
|
10
|
-
|
|
11
|
-
| File | Description |
|
|
12
|
-
|------|-------------|
|
|
13
|
-
| `sessions.json` | Session history and metadata |
|
|
14
|
-
| `commands.json` | Command usage statistics |
|
|
15
|
-
| `agents.json` | Agent invocation tracking |
|
|
16
|
-
| `context.json` | Context budget metrics over time |
|
|
17
|
-
| `exports/` | Exported analytics files |
|
|
18
|
-
|
|
19
|
-
## Data Schema
|
|
20
|
-
|
|
21
|
-
### sessions.json
|
|
22
|
-
|
|
23
|
-
```json
|
|
24
|
-
{
|
|
25
|
-
"sessions": [
|
|
26
|
-
{
|
|
27
|
-
"id": "uuid",
|
|
28
|
-
"started": "ISO-timestamp",
|
|
29
|
-
"ended": "ISO-timestamp",
|
|
30
|
-
"duration_minutes": 45,
|
|
31
|
-
"files_modified": 12,
|
|
32
|
-
"commits": 3,
|
|
33
|
-
"member_id": "dev-1"
|
|
34
|
-
}
|
|
35
|
-
]
|
|
36
|
-
}
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### commands.json
|
|
40
|
-
|
|
41
|
-
```json
|
|
42
|
-
{
|
|
43
|
-
"commands": {
|
|
44
|
-
"/rpi-research": {
|
|
45
|
-
"count": 23,
|
|
46
|
-
"last_used": "ISO-timestamp",
|
|
47
|
-
"success_rate": 0.95,
|
|
48
|
-
"history": [
|
|
49
|
-
{
|
|
50
|
-
"timestamp": "ISO-timestamp",
|
|
51
|
-
"duration_seconds": 120,
|
|
52
|
-
"success": true
|
|
53
|
-
}
|
|
54
|
-
]
|
|
55
|
-
}
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
### agents.json
|
|
61
|
-
|
|
62
|
-
```json
|
|
63
|
-
{
|
|
64
|
-
"agents": {
|
|
65
|
-
"@core-architect": {
|
|
66
|
-
"invocations": 18,
|
|
67
|
-
"last_used": "ISO-timestamp",
|
|
68
|
-
"avg_context_tokens": 35000,
|
|
69
|
-
"tasks_completed": 15
|
|
70
|
-
}
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
### context.json
|
|
76
|
-
|
|
77
|
-
```json
|
|
78
|
-
{
|
|
79
|
-
"snapshots": [
|
|
80
|
-
{
|
|
81
|
-
"timestamp": "ISO-timestamp",
|
|
82
|
-
"total_tokens": 45000,
|
|
83
|
-
"breakdown": {
|
|
84
|
-
"indexes": 12400,
|
|
85
|
-
"workflows": 18200,
|
|
86
|
-
"agents": 8600,
|
|
87
|
-
"commands": 5800
|
|
88
|
-
},
|
|
89
|
-
"budget_percentage": 22.5
|
|
90
|
-
}
|
|
91
|
-
]
|
|
92
|
-
}
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
## Retention
|
|
96
|
-
|
|
97
|
-
Data is retained according to `telemetry.retention_days` in settings (default: 90 days). Older data is automatically pruned.
|
|
98
|
-
|
|
99
|
-
## Clearing Data
|
|
100
|
-
|
|
101
|
-
To clear all analytics data:
|
|
102
|
-
|
|
103
|
-
```
|
|
104
|
-
/analytics clear
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
Or manually delete files in this directory (except README.md).
|
|
108
|
-
|
|
109
|
-
## Privacy
|
|
110
|
-
|
|
111
|
-
- All data stored locally
|
|
112
|
-
- No external transmission
|
|
113
|
-
- User has full control
|
|
114
|
-
- Can be disabled in settings
|
|
1
|
+
# Analytics Data
|
|
2
|
+
|
|
3
|
+
Local storage for usage analytics and metrics.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
This directory stores local analytics data collected during Claude Code sessions. All data is stored locally and never sent externally unless explicitly configured.
|
|
8
|
+
|
|
9
|
+
## Files
|
|
10
|
+
|
|
11
|
+
| File | Description |
|
|
12
|
+
|------|-------------|
|
|
13
|
+
| `sessions.json` | Session history and metadata |
|
|
14
|
+
| `commands.json` | Command usage statistics |
|
|
15
|
+
| `agents.json` | Agent invocation tracking |
|
|
16
|
+
| `context.json` | Context budget metrics over time |
|
|
17
|
+
| `exports/` | Exported analytics files |
|
|
18
|
+
|
|
19
|
+
## Data Schema
|
|
20
|
+
|
|
21
|
+
### sessions.json
|
|
22
|
+
|
|
23
|
+
```json
|
|
24
|
+
{
|
|
25
|
+
"sessions": [
|
|
26
|
+
{
|
|
27
|
+
"id": "uuid",
|
|
28
|
+
"started": "ISO-timestamp",
|
|
29
|
+
"ended": "ISO-timestamp",
|
|
30
|
+
"duration_minutes": 45,
|
|
31
|
+
"files_modified": 12,
|
|
32
|
+
"commits": 3,
|
|
33
|
+
"member_id": "dev-1"
|
|
34
|
+
}
|
|
35
|
+
]
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### commands.json
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"commands": {
|
|
44
|
+
"/rpi-research": {
|
|
45
|
+
"count": 23,
|
|
46
|
+
"last_used": "ISO-timestamp",
|
|
47
|
+
"success_rate": 0.95,
|
|
48
|
+
"history": [
|
|
49
|
+
{
|
|
50
|
+
"timestamp": "ISO-timestamp",
|
|
51
|
+
"duration_seconds": 120,
|
|
52
|
+
"success": true
|
|
53
|
+
}
|
|
54
|
+
]
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### agents.json
|
|
61
|
+
|
|
62
|
+
```json
|
|
63
|
+
{
|
|
64
|
+
"agents": {
|
|
65
|
+
"@core-architect": {
|
|
66
|
+
"invocations": 18,
|
|
67
|
+
"last_used": "ISO-timestamp",
|
|
68
|
+
"avg_context_tokens": 35000,
|
|
69
|
+
"tasks_completed": 15
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### context.json
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
{
|
|
79
|
+
"snapshots": [
|
|
80
|
+
{
|
|
81
|
+
"timestamp": "ISO-timestamp",
|
|
82
|
+
"total_tokens": 45000,
|
|
83
|
+
"breakdown": {
|
|
84
|
+
"indexes": 12400,
|
|
85
|
+
"workflows": 18200,
|
|
86
|
+
"agents": 8600,
|
|
87
|
+
"commands": 5800
|
|
88
|
+
},
|
|
89
|
+
"budget_percentage": 22.5
|
|
90
|
+
}
|
|
91
|
+
]
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Retention
|
|
96
|
+
|
|
97
|
+
Data is retained according to `telemetry.retention_days` in settings (default: 90 days). Older data is automatically pruned.
|
|
98
|
+
|
|
99
|
+
## Clearing Data
|
|
100
|
+
|
|
101
|
+
To clear all analytics data:
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
/analytics clear
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Or manually delete files in this directory (except README.md).
|
|
108
|
+
|
|
109
|
+
## Privacy
|
|
110
|
+
|
|
111
|
+
- All data stored locally
|
|
112
|
+
- No external transmission
|
|
113
|
+
- User has full control
|
|
114
|
+
- Can be disabled in settings
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "../schemas/automation.schema.json",
|
|
3
|
-
"version": "1.0.0",
|
|
4
|
-
"generators": {
|
|
5
|
-
"code_mapper": {
|
|
6
|
-
"enabled": true,
|
|
7
|
-
"output_path": "context/CODE_TO_WORKFLOW_MAP.md",
|
|
8
|
-
"scan_patterns": [
|
|
9
|
-
"context/workflows/*.md",
|
|
10
|
-
"agents/*.md",
|
|
11
|
-
"commands/*.md"
|
|
12
|
-
],
|
|
13
|
-
"reference_patterns": [
|
|
14
|
-
"\\[Line (\\d+)\\]",
|
|
15
|
-
"\\[Lines (\\d+)-(\\d+)\\]",
|
|
16
|
-
":(\\d+)",
|
|
17
|
-
"::(\\w+)\\(\\)"
|
|
18
|
-
],
|
|
19
|
-
"ignore_paths": [
|
|
20
|
-
"node_modules",
|
|
21
|
-
".git",
|
|
22
|
-
"dist",
|
|
23
|
-
"build"
|
|
24
|
-
]
|
|
25
|
-
},
|
|
26
|
-
"index_builder": {
|
|
27
|
-
"enabled": true,
|
|
28
|
-
"rebuild_on_change": true,
|
|
29
|
-
"indexes": [
|
|
30
|
-
"indexes/workflows/CATEGORY_INDEX.md",
|
|
31
|
-
"indexes/code/CATEGORY_INDEX.md",
|
|
32
|
-
"indexes/agents/CATEGORY_INDEX.md"
|
|
33
|
-
]
|
|
34
|
-
},
|
|
35
|
-
"gotcha_extractor": {
|
|
36
|
-
"enabled": false,
|
|
37
|
-
"scan_git_history": true,
|
|
38
|
-
"keywords": ["fix", "bug", "revert", "hotfix", "GOTCHA", "WARN"],
|
|
39
|
-
"output_path": "context/KNOWN_GOTCHAS.md"
|
|
40
|
-
}
|
|
41
|
-
},
|
|
42
|
-
"hooks": {
|
|
43
|
-
"pre_commit": {
|
|
44
|
-
"enabled": true,
|
|
45
|
-
"check_drift": true,
|
|
46
|
-
"block_on_stale": false
|
|
47
|
-
},
|
|
48
|
-
"post_commit": {
|
|
49
|
-
"enabled": true,
|
|
50
|
-
"rebuild_code_map": true,
|
|
51
|
-
"update_hashes": true
|
|
52
|
-
}
|
|
53
|
-
},
|
|
54
|
-
"schedule": {
|
|
55
|
-
"full_rebuild": "weekly",
|
|
56
|
-
"drift_check": "on_file_change"
|
|
57
|
-
}
|
|
58
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../schemas/automation.schema.json",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"generators": {
|
|
5
|
+
"code_mapper": {
|
|
6
|
+
"enabled": true,
|
|
7
|
+
"output_path": "context/CODE_TO_WORKFLOW_MAP.md",
|
|
8
|
+
"scan_patterns": [
|
|
9
|
+
"context/workflows/*.md",
|
|
10
|
+
"agents/*.md",
|
|
11
|
+
"commands/*.md"
|
|
12
|
+
],
|
|
13
|
+
"reference_patterns": [
|
|
14
|
+
"\\[Line (\\d+)\\]",
|
|
15
|
+
"\\[Lines (\\d+)-(\\d+)\\]",
|
|
16
|
+
":(\\d+)",
|
|
17
|
+
"::(\\w+)\\(\\)"
|
|
18
|
+
],
|
|
19
|
+
"ignore_paths": [
|
|
20
|
+
"node_modules",
|
|
21
|
+
".git",
|
|
22
|
+
"dist",
|
|
23
|
+
"build"
|
|
24
|
+
]
|
|
25
|
+
},
|
|
26
|
+
"index_builder": {
|
|
27
|
+
"enabled": true,
|
|
28
|
+
"rebuild_on_change": true,
|
|
29
|
+
"indexes": [
|
|
30
|
+
"indexes/workflows/CATEGORY_INDEX.md",
|
|
31
|
+
"indexes/code/CATEGORY_INDEX.md",
|
|
32
|
+
"indexes/agents/CATEGORY_INDEX.md"
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"gotcha_extractor": {
|
|
36
|
+
"enabled": false,
|
|
37
|
+
"scan_git_history": true,
|
|
38
|
+
"keywords": ["fix", "bug", "revert", "hotfix", "GOTCHA", "WARN"],
|
|
39
|
+
"output_path": "context/KNOWN_GOTCHAS.md"
|
|
40
|
+
}
|
|
41
|
+
},
|
|
42
|
+
"hooks": {
|
|
43
|
+
"pre_commit": {
|
|
44
|
+
"enabled": true,
|
|
45
|
+
"check_drift": true,
|
|
46
|
+
"block_on_stale": false
|
|
47
|
+
},
|
|
48
|
+
"post_commit": {
|
|
49
|
+
"enabled": true,
|
|
50
|
+
"rebuild_code_map": true,
|
|
51
|
+
"update_hashes": true
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"schedule": {
|
|
55
|
+
"full_rebuild": "weekly",
|
|
56
|
+
"drift_check": "on_file_change"
|
|
57
|
+
}
|
|
58
|
+
}
|