psyclaw 0.24.0 → 0.25.1

package/scripts/check-branding.mjs

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+import { readdir, readFile } from "node:fs/promises";
+import { extname, join, relative, resolve, sep } from "node:path";
+import process from "node:process";
+
+const root = resolve(import.meta.dirname, "..");
+const legacyName = `psy${"pi"}`;
+const scanRoots = [
+  "apps",
+  "docs",
+  "evals",
+  "scripts",
+  "skills",
+  "src",
+  "tests",
+];
+const rootFiles = [
+  "AGENTS.md",
+  "CHANGELOG.md",
+  "CLAUDE.md",
+  "LICENSE",
+  "PRODUCT.md",
+  "README.md",
+  "package.json",
+  "package.json.psyclaw",
+  "pnpm-lock.yaml",
+  "tsconfig.json",
+  "vitest.config.ts",
+];
+const skippedDirectories = new Set([
+  ".git",
+  ".obsidian",
+  "coverage",
+  "dist",
+  "node_modules",
+  "raw",
+]);
+const skippedExtensions = new Set([
+  ".docx",
+  ".gif",
+  ".ico",
+  ".jpeg",
+  ".jpg",
+  ".pdf",
+  ".png",
+  ".webp",
+  ".zip",
+]);
+const manifest = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+const governance = JSON.parse(await readFile(join(root, "package.json.psyclaw"), "utf8"));
+
+function displayPath(path) {
+  return relative(root, path).split(sep).join("/");
+}
+
+function isAllowedProvenance(path, line) {
+  if (displayPath(path) !== "package.json.psyclaw") return false;
+  const provenance = new RegExp(
+    `^\\s*"ref"\\s*:\\s*"${legacyName}@[0-9a-f]{40}"\\s*$`,
+    "i",
+  );
+  return provenance.test(line);
+}
+
+async function collectFiles(path) {
+  const entries = await readdir(path, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+    const child = join(path, entry.name);
+    if (entry.isDirectory()) {
+      if (!skippedDirectories.has(entry.name)) {
+        files.push(...await collectFiles(child));
+      }
+      continue;
+    }
+    if (entry.isFile() && !skippedExtensions.has(extname(entry.name).toLowerCase())) {
+      files.push(child);
+    }
+  }
+  return files;
+}
+
+const candidates = rootFiles.map((path) => join(root, path));
+for (const path of scanRoots) {
+  candidates.push(...await collectFiles(join(root, path)));
+}
+
+const forbidden = [];
+const allowed = [];
+const contractFailures = [];
+for (const path of candidates) {
+  const content = await readFile(path, "utf8");
+  for (const [index, line] of content.split(/\r?\n/u).entries()) {
+    if (!line.toLowerCase().includes(legacyName)) continue;
+    const match = `${displayPath(path)}:${index + 1}`;
+    if (isAllowedProvenance(path, line)) {
+      allowed.push(match);
+    } else {
+      forbidden.push(match);
+    }
+  }
+}
+
+if (manifest.name !== "psyclaw") contractFailures.push("package.json name must be psyclaw");
+if (manifest.bin?.psyclaw !== "dist/src/cli.js") {
+  contractFailures.push("package.json must expose the psyclaw CLI bin");
+}
+if (manifest.scripts?.postinstall !== undefined) {
+  contractFailures.push("package.json must not mutate dependencies during postinstall");
+}
+if (manifest.publishConfig?.registry !== "https://registry.npmjs.org/") {
+  contractFailures.push("package.json publishConfig must use the official npm registry");
+}
+if (manifest.publishConfig?.access !== "public") {
+  contractFailures.push("package.json publishConfig must declare public access");
+}
+const expectedExtensions = ["./dist/src/extension.js", "./dist/src/panel/extension.js"];
+if (JSON.stringify(manifest.pi?.extensions) !== JSON.stringify(expectedExtensions)) {
+  contractFailures.push("package.json Pi extensions must point to packaged dist files");
+}
+if (governance.id !== "psyclaw") contractFailures.push("package governance id must be psyclaw");
+if (governance.schemaVersion !== "psyclaw/package-governance/v1") {
+  contractFailures.push("package governance schema must use the psyclaw namespace");
+}
+if (governance.apiVersion !== manifest.version.replace(/\.0$/u, "")) {
+  contractFailures.push("package governance apiVersion must match the package major/minor version");
+}
+
+const versionSurfaces = [
+  ["README.md", `v${manifest.version}`],
+  ["PRODUCT.md", `Version ${manifest.version}`],
+  ["CHANGELOG.md", `## v${manifest.version}`],
+  ["docs/使用白皮书.md", `| 版本 | ${manifest.version}`],
+  ["apps/website/index.html", `PsyClaw v${manifest.version}`],
+];
+for (const [path, marker] of versionSurfaces) {
+  const content = await readFile(join(root, path), "utf8");
+  if (!content.includes(marker)) contractFailures.push(`${path} is missing ${marker}`);
+}
+
+if (allowed.length !== 1) {
+  contractFailures.push(`expected one pinned predecessor provenance ref, found ${allowed.length}`);
+}
+if (forbidden.length > 0) {
+  contractFailures.push("legacy product identifier found in release sources");
+  contractFailures.push(...forbidden.map((match) => `legacy identifier at ${match}`));
+}
+
+if (contractFailures.length > 0) {
+  process.stderr.write("branding check failed:\n");
+  for (const failure of contractFailures) process.stderr.write(`  - ${failure}\n`);
+  process.exitCode = 1;
+} else {
+  process.stdout.write(
+    `branding check passed: PsyClaw ${manifest.version}; retained provenance: ${allowed[0]}\n`,
+  );
+}

