@synap-core/cli 1.7.0 → 1.10.0

package/dist/commands/view.d.ts

@@ -0,0 +1,57 @@
+/**
+ * synap view
+ *
+ * Manage views on the pod.
+ *
+ * Usage:
+ *   synap view create --type kanban --profile task --name "My Board" --workspace <id>
+ *   synap view create --type bento --profile note --json
+ *   synap view list [--workspace <id>]
+ *
+ * API:
+ *   POST /api/hub/views  — CreateViewRequest: { userId, workspaceId, name, type, profileId, config, metadata }
+ *   GET  /api/hub/views  — ListViewsQuery:    { userId, workspaceId, type, profileId }
+ *
+ * Note: the backend accepts `profileId` (not `profileSlug`). The CLI accepts
+ * `--profile <slug>` for convenience and passes it as `profileId` — the backend
+ * resolves it at the entity level or stores it as-is. Pass a UUID if you need
+ * exact profile routing.
+ */
+export interface ViewCreateOpts {
+    type: string;
+    profile?: string;
+    name?: string;
+    workspace?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export interface ViewListOpts {
+    workspace?: string;
+    type?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function viewCreate(opts: ViewCreateOpts): Promise<void>;
+export declare function viewList(opts: ViewListOpts): Promise<void>;
+export interface ViewArrangeOpts {
+    file?: string;
+    workspace?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+/**
+ * POST /api/hub/views/:viewId/arrange
+ *
+ * Replaces the widget arrangement for a bento-type view.
+ * Payload: { userId, workspaceId?, widgets: BentoWidget[] }
+ *
+ * BentoWidget shape: { id, kind, x?, y?, w?, h?, config?, ...passthrough }
+ *
+ * Layout JSON can be provided via --file <path> or piped from stdin.
+ * Expected format: an array of BentoWidget objects, OR
+ *   { widgets: BentoWidget[] } wrapper — both are accepted.
+ */
+export declare function viewArrange(viewId: string, opts: ViewArrangeOpts): Promise<void>;

package/dist/commands/view.js

@@ -0,0 +1,195 @@
+/**
+ * synap view
+ *
+ * Manage views on the pod.
+ *
+ * Usage:
+ *   synap view create --type kanban --profile task --name "My Board" --workspace <id>
+ *   synap view create --type bento --profile note --json
+ *   synap view list [--workspace <id>]
+ *
+ * API:
+ *   POST /api/hub/views  — CreateViewRequest: { userId, workspaceId, name, type, profileId, config, metadata }
+ *   GET  /api/hub/views  — ListViewsQuery:    { userId, workspaceId, type, profileId }
+ *
+ * Note: the backend accepts `profileId` (not `profileSlug`). The CLI accepts
+ * `--profile <slug>` for convenience and passes it as `profileId` — the backend
+ * resolves it at the entity level or stores it as-is. Pass a UUID if you need
+ * exact profile routing.
+ */
+import { readFileSync } from "fs";
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, resolveUserId, hubGet, hubPost } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+export async function viewCreate(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const name = opts.name ?? `${opts.type} view`;
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        // Resolve profile slug → UUID (backend requires UUID for profileId)
+        let profileId;
+        if (opts.profile) {
+            const profilesRes = await hubGet("/profiles", { userId, workspaceId: workspaceId ?? "" }, cfg);
+            const profiles = unwrapList(profilesRes, ["profiles", "items"]);
+            const match = profiles.find((p) => p.slug === opts.profile || p.id === opts.profile);
+            if (!match) {
+                log.error(`Profile "${opts.profile}" not found. Run: synap list profiles`);
+                process.exit(1);
+            }
+            profileId = String(match.id);
+        }
+        const body = {
+            userId,
+            name,
+            type: opts.type,
+        };
+        if (workspaceId)
+            body.workspaceId = workspaceId;
+        if (profileId)
+            body.profileId = profileId;
+        const res = await hubPost("/views", body, cfg);
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        const isProposed = res.status === "proposed" || Boolean(res.proposalId);
+        if (isProposed) {
+            log.warn(`Queued for approval (proposal: ${String(res.proposalId ?? "")})`);
+            if (res.reviewUrl)
+                log.dim(`  Review: ${String(res.reviewUrl)}`);
+        }
+        else {
+            log.success(`View created: ${String(res.name ?? name)}`);
+            log.dim(`id: ${String(res.id ?? "")}`);
+            if (res.type)
+                log.dim(`type: ${String(res.type)}`);
+        }
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+export async function viewList(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        const params = { userId };
+        if (workspaceId)
+            params.workspaceId = workspaceId;
+        if (opts.type)
+            params.type = opts.type;
+        const res = await hubGet("/views", params, cfg);
+        const views = unwrapList(res, ["views", "items"]);
+        if (opts.json) {
+            console.log(JSON.stringify(views, null, 2));
+            return;
+        }
+        if (views.length === 0) {
+            log.dim(`No views found${opts.type ? ` of type '${opts.type}'` : ""}.`);
+            if (opts.type)
+                log.dim("  Drop --type to list all views in the workspace.");
+            return;
+        }
+        log.heading(`Views${opts.type ? ` (${opts.type})` : ""}${workspaceId ? ` in workspace ${workspaceId.slice(0, 8)}…` : ""}`);
+        console.log("");
+        for (const v of views) {
+            const type = String(v.type ?? "").padEnd(14);
+            const name = String(v.name ?? "–").slice(0, 40).padEnd(42);
+            const id = chalk.dim(String(v.id ?? "").slice(0, 8));
+            const profile = v.profileId ? chalk.dim(`  [${v.profileId}]`) : "";
+            console.log(`  ${chalk.cyan(type)}  ${name}  ${id}${profile}`);
+        }
+        console.log("");
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+/**
+ * POST /api/hub/views/:viewId/arrange
+ *
+ * Replaces the widget arrangement for a bento-type view.
+ * Payload: { userId, workspaceId?, widgets: BentoWidget[] }
+ *
+ * BentoWidget shape: { id, kind, x?, y?, w?, h?, config?, ...passthrough }
+ *
+ * Layout JSON can be provided via --file <path> or piped from stdin.
+ * Expected format: an array of BentoWidget objects, OR
+ *   { widgets: BentoWidget[] } wrapper — both are accepted.
+ */
+export async function viewArrange(viewId, opts) {
+    try {
+        // Read layout JSON from --file or stdin
+        let raw;
+        if (opts.file) {
+            try {
+                raw = readFileSync(opts.file, "utf-8");
+            }
+            catch (e) {
+                log.error(`Cannot read file: ${opts.file} — ${e.message}`);
+                process.exit(1);
+            }
+        }
+        else if (!process.stdin.isTTY) {
+            raw = await new Promise((resolve, reject) => {
+                const chunks = [];
+                process.stdin.on("data", (chunk) => chunks.push(chunk));
+                process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+                process.stdin.on("error", reject);
+            });
+        }
+        else {
+            log.error("Provide layout JSON via --file <path> or pipe stdin.\n" +
+                "  Format: array of { id, kind, x?, y?, w?, h?, config? } objects, or { widgets: [...] }.");
+            process.exit(1);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            log.error("Layout JSON is not valid JSON.");
+            process.exit(1);
+        }
+        // Accept both bare array and { widgets: [...] } wrapper
+        const widgets = Array.isArray(parsed)
+            ? parsed
+            : Array.isArray(parsed.widgets)
+                ? parsed.widgets
+                : [];
+        if (widgets.length === 0) {
+            log.error("No widgets found in layout. Expected an array or { widgets: [...] }.");
+            process.exit(1);
+        }
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        const body = { userId, widgets };
+        if (workspaceId)
+            body.workspaceId = workspaceId;
+        const res = (await hubPost(`/views/${viewId}/arrange`, body, cfg));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        const isProposed = res.status === "proposed" || Boolean(res.proposalId);
+        if (isProposed) {
+            log.warn(`Queued for approval (proposal: ${String(res.proposalId ?? "")})`);
+            if (res.reviewUrl)
+                log.dim(`  Review: ${String(res.reviewUrl)}`);
+            return;
+        }
+        log.success(`View arranged: ${viewId.slice(0, 8)}…`);
+        log.dim(`  ${widgets.length} widget(s) set`);
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/view.js.map

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

package/dist/commands/whoami.d.ts

@@ -0,0 +1,21 @@
+/**
+ * synap whoami
+ *
+ * Answers the one question `synap status` can't: WHICH key is this session
+ * actually authenticating with, and does the ambient `SYNAP_HUB_API_KEY`
+ * silently disagree with the pinned `claude-code` surface key?
+ *
+ * `synap status` probes via `resolveHubConfig()` and prints a single "Valid"
+ * off whichever key wins — which HIDES the case where the env key is revoked
+ * but a valid surface key is pinned (or vice-versa). This command:
+ *   1. resolves the winning cfg (the key every command uses),
+ *   2. independently reads env key + `claude-code` surface key and reproduces
+ *      the surface-over-env preference rule from hub-client.ts:394-403,
+ *   3. introspects the winner via `/auth/status`, and
+ *   4. when env and surface keys diverge, names the winner AND the ignored key,
+ *      probing the loser too so the operator sees both states side by side.
+ *
+ * It never mutates state and never relies on resolveHubConfig's stderr swap
+ * warning (hub-client.ts:398-400) — it reads the divergence itself.
+ */
+export declare function whoami(): Promise<void>;

package/dist/commands/whoami.js

@@ -0,0 +1,129 @@
+/**
+ * synap whoami
+ *
+ * Answers the one question `synap status` can't: WHICH key is this session
+ * actually authenticating with, and does the ambient `SYNAP_HUB_API_KEY`
+ * silently disagree with the pinned `claude-code` surface key?
+ *
+ * `synap status` probes via `resolveHubConfig()` and prints a single "Valid"
+ * off whichever key wins — which HIDES the case where the env key is revoked
+ * but a valid surface key is pinned (or vice-versa). This command:
+ *   1. resolves the winning cfg (the key every command uses),
+ *   2. independently reads env key + `claude-code` surface key and reproduces
+ *      the surface-over-env preference rule from hub-client.ts:394-403,
+ *   3. introspects the winner via `/auth/status`, and
+ *   4. when env and surface keys diverge, names the winner AND the ignored key,
+ *      probing the loser too so the operator sees both states side by side.
+ *
+ * It never mutates state and never relies on resolveHubConfig's stderr swap
+ * warning (hub-client.ts:398-400) — it reads the divergence itself.
+ */
+import chalk from "chalk";
+import { log, banner } from "../utils/logger.js";
+import { resolveHubConfig, hubGet, HubError } from "../lib/hub-client.js";
+import { getSurfaceAgentKey } from "../lib/pod.js";
+/** Last 6+ chars of a key, for eyeballing which secret is in play without leaking it. */
+function keyTail(apiKey) {
+    return apiKey.length <= 8 ? "…" : `…${apiKey.slice(-6)}`;
+}
+/** Introspect a specific key by cloning the winning cfg and swapping the secret. */
+async function probeKey(cfg, apiKey) {
+    try {
+        const status = (await hubGet("/auth/status", {}, { ...cfg, apiKey }));
+        return { kind: "ok", status };
+    }
+    catch (err) {
+        const is401 = err instanceof HubError
+            ? err.status === 401
+            : String(err instanceof Error ? err.message : err).toLowerCase().includes("unauthorized");
+        if (is401)
+            return { kind: "revoked" };
+        return { kind: "error", message: err instanceof Error ? err.message : String(err) };
+    }
+}
+function renderAuthStatus(s) {
+    log.info(`Key ID     : ${s.keyIdPrefix ?? "unknown"}`);
+    log.info(`Key type   : ${s.keyType ?? chalk.dim("unknown")}`);
+    log.info(`Identity   : ${s.userEmail ?? s.userName ?? s.userId ?? "unknown"}`);
+    if (s.name)
+        log.info(`Key name   : ${s.name}`);
+    log.info(`Workspace  : ${s.workspaceId ?? chalk.dim("unknown")}`);
+    log.info(`Scopes     : ${s.scopes && s.scopes.length ? s.scopes.join(", ") : chalk.dim("(none)")}`);
+    const active = s.isActive === true ? chalk.green("active") : s.isActive === false ? chalk.red("revoked") : chalk.dim("unknown");
+    log.info(`Status     : ${active}`);
+    log.info(`Expires    : ${s.expiresAt ?? chalk.dim("never")}`);
+}
+export async function whoami() {
+    banner();
+    // 1. The key that actually authenticates every command.
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err instanceof Error ? err.message : String(err));
+        return;
+    }
+    // 2. Independently read the two candidate keys and reproduce the preference
+    //    rule from hub-client.ts:394-403 — do NOT depend on resolveHubConfig's
+    //    stderr swap warning, read the state ourselves.
+    const envKey = process.env.SYNAP_HUB_API_KEY;
+    const envPod = process.env.SYNAP_POD_URL;
+    const surfaceKey = getSurfaceAgentKey("claude-code");
+    const surfacePinnedHere = !!surfaceKey && !!surfaceKey.hubApiKey && surfaceKey.podUrl === envPod;
+    const diverges = !!envKey &&
+        surfacePinnedHere &&
+        surfaceKey.hubApiKey !== envKey;
+    // Which candidate did resolveHubConfig actually pick?
+    const winner = diverges
+        ? cfg.apiKey === surfaceKey.hubApiKey
+            ? "surface"
+            : "env"
+        : "other";
+    // 3. Introspect the winning key.
+    log.heading("Winning key (resolved)");
+    log.info(`Pod        : ${cfg.podUrl}`);
+    log.dim(`Secret     : ${keyTail(cfg.apiKey)}`);
+    const winnerProbe = await probeKey(cfg, cfg.apiKey);
+    if (winnerProbe.kind === "ok") {
+        renderAuthStatus(winnerProbe.status);
+    }
+    else if (winnerProbe.kind === "revoked") {
+        log.error("This key is revoked or expired — /auth/status returned 401.");
+        log.hint("Refresh it with: synap login --reconnect");
+    }
+    else {
+        log.warn(`Could not introspect key: ${winnerProbe.message}`);
+    }
+    // 4. Divergence report — the whole point of the command.
+    if (!diverges) {
+        if (envKey && surfacePinnedHere) {
+            log.dim("\nEnv key and claude-code surface key agree — no divergence.");
+        }
+        log.blank();
+        return;
+    }
+    log.heading("⚠ Key divergence detected");
+    const winnerLabel = winner === "surface" ? "claude-code surface key" : "ambient SYNAP_HUB_API_KEY";
+    const loserLabel = winner === "surface" ? "ambient SYNAP_HUB_API_KEY" : "claude-code surface key";
+    const loserSecret = winner === "surface" ? envKey : surfaceKey.hubApiKey;
+    // Mirror the surface-key warning wording at hub-client.ts:398-400.
+    log.warn(`ambient SYNAP_HUB_API_KEY does not match the claude-code surface key pinned to ${envPod}.`);
+    log.info(`Winner  (used)    : ${chalk.bold(winnerLabel)}  ${chalk.dim(keyTail(cfg.apiKey))}`);
+    log.info(`Ignored (in play) : ${loserLabel}  ${chalk.dim(keyTail(loserSecret))}`);
+    // Probe the LOSING key so both states are visible side by side.
+    const loserProbe = await probeKey(cfg, loserSecret);
+    if (loserProbe.kind === "ok") {
+        const s = loserProbe.status;
+        const active = s.isActive === false ? chalk.red("revoked") : chalk.green("valid");
+        log.info(`  ${loserLabel} → ${active} (${s.keyIdPrefix ?? "?"}, ${s.userEmail ?? s.userId ?? "?"})`);
+    }
+    else if (loserProbe.kind === "revoked") {
+        log.warn(`  ${loserLabel} → ${chalk.red("revoked")} (401 from /auth/status)`);
+    }
+    else {
+        log.dim(`  ${loserLabel} → could not verify: ${loserProbe.message}`);
+    }
+    log.blank();
+}
+//# sourceMappingURL=whoami.js.map

package/dist/commands/whoami.js.map

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

package/dist/index.d.ts

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
 /**
- * @synap/cli — Connect OpenClaw to sovereign knowledge infrastructure
+ * @synap/cli — Connect AI agents to your Synap data pod
  *
  * Usage:
  *   npx @synap/cli init              Full setup: detect, harden, connect, install
- *   npx @synap/cli connect           Connect OpenClaw to an existing Synap pod
- *   npx @synap/cli security-audit    Check OpenClaw for known vulnerabilities
- *   npx @synap/cli status            Show pod + OpenClaw health
+ *   npx @synap/cli connect           Connect an AI surface to a Synap pod
+ *   npx @synap/cli status            Show pod health and API status
  *   npx @synap/cli update            Update skill + check for CLI updates
  *
  * Or install globally: