psyclaw 0.25.1 → 0.26.0

package/dist/src/tui/app.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text, render, useApp, useInput } from "ink";
+import { spawn } from "node:child_process";
+import { discoverAgents } from "../agents/discover.js";
+import { importAgentSkills } from "../agents/import.js";
+import { planAgentInstall, runInstall } from "../install/installer.js";
+import { agentTableLines } from "./model.js";
+import { PSYCLAW_ACCENT, PSYCLAW_ERROR, PSYCLAW_OK } from "../branding.js";
+function spawnRunner(command) {
+    const [bin, ...args] = command.split(/\s+/).filter(Boolean);
+    return new Promise((resolve) => {
+        const child = spawn(bin, args, { stdio: "ignore", shell: false });
+        child.on("error", () => resolve({ exitCode: 1 }));
+        child.on("close", (code) => resolve({ exitCode: code ?? 1 }));
+    });
+}
+function Banner() {
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { gap: 1, alignItems: "center", children: [_jsx(Text, { color: PSYCLAW_ACCENT, bold: true, children: "\u03C8 PsyClaw shell" }), _jsx(Text, { color: "black", backgroundColor: PSYCLAW_ACCENT, bold: true, children: " TUI " }), _jsx(Text, { dimColor: true, children: "\u667A\u80FD\u4F53\u751F\u6001\u4E0E\u6280\u80FD\u7BA1\u7406 \u00B7 \u53EA\u8BFB\u53D1\u73B0\uFF0C\u663E\u5F0F\u6388\u6743" })] }), _jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" })] }));
+}
+function Hint({ children }) {
+    return (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["\uD83D\uDCA1 ", children] }) }));
+}
+function App({ root, homeDir }) {
+    const { exit } = useApp();
+    const [scans, setScans] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [selected, setSelected] = useState(0);
+    const [mode, setMode] = useState("browse");
+    const [message, setMessage] = useState([]);
+    const [resultOk, setResultOk] = useState(true);
+    const refresh = async () => {
+        setLoading(true);
+        setScans(await discoverAgents({ ...(homeDir === undefined ? {} : { homeDir }) }));
+        setLoading(false);
+    };
+    useEffect(() => {
+        void refresh();
+    }, []);
+    const current = scans[selected];
+    useInput(async (input, key) => {
+        if (mode === "browse") {
+            if (key.upArrow)
+                setSelected((value) => Math.max(0, value - 1));
+            if (key.downArrow)
+                setSelected((value) => Math.min(Math.max(0, scans.length - 1), value + 1));
+            if (input === "r")
+                await refresh();
+            if (input === "i" && current?.found)
+                setMode("install-confirm");
+            if (input === "m" && current?.found)
+                setMode("import-confirm");
+            if (input === "q")
+                exit();
+            return;
+        }
+        if (mode === "install-confirm" && current) {
+            if (input === "y") {
+                setMessage(["正在执行安装…"]);
+                const receipt = await runInstall(planAgentInstall(current), { approved: true, actor: "researcher", reason: "tui" }, spawnRunner);
+                setResultOk(receipt.ok);
+                setMessage([`${receipt.ok ? "✔" : "✗"} ${current.name}: ${receipt.ok ? "已成功安装" : `安装失败 (${receipt.reasonCode ?? "unknown"})`}`]);
+                setMode("result");
+            }
+            if (input === "n" || key.escape)
+                setMode("browse");
+            return;
+        }
+        if (mode === "import-confirm" && current) {
+            if (input === "y") {
+                const result = await importAgentSkills({
+                    root,
+                    agent: current,
+                    approval: { approved: true, actor: "researcher", reason: "tui" },
+                });
+                setResultOk(true);
+                setMessage([`✔ 已从 ${current.name} 导入 ${result.importedCount} 个学术技能`, `产物清单: ${result.manifestPath}`]);
+                setMode("result");
+            }
+            if (input === "n" || key.escape)
+                setMode("browse");
+            return;
+        }
+        if (mode === "result" && (input === "q" || key.escape)) {
+            setMode("browse");
+        }
+    });
+    const table = agentTableLines(scans);
+    return (_jsxs(Box, { borderStyle: "round", borderColor: PSYCLAW_ACCENT, paddingX: 2, paddingY: 1, flexDirection: "column", children: [_jsx(Banner, {}), _jsx(Box, { flexDirection: "column", marginY: 1, children: loading
+                    ? _jsx(Text, { dimColor: true, children: "\u6B63\u5728\u626B\u63CF\u672C\u673A\u5DF2\u5B89\u88C5\u667A\u80FD\u4F53\u2026" })
+                    : table.map((line, index) => {
+                        if (index === 0)
+                            return _jsx(Text, { bold: true, color: PSYCLAW_ACCENT, children: line }, "header");
+                        if (index === 1)
+                            return _jsx(Text, { dimColor: true, children: line }, "divider");
+                        const isSelected = index === selected + 2;
+                        return (_jsxs(Box, { children: [_jsx(Text, { color: isSelected ? PSYCLAW_ACCENT : "gray", bold: isSelected, children: isSelected ? "❯ " : "  " }), isSelected ? (_jsx(Text, { bold: true, color: PSYCLAW_ACCENT, children: line })) : (_jsx(Text, { children: line }))] }, `${index}:${line}`));
+                    }) }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Hint, { children: "[\u2191/\u2193] \u9009\u62E9 \u00B7 [R] \u5237\u65B0 \u00B7 [I] \u5B89\u88C5\u6269\u5C55 \u00B7 [M] \u5BFC\u5165\u6280\u80FD \u00B7 [Q] \u9000\u51FA" }), mode === "install-confirm" && current && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: PSYCLAW_ACCENT, bold: true, children: ["\u279C \u786E\u8BA4\u5B89\u88C5 ", current.name, "\uFF1F(\u6309 Y \u786E\u8BA4\uFF0CN \u53D6\u6D88)"] }), _jsxs(Text, { dimColor: true, children: ["\u6267\u884C\u547D\u4EE4: ", current.install?.installCommand || "无自动化命令（需手动安装）"] })] })), mode === "import-confirm" && current && (_jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsxs(Text, { color: PSYCLAW_ACCENT, bold: true, children: ["\u279C \u786E\u8BA4\u5C06 ", current.name, " \u7684 ", current.skills.length, " \u4E2A\u6280\u80FD\u5BFC\u5165 .psyclaw/imports\uFF1F(\u6309 Y \u786E\u8BA4\uFF0CN \u53D6\u6D88)"] }) })), mode === "result" && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [message.map((line) => (_jsx(Text, { color: resultOk ? PSYCLAW_OK : PSYCLAW_ERROR, bold: true, children: line }, line))), _jsx(Text, { dimColor: true, children: "[Q / Esc] \u8FD4\u56DE\u5217\u8868" })] }))] })] }));
+}
+export function runTui(root, options = {}) {
+    render(_jsx(App, { root: root, ...(options.homeDir === undefined ? {} : { homeDir: options.homeDir }) }), { stdout: process.stdout, exitOnCtrlC: true });
+}
+//# sourceMappingURL=app.js.map

