@scribe-platform/cli 0.7.0 → 0.9.0

package/dist/commands/prospect.js

@@ -0,0 +1,222 @@
+import { CALL_OUTCOMES } from '../lib/client.js';
+import { printResult, requireClient, runAction } from '../lib/cli-utils.js';
+const STATUSES = ['prospect', 'active', 'churned', 'lost'];
+function isValidStatus(status) {
+    return STATUSES.includes(status);
+}
+/** Mirrors the console's sort dropdown — see RFC 0027. */
+const SORTS = ['due', 'neglected', 'warm', 'name'];
+function isValidSort(sort) {
+    return SORTS.includes(sort);
+}
+function isValidOutcome(outcome) {
+    return CALL_OUTCOMES.includes(outcome);
+}
+/** `--next` and `--clear-next` are mutually exclusive — a reschedule is to a date or to nothing, never both. */
+function resolveFollowUpUpdate(opts) {
+    if (opts.next && opts.clearNext) {
+        return { ok: false, error: '--next and --clear-next are mutually exclusive' };
+    }
+    if (opts.clearNext)
+        return { ok: true, value: null };
+    if (opts.next)
+        return { ok: true, value: opts.next };
+    return { ok: true };
+}
+/**
+ * RFC 0027 — the nurture-loop primitive. `log` is one note plus, optionally,
+ * one reschedule of the next follow-up; `--next`/`--clear-next` are mutually
+ * exclusive because a reschedule is either to a date or to nothing, never
+ * both. No delete subcommand here or anywhere under `/api/v1/prospects` —
+ * deletion stays console-only.
+ */
+export function registerProspectCommands(program) {
+    const prospect = program.command('prospect').description('Manage prospects and clients in the calling pipeline');
+    prospect
+        .command('list')
+        .description('List prospects, optionally filtered by status or search term')
+        .option('--status <status>', 'prospect, active, churned, or lost')
+        .option('--search <text>', 'Filter by name')
+        .option('--due', 'Only prospects with a follow-up due now or overdue, soonest/most-overdue first')
+        .option('--sort <sort>', `one of: ${SORTS.join(', ')} (default: due)`)
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (opts) => {
+        if (opts.sort && !isValidSort(opts.sort)) {
+            console.error(`--sort must be one of: ${SORTS.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const items = await requireClient().listProspects(opts);
+        if (opts.json) {
+            printResult(items, true);
+            return;
+        }
+        printResult(items.map((p) => ({
+            id: p.id,
+            name: p.name,
+            status: p.status,
+            // The attempt count travels with the warmth because `cold` means
+            // something different after one try than after five.
+            warmth: p.warmth.warmth,
+            tries: p.warmth.attempts,
+            nextFollowUp: p.prospecting?.nextFollowUpAt ?? '',
+            lastContact: p.warmth.lastContactAt ?? '',
+        })), false);
+        // Below the table, not as a column: these are sentences, and a column
+        // wide enough for one would squeeze everything that tells Ashley who
+        // to call. RFC 0029 — context for the call, not a change to the list.
+        const withProofs = items.filter((p) => p.proofNote);
+        if (withProofs.length > 0) {
+            console.log('');
+            for (const p of withProofs)
+                console.log(`${p.name} — ${p.proofNote}`);
+        }
+    }));
+    prospect
+        .command('show')
+        .description('Show one prospect, including its full call log')
+        .argument('<id>')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, opts) => {
+        const p = await requireClient().getProspect(id);
+        if (opts.json) {
+            printResult(p, true);
+            return;
+        }
+        console.log(`${p.name} (${p.status})`);
+        if (p.primaryContact) {
+            const contact = [p.primaryContact.name, p.primaryContact.email, p.primaryContact.phone].filter(Boolean).join(' / ');
+            if (contact)
+                console.log(`Contact: ${contact}`);
+        }
+        console.log(`Warmth: ${p.warmth.warmth} (${p.warmth.attempts} ${p.warmth.attempts === 1 ? 'attempt' : 'attempts'})`);
+        console.log(`Next follow-up: ${p.prospecting?.nextFollowUpAt ?? 'Not scheduled'}`);
+        console.log('Notes:');
+        if (p.notes.length === 0)
+            console.log('  (none yet)');
+        for (const note of [...p.notes].reverse()) {
+            console.log(`  [${note.createdAt}]${note.outcome ? ` (${note.outcome})` : ''} ${note.body}`);
+        }
+    }));
+    prospect
+        .command('pipeline')
+        .description('The funnel\'s shape — counts by warmth, and how many prospects are still workable')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (opts) => {
+        const summary = await requireClient().prospectPipeline();
+        if (opts.json) {
+            printResult(summary, true);
+            return;
+        }
+        console.log(`${summary.workable} workable of ${summary.total} prospects`);
+        for (const warmth of ['hot', 'warm', 'untouched', 'cold', 'stalled']) {
+            const count = summary.counts[warmth];
+            if (count > 0)
+                console.log(`  ${warmth.padEnd(10)} ${count}`);
+        }
+        // The actionable read, rather than leaving it to be inferred from the
+        // numbers: stalled is the only bucket that is genuinely spent.
+        if (summary.workable === 0 && summary.total > 0) {
+            console.log('\nEvery prospect has stalled — time to find more leads.');
+        }
+    }));
+    prospect
+        .command('create')
+        .description('Create a new prospect')
+        .argument('<name>')
+        .option('--status <status>', 'prospect, active, churned, or lost', 'prospect')
+        .option('--contact-name <name>')
+        .option('--email <email>')
+        .option('--phone <phone>')
+        .option('--note <text>', 'A seed note — e.g. how/where this prospect was found')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (name, opts) => {
+        if (!isValidStatus(opts.status)) {
+            console.error(`--status must be one of: ${STATUSES.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const hasContact = opts.contactName || opts.email || opts.phone;
+        const result = await requireClient().createProspect({
+            name,
+            status: opts.status,
+            primaryContact: hasContact
+                ? { name: opts.contactName ?? null, email: opts.email ?? null, phone: opts.phone ?? null }
+                : null,
+            note: opts.note,
+        });
+        printResult(result, opts.json);
+    }));
+    prospect
+        .command('update')
+        .description("Update a prospect's name or contact info")
+        .argument('<id>')
+        .option('--name <name>')
+        .option('--contact-name <name>')
+        .option('--email <email>')
+        .option('--phone <phone>')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, opts) => {
+        const hasContact = opts.contactName !== undefined || opts.email !== undefined || opts.phone !== undefined;
+        if (opts.name === undefined && !hasContact) {
+            console.error('Provide at least one field to update');
+            process.exitCode = 1;
+            return;
+        }
+        const result = await requireClient().updateProspect(id, {
+            name: opts.name,
+            primaryContact: hasContact
+                ? { name: opts.contactName ?? null, email: opts.email ?? null, phone: opts.phone ?? null }
+                : undefined,
+        });
+        printResult(result, opts.json);
+    }));
+    prospect
+        .command('log')
+        .description('Log a call — a note, and optionally a next follow-up date, together')
+        .argument('<id>')
+        .requiredOption('--note <text>', 'What happened')
+        .option('--outcome <outcome>', `how far it got — one of: ${CALL_OUTCOMES.join(', ')}`)
+        .option('--next <date>', 'ISO date (or anything Date can parse) for the next follow-up')
+        .option('--clear-next', 'Clear any scheduled follow-up')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, opts) => {
+        const followUp = resolveFollowUpUpdate(opts);
+        if (!followUp.ok) {
+            console.error(followUp.error);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.outcome !== undefined && !isValidOutcome(opts.outcome)) {
+            console.error(`--outcome must be one of: ${CALL_OUTCOMES.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const result = await requireClient().logProspectCall(id, {
+            note: opts.note,
+            nextFollowUpAt: followUp.value,
+            // Omitted means "not a contact attempt", which is what keeps a
+            // research note out of the attempt tally that decides stalling.
+            outcome: opts.outcome ?? null,
+        });
+        printResult(result, opts.json);
+    }));
+    prospect
+        .command('status')
+        .description('Move a prospect through prospect → active/lost (or a client through active ↔ churned)')
+        .argument('<id>')
+        .argument('<status>', 'prospect, active, churned, or lost')
+        .option('--reason <reason>', 'Carried with a lost or churned move')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, status, opts) => {
+        if (!isValidStatus(status)) {
+            console.error(`status must be one of: ${STATUSES.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const result = await requireClient().setProspectStatus(id, { status, reason: opts.reason });
+        printResult(result, opts.json);
+    }));
+}
+export { isValidOutcome, isValidSort, isValidStatus, resolveFollowUpUpdate };
+//# sourceMappingURL=prospect.js.map

