@easysociable/cli 0.1.3 → 0.1.5

package/dist/easysociable.js

@@ -15351,6 +15351,10 @@ function parseSlideshowRunSummaryList(payload) {
   assertNoPrivateTemplateFields(payload);
   return parseDataEnvelope(payload, external_exports.array(slideshowRunSummarySchema));
 }
+function parseSlideshowRunSummary(payload) {
+  assertNoPrivateTemplateFields(payload);
+  return parseDataEnvelope(payload, slideshowRunSummarySchema);
+}
 function parseBrand(payload) {
   return parseDataEnvelope(payload, brandSchema);
 }
@@ -15538,7 +15542,10 @@ var init_src = __esm({
       notFor: external_exports.array(external_exports.string()).optional(),
       locale: external_exports.enum(["zh-CN", "en", "bilingual"]).optional(),
       capacity: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-      previewImageUrl: external_exports.string().url().optional()
+      previewImageUrl: external_exports.string().url().optional(),
+      /** Layout Family id — catalog UIs group variants by this (ADR-0033). */
+      familyId: external_exports.string().optional(),
+      familyRole: external_exports.enum(["master", "variant"]).optional()
     }).strict();
     publicTemplateSlotTypeSchema = external_exports.enum(["text", "number", "image"]);
     publicTemplateSlotSchema = external_exports.object({
@@ -16288,7 +16295,7 @@ function isRetryableStatus(status) {
   return status === 429 || status === 502 || status === 503 || status === 504;
 }
 function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 var TemplateGatewayError, TemplateGatewayClient;
 var init_client = __esm({
@@ -16569,11 +16576,11 @@ var init_client = __esm({
         this.throwIfError(response.status, response.json);
         return parseSlideshowRun(response.json);
       }
+      /** Permanently delete a Slideshow Run (ADR-0034 hard delete). */
       async trashSlideshowRun(runId) {
         const response = await this.request("DELETE", `/v1/slideshow/runs/${encodeURIComponent(runId)}`);
         this.throwIfError(response.status, response.json);
-        const rows = parseSlideshowRunSummaryList(response.json);
-        return rows[0];
+        return parseSlideshowRunSummary(response.json);
       }
       async renderSlideshowRun(runId, body) {
         const input = renderSlideshowRunInputSchema.parse(body ?? {});
@@ -23452,7 +23459,7 @@ var init_protocol = __esm({
               return;
             }
             const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-            await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+            await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
             options?.signal?.throwIfAborted();
           }
         } catch (error52) {
@@ -23469,7 +23476,7 @@ var init_protocol = __esm({
        */
       request(request, resultSchema, options) {
         const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           const earlyReject = (error52) => {
             reject(error52);
           };
@@ -23547,7 +23554,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve2(parseResult.data);
+                resolve3(parseResult.data);
               }
             } catch (error52) {
               reject(error52);
@@ -23808,12 +23815,12 @@ var init_protocol = __esm({
           }
         } catch {
         }
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           if (signal.aborted) {
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
             return;
           }
-          const timeoutId = setTimeout(resolve2, interval);
+          const timeoutId = setTimeout(resolve3, interval);
           signal.addEventListener("abort", () => {
             clearTimeout(timeoutId);
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -26840,7 +26847,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve2.call(this, root, ref);
+      let _sch = resolve3.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -26867,7 +26874,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve2(root, ref) {
+    function resolve3(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -27442,7 +27449,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve2(baseURI, relativeURI, options) {
+    function resolve3(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse5(baseURI, schemelessOptions), parse5(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -27669,7 +27676,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve2,
+      resolve: resolve3,
       resolveComponent,
       equal,
       serialize,
@@ -31568,12 +31575,12 @@ var init_stdio2 = __esm({
         this.onclose?.();
       }
       send(message) {
-        return new Promise((resolve2) => {
+        return new Promise((resolve3) => {
           const json2 = serializeMessage(message);
           if (this._stdout.write(json2)) {
-            resolve2();
+            resolve3();
           } else {
-            this._stdout.once("drain", resolve2);
+            this._stdout.once("drain", resolve3);
           }
         });
       }
@@ -31644,8 +31651,8 @@ async function serveStdioMcp(options) {
   await waitForStdioServerClose(server, process.stdin);
 }
 async function waitForStdioServerClose(server, stdin = process.stdin) {
-  await new Promise((resolve2) => {
-    server.onclose = () => resolve2();
+  await new Promise((resolve3) => {
+    server.onclose = () => resolve3();
     if (stdin.readableEnded || stdin.destroyed) {
       void server.close().catch(() => void 0);
       return;
@@ -31974,7 +31981,7 @@ var init_src4 = __esm({
       {
         name: "create_render_job",
         title: "Create render job",
-        description: "Submit fill-slots hosted render: templateId + slots + outputFormats (ADR-0021). Image slot values must be renderAssetId (preferred) or catalog imageId. Do not send ContentDocument, contentDocumentHash, AST, Binding Map, or RenderPlan.",
+        description: "Retired as a paid delivery path. PNG packs come from Studio Download. Gateway returns HEADLESS_RENDER_DISABLED. Kept for compatibility; do not use for customer PNG delivery. Historic fill-slots shape: templateId + slots + outputFormats (ADR-0021).",
         effect: "local-write-job",
         inputSchema: {
           type: "object",
@@ -32275,8 +32282,8 @@ var init_src5 = __esm({
       { name: "update_run", title: "Update slideshow run", description: "Edit page-instance slots/layout/style/decorations or presentation preference with optimistic revision.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, pack: { type: "object" }, brandId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" }, baseRevision: { type: "integer", minimum: 1 }, pageIndex: { type: "integer", minimum: 0 }, slots: { type: "object" }, layout: { type: "object" }, style: { type: "object" }, decorations: { type: "array" } }, required: ["runId"] }, outputSchema: objectSchema },
       { name: "archive_run", title: "Archive slideshow run", description: "Hide a Run from default lists without deleting it.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
       { name: "restore_run", title: "Restore slideshow run", description: "Restore an archived or trashed Run.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
-      { name: "trash_run", title: "Trash slideshow run", description: "Move a Run to trash (recoverable for 30 days).", effect: "explicit-approval", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
-      { name: "render_run", title: "Render slideshow run", description: "Render a topology-locked Run as an atomic PNG set.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, idempotencyKey: { type: "string", minLength: 1, maxLength: 128 } }, required: ["runId", "idempotencyKey"] }, outputSchema: objectSchema }
+      { name: "trash_run", title: "Delete slideshow run", description: "Permanently delete a Slideshow Run (hard delete; not recoverable).", effect: "explicit-approval", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
+      { name: "render_run", title: "Render slideshow run", description: "Retired. PNG packs come from Studio Download in the browser, not hosted render jobs.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, idempotencyKey: { type: "string", minLength: 1, maxLength: 128 } }, required: ["runId", "idempotencyKey"] }, outputSchema: objectSchema }
     ];
     slideshowResourceTemplates = [
       { uriTemplate: "slideshow://runs/{runId}", name: "Slideshow Run", description: "Owner-scoped Run JSON snapshot", mimeType: "application/json" }
@@ -32311,7 +32318,7 @@ var init_src5 = __esm({
             case "trash_run":
               return { ok: true, data: await this.client.trashSlideshowRun(String(args.runId)), meta: m };
             case "render_run":
-              return { ok: true, data: await this.client.renderSlideshowRun(String(args.runId), { outputFormats: args.outputFormats ?? ["png"], idempotencyKey: String(args.idempotencyKey) }), meta: m };
+              return { ok: false, error: { code: "HEADLESS_RENDER_DISABLED", message: "PNG packs come from Studio Download, not CLI/MCP hosted jobs", retryable: false, suggestedAction: "Open the Slideshow in Studio and click Download" }, meta: m };
             default:
               return { ok: false, error: { code: "UNKNOWN_TOOL", message: `Unknown tool: ${toolName}`, retryable: false }, meta: m };
           }
@@ -32343,13 +32350,20 @@ async function serveUnifiedStdioMcp(client) {
     resourceTemplates: unifiedResourceTemplates
   }, { backendName: "gateway" });
 }
-var removedTools, templateNames, slideshowNames, brandTools, rename, templateTools, slideshowTools, imageTools, unifiedToolRegistry, unifiedResourceTemplates, UnifiedMcpBackend;
+var HEADLESS_PNG_DELIVERY, HEADLESS_TOOLS, removedTools, templateNames, slideshowNames, brandTools, rename, templateTools, slideshowTools, imageTools, unifiedToolRegistry, unifiedResourceTemplates, UnifiedMcpBackend;
 var init_src6 = __esm({
   "../../packages/mcp-server/src/index.ts"() {
     "use strict";
     init_src3();
     init_src4();
     init_src5();
+    HEADLESS_PNG_DELIVERY = {
+      code: "HEADLESS_RENDER_DISABLED",
+      message: "PNG packs come from Studio Download, not CLI/MCP hosted jobs",
+      retryable: false,
+      suggestedAction: "Open the Slideshow in Studio and click Download"
+    };
+    HEADLESS_TOOLS = /* @__PURE__ */ new Set(["create_template_render_job", "render_slideshow_run"]);
     removedTools = /* @__PURE__ */ new Set(["publish_run", "unpublish_run"]);
     templateNames = {
       create_draft: "create_template_draft",
@@ -32403,6 +32417,13 @@ var init_src6 = __esm({
         this.slideshow = new SlideshowMcpBackend(client);
       }
       invoke(toolName, args) {
+        if (HEADLESS_TOOLS.has(toolName)) {
+          return Promise.resolve({
+            ok: false,
+            error: { ...HEADLESS_PNG_DELIVERY },
+            meta: { requestId: `mcp_${Date.now().toString(36)}`, runtimeVersion: "0.0.0", schemaVersion: 1, toolContractVersion: "2026-09-04" }
+          });
+        }
         const templateTool = templateTools.find((tool) => tool.name === toolName);
         if (templateTool) return this.template.invoke(Object.entries(templateNames).find(([, name]) => name === toolName)?.[0] ?? toolName, args);
         const slideshowTool = slideshowTools.find((tool) => tool.name === toolName);
@@ -32486,11 +32507,10 @@ var init_v1_mcp = __esm({
 
 // src/v1-cli.ts
 init_src2();
-import { cp, mkdtemp, readFile, rename as rename2, rm, writeFile, mkdir, chmod, copyFile } from "fs/promises";
+import { cp, readFile, writeFile, mkdir, chmod, copyFile } from "fs/promises";
 import { existsSync as existsSync4, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
-import { createHash } from "crypto";
-import { homedir as homedir3, tmpdir } from "os";
-import { join as join4 } from "path";
+import { homedir as homedir3 } from "os";
+import { join as join4, resolve as resolve2 } from "path";
 import { Command } from "commander";
 
 // src/runtime/mcp-hosts.ts
@@ -32688,7 +32708,9 @@ function engineJson() {
       runs: "runs",
       exports: "exports",
       topics: "topics",
-      discovery: "discovery",
+      needs: "needs",
+      products: "products",
+      recommendations: "recommendations",
       swipe: "swipe",
       profiles: "profiles",
       inbox: "inbox",
@@ -32729,7 +32751,95 @@ function inventory(engine, moduleUrl) {
     starterComplete: missing.length === 0
   };
 }
-function validateEngine(rootOrEngine, moduleUrl, { strict = false } = {}) {
+function tableCell(md, field) {
+  const escaped = field.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const match = md.match(new RegExp(`^\\|\\s*(?:\\*\\*)?${escaped}(?:\\*\\*)?\\s*\\|\\s*([^|]*?)\\|`, "im"));
+  return match ? match[1].trim() : null;
+}
+function isFilledCell(value) {
+  if (value == null)
+    return false;
+  const text = value.trim();
+  return text.length > 0 && !/\(fill\)/i.test(text);
+}
+function headingSection(md, title) {
+  const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const match = md.match(new RegExp(`^##\\s+${escaped}\\s*$`, "im"));
+  if (!match || match.index == null)
+    return null;
+  const rest = md.slice(match.index + match[0].length);
+  const next = rest.search(/^##\s+/m);
+  return (next < 0 ? rest : rest.slice(0, next)).trim();
+}
+function isFilledSection(body) {
+  if (body == null)
+    return false;
+  const cleaned = body.replace(/\(fill\)/gi, "").replace(/^[-*]\s*$/gm, "").replace(/^\d+\.\s*$/gm, "").trim();
+  return cleaned.length > 0;
+}
+function activeProfileId(engine) {
+  const path = join3(engine, "accounts", "_index.md");
+  if (!existsSync3(path))
+    return null;
+  for (const line of readFileSync2(path, "utf8").split("\n")) {
+    if (!line.startsWith("|"))
+      continue;
+    const cells = line.split("|").slice(1, -1).map((cell) => cell.trim());
+    if (cells.length < 7)
+      continue;
+    if (/^-+$/.test(cells[0]) || /^handle$/i.test(cells[0]) || /^column$/i.test(cells[0]))
+      continue;
+    if (cells[6].toLowerCase() === "active" && cells[1])
+      return cells[1];
+  }
+  return null;
+}
+function countNeedIds(md) {
+  let count = 0;
+  for (const line of md.split("\n")) {
+    if (/^\|\s*N-\d{8}-\d+/.test(line))
+      count += 1;
+  }
+  return count;
+}
+function checkKnowledge(engine) {
+  const missing = [];
+  const profileId = activeProfileId(engine);
+  if (!profileId)
+    missing.push("accounts/_index.md");
+  const profile = profileId || "default";
+  const voiceRel = `profiles/${profile}/voice.md`;
+  const voicePath = join3(engine, voiceRel);
+  if (!existsSync3(voicePath)) {
+    missing.push(voiceRel);
+  } else {
+    const voice = readFileSync2(voicePath, "utf8");
+    for (const field of ["Role", "What I build", "Point of view"]) {
+      if (!isFilledCell(tableCell(voice, field))) {
+        missing.push(voiceRel);
+        break;
+      }
+    }
+  }
+  const boundariesRel = `profiles/${profile}/boundaries.md`;
+  const boundariesPath = join3(engine, boundariesRel);
+  if (!existsSync3(boundariesPath)) {
+    missing.push(boundariesRel);
+  } else {
+    const boundaries = readFileSync2(boundariesPath, "utf8");
+    if (!isFilledSection(headingSection(boundaries, "Not covering")) || !isFilledSection(headingSection(boundaries, "Never claim")))
+      missing.push(boundariesRel);
+  }
+  const needsDir = join3(engine, "needs");
+  if (isDir(needsDir)) {
+    const needsRel = "needs/_index.md";
+    const needsPath = join3(engine, needsRel);
+    if (!existsSync3(needsPath) || countNeedIds(readFileSync2(needsPath, "utf8")) < 3)
+      missing.push(needsRel);
+  }
+  return { valid: missing.length === 0, missing };
+}
+function validateEngine(rootOrEngine, moduleUrl, { strict = false, requireKnowledge = false } = {}) {
   const engine = resolveEngine(rootOrEngine);
   const parent = resolve(engine, "..");
   const errors = [];
@@ -32746,28 +32856,37 @@ function validateEngine(rootOrEngine, moduleUrl, { strict = false } = {}) {
     else if (result.missing.length > 0)
       errors.push(`Starter incomplete: ${result.missing.length} file(s) missing (use engine init --yes to add only missing files)`);
   }
-  return { ...result, valid: errors.length === 0, errors, created: [] };
+  const knowledge = requireKnowledge ? checkKnowledge(engine) : void 0;
+  if (knowledge && !knowledge.valid)
+    errors.push(`Knowledge gate failed: ${knowledge.missing.join(", ")}`);
+  return { ...result, valid: errors.length === 0, errors, created: [], ...knowledge ? { knowledge } : {} };
 }
 function python3Bin() {
   const result = spawnSync("python3", ["--version"], { encoding: "utf8" });
   return result.status === 0 ? "python3" : "";
 }
-function ensureWorkbench(engine, moduleUrl) {
+function ensureWorkbench(engine, moduleUrl, { update = false } = {}) {
   const destDir = join3(engine, "workbench");
   mkdirSync2(destDir, { recursive: true });
   const copied = [];
+  const updated = [];
   const skipped = [];
   const src = workbenchSrc(moduleUrl);
   for (const name of WORKBENCH_FILES) {
     const dest = join3(destDir, name);
-    if (existsSync3(dest)) {
+    const from = join3(src, name);
+    if (existsSync3(dest) && !update) {
       skipped.push(name);
       continue;
     }
-    copyFileSync(join3(src, name), dest);
-    copied.push(name);
+    const existed = existsSync3(dest);
+    copyFileSync(from, dest);
+    if (existed)
+      updated.push(name);
+    else
+      copied.push(name);
   }
-  return { destDir, copied, skipped };
+  return { destDir, copied, updated, skipped };
 }
 function buildWorkbench(engine) {
   const python = python3Bin();
@@ -32799,7 +32918,7 @@ async function startWorkbench(engine, moduleUrl, { noOpen = false } = {}) {
   const python = python3Bin();
   if (!python)
     return { ok: false, code: "PYTHON3_REQUIRED", message: "python3 is required for the workbench. Install Python 3 and retry." };
-  ensureWorkbench(engine, moduleUrl);
+  ensureWorkbench(engine, moduleUrl, { update: true });
   const built = buildWorkbench(engine);
   if (!built.ok)
     return built;
@@ -32931,6 +33050,7 @@ function readCliVersion() {
     return "0.0.0";
   }
 }
+var HEADLESS_RENDER_DISABLED = "PNG delivery is Studio Download (browser ZIP). CLI/MCP hosted PNG jobs are retired. Open the Run in Studio and use Download.";
 var credentialPath = join4(homedir3(), ".config", "easysociable", "credentials.json");
 function resolveInstallSkillIds(options) {
   return parseInstallSkills(typeof options.skills === "string" ? options.skills : void 0);
@@ -33050,29 +33170,20 @@ async function applyInstallation(options) {
     for (const skill of resolveInstallSkillIds(options))
       await cp(join4(String(plan.source), skill), join4(host.skillsPath, skill), { recursive: true, force: false, errorOnExist: false });
   }
+  if (options.json !== true) {
+    process.stdout.write(`Installed skills your Agent will use:
+  easysociable-slideshow  \u2014 turns a draft into slideshow pages you preview and download here
+  easysociable-template   \u2014 creates page templates
+`);
+  }
   return { ...plan, applied: true, backups };
 }
-async function readJsonArgument(value) {
-  if (existsSync4(value))
-    return JSON.parse(await readFile(value, "utf8"));
-  return JSON.parse(value);
-}
 function mimeTypeFor(fileName) {
   const extension = fileName.toLowerCase().split(".").pop();
   if (extension === "jpg" || extension === "jpeg") return "image/jpeg";
   if (extension === "webp") return "image/webp";
   return "image/png";
 }
-function renderSlots(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    throw new Error("Render slots must be a JSON object");
-  const entries = Object.entries(value);
-  for (const [key, item] of entries) {
-    if (!(typeof item === "string" || typeof item === "number" || item === null))
-      throw new Error(`Render slot ${key} must be a string, number or null`);
-  }
-  return Object.fromEntries(entries);
-}
 function withClient(action) {
   return async (...args) => {
     const command = args.at(-1);
@@ -33087,69 +33198,6 @@ function withClient(action) {
     }
   };
 }
-async function exportManifest(client, jobId, output) {
-  const job = await client.getRenderJob(jobId);
-  if (job.status !== "completed" || !job.manifest)
-    throw new Error(`Render job ${jobId} is not completed or has no manifest`);
-  const staging = await mkdtemp(join4(tmpdir(), "easysociable-export-"));
-  try {
-    for (const [index, artifact] of job.manifest.artifacts.entries()) {
-      const response = await fetch(artifact.url);
-      if (!response.ok) throw new Error(`Artifact download failed (${response.status})`);
-      const bytes = Buffer.from(await response.arrayBuffer());
-      const checksum = createHash("sha256").update(bytes).digest("hex");
-      if (checksum !== artifact.sha256) throw new Error(`Artifact checksum mismatch for page ${index + 1}`);
-      await writeFile(join4(staging, `${String(index + 1).padStart(2, "0")}.png`), bytes);
-    }
-    await writeFile(join4(staging, "manifest.json"), `${JSON.stringify(job.manifest, null, 2)}
-`);
-    await rm(output, { recursive: true, force: true });
-    await rename2(staging, output);
-    return { jobId, output, pages: job.manifest.artifacts.length, manifest: job.manifest };
-  } catch (error52) {
-    await rm(staging, { recursive: true, force: true });
-    throw error52;
-  }
-}
-async function exportSlideshowRun(client, runId, output) {
-  const manifest = await client.getSlideshowRunManifest(runId);
-  const staging = await mkdtemp(join4(tmpdir(), "easysociable-slideshow-export-"));
-  try {
-    const pages = [];
-    for (const artifact of manifest.artifacts) {
-      const bytes = Buffer.from(await client.downloadSlideshowArtifact(runId, artifact.pageIndex));
-      const checksum = createHash("sha256").update(bytes).digest("hex");
-      if (checksum !== artifact.sha256)
-        throw new Error(`Artifact checksum mismatch for page ${artifact.pageIndex + 1}`);
-      const role = artifact.role || `page${artifact.pageIndex}`;
-      const fileName = `${String(artifact.pageIndex + 1).padStart(2, "0")}-${role}.png`;
-      await writeFile(join4(staging, fileName), bytes);
-      pages.push({
-        pageIndex: artifact.pageIndex,
-        role,
-        file: fileName,
-        bytes: bytes.length,
-        sha256: checksum,
-        width: artifact.width,
-        height: artifact.height
-      });
-    }
-    const localManifest = {
-      schema: "slideshow-hosted-export.v1",
-      runId: manifest.runId,
-      deckJobId: manifest.deckJobId,
-      pages
-    };
-    await writeFile(join4(staging, "manifest.json"), `${JSON.stringify(localManifest, null, 2)}
-`);
-    await rm(output, { recursive: true, force: true });
-    await rename2(staging, output);
-    return { runId, output, pages: pages.length, manifest: localManifest };
-  } catch (error52) {
-    await rm(staging, { recursive: true, force: true });
-    throw error52;
-  }
-}
 function addCrudCommands(parent, resource, routes) {
   jsonOption(parent.command("list").description(`List ${resource}`)).action(withClient(async (client) => client.requestJson("GET", routes.list)));
   jsonOption(parent.command("get").requiredOption("--id <id>").description(`Get ${resource}`)).action(withClient(async (client, opts) => client.requestJson("GET", routes.get.replace(":id", String(opts.id)))));
@@ -33195,10 +33243,18 @@ function buildV1Cli() {
       throw new Error(errors?.[0] ?? result.code ?? "engine init failed");
     }
   });
-  jsonOption(engine.command("validate").description("Validate engine starter completeness or a run folder").option("--root <path>", "Parent directory or Content Engine path").option("--run <path>", "Run directory to validate").option("--require-pack", "Require pack-*.json on the run").option("--require-export", "Require export directory").option("--export <path>", "Export directory for --require-export")).action((...args) => {
+  jsonOption(engine.command("validate").description("Validate engine starter completeness or a run folder").option("--root <path>", "Parent directory or Content Engine path").option("--run <path>", "Run directory to validate").option("--require-pack", "Require pack-*.json on the run").option("--require-export", "Require export directory").option("--export <path>", "Export directory for --require-export").option("--require-knowledge", "Require Identity (Role / What I build / POV) + boundaries; needs count only if needs/ exists")).action((...args) => {
     const command = args.at(-1);
     const opts = command.opts();
     if (opts.run) {
+      if (opts.requireKnowledge === true) {
+        const engineRoot = resolve2(String(opts.run), "..", "..");
+        const knowledge = checkKnowledge(engineRoot);
+        if (!knowledge.valid) {
+          print({ valid: false, missing: knowledge.missing, knowledge, action: "validated" }, commandWantsJson(command));
+          throw new Error(`Knowledge gate failed: ${knowledge.missing.join(", ")}`);
+        }
+      }
       const result = validateRun(CLI_MODULE_URL, {
         run: String(opts.run),
         requirePack: opts.requirePack === true,
@@ -33215,31 +33271,30 @@ function buildV1Cli() {
     }
     if (!opts.root)
       throw new Error("Pass --root <path> or --run <path>.");
-    const report = validateEngine(String(opts.root), CLI_MODULE_URL, { strict: true });
+    const report = validateEngine(String(opts.root), CLI_MODULE_URL, {
+      strict: true,
+      requireKnowledge: opts.requireKnowledge === true
+    });
     print({ ...report, action: "validated" }, commandWantsJson(command));
     if (!report.valid)
       throw new Error(report.errors[0] ?? "engine validate failed");
   });
-  jsonOption(engine.command("serve").description("Build and start the workbench on :8765").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot()).option("--no-open", "Do not open a browser")).action(async (...args) => {
+  jsonOption(engine.command("serve").description("Sync workbench runtime from CLI, rebuild, start on :8765").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot()).option("--no-open", "Do not open a browser")).action(async (...args) => {
     const command = args.at(-1);
     const opts = command.opts();
     const enginePath = resolveEngine(String(opts.engine));
-    ensureWorkbench(enginePath, CLI_MODULE_URL);
-    const built = buildWorkbench(enginePath);
-    if (!built.ok)
-      throw new Error(built.message);
     const started = await startWorkbench(enginePath, CLI_MODULE_URL, { noOpen: opts.noOpen === true });
     print({ action: "serve", engine: enginePath, ...started }, commandWantsJson(command));
     if (!started.ok)
       throw new Error("message" in started ? String(started.message) : "engine serve failed");
   });
-  jsonOption(engine.command("build").description("Rebuild workbench/index.html from markdown indexes").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot())).action((...args) => {
+  jsonOption(engine.command("build").description("Sync workbench runtime from CLI, then rebuild workbench/index.html").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot())).action((...args) => {
     const command = args.at(-1);
     const opts = command.opts();
     const enginePath = resolveEngine(String(opts.engine));
-    ensureWorkbench(enginePath, CLI_MODULE_URL);
+    const workbench = ensureWorkbench(enginePath, CLI_MODULE_URL, { update: true });
     const built = buildWorkbench(enginePath);
-    print({ action: "build", engine: enginePath, ...built }, commandWantsJson(command));
+    print({ action: "build", engine: enginePath, workbench, ...built }, commandWantsJson(command));
     if (!built.ok)
       throw new Error(built.message);
   });
@@ -33306,8 +33361,12 @@ function buildV1Cli() {
   jsonOption(slideshows.command("archive").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.archiveSlideshowRun(String(opts.id))));
   jsonOption(slideshows.command("restore").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.restoreSlideshowRun(String(opts.id))));
   jsonOption(slideshows.command("delete").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.trashSlideshowRun(String(opts.id))));
-  jsonOption(slideshows.command("render").requiredOption("--id <id>").requiredOption("--idempotency-key <key>")).action(withClient(async (client, opts) => client.renderSlideshowRun(String(opts.id), { outputFormats: ["png"], idempotencyKey: String(opts.idempotencyKey) })));
-  jsonOption(slideshows.command("export").requiredOption("--id <id>").requiredOption("--output <path>")).action(withClient(async (client, opts) => exportSlideshowRun(client, String(opts.id), String(opts.output))));
+  jsonOption(slideshows.command("render").description("Retired: PNG packs come from Studio Download").requiredOption("--id <id>").requiredOption("--idempotency-key <key>")).action(withClient(async () => {
+    throw new Error(HEADLESS_RENDER_DISABLED);
+  }));
+  jsonOption(slideshows.command("export").description("Retired: PNG packs come from Studio Download").requiredOption("--id <id>").requiredOption("--output <path>")).action(withClient(async () => {
+    throw new Error(HEADLESS_RENDER_DISABLED);
+  }));
   const renders = program.command("renders").description("Inspect final render jobs");
   jsonOption(renders.command("create-asset").requiredOption("--file <path>").requiredOption("--idempotency-key <key>")).action(withClient(async (client, opts) => {
     const fileName = String(opts.file);
@@ -33322,16 +33381,15 @@ function buildV1Cli() {
       idempotencyKey: String(opts.idempotencyKey)
     });
   }));
-  jsonOption(renders.command("create").requiredOption("--template-id <id>").requiredOption("--slots <json-or-file>").option("--format <format>", "Final output format", "png").requiredOption("--idempotency-key <key>")).action(withClient(async (client, opts) => client.createRenderJob({
-    templateId: String(opts.templateId),
-    slots: renderSlots(await readJsonArgument(String(opts.slots))),
-    outputFormats: [String(opts.format)],
-    idempotencyKey: String(opts.idempotencyKey)
-  })));
+  jsonOption(renders.command("create").description("Retired: PNG packs come from Studio Download").requiredOption("--template-id <id>").requiredOption("--slots <json-or-file>").option("--format <format>", "Final output format", "png").requiredOption("--idempotency-key <key>")).action(withClient(async () => {
+    throw new Error(HEADLESS_RENDER_DISABLED);
+  }));
   jsonOption(renders.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getRenderJob(String(opts.id))));
   jsonOption(renders.command("manifest").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getRenderManifest(String(opts.id))));
   jsonOption(renders.command("wait").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.pollRenderJob(String(opts.id))));
-  jsonOption(renders.command("export").requiredOption("--id <id>").requiredOption("--output <path>")).action(withClient(async (client, opts) => exportManifest(client, String(opts.id), String(opts.output))));
+  jsonOption(renders.command("export").description("Retired: PNG packs come from Studio Download").requiredOption("--id <id>").requiredOption("--output <path>")).action(withClient(async () => {
+    throw new Error(HEADLESS_RENDER_DISABLED);
+  }));
   const mcp = program.command("mcp").description("Install and run the unified EasySociable MCP server");
   jsonOption(mcp.command("install").requiredOption("--host <host>", "codex, claude, hermes, or openclaw").option("--config-path <path>")).action((...args) => {
     const command = args.at(-1);