@lingxiao-office/sdk 1.0.0

package/dist/core/ModeAudit.js

@@ -0,0 +1,113 @@
+/**
+ * ModeAudit — 三模式审计的统一出口 + per-mode metrics sink。
+ *
+ * 历史上三类模式事件各自走独立通道：
+ *   - office：Registry.execute 调 auditOfficeToolExecution → jsonl 落盘
+ *   - bughunt：appendBughuntEvent → ledger.events[]
+ *   - workflow：WorkflowEngine.emitEvent → 订阅者 + DB execution 表
+ *
+ * 三者没有统一的事件 schema，也没有共享的可观测出口。本模块提供：
+ *   1. 统一的 ModeAuditEvent 判别联合（per kind 收窄 payload）；
+ *   2. auditModeEvent(mode, event) 单一入口，落各自既有通道 + 写统一 metrics sink；
+ *   3. 复用 MetricsRegistry（lingxiao_mode_*_total）做 per-mode 调用/拦截/耗时计数。
+ *
+ * 本模块**不接管**各模式既有的数据落盘（jsonl/ledger/DB），只在其之上加一层统一
+ * 抽象与可观测桥接——避免一次性大重构破坏既有审计与回归。各通道的底层写函数仍由
+ * 调用方持有，auditModeEvent 只做「分发 + metrics」。
+ *
+ * 确定性：metrics 只记录结构化 label（mode/kind/outcome/tool），无启发式、无采样推断。
+ */
+import { metrics } from './MetricsRegistry.js';
+const MODE_COUNTER_NAMES = {
+    bughunt: 'lingxiao_mode_bughunt_total',
+    office: 'lingxiao_mode_office_total',
+    workflow: 'lingxiao_mode_workflow_total',
+};
+/** fail-closed 拦截计数（跨模式，按 mode/tool 分 label）。 */
+const modeGateBlockedTotal = metrics.counter('lingxiao_mode_gate_blocked_total', '会话级模式未启用时，工具调用被 mode_forbidden 拦截的次数');
+/**
+ * 读取某 (mode, tool) 组合的累计拦截次数——确定性、结构化。
+ *
+ * 用于反馈点（N5）：例如 bughunt 模式未启用却反复有 set_bughunt_dag 调用，
+ * 累计拦截数即「反复尝试」的真实信号源。不做基于 confidence 的推断，只暴露计数，
+ * 由上层（runtime projection / prompt）决定如何提示。
+ */
+export function getModeGateBlockCount(mode, tool) {
+    let total = 0;
+    try {
+        for (const sample of modeGateBlockedTotal.getValues()) {
+            if (sample.labels.mode === mode && sample.labels.tool === tool) {
+                total += sample.value;
+            }
+        }
+    }
+    catch {
+        // 读取失败返回 0。
+    }
+    return total;
+}
+/** 反馈阈值：同一 (mode,tool) 累计拦截达到该值即视为「反复尝试未启用模式的工具」。 */
+const REPEATED_GATE_BLOCK_THRESHOLD = 3;
+/**
+ * 反馈点：判定某 (mode,tool) 是否达到「反复尝试未启用模式」的信号。
+ * 确定性：基于真实计数器与固定阈值，无启发式 / 无关键词。
+ */
+export function isRepeatedModeGateBlock(mode, tool) {
+    return getModeGateBlockCount(mode, tool) >= REPEATED_GATE_BLOCK_THRESHOLD;
+}
+function modeCounter(mode) {
+    return metrics.counter(MODE_COUNTER_NAMES[mode], `模式 ${mode} 的工具调用/事件计数`);
+}
+/**
+ * 记录一个 per-mode 审计事件并更新 metrics。
+ *
+ * 调用方仍负责把事件落到该模式既有的数据通道（office jsonl / bughunt ledger /
+ * workflow DB）；本函数只负责「统一 metrics 计数 + 一个可观测的汇聚点」。
+ *
+ * @param mode 事件所属模式。
+ * @param event 结构化审计事件。
+ * @param callerContext 可选的调用方上下文（用于 metrics label，不落库）。
+ */
+export function auditModeEvent(mode, event, callerContext) {
+    try {
+        const baseLabels = { kind: event.kind };
+        const outcome = auditOutcomeFor(event);
+        if (outcome)
+            baseLabels.outcome = outcome;
+        modeCounter(mode).inc(baseLabels);
+        if (event.kind === 'mode_gate_blocked') {
+            modeGateBlockedTotal.inc({
+                mode,
+                tool: event.tool,
+                reason: event.reason,
+                actor: callerContext?.actor ?? event.actor,
+            });
+        }
+    }
+    catch {
+        // metrics 写入失败绝不影响业务路径。
+    }
+}
+/** 从审计事件派生确定性的 outcome label（无启发式）。 */
+function auditOutcomeFor(event) {
+    switch (event.kind) {
+        case 'office_tool_call':
+            return event.success ? 'success' : 'failure';
+        case 'workflow_execution':
+            return event.outcome;
+        case 'bughunt_ledger_event':
+            return event.bughuntKind;
+        case 'mode_gate_blocked':
+            return 'blocked';
+        default:
+            return undefined;
+    }
+}
+/**
+ * fail-closed 拦截的便捷记录器。
+ * 供 ModeToolPolicy 命中 `*_MODE_REQUIRED` 时调用（确定性统计反复尝试）。
+ */
+export function recordModeGateBlock(mode, tool, reason, actor) {
+    auditModeEvent(mode, { kind: 'mode_gate_blocked', tool, reason, actor }, { actor });
+}
+//# sourceMappingURL=ModeAudit.js.map

