@easysociable/cli 0.1.9 → 0.1.10

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";
@@ -33002,6 +33003,121 @@ 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"]);
+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();
@@ -33310,6 +33426,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);