@synap-core/cli 1.11.0 → 1.13.0

package/dist/lib/template-steps.js.map

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

package/dist/lib/time-ago.d.ts

@@ -0,0 +1,2 @@
+/** "5 minutes ago" from an ISO date — the CLI's relative-time words (was local to `synap status`). */
+export declare function timeAgo(isoDate: string, now?: number): string;

package/dist/lib/time-ago.js

@@ -0,0 +1,15 @@
+/** "5 minutes ago" from an ISO date — the CLI's relative-time words (was local to `synap status`). */
+export function timeAgo(isoDate, now = Date.now()) {
+    const diff = now - new Date(isoDate).getTime();
+    const minutes = Math.floor(diff / 60_000);
+    if (minutes < 1)
+        return "just now";
+    if (minutes < 60)
+        return `${minutes} minute${minutes === 1 ? "" : "s"} ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours} hour${hours === 1 ? "" : "s"} ago`;
+    const days = Math.floor(hours / 24);
+    return `${days} day${days === 1 ? "" : "s"} ago`;
+}
+//# sourceMappingURL=time-ago.js.map

package/dist/lib/time-ago.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-ago.js","sourceRoot":"","sources":["../../src/lib/time-ago.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC/D,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IAC1C,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AACnD,CAAC"}

package/dist/lib/wake-hook-settings.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The wake hook in a Claude Code settings file — `synap hooks install-wake`
+ * and `synap init`.
+ *
+ * One `Stop` hook, `asyncRewake: true`, running `synap session wait --hook`.
+ * The contract, verified against Claude Code 2.1.309 (its bundled settings
+ * schema and hook runner) and code.claude.com/docs/en/hooks:
+ *   - `asyncRewake` runs the command in the background ("Implies async") and
+ *     wakes the model when it exits 2; the hook's stderr (stdout if stderr is
+ *     empty) is shown to Claude as a system reminder. Any other exit wakes no one.
+ *   - `timeout` is enforced on it too (seconds; default 600, no maximum in the
+ *     schema), so the entry sets one and the command stops on its own first.
+ *   - Only an INTERACTIVE session (or the SDK with streaming input) backgrounds
+ *     it; `claude -p` runs it in the foreground — the command exits at once there.
+ *
+ * The merge never clobbers: other hooks, other events and other keys are kept
+ * as they are, a second install is a no-op, and a file that does not parse is
+ * refused (`readJsonStrict`), never rewritten from `{}`. The command names
+ * `synap` on PATH, not this machine's absolute path, because a project's
+ * `.claude/settings.json` is usually committed and shared.
+ */
+/** Claude Code's own limit on the background process, in seconds. */
+export declare const WAKE_HOOK_TIMEOUT_SECONDS = 3600;
+/** Our own deadline sits under it, so we exit 0 (no wake) before Claude Code kills us. */
+export declare const WAKE_HOOK_COMMAND = "synap session wait --hook --timeout 55m";
+export interface WakeHookEntry {
+    type: "command";
+    command: string;
+    asyncRewake: true;
+    timeout: number;
+}
+export declare const WAKE_HOOK_ENTRY: WakeHookEntry;
+type Settings = Record<string, unknown>;
+/** Ours, in any version: a command hook that runs `synap session wait … --hook`. */
+export declare function isWakeHook(hook: unknown): boolean;
+export type WakeHookChange = "added" | "updated" | "unchanged" | "removed" | "absent";
+/**
+ * Settings with the wake hook in place. An older wake entry (another command
+ * line or timeout) is updated where it stands; anything else is untouched.
+ */
+export declare function withWakeHook(settings: Settings): {
+    settings: Settings;
+    change: WakeHookChange;
+};
+/** Settings without the wake hook. Empty groups, an empty `Stop` and an empty `hooks` go too. */
+export declare function withoutWakeHook(settings: Settings): {
+    settings: Settings;
+    change: WakeHookChange;
+};
+/** `<dir>/.claude/settings.json`, or the user's `~/.claude/settings.json`. */
+export declare function wakeHookSettingsPath(opts: {
+    user?: boolean;
+    dir?: string;
+}): string;
+/** Read, merge, write (only when something changed). Throws on a file that does not parse. */
+export declare function applyWakeHook(file: string, uninstall?: boolean): WakeHookChange;
+export {};

