psyclaw 0.26.3 → 0.27.0

package/dist/src/updates/update.js

@@ -1,5 +1,5 @@
 import { access } from "node:fs/promises";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { PI_AI, PI_CODING_AGENT, resolvePsyClawManifest } from "./manifest.js";
 import { compareSemver } from "./status.js";
 /** Reject anything that is not a plain, installable semver (guards the spawn). */
@@ -27,14 +27,171 @@ async function packageManagerAt(root) {
 }
 function buildCommand(manager, version) {
     const spec = `${PI_AI}@${version} ${PI_CODING_AGENT}@${version}`;
-    return manager === "pnpm" ? `pnpm add --save-exact ${spec}` : `npm install --save-exact ${spec}`;
+    return manager === "pnpm"
+        ? `pnpm add --save-exact ${spec}`
+        : `npm install --save-exact --omit=dev --legacy-peer-deps ${spec}`;
+}
+function buildProductCommand(version) {
+    return `npm install --global psyclaw@${version}`;
+}
+async function hasSourceLockfile(root) {
+    for (const file of ["pnpm-lock.yaml", "package-lock.json"]) {
+        try {
+            await access(join(root, file));
+            return true;
+        }
+        catch {
+            // keep looking
+        }
+    }
+    return false;
+}
+/**
+ * Update the installed PsyClaw product together with the exact Pi runtime
+ * declared by that release. Updating the whole product keeps PsyClaw's code,
+ * extensions, banner and tested runtime in one user-facing operation.
+ * Source checkouts are deliberately not overwritten; developers update them
+ * through Git and rebuild explicitly.
+ */
+export async function updatePsyClaw(options) {
+    const now = options.now ?? (() => new Date().toISOString());
+    const startedAt = now();
+    const finish = (receipt) => ({
+        schemaVersion: "psyclaw/product-update/v1",
+        startedAt,
+        finishedAt: now(),
+        ...receipt,
+    });
+    const manifest = await resolvePsyClawManifest(options.packageRoot);
+    const emptyRuntime = { packageName: PI_CODING_AGENT };
+    if (manifest === undefined) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: "psyclaw package.json not found",
+            psyclaw: { packageName: "psyclaw" },
+            runtime: emptyRuntime,
+            commands: [],
+        });
+    }
+    const psyclaw = { packageName: "psyclaw", before: manifest.version };
+    const runtime = {
+        packageName: PI_CODING_AGENT,
+        ...(manifest.piVersion === undefined ? {} : { before: manifest.piVersion }),
+    };
+    if (await hasSourceLockfile(manifest.root)) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: "source checkout detected; update with Git, then run pnpm install and pnpm build",
+            psyclaw,
+            runtime,
+            commands: [],
+        });
+    }
+    const publishedPsyClawVersion = await options.registry.latestNpm("psyclaw");
+    const latestDependencies = publishedPsyClawVersion === undefined
+        ? undefined
+        : await options.registry.npmDependencies("psyclaw", publishedPsyClawVersion);
+    const publishedPiVersion = latestDependencies?.[PI_CODING_AGENT];
+    if (publishedPsyClawVersion === undefined || publishedPiVersion === undefined) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: publishedPsyClawVersion === undefined
+                ? "latest PsyClaw release unavailable"
+                : "latest PsyClaw dependency manifest unavailable",
+            psyclaw: { ...psyclaw, ...(publishedPsyClawVersion === undefined ? {} : { latest: publishedPsyClawVersion }) },
+            runtime: { ...runtime, ...(publishedPiVersion === undefined ? {} : { latest: publishedPiVersion }) },
+            commands: [],
+        });
+    }
+    const latestPsyClaw = publishedPsyClawVersion;
+    const latestPi = publishedPiVersion;
+    if (!isSafeVersion(latestPsyClaw) || !isSafeVersion(latestPi)) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: !isSafeVersion(latestPsyClaw)
+                ? `refusing unsafe PsyClaw version: ${latestPsyClaw}`
+                : `refusing unsafe Pi version: ${latestPi}`,
+            psyclaw: { ...psyclaw, latest: latestPsyClaw },
+            runtime: { ...runtime, latest: latestPi },
+            commands: [],
+        });
+    }
+    const selfComparison = compareSemver(manifest.version, latestPsyClaw);
+    const runtimeComparison = manifest.piVersion === undefined ? null : compareSemver(manifest.piVersion, latestPi);
+    const selfNeedsUpdate = options.force === true || selfComparison === null || selfComparison < 0;
+    const runtimeNeedsRepair = selfComparison === 0 && runtimeComparison !== 0;
+    const commands = [];
+    // Reinstalling the product also installs its tested, exact Pi dependency.
+    // Force can repair a locally drifted runtime without composing an untested
+    // PsyClaw/Pi version pair.
+    if (selfNeedsUpdate || runtimeNeedsRepair) {
+        commands.push(buildProductCommand(latestPsyClaw));
+    }
+    const versions = {
+        psyclaw: { ...psyclaw, latest: latestPsyClaw },
+        runtime: { ...runtime, latest: latestPi },
+    };
+    if (commands.length === 0) {
+        return finish({
+            ok: true,
+            executed: false,
+            reasonCode: "already-up-to-date",
+            psyclaw: { ...versions.psyclaw, after: latestPsyClaw },
+            runtime: { ...versions.runtime, after: manifest.piVersion ?? latestPi },
+            commands,
+        });
+    }
+    if (options.executor === undefined) {
+        return finish({
+            ok: true,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: "check only: no changes applied",
+            ...versions,
+            commands,
+        });
+    }
+    for (const command of commands) {
+        // Do not keep the updater's cwd inside the package npm is replacing. This
+        // matters on Windows, where an in-use directory cannot be removed.
+        const { exitCode } = await options.executor({ command, cwd: dirname(manifest.root) });
+        if (exitCode !== 0) {
+            return finish({
+                ok: false,
+                executed: true,
+                reasonCode: "update-failed",
+                reason: `update command failed: ${command}`,
+                psyclaw: versions.psyclaw,
+                runtime: versions.runtime,
+                commands,
+                exitCode,
+            });
+        }
+    }
+    return finish({
+        ok: true,
+        executed: true,
+        reasonCode: "update-applied",
+        psyclaw: { ...versions.psyclaw, after: latestPsyClaw },
+        runtime: { ...versions.runtime, after: latestPi },
+        commands,
+        exitCode: 0,
+    });
 }
 /**
  * Update the bundled Pi runtime by re-pinning both `@earendil-works/pi-*`
  * packages to the latest official release. This is the write-side counterpart
- * to `checkUpdates`: it is `--yes`/executor-gated, refuses non-semver versions,
- * and always returns a structured receipt. Without an executor it is a pure
- * plan (no workspace mutation).
+ * to `checkUpdates`: it is executor-gated, refuses non-semver versions, and
+ * always returns a structured receipt. Without an executor it is a pure plan
+ * (no workspace mutation).
  */
 export async function updateBundledPi(options) {
     const now = options.now ?? (() => new Date().toISOString());
@@ -107,7 +264,7 @@ export async function updateBundledPi(options) {
             ok: true,
             executed: false,
             reasonCode: "update-skipped",
-            reason: "dry run: re-run with --yes to apply",
+            reason: "dry run: no executor provided",
             command,
             after: latestVersion,
             ...withLatest,

package/dist/src/updates/update.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyclaw",
-  "version": "0.26.3",
+  "version": "0.27.0",
   "description": "A standalone, evidence-grounded social-science research agent — a conversation-driven agent that bundles the Pi runtime with psyclaw's research contracts, evidence gates, and workflows",
   "type": "module",
   "license": "MIT",
@@ -58,8 +58,9 @@
     "prepublishOnly": "pnpm check:branding && pnpm build"
   },
   "dependencies": {
-    "@earendil-works/pi-ai": "0.84.1",
-    "@earendil-works/pi-coding-agent": "0.84.1",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
     "ink": "^7.1.1",
     "react": "^19.2.8",
     "typebox": "1.3.7",

package/scripts/rebrand-pi.mjs

@@ -8,7 +8,7 @@
  * 3. 3D 侧影电路方块字 (3D Isometric Shadow Block: ██████╗)
  * 4. 学术罗马衬线体 (Academic Roman Serif: ╔══╗)
  *
- * Pets are opt-in via /pet and only render when the terminal is wide enough.
+ * Pets are opt-in via /pet and render below the primary wordmark.
  */
 import { execFile } from "node:child_process";
 import { readFile, rename, rm, writeFile } from "node:fs/promises";
@@ -17,7 +17,7 @@ import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const NAME = "PsyClaw";
-const LOCKED_PI_VERSION = "0.84.1";
+const LOCKED_PI_VERSION = "0.84.4";
 // Retain the predecessor Pi profile so existing models, themes, packages, and
 // skills survive the product rename. PsyClaw's project data remains separate.
 const CONFIG_DIR = `.psy${"pi"}`;
@@ -106,15 +106,16 @@ function buildCustomVariant(fontLines, dogLines = []) {
   return `[\n${rows.join(",\n")}\n  ]`;
 }
 
-// Every default variant is pet-free. Pet variants are selected only when
-// PSYCLAW_PET=1 and the complete row fits the current terminal.
+// Every default variant is pet-free. The pet is appended below the wordmark
+// when enabled so it never forces PsyClaw's primary branding into a smaller
+// layout.
 const VAR_COMPACT = `[
     \`  \\x1b[1m${GRAD_2ROW_0}\\x1b[0m   \\x1b[38;2;148;163;184mv\${process.env.PSYCLAW_VERSION ?? this.version}\\x1b[0m\`,
     \`  \\x1b[1m${GRAD_2ROW_1}\\x1b[0m\`
   ]`;
-const VAR_COMPACT_PET = `[
-    \`  \\x1b[1m${GRAD_2ROW_0}\\x1b[0m   ${PUP_SCHOLAR_TOP}\`,
-    \`  \\x1b[1m${GRAD_2ROW_1}\\x1b[0m   ${PUP_SCHOLAR_BOT}\`
+const VAR_STACKED_PET = `[
+    \`  ${PUP_SCHOLAR_TOP}\`,
+    \`  ${PUP_SCHOLAR_BOT}\`
   ]`;
 const VAR_SLANT_CLASSIC = buildCustomVariant(FONT_SLANT_CLASSIC);
 const VAR_3D_BLOCK = buildCustomVariant(FONT_3D_BLOCK);
@@ -127,7 +128,6 @@ const PSYCLAW_DYNAMIC_BANNER = `const bannerCandidates = [
   ${VAR_COMPACT}, ${VAR_SLANT_CLASSIC}, ${VAR_3D_BLOCK}, ${VAR_SERIF},
 ];
 const compactBanner = ${VAR_COMPACT};
-const petBanner = ${VAR_COMPACT_PET};
 const terminalColumns = process.stdout.columns ?? 80;
 const ansiPattern = /\\x1b\\[[0-9;]*m/g;
 const cellWidth = (text) => Array.from(text.replace(ansiPattern, "")).reduce((width, char) => {
@@ -143,10 +143,13 @@ const fittingBanners = bannerCandidates.filter((rows) => bannerWidth(rows) <= te
 const tinyBanner = [terminalColumns >= 22
   ? \`  ψ PsyClaw v\${process.env.PSYCLAW_VERSION ?? this.version}\`
   : "  PsyClaw"];
-const defaultPool = fittingBanners.length > 0 ? fittingBanners : [tinyBanner];
-const chosenBanner = process.env.PSYCLAW_PET === "1" && bannerWidth(petBanner) <= terminalColumns - 4
-  ? petBanner
-  : defaultPool[Math.floor(Math.random() * defaultPool.length)];
+const chosenBanner = fittingBanners.reduce((largest, candidate) => {
+  if (!largest) return candidate;
+  if (candidate.length !== largest.length) return candidate.length > largest.length ? candidate : largest;
+  return bannerWidth(candidate) > bannerWidth(largest) ? candidate : largest;
+}, undefined) ?? tinyBanner;
+const petEnabled = process.env.PSYCLAW_PET === "1";
+const stackedPet = petEnabled ? ${VAR_STACKED_PET} : [];
 const detailLines = terminalColumns >= 86 ? [
   \`  ${GRAD_PIPELINE}\`,
   \`  ${GRAD_PROTOCOL}\`,
@@ -155,6 +158,7 @@ if (terminalColumns >= 76) detailLines.push(\`  ${GRAD_WORKBENCH}\`);
 const logo = [
   "",
   ...chosenBanner,
+  ...stackedPet,
   "",
   ...detailLines,
   "",

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/skills/recommended/catalog.json

@@ -1,11 +1,12 @@
 {
   "schemaVersion": "psyclaw/recommended-skills/v1",
-  "documentVersion": "0.2.0",
+  "documentVersion": "0.3.0",
+  "syncedAt": "2026-08-29",
   "sourceDocument": "学术AI_Skill分享资料.pdf",
   "sourceRef": "local-user-curated",
   "items": [
     { "id": "markitdown", "name": "MarkItDown", "kind": "skill", "stage": "统一", "description": "把 PDF、Word、PPT、Excel、HTML 等转换为结构化 Markdown。", "sourceRef": "https://github.com/microsoft/markitdown" },
-    { "id": "markitdown-pro", "name": "MarkItDown Pro", "kind": "skill", "stage": "统一", "description": "字幕优先、转录回退，把 B 站课程和讲座转成带来源状态的 Markdown。", "sourceRef": "https://github.com/LHT666-hub/markItdown-pro" },
+    { "id": "markitdown-bilibili", "name": "MarkItDown + Bilibili", "kind": "skill", "stage": "统一", "description": "字幕优先、转录回退，把 B 站课程和讲座转成带来源状态的 Markdown。", "sourceRef": "https://github.com/LHT666-hub/markItdown-pro" },
     { "id": "session-handoff", "name": "Session Handoff", "kind": "skill", "stage": "接力", "description": "把长任务的目标、进度、阻塞和下一步写成可核验的交接状态。", "sourceRef": "https://github.com/LHT666-hub/session-handoff" },
     { "id": "paper-search-mcp", "name": "Paper Search MCP", "kind": "mcp", "stage": "检索", "description": "统一 arXiv、PubMed、OpenAlex、Crossref 等开放来源的论文检索和去重。", "sourceRef": "https://github.com/openags/paper-search-mcp" },
     { "id": "zotero-translators", "name": "Zotero Translators", "kind": "skill", "stage": "题录", "description": "从出版社和数据库页面提取规范题录、DOI、PDF 和补充材料。", "sourceRef": "https://github.com/zotero/translators" },
@@ -27,26 +28,26 @@
     { "id": "orca-computer-use", "name": "Orca Computer Use", "kind": "integration", "stage": "Computer Use", "description": "本机已有的桌面可视化控制能力，通过 Orca 的版本化 CLI 读取窗口、无障碍树和截图并执行安全操作。", "sourceRef": "local: computer-use skill / ORCA CLI", "status": "available-if-orca" }
   ],
   "installPrep": [
-    {"id":"markitdown","sourceKind":"github","ref":"fd239d5d2be43d9b68329730206b9312c7d5a388","license":"MIT","command":"python -m pip install markitdown","target":".psyclaw/imports/recommended/markitdown","dependencies":["Python >=3.10"],"status":"review-required","requiresApproval":true,"blockedReason":"Package install is not content-pinned; verify the PyPI version before execution."},
-    {"id":"markitdown-pro","sourceKind":"github","ref":"a601bb294f57dc03a681d2b9fa91d4bb5627bd2f","license":"MIT","command":"git clone https://github.com/LHT666-hub/markItdown-pro .psyclaw/imports/recommended/markitdown-pro && git -C .psyclaw/imports/recommended/markitdown-pro checkout a601bb294f57dc03a681d2b9fa91d4bb5627bd2f","target":".psyclaw/imports/recommended/markitdown-pro","dependencies":["Git","Python runtime per repository metadata"],"status":"review-required","requiresApproval":true,"blockedReason":"Repository license is verified, but dependency lock and Skill entrypoint still require preflight."},
-    {"id":"paper-search-mcp","sourceKind":"github","ref":"c8b642183bb725f0a7faec89e58b558df09079d1","license":"MIT","command":"git clone https://github.com/openags/paper-search-mcp .psyclaw/mcp-src/paper-search-mcp && git -C .psyclaw/mcp-src/paper-search-mcp checkout c8b642183bb725f0a7faec89e58b558df09079d1","target":".psyclaw/mcp/paper-search-mcp.json","dependencies":["Git","Python/uv per repository metadata"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify package entrypoint and lockfile before registering a stdio server."},
-    {"id":"session-handoff","sourceKind":"github","ref":"e18e41900953e0126b6beb0b24387bbaf2178f44","license":"MIT","command":"git clone https://github.com/LHT666-hub/session-handoff .psyclaw/imports/recommended/session-handoff && git -C .psyclaw/imports/recommended/session-handoff checkout e18e41900953e0126b6beb0b24387bbaf2178f44","target":".psyclaw/imports/recommended/session-handoff","dependencies":["Git"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify SKILL.md and dependency tree before activation."},
-    {"id":"zotero-translators","sourceKind":"github","ref":"master","license":"unknown","command":"git clone https://github.com/zotero/translators .psyclaw/imports/recommended/zotero-translators && git -C .psyclaw/imports/recommended/zotero-translators checkout master","target":".psyclaw/imports/recommended/zotero-translators","dependencies":["Git","Zotero-compatible translator runtime"],"status":"blocked","requiresApproval":true,"blockedReason":"License and immutable commit were not verified in the current preflight."},
-    {"id":"scansci-pdf","sourceKind":"github","ref":"master","license":"Apache-2.0","command":"git clone https://github.com/Rimagination/scansci-pdf .psyclaw/imports/recommended/scansci-pdf && git -C .psyclaw/imports/recommended/scansci-pdf checkout master","target":".psyclaw/imports/recommended/scansci-pdf","dependencies":["Git","repository runtime requirements"],"status":"review-required","requiresApproval":true,"blockedReason":"Immutable commit and executable Skill entrypoint still require preflight."},
+    {"id":"markitdown","sourceKind":"github","ref":"9dc0d6579b8739c9d0671ff205e071e3053c7df1","license":"MIT","command":"python -m pip install markitdown","target":".psyclaw/imports/recommended/markitdown","dependencies":["Python >=3.10"],"status":"review-required","requiresApproval":true,"blockedReason":"Package install is not content-pinned; verify the PyPI version before execution."},
+    {"id":"markitdown-bilibili","sourceKind":"github","sourceUrl":"https://github.com/LHT666-hub/markItdown-pro.git","ref":"a601bb294f57dc03a681d2b9fa91d4bb5627bd2f","skillPath":"markitdown-bilibili","skillName":"markitdown-bilibili","license":"MIT","target":".psyclaw/imports/recommended/markitdown-bilibili","dependencies":["Python >=3.10","markitdown[all]","yt-dlp","FFmpeg (optional for transcription)"],"status":"review-required","requiresApproval":true,"blockedReason":"Runtime dependencies are installed separately and must pass the Skill doctor before conversion."},
+    {"id":"paper-search-mcp","sourceKind":"github","ref":"234678ab231074a7977320978ee0496dcdaddd1f","license":"MIT","command":"git clone https://github.com/openags/paper-search-mcp .psyclaw/mcp-src/paper-search-mcp && git -C .psyclaw/mcp-src/paper-search-mcp checkout 234678ab231074a7977320978ee0496dcdaddd1f","target":".psyclaw/mcp/paper-search-mcp.json","dependencies":["Git","Python/uv per repository metadata"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify package entrypoint and lockfile before registering a stdio server."},
+    {"id":"session-handoff","sourceKind":"github","sourceUrl":"https://github.com/LHT666-hub/session-handoff.git","ref":"e18e41900953e0126b6beb0b24387bbaf2178f44","skillPath":"session-handoff","skillName":"session-handoff","license":"MIT","target":".psyclaw/imports/recommended/session-handoff","dependencies":[],"status":"review-required","requiresApproval":true,"blockedReason":"Install manifest and content hash must pass validation before activation."},
+    {"id":"zotero-translators","sourceKind":"github","ref":"409a58d4a84c4e2bb5a673aaf018595ba0767b46","license":"unknown","command":"git clone https://github.com/zotero/translators .psyclaw/imports/recommended/zotero-translators && git -C .psyclaw/imports/recommended/zotero-translators checkout 409a58d4a84c4e2bb5a673aaf018595ba0767b46","target":".psyclaw/imports/recommended/zotero-translators","dependencies":["Git","Zotero-compatible translator runtime"],"status":"blocked","requiresApproval":true,"blockedReason":"License was not verified in the current preflight."},
+    {"id":"scansci-pdf","sourceKind":"github","ref":"8278ff83d97f3296f8d0a456efe5e0b71b9f2f44","license":"Apache-2.0","command":"git clone https://github.com/Rimagination/scansci-pdf .psyclaw/imports/recommended/scansci-pdf && git -C .psyclaw/imports/recommended/scansci-pdf checkout 8278ff83d97f3296f8d0a456efe5e0b71b9f2f44","target":".psyclaw/imports/recommended/scansci-pdf","dependencies":["Git","repository runtime requirements"],"status":"review-required","requiresApproval":true,"blockedReason":"Executable Skill entrypoint and dependencies still require preflight."},
     {"id":"scholarbridge","sourceKind":"github","ref":"8e16393534068f4f1e18dfe5ce3b1c15a94a02c4","license":"unknown","command":"git clone https://github.com/LHT666-hub/ScholarBridge .psyclaw/imports/recommended/scholarbridge && git -C .psyclaw/imports/recommended/scholarbridge checkout 8e16393534068f4f1e18dfe5ce3b1c15a94a02c4","target":".psyclaw/imports/recommended/scholarbridge","dependencies":["Git"],"status":"blocked","requiresApproval":true,"blockedReason":"Repository license is not declared by GitHub metadata."},
     {"id":"mentorforge","sourceKind":"github","ref":"14de3bc28ee7e74273c69fc3e4672426f4b335d0","license":"MIT","command":"git clone https://github.com/qwqalice/MentorForge .psyclaw/imports/recommended/mentorforge && git -C .psyclaw/imports/recommended/mentorforge checkout 14de3bc28ee7e74273c69fc3e4672426f4b335d0","target":".psyclaw/imports/recommended/mentorforge","dependencies":["Git"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify Skill entrypoint and runtime dependencies before activation."},
     {"id":"supervisor-skills","sourceKind":"github","ref":"aff5de9e5b902df0ef51e955d4c78b22793d763a","license":"NOASSERTION","command":"git clone https://github.com/HKUSTDial/Supervisor-Skills .psyclaw/imports/recommended/supervisor-skills && git -C .psyclaw/imports/recommended/supervisor-skills checkout aff5de9e5b902df0ef51e955d4c78b22793d763a","target":".psyclaw/imports/recommended/supervisor-skills","dependencies":["Git"],"status":"blocked","requiresApproval":true,"blockedReason":"License requires human review before installation."},
-    {"id":"openkb","sourceKind":"github","ref":"master","license":"Apache-2.0","command":"git clone https://github.com/VectifyAI/OpenKB .psyclaw/imports/recommended/openkb && git -C .psyclaw/imports/recommended/openkb checkout master","target":".psyclaw/imports/recommended/openkb","dependencies":["Git","repository runtime requirements"],"status":"review-required","requiresApproval":true,"blockedReason":"Immutable commit and dependency lock still require preflight."},
-    {"id":"corpus2skill","sourceKind":"github","ref":"e1f036154014d3833f0dabb831115be52ba98aa4","license":"unknown","command":"git clone https://github.com/dukesun99/Corpus2Skill .psyclaw/imports/recommended/corpus2skill && git -C .psyclaw/imports/recommended/corpus2skill checkout e1f036154014d3833f0dabb831115be52ba98aa4","target":".psyclaw/imports/recommended/corpus2skill","dependencies":["Git"],"status":"blocked","requiresApproval":true,"blockedReason":"License is not verified."},
-    {"id":"academic-reference-matcher","sourceKind":"github","ref":"189a5ddbeaca8e1a594c28ac5d4c694741c01db9","license":"MIT","command":"git clone https://github.com/keros68/academic-reference-matcher .psyclaw/imports/recommended/academic-reference-matcher && git -C .psyclaw/imports/recommended/academic-reference-matcher checkout 189a5ddbeaca8e1a594c28ac5d4c694741c01db9","target":".psyclaw/imports/recommended/academic-reference-matcher","dependencies":["Git"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify entrypoint and dependency lock before activation."},
+    {"id":"openkb","sourceKind":"github","ref":"ff54396e575ee6feb0113b631a34caa082b441cc","license":"Apache-2.0","command":"git clone https://github.com/VectifyAI/OpenKB .psyclaw/imports/recommended/openkb && git -C .psyclaw/imports/recommended/openkb checkout ff54396e575ee6feb0113b631a34caa082b441cc","target":".psyclaw/imports/recommended/openkb","dependencies":["Git","repository runtime requirements"],"status":"review-required","requiresApproval":true,"blockedReason":"Dependency lock still requires preflight."},
+    {"id":"corpus2skill","sourceKind":"github","ref":"bdc1e436d97d2b3559b284ff04056178d2677f90","license":"unknown","command":"git clone https://github.com/dukesun99/Corpus2Skill .psyclaw/imports/recommended/corpus2skill && git -C .psyclaw/imports/recommended/corpus2skill checkout bdc1e436d97d2b3559b284ff04056178d2677f90","target":".psyclaw/imports/recommended/corpus2skill","dependencies":["Git"],"status":"blocked","requiresApproval":true,"blockedReason":"License is not verified."},
+    {"id":"academic-reference-matcher","sourceKind":"github","sourceUrl":"https://github.com/keros68/academic-reference-matcher.git","ref":"189a5ddbeaca8e1a594c28ac5d4c694741c01db9","skillPath":".","skillName":"academic-reference-matcher","license":"MIT","target":".psyclaw/imports/recommended/academic-reference-matcher","dependencies":[],"status":"review-required","requiresApproval":true,"blockedReason":"Install manifest and content hash must pass validation before activation."},
     {"id":"pskoett-ai-skills","sourceKind":"github","ref":"20e64cec1529d9c371fdcc20c751b7ef10b68af7","license":"unknown","command":"git clone https://github.com/pskoett/pskoett-ai-skills .psyclaw/imports/recommended/pskoett-ai-skills && git -C .psyclaw/imports/recommended/pskoett-ai-skills checkout 20e64cec1529d9c371fdcc20c751b7ef10b68af7","target":".psyclaw/imports/recommended/pskoett-ai-skills","dependencies":["Git"],"status":"blocked","requiresApproval":true,"blockedReason":"License is not verified."},
     {"id":"omnidistill","sourceKind":"github","ref":"109141d0f55c0dbaac2563bcf700d6ef99c39f6b","license":"unknown","command":"git clone https://github.com/LHT666-hub/OmniDistill .psyclaw/imports/recommended/omnidistill && git -C .psyclaw/imports/recommended/omnidistill checkout 109141d0f55c0dbaac2563bcf700d6ef99c39f6b","target":".psyclaw/imports/recommended/omnidistill","dependencies":["Git"],"status":"blocked","requiresApproval":true,"blockedReason":"License is not verified."},
     {"id":"smartplot","sourceKind":"website","ref":null,"license":"unknown","command":null,"target":null,"dependencies":[],"status":"blocked","requiresApproval":true,"blockedReason":"Source is a website rather than a verified package repository."},
     {"id":"ars-academic-research-skill","sourceKind":"user-provided","ref":null,"license":"unknown","command":null,"target":".psyclaw/imports/recommended/ars-academic-research-skill","dependencies":[],"status":"blocked","requiresApproval":true,"blockedReason":"User-provided source/ref is still required."},
     {"id":"nature-skill-suite","sourceKind":"local","ref":null,"license":"unknown","command":"copy reviewed nature-* skills into .psyclaw/imports/recommended/nature-skill-suite","target":".psyclaw/imports/recommended/nature-skill-suite","dependencies":["local skill source"],"status":"review-required","requiresApproval":true,"blockedReason":"Each local Skill needs independent source, version, hash, license and dependency evidence."},
-    {"id":"playwright-mcp","sourceKind":"github","ref":"7e0457a7cbf88823bf0146d12c46ae12c6818247","license":"Apache-2.0","command":"npx -y @playwright/mcp@latest","target":".psyclaw/mcp/playwright-mcp.json","dependencies":["Node.js >=18","npm or pnpm"],"status":"review-required","requiresApproval":true,"blockedReason":"npm package version must be pinned before execution; browser-session access requires a separate approval."},
+    {"id":"playwright-mcp","sourceKind":"github","ref":"d0c29a5658b93b6e62435ceaf362a7d7dfc3522d","license":"Apache-2.0","command":"npx -y @playwright/mcp@latest","target":".psyclaw/mcp/playwright-mcp.json","dependencies":["Node.js >=18","npm or pnpm"],"status":"review-required","requiresApproval":true,"blockedReason":"npm package version must be pinned before execution; browser-session access requires a separate approval."},
     {"id":"browserbase-stagehand-mcp","sourceKind":"github","ref":"3e6f53461949037d5e65dd425da3ceb1263f11d6","license":"Apache-2.0","command":"npm install --save-dev @browserbasehq/stagehand","target":".psyclaw/mcp/browserbase-stagehand-mcp.json","dependencies":["Node.js","Browserbase credentials if hosted"],"status":"blocked","requiresApproval":true,"blockedReason":"Repository is archived and hosted use requires credentials; do not enable automatically."},
-    {"id":"computer-use-mcp","sourceKind":"github","ref":"main","license":"MIT","command":"git clone https://github.com/zavora-ai/computer-use-mcp .psyclaw/imports/recommended/computer-use-mcp && git -C .psyclaw/imports/recommended/computer-use-mcp checkout main","target":".psyclaw/mcp/computer-use-mcp.json","dependencies":["Git","OS accessibility permissions"],"status":"review-required","requiresApproval":true,"blockedReason":"Immutable commit and desktop control permissions require preflight."},
+    {"id":"computer-use-mcp","sourceKind":"github","ref":"5e52308f1ca667cb1433cfd99065fb792db44652","license":"MIT","command":"git clone https://github.com/zavora-ai/computer-use-mcp .psyclaw/imports/recommended/computer-use-mcp && git -C .psyclaw/imports/recommended/computer-use-mcp checkout 5e52308f1ca667cb1433cfd99065fb792db44652","target":".psyclaw/mcp/computer-use-mcp.json","dependencies":["Git","OS accessibility permissions"],"status":"review-required","requiresApproval":true,"blockedReason":"Desktop control permissions require preflight."},
     {"id":"orca-computer-use","sourceKind":"local","ref":null,"license":"unknown","command":"use installed Orca computer-use integration after capability check","target":".psyclaw/mcp/orca-computer-use.json","dependencies":["Orca CLI"],"status":"review-required","requiresApproval":true,"blockedReason":"Local Orca version and manifest must be checked at runtime."}
   ]
 }