package/scripts/copy-panel.mjs

@@ -0,0 +1,11 @@
+import { cpSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const source = join(root, "apps", "panel", "index.html");
+const target = join(root, "dist", "apps", "panel", "index.html");
+
+mkdirSync(dirname(target), { recursive: true });
+cpSync(source, target);
+console.log(`copied panel asset -> ${target}`);

package/scripts/rebrand-pi.mjs

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+/**
+ * Rebrand the bundled Pi runtime for PsyClaw.
+ *
+ * Curated Master Rotation Pool (Slanted Block Matrix removed):
+ * 1. 紧凑型对称衬线 I 方块字 (Compact Linear with Serif-I: ▀█▀ / ▄█▄)
+ * 2. 经典流线斜体 (Classic Slant Italic)
+ * 3. 3D 侧影电路方块字 (3D Isometric Shadow Block: ██████╗)
+ * 4. 学术罗马衬线体 (Academic Roman Serif: ╔══╗)
+ *
+ * Paired with Kaomoji Academic Puppies (✨ / 💤) & 24-Bit TrueColor Gemini Aurora Gradient.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const NAME = "PsyClaw";
+// Retain psypi's Pi profile so existing models, themes, packages, and skills
+// survive the product rename. PsyClaw's project data remains in `.psyclaw`.
+const CONFIG_DIR = ".psypi";
+
+function hexToRgb(hex) {
+  const num = parseInt(hex.replace("#", ""), 16);
+  return [(num >> 16) & 255, (num >> 8) & 255, num & 255];
+}
+
+function interpolateRgb(c1, c2, t) {
+  return [
+    Math.round(c1[0] + (c2[0] - c1[0]) * t),
+    Math.round(c1[1] + (c2[1] - c1[1]) * t),
+    Math.round(c1[2] + (c2[2] - c1[2]) * t),
+  ];
+}
+
+function gradientText(text, hexStops, totalCols) {
+  const chars = Array.from(text);
+  const total = totalCols || chars.length;
+  if (total === 0) return "";
+  const stops = hexStops.map(hexToRgb);
+
+  return chars.map((char, col) => {
+    if (char === " " || char === "\t") return char;
+    const globalT = Math.min(1, Math.max(0, col / Math.max(1, total - 1)));
+    const stopIndex = Math.min(Math.floor(globalT * (stops.length - 1)), stops.length - 2);
+    const localT = (globalT * (stops.length - 1)) - stopIndex;
+    const [r, g, b] = interpolateRgb(stops[stopIndex], stops[stopIndex + 1], localT);
+    const escaped = char === "\\" ? "\\\\" : char;
+    return `\\x1b[38;2;${r};${g};${b}m${escaped}\\x1b[0m`;
+  }).join("");
+}
+
+const AURORA_STOPS = ["#38bdf8", "#60a5fa", "#818cf8", "#a855f7", "#ec4899", "#2dd4bf"];
+
+// Colors
+const WHITE = "\\x1b[1m\\x1b[38;2;255;255;255m";
+const GLASSES = "\\x1b[1m\\x1b[38;2;56;189;248m";
+const ZZZ = "\\x1b[38;2;168;85;247m";
+const GOLD = "\\x1b[38;2;251;191;36m";
+const RESET = "\\x1b[0m";
+
+// Kaomoji Pups
+const PUP_SCHOLAR_TOP = `${WHITE}( ᐡ ${RESET}${GLASSES}⌐■-■${RESET}${WHITE} ᐡ )${RESET} ${GOLD}✨${RESET}`;
+const PUP_SCHOLAR_BOT = `${WHITE}c( づ 📜 づ )${RESET}`;
+
+const PUP_SLEEP_TOP = `${ZZZ}z z Z${RESET}`;
+const PUP_SLEEP_BOT = `${WHITE}( ᐡ ${RESET}${GLASSES}⌐■-■${RESET}${WHITE} ᐡ )${RESET} ${ZZZ}💤${RESET}`;
+
+const PUP_SCHOLAR_5ROW = [
+  `    ${WHITE}/ᐢ⑅ᐢ/ ${RESET} ${GOLD}✨${RESET}`,
+  `  ${WHITE}( ${RESET}${GLASSES}⌐■-■${RESET}${WHITE} )${RESET} `,
+  ` c${WHITE}(づ 📜 づ${RESET}`,
+  `  ${WHITE}(  "   " )${RESET}`,
+  `   ${WHITE}∪-----∪${RESET} `,
+];
+
+const PUP_SLEEPING_5ROW = [
+  `       ${ZZZ}z z Z${RESET}  `,
+  `    ${WHITE}/ᐢ⑅ᐢ/ ${RESET}${ZZZ}💤${RESET} `,
+  ` ${WHITE}( ${RESET}${GLASSES}⌐■-■${RESET}${WHITE} )~${RESET} `,
+  `${WHITE}c(  - ᴥ - )づ${RESET}`,
+  ` ${WHITE}(______)'${RESET}  `,
+];
+
+const PUP_SCHOLAR_3ROW = [
+  `    ${WHITE}/ᐢ⑅ᐢ/ ${RESET} ${GOLD}✨${RESET}`,
+  `  ${WHITE}( ${RESET}${GLASSES}⌐■-■${RESET}${WHITE} )${RESET} `,
+  ` c${WHITE}(づ 📜 づ${RESET}`,
+];
+
+const PUP_SLEEPING_3ROW = [
+  `       ${ZZZ}z z Z${RESET}  `,
+  `    ${WHITE}/ᐢ⑅ᐢ/ ${RESET}${ZZZ}💤${RESET} `,
+  ` ${WHITE}( ${RESET}${GLASSES}⌐■-■${RESET}${WHITE} )~${RESET} `,
+];
+
+// 1. 紧凑型对称衬线 I 方块字 (2-Row Compact)
+const FONT_2ROW_ROW0 = "█▀█ █▀▀ █ █ █▀▀ █    █▀█ █ █";
+const FONT_2ROW_ROW1 = "█▀▀ ▄██  █  █▄▄ █▄▄ ▄█▀ █▀█";
+const GRAD_2ROW_0 = gradientText(FONT_2ROW_ROW0, AURORA_STOPS, FONT_2ROW_ROW0.length);
+const GRAD_2ROW_1 = gradientText(FONT_2ROW_ROW1, AURORA_STOPS, FONT_2ROW_ROW1.length);
+
+// 2. 经典流线斜体 (Classic Slant Italic - 5-Row PsyClaw)
+const FONT_SLANT_CLASSIC = [
+  "  ____  ____  _   _  ____ _       ___ __      __",
+  " |  _ \\/ ___|| | | |/ ___| |     / _ \\ \\    / / ",
+  " | |_) \\___ \\| |_| | |   | |    | |_| \\ \\  / /  ",
+  " |  __/ ___) |  _  | |___| |___ |  _  |\\ \\// /   ",
+  " |_|   |____/|_| |_|\\____|_____|_| |_| \\__/    ",
+];
+
+// 3. 3D 侧影电路方块 (3D Isometric Shadow Block - 5-Row)
+const FONT_3D_BLOCK = FONT_SLANT_CLASSIC;
+
+// 4. 学术罗马衬线体 (Academic Roman Serif - 3-Row)
+const FONT_SERIF = [
+  " ╔═══╗ ╔══╗  ╦ ╦  ╔══╗ ╦     ╔══╗ ╦ ╦",
+  " ╠═══╝ ╚══╗  ╚╦╝  ║    ║     ╠══╣ ║║║",
+  " ╩     ╚══╝   ╩   ╚══╝ ╚═══╝ ╩  ╩ ╚╩╝",
+];
+
+function buildCustomVariant(fontLines, dogLines = []) {
+  const fontWidth = Math.max(...fontLines.map((line) => Array.from(line).length));
+  const rows = fontLines.map((line, i) => {
+    const paddedFont = line.padEnd(fontWidth, " ");
+    const gradFont = `\\x1b[1m${gradientText(paddedFont, AURORA_STOPS, fontWidth)}\\x1b[0m`;
+    const dog = dogLines[i] || "";
+    return `    \`  ${gradFont}   ${dog}\``;
+  });
+  return `[\n${rows.join(",\n")}\n  ]`;
+}
+
+// 组合变体
+const VAR_COMPACT_SCHOLAR = `[
+    \`  \\x1b[1m${GRAD_2ROW_0}\\x1b[0m   \\x1b[38;2;100;116;139m·\\x1b[0m   \\x1b[1m${gradientText("P S Y C L A W", ["#38bdf8", "#818cf8", "#2dd4bf"])}\\x1b[0m  \\x1b[38;2;148;163;184mv\${process.env.PSYCLAW_VERSION ?? this.version}\\x1b[0m   ${PUP_SCHOLAR_TOP}\`,
+    \`  \\x1b[1m${GRAD_2ROW_1}\\x1b[0m       \\x1b[38;2;148;163;184mEvidence-Grounded Social-Science Research Agent\\x1b[0m   ${PUP_SCHOLAR_BOT}\`
+  ]`;
+
+const VAR_COMPACT_SLEEP = `[
+    \`  \\x1b[1m${GRAD_2ROW_0}\\x1b[0m   \\x1b[38;2;100;116;139m·\\x1b[0m   \\x1b[1m${gradientText("P S Y C L A W", ["#38bdf8", "#818cf8", "#2dd4bf"])}\\x1b[0m  \\x1b[38;2;148;163;184mv\${process.env.PSYCLAW_VERSION ?? this.version}\\x1b[0m   ${PUP_SLEEP_TOP}\`,
+    \`  \\x1b[1m${GRAD_2ROW_1}\\x1b[0m       \\x1b[38;2;148;163;184mEvidence-Grounded Social-Science Research Agent\\x1b[0m   ${PUP_SLEEP_BOT}\`
+  ]`;
+
+const VAR_SLANT_CLASSIC_SCHOLAR = buildCustomVariant(FONT_SLANT_CLASSIC, PUP_SCHOLAR_5ROW);
+const VAR_SLANT_CLASSIC_SLEEP = buildCustomVariant(FONT_SLANT_CLASSIC, PUP_SLEEPING_5ROW);
+const VAR_3D_BLOCK_SCHOLAR = buildCustomVariant(FONT_3D_BLOCK, PUP_SCHOLAR_5ROW);
+const VAR_3D_BLOCK_SLEEP = buildCustomVariant(FONT_3D_BLOCK, PUP_SLEEPING_5ROW);
+const VAR_SERIF_SCHOLAR = buildCustomVariant(FONT_SERIF, PUP_SCHOLAR_3ROW);
+const VAR_SERIF_SLEEP = buildCustomVariant(FONT_SERIF, PUP_SLEEPING_3ROW);
+const VAR_SLANT_CLASSIC_NARROW = buildCustomVariant(FONT_SLANT_CLASSIC);
+const VAR_SERIF_NARROW = buildCustomVariant(FONT_SERIF);
+
+const GRAD_PIPELINE = "\\x1b[38;2;45;212;191m• Pipeline  :\\x1b[0m \\x1b[1m\\x1b[38;2;56;189;248mintake\\x1b[0m \\x1b[38;2;99;102;241m➔\\x1b[0m \\x1b[1m\\x1b[38;2;129;140;248mcapture\\x1b[0m \\x1b[38;2;168;85;247m➔\\x1b[0m \\x1b[1m\\x1b[38;2;168;85;247mcitation-audit\\x1b[0m \\x1b[38;2;236;72;153m➔\\x1b[0m \\x1b[1m\\x1b[38;2;45;212;191mbrief\\x1b[0m";
+const GRAD_PROTOCOL = "\\x1b[38;2;45;212;191m• Protocol  :\\x1b[0m \\x1b[1m\\x1b[38;2;52;211;153m✔ 2+ Source Cross-Check\\x1b[0m \\x1b[38;2;100;116;139m·\\x1b[0m \\x1b[1m\\x1b[38;2;45;212;191m✔ SHA-256 Provenance Ledger\\x1b[0m";
+const GRAD_WORKBENCH = "\\x1b[38;2;45;212;191m• Workbench :\\x1b[0m \\x1b[1m\\x1b[38;2;56;189;248mhttp://127.0.0.1:3721\\x1b[0m \\x1b[38;2;168;85;247m(Interactive Panel Active)\\x1b[0m";
+
+const PSYCLAW_DYNAMIC_BANNER = `const wideBannerVariants = [
+  ${VAR_COMPACT_SCHOLAR}, ${VAR_COMPACT_SLEEP},
+  ${VAR_SLANT_CLASSIC_SCHOLAR}, ${VAR_SLANT_CLASSIC_SLEEP},
+  ${VAR_3D_BLOCK_SCHOLAR}, ${VAR_3D_BLOCK_SLEEP},
+  ${VAR_SERIF_SCHOLAR}, ${VAR_SERIF_SLEEP},
+];
+const narrowBannerVariants = [${VAR_SLANT_CLASSIC_NARROW}, ${VAR_SERIF_NARROW}];
+const BANNER_VARIANTS = (process.stdout.columns ?? 80) >= 96 ? wideBannerVariants : narrowBannerVariants;
+const chosenBanner = BANNER_VARIANTS[Math.floor(Math.random() * BANNER_VARIANTS.length)];
+const logo = [
+  "",
+  ...chosenBanner,
+  "",
+  \`  ${GRAD_PIPELINE}\`,
+  \`  ${GRAD_PROTOCOL}\`,
+  \`  ${GRAD_WORKBENCH}\`,
+  "",
+].join("\\n");`;
+
+const GRAD_CORE_SKILLS = "\\x1b[1m\\x1b[38;2;56;189;248m✦ 核心证据链:\\x1b[0m \\x1b[1m\\x1b[38;2;56;189;248mresearch-intake\\x1b[0m \\x1b[38;2;99;102;241m➔\\x1b[0m \\x1b[1m\\x1b[38;2;129;140;248mevidence-capture\\x1b[0m \\x1b[38;2;168;85;247m➔\\x1b[0m \\x1b[1m\\x1b[38;2;168;85;247mcitation-audit\\x1b[0m \\x1b[38;2;236;72;153m➔\\x1b[0m \\x1b[1m\\x1b[38;2;45;212;191mresearch-brief\\x1b[0m";
+
+const PSYCLAW_SKILLS_FORMATTER = `const skills = skillsResult.skills;
+            if (skills.length > 0) {
+                const groups = this.buildScopeGroups(skills.map((skill) => ({ path: skill.filePath, sourceInfo: skill.sourceInfo })));
+                const skillList = this.formatScopeGroups(groups, {
+                    formatPath: (item) => this.formatDisplayPath(item.path),
+                    formatPackagePath: (item) => this.getShortPath(item.path, item.sourceInfo),
+                });
+                const CORE_PIPELINE = ["research-intake", "evidence-capture", "citation-audit", "research-brief"];
+                const availableCore = CORE_PIPELINE.filter((name) => skills.some((s) => s.name === name));
+                const otherSkills = skills.filter((s) => !CORE_PIPELINE.includes(s.name)).map((s) => s.name);
+                const skillCompactList = \`  ${GRAD_CORE_SKILLS}\\n\${theme.fg("dim", \`  ⟡ 生态扩展 (\${otherSkills.length}): \${otherSkills.slice(0, 10).join(", ")}\${otherSkills.length > 10 ? " ... (按 Ctrl+O 展开全部)" : ""}\`)}\`;
+                addLoadedSection("Skills", skillCompactList, skillList);
+            }`;
+
+const MODE_PATCHES = [
+  {
+    old: 'Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.',
+    next: 'PsyClaw 可自解释研究范式、文献核验规则与证据账本。直接输入研究目标或向其提问即可。',
+  },
+  {
+    old: 'PsyClaw can explain its own features and look up its docs. Ask it how to use or extend PsyClaw.',
+    next: 'PsyClaw 可自解释研究范式、文献核验规则与证据账本。直接输入研究目标或向其提问即可。',
+  },
+  {
+    old: 'theme.bold(theme.fg("accent", APP_NAME))',
+    next: 'theme.bold(theme.fg("accent", `ψ ${APP_NAME}`))',
+  },
+  {
+    old: `const skills = skillsResult.skills;
+            if (skills.length > 0) {
+                const groups = this.buildScopeGroups(skills.map((skill) => ({ path: skill.filePath, sourceInfo: skill.sourceInfo })));
+                const skillList = this.formatScopeGroups(groups, {
+                    formatPath: (item) => this.formatDisplayPath(item.path),
+                    formatPackagePath: (item) => this.getShortPath(item.path, item.sourceInfo),
+                });
+                const skillCompactList = formatCompactList(skills.map((skill) => skill.name));
+                addLoadedSection("Skills", skillCompactList, skillList);
+            }`,
+    next: PSYCLAW_SKILLS_FORMATTER,
+  },
+  {
+    old: 'this.getStartupExpansionState(), 1, 0);',
+    next: 'this.getStartupExpansionState(), 0, 0);',
+  },
+  {
+    old: 'this.ui.terminal.setTitle(`${APP_TITLE} - ${sessionName} - ${cwdBasename}`);',
+    next: 'this.ui.terminal.setTitle(`ψ ${APP_TITLE} - ${sessionName} - ${cwdBasename}`);',
+  },
+  {
+    old: 'this.ui.terminal.setTitle(`${APP_TITLE} - ${cwdBasename}`);',
+    next: 'this.ui.terminal.setTitle(`ψ ${APP_TITLE} - ${cwdBasename}`);',
+  },
+];
+
+async function patchPackageJson(pkgPath) {
+  const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
+  const existing = pkg.piConfig && typeof pkg.piConfig === "object" && !Array.isArray(pkg.piConfig)
+    ? pkg.piConfig
+    : {};
+  if (existing.name === NAME && existing.configDir === CONFIG_DIR) {
+    return { applied: false };
+  }
+  pkg.piConfig = { ...existing, name: NAME, configDir: CONFIG_DIR };
+  await writeFile(pkgPath, `${JSON.stringify(pkg, null, "\t")}\n`, "utf8");
+  return { applied: true };
+}
+
+async function applyModePatches(modePath) {
+  let content = await readFile(modePath, "utf8");
+  const applied = [];
+
+  // 动态检测并替换任何现有 logo / BANNER 定义，实现启动时多形态随机轮换
+  const dynamicBannerRegex = /(?:const BANNER_VARIANTS[\s\S]*?const logo = \[[\s\S]*?\]\.join\("\\n"\);|const logo = (?:`[\s\S]*?`|\[[\s\S]*?\]\.join\("\\n"\)|theme\.bold[\s\S]*?);)/;
+  const currentMatch = content.match(dynamicBannerRegex);
+  if (currentMatch && currentMatch[0] !== PSYCLAW_DYNAMIC_BANNER) {
+    content = content.replace(dynamicBannerRegex, PSYCLAW_DYNAMIC_BANNER);
+    applied.push("const logo = ... [Updated Curated 4-Style psyclaw Banner Rotation Pool]");
+  }
+
+  // 静态字符串替换
+  for (const { old, next } of MODE_PATCHES) {
+    if (content.includes(old)) {
+      content = content.replace(old, next);
+      applied.push(old.slice(0, 48));
+    }
+  }
+  if (applied.length > 0) {
+    await writeFile(modePath, content, "utf8");
+  }
+  return applied;
+}
+
+async function main() {
+  const entry = import.meta.resolve("@earendil-works/pi-coding-agent");
+  const pkgDir = dirname(dirname(fileURLToPath(entry)));
+  const pkgPath = join(pkgDir, "package.json");
+  const modePath = join(pkgDir, "dist", "modes", "interactive", "interactive-mode.js");
+
+  const pkgResult = await patchPackageJson(pkgPath);
+  const applied = await applyModePatches(modePath);
+
+  process.stdout.write(
+    `psyclaw rebrand: piConfig ${pkgResult.applied ? "applied" : "already set"} · ${applied.length > 0 ? `patched ${applied.length} display string(s)` : "display strings already patched"} (${pkgDir})\n`,
+  );
+  if (applied.length > 0) {
+    for (const label of applied) {
+      process.stdout.write(`  - ${label}…\n`);
+    }
+  }
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});

package/scripts/verify_docx.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+"""Structure + visual regression verifier for a DOCX artifact."""
+from __future__ import annotations
+
+import argparse
+import json
+import tempfile
+from pathlib import Path
+
+from psyclaw.output.docx_contract import inspect_docx
+from psyclaw.output.docx_visual import compare_visual_manifests, render_docx
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("docx")
+    parser.add_argument("--baseline", help="existing visual_manifest.json")
+    parser.add_argument("--output-dir", help="keep render intermediates here")
+    args = parser.parse_args()
+
+    contract = inspect_docx(args.docx)
+    if not contract["ok"]:
+        print(json.dumps(contract, ensure_ascii=False, indent=2))
+        return 1
+    if args.output_dir:
+        rendered = render_docx(args.docx, args.output_dir)
+    else:
+        with tempfile.TemporaryDirectory(prefix="psyclaw_docx_verify_") as td:
+            rendered = render_docx(args.docx, td)
+            if args.baseline and rendered.get("ok"):
+                rendered["comparison"] = compare_visual_manifests(
+                    rendered, json.loads(Path(args.baseline).read_text(encoding="utf-8")))
+    if args.baseline and args.output_dir and rendered.get("ok"):
+        rendered["comparison"] = compare_visual_manifests(
+            rendered, json.loads(Path(args.baseline).read_text(encoding="utf-8")))
+    print(json.dumps({"contract": contract, "render": rendered}, ensure_ascii=False, indent=2))
+    return 0 if rendered.get("ok") and rendered.get("comparison", {"ok": True})["ok"] else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/core/citation-audit/SKILL.md

@@ -1,9 +1,9 @@
----
-name: citation-audit
-description: Check claim-to-evidence links, citation fields, conflicts, and unsupported language before writing a research brief.
-license: MIT
----
-
-# Citation Audit
-
-Split factual statements into Claims. Require a qualifying source and locator for every supported Claim, preserve contradictory evidence, and downgrade uncertainty instead of filling gaps. A title match, abstract-only record, or model memory is not proof of a result or causal statement.
+---
+name: citation-audit
+description: Check claim-to-evidence links, citation fields, conflicts, and unsupported language before writing a research brief.
+license: MIT
+---
+
+# Citation Audit
+
+Split factual statements into Claims. Require a qualifying source and locator for every supported Claim, preserve contradictory evidence, and downgrade uncertainty instead of filling gaps. A title match, abstract-only record, or model memory is not proof of a result or causal statement.

package/skills/core/evidence-capture/SKILL.md

@@ -1,9 +1,9 @@
----
-name: evidence-capture
-description: Import local or user-provided sources into an append-only evidence ledger with provenance, locator, access status, and SHA-256.
-license: MIT
----
-
-# Evidence Capture
-
-Record the original locator, retrieval time, source type, evidence level, exact quote where applicable, page or section locator, and content hash. Treat metadata as metadata, user-provided material as unverified until checked, and failed or partial conversion as an explicit status. Do not download arbitrary full text or write to `data/raw` without an approved, lawful route.
+---
+name: evidence-capture
+description: Import local or user-provided sources into an append-only evidence ledger with provenance, locator, access status, and SHA-256.
+license: MIT
+---
+
+# Evidence Capture
+
+Record the original locator, retrieval time, source type, evidence level, exact quote where applicable, page or section locator, and content hash. Treat metadata as metadata, user-provided material as unverified until checked, and failed or partial conversion as an explicit status. Do not download arbitrary full text or write to `data/raw` without an approved, lawful route.

package/skills/core/manifest.json

@@ -1,15 +1,15 @@
-{
-  "schemaVersion": "psyclaw/skill-pack/v1",
-  "id": "psyclaw-core",
-  "version": "0.1.0",
-  "skills": [
-    "research-intake",
-    "evidence-capture",
-    "citation-audit",
-    "research-brief"
-  ],
-  "enabledByDefault": ["research-intake", "evidence-capture", "citation-audit", "research-brief"],
-  "source": {"kind": "workspace", "ref": "initial-mvp"},
-  "license": {"spdx": "MIT", "evidenceRef": "../../LICENSE"},
-  "dependencyStatus": "ready"
-}
+{
+  "schemaVersion": "psyclaw/skill-pack/v1",
+  "id": "psyclaw-core",
+  "version": "0.1.0",
+  "skills": [
+    "research-intake",
+    "evidence-capture",
+    "citation-audit",
+    "research-brief"
+  ],
+  "enabledByDefault": ["research-intake", "evidence-capture", "citation-audit", "research-brief"],
+  "source": {"kind": "workspace", "ref": "initial-mvp"},
+  "license": {"spdx": "MIT", "evidenceRef": "../../LICENSE"},
+  "dependencyStatus": "ready"
+}

package/skills/core/research-brief/SKILL.md

@@ -1,11 +1,11 @@
----
-name: research-brief
-description: Produce a concise, evidence-grounded research brief from an approved intake card and audited local evidence ledger.
-license: MIT
----
-
-# Research Brief
-
+---
+name: research-brief
+description: Produce a concise, evidence-grounded research brief from an approved intake card and audited local evidence ledger.
+license: MIT
+---
+
+# Research Brief
+
 Follow intake -> capture -> ledger -> audit -> write -> handoff. Write only from accepted evidence and label gaps, contradictions, exploratory claims, and human decisions. Include a provenance manifest, verification verdict, and executable handoff; do not invent citations, data, methods, or numerical results.
 
 For manuscript outputs, use continuous academic paragraphs rather than bullet-heavy notes. Apply a neutral submission format: Times New Roman for Latin text, SimSun/宋体 fallback for Chinese, black headings and body text, and no decorative color. Before finalization, ensure each factual or literature-dependent paragraph has a verified citation; if sources are insufficient, retrieve more or mark the section uncertain instead of fabricating references.

package/skills/core/research-intake/SKILL.md

@@ -1,9 +1,9 @@
----
-name: research-intake
-description: Turn a social-science research request into a bounded design card with paradigm, scope, ethics, and output contract.
-license: MIT
----
-
-# Research Intake
-
-Collect the research goal, paradigm, population or corpus, time range, language and geography, exploratory versus confirmatory status, ethics constraints, and desired output. Ask for missing blocking fields before any retrieval or analysis. Keep the design card in `.psyclaw/project.json` and never infer consent or access rights.
+---
+name: research-intake
+description: Turn a social-science research request into a bounded design card with paradigm, scope, ethics, and output contract.
+license: MIT
+---
+
+# Research Intake
+
+Collect the research goal, paradigm, population or corpus, time range, language and geography, exploratory versus confirmatory status, ethics constraints, and desired output. Ask for missing blocking fields before any retrieval or analysis. Keep the design card in `.psyclaw/project.json` and never infer consent or access rights.

package/dist/src/adapters/pi/extension.d.ts

@@ -1,19 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-type ToolTextContent = {
-    type: "text";
-    text: string;
-};
-interface ToolResultShape {
-    content: ToolTextContent[];
-    details: Record<string, unknown>;
-}
-/**
- * Explicit workflow dispatch shared by the workbench's direct (`workflow`
- * parameter) and natural-language routed paths, so every workflow result has
- * the same `psyclaw/workflow-result/v1` contract.
- */
-export declare function runWorkflowTool(root: string, workflow: string, target?: string, nStudies?: number): Promise<ToolResultShape>;
-/** Turn a natural-language meta-analysis request into a searchable target. */
-export declare function cleanMetaTarget(request: string): string;
-export default function psyclawExtension(pi: ExtensionAPI): void;
-export {};