@mstar-harness/opencode 1.0.2 → 1.0.3

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/CHANGELOG.md CHANGED
@@ -4,6 +4,12 @@ All notable changes to the `@mstar-harness/opencode` package are documented in t
4
4
 
5
5
  The monorepo root [CHANGELOG.md](../../CHANGELOG.md) summarizes cross-surface releases.
6
6
 
7
+ ## 1.0.3
8
+
9
+ - Bundled skills/commands: iteration continuous execution (Phase 2–5 HARD push discipline in `iteration-drive` + `mstar-iteration` §2.6); skills command-agnostic cleanup; `pm` Autonomous Execute push rule; routing-eval v15.
10
+
11
+ See root [CHANGELOG.md](../../CHANGELOG.md) **1.0.3**.
12
+
7
13
  ## 1.0.2
8
14
 
9
15
  - Bundled skills/commands: iteration artifact boundaries (`{ITERATION_DIR}/<id>/` workspace, specs-first start, compound workspace promotion at close); new iteration references; corpus hygiene aligned.
@@ -25,11 +25,33 @@ Phase 2: Autonomous Execute → Phase 3: iteration-close → Phase 4: Create
25
25
 
26
26
  **Done 定义**:**仅** Phase 5 §5.5 exit checklist 全 `[x]`。**Phase 3 close ≠ Done;Phase 4 开 PR ≠ Done。**
27
27
 
28
+ ## Continuous execution(HARD — Phase 2–5)
29
+
30
+ **Autonomous Execute push**:自 Phase 2 进入至 Phase 5 §5.5 exit 全 `[x]` 前,PM **连续编排**,不得把进度汇报、phase 标题或子 agent 返回当作**回合结束**。
31
+
32
+ | 禁止 | 必须 |
33
+ |------|------|
34
+ | plan / task / phase 边界问用户「是否继续」「要不要现在启动」「是否开 PR」等例行 yes/no | 进度摘要后**下一条动作** = **dispatch**(`Task`)或下一 phase 步骤(打印 checklist → 执行) |
35
+ | 用完整 Phase 2 汇报收束 turn 后等待用户 | 同 plan 内 task 间 → **`mstar-sdd` Continuous execution**;当前 plan Done 后 → **立刻**下一 plan dispatch |
36
+ | 把 `## Phase 3/4/5` 标题当作可停下协商点(除合法 STOP) | Phase 3 checklist `[x]` → **立刻** Phase 4;PR 创建后 → **立刻** Phase 5 loop |
37
+ | 跨 plan **并行** implement dispatch(多 plan 同时跑 implementer) | Per-plan **串行**:plan A implement→QC→QA→Done 后再 plan B(除非用户书面 override) |
38
+
39
+ **合法 STOP(仅此升级用户)**:
40
+
41
+ - §2.0 / Phase 4 branch metadata 缺失(`iteration_base_branch` / `target_branch`)
42
+ - **`Blocked`**:真冲突、secrets、不可逆范围缺口、Phase 5 多轮仍无法 merge-ready
43
+ - 用户本轮显式打断
44
+
45
+ **Turn 收束纪律**:若 host 即将结束本轮,最后一条 assistant 内容必须是 **in-flight 动作**(invoke 已发出、或写明下一 dispatch 的 Assignment 字段),**不得**以对用户的确认问句结尾。
46
+
47
+ SSOT 细化:`mstar-sdd`(task 级)· `mstar-iteration` §2.6(push 纪律)。
48
+
28
49
  ## PM invariants(Phase 2–5 全程有效)
29
50
 
30
51
  | 禁止(PM 线程) | 必须 |
31
52
  |-----------------|------|
32
53
  | Write/Edit/Shell 产品代码、写测试、跑 QC 审查(Phase 2) | 每条 implement/QC/QA Assignment ⇒ **1 次 `Task`** |