package/dist/src/tui/app.js.map

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

package/dist/src/tui/model.d.ts

@@ -0,0 +1,13 @@
+import type { AgentScan } from "../agents/discover.js";
+export interface AgentRow {
+    name: string;
+    status: string;
+    skills: string;
+    config: string;
+    creds: string;
+    method: string;
+}
+export declare function agentRows(scans: readonly AgentScan[]): AgentRow[];
+export declare const AGENT_HEADERS: readonly ["name", "status", "skills", "creds", "method", "config"];
+export declare function renderTable(headers: readonly string[], rows: readonly (readonly string[])[]): string[];
+export declare function agentTableLines(scans: readonly AgentScan[]): string[];

package/dist/src/tui/model.js

@@ -0,0 +1,25 @@
+export function agentRows(scans) {
+    return scans.map((scan) => ({
+        name: scan.name,
+        status: scan.found ? "found" : "not found",
+        skills: String(scan.skills.length),
+        config: scan.configPath ?? "—",
+        creds: scan.hasCredentials ? "yes" : "no",
+        method: scan.install?.method ?? "—",
+    }));
+}
+export const AGENT_HEADERS = ["name", "status", "skills", "creds", "method", "config"];
+export function renderTable(headers, rows) {
+    const widths = headers.map((header, column) => {
+        const cellLengths = rows.map((row) => row[column]?.length ?? 0);
+        return Math.max(header.length, ...cellLengths);
+    });
+    const format = (cells) => cells.map((cell, column) => (cell ?? "").padEnd(widths[column] ?? 0)).join("  ");
+    const divider = headers.map((_header, column) => "-".repeat(widths[column] ?? 0)).join("  ");
+    return [format(headers), divider, ...rows.map(format)];
+}
+export function agentTableLines(scans) {
+    const rows = agentRows(scans).map((row) => [row.name, row.status, row.skills, row.creds, row.method, row.config]);
+    return renderTable([...AGENT_HEADERS], rows);
+}
+//# sourceMappingURL=model.js.map

