@router-agent/core 0.0.0-stage → 0.3.31

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 跨包共享的配置视图。
+ *
+ * 应用侧 `src/config.ts` 里的 AppConfig 属于装配层，适配器包不应该反向依赖它；
+ * 这里只放适配器真正需要的、稳定的字段形状，AppConfig 结构上天然兼容。
+ */
+/** 群级准入配置：适配器只关心「哪些群、什么接收方式、名单是谁」。 */
+export interface ChatAdmissionSettings {
+    chat: string;
+    /** all：全部消息，且不 @ 也会回复；mention：只收 @机器人。 */
+    mode: 'all' | 'mention';
+    /** 本群只允许这些 open_id 操作；空表示沿用全局名单。 */
+    allowed: string[];
+    /** 需求分析助手的终审管理员；邮箱或 open_id。 */
+    intake?: {
+        approvers?: string[];
+    };
+}
+/** worker 运行时选项：`runtime.options.<runtimeId>.<key>`。 */
+export interface RuntimeSettingsView {
+    default: string;
+    options?: Record<string, unknown>;
+    /** 运行时插件入口：id → npm 包名 / 本地路径 / 目录。 */
+    plugins?: Record<string, unknown>;
+}
+/** 运行时装配用到的配置视图；AppConfig 结构上兼容。 */
+export interface RuntimeConfigView {
+    runtime: RuntimeSettingsView;
+}
+/** 通道装配用到的配置视图；AppConfig 结构上兼容。 */
+export interface ChannelConfigView {
+    /** 通道插件入口：id → npm 包名 / 本地路径 / 目录。 */
+    channels?: Record<string, unknown>;
+    feishu: {
+        appId: string;
+        allowed: string[];
+        chats: ChatAdmissionSettings[];
+        directMessages: boolean;
+        botOpenIds: string[];
+        botNames: string[];
+    };
+}

package/dist/config.js

@@ -0,0 +1,8 @@
+/**
+ * 跨包共享的配置视图。
+ *
+ * 应用侧 `src/config.ts` 里的 AppConfig 属于装配层，适配器包不应该反向依赖它；
+ * 这里只放适配器真正需要的、稳定的字段形状，AppConfig 结构上天然兼容。
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+/** 结构化日志事件：由内核/队列/API 发出，由 CLI 统一落盘。 */
+export interface LogEvent {
+    event: string;
+    [key: string]: unknown;
+}
+export type EventSink = (event: LogEvent) => void;
+/** 截断长文本，日志里保留可读的片段而不刷屏。 */
+export declare function preview(value: unknown, max?: number): string;
+export declare function noopSink(_event: LogEvent): void;

package/dist/events.js

@@ -0,0 +1,10 @@
+/** 截断长文本，日志里保留可读的片段而不刷屏。 */
+export function preview(value, max = 160) {
+    const text = typeof value === 'string' ? value : String(value ?? '');
+    const single = text.replace(/\s+/g, ' ').trim();
+    return single.length > max ? `${single.slice(0, max)}…` : single;
+}
+export function noopSink(_event) {
+    // 未注入日志实现时什么都不做
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../packages/core/src/events.ts"],"names":[],"mappings":"AAQA,4BAA4B;AAC5B,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,GAAG,GAAG,GAAG;IAC/C,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC/C,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAgB;IACvC,gBAAgB;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './model.js';
+export * from './policy.js';
+export * from './stage.js';
+export * from './events.js';
+export * from './config.js';
+export * from './pr.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './model.js';
+export * from './policy.js';
+export * from './stage.js';
+export * from './events.js';
+export * from './config.js';
+export * from './pr.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA"}

package/dist/model.d.ts

@@ -0,0 +1,261 @@
+/** 领域内核的实体与取值定义。所有模块共用这里的词汇。 */
+/** Router 对一个 Trigger 的四种决定。 */
+export type Decision = 'accept' | 'stop' | 'ignore' | 'unavailable';
+/** 决定的依据强度：显式（@bot / 直接指派）或推断（LLM 研判）。 */
+export type Strength = 'explicit' | 'inferred';
+/** 工单阶段（五种）：待办 / 进行中 / 审核中 / 已阻塞 / 已完成。 */
+export type Stage = 'todo' | 'running' | 'review' | 'blocked' | 'done';
+/** Worker 上报的六种状态。 */
+export type ReportState = 'progress' | 'waiting' | 'ready' | 'blocked' | 'failed' | 'dropped';
+/** Source 种类：内置飞书与 GitHub PR 跟踪；自定义通道可以写自己的来源名。 */
+export type SourceKind = string;
+/** 一条消息的寻址方式。 */
+export type AddressMode = 'mention' | 'direct' | 'none';
+export type TriggerDisposition = 'pending' | 'evaluating' | 'filtered' | 'evaluated' | 'fanned_out' | 'owned';
+/**
+ * Router 落盘到本机的原始附件。
+ * 目前只有飞书图片；派工/追问时把本地路径透传给 Worker，让它直接看原图。
+ */
+export interface Attachment {
+    /** Router 本机绝对路径。 */
+    path: string;
+    /** image/png、image/jpeg 等，供 Worker 判断文件类型。 */
+    mimeType: string;
+    /** 是否来自被引用的消息。 */
+    quoted?: boolean;
+}
+export interface Trigger {
+    id: string;
+    source: SourceKind;
+    /**
+     * 通道实例 ID（一期固定 feishu）。
+     * 历史数据没有该字段时按 DEFAULT_CHANNEL_ID 兜底，见 channels/port.ts。
+     */
+    channelId?: string;
+    /** Source 自己的事件 ID，用于幂等。 */
+    externalId: string;
+    threadId: string;
+    /**
+     * 这条消息携带的全部外部线程标识：话题 ID（omt_）、根消息 ID（om_）、消息自身 ID。
+     * 飞书在不同客户端入口给不全字段（话题面板直发只有 thread_id），
+     * Store 靠这组别名把同一话题的消息解析到同一个 Thread。见 Store.resolveThread。
+     */
+    threadKeys?: string[];
+    /** 飞书 chat_id 或 GitHub owner/repo#number。 */
+    chatId: string;
+    chatName: string;
+    actorId: string;
+    actorName: string;
+    isBot: boolean;
+    text: string;
+    addressed: AddressMode;
+    /**
+     * 这条消息没有 @ 机器人，但因「话题已绑定在办工单 + 发送者在允许名单」而被放行（tk-59）。
+     *
+     * 放行不等于会被回复：准入 Gate 仍然可以把它拦掉。但一旦真的处理了，
+     * Router 就要加确认表情并给一句回执，否则用户只看到消息被吞掉。
+     */
+    unaddressedAdmitted?: boolean;
+    /** 纯附件消息（图片 / 文件 / 语音等）：正文只是占位文本，不能据此开工。 */
+    mediaOnly?: boolean;
+    receivedAt: string;
+    disposition: TriggerDisposition;
+    decisionId?: string;
+    /** Source 原始载荷，便于审计与回放。 */
+    raw?: unknown;
+}
+export interface Thread {
+    id: string;
+    source: SourceKind;
+    /** 通道实例 ID；历史线程没有该字段时按飞书兜底。 */
+    channelId?: string;
+    rootId: string;
+    chatId: string;
+    createdAt: string;
+}
+export interface Mandate {
+    id: string;
+    ticketId: string;
+    policyVersion: string;
+    strength: Strength;
+    /** 授权范围：一句话说明这份工作允许做什么。 */
+    scope: string;
+    /** 研判命中的策略规则名。 */
+    rules: string[];
+    actorId: string;
+    actorName: string;
+    source: SourceKind;
+    chatId: string;
+    threadId: string;
+    createdAt: string;
+}
+export interface Ticket {
+    id: string;
+    title: string;
+    threadId: string;
+    source: SourceKind;
+    /** 通道实例 ID（channels.<id>）；历史工单没有该字段时按飞书兜底。 */
+    channelId?: string;
+    chatId: string;
+    mandateId: string;
+    stage: Stage;
+    /** 派工目标仓库（Orca repo 选择器或项目名）；开单时必须明确。 */
+    repo: string;
+    /** 派工起始分支（worktree 的 base branch）；开单时必须明确。 */
+    branch: string;
+    /** 开单消息里随附的原始附件（Router 已落盘），派工时透传给 Worker。 */
+    attachments?: Attachment[];
+    prNumber: number;
+    prUrl: string;
+    prState: 'none' | 'open' | 'merged' | 'closed';
+    createdAt: string;
+    updatedAt: string;
+    closedAt?: string;
+}
+/**
+ * 一次尚未凑齐派工信息的对话草稿。
+ * Router 判断该开工但缺 repo / branch 时先落这里，等用户补齐后再开单。
+ */
+export interface DispatchDraft {
+    chatId: string;
+    threadId: string;
+    actorId: string;
+    /** 原始工作请求（多轮补齐时保持不变）。 */
+    task: string;
+    repo: string;
+    branch: string;
+    updatedAt: string;
+}
+export interface Assignment {
+    id: string;
+    ticketId: string;
+    runtimeId: string;
+    handle: string;
+    workdir: string;
+    status: 'pending' | 'running' | 'ended';
+    startedAt: string;
+    endedAt?: string;
+}
+export type InputKind = 'followup' | 'ci' | 'policy' | 'retry';
+export interface Input {
+    id: string;
+    ticketId: string;
+    assignmentId: string;
+    seq: number;
+    kind: InputKind;
+    text: string;
+    /**
+     * 来源标识：同一条外部消息只入库一次。
+     * 空表示没有可去重的来源（例如内部补的 retry 输入）。
+     */
+    sourceKey?: string;
+    /** expired：worker 在 ack 前就没了；不再重投，也不代表用户请求被完成。 */
+    status: 'pending' | 'delivered' | 'acked' | 'expired';
+    createdAt: string;
+    deliveredAt?: string;
+    ackedAt?: string;
+}
+export interface Report {
+    id: string;
+    ticketId: string;
+    assignmentId: string;
+    turn: number;
+    state: ReportState;
+    summary: string;
+    humanAction?: string;
+    prNumber?: number;
+    prUrl?: string;
+    /** Worker 要发给发起人的完整回复（Markdown）。里面可以有文档链接、PR 链接，Router 原样发送。 */
+    reply?: string;
+    ackedInputs: string[];
+    at: string;
+}
+export interface Subscription {
+    threadId: string;
+    ticketId: string;
+    /** 只提供上下文、不授予权限的订阅。 */
+    contextOnly: boolean;
+    createdAt: string;
+}
+export interface DecisionRecord {
+    id: string;
+    triggerId: string;
+    threadId: string;
+    decision: Decision;
+    strength: Strength;
+    reason: string;
+    policyVersion: string;
+    /** observe 模式下「本该接单」的标记。 */
+    wouldAccept: boolean;
+    createdAt: string;
+}
+export interface Channel {
+    kind: 'feishu' | 'github';
+    chatId: string;
+    /** 飞书 thread / 根消息 ID，用于话题回复。 */
+    threadId?: string;
+}
+/**
+ * 需求识别（intake）的状态。
+ *
+ * Router 只负责调度与流程收尾：初筛、追问、结构化整理全部交给 intake 分析引擎，
+ * 结构化结果必须经管理员终审（approved / rejected）才可能进入原有派单流程。
+ */
+export type IntakeStatus = 'clarifying' | 'ready' | 'approved' | 'rejected' | 'dismissed' | 'answered';
+/** 初筛结论：闲聊 / 普通咨询 / 疑似故障或需求。 */
+export type IntakeKind = 'chat' | 'question' | 'issue';
+/** 一条 intake 会话里的消息；Router 回复也记进来，供下一轮分析看到上下文。 */
+export interface IntakeTurn {
+    role: 'user' | 'router';
+    text: string;
+    at: string;
+    actorId?: string;
+}
+/** 分析引擎整理出的结构化需求单。 */
+export interface IntakeReport {
+    title: string;
+    /** 问题描述：用户实际遇到了什么。 */
+    problem: string;
+    /** 背景：什么场景下发生、影响谁。 */
+    background: string;
+    /** 复现步骤；收集不到时留空字符串，由 Router 标注「未收集到」。 */
+    steps: string;
+    /** 设备 / 账号 / 环境等信息。 */
+    environment: string;
+    /** 影响范围与严重程度。 */
+    impact: string;
+    /** 用户期望的结果。 */
+    expected: string;
+    /** 分析引擎判断的类型：操作问题 / 已知问题 / 疑似 BUG / 新需求。 */
+    assessment: string;
+}
+/**
+ * 一次需求识别会话。
+ *
+ * 与 Ticket 没有直接绑定：只有管理员终审通过后才通过 Engine.decide() 生成正式工单，
+ * 原有权限与派单体系保持不变。
+ */
+export interface Intake {
+    id: string;
+    threadId: string;
+    chatId: string;
+    /** 发起人：只有本人和管理员能推进这条 intake。 */
+    actorId: string;
+    actorName: string;
+    /** 群绑定项目名与仓库选择器；intake 仅读取这个项目的代码。 */
+    project: string;
+    repo: string;
+    branch: string;
+    status: IntakeStatus;
+    kind: IntakeKind;
+    /** 最初触发识别的原文。 */
+    rawText: string;
+    turns: IntakeTurn[];
+    report?: IntakeReport;
+    /** 已经追问过的轮数，用于防止无限对话。 */
+    questions: number;
+    /** 终审通过后生成的工单号。 */
+    ticketId?: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/model.js

@@ -0,0 +1,3 @@
+/** 领域内核的实体与取值定义。所有模块共用这里的词汇。 */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../packages/core/src/model.ts"],"names":[],"mappings":"AAAA,gCAAgC"}

package/dist/policy.d.ts

@@ -0,0 +1,96 @@
+import type { Decision, Mandate, Strength, Trigger } from './model.js';
+export type AcceptMode = 'off' | 'observe' | 'auto';
+/**
+ * worker 被服务重启打断后的恢复策略。
+ *
+ * auto：自动补一条输入让 worker 从中断处接着做。
+ * notify：只发飞书提醒，等用户回复才恢复。
+ * off：完全不处理。
+ */
+export type InterruptedRecoveryMode = 'auto' | 'notify' | 'off';
+/** 准入表：三列分别对应「名单内未寻址 / 名单外已寻址 / 名单外未寻址」。 */
+export interface AdmissionTable {
+    listedNotAddressed: 'inferred' | 'ignore';
+    unlistedAddressed: 'explicit' | 'inferred' | 'ignore';
+    unlistedNotAddressed: 'inferred' | 'ignore';
+}
+export interface Policy {
+    version: string;
+    acceptMode: AcceptMode;
+    maxWorkers: number;
+    /** 允许发起工作的原始条目（邮箱或 open_id）。 */
+    allowed: string[];
+    /** 名单条目解析出的 open_id；缺省时回退到 allowed（旧库兼容）。 */
+    allowedOpenIds?: string[];
+    /** 群级白名单：非空时该群只允许这些人操作，覆盖全局 allowed。 */
+    allowedByChat?: Record<string, string[]>;
+    /** 群级白名单解析出的 open_id；缺省时回退到 allowedByChat。 */
+    allowedByChatOpenIds?: Record<string, string[]>;
+    /** open_id → 通讯录显示名；只用于展示（喂给模型时写成「名字(ou_xxx)」），不参与匹配。 */
+    names?: Record<string, string>;
+    /** 允许产生推断候选的机器人身份。 */
+    bots: string[];
+    admission: AdmissionTable;
+    /** 该范围是否接收全部消息；false 表示只接收 @bot 与私聊。 */
+    receiveAll: boolean;
+}
+export type GateResult = {
+    action: 'explicit';
+    strength: Extract<Strength, 'explicit'>;
+} | {
+    action: 'infer';
+    strength: Extract<Strength, 'inferred'>;
+} | {
+    action: 'reply-only';
+    strength: Extract<Strength, 'inferred'>;
+    reason: string;
+} | {
+    action: 'ignore';
+    reason: string;
+};
+export declare const DEFAULT_ADMISSION: AdmissionTable;
+/**
+ * 生效的全局名单：优先用解析出的 open_id，没有解析结果时回退到原始条目
+ * （旧 `state.db` 里的 policy 行没有新字段，回退即旧行为）。
+ */
+export declare function effectiveAllowed(policy: Policy): string[];
+/**
+ * 生效的群级名单。
+ *
+ * 返回值有三种形态，调用方必须分清：
+ * - `undefined`：该群没配名单 → 沿用全局名单；
+ * - 非空数组：该群生效的 open_id 列表；
+ * - 空数组：配了名单但一个都没解析出来 → **该群拒绝所有人**，
+ *   绝不能退回全局名单（那比用户原意更宽松，是安全倒退）。
+ */
+export declare function effectiveAllowedByChat(policy: Policy, chatId: string): string[] | undefined;
+/**
+ * 三层路由的第一层：确定性 Gate。
+ * 不调用任何模型，只看名单、寻址方式、机器人名单与 accept mode。
+ */
+export declare function gate(trigger: Trigger, policy: Policy): GateResult;
+/**
+ * 是否给收到的消息加「收到」表情。
+ *
+ * 两个条件同时成立才加：
+ * 1. 确实在跟机器人说话：@ / 私聊，所在群配置为全量接收，
+ *    或未 @ 但因话题已绑定在办工单而被放行（tk-59）；
+ * 2. 准入 Gate 不会静默忽略：被群白名单拦截、`admission: ignore` 的消息不加。
+ *
+ * 否则用户会先看到「Typing」，然后永远等不到回复，表情也不会被撤销。
+ */
+export declare function shouldAcknowledge(trigger: Trigger, policy: Policy, replyAlwaysChats: ReadonlySet<string>): boolean;
+export interface Acceptance {
+    decision: Decision;
+    wouldAccept: boolean;
+}
+/** observe 模式下，推断候选的 accept 被降级为「记录但不开工」。 */
+export declare function negotiateAcceptance(decision: Decision, strength: Strength, mode: AcceptMode): Acceptance;
+export type Revalidation = {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};
+/** 工单恢复前对当前策略做重新校验；不主动撤销在途 Mandate。 */
+export declare function revalidateMandate(mandate: Mandate, policy: Policy): Revalidation;

package/dist/policy.js

@@ -0,0 +1,117 @@
+export const DEFAULT_ADMISSION = {
+    listedNotAddressed: 'inferred',
+    unlistedAddressed: 'inferred',
+    unlistedNotAddressed: 'ignore',
+};
+/**
+ * 生效的全局名单：优先用解析出的 open_id，没有解析结果时回退到原始条目
+ * （旧 `state.db` 里的 policy 行没有新字段，回退即旧行为）。
+ */
+export function effectiveAllowed(policy) {
+    return policy.allowedOpenIds ?? policy.allowed;
+}
+/**
+ * 生效的群级名单。
+ *
+ * 返回值有三种形态，调用方必须分清：
+ * - `undefined`：该群没配名单 → 沿用全局名单；
+ * - 非空数组：该群生效的 open_id 列表；
+ * - 空数组：配了名单但一个都没解析出来 → **该群拒绝所有人**，
+ *   绝不能退回全局名单（那比用户原意更宽松，是安全倒退）。
+ */
+export function effectiveAllowedByChat(policy, chatId) {
+    const scoped = policy.allowedByChat?.[chatId];
+    if (!scoped || scoped.length === 0)
+        return undefined;
+    return policy.allowedByChatOpenIds?.[chatId] ?? scoped;
+}
+/**
+ * 三层路由的第一层：确定性 Gate。
+ * 不调用任何模型，只看名单、寻址方式、机器人名单与 accept mode。
+ */
+export function gate(trigger, policy) {
+    const addressed = trigger.addressed !== 'none';
+    // 群级白名单：配置了就只认这一份，名单外的人在该群完全无效（不接单、不回复）。
+    const scoped = effectiveAllowedByChat(policy, trigger.chatId);
+    // 配了群名单但一个都没解析出来：这个群谁都不许进，也不能退回全局名单。
+    if (scoped && scoped.length === 0) {
+        return { action: 'ignore', reason: 'admission:chat-allowlist-empty' };
+    }
+    const listed = (scoped ?? effectiveAllowed(policy)).includes(trigger.actorId);
+    if (trigger.isBot) {
+        // 机器人永远不能构成显式请求：要么被列入 bots 成为推断候选，要么直接忽略。
+        if (!policy.bots.includes(trigger.actorId))
+            return { action: 'ignore', reason: 'bot:not-listed' };
+        if (!addressed && !policy.receiveAll)
+            return { action: 'ignore', reason: 'bot:not-receive-all' };
+        return applyAcceptMode({ action: 'infer', strength: 'inferred' }, policy);
+    }
+    if (scoped && !listed) {
+        return { action: 'ignore', reason: 'admission:not-in-chat-allowlist' };
+    }
+    // 设计文档 2.3：私聊 bot 进入研判，不构成显式授权；只有 @机器人 才是显式。
+    if (trigger.addressed === 'direct') {
+        return applyAcceptMode({ action: 'infer', strength: 'inferred' }, policy);
+    }
+    let cell;
+    if (addressed) {
+        cell = listed ? 'explicit' : policy.admission.unlistedAddressed;
+    }
+    else {
+        cell = listed ? policy.admission.listedNotAddressed : policy.admission.unlistedNotAddressed;
+    }
+    if (cell === 'ignore') {
+        return { action: 'ignore', reason: addressed ? 'admission:unlisted-addressed' : listed ? 'admission:listed-not-addressed' : 'admission:unlisted-not-addressed' };
+    }
+    if (cell === 'explicit')
+        return { action: 'explicit', strength: 'explicit' };
+    return applyAcceptMode({ action: 'infer', strength: 'inferred' }, policy);
+}
+/**
+ * 是否给收到的消息加「收到」表情。
+ *
+ * 两个条件同时成立才加：
+ * 1. 确实在跟机器人说话：@ / 私聊，所在群配置为全量接收，
+ *    或未 @ 但因话题已绑定在办工单而被放行（tk-59）；
+ * 2. 准入 Gate 不会静默忽略：被群白名单拦截、`admission: ignore` 的消息不加。
+ *
+ * 否则用户会先看到「Typing」，然后永远等不到回复，表情也不会被撤销。
+ */
+export function shouldAcknowledge(trigger, policy, replyAlwaysChats) {
+    const verdict = gate(trigger, policy);
+    // 未 @ 但被放行的消息（tk-59）Router 一定会处理（投给工单的 worker），表情必须跟着走，
+    // 否则用户只看到消息被吞掉：既没有确认表情，也等不到回执。
+    // 只放行「名单内未寻址」这一条 ignore——机器人、名单外成员、群名单为空等仍然拦。
+    if (trigger.unaddressedAdmitted && verdict.action === 'ignore' && verdict.reason === 'admission:listed-not-addressed')
+        return true;
+    if (trigger.addressed === 'none' && !trigger.unaddressedAdmitted && !replyAlwaysChats.has(trigger.chatId))
+        return false;
+    return verdict.action !== 'ignore';
+}
+function applyAcceptMode(result, policy) {
+    if (policy.acceptMode === 'off') {
+        return { action: 'reply-only', strength: 'inferred', reason: 'accept-mode:off' };
+    }
+    return result;
+}
+/** observe 模式下，推断候选的 accept 被降级为「记录但不开工」。 */
+export function negotiateAcceptance(decision, strength, mode) {
+    if (decision === 'accept' && strength === 'inferred' && mode === 'observe') {
+        return { decision: 'ignore', wouldAccept: true };
+    }
+    return { decision, wouldAccept: false };
+}
+/** 工单恢复前对当前策略做重新校验；不主动撤销在途 Mandate。 */
+export function revalidateMandate(mandate, policy) {
+    if (mandate.strength === 'explicit')
+        return { valid: true };
+    if (policy.acceptMode !== 'auto')
+        return { valid: false, reason: 'accept-mode:not-auto' };
+    // 名单改成邮箱后，这里必须按解析结果判定，否则在途工单会被判成 sender:not-allowed 直接失效。
+    const scoped = effectiveAllowedByChat(policy, mandate.chatId);
+    const allowed = scoped ?? effectiveAllowed(policy);
+    if (!allowed.includes(mandate.actorId))
+        return { valid: false, reason: 'sender:not-allowed' };
+    return { valid: true };
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/dist/pr.d.ts

@@ -0,0 +1,10 @@
+/** PR / MR 的中立视图；Router 跟踪与 UI 证据门禁共用。 */
+export interface PrInfo {
+    number: number;
+    url: string;
+    state: 'open' | 'merged' | 'closed';
+    title: string;
+    branch: string;
+    /** PR 描述正文；UI 证据门禁用它检查 Before / After。列表查询不返回时为 undefined。 */
+    body?: string;
+}

package/dist/pr.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pr.js.map

package/dist/pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.js","sourceRoot":"","sources":["../../../../packages/core/src/pr.ts"],"names":[],"mappings":""}

package/dist/stage.d.ts

@@ -0,0 +1,36 @@
+import type { Assignment, Report, Stage, Ticket } from './model.js';
+export interface StageInput {
+    ticket: Ticket;
+    assignment?: Assignment | null;
+    latestReport?: Report | null;
+    /** 是否存在等待人工回答的问题。 */
+    hasAttention?: boolean;
+}
+/**
+ * 五种工单阶段的展示顺序与中文名。
+ * 顺序即看板列顺序，也用于 CLI / 提示文案。
+ */
+export declare const STAGE_VALUES: readonly Stage[];
+export declare const STAGE_LABELS: Record<Stage, string>;
+/**
+ * 旧八阶段 → 新五阶段的映射。
+ * 同时用于两处：历史库读时兼容（不写库），以及 scripts/migrate-ticket-stages.mjs 的迁移。
+ * 注意：旧 `draft` / `accepted` 都并回「待办」，旧 `idle` 因为需要人工推动也并入「已阻塞」。
+ */
+export declare const LEGACY_STAGE_MAP: Readonly<Record<string, Stage>>;
+export declare function isStage(value: unknown): value is Stage;
+/** 把库里的阶段值归一化到新五阶段；未知值返回 null，交给调用方决定兜底。 */
+export declare function normalizeStage(value: unknown): Stage | null;
+/** 按新阶段查询时，需要一并匹配的旧阶段值（迁移执行前也能查全）。 */
+export declare function stageAliases(stage: Stage): string[];
+/**
+ * 由「工单 + 派工 + 最新报告」推导阶段。
+ * 自上而下判断，第一条命中的规则生效。
+ */
+export declare function computeStage(input: StageInput): Stage;
+/**
+ * 阶段迁移是否合法。
+ * 收敛到五种后不再表达细分流程：除「已完成」外，四个活跃阶段之间都可以互转；
+ * 「已完成」是终态，符合 PR 合并/关单后不可切回的既有约束。
+ */
+export declare function canTransition(from: Stage, to: Stage): boolean;

package/dist/stage.js

@@ -0,0 +1,89 @@
+/**
+ * 五种工单阶段的展示顺序与中文名。
+ * 顺序即看板列顺序，也用于 CLI / 提示文案。
+ */
+export const STAGE_VALUES = ['todo', 'running', 'review', 'blocked', 'done'];
+export const STAGE_LABELS = {
+    todo: '待办',
+    running: '进行中',
+    review: '审核中',
+    blocked: '已阻塞',
+    done: '已完成',
+};
+/**
+ * 旧八阶段 → 新五阶段的映射。
+ * 同时用于两处：历史库读时兼容（不写库），以及 scripts/migrate-ticket-stages.mjs 的迁移。
+ * 注意：旧 `draft` / `accepted` 都并回「待办」，旧 `idle` 因为需要人工推动也并入「已阻塞」。
+ */
+export const LEGACY_STAGE_MAP = {
+    draft: 'todo',
+    accepted: 'todo',
+    assigned: 'running',
+    running: 'running',
+    review: 'review',
+    person: 'blocked',
+    idle: 'blocked',
+    closed: 'done',
+};
+export function isStage(value) {
+    return typeof value === 'string' && STAGE_VALUES.includes(value);
+}
+/** 把库里的阶段值归一化到新五阶段；未知值返回 null，交给调用方决定兜底。 */
+export function normalizeStage(value) {
+    if (isStage(value))
+        return value;
+    if (typeof value === 'string')
+        return LEGACY_STAGE_MAP[value] ?? null;
+    return null;
+}
+/** 按新阶段查询时，需要一并匹配的旧阶段值（迁移执行前也能查全）。 */
+export function stageAliases(stage) {
+    const aliases = Object.entries(LEGACY_STAGE_MAP)
+        .filter(([, mapped]) => mapped === stage)
+        .map(([legacy]) => legacy);
+    return [...new Set([stage, ...aliases])];
+}
+/**
+ * 由「工单 + 派工 + 最新报告」推导阶段。
+ * 自上而下判断，第一条命中的规则生效。
+ */
+export function computeStage(input) {
+    const { ticket, assignment, latestReport, hasAttention } = input;
+    if (ticket.closedAt)
+        return 'done';
+    if (hasAttention)
+        return 'blocked';
+    if (latestReport?.state === 'ready')
+        return 'review';
+    if (latestReport?.state === 'blocked' || latestReport?.state === 'failed')
+        return 'blocked';
+    if (!assignment)
+        return 'todo';
+    // 已派工（pending 或 running）都算「进行中」：对发起人来说工作已经开始了。
+    if (assignment.status === 'pending')
+        return 'running';
+    // 派工已结束但工单没闭环、worker 明确 waiting/dropped：都需要人来推动。
+    if (assignment.status === 'ended')
+        return 'blocked';
+    if (latestReport?.state === 'waiting' || latestReport?.state === 'dropped')
+        return 'blocked';
+    return 'running';
+}
+const TRANSITIONS = {
+    todo: ['running', 'review', 'blocked', 'done'],
+    running: ['todo', 'review', 'blocked', 'done'],
+    review: ['todo', 'running', 'blocked', 'done'],
+    blocked: ['todo', 'running', 'review', 'done'],
+    done: [],
+};
+/**
+ * 阶段迁移是否合法。
+ * 收敛到五种后不再表达细分流程：除「已完成」外，四个活跃阶段之间都可以互转；
+ * 「已完成」是终态，符合 PR 合并/关单后不可切回的既有约束。
+ */
+export function canTransition(from, to) {
+    if (from === to)
+        return true;
+    return TRANSITIONS[from].includes(to);
+}
+//# sourceMappingURL=stage.js.map

package/dist/stage.js.map

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

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@router-agent/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.31",
+  "type": "module",
+  "description": "领域内核：工单、授权、阶段、策略与共享类型",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blankPen/router-agent.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/blankPen/router-agent#readme",
+  "bugs": {
+    "url": "https://github.com/blankPen/router-agent/issues"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*.js": "./dist/*.js",
+    "./*": "./dist/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.