package/dist/lib/wake-hook-settings.js

@@ -0,0 +1,153 @@
+/**
+ * The wake hook in a Claude Code settings file — `synap hooks install-wake`
+ * and `synap init`.
+ *
+ * One `Stop` hook, `asyncRewake: true`, running `synap session wait --hook`.
+ * The contract, verified against Claude Code 2.1.309 (its bundled settings
+ * schema and hook runner) and code.claude.com/docs/en/hooks:
+ *   - `asyncRewake` runs the command in the background ("Implies async") and
+ *     wakes the model when it exits 2; the hook's stderr (stdout if stderr is
+ *     empty) is shown to Claude as a system reminder. Any other exit wakes no one.
+ *   - `timeout` is enforced on it too (seconds; default 600, no maximum in the
+ *     schema), so the entry sets one and the command stops on its own first.
+ *   - Only an INTERACTIVE session (or the SDK with streaming input) backgrounds
+ *     it; `claude -p` runs it in the foreground — the command exits at once there.
+ *
+ * The merge never clobbers: other hooks, other events and other keys are kept
+ * as they are, a second install is a no-op, and a file that does not parse is
+ * refused (`readJsonStrict`), never rewritten from `{}`. The command names
+ * `synap` on PATH, not this machine's absolute path, because a project's
+ * `.claude/settings.json` is usually committed and shared.
+ */
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+import { readJsonStrict, writeFileAtomic } from "./atomic-file.js";
+/** Claude Code's own limit on the background process, in seconds. */
+export const WAKE_HOOK_TIMEOUT_SECONDS = 3600;
+/** Our own deadline sits under it, so we exit 0 (no wake) before Claude Code kills us. */
+export const WAKE_HOOK_COMMAND = "synap session wait --hook --timeout 55m";
+export const WAKE_HOOK_ENTRY = {
+    type: "command",
+    command: WAKE_HOOK_COMMAND,
+    asyncRewake: true,
+    timeout: WAKE_HOOK_TIMEOUT_SECONDS,
+};
+/** Ours, in any version: a command hook that runs `synap session wait … --hook`. */
+export function isWakeHook(hook) {
+    if (!hook || typeof hook !== "object")
+        return false;
+    const h = hook;
+    return (h.type === "command" &&
+        typeof h.command === "string" &&
+        /(^|[\s/])synap\s+session\s+wait\b/.test(h.command) &&
+        /\s--hook\b/.test(h.command));
+}
+function sameEntry(hook) {
+    if (!hook || typeof hook !== "object")
+        return false;
+    const h = hook;
+    return (h.type === WAKE_HOOK_ENTRY.type &&
+        h.command === WAKE_HOOK_ENTRY.command &&
+        h.asyncRewake === true &&
+        h.timeout === WAKE_HOOK_ENTRY.timeout);
+}
+/** The settings' `hooks.Stop` array, or a refusal when the file holds something else there. */
+function stopGroups(settings) {
+    const hooks = settings.hooks;
+    if (hooks !== undefined && (typeof hooks !== "object" || hooks === null || Array.isArray(hooks))) {
+        throw new Error("`hooks` in this settings file is not an object; fix it by hand, nothing was written.");
+    }
+    const stop = hooks?.Stop;
+    if (stop === undefined)
+        return [];
+    if (!Array.isArray(stop)) {
+        throw new Error("`hooks.Stop` in this settings file is not a list; fix it by hand, nothing was written.");
+    }
+    return stop;
+}
+/**
+ * Settings with the wake hook in place. An older wake entry (another command
+ * line or timeout) is updated where it stands; anything else is untouched.
+ */
+export function withWakeHook(settings) {
+    const groups = stopGroups(settings);
+    let found = false;
+    let updated = false;
+    const nextGroups = groups.map((g) => {
+        if (!Array.isArray(g?.hooks))
+            return g;
+        const hooks = g.hooks.flatMap((h) => {
+            if (!isWakeHook(h))
+                return [h];
+            if (found) {
+                updated = true; // a duplicate of ours: keep one
+                return [];
+            }
+            found = true;
+            if (sameEntry(h))
+                return [h];
+            updated = true;
+            return [{ ...WAKE_HOOK_ENTRY }];
+        });
+        return { ...g, hooks };
+    });
+    const cleaned = nextGroups.filter((g) => !Array.isArray(g?.hooks) || g.hooks.length > 0);
+    if (found && !updated)
+        return { settings, change: "unchanged" };
+    const finalGroups = found ? cleaned : [...cleaned, { hooks: [{ ...WAKE_HOOK_ENTRY }] }];
+    return {
+        settings: {
+            ...settings,
+            hooks: { ...(settings.hooks ?? {}), Stop: finalGroups },
+        },
+        change: found ? "updated" : "added",
+    };
+}
+/** Settings without the wake hook. Empty groups, an empty `Stop` and an empty `hooks` go too. */
+export function withoutWakeHook(settings) {
+    const groups = stopGroups(settings);
+    let removed = false;
+    const nextGroups = groups
+        .map((g) => {
+        if (!Array.isArray(g?.hooks))
+            return g;
+        const hooks = g.hooks.filter((h) => {
+            const ours = isWakeHook(h);
+            if (ours)
+                removed = true;
+            return !ours;
+        });
+        return { ...g, hooks };
+    })
+        .filter((g) => !Array.isArray(g?.hooks) || g.hooks.length > 0);
+    if (!removed)
+        return { settings, change: "absent" };
+    const { Stop: _stop, ...otherEvents } = settings.hooks ?? {};
+    const hooks = nextGroups.length > 0 ? { ...otherEvents, Stop: nextGroups } : otherEvents;
+    const { hooks: _hooks, ...rest } = settings;
+    return {
+        settings: Object.keys(hooks).length > 0 ? { ...rest, hooks } : rest,
+        change: "removed",
+    };
+}
+/** `<dir>/.claude/settings.json`, or the user's `~/.claude/settings.json`. */
+export function wakeHookSettingsPath(opts) {
+    if (opts.user)
+        return path.join(os.homedir(), ".claude", "settings.json");
+    return path.join(path.resolve(opts.dir ?? process.cwd()), ".claude", "settings.json");
+}
+/** Read, merge, write (only when something changed). Throws on a file that does not parse. */
+export function applyWakeHook(file, uninstall = false) {
+    const existing = readJsonStrict(file);
+    if (!existing && uninstall)
+        return "absent";
+    const { settings, change } = uninstall ? withoutWakeHook(existing ?? {}) : withWakeHook(existing ?? {});
+    if (change === "added" || change === "updated" || change === "removed") {
+        // A new project settings file is shared config, not a secret: 0644. An
+        // existing file keeps its own mode (~/.claude/settings.json holds keys).
+        writeFileAtomic(file, JSON.stringify(settings, null, 2) + "\n", fs.existsSync(file) ? {} : { mode: 0o644 });
+    }
+    return change;
+}
+//# sourceMappingURL=wake-hook-settings.js.map