package/dist/core/ModeAudit.js.map

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

package/dist/core/ModeRuntimeProjection.d.ts

@@ -0,0 +1,96 @@
+import type { ControlMode, LeaderExecutionMode } from '../contracts/types/Session.js';
+import { type AutonomyMode, type AutonomyLifecyclePhase, type CapabilityIntentProfile } from '../contracts/types/Autonomy.js';
+import type { AutonomyDecision } from '../contracts/types/AutonomyDecision.js';
+import { type PermissionMode, type ToolPermissionContext } from './PermissionSystem.js';
+import { type ProjectBlueprint } from './ProjectBlueprint.js';
+import { type ModeId } from '../contracts/modes.js';
+export type CollaborationMode = 'solo' | 'team';
+export type ExecutionRoutePreference = 'auto' | 'direct' | 'hybrid' | 'delegate';
+export type BlackboardMode = 'off' | 'summary' | 'full';
+export type RouteMode = LeaderExecutionMode | 'unknown';
+export type CollaborationModeSource = 'explicit' | 'legacy' | 'default';
+export type RouteModeSource = 'leader' | 'session' | 'default';
+export type BlackboardModeSource = 'default' | 'explicit' | 'team' | 'workflow' | 'contract_bound';
+export interface AutonomyDecisionTrace {
+    toolName: string;
+    decision: AutonomyDecision;
+    gateResult: 'allow' | 'blocked' | 'confirmation_required';
+    gateKind?: 'forbidden' | 'confirmation_required' | null;
+    recordedAt: number;
+    source: 'leader_tool_gate' | string;
+}
+export interface ModeRuntimeProjection {
+    controlMode: ControlMode;
+    route: {
+        mode: RouteMode;
+        preference: ExecutionRoutePreference;
+        reason?: string;
+        source: RouteModeSource;
+    };
+    collaboration: {
+        mode: CollaborationMode;
+        source: CollaborationModeSource;
+        activeTeamName?: string | null;
+        teamEnabled: boolean;
+    };
+    workflow: {
+        enabled: boolean;
+        activeExecutionCount: number;
+    };
+    /**
+     * 会话级模式插件激活状态（bughunt/office/workflow）。
+     * 由 MODE_REGISTRY 单一事实源派生，供 ModeToolPolicy 做 fail-closed 判定，
+     * 并对齐 modes.md「Backend projection canonical」供 Web/TUI 投影展示。
+     */
+    modePlugins: Record<ModeId, boolean>;
+    blackboard: {
+        mode: BlackboardMode;
+        source: BlackboardModeSource;
+    };
+    permission: {
+        mode: PermissionMode;
+        summary?: string;
+    };
+    /** 项目蓝图(复杂项目结构化状态);无蓝图时为 null。投影到 runtime snapshot 供前端展示与覆盖判定。 */
+    blueprint?: ProjectBlueprint | null;
+    /**
+     * 自治档位 + capability intent profile + 生命周期阶段 + policy generation。
+     * `intentProfile` 缺失或非法时会 fail-closed 到只读默认 profile。
+     */
+    autonomy: AutonomyMode;
+    intentProfile: CapabilityIntentProfile;
+    lifecyclePhase: AutonomyLifecyclePhase;
+    modeGeneration: number;
+    policyId: string | null;
+    policyHash: string | null;
+    lastDecisionTrace: AutonomyDecisionTrace | null;
+}
+export interface ModeRuntimeStateReader {
+    getSessionState(sessionId: string, key: string): unknown | null;
+}
+export interface ActiveTeamValidationResult {
+    valid: boolean;
+    activeTeamName: string | null;
+    rosterCount: number;
+}
+export interface ResolveModeRuntimeProjectionInput {
+    sessionId: string;
+    db: ModeRuntimeStateReader;
+    permissionContext?: ToolPermissionContext | null;
+    permissionSummary?: string;
+    blackboardAvailable?: boolean;
+    blackboardModeOverride?: unknown;
+    activeWorkflowExecutionCount?: number;
+    validateActiveTeam?: (teamName: string, sessionId: string) => ActiveTeamValidationResult;
+}
+/**
+ * 归一化后的执行路由偏好三态。'hybrid' 是历史遗留值（UI 已收敛为 自动/自己执行/委派助手
+ * 三选项），语义等同 'auto'（算法自主决定），归一化掉。chooseExecutionRoute 决策与 route
+ * hint 注入共用此单一事实源，避免两处各写归一化逻辑而漂移。
+ */
+export type EffectiveRoutePreference = 'auto' | 'direct' | 'delegate';
+/** 将任意 EXECUTION_ROUTE_OVERRIDE 值归一化为 auto/direct/delegate 三态。 */
+export declare function resolveEffectiveRoutePreference(value: unknown): EffectiveRoutePreference;
+export declare function defaultActiveTeamValidator(teamName: string, sessionId: string): ActiveTeamValidationResult;
+export declare function resolveModeRuntimeProjection(input: ResolveModeRuntimeProjectionInput): ModeRuntimeProjection;
+//# sourceMappingURL=ModeRuntimeProjection.d.ts.map

