@synap-core/cli 1.8.0 → 1.11.0

package/dist/commands/market-authoring.js

@@ -0,0 +1,225 @@
+/**
+ * `synap market` — the template AUTHORING loop.
+ * =============================================
+ *
+ * The other half of `market` (browse/install/update/installed lives in
+ * `market.ts`): the create→publish path an author walks.
+ *
+ *   synap market scaffold <slug>        — write a minimal valid <slug>.template.yaml
+ *   synap market validate  <file>       — run the ONE shared validator, fast feedback
+ *   synap market publish   <file>       — validate, then upsert to the CP (private by default)
+ *   synap market publish   --from-workspace <id>  — serialize a LIVE workspace, then publish
+ *   synap market unpublish <slug>       — flip a published package back to private
+ *
+ * REUSE: validation is the shared `validateTemplate` (via `lib/template-file`);
+ * CP transport is `lib/cp-packages` (`publishPackage`/`unpublishPackage`); the
+ * pod `to-template` serializer is reached through the standard hub client. No
+ * fetch is hand-rolled here.
+ */
+import { existsSync, writeFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { parseTemplateFile, validateTemplateYaml, templateToPackageDefinition, packageDefinitionToYaml, scaffoldTemplateYaml, } from "../lib/template-file.js";
+import { publishPackage, unpublishPackage, CpWriteError, } from "../lib/cp-packages.js";
+import { resolveHubConfig, hubPost, renderHubError } from "../lib/hub-client.js";
+/** Print a validator failure list human-readably: `rule` · `path` — `message`. */
+function printValidationErrors(errors) {
+    for (const e of errors) {
+        console.error(`  ${chalk.red("✗")} ${chalk.yellow(e.rule)} ${chalk.dim(e.path)}\n      ${e.message}`);
+    }
+}
+// ─── validate ────────────────────────────────────────────────────────────────
+export async function marketValidate(file, opts) {
+    let tpl;
+    try {
+        tpl = parseTemplateFile(file);
+    }
+    catch (e) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, errors: [{ rule: "parse", path: file, message: e.message }] }, null, 2));
+        }
+        else {
+            log.error(e.message);
+        }
+        process.exit(1);
+    }
+    const result = validateTemplateYaml(tpl);
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.ok)
+            process.exit(1);
+        return;
+    }
+    if (result.ok) {
+        log.success(`${file} is valid.`);
+        return;
+    }
+    log.error(`${file} has ${result.errors.length} validation error${result.errors.length === 1 ? "" : "s"}:`);
+    printValidationErrors(result.errors);
+    process.exit(1);
+}
+// ─── scaffold ──────────────────────────────────────────────────────────────
+export async function marketScaffold(slug, opts) {
+    const fileName = `${slug}.template.yaml`;
+    const target = resolvePath(process.cwd(), fileName);
+    // Create-then-configure: refuse to clobber, never overwrite an author's work.
+    if (existsSync(target)) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, error: "exists", path: target }, null, 2));
+        }
+        else {
+            log.error(`${fileName} already exists — refusing to overwrite.`);
+            log.hint("Edit it in place, or choose a different slug.");
+        }
+        process.exit(1);
+    }
+    writeFileSync(target, scaffoldTemplateYaml(slug), "utf-8");
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: true, path: target, slug }, null, 2));
+        return;
+    }
+    log.success(`Wrote ${fileName}`);
+    log.dim("Edit it in place, then:");
+    log.dim(`  synap market validate ${fileName}`);
+    log.dim(`  synap market publish ${fileName}`);
+}
+// ─── publish ─────────────────────────────────────────────────────────────────
+/**
+ * POST `/api/hub/workspaces/:id/to-template` — the pod-native serializer that
+ * turns a LIVE workspace into a full `PackageDefinition`. The one door for the
+ * `--from-workspace` publish path; mirrors every other `/api/hub/*` call.
+ */
+export async function fetchWorkspaceAsTemplate(workspaceId, opts) {
+    const cfg = await resolveHubConfig(opts);
+    const res = (await hubPost(`/workspaces/${encodeURIComponent(workspaceId)}/to-template`, {}, cfg, 60_000));
+    if (!res?.definition) {
+        throw new Error(`Workspace ${workspaceId} produced no template definition.`);
+    }
+    return res.definition;
+}
+/** Surface a publish outcome (created/updated/no-op) uniformly. */
+function reportPublish(r) {
+    const vis = r.isPublic ? chalk.green("public") : chalk.dim("private");
+    switch (r.outcome) {
+        case "created":
+            log.success(`Published ${chalk.bold(r.slug)} ${chalk.dim(r.version)} (${vis})`);
+            break;
+        case "updated":
+            log.success(`Updated ${chalk.bold(r.slug)} → ${chalk.dim(r.version)} (${vis})`);
+            break;
+        case "no-op":
+            log.info(`${chalk.bold(r.slug)} is already up to date at ${chalk.dim(r.version)} (${vis}) — nothing to publish.`);
+            break;
+    }
+}
+/** Turn a CP write failure into a clear, honest message — never swallow the server `detail`; special-case the reserved-slug 403. */
+function reportCpWriteError(err, slug) {
+    if (err.status === 403 && /reserved/i.test(err.serverMessage) && slug) {
+        log.error(`"${slug}" is a reserved Synap bedrock template — publish under a different slug.`);
+        log.hint("Reserved: foundation, crm, operations, content-os, enterprise-os, research-base.");
+        return;
+    }
+    log.error(`Publish failed${err.status ? ` (HTTP ${err.status})` : ""}: ${err.serverMessage}`);
+}
+export async function marketPublish(file, opts) {
+    // Default PRIVATE; `--public` flips it. `--private` is accepted as the explicit
+    // default so a script can state intent.
+    const isPublic = opts.public === true;
+    // 1. Obtain the definition + a WorkspaceYaml view to validate.
+    let def;
+    let yamlForValidate;
+    let sourceLabel;
+    if (opts.fromWorkspace) {
+        try {
+            def = await fetchWorkspaceAsTemplate(opts.fromWorkspace, opts);
+        }
+        catch (e) {
+            renderHubError(e);
+            process.exit(1);
+        }
+        yamlForValidate = packageDefinitionToYaml(def);
+        sourceLabel = `workspace ${opts.fromWorkspace}`;
+    }
+    else {
+        if (!file) {
+            log.error("Provide a template file, or --from-workspace <id>.");
+            process.exit(1);
+        }
+        try {
+            const tpl = parseTemplateFile(file);
+            yamlForValidate = tpl;
+            def = templateToPackageDefinition(tpl);
+        }
+        catch (e) {
+            log.error(e.message);
+            process.exit(1);
+        }
+        sourceLabel = file;
+    }
+    // 2. Validate BEFORE any publish network call (the fast author-feedback gate).
+    const result = validateTemplateYaml(yamlForValidate);
+    if (!result.ok) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, stage: "validate", errors: result.errors }, null, 2));
+        }
+        else {
+            log.error(`${sourceLabel} failed validation — not published:`);
+            printValidationErrors(result.errors);
+        }
+        process.exit(1);
+    }
+    // 3. Publish.
+    const slug = def._meta?.slug;
+    try {
+        const r = await publishPackage(def, { isPublic });
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, ...r }, null, 2));
+            return;
+        }
+        reportPublish(r);
+    }
+    catch (e) {
+        if (e instanceof CpWriteError) {
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, stage: "publish", status: e.status, error: e.serverMessage, slug }, null, 2));
+            }
+            else {
+                reportCpWriteError(e, slug);
+            }
+            process.exit(1);
+        }
+        log.error(`Publish failed: ${e.message}`);
+        process.exit(1);
+    }
+}
+// ─── unpublish ───────────────────────────────────────────────────────────────
+export async function marketUnpublish(slug, opts) {
+    try {
+        const r = await unpublishPackage(slug);
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, ...r }, null, 2));
+            return;
+        }
+        log.success(`${chalk.bold(slug)} is now ${r.isPublic ? "public" : "private"}.`);
+    }
+    catch (e) {
+        if (e instanceof CpWriteError) {
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, status: e.status, error: e.serverMessage, slug }, null, 2));
+            }
+            else {
+                log.error(`Unpublish failed${e.status ? ` (HTTP ${e.status})` : ""}: ${e.serverMessage}`);
+                // The CP PATCH door does not yet accept `isPublic` (only `podId`) — say so
+                // rather than leaving a bare validation error.
+                if (e.status === 400) {
+                    log.hint("The control-plane PATCH door needs `isPublic` added to its allow-list (TODO cp).");
+                }
+            }
+            process.exit(1);
+        }
+        log.error(`Unpublish failed: ${e.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=market-authoring.js.map

package/dist/commands/market-authoring.js.map

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

package/dist/commands/market.d.ts

@@ -0,0 +1,224 @@
+/**
+ * `synap market` — discover + install ANY package type.
+ * =====================================================
+ *
+ * `synap launch` is workspace-first: it turns an empty pod into a company from
+ * BUNDLED workspace templates (offline). `market` is the superset browser — it
+ * reaches EVERY package type the control-plane registry carries
+ * (capability / skill / workflow / view / cell / workspace), public or private,
+ * over the shared catalog door (`assembleCatalog` + the CP `/api/packages`
+ * transport). Suites (`enterprise-os`, `the-arch`) headline via the `suite` tag,
+ * not a hardcoded slug.
+ *
+ *   synap market [--search q] [--type t] [--list] [--json]   — browse
+ *   synap market install <slug>                              — install
+ *   synap market update [slug] [--yes] [--json]              — check/apply drift
+ *
+ * INSTALL SCOPE: WORKSPACE-type packages install via `/packages/apply` (the
+ * same door `launch` uses), which provisions a workspace from the definition.
+ * Non-workspace kinds (capability / automation / cell / template) install via
+ * the pod's kind-agnostic `market.install` verb on `/capabilities/execute`,
+ * which resolves the definition from `cp_catalog_cache`. Types the verb doesn't
+ * handle fall back to a route-to-browser message.
+ */
+import { type CatalogEntry, type TemplateUpdateCheck } from "@synap-core/workspace-templates";
+import { type PackageFilters, type TierInfo } from "../lib/cp-packages.js";
+import { type InstalledTemplateInfo } from "../lib/installed.js";
+export interface MarketCatalog {
+    entries: CatalogEntry[];
+    tierBySlug: Map<string, TierInfo>;
+    lockedSlugs: Set<string>;
+    installed: Set<string>;
+    /** Bundled slugs (public + private) — the offline-installable workspace set. */
+    bundledSlugs: Set<string>;
+    loggedIn: boolean;
+    reachedCp: boolean;
+    /**
+     * Slug → CP row's OWN `version`, read straight off `CpBrowseRow`/`CpMineRow`
+     * (NOT off the merged `entries[]`). Needed because `mergeCatalog`'s
+     * squatting-defense makes the BUNDLE win the merged entry for every OFFICIAL
+     * public template that also exists on the CP (list-route rows never carry
+     * `definition`, so `computeTemplateUpdates` sees no remote version for them
+     * via `entries[]` and would silently hide a real CP-side update). `market
+     * update` compares against THIS map directly instead.
+     */
+    remoteVersionBySlug: Map<string, string>;
+}
+/**
+ * Assemble the market catalog: bundled workspace templates ∪ public CP browse
+ * (all types) ∪ the caller's own packages (when logged in), through the shared
+ * `assembleCatalog` door. Unlike `launch`, PUBLIC CP rows are fetched even when
+ * logged out — the bundle only carries workspaces, so all-types discovery needs
+ * the CP browse route (which needs no auth).
+ */
+export declare function buildMarketCatalog(filters?: PackageFilters): Promise<MarketCatalog>;
+/** The `kind` values the pod's `market.install` verb provisions (see
+ * cp-catalog-sync.ts `CatalogKind`). */
+export type MarketInstallKind = "capability" | "automation" | "template" | "cell";
+/**
+ * Map a CP package `category` (what {@link typeOf} returns) → the pod
+ * `market.install` verb's `kind` vocabulary, or `null` when the verb can't
+ * install that type. The CP's live PACKAGE_TYPES and the pod's cache `kind`
+ * diverge (see cp-catalog-sync.ts): the CP's `workflow` is the pod's
+ * `automation`; the CP's `workspace` is the pod's `template` — but a workspace
+ * installs through the dedicated `/packages/apply` create path, so it never
+ * routes through here. `automation`/`template` are also accepted verbatim so a
+ * row already speaking the pod's cache vocabulary still resolves.
+ */
+export declare function marketInstallKind(type: string): MarketInstallKind | null;
+interface DependencySeedOutcome {
+    slug: string;
+    status: "no-layers" | "seeded" | "failed";
+    layers?: string[];
+    error?: string;
+}
+export interface ResolvedDependencyLike {
+    slug: string;
+    seedOutcome?: DependencySeedOutcome;
+}
+/**
+ * Top-level rollup the backend now sends alongside `dependencies[]` — same
+ * info, pre-aggregated. Kept local for the same reason as the types above:
+ * a structural match is all `/packages/apply`'s JSON needs, and this CLI
+ * doesn't carry api-types. Optional — older pod builds won't send it.
+ */
+export interface SeedSummary {
+    attempted: number;
+    seeded: number;
+    failed: Array<{
+        slug: string;
+        error: string;
+    }>;
+}
+/** The two new honest-outcome fields `/packages/apply` may return. Both optional — a legacy pod build may omit them. */
+export interface WorkspaceApplyResult {
+    status?: string;
+    workspaceId?: string;
+    onto?: string;
+    outcome?: "created" | "reconciled" | "unchanged";
+}
+export interface ApplyVerdict {
+    /** Honest coarse status — JSON consumers should branch on this, never guess from `workspace.outcome` alone. */
+    status: "installed" | "installed-with-failures" | "updated" | "updated-with-failures" | "unchanged" | "composed" | "composed-with-failures" | "stamp-contradiction" | "legacy-unknown" | "no-workspace";
+    /** Non-fatal warnings — a stamp contradiction or a compose-overlay note. Seed failures are reported separately via `printSeedOutcomes`. */
+    warnings: string[];
+}
+/**
+ * Classify one `/packages/apply` response into the honest verdict both
+ * `marketInstall` and `applyOnePackage` print (and both put in `--json`).
+ * `wasUnstamped` = the slug was already installed with no recorded version
+ * BEFORE this call (only `marketInstall` can detect this today — see its
+ * `fetchInstalledTemplates` call; `applyOnePackage` only ever re-applies
+ * already-versioned slugs, so it always passes `false`).
+ */
+export declare function classifyApplyResult(entry: CatalogEntry, ws: WorkspaceApplyResult | undefined, dependencies: ResolvedDependencyLike[] | undefined, seedSummary: SeedSummary | undefined, ctx: {
+    remoteVersionSent?: string;
+    wasUnstamped: boolean;
+}): ApplyVerdict;
+/** Render a `classifyApplyResult` verdict — the ONE honest-text door for both `marketInstall` and `applyOnePackage`. */
+export declare function printApplyVerdict(entry: CatalogEntry, verdict: ApplyVerdict): void;
+export declare function market(opts: {
+    list?: boolean;
+    json?: boolean;
+    search?: string;
+    type?: string;
+}): Promise<void>;
+export declare function marketInstall(slug: string, opts: {
+    podUrl?: string;
+    apiKey?: string;
+    json?: boolean;
+    project?: string;
+    timeout?: string;
+    /** Reconcile this template ONTO an existing workspace (additive) instead of creating a new one — passed through to `/packages/apply` as `targetWorkspaceId`. */
+    onto?: string;
+    /** Preview the create path write-free (`/packages/preflight`) — reports would-create / reuse / conflicts and writes nothing. */
+    dryRun?: boolean;
+}): Promise<void>;
+export interface UpdateCheck extends TemplateUpdateCheck {
+    /**
+     * True when the installed workspace carries no version stamp at all — the
+     * pod can't say whether it's stale. Distinct from `updateAvailable: false`
+     * (checked, and it IS current). Every CLI/Hub-door install is `true` today —
+     * see `InstalledTemplateInfo.version`'s doc in `lib/installed.ts`.
+     */
+    noVersionInfo: boolean;
+}
+/**
+ * Per-installed-slug drift check. Starts from the shared `computeTemplateUpdates`
+ * (handles bundled-only / private-only slugs via `bundleVersion`), then
+ * overrides `latestVersion`/`updateAvailable` with the CP row's OWN version for
+ * any slug in `remoteVersionBySlug` — the merge-winner bypass this command
+ * needs (see `MarketCatalog.remoteVersionBySlug`'s doc). A slug the pod never
+ * version-stamped is reported `noVersionInfo: true`, never silently "outdated".
+ */
+export declare function computeUpdates(installedTemplates: InstalledTemplateInfo[], cat: MarketCatalog): UpdateCheck[];
+export declare function marketUpdate(slugsArg: string[] | undefined, opts: {
+    yes?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+    timeout?: string;
+}): Promise<void>;
+export interface TreeNode {
+    slug: string;
+    name: string;
+    relation: "compose" | "require";
+    depKind?: string;
+    installed: boolean;
+    workspaceId?: string;
+    workspaceName?: string;
+    installedVersion?: string;
+    latestVersion?: string | null;
+    updateAvailable: boolean;
+    noVersionInfo: boolean;
+    /** Names of OTHER top-level packages whose tree also carries this slug. */
+    shared: string[];
+    children: TreeNode[];
+}
+export interface TreePackage {
+    slug: string;
+    name: string;
+    installedVersion: string;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    noVersionInfo: boolean;
+    workspaceCount: number;
+    isSuite: boolean;
+    children: TreeNode[];
+}
+/**
+ * The nested composition-tree view: one tree per installed TOP-LEVEL package
+ * (a suite, or any installed package whose `edgesOf` resolves at least one
+ * dependency — bundled OR remote). Everything else stays a flat leaf
+ * (`leafRows`, rendered like a plain `market installed` row). This is the
+ * SAME "top-level" rule the old walker used (kept verbatim for `--tree`'s
+ * JSON/text backward compatibility — see `marketInstalled`'s before/after
+ * diff check), just evaluated against the fixed `edgesOf` instead of the
+ * bundled-only map.
+ *
+ * Nested `TreeNode`s are built by walking `graph.edges` (both `require` and
+ * `compose` relations — the engine excludes compose SOURCES from `nodes`,
+ * rule 2, but never from `edges`, so the nested view still shows them exactly
+ * where the old walker did) and `shared` reads straight off each node's
+ * `roots` (the engine's true reachability set), replacing the old walker's
+ * bespoke reverse index.
+ */
+export declare function buildCompositionTrees(rows: UpdateCheck[], cat: MarketCatalog, installedTemplates: InstalledTemplateInfo[], workspaceCountBySlug: Map<string, number>): Promise<{
+    packages: TreePackage[];
+    leafRows: UpdateCheck[];
+}>;
+export declare function printCompositionTree(pkg: TreePackage): void;
+/**
+ * Pure-read inventory of what's installed on this pod — reuses
+ * `buildMarketCatalog` + `fetchInstalledTemplates` + `computeUpdates`
+ * (`market update`'s own drift check), never writes anything. Pairs with
+ * `market update` to apply what this surfaces.
+ */
+export declare function marketInstalled(opts: {
+    json?: boolean;
+    outdated?: boolean;
+    tree?: boolean;
+    layers?: boolean;
+}): Promise<void>;
+export {};