package/dist/src/tui/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/tui/model.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,SAAS,CAAC,KAA2B;IACnD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;QAC1C,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAClC,MAAM,EAAE,IAAI,CAAC,UAAU,IAAI,GAAG;QAC9B,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACzC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG;KACpC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEhG,MAAM,UAAU,WAAW,CACzB,OAA0B,EAC1B,IAAoC;IAEpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,KAAwB,EAAU,EAAE,CAClD,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7F,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClH,OAAO,WAAW,CAAC,CAAC,GAAG,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/updates/check.d.ts

@@ -0,0 +1,43 @@
+import { type SkillDrift } from "./skills.js";
+import { type UpdateStatus } from "./status.js";
+import { type RegistryClient } from "./registry.js";
+export interface SelfUpdate {
+    current: string;
+    latest?: string;
+    status: UpdateStatus;
+}
+/** The bundled Pi runtime: psyclaw's pinned dependency vs the official latest. */
+export interface PiRuntimeUpdate {
+    packageName: string;
+    current?: string;
+    latest?: string;
+    note?: string;
+    status: UpdateStatus;
+}
+export interface AgentUpdate {
+    id: string;
+    name: string;
+    method: string;
+    ref: string;
+    latest?: string;
+    status: UpdateStatus;
+}
+export interface UpdateReport {
+    schemaVersion: "psyclaw/update-report/v1";
+    checkedAt: string;
+    self: SelfUpdate;
+    runtime: PiRuntimeUpdate;
+    agents: AgentUpdate[];
+    skills: SkillDrift[];
+}
+export interface CheckUpdatesOptions {
+    registry: RegistryClient;
+    cwd: string;
+    now?: () => string;
+}
+/**
+ * Build an update report: psyclaw itself, its bundled Pi runtime, each
+ * installable agent, and imported skill drift. All registry lookups fail
+ * closed to `undefined`; nothing here installs or modifies state.
+ */
+export declare function checkUpdates(options: CheckUpdatesOptions): Promise<UpdateReport>;

package/dist/src/updates/check.js

@@ -0,0 +1,68 @@
+import { KNOWN_AGENTS } from "../agents/catalog.js";
+import { checkSkillDrift } from "./skills.js";
+import { isUnpinnedRef, versionStatus } from "./status.js";
+import { npmPackageName, pipxPackageName } from "./registry.js";
+import { PI_CODING_AGENT, resolvePsyClawManifest } from "./manifest.js";
+/**
+ * Build an update report: psyclaw itself, its bundled Pi runtime, each
+ * installable agent, and imported skill drift. All registry lookups fail
+ * closed to `undefined`; nothing here installs or modifies state.
+ */
+export async function checkUpdates(options) {
+    const manifest = await resolvePsyClawManifest();
+    const current = manifest?.version ?? "unknown";
+    const selfLatest = await options.registry.latestNpm("psyclaw");
+    const self = {
+        current,
+        ...(selfLatest === undefined ? {} : { latest: selfLatest }),
+        status: selfLatest === undefined ? "not-published" : versionStatus(current, selfLatest),
+    };
+    const piRelease = await options.registry.latestPiRelease();
+    const piVersion = manifest?.piVersion;
+    const piNote = piRelease?.note;
+    const runtime = {
+        packageName: PI_CODING_AGENT,
+        ...(piVersion === undefined ? {} : { current: piVersion }),
+        ...(piRelease === undefined ? {} : { latest: piRelease.version }),
+        ...(piNote === undefined ? {} : { note: piNote }),
+        status: piRelease === undefined ? "unavailable" : versionStatus(piVersion, piRelease.version),
+    };
+    const agents = [];
+    for (const agent of KNOWN_AGENTS) {
+        const install = agent.install;
+        if (!install)
+            continue;
+        let latest;
+        if (install.method === "npm") {
+            const packageName = npmPackageName(install.installCommand);
+            if (packageName !== undefined)
+                latest = await options.registry.latestNpm(packageName);
+        }
+        else if (install.method === "pipx") {
+            const packageName = pipxPackageName(install.installCommand);
+            if (packageName !== undefined)
+                latest = await options.registry.latestPypi(packageName);
+        }
+        agents.push({
+            id: agent.id,
+            name: agent.name,
+            method: install.method,
+            ref: install.ref,
+            ...(latest === undefined ? {} : { latest }),
+            status: isUnpinnedRef(install.ref) ? "unpinned" : versionStatus(install.ref, latest),
+        });
+    }
+    const skills = [];
+    for (const agent of KNOWN_AGENTS) {
+        skills.push(await checkSkillDrift(options.cwd, agent.id));
+    }
+    return {
+        schemaVersion: "psyclaw/update-report/v1",
+        checkedAt: (options.now ?? (() => new Date().toISOString()))(),
+        self,
+        runtime,
+        agents,
+        skills,
+    };
+}
+//# sourceMappingURL=check.js.map

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

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

