@synap-core/cli 1.11.0 → 1.13.0

package/dist/commands/workspace-ops.js

@@ -0,0 +1,153 @@
+/**
+ * Governed workspace operations (R8a):
+ *
+ *   synap workspace archive <id|name>      POST  /api/hub/workspaces/:id/archive
+ *   synap workspace restore <id>           POST  /api/hub/workspaces/:id/restore
+ *   synap workspace rename <id|name> <new> PATCH /api/hub/workspaces/:id
+ *   synap entity move <ids...> --to <ws>   POST  /api/hub/entities/move
+ *
+ * Every one of these is GOVERNED on the pod: with an agent key the answer is a
+ * proposal (`proposed` is success — approve it with `synap open proposal <id>`);
+ * with an owner key it applies. This file only resolves names and prints.
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet, hubPost, hubPatch, } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Resolve <id|name> to { id, name }. An id is taken as-is (an ARCHIVED
+ * workspace is hidden from the list, so restore must be able to name it by id).
+ */
+export async function resolveWorkspaceRef(value, cfg) {
+    if (UUID_RE.test(value))
+        return { id: value, name: value };
+    const res = (await hubGet("/workspaces", {}, cfg));
+    const list = unwrapList(res, ["workspaces"]);
+    const match = list.find((w) => String(w.name ?? "").toLowerCase() === value.toLowerCase());
+    if (!match) {
+        const names = list.map((w) => String(w.name ?? w.id)).join(", ");
+        throw new Error(`Workspace '${value}' not found.${names ? ` Available: ${names}` : ""} ` +
+            "(Archived workspaces are hidden — pass the workspace id.)");
+    }
+    return { id: String(match.id), name: String(match.name ?? match.id) };
+}
+/** True when the pod answered with a proposal instead of applying. */
+function isProposed(res) {
+    return !!res && typeof res === "object" && res.status === "proposed";
+}
+function printProposed(res, what) {
+    log.success(`${what} filed for review.`);
+    if (res.proposalId)
+        log.dim(`Approve it: synap open proposal ${res.proposalId}`);
+    if (res.reviewUrl)
+        log.dim(res.reviewUrl);
+}
+function fail(e) {
+    const msg = e.message ?? String(e);
+    log.error(msg);
+    if (/HTTP 403/.test(msg)) {
+        log.hint("403 — owner or pod admin only, or a protected/system workspace.");
+    }
+    else if (/HTTP 404/.test(msg)) {
+        log.hint("404 — that workspace or entity does not exist.");
+    }
+    process.exit(1);
+}
+async function archiveOrRestore(target, restore, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const ws = await resolveWorkspaceRef(target, cfg);
+        const res = await hubPost(`/workspaces/${ws.id}/${restore ? "restore" : "archive"}`, opts.reason ? { reasoning: opts.reason } : {}, cfg);
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        if (isProposed(res)) {
+            printProposed(res, restore ? `Restore of '${ws.name}'` : `Archive of '${ws.name}'`);
+            return;
+        }
+        const body = res;
+        const name = body.name ?? ws.name;
+        if (restore) {
+            log.success(`Restored workspace '${name}'.`);
+            const paused = body.pausedByArchive ?? [];
+            if (paused.length > 0) {
+                log.dim(`${paused.length} automation(s) are still paused from the archive — re-enable the ones you want:`);
+                for (const a of paused)
+                    log.dim(`  ${a.name}  ${chalk.dim(`synap automation enable ${a.id}`)}`);
+            }
+        }
+        else {
+            log.success(`Archived workspace '${name}'.`);
+            const paused = body.pausedAutomations ?? [];
+            if (paused.length > 0) {
+                log.dim(`Paused ${paused.length} automation(s): ${paused.map((a) => a.name).join(", ")}`);
+                log.dim("Restoring the workspace will NOT re-enable them.");
+            }
+        }
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export function workspaceArchive(target, opts) {
+    return archiveOrRestore(target, false, opts);
+}
+export function workspaceRestore(target, opts) {
+    return archiveOrRestore(target, true, opts);
+}
+export async function workspaceRename(target, newName, opts) {
+    try {
+        const trimmed = newName.trim();
+        if (!trimmed)
+            throw new Error("New name must not be empty.");
+        const cfg = await resolveHubConfig(opts);
+        const ws = await resolveWorkspaceRef(target, cfg);
+        const res = await hubPatch(`/workspaces/${ws.id}`, { name: trimmed }, cfg);
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        if (isProposed(res)) {
+            printProposed(res, `Rename of '${ws.name}' to '${trimmed}'`);
+            return;
+        }
+        log.success(`Renamed '${ws.name}' to '${trimmed}'.`);
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+export async function entityMove(entityIds, opts) {
+    try {
+        const bad = entityIds.filter((id) => !UUID_RE.test(id));
+        if (bad.length > 0)
+            throw new Error(`Not entity ids: ${bad.join(", ")}`);
+        const cfg = await resolveHubConfig(opts);
+        const ws = await resolveWorkspaceRef(opts.to, cfg);
+        const res = (await hubPost("/entities/move", { entityIds, workspaceId: ws.id, ...(opts.reason ? { reason: opts.reason } : {}) }, cfg));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        const moved = res.moved ?? [];
+        const proposed = res.proposed ?? [];
+        const errors = res.errors ?? [];
+        if (moved.length)
+            log.success(`Moved ${moved.length} entit${moved.length === 1 ? "y" : "ies"} to '${ws.name}'.`);
+        if (proposed.length) {
+            log.success(`${proposed.length} move(s) filed for review.`);
+            for (const p of proposed)
+                log.dim(`  ${p.entityId.slice(0, 8)}  synap open proposal ${p.proposalId}`);
+        }
+        for (const e of errors)
+            log.error(`${e.entityId.slice(0, 8)}: ${e.error}`);
+        if (errors.length && !moved.length && !proposed.length)
+            process.exit(1);
+    }
+    catch (e) {
+        fail(e);
+    }
+}
+//# sourceMappingURL=workspace-ops.js.map

package/dist/commands/workspace-ops.js.map

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

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 /**
- * @synap/cli — Connect AI agents to your Synap data pod
+ * @synap-core/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 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
+ *   npx @synap-core/cli init              Full setup: detect, harden, connect, install
+ *   npx @synap-core/cli connect           Connect an AI surface to a Synap pod
+ *   npx @synap-core/cli status            Show pod health and API status
+ *   npx @synap-core/cli update            Show how to update the CLI
  *
  * Or install globally:
- *   npm i -g @synap/cli
+ *   npm i -g @synap-core/cli
  *   synap init
  */
 export {};