@lingxiao-office/sdk 1.0.0

package/dist/core/SessionStateKeys.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Session state key constants
+ *
+ * All string keys used with db.getSessionState() / db.setSessionState()
+ * are centralized here to prevent typos and duplication.
+ */
+export declare const SESSION_KEYS: {
+    /** Whether the leader is waiting for user input ('true' | 'false') */
+    readonly LEADER_WAITING_FOR_USER: "leader_waiting_for_user";
+    /** Pending plan review flag */
+    readonly LEADER_PENDING_REVIEW: "leader_pending_review";
+    /** Whether the plan has been approved */
+    readonly LEADER_PLAN_APPROVED: "leader_plan_approved";
+    /** Current leader execution mode */
+    readonly LEADER_EXECUTION_MODE: "leader_execution_mode";
+    /** Reason for the current execution mode */
+    readonly LEADER_EXECUTION_REASON: "leader_execution_reason";
+    /** Serialized ToolPermissionContext */
+    readonly TOOL_PERMISSION_CONTEXT: "tool_permission_context";
+    /** Serialized PermissionRequestPayload when awaiting user approval */
+    readonly PENDING_PERMISSION_REQUEST: "pending_permission_request";
+    /** Session collaboration mode ('solo' | 'team') */
+    readonly COLLABORATION_MODE: "collaboration_mode";
+    /** User/session route preference override ('auto' | 'direct' | 'hybrid' | 'delegate') */
+    readonly EXECUTION_ROUTE_OVERRIDE: "execution_route_override";
+    /** Active Leader/session progress plan (separate from PENDING_PLAN approval gate) */
+    readonly ACTIVE_PLAN: "active_plan";
+    /** Structured permission audit records for bypass/auto-approval decisions */
+    readonly PERMISSION_AUDIT_LOG: "permission_audit_log";
+    /** Kind of pending user input (message, plan_review, permission_request, etc.) */
+    readonly PENDING_USER_INPUT: "pending_user_input";
+    /** Structured user gate currently blocking or idling the leader */
+    readonly PENDING_USER_GATE: "pending_user_gate";
+    /** Custom role definitions */
+    readonly CUSTOM_ROLES: "custom_roles";
+    /** Leader route history */
+    readonly LEADER_ROUTE_HISTORY: "leader_route_history";
+    /** Leader selected skills history */
+    readonly LEADER_SELECTED_SKILLS_HISTORY: "leader_selected_skills_history";
+    /** Latest invisible understanding snapshot for this session */
+    readonly INTUITION_SNAPSHOT: "intuition_snapshot";
+    /** Active Bughunt DAG and finding ledger */
+    readonly BUGHUNT_LEDGER: "bughunt_ledger";
+    /**
+     * Leader context summary — plaintext extracted from the latest compression summary message.
+     * Written by ContextManager after each successful LLM compression.
+     * Read by AgentPool when building WorkerTaskPayload to give workers leader context.
+     */
+    readonly LEADER_CONTEXT_SUMMARY: "leader_context_summary";
+    /** Current model ID for this session (written by LeaderAgent.setModel) */
+    readonly CURRENT_MODEL: "current_model";
+    /** Current default Agent model ID for this session (written by SessionManagerRuntime.setAgentModel) */
+    readonly CURRENT_AGENT_MODEL: "current_agent_model";
+    /** Active team name (set by Leader when calling team_manage(action="create")) */
+    readonly LEADER_ACTIVE_TEAM: "leader_active_team";
+    /** Bughunt mode flag ('true' | 'false') */
+    readonly BUGHUNT_MODE_ACTIVE: "bughunt_mode_active";
+    /** Office mode flag ('true' | 'false') */
+    readonly OFFICE_MODE_ACTIVE: "office_mode_active";
+    /** Workflow mode flag ('true' | 'false') — 控制 workflow_* 工具是否注入到 Leader/Worker */
+    readonly WORKFLOW_MODE_ACTIVE: "workflow_mode_active";
+    /** Pending plan content awaiting user approval */
+    readonly PENDING_PLAN: "pending_plan";
+    /** Latest scratchpad review digest fingerprint (Leader only) */
+    readonly LEADER_LAST_SCRATCHPAD_REVIEW_DIGEST: "leader_last_scratchpad_review_digest";
+    /** EternalLoop patrol interval (ms) */
+    readonly ETERNAL_PATROL_INTERVAL: "eternal_patrol_interval";
+    /** EternalLoop consecutive idle patrol count */
+    readonly ETERNAL_IDLE_PATROL_COUNT: "eternal_idle_patrol_count";
+    /** EternalLoop last patrol timestamp (epoch ms) */
+    readonly ETERNAL_LAST_PATROL_AT: "eternal_last_patrol_at";
+    /** EternalLoop current hourly token window usage */
+    readonly ETERNAL_WINDOW_TOKENS: "eternal_window_tokens";
+    /** EternalLoop configured hourly token budget */
+    readonly ETERNAL_TOKEN_BUDGET_PER_HOUR: "eternal_token_budget_per_hour";
+    /** EternalLoop current token window start timestamp (epoch ms) */
+    readonly ETERNAL_WINDOW_START_MS: "eternal_window_start_ms";
+    /** EternalLoop consecutive API failure count */
+    readonly ETERNAL_API_FAILURE_COUNT: "eternal_api_failure_count";
+    /** EternalLoop circuit breaker open-until timestamp (epoch ms) */
+    readonly ETERNAL_CIRCUIT_OPEN_UNTIL: "eternal_circuit_open_until";
+    /** EternalLoop total patrol count */
+    readonly ETERNAL_TOTAL_PATROLS: "eternal_total_patrols";
+    /** EternalLoop silence lock flag */
+    readonly ETERNAL_SILENCE_LOCK_ENGAGED: "eternal_silence_lock_engaged";
+    /** EternalLoop last patrol outcome */
+    readonly ETERNAL_LAST_PATROL_OUTCOME: "eternal_last_patrol_outcome";
+    /** EternalLoop worker completion count used in fingerprint */
+    readonly ETERNAL_WORKER_COMPLETION_COUNT: "eternal_worker_completion_count";
+    /** EternalLoop last real project fingerprint */
+    readonly ETERNAL_LAST_FINGERPRINT: "eternal_last_fingerprint";
+    /** User-directed persistent Eternal goal */
+    readonly ETERNAL_GOAL: "eternal_goal";
+    /** Current Leader autonomy control mode ('manual' | 'eternal') */
+    readonly CONTROL_MODE: "control_mode";
+    /** Metadata for side conversations linked to a parent thread */
+    readonly SIDE_THREAD_META: "side_thread:meta";
+    /** Global web channel records */
+    readonly GLOBAL_CHANNELS: "global:channels";
+    /** Fork metadata: parent session ID and fork point */
+    readonly FORK_PARENT_SESSION_ID: "fork:parent_session";
+    /** Active project blueprint (project_type + standard subsystems + coverage taskIds) — serialized ProjectBlueprint JSON */
+    readonly PROJECT_BLUEPRINT: "project_blueprint";
+    /** Current user turn capability intent profile; serialized CapabilityIntentProfile JSON. */
+    readonly CAPABILITY_INTENT_PROFILE: "capability_intent_profile";
+    /** Turn id for which CAPABILITY_INTENT_PROFILE was recorded; prevents repeat record loops. */
+    readonly CAPABILITY_INTENT_TURN_ID: "capability_intent_turn_id";
+    /** Current user turn id, incremented when Leader accepts a user message. */
+    readonly CURRENT_USER_TURN_ID: "current_user_turn_id";
+    /** Pending flag set by runtime when the just-arrived user input explicitly forbids tool calls. */
+    readonly TOOL_USE_SUPPRESSION_PENDING: "tool_use_suppression_pending";
+    /** Current user turn id for which all Leader tool calls must be hidden/skipped. */
+    readonly TOOL_USE_SUPPRESSION_TURN_ID: "tool_use_suppression_turn_id";
+    /** Latest structured autonomy gate decision trace for Web/TUI audit. */
+    readonly AUTONOMY_DECISION_TRACE: "autonomy_decision_trace";
+    /**
+     * AutonomyMode for the current session — serialized JSON of one of
+     * 'review_first' | 'balanced' | 'autonomous'. Default value is 'balanced'
+     * (see `DEFAULT_AUTONOMY_MODE` in `contracts/types/Autonomy.ts`). Orthogonal
+     * to PermissionMode; high autonomy does NOT bypass dangerous/scope/loop gates.
+     */
+    readonly AUTONOMY_MODE: "autonomy_mode";
+    /** Autonomy Governor lifecycle phase: bootstrap | active | recovery | stable. */
+    readonly AUTONOMY_LIFECYCLE_PHASE: "autonomy_lifecycle_phase";
+    /** Monotonic generation incremented whenever autonomy policy changes. */
+    readonly AUTONOMY_MODE_GENERATION: "autonomy_mode_generation";
+    /** Effective autonomy policy id used by prompt/runtime/UI audit. */
+    readonly AUTONOMY_POLICY_ID: "autonomy_policy_id";
+    /** Stable hash of the effective autonomy policy card/summary. */
+    readonly AUTONOMY_POLICY_HASH: "autonomy_policy_hash";
+    /** Last autonomy update actor: web | tui | leader | runtime_policy. */
+    readonly AUTONOMY_UPDATED_BY: "autonomy_updated_by";
+    /** Optional human-readable reason for the last autonomy update. */
+    readonly AUTONOMY_UPDATE_REASON: "autonomy_update_reason";
+};
+/** All known session_state key prefixes for namespace validation */
+export declare const SESSION_KEY_PREFIXES: readonly ["leader_", "intuition_", "tool_", "pending_", "collaboration_", "execution_route_", "active_plan", "custom_", "runtime_recovery:", "context_runtime:", "agent_checkpoint:", "bughunt_", "eternal_", "orchestration_runtime:", "current_model", "current_user_turn_id", "current_agent_model", "control_mode", "side_thread:", "global:", "config:", "office_", "workflow_", "findings", "running", "fork:", "project_blueprint", "capability_intent_", "autonomy_"];
+//# sourceMappingURL=SessionStateKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStateKeys.d.ts","sourceRoot":"","sources":["../../src/core/SessionStateKeys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY;IACvB,sEAAsE;;IAEtE,+BAA+B;;IAE/B,yCAAyC;;IAEzC,oCAAoC;;IAEpC,4CAA4C;;IAE5C,uCAAuC;;IAEvC,sEAAsE;;IAEtE,mDAAmD;;IAEnD,yFAAyF;;IAEzF,qFAAqF;;IAErF,6EAA6E;;IAE7E,kFAAkF;;IAElF,mEAAmE;;IAEnE,8BAA8B;;IAE9B,2BAA2B;;IAE3B,qCAAqC;;IAErC,+DAA+D;;IAE/D,4CAA4C;;IAE5C;;;;OAIG;;IAEH,0EAA0E;;IAE1E,uGAAuG;;IAEvG,iFAAiF;;IAEjF,2CAA2C;;IAE3C,0CAA0C;;IAE1C,kFAAkF;;IAElF,kDAAkD;;IAElD,gEAAgE;;IAEhE,uCAAuC;;IAEvC,gDAAgD;;IAEhD,mDAAmD;;IAEnD,oDAAoD;;IAEpD,iDAAiD;;IAEjD,kEAAkE;;IAElE,gDAAgD;;IAEhD,kEAAkE;;IAElE,qCAAqC;;IAErC,oCAAoC;;IAEpC,sCAAsC;;IAEtC,8DAA8D;;IAE9D,gDAAgD;;IAEhD,4CAA4C;;IAE5C,kEAAkE;;IAElE,gEAAgE;;IAEhE,iCAAiC;;IAEjC,sDAAsD;;IAEtD,0HAA0H;;IAE1H,4FAA4F;;IAE5F,8FAA8F;;IAE9F,4EAA4E;;IAE5E,kGAAkG;;IAElG,mFAAmF;;IAEnF,wEAAwE;;IAExE;;;;;OAKG;;IAEH,iFAAiF;;IAEjF,yEAAyE;;IAEzE,oEAAoE;;IAEpE,iEAAiE;;IAEjE,uEAAuE;;IAEvE,mEAAmE;;CAE3D,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,+cA8BvB,CAAC"}

package/dist/core/SessionStateKeys.js

@@ -0,0 +1,168 @@
+/**
+ * Session state key constants
+ *
+ * All string keys used with db.getSessionState() / db.setSessionState()
+ * are centralized here to prevent typos and duplication.
+ */
+export const SESSION_KEYS = {
+    /** Whether the leader is waiting for user input ('true' | 'false') */
+    LEADER_WAITING_FOR_USER: 'leader_waiting_for_user',
+    /** Pending plan review flag */
+    LEADER_PENDING_REVIEW: 'leader_pending_review',
+    /** Whether the plan has been approved */
+    LEADER_PLAN_APPROVED: 'leader_plan_approved',
+    /** Current leader execution mode */
+    LEADER_EXECUTION_MODE: 'leader_execution_mode',
+    /** Reason for the current execution mode */
+    LEADER_EXECUTION_REASON: 'leader_execution_reason',
+    /** Serialized ToolPermissionContext */
+    TOOL_PERMISSION_CONTEXT: 'tool_permission_context',
+    /** Serialized PermissionRequestPayload when awaiting user approval */
+    PENDING_PERMISSION_REQUEST: 'pending_permission_request',
+    /** Session collaboration mode ('solo' | 'team') */
+    COLLABORATION_MODE: 'collaboration_mode',
+    /** User/session route preference override ('auto' | 'direct' | 'hybrid' | 'delegate') */
+    EXECUTION_ROUTE_OVERRIDE: 'execution_route_override',
+    /** Active Leader/session progress plan (separate from PENDING_PLAN approval gate) */
+    ACTIVE_PLAN: 'active_plan',
+    /** Structured permission audit records for bypass/auto-approval decisions */
+    PERMISSION_AUDIT_LOG: 'permission_audit_log',
+    /** Kind of pending user input (message, plan_review, permission_request, etc.) */
+    PENDING_USER_INPUT: 'pending_user_input',
+    /** Structured user gate currently blocking or idling the leader */
+    PENDING_USER_GATE: 'pending_user_gate',
+    /** Custom role definitions */
+    CUSTOM_ROLES: 'custom_roles',
+    /** Leader route history */
+    LEADER_ROUTE_HISTORY: 'leader_route_history',
+    /** Leader selected skills history */
+    LEADER_SELECTED_SKILLS_HISTORY: 'leader_selected_skills_history',
+    /** Latest invisible understanding snapshot for this session */
+    INTUITION_SNAPSHOT: 'intuition_snapshot',
+    /** Active Bughunt DAG and finding ledger */
+    BUGHUNT_LEDGER: 'bughunt_ledger',
+    /**
+     * Leader context summary — plaintext extracted from the latest compression summary message.
+     * Written by ContextManager after each successful LLM compression.
+     * Read by AgentPool when building WorkerTaskPayload to give workers leader context.
+     */
+    LEADER_CONTEXT_SUMMARY: 'leader_context_summary',
+    /** Current model ID for this session (written by LeaderAgent.setModel) */
+    CURRENT_MODEL: 'current_model',
+    /** Current default Agent model ID for this session (written by SessionManagerRuntime.setAgentModel) */
+    CURRENT_AGENT_MODEL: 'current_agent_model',
+    /** Active team name (set by Leader when calling team_manage(action="create")) */
+    LEADER_ACTIVE_TEAM: 'leader_active_team',
+    /** Bughunt mode flag ('true' | 'false') */
+    BUGHUNT_MODE_ACTIVE: 'bughunt_mode_active',
+    /** Office mode flag ('true' | 'false') */
+    OFFICE_MODE_ACTIVE: 'office_mode_active',
+    /** Workflow mode flag ('true' | 'false') — 控制 workflow_* 工具是否注入到 Leader/Worker */
+    WORKFLOW_MODE_ACTIVE: 'workflow_mode_active',
+    /** Pending plan content awaiting user approval */
+    PENDING_PLAN: 'pending_plan',
+    /** Latest scratchpad review digest fingerprint (Leader only) */
+    LEADER_LAST_SCRATCHPAD_REVIEW_DIGEST: 'leader_last_scratchpad_review_digest',
+    /** EternalLoop patrol interval (ms) */
+    ETERNAL_PATROL_INTERVAL: 'eternal_patrol_interval',
+    /** EternalLoop consecutive idle patrol count */
+    ETERNAL_IDLE_PATROL_COUNT: 'eternal_idle_patrol_count',
+    /** EternalLoop last patrol timestamp (epoch ms) */
+    ETERNAL_LAST_PATROL_AT: 'eternal_last_patrol_at',
+    /** EternalLoop current hourly token window usage */
+    ETERNAL_WINDOW_TOKENS: 'eternal_window_tokens',
+    /** EternalLoop configured hourly token budget */
+    ETERNAL_TOKEN_BUDGET_PER_HOUR: 'eternal_token_budget_per_hour',
+    /** EternalLoop current token window start timestamp (epoch ms) */
+    ETERNAL_WINDOW_START_MS: 'eternal_window_start_ms',
+    /** EternalLoop consecutive API failure count */
+    ETERNAL_API_FAILURE_COUNT: 'eternal_api_failure_count',
+    /** EternalLoop circuit breaker open-until timestamp (epoch ms) */
+    ETERNAL_CIRCUIT_OPEN_UNTIL: 'eternal_circuit_open_until',
+    /** EternalLoop total patrol count */
+    ETERNAL_TOTAL_PATROLS: 'eternal_total_patrols',
+    /** EternalLoop silence lock flag */
+    ETERNAL_SILENCE_LOCK_ENGAGED: 'eternal_silence_lock_engaged',
+    /** EternalLoop last patrol outcome */
+    ETERNAL_LAST_PATROL_OUTCOME: 'eternal_last_patrol_outcome',
+    /** EternalLoop worker completion count used in fingerprint */
+    ETERNAL_WORKER_COMPLETION_COUNT: 'eternal_worker_completion_count',
+    /** EternalLoop last real project fingerprint */
+    ETERNAL_LAST_FINGERPRINT: 'eternal_last_fingerprint',
+    /** User-directed persistent Eternal goal */
+    ETERNAL_GOAL: 'eternal_goal',
+    /** Current Leader autonomy control mode ('manual' | 'eternal') */
+    CONTROL_MODE: 'control_mode',
+    /** Metadata for side conversations linked to a parent thread */
+    SIDE_THREAD_META: 'side_thread:meta',
+    /** Global web channel records */
+    GLOBAL_CHANNELS: 'global:channels',
+    /** Fork metadata: parent session ID and fork point */
+    FORK_PARENT_SESSION_ID: 'fork:parent_session',
+    /** Active project blueprint (project_type + standard subsystems + coverage taskIds) — serialized ProjectBlueprint JSON */
+    PROJECT_BLUEPRINT: 'project_blueprint',
+    /** Current user turn capability intent profile; serialized CapabilityIntentProfile JSON. */
+    CAPABILITY_INTENT_PROFILE: 'capability_intent_profile',
+    /** Turn id for which CAPABILITY_INTENT_PROFILE was recorded; prevents repeat record loops. */
+    CAPABILITY_INTENT_TURN_ID: 'capability_intent_turn_id',
+    /** Current user turn id, incremented when Leader accepts a user message. */
+    CURRENT_USER_TURN_ID: 'current_user_turn_id',
+    /** Pending flag set by runtime when the just-arrived user input explicitly forbids tool calls. */
+    TOOL_USE_SUPPRESSION_PENDING: 'tool_use_suppression_pending',
+    /** Current user turn id for which all Leader tool calls must be hidden/skipped. */
+    TOOL_USE_SUPPRESSION_TURN_ID: 'tool_use_suppression_turn_id',
+    /** Latest structured autonomy gate decision trace for Web/TUI audit. */
+    AUTONOMY_DECISION_TRACE: 'autonomy_decision_trace',
+    /**
+     * AutonomyMode for the current session — serialized JSON of one of
+     * 'review_first' | 'balanced' | 'autonomous'. Default value is 'balanced'
+     * (see `DEFAULT_AUTONOMY_MODE` in `contracts/types/Autonomy.ts`). Orthogonal
+     * to PermissionMode; high autonomy does NOT bypass dangerous/scope/loop gates.
+     */
+    AUTONOMY_MODE: 'autonomy_mode',
+    /** Autonomy Governor lifecycle phase: bootstrap | active | recovery | stable. */
+    AUTONOMY_LIFECYCLE_PHASE: 'autonomy_lifecycle_phase',
+    /** Monotonic generation incremented whenever autonomy policy changes. */
+    AUTONOMY_MODE_GENERATION: 'autonomy_mode_generation',
+    /** Effective autonomy policy id used by prompt/runtime/UI audit. */
+    AUTONOMY_POLICY_ID: 'autonomy_policy_id',
+    /** Stable hash of the effective autonomy policy card/summary. */
+    AUTONOMY_POLICY_HASH: 'autonomy_policy_hash',
+    /** Last autonomy update actor: web | tui | leader | runtime_policy. */
+    AUTONOMY_UPDATED_BY: 'autonomy_updated_by',
+    /** Optional human-readable reason for the last autonomy update. */
+    AUTONOMY_UPDATE_REASON: 'autonomy_update_reason',
+};
+/** All known session_state key prefixes for namespace validation */
+export const SESSION_KEY_PREFIXES = [
+    'leader_',
+    'intuition_',
+    'tool_',
+    'pending_',
+    'collaboration_', // written by mode split collaboration controls
+    'execution_route_', // written by route preference controls
+    'active_plan', // written by Active Plan tools
+    'custom_',
+    'runtime_recovery:', // written by RecoveryRecords
+    'context_runtime:', // written by ContextRuntimeState
+    'agent_checkpoint:', // written by ResumeManager
+    'bughunt_',
+    'eternal_', // written by EternalLoop
+    'orchestration_runtime:', // written by OrchestrationRuntime
+    'current_model', // written by LeaderAgent.setModel()
+    'current_user_turn_id', // written by LeaderAgent when accepting a user turn
+    'current_agent_model', // written by SessionManagerRuntime.setAgentModel()
+    'control_mode', // written by LeaderAgent.setControlMode()
+    'side_thread:', // written by SessionRoutes side-thread creation
+    'global:', // global pseudo-session state
+    'config:', // web/ACP session config options
+    'office_', // office mode flags
+    'workflow_', // workflow mode flag
+    'findings', // shared findings list
+    'running', // approval/runtime marker
+    'fork:', // fork metadata
+    'project_blueprint', // written by define_project_blueprint
+    'capability_intent_', // written by record_capability_intent
+    'autonomy_', // written by Autonomy Governor state/gate/policy manager
+];
+//# sourceMappingURL=SessionStateKeys.js.map