54
+ | **进度汇报后问「是否继续」或以 phase 摘要收束 turn** | 汇报后**立刻** dispatch 或进入下一 phase 动作(见上节 Continuous execution) |
33
55
  | **多 task plan 用 inline 大包派发**(整份 plan / T1–Tn 贴进一个 dev Assignment) | **SDD**:`mstar-sdd` per-task 循环 — `task-brief` → implementer → `review-package` → task reviewer → `progress.md` |
34
56
  | 只写 Assignment 就进入下一 gate | 同轮 dispatch:`Subagent invokes issued: N`(N = Assignment 条数) |
35
57
  | 最后一个 plan `Done` 后直接开 PR / 汇报结束 | **Phase 3 → 4 → 5** 顺序执行 |
@@ -60,6 +82,8 @@ Phase 2: Autonomous Execute → Phase 3: iteration-close → Phase 4: Create
60
82
 
61
83
  ## Phase 2: Autonomous Execute
62
84
 
85
+ **Continuous execution applies** — 本节全程遵守上节 **Continuous execution(HARD)**;Completion Report / 进度同步后不得 check-in,下一条必须是 dispatch 或下一 plan。
86
+
63
87
  **Branch policy first** — before any plan dispatch(`mstar-iteration` §2.3):
64
88
 
65
89
  | Field | SSOT | If missing |
@@ -6,7 +6,7 @@ Parallel PM dispatch: **`parallel-dispatch.md`** (Task tool uses same turn model
6
6
 
7
7
  ## Cursor-only context
8
8
 
9
- - Role prompts: `mstar-roles`; **`/pm`** or **`pm` skill** → general PM orchestration (per-plan dispatch, gates, QC) without an iteration command. **`commands/`** (`iteration-start`, `iteration-drive`, `mstar-bootstrap`) only when running formal iteration Phase 1–5.
9
+ - Role prompts: `mstar-roles`; **`/pm`** or **`pm` skill** → general PM orchestration (per-plan dispatch, gates, QC) without an iteration command. Host **`commands/`** for formal iteration Phase 1–5 (semantics → **`mstar-iteration`**).
10
10
  - Routing-eval: `.cursor/skills/mstar-routing-eval/` — regression tooling only; not runtime load order.
11
11
 
12
12
  ## Plan mode × harness dual-write
@@ -6,7 +6,7 @@ Parallel PM dispatch: **`parallel-dispatch.md`** (read in dispatch rounds).
6
6
 
7
7
  ## Role loading
8
8
 
9
- - **PM entry**: **`/pm`** or **`pm` skill** → `project-manager` for general orchestration; **`commands/`** (`iteration-start`, `iteration-drive`, `mstar-bootstrap`) for formal iteration only.
9
+ - **PM entry**: **`/pm`** or **`pm` skill** → `project-manager` for general orchestration; host **`commands/`** for formal iteration Phase 1–5 (semantics → **`mstar-iteration`**).
10
10
  - **Role shell**: `agents/<id>.md` referenced by `opencode.json` `agent.<id>` (frontmatter + role binding only).
11
11
  - **Role body**: `mstar-roles` `references/<id>.md` (or shared references + parameters).
12
12
  - Implementation evidence and RCA behavior: `mstar-coding-behavior`.
@@ -283,11 +283,15 @@ Iteration Phase 2 附加:
283
283
  - `Subagent invokes issued: 0` 而 Assignment 已写出 → **`dispatch incomplete`**;下一条补发 invoke,禁止 PM 顶替
284
284
  - QC 初轮:**SDD → N=3**;**inline → N=1**;双轨 implement → **N=2**(同条消息发满 N)
285
285
 
286
- ### 2.6 Push 纪律
286
+ ### 2.6 Push 纪律(Autonomous Execute)
287
287
 
288
- - 不因 harness 基础问题常问"是否继续"—— 决策、记录、**dispatch**
289
- - 未知 → 读 `mstar-*`;**`Blocked`** 或仅对 stop/secrets/不可逆范围缺口/冲突后升级
288
+ **Continuous execution(HARD)**:Phase 2 Autonomous Execute 经 Phase 5 merge-ready exit 全程 不向用户做例行 yes/no check-in。
289
+
290
+ - 不因 harness 流程问题常问「是否继续」「要不要现在启动」—— **决策、记录、dispatch**
291
+ - 进度汇报 / subagent Completion Report 后,下一条必须是 **dispatch 或下一 gate 动作**,不得以确认问句收束 turn
292
+ - 未知 → 读 `mstar-*`;仅 **`Blocked`**、secrets、不可逆范围缺口、branch metadata 缺失、或 Phase 5 多轮仍 blocked 时升级用户
290
293
  - 实际 Git ≠ `working_branch` → **同轮**更新 plan + status
294
+ - Per-plan loop **串行**(plan A Done 后再 plan B);plan 内 SDD task **串行** — 见 §2.4、§2.5、`mstar-sdd` Continuous execution
291
295
 
292
296
  ---
293
297
 
@@ -177,4 +177,4 @@ read `mstar-host` → the active host reference and `references/parallel-dispatc
177
177
 
178
178
  - 把整份 plan 或 T1–Tn 全文贴进 **一个** `fullstack-dev` leaf Assignment。
179
179
  - 省略 `Execution mode` / `SDD dir` / `Model tier` 却期望 SDD 产物(`progress.md`、per-task review)。
180
- - 期望 leaf `fullstack-dev` 载入 `mstar-sdd` 并自编排 per-task 循环 — **编排仅 PM**(`iteration-drive` / `mstar-iteration` §2.4–2.5)。
180
+ - 期望 leaf `fullstack-dev` 载入 `mstar-sdd` 并自编排 per-task 循环 — **编排仅 PM**(`mstar-iteration` §2.4–2.5)。
@@ -143,7 +143,7 @@ If any fail -> do not dispatch implement.
143
143
  | Entry | Next reads |
144
144
  |-------|------------|
145
145
  | **`/pm`** or **`pm` skill** (Codex, Cursor; OpenCode when no command) | This shim → **`project-manager.md`** § Required Reading + topic skills on demand |
146
- | **Cursor / OpenCode** **`commands/`** (`iteration-start`, `iteration-drive`, `mstar-bootstrap`) | Command **Boot** + **`project-manager.md`** — iteration lifecycle only; **not** required for ordinary per-plan PM |
146
+ | **Cursor / OpenCode** host iteration `commands/` | Command Boot + **`project-manager.md`** — iteration lifecycle only; **not** required for ordinary per-plan PM |
147
147
  | **OpenCode** (no command, not `/pm`) | `project-manager` + `mstar-host` → `opencode.md` |
148
148
 
149
149
  **Dispatch-first**, iteration branch policy(`iteration_base_branch` / `spec_integration_branch` / `target_branch`), Autonomous Execute → **`mstar-iteration`** §2. Routing, gates, Task Board, QC, templates → this file + topic `mstar-*` skills.
@@ -11,7 +11,7 @@ SSOT for mode selection and host resume → this file. Per-task artifacts → **
11
11
  | **`fresh`** (default) | Independent tasks, module boundaries, different dev tracks, or first task on a plan |
12
12
  | **`sticky`** | Same `fullstack-dev` (or same role id), sequential tasks on one branch, strong file/context continuity (e.g. T3+T4 daemon stderr + DB reset) |
13
13
 
14
- **Prefer `sticky`** on iteration-drive Phase 2 when PM will dispatch many tasks to the same dev on one plan feature branch.
14
+ **Prefer `sticky`** on iteration Phase 2 Autonomous Execute when PM will dispatch many tasks to the same dev on one plan feature branch.
15
15
 
16
16
  ## Assignment fields (implement dispatch)
17
17
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: pm
3
- description: "PM entry shim — force project-manager orchestration when user invokes /pm or this skill (Codex and Cursor). General per-plan PM work: this skill + project-manager.md. Formal iteration lifecycle on Cursor/OpenCode: commands (iteration-start, iteration-drive, mstar-bootstrap). Boot, routing, dispatch SSOT → mstar-roles/references/project-manager.md and topic mstar-* skills — not here."
3
+ description: "PM entry shim — force project-manager orchestration when user invokes /pm or this skill (Codex and Cursor). General per-plan PM work: this skill + project-manager.md. Formal iteration lifecycle: mstar-iteration (host commands/ may orchestrate Phase 1–5). Boot, routing, dispatch SSOT → mstar-roles/references/project-manager.md and topic mstar-* skills — not here."
4
4
  ---
5
5
 
6
6
  # PM (entry shim)
@@ -12,10 +12,10 @@ description: "PM entry shim — force project-manager orchestration when user in
12
12
  | Host | Use |
13
13
  |------|-----|
14
14
  | **Codex** | **`/pm`** or this skill → **`project-manager`** for the session |
15
- | **Cursor** | **`/pm`** or this skill → general PM orchestration (single-plan, hotfix, QC waves, dispatch) **without** starting an iteration. Formal iteration → **`commands/`** below |
15
+ | **Cursor** | **`/pm`** or this skill → general PM orchestration (single-plan, hotfix, QC waves, dispatch) **without** starting an iteration. Formal iteration → host **`commands/`** + **`mstar-iteration`** |
16
16
  | **OpenCode** | Same as Cursor when no command: **`project-manager`** via `mstar-roles` → `references/project-manager.md` |
17
17
 
18
- **Iteration commands** (optional; carry their own Boot): `iteration-start`, `iteration-drive`, `mstar-bootstrap` use when running Phase 1–5 iteration lifecycle, not required for ordinary PM work.
18
+ **Iteration lifecycle** (optional): host `commands/` may sequence Phase 1–5; semantics SSOT → **`mstar-iteration`**. Not required for ordinary PM work.
19
19
 
20
20
  Detect host → **`mstar-host`** → `references/codex.md` | `cursor.md` | `opencode.md`.
21
21
 
@@ -25,10 +25,11 @@ Detect host → **`mstar-host`** → `references/codex.md` | `cursor.md` | `open
25
25
  2. `mstar-roles` → **`references/project-manager.md`** — required reading list, routing, dispatch-first, iteration branch policy
26
26
  3. Topic skills **on demand** per that file and the active workflow (`mstar-dispatch-gates`, `mstar-iteration`, `mstar-sdd`, `mstar-review-qc`, …)
27
27
 
28
- ## Three rules (everything else is a pointer)
28
+ ## Four rules (everything else is a pointer)
29
29
 
30
30
  1. **Delegate** — PM does not implement, QC, or QA in-thread (`project-manager.md` Execution Boundary; hotfix → `mstar-phase-gates`).
31
31
  2. **Dispatch** — when host has invoke/Task tools: **1 Assignment ⇒ 1 invoke** (`mstar-dispatch-gates`). Markdown alone is not dispatch.
32
- 3. **SSOT** — iteration lifecycle → **`mstar-iteration`** (or **`commands/`** on Cursor/OpenCode); Cursor Plan mode → **`mstar-host/references/cursor-plan-mode-bridge.md`**.
32
+ 3. **SSOT** — iteration lifecycle → **`mstar-iteration`**; Cursor Plan mode → **`mstar-host/references/cursor-plan-mode-bridge.md`**.
33
+ 4. **Autonomous Execute push** — multi-plan iteration Phase 2–5: continuously dispatch implement → QC → QA → Done through merge-ready exit without routine yes/no prompts; **Blocked** only on true conflicts or metadata gaps → **`mstar-iteration` §2.6**.
33
34
 
34
35
  Conflict: user instructions → project `AGENTS.md` / `CLAUDE.md` → `mstar-harness-core` → this file.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mstar-harness/opencode",
3
- "version": "1.0.2",
3
+ "version": "1.0.3",
4
4
  "description": "Morning Star harness OpenCode plugin (skills bootstrap and agent loading).",
5
5
  "license": "MIT",
6
6
  "repository": {