dsh-auto-review 0.4.0

package/lib/types/invariant.js

@@ -0,0 +1,306 @@
+/**
+ * Package-owned invariant companion for `dsh-auto-review`:
+ *
+ * 1. Every `autoReview/verdict` audit event references an `approval/asked`
+ *    event that precedes it in the same session, at most one verdict exists
+ *    per asked event, and payload fields obey the closed vocabularies
+ *    (decision/reason/riskLevel/outcome/fallback). The same chain holds for
+ *    `autoReview/rejection` events (hard-disable rejections).
+ * 2. Model-visible ⟺ logged: every `tool/result` carrying the deny marker
+ *    links to a recorded `deny` verdict with a matching call id, every
+ *    `tool/result` carrying the fallback marker links to a recorded fallback
+ *    verdict that was rejected, and every `tool/result` carrying the never
+ *    marker links to a recorded rejection that settled rejected.
+ *
+ * @module dsh-auto-review/invariant
+ */
+import { AUTO_REVIEW_FALLBACKS, CIRCUIT_MARKER_PATTERN, DENY_MARKER_PATTERN, FALLBACK_MARKER_PATTERN, NEVER_MARKER_PATTERN } from "./events.js";
+const PACKAGE_NAME = 'dsh-auto-review';
+/** Cordis companion plugin name. */
+export const name = 'auto-review-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+const DECISIONS = ['allow', 'deny'];
+const RISK_LEVELS = ['low', 'medium', 'high'];
+const OUTCOMES = ['allowed-once', 'rejected', 'cancelled', 'unavailable'];
+const TRIP_KINDS = ['consecutive', 'window'];
+const CIRCUIT_ACTIONS = ['delegate', 'reject', 'abort-turn'];
+/* jscpd:ignore-start -- package companions share replay and dispatch plumbing */
+/** Install verdict-chain and deny-marker validation over loaded logs and newly appended events. */
+const install = Object.assign((ctx, fail) => {
+    // Install-scoped so a dispose/re-register cycle re-sweeps from a clean slate.
+    const askedIds = new WeakMap();
+    const verdicts = new WeakMap();
+    const verdictByApproval = new WeakMap();
+    const circuits = new WeakMap();
+    const rejections = new WeakMap();
+    const validateEvent = (session, event) => {
+        if (event.type === 'approval/asked') {
+            let ids = askedIds.get(session);
+            if (ids === undefined) {
+                ids = new Map();
+                askedIds.set(session, ids);
+            }
+            ids.set(event.data.id, (ids.get(event.data.id) ?? 0) + 1);
+            return;
+        }
+        if (event.type === 'autoReview/verdict') {
+            const data = event.data;
+            const fallback = data.fallback;
+            if (fallback === undefined) {
+                if (data.decision === undefined || !DECISIONS.includes(data.decision)) {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has invalid decision ${JSON.stringify(data.decision)}`);
+                }
+                if (typeof data.reason !== 'string' || data.reason.length === 0) {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has no reviewer reason`);
+                }
+                if (data.riskLevel !== undefined && !RISK_LEVELS.includes(data.riskLevel)) {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has invalid riskLevel ${JSON.stringify(data.riskLevel)}`);
+                }
+            }
+            else {
+                if (!AUTO_REVIEW_FALLBACKS.includes(fallback)) {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has invalid fallback ${JSON.stringify(fallback)}`);
+                }
+                if (data.decision !== undefined || data.reason !== undefined || data.riskLevel !== undefined) {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} carries verdict fields alongside fallback ${JSON.stringify(fallback)}`);
+                }
+            }
+            if (data.outcome !== undefined && !OUTCOMES.includes(data.outcome)) {
+                fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has invalid outcome ${JSON.stringify(data.outcome)}`);
+            }
+            if (data.escalation !== undefined) {
+                // The only escalation today: the risk policy overrode an allow. It
+                // must reference an allow verdict and can never settle allowed-once.
+                if (data.escalation !== 'risk-policy') {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has invalid escalation ${JSON.stringify(data.escalation)}`);
+                }
+                if (data.decision !== 'allow') {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} escalates a non-allow verdict`);
+                }
+                if (data.outcome === 'allowed-once') {
+                    fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} escalates yet settles allowed-once`);
+                }
+            }
+            if (!Number.isSafeInteger(data.durationMs) || data.durationMs < 0) {
+                fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} has invalid durationMs ${String(data.durationMs)}`);
+            }
+            const count = askedIds.get(session)?.get(data.approvalId) ?? 0;
+            if (count < 1) {
+                fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} references no prior approval/asked ${JSON.stringify(data.approvalId)}`);
+            }
+            let verdictsForSession = verdicts.get(session);
+            if (verdictsForSession === undefined) {
+                verdictsForSession = new Map();
+                verdicts.set(session, verdictsForSession);
+            }
+            if (verdictsForSession.has(data.reviewId)) {
+                fail(`autoReview/verdict repeats reviewId ${JSON.stringify(data.reviewId)}`);
+            }
+            const record = {
+                callId: data.callId,
+                decision: data.decision,
+                outcome: data.outcome,
+                fallback: data.fallback,
+                escalation: data.escalation,
+            };
+            verdictsForSession.set(data.reviewId, record);
+            let byApproval = verdictByApproval.get(session);
+            if (byApproval === undefined) {
+                byApproval = new Map();
+                verdictByApproval.set(session, byApproval);
+            }
+            if (byApproval.has(data.approvalId)) {
+                fail(`autoReview/verdict ${JSON.stringify(data.reviewId)} is the second verdict for approval/asked ${JSON.stringify(data.approvalId)}`);
+            }
+            byApproval.set(data.approvalId, record);
+            return;
+        }
+        if (event.type === 'autoReview/circuit') {
+            const data = event.data;
+            if (!TRIP_KINDS.includes(data.trip.kind)) {
+                fail(`autoReview/circuit ${JSON.stringify(data.circuitId)} has invalid trip kind ${JSON.stringify(data.trip.kind)}`);
+            }
+            if (!CIRCUIT_ACTIONS.includes(data.action)) {
+                fail(`autoReview/circuit ${JSON.stringify(data.circuitId)} has invalid action ${JSON.stringify(data.action)}`);
+            }
+            if (!Number.isSafeInteger(data.trip.count) || data.trip.count < 1) {
+                fail(`autoReview/circuit ${JSON.stringify(data.circuitId)} has invalid trip count ${String(data.trip.count)}`);
+            }
+            let circuitIds = circuits.get(session);
+            if (circuitIds === undefined) {
+                circuitIds = new Map();
+                circuits.set(session, circuitIds);
+            }
+            if (circuitIds.has(data.circuitId)) {
+                fail(`autoReview/circuit repeats circuitId ${JSON.stringify(data.circuitId)}`);
+            }
+            circuitIds.set(data.circuitId, data.action);
+            return;
+        }
+        if (event.type === 'autoReview/override') {
+            const verdict = verdicts.get(session)?.get(event.data.reviewId);
+            if (verdict === undefined || (verdict.decision !== 'deny' && verdict.escalation !== 'risk-policy')) {
+                fail(`autoReview/override references reviewId ${JSON.stringify(event.data.reviewId)} without a prior denial verdict`);
+            }
+            return;
+        }
+        if (event.type === 'autoReview/rejection') {
+            const data = event.data;
+            if (typeof data.reason !== 'string' || data.reason.length === 0) {
+                fail(`autoReview/rejection ${JSON.stringify(data.rejectionId)} has no hard-disable reason`);
+            }
+            if (data.outcome !== 'rejected') {
+                fail(`autoReview/rejection ${JSON.stringify(data.rejectionId)} has invalid outcome ${JSON.stringify(data.outcome)}`);
+            }
+            if (data.approvalId !== undefined) {
+                const count = askedIds.get(session)?.get(data.approvalId) ?? 0;
+                if (count < 1) {
+                    fail(`autoReview/rejection ${JSON.stringify(data.rejectionId)} references no prior approval/asked ${JSON.stringify(data.approvalId)}`);
+                }
+                let byApproval = verdictByApproval.get(session);
+                if (byApproval === undefined) {
+                    byApproval = new Map();
+                    verdictByApproval.set(session, byApproval);
+                }
+                if (byApproval.has(data.approvalId)) {
+                    fail(`autoReview/rejection ${JSON.stringify(data.rejectionId)} is the second decision for approval/asked ${JSON.stringify(data.approvalId)}`);
+                }
+                byApproval.set(data.approvalId, {
+                    callId: data.callId,
+                    decision: undefined,
+                    outcome: data.outcome,
+                    fallback: undefined,
+                    escalation: undefined,
+                });
+            }
+            let rejectionIds = rejections.get(session);
+            if (rejectionIds === undefined) {
+                rejectionIds = new Map();
+                rejections.set(session, rejectionIds);
+            }
+            if (rejectionIds.has(data.rejectionId)) {
+                fail(`autoReview/rejection repeats rejectionId ${JSON.stringify(data.rejectionId)}`);
+            }
+            rejectionIds.set(data.rejectionId, { callId: data.callId, outcome: data.outcome });
+            return;
+        }
+        if (event.type === 'approval/decided') {
+            // The answerer claims a request by appending its verdict BEFORE the
+            // service settles the decided pair; a claimed verdict must therefore
+            // agree with the recorded outcome (a `delegate` fallback omits its
+            // outcome because the downstream answerer owns the decision).
+            const claimed = verdictByApproval.get(session)?.get(event.data.id);
+            if (claimed?.outcome !== undefined && claimed.outcome !== event.data.outcome) {
+                fail(`approval/decided ${JSON.stringify(event.data.id)} outcome ${JSON.stringify(event.data.outcome)} contradicts the autoReview/verdict outcome ${JSON.stringify(claimed.outcome)}`);
+            }
+            return;
+        }
+        if (event.type === 'tool/result') {
+            const block = event.data.message.content[0];
+            if (block === undefined || block.type !== 'tool-result') {
+                // Not a tool-result projection this invariant owns; skip.
+                return;
+            }
+            const text = block.content
+                .filter(item => item.type === 'text')
+                .map(item => item.text)
+                .join('\n');
+            const denyMatch = DENY_MARKER_PATTERN.exec(text);
+            if (denyMatch !== null) {
+                const reviewId = denyMatch[1];
+                if (reviewId === undefined) {
+                    fail(`tool/result carries an unparseable deny marker: ${JSON.stringify(denyMatch[0])}`);
+                    return;
+                }
+                const verdict = verdicts.get(session)?.get(reviewId);
+                if (verdict === undefined) {
+                    fail(`tool/result deny marker references unknown reviewId ${JSON.stringify(reviewId)}`);
+                    return;
+                }
+                if (verdict.decision !== 'deny' && !(verdict.escalation === 'risk-policy' && verdict.outcome === 'rejected')) {
+                    fail(`tool/result deny marker references a non-deny verdict ${JSON.stringify(reviewId)}`);
+                }
+                if (verdict.callId !== undefined && verdict.callId !== block.toolCallId) {
+                    fail(`tool/result deny marker for review ${JSON.stringify(reviewId)} has call id ${JSON.stringify(block.toolCallId)}, expected ${JSON.stringify(verdict.callId)}`);
+                }
+                return;
+            }
+            const fallbackMatch = FALLBACK_MARKER_PATTERN.exec(text);
+            if (fallbackMatch !== null) {
+                const reviewId = fallbackMatch[1];
+                if (reviewId === undefined) {
+                    fail(`tool/result carries an unparseable fallback marker: ${JSON.stringify(fallbackMatch[0])}`);
+                    return;
+                }
+                const verdict = verdicts.get(session)?.get(reviewId);
+                if (verdict === undefined) {
+                    fail(`tool/result fallback marker references unknown reviewId ${JSON.stringify(reviewId)}`);
+                    return;
+                }
+                if (verdict.fallback === undefined || verdict.outcome !== 'rejected') {
+                    fail(`tool/result fallback marker references a verdict that was not rejected by fallback ${JSON.stringify(reviewId)}`);
+                }
+                if (verdict.callId !== undefined && verdict.callId !== block.toolCallId) {
+                    fail(`tool/result fallback marker for review ${JSON.stringify(reviewId)} has call id ${JSON.stringify(block.toolCallId)}, expected ${JSON.stringify(verdict.callId)}`);
+                }
+                return;
+            }
+            const circuitMatch = CIRCUIT_MARKER_PATTERN.exec(text);
+            if (circuitMatch !== null) {
+                const circuitId = circuitMatch[1];
+                const toolName = circuitMatch[2];
+                if (circuitId === undefined || toolName === undefined) {
+                    fail(`tool/result carries an unparseable circuit marker: ${JSON.stringify(circuitMatch[0])}`);
+                    return;
+                }
+                const action = circuits.get(session)?.get(circuitId);
+                if (action === undefined) {
+                    fail(`tool/result circuit marker references unknown circuitId ${JSON.stringify(circuitId)}`);
+                    return;
+                }
+                if (action === 'delegate') {
+                    fail(`tool/result circuit marker references a delegate-action circuit ${JSON.stringify(circuitId)}`);
+                }
+                return;
+            }
+            const neverMatch = NEVER_MARKER_PATTERN.exec(text);
+            if (neverMatch === null)
+                return;
+            const rejectionId = neverMatch[1];
+            if (rejectionId === undefined) {
+                fail(`tool/result carries an unparseable never marker: ${JSON.stringify(neverMatch[0])}`);
+                return;
+            }
+            const rejection = rejections.get(session)?.get(rejectionId);
+            if (rejection === undefined) {
+                fail(`tool/result never marker references unknown rejectionId ${JSON.stringify(rejectionId)}`);
+                return;
+            }
+            if (rejection.outcome !== 'rejected') {
+                fail(`tool/result never marker references a rejection that did not settle rejected ${JSON.stringify(rejectionId)}`);
+            }
+            if (rejection.callId !== undefined && rejection.callId !== block.toolCallId) {
+                fail(`tool/result never marker for rejection ${JSON.stringify(rejectionId)} has call id ${JSON.stringify(block.toolCallId)}, expected ${JSON.stringify(rejection.callId)}`);
+            }
+        }
+    };
+    for (const session of ctx.sessions.list()) {
+        for (const event of session.events)
+            validateEvent(session, event);
+    }
+    ctx.on('internal/dispatch', (_mode, eventName, args) => {
+        if (eventName !== 'session/event')
+            return;
+        const [session, event] = args;
+        validateEvent(session, event);
+    }, { global: true });
+}, { inject: ['sessions'] });
+/* jscpd:ignore-end */
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//# sourceMappingURL=invariant.js.map

package/lib/types/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../src/invariant.ts"],"names":[],"mappings":"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"}

package/lib/types/messages.d.ts

@@ -0,0 +1,38 @@
+/**
+ * User-facing command strings for `dsh-auto-review` in the supported
+ * languages. The table is a pure function of the resolved `language` config;
+ * the English strings are the source of truth, the Chinese twin mirrors
+ * them. Reviewer-prompt content is NOT here (it is config-provided
+ * guidance/policy text, not command UI).
+ * @module dsh-auto-review/messages
+ */
+/** Supported UI languages for the `/auto-review` command output. */
+export type UiLanguage = 'en' | 'zh';
+/** All command strings of one language. */
+export interface Messages {
+    readonly usage: string;
+    readonly description: string;
+    readonly statusLine: (enabled: boolean) => string;
+    readonly verdictsLine: (used: number, max: number) => string;
+    readonly failuresLine: (used: number, max: number) => string;
+    readonly circuitLine: (kind: string, count: number, action: string) => string;
+    readonly allTimeLine: (allows: number, denies: number, fallbacks: number, rejections: number, avg: number) => string;
+    readonly recentLine: (labels: string) => string;
+    readonly unknownArg: (arg: string) => string;
+    readonly already: (state: string) => string;
+    readonly switchedNotice: (enabled: boolean) => string;
+    readonly switchedResult: (state: string) => string;
+    readonly approveResult: (toolName: string, reviewId: string, minutes: number) => string;
+    readonly approveNone: (index: number, count: number) => string;
+    readonly approveInvalid: (arg: string) => string;
+    readonly circuitNotice: (kind: string, count: number) => string;
+}
+/** The message tables, keyed by {@link UiLanguage}. */
+export declare const MESSAGES: Readonly<Record<UiLanguage, Messages>>;
+/**
+ * Pick one language's message table.
+ * @param language - the resolved UI language.
+ * @returns the table (English and Chinese are the shipped languages).
+ */
+export declare function messages(language: UiLanguage): Messages;
+//# sourceMappingURL=messages.d.ts.map

package/lib/types/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpC,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IACjD,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5D,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5D,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7E,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACpH,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/C,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3C,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IACrD,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAClD,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;IACvF,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC9D,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAChD,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAChE;AAkDD,uDAAuD;AACvD,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAsB,CAAA;AAElF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAEvD"}

package/lib/types/messages.js

@@ -0,0 +1,65 @@
+/**
+ * User-facing command strings for `dsh-auto-review` in the supported
+ * languages. The table is a pure function of the resolved `language` config;
+ * the English strings are the source of truth, the Chinese twin mirrors
+ * them. Reviewer-prompt content is NOT here (it is config-provided
+ * guidance/policy text, not command UI).
+ * @module dsh-auto-review/messages
+ */
+const EN = {
+    usage: 'Usage: /auto-review on|off|status|approve [n]',
+    description: 'enable or disable second-model AI auto-review for this session, inspect verdicts, or approve one retry',
+    statusLine: enabled => `Auto-review is ${enabled ? 'ON' : 'OFF'} for this session.`,
+    verdictsLine: (used, max) => `AI verdicts this turn: ${used}/${max}`,
+    failuresLine: (used, max) => `Reviewer failures this turn: ${used}/${max}`,
+    circuitLine: (kind, count, action) => `Rejection circuit breaker tripped (${kind}: ${count} denials); later requests in this turn follow "${action}".`,
+    allTimeLine: (allows, denies, fallbacks, rejections, avg) => `All-time: ${allows} allows, ${denies} denies, ${fallbacks} fallbacks, ${rejections} never rejects (avg ${avg} ms per verdict).`,
+    recentLine: labels => `Recent verdicts: ${labels}`,
+    unknownArg: arg => `Unknown /auto-review argument "${arg}". Usage: /auto-review on|off|status|approve [n]`,
+    already: state => `Auto-review is already ${state} for this session.`,
+    switchedNotice: enabled => `AI auto-review was switched ${enabled ? 'ON' : 'OFF'} for this session (changed by the user).`,
+    switchedResult: state => `Auto-review ${state} for this session.`,
+    approveResult: (toolName, reviewId, minutes) => [
+        `Authorized ONE retry of the denied ${toolName} action (review ${reviewId}).`,
+        `The next ${toolName} review within ${minutes} minutes carries this authorization as reviewer context — the reviewer still decides.`,
+    ].join('\n'),
+    approveNone: (index, count) => `No recent denial #${index} in this session (${count} recorded).`,
+    approveInvalid: arg => `Invalid /auto-review approve index "${arg}". Usage: /auto-review approve [n]`,
+    circuitNotice: (kind, count) => `The AI auto-review rejection circuit breaker tripped (${kind}: ${count} denials). `
+        + 'This turn is aborted because the agent kept proposing blocked actions. '
+        + 'Adjust the sandbox boundary or the review policy, then continue.',
+};
+const ZH = {
+    usage: '用法：/auto-review on|off|status|approve [n]',
+    description: '为本会话启用或禁用第二模型 AI 自动审查、查看裁决统计，或批准一次重试',
+    statusLine: enabled => `本会话的自动审查已${enabled ? '开启' : '关闭'}。`,
+    verdictsLine: (used, max) => `本回合 AI 裁决数：${used}/${max}`,
+    failuresLine: (used, max) => `本回合审查失败数：${used}/${max}`,
+    circuitLine: (kind, count, action) => `拒绝熔断器已触发（${kind}：${count} 次拒绝）；本回合后续请求按 "${action}" 处理。`,
+    allTimeLine: (allows, denies, fallbacks, rejections, avg) => `累计：${allows} 次放行，${denies} 次拒绝，${fallbacks} 次失败，${rejections} 次硬禁用拒绝（每次裁决平均 ${avg} ms）。`,
+    recentLine: labels => `最近裁决：${labels}`,
+    unknownArg: arg => `未知的 /auto-review 参数 "${arg}"。用法：/auto-review on|off|status|approve [n]`,
+    already: state => `本会话的自动审查已处于 ${state} 状态。`,
+    switchedNotice: enabled => `AI 自动审查已为本会话${enabled ? '开启' : '关闭'}（由用户更改）。`,
+    switchedResult: state => `本会话的自动审查已${state}。`,
+    approveResult: (toolName, reviewId, minutes) => [
+        `已批准对 ${toolName} 被拒操作的一次重试（审查 ${reviewId}）。`,
+        `接下来 ${minutes} 分钟内对 ${toolName} 的下一次审查将携带该授权作为审查上下文——最终仍由审查代理裁决。`,
+    ].join('\n'),
+    approveNone: (index, count) => `本会话没有第 ${index} 条近期拒绝记录（共 ${count} 条）。`,
+    approveInvalid: arg => `无效的 /auto-review approve 序号 "${arg}"。用法：/auto-review approve [n]`,
+    circuitNotice: (kind, count) => `AI 自动审查拒绝熔断器触发（${kind}：${count} 次拒绝）。`
+        + '由于代理持续提出被阻止的操作，本回合已中止。'
+        + '请调整沙箱边界或审查策略后继续。',
+};
+/** The message tables, keyed by {@link UiLanguage}. */
+export const MESSAGES = { en: EN, zh: ZH };
+/**
+ * Pick one language's message table.
+ * @param language - the resolved UI language.
+ * @returns the table (English and Chinese are the shipped languages).
+ */
+export function messages(language) {
+    return MESSAGES[language];
+}
+//# sourceMappingURL=messages.js.map