package/dist/core/SessionStateKeys.js.map

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

package/dist/core/SharedLedger.d.ts

@@ -0,0 +1,98 @@
+/**
+ * SharedLedger — 会话级共享账本
+ *
+ * 替代 BlackboardGraph 的轻量共享状态。核心概念：
+ * - append-only 类型化条目列表
+ * - 按 type + surface 索引
+ * - supersedes 机制处理更新（旧条目不删，新条目标记替代）
+ * - Leader 注入策略：constraint/decision 永不裁剪；finding/contract 按需查询
+ *
+ * 四个痛点对应：
+ * 1. 跨 worker 共享：worker 启动注入相关条目 + 运行中 read_ledger 查询
+ * 2. 长会话防遗忘：constraint + decision 在 compaction 时保留
+ * 3. 契约对齐：type=contract 按 surface 索引，前后端 worker 看同一份
+ * 4. 进度可审计：每条有 author + evidence + timestamp
+ */
+export type LedgerEntryType = 'decision' | 'contract' | 'finding' | 'constraint';
+export interface LedgerEntry {
+    /** 自增 ID: L-1, L-2, ... */
+    id: string;
+    /** 条目类型 */
+    type: LedgerEntryType;
+    /** 稳定索引键，如 "POST /api/users" 或 "tech-stack" 或 "db-schema" */
+    surface: string;
+    /** 写入者: "leader" | worker name */
+    author: string;
+    /** 正文 (markdown) */
+    content: string;
+    /** 证据引用: 文件路径、task_id、URL */
+    evidence?: string[];
+    /** 如果更新了旧条目，指向被替代的 id */
+    supersedes?: string;
+    /** 创建时间 */
+    createdAt: number;
+}
+export interface LedgerQuery {
+    type?: LedgerEntryType | LedgerEntryType[];
+    surface?: string;
+    author?: string;
+    /** 只返回最新版本（supersedes 链的头部） */
+    latestOnly?: boolean;
+    limit?: number;
+}
+export interface LedgerSnapshot {
+    entries: LedgerEntry[];
+    version: number;
+}
+export declare class SharedLedger {
+    private entries;
+    private nextId;
+    private version;
+    /**
+     * 追加条目。返回新条目 ID。
+     */
+    append(input: Omit<LedgerEntry, 'id' | 'createdAt'>): string;
+    /**
+     * 更新条目（追加新版本，标记 supersedes 旧版本）。
+     */
+    update(surface: string, type: LedgerEntryType, input: {
+        author: string;
+        content: string;
+        evidence?: string[];
+    }): string;
+    /**
+     * 查询条目
+     */
+    query(q?: LedgerQuery): LedgerEntry[];
+    /**
+     * 获取所有 constraint + decision（用于 Leader compaction-safe slot）
+     */
+    getCompactionSafeEntries(): LedgerEntry[];
+    /**
+     * 获取按 surface 最新版本的 contract 条目（用于 worker 启动注入）
+     */
+    getActiveContracts(): LedgerEntry[];
+    /**
+     * 获取与指定 surfaces 相关的所有最新条目（用于 worker context 注入）
+     */
+    getRelevantEntries(surfaces: string[]): LedgerEntry[];
+    /**
+     * 格式化为 markdown（注入 LLM context 用）
+     */
+    formatForContext(entries: LedgerEntry[]): string;
+    /** 导出快照（用于持久化） */
+    snapshot(): LedgerSnapshot;
+    /** 从快照恢复 */
+    restore(snapshot: LedgerSnapshot): void;
+    get size(): number;
+    get currentVersion(): number;
+    /**
+     * 获取某 surface + type 的最新条目
+     */
+    private getLatestBySurface;
+    /**
+     * 过滤出每个 surface+type 的最新版本（排除被 supersedes 的旧条目）
+     */
+    private filterLatest;
+}
+//# sourceMappingURL=SharedLedger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SharedLedger.d.ts","sourceRoot":"","sources":["../../src/core/SharedLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;IAEpB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,MAAM;IAY5D;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM;IAavH;;OAEG;IACH,KAAK,CAAC,CAAC,GAAE,WAAgB,GAAG,WAAW,EAAE;IAuBzC;;OAEG;IACH,wBAAwB,IAAI,WAAW,EAAE;IAMzC;;OAEG;IACH,kBAAkB,IAAI,WAAW,EAAE;IAMnC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IAQrD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM;IAchD,kBAAkB;IAClB,QAAQ,IAAI,cAAc;IAI1B,YAAY;IACZ,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAQvC,IAAI,IAAI,IAAI,MAAM,CAAgC;IAClD,IAAI,cAAc,IAAI,MAAM,CAAyB;IAErD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}

