@mstar-harness/opencode 3.1.2 → 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.
Files changed (76) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/dist/mstar.js +200 -113
  3. package/harness-commands/codebase-audit.md +3 -3
  4. package/harness-commands/iteration-drive.md +9 -90
  5. package/harness-commands/iteration-loop.md +22 -62
  6. package/harness-commands/iteration-start.md +20 -77
  7. package/harness-commands/pr-deep-review.md +37 -0
  8. package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/SKILL.md +3 -3
  9. package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/knowledge-and-designs.md +8 -8
  10. package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/plan-files-and-reports.md +6 -6
  11. package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/status-and-residuals.md +3 -3
  12. package/harness-skills/mstar-artifacts/templates/README.md +7 -0
  13. package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/templates/plan.main.md +1 -1
  14. package/harness-skills/mstar-audit/SKILL.md +36 -89
  15. package/harness-skills/mstar-audit/references/audit-playbook.md +1 -1
  16. package/harness-skills/mstar-audit/references/codebase-audit.md +85 -0
  17. package/harness-skills/mstar-audit/references/pr-review.md +139 -0
  18. package/harness-skills/mstar-branch-worktree/SKILL.md +5 -5
  19. package/harness-skills/mstar-compound/SKILL.md +4 -4
  20. package/harness-skills/mstar-compound/references/compound-workflow.md +1 -1
  21. package/harness-skills/mstar-compound-refresh/SKILL.md +4 -4
  22. package/harness-skills/mstar-compound-refresh/references/project-knowledge-bootstrap.md +3 -3
  23. package/harness-skills/{mstar-plan-conventions → mstar-conventions}/SKILL.md +9 -9
  24. package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/artifact-storage-paths.md +13 -13
  25. package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/harness-bootstrap-and-agents-layering.md +5 -5
  26. package/harness-skills/mstar-design-md/SKILL.md +3 -3
  27. package/harness-skills/mstar-dispatch-gates/SKILL.md +3 -3
  28. package/harness-skills/mstar-engine-legacy/SKILL.md +1 -1
  29. package/harness-skills/mstar-engine-legacy/references/lease-protocol.md +1 -1
  30. package/harness-skills/mstar-engine-legacy/references/status-field-history.md +1 -1
  31. package/harness-skills/mstar-harness-core/SKILL.md +21 -20
  32. package/harness-skills/mstar-host/references/_shared/plan-mode-bridge-core.md +5 -5
  33. package/harness-skills/mstar-host/references/cursor-plan-mode-bridge.md +7 -7
  34. package/harness-skills/mstar-host/references/cursor.md +1 -1
  35. package/harness-skills/mstar-host/references/kimi-plan-mode-bridge.md +1 -1
  36. package/harness-skills/mstar-host/references/omp-plan-mode-bridge.md +1 -1
  37. package/harness-skills/mstar-host/references/parallel-dispatch.md +1 -1
  38. package/harness-skills/mstar-host/references/zcode-plan-mode-bridge.md +1 -1
  39. package/harness-skills/mstar-iteration/SKILL.md +21 -15
  40. package/harness-skills/mstar-iteration/references/command-shared-invariants.md +62 -0
  41. package/harness-skills/mstar-iteration/references/iteration-artifact-boundaries.md +1 -1
  42. package/harness-skills/mstar-iteration/references/phase-2-worktree-lease.md +5 -5
  43. package/harness-skills/mstar-iteration/references/phase-3-iteration-close.md +1 -1
  44. package/harness-skills/mstar-iteration/references/phase-4-5-pr-delivery.md +1 -1
  45. package/harness-skills/mstar-iteration/references/phase5-helper-discovery.md +1 -1
  46. package/harness-skills/mstar-phase-gates/SKILL.md +5 -5
  47. package/harness-skills/mstar-project-governance/SKILL.md +9 -9
  48. package/harness-skills/mstar-review-qc/SKILL.md +4 -4
  49. package/harness-skills/mstar-roles/SKILL.md +7 -7
  50. package/harness-skills/mstar-roles/references/_shared/leaf-executor-core.md +20 -2
  51. package/harness-skills/mstar-roles/references/architect.md +7 -10
  52. package/harness-skills/mstar-roles/references/code-reviewer.md +7 -10
  53. package/harness-skills/mstar-roles/references/frontend-dev.md +6 -5
  54. package/harness-skills/mstar-roles/references/fullstack-dev-shared.md +6 -5
  55. package/harness-skills/mstar-roles/references/ops-engineer.md +3 -7
  56. package/harness-skills/mstar-roles/references/product-manager.md +8 -11
  57. package/harness-skills/mstar-roles/references/project-manager/dispatch-and-assignment.md +1 -1
  58. package/harness-skills/mstar-roles/references/project-manager/plan-management.md +3 -3
  59. package/harness-skills/mstar-roles/references/project-manager/qa-trigger-matrix.md +2 -2
  60. package/harness-skills/mstar-roles/references/project-manager/qc-and-residuals.md +3 -3
  61. package/harness-skills/mstar-roles/references/project-manager.md +5 -5
  62. package/harness-skills/mstar-roles/references/prompt-engineer.md +4 -7
  63. package/harness-skills/mstar-roles/references/qa-engineer/acceptance-gate.md +2 -2
  64. package/harness-skills/mstar-roles/references/qa-engineer.md +4 -8
  65. package/harness-skills/mstar-roles/references/qc-specialist/report-template.md +1 -1
  66. package/harness-skills/mstar-roles/references/qc-specialist/reviewer-workflow.md +1 -1
  67. package/harness-skills/mstar-roles/references/qc-specialist-shared.md +5 -8
  68. package/harness-skills/mstar-roles/references/writing-specialist.md +3 -6
  69. package/harness-skills/mstar-sdd/SKILL.md +2 -2
  70. package/harness-skills/mstar-sdd/references/file-handoffs.md +1 -1
  71. package/harness-skills/mstar-strategy/SKILL.md +8 -38
  72. package/package.json +1 -1
  73. package/harness-skills/mstar-plan-artifacts/templates/README.md +0 -7
  74. /package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/plan-quality-bar.md +0 -0
  75. /package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/templates/status.empty.json +0 -0
  76. /package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/effort-estimation.md +0 -0
