@mstar-harness/dsh 2.1.1

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 (146) hide show
  1. package/README.i18n.yaml +7 -0
  2. package/README.md +448 -0
  3. package/README.zh.md +221 -0
  4. package/bundle/README.md +312 -0
  5. package/bundle/cordis.patch.yml +17 -0
  6. package/dist/client/index.d.ts +14 -0
  7. package/dist/client/panel/PanelView.d.ts +67 -0
  8. package/dist/client/panel/TabNav.d.ts +28 -0
  9. package/dist/client/panel/graph/event-log.d.ts +76 -0
  10. package/dist/client/panel/graph/project-graph.d.ts +499 -0
  11. package/dist/client/panel/graph/schema.d.ts +224 -0
  12. package/dist/client/panel/guards.d.ts +12 -0
  13. package/dist/client/panel/locale.d.ts +134 -0
  14. package/dist/client/panel/pages/AgentCanvasPage.d.ts +363 -0
  15. package/dist/client/panel/pages/EventLogPage.d.ts +48 -0
  16. package/dist/client/panel/pages/IterationInfoSection.d.ts +80 -0
  17. package/dist/client/panel/pages/IterationTaskPage.d.ts +37 -0
  18. package/dist/client/panel/panel-meta.d.ts +18 -0
  19. package/dist/client/panel/plan-sort.d.ts +54 -0
  20. package/dist/client/panel/sidebar.d.ts +17 -0
  21. package/dist/client/panel/state-section.d.ts +23 -0
  22. package/dist/client/panel/use-mstar-engine-status.d.ts +42 -0
  23. package/dist/client/panel/zones/Legend.d.ts +18 -0
  24. package/dist/client/panel/zones/TaskBoard.d.ts +40 -0
  25. package/dist/client.d.ts +1 -0
  26. package/dist/client.js +4486 -0
  27. package/dist/gates/_shared.d.ts +198 -0
  28. package/dist/gates/adapter.d.ts +131 -0
  29. package/dist/gates/agent-flow.d.ts +320 -0
  30. package/dist/gates/catalog.d.ts +118 -0
  31. package/dist/gates/dispatch.d.ts +152 -0
  32. package/dist/gates/seams.d.ts +152 -0
  33. package/dist/gates/skill-lint.d.ts +87 -0
  34. package/dist/gates/status.d.ts +81 -0
  35. package/dist/gates/tools.d.ts +37 -0
  36. package/dist/index.d.ts +107 -0
  37. package/dist/index.js +5748 -0
  38. package/dist/invariant.d.ts +15 -0
  39. package/dist/invariant.js +29 -0
  40. package/dist/service.d.ts +96 -0
  41. package/dist/types.d.ts +241 -0
  42. package/harness-commands/codebase-audit.md +40 -0
  43. package/harness-commands/iteration-drive.md +129 -0
  44. package/harness-commands/iteration-loop.md +139 -0
  45. package/harness-commands/iteration-start.md +179 -0
  46. package/harness-skills/grill-me/SKILL.md +10 -0
  47. package/harness-skills/mstar-audit/SKILL.md +183 -0
  48. package/harness-skills/mstar-audit/references/audit-playbook.md +130 -0
  49. package/harness-skills/mstar-audit/references/finding-format.md +65 -0
  50. package/harness-skills/mstar-branch-worktree/SKILL.md +219 -0
  51. package/harness-skills/mstar-branch-worktree/references/parallel-writable-pre-dispatch.md +68 -0
  52. package/harness-skills/mstar-coding-behavior/SKILL.md +147 -0
  53. package/harness-skills/mstar-compound/SKILL.md +105 -0
  54. package/harness-skills/mstar-compound/assets/resolution-template.md +94 -0
  55. package/harness-skills/mstar-compound/references/category-mapping.md +37 -0
  56. package/harness-skills/mstar-compound/references/compound-workflow.md +155 -0
  57. package/harness-skills/mstar-compound/references/concepts-vocabulary.md +44 -0
  58. package/harness-skills/mstar-compound/references/schema.yaml +122 -0
  59. package/harness-skills/mstar-compound-refresh/SKILL.md +140 -0
  60. package/harness-skills/mstar-compound-refresh/references/project-knowledge-bootstrap.md +164 -0
  61. package/harness-skills/mstar-design-md/SKILL.md +142 -0
  62. package/harness-skills/mstar-design-md/references/completeness-checklist.md +181 -0
  63. package/harness-skills/mstar-design-md/references/design-md-spec.md +508 -0
  64. package/harness-skills/mstar-design-md/references/vercel-example.md +200 -0
  65. package/harness-skills/mstar-design-md/templates/DESIGN.dark.md.template +354 -0
  66. package/harness-skills/mstar-design-md/templates/DESIGN.md.template +474 -0
  67. package/harness-skills/mstar-dispatch-gates/SKILL.md +128 -0
  68. package/harness-skills/mstar-dispatch-gates/references/leaf-executor-checklist.md +23 -0
  69. package/harness-skills/mstar-harness-core/SKILL.md +180 -0
  70. package/harness-skills/mstar-host/SKILL.md +78 -0
  71. package/harness-skills/mstar-host/references/_shared/host-role-binding-core.md +51 -0
  72. package/harness-skills/mstar-host/references/_shared/plan-mode-bridge-core.md +91 -0
  73. package/harness-skills/mstar-host/references/codex.md +61 -0
  74. package/harness-skills/mstar-host/references/cursor-plan-mode-bridge.md +159 -0
  75. package/harness-skills/mstar-host/references/cursor.md +183 -0
  76. package/harness-skills/mstar-host/references/dsh.md +502 -0
  77. package/harness-skills/mstar-host/references/kimi-plan-mode-bridge.md +36 -0
  78. package/harness-skills/mstar-host/references/kimi.md +136 -0
  79. package/harness-skills/mstar-host/references/omp-plan-mode-bridge.md +32 -0
  80. package/harness-skills/mstar-host/references/omp.md +244 -0
  81. package/harness-skills/mstar-host/references/opencode.md +76 -0
  82. package/harness-skills/mstar-host/references/parallel-dispatch.md +68 -0
  83. package/harness-skills/mstar-host/references/zcode-plan-mode-bridge.md +36 -0
  84. package/harness-skills/mstar-host/references/zcode.md +129 -0
  85. package/harness-skills/mstar-iteration/SKILL.md +393 -0
  86. package/harness-skills/mstar-iteration/references/autonomous-direction-lock.md +90 -0
  87. package/harness-skills/mstar-iteration/references/iteration-artifact-boundaries.md +103 -0
  88. package/harness-skills/mstar-iteration/references/iteration-compass-template.md +142 -0
  89. package/harness-skills/mstar-iteration/references/iteration-corpus-hygiene.md +45 -0
  90. package/harness-skills/mstar-iteration/references/iteration-workspace-readme-template.md +27 -0
  91. package/harness-skills/mstar-iteration/references/phase-2-worktree-lease.md +193 -0
  92. package/harness-skills/mstar-iteration/references/phase-3-iteration-close.md +95 -0
  93. package/harness-skills/mstar-iteration/references/phase-4-5-pr-delivery.md +84 -0
  94. package/harness-skills/mstar-iteration/references/phase5-helper-discovery.md +24 -0
  95. package/harness-skills/mstar-phase-gates/SKILL.md +112 -0
  96. package/harness-skills/mstar-plan-artifacts/SKILL.md +46 -0
  97. package/harness-skills/mstar-plan-artifacts/references/done-compaction.md +88 -0
  98. package/harness-skills/mstar-plan-artifacts/references/knowledge-and-designs.md +100 -0
  99. package/harness-skills/mstar-plan-artifacts/references/plan-files-and-reports.md +99 -0
  100. package/harness-skills/mstar-plan-artifacts/references/plan-quality-bar.md +99 -0
  101. package/harness-skills/mstar-plan-artifacts/references/status-and-residuals.md +570 -0
  102. package/harness-skills/mstar-plan-artifacts/templates/README.md +9 -0
  103. package/harness-skills/mstar-plan-artifacts/templates/notes.empty.json +5 -0
  104. package/harness-skills/mstar-plan-artifacts/templates/plan.main.md +54 -0
  105. package/harness-skills/mstar-plan-artifacts/templates/plans-done.empty.json +3 -0
  106. package/harness-skills/mstar-plan-artifacts/templates/status.empty.json +7 -0
  107. package/harness-skills/mstar-plan-conventions/SKILL.md +165 -0
  108. package/harness-skills/mstar-plan-conventions/references/artifact-storage-paths.md +50 -0
  109. package/harness-skills/mstar-plan-conventions/references/effort-estimation.md +38 -0
  110. package/harness-skills/mstar-plan-conventions/references/harness-bootstrap-and-agents-layering.md +93 -0
  111. package/harness-skills/mstar-review-qc/SKILL.md +60 -0
  112. package/harness-skills/mstar-review-qc/references/review-responsibility-boundaries.md +54 -0
  113. package/harness-skills/mstar-roles/SKILL.md +86 -0
  114. package/harness-skills/mstar-roles/references/_shared/leaf-executor-core.md +46 -0
  115. package/harness-skills/mstar-roles/references/architect.md +114 -0
  116. package/harness-skills/mstar-roles/references/code-reviewer.md +109 -0
  117. package/harness-skills/mstar-roles/references/frontend-dev.md +70 -0
  118. package/harness-skills/mstar-roles/references/fullstack-dev-shared.md +89 -0
  119. package/harness-skills/mstar-roles/references/ops-engineer.md +78 -0
  120. package/harness-skills/mstar-roles/references/product-manager.md +107 -0
  121. package/harness-skills/mstar-roles/references/project-manager/dispatch-and-assignment.md +198 -0
  122. package/harness-skills/mstar-roles/references/project-manager/plan-management.md +61 -0
  123. package/harness-skills/mstar-roles/references/project-manager/qa-trigger-matrix.md +56 -0
  124. package/harness-skills/mstar-roles/references/project-manager/qc-and-residuals.md +98 -0
  125. package/harness-skills/mstar-roles/references/project-manager/routing-and-dev-allocation.md +99 -0
  126. package/harness-skills/mstar-roles/references/project-manager.md +310 -0
  127. package/harness-skills/mstar-roles/references/prompt-engineer.md +71 -0
  128. package/harness-skills/mstar-roles/references/qa-engineer/acceptance-gate.md +62 -0
  129. package/harness-skills/mstar-roles/references/qa-engineer.md +79 -0
  130. package/harness-skills/mstar-roles/references/qc-specialist/deep-review-lenses.md +95 -0
  131. package/harness-skills/mstar-roles/references/qc-specialist/report-template.md +72 -0
  132. package/harness-skills/mstar-roles/references/qc-specialist/reviewer-checklist.md +44 -0
  133. package/harness-skills/mstar-roles/references/qc-specialist/reviewer-workflow.md +57 -0
  134. package/harness-skills/mstar-roles/references/qc-specialist-shared.md +128 -0
  135. package/harness-skills/mstar-roles/references/writing-specialist.md +59 -0
  136. package/harness-skills/mstar-sdd/SKILL.md +133 -0
  137. package/harness-skills/mstar-sdd/references/file-handoffs.md +83 -0
  138. package/harness-skills/mstar-sdd/references/implementer-continuation-prompt.md +44 -0
  139. package/harness-skills/mstar-sdd/references/implementer-prompt.md +56 -0
  140. package/harness-skills/mstar-sdd/references/sticky-implementer-session.md +103 -0
  141. package/harness-skills/mstar-sdd/references/task-reviewer-prompt.md +53 -0
  142. package/harness-skills/mstar-skill-authoring/SKILL.md +162 -0
  143. package/harness-skills/mstar-skill-authoring/references/skillsbench-authoring.md +117 -0
  144. package/harness-skills/mstar-strategy/SKILL.md +130 -0
  145. package/harness-skills/pm/SKILL.md +40 -0
  146. package/package.json +92 -0
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Data hook for the workflow panel (spec §5): subscribes to the active
3
+ * session's conversation snapshot through the session standard kit
4
+ * (`useSession`, a uSES selector hook) and scans the log for the latest
5
+ * `mstar-engine-status` catalog row.
6
+ *
7
+ * Node discriminator (spec §2.4): `kind === 'context'` + `form === 'catalog'`
8
+ * + `source.kind === 'mstar-engine-status'`; the LATEST row wins (snapshot
9
+ * order tail). Refresh = snapshot subscription: a digest/TTL re-emission on
10
+ * the server only produces a new log line, whose snapshot bump re-runs this
11
+ * selection — no manual reload, no polling.
12
+ *
13
+ * Contract: `{ source: MstarEngineStatusSource | null; lastUpdated: number |
14
+ * null }` — `source` null while no catalog row is logged yet (waiting empty
15
+ * state); `lastUpdated` carries the catalog message node `time` (Unix ms) for
16
+ * the freshness marker. The hook never throws: a snapshot the selector cannot
17
+ * read, or an absent session face, degrades to the explicit empty signal
18
+ * instead of bubbling a crash (spec §5 degradation path; the strict-session
19
+ * slot normally guarantees a session — the guard is belt-and-suspenders).
20
+ */
21
+ import type { ConversationSnapshot } from '@deepseek-ai/dsh-client-runtime/client';
22
+ import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
23
+ import type { MstarEngineStatusSource } from '../../types.ts';
24
+ /** The hook result: the latest catalog row plus its message time (spec §5). */
25
+ export interface MstarEngineStatusView {
26
+ source: MstarEngineStatusSource | null;
27
+ /** Unix ms of the catalog message node; null while no row is present. */
28
+ lastUpdated: number | null;
29
+ }
30
+ /**
31
+ * `useMstarEngineStatus(useSession): MstarEngineStatusView` — the panel's data
32
+ * hook (spec §5). The session standard kit's `useSession` is passed in (the
33
+ * view ring hands it to every `conversation.view` entry); the hook rides it as
34
+ * a selector over the conversation snapshot, so a snapshot bump (new catalog
35
+ * row) re-runs the selection and refreshes the panel.
36
+ *
37
+ * The hook never throws (spec §5 degradation path; Task 3 contract): a
38
+ * throwing session face or an absent one degrades to the explicit empty
39
+ * signal instead of bubbling a crash — the strict-session slot normally
40
+ * guarantees a session, the guard is belt-and-suspenders.
41
+ */
42
+ export declare function useMstarEngineStatus(useSession: SnapshotSelectorHook<ConversationSnapshot>): MstarEngineStatusView;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Legend (spec panel-tabs §4/§6.2, plan 20260811-panel-agent-canvas Task 3):
3
+ * mounted on the AgentCanvasPage (the zone-dashboard footer legend is gone
4
+ * with the WorkflowCanvas — spec §6.1). Describes ONLY the role-card status
5
+ * treatments of the agent canvas — plan
6
+ * 20260813-panel-agent-canvas-legend-layout Task 1 (图例精简): the 7
7
+ * collaboration-edge / layout entries (flow-actual / port / group /
8
+ * sub-bucket / supervise / on-demand / unknown) are REMOVED — the legend is
9
+ * the 3 entity card treatments (running glow, settled = the standalone GREEN
10
+ * done frame + ✓ — never on off-tier roles — idle dashed-muted). Pure render
11
+ * of the `t` seat; every label is a `zone.legend.*` locale key.
12
+ */
13
+ import * as React from 'react';
14
+ import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
15
+ export interface LegendProps {
16
+ t: TranslateNS<'mstar-panel'>;
17
+ }
18
+ export declare function Legend({ t }: LegendProps): React.JSX.Element;
@@ -0,0 +1,40 @@
1
+ /**
2
+ * TaskBoard (plan 20260810-panel-canvas-zones Task 4, spec panel-zones §3;
3
+ * plan 20260813-panel-quick-fixes Task 1) — the tasks-zone kanban: the 5
4
+ * PLAN_STATE_IDS columns (Todo / InProgress / InReview / Done /
5
+ * blocked-unknown, in the projection's constant order), each with a localized
6
+ * state-name header + count badge, plan cards (mono ellipsized id + status
7
+ * chip — the `data-plan-id` / `data-plan-status` anchors shared with the
8
+ * sidebar plan board), the dim inter-column flow arrows (spec §2.4:
9
+ * Todo→InProgress→InReview→Done plus the InProgress↔Blocked back-edge, now
10
+ * docking at the merged blocked-unknown column), the per-column 「更多」
11
+ * expand affordance, and the muted "no plans" empty state.
12
+ *
13
+ * The projection KEEPS every row (`column.plans` = the full column) and
14
+ * reports `column.capped` (PLAN_CAP) when a column overflows. This render
15
+ * shows the first PLAN_CAP rows by default and, for an overflowing column, a
16
+ * clickable 「更多」 button (`data-kanban-more`) that toggles an expanded
17
+ * state to reveal ALL rows (plus a 「收起」 to collapse back). PLAN_CAP is
18
+ * reused from `plan-sort.ts` (spec §3, reused not copied); only the Done
19
+ * column is sorted (the projection applies `sortPlans`), every other column
20
+ * keeps input order.
21
+ *
22
+ * Degradation (spec §8): state null / plans missing project to the same
23
+ * 5-column skeleton with count 0 — the board renders it with a muted
24
+ * "no plans" note (`data-zone-empty="no-plans"`), NEVER an orange warn box.
25
+ */
26
+ import * as React from 'react';
27
+ import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
28
+ import type { KanbanColumnView, ZoneView } from '../graph/project-graph.ts';
29
+ export interface TaskBoardProps {
30
+ view: ZoneView['tasks'];
31
+ t: TranslateNS<'mstar-panel'>;
32
+ }
33
+ /** Toggle a column id in the expanded set (pure — the click path is unit-tested). */
34
+ export declare function toggleKanbanExpanded(expanded: ReadonlySet<string>, id: string): ReadonlySet<string>;
35
+ /** The rows a column shows: PLAN_CAP by default, ALL when expanded. */
36
+ export declare function visibleKanbanPlans(column: KanbanColumnView, expanded: boolean): {
37
+ id: string;
38
+ status: string;
39
+ }[];
40
+ export declare function TaskBoard({ view, t }: TaskBoardProps): React.JSX.Element;
@@ -0,0 +1 @@
1
+ export * from './client/index.js'