@anyday/sanity-workspace-manager 0.1.1 → 0.2.0

package/README.md

@@ -27,8 +27,9 @@ From the root of the site repo:
 # 1. Export the Studio's schema (writes sanity.schema.json)
 cd studio && npx sanity schema extract && cd ..
 
-# 2. Draft the manifest, reading theme defaults and three starter pages from the live project
-npx @anyday/sanity-workspace-manager init --live --starter home,about,contact
+# 2. Draft the manifest from the repo and the live project; it lists the site's pages to pick
+#    starter content from
+npx @anyday/sanity-workspace-manager init --live
 
 # 3. Review workspace-manager.json, then commit it next to the schema
 
@@ -62,27 +63,45 @@ different id later creates a second project type instead of updating this one.
 | git remote and default branch   | `site.repo`, `site.branch`, the suggested id and name                                                |
 | `.env.example`, names only      | `siteEnv`, the variables each new site needs                                                         |
 | `sanity.schema.json`            | copy sections, singletons, home page, language documents, settings fields, colour and font templates |
-| the live project, with `--live` | theme defaults, colour defaults and starter pages (`--starter <ids>`)                                |
+| the live project, with `--live` | theme defaults, colour defaults and starter pages                                                    |
 
 `sanity.schema.json` is looked for in the repo root, `frontend`, `web`, `site`, `studio`, `apps`
 and each folder in `apps`.
 
 ### Options
 
-| Option             | Does                                                                        |
-| ------------------ | --------------------------------------------------------------------------- |
-| `--yes`            | Accepts the suggested id, name and project without asking                   |
-| `--project <id>`   | The Sanity project new workspaces copy their schema from                    |
-| `--org <id>`       | The Sanity organisation new workspaces are created in (found with `--live`) |
-| `--live`           | Reads the current theme, settings and starter pages from that project       |
-| `--dataset <name>` | The dataset `--live` reads (default `production`)                           |
-| `--starter <ids>`  | Comma-separated document ids to use as starter content (needs `--live`)     |
-| `--force`          | Replaces an existing `workspace-manager.json`                               |
-| `--print`          | Prints the draft instead of writing it                                      |
-
-Without `--starter`, new workspaces start from one empty 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.
+| Option              | Does                                                                                            |
+| ------------------- | ----------------------------------------------------------------------------------------------- |
+| `--yes`             | Accepts the suggested id, name and project without asking                                       |
+| `--project <id>`    | The Sanity project new workspaces copy their schema from                                        |
+| `--org <id>`        | The Sanity organisation new workspaces are created in (found with `--live`)                     |
+| `--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`                                                   |
+| `--print`           | Prints the draft instead of writing it                                                          |
+
+### Starter pages
+
+Starter pages are what a new workspace starts with when it doesn't copy another workspace. With
+`--live`, `init` lists the live site's pages in the home page's language, home first:
+
+```text
+Pages of the live site:
+  1. Home (/home)  ← home
+  2. About Olive (/about-olive)
+  3. Accessibility (/accessibility)
+Starter pages, by number (e.g. 1,3; Enter for one empty home page):
+```
+
+Pick by number, or press Enter for one empty home page. To skip the list, name the pages with
+`--starter`: `home` means whichever page the settings mark as the home page, and any other entry
+is a page's slug or document id, e.g. `--starter home,about-olive`. When translations share a
+slug, the home page's language wins. With `--yes` and no `--starter`, the starter is one empty
+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.
 
 ### Review before registering
 

package/dist/cli.mjs