package/dist/src/updates/manifest.d.ts

@@ -0,0 +1,19 @@
+/** The two official Pi packages psyclaw pins and bumps in lockstep. */
+export declare const PI_AI = "@earendil-works/pi-ai";
+export declare const PI_CODING_AGENT = "@earendil-works/pi-coding-agent";
+export interface PsyClawManifest {
+    root: string;
+    version: string;
+    piVersion?: string;
+    piAiVersion?: string;
+    packageManager?: string;
+}
+/** Synchronous psyclaw version read (banner, branding) — same walk as the resolver. */
+export declare function readPsyClawVersionSync(startDir?: string): string | undefined;
+/**
+ * Walk up from `startDir` (defaults to this module's location) until a
+ * `package.json` named `psyclaw` is found, then return its own version and the
+ * pinned Pi dependency versions. Returns `undefined` when no psyclaw package is
+ * reachable — the caller fails closed instead of guessing.
+ */
+export declare function resolvePsyClawManifest(startDir?: string): Promise<PsyClawManifest | undefined>;

package/dist/src/updates/manifest.js

@@ -0,0 +1,58 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/** The two official Pi packages psyclaw pins and bumps in lockstep. */
+export const PI_AI = "@earendil-works/pi-ai";
+export const PI_CODING_AGENT = "@earendil-works/pi-coding-agent";
+function asString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/**
+ * Walk up from `startDir` until a `package.json` named `psyclaw` is found. The
+ * single source of truth for "where is the psyclaw package and what does it
+ * say" — used by both the async manifest resolver and the sync version reader.
+ */
+function findPsyClawPackage(startDir) {
+    let dir = startDir;
+    for (let depth = 0; depth < 6; depth += 1) {
+        try {
+            const parsed = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+            if (parsed.name === "psyclaw")
+                return { dir, parsed };
+        }
+        catch {
+            // keep walking up
+        }
+        dir = join(dir, "..");
+    }
+    return undefined;
+}
+/** Synchronous psyclaw version read (banner, branding) — same walk as the resolver. */
+export function readPsyClawVersionSync(startDir) {
+    const found = findPsyClawPackage(startDir ?? dirname(fileURLToPath(import.meta.url)));
+    return found === undefined ? undefined : asString(found.parsed.version);
+}
+/**
+ * Walk up from `startDir` (defaults to this module's location) until a
+ * `package.json` named `psyclaw` is found, then return its own version and the
+ * pinned Pi dependency versions. Returns `undefined` when no psyclaw package is
+ * reachable — the caller fails closed instead of guessing.
+ */
+export async function resolvePsyClawManifest(startDir) {
+    const found = findPsyClawPackage(startDir ?? dirname(fileURLToPath(import.meta.url)));
+    if (found === undefined)
+        return undefined;
+    const { dir, parsed } = found;
+    const dependencies = parsed.dependencies ?? {};
+    const piVersion = asString(dependencies[PI_CODING_AGENT]);
+    const piAiVersion = asString(dependencies[PI_AI]);
+    const packageManager = asString(parsed.packageManager);
+    return {
+        root: dir,
+        version: asString(parsed.version) ?? "unknown",
+        ...(piVersion === undefined ? {} : { piVersion }),
+        ...(piAiVersion === undefined ? {} : { piAiVersion }),
+        ...(packageManager === undefined ? {} : { packageManager }),
+    };
+}
+//# sourceMappingURL=manifest.js.map

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

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

