frontpage-host 0.1.11 → 0.1.12

package/AGENTS.md

@@ -101,7 +101,7 @@ Sites are Astro 6 + Tailwind v4. More detail: `frontpage help site-building` or
 2. **`src/config/site.ts`** — keep `pages` (path registry) and `nav` in sync when adding/renaming/deleting page files. Tab title comes from BaseLayout, not the `pages` map label.
 3. **One file per URL** for similar page sets (services, guides, …). Do not default to `getStaticPaths()` over `src/data/*.ts`. Blog/news → `frontpage articles`, not a hand-rolled catalog.
 4. **No backends / databases / fake forms or checkout.** Real forms use `<form data-fp-form="slug">` + `frontpage modules`. Refuse or use modules for payments.
-5. **Tokens** in `src/config/tokens.ts` — keep required color/font/spacing/radii keys; style via CSS variables / token Tailwind. Setting a font token is not enough — apply `font-sans` / `font-serif` / `font-display`. Browse fonts with `frontpage fonts`; set one token with `frontpage tokens set --group … --key … --value …` (CAS like push). Module how-tos: `frontpage modules docs <key>` / `frontpage extensions docs <key>`.
+5. **Tokens** in `src/config/tokens.ts` — keep required color/font/spacing/radii keys; style via CSS variables / token Tailwind. **Fonts load rule:** the build bundles catalog faces when the family string appears in `tokens.ts` and/or in a real CSS `font-family` / `fontFamily` / `font-['…']` context under `src/pages|components|styles` — not from prose alone. Preferred path: `frontpage fonts` → exact `value` → `frontpage tokens set --group fonts --key <role> --value "…"` → **APPLY** `font-sans` / `font-serif` / `font-mono` / `font-display` (or `var(--font-*)`) on elements. Inline catalog `font-family` accents can bundle after rebuild, but brand roles still prefer tokens + utilities. Off-catalog families silently fall back to system fonts (push may warn). Module how-tos: `frontpage modules docs <key>` / `frontpage extensions docs <key>`.
 6. **Shared chrome** — prefer `src/components/Header.astro` + `Footer.astro` (or `chrome: { managed: true }` in `site.ts`).
 7. **404** — customize `src/pages/404.astro` if needed; keep `frontpage:404` meta; never register `/404` in `nav`/`pages`.
 8. **Platform-owned paths** stay off-limits (BaseLayout overlay, module/extension shells, `package.json`, …). Customer layouts like `DocsLayout` / `GuideLayout` are OK.

package/dist/commands/push.js

@@ -115,6 +115,7 @@ export async function runPush(args) {
             commitSha: data.commitSha,
             baseCommitSha: data.baseCommitSha,
             filesChanged: data.filesChanged,
+            ...(data.warnings?.length ? { warnings: data.warnings } : {}),
         };
         if (!wait) {
             if (isJson()) {
@@ -123,12 +124,16 @@ export async function runPush(args) {
             }
             if (!data.changed) {
                 console.log("Nothing to commit (remote already matches).");
+                for (const w of data.warnings ?? [])
+                    console.error(`Warning: ${w}`);
                 return EXIT_OK;
             }
             console.log(`Pushed ${data.filesChanged.length} file(s) → ${data.commitSha}`);
             console.log("Updated .frontpage/state.json baseCommitSha");
             console.log("Note: module markup may auto-activate modules (same as the editor agent).");
             console.log("tokens.ts may be auto-repaired at commit if it would break the build.");
+            for (const w of data.warnings ?? [])
+                console.error(`Warning: ${w}`);
             return EXIT_OK;
         }
         // --wait: after push, wait for agent-run busy to clear (same statuses as deploy wait).
@@ -141,6 +146,8 @@ export async function runPush(args) {
                 console.log(`Pushed ${data.filesChanged.length} file(s) → ${data.commitSha}`);
                 console.log("Updated .frontpage/state.json baseCommitSha");
             }
+            for (const w of data.warnings ?? [])
+                console.error(`Warning: ${w}`);
             console.error("Waiting for agent run / deploy idle…");
         }
         const result = await waitForAgentIdle({

package/dist/registry.js

@@ -168,7 +168,8 @@ export const COMMANDS = [
             "frontpage fonts --query Cinzel --json",
         ],
         flags: [
-            "Use the exact `value` string in tokens.fonts.* (via frontpage tokens set or push)",
+            "Use the exact `value` string in tokens.fonts.* (via frontpage tokens set or push), then APPLY font-* utilities",
+            "Build bundles catalog faces from tokens.ts and/or CSS font-family contexts (not prose mentions)",
             "No --site required — catalog is account/platform scoped",
         ],
     },
@@ -517,8 +518,10 @@ export const TOPICS = {
 
   Tokens & fonts:
   - Keep required colors/fonts/spacing/radii keys; style via CSS variables / token Tailwind.
-  - Setting fonts.sans is not enough — apply font-sans / font-serif / font-display on elements.
-  - Browse fonts: frontpage fonts [--slot serif] [--query elegant] — use the exact value string.
+  - Load rule: catalog faces bundle when the family string is in tokens.ts and/or a real CSS font-family / fontFamily / font-['…'] context under src/pages|components|styles — not from prose alone.
+  - Preferred path: frontpage fonts → exact value → tokens set fonts.<role> → APPLY font-sans|serif|mono|display (or var(--font-*)).
+  - Inline catalog font-family accents can load after rebuild; brand roles still prefer tokens + utilities.
+  - Setting fonts.sans alone is not enough — apply the utility on elements.
   - Surgical token edit: frontpage tokens set --group fonts --key sans --value "…" (CAS like push).
 
   Chrome / SEO / 404:

package/llms.txt

@@ -5,7 +5,7 @@
 - Introspect: frontpage help | frontpage help --json | frontpage help <topic|command>
 - Topics: quickstart, auth, sync, site-building, agent, content, history, isolation, exit-codes
 - Site building: frontpage help site-building — Astro pages map, BaseLayout, tokens, no backends/fake forms
-- Fonts: frontpage fonts [--slot] [--query] — use exact value; tokens: frontpage tokens set --group --key --value (CAS)
+- Fonts: frontpage fonts [--slot] [--query] → exact value → tokens set fonts.<role> → APPLY font-sans|serif|mono|display. Build bundles catalog faces from tokens.ts and/or CSS font-family contexts (not prose). Inline-only without tokens works for catalog faces after rebuild; prefer tokens+utilities for brand roles.
 - Module/extension docs: frontpage modules docs <key> | frontpage extensions docs <key>
 - Search flags: --regex --case-sensitive --whole-word --files-only --context-lines --max-results
 - Modules setup: frontpage modules request-setup <key> --reason "…" (owner status bar; CLI cannot show it)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {