ctx-cc 1.0.0 → 2.0.0
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/README.md +105 -80
- package/agents/ctx-debugger.md +257 -0
- package/agents/ctx-executor.md +96 -71
- package/agents/ctx-planner.md +70 -62
- package/agents/ctx-researcher.md +26 -19
- package/agents/ctx-verifier.md +86 -68
- package/bin/ctx.js +3 -2
- package/commands/ctx.md +116 -0
- package/commands/help.md +123 -90
- package/commands/init.md +55 -106
- package/commands/pause.md +68 -69
- package/commands/quick.md +68 -0
- package/package.json +2 -2
- package/src/install.js +3 -3
- package/templates/STATE.md +47 -0
- package/commands/do.md +0 -130
- package/commands/forget.md +0 -58
- package/commands/phase-add.md +0 -53
- package/commands/phase-list.md +0 -46
- package/commands/phase-next.md +0 -67
- package/commands/plan.md +0 -139
- package/commands/recall.md +0 -72
- package/commands/remember.md +0 -68
- package/commands/resume.md +0 -108
- package/commands/ship.md +0 -119
- package/commands/status.md +0 -95
- package/commands/update.md +0 -117
- package/commands/verify.md +0 -151
package/commands/status.md
DELETED
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ctx:status
|
|
3
|
-
description: Full status report
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
<objective>
|
|
7
|
-
Display comprehensive project status including phase, progress, context usage, and todos.
|
|
8
|
-
</objective>
|
|
9
|
-
|
|
10
|
-
<process>
|
|
11
|
-
|
|
12
|
-
<step name="gather_status">
|
|
13
|
-
Collect status from all CTX components:
|
|
14
|
-
|
|
15
|
-
1. **Project** - Name, tech stack
|
|
16
|
-
2. **Phase** - Current phase, progress
|
|
17
|
-
3. **Context** - Usage percentage
|
|
18
|
-
4. **Memory** - Fact counts
|
|
19
|
-
5. **Todos** - Pending count
|
|
20
|
-
6. **Integrations** - ArguSeek, ChunkHound status
|
|
21
|
-
</step>
|
|
22
|
-
|
|
23
|
-
<step name="display">
|
|
24
|
-
```
|
|
25
|
-
## CTX Status
|
|
26
|
-
|
|
27
|
-
### Project
|
|
28
|
-
**Name:** {project name}
|
|
29
|
-
**Tech:** {language} + {framework}
|
|
30
|
-
**Initialized:** {date}
|
|
31
|
-
|
|
32
|
-
### Current Phase
|
|
33
|
-
**Phase:** {phase name} ({phase number}/{total})
|
|
34
|
-
**Goal:** {goal}
|
|
35
|
-
**Progress:** {percentage}% ({completed}/{total} tasks)
|
|
36
|
-
**Status:** {pending/in_progress/complete}
|
|
37
|
-
|
|
38
|
-
### Context Budget
|
|
39
|
-
**Current:** {percentage}%
|
|
40
|
-
**Quality:** {Peak/Good/Degrading/Poor}
|
|
41
|
-
**Recommendation:** {Continue/Consider checkpoint/Checkpoint now}
|
|
42
|
-
|
|
43
|
-
```
|
|
44
|
-
{context bar visualization}
|
|
45
|
-
[████████████░░░░░░░░] 45%
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
### Memory
|
|
49
|
-
| Tier | Facts |
|
|
50
|
-
|------|-------|
|
|
51
|
-
| Working | {count} |
|
|
52
|
-
| Episodic | {count} |
|
|
53
|
-
| Semantic | {count} |
|
|
54
|
-
|
|
55
|
-
### Todos
|
|
56
|
-
**Pending:** {count}
|
|
57
|
-
**In Progress:** {count}
|
|
58
|
-
**Completed:** {count}
|
|
59
|
-
|
|
60
|
-
### Integrations
|
|
61
|
-
| Tool | Status |
|
|
62
|
-
|------|--------|
|
|
63
|
-
| ArguSeek | {available/unavailable} |
|
|
64
|
-
| ChunkHound | {indexed/not indexed/unavailable} |
|
|
65
|
-
|
|
66
|
-
### Last Checkpoint
|
|
67
|
-
**ID:** {id or "None"}
|
|
68
|
-
**Created:** {timestamp or "N/A"}
|
|
69
|
-
|
|
70
|
-
---
|
|
71
|
-
|
|
72
|
-
**Quick Actions:**
|
|
73
|
-
- Continue work: `/ctx:do`
|
|
74
|
-
- Verify phase: `/ctx:verify`
|
|
75
|
-
- Save state: `/ctx:pause`
|
|
76
|
-
- View phases: `/ctx:phase list`
|
|
77
|
-
```
|
|
78
|
-
</step>
|
|
79
|
-
|
|
80
|
-
</process>
|
|
81
|
-
|
|
82
|
-
<context_quality>
|
|
83
|
-
| Usage | Quality | Action |
|
|
84
|
-
|-------|---------|--------|
|
|
85
|
-
| 0-30% | Peak | Continue |
|
|
86
|
-
| 30-50% | Good | Continue |
|
|
87
|
-
| 50-70% | Degrading | Consider checkpoint |
|
|
88
|
-
| 70%+ | Poor | Checkpoint now |
|
|
89
|
-
</context_quality>
|
|
90
|
-
|
|
91
|
-
<success_criteria>
|
|
92
|
-
- [ ] All status components displayed
|
|
93
|
-
- [ ] Context budget clearly shown
|
|
94
|
-
- [ ] Next actions suggested
|
|
95
|
-
</success_criteria>
|
package/commands/update.md
DELETED
|
@@ -1,117 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ctx:update
|
|
3
|
-
description: Check for CTX updates and install if available
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
<objective>
|
|
7
|
-
Check for CTX updates, show what's new, and install if user confirms.
|
|
8
|
-
</objective>
|
|
9
|
-
|
|
10
|
-
<process>
|
|
11
|
-
|
|
12
|
-
<step name="get_installed_version">
|
|
13
|
-
Read installed version:
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
cat ~/.claude/ctx/VERSION 2>/dev/null
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
If VERSION file missing, treat as version 0.0.0.
|
|
20
|
-
</step>
|
|
21
|
-
|
|
22
|
-
<step name="check_latest_version">
|
|
23
|
-
Check npm for latest version:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm view ctx-cc version 2>/dev/null
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
If npm check fails:
|
|
30
|
-
```
|
|
31
|
-
Couldn't check for updates (offline or npm unavailable).
|
|
32
|
-
|
|
33
|
-
To update manually: `npx ctx-cc --force`
|
|
34
|
-
```
|
|
35
|
-
</step>
|
|
36
|
-
|
|
37
|
-
<step name="compare_versions">
|
|
38
|
-
Compare installed vs latest:
|
|
39
|
-
|
|
40
|
-
**If installed == latest:**
|
|
41
|
-
```
|
|
42
|
-
## CTX Update
|
|
43
|
-
|
|
44
|
-
**Installed:** {version}
|
|
45
|
-
**Latest:** {version}
|
|
46
|
-
|
|
47
|
-
You're already on the latest version.
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
**If installed < latest:**
|
|
51
|
-
Continue to show changes and confirm.
|
|
52
|
-
</step>
|
|
53
|
-
|
|
54
|
-
<step name="show_changes">
|
|
55
|
-
Fetch changelog and show what's new:
|
|
56
|
-
|
|
57
|
-
```
|
|
58
|
-
## CTX Update Available
|
|
59
|
-
|
|
60
|
-
**Installed:** {old version}
|
|
61
|
-
**Latest:** {new version}
|
|
62
|
-
|
|
63
|
-
### What's New
|
|
64
|
-
────────────────────────────────────────────────────────────
|
|
65
|
-
|
|
66
|
-
{changelog entries between versions}
|
|
67
|
-
|
|
68
|
-
────────────────────────────────────────────────────────────
|
|
69
|
-
|
|
70
|
-
**Note:** The installer will replace:
|
|
71
|
-
- `~/.claude/commands/ctx/`
|
|
72
|
-
- `~/.claude/ctx/`
|
|
73
|
-
- `~/.claude/agents/ctx-*`
|
|
74
|
-
|
|
75
|
-
Your custom files are preserved.
|
|
76
|
-
```
|
|
77
|
-
</step>
|
|
78
|
-
|
|
79
|
-
<step name="confirm_update">
|
|
80
|
-
Ask user to confirm:
|
|
81
|
-
|
|
82
|
-
**Options:**
|
|
83
|
-
- "Yes, update now"
|
|
84
|
-
- "No, cancel"
|
|
85
|
-
</step>
|
|
86
|
-
|
|
87
|
-
<step name="run_update">
|
|
88
|
-
If confirmed:
|
|
89
|
-
|
|
90
|
-
```bash
|
|
91
|
-
npx ctx-cc --force
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
Clear any update cache.
|
|
95
|
-
</step>
|
|
96
|
-
|
|
97
|
-
<step name="complete">
|
|
98
|
-
```
|
|
99
|
-
╔═══════════════════════════════════════════════════════════╗
|
|
100
|
-
║ CTX Updated: v{old} → v{new} ║
|
|
101
|
-
╚═══════════════════════════════════════════════════════════╝
|
|
102
|
-
|
|
103
|
-
⚠️ Restart Claude Code to pick up the new commands.
|
|
104
|
-
|
|
105
|
-
View full changelog: https://github.com/jufjuf/CTX/blob/main/CHANGELOG.md
|
|
106
|
-
```
|
|
107
|
-
</step>
|
|
108
|
-
|
|
109
|
-
</process>
|
|
110
|
-
|
|
111
|
-
<success_criteria>
|
|
112
|
-
- [ ] Installed version detected
|
|
113
|
-
- [ ] Latest version checked
|
|
114
|
-
- [ ] Changelog shown for new versions
|
|
115
|
-
- [ ] User confirmation obtained
|
|
116
|
-
- [ ] Update executed successfully
|
|
117
|
-
</success_criteria>
|
package/commands/verify.md
DELETED
|
@@ -1,151 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ctx:verify
|
|
3
|
-
description: Three-level verification of current phase
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
<objective>
|
|
7
|
-
Verify the current phase implementation using three-level verification plus anti-pattern scanning.
|
|
8
|
-
</objective>
|
|
9
|
-
|
|
10
|
-
<process>
|
|
11
|
-
|
|
12
|
-
<step name="load_phase">
|
|
13
|
-
Load current phase from `.ctx/ROADMAP.md`.
|
|
14
|
-
Load verification criteria from `.ctx/phases/{phase-id}/PLAN.md`.
|
|
15
|
-
|
|
16
|
-
If no phase:
|
|
17
|
-
```
|
|
18
|
-
No phase to verify. Run `/ctx:plan <goal>` first.
|
|
19
|
-
```
|
|
20
|
-
</step>
|
|
21
|
-
|
|
22
|
-
<step name="three_level_verification">
|
|
23
|
-
For each artifact in the phase:
|
|
24
|
-
|
|
25
|
-
### Level 1: EXISTS
|
|
26
|
-
```
|
|
27
|
-
Question: Is the file on disk?
|
|
28
|
-
Check: Glob for the file path
|
|
29
|
-
Pass: File exists
|
|
30
|
-
Fail: File missing
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### Level 2: SUBSTANTIVE
|
|
34
|
-
```
|
|
35
|
-
Question: Is it real code, not a stub?
|
|
36
|
-
Check:
|
|
37
|
-
- No "// TODO" comments in new code
|
|
38
|
-
- No empty function bodies
|
|
39
|
-
- No placeholder returns (return null, return {})
|
|
40
|
-
- No "not implemented" comments
|
|
41
|
-
Pass: Real, complete implementation
|
|
42
|
-
Fail: Stub or placeholder detected
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Level 3: WIRED
|
|
46
|
-
```
|
|
47
|
-
Question: Is it imported and used?
|
|
48
|
-
Check:
|
|
49
|
-
- Grep for imports of the file
|
|
50
|
-
- Trace call paths from entry points
|
|
51
|
-
- Verify the code is reachable
|
|
52
|
-
Pass: Connected to the application
|
|
53
|
-
Fail: Orphan code (exists but unused)
|
|
54
|
-
```
|
|
55
|
-
</step>
|
|
56
|
-
|
|
57
|
-
<step name="anti_pattern_scan">
|
|
58
|
-
Scan for common anti-patterns:
|
|
59
|
-
|
|
60
|
-
| Pattern | Search | Severity |
|
|
61
|
-
|---------|--------|----------|
|
|
62
|
-
| TODO comments | `// TODO`, `# TODO` | Warning |
|
|
63
|
-
| Empty catch | `catch.*\{\s*\}` | Error |
|
|
64
|
-
| Console-only errors | `console.error` without throw | Warning |
|
|
65
|
-
| Placeholder returns | `return null`, `return {}` | Error |
|
|
66
|
-
| Hardcoded secrets | API keys, passwords | Critical |
|
|
67
|
-
| Debug code | `console.log`, `debugger` | Warning |
|
|
68
|
-
</step>
|
|
69
|
-
|
|
70
|
-
<step name="goal_gap_analysis">
|
|
71
|
-
Check if phase goal is achieved:
|
|
72
|
-
|
|
73
|
-
1. Re-read the original goal
|
|
74
|
-
2. Compare against what was built
|
|
75
|
-
3. Identify any gaps
|
|
76
|
-
|
|
77
|
-
```
|
|
78
|
-
Goal: {original goal}
|
|
79
|
-
Built: {what was implemented}
|
|
80
|
-
Gaps: {missing pieces, if any}
|
|
81
|
-
```
|
|
82
|
-
</step>
|
|
83
|
-
|
|
84
|
-
<step name="generate_report">
|
|
85
|
-
Write `.ctx/phases/{phase-id}/VERIFY.md`:
|
|
86
|
-
|
|
87
|
-
```markdown
|
|
88
|
-
# Verification Report
|
|
89
|
-
|
|
90
|
-
## Phase: {name}
|
|
91
|
-
## Date: {timestamp}
|
|
92
|
-
|
|
93
|
-
## Three-Level Results
|
|
94
|
-
|
|
95
|
-
| Artifact | Exists | Substantive | Wired | Status |
|
|
96
|
-
|----------|--------|-------------|-------|--------|
|
|
97
|
-
| {file1} | ✓ | ✓ | ✓ | PASS |
|
|
98
|
-
| {file2} | ✓ | ✓ | ✗ | FAIL |
|
|
99
|
-
|
|
100
|
-
## Anti-Pattern Scan
|
|
101
|
-
|
|
102
|
-
| Pattern | Count | Files | Severity |
|
|
103
|
-
|---------|-------|-------|----------|
|
|
104
|
-
| TODO | 2 | auth.ts, login.ts | Warning |
|
|
105
|
-
|
|
106
|
-
## Goal Gap Analysis
|
|
107
|
-
|
|
108
|
-
**Goal:** {goal}
|
|
109
|
-
**Status:** {Achieved / Partially Achieved / Not Achieved}
|
|
110
|
-
**Gaps:** {list or "None"}
|
|
111
|
-
|
|
112
|
-
## Overall: {PASS / FAIL}
|
|
113
|
-
|
|
114
|
-
{If FAIL: List what needs to be fixed}
|
|
115
|
-
```
|
|
116
|
-
</step>
|
|
117
|
-
|
|
118
|
-
<step name="output_summary">
|
|
119
|
-
Display verification summary:
|
|
120
|
-
|
|
121
|
-
```
|
|
122
|
-
## Verification: {phase name}
|
|
123
|
-
|
|
124
|
-
**Three-Level Check:**
|
|
125
|
-
- Exists: {pass/fail count}
|
|
126
|
-
- Substantive: {pass/fail count}
|
|
127
|
-
- Wired: {pass/fail count}
|
|
128
|
-
|
|
129
|
-
**Anti-Patterns:** {count} found
|
|
130
|
-
**Goal Gaps:** {count or "None"}
|
|
131
|
-
|
|
132
|
-
**Overall:** {PASS ✓ / FAIL ✗}
|
|
133
|
-
|
|
134
|
-
{If FAIL:}
|
|
135
|
-
**Action Required:**
|
|
136
|
-
- {list of fixes needed}
|
|
137
|
-
|
|
138
|
-
{If PASS:}
|
|
139
|
-
**Next:** Run `/ctx:phase next` or `/ctx:ship`
|
|
140
|
-
```
|
|
141
|
-
</step>
|
|
142
|
-
|
|
143
|
-
</process>
|
|
144
|
-
|
|
145
|
-
<success_criteria>
|
|
146
|
-
- [ ] All artifacts checked at three levels
|
|
147
|
-
- [ ] Anti-pattern scan completed
|
|
148
|
-
- [ ] Goal gap analysis done
|
|
149
|
-
- [ ] VERIFY.md written
|
|
150
|
-
- [ ] Clear pass/fail determination
|
|
151
|
-
</success_criteria>
|