@synap-core/cli 1.10.0 → 1.12.2

package/dist/commands/doc.js

@@ -8,17 +8,20 @@
  *   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> --content "new body"
  *   synap doc update <id> --file ./notes.md
  *   echo "updated" | synap doc update <id>
+ *   synap doc update <id> --section risks --section-title "Risks" --file ./risks.md
  *
  * API:
- *   POST  /api/hub/documents        — { userId, workspaceId?, title, content?, type? }
- *   PATCH /api/hub/documents/:id    — { userId, content } (full-replace, proposal-gated)
+ *   POST  /api/hub/documents            — { userId, workspaceId?, title, content?, type? }
+ *   PATCH /api/hub/documents/:id        — { userId, content, baseRevision? } (full replace)
+ *   POST  /api/hub/documents/:id/patch  — { userId, ops, baseRevision? } (--section: one upsert_section op)
  */
 import { readFileSync } from "fs";
 import { log } from "../utils/logger.js";
 import { resolveHubConfig, resolveUserId, hubPost, hubPatch, } from "../lib/hub-client.js";
+import { writeGovernance } from "../lib/capture-lane.js";
 import { openInBrowser } from "./open.js";
 /** Read content from --content flag, --file flag, or stdin (in that priority order). */
 async function resolveContent(content, file) {
@@ -71,9 +74,13 @@ export async function docCreate(opts) {
         }
         const isProposed = res.status === "proposed" || Boolean(res.proposalId);
         if (isProposed) {
-            log.warn(`Queued for approval (proposal: ${String(res.proposalId ?? "")})`);
+            // A proposal is normal — the write is queued for review, not a failure.
+            log.info(`Document: ${opts.title} — proposed (under review)`);
+            const proposalId = String(res.proposalId ?? "");
+            if (proposalId)
+                log.dim(`  proposal: ${proposalId}`);
             if (res.reviewUrl)
-                log.dim(`  Review: ${String(res.reviewUrl)}`);
+                log.dim(`  review: ${String(res.reviewUrl)}`);
             return;
         }
         log.success(`Document created: ${opts.title}`);
@@ -88,36 +95,111 @@ export async function docCreate(opts) {
         process.exit(1);
     }
 }
