figura-cli 0.12.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figura-cli",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Command-line client for the Figura visualization SaaS",
   "license": "MIT",
   "type": "module",

package/skills/fig/SKILL.md

@@ -74,13 +74,19 @@ greenfield.
    fetched design system. **Follow that design system verbatim; never invent brand
    values.** `figura_create_fig` returns a shareable `figura.so/f/<id>` link.
 
-3. **Shortcut — let Figura render it.** Call **`figura_generate_fig`** with a
+3. **Server render — the user's call, never yours.** Figura can also render the
+   fig server-side against the team brand: **`figura_generate_fig`** with a
    natural-language brief (same `area` / `orientation` / `mode` / `title` /
-   `publish: true`) when you'd rather not hand-build. Figura renders it server-side
-   against the team brand. This is **billed** (a `403` means no active
-   subscription); pass **`fidelity: 'high'`** to render on the better model (the
-   default `'fast'` is a lighter model — fine for rough states, weaker on brand).
-   For best fidelity, prefer the hand-built path above.
+   `publish: true`). Use it only when the **user explicitly asks** for a server
+   render ("let Figura render it", headless/CI flows with no local model) — or
+   when you've offered both paths and they picked this one. It runs as an
+   **async job the tool polls for you** — expect ~30–90s before the landed fig
+   returns; don't re-call while one is in flight. Unlike the default path, this
+   **spends the team's Figura credits** (a `403` means no active subscription).
+   Pass **`fidelity: 'high'`** to render on the better model (the default
+   `'fast'` is lighter — fine for rough states, weaker on brand). Never pick
+   this path on your own to save effort: it costs credits and hand-built figs
+   track the brand better.
 
 4. **Review** the returned link, share it, move on.
 
@@ -114,12 +120,45 @@ CSS-only radio tabs, since figs carry no `<script>`:
   width into scrollable overflow; scale minis with `transform` in
   fixed-aspect wrappers instead), and screenshot each state to check no
   annotation chip covers the content it annotates.
+  When you write the fig's HTML out to render/screenshot it, save it to a
+  **deterministic**, project-scoped path — the repo's `.figura/figs/` (already
+  gitignored), or `~/.figura/figs/` outside a bound repo — never `/tmp` or
+  `mktemp`. A stable path means a rerun overwrites the same file instead of
+  littering volatile temp locations, and matches where `figura fig open` writes
+  (`<repo>/.figura/figs/figura-fig-<id>.html`).
 
 A **wipe-slider** stays the narrow tool for exactly two states of the same
 layout with pixel-level tweaks. Never ship a squeezed side-by-side as the
 *only* view of desktop frames, and never a full-frame toggle as the only
 view of many variations — each is one half of the pair above.
 
+## Metadata & geometry — stamped for you
+
+Every landed fig is **auto-stamped server-side** (on `create` and `generate`)
+with two things you do **not** hand-write:
+
+- A **device kit** `<style>` — the target's hard geometry as CSS custom
+  properties from the one source of truth: `--fig-artboard-w/h` and
+  `--fig-safe-top/right/bottom/left`, plus `.fig-safe` / `.fig-safe-top` /
+  `.fig-safe-bottom` helpers. Only mobile figs with a fixed artboard get it.
+- A **machine-readable manifest** — `<script type="application/fig+json"
+  id="fig-manifest">` describing the artifact (target, geometry, generator,
+  intent, feature, external deps, and objective fidelity `checks`). It powers fig
+  search and the self-improving loop. Artifact-descriptive only — no team/brand
+  ids (the block is served on the public link).
+
+So when you **hand-build** a fig (the default path), do your part of the contract:
+
+- **Mobile:** size the body to the exact logical screen and emit
+  `<meta name="figura:artboard" content="WxH">` matching it (iPhone portrait
+  `393x852` / landscape `852x393`). For OS-chrome insets prefer
+  `var(--fig-safe-top, 59px)` / `.fig-safe-top` over hardcoded pixels — the stamp
+  fills the value, the fallback keeps you correct if the kit is absent.
+- **Always:** emit `<meta name="figura:context" content="...">` (design intent).
+- **Optional but valued:** if the fig grounds a specific feature or flag, emit
+  `<meta name="figura:feature" content="<flag-or-slug>">` so it links back to the
+  feature it depicts.
+
 ## Notes
 
 - **MCP unavailable** (headless / cron, or no interactive auth): fall back to the

package/skills/figura-brand/reference/brand-format.md

@@ -42,40 +42,39 @@ CONVENTIONS (hard rules found in the repo)
 - e.g. aspect ratios, chrome shape (pill/capsule), "never use <X>", dark-first, etc.
 ```
 
-## Worked example (Pano — abridged)
+## Worked example (fictional brand "Ledgerline" — abridged)
 
 ```
-PANO BRAND GROUND-TRUTH (locked):
+LEDGERLINE BRAND GROUND-TRUTH (locked):
 
-WHAT PANO IS
-- A landscape creator-cinema iOS app. Films are always landscape, 2:1, never portrait.
-- Voice, not text. Tagline: "Go wide."
+WHAT LEDGERLINE IS
+- A calm B2B invoicing web app. Dense tables, quiet confidence, desktop-first.
+- Numbers first. Tagline: "Books, balanced."
 
 COLORS (use ONLY these)
-- #DD5325 Vermillion — primary brand accent; record/active state; gradient start.
-- #2A6F84 Teal — secondary accent; pro/expert affordances; gradient end.
-- #E2E2DC Paper — foreground text + light surfaces (a cool gray; never warm cream).
-- #0A0A0A Ground — near-black base background.
+- #1F6F54 Fern — primary brand accent; primary actions; gradient start.
+- #C9A227 Brass — secondary accent; highlights + paid states; gradient end.
+- #F4F2EC Bone — light surfaces + foreground on dark (a warm off-white).
+- #101312 Ink — near-black base background.
 
 THE BRAND GRADIENT
-- EXACTLY one: linear-gradient(90deg, #DD5325, #2A6F84). Wordmark/hero accents only.
+- EXACTLY one: linear-gradient(90deg, #1F6F54, #C9A227). Wordmark/hero accents only.
 
 TYPE
-- Display: Clash Display — stack 'Clash Display', system-ui, sans-serif. Medium at display size.
+- Display: Fraunces — stack 'Fraunces', Georgia, serif. Semibold at display size.
 - Body: Inter — stack Inter, -apple-system, 'SF Pro Text', system-ui, sans-serif.
-- Mono: JetBrains Mono — hex values, timecode, numerics.
+- Mono: JetBrains Mono — amounts, invoice ids, dates.
 - Scale: 12 / 14 / 16 / 18 / 20 / 24 / 30 / 36 / 48.
 
 SPACING / RADIUS
 - 4-based scale: 4 8 12 16 20 24 32 40 48 64. Radius: sm 4, md 8, lg 12, full 999.
 
 ICON LANGUAGE
-- SF Symbols by name (mic.fill, waveform, play.fill, chevron.right). Inline stroke SVG. NEVER emoji.
+- Inline stroke SVG (receipt, arrow-right, check-circle). NEVER emoji.
 
 VOICE
-- "Vertical was a phase." "Stories went sideways." "Turn your phone." "Go sideways."
-- Terse, sideways, confident — never salesy.
+- "Every cent, accounted." "Close the month, not your eyes." Terse, dry, precise — never salesy.
 
 CONVENTIONS
-- Films always 2:1 landscape. Chrome is pill/capsule (border-radius 999). Dark-first. Never iOS "Liquid Glass".
+- Tables are the hero. Chrome is squared (radius md, never pill). Light-first with a dark ledger mode.
 ```