@@ -7,7 +7,7 @@ description: Morning Star 全局战略方向 —— 创建并维护 `STRATEGY.md
7
7
 
8
8
  ## Load order
9
9
 
10
- **Read `mstar-harness-core` first.** Path symbols → **`mstar-plan-conventions`**. On conflict, **`mstar-harness-core` wins**.
10
+ **Read `mstar-harness-core` first.** Path symbols → **`mstar-conventions`**. On conflict, **`mstar-harness-core` wins**.
11
11
 
12
12
  ## Purpose
13
13
 
@@ -17,7 +17,7 @@ Without a strategy document, decisions are made in isolation — each plan misse
17
17
 
18
18
  ## 产物存储位置
19
19
 
20
- **SSOT**: `mstar-plan-conventions/references/artifact-storage-paths.md`。STRATEGY.md → `<repo-root>/STRATEGY.md`(与 `.git/`、`AGENTS.md` 同级)。**禁止**放入 `{HARNESS_DIR}`、`docs/` 或任何子目录。
20
+ **SSOT**: `mstar-conventions/references/artifact-storage-paths.md`。STRATEGY.md → `<repo-root>/STRATEGY.md`(与 `.git/`、`AGENTS.md` 同级)。**禁止**放入 `{HARNESS_DIR}`、`docs/` 或任何子目录。
21
21
 
22
22
  ## When to use
23
23
 
@@ -68,15 +68,9 @@ A good strategy document is opinionated and concise. It should fit in one screen
68
68
 
69
69
  ## Creating STRATEGY.md
70
70
 
71
- ### Phase 1: Gather context
71
+ Creating and maintaining `STRATEGY.md` follows the **project knowledge bootstrap**: **`mstar-compound-refresh`** → `references/project-knowledge-bootstrap.md` **Phase 2 (Distill STRATEGY.md)** — survey context → interview → draft/review → stale/partial/current handling. The six-section structure and the engine check above stay authoritative here.
72
72
 
73
- 1. Read existing project documentation (README, AGENTS.md, existing specs).
74
- 2. If `{KNOWLEDGE_DIR}` or `{ITERATION_DIR}` exist, scan for architectural decisions and patterns.
75
- 3. If `CONCEPTS.md` exists, use it to understand domain vocabulary.
76
-
77
- ### Phase 2: Interview
78
-
79
- Ask PM these questions (one at a time):
73
+ ### Interview (ask PM the 5 questions one at a time)
80
74
 
81
75
  1. "What is the one-sentence vision for this project?"
82
76
  2. "Who are the primary users and what do they need most?"
@@ -84,33 +78,9 @@ Ask PM these questions (one at a time):
84
78
  4. "What 2-3 principles should guide every technical decision?"
85
79
  5. "What technology bets have you made, and why?"
86
80
 
87
- ### Phase 3: Draft
88
-
89
- Write STRATEGY.md at the repo root. Keep it concise — each section should be 1-3 sentences or a short bullet list.
90
-
91
- ### Phase 4: Discoverability
92
-
93
- Check if AGENTS.md references STRATEGY.md. If not, propose adding:
94
-
95
- ```markdown
96
- - `STRATEGY.md` — project vision and guiding principles
97
- ```
98
-
99
- Ask for consent before applying.
100
-
101
- ## Maintaining STRATEGY.md
102
-
103
- ### Review triggers
104
-
105
- - After a major architectural decision
106
- - When a plan introduces a new technology stack
107
- - Quarterly review (scheduled by PM)
108
-
109
- ### Update rules
81
+ ### Maintenance
110
82
 
111
- 1. **Be decisive about direction changes.** Don't keep old strategy alongside new — replace it.
112
- 2. **Log decisions with context.** The Decision Log captures *why* a choice was made, not just what.
113
- 3. **Keep it current.** Stale strategy is worse than no strategy — it misdirects plans.
83
+ Review triggers: after a major architectural decision, when a plan introduces a new technology stack, or quarterly (PM-scheduled). Update rules: be decisive about direction changes (replace, don't keep old strategy alongside new); log decisions with context (why, not just what); keep it current stale strategy is worse than no strategy.
114
84
 
115
85
  ## STRATEGY.md vs other docs
116
86
 
@@ -131,7 +101,7 @@ Ask for consent before applying.
131
101
 
132
102
  ## Workflow
133
103
 
134
- 主链:**创建**(Phase 1 收集上下文 Phase 2 访谈 PM Phase 3 落盘 `<repo-root>/STRATEGY.md` Phase 4 可发现性检查)→ **维护**(方向变更时果断替换旧策略、Decision Log 记决策理由、保持最新)→ **定期评审**(重大架构决策后 / 新技术栈引入时 / 季度评审)。作为 brainstorm / plan 的上游锚点被引用。
104
+ 主链:**创建/维护**(survey 访谈 = 五问 draft/review更新/替换/跳过)细节 **`mstar-compound-refresh`** `references/project-knowledge-bootstrap.md` **Phase 2**。作为 brainstorm / plan 的上游锚点被引用。
135
105
 
136
106
  ## Evidence
137
107
 
@@ -141,4 +111,4 @@ Ask for consent before applying.
141
111
 
142
112
  - 迭代级战略对齐(iteration-start §1.1 读 STRATEGY.md)→ **`mstar-iteration`**
143
113
  - 知识维护 / bootstrap(战略变更后的知识对账)→ **`mstar-compound-refresh`**
144
- - 路径符号与产物存储 SSOT → **`mstar-plan-conventions`**
114
+ - 路径符号与产物存储 SSOT → **`mstar-conventions`**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mstar-harness/opencode",
3
- "version": "3.1.2",
3
+ "version": "3.2.0",
4
4
  "description": "Morning Star harness OpenCode plugin — skills bootstrap + engine-backed runtime hooks (status lint, dispatch validation, Enforcement: hard gates).",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -1,7 +0,0 @@
1
- # Plan harness file templates
2
-
3
- Copy these into `{HARNESS_DIR}` when bootstrapping a project. Path symbols (`{HARNESS_DIR}`, `{PLAN_DIR}`, …) → **`mstar-plan-conventions`**. Field semantics and residual lifecycle → **`mstar-plan-artifacts/references/status-and-residuals.md`**. Optional rollup: engine `techDebtRollup` import (read-only; see that reference).
4
-
5
- | File | Copy to | Notes |
6
- |------|---------|--------|
7
- | `status.empty.json` | `{HARNESS_DIR}/status.json` | The **v2 root register** shape (`version: 2`, `updated_at`, `workflows: []`) — see **`mstar-plan-artifacts` SKILL.md** + `references/status-and-residuals.md`. Replace `updated_at` with the real date. Per-lifecycle snapshot / register / lease fields are created at runtime by engine writers (`workflows/<id>/snapshot.json`, `projects/<id>/residuals.json`) — not in the empty template. |