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.
@@ -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>
@@ -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>
@@ -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>