package/lib/types/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/messages.ts"],"names":[],"mappings":"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"}

package/lib/types/projection-types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Pure-type outlet of the `autoReview` session projection: the wire value
+ * the host folds and the browser review panel renders. Zero value imports —
+ * client programs pull these types without dragging the host chain.
+ * @module dsh-auto-review/projection-types
+ */
+/** One verdict, presented for the panel. */
+export interface AutoReviewVerdictView {
+    readonly reviewId: string;
+    readonly toolName: string;
+    readonly at: number;
+    readonly durationMs: number;
+    readonly decision?: 'allow' | 'deny';
+    readonly riskLevel?: 'low' | 'medium' | 'high';
+    readonly escalation?: 'risk-policy';
+    readonly fallback?: string;
+    readonly outcome?: string;
+    readonly reason?: string;
+}
+/** One recent denial offered for a one-shot approve (newest first). */
+export interface AutoReviewDenyView {
+    readonly reviewId: string;
+    readonly toolName: string;
+    readonly reason?: string;
+}
+/** The whole wire value folded by the `autoReview` projection unit. */
+export interface AutoReviewProjection {
+    /** The session's switch — the last `autoReview/state` event, or the `enableByDefault` default. */
+    readonly enabled: boolean;
+    /** Real AI verdicts in the current open turn. */
+    readonly verdictsUsed: number;
+    /** Reviewer failures in the current open turn. */
+    readonly failuresUsed: number;
+    /** Cumulative counts over the whole session. */
+    readonly allows: number;
+    readonly denies: number;
+    readonly fallbacks: number;
+    /** Hard-disable (`never` policy) rejections — no reviewer ran for these. */
+    readonly neverRejects: number;
+    /** Mean duration of decision-carrying verdicts, rounded; 0 without any. */
+    readonly avgDurationMs: number;
+    /** The current turn's circuit trip, or null. */
+    readonly circuit: {
+        readonly action: 'delegate' | 'reject' | 'abort-turn';
+        readonly trip: {
+            readonly kind: 'consecutive' | 'window';
+            readonly count: number;
+        };
+        readonly toolName: string;
+    } | null;
+    /** The last 8 verdicts, newest first. */
+    readonly recent: readonly AutoReviewVerdictView[];
+    /** The last 5 denials, newest first (approve candidates; index 0 = approve 1). */
+    readonly recentDenies: readonly AutoReviewDenyView[];
+}
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionMap {
+        autoReview: AutoReviewProjection;
+    }
+}
+//# sourceMappingURL=projection-types.d.ts.map

