@mstar-harness/dsh 3.8.1 → 3.8.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.
Files changed (78) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +16 -6
  3. package/README.zh.md +16 -6
  4. package/dist/client/panel/engine-status-client.d.ts +84 -6
  5. package/dist/client/panel/graph/project-graph.d.ts +26 -13
  6. package/dist/client/panel/guards.d.ts +41 -1
  7. package/dist/client/panel/locale.d.ts +1 -1
  8. package/dist/client/panel/pages/AgentListPage.d.ts +1 -1
  9. package/dist/client/panel/sidebar.d.ts +3 -2
  10. package/dist/client/panel/state-section.d.ts +25 -3
  11. package/dist/client/panel/use-mstar-engine-status.d.ts +28 -4
  12. package/dist/client.js +346 -48
  13. package/dist/engine-status-endpoint.d.ts +85 -8
  14. package/dist/engine-status-store.d.ts +91 -1
  15. package/dist/engine-status-wire.d.ts +9 -0
  16. package/dist/gates/_shared.d.ts +61 -9
  17. package/dist/gates/adapter.d.ts +32 -2
  18. package/dist/gates/agent-flow.d.ts +312 -60
  19. package/dist/gates/catalog.d.ts +58 -37
  20. package/dist/gates/dispatch.d.ts +11 -2
  21. package/dist/gates/goal-bridge.d.ts +10 -130
  22. package/dist/gates/plan-mode-bridge.d.ts +20 -11
  23. package/dist/gates/role-persona.d.ts +16 -0
  24. package/dist/gates/steering.d.ts +41 -0
  25. package/dist/gates/workflow-ledger.d.ts +31 -4
  26. package/dist/gates/workflow-selection.d.ts +41 -20
  27. package/dist/index.js +1206 -392
  28. package/dist/types.d.ts +36 -11
  29. package/harness-commands/amazing-e2e-check.md +10 -0
  30. package/harness-commands/amazing-pr-review.md +2 -0
  31. package/harness-commands/codebase-audit.md +2 -0
  32. package/harness-commands/iteration-drive.md +1 -1
  33. package/harness-skills/mstar-artifacts/references/plan-files-and-reports.md +2 -2
  34. package/harness-skills/mstar-artifacts/references/plan-quality-bar.md +14 -12
  35. package/harness-skills/mstar-artifacts/templates/plan.main.md +19 -6
  36. package/harness-skills/mstar-audit/SKILL.md +5 -5
  37. package/harness-skills/mstar-coding-behavior/SKILL.md +8 -8
  38. package/harness-skills/mstar-dispatch-gates/SKILL.md +9 -7
  39. package/harness-skills/mstar-e2e/SKILL.md +40 -0
  40. package/harness-skills/mstar-e2e/references/report-template.md +32 -0
  41. package/harness-skills/mstar-engine-legacy/references/qc-seat-n-restatements.md +3 -3
  42. package/harness-skills/mstar-harness-core/SKILL.md +14 -1
  43. package/harness-skills/mstar-host/SKILL.md +3 -1
  44. package/harness-skills/mstar-host/references/_shared/host-role-binding-core.md +1 -1
  45. package/harness-skills/mstar-host/references/cursor.md +1 -1
  46. package/harness-skills/mstar-host/references/dsh-workflow-scripts.md +424 -0
  47. package/harness-skills/mstar-host/references/dsh.md +180 -51
  48. package/harness-skills/mstar-host/references/kimi.md +3 -3
  49. package/harness-skills/mstar-host/references/omp.md +3 -3
  50. package/harness-skills/mstar-host/references/parallel-dispatch.md +6 -6
  51. package/harness-skills/mstar-host/references/zcode.md +4 -4
  52. package/harness-skills/mstar-iteration/SKILL.md +1 -1
  53. package/harness-skills/mstar-iteration/references/phase-1-prepare.md +2 -2
  54. package/harness-skills/mstar-iteration/references/phase-2-worktree-lease.md +3 -3
  55. package/harness-skills/mstar-review-qc/SKILL.md +4 -4
  56. package/harness-skills/mstar-review-qc/references/review-responsibility-boundaries.md +9 -7
  57. package/harness-skills/mstar-roles/SKILL.md +2 -0
  58. package/harness-skills/mstar-roles/references/_shared/leaf-executor-core.md +9 -0
  59. package/harness-skills/mstar-roles/references/ops-engineer.md +3 -0
  60. package/harness-skills/mstar-roles/references/project-manager/dispatch-and-assignment.md +12 -9
  61. package/harness-skills/mstar-roles/references/project-manager/qa-trigger-matrix.md +7 -5
  62. package/harness-skills/mstar-roles/references/project-manager/qc-and-residuals.md +2 -2
  63. package/harness-skills/mstar-roles/references/project-manager/routing-and-dev-allocation.md +2 -2
  64. package/harness-skills/mstar-roles/references/project-manager.md +4 -2
  65. package/harness-skills/mstar-roles/references/qa-engineer/acceptance-gate.md +12 -13
  66. package/harness-skills/mstar-roles/references/qa-engineer.md +5 -4
  67. package/harness-skills/mstar-roles/references/qc-specialist/deep-review-lenses.md +5 -5
  68. package/harness-skills/mstar-roles/references/qc-specialist/report-template.md +2 -0
  69. package/harness-skills/mstar-roles/references/qc-specialist/reviewer-checklist.md +1 -1
  70. package/harness-skills/mstar-roles/references/qc-specialist/reviewer-workflow.md +5 -4
  71. package/harness-skills/mstar-roles/references/qc-specialist-shared.md +3 -1
  72. package/harness-skills/mstar-sdd/SKILL.md +17 -9
  73. package/harness-skills/mstar-sdd/references/file-handoffs.md +40 -20
  74. package/harness-skills/mstar-sdd/references/implementer-continuation-prompt.md +9 -4
  75. package/harness-skills/mstar-sdd/references/implementer-prompt.md +11 -6
  76. package/harness-skills/mstar-sdd/references/sticky-implementer-session.md +4 -2
  77. package/harness-skills/mstar-sdd/references/task-reviewer-prompt.md +8 -4
  78. package/package.json +2 -2
