@lmzhen/dsh-evolution-core 0.30.28 → 0.30.30

package/README.md

@@ -60,9 +60,11 @@ session log made the session unresumable (A-line P0-1), which is why the payload
 | `evolution/skills-refresh` | emit (notification) | `evolution-commands` `/evolution` verbs |
 | `evolution/review-scheduled` | emit (notification) | `evolution-review` cadence paths |
 | `evolution/review-error` | emit (notification) | `evolution-review` failure paths |
-| `evolution/plan-applied` | emit (notification) | `evolution-review` after a plan lands |
+| `evolution/review-completed` | emit (notification) | `evolution-review` after a plugin branch settles |
 | `evolution/memory-applied` | emit (notification) | `memory` after a memory write |
 
+Legacy `evolution/plan-applied` remains declared so old activity ledgers stay readable, but the current production tree has no plan emitter after the review subagent/plan path was removed.
+
 The mode column is what the code does today: every one of them is an announcement, and each
 declaration carries it as a `@mode` tag (finding O-1, landed) — `verify-arch-guards`' rule **N33** checks that
 tag against THIS table and against the dispatch site (`ctx.emit('…'`), so a declaration that drifts from

package/lib/index.js

@@ -7987,8 +7987,18 @@ function renderLongRunTable() {
 * `client` probes run in the browser half, where the host has no view of the seats.
 * @module @lmzhen/dsh-evolution-core
 */
-/** The 26 probes, in service-name order (the guard checks this list against the tree). */
+/** The 28 probes, in service-name order (the guard checks this list against the tree). */
 const PLATFORM_SERVICE_PROBES = Object.freeze([
+	{
+		service: "agentDefaultModel",
+		feature: "the model route inherited by a plugin review branch",
+		side: "host"
+	},
+	{
+		service: "agentPresets",
+		feature: "the preset mount that gives a plugin review branch its tools/system",
+		side: "host"
+	},
 	{
 		service: "agents",
 		feature: "review and curator subagent wake-ups",
@@ -13967,13 +13977,13 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Run the review in the parent session (inject) or on a subagent.",
+		summary: "Run the review in the parent session (inject), on a subagent, or in a background branch.",
 		label: "运行位置",
-		hint: "在哪里运行检查：在当前会话里／交给子代理。",
+		hint: "在哪里运行检查：在当前会话里／交给子代理／后台分支。",
 		control: "select",
 		unit: "",
-		values: "subagent|inject",
-		valueLabels: "交给子代理|在当前会话里",
+		values: "inject|branch",
+		valueLabels: "在当前会话里|后台分支",
 		card: "evolution-review"
 	},
 	{

package/lib/types/events.d.ts

@@ -29,7 +29,47 @@ export interface EvolutionReviewScheduledEvent {
      * `'subagent'` (spawned review run), `'inject'` (prompt injected into the
      * parent — direct, fallback, or deferred-drain), `'completion'`
      * (completion-trigger prompt, direct or deferred-drain). */
-    channel?: 'subagent' | 'inject' | 'completion' | undefined;
+    channel?: 'subagent' | 'inject' | 'completion' | 'branch' | undefined;
+}
+/** One normalized skill/memory action performed by a review branch. */
+export interface EvolutionReviewAction {
+    readonly type: 'skill' | 'memory' | 'tool';
+    readonly action: string;
+    readonly target: string;
+    readonly status: 'ok' | 'error';
+    readonly revision?: string | undefined;
+    readonly summary?: string | undefined;
+}
+/** One durable review outcome emitted after a branch settles. */
+export interface EvolutionReviewCompletedEvent {
+    readonly version: 1;
+    readonly reviewId: string;
+    readonly sessionId: string;
+    readonly branchSessionId?: string | undefined;
+    readonly kind: ReviewKind;
+    readonly status: 'completed' | 'failed' | 'timeout' | 'aborted';
+    readonly trigger: {
+        readonly reason: string;
+        readonly toolCalls: number;
+        readonly userChars: number;
+        readonly assistantChars: number;
+    };
+    readonly finalText: string;
+    readonly actions: readonly EvolutionReviewAction[];
+    readonly usage?: {
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+        readonly cacheReadTokens: number;
+        readonly cacheWriteTokens: number;
+    } | undefined;
+    readonly startedAt: number;
+    readonly finishedAt: number;
+    readonly model?: {
+        readonly provider: string;
+        readonly model: string;
+    } | undefined;
+    readonly promptVersion?: string | undefined;
+    readonly error?: string | undefined;
 }
 export interface EvolutionPlanAppliedEvent {
     /** Owning session (payload v2): process events carry no session envelope. */
@@ -92,11 +132,17 @@ declare module '@deepseek-ai/cordis' {
          * @mode emit
          */
         'evolution/review-scheduled'(event: EvolutionReviewScheduledEvent): void;
+        /**
+         * One review branch settled with its durable result. An ANNOUNCEMENT: the
+         * activity ledger folds it into review history; it decides nothing.
+         * @param event - the review identity, status, summary, actions, and usage.
+         * @mode emit
+         */
+        'evolution/review-completed'(event: EvolutionReviewCompletedEvent): void;
         /**
          * A reviewed plan finished its write leg, with the counts that describe what landed. An
          * ANNOUNCEMENT: the family's own ledger of plan outcomes (A98 / O-1).
          * @param event - the outcome counts, the first failure message, and the policy fingerprint.
-         * @mode emit
          */
         'evolution/plan-applied'(event: EvolutionPlanAppliedEvent): void;
         /**

package/lib/types/params.js

@@ -105,7 +105,7 @@ export const PARAM_EXPOSURE = Object.freeze([
     { id: 'skillReviewTrigger', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Which channel may inject a skill review (cadence, completion, both).', label: '技能检查时机', hint: '什么时候检查技能：按间隔／按任务完成／两者。', control: 'select', unit: '', values: 'cadence|completion|both', valueLabels: '按间隔|按任务完成|两者', card: 'evolution-review' },
     { id: 'skillReviewCompletionMinToolCalls', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Tool calls a task needs before the completion channel injects.', label: '完成时的最少工具调用', hint: '选「按任务完成」时，任务至少用了几次工具才检查。', control: 'number', unit: '次', values: '', card: 'evolution-review' },
     { id: 'reviewEnabled', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Master switch for the review plugin.', label: '启用自动检查', hint: '关闭后不再自动回顾会话。', control: 'switch', unit: '', values: '', card: 'evolution-review' },
-    { id: 'reviewMode', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Run the review in the parent session (inject) or on a subagent.', label: '运行位置', hint: '在哪里运行检查：在当前会话里／交给子代理。', control: 'select', unit: '', values: 'subagent|inject', valueLabels: '交给子代理|在当前会话里', card: 'evolution-review' },
+    { id: 'reviewMode', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Run the review in the parent session (inject), on a subagent, or in a background branch.', label: '运行位置', hint: '在哪里运行检查：在当前会话里／交给子代理／后台分支。', control: 'select', unit: '', values: 'inject|branch', valueLabels: '在当前会话里|后台分支', card: 'evolution-review' },
     { id: 'reviewWakeInject', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Deliver the deferred review as a waking follow-up message.', label: '延后结果发提醒', hint: '会话空闲时，把延后的检查结果作为一条提醒发给你。', control: 'switch', unit: '', values: '', card: 'evolution-review' },
     { id: 'reviewNotice', group: 'review', tier: 'E3', authority: 'cordis', owner: 'evolution-review', applies: 'live', docAnchor: 'PARAMETERS.md#review', summary: 'Deliver result notices into the parent conversation.', label: '结果通知', hint: '关闭后检查结果不再写进对话；检查本身照常运行，结果留在审计记录里。', control: 'switch', unit: '', values: '', card: 'evolution-review' },
     { id: 'reviewProvider', group: 'review', tier: 'E2', authority: 'cordis', owner: 'evolution-review', applies: 'none', docAnchor: 'PARAMETERS.md#review', summary: 'LLM provider for review subagents (deployment identity).', why: 'identity' },

package/lib/types/platform-services.d.ts

@@ -20,7 +20,7 @@ export interface PlatformServiceProbe {
     /** Where the probe runs. */
     readonly side: 'host' | 'client';
 }
-/** The 26 probes, in service-name order (the guard checks this list against the tree). */
+/** The 28 probes, in service-name order (the guard checks this list against the tree). */
 export declare const PLATFORM_SERVICE_PROBES: readonly PlatformServiceProbe[];
 /**
  * The HOST-side probes that do not resolve in this runtime — what `/evolution doctor` prints as

package/lib/types/platform-services.js

@@ -11,8 +11,10 @@
  * `client` probes run in the browser half, where the host has no view of the seats.
  * @module @lmzhen/dsh-evolution-core
  */
-/** The 26 probes, in service-name order (the guard checks this list against the tree). */
+/** The 28 probes, in service-name order (the guard checks this list against the tree). */
 export const PLATFORM_SERVICE_PROBES = Object.freeze([
+    { service: 'agentDefaultModel', feature: 'the model route inherited by a plugin review branch', side: 'host' },
+    { service: 'agentPresets', feature: 'the preset mount that gives a plugin review branch its tools/system', side: 'host' },
     { service: 'agents', feature: 'review and curator subagent wake-ups', side: 'host' },
     { service: 'approval', feature: 'the platform approval policy the approval row shadows', side: 'host' },
     { service: 'configEditor', feature: 'the params view inherited-vs-override column', side: 'host' },

package/lib/types/unit-transaction.d.ts

@@ -214,7 +214,7 @@ export declare class UnitTransactions implements UnitTransaction {
         phase: "target-pending" | "target-written" | "source-archiving" | "sources-archived";
     } | {
         ok: boolean;
-        phase: "prepared" | "support-pending" | "unit-written" | "committed" | "failed" | "rolled-back";
+        phase: "failed" | "prepared" | "support-pending" | "unit-written" | "committed" | "rolled-back";
     }>;
 }
 //# sourceMappingURL=unit-transaction.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-core",
   "description": "Shared stores, prompts, signals and lifecycle logic for the dsh-evolution plugin family (community build)",
-  "version": "0.30.28",
+  "version": "0.30.30",
   "publishConfig": {
     "access": "public"
   },