package/dist/lib/wake-hook-settings.js.map

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

package/dist/lib/wake-state.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The wake hook's memory between runs — `~/.synap/wake/<key>.json`.
+ *
+ * Claude Code runs an `asyncRewake` Stop hook as a NEW background process on
+ * every Stop, and never kills the previous one ("Each execution creates a
+ * separate background process", code.claude.com/docs/en/hooks). So two waiters
+ * for one terminal overlap whenever the person types again before the first
+ * gives up. This file keeps them honest:
+ *
+ *   - `owner`: the newest waiter's token. An older waiter sees it change and
+ *     exits quietly at its next read — the terminal has one doorbell, not two.
+ *   - `since`: the feed cursor, so the next run resumes where the last one
+ *     read (never a replay, never a gap) — the pod's `nextSince`.
+ *   - `delivered`: event ids already handed to the agent, so an older waiter
+ *     whose read was in flight and a newer one cannot both wake it for the
+ *     same event.
+ *   - `carried`: events read (and so marked read by the pod) that do not wake
+ *     — an fyi, a done, a held wake — kept until the next wake shows them.
+ *
+ * Best-effort by design: a lost write costs at most one duplicate line, and a
+ * file that cannot be read is a fresh start, never a crash in someone's hook.
+ * The read-modify-writes are unlocked: two waiters racing inside the same
+ * milliseconds can both wake the agent once.
+ *
+ * Stated limits, both from the pod's contract rather than this file:
+ *   - the pod marks a message read when it HANDS it out (there is no ack), so
+ *     a hook killed between that read and its stderr write (the session ended,
+ *     the hook's timeout) loses that one wake — the message stays in the room;
+ *   - after the first run the hook reads in CURSOR mode (`since`), which sees
+ *     owner messages written while the agent worked its turn, but not a post
+ *     whose row commits after a concurrent read already moved the cursor past
+ *     its timestamp (unread mode would; it would also drop those owner messages).
+ */
+import type { SessionFeedEvent } from "./session-feed.js";
+export interface WakeState {
+    owner?: string;
+    pid?: number;
+    since?: string | null;
+    delivered?: string[];
+    carried?: SessionFeedEvent[];
+    updatedAt?: string;
+}
+/** One file per (Claude Code conversation, focus session). */
+export declare function wakeStatePath(conversationId: string | undefined, sessionId: string): string;
+export declare function readWakeState(file: string): WakeState;
+/** Claim the doorbell: this run becomes the owner. Returns its token. */
+export declare function claimWake(file: string): string;
+export declare function isWakeOwner(file: string, owner: string): boolean;
+/** Advance the cursor (never backwards) and carry events that did not wake. */
+export declare function recordRead(file: string, p: {
+    since: string | null;
+    carry?: SessionFeedEvent[];
+}): void;
+/**
+ * Hand events to the agent: drop any already delivered (by another waiter),
+ * mark the rest delivered, and release the carried ones with them. Returns
+ * what to show; `events` empty = someone else already woke the agent for them.
+ */
+export declare function takeDelivery(file: string, p: {
+    events: SessionFeedEvent[];
+    since: string | null;
+}): {
+    events: SessionFeedEvent[];
+    carried: SessionFeedEvent[];
+};

package/dist/lib/wake-state.js

@@ -0,0 +1,122 @@
+/**
+ * The wake hook's memory between runs — `~/.synap/wake/<key>.json`.
+ *
+ * Claude Code runs an `asyncRewake` Stop hook as a NEW background process on
+ * every Stop, and never kills the previous one ("Each execution creates a
+ * separate background process", code.claude.com/docs/en/hooks). So two waiters
+ * for one terminal overlap whenever the person types again before the first
+ * gives up. This file keeps them honest:
+ *
+ *   - `owner`: the newest waiter's token. An older waiter sees it change and
+ *     exits quietly at its next read — the terminal has one doorbell, not two.
+ *   - `since`: the feed cursor, so the next run resumes where the last one
+ *     read (never a replay, never a gap) — the pod's `nextSince`.
+ *   - `delivered`: event ids already handed to the agent, so an older waiter
+ *     whose read was in flight and a newer one cannot both wake it for the
+ *     same event.
+ *   - `carried`: events read (and so marked read by the pod) that do not wake
+ *     — an fyi, a done, a held wake — kept until the next wake shows them.
+ *
+ * Best-effort by design: a lost write costs at most one duplicate line, and a
+ * file that cannot be read is a fresh start, never a crash in someone's hook.
+ * The read-modify-writes are unlocked: two waiters racing inside the same
+ * milliseconds can both wake the agent once.
+ *
+ * Stated limits, both from the pod's contract rather than this file:
+ *   - the pod marks a message read when it HANDS it out (there is no ack), so
+ *     a hook killed between that read and its stderr write (the session ended,
+ *     the hook's timeout) loses that one wake — the message stays in the room;
+ *   - after the first run the hook reads in CURSOR mode (`since`), which sees
+ *     owner messages written while the agent worked its turn, but not a post
+ *     whose row commits after a concurrent read already moved the cursor past
+ *     its timestamp (unread mode would; it would also drop those owner messages).
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { randomBytes } from "node:crypto";
+import { writeFileAtomic } from "./atomic-file.js";
+/** Ids remembered as delivered (the newest win). */
+const DELIVERED_MAX = 200;
+/** Events carried to the next wake (the newest win). */
+const CARRIED_MAX = 20;
+function wakeDir() {
+    return path.join(os.homedir(), ".synap", "wake");
+}
+/** One file per (Claude Code conversation, focus session). */
+export function wakeStatePath(conversationId, sessionId) {
+    const safe = (s) => s.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return path.join(wakeDir(), `${safe(conversationId ?? "terminal")}__${safe(sessionId)}.json`);
+}
+export function readWakeState(file) {
+    try {
+        const v = JSON.parse(fs.readFileSync(file, "utf8"));
+        return v && typeof v === "object" && !Array.isArray(v) ? v : {};
+    }
+    catch {
+        return {};
+    }
+}
+function writeWakeState(file, state) {
+    try {
+        writeFileAtomic(file, JSON.stringify({ ...state, updatedAt: new Date().toISOString() }, null, 2) + "\n", {
+            mode: 0o600,
+        });
+    }
+    catch {
+        /* best-effort — see the header */
+    }
+}
+/** The later of two millisecond ISO cursors (they compare as strings). */
+function laterCursor(a, b) {
+    if (!a)
+        return b ?? null;
+    if (!b)
+        return a;
+    return a > b ? a : b;
+}
+/** Claim the doorbell: this run becomes the owner. Returns its token. */
+export function claimWake(file) {
+    const owner = randomBytes(8).toString("hex");
+    writeWakeState(file, { ...readWakeState(file), owner, pid: process.pid });
+    return owner;
+}
+export function isWakeOwner(file, owner) {
+    return readWakeState(file).owner === owner;
+}
+/** Advance the cursor (never backwards) and carry events that did not wake. */
+export function recordRead(file, p) {
+    const s = readWakeState(file);
+    const delivered = new Set(s.delivered ?? []);
+    const carried = [...(s.carried ?? [])];
+    for (const e of p.carry ?? []) {
+        if (!delivered.has(e.id) && !carried.some((c) => c.id === e.id))
+            carried.push(e);
+    }
+    writeWakeState(file, {
+        ...s,
+        since: laterCursor(s.since, p.since),
+        carried: carried.slice(-CARRIED_MAX),
+    });
+}
+/**
+ * Hand events to the agent: drop any already delivered (by another waiter),
+ * mark the rest delivered, and release the carried ones with them. Returns
+ * what to show; `events` empty = someone else already woke the agent for them.
+ */
+export function takeDelivery(file, p) {
+    const s = readWakeState(file);
+    const delivered = new Set(s.delivered ?? []);
+    const events = p.events.filter((e) => !delivered.has(e.id));
+    const carried = events.length > 0 ? (s.carried ?? []).filter((e) => !delivered.has(e.id)) : [];
+    for (const e of [...events, ...carried])
+        delivered.add(e.id);
+    writeWakeState(file, {
+        ...s,
+        since: laterCursor(s.since, p.since),
+        delivered: [...delivered].slice(-DELIVERED_MAX),
+        carried: events.length > 0 ? [] : s.carried,
+    });
+    return { events, carried: carried.filter((c) => !events.some((e) => e.id === c.id)) };
+}
+//# sourceMappingURL=wake-state.js.map

package/dist/lib/wake-state.js.map

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

package/dist/utils/logger.js

@@ -5,8 +5,11 @@ import chalk from "chalk";
 // are trying to parse. Callers that print a failure and its next-action hint
 // use error/warn/dim — dim stays on stdout because it is also used for ordinary
 // output detail; hint lines that accompany an error are emitted via `hint`.
+//
+// Colour carries meaning only: green ✓ done, yellow ⚠ warning, red ✗ error,
+// cyan for a command to type. Ordinary lines stay uncoloured.
 export const log = {
-    info: (msg) => console.log(chalk.blue("  " + msg)),
+    info: (msg) => console.log("  " + msg),
     success: (msg) => console.log(chalk.green("  ✓ " + msg)),
     warn: (msg) => console.error(chalk.yellow("  ⚠ " + msg)),
     error: (msg) => console.error(chalk.red("  ✗ " + msg)),
@@ -19,7 +22,7 @@ export const log = {
 export function banner() {
     console.log(chalk.cyan(`
   ╔═══════════════════════════════════════╗
-  ║         ${chalk.bold("Synap CLI")}                    ║
+  ║         ${chalk.bold("Synap CLI")}                     ║
   ║  Knowledge infrastructure for agents  ║
   ╚═══════════════════════════════════════╝
 `));

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAChE,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAChE,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC9D,0EAA0E;IAC1E,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC7D,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,UAAU,MAAM;IACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;;cAEX,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;CAGpC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C;YACE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;IAC9C,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAChE,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAChE,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC9D,0EAA0E;IAC1E,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC7D,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,UAAU,MAAM;IACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;;cAEX,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;CAGpC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C;YACE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/package.json

@@ -1,41 +1,42 @@
 {
   "name": "@synap-core/cli",
-  "version": "1.11.0",
-  "description": "Synap CLI — connect OpenClaw to sovereign knowledge infrastructure",
+  "version": "1.13.0",
+  "description": "Connect any AI agent (Claude Code, Codex, Cursor and more) to your own Synap data pod: shared memory, structured data and human-approved changes.",
   "type": "module",
   "bin": {
     "synap": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/write-build-info.mjs",
     "dev": "tsx src/index.ts",
     "sync-skills": "bash scripts/sync-skills.sh",
-    "prepublishOnly": "pnpm sync-skills && pnpm build",
-    "prepack": "rm -rf node_modules/@synap/hub-rest-client && cp -r ../synap-backend/packages/hub-rest-client node_modules/@synap/",
-    "postpack": "rm -rf node_modules/@synap/hub-rest-client && ln -s ../../../synap-backend/packages/hub-rest-client node_modules/@synap/hub-rest-client",
+    "prepublishOnly": "npm run sync-skills && npm run build",
     "postbuild": "chmod +x dist/index.js",
-    "test": "vitest run"
+    "test": "vitest run",
+    "verify-artifact": "node scripts/verify-artifact.mjs",
+    "docs:cli": "node scripts/gen-cli-reference.mjs",
+    "docs:cli:check": "node scripts/gen-cli-reference.mjs --check"
   },
   "dependencies": {
-    "@synap/hub-rest-client": "file:../synap-backend/packages/hub-rest-client",
-    "@synap-core/workspace-templates": "workspace:*",
+    "@synap-core/hub-rest-client": "^1.1.1",
+    "@synap-core/types": "^1.12.1",
+    "@synap-core/workspace-templates": ">=0.12.0 <1.0.0",
     "chalk": "^5.4.0",
     "commander": "^13.0.0",
+    "esbuild": "^0.28.0",
     "ora": "^8.0.0",
     "prompts": "^2.4.2",
+    "qrcode": "^1.5.4",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/prompts": "^2.4.9",
-    "esbuild": "^0.28.0",
+    "@types/qrcode": "^1.5.5",
     "tsx": "^4.0.0",
     "typescript": "^5.7.0",
     "vitest": "^3.2.4"
   },
-  "bundledDependencies": [
-    "@synap/hub-rest-client"
-  ],
   "files": [
     "dist",
     "skills",
@@ -46,15 +47,23 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/synap-core/cli"
+    "url": "git+https://github.com/Synap-core/synap-cli.git"
   },
   "license": "MIT",
+  "homepage": "https://synap.live/download/cli",
+  "bugs": {
+    "url": "https://github.com/Synap-core/synap-cli/issues"
+  },
   "keywords": [
     "synap",
-    "openclaw",
-    "ai",
+    "mcp",
+    "ai-agents",
+    "claude-code",
+    "codex",
+    "cursor",
     "knowledge-graph",
     "memory",
-    "agent"
+    "personal-data",
+    "self-hosted"
   ]
 }

package/skills/README.md

@@ -1,14 +1,15 @@
 # Synap Skills
 
-Three skills make up the Synap agent surface. Install all three for the full experience; they are designed to be used together.
+Four baseline skills make up the Synap agent surface (`manifest.json` is the list). Install all of them for the full experience; they are designed to be used together.
 
-## The three skills
+## The baseline skills
 
-| Skill          | Purpose                                                    | Trigger                                                           |
-| -------------- | ---------------------------------------------------------- | ----------------------------------------------------------------- |
-| `synap`        | Core data operations — read, write, link, search, remember | "Save this", "Find my X", "Who is Y", "Remind me to Z"            |
-| `synap-schema` | Extend the data model — new profiles, new properties       | "I need a type for X", "Add a field to tasks"                     |
-| `synap-ui`     | Build views, dashboards, workspaces, bento layouts         | "Make me a dashboard", "Build a kanban", "Create a CRM workspace" |
+| Skill          | Purpose                                                                                    | Trigger                                                                      |
+| -------------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- |
+| `synap`        | Core data operations — read, write, link, search, remember                                 | "Save this", "Find my X", "Who is Y", "Remind me to Z"                       |
+| `synap-schema` | Extend the data model — new profiles, new properties                                       | "I need a type for X", "Add a field to tasks"                                |
+| `synap-ui`     | Build views, dashboards, workspaces, bento layouts                                         | "Make me a dashboard", "Build a kanban", "Create a CRM workspace"            |
+| `synap-design` | Design and build UI: principles, the component catalog and tokens, the design-to-code loop | "Design the proposal page", "Is this screen right?", "Implement this design" |
 
 Each skill has its own SKILL.md with a trigger-first description. The harness loads only the skills whose descriptions match the user's intent — so a data-fetch turn doesn't load the UI skill, and vice versa.
 
@@ -29,6 +30,7 @@ skills/
 │   └── property-types.md     ← valueType reference + constraints + uiHints + scope
 │
 ├── synap-ui/                 ← build interface over data
+├── synap-design/             ← design principles, design system, design loop
 │   ├── SKILL.md
 │   ├── view-types.md         ← the 12 implemented view types + configs
 │   ├── widget-catalog.md     ← cells/widgets reference
@@ -66,12 +68,12 @@ Provision a key via `npx @synap-core/cli connect --target=<client>` or directly
 
 Each skill is portable and works unchanged in:
 
-- **OpenClaw** — drop into the standard skill directory, env vars pick up the pod URL and key
-- **Claude Code** — install to `~/.claude/skills/synap/` (strip `metadata.openclaw` block if desired)
+- **Any agent that reads skill folders** — drop into its skill directory; env vars pick up the pod URL and key
+- **Claude Code** — install to `~/.claude/skills/synap/`
 - **Claude Desktop** — does NOT read local skill folders. Skills in Claude Desktop sync from claude.ai — upload the three skill directories there (Settings → Skills → Upload). Claude Desktop CAN still use the pod via an MCP bridge — see `synap-cli/src/lib/targets.ts` `installClaudeDesktop` for the stdio-bridge config.
-- **Raycast** — the Raycast extension is a separate package with its own tool bindings; it reads these skills as context
+- **Raycast** — Raycast AI connects to the pod's `/mcp` as an HTTP MCP server (`synap connect --target=raycast`) and reads these skills through `synap_load_skill`, like any MCP client
 
-The OpenClaw-specific metadata block is namespaced under `metadata.openclaw` so consumers that don't recognize it will ignore it cleanly.
+The install metadata (required env, capabilities) is namespaced under `metadata.synap`, so consumers that don't recognize it ignore it cleanly.
 
 ## When to install which