@@ -26,10 +26,10 @@ Dispatch:
26
26
 
27
27
  - Control harness root (briefs/reports/diffs live here): [CONTROL_ROOT]
28
28
  - Feature worktree — cwd for all source edits, branch [WORKING_BRANCH]: [FEATURE_CWD]
29
- - Plan: [PLAN_FILE] — Context file: [CONTEXT_FILE]
29
+ - Plan: [PLAN_FILE] — PM coordination context: [CONTEXT_FILE] (never use it to select your checkout)
30
30
  - Brief: [BRIEF_FILE] — Report: [REPORT_FILE]
31
31
  - First step on resume: re-observe `pwd` and the checked-out branch — a sticky session may wake in a different cwd; on mismatch with [FEATURE_CWD]/[WORKING_BRANCH], stop and report BLOCKED — do not write.
32
- - These destinations bind the handoff, not the host: a later deliberate `chdir`, absolute-path write outside [FEATURE_CWD], or host-native edit tool (apply_patch) is NOT blocked. CLI-launchable children are started via `mstar sdd exec --context [CONTEXT_FILE] -- <argv>` (starting cwd = feature worktree).
32
+ - These destinations bind the handoff, not the host: a later deliberate `chdir`, absolute-path write outside [FEATURE_CWD], or host-native edit tool (apply_patch) is NOT blocked. Execute allowed commands directly with the tool workdir fixed to the verified [FEATURE_CWD] / [WORKING_BRANCH]. Hosted leaves must not invoke `mstar sdd exec --context` or resolve cwd from mutable shared context; that entry is reserved for PM serialized CLI launch (file-handoffs.md § Bound child launch).
33
33
 
34
34
  ## Context not in the brief
35
35
 
@@ -39,11 +39,16 @@ Dispatch:
39
39
 
40
40
  Write your full report to: [REPORT_FILE]