package/dist/core/ModeRuntimeProjection.d.ts.map

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

package/dist/core/ModeRuntimeProjection.js

@@ -0,0 +1,216 @@
+import { normalizeAutonomyMode, normalizeAutonomyLifecyclePhase, } from '../contracts/types/Autonomy.js';
+import { defaultCapabilityIntentProfile, normalizeCapabilityIntentProfile } from '../agents/IntentClassifier.js';
+import { getDefaultToolPermissionContext, normalizeToolPermissionContext, summarizePermissionContextForDisplay, } from './PermissionSystem.js';
+import { SESSION_KEYS } from './SessionStateKeys.js';
+import { parseBlueprint } from './ProjectBlueprint.js';
+import { getTeamMailbox, getTeamMemberRegistry } from './TeamMailbox.js';
+import { MODE_REGISTRY, ALL_MODE_IDS } from '../contracts/modes.js';
+function asTrimmedString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function asRecord(value) {
+    if (typeof value === 'string' && value.trim()) {
+        try {
+            const parsed = JSON.parse(value);
+            return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+function readNumber(value) {
+    const n = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+function readAutonomyDecisionTrace(value) {
+    const record = asRecord(value);
+    if (!record)
+        return null;
+    const decisionRecord = asRecord(record.decision);
+    const toolName = asTrimmedString(record.toolName);
+    const recordedAt = readNumber(record.recordedAt);
+    const gateResult = record.gateResult === 'allow' || record.gateResult === 'blocked' || record.gateResult === 'confirmation_required'
+        ? record.gateResult
+        : null;
+    if (!decisionRecord || !toolName || recordedAt === null || !gateResult)
+        return null;
+    return {
+        toolName,
+        decision: decisionRecord,
+        gateResult,
+        gateKind: record.gateKind === 'forbidden' || record.gateKind === 'confirmation_required' ? record.gateKind : null,
+        recordedAt,
+        source: typeof record.source === 'string' && record.source.trim() ? record.source.trim() : 'leader_tool_gate',
+    };
+}
+function readControlMode(value) {
+    return value === 'eternal' ? 'eternal' : 'manual';
+}
+function readRouteMode(value) {
+    if (value === 'direct' || value === 'hybrid' || value === 'delegate') {
+        return { mode: value, source: 'leader' };
+    }
+    return { mode: 'direct', source: 'default' };
+}
+function readRoutePreference(value) {
+    if (value === 'direct' || value === 'hybrid' || value === 'delegate')
+        return value;
+    return 'auto';
+}
+/** 将任意 EXECUTION_ROUTE_OVERRIDE 值归一化为 auto/direct/delegate 三态。 */
+export function resolveEffectiveRoutePreference(value) {
+    const pref = readRoutePreference(value);
+    return pref === 'hybrid' ? 'auto' : pref;
+}
+function readCollaborationMode(value) {
+    return value === 'solo' || value === 'team' ? value : null;
+}
+function readBlackboardMode(value) {
+    return value === 'off' || value === 'summary' || value === 'full' ? value : null;
+}
+export function defaultActiveTeamValidator(teamName, sessionId) {
+    const activeTeamName = teamName.trim();
+    if (!activeTeamName) {
+        return { valid: false, activeTeamName: null, rosterCount: 0 };
+    }
+    try {
+        const team = getTeamMailbox().getTeam(activeTeamName, sessionId);
+        const roster = getTeamMemberRegistry().getByTeam(activeTeamName, sessionId);
+        const rosterNames = new Set(roster.map((member) => member.name));
+        const expectedNames = new Set();
+        if (team?.leader)
+            expectedNames.add(team.leader);
+        for (const memberName of team?.members || [])
+            expectedNames.add(memberName);
+        const expectedRosterPresent = expectedNames.size === 0
+            ? roster.length > 0
+            : Array.from(expectedNames).every((name) => rosterNames.has(name));
+        const valid = Boolean(team?.active !== false && roster.length > 0 && expectedRosterPresent);
+        return {
+            valid,
+            activeTeamName: valid ? activeTeamName : null,
+            rosterCount: roster.length,
+        };
+    }
+    catch {
+        return { valid: false, activeTeamName: null, rosterCount: 0 };
+    }
+}
+function resolvePermissionProjection(input) {
+    const raw = input.permissionContext ?? input.db.getSessionState(input.sessionId, SESSION_KEYS.TOOL_PERMISSION_CONTEXT);
+    const context = raw
+        ? normalizeToolPermissionContext(raw)
+        : getDefaultToolPermissionContext();
+    return {
+        mode: context.mode,
+        summary: input.permissionSummary || summarizePermissionContextForDisplay(context),
+    };
+}
+function resolveCollaborationProjection(input) {
+    const explicitMode = readCollaborationMode(input.db.getSessionState(input.sessionId, SESSION_KEYS.COLLABORATION_MODE));
+    const activeTeamState = asTrimmedString(input.db.getSessionState(input.sessionId, SESSION_KEYS.LEADER_ACTIVE_TEAM));
+    const validate = input.validateActiveTeam ?? defaultActiveTeamValidator;
+    const activeTeam = activeTeamState ? validate(activeTeamState, input.sessionId) : { valid: false, activeTeamName: null, rosterCount: 0 };
+    if (explicitMode) {
+        const teamEnabled = explicitMode === 'team' && activeTeam.valid;
+        return {
+            mode: explicitMode,
+            source: 'explicit',
+            activeTeamName: teamEnabled ? activeTeam.activeTeamName : null,
+            teamEnabled,
+        };
+    }
+    if (activeTeam.valid) {
+        return {
+            mode: 'team',
+            source: 'legacy',
+            activeTeamName: activeTeam.activeTeamName,
+            teamEnabled: true,
+        };
+    }
+    return {
+        mode: 'solo',
+        source: 'default',
+        activeTeamName: null,
+        teamEnabled: false,
+    };
+}
+function resolveBlackboardProjection(input) {
+    const explicit = readBlackboardMode(input.blackboardModeOverride);
+    if (explicit) {
+        return { mode: explicit, source: 'explicit' };
+    }
+    if (input.collaboration.teamEnabled) {
+        return { mode: 'full', source: 'team' };
+    }
+    if (input.workflowEnabled && input.blackboardAvailable) {
+        return { mode: 'full', source: 'workflow' };
+    }
+    if (input.blackboardAvailable) {
+        return { mode: 'summary', source: 'default' };
+    }
+    return { mode: 'off', source: 'default' };
+}
+export function resolveModeRuntimeProjection(input) {
+    const controlMode = readControlMode(input.db.getSessionState(input.sessionId, SESSION_KEYS.CONTROL_MODE));
+    const route = readRouteMode(input.db.getSessionState(input.sessionId, SESSION_KEYS.LEADER_EXECUTION_MODE));
+    const routePreference = readRoutePreference(input.db.getSessionState(input.sessionId, SESSION_KEYS.EXECUTION_ROUTE_OVERRIDE));
+    const routeReason = asTrimmedString(input.db.getSessionState(input.sessionId, SESSION_KEYS.LEADER_EXECUTION_REASON));
+    const modePlugins = Object.fromEntries(ALL_MODE_IDS.map((id) => [id, input.db.getSessionState(input.sessionId, MODE_REGISTRY[id].sessionKey) === 'true']));
+    const workflowEnabled = modePlugins.workflow;
+    const collaboration = resolveCollaborationProjection(input);
+    const blackboard = resolveBlackboardProjection({
+        workflowEnabled,
+        collaboration,
+        blackboardAvailable: input.blackboardAvailable,
+        blackboardModeOverride: input.blackboardModeOverride,
+    });
+    const blueprint = parseBlueprint(input.db.getSessionState(input.sessionId, SESSION_KEYS.PROJECT_BLUEPRINT));
+    const autonomy = normalizeAutonomyMode(input.db.getSessionState(input.sessionId, SESSION_KEYS.AUTONOMY_MODE));
+    const currentTurnRaw = input.db.getSessionState(input.sessionId, SESSION_KEYS.CURRENT_USER_TURN_ID);
+    const currentTurnId = readNumber(currentTurnRaw);
+    const intentProfile = normalizeCapabilityIntentProfile(input.db.getSessionState(input.sessionId, SESSION_KEYS.CAPABILITY_INTENT_PROFILE), { turnId: currentTurnId, source: 'record_capability_intent' }) ?? defaultCapabilityIntentProfile('intent_profile_not_recorded', { turnId: currentTurnId });
+    const lifecyclePhase = normalizeAutonomyLifecyclePhase(input.db.getSessionState(input.sessionId, SESSION_KEYS.AUTONOMY_LIFECYCLE_PHASE));
+    const modeGeneration = (() => {
+        const raw = input.db.getSessionState(input.sessionId, SESSION_KEYS.AUTONOMY_MODE_GENERATION);
+        const n = typeof raw === 'number' ? raw : typeof raw === 'string' ? Number(raw) : NaN;
+        return Number.isFinite(n) && n >= 1 ? Math.trunc(n) : 1;
+    })();
+    const policyId = (() => {
+        const raw = input.db.getSessionState(input.sessionId, SESSION_KEYS.AUTONOMY_POLICY_ID);
+        return typeof raw === 'string' && raw.trim() ? raw.trim() : null;
+    })();
+    const policyHash = (() => {
+        const raw = input.db.getSessionState(input.sessionId, SESSION_KEYS.AUTONOMY_POLICY_HASH);
+        return typeof raw === 'string' && raw.trim() ? raw.trim() : null;
+    })();
+    const lastDecisionTrace = readAutonomyDecisionTrace(input.db.getSessionState(input.sessionId, SESSION_KEYS.AUTONOMY_DECISION_TRACE));
+    return {
+        controlMode,
+        route: {
+            mode: route.mode,
+            preference: routePreference,
+            ...(routeReason ? { reason: routeReason } : {}),
+            source: route.source,
+        },
+        collaboration,
+        workflow: {
+            enabled: workflowEnabled,
+            activeExecutionCount: Math.max(0, Math.trunc(input.activeWorkflowExecutionCount ?? 0)),
+        },
+        modePlugins,
+        blackboard,
+        permission: resolvePermissionProjection(input),
+        blueprint,
+        autonomy,
+        intentProfile,
+        lifecyclePhase,
+        modeGeneration,
+        policyId,
+        policyHash,
+        lastDecisionTrace,
+    };
+}
+//# sourceMappingURL=ModeRuntimeProjection.js.map

package/dist/core/ModeRuntimeProjection.js.map

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

package/dist/core/ModeStore.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ModeStore<T> — 会话级模式持久化状态库的通用抽象。
+ *
+ * 历史上只有 Bughunt 有 ledger（src/core/BughuntLedger.ts），office 的审计落 jsonl、
+ * workflow 的执行历史只活在内存 Map 里、进程重启即丢。三者的「读写一个 JSON 到
+ * session_state、带版本号、带 updated_at」模式完全同构，这里把它收成一个泛型类，
+ * 让三个模式共享同一种命名空间化的持久化与失效语义。
+ *
+ * 设计：
+ *   - 存储后端仍是 DatabaseManager 的 session_state（复用 SESSION_KEY_PREFIXES 的
+ *     `bughunt_` / `office_` / `workflow_` 前缀，无需新表）。
+ *   - 泛型 T 约束 version/session_id/updated_at 三字段，保证读写一致性校验有据可依。
+ *   - 不假设 T 的业务字段——create/transform 等业务逻辑由调用方持有 factory/producer。
+ *
+ * 确定性：纯函数式读写，只动 session_state，无启发式。
+ */
+import type { ModeId } from '../contracts/modes.js';
+/** ModeStore 持久化的最小契约：版本、会话、更新时间。 */
+export interface ModeStoreRecord {
+    version: number;
+    session_id: string;
+    updated_at: number;
+}
+/** ModeStore 依赖的会话状态读写接口（DatabaseManager 满足此契约）。 */
+export interface ModeStoreDb {
+    getSessionState(sessionId: string, key: string): unknown | null;
+    setSessionState(sessionId: string, key: string, value: unknown): void;
+}
+/**
+ * 会话级模式状态库。
+ *
+ * 用法（典型）：
+ * ```ts
+ * const store = new ModeStore('bughunt', SESSION_KEYS.BUGHUNT_LEDGER, createBughuntLedger);
+ * const ledger = store.ensure(db, sessionId);
+ * store.update(db, ledger, (cur) => ({ ...cur, active: false }));
+ * ```
+ */
+export declare class ModeStore<T extends ModeStoreRecord> {
+    private readonly mode;
+    private readonly sessionKey;
+    private readonly factory;
+    constructor(mode: ModeId, sessionKey: string, factory: (sessionId: string) => T);
+    /** 读取并校验；记录不存在或版本/会话不匹配返回 null。 */
+    read(db: ModeStoreDb, sessionId: string): T | null;
+    /** 写入（自动盖 updated_at 时间戳）。 */
+    write(db: ModeStoreDb, value: T): T;
+    /** 读取，不存在则用 factory 创建并落库。 */
+    ensure(db: ModeStoreDb, sessionId: string): T;
+    /**
+     * 读 → 转换 → 写 的原子化更新（注意：DatabaseManager 的 session_state 读写本身
+     * 不跨进程加锁；本方法保证「同一调用内读到最新再覆盖」，适合单进程多模式场景）。
+     */
+    update(db: ModeStoreDb, sessionId: string, transform: (current: T) => T): T;
+    /** 清空该会话本模式的记录（用于模式关闭时的确定性回收）。 */
+    clear(db: ModeStoreDb, sessionId: string): void;
+    /** 该模式的标识（诊断/审计用）。 */
+    get id(): ModeId;
+    /** 该模式的 session_state 键。 */
+    get key(): string;
+}
+//# sourceMappingURL=ModeStore.d.ts.map

package/dist/core/ModeStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeStore.d.ts","sourceRoot":"","sources":["../../src/core/ModeStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAChE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACvE;AAED;;;;;;;;;GASG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,eAAe;IAE5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,CAAC;IAGpD,mCAAmC;IACnC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAQlD,8BAA8B;IAC9B,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAMnC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC;IAI7C;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;IAK3E,kCAAkC;IAClC,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/C,sBAAsB;IACtB,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,4BAA4B;IAC5B,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF"}

package/dist/core/ModeStore.js

@@ -0,0 +1,77 @@
+/**
+ * ModeStore<T> — 会话级模式持久化状态库的通用抽象。
+ *
+ * 历史上只有 Bughunt 有 ledger（src/core/BughuntLedger.ts），office 的审计落 jsonl、
+ * workflow 的执行历史只活在内存 Map 里、进程重启即丢。三者的「读写一个 JSON 到
+ * session_state、带版本号、带 updated_at」模式完全同构，这里把它收成一个泛型类，
+ * 让三个模式共享同一种命名空间化的持久化与失效语义。
+ *
+ * 设计：
+ *   - 存储后端仍是 DatabaseManager 的 session_state（复用 SESSION_KEY_PREFIXES 的
+ *     `bughunt_` / `office_` / `workflow_` 前缀，无需新表）。
+ *   - 泛型 T 约束 version/session_id/updated_at 三字段，保证读写一致性校验有据可依。
+ *   - 不假设 T 的业务字段——create/transform 等业务逻辑由调用方持有 factory/producer。
+ *
+ * 确定性：纯函数式读写，只动 session_state，无启发式。
+ */
+/**
+ * 会话级模式状态库。
+ *
+ * 用法（典型）：
+ * ```ts
+ * const store = new ModeStore('bughunt', SESSION_KEYS.BUGHUNT_LEDGER, createBughuntLedger);
+ * const ledger = store.ensure(db, sessionId);
+ * store.update(db, ledger, (cur) => ({ ...cur, active: false }));
+ * ```
+ */
+export class ModeStore {
+    mode;
+    sessionKey;
+    factory;
+    constructor(mode, sessionKey, factory) {
+        this.mode = mode;
+        this.sessionKey = sessionKey;
+        this.factory = factory;
+    }
+    /** 读取并校验；记录不存在或版本/会话不匹配返回 null。 */
+    read(db, sessionId) {
+        const raw = db.getSessionState(sessionId, this.sessionKey);
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const record = raw;
+        if (record.session_id !== sessionId)
+            return null;
+        return { ...record };
+    }
+    /** 写入（自动盖 updated_at 时间戳）。 */
+    write(db, value) {
+        const next = { ...value, updated_at: Date.now() };
+        db.setSessionState(value.session_id, this.sessionKey, next);
+        return next;
+    }
+    /** 读取，不存在则用 factory 创建并落库。 */
+    ensure(db, sessionId) {
+        return this.read(db, sessionId) ?? this.write(db, this.factory(sessionId));
+    }
+    /**
+     * 读 → 转换 → 写 的原子化更新（注意：DatabaseManager 的 session_state 读写本身
+     * 不跨进程加锁；本方法保证「同一调用内读到最新再覆盖」，适合单进程多模式场景）。
+     */
+    update(db, sessionId, transform) {
+        const current = this.ensure(db, sessionId);
+        return this.write(db, transform(current));
+    }
+    /** 清空该会话本模式的记录（用于模式关闭时的确定性回收）。 */
+    clear(db, sessionId) {
+        db.setSessionState(sessionId, this.sessionKey, null);
+    }
+    /** 该模式的标识（诊断/审计用）。 */
+    get id() {
+        return this.mode;
+    }
+    /** 该模式的 session_state 键。 */
+    get key() {
+        return this.sessionKey;
+    }
+}
+//# sourceMappingURL=ModeStore.js.map

package/dist/core/ModeStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeStore.js","sourceRoot":"","sources":["../../src/core/ModeStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH;;;;;;;;;GASG;AACH,MAAM,OAAO,SAAS;IAED;IACA;IACA;IAHnB,YACmB,IAAY,EACZ,UAAkB,EAClB,OAAiC;QAFjC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAQ;QAClB,YAAO,GAAP,OAAO,CAA0B;IACjD,CAAC;IAEJ,mCAAmC;IACnC,IAAI,CAAC,EAAe,EAAE,SAAiB;QACrC,MAAM,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjD,MAAM,MAAM,GAAG,GAAiB,CAAC;QACjC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACjD,OAAO,EAAE,GAAG,MAAM,EAAO,CAAC;IAC5B,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,EAAe,EAAE,KAAQ;QAC7B,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAClD,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAA8B;IAC9B,MAAM,CAAC,EAAe,EAAE,SAAiB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAe,EAAE,SAAiB,EAAE,SAA4B;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,EAAe,EAAE,SAAiB;QACtC,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,sBAAsB;IACtB,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,4BAA4B;IAC5B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}