package/dist/commands/prospect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prospect.js","sourceRoot":"","sources":["../../src/commands/prospect.ts"],"names":[],"mappings":"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"}

package/dist/commands/request.d.ts

@@ -0,0 +1,38 @@
+import { Command } from 'commander';
+declare function isValidRequestStatus(status: string): boolean;
+declare function isValidRequestType(type: string): boolean;
+/**
+ * Every status name is phrased from the **Client's** side, because that is who
+ * reads it on their own dashboard — so the one status an agency user is most
+ * likely to misread is `waiting-on-you`, which means waiting on *them*, not on
+ * you. Printed alongside the raw name rather than instead of it: the raw name
+ * is what goes back into `request status`.
+ */
+declare const STAFF_LABELS: Record<string, string>;
+type Assignment = {
+    ok: true;
+    value: 'any' | 'unassigned' | 'mine';
+} | {
+    ok: false;
+    error: string;
+};
+/** `--mine` and `--unassigned` ask opposite questions, so passing both is a mistake rather than a narrowing. */
+declare function resolveAssignment(opts: {
+    mine?: boolean;
+    unassigned?: boolean;
+}): Assignment;
+/**
+ * RFC 0005 — the Request queue, as the CLI sees it.
+ *
+ * A Request is a Client asking the Agency for work, so unlike every other
+ * command group here nothing about it lives in a Site's repo. The whole surface
+ * is staff-only for that reason: a thread carries internal notes, and claiming
+ * one only means something from inside the Agency.
+ *
+ * There is deliberately no `create` — a Request comes from the Client, through
+ * their own dashboard. Filing one on their behalf would put words in their mouth
+ * and make the queue's own numbers a measure of us rather than of them.
+ */
+export declare function registerRequestCommands(program: Command): void;
+export { isValidRequestStatus, isValidRequestType, resolveAssignment, STAFF_LABELS };
+//# sourceMappingURL=request.d.ts.map

