psyclaw 0.28.3 → 0.29.2

package/dist/src/analysis/plan.d.ts

@@ -0,0 +1,82 @@
+import { type AnalysisPlanContract } from "./hooks.js";
+export declare const ANALYSIS_PLAN_SCHEMA: "psyclaw/analysis-plan/v1";
+export declare const ANALYSIS_PLAN_ACTIVE: "analysis/plans/active.json";
+export type AnalysisPlanStatus = "clarifying" | "drafting" | "awaiting-confirm" | "reviewing" | "ready" | "running" | "deferred" | "completed" | "blocked";
+export type AnalysisPlanStage = "clarify-eda" | "propose" | "confirm" | "review" | "execute" | "report-checks" | "handoff";
+export type AnalysisExecutionBackend = "local-script" | "mcp" | "undecided";
+export interface AnalysisPlanEdaNote {
+    at: string;
+    summary: string;
+    paths?: string[];
+}
+export interface AnalysisPlanRecord extends AnalysisPlanContract {
+    schemaVersion: typeof ANALYSIS_PLAN_SCHEMA;
+    id: string;
+    status: AnalysisPlanStatus;
+    stage: AnalysisPlanStage;
+    goal: string;
+    dataPaths: string[];
+    questions: string[];
+    edaNotes: AnalysisPlanEdaNote[];
+    proposedMethods: string[];
+    confirmedMethod?: string;
+    executionBackend: AnalysisExecutionBackend;
+    mcpServer?: string;
+    scriptEntrypoint?: string;
+    reviewFindings: string[];
+    runPreference: "unset" | "now" | "later";
+    createdAt: string;
+    updatedAt: string;
+    notes?: string;
+}
+export declare function createAnalysisPlan(input: {
+    goal: string;
+    dataPaths?: string[];
+    confirmatory?: boolean;
+    now?: string;
+}): AnalysisPlanRecord;
+export declare function analysisPlansDir(root: string): Promise<string>;
+export declare function writeAnalysisPlan(root: string, plan: AnalysisPlanRecord): Promise<AnalysisPlanRecord>;
+export declare function readAnalysisPlan(root: string, id: string): Promise<AnalysisPlanRecord | null>;
+export declare function readActiveAnalysisPlan(root: string): Promise<AnalysisPlanRecord | null>;
+export declare function listAnalysisPlans(root: string): Promise<string[]>;
+export declare function advanceAnalysisPlan(plan: AnalysisPlanRecord, action: {
+    type: "add-question";
+    question: string;
+} | {
+    type: "add-eda";
+    summary: string;
+    paths?: string[];
+} | {
+    type: "draft";
+    primaryOutcome?: string;
+    primaryAnalysis?: string;
+    exploratoryAnalyses?: string[];
+    proposedMethods?: string[];
+    missingDataPlan?: string;
+    multiplicityPlan?: string;
+    exclusionCriteria?: string;
+} | {
+    type: "confirm";
+    method: string;
+    backend?: AnalysisExecutionBackend;
+    mcpServer?: string;
+} | {
+    type: "review";
+} | {
+    type: "ready";
+} | {
+    type: "run-now";
+} | {
+    type: "defer";
+} | {
+    type: "complete";
+    scriptEntrypoint?: string;
+} | {
+    type: "block";
+    reason: string;
+}): AnalysisPlanRecord;
+export declare function renderAnalysisPlanMarkdown(plan: AnalysisPlanRecord): string;
+export declare function formatAnalysisPlanStatus(plan: AnalysisPlanRecord): string;
+/** Seed HANDOFF fields from a completed/ready plan without wiping human edits wholesale when stubby. */
+export declare function syncHandoffFromAnalysisPlan(root: string, plan: AnalysisPlanRecord): Promise<string>;

package/dist/src/analysis/plan.js