package/lib/types/projection-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-types.d.ts","sourceRoot":"","sources":["../../src/projection-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAA;QACrD,QAAQ,CAAC,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;QAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAC1B,GAAG,IAAI,CAAA;IACR,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACjD,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACrD;AAED,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,oBAAoB;QAC5B,UAAU,EAAE,oBAAoB,CAAA;KACjC;CACF"}

package/lib/types/projection-types.js

@@ -0,0 +1,8 @@
+/**
+ * Pure-type outlet of the `autoReview` session projection: the wire value
+ * the host folds and the browser review panel renders. Zero value imports —
+ * client programs pull these types without dragging the host chain.
+ * @module dsh-auto-review/projection-types
+ */
+export {};
+//# sourceMappingURL=projection-types.js.map

package/lib/types/projection-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-types.js","sourceRoot":"","sources":["../../src/projection-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/types/projection.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Host projection unit for the `autoReview` panel value: folds the log-only
+ * `autoReview/*` events into one wire-JSON whole value the browser review
+ * panel reads via `useProjection('autoReview')`. Pure mathematics only — the
+ * framework owns subscriptions, watermarks, change feeds, and persistence.
+ * The fold mirrors the `events.ts` pure folds (budgets, statistics, denials).
+ * @module dsh-auto-review/projection
+ */
+import { z } from 'zod';
+import type { ProjectionDefinition } from '@deepseek-ai/dsh-session-projection';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { AutoReviewDenyView, AutoReviewProjection, AutoReviewVerdictView } from './projection-types.ts';
+/** Strict wire schema — validates the `view` output before it leaves the host. */
+export declare const AUTO_REVIEW_PROJECTION_SCHEMA: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    verdictsUsed: z.ZodNumber;
+    failuresUsed: z.ZodNumber;
+    allows: z.ZodNumber;
+    denies: z.ZodNumber;
+    fallbacks: z.ZodNumber;
+    neverRejects: z.ZodNumber;
+    avgDurationMs: z.ZodNumber;
+    circuit: z.ZodNullable<z.ZodObject<{
+        action: z.ZodUnion<readonly [z.ZodLiteral<"delegate">, z.ZodLiteral<"reject">, z.ZodLiteral<"abort-turn">]>;
+        trip: z.ZodObject<{
+            kind: z.ZodUnion<readonly [z.ZodLiteral<"consecutive">, z.ZodLiteral<"window">]>;
+            count: z.ZodNumber;
+        }, z.core.$strip>;
+        toolName: z.ZodString;
+    }, z.core.$strip>>;
+    recent: z.ZodArray<z.ZodObject<{
+        reviewId: z.ZodString;
+        toolName: z.ZodString;
+        at: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        decision: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"allow">, z.ZodLiteral<"deny">]>>;
+        riskLevel: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"low">, z.ZodLiteral<"medium">, z.ZodLiteral<"high">]>>;
+        escalation: z.ZodOptional<z.ZodLiteral<"risk-policy">>;
+        fallback: z.ZodOptional<z.ZodString>;
+        outcome: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"allowed-once">, z.ZodLiteral<"rejected">, z.ZodLiteral<"cancelled">, z.ZodLiteral<"unavailable">]>>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    recentDenies: z.ZodArray<z.ZodObject<{
+        reviewId: z.ZodString;
+        toolName: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** The fold's plain-JSON state (the persisted-cache precondition). */
+export interface AutoReviewProjectionState {
+    readonly enabled: boolean;
+    readonly turnOpen: boolean;
+    readonly verdictsUsed: number;
+    readonly failuresUsed: number;
+    readonly allows: number;
+    readonly denies: number;
+    readonly fallbacks: number;
+    readonly neverRejects: number;
+    readonly durationSum: number;
+    readonly decided: number;
+    readonly circuit: AutoReviewProjection['circuit'];
+    readonly recent: readonly AutoReviewVerdictView[];
+    readonly recentDenies: readonly AutoReviewDenyView[];
+}
+/**
+ * State for the empty log. `enabled` starts at the resolved
+ * `enableByDefault` — the projection cannot know the plugin config on its
+ * own, so the unit is built per mount by {@link makeAutoReviewProjection}.
+ * @param enabledByDefault - the resolved `enableByDefault` config value.
+ */
+export declare function initAutoReviewProjection(enabledByDefault: boolean): AutoReviewProjectionState;
+/**
+ * Pure transition: previous state + one committed event → next state.
+ * Uninterested events return the same state reference.
+ * @param state - the state covering all prior events.
+ * @param event - the next committed session event.
+ * @returns the next state (same reference when the event is not this unit's).
+ */
+export declare function applyAutoReview(state: AutoReviewProjectionState, event: SessionEvent): AutoReviewProjectionState;
+/** State → wire payload (the read-side projection). */
+export declare function viewAutoReview(state: AutoReviewProjectionState): AutoReviewProjection;
+/**
+ * Build the registered unit for one mount. The unit's initial `enabled` is
+ * the mount's resolved `enableByDefault` (the pure `init` cannot see plugin
+ * config otherwise), and the panel therefore reports the same switch state
+ * the answerer applies. Registrants sharing the `autoReview` key share one
+ * unit; the first mount's default wins, which only matters for a double
+ * mount with conflicting `enableByDefault` values.
+ * @param enabledByDefault - the resolved `enableByDefault` config value.
+ * @returns the projection unit for `ctx.sessionProjections.register`.
+ */
+export declare function makeAutoReviewProjection(enabledByDefault: boolean): ProjectionDefinition<'autoReview', AutoReviewProjectionState>;
+//# sourceMappingURL=projection.d.ts.map

package/lib/types/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,0BAA0B,CAAA;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAmC5G,kFAAkF;AAClF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYxC,CAAA;AAEF,sEAAsE;AACtE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACjD,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACrD;AAKD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,OAAO,GAAG,yBAAyB,CAgB7F;AA6BD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,YAAY,GAAG,yBAAyB,CAyChH;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG,oBAAoB,CAcrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,OAAO,GAAG,oBAAoB,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAajI"}