@synap-core/cli 1.7.0 → 1.10.0

package/dist/commands/facet.js

@@ -0,0 +1,113 @@
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet, hubPost, hubDelete, renderHubError } from "../lib/hub-client.js";
+import { resolveActiveLens } from "../lib/session-lens.js";
+import { reportWrite } from "../lib/capture-lane.js";
+import { unwrapList } from "../lib/unwrapList.js";
+/** Fetch an entity's attached roles. Shared with `show <id>`'s Roles section. */
+export async function fetchFacets(entityId, cfg) {
+    const res = (await hubGet(`/entities/${entityId}/facets`, {}, cfg));
+    return unwrapList(res, ["facets"]);
+}
+/** Render the "Roles (n)" heading + each role's name/status/properties. */
+export function renderRoles(facets) {
+    log.heading(`Roles (${facets.length})`);
+    for (const item of facets) {
+        const name = item.profile?.displayName ?? item.profile?.slug ?? "role";
+        const status = item.facet.status ? chalk.dim(` [${item.facet.status}]`) : "";
+        log.info(`${chalk.bold(name)}${status}  ${chalk.dim(item.facet.id.slice(0, 8))}`);
+        for (const [k, v] of Object.entries(item.facet.properties ?? {})) {
+            if (v !== null && v !== undefined && v !== "")
+                log.dim(`  ${k}: ${String(v)}`);
+        }
+    }
+}
+// ─── facet attach ─────────────────────────────────────────────────────────────
+export async function attachFacet(entityId, roleSlug, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const workspaceId = opts.workspace ?? resolveActiveLens()?.workspaceId ?? cfg.workspaceId;
+        const properties = {};
+        for (const kv of opts.property ?? []) {
+            const idx = kv.indexOf("=");
+            if (idx === -1)
+                continue;
+            properties[kv.slice(0, idx)] = kv.slice(idx + 1);
+        }
+        const res = (await hubPost(`/entities/${entityId}/facets`, {
+            profileSlug: roleSlug,
+            ...(Object.keys(properties).length > 0 ? { properties } : {}),
+            ...(workspaceId ? { workspaceId } : {}),
+        }, cfg));
+        // Same governed-write reporter every other write uses (destination line,
+        // "proposed" copy, --json `outcome`/lane fields) — no bespoke messaging.
+        await reportWrite(res, {
+            label: `Attached role: ${chalk.bold(roleSlug)}`,
+            lane: "work",
+            workspaceId,
+            cfg,
+            json: opts.json,
+        });
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(1);
+    }
+}
+// ─── facet list ───────────────────────────────────────────────────────────────
+export async function listFacets(entityId, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const facets = await fetchFacets(entityId, cfg);
+        if (opts.json) {
+            console.log(JSON.stringify({ facets }, null, 2));
+            return;
+        }
+        if (facets.length === 0) {
+            log.dim("No roles attached to this entity.");
+            log.dim(`  Attach one with: synap facet attach ${entityId} <role-slug>`);
+            return;
+        }
+        renderRoles(facets);
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(1);
+    }
+}
+// ─── facet detach ─────────────────────────────────────────────────────────────
+export async function detachFacet(facetOrEntityId, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        let facetId = facetOrEntityId;
+        let roleLabel = ""; // known only in the `--entity <id> --role <slug>` form
+        if (opts.entity && opts.role) {
+            const facets = await fetchFacets(opts.entity, cfg);
+            const match = facets.find((f) => f.profile?.slug === opts.role);
+            if (!match) {
+                console.error(chalk.red(`No role '${opts.role}' attached to entity ${opts.entity}`));
+                process.exit(1);
+            }
+            facetId = match.facet.id;
+            roleLabel = opts.role;
+        }
+        const res = (await hubDelete(`/facets/${facetId}`, cfg));
+        // Name the role when we know it; only the bare `detach <facetId>` form falls
+        // back to the id prefix.
+        const label = roleLabel
+            ? `Detached role: ${chalk.bold(roleLabel)}`
+            : `Detached role ${chalk.dim(facetId.slice(0, 8))}`;
+        await reportWrite(res, {
+            label,
+            lane: "work",
+            workspaceId: resolveActiveLens()?.workspaceId ?? cfg.workspaceId,
+            cfg,
+            json: opts.json,
+        });
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=facet.js.map

package/dist/commands/facet.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,18 @@
+/**
+ * synap graph
+ *
+ * BFS graph traversal from a starting entity via the Hub Protocol.
+ *
+ * Usage:
+ *   synap graph --entity <id>            # traversal depth 2
+ *   synap graph --entity <id> --depth 3
+ *   synap graph --entity <id> --json
+ */
+export interface GraphTraverseOpts {
+    entity: string;
+    depth?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function graphTraverse(opts: GraphTraverseOpts): Promise<void>;

package/dist/commands/graph.js

@@ -0,0 +1,74 @@
+/**
+ * synap graph
+ *
+ * BFS graph traversal from a starting entity via the Hub Protocol.
+ *
+ * Usage:
+ *   synap graph --entity <id>            # traversal depth 2
+ *   synap graph --entity <id> --depth 3
+ *   synap graph --entity <id> --json
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, resolveUserId, hubGet } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+export async function graphTraverse(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const maxDepth = parseInt(opts.depth ?? "2", 10);
+        const results = await hubGet("/graph/traverse", {
+            startEntityId: opts.entity,
+            maxDepth,
+            userId,
+        }, cfg);
+        if (opts.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        // The API returns a flat array of records — each record is an entity or
+        // relation row from the traversal. Split by whether it has a `sourceEntityId`
+        // (relation) or not (node).
+        const nodes = [];
+        const edges = [];
+        for (const row of unwrapList(results)) {
+            if (row.sourceEntityId || row.targetEntityId) {
+                edges.push(row);
+            }
+            else {
+                nodes.push(row);
+            }
+        }
+        console.log(chalk.bold(`\nGraph from ${opts.entity} (depth ${maxDepth})`));
+        console.log(chalk.bold(`\nNodes (${nodes.length}):`));
+        if (nodes.length === 0) {
+            log.dim("(none)");
+        }
+        else {
+            for (const n of nodes) {
+                const profile = String(n.profileSlug ?? n.entityType ?? n.type ?? "entity").padEnd(14);
+                const title = String(n.title ?? n.name ?? "–").slice(0, 40).padEnd(42);
+                const id = chalk.dim(String(n.id ?? "").slice(0, 8));
+                console.log(`  ${chalk.cyan("•")} ${profile} ${title} ${id}`);
+            }
+        }
+        console.log(chalk.bold(`\nEdges (${edges.length}):`));
+        if (edges.length === 0) {
+            log.dim("(none)");
+        }
+        else {
+            for (const e of edges) {
+                const relType = String(e.type ?? e.relationType ?? e.relationshipType ?? "–").padEnd(22);
+                const src = String(e.sourceEntityId ?? "?").slice(0, 8);
+                const tgt = String(e.targetEntityId ?? "?").slice(0, 8);
+                console.log(`  ${chalk.dim(relType)}  ${chalk.dim(src)} → ${chalk.dim(tgt)}`);
+            }
+        }
+        console.log("");
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

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

package/dist/commands/home.d.ts

@@ -0,0 +1,12 @@
+/**
+ * synap home
+ *
+ * Show the current bento layout of the active workspace's home screen.
+ * Useful at the start of an agent session to understand what's already
+ * present before proposing UI changes.
+ */
+import type { BaseOpts } from "./data.js";
+export interface HomeOpts extends BaseOpts {
+    workspace?: string;
+}
+export declare function showHome(opts: HomeOpts): Promise<void>;

package/dist/commands/home.js

@@ -0,0 +1,54 @@
+/**
+ * synap home
+ *
+ * Show the current bento layout of the active workspace's home screen.
+ * Useful at the start of an agent session to understand what's already
+ * present before proposing UI changes.
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet } from "../lib/hub-client.js";
+import { getAgentWorkspaceRouting } from "../lib/pod.js";
+export async function showHome(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const routing = getAgentWorkspaceRouting();
+        const workspaceId = opts.workspace ??
+            routing?.memoryWorkspaceId ??
+            cfg.workspaceId;
+        if (!workspaceId) {
+            console.error(chalk.red("Error: no workspace resolved. Pass --workspace <id> or run `synap context` to set active workspace."));
+            process.exit(1);
+        }
+        const res = (await hubGet(`/workspaces/${workspaceId}/home`, {}, cfg));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        const viewLabel = res.homeViewName
+            ? `${res.homeViewName} (${res.homeViewId ?? "no view"})`
+            : res.homeViewId ?? chalk.dim("none");
+        log.info(`Home layout — workspace ${chalk.bold(workspaceId.slice(0, 8))}`);
+        console.log(`  View: ${chalk.cyan(viewLabel)}`);
+        console.log(`  Blocks: ${res.blocks.length}`);
+        if (res.blockSummary.length === 0) {
+            console.log(chalk.dim("  (empty — no bento blocks on home yet)"));
+            return;
+        }
+        console.log("");
+        for (const b of res.blockSummary) {
+            const kindLabel = chalk.dim(`[${b.kind}]`);
+            const typeLabel = b.typeKey ? chalk.cyan(b.typeKey) : "";
+            const nameLabel = b.label ? chalk.white(b.label) : chalk.dim("unlabelled");
+            const idLabel = b.id ? chalk.dim(` ${b.id.slice(0, 8)}`) : "";
+            console.log(`  ${kindLabel} ${typeLabel}  ${nameLabel}${idLabel}`);
+        }
+        console.log("");
+        console.log(chalk.dim("Tip: use `create_proposal` with targetType:\"workspace_home\" to propose adding or removing blocks."));
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=home.js.map

package/dist/commands/home.js.map

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

package/dist/commands/import.d.ts

@@ -0,0 +1,38 @@
+/**
+ * synap import — "capture, but for files and URLs".
+ *
+ * Routes EVERY input (local file, folder, or http(s) URL) through the SAME AI
+ * capture centerpiece as free-text `capture`:
+ *   POST /capture/structure  (AI entity extraction + workspace/project routing)
+ *   POST /capture/execute    (materialize the chosen proposals + relations)
+ *
+ * One item per file/url. This inherits AI entity extraction, the relation graph,
+ * workspace routing AND project routing for free — no separate /import/* path.
+ *
+ * Inputs:
+ *   - http(s) URL              → sent as `url`
+ *   - directory                → recursively globbed (skips node_modules/.git/dotfiles)
+ *   - file                     → text-like → utf8, everything else → base64
+ *
+ * Routing: --workspace / --project override the AI's suggestion; otherwise the
+ * AI-proposed targetWorkspaceId / targetProjectId from /capture/structure win.
+ */
+export interface ImportOpts {
+    workspace?: string;
+    project?: string;
+    dryRun?: boolean;
+    yes?: boolean;
+    session?: boolean;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+    /** Adapter name: "superwhisper" enables paired store-first path. */
+    source?: string;
+    /** Skip AI structure; store corpus units (Superwhisper). */
+    storeFirst?: boolean;
+    withAudio?: boolean;
+    limit?: number;
+    concurrency?: number;
+    resume?: boolean;
+}
+export declare function importData(inputs: string[], opts: ImportOpts): Promise<void>;