@anyday/sanity-workspace-manager 0.4.0 → 0.5.0

package/README.md

@@ -57,6 +57,22 @@ suggestion you can accept with Enter:
 The id is permanent: jobs store it and it prefixes each site's Vercel project. Registering a
 different id later creates a second project type instead of updating this one.
 
+### Which command to run
+
+| Command                            | Questions                | Starter pages                                  | Use it when                                   |
+| ---------------------------------- | ------------------------ | ---------------------------------------------- | --------------------------------------------- |
+| `init --live`                      | Yes, then a list to pick | The pages you pick (none: one empty home page) | Usually: real theme, colours and pages        |
+| `init --live --starter home,about` | Yes, no list             | Those pages                                    | You already know which pages                  |
+| `init --live --yes`                | None, suggestions taken  | One empty home page                            | Scripts, or no starter content wanted         |
+| `init`                             | Yes                      | One empty home page                            | The project has no content yet, or no sign-in |
+
+Without `--live`, `init` reads only the repo's files, so the manifest has the structure but no
+values: colour defaults are `#000000`, theme defaults and `studioOrigins` are empty. Fill them in
+by hand, or run again with `--live --force` once the project has content.
+
+Starter pages are only what **Start fresh** writes. **Copy from a workspace** is picked in the
+Workspaces app for each new workspace, and reads its source live; it needs no `init` option.
+
 ### What it reads
 
 | Source                          | Used for                                                                                             |
@@ -73,7 +89,7 @@ and each folder in `apps`.
 
 | Option               | Does                                                                                            |
 | -------------------- | ----------------------------------------------------------------------------------------------- |
-| `--yes`              | Accepts the suggested id, name and project without asking                                       |
+| `--yes`              | Asks nothing: takes every suggestion and skips the starter list                                 |
 | `--project <id>`     | The Sanity project new workspaces copy their schema from                                        |
 | `--org <id>`         | The Sanity organisation new workspaces are created in (found with `--live`)                     |
 | `--vercel-team <id>` | The client's own Vercel team for the sites; leave out for Anyday's team                         |
@@ -81,7 +97,7 @@ and each folder in `apps`.
 | `--live`             | Reads the current theme, settings and starter pages from that project                           |
 | `--dataset <name>`   | The dataset `--live` reads (default `production`)                                               |
 | `--starter <pages>`  | Starter pages without the list: `home`, slugs or document ids, comma-separated (needs `--live`) |
-| `--force`            | Replaces an existing `workspace-manager.json`                                                   |
+| `--force`            | Replaces an existing `workspace-manager.json`, keeping its file-backed theme defaults (fonts)   |
 | `--print`            | Prints the draft instead of writing it                                                          |
 
 ### Starter pages
@@ -104,7 +120,8 @@ slug, the home page's language wins. With `--yes` and no `--starter`, the starte
 home page.
 
 Starter pages get `{{siteName}}` and `{{language}}` where the source site's name and language
-were. Font files are never copied into theme defaults, since fonts are often licensed per brand.
+were. Fonts are left out of theme defaults, since uploaded fonts are often licensed per brand: add
+them by hand when they may be reused, and a later `--force` keeps them.
 
 ### Review before registering
 

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync3, writeFileSync } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync4, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { parseArgs } from "node:util";
@@ -772,6 +772,17 @@ function placeholders(value, siteName, language, key, parent) {
   }
   return value;
 }
+function keepFileDefaults(draft, existing) {
+  const defaults = draft.manifest.brand.theme.defaults;
+  const previous = existing?.brand?.theme?.defaults ?? {};
+  const kept = Object.keys(previous).filter(
+    (field) => !(field in defaults) && hasReference(previous[field])
+  );
+  for (const field of kept) defaults[field] = previous[field];
+  if (kept.length)
+    draft.notes.push(`Kept from the existing manifest's theme defaults: ${kept.join(", ")}`);
+  return kept;
+}
 var hasReference = (value) => JSON.stringify(value ?? null).includes('"_ref":');
 function references(value) {
   if (Array.isArray(value)) return value.flatMap(references);
@@ -1069,6 +1080,7 @@ async function init(argv) {
     });
     draft = draftManifest(repo, base, live);
   }
+  if (existsSync3(out)) keepFileDefaults(draft, readJson(out));
   configFrom(parseManifest(draft.manifest));
   const json = `${JSON.stringify(draft.manifest, null, 2)}
 `;
@@ -1079,6 +1091,13 @@ async function init(argv) {
 Check before registering:`);
   for (const note of draft.notes) console.error(`  - ${note}`);
 }
+function readJson(path) {
+  try {
+    return JSON.parse(readFileSync4(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
 async function ask(suggested, orgFor) {
   const prompt = createInterface({ input: process.stdin, output: process.stderr });
   const question = async (label, fallback) => (await prompt.question(`${label}${fallback ? ` (${fallback})` : ""}: `)).trim() || fallback;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anyday/sanity-workspace-manager",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Drafts a site repo's workspace-manager.json for the Anyday workspace manager",
   "repository": {
     "type": "git",