41
41
 
42
+ ## Scope and stop
43
+
44
+ Use only the brief's owned files, relevant inputs and named checks. Do not restart global exploration, extend the task, or run local full suites without the user's explicit scoped permission. Reuse unaffected evidence. Stop once the assigned acceptance criteria are evidenced; report concrete missing context instead of over-analyzing settled work.
45
+
42
46
  ## Your job
43
47
 
44
48
  1. Implement exactly what this brief specifies (prior tasks are done)
45
- 2. Run tests; commit on Working branch
46
- 3. Write report file; return short summary only
49
+ 2. Run only assigned affected unit tests or applicable scoped-check evidence; use file-handoffs.md § Verification evidence and retain unaffected prior evidence
50
+ 3. Commit on Working branch
51
+ 4. Write report file with actual evidence; return short summary only
47
52
 
48
53
  ## When stuck
49
54
 
@@ -26,10 +26,10 @@ Dispatch:
26
26
 
27
27
  - Control harness root (briefs/reports/diffs live here): [CONTROL_ROOT]
28
28
  - Feature worktree — cwd for all source edits, branch [WORKING_BRANCH]: [FEATURE_CWD]
29
- - Plan: [PLAN_FILE] — Context file: [CONTEXT_FILE]
29
+ - Plan: [PLAN_FILE] — PM coordination context: [CONTEXT_FILE] (never use it to select your checkout)
30
30
  - Brief: [BRIEF_FILE] — Report: [REPORT_FILE]
31
31
  - First step: observe `pwd` and the checked-out branch; on mismatch with [FEATURE_CWD]/[WORKING_BRANCH], stop and report BLOCKED — do not write. A declared-correct assignment does not make a wrong-checkout write safe.
32
- - These destinations bind the handoff, not the host: a later deliberate `chdir`, absolute-path write outside [FEATURE_CWD], or host-native edit tool (apply_patch) is NOT blocked. CLI-launchable children are started via `mstar sdd exec --context [CONTEXT_FILE] -- <argv>` (starting cwd = feature worktree).
32
+ - These destinations bind the handoff, not the host: a later deliberate `chdir`, absolute-path write outside [FEATURE_CWD], or host-native edit tool (apply_patch) is NOT blocked. Execute allowed commands directly with the tool workdir fixed to the verified [FEATURE_CWD] / [WORKING_BRANCH]. Hosted leaves must not invoke `mstar sdd exec --context` or resolve cwd from mutable shared context; that entry is reserved for PM serialized CLI launch (file-handoffs.md § Bound child launch).
33
33
 
34
34
  ## Context not in the brief
35
35
 
@@ -41,14 +41,18 @@ Dispatch:
41
41
 
42
42
  ## Before you begin
43
43
 
44
- Ask questions now about requirements, approach, or dependencies.
44
+ Read the supplied brief and relevant inputs. Ask only about a concrete missing prerequisite that prevents this task; do not reopen settled choices.
45
+
46
+ ## Scope and stop
47
+
48
+ Use only the brief's owned files, relevant inputs and named checks. Do not restart global exploration, extend the task, or run local full suites without the user's explicit scoped permission. Reuse unaffected evidence. Stop once the assigned acceptance criteria are evidenced; report concrete missing context instead of over-analyzing settled work.
45
49
 
46
50
  ## Your job
47
51
 
48
52
  1. Implement exactly what the brief specifies
49
- 2. Run tests (TDD if brief requires)
53
+ 2. Run only the assigned affected unit tests; for non-executable docs/policy, use real scoped-check evidence per file-handoffs.md § Verification evidence
50
54
  3. Commit on Working branch
51
- 4. Self-review
55
+ 4. Self-review only the task diff and directly affected contracts
52
56
  5. Write report file; return short summary only
53
57
 
54
58
  ## When stuck
@@ -59,7 +63,8 @@ Dispatch:
59
63
 
60
64
  - Status: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED
61
65
  - Implemented / attempted