+/**
+ * synap doc reference <url> — create an external reference document (no bytes).
+ * Reuses the same POST /api/hub/documents door as `doc create`, sending a `url`
+ * field instead of `content`.
+ */
+export async function docReference(url, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        const body = {
+            userId,
+            title: opts.title,
+            url,
+        };
+        // A reference can be pod-wide; only scope it when a workspace is available.
+        if (workspaceId)
+            body.workspaceId = workspaceId;
+        const res = (await hubPost("/documents", body, cfg));
+        // `/documents` returns the row directly — no `{ document: … }` wrapper.
+        const id = String(res.id ?? "");
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        if (writeGovernance(res) === "proposed") {
+            // A proposal is normal — the write is queued for review, not a failure.
+            // Mirror `synap upload`'s neutral phrasing (info, not warn).
+            log.info(`Reference: ${opts.title} — proposed (under review)`);
+            const proposalId = String(res.proposalId ?? "");
+            if (proposalId)
+                log.dim(`  proposal: ${proposalId}`);
+            if (res.reviewUrl)
+                log.dim(`  review: ${String(res.reviewUrl)}`);
+            return;
+        }
+        log.success(`Reference created: ${opts.title}`);
+        log.dim(`  url: ${url}`);
+        log.dim(`  id: ${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).");
+        if (content === undefined) {
+            log.error("Provide --content, --file, or pipe stdin to supply new content.");
             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));
+        let baseRevision;
+        if (opts.baseRevision !== undefined) {
+            baseRevision = Number(opts.baseRevision);
+            if (!Number.isInteger(baseRevision) || baseRevision < 0) {
+                log.error("--base-revision must be a whole number (the `revision` a read returned).");
+                process.exit(1);
+            }
+        }
+        if (opts.section !== undefined && !opts.sectionTitle) {
+            log.error("--section needs --section-title (the section's heading).");
+            process.exit(1);
+        }
+        // --section writes ONE section through the patch door; otherwise the
+        // content replaces the whole body (PATCH, an alias of the same door).
+        const res = (opts.section !== undefined
+            ? await hubPost(`/documents/${documentId}/patch`, {
+                userId,
+                ops: [
+                    {
+                        op: "upsert_section",
+                        id: opts.section,
+                        title: opts.sectionTitle,
+                        body: content,
+                    },
+                ],
+                ...(baseRevision !== undefined ? { baseRevision } : {}),
+            }, cfg)
+            : await hubPatch(`/documents/${documentId}`, {
+                userId,
+                content,
+                ...(baseRevision !== undefined ? { baseRevision } : {}),
+            }, 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 ?? "")})`);
+            // A proposal is normal — the write is queued for review, not a failure.
+            log.info(`Update: ${documentId.slice(0, 8)}… — proposed (under review)`);
+            const proposalId = String(res.proposalId ?? "");
+            if (proposalId)
+                log.dim(`  proposal: ${proposalId}`);
             if (res.reviewUrl)
-                log.dim(`  Review: ${String(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 });
         }

package/dist/commands/doc.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,130 @@
+/**
+ * synap doctor — coherence preflight.
+ *
+ * Catches CLI-side config drift in ONE call instead of scattered 404/403
+ * failures partway through a real command. Checks, in order:
+ *   (a) SYNAP_POD_URL resolves — the host is actually served (catches the
+ *       classic failure: a stale/migrated domain that still LOOKS configured).
+ *   (b) the key authenticates against that pod.
+ *   (c) the configured workspace (and project) actually exist on THIS pod —
+ *       via `GET /orient`, which is the pod's own answer to "what's valid here".
+ *   (d) the Intelligence Service is reachable — the dependency that capture,
+ *       import and all AI structuring run through. Without it doctor once
+ *       printed "All checks passed" while every import was 502-ing.
+ *   (e) the connection broker answers — and when it does not, WHY: broker
+ *       kind, relay credential presence + expiry, control-plane issuer trust
+ *       and the owner's identity link, with the one fix for that reason.
+ *   (f) prints the active lens (pod, workspace, project) so the user sees
+ *       exactly where they're pointed.
+ *
+ * Degrades gracefully on older pods (missing /orient, no dependency probe) — a
+ * check that can't run says so and moves on, it never throws. Crucially, a
+ * check that could not run reports "could not determine" and is NOT green: an
+ * unknown is not a pass. Only a PROVEN failure sets a non-zero exit code.
+ */
+interface DoctorOpts {
+    json?: boolean;
+    /** Every check with its details, ids and addresses. */
+    verbose?: boolean;
+    /** Perform the one right action per key problem, then verify with a real MCP initialize. */
+    fix?: boolean;
+}
+interface CheckResult {
+    name: string;
+    /** true ONLY when the check verified something good. */
+    ok: boolean;
+    /**
+     * true when the check could not run at all — an unknown, not a pass and not
+     * a proven failure. It still suppresses "All checks passed" (that green line
+     * over an undetermined dependency is the exact lie this file is fixing), but
+     * it does NOT set a failing exit code, because nothing was proven broken.
+     */
+    unknown?: boolean;
+    detail: string;
+    fix?: string;
+}
+/**
+ * What the pod's dependency probe says about the Intelligence Service.
+ *
+ * Mirrors the pod's own three states rather than flattening them to a boolean
+ * (`packages/api/src/routers/hub-protocol/rest/health-dependencies.ts`):
+ *   • `up`         — state "reachable".
+ *   • `down`       — state "unreachable": the pod KNOWS the IS URL, the probe failed.
+ *   • `unresolved` — the pod could not even work out WHICH IS to call. Still a
+ *     real failure (a capture hits the same resolution), but a different fault
+ *     with a different fix, so it is never reported as "unreachable".
+ *   • `unknown`    — the CLI could not read an answer at all. NOT a pass.
+ */
+export type IsHealthVerdict = {
+    state: "up" | "down" | "unresolved" | "unknown";
+    detail: string;
+};
+export declare function readIntelligenceHealth(payload: unknown): IsHealthVerdict;
+/**
+ * Turn an IS verdict into a check row. Names the CONSEQUENCE, not just the
+ * dependency: the incident this fixes had a green doctor while every capture /
+ * import was 502-ing, so "IS unreachable" alone does not tell the user that the
+ * command they are about to run cannot work.
+ */
+export declare function intelligenceCheck(verdict: IsHealthVerdict): CheckResult;
+export declare function doctor(opts?: DoctorOpts): Promise<void>;
+/**
+ * What `GET /api/hub/connectors/providers` says about the broker.
+ * `not-configured` is the route's own 503 ("Nango not configured"); every other
+ * failure to read is `unknown`, never a pass.
+ */
+export type BrokerProvidersRead = {
+    state: "ok";
+} | {
+    state: "not-configured";
+} | {
+    state: "error";
+    reason: string;
+    message?: string;
+} | {
+    state: "unknown";
+    detail: string;
+};
+/**
+ * `GET /api/hub/connectors/broker-diagnostics` (synap-backend
+ * `connectors/broker-trust-diagnostics.ts`). Non-secret by contract.
+ */
+export interface BrokerTrustReport {
+    cpIssuer: {
+        present: boolean;
+        status: string | null;
+        hasSourceConfigWrite: boolean;
+    };
+    ownerIdentityLink: {
+        present: boolean;
+    };
+    /** `resolvable` is absent on a pod that predates it. */
+    relayCredential: {
+        present: boolean;
+        resolvable?: boolean;
+        validUntil: string | null;
+    };
+    broker: {
+        kind: string;
+        reason: string | null;
+    };
+}
+export type BrokerDiagnosticsRead = {
+    state: "read";
+    report: BrokerTrustReport;
+} | {
+    state: "unknown";
+    detail: string;
+};
+export declare function readProvidersEnvelope(payload: unknown): BrokerProvidersRead;
+export declare function readBrokerDiagnostics(payload: unknown): BrokerDiagnosticsRead;
+/** The one fix for a broker fault, sharpened by the trust diagnostics when readable. */
+export declare function brokerFixHint(reason: string, diagnostics: BrokerDiagnosticsRead, message?: string): string;
+export declare function brokerCheck(providers: BrokerProvidersRead, diagnostics: BrokerDiagnosticsRead): CheckResult;
+/**
+ * Default output never shows internal addresses, ids or raw timestamps — they
+ * are noise to a person and stay one `-v` away. A parenthetical that only
+ * carried an id ("(checked as workspace <uuid>)") goes entirely.
+ */
+export declare function forDisplay(text: string, verbose?: boolean): string;
+export {};