package/dist/commands/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/commands/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,iBAAS,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;;GAMG;AACH,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMxC,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,gHAAgH;AAChH,iBAAS,iBAAiB,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAOrF;AA+BD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwK9D;AAED,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}

package/dist/commands/request.js

@@ -0,0 +1,214 @@
+import { REQUEST_STATUSES, REQUEST_TYPES } from '../lib/client.js';
+import { printResult, requireClient, runAction } from '../lib/cli-utils.js';
+function isValidRequestStatus(status) {
+    return REQUEST_STATUSES.includes(status);
+}
+function isValidRequestType(type) {
+    return REQUEST_TYPES.includes(type);
+}
+/**
+ * Every status name is phrased from the **Client's** side, because that is who
+ * reads it on their own dashboard — so the one status an agency user is most
+ * likely to misread is `waiting-on-you`, which means waiting on *them*, not on
+ * you. Printed alongside the raw name rather than instead of it: the raw name
+ * is what goes back into `request status`.
+ */
+const STAFF_LABELS = {
+    open: 'Open — nobody has picked it up',
+    'in-progress': 'In progress',
+    'waiting-on-you': 'Waiting on client',
+    done: 'Done',
+    cancelled: 'Cancelled',
+};
+/** `--mine` and `--unassigned` ask opposite questions, so passing both is a mistake rather than a narrowing. */
+function resolveAssignment(opts) {
+    if (opts.mine && opts.unassigned) {
+        return { ok: false, error: '--mine and --unassigned are mutually exclusive' };
+    }
+    if (opts.mine)
+        return { ok: true, value: 'mine' };
+    if (opts.unassigned)
+        return { ok: true, value: 'unassigned' };
+    return { ok: true, value: 'any' };
+}
+function authorOf(thread, message) {
+    if (!message.authorUserId)
+        return 'Scribe';
+    return thread.actors[message.authorUserId]?.name ?? 'Someone';
+}
+function printThread(thread) {
+    const { request } = thread;
+    console.log(`${request.subject}`);
+    console.log(`Site: ${thread.site ?? request.siteId}   Type: ${request.type}`);
+    console.log(`Status: ${request.status} (${STAFF_LABELS[request.status] ?? request.status})`);
+    console.log(`Assigned: ${request.assignedToUserId ? (thread.actors[request.assignedToUserId]?.name ?? 'someone') : 'nobody'}`);
+    if (request.page)
+        console.log(`Page: ${request.page}`);
+    console.log(`Opened: ${request.createdAt}   Last activity: ${request.lastActivityAt}`);
+    console.log('');
+    console.log(request.body);
+    console.log('');
+    console.log('Thread:');
+    if (thread.messages.length === 0) {
+        console.log('  (nothing yet — the request body above is the whole of it)');
+        return;
+    }
+    for (const message of thread.messages) {
+        // The internal marker is first, not a suffix: it decides whether the line
+        // can be quoted back to the Client at all.
+        const tags = [message.internal ? 'INTERNAL' : null, message.kind === 'system' ? 'system' : null].filter(Boolean).join(' ');
+        console.log(`  [${message.createdAt}] ${tags ? `(${tags}) ` : ''}${authorOf(thread, message)}: ${message.body}`);
+    }
+}
+/**
+ * RFC 0005 — the Request queue, as the CLI sees it.
+ *
+ * A Request is a Client asking the Agency for work, so unlike every other
+ * command group here nothing about it lives in a Site's repo. The whole surface
+ * is staff-only for that reason: a thread carries internal notes, and claiming
+ * one only means something from inside the Agency.
+ *
+ * There is deliberately no `create` — a Request comes from the Client, through
+ * their own dashboard. Filing one on their behalf would put words in their mouth
+ * and make the queue's own numbers a measure of us rather than of them.
+ */
+export function registerRequestCommands(program) {
+    const request = program.command('request').description('Work the queue of requests clients have sent in');
+    request
+        .command('list')
+        .description('List requests, oldest activity first — the queue, worked from the end that has waited longest')
+        .option('--site <slug>', 'Only this site\'s requests')
+        .option('--status <status>', `one of: ${REQUEST_STATUSES.join(', ')}`)
+        .option('--type <type>', `one of: ${REQUEST_TYPES.join(', ')}`)
+        .option('--mine', 'Only requests this key\'s owner has claimed')
+        .option('--unassigned', 'Only requests nobody has claimed yet')
+        .option('--all', 'Include finished requests (done, cancelled), which are hidden by default')
+        .option('--sort <sort>', 'oldest (default) or newest, by last activity')
+        .option('--page <n>', 'Page number, 1-based')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (opts) => {
+        if (opts.status && !isValidRequestStatus(opts.status)) {
+            console.error(`--status must be one of: ${REQUEST_STATUSES.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.type && !isValidRequestType(opts.type)) {
+            console.error(`--type must be one of: ${REQUEST_TYPES.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.sort && opts.sort !== 'newest' && opts.sort !== 'oldest') {
+            console.error('--sort must be newest or oldest');
+            process.exitCode = 1;
+            return;
+        }
+        const assignment = resolveAssignment(opts);
+        if (!assignment.ok) {
+            console.error(assignment.error);
+            process.exitCode = 1;
+            return;
+        }
+        const result = await requireClient().listRequests({
+            site: opts.site,
+            status: opts.status,
+            type: opts.type,
+            assignment: assignment.value,
+            includeClosed: opts.all,
+            sort: opts.sort,
+            page: opts.page ? Number(opts.page) : undefined,
+        });
+        if (opts.json) {
+            printResult(result, true);
+            return;
+        }
+        // An empty queue is the most common answer there is, and
+        // `console.table([])` renders it as an empty frame that reads like a
+        // broken command rather than good news.
+        if (result.items.length === 0) {
+            console.log(opts.all || opts.status ? 'No requests match.' : 'Nothing in the queue.');
+            return;
+        }
+        printResult(result.items.map((item) => ({
+            id: item.id,
+            site: item.site ?? '',
+            subject: item.subject,
+            type: item.type,
+            status: item.status,
+            claimed: item.assignedToUserId ? 'yes' : 'no',
+            lastActivity: item.lastActivityAt,
+        })), false);
+        // The total is the only way to know there is a page 2, and a queue
+        // that silently showed its first 25 of 60 is the way one stops being
+        // believed.
+        if (result.total > result.items.length) {
+            console.log(`\nShowing ${result.items.length} of ${result.total} — pass --page 2 for more.`);
+        }
+    }));
+    request
+        .command('show')
+        .description('Show one request: the ask, its status, and the whole thread including internal notes')
+        .argument('<id>')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, opts) => {
+        const thread = await requireClient().getRequest(id);
+        if (opts.json) {
+            printResult(thread, true);
+            return;
+        }
+        printThread(thread);
+    }));
+    request
+        .command('claim')
+        .description("Claim a request for this key's owner, or release it with --release")
+        .argument('<id>')
+        .option('--release', 'Hand it back to nobody instead of claiming it')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, opts) => {
+        const thread = await requireClient().updateRequest(id, { assignTo: opts.release ? null : 'me' });
+        if (opts.json) {
+            printResult(thread, true);
+            return;
+        }
+        console.log(opts.release ? `Released: ${thread.request.subject}` : `Claimed: ${thread.request.subject}`);
+    }));
+    request
+        .command('reply')
+        .description('Reply to the client on a request, or add an Agency-only note with --internal')
+        .argument('<id>')
+        .requiredOption('--message <text>', 'What to say')
+        .option('--internal', 'An internal note: never shown to the client, and emails nobody')
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, opts) => {
+        const thread = await requireClient().replyToRequest(id, { body: opts.message, internal: opts.internal });
+        if (opts.json) {
+            printResult(thread, true);
+            return;
+        }
+        console.log(opts.internal ? 'Note added (internal — the client will not see it).' : 'Replied — the client has been emailed.');
+        // A visible reply on an `open` request also picks it up, which is a
+        // status change the caller didn't ask for and should hear about.
+        if (thread.movedTo)
+            console.log(`Status is now: ${thread.movedTo}`);
+    }));
+    request
+        .command('status')
+        .description('Move a request to another status')
+        .argument('<id>')
+        .argument('<status>', REQUEST_STATUSES.join(', '))
+        .option('--json', 'Output as JSON')
+        .action(runAction(async (id, status, opts) => {
+        if (!isValidRequestStatus(status)) {
+            console.error(`status must be one of: ${REQUEST_STATUSES.join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const thread = await requireClient().updateRequest(id, { status });
+        if (opts.json) {
+            printResult(thread, true);
+            return;
+        }
+        console.log(`${thread.request.subject} is now ${thread.request.status} (${STAFF_LABELS[thread.request.status] ?? ''}).`);
+    }));
+}
+export { isValidRequestStatus, isValidRequestType, resolveAssignment, STAFF_LABELS };
+//# sourceMappingURL=request.js.map

package/dist/commands/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/commands/request.ts"],"names":[],"mappings":"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"}

package/dist/commands/site.d.ts

@@ -1,3 +1,14 @@
 import { Command } from 'commander';
+/**
+ * True when changing a Site's stored domain to `next` would be a **cutover**
+ * rather than a correction — i.e. the Site is still on its provisional
+ * `<owner>.github.io` Pages host and is being moved to a real hostname.
+ *
+ * `site update --domain` only rewrites the Mongo record and the Turnstile
+ * widget. It does not touch DNS, `public/CNAME`, or the repo's Pages settings,
+ * so using it for a cutover leaves the Site claiming a domain that serves
+ * nothing — the half-state `site promote` exists to prevent.
+ */
+export declare function isDomainCutover(current: string, next: string, githubOwner: string): boolean;
 export declare function registerSiteCommands(program: Command): void;
 //# sourceMappingURL=site.d.ts.map

package/dist/commands/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/commands/site.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0V3D"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/commands/site.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CpC;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAG3F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwX3D"}

package/dist/commands/site.js

@@ -35,6 +35,20 @@ function printDnsRecords(records, write = console.error) {
     }
     write('In Cloudflare the record must be DNS-only (grey cloud), not proxied.\n');
 }
+/**
+ * True when changing a Site's stored domain to `next` would be a **cutover**
+ * rather than a correction — i.e. the Site is still on its provisional
+ * `<owner>.github.io` Pages host and is being moved to a real hostname.
+ *
+ * `site update --domain` only rewrites the Mongo record and the Turnstile
+ * widget. It does not touch DNS, `public/CNAME`, or the repo's Pages settings,
+ * so using it for a cutover leaves the Site claiming a domain that serves
+ * nothing — the half-state `site promote` exists to prevent.
+ */
+export function isDomainCutover(current, next, githubOwner) {
+    const pagesHost = `${githubOwner}.github.io`.toLowerCase();
+    return current.toLowerCase() === pagesHost && next.toLowerCase() !== pagesHost;
+}
 export function registerSiteCommands(program) {
     const site = program.command('site').description('Manage sites');
     site
@@ -51,7 +65,7 @@ export function registerSiteCommands(program) {
         .command('add')
         .description('Provision a new site: create its GitHub repo, push a starter template, and register it')
         .requiredOption('--slug <slug>', 'Site slug (also used as the repo name)')
-        .option('--domain <domain>', 'Site domain (defaults to the GitHub Pages host — set the real one later with `scribe site update --domain`)')
+        .option('--domain <domain>', 'Site domain (defaults to the GitHub Pages host — take the site live on the real one later with `scribe site promote`)')
         .option('--turnstile-key <key>', 'Cloudflare Turnstile site key (defaults to the server-configured shared widget)')
         .option('--name <name>', 'Display name (defaults to the slug)')
         .option('--form-collection <name>', 'Name for the default form/inbox collection (defaults to "inquiries")')
@@ -71,10 +85,11 @@ export function registerSiteCommands(program) {
     }));
     site
         .command('update')
-        .description("Update a site's settings: its domain and/or Turnstile site key")
+        .description("Correct a site's stored settings: its domain and/or Turnstile site key")
         .argument('<slug>', 'Site slug')
         .option('--turnstile-key <key>', 'Cloudflare Turnstile site key')
-        .option('--domain <domain>', "The site's public hostname, e.g. example.com — also synced to the Turnstile widget")
+        .option('--domain <domain>', "Correct the site's stored hostname (record + Turnstile only). To take a site live on a new domain use `scribe site promote`")
+        .option('--record-only', 'Allow --domain to move a site off its github.io host without doing the cutover')
         .action(runAction(async (slug, opts) => {
         if (!opts.turnstileKey && !opts.domain) {
             console.error('Nothing to update — pass --turnstile-key and/or --domain.');
@@ -82,6 +97,29 @@ export function registerSiteCommands(program) {
             return;
         }
         const client = requireClient();
+        // A cutover reached through `update` is the classic half-move: the
+        // record names a domain that DNS, Pages and `public/CNAME` know
+        // nothing about, so the site 404s on the new host while still
+        // reporting healthy. Refuse rather than warn — a warning on stderr is
+        // exactly what gets scrolled past.
+        if (opts.domain && !opts.recordOnly) {
+            const existing = await client
+                .listSites()
+                .then((sites) => sites.find((s) => s.slug === slug))
+                // A lookup failure shouldn't block a legitimate correction.
+                .catch(() => undefined);
+            if (existing && isDomainCutover(existing.domain, opts.domain, existing.githubOwner)) {
+                console.error(`"${slug}" is still on ${existing.domain}, so this is a cutover, not a correction.`);
+                console.error('`site update --domain` changes only the stored record and the Turnstile widget —');
+                console.error('it does not touch DNS, public/CNAME, or the repo\'s GitHub Pages settings, so the');
+                console.error('site would 404 on the new domain. Use promote instead, which does all of it:\n');
+                console.error(`  scribe site promote ${slug} --domain ${opts.domain} --dns-only   # check DNS, change nothing`);
+                console.error(`  scribe site promote ${slug} --domain ${opts.domain}              # cut over\n`);
+                console.error('Pass --record-only if you really do just want to rewrite the stored value.');
+                process.exitCode = 1;
+                throw new CliExit();
+            }
+        }
         const result = await client.updateSite(slug, {
             turnstileSiteKey: opts.turnstileKey,
             domain: opts.domain,