package/dist/src/updates/registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Injectable registry clients. Network access is opt-in and every failure
+ * resolves to `undefined` (never throws), so callers stay offline-safe and the
+ * report simply marks the item unavailable/not-published.
+ */
+/** The latest official Pi release as reported by pi.dev. */
+export interface PiRelease {
+    version: string;
+    packageName?: string;
+    note?: string;
+}
+export interface RegistryClient {
+    latestNpm(packageName: string): Promise<string | undefined>;
+    latestPypi(packageName: string): Promise<string | undefined>;
+    latestPiRelease(): Promise<PiRelease | undefined>;
+}
+export declare function createHttpRegistry(fetchFn?: typeof fetch): RegistryClient;
+/** Extract the package name from an `npm install -g <pkg>[@version]` command. */
+export declare function npmPackageName(command: string): string | undefined;
+/** Extract the package name from a `pipx install <pkg>[==version]` command. */
+export declare function pipxPackageName(command: string): string | undefined;

package/dist/src/updates/registry.js

@@ -0,0 +1,82 @@
+/**
+ * Injectable registry clients. Network access is opt-in and every failure
+ * resolves to `undefined` (never throws), so callers stay offline-safe and the
+ * report simply marks the item unavailable/not-published.
+ */
+const REQUEST_TIMEOUT_MS = 8000;
+const PI_LATEST_VERSION_URL = "https://pi.dev/api/latest-version";
+export function createHttpRegistry(fetchFn = fetch) {
+    return {
+        async latestNpm(packageName) {
+            try {
+                const response = await fetchFn(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, { signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
+                if (!response.ok)
+                    return undefined;
+                const body = await response.json();
+                return typeof body.version === "string" && body.version.trim() ? body.version.trim() : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        },
+        async latestPypi(packageName) {
+            try {
+                const response = await fetchFn(`https://pypi.org/pypi/${encodeURIComponent(packageName)}/json`, { signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
+                if (!response.ok)
+                    return undefined;
+                const body = await response.json();
+                const version = body.info?.version;
+                return typeof version === "string" && version.trim() ? version.trim() : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        },
+        async latestPiRelease() {
+            try {
+                const response = await fetchFn(PI_LATEST_VERSION_URL, {
+                    headers: { accept: "application/json" },
+                    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+                });
+                if (!response.ok)
+                    return undefined;
+                const body = await response.json();
+                const version = typeof body.version === "string" && body.version.trim() ? body.version.trim() : undefined;
+                if (version === undefined)
+                    return undefined;
+                const packageName = typeof body.packageName === "string" && body.packageName.trim()
+                    ? body.packageName.trim()
+                    : undefined;
+                const note = typeof body.note === "string" && body.note.trim() ? body.note.trim() : undefined;
+                return {
+                    version,
+                    ...(packageName === undefined ? {} : { packageName }),
+                    ...(note === undefined ? {} : { note }),
+                };
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+/** Extract the package name from an `npm install -g <pkg>[@version]` command. */
+export function npmPackageName(command) {
+    const match = command.match(/npm\s+install\s+(?:-g|--global)\s+([^\s]+)/);
+    const raw = match?.[1];
+    if (raw === undefined)
+        return undefined;
+    // Strip a trailing `@version` for both scoped and unscoped packages.
+    const at = raw.lastIndexOf("@");
+    return at > 0 ? raw.slice(0, at) : raw;
+}
+/** Extract the package name from a `pipx install <pkg>[==version]` command. */
+export function pipxPackageName(command) {
+    const match = command.match(/pipx\s+install\s+([^\s]+)/);
+    const raw = match?.[1];
+    if (raw === undefined)
+        return undefined;
+    // Strip a pip version specifier (`==0.16.0`).
+    return raw.split("==")[0] ?? undefined;
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/src/updates/skills.d.ts

@@ -0,0 +1,15 @@
+export type SkillDriftStatus = "up-to-date" | "changed" | "missing" | "no-import";
+export interface SkillDrift {
+    agentId: string;
+    status: SkillDriftStatus;
+    /** Source files whose content changed since import. */
+    changed: string[];
+    /** Source files that no longer exist. */
+    missing: string[];
+}
+/**
+ * Detect whether imported skill files drifted from their sources. Only the
+ * source path is re-hashed; the imported copy itself is never modified and the
+ * result is read-only.
+ */
+export declare function checkSkillDrift(root: string, agentId: string): Promise<SkillDrift>;

package/dist/src/updates/skills.js

@@ -0,0 +1,39 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { sha256File } from "../core/hash.js";
+import { projectPaths } from "../project/paths.js";
+/**
+ * Detect whether imported skill files drifted from their sources. Only the
+ * source path is re-hashed; the imported copy itself is never modified and the
+ * result is read-only.
+ */
+export async function checkSkillDrift(root, agentId) {
+    const manifestPath = join(projectPaths(root).root, ".psyclaw", "imports", agentId, "import-manifest.json");
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+    }
+    catch {
+        return { agentId, status: "no-import", changed: [], missing: [] };
+    }
+    const changed = [];
+    const missing = [];
+    for (const skill of manifest.skills ?? []) {
+        for (const file of skill.files ?? []) {
+            const source = file.sourcePath;
+            const expected = file.sha256;
+            if (typeof source !== "string" || typeof expected !== "string")
+                continue;
+            const actual = await sha256File(source).catch(() => undefined);
+            if (actual === undefined) {
+                missing.push(source);
+            }
+            else if (actual.toLowerCase() !== expected.toLowerCase()) {
+                changed.push(source);
+            }
+        }
+    }
+    const status = missing.length > 0 ? "missing" : changed.length > 0 ? "changed" : "up-to-date";
+    return { agentId, status, changed, missing };
+}
+//# sourceMappingURL=skills.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/updates/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBnD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC;IAC3G,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAkB,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,SAAS;YACzE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAqB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAChH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/src/updates/status.d.ts

@@ -0,0 +1,7 @@
+export type UpdateStatus = "up-to-date" | "outdated" | "unpinned" | "unavailable" | "not-published" | "unknown";
+/** A ref that cannot be compared to a registry version. */
+export declare function isUnpinnedRef(ref: string | undefined): boolean;
+/** Compare two versions; returns null when either side is not parseable semver. */
+export declare function compareSemver(left: string, right: string): number | null;
+/** Classify a pinned version against the latest available version. */
+export declare function versionStatus(current: string | undefined, latest: string | undefined): UpdateStatus;

package/dist/src/updates/status.js

@@ -0,0 +1,37 @@
+const UNPINNED_REFS = new Set(["", "unpinned", "latest", "head", "main", "master", "*", "unknown"]);
+/** A ref that cannot be compared to a registry version. */
+export function isUnpinnedRef(ref) {
+    return ref === undefined || UNPINNED_REFS.has(ref.trim().toLowerCase());
+}
+/** Compare two versions; returns null when either side is not parseable semver. */
+export function compareSemver(left, right) {
+    const a = parseSemver(left);
+    const b = parseSemver(right);
+    if (a === null || b === null)
+        return null;
+    for (let index = 0; index < 3; index += 1) {
+        const x = a[index] ?? 0;
+        const y = b[index] ?? 0;
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    return 0;
+}
+function parseSemver(value) {
+    const match = value.trim().replace(/^v/i, "").match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+/** Classify a pinned version against the latest available version. */
+export function versionStatus(current, latest) {
+    if (latest === undefined)
+        return "unavailable";
+    if (current === undefined)
+        return "unknown";
+    const comparison = compareSemver(current, latest);
+    if (comparison === null)
+        return "unknown";
+    return comparison < 0 ? "outdated" : "up-to-date";
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/updates/status.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpG,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,OAAO,GAAG,KAAK,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACvD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,OAA2B,EAAE,MAA0B;IACnF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAC/C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AACpD,CAAC"}