@mstar-harness/dsh 3.5.1 → 3.6.0-alpha.1

package/dist/index.js

@@ -4036,6 +4036,13 @@ function formatViolation(violation14) {
 function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
 }
+var CATALOG_STATE_JOIN_LIMIT = 8;
+function joinCapped(items, cap, separator, render) {
+  const visible = items.slice(0, cap).map(render);
+  if (items.length > cap)
+    visible.push(`+${items.length - cap} more`);
+  return visible.join(separator);
+}
 function resolveSeamHard(harnessDir, config) {
   if (config.enforcement === "hard")
     return true;
@@ -5491,7 +5498,7 @@ function renderEngineStatusCatalog(source) {
       if (state.selection.kind === "active" && state.selection.warning !== undefined) {
         lines.push(`workflow warning: ${state.selection.warning.code} ${state.selection.warning.message}`);
       }
-      lines.push(`plans: ${state.plans.length === 0 ? "none registered" : state.plans.map((p) => `${p.id}(${p.status})`).join(" ")}`);
+      lines.push(`plans: ${state.plans.length === 0 ? "none registered" : joinCapped(state.plans, CATALOG_STATE_JOIN_LIMIT, " ", (p) => `${p.id}(${p.status})`)}`);
       lines.push(`residuals: ${state.residuals.length === 0 ? "none open" : state.residuals.map((r) => `${r.severity} ${r.count}`).join(", ")}`);
       if (state.iterationBaseBranch !== null && state.targetBranch !== null) {
         const integration = state.specIntegrationBranch !== null ? ` (spec integration: ${state.specIntegrationBranch})` : "";
@@ -5504,7 +5511,7 @@ function renderEngineStatusCatalog(source) {
       ].filter((part) => part !== null).join("; ");
       if (policy !== "")
         lines.push(`policy: ${policy}`);
-      lines.push(`leases: ${state.leases.length === 0 ? "none active" : state.leases.map((l) => `${l.planId} → ${l.holder}${l.worktreePath !== null ? ` (${l.worktreePath})` : ""}`).join("; ")}`);
+      lines.push(`leases: ${state.leases.length === 0 ? "none active" : joinCapped(state.leases, CATALOG_STATE_JOIN_LIMIT, "; ", (l) => `${l.planId} → ${l.holder}${l.worktreePath !== null ? ` (${l.worktreePath})` : ""}`)}`);
       if (state.knowledge !== null) {
         lines.push(`knowledge: ${state.knowledge.docCount} doc${state.knowledge.docCount === 1 ? "" : "s"} (${state.knowledge.categories.join(", ")})`);
       }
@@ -7206,112 +7213,111 @@ function unquote(value) {
   return value.length >= 2 && value.startsWith('"') && value.endsWith('"') ? value.slice(1, -1) : value;
 }
 
-// src/gates/fallbacks-probe.ts
-var FALLBACKS_ENTRY_NAME = "dsh-llm-fallbacks";
-function fallbacksService(ctx) {
-  return ctx.get("llm-fallbacks");
-}
-function fallbacksEntry(ctx) {
-  const loader = ctx.get("loader");
-  if (loader === undefined)
-    return;
-  for (const entry of loader.entries()) {
-    if (entry.options.name !== FALLBACKS_ENTRY_NAME)
-      continue;
-    if (entry.options.group)
-      continue;
-    if (entry.disabled)
-      continue;
-    return entry;
-  }
-  return;
-}
-function fallbacksMounted(ctx) {
-  if (fallbacksService(ctx) !== undefined)
-    return true;
-  const entry = fallbacksEntry(ctx);
-  if (entry === undefined)
-    return false;
-  return entry.fiber !== undefined;
-}
-
-// src/gates/fallbacks-decoration.ts
-var DECORATION_LOGGER = "mstar/subagent-decoration";
-var PERSONA_SECTION_NAME = "mstar:role-persona";
-var PERSONA_SECTION_ORDER = 1;
-var decorationLogSink = () => {};
-function setDecorationLogger(sink) {
-  const prior = decorationLogSink;
-  decorationLogSink = sink;
+// src/gates/role-persona.ts
+var ROLE_PERSONA_LOGGER = "mstar/role-persona";
+var SUBAGENTS_SERVICE = "subagents";
+var rolePersonaLogSink = () => {};
+function setRolePersonaLogger(sink) {
+  const prior = rolePersonaLogSink;
+  rolePersonaLogSink = sink;
   return prior;
 }
-var decorationAgentsDir;
+var rolePersonaAgentsDir;
 var mirrorAbsentDebugged = false;
-function setDecorationAgentsDir(dir) {
-  const prior = decorationAgentsDir;
-  decorationAgentsDir = dir;
+function setRolePersonaAgentsDir(dir) {
+  const prior = rolePersonaAgentsDir;
+  rolePersonaAgentsDir = dir;
   mirrorAbsentDebugged = false;
   return prior;
 }
-function seededTaskPrompt(child) {
-  for (const event of child.session.events) {
-    if (event.type !== "user/message")
-      continue;
-    const text = event.data.content.filter((block) => block.type === "text").map((block) => block.text).join(`
-`);
-    if (text.trim().length > 0)
-      return text;
-  }
-  return;
+var wrapperCache = new WeakMap;
+function registerRolePersonaChannel(ctx, config) {
+  const rolePersonas = config.rolePersonas;
+  ctx.on("internal/get", (_readCtx, name, _error, next) => {
+    const value = next();
+    if (name !== SUBAGENTS_SERVICE)
+      return value;
+    try {
+      return wrapSubagentsService(value, rolePersonas);
+    } catch (error) {
+      log2("warn", `role persona channel degraded to pass-through (subagent starts unaffected): ${errorMessage2(error)}`);
+      return value;
+    }
+  });
 }
-function decorateSubagentStart(ctx, config, info) {
-  try {
-    const personas = config.rolePersonas;
-    const agentsDir = decorationAgentsDir;
-    if ((personas == null || Object.keys(personas).length === 0) && agentsDir === undefined)
-      return;
-    const agents = ctx.get("agents");
-    if (agents === undefined) {
-      log2("debug", "agents service absent — mstar:role-persona decoration skipped (composition without dsh-agent)");
-      return;
+function wrapSubagentsService(value, rolePersonas) {
+  if (typeof value !== "object" || value === null)
+    return value;
+  const service = value;
+  if (typeof service.start !== "function" || typeof service.getProvider !== "function")
+    return value;
+  const cached = wrapperCache.get(value);
+  if (cached !== undefined && cached.rolePersonas === rolePersonas)
+    return cached.wrapper;
+  const wrapper = Object.create(value);
+  wrapper.start = (name, request) => {
+    let merged = request;
+    try {
+      merged = withRolePersona(service, name, request, rolePersonas, "one-shot");
+    } catch (error) {
+      log2("warn", `role persona merge degraded to pass-through (subagent start unaffected): ${errorMessage2(error)}`);
     }
-    const child = agents.get(info.id);
-    if (child === undefined)
-      return;
-    const taskPrompt = seededTaskPrompt(child);
-    if (taskPrompt === undefined)
-      return;
-    const executeAs = parseAssignmentFields(assignmentHeaderRegion(taskPrompt)).executeAs;
-    if (executeAs === undefined)
-      return;
-    const persona = personaFor(executeAs, { rolePersonas: config.rolePersonas, agentsDir }, (message) => log2("warn", message));
-    if (persona === undefined) {
-      if (agentsDir === undefined && !mirrorAbsentDebugged) {
-        mirrorAbsentDebugged = true;
-        log2("debug", "harness-agents mirror absent — mstar:role-persona skipped (config-only lookups; mirror defaults unavailable)");
+    return service.start(name, merged);
+  };
+  if (typeof service.startContinuable === "function") {
+    wrapper.startContinuable = (spec) => {
+      let merged = spec;
+      try {
+        const mergedRequest = withRolePersona(service, spec.provider, spec.request, rolePersonas, "continuable");
+        if (mergedRequest !== spec.request)
+          merged = { ...spec, request: mergedRequest };
+      } catch (error) {
+        log2("warn", `role persona merge degraded to pass-through (continuable subagent start unaffected): ${errorMessage2(error)}`);
       }
-      return;
-    }
-    child.ctx.systemPrompt.section({
-      name: PERSONA_SECTION_NAME,
-      order: PERSONA_SECTION_ORDER,
-      text: persona.text
-    });
-    if (fallbacksMounted(ctx)) {
-      log2("info", `dsh-llm-fallbacks mounted (v${fallbacksService(ctx)?.version ?? "unknown"}) — mstar:role-persona injected for role '${executeAs}'`);
-    } else {
-      log2("debug", `dsh-llm-fallbacks unmounted — mstar:role-persona injected from ${persona.source === "config" ? "mstar Config" : "harness-agents default"} for role '${executeAs}' (decoration channel unchanged)`);
-    }
-  } catch (error) {
-    log2("warn", `mstar:role-persona decoration aborted (degraded — subagent dispatch unaffected): ${errorMessage2(error)}`);
+      return service.startContinuable(merged);
+    };
   }
+  wrapperCache.set(value, { rolePersonas, wrapper });
+  return wrapper;
+}
+function withRolePersona(service, providerName, request, rolePersonas, surface) {
+  if (request.persona !== undefined)
+    return request;
+  const personas = rolePersonas;
+  const agentsDir = rolePersonaAgentsDir;
+  if ((personas == null || Object.keys(personas).length === 0) && agentsDir === undefined)
+    return request;
+  const taskPrompt = (request.prompt ?? []).filter((block) => block.type === "text").map((block) => block.text ?? "").join(`
+`);
+  if (taskPrompt.trim().length === 0)
+    return request;
+  const executeAs = parseAssignmentFields(assignmentHeaderRegion(taskPrompt)).executeAs;
+  if (executeAs === undefined)
+    return request;
+  const persona = personaFor(executeAs, { rolePersonas: personas, agentsDir }, (message) => log2("warn", message));
+  if (persona === undefined) {
+    if (agentsDir === undefined && !mirrorAbsentDebugged) {
+      mirrorAbsentDebugged = true;
+      log2("debug", "harness-agents mirror absent — role persona skipped (config-only lookups; mirror defaults unavailable)");
+    }
+    return request;
+  }
+  const provider = service.getProvider(providerName);
+  if (provider === undefined)
+    return request;
+  if (surface === "one-shot" ? provider.capabilities?.persona !== true : typeof provider.prepareContinuable !== "function") {
+    log2("debug", surface === "one-shot" ? `subagent provider '${providerName}' lacks the persona capability — role persona for '${executeAs}' skipped (start proceeds unchanged)` : `subagent provider '${providerName}' does not support continuable children — role persona for '${executeAs}' skipped (the native continuable start fails loud its own way)`);
+    return request;
+  }
+  log2("debug", `role persona delivered via the native subagent persona channel for role '${executeAs}' (${surface} start, source: ${persona.source === "config" ? "mstar Config" : "harness-agents default"})`);
+  return { ...request, persona: persona.text };
 }
 function errorMessage2(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function log2(level, message) {
   try {
-    decorationLogSink(level, message);
+    rolePersonaLogSink(level, message);
   } catch {}
 }
 
@@ -7992,6 +7998,35 @@ ${mstarLoadLine(roleId)}` });
   return { declared, skipped, preserved, outcome };
 }
 
+// src/gates/fallbacks-probe.ts
+var FALLBACKS_ENTRY_NAME = "dsh-llm-fallbacks";
+function fallbacksService(ctx) {
+  return ctx.get("llm-fallbacks");
+}
+function fallbacksEntry(ctx) {
+  const loader = ctx.get("loader");
+  if (loader === undefined)
+    return;
+  for (const entry of loader.entries()) {
+    if (entry.options.name !== FALLBACKS_ENTRY_NAME)
+      continue;
+    if (entry.options.group)
+      continue;
+    if (entry.disabled)
+      continue;
+    return entry;
+  }
+  return;
+}
+function fallbacksMounted(ctx) {
+  if (fallbacksService(ctx) !== undefined)
+    return true;
+  const entry = fallbacksEntry(ctx);
+  if (entry === undefined)
+    return false;
+  return entry.fiber !== undefined;
+}
+
 // src/gates/fallbacks-advisory.ts
 var ADVISORY_LOGGER = "mstar/fallbacks-advisory";
 var advisoryLogSink = () => {};
@@ -8276,12 +8311,6 @@ function engineStatusProvider(ctx, resolver, bootHarnessDir) {
   };
 }
 var DIGEST_PLAN_CAP = 8;
-function joinCapped(items, cap, separator, render) {
-  const visible = items.slice(0, cap).map(render);
-  if (items.length > cap)
-    visible.push(`+${items.length - cap} more`);
-  return visible.join(separator);
-}
 function engineStatusSummary(source) {
   const lines = [`mstar engine status: v${source.version}`];
   const state = source.state;
@@ -8404,16 +8433,14 @@ function apply(ctx, config) {
     else
       logger.info(message);
   });
-  setDecorationLogger((level, message) => {
-    const logger = ctx.logger(DECORATION_LOGGER);
+  setRolePersonaLogger((level, message) => {
+    const logger = ctx.logger(ROLE_PERSONA_LOGGER);
     if (level === "debug")
       logger.debug(message);
-    else if (level === "info")
-      logger.info(message);
     else
       logger.warn(message);
   });
-  setDecorationAgentsDir(packagedAgentsDir());
+  setRolePersonaAgentsDir(packagedAgentsDir());
   setHarnessPromptLogger((level, message) => {
     const logger = ctx.logger(HARNESS_PROMPT_LOGGER);
     if (level === "debug")
@@ -8526,9 +8553,9 @@ function apply(ctx, config) {
     ctx.on("fs/write-intent", (target, actor, next) => seamWriteIntentListener(ctx, resolver, config, seam, target, actor, next), { prepend: true });
   }
   ctx.on("tools/pre-execute", (exec, next) => preExecuteListener(ctx, resolver, config, adapter, exec, next), { prepend: true });
-  ctx.events.on("subagent/start", (info) => {
+  registerRolePersonaChannel(ctx, config);
+  ctx.events.on("subagent/start", () => {
     runAdvisoryPass();
-    decorateSubagentStart(ctx, config, info);
   });
   const ttlMs = config.catalogTtlMs ?? DEFAULT_CATALOG_TTL_MS;
   const explicitKey = bootHarnessDir !== null ? EXPLICIT_CACHE_KEY : undefined;
@@ -8547,10 +8574,11 @@ function apply(ctx, config) {
 }
 export {
   skillLocalConfig,
-  setDecorationLogger,
-  setDecorationAgentsDir,
+  setRolePersonaLogger,
+  setRolePersonaAgentsDir,
   setAdvisoryLogger,
   runFallbacksAdvisory,
+  registerRolePersonaChannel,
   recordWorkflowVerdict,
   recordSettle,
   recordDispatch,
@@ -8564,17 +8592,14 @@ export {
   lintCompoundWrite,
   lintAuditWrite,
   inject,
-  decorateSubagentStart,
   apply,
   SkillLintVetoError,
   SeamVetoError,
   SETTLE_SEAM,
-  PERSONA_SECTION_ORDER,
-  PERSONA_SECTION_NAME,
+  ROLE_PERSONA_LOGGER,
   HarnessResolver,
   DshMstar,
   DshHostAdapter,
-  DECORATION_LOGGER,
   Config,
   AGENT_FLOW_MAX_EVENTS,
   AGENT_FLOW_FILE,

package/harness-skills/mstar-artifacts/references/status-and-residuals.md

@@ -43,29 +43,33 @@ Canonical vs legacy residual definitions → **`mstar-artifacts` SKILL.md**（"`
 ```json
 {
   "schema_version": 1,
-  "id": "<plan-id-or-iteration-id>",
-  "type": "plan | iteration",
-  "status": "running | paused | completed | failed | stopped",
-  "started_at": "YYYY-MM-DD",
-  "ended_at": null,
-  "updated_at": "YYYY-MM-DD",
+  "id": "iter-demo",
+  "type": "iteration",
+  "status": "running",
+  "started_at": "2026-08-30",
+  "updated_at": "2026-08-30",
   "phase": "phase-2-execute",
   "plans": [
     {
       "id": "plan-id",
       "title": "Plan title",
       "file": "{PLAN_DIR}/plan-id-feature-name.md",
-      "status": "Todo | InProgress | InReview | Blocked | Done",
+      "status": "InProgress",
       "owner": "@project-manager",
       "agents": ["@fullstack-dev"],
       "progress": 0,
       "tags": [],
-      "created_at": "YYYY-MM-DD",
-      "updated_at": "YYYY-MM-DD",
+      "created_at": "2026-08-29",
+      "updated_at": "2026-08-30",
       "done_at": null,
       "notes": [],
       "metadata": {},
-      "execution_lease": {}
+      "execution_lease": {
+        "holder": "omp:demo-session",
+        "claimed_at": "2026-08-30T02:30:00Z",
+        "worktree_path": "/tmp/worktrees/demo-plan",
+        "working_branch": "feature/demo-plan"
+      }
     }
   ],
   "execution_policy": {
@@ -73,14 +77,22 @@ Canonical vs legacy residual definitions → **`mstar-artifacts` SKILL.md**（"`
     "worktree_mode": "",
     "push_policy": ""
   },
-  "integration_merge_lease": {},
-  "branch": { "base": "", "integration": "", "target": "" },
+  "integration_merge_lease": {
+    "holder": "omp:demo-session",
+    "claimed_at": "2026-08-30T03:00:00Z",
+    "plan_id": "plan-id",
+    "source_branch": "feature/demo-plan",
+    "target_branch": "iteration/iter-demo"
+  },
+  "branch": { "base": "main", "integration": "iteration/iter-demo", "target": "main" },
   "control_worktree_path": "/abs/repo/root",
   "legacy_metadata": {},
-  "compass_ref": "iterations/<iteration-id>/delivery-compass.md"
+  "compass_ref": "iterations/iter-demo/delivery-compass.md"
 }
 ```
 
+- The example above depicts the **held** state (both leases populated, illustrative placeholder values) and passes `validateWorkflowSnapshot`; the released state is **key absence** (delete-key-on-release below), never `null` or `{}`, and enum scalars (`type` / `status` / plan-row `status`) are always single values — the full enum sets are `type`: `plan | iteration`, snapshot `status`: `running | paused | completed | failed | stopped`, plan-row `status`: `Todo | InProgress | InReview | Blocked | Done`.
+
 - `plans[]` rows are the **legacy PlanRow shape verbatim** (unknown row fields preserved, never re-bucketed). Per-row `execution_lease` stays on the row; `integration_merge_lease` is **top-level** (the v1 root-`metadata` home is gone).
 - Terminal statuses (`completed` / `failed` / `stopped`) require `ended_at` and no dangling leases.
 - `execution_policy` keys are copied from v1 root `metadata` at migrate; values are accepted-but-opaque this iteration (no semantic gate).

package/harness-skills/mstar-coding-behavior/SKILL.md

@@ -31,6 +31,8 @@ The failure mode: "correct" code that is alien to the codebase — works but loo
 
 ## 2) Simplicity First
 
+**Upstream invariants**: the global engineering rules live in `mstar-harness-core`（核心研发守则）——no backward-compat layers, simplest implementation, layered growth, modularity, dependency discipline, long-term architecture; this section is their implementation-level playbook.
+
 Implement the smallest durable slice that satisfies the request and acceptance criteria.
 
 **The Ladder.** A reflex hierarchy for every decision — stop at the first rung that holds:

package/harness-skills/mstar-harness-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mstar-harness-core
-description: Morning Star (启明星) harness **强制全局入口** —— 信息源优先级、最小交付循环、状态机与 Done 权限、Task category 路由（含 quick 禁豁免）、@explore 边界、长任务纪律、护栏不变量、反模式索引、Morning Star Skill 索引与宿主入口。**任何**非平凡任务开始前必须先 Read 本 skill；再按角色与任务 **按需** Read 其它 `mstar-*` 专题（勿默认通读全部）。`@project-manager` 开轮必读 + `mstar-dispatch-gates` / `mstar-phase-gates` / `mstar-conventions` 等；实现/审查/QA 必读本 skill + `mstar-coding-behavior` 及角色清单（见 `mstar-roles`）。Prepare/派发/Git/residual/QC 细则在专题 skill，不在此重复。
+description: Morning Star (启明星) harness **强制全局入口** —— 信息源优先级、最小交付循环、状态机与 Done 权限、Task category 路由（含 quick 禁豁免）、@explore 边界、长任务纪律、核心研发守则、护栏不变量、反模式索引、Morning Star Skill 索引与宿主入口。**任何**非平凡任务开始前必须先 Read 本 skill；再按角色与任务 **按需** Read 其它 `mstar-*` 专题（勿默认通读全部）。`@project-manager` 开轮必读 + `mstar-dispatch-gates` / `mstar-phase-gates` / `mstar-conventions` 等；实现/审查/QA 必读本 skill + `mstar-coding-behavior` 及角色清单（见 `mstar-roles`）。Prepare/派发/Git/residual/QC 细则在专题 skill，不在此重复。
 ---
 
 # Morning Star Harness Core（启明星核心）
@@ -121,6 +121,18 @@ Read **`mstar-host`** after this skill; detect host per its table, then Read the
 | Kimi | `Agent`/`AgentSwarm`（仅 `coder`/`explore`/`plan`）；角色绑定在 prompt（C5b）；Plan 双写 → `references/kimi.md` · `kimi-plan-mode-bridge.md` |
 | 其它 | 同 `mstar-host` skill；按工具信号选 reference |
 
+## 核心研发守则
+
+全局工程不变量，适用于所有角色；实现级操作细节（The Ladder、surgical、debugging 等）→ **`mstar-coding-behavior`**。
+
+- Do not preserve backward compatibility. Remove obsolete paths instead of adding compatibility layers, fallbacks, or migrations.
+- Choose the simplest implementation that fully meets the current requirements. Avoid speculative abstractions, configuration, and indirection.
+- Grow the system in layers. Start from the smallest version that works end to end, and add each new capability on top of a product that already works. Never trade a working product for unfinished complexity.
+- Keep components modular and concerns clearly separated.
+- Prefer established, well-maintained libraries when they reduce overall complexity or improve reliability. Do not reimplement common functionality without a clear reason.
+- Lean on the dependencies already in the project before writing your own implementation or adding packages. Do not assume a library lacks a capability without checking its documentation and types.
+- Make architectural decisions for the long term. Do not accept a stopgap that only works for now and is meant to be replaced later.
+
 ## 护栏（不变量）
 
 - 未经用户同意不改宿主配置文件与用户凭据。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/dsh",
-  "version": "3.5.1",
+  "version": "3.6.0-alpha.1",
   "description": "Morning Star harness dsh (DeepSeek Harness) cordis function plugin — in-process engine gates (status/dispatch/lease) with hard refusal channels.",
   "keywords": [
     "dsh",
@@ -44,7 +44,7 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-store",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-locale"
       ],
@@ -56,31 +56,30 @@
     "test": "bun test",
     "typecheck:tests": "bunx tsc --noEmit -p tests/tsconfig.json",
     "bundle-assets": "bun run scripts/bundle-harness-assets.ts",
-    "build": "bun run bundle-assets && rm -rf dist && bun build src/index.ts src/invariant.ts --target node --outdir dist --external @deepseek-ai/cordis --external @deepseek-ai/dsh-skill-filesystem --external @deepseek-ai/dsh-tools --external @deepseek-ai/dsh-llm --external dsh-llm-fallbacks && bun run build-client && bunx tsc",
+    "build": "bun run bundle-assets && rm -rf dist && bun build src/index.ts src/invariant.ts --target node --outdir dist --external @deepseek-ai/cordis --external @deepseek-ai/dsh-skill-filesystem --external @deepseek-ai/dsh-tools --external @deepseek-ai/dsh-llm && bun run build-client && bunx tsc",
     "build-client": "bun run scripts/build-client-bundle.ts",
     "prepublishOnly": "bun run build"
   },
   "engines": {
     "bun": ">=1.2.17"
   },
-  "dependencies": {
-    "dsh-llm-fallbacks": "^0.3.0"
-  },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-skill-filesystem": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-fs": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-jobs": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-skill": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-skill-filesystem": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2"
   },
   "publishConfig": {
     "access": "public"
@@ -91,6 +90,7 @@
     "@types/react": "~18.3.1",
     "js-yaml": "^4.1.0",
     "bun-types": "^1.2.17",
+    "dsh-llm-fallbacks": "^0.4.0-alpha.1",
     "schemastery": "^3.18.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",

package/dist/gates/fallbacks-decoration.d.ts

@@ -1,108 +0,0 @@
-/**
- * Role-based subagent decoration at the `subagent/start` seam (plan
- * `20260814-dsh-fallbacks-integration` Task 2).
- *
- * Decoration rides the `subagent/start` EMIT — NOT `tools/pre-execute`:
- * tool args are deep-frozen snapshots and persona/`agentOptions` come from
- * the tool-subagent's own Config, never call args. The listener is
- * SYNCHRONOUS (the section must register before the child's first LLM call)
- * and resolves the published child via `ctx.get('agents')?.get(info.id)` —
- * documented in the `@deepseek-ai/dsh-subagent` event contract ("For
- * in-process providers, `ctx.agents.get(info.id)` resolves during this
- * notification"). The registered section is agent-scoped on `Agent.ctx`
- * (contributions are agent-local and unwind on disposal — the
- * hooks-claude-code precedent).
- *
- * Role identity uses the engine Assignment header grammar — the SAME
- * parsers the dispatch gate uses (`assignmentHeaderRegion` +
- * `parseAssignmentFields`) — over the child's seeded task prompt (the
- * child session's first `user/message`). Persona lookup (plan
- * `20260815-dsh-fallbacks-personas` Task 3) is the single
- * {@link personaFor} surface — `Config.rolePersonas[executeAs]` →
- * `harness-agents/` mirror default → skip (never gated on `roleMap` or on
- * the fallbacks mounted state: unmounted fallbacks degrades to the same
- * injection with exactly one debug log; probe at the decision point, no
- * cache). `roleMap` is a taxonomy bridge for logging + future rule-driven
- * interop only. The mirror root is bound at apply (`setDecorationAgentsDir`
- * ← `packagedAgentsDir()`), package-relative so the shipped bundle works
- * from any launch cwd.
- *
- * Degradation (the listener never throws — contained like the dispatch
- * gate's degrade path): `agents` service absent → skip + one debug log
- * (documented Known Limitation for compositions without dsh-agent);
- * child unresolved / non-Assignment / role-unmatched → silent no-op
- * (role-unmatched with the mirror present and no eligible shell stays
- * silent; with NO mirror the config-miss path logs ONE debug per apply —
- * case (e) semantics). A throwing log sink is contained inside the log
- * helper itself (plan QC F-002) — the sink must not escape the listener
- * either.
- *
- * Persona text is rendered by dsh system-prompt's STRICT `{{...}}`
- * interpolation, so persona values MUST NOT contain `{{` paired with a
- * later `}}` — the Config schema rejects such values at plugin mount (see
- * `_shared.ts` `rolePersonas` / `PERSONA_INTERPOLATION_HAZARD`); a mirror
- * default carrying the hazard is warned + skipped at extraction (never a
- * boot throw).
- *
- * Module boundary: no barrel — the entry imports this module by explicit
- * relative path and re-exports the public names verbatim.
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { Config } from './_shared.ts';
-/** Logger label for the subagent decoration (dsh logger naming: `<scope>/<subject>`). */
-export declare const DECORATION_LOGGER = "mstar/subagent-decoration";
-/** The decoration's system-prompt section name (agent-scoped on `Agent.ctx`). */
-export declare const PERSONA_SECTION_NAME = "mstar:role-persona";
-/** Prompt order of the persona section — renders right after the deployment persona slot (order 0). */
-export declare const PERSONA_SECTION_ORDER = 1;
-/**
- * Structural view of the `subagent/start` emit payload the decoration
- * consumes (`@deepseek-ai/dsh-subagent` `SubagentRunInfo` — the plugin
- * carries no dsh-subagent dependency; same pattern as the probe's
- * `LoaderEntryView` and agent-flow's `TaskDoneSnapshot`). Only `id` is
- * consumed; the rest keeps the view faithful to the published contract.
- */
-export interface SubagentRunInfoView {
-    /** Unique identity shared with the paired terminal event. */
-    readonly runId: unknown;
-    /** Provider name recorded when the child was first created. */
-    readonly provider: string;
-    /** The child agent's id. */
-    readonly id: string;
-    /** Snapshot of whether the run's local agent was present when start fulfilled. */
-    readonly local: boolean;
-}
-/** Decoration log levels the module sink understands. */
-export type DecorationLogLevel = 'debug' | 'info' | 'warn';
-/** Module-level decoration log sink — bound by `apply` to `ctx.logger(DECORATION_LOGGER)` (agent-flow ledger precedent). */
-export type DecorationLogSink = (level: DecorationLogLevel, message: string) => void;
-/**
- * Bind the decoration log sink (the entry `apply` binds it to
- * `ctx.logger(DECORATION_LOGGER)`). Returns the PRIOR sink so a caller can
- * restore it (test pattern: agent-flow `setAgentFlowLogger`).
- */
-export declare function setDecorationLogger(sink: DecorationLogSink): DecorationLogSink;
-/**
- * Bind the persona-defaults mirror root. Returns the PRIOR binding so a
- * caller can restore it (test pattern: {@link setDecorationLogger}).
- * @param dir - the mirror root, or `undefined` to disable mirror defaults.
- */
-export declare function setDecorationAgentsDir(dir: string | undefined): string | undefined;
-/**
- * Decorate one `subagent/start` emit: resolve the child, extract its seeded
- * task prompt, and — when the prompt is Assignment-shaped and
- * `rolePersonas[executeAs]` is configured — register the persona as the
- * child's `mstar:role-persona` system-prompt section (agent-scoped on
- * `Agent.ctx`, unwinds on child disposal). Synchronous by design: the
- * section must register before the child's first LLM call.
- *
- * Never throws — every failure mode degrades (skip + one log line at most),
- * matching the dispatch gate's contained degrade path; the dispatch itself
- * is never affected.
- *
- * @param ctx - the plugin's registrant context (the app composition root).
- * @param config - validated plugin configuration (`rolePersonas` is the only
- *   payload source; `roleMap` is never consulted for injection).
- * @param info - the `subagent/start` emit payload.
- */
-export declare function decorateSubagentStart(ctx: Context, config: Config, info: SubagentRunInfoView): void;