@synap-core/cli 1.7.0 → 1.10.0

package/dist/commands/doc.js

@@ -0,0 +1,130 @@
+/**
+ * synap doc create / synap doc update
+ *
+ * Manage markdown documents on the pod.
+ *
+ * Usage:
+ *   synap doc create --title "My Doc" --content "# Hello" [--workspace <id>] [--open]
+ *   synap doc create --title "My Doc" --file ./notes.md [--open]
+ *   echo "# Hello" | synap doc create --title "My Doc"
+ *
+ *   synap doc update <id> --content "new body" [--title "New Title"]
+ *   synap doc update <id> --file ./notes.md
+ *   echo "updated" | synap doc update <id>
+ *
+ * API:
+ *   POST  /api/hub/documents        — { userId, workspaceId?, title, content?, type? }
+ *   PATCH /api/hub/documents/:id    — { userId, content } (full-replace, proposal-gated)
+ */
+import { readFileSync } from "fs";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, resolveUserId, hubPost, hubPatch, } from "../lib/hub-client.js";
+import { openInBrowser } from "./open.js";
+/** Read content from --content flag, --file flag, or stdin (in that priority order). */
+async function resolveContent(content, file) {
+    if (content !== undefined)
+        return content;
+    if (file) {
+        try {
+            return readFileSync(file, "utf-8");
+        }
+        catch (e) {
+            log.error(`Cannot read file: ${file} — ${e.message}`);
+            process.exit(1);
+        }
+    }
+    // stdin — only when it's a pipe (not a TTY)
+    if (!process.stdin.isTTY) {
+        return 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);
+        });
+    }
+    return undefined;
+}
+export async function docCreate(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        if (!workspaceId) {
+            log.error("Workspace ID required. Use --workspace <id> or set active workspace with: synap use <id>");
+            process.exit(1);
+        }
+        const content = await resolveContent(opts.content, opts.file);
+        const body = {
+            userId,
+            workspaceId,
+            title: opts.title,
+            type: "markdown",
+        };
+        if (content !== undefined)
+            body.content = content;
+        const res = (await hubPost("/documents", body, cfg));
+        const doc = res.document ?? res;
+        const id = String(doc.id ?? res.id ?? "");
+        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(`Document created: ${opts.title}`);
+        log.dim(`  id: ${id}`);
+        log.dim(`  open in browser: synap open document ${id}`);
+        if (opts.open && id) {
+            await openInBrowser({ kind: "document", id });
+        }
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+export async function docUpdate(documentId, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const content = await resolveContent(opts.content, opts.file);
+        if (content === undefined && opts.title === undefined) {
+            log.error("Provide --content, --file, or pipe stdin to supply new content. " +
+                "Title-only updates require --content as well (backend limitation).");
+            process.exit(1);
+        }
+        const body = { userId };
+        if (content !== undefined)
+            body.content = content;
+        if (opts.title !== undefined)
+            body.title = opts.title;
+        const res = (await hubPatch(`/documents/${documentId}`, 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(`Document updated: ${documentId.slice(0, 8)}…`);
+        if (opts.title)
+            log.dim(`  title: ${opts.title}`);
+        if (opts.open) {
+            await openInBrowser({ kind: "document", id: documentId });
+        }
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=doc.js.map

package/dist/commands/doc.js.map

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

package/dist/commands/events.d.ts

@@ -0,0 +1,26 @@
+/**
+ * synap events
+ *
+ * Show the event chain for an entity or recent pod-wide events.
+ *
+ * Usage:
+ *   synap events --entity <id>            # last 20 events for entity
+ *   synap events --entity <id> --limit 50
+ *   synap events --entity <id> --json
+ *   synap events --limit 20               # recent pod-wide events
+ *
+ * API: GET /api/hub/events
+ * Query params: userId (pinned server-side), subjectId, type, subjectType,
+ *               fromDate, limit (default 50, max 200).
+ * Response: { events: WireEvent[] }  — newest first.
+ * WireEvent shape: { id, type, subjectType?, subjectId?, userId?, workspaceId?,
+ *                    data?, timestamp? }
+ */
+export interface ListEventsOpts {
+    entity?: string;
+    limit?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function listEvents(opts: ListEventsOpts): Promise<void>;

package/dist/commands/events.js

@@ -0,0 +1,69 @@
+/**
+ * synap events
+ *
+ * Show the event chain for an entity or recent pod-wide events.
+ *
+ * Usage:
+ *   synap events --entity <id>            # last 20 events for entity
+ *   synap events --entity <id> --limit 50
+ *   synap events --entity <id> --json
+ *   synap events --limit 20               # recent pod-wide events
+ *
+ * API: GET /api/hub/events
+ * Query params: userId (pinned server-side), subjectId, type, subjectType,
+ *               fromDate, limit (default 50, max 200).
+ * Response: { events: WireEvent[] }  — newest first.
+ * WireEvent shape: { id, type, subjectType?, subjectId?, userId?, workspaceId?,
+ *                    data?, timestamp? }
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+export async function listEvents(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const limit = parseInt(opts.limit ?? "20", 10);
+        const params = { limit };
+        if (opts.entity)
+            params.subjectId = opts.entity;
+        const res = await hubGet("/events", params, cfg);
+        const events = unwrapList(res, ["events", "items"]);
+        if (opts.json) {
+            console.log(JSON.stringify(events, null, 2));
+            return;
+        }
+        const scope = opts.entity
+            ? `entity: ${opts.entity.slice(0, 8)}…`
+            : "pod-wide";
+        console.log(chalk.bold(`\nRecent events (${scope})`));
+        console.log("");
+        if (events.length === 0) {
+            log.dim("(no events found)");
+            console.log("");
+            return;
+        }
+        for (const ev of events) {
+            // Normalise timestamp — may be ISO string or Date
+            const raw = ev.timestamp ?? ev.createdAt ?? "";
+            let ts = String(raw);
+            try {
+                if (ts) {
+                    const d = new Date(ts);
+                    ts = d.toISOString().replace("T", " ").slice(0, 16);
+                }
+            }
+            catch { /* leave as-is */ }
+            const evType = String(ev.eventType ?? ev.type ?? "–");
+            const subjectType = ev.subjectType ? chalk.dim(` [${ev.subjectType}]`) : "";
+            const subjectId = ev.subjectId ? chalk.dim(`  → ${String(ev.subjectId).slice(0, 8)}`) : "";
+            console.log(`  ${chalk.dim(ts.padEnd(17))}  ${chalk.cyan(evType.padEnd(36))}${subjectType}${subjectId}`);
+        }
+        console.log("");
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/commands/events.js.map

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

package/dist/commands/explain.d.ts

@@ -0,0 +1,21 @@
+/**
+ * synap explain [topic]
+ *
+ * Static capability map — no network calls needed. Tells any agent starting
+ * cold what Synap can do and which CLI command to use for each operation.
+ *
+ * Usage:
+ *   synap explain              # full capability map
+ *   synap explain graph        # relations & graph traversal
+ *   synap explain memory       # memory & knowledge
+ *   synap explain automation   # automations
+ *   synap explain agents       # agents & runner
+ *   synap explain governance   # proposals & governance
+ *   synap explain views        # views & bento
+ *   synap explain events       # event chain
+ *   synap explain tools        # tools & external services
+ */
+export interface ExplainOpts {
+    topic?: string;
+}
+export declare function explain(opts: ExplainOpts): Promise<void>;

package/dist/commands/explain.js

@@ -0,0 +1,251 @@
+/**
+ * synap explain [topic]
+ *
+ * Static capability map — no network calls needed. Tells any agent starting
+ * cold what Synap can do and which CLI command to use for each operation.
+ *
+ * Usage:
+ *   synap explain              # full capability map
+ *   synap explain graph        # relations & graph traversal
+ *   synap explain memory       # memory & knowledge
+ *   synap explain automation   # automations
+ *   synap explain agents       # agents & runner
+ *   synap explain governance   # proposals & governance
+ *   synap explain views        # views & bento
+ *   synap explain events       # event chain
+ *   synap explain tools        # tools & external services
+ */
+import chalk from "chalk";
+// ── Section renderers ──────────────────────────────────────────────────────────
+function sectionEntities() {
+    console.log(chalk.bold("\n## Entities & Profiles"));
+    console.log(chalk.dim("  Every piece of data is an entity with a profile type (schema)."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap orient")}               ${chalk.dim("→ see workspaces, profiles, capabilities")}`);
+    console.log(`  ${chalk.cyan("synap list profiles")}        ${chalk.dim("→ entity types available in active workspace")}`);
+    console.log(`  ${chalk.cyan("synap list entities")}        ${chalk.dim("→ browse entities (--profile, --workspace, --limit)")}`);
+    console.log(`  ${chalk.cyan("synap show <id>")}            ${chalk.dim("→ entity detail + all linked relations")}`);
+    console.log(`  ${chalk.cyan("synap get entity <id>")}      ${chalk.dim("→ raw entity properties")}`);
+    console.log(`  ${chalk.cyan("synap create entity")}        ${chalk.dim("→ --profile task --name 'Fix bug' --props '{}'")}`);
+    console.log(`  ${chalk.cyan("synap set entity <id>")}      ${chalk.dim("→ --props '{\"status\":\"done\"}'")}`);
+    console.log(`  ${chalk.cyan("synap browse [profile]")}     ${chalk.dim("→ paginated entity list (cleanest UX)")}`);
+    console.log(`  ${chalk.cyan("synap ask <query>")}          ${chalk.dim("→ the one read verb — routes across all substrates")}`);
+}
+function sectionGraph() {
+    console.log(chalk.bold("\n## Relations & Graph"));
+    console.log(chalk.dim("  Entities are connected by typed relations forming a traversable graph."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap create relation")}      ${chalk.dim("→ --source <id> --target <id> --type extends")}`);
+    console.log(`  ${chalk.cyan("synap graph --entity <id>")}  ${chalk.dim("→ BFS traversal depth 2 (--depth 3 for deeper)")}`);
+    console.log(`  ${chalk.cyan("synap show <id>")}            ${chalk.dim("→ entity + its relations in one view")}`);
+    console.log("");
+    console.log(chalk.dim("  Relation types are workspace-defined. Check your workspace schema for valid types."));
+    console.log(chalk.dim("  maxDepth clamped to 3. Response: flat array of entity + relation records."));
+}
+function sectionMemory() {
+    console.log(chalk.bold("\n## Memory & Knowledge"));
+    console.log(chalk.dim("  Canonical verbs: ask (read) · capture (structured write)."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap ask <query>")}          ${chalk.dim("→ the one read verb — routes semantic/procedural/episodic")}`);
+    console.log(`  ${chalk.cyan("synap capture")}              ${chalk.dim("→ structured knowledge: --type gotcha|lesson|decision|reference")}`);
+    console.log(`                              ${chalk.dim("     --claim 'text' --why 'context' --tags 'repo:x'")}`);
+    console.log(`  ${chalk.cyan("synap context")}              ${chalk.dim("→ session-start: knowledge + proposals + tasks")}`);
+    console.log(`  ${chalk.cyan("synap observe write <text>")} ${chalk.dim("→ record user observation (AI-maintained model)")}`);
+    console.log(`  ${chalk.cyan("synap observe recall <q>")}   ${chalk.dim("→ search user observations")}`);
+}
+function sectionEvents() {
+    console.log(chalk.bold("\n## Events & Event Chain"));
+    console.log(chalk.dim("  Every mutation emits a typed event. Subscribe for real-time feeds."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap events --entity <id>")} ${chalk.dim("→ recent event history for an entity")}`);
+    console.log(`  ${chalk.cyan("synap events --limit 50")}    ${chalk.dim("→ pod-wide recent events")}`);
+    console.log(`  ${chalk.cyan("synap subscribe")}            ${chalk.dim("→ NDJSON stream (long-poll, Ctrl+C to stop)")}`);
+    console.log(`  ${chalk.cyan("synap subscribe --event proposal.*")}  ${chalk.dim("→ filtered stream")}`);
+    console.log("");
+    console.log(chalk.dim("  Event shape: { id, type, subjectType, subjectId, userId, workspaceId, data, timestamp }"));
+    console.log(chalk.dim("  Query params: subjectId, type, subjectType, fromDate, limit (max 200)."));
+}
+function sectionAutomation() {
+    console.log(chalk.bold("\n## Automations"));
+    console.log(chalk.dim("  Trigger→filter→action rules. Triggers: event pattern, cron, webhook, manual."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap automation list")}      ${chalk.dim("→ list automations (--workspace, --status)")}`);
+    console.log(`  ${chalk.cyan("synap automation describe <id>")}`);
+    console.log(`  ${chalk.cyan("synap automation create")}    ${chalk.dim("→ --name X --trigger event:entity.* --action notify")}`);
+    console.log(`  ${chalk.cyan("synap automation enable <id> / disable <id> / delete <id>")}`);
+    console.log(`  ${chalk.cyan("synap automation schema")}    ${chalk.dim("→ fetch DSL schema (AI context)")}`);
+    console.log("");
+    console.log(chalk.dim("  Action types: notify | channel-message | none"));
+    console.log(chalk.dim("  Cron trigger: --trigger cron:0_*_*_*_*   Event: --trigger event:entity.*"));
+}
+function sectionViews() {
+    console.log(chalk.bold("\n## Views"));
+    console.log(chalk.dim("  Named query + rendering configs over the entity store."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap view list")}            ${chalk.dim("→ list views (--workspace)")}`);
+    console.log(`  ${chalk.cyan("synap view create")}          ${chalk.dim("→ --type kanban --profile task --name 'My Board'")}`);
+    console.log("");
+    console.log(chalk.dim("  View types (12):"));
+    console.log(chalk.dim("    table | kanban | bento | list | grid | gallery"));
+    console.log(chalk.dim("    calendar | masonry | flow | matrix | branch_tree | whiteboard"));
+    console.log("");
+    console.log(chalk.dim("  Bento views hold a widget arrangement (react-grid-layout)."));
+    console.log(chalk.dim("  Each bento widget: { id, kind: view|entity|widget|<custom>, x, y, w, h, config }"));
+}
+function sectionGovernance() {
+    console.log(chalk.bold("\n## Proposals & Governance"));
+    console.log(chalk.dim("  AI mutations that require approval go through proposals first."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap proposals list")}       ${chalk.dim("→ pending proposals (--workspace, --limit)")}`);
+    console.log(`  ${chalk.cyan("synap proposals approve <id>")} ${chalk.dim("→ --reason 'text'")}`);
+    console.log(`  ${chalk.cyan("synap proposals reject <id>")} ${chalk.dim("→ --reason 'text'")}`);
+    console.log("");
+    console.log(chalk.dim("  When a mutation is gated: response.status = 'proposed', response.proposalId set."));
+    console.log(chalk.dim("  Proposals are reversible — approve, reject, or revert after execution."));
+}
+function sectionTools() {
+    console.log(chalk.bold("\n## Tools & External Services"));
+    console.log(chalk.dim("  39 Nango-powered integrations: Google, GitHub, Notion, Linear, Slack, Jira, …"));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap tools list")}            ${chalk.dim("→ available tools + connection status")}`);
+    console.log(`  ${chalk.cyan("synap cap list")}               ${chalk.dim("→ capabilities, one row per pack, with status + connection")}`);
+    console.log(`  ${chalk.cyan("synap cap connect [name]")}     ${chalk.dim("→ connect a credential to a capability")}`);
+    console.log(`  ${chalk.cyan("synap cap enable [name]")}      ${chalk.dim("→ turn on a capability (ensures connection, picks verbs)")}`);
+    console.log(`  ${chalk.cyan("synap cap show <name>")}        ${chalk.dim("→ status, connection, verbs, next action")}`);
+    console.log(`  ${chalk.cyan("synap cap run <verb>")}         ${chalk.dim("→ launch a verb")}`);
+    console.log(`  ${chalk.cyan("synap tools disconnect <provider>")}`);
+    console.log(`  ${chalk.cyan("synap tools schema")}          ${chalk.dim("→ supported providers + field mapping (AI context)")}`);
+}
+function sectionAgents() {
+    console.log(chalk.bold("\n## Agents"));
+    console.log(chalk.dim("  Named agent identities (separate keys) + autonomous runner + recurring schedules."));
+    console.log("");
+    console.log(`  ${chalk.cyan("synap agents list")}          ${chalk.dim("→ configured agent identities")}`);
+    console.log(`  ${chalk.cyan("synap agents create")}        ${chalk.dim("→ --template twin|assistant|custom --name X")}`);
+    console.log(`  ${chalk.cyan("synap agents add")}           ${chalk.dim("→ register pre-existing credential")}`);
+    console.log(`  ${chalk.cyan("synap agent run")}            ${chalk.dim("→ --goal 'text' --persona researcher")}`);
+    console.log(`  ${chalk.cyan("synap agent schedule")}       ${chalk.dim("→ --goal X --name Y --every daily")}`);
+    console.log(`  ${chalk.cyan("synap agent tick")}           ${chalk.dim("→ run due schedules (wire to crontab)")}`);
+    console.log("");
+    console.log(chalk.dim("  Persona types: researcher | assistant | developer"));
+    console.log(chalk.dim("  Model alias: synap/advanced (default). Pass --model to override."));
+}
+function sectionQuickRef() {
+    console.log(chalk.bold("\n## CLI Quick Reference"));
+    console.log("");
+    console.log(chalk.dim("  Auth & setup"));
+    console.log(`  ${chalk.cyan("synap pods list / add / use <name>")}`);
+    console.log(`  ${chalk.cyan("synap use <workspace-id>")}   ${chalk.dim("→ set active workspace")}`);
+    console.log(`  ${chalk.cyan("synap orient")}               ${chalk.dim("→ who am I, what workspaces, capabilities")}`);
+    console.log("");
+    console.log(chalk.dim("  Data"));
+    console.log(`  ${chalk.cyan("synap browse [profile]")}  ${chalk.cyan("synap show <id>")}  ${chalk.cyan("synap ask <q>")}`);
+    console.log(`  ${chalk.cyan("synap create entity")}  ${chalk.cyan("synap set entity <id>")}`);
+    console.log(`  ${chalk.cyan("synap capture --type lesson")}`);
+    console.log("");
+    console.log(chalk.dim("  Graph"));
+    console.log(`  ${chalk.cyan("synap graph --entity <id> [--depth 2]")}`);
+    console.log(`  ${chalk.cyan("synap create relation --source X --target Y --type related_to")}`);
+    console.log("");
+    console.log(chalk.dim("  Events"));
+    console.log(`  ${chalk.cyan("synap events --entity <id>")}`);
+    console.log(`  ${chalk.cyan("synap subscribe [--event proposal.*]")}`);
+    console.log("");
+    console.log(chalk.dim("  Governance"));
+    console.log(`  ${chalk.cyan("synap proposals list")}  ${chalk.cyan("synap proposals approve <id>")}`);
+    console.log("");
+    console.log(chalk.dim("  Browser navigation (requires desktop app)"));
+    console.log(`  ${chalk.cyan("synap open entity <id>")}     ${chalk.dim("→ open entity in side panel")}`);
+    console.log(`  ${chalk.cyan("synap open view <id>")}       ${chalk.dim("→ open view in main panel")}`);
+    console.log(`  ${chalk.cyan("synap open cell <typeKey>")}  ${chalk.dim("→ open any registered cell in side panel")}`);
+    console.log("");
+    console.log(chalk.dim("  AI-generated cells (Capability B)"));
+    console.log(`  ${chalk.cyan("synap artifact create --html <file>")}  ${chalk.dim("→ define a frame cell from HTML source")}`);
+    console.log(`  ${chalk.cyan("  --name <name> --open")}               ${chalk.dim("→ set cell name + open immediately in browser")}`);
+    console.log("");
+    console.log(chalk.dim("  Context for this session"));
+    console.log(`  ${chalk.cyan("synap context")}              ${chalk.dim("→ knowledge + proposals + tasks")}`);
+    console.log(`  ${chalk.cyan("synap explain [topic]")}      ${chalk.dim("→ full capability map (this command)")}`);
+}
+// ── Main export ───────────────────────────────────────────────────────────────
+export async function explain(opts) {
+    const topic = opts.topic?.toLowerCase();
+    switch (topic) {
+        case "graph":
+        case "relations":
+        case "relation":
+            sectionGraph();
+            break;
+        case "memory":
+        case "knowledge":
+        case "note":
+        case "recall":
+            sectionMemory();
+            break;
+        case "events":
+        case "event":
+        case "subscribe":
+            sectionEvents();
+            break;
+        case "automation":
+        case "automations":
+            sectionAutomation();
+            break;
+        case "views":
+        case "view":
+        case "bento":
+            sectionViews();
+            break;
+        case "governance":
+        case "proposals":
+        case "proposal":
+            sectionGovernance();
+            break;
+        case "tools":
+        case "connectors":
+        case "connector":
+        case "integrations":
+            sectionTools();
+            break;
+        case "agents":
+        case "agent":
+            sectionAgents();
+            break;
+        case "entities":
+        case "entity":
+        case "profiles":
+            sectionEntities();
+            break;
+        case "quickref":
+        case "quick-ref":
+        case "ref":
+        case "commands":
+            sectionQuickRef();
+            break;
+        case undefined:
+        case "":
+        case "all": {
+            // Full capability map
+            console.log(chalk.bold.cyan("\nSynap Capability Map"));
+            console.log(chalk.dim("  Sovereign personal data infrastructure. Run any section with: synap explain <topic>"));
+            console.log(chalk.dim("  Topics: entities | graph | memory | events | automation | views | governance | tools | agents\n"));
+            sectionEntities();
+            sectionGraph();
+            sectionMemory();
+            sectionEvents();
+            sectionAutomation();
+            sectionViews();
+            sectionGovernance();
+            sectionTools();
+            sectionAgents();
+            sectionQuickRef();
+            break;
+        }
+        default:
+            console.log(chalk.yellow(`  Unknown topic: "${opts.topic}". Valid topics:`));
+            console.log(chalk.dim("  entities | graph | memory | events | automation | views | governance | tools | agents | commands"));
+            process.exit(1);
+    }
+    console.log("");
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

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

package/dist/commands/facet.d.ts

@@ -0,0 +1,29 @@
+import { type HubConfig } from "../lib/hub-client.js";
+import { type BaseOpts } from "./data.js";
+export interface EffectiveFacet {
+    facet: {
+        id: string;
+        entityId: string;
+        profileId: string;
+        workspaceId?: string | null;
+        status?: string | null;
+        properties?: Record<string, unknown>;
+    };
+    profile?: {
+        slug: string;
+        displayName: string;
+    };
+}
+/** Fetch an entity's attached roles. Shared with `show <id>`'s Roles section. */
+export declare function fetchFacets(entityId: string, cfg: HubConfig): Promise<EffectiveFacet[]>;
+/** Render the "Roles (n)" heading + each role's name/status/properties. */
+export declare function renderRoles(facets: EffectiveFacet[]): void;
+export declare function attachFacet(entityId: string, roleSlug: string, opts: BaseOpts & {
+    property?: string[];
+    workspace?: string;
+}): Promise<void>;
+export declare function listFacets(entityId: string, opts: BaseOpts): Promise<void>;
+export declare function detachFacet(facetOrEntityId: string, opts: BaseOpts & {
+    entity?: string;
+    role?: string;
+}): Promise<void>;