@@ -0,0 +1,246 @@
+import { mkdir, readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { atomicWriteFile } from "../project/jsonl.js";
+import { assertSafeProjectPath, projectPaths } from "../project/paths.js";
+import { validateAnalysisPlan } from "./hooks.js";
+export const ANALYSIS_PLAN_SCHEMA = "psyclaw/analysis-plan/v1";
+export const ANALYSIS_PLAN_ACTIVE = "analysis/plans/active.json";
+const STATUS_STAGE = {
+    clarifying: "clarify-eda",
+    drafting: "propose",
+    "awaiting-confirm": "confirm",
+    reviewing: "review",
+    ready: "execute",
+    running: "execute",
+    deferred: "execute",
+    completed: "handoff",
+    blocked: "review",
+};
+function nowIso() {
+    return new Date().toISOString();
+}
+function planId(now = Date.now()) {
+    return `ap_${now}`;
+}
+export function createAnalysisPlan(input) {
+    const createdAt = input.now ?? nowIso();
+    return {
+        schemaVersion: ANALYSIS_PLAN_SCHEMA,
+        id: planId(Date.parse(createdAt) || Date.now()),
+        status: "clarifying",
+        stage: "clarify-eda",
+        goal: input.goal.trim() || "未命名分析目标",
+        confirmatory: input.confirmatory === true,
+        exploratoryAnalyses: input.confirmatory === true ? [] : ["待澄清后声明"],
+        dataPaths: [...(input.dataPaths ?? [])],
+        questions: [],
+        edaNotes: [],
+        proposedMethods: [],
+        executionBackend: "local-script",
+        reviewFindings: [],
+        runPreference: "unset",
+        createdAt,
+        updatedAt: createdAt,
+    };
+}
+export async function analysisPlansDir(root) {
+    const dir = await assertSafeProjectPath(root, "analysis/plans");
+    await mkdir(dir, { recursive: true });
+    return dir;
+}
+export async function writeAnalysisPlan(root, plan) {
+    const dir = await analysisPlansDir(root);
+    const updated = { ...plan, stage: STATUS_STAGE[plan.status], updatedAt: nowIso() };
+    const file = join(dir, `${updated.id}.json`);
+    await atomicWriteFile(file, `${JSON.stringify(updated, null, 2)}\n`);
+    await atomicWriteFile(join(dir, "active.json"), `${JSON.stringify({ schemaVersion: "psyclaw/analysis-plan-active/v1", planId: updated.id, updatedAt: updated.updatedAt }, null, 2)}\n`);
+    await atomicWriteFile(join(dir, `${updated.id}.md`), renderAnalysisPlanMarkdown(updated));
+    return updated;
+}
+export async function readAnalysisPlan(root, id) {
+    try {
+        const path = await assertSafeProjectPath(root, `analysis/plans/${id}.json`);
+        const value = JSON.parse(await readFile(path, "utf8"));
+        if (value.schemaVersion !== ANALYSIS_PLAN_SCHEMA || typeof value.id !== "string")
+            return null;
+        return value;
+    }
+    catch {
+        return null;
+    }
+}
+export async function readActiveAnalysisPlan(root) {
+    try {
+        const activePath = await assertSafeProjectPath(root, ANALYSIS_PLAN_ACTIVE);
+        const active = JSON.parse(await readFile(activePath, "utf8"));
+        if (!active.planId)
+            return null;
+        return readAnalysisPlan(root, active.planId);
+    }
+    catch {
+        return null;
+    }
+}
+export async function listAnalysisPlans(root) {
+    try {
+        const dir = await analysisPlansDir(root);
+        const names = await readdir(dir);
+        return names.filter((name) => /^ap_\d+\.json$/.test(name)).map((name) => name.replace(/\.json$/, "")).sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function advanceAnalysisPlan(plan, action) {
+    const next = { ...plan, updatedAt: nowIso() };
+    switch (action.type) {
+        case "add-question":
+            next.questions = [...plan.questions, action.question.trim()].filter(Boolean);
+            next.status = "clarifying";
+            break;
+        case "add-eda":
+            next.edaNotes = [...plan.edaNotes, { at: nowIso(), summary: action.summary.trim(), ...(action.paths ? { paths: action.paths } : {}) }];
+            next.status = "clarifying";
+            break;
+        case "draft":
+            if (action.primaryOutcome !== undefined)
+                next.primaryOutcome = action.primaryOutcome;
+            if (action.primaryAnalysis !== undefined)
+                next.primaryAnalysis = action.primaryAnalysis;
+            if (action.exploratoryAnalyses !== undefined)
+                next.exploratoryAnalyses = action.exploratoryAnalyses;
+            if (action.proposedMethods !== undefined)
+                next.proposedMethods = action.proposedMethods;
+            if (action.missingDataPlan !== undefined)
+                next.missingDataPlan = action.missingDataPlan;
+            if (action.multiplicityPlan !== undefined)
+                next.multiplicityPlan = action.multiplicityPlan;
+            if (action.exclusionCriteria !== undefined)
+                next.exclusionCriteria = action.exclusionCriteria;
+            next.status = "awaiting-confirm";
+            break;
+        case "confirm":
+            next.confirmedMethod = action.method.trim();
+            next.primaryAnalysis = action.method.trim();
+            next.executionBackend = action.backend ?? "local-script";
+            if (action.mcpServer)
+                next.mcpServer = action.mcpServer;
+            next.status = "reviewing";
+            break;
+        case "review": {
+            const result = validateAnalysisPlan(next);
+            next.reviewFindings = result.findings.map((finding) => `${finding.severity}: ${finding.message}`);
+            next.status = result.findings.some((finding) => finding.severity === "block") ? "blocked" : "ready";
+            break;
+        }
+        case "ready":
+            next.status = "ready";
+            break;
+        case "run-now":
+            next.runPreference = "now";
+            next.status = "running";
+            break;
+        case "defer":
+            next.runPreference = "later";
+            next.status = "deferred";
+            break;
+        case "complete":
+            if (action.scriptEntrypoint)
+                next.scriptEntrypoint = action.scriptEntrypoint;
+            next.status = "completed";
+            break;
+        case "block":
+            next.reviewFindings = [...next.reviewFindings, `block: ${action.reason}`];
+            next.status = "blocked";
+            break;
+    }
+    next.stage = STATUS_STAGE[next.status];
+    return next;
+}
+export function renderAnalysisPlanMarkdown(plan) {
+    const lines = [
+        `# Analysis plan \`${plan.id}\``,
+        "",
+        `- Status: **${plan.status}** (stage: ${plan.stage})`,
+        `- Goal: ${plan.goal}`,
+        `- Confirmatory: ${plan.confirmatory ? "yes" : "no (exploratory OK if disclosed)"}`,
+        `- Execution: ${plan.executionBackend}${plan.mcpServer ? ` (${plan.mcpServer})` : ""}`,
+        `- Run preference: ${plan.runPreference}`,
+        "",
+        "## Data",
+        "",
+        ...(plan.dataPaths.length > 0 ? plan.dataPaths.map((path) => `- ${path}`) : ["- (not set)"]),
+        "",
+        "## Clarifying questions",
+        "",
+        ...(plan.questions.length > 0 ? plan.questions.map((q, i) => `${i + 1}. ${q}`) : ["- (none yet)"]),
+        "",
+        "## EDA notes",
+        "",
+        ...(plan.edaNotes.length > 0
+            ? plan.edaNotes.map((note) => `- ${note.at}: ${note.summary}${note.paths?.length ? ` (${note.paths.join(", ")})` : ""}`)
+            : ["- (none yet)"]),
+        "",
+        "## Proposal",
+        "",
+        `- Primary outcome: ${plan.primaryOutcome ?? "(missing)"}`,
+        `- Primary analysis: ${plan.primaryAnalysis ?? "(missing)"}`,
+        `- Confirmed method: ${plan.confirmedMethod ?? "(not confirmed)"}`,
+        `- Proposed methods: ${plan.proposedMethods.join("; ") || "(none)"}`,
+        `- Exploratory: ${(plan.exploratoryAnalyses ?? []).join("; ") || "(none)"}`,
+        `- Missing data: ${plan.missingDataPlan ?? "(missing)"}`,
+        `- Multiplicity: ${plan.multiplicityPlan ?? "(missing)"}`,
+        `- Exclusion: ${plan.exclusionCriteria ?? "(missing)"}`,
+        "",
+        "## Review",
+        "",
+        ...(plan.reviewFindings.length > 0 ? plan.reviewFindings.map((item) => `- ${item}`) : ["- (not reviewed)"]),
+        "",
+        "## Execution",
+        "",
+        `- Script entrypoint: ${plan.scriptEntrypoint ?? "analysis/scripts/run_all.py (expected)"}`,
+        "- Default: write local reproducible scripts; MCP only for special backends or explicit request.",
+        "",
+        "## Next",
+        "",
+        plan.status === "ready" || plan.status === "deferred"
+            ? "- Choose `/plan run` (now) or `/plan defer` (later), then execute."
+            : plan.status === "completed"
+                ? "- Update `analysis/HANDOFF.md` before switching to academic."
+                : "- Continue the current stage; do not jump to academic/ARS.",
+        "",
+    ];
+    return lines.join("\n");
+}
+export function formatAnalysisPlanStatus(plan) {
+    return [
+        `分析 Plan \`${plan.id}\` · ${plan.status}/${plan.stage}`,
+        `目标：${plan.goal}`,
+        `主分析：${plan.confirmedMethod ?? plan.primaryAnalysis ?? "（未确认）"}`,
+        `后端：${plan.executionBackend}${plan.mcpServer ? `/${plan.mcpServer}` : ""} · 执行偏好：${plan.runPreference}`,
+        `文件：analysis/plans/${plan.id}.md`,
+        plan.reviewFindings.length > 0 ? `审核：${plan.reviewFindings.join("；")}` : "审核：尚未完成或无发现",
+    ].join("\n");
+}
+/** Seed HANDOFF fields from a completed/ready plan without wiping human edits wholesale when stubby. */
+export async function syncHandoffFromAnalysisPlan(root, plan) {
+    const path = projectPaths(root).analysisHandoff;
+    const block = [
+        `# Analysis → Academic handoff`,
+        "",
+        `- Status: ${plan.status === "completed" ? "ready-for-academic" : "draft"}`,
+        `- Plan id: ${plan.id}`,
+        `- Question / design: ${plan.goal}`,
+        `- Primary analysis: ${plan.confirmedMethod ?? plan.primaryAnalysis ?? ""}`,
+        `- Primary outcome: ${plan.primaryOutcome ?? ""}`,
+        `- Primary results paths: ${plan.scriptEntrypoint ?? "analysis/results/"}`,
+        `- Key numbers (N, effects): (fill after execution)`,
+        `- Limits / unverified items: ${(plan.reviewFindings.concat(plan.exploratoryAnalyses ?? [])).join("; ") || "none listed"}`,
+        `- Ready for academic: ${plan.status === "completed" ? "yes-if-results-present" : "no"}`,
+        "",
+    ].join("\n");
+    await mkdir(projectPaths(root).analysis, { recursive: true });
+    await atomicWriteFile(path, block);
+    return "analysis/HANDOFF.md";
+}
+//# sourceMappingURL=plan.js.map

package/dist/src/analysis/plan.js.map

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

package/dist/src/analysis/stats-router.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Analysis-mode stats intent router.
+ * When matched in analysis mode, soft-takeover into the analysis-plan skill.
+ * Does not compete with academic ARS soft-routing.
+ */
+export interface StatsIntentMatch {
+    kind: "stats-analysis";
+    reason: string;
+}
+export declare function resolveStatsIntent(text: string): StatsIntentMatch | null;
+export declare function formatAnalysisPlanTakeover(userText: string): string;
+/** System-prompt contract for analysis sticky mode. */
+export declare function analysisSoftRoutePrompt(): string;

package/dist/src/analysis/stats-router.js

@@ -0,0 +1,44 @@
+/**
+ * Analysis-mode stats intent router.
+ * When matched in analysis mode, soft-takeover into the analysis-plan skill.
+ * Does not compete with academic ARS soft-routing.
+ */
+const STATS_INTENT = /统计|分析数据|数据分析|跑(一下)?(检验|回归|方差|anova|相关)|t\s*检验|方差分析|回归分析|中介|调节|SEM|因子(分析)?|生存分析|功效|样本量|描述统计|探索性|EDA|analysis plan|统计方案|帮我分析|看一下(这个)?数据|dataset|csv|\.sav\b|独立样本|配对样本|重复测量|混合设计|多层(模型|线性)|meta[- ]?analysis|元分析/i;
+const EXPLICIT_SKIP = /^\/(?:skill:|plan\b|ars(?:-|\b)|init\b|verify\b|grill\b|review\b|loop\b|mcp\b|agents\b|provider\b|panel\b|help\b)/i;
+/** Academic writing intents should not steal analysis-plan takeover. */
+const ACADEMIC_DOMINANT = /写论文|成稿|审稿|文献综述|润色终稿|\/ars-|academic-paper|同行评审/i;
+export function resolveStatsIntent(text) {
+    const trimmed = text.trim();
+    if (!trimmed || EXPLICIT_SKIP.test(trimmed))
+        return null;
+    if (ACADEMIC_DOMINANT.test(trimmed) && !/先分析|先跑|数据分析|统计方案/.test(trimmed))
+        return null;
+    if (!STATS_INTENT.test(trimmed))
+        return null;
+    return { kind: "stats-analysis", reason: "statistical / data-analysis intent" };
+}
+export function formatAnalysisPlanTakeover(userText) {
+    return [
+        "/skill:analysis-plan",
+        "",
+        "Analysis-plan soft takeover. Follow the analysis-plan skill stages now; do not ask the user to retype /skill:analysis-plan.",
+        "Do not start academic/ARS writing. Do not invent numerical results.",
+        "Default execution backend: write reproducible scripts under analysis/scripts/ using mature libraries (pandas/pingouin/statsmodels/scipy or R equivalents).",
+        "Use MCP only when the user needs a special backend (SPSS/Mplus/MNE/Stata) or explicitly asks.",
+        "Persist structured state with /plan (new|status|confirm|review|run|defer|handoff); soft confirm ≠ ARS checkpoint ≠ awaiting-human.",
+        "User request:",
+        userText.trim(),
+    ].join("\n");
+}
+/** System-prompt contract for analysis sticky mode. */
+export function analysisSoftRoutePrompt() {
+    return [
+        "## Analysis soft-route (stats plan)",
+        "While analysis mode is active, clear statistical / data-analysis intents soft-takeover into `/skill:analysis-plan` without waiting for an explicit slash from the user.",
+        "Stages: clarify + light EDA → structured proposal → soft human confirm (`/plan confirm`) → plan review (`/plan review`) → `/plan run` (now) or `/plan defer` (later).",
+        "Default backend: local reproducible scripts under `analysis/scripts/`. MCP only for special backends or explicit request.",
+        "Do not merge this with academic/ARS planning. After an accepted/completed plan (and results), update `analysis/HANDOFF.md` before switching to academic.",
+        "Explicit `/skill:` or `/plan` always wins over soft routing. Academic writing intents belong in academic mode.",
+    ].join("\n");
+}
+//# sourceMappingURL=stats-router.js.map

package/dist/src/analysis/stats-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-router.js","sourceRoot":"","sources":["../../../src/analysis/stats-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,YAAY,GAAG,gNAAgN,CAAC;AAEtO,MAAM,aAAa,GAAG,oHAAoH,CAAC;AAE3I,wEAAwE;AACxE,MAAM,iBAAiB,GAAG,iDAAiD,CAAC;AAE5E,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO;QACL,sBAAsB;QACtB,EAAE;QACF,6HAA6H;QAC7H,qEAAqE;QACrE,4JAA4J;QAC5J,+FAA+F;QAC/F,oIAAoI;QACpI,eAAe;QACf,QAAQ,CAAC,IAAI,EAAE;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,qCAAqC;QACrC,yKAAyK;QACzK,uKAAuK;QACvK,2HAA2H;QAC3H,0JAA0J;QAC1J,gHAAgH;KACjH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/ars/academic-router.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Academic-mode soft router: natural-language intent → a small allowlist of
+ * bundled writing/review skills. Skills outside this set must be invoked
+ * explicitly with `/skill:<name>` (or equivalent).
+ */
+export declare const ACADEMIC_SOFT_ROUTE_SKILLS: readonly ["deep-research", "academic-paper", "academic-paper-reviewer", "academic-pipeline", "academic-paper-strategist", "academic-paper-composer", "nature-figure", "nature-ref-verifier", "nature-polishing"];
+export type AcademicSoftRouteSkill = (typeof ACADEMIC_SOFT_ROUTE_SKILLS)[number];
+export interface AcademicSoftRouteMatch {
+    skill: AcademicSoftRouteSkill;
+    reason: string;
+    /** Optional ARS/academic-paper mode hint for the skill body. */
+    modeHint?: string;
+    priority: number;
+}
+export declare function isAcademicSoftRouteSkill(name: string): boolean;
+/**
+ * Rank allowlisted skills for academic-mode natural language (deduped by skill,
+ * keeping the highest-priority rule per skill).
+ *
+ * Primary order for multi-intent asks: earliest cue in the utterance, then
+ * rule priority. That keeps “先 A 再 B” routing to A first while still
+ * surfacing B in the ranked follow-ups.
+ */
+export declare function rankAcademicSoftRoutes(text: string, limit?: number): AcademicSoftRouteMatch[];
+/**
+ * Resolve the best allowlisted skill for academic-mode natural language.
+ * Returns null when the utterance is explicit slash routing or too ambiguous.
+ */
+export declare function resolveAcademicSoftRoute(text: string): AcademicSoftRouteMatch | null;
+/** Expand a soft-route match into a Pi skill invocation the user need not type. */
+export declare function formatAcademicSoftRouteInvocation(match: AcademicSoftRouteMatch, userText: string, also?: AcademicSoftRouteMatch[]): string;
+/** System-prompt contract for academic sticky mode. */
+export declare function academicSoftRoutePrompt(): string;

package/dist/src/ars/academic-router.js

@@ -0,0 +1,204 @@
+/**
+ * Academic-mode soft router: natural-language intent → a small allowlist of
+ * bundled writing/review skills. Skills outside this set must be invoked
+ * explicitly with `/skill:<name>` (or equivalent).
+ */
+export const ACADEMIC_SOFT_ROUTE_SKILLS = [
+    "deep-research",
+    "academic-paper",
+    "academic-paper-reviewer",
+    "academic-pipeline",
+    "academic-paper-strategist",
+    "academic-paper-composer",
+    "nature-figure",
+    "nature-ref-verifier",
+    "nature-polishing",
+];
+const ROUTE_RULES = [
+    {
+        skill: "nature-figure",
+        reason: "figure / plotting request",
+        priority: 100,
+        pattern: /nature[- ]?figure|配图|作图|画图|出图|科研绘图|论文图表|森林图|forest\s*plot|可视化图|manuscript figure|publication[- ]ready (figure|plot)|graphical abstract|机制示意|投稿级配图|投稿级.{0,6}图/i,
+    },
+    {
+        skill: "nature-ref-verifier",
+        reason: "citation field cross-check",
+        priority: 95,
+        pattern: /nature[- ]?ref|引用交叉|核对引用字段|交叉核验|多源字段核验|cross[- ]?check (refs?|citations?)|doi.*(核验|核对|verify)|verify.*(doi|citation|reference)|作者年份/i,
+    },
+    {
+        skill: "nature-polishing",
+        reason: "prose polish / finalization",
+        priority: 90,
+        pattern: /nature[- ]?polish|润色|polish(ing)? (the )?(prose|manuscript|paper|abstract)|终稿润色|语言润色|submission[- ]ready polish|只做.{0,8}润色|不改(结论|数据|引用|结构).{0,12}润色|润色.{0,12}不改(结论|数据|引用)/i,
+    },
+    {
+        skill: "academic-paper-strategist",
+        reason: "outline / writing strategy",
+        priority: 88,
+        pattern: /strategist|写作策略|优化大纲|规划大纲|详细大纲|paper strategy|optimize (the )?outline|重构论证|贡献点|大纲权衡|动笔前/i,
+    },
+    {
+        skill: "academic-paper-composer",
+        reason: "compose full manuscript from outline",
+        priority: 86,
+        pattern: /composer|按大纲写|按.{0,6}大纲写成|执行大纲|写成全文|写完整篇|通篇写作|compose (the )?(full )?manuscript|write (the )?paper from (this |the )?outline|execute the outline|章节级质量/i,
+    },
+    {
+        skill: "academic-paper-reviewer",
+        reason: "peer review / revision coaching",
+        priority: 84,
+        pattern: /reviewer|peer review|同行评审|模拟审稿|改稿|revision coach|rebuttal|点对点回复|审稿意见|方法学质疑/i,
+    },
+    {
+        skill: "academic-pipeline",
+        reason: "full ARS academic pipeline",
+        priority: 82,
+        pattern: /academic[- ]?pipeline|完整流水线|全流程写作|完整.{0,8}pipeline|端到端.{0,8}pipeline|end[- ]to[- ]end (paper|manuscript) pipeline|从选题到成稿/i,
+    },
+    {
+        skill: "deep-research",
+        reason: "literature research / synthesis",
+        priority: 78,
+        pattern: /deep[- ]?research|文献调研|文献检索|系统综述检索|annotated bibliography|knowledge map|文献地图|知识地图|检索式|可纳入的研究/i,
+    },
+    {
+        skill: "academic-paper",
+        reason: "ARS academic-paper lit-review mode",
+        modeHint: "lit-review",
+        priority: 70,
+        pattern: /lit[- ]?review|文献综述(节|章节|写作)?|literature review section|放入论文引言/i,
+    },
+    {
+        skill: "academic-paper",
+        reason: "ARS academic-paper abstract mode",
+        modeHint: "abstract",
+        priority: 69,
+        pattern: /\babstract\b|写摘要|摘要撰写|structured abstract|写一个.{0,12}abstract/i,
+    },
+    {
+        skill: "academic-paper",
+        reason: "ARS academic-paper outline mode",
+        modeHint: "outline",
+        priority: 68,
+        pattern: /(?<!详细|优化|规划|重构)(写大纲|论文大纲|section outline)|\boutline\b(?!.*strategist)/i,
+    },
+    {
+        skill: "academic-paper",
+        reason: "ARS academic-paper citation-check mode",
+        modeHint: "citation-check",
+        priority: 72,
+        pattern: /citation[- ]?check|引用检查|核对文末参考文献|reference list check|引文和文末|一一对应/i,
+    },
+    {
+        skill: "academic-paper",
+        reason: "ARS academic-paper writing / format",
+        modeHint: "writing",
+        priority: 50,
+        pattern: /写论文|撰写论文|manuscript(?!\s+prose)|学术写作|format convert|排版导出|转 docx|转 pdf/i,
+    },
+];
+const EXPLICIT_SKILL_OR_ARS = /^\/(?:skill:|ars(?:-|\b)|create-|agents\b|init\b|verify\b|grill\b|review\b|loop\b|mcp\b|plugin\b|provider\b|panel\b|pet\b|help\b|export\b)/i;
+/** Out-of-allowlist or non-academic intents that must not soft-route. */
+const HARD_NEGATIVE = /academic-grill|逐题追问|(独立样本|配对|重复测量).{0,6}t\s*检验|跑一下.{0,12}(回归|方差|anova)|不要写论文|今天天气/i;
+export function isAcademicSoftRouteSkill(name) {
+    return ACADEMIC_SOFT_ROUTE_SKILLS.includes(name.trim());
+}
+function matchIndex(text, pattern) {
+    const flags = pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`;
+    const re = new RegExp(pattern.source, flags);
+    const hit = re.exec(text);
+    return hit?.index ?? Number.POSITIVE_INFINITY;
+}
+function matchesFor(text) {
+    const hits = [];
+    for (const rule of ROUTE_RULES) {
+        const index = matchIndex(text, rule.pattern);
+        if (!Number.isFinite(index))
+            continue;
+        hits.push({
+            skill: rule.skill,
+            reason: rule.reason,
+            priority: rule.priority,
+            index,
+            ...(rule.modeHint ? { modeHint: rule.modeHint } : {}),
+        });
+    }
+    return hits;
+}
+/**
+ * Rank allowlisted skills for academic-mode natural language (deduped by skill,
+ * keeping the highest-priority rule per skill).
+ *
+ * Primary order for multi-intent asks: earliest cue in the utterance, then
+ * rule priority. That keeps “先 A 再 B” routing to A first while still
+ * surfacing B in the ranked follow-ups.
+ */
+export function rankAcademicSoftRoutes(text, limit = ACADEMIC_SOFT_ROUTE_SKILLS.length) {
+    const trimmed = text.trim();
+    if (!trimmed || EXPLICIT_SKILL_OR_ARS.test(trimmed) || HARD_NEGATIVE.test(trimmed))
+        return [];
+    const bestBySkill = new Map();
+    for (const hit of matchesFor(trimmed)) {
+        const existing = bestBySkill.get(hit.skill);
+        if (!existing || hit.priority > existing.priority || (hit.priority === existing.priority && hit.index < existing.index)) {
+            bestBySkill.set(hit.skill, hit);
+        }
+    }
+    return [...bestBySkill.values()]
+        .sort((a, b) => a.index - b.index || b.priority - a.priority || a.skill.localeCompare(b.skill))
+        .slice(0, Math.max(0, limit))
+        .map(({ index: _index, ...match }) => match);
+}
+/**
+ * Resolve the best allowlisted skill for academic-mode natural language.
+ * Returns null when the utterance is explicit slash routing or too ambiguous.
+ */
+export function resolveAcademicSoftRoute(text) {
+    return rankAcademicSoftRoutes(text, 1)[0] ?? null;
+}
+/** Expand a soft-route match into a Pi skill invocation the user need not type. */
+export function formatAcademicSoftRouteInvocation(match, userText, also = []) {
+    const modeLine = match.modeHint
+        ? `Preferred mode / focus: ${match.modeHint}.`
+        : "";
+    const followUps = also
+        .filter((item) => item.skill !== match.skill)
+        .map((item) => item.skill);
+    const followLine = followUps.length > 0
+        ? `After the primary skill, continue with these allowlisted skills in order when the user request clearly needs them: ${followUps.join(" → ")}.`
+        : "";
+    return [
+        `/skill:${match.skill}`,
+        "",
+        `Academic soft-route (${match.reason}). Load and follow this skill now; do not ask the user to retype /skill:${match.skill}.`,
+        modeLine,
+        followLine,
+        "User request:",
+        userText.trim(),
+    ].filter((line) => line !== undefined && line !== "").join("\n");
+}
+/** System-prompt contract for academic sticky mode. */
+export function academicSoftRoutePrompt() {
+    const list = ACADEMIC_SOFT_ROUTE_SKILLS.map((name) => `- ${name}`).join("\n");
+    return [
+        "## Academic soft-route (allowlist only)",
+        "While academic mode is active, you may silently load and follow only these bundled skills without waiting for an explicit `/skill:` from the user:",
+        list,
+        "Routing preference (pick one primary skill, state it briefly, then proceed; for clearly multi-step asks, chain allowlisted skills in order):",
+        "- Literature search / synthesis → deep-research",
+        "- Paper-format lit-review / abstract / outline / citation-check / manuscript drafting → academic-paper",
+        "- Peer review / revision / rebuttal → academic-paper-reviewer",
+        "- End-to-end ARS pipeline → academic-pipeline",
+        "- Writing strategy / optimized outline → academic-paper-strategist",
+        "- Execute outline into full manuscript → academic-paper-composer",
+        "- Publication figures → nature-figure",
+        "- DOI/author/year field cross-check after citation work → nature-ref-verifier",
+        "- Final prose polish only → nature-polishing",
+        "Invoke the chosen skill via `/skill:<name>` (or the host skill tool) so the user can see it, then follow that skill. Do not ask the user to type the slash command when the intent is clear.",
+        "Skills outside this allowlist must NOT be auto-selected. If another skill is needed, tell the user to run `/skill:<name>` explicitly (or `/skill` to manage installs).",
+        "Explicit user `/skill:` or `/ars-*` always wins over soft routing.",
+    ].join("\n");
+}
+//# sourceMappingURL=academic-router.js.map