@easysociable/cli 0.1.9 → 0.1.11

package/README.md

@@ -53,6 +53,7 @@ unless you pass `--sync-workbench` (pulls from the public core checkout /
 | Command | Purpose |
 |---------|---------|
 | `easysociable engine init [--root] [--yes] [--serve]` | Clone public core into `Content Engine/` (no overwrite) |
+| `easysociable engine update [--engine] [--yes]` | Sync core rules from the public template; preview first, apply with `--yes`. Never touches vault data |
 | `easysociable engine serve [--engine] [--no-open] [--sync-workbench]` | Rebuild + start on `:8765` |
 | `easysociable engine build [--engine] [--sync-workbench]` | Rebuild `workbench/index.html` |
 | `easysociable engine detect` | Find engines under search roots |

package/dist/easysociable.js

@@ -32645,7 +32645,8 @@ import {
   readdirSync,
   readFileSync as readFileSync2,
   rmSync,
-  statSync
+  statSync,
+  writeFileSync as writeFileSync2
 } from "fs";
 import net from "net";
 import { homedir as homedir2 } from "os";
@@ -32654,7 +32655,18 @@ var ENGINE_ROOT_NAME = "Content Engine";
 var WORKBENCH_PORT = 8765;
 var WORKBENCH_URL = `http://127.0.0.1:${WORKBENCH_PORT}/workbench/`;
 var CONTENT_ENGINE_REPO = "https://github.com/murphywuwu/content-engine.git";
-var WORKBENCH_FILES = ["template.html", "build.py", "serve.py", "roots.py"];
+var WORKBENCH_FILES = [
+  "template.html",
+  "build.py",
+  "serve.py",
+  "roots.py",
+  "README.md",
+  "easysociable-mark.svg",
+  "css/workbench.css",
+  "js/i18n.js",
+  "js/utils.js",
+  "js/app.js"
+];
 var REQUIRED_RELATIVE = [
   "CLAUDE.md",
   "engine.json",
@@ -32874,6 +32886,7 @@ function ensureWorkbench(engine, _moduleUrl, { update = false } = {}) {
     if (!existsSync3(from))
       throw new Error(`Missing ${name} in Content Engine core checkout`);
     const existed = existsSync3(dest);
+    mkdirSync2(dirname3(dest), { recursive: true });
     copyFileSync(from, dest);
     if (existed)
       updated.push(name);
@@ -33002,6 +33015,133 @@ async function initEngine(rootOrEngine, moduleUrl, {
     source: contentEngineRepoUrl()
   };
 }
+var CORE_REFRESH_FILES = /* @__PURE__ */ new Set(["CLAUDE.md", "LAYOUT.md", "topics/scoring.md"]);
+var CORE_ADD_ONLY_FILES = /* @__PURE__ */ new Set([
+  "media/_index.md",
+  "media/README.md",
+  "profiles/default/brand.md",
+  "wiki/_index.md",
+  "wiki/_unfiled.md",
+  "wiki/README.md",
+  "wiki/_template.md",
+  "library/README.md",
+  "library/swipe/_index.md",
+  "library/atoms/_index.md",
+  "library/claims/_index.md"
+]);
+function classifyCoreFile(rel) {
+  const parts = rel.split("/");
+  if (parts[0] === ".git")
+    return "skip";
+  if (CORE_ADD_ONLY_FILES.has(rel))
+    return "add";
+  if (CORE_REFRESH_FILES.has(rel))
+    return "refresh";
+  if (parts[0] === "workbench")
+    return "refresh";
+  if (parts[0] === "platforms" && rel.endsWith(".md"))
+    return "refresh";
+  if (basename(rel) === "_template.md" || parts.includes("_template"))
+    return "refresh";
+  return "skip";
+}
+function walkCoreFiles(core, relDir = "") {
+  const out = [];
+  const absDir = join3(core, relDir);
+  if (!isDir(absDir))
+    return out;
+  for (const name of readdirSync(absDir)) {
+    if (name === ".git" || name === ".DS_Store")
+      continue;
+    const rel = relDir ? `${relDir}/${name}` : name;
+    if (isDir(join3(core, rel)))
+      out.push(...walkCoreFiles(core, rel));
+    else
+      out.push(rel);
+  }
+  return out;
+}
+function mergeEngineJson(engine, core) {
+  const engPath = join3(engine, "engine.json");
+  const corePath = join3(core, "engine.json");
+  if (!existsSync3(engPath) || !existsSync3(corePath))
+    return [];
+  let eng;
+  let cor;
+  try {
+    eng = JSON.parse(readFileSync2(engPath, "utf8"));
+    cor = JSON.parse(readFileSync2(corePath, "utf8"));
+  } catch {
+    return [];
+  }
+  const engPaths = eng.paths ?? (eng.paths = {});
+  const corPaths = cor.paths ?? {};
+  const added = [];
+  for (const [key, value] of Object.entries(corPaths)) {
+    if (!(key in engPaths)) {
+      engPaths[key] = value;
+      added.push(`paths.${key}`);
+    }
+  }
+  if (added.length)
+    writeFileSync2(engPath, `${JSON.stringify(eng, null, 2)}
+`);
+  return added;
+}
+function updateEngine(rootOrEngine, moduleUrl, { yes = false } = {}) {
+  const engine = resolveEngine(rootOrEngine);
+  if (!isEngine(engine)) {
+    return {
+      engine,
+      action: "preview",
+      valid: false,
+      code: "NOT_AN_ENGINE",
+      errors: [`${engine} is not a Content Engine. Run engine init first, or pass --engine <path>.`]
+    };
+  }
+  const core = ensureCoreCheckout({ update: true });
+  const refresh = [];
+  const add = [];
+  for (const rel of walkCoreFiles(core)) {
+    const cls = classifyCoreFile(rel);
+    if (cls === "refresh")
+      refresh.push(rel);
+    else if (cls === "add" && !existsSync3(join3(engine, rel)))
+      add.push(rel);
+  }
+  if (!yes) {
+    return {
+      engine,
+      action: "preview",
+      source: contentEngineRepoUrl(),
+      willRefresh: refresh,
+      willAdd: add,
+      next: "Re-run with --yes to apply. Vault data (profiles, needs, runs, media files) is never touched."
+    };
+  }
+  const copy = (list) => {
+    for (const rel of list) {
+      const dest = join3(engine, rel);
+      mkdirSync2(dirname3(dest), { recursive: true });
+      copyFileSync(join3(core, rel), dest);
+    }
+    return list;
+  };
+  const refreshed = copy(refresh);
+  const added = copy(add);
+  const enginePaths = mergeEngineJson(engine, core);
+  const workbenchBuild = buildWorkbench(engine);
+  return {
+    ...validateEngine(engine, moduleUrl),
+    engine,
+    action: "applied",
+    source: contentEngineRepoUrl(),
+    refreshed,
+    added,
+    enginePaths,
+    workbenchBuild
+  };
+}
 function detectEngines() {
   const extra = (process.env.EASYSOCIABLE_ENGINE_SEARCH_ROOTS || "").split(process.platform === "win32" ? ";" : ":").map((item) => item.trim()).filter(Boolean);
   const home = homedir2();
@@ -33048,6 +33188,21 @@ function validateRun(moduleUrl, args) {
   };
 }
 
+// src/studioIdentity.ts
+var FIXTURE_WORKSPACE_IDS = /* @__PURE__ */ new Set(["workspace_local"]);
+var IDENTITY_CHAIN_HINT = "Studio login \u2192 Dashboard create API key \u2192 easysociable auth login --api-key <key> \u2192 create Run \u2192 open studioUrl as the same account. See docs/operations/studio-identity-chain.md";
+async function assertHumanStudioIdentity(client, options = {}) {
+  if (options.allowLocalFixture === true || process.env.EASYSOCIABLE_ALLOW_LOCAL_FIXTURE === "1")
+    return;
+  const envelope = await client.requestJson("GET", "/v1/commercial/me");
+  const workspaceId = envelope.data?.principal?.workspaceId ?? envelope.principal?.workspaceId ?? null;
+  if (typeof workspaceId === "string" && FIXTURE_WORKSPACE_IDS.has(workspaceId)) {
+    throw new Error(
+      `This CLI is using fixture workspace "${workspaceId}". ${IDENTITY_CHAIN_HINT}`
+    );
+  }
+}
+
 // src/v1-cli.ts
 var CLI_MODULE_URL = import.meta.url;
 function readCliVersion() {
@@ -33310,6 +33465,15 @@ function buildV1Cli() {
     if (!built.ok)
       throw new Error(built.message);
   });
+  jsonOption(engine.command("update").description("Sync core rules from the template (CLAUDE.md, workbench, platforms, templates) and add new scaffolds; never touches your vault data. Preview first; apply with --yes.").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot()).option("--yes", "Apply the update (default is a dry-run preview)")).action((...args) => {
+    const command = args.at(-1);
+    const opts = command.opts();
+    const result = updateEngine(String(opts.engine), CLI_MODULE_URL, { yes: opts.yes === true });
+    print(result, commandWantsJson(command));
+    const code = result.code;
+    if (code)
+      throw new Error(result.errors?.[0] ?? code);
+  });
   const auth = program.command("auth").description("Manage the shared EasySociable credential");
   jsonOption(auth.command("status").description("Show authentication status")).action(async (...args) => {
     const command = args.at(-1);
@@ -33367,7 +33531,10 @@ function buildV1Cli() {
     contentSlug: opts.contentSlug ? String(opts.contentSlug) : void 0,
     status: opts.status ? String(opts.status) : void 0
   })));
-  jsonOption(slideshows.command("create").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.createSlideshowRun({ pack: JSON.parse(await readFile(String(opts.file), "utf8")) })));
+  jsonOption(slideshows.command("create").requiredOption("--file <path>").option("--allow-local-fixture", "Allow workspace_local fixture keys (dev only)")).action(withClient(async (client, opts) => {
+    await assertHumanStudioIdentity(client, { allowLocalFixture: opts.allowLocalFixture === true });
+    return client.createSlideshowRun({ pack: JSON.parse(await readFile(String(opts.file), "utf8")) });
+  }));
   jsonOption(slideshows.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getSlideshowRun(String(opts.id))));
   jsonOption(slideshows.command("update").requiredOption("--id <id>").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.updateSlideshowRun(String(opts.id), JSON.parse(await readFile(String(opts.file), "utf8")))));
   jsonOption(slideshows.command("archive").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.archiveSlideshowRun(String(opts.id))));