@@ -642,7 +642,7 @@ function draftStarter(schema, home, live, note) {
   const page = { _id: "starter-home", _type: type };
   if ("title" in fields) page.title = "{{siteName}}";
   if ("language" in fields) page.language = "{{language}}";
-  note("Starter is one empty home page: pass --starter <ids> with --live to copy real pages");
+  note("Starter is one empty home page: run with --live to pick real pages instead");
   return { homeId: "starter-home", documents: [page] };
 }
 function draftBrand(schema, home, live, note) {
@@ -792,15 +792,27 @@ async function organizationOf(projectId, token) {
   if (!response.ok) throw new Error(`Couldn't read project ${projectId}: ${response.status}`);
   return (await response.json()).organizationId ?? "";
 }
+var liveClient = ({ projectId, dataset, token }) => createClient({
+  projectId,
+  dataset,
+  token,
+  apiVersion: "2026-08-15",
+  useCdn: false,
+  perspective: "published"
+});
+async function listPages(options) {
+  const { settings, pages } = await liveClient(options).fetch(
+    `{
+      "settings": *[_id == $settingsId][0],
+      "pages": *[_type == $type && defined(slug.current)]{_id, title, "slug": slug.current, language}
+    }`,
+    { settingsId: options.home.documentId, type: options.pageType }
+  );
+  const homeId = settings?.[options.home.field]?._ref ?? null;
+  return { pages, homeId };
+}
 async function readLive(options) {
-  const client = createClient({
-    projectId: options.projectId,
-    dataset: options.dataset,
-    token: options.token,
-    apiVersion: "2026-08-15",
-    useCdn: false,
-    perspective: "published"
-  });
+  const client = liveClient(options);
   const docs = await client.fetch("*[_id in $ids]", {
     ids: [options.settingsId, options.themeId, ...options.starterIds]
   });
@@ -861,6 +873,39 @@ function readRepo(root) {
   };
 }
 
+// src/init/starter.ts
+function resolveStarter(entries, pages, homeId) {
+  const home = pages.find((page) => page._id === homeId);
+  return entries.map((entry) => {
+    if (entry === "home") {
+      if (!homeId) throw new Error("The live settings name no home page: pass its slug instead");
+      return homeId;
+    }
+    if (pages.some((page) => page._id === entry)) return entry;
+    let matches = pages.filter((page) => page.slug === entry);
+    if (matches.length > 1 && home?.language)
+      matches = matches.filter((page) => page.language === home.language);
+    if (matches.length === 1) return matches[0]._id;
+    if (!matches.length) throw new Error(`No page with the slug or id "${entry}"`);
+    throw new Error(
+      `Several pages have the slug "${entry}": pass one of ${matches.map((page) => page._id).join(", ")}`
+    );
+  });
+}
+function pickable(pages, homeId) {
+  const home = pages.find((page) => page._id === homeId);
+  const shown = home?.language ? pages.filter((page) => page.language === home.language) : pages;
+  return [...shown].sort(
+    (a, b) => a._id === homeId ? -1 : b._id === homeId ? 1 : (a.title ?? "").localeCompare(b.title ?? "")
+  );
+}
+function parsePick(answer, count) {
+  const picked = answer.split(/[\s,]+/).filter(Boolean).map((part) => Number(part));
+  const wrong = picked.filter((n) => !Number.isInteger(n) || n < 1 || n > count);
+  if (wrong.length) throw new Error(`Pick numbers from 1 to ${count}`);
+  return [...new Set(picked)].map((n) => n - 1);
+}
+
 // src/register.ts
 import { readFileSync as readFileSync3 } from "node:fs";
 import { join as join3 } from "node:path";
@@ -896,7 +941,8 @@ Options:
   --org <id>         The Sanity organisation new workspaces are created in (found with --live)
   --live             Read the current theme, settings and starter pages from that project
   --dataset <name>   Dataset to read with --live (default: production)
-  --starter <ids>    Comma-separated document ids to use as starter content (needs --live)
+  --starter <pages>  Comma-separated pages to copy as starter content: \`home\`, slugs or
+                     document ids (needs --live; without it, --live offers a list to pick from)
   --force            Overwrite an existing workspace-manager.json
   --print            Print the draft instead of writing it
 
@@ -957,13 +1003,22 @@ async function init(argv) {
   };
   let draft = draftManifest(repo, base);
   if (token) {
+    const project = { projectId: answers.project, dataset: values.dataset, token };
+    const { pages, homeId } = await listPages({
+      ...project,
+      pageType: draft.manifest.content.starter.documents[0]._type,
+      home: draft.manifest.content.homePage
+    });
+    const starterIds = values.starter ? resolveStarter(
+      values.starter.split(",").map((entry) => entry.trim()).filter(Boolean),
+      pages,
+      homeId
+    ) : values.yes ? [] : await pickStarter(pickable(pages, homeId), homeId);
     const live = await readLive({
-      projectId: answers.project,
-      dataset: values.dataset,
-      token,
+      ...project,
       settingsId: draft.manifest.brand.settings.documentId,
       themeId: draft.manifest.brand.theme.documentId,
-      starterIds: values.starter?.split(",").map((id) => id.trim()).filter(Boolean) ?? []
+      starterIds
     });
     draft = draftManifest(repo, base, live);
   }
@@ -978,7 +1033,7 @@ Check before registering:`);
   for (const note of draft.notes) console.error(`  - ${note}`);
 }
 async function ask(suggested, orgFor) {
-  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = createInterface({ input: process.stdin, output: process.stderr });
   const question = async (label, fallback) => (await prompt.question(`${label}${fallback ? ` (${fallback})` : ""}: `)).trim() || fallback;
   try {
     const id = await question("Project type id, short and lowercase", suggested.id);
@@ -990,6 +1045,23 @@ async function ask(suggested, orgFor) {
     prompt.close();
   }
 }
+async function pickStarter(pages, homeId) {
+  if (!pages.length) return [];
+  console.error("\nPages of the live site:");
+  pages.forEach((page, index) => {
+    const label = `${page.title ?? page._id} (/${page.slug})`;
+    console.error(`  ${index + 1}. ${label}${page._id === homeId ? "  \u2190 home" : ""}`);
+  });
+  const prompt = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    const answer = await prompt.question(
+      "Starter pages, by number (e.g. 1,3; Enter for one empty home page): "
+    );
+    return parsePick(answer, pages.length).map((index) => pages[index]._id);
+  } finally {
+    prompt.close();
+  }
+}
 var commands = {
   init,
   register: registerCommand

package/package.json

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