frontpage-host 0.1.0 → 0.1.2

package/dist/registry.js

@@ -3,43 +3,317 @@
  * Only shipped Phase 0–5 commands appear here.
  */
 export const COMMANDS = [
-    { name: "help", summary: "Show available commands", usage: "frontpage help [command|topic]", topics: ["auth", "sync", "agent", "content", "history", "exit-codes"] },
-    { name: "login", summary: "Save an API key to the OS keychain", usage: "frontpage login [api-key]", topics: ["auth"] },
-    { name: "logout", summary: "Remove the saved API key", usage: "frontpage logout", topics: ["auth"] },
-    { name: "whoami", summary: "Show the identity for the current API key", usage: "frontpage whoami", topics: ["auth"] },
-    { name: "sites", summary: "List sites your key can access", usage: "frontpage sites", topics: ["auth"] },
-    { name: "use", summary: "Set the default site subdomain for this folder", usage: "frontpage use <subdomain>", topics: ["auth", "sync"] },
-    { name: "link", summary: "Alias for use", usage: "frontpage link <subdomain>", topics: ["auth", "sync"] },
-    { name: "doctor", summary: "Check CLI auth and API connectivity", usage: "frontpage doctor", topics: ["auth"] },
-    { name: "pull", summary: "Download allowlisted site files into this folder", usage: "frontpage pull [--site <slug>]", topics: ["sync"] },
-    { name: "push", summary: "Upload local allowlisted files (CAS + active-run guard)", usage: "frontpage push [--site <slug>] [--message …]", topics: ["sync"] },
-    { name: "diff", summary: "Compare local allowlisted files to the remote tip", usage: "frontpage diff [--site <slug>]", topics: ["sync"] },
-    { name: "ls", summary: "List remote allowlisted files", usage: "frontpage ls [prefix] [--site <slug>]", topics: ["sync"] },
-    { name: "cat", summary: "Print a remote file", usage: "frontpage cat <path> [--site <slug>]", topics: ["sync"] },
-    { name: "search", summary: "Search remote text files", usage: "frontpage search <pattern> [path] [--site <slug>]", topics: ["sync"] },
-    { name: "status", summary: "Show linked site and tip vs last pull", usage: "frontpage status [--site <slug>]", topics: ["sync"] },
-    { name: "open", summary: "Open the site in a browser", usage: "frontpage open [--site <slug>]", topics: ["sync"] },
-    { name: "prompt", summary: "Enqueue an agent build", usage: 'frontpage prompt "..." [--site <slug>] [--path /]', topics: ["agent"] },
-    { name: "runs", summary: "List, wait, cancel, or retry agent runs", usage: "frontpage runs [current|wait|cancel|retry|get] …", topics: ["agent"] },
-    { name: "publish", summary: "Promote staging to production", usage: "frontpage publish [--site <slug>]", topics: ["agent"] },
-    { name: "unpublish", summary: "Take the live site offline (admin)", usage: "frontpage unpublish [--site <slug>]", topics: ["agent"] },
-    { name: "deploy", summary: "Wait for active agent deploy to finish", usage: "frontpage deploy wait [--site <slug>]", topics: ["agent"] },
-    { name: "usage", summary: "Show plan and AI/bandwidth usage", usage: "frontpage usage [--site <slug>]", topics: ["agent"] },
-    { name: "analytics", summary: "Show analytics dashboard JSON", usage: "frontpage analytics [--days 7] [--site <slug>]", topics: ["agent"] },
-    { name: "pages", summary: "List site pages", usage: "frontpage pages [--site <slug>]", topics: ["agent"] },
-    { name: "modules", summary: "List or mutate modules (secret masks only)", usage: "frontpage modules [list|enable|disable|config] …", topics: ["agent", "content"] },
-    { name: "extensions", summary: "List or mutate extensions (no secret values)", usage: "frontpage extensions [list|enable|disable|config] …", topics: ["agent", "content"] },
-    { name: "media", summary: "List or upload site media assets", usage: "frontpage media list|upload <file>", topics: ["content"] },
-    { name: "inbox", summary: "List leads / subscribers / orders", usage: "frontpage inbox [leads|…] [--mark-read] [--csv]", topics: ["content"] },
-    { name: "seo", summary: "Get or set page SEO", usage: "frontpage seo get|set --path / …", topics: ["content"] },
-    { name: "articles", summary: "Articles hub, content, and section ops", usage: "frontpage articles list|content|create-article|…", topics: ["content"] },
-    { name: "settings", summary: "Get or set site settings (admin)", usage: "frontpage settings get|set …", topics: ["content"] },
-    { name: "edit", summary: "Click-edit style exact text replace + deploy", usage: 'frontpage edit --path / --old "…" --new "…"', topics: ["content"] },
-    { name: "history", summary: "List recent commits on the site branch", usage: "frontpage history [--limit N] [--page N]", topics: ["history", "agent"] },
-    { name: "revert", summary: "Restore site to a prior commit (tree restore + deploy)", usage: "frontpage revert <40-char-sha>", topics: ["history"] },
-    { name: "completion", summary: "Print shell completion script", usage: "frontpage completion bash|zsh|fish", topics: ["auth"] },
+    {
+        name: "help",
+        summary: "Show available commands",
+        usage: "frontpage help [command|topic] [--json]",
+        topics: ["auth", "sync", "agent", "content", "history", "isolation", "exit-codes", "quickstart"],
+        examples: ["frontpage help", "frontpage help sync", "frontpage help push", "frontpage help --json"],
+    },
+    {
+        name: "login",
+        summary: "Save an API key to the OS keychain",
+        usage: "frontpage login [api-key]",
+        topics: ["auth"],
+        examples: ['frontpage login', 'frontpage login "$FRONTPAGE_API_KEY"'],
+        flags: ["FRONTPAGE_API_KEY env overrides keychain after login for that process"],
+        seeAlso: ["whoami", "doctor", "logout"],
+    },
+    {
+        name: "logout",
+        summary: "Remove the saved API key",
+        usage: "frontpage logout",
+        topics: ["auth"],
+    },
+    {
+        name: "whoami",
+        summary: "Show the identity for the current API key",
+        usage: "frontpage whoami [--json]",
+        topics: ["auth"],
+    },
+    {
+        name: "sites",
+        summary: "List sites your key can access",
+        usage: "frontpage sites [--json]",
+        topics: ["auth"],
+        examples: ["frontpage sites", "frontpage sites --json"],
+        seeAlso: ["use"],
+    },
+    {
+        name: "use",
+        summary: "Set the default site subdomain for this folder",
+        usage: "frontpage use <subdomain>",
+        topics: ["auth", "sync"],
+        examples: ["frontpage use arbiter"],
+        dangers: ["Clears baseCommitSha when switching sites — run pull again before push"],
+        seeAlso: ["link", "pull", "status"],
+    },
+    {
+        name: "link",
+        summary: "Alias for use",
+        usage: "frontpage link <subdomain>",
+        topics: ["auth", "sync"],
+    },
+    {
+        name: "doctor",
+        summary: "Check CLI auth and API connectivity",
+        usage: "frontpage doctor [--json]",
+        topics: ["auth"],
+    },
+    {
+        name: "pull",
+        summary: "Download allowlisted site files into this folder",
+        usage: "frontpage pull [--site <slug>] [--json]",
+        topics: ["sync"],
+        examples: ["frontpage pull", "frontpage pull --site arbiter --json"],
+        flags: ["--site <slug>"],
+        seeAlso: ["push", "status", "diff"],
+    },
+    {
+        name: "push",
+        summary: "Upload local allowlisted files (CAS + active-run guard)",
+        usage: "frontpage push [--site <slug>] [--message …] [--json]",
+        topics: ["sync"],
+        examples: ['frontpage push --message "Update hero copy"'],
+        flags: ["--site <slug>", "--message <text>"],
+        dangers: [
+            "Requires prior pull (baseCommitSha)",
+            "Refused while an agent run is active (exit 3)",
+            "CAS fail if remote tip moved (exit 3) — pull and retry",
+            "May auto-activate modules when markup references them",
+        ],
+        seeAlso: ["pull", "diff", "status", "deploy"],
+    },
+    {
+        name: "diff",
+        summary: "Compare local allowlisted files to the remote tip",
+        usage: "frontpage diff [--site <slug>] [--json]",
+        topics: ["sync"],
+        examples: ["frontpage diff --json"],
+        flags: ["--site <slug>", "JSON data.dirty is true when differences exist"],
+    },
+    {
+        name: "ls",
+        summary: "List remote allowlisted files",
+        usage: "frontpage ls [prefix] [--site <slug>] [--json]",
+        topics: ["sync"],
+    },
+    {
+        name: "cat",
+        summary: "Print a remote file",
+        usage: "frontpage cat <path> [--site <slug>]",
+        topics: ["sync"],
+    },
+    {
+        name: "search",
+        summary: "Search remote text files",
+        usage: "frontpage search <pattern> [path] [--site <slug>]",
+        topics: ["sync"],
+    },
+    {
+        name: "status",
+        summary: "Show linked site and tip vs last pull",
+        usage: "frontpage status [--site <slug>] [--json]",
+        topics: ["sync"],
+    },
+    {
+        name: "open",
+        summary: "Open the site subdomain in a browser",
+        usage: "frontpage open [--site <slug>] [--prod]",
+        topics: ["sync"],
+        flags: ["--prod is a no-op stub today — always opens https://<slug>.frontpage.host/"],
+    },
+    {
+        name: "prompt",
+        summary: "Enqueue an agent build",
+        usage: 'frontpage prompt "..." [--site <slug>] [--path /] [--json]',
+        topics: ["agent"],
+        examples: ['frontpage prompt "make the hero shorter"'],
+        flags: ["--path must start with /", "stdout is bare runId (or JSON with --json)"],
+        seeAlso: ["runs", "deploy"],
+    },
+    {
+        name: "runs",
+        summary: "List, wait, cancel, or retry agent runs",
+        usage: "frontpage runs [list|current|wait|cancel|retry|get] [runId] [--site <slug>] [--json]",
+        topics: ["agent"],
+        examples: [
+            "frontpage runs",
+            "frontpage runs wait",
+            "frontpage runs wait <runId>",
+            "frontpage runs cancel <runId>",
+            "frontpage runs retry <runId>",
+            "frontpage runs get <runId>",
+        ],
+        flags: ["There is no runs continue — mid-task continuation is automatic"],
+        seeAlso: ["prompt", "deploy"],
+    },
+    {
+        name: "publish",
+        summary: "Promote staging to production",
+        usage: "frontpage publish [--site <slug>] [--json]",
+        topics: ["agent"],
+        dangers: [
+            "Promotes the current staging tip to PRODUCTION (custom domain)",
+            "Agents: never run unless the user explicitly asked to publish",
+        ],
+        seeAlso: ["unpublish", "deploy"],
+    },
+    {
+        name: "unpublish",
+        summary: "Take the live site offline (admin)",
+        usage: "frontpage unpublish [--site <slug>] [--yes] [--json]",
+        topics: ["agent"],
+        dangers: [
+            "Takes production offline",
+            "Requires --yes when stdin is not a TTY",
+            "Agents: never run unless the user explicitly asked",
+        ],
+    },
+    {
+        name: "deploy",
+        summary: "Wait for an in-flight build to finish (not publish)",
+        usage: "frontpage deploy wait [--site <slug>] [--json]",
+        topics: ["agent"],
+        flags: [
+            "Optional build wait only — staging is https://<subdomain>.frontpage.host",
+            "Does NOT promote to production; use publish only when the user asks",
+        ],
+    },
+    {
+        name: "usage",
+        summary: "Show plan and AI/bandwidth usage",
+        usage: "frontpage usage [--site <slug>]",
+        topics: ["agent"],
+    },
+    {
+        name: "analytics",
+        summary: "Show analytics dashboard JSON",
+        usage: "frontpage analytics [--days 7] [--site <slug>]",
+        topics: ["agent"],
+    },
+    {
+        name: "pages",
+        summary: "List site pages",
+        usage: "frontpage pages [--site <slug>] [--json]",
+        topics: ["agent"],
+    },
+    {
+        name: "modules",
+        summary: "List or mutate modules (secret masks only)",
+        usage: "frontpage modules [list|enable|disable|archive|config] <key> [--instance <id>] [--config '{…}'] [--site <slug>]",
+        topics: ["agent", "content"],
+        dangers: ["Secret values are never returned — masks only"],
+    },
+    {
+        name: "extensions",
+        summary: "List or mutate extensions (no secret values)",
+        usage: "frontpage extensions [list|enable|disable|config] <key> [--config '{…}'] [--site <slug>]",
+        topics: ["agent", "content"],
+    },
+    {
+        name: "media",
+        summary: "List or upload site media assets",
+        usage: "frontpage media list|upload <file> [--site <slug>]",
+        topics: ["content"],
+    },
+    {
+        name: "inbox",
+        summary: "List leads / subscribers / orders",
+        usage: "frontpage inbox [leads|subscribers|orders|…] [--mark-read] [--csv] [--site <slug>]",
+        topics: ["content"],
+        dangers: ["--mark-read is side-effecting with no confirm"],
+    },
+    {
+        name: "seo",
+        summary: "Get or set page SEO",
+        usage: "frontpage seo get|set --path / [--title …] [--description …] [--site <slug>]",
+        topics: ["content"],
+    },
+    {
+        name: "articles",
+        summary: "Articles hub, content, and section ops",
+        usage: "frontpage articles list|content|create-section|config-section|archive-section|restore-section|create-article|delete-article|set-draft|set-image|set-tags|set-seo|set-meta … [--site <slug>]",
+        topics: ["content"],
+        examples: [
+            "frontpage articles list",
+            "frontpage articles content get --section blog --article my-post",
+            "frontpage articles content set --section blog --article my-post --body '…' --base <sha>",
+        ],
+    },
+    {
+        name: "settings",
+        summary: "Get or set site settings (admin)",
+        usage: "frontpage settings get|set [--subdomain-public true|false] [--usage-alerts true|false] [--build-model …] [--brand-name …] [--brand-logo …] [--brand-reset] [--site <slug>]",
+        topics: ["content"],
+    },
+    {
+        name: "edit",
+        summary: "Click-edit style exact text replace + deploy",
+        usage: 'frontpage edit --path / --old "…" --new "…" [--site <slug>]',
+        topics: ["content"],
+        dangers: [
+            "Exact single-occurrence replace (fails if 0 or 2+ matches)",
+            "Deploys via click-edit path — not the same as push / gated-write",
+        ],
+    },
+    {
+        name: "history",
+        summary: "List recent commits on the site branch",
+        usage: "frontpage history [--limit N] [--page N] [--site <slug>] [--json]",
+        topics: ["history", "agent"],
+        flags: ["S = staging tip, P = production tip"],
+    },
+    {
+        name: "revert",
+        summary: "Restore site to a prior commit (tree restore + deploy)",
+        usage: "frontpage revert <40-char-sha> [--site <slug>] [--yes] [--json]",
+        topics: ["history"],
+        dangers: [
+            "Creates a NEW commit whose tree matches the target",
+            "Requires full 40-char SHA",
+            "Requires --yes when stdin is not a TTY",
+            "Refused while an agent run is active",
+        ],
+        seeAlso: ["history"],
+    },
+    {
+        name: "completion",
+        summary: "Print shell completion script",
+        usage: "frontpage completion bash|zsh|fish",
+        topics: ["auth"],
+    },
+];
+export const TOPIC_NAMES = [
+    "quickstart",
+    "auth",
+    "sync",
+    "agent",
+    "content",
+    "history",
+    "isolation",
+    "exit-codes",
 ];
 export const TOPICS = {
+    quickstart: `Quickstart
+  npm i -g frontpage-host          # package name ≠ binary name
+  # Binary is: frontpage
+  # Do NOT install the unrelated npm package named "frontpage"
+
+  1. Create a key: Frontpage editor → profile → Developers (fp_live_…)
+  2. frontpage login               # or: frontpage login "$FRONTPAGE_API_KEY"
+  3. frontpage sites               # use the subdomain column
+  4. mkdir work && cd work && frontpage use <subdomain>
+  5. frontpage pull
+  6. Edit files under src/, public/, or content/
+  7. frontpage push --message "…"
+  8. Review https://<subdomain>.frontpage.host  (staging)
+  9. frontpage publish             # ONLY if the user asked — promotes to production
+
+  Staging is the subdomain. There is no separate staging-deploy step for agents.
+  Never publish/unpublish unless the user explicitly asks.
+  Agents: read AGENTS.md in the npm package; use --json for structured I/O.
+  More: frontpage help auth | sync | agent | content | history | isolation | exit-codes`,
     auth: `Authentication
   1. Create a key in the Frontpage editor: profile menu → Developers
   2. frontpage login
@@ -47,33 +321,41 @@ export const TOPICS = {
   4. frontpage use <subdomain>   (e.g. asimov-press, not a custom domain)
 
   Keys act as you on every site you can access. Treat them like passwords.
-  Override with FRONTPAGE_API_KEY in CI.`,
+  Override with FRONTPAGE_API_KEY in CI.
+  FRONTPAGE_API_BASE defaults to https://app.frontpage.host
+  PUBLIC_CLI_ENABLED is server-side — the CLI cannot enable it.`,
     sync: `File sync
   frontpage use <subdomain>
   frontpage pull                 # downloads src/, public/, content/ into cwd
-  frontpage diff                 # local vs remote tip
+  frontpage diff                 # local vs remote tip (--json → data.dirty)
   frontpage push [--message …]   # uploads allowlisted files; CAS + active-run guard
   frontpage ls [prefix]
   frontpage cat <path>
   frontpage search <pattern>
   frontpage status
-  frontpage open
+  frontpage open                 # opens https://<slug>.frontpage.host/ (--prod is a no-op stub)
 
   Local state: .frontpage/state.json { slug, baseCommitSha }
   Pull first so push can compare-and-swap on baseCommitSha.
   Do not push while the editor agent is building (status / runs show active work).
   Pushing module markup may auto-activate modules (same as the agent).
   tokens.ts may be auto-repaired at commit if it would break the build.
-  Binaries use base64 (not utf8-corrupted).`,
+  Binaries use base64 (not utf8-corrupted).
+
+  Staging vs production:
+  - Push/prompt/edit update STAGING: https://<subdomain>.frontpage.host
+  - No separate "deploy to staging" step for agents — review the subdomain after the build.
+  - frontpage deploy wait only waits for an in-flight build; it is NOT go-live.
+  - frontpage publish promotes staging → production (custom domain). Never publish unless asked.`,
     agent: `Agent + publish
   frontpage prompt "make the hero shorter"
   frontpage runs                 # latest + active
   frontpage runs wait [runId]
   frontpage runs cancel <runId>
   frontpage runs retry <runId>
-  frontpage deploy wait
-  frontpage publish
-  frontpage unpublish            # admin only
+  frontpage deploy wait          # optional: wait for build; NOT publish
+  frontpage publish              # ONLY if the user asked — production promote
+  frontpage unpublish --yes      # admin only; never unless asked; --yes when non-TTY
   frontpage usage
   frontpage analytics [--days 7]
   frontpage pages
@@ -81,13 +363,14 @@ export const TOPICS = {
   frontpage extensions
 
   Mid-task continuation is automatic — there is no runs continue.
-  Do not push while an agent run is active.`,
+  Do not push while an agent run is active.
+  Default after work: review https://<subdomain>.frontpage.host; do not publish.`,
     content: `Content
   frontpage media list|upload <file>
-  frontpage inbox [leads|subscribers|…] [--mark-read] [--csv]
+  frontpage inbox [leads|subscribers|orders|…] [--mark-read] [--csv]
   frontpage seo get|set --path /
   frontpage articles list|content|create-section|create-article|set-draft|…
-  frontpage modules enable|disable|config <key>
+  frontpage modules enable|disable|archive|config <key>
   frontpage extensions enable|disable|config <key>
   frontpage settings get|set
   frontpage edit --path / --old "…" --new "…"
@@ -97,19 +380,34 @@ export const TOPICS = {
   Domains, billing, members, and site delete are out of v1.`,
     history: `History
   frontpage history [--limit 20] [--page 1]
-  frontpage revert <40-char-sha>
+  frontpage revert <40-char-sha> --yes
 
   history lists commits on site/<slug> (plan Time Machine window).
   S = staging tip, P = production tip.
   revert creates a NEW commit whose tree matches the target (linear restore).
   Target SHA must be on this site's history (not another site in the monorepo).
-  Refused while an agent run is active. Goes through commitSiteBranch (build gate).`,
+  Refused while an agent run is active. Goes through commitSiteBranch (build gate).
+  --yes required when stdin is not a TTY.`,
+    isolation: `Isolation
+  Every site-scoped call targets subdomain → branch site/<slug> only.
+  No client-supplied branch, ref, repo, or clone URL is accepted.
+  Non-members get 404 (no site enumeration); under-privileged roles get 403.
+  Exit 4 on those 404s can mean "no access / not found", not only a bad key.
+  API keys never grant platform-admin fleet override.
+  Keys are account-wide: sharing a key shares that user's power on every site they can access.
+  Path allowlist only; GitHub tokens and remotes are never returned.
+  See also: frontpage help auth | sync`,
     "exit-codes": `Exit codes
   0  success
   2  usage / budget / rate-limit / unavailable
   3  conflict (CAS / active run / unreachable domain / cancel-while-deploying)
-  4  authentication or authorization failure
-  5  unexpected server or network error`,
+  4  authentication or authorization failure (also many 404s — no access / not found)
+  5  unexpected server or network error (including API disabled / PUBLIC_CLI_ENABLED)
+
+  Global --json envelope:
+    { "ok": true, "command": "…", "data": {…} }
+    { "ok": false, "command": "…", "error": { "message", "code?", "httpStatus?", "exitCode" } }
+  Failures with --json still use the process exit code; envelope is on stdout.`,
 };
 export function findCommand(name) {
     return COMMANDS.find((c) => c.name === name);

package/dist/runtime.d.ts

@@ -0,0 +1,22 @@
+export declare function setRuntimeFlags(flags: {
+    json?: boolean;
+    quiet?: boolean;
+    yes?: boolean;
+}): void;
+export declare function isJson(): boolean;
+export declare function isQuiet(): boolean;
+/** True when --yes was passed, or stdin is a TTY (interactive confirm not required). */
+export declare function allowDestructive(): boolean;
+export declare function requireYesOrTty(action: string): string | null;
+export type JsonErrorBody = {
+    message: string;
+    code?: string;
+    httpStatus?: number;
+    exitCode: number;
+};
+export declare function emitOk(command: string, data: unknown): void;
+export declare function emitErr(command: string, err: unknown): number;
+export declare function emitUsage(command: string, message: string, exitCode?: number): number;
+/** Progress / spinner lines — suppressed when --quiet or --json. */
+export declare function progress(text: string): void;
+export declare function unexpectedExit(): number;

package/dist/runtime.js

@@ -0,0 +1,73 @@
+/**
+ * Process-global CLI runtime flags (set once from argv in bin.ts).
+ */
+import { CliHttpError, EXIT_UNEXPECTED, exitCodeForError } from "./http/client.js";
+let jsonMode = false;
+let quietMode = false;
+let yesMode = false;
+export function setRuntimeFlags(flags) {
+    if (flags.json !== undefined)
+        jsonMode = flags.json;
+    if (flags.quiet !== undefined)
+        quietMode = flags.quiet;
+    if (flags.yes !== undefined)
+        yesMode = flags.yes;
+}
+export function isJson() {
+    return jsonMode;
+}
+export function isQuiet() {
+    return quietMode;
+}
+/** True when --yes was passed, or stdin is a TTY (interactive confirm not required). */
+export function allowDestructive() {
+    return yesMode || Boolean(process.stdin.isTTY);
+}
+export function requireYesOrTty(action) {
+    if (allowDestructive())
+        return null;
+    return `Refusing ${action} without --yes (non-interactive). Re-run with --yes if intentional.`;
+}
+export function emitOk(command, data) {
+    console.log(JSON.stringify({ ok: true, command, data }));
+}
+export function emitErr(command, err) {
+    const exitCode = exitCodeForError(err);
+    const message = err instanceof Error ? err.message : String(err);
+    const body = { message, exitCode };
+    if (err instanceof CliHttpError) {
+        if (err.code)
+            body.code = err.code;
+        if (err.status)
+            body.httpStatus = err.status;
+    }
+    if (jsonMode) {
+        console.log(JSON.stringify({ ok: false, command, error: body }));
+    }
+    else {
+        console.error(message);
+    }
+    return exitCode;
+}
+export function emitUsage(command, message, exitCode = 2) {
+    if (jsonMode) {
+        console.log(JSON.stringify({
+            ok: false,
+            command,
+            error: { message, exitCode },
+        }));
+    }
+    else {
+        console.error(message);
+    }
+    return exitCode;
+}
+/** Progress / spinner lines — suppressed when --quiet or --json. */
+export function progress(text) {
+    if (quietMode || jsonMode)
+        return;
+    process.stderr.write(text);
+}
+export function unexpectedExit() {
+    return EXIT_UNEXPECTED;
+}

package/llms.txt

@@ -0,0 +1,14 @@
+# Frontpage CLI (frontpage-host)
+
+- Package: frontpage-host (npm). Binary: frontpage. Do NOT install npm package "frontpage".
+- Docs in this package: README.md, AGENTS.md (agent operating manual).
+- Introspect: frontpage help | frontpage help --json | frontpage help <topic|command>
+- Topics: quickstart, auth, sync, agent, content, history, isolation, exit-codes
+- Auth: mint fp_live_ key in Frontpage UI (Developers); frontpage login KEY or FRONTPAGE_API_KEY
+- Site id: subdomain only (frontpage use <subdomain>). Not custom domains.
+- Staging: https://<subdomain>.frontpage.host — push/prompt/edit update staging; no separate staging deploy step for agents
+- Production: custom domain after frontpage publish — NEVER publish/unpublish unless the user explicitly asks
+- Sync: allowlist src/ public/ content/; pull → edit → push (CAS); no push during active agent run; review on subdomain
+- Machine: global --json / --quiet; exit 0/2/3/4/5 (see help exit-codes)
+- deploy wait = optional build wait only; it is NOT go-live / publish
+- No runs continue, domains, billing, members, MCP, or git remotes in v1

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {
     "frontpage": "dist/bin.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "AGENTS.md",
+    "llms.txt"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",