ctx-cc 1.0.0 → 2.1.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 +124 -75
- 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 +109 -92
- package/commands/init.md +55 -106
- package/commands/pause.md +68 -69
- package/commands/phase.md +149 -0
- package/commands/plan.md +77 -123
- package/commands/quick.md +68 -0
- package/commands/status.md +59 -76
- package/commands/verify.md +91 -121
- 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/recall.md +0 -72
- package/commands/remember.md +0 -68
- package/commands/resume.md +0 -108
- package/commands/ship.md +0 -119
- package/commands/update.md +0 -117
package/commands/ship.md
DELETED
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ctx:ship
|
|
3
|
-
description: Final audit before shipping
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
<objective>
|
|
7
|
-
Run final audit to ensure project is ready to ship. Checks all phases, todos, and verification status.
|
|
8
|
-
</objective>
|
|
9
|
-
|
|
10
|
-
<process>
|
|
11
|
-
|
|
12
|
-
<step name="check_phases">
|
|
13
|
-
Load `.ctx/ROADMAP.md` and check all phases:
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
## Phase Status
|
|
17
|
-
|
|
18
|
-
| Phase | Status | Verified |
|
|
19
|
-
|-------|--------|----------|
|
|
20
|
-
| {name} | {complete/incomplete} | {yes/no} |
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
If any phase is incomplete:
|
|
24
|
-
```
|
|
25
|
-
⚠ Phase "{name}" is not complete.
|
|
26
|
-
Run `/ctx:do` to finish, then `/ctx:verify`.
|
|
27
|
-
```
|
|
28
|
-
</step>
|
|
29
|
-
|
|
30
|
-
<step name="check_todos">
|
|
31
|
-
Load `.ctx/todos/` and check for pending items:
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
## Pending Todos
|
|
35
|
-
|
|
36
|
-
{count} todos remaining:
|
|
37
|
-
- [ ] {todo 1}
|
|
38
|
-
- [ ] {todo 2}
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
If todos exist:
|
|
42
|
-
```
|
|
43
|
-
⚠ {count} pending todos found.
|
|
44
|
-
Complete them or explicitly defer with rationale.
|
|
45
|
-
```
|
|
46
|
-
</step>
|
|
47
|
-
|
|
48
|
-
<step name="run_final_verification">
|
|
49
|
-
Run `/ctx:verify` on each completed phase:
|
|
50
|
-
|
|
51
|
-
For each phase, check:
|
|
52
|
-
- Three-level verification passes
|
|
53
|
-
- No anti-patterns (or documented exceptions)
|
|
54
|
-
- Goal gaps resolved
|
|
55
|
-
</step>
|
|
56
|
-
|
|
57
|
-
<step name="check_integrations">
|
|
58
|
-
Verify integration points:
|
|
59
|
-
|
|
60
|
-
1. **Dependencies** - All imports resolve
|
|
61
|
-
2. **Tests** - Test suite passes (if exists)
|
|
62
|
-
3. **Build** - Project builds without errors
|
|
63
|
-
4. **Lint** - No linting errors
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
# Attempt to run common checks
|
|
67
|
-
npm test 2>/dev/null || echo "No npm test"
|
|
68
|
-
npm run build 2>/dev/null || echo "No build script"
|
|
69
|
-
npm run lint 2>/dev/null || echo "No lint script"
|
|
70
|
-
```
|
|
71
|
-
</step>
|
|
72
|
-
|
|
73
|
-
<step name="generate_ship_report">
|
|
74
|
-
Create summary:
|
|
75
|
-
|
|
76
|
-
```
|
|
77
|
-
## Ship Readiness Report
|
|
78
|
-
|
|
79
|
-
### Phases
|
|
80
|
-
| Phase | Complete | Verified |
|
|
81
|
-
|-------|----------|----------|
|
|
82
|
-
{table}
|
|
83
|
-
|
|
84
|
-
### Todos
|
|
85
|
-
- Pending: {count}
|
|
86
|
-
- Completed: {count}
|
|
87
|
-
|
|
88
|
-
### Checks
|
|
89
|
-
- [ ] All phases complete: {yes/no}
|
|
90
|
-
- [ ] All verifications pass: {yes/no}
|
|
91
|
-
- [ ] No pending todos: {yes/no}
|
|
92
|
-
- [ ] Build passes: {yes/no}
|
|
93
|
-
- [ ] Tests pass: {yes/no}
|
|
94
|
-
|
|
95
|
-
### Overall: {READY TO SHIP ✓ / NOT READY ✗}
|
|
96
|
-
|
|
97
|
-
{If not ready:}
|
|
98
|
-
**Blockers:**
|
|
99
|
-
1. {blocker}
|
|
100
|
-
2. {blocker}
|
|
101
|
-
|
|
102
|
-
{If ready:}
|
|
103
|
-
**Recommendation:** Safe to deploy.
|
|
104
|
-
```
|
|
105
|
-
</step>
|
|
106
|
-
|
|
107
|
-
</process>
|
|
108
|
-
|
|
109
|
-
<output>
|
|
110
|
-
Ship readiness report with clear pass/fail and any blockers.
|
|
111
|
-
</output>
|
|
112
|
-
|
|
113
|
-
<success_criteria>
|
|
114
|
-
- [ ] All phases checked
|
|
115
|
-
- [ ] All todos reviewed
|
|
116
|
-
- [ ] Final verification run
|
|
117
|
-
- [ ] Build/test status checked
|
|
118
|
-
- [ ] Clear ship/no-ship recommendation
|
|
119
|
-
</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>
|