ferst-core 0.2.2 → 0.2.3

package/bin/set-cms-branch.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// ferst-set-cms-branch — stamp the Sveltia CMS backend branch to match THIS
+// deployment's branch, so config.yml never drifts from the platform git-proxy's
+// branch policy (dev deploy → dev, main → main). Run it AFTER `astro build`:
+//
+//   "build": "astro build && ferst-set-cms-branch"
+//
+// It rewrites the built CMS config's `branch:` from CF_PAGES_BRANCH (Cloudflare
+// Pages), falling back to the current git branch, then `main`. The COMMITTED
+// config.yml stays a neutral placeholder, identical on every branch — no
+// per-branch config, no merge hazard.
+//
+// Why it matters: Sveltia READS content from `branch`, and the git-proxy rejects
+// writes whose branch != the project's branch policy. A wrong value = the CMS
+// shows no content and any save 403s. This makes that impossible to ship
+// silently — it fails the build loudly if it can't stamp.
+//
+// Config path: `dist/admin/config.yml` under the current working directory
+// (the client repo root at build time). Override with a first CLI arg.
+import { readFileSync, writeFileSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
+
+const CONFIG = resolve(process.cwd(), process.argv[2] ?? 'dist/admin/config.yml');
+
+function deploymentBranch() {
+  const cf = process.env.CF_PAGES_BRANCH?.trim();
+  if (cf) return cf;
+  try {
+    const git = execSync('git rev-parse --abbrev-ref HEAD', {
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).toString().trim();
+    if (git && git !== 'HEAD') return git;
+  } catch {
+    /* not a git checkout — fall through */
+  }
+  return 'main';
+}
+
+const branch = deploymentBranch();
+
+let yml;
+try {
+  yml = readFileSync(CONFIG, 'utf8');
+} catch {
+  console.error(`ferst-set-cms-branch: ${CONFIG} not found — run this AFTER astro build.`);
+  process.exit(1);
+}
+
+// Check the `branch:` line EXISTS separately from whether it changed — stamping
+// the same value (e.g. main→main on the prod placeholder) is a valid no-op.
+const BRANCH_LINE = /^(\s*branch:\s*)\S.*$/m;
+if (!BRANCH_LINE.test(yml)) {
+  console.error('ferst-set-cms-branch: no "branch:" line found in the CMS config backend.');
+  process.exit(1);
+}
+writeFileSync(CONFIG, yml.replace(BRANCH_LINE, `$1${branch}`));
+console.log(`ferst-set-cms-branch: CMS backend branch → "${branch}"`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ferst-core",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "description": "Ferst Core — the shared, brand-agnostic client-site system: Astro components, layouts, content schemas, the layered config resolver, and a neutral styling architecture that every client overrides.",
   "license": "BUSL-1.1",
@@ -44,7 +44,8 @@
     "LICENSE-Apache-2.0"
   ],
   "bin": {
-    "ferst-check-thin": "bin/check-thin.mjs"
+    "ferst-check-thin": "bin/check-thin.mjs",
+    "ferst-set-cms-branch": "bin/set-cms-branch.mjs"
   },
   "dependencies": {
     "zod": "^3.25.0"