62
- - Tests: command, output, red/green evidence if TDD
66
+ - Verification: affected test files, command, actual output (red/green for executable bug fixes), OR the complete scoped-check block from file-handoffs.md for non-executable docs/policy
67
+ - Reused evidence: original range and reason it remains applicable
63
68
  - Files changed
64
69
  - Self-review notes
65
70
  ```
@@ -4,14 +4,16 @@ Reuse the **same implementer subagent** across multiple tasks in one plan when t
4
4
 
5
5
  SSOT for mode selection and host resume → this file. Per-task artifacts → **`file-handoffs.md`**.
6
6
 
7
+ **Parallel ready tasks use fresh sessions and task-specific artifact paths inside one canonical per-plan SDD root** (`mstar-sdd` § Ready-task scheduling). Never resume the same session concurrently or share its ledger between tracks; PM alone updates shared context/progress; parallel leaves consume immutable absolute artifact paths, not shared-context helpers.
8
+
7
9
  ## When to use
8
10
 
9
11
  | `SDD implementer session` | Use |
10
12
  |---------------------------|-----|
11
13
  | **`fresh`** (default) | Independent tasks, module boundaries, different dev tracks, or first task on a plan |
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) |
14
+ | **`sticky`** | One sequential dependency chain on one owner track; 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
15
 
14
- **Prefer `sticky`** on iteration Phase 2 Autonomous Execute when PM will dispatch many tasks to the same dev on one plan feature branch.
16
+ **Prefer `sticky`** only within a sequential dependency chain with strong context continuity; independent ready tasks remain fresh and concurrent.
15
17
 
16
18
  ## Assignment fields (implement dispatch)
17
19
 
@@ -12,7 +12,7 @@ Dispatch:
12
12
  <SUBAGENT-STOP> Skip PM orchestration. Read-only review.</SUBAGENT-STOP>
13
13
 
14
14
  Review one task implementation: spec compliance first, then quality.
15
- Task-scoped gate — plan-level QC comes later on the whole branch.
15
+ Task-scoped gate — later plan QC checks changed interfaces across tasks, reusing this report.
16
16
 
17
17
  ## What was requested
18
18
 
@@ -39,8 +39,12 @@ Dispatch:
39
39
  Diff file: [DIFF_FILE]
40
40
 
41
41
  Read the diff file once. Do not re-run git. Do not mutate checkout.
42
- Do not re-run full test suite — trust implementer evidence unless a
43
- specific doubt needs one focused test.
42
+ Review only the assigned task diff and directly affected interfaces.
43
+ No repository-wide exploration or full test suite. Reuse relevant
44
+ implementer evidence; a specific doubt permits only the assigned focused
45
+ unit check. Non-executable docs/policy may use scoped-check evidence;
46
+ verify its applicability against the diff, never invent a test obligation.
47
+ Stop once the assigned acceptance questions are answered.
44
48
 
45
49
  ## Output
46
50
 
@@ -57,4 +61,4 @@ Dispatch:
57
61
  **Task quality:** Approved | Needs fixes
58
62
  ```
59
63
 
60
- Re-review after fixes covers both verdicts. PM resolves all ⚠️ items before marking task complete.
64
+ Re-review after fixes checks both verdicts only for the raised findings and fix delta; unchanged evidence remains reusable. PM resolves all ⚠️ items before marking task complete.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mstar-harness/dsh",
3
- "version": "3.8.1",
3
+ "version": "3.8.3",
4
4
  "description": "Morning Star harness dsh (DeepSeek Harness) cordis function plugin — in-process engine gates (status/dispatch/lease) with hard refusal channels.",
5
5
  "keywords": [
6
6
  "dsh",
@@ -145,7 +145,7 @@
145
145
  "anser": "^2.3.5",
146
146
  "bun-types": "^1.2.17",
147
147
  "clsx": "^2.0.0",
148
- "dsh-llm-fallbacks": "0.4.1",
148
+ "dsh-llm-fallbacks": "0.5.2",
149
149
  "immer": "^10.1.1",
150
150
  "js-yaml": "^4.1.0",
151
151
  "katex": "^0.16.47",