mindsystem-cc 3.0.0 → 3.2.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 +179 -332
- package/agents/ms-executor.md +0 -1
- package/agents/ms-roadmapper.md +0 -1
- package/bin/install.js +2 -2
- package/commands/ms/help.md +0 -30
- package/commands/ms/linear.md +231 -0
- package/commands/ms/progress.md +16 -2
- package/commands/ms/remove-phase.md +0 -2
- package/mindsystem/templates/state.md +0 -13
- package/mindsystem/workflows/execute-plan.md +0 -1
- package/mindsystem/workflows/transition.md +0 -14
- package/package.json +1 -1
- package/scripts/ms-linear/ms_linear/__init__.py +3 -0
- package/scripts/ms-linear/ms_linear/__main__.py +6 -0
- package/scripts/ms-linear/ms_linear/__pycache__/__init__.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/__pycache__/__main__.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/__pycache__/cli.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/__pycache__/client.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/__pycache__/config.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/__pycache__/errors.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/__pycache__/output.cpython-314.pyc +0 -0
- package/scripts/ms-linear/ms_linear/cli.py +604 -0
- package/scripts/ms-linear/ms_linear/client.py +503 -0
- package/scripts/ms-linear/ms_linear/config.py +102 -0
- package/scripts/ms-linear/ms_linear/errors.py +29 -0
- package/scripts/ms-linear/ms_linear/output.py +45 -0
- package/scripts/ms-linear/pyproject.toml +16 -0
- package/scripts/ms-linear/uv.lock +196 -0
- package/scripts/ms-linear-wrapper.sh +21 -0
- package/commands/ms/pause-work.md +0 -123
- package/commands/ms/resume-work.md +0 -40
- package/mindsystem/templates/continue-here.md +0 -78
- package/mindsystem/workflows/resume-project.md +0 -311
|
@@ -1,311 +0,0 @@
|
|
|
1
|
-
<trigger>
|
|
2
|
-
Use this workflow when:
|
|
3
|
-
- Starting a new session on an existing project
|
|
4
|
-
- User says "continue", "what's next", "where were we", "resume"
|
|
5
|
-
- Any planning operation when .planning/ already exists
|
|
6
|
-
- User returns after time away from project
|
|
7
|
-
</trigger>
|
|
8
|
-
|
|
9
|
-
<purpose>
|
|
10
|
-
Instantly restore full project context and present clear status.
|
|
11
|
-
Enables seamless session continuity for fully autonomous workflows.
|
|
12
|
-
|
|
13
|
-
"Where were we?" should have an immediate, complete answer.
|
|
14
|
-
</purpose>
|
|
15
|
-
|
|
16
|
-
<process>
|
|
17
|
-
|
|
18
|
-
<step name="detect_existing_project">
|
|
19
|
-
Check if this is an existing project:
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
ls .planning/STATE.md 2>/dev/null && echo "Project exists"
|
|
23
|
-
ls .planning/ROADMAP.md 2>/dev/null && echo "Roadmap exists"
|
|
24
|
-
ls .planning/PROJECT.md 2>/dev/null && echo "Project file exists"
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
**If STATE.md exists:** Proceed to load_state
|
|
28
|
-
**If only ROADMAP.md/PROJECT.md exist:** Offer to reconstruct STATE.md
|
|
29
|
-
**If .planning/ doesn't exist:** This is a new project - route to /ms:new-project
|
|
30
|
-
</step>
|
|
31
|
-
|
|
32
|
-
<step name="load_state">
|
|
33
|
-
|
|
34
|
-
Read and parse STATE.md, then PROJECT.md:
|
|
35
|
-
|
|
36
|
-
```bash
|
|
37
|
-
cat .planning/STATE.md
|
|
38
|
-
cat .planning/PROJECT.md
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
**From STATE.md extract:**
|
|
42
|
-
|
|
43
|
-
- **Project Reference**: Core value and current focus
|
|
44
|
-
- **Current Position**: Phase X of Y, Plan A of B, Status
|
|
45
|
-
- **Progress**: Visual progress bar
|
|
46
|
-
- **Recent Decisions**: Key decisions affecting current work
|
|
47
|
-
- **Pending Todos**: Ideas captured during sessions
|
|
48
|
-
- **Blockers/Concerns**: Issues carried forward
|
|
49
|
-
- **Session Continuity**: Where we left off, any resume files
|
|
50
|
-
|
|
51
|
-
**From PROJECT.md extract:**
|
|
52
|
-
|
|
53
|
-
- **What This Is**: Current accurate description
|
|
54
|
-
- **Requirements**: Validated, Active, Out of Scope
|
|
55
|
-
- **Key Decisions**: Full decision log with outcomes
|
|
56
|
-
- **Constraints**: Hard limits on implementation
|
|
57
|
-
|
|
58
|
-
</step>
|
|
59
|
-
|
|
60
|
-
<step name="check_incomplete_work">
|
|
61
|
-
Look for incomplete work that needs attention:
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
# Check for continue-here files (mid-plan resumption)
|
|
65
|
-
ls .planning/phases/*/.continue-here*.md 2>/dev/null
|
|
66
|
-
|
|
67
|
-
# Check for plans without summaries (incomplete execution)
|
|
68
|
-
for plan in .planning/phases/*/*-PLAN.md; do
|
|
69
|
-
summary="${plan/PLAN/SUMMARY}"
|
|
70
|
-
[ ! -f "$summary" ] && echo "Incomplete: $plan"
|
|
71
|
-
done 2>/dev/null
|
|
72
|
-
|
|
73
|
-
# Check for interrupted agents
|
|
74
|
-
if [ -f .planning/current-agent-id.txt ] && [ -s .planning/current-agent-id.txt ]; then
|
|
75
|
-
AGENT_ID=$(cat .planning/current-agent-id.txt | tr -d '\n')
|
|
76
|
-
echo "Interrupted agent: $AGENT_ID"
|
|
77
|
-
fi
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
**If .continue-here file exists:**
|
|
81
|
-
|
|
82
|
-
- This is a mid-plan resumption point
|
|
83
|
-
- Read the file for specific resumption context
|
|
84
|
-
- Flag: "Found mid-plan checkpoint"
|
|
85
|
-
|
|
86
|
-
**If PLAN without SUMMARY exists:**
|
|
87
|
-
|
|
88
|
-
- Execution was started but not completed
|
|
89
|
-
- Flag: "Found incomplete plan execution"
|
|
90
|
-
|
|
91
|
-
**If interrupted agent found:**
|
|
92
|
-
|
|
93
|
-
- Subagent was spawned but session ended before completion
|
|
94
|
-
- Read agent-history.json for task details
|
|
95
|
-
- Flag: "Found interrupted agent"
|
|
96
|
-
</step>
|
|
97
|
-
|
|
98
|
-
<step name="present_status">
|
|
99
|
-
Present complete project status to user:
|
|
100
|
-
|
|
101
|
-
```
|
|
102
|
-
╔══════════════════════════════════════════════════════════════╗
|
|
103
|
-
║ PROJECT STATUS ║
|
|
104
|
-
╠══════════════════════════════════════════════════════════════╣
|
|
105
|
-
║ Building: [one-liner from PROJECT.md "What This Is"] ║
|
|
106
|
-
║ ║
|
|
107
|
-
║ Phase: [X] of [Y] - [Phase name] ║
|
|
108
|
-
║ Plan: [A] of [B] - [Status] ║
|
|
109
|
-
║ Progress: [██████░░░░] XX% ║
|
|
110
|
-
║ ║
|
|
111
|
-
║ Last activity: [date] - [what happened] ║
|
|
112
|
-
╚══════════════════════════════════════════════════════════════╝
|
|
113
|
-
|
|
114
|
-
[If incomplete work found:]
|
|
115
|
-
⚠️ Incomplete work detected:
|
|
116
|
-
- [.continue-here file or incomplete plan]
|
|
117
|
-
|
|
118
|
-
[If interrupted agent found:]
|
|
119
|
-
⚠️ Interrupted agent detected:
|
|
120
|
-
Agent ID: [id]
|
|
121
|
-
Task: [task description from agent-history.json]
|
|
122
|
-
Interrupted: [timestamp]
|
|
123
|
-
|
|
124
|
-
Resume with: /ms:resume-task
|
|
125
|
-
|
|
126
|
-
[If pending todos exist:]
|
|
127
|
-
📋 [N] pending todos — /ms:check-todos to review
|
|
128
|
-
|
|
129
|
-
[If blockers exist:]
|
|
130
|
-
⚠️ Carried concerns:
|
|
131
|
-
- [blocker 1]
|
|
132
|
-
- [blocker 2]
|
|
133
|
-
|
|
134
|
-
[If alignment is not ✓:]
|
|
135
|
-
⚠️ Brief alignment: [status] - [assessment]
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
</step>
|
|
139
|
-
|
|
140
|
-
<step name="determine_next_action">
|
|
141
|
-
Based on project state, determine the most logical next action:
|
|
142
|
-
|
|
143
|
-
**If interrupted agent exists:**
|
|
144
|
-
→ Primary: Resume interrupted agent (/ms:resume-task)
|
|
145
|
-
→ Option: Start fresh (abandon agent work)
|
|
146
|
-
|
|
147
|
-
**If .continue-here file exists:**
|
|
148
|
-
→ Primary: Resume from checkpoint
|
|
149
|
-
→ Option: Start fresh on current plan
|
|
150
|
-
|
|
151
|
-
**If incomplete plan (PLAN without SUMMARY):**
|
|
152
|
-
→ Primary: Complete the incomplete plan
|
|
153
|
-
→ Option: Abandon and move on
|
|
154
|
-
|
|
155
|
-
**If phase in progress, all plans complete:**
|
|
156
|
-
→ Primary: Transition to next phase
|
|
157
|
-
→ Option: Review completed work
|
|
158
|
-
|
|
159
|
-
**If phase ready to plan:**
|
|
160
|
-
→ Check if CONTEXT.md exists for this phase:
|
|
161
|
-
|
|
162
|
-
- If CONTEXT.md missing:
|
|
163
|
-
→ Primary: Discuss phase vision (how user imagines it working)
|
|
164
|
-
→ Secondary: Plan directly (skip context gathering)
|
|
165
|
-
- If CONTEXT.md exists:
|
|
166
|
-
→ Primary: Plan the phase
|
|
167
|
-
→ Option: Review roadmap
|
|
168
|
-
|
|
169
|
-
**If phase ready to execute:**
|
|
170
|
-
→ Primary: Execute next plan
|
|
171
|
-
→ Option: Review the plan first
|
|
172
|
-
</step>
|
|
173
|
-
|
|
174
|
-
<step name="offer_options">
|
|
175
|
-
Present contextual options based on project state:
|
|
176
|
-
|
|
177
|
-
```
|
|
178
|
-
What would you like to do?
|
|
179
|
-
|
|
180
|
-
[Primary action based on state - e.g.:]
|
|
181
|
-
1. Resume interrupted agent (/ms:resume-task) [if interrupted agent found]
|
|
182
|
-
OR
|
|
183
|
-
1. Continue phase execution (/ms:execute-phase {X}) [resumes from checkpoint or incomplete plan]
|
|
184
|
-
OR
|
|
185
|
-
1. Discuss Phase 3 context (/ms:discuss-phase 3) [if CONTEXT.md missing]
|
|
186
|
-
OR
|
|
187
|
-
1. Plan Phase 3 (/ms:plan-phase 3) [if CONTEXT.md exists or discuss option declined]
|
|
188
|
-
|
|
189
|
-
[Secondary options:]
|
|
190
|
-
2. Review current phase status
|
|
191
|
-
3. Check pending todos ([N] pending)
|
|
192
|
-
4. Review brief alignment
|
|
193
|
-
5. Something else
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
**Note:** When offering phase planning, check for CONTEXT.md existence first:
|
|
197
|
-
|
|
198
|
-
```bash
|
|
199
|
-
ls .planning/phases/XX-name/CONTEXT.md 2>/dev/null
|
|
200
|
-
```
|
|
201
|
-
|
|
202
|
-
If missing, suggest discuss-phase before plan. If exists, offer plan directly.
|
|
203
|
-
|
|
204
|
-
Wait for user selection.
|
|
205
|
-
</step>
|
|
206
|
-
|
|
207
|
-
<step name="route_to_workflow">
|
|
208
|
-
Based on user selection, route to appropriate workflow:
|
|
209
|
-
|
|
210
|
-
- **Execute phase** → Show command for user to run after clearing:
|
|
211
|
-
```
|
|
212
|
-
---
|
|
213
|
-
|
|
214
|
-
## ▶ Next Up
|
|
215
|
-
|
|
216
|
-
**Phase {X}: [Phase Name]** — [goal from ROADMAP.md]
|
|
217
|
-
|
|
218
|
-
`/ms:execute-phase {X}`
|
|
219
|
-
|
|
220
|
-
<sub>`/clear` first → fresh context window</sub>
|
|
221
|
-
|
|
222
|
-
---
|
|
223
|
-
```
|
|
224
|
-
- **Plan phase** → Show command for user to run after clearing:
|
|
225
|
-
```
|
|
226
|
-
---
|
|
227
|
-
|
|
228
|
-
## ▶ Next Up
|
|
229
|
-
|
|
230
|
-
**Phase [N]: [Name]** — [Goal from ROADMAP.md]
|
|
231
|
-
|
|
232
|
-
`/ms:plan-phase [phase-number]`
|
|
233
|
-
|
|
234
|
-
<sub>`/clear` first → fresh context window</sub>
|
|
235
|
-
|
|
236
|
-
---
|
|
237
|
-
|
|
238
|
-
**Also available:**
|
|
239
|
-
- `/ms:discuss-phase [N]` — gather context first
|
|
240
|
-
- `/ms:research-phase [N]` — investigate unknowns
|
|
241
|
-
|
|
242
|
-
---
|
|
243
|
-
```
|
|
244
|
-
- **Transition** → ./transition.md
|
|
245
|
-
- **Check todos** → Read .planning/todos/pending/, present summary
|
|
246
|
-
- **Review alignment** → Read PROJECT.md, compare to current state
|
|
247
|
-
- **Something else** → Ask what they need
|
|
248
|
-
</step>
|
|
249
|
-
|
|
250
|
-
<step name="update_session">
|
|
251
|
-
Before proceeding to routed workflow, update session continuity:
|
|
252
|
-
|
|
253
|
-
Update STATE.md:
|
|
254
|
-
|
|
255
|
-
```markdown
|
|
256
|
-
## Session Continuity
|
|
257
|
-
|
|
258
|
-
Last session: [now]
|
|
259
|
-
Stopped at: Session resumed, proceeding to [action]
|
|
260
|
-
Resume file: [updated if applicable]
|
|
261
|
-
```
|
|
262
|
-
|
|
263
|
-
This ensures if session ends unexpectedly, next resume knows the state.
|
|
264
|
-
</step>
|
|
265
|
-
|
|
266
|
-
</process>
|
|
267
|
-
|
|
268
|
-
<reconstruction>
|
|
269
|
-
If STATE.md is missing but other artifacts exist:
|
|
270
|
-
|
|
271
|
-
"STATE.md missing. Reconstructing from artifacts..."
|
|
272
|
-
|
|
273
|
-
1. Read PROJECT.md → Extract "What This Is" and Core Value
|
|
274
|
-
2. Read ROADMAP.md → Determine phases, find current position
|
|
275
|
-
3. Scan \*-SUMMARY.md files → Extract decisions, concerns
|
|
276
|
-
4. Count pending todos in .planning/todos/pending/
|
|
277
|
-
5. Check for .continue-here files → Session continuity
|
|
278
|
-
|
|
279
|
-
Reconstruct and write STATE.md, then proceed normally.
|
|
280
|
-
|
|
281
|
-
This handles cases where:
|
|
282
|
-
|
|
283
|
-
- Project predates STATE.md introduction
|
|
284
|
-
- File was accidentally deleted
|
|
285
|
-
- Cloning repo without full .planning/ state
|
|
286
|
-
</reconstruction>
|
|
287
|
-
|
|
288
|
-
<quick_resume>
|
|
289
|
-
For users who want minimal friction:
|
|
290
|
-
|
|
291
|
-
If user says just "continue" or "go":
|
|
292
|
-
|
|
293
|
-
- Load state silently
|
|
294
|
-
- Determine primary action
|
|
295
|
-
- Execute immediately without presenting options
|
|
296
|
-
|
|
297
|
-
"Continuing from [state]... [action]"
|
|
298
|
-
|
|
299
|
-
This enables fully autonomous "just keep going" workflow.
|
|
300
|
-
</quick_resume>
|
|
301
|
-
|
|
302
|
-
<success_criteria>
|
|
303
|
-
Resume is complete when:
|
|
304
|
-
|
|
305
|
-
- [ ] STATE.md loaded (or reconstructed)
|
|
306
|
-
- [ ] Incomplete work detected and flagged
|
|
307
|
-
- [ ] Clear status presented to user
|
|
308
|
-
- [ ] Contextual next actions offered
|
|
309
|
-
- [ ] User knows exactly where project stands
|
|
310
|
-
- [ ] Session continuity updated
|
|
311
|
-
</success_criteria>
|