package/dist/core/SharedLedger.js

@@ -0,0 +1,145 @@
+/**
+ * SharedLedger — 会话级共享账本
+ *
+ * 替代 BlackboardGraph 的轻量共享状态。核心概念：
+ * - append-only 类型化条目列表
+ * - 按 type + surface 索引
+ * - supersedes 机制处理更新（旧条目不删，新条目标记替代）
+ * - Leader 注入策略：constraint/decision 永不裁剪；finding/contract 按需查询
+ *
+ * 四个痛点对应：
+ * 1. 跨 worker 共享：worker 启动注入相关条目 + 运行中 read_ledger 查询
+ * 2. 长会话防遗忘：constraint + decision 在 compaction 时保留
+ * 3. 契约对齐：type=contract 按 surface 索引，前后端 worker 看同一份
+ * 4. 进度可审计：每条有 author + evidence + timestamp
+ */
+export class SharedLedger {
+    entries = [];
+    nextId = 1;
+    version = 0;
+    /**
+     * 追加条目。返回新条目 ID。
+     */
+    append(input) {
+        const id = `L-${this.nextId++}`;
+        const entry = {
+            ...input,
+            id,
+            createdAt: Date.now(),
+        };
+        this.entries.push(entry);
+        this.version++;
+        return id;
+    }
+    /**
+     * 更新条目（追加新版本，标记 supersedes 旧版本）。
+     */
+    update(surface, type, input) {
+        const existing = this.getLatestBySurface(surface, type);
+        const id = this.append({
+            type,
+            surface,
+            author: input.author,
+            content: input.content,
+            evidence: input.evidence,
+            supersedes: existing?.id,
+        });
+        return id;
+    }
+    /**
+     * 查询条目
+     */
+    query(q = {}) {
+        let results = [...this.entries];
+        if (q.type) {
+            const types = Array.isArray(q.type) ? q.type : [q.type];
+            results = results.filter(e => types.includes(e.type));
+        }
+        if (q.surface) {
+            const surf = q.surface.toLowerCase();
+            results = results.filter(e => e.surface.toLowerCase() === surf);
+        }
+        if (q.author) {
+            results = results.filter(e => e.author === q.author);
+        }
+        if (q.latestOnly) {
+            results = this.filterLatest(results);
+        }
+        if (q.limit && q.limit > 0) {
+            results = results.slice(-q.limit);
+        }
+        return results;
+    }
+    /**
+     * 获取所有 constraint + decision（用于 Leader compaction-safe slot）
+     */
+    getCompactionSafeEntries() {
+        return this.filterLatest(this.entries.filter(e => e.type === 'constraint' || e.type === 'decision'));
+    }
+    /**
+     * 获取按 surface 最新版本的 contract 条目（用于 worker 启动注入）
+     */
+    getActiveContracts() {
+        return this.filterLatest(this.entries.filter(e => e.type === 'contract'));
+    }
+    /**
+     * 获取与指定 surfaces 相关的所有最新条目（用于 worker context 注入）
+     */
+    getRelevantEntries(surfaces) {
+        if (surfaces.length === 0)
+            return [];
+        const normalized = new Set(surfaces.map(s => s.toLowerCase()));
+        return this.filterLatest(this.entries.filter(e => normalized.has(e.surface.toLowerCase())));
+    }
+    /**
+     * 格式化为 markdown（注入 LLM context 用）
+     */
+    formatForContext(entries) {
+        if (entries.length === 0)
+            return '';
+        const lines = ['## Shared Ledger'];
+        for (const e of entries) {
+            lines.push(`### [${e.type}] ${e.surface} (${e.id}, by ${e.author})`);
+            lines.push(e.content);
+            if (e.evidence && e.evidence.length > 0) {
+                lines.push(`_evidence: ${e.evidence.join(', ')}_`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /** 导出快照（用于持久化） */
+    snapshot() {
+        return { entries: [...this.entries], version: this.version };
+    }
+    /** 从快照恢复 */
+    restore(snapshot) {
+        this.entries = [...snapshot.entries];
+        this.version = snapshot.version;
+        this.nextId = this.entries.length > 0
+            ? Math.max(...this.entries.map(e => parseInt(e.id.replace('L-', ''), 10))) + 1
+            : 1;
+    }
+    get size() { return this.entries.length; }
+    get currentVersion() { return this.version; }
+    /**
+     * 获取某 surface + type 的最新条目
+     */
+    getLatestBySurface(surface, type) {
+        const surf = surface.toLowerCase();
+        const candidates = this.entries.filter(e => e.type === type && e.surface.toLowerCase() === surf);
+        return this.filterLatest(candidates)[0];
+    }
+    /**
+     * 过滤出每个 surface+type 的最新版本（排除被 supersedes 的旧条目）
+     */
+    filterLatest(entries) {
+        const superseded = new Set();
+        for (const e of entries) {
+            if (e.supersedes)
+                superseded.add(e.supersedes);
+        }
+        return entries.filter(e => !superseded.has(e.id));
+    }
+}
+//# sourceMappingURL=SharedLedger.js.map

package/dist/core/SharedLedger.js.map

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

package/dist/core/SkillCatalog.d.ts

@@ -0,0 +1,79 @@
+import type { DatabaseManager } from './Database.js';
+import { type SkillPhase } from './SkillPhaseLoader.js';
+export type SkillSource = 'project' | 'plugin' | 'global' | 'bundled';
+export interface SkillPluginProvenance {
+    id: string;
+    version: string;
+    path: string;
+}
+export interface SkillDescriptor {
+    name: string;
+    source: SkillSource;
+    path: string;
+    summary: string;
+    contentPreview: string;
+    plugin?: SkillPluginProvenance;
+}
+export interface SkillInjectionOptions {
+    maxTotalChars?: number;
+    maxPerSkillChars?: number;
+}
+export interface SkillCollectionOptions {
+    disabledNames?: string[];
+    disabledRefs?: string[];
+    maxActive?: number;
+}
+export interface InjectedSkillSection {
+    name: string;
+    source: SkillSource;
+    path: string;
+    summary: string;
+    plugin?: SkillPluginProvenance;
+    includedChars: number;
+    originalChars: number;
+    truncated: boolean;
+    body: string;
+}
+/** 分层技能描述符 — 包含 phases */
+export interface ExtendedSkillDescriptor extends SkillDescriptor {
+    phases: SkillPhase[];
+    hasQualityGates: boolean;
+}
+export interface SkillSurfaceItem {
+    id: string;
+    status?: string;
+    preview: string;
+    detail: string;
+}
+export interface SkillSourceCandidate {
+    dir: string;
+    source: SkillSource;
+    plugin?: SkillPluginProvenance;
+}
+export declare function getSkillSourceCandidates(workspace: string): SkillSourceCandidate[];
+export declare function formatSkillSourceLabel(source: SkillSource): string;
+export declare function getSkillDescriptorRef(skill: Pick<SkillDescriptor, 'name' | 'source' | 'plugin'>): string;
+export declare function resolveDisabledSkillNames(): string[];
+export declare function resolveDisabledSkillRefs(): string[];
+export declare function collectAvailableSkills(workspace: string, options?: SkillCollectionOptions): SkillDescriptor[];
+/**
+ * 获取技能的分层描述符 — 包含 phases/paradigms/principles/contracts
+ * 返回 null 表示该技能不存在
+ */
+export declare function getExtendedSkillDescriptor(workspace: string, skillName: string): ExtendedSkillDescriptor | null;
+export declare function getAvailableSkillEntries(workspace: string): Array<{
+    name: string;
+    source: string;
+    desc: string;
+}>;
+export declare function buildSkillSurfaceItems(workspace: string): SkillSurfaceItem[];
+export declare function buildRoleSkillSurfaceItems(db: Pick<DatabaseManager, 'getSessionState'> | undefined, sessionId: string): SkillSurfaceItem[];
+export declare function buildSkillDigest(skills: SkillDescriptor[]): string;
+export declare function parseExplicitSkillMentions(text: string): string[];
+export declare function resolveExplicitSkillMentions(text: string, skills: SkillDescriptor[]): string[];
+export declare function buildSkillInjection(skillNames: string[], skills: SkillDescriptor[], options?: SkillInjectionOptions): {
+    names: string[];
+    sections: InjectedSkillSection[];
+    content: string;
+};
+//# sourceMappingURL=SkillCatalog.d.ts.map