quiver-cli 1.3.1 → 2.0.0

package/template/.agents/skills/design/impeccable/scripts/live/vocabulary.mjs

@@ -1,171 +0,0 @@
-/**
- * Canonical design-command vocabulary for Live Mode: each command's value, human
- * label, and SVG icon. Icons stack above the chip label; strokes use currentColor
- * so the icon recolors when its chip is selected.
- *
- * Single source of truth, consumed by:
- *   - skill/scripts/live/event-validation.mjs — re-exports VISUAL_ACTIONS.
- *   - skill/scripts/live-browser.js — the real picker. It is served raw and
- *     injected as an IIFE, so it cannot import this at runtime; live-server.mjs
- *     serializes LIVE_COMMANDS into window.__IMPECCABLE_VOCAB__ alongside the
- *     token/port, and live-browser.js builds its ICONS + ACTIONS from that.
- *   - site/components/LiveDemoPalette.astro — the marketing demo palette (imported
- *     at build time).
- *
- * Add, rename, or reorder a verb here and all three follow.
- */
-
-const ICON_ATTRS = 'width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" style="display:block"';
-
-export const LIVE_COMMANDS = [
-  { value: 'impeccable', label: 'Freeform',  icon: `<svg ${ICON_ATTRS}><path d="M4 20l4-1L18 9l-3-3L5 16z"/><path d="M14 7l3 3"/></svg>` },
-  { value: 'bolder',     label: 'Bolder',    icon: `<svg ${ICON_ATTRS}><rect x="6" y="12" width="4" height="7" rx="0.5"/><rect x="14" y="5" width="4" height="14" rx="0.5"/></svg>` },
-  { value: 'quieter',    label: 'Quieter',   icon: `<svg ${ICON_ATTRS}><rect x="6" y="5" width="4" height="14" rx="0.5"/><rect x="14" y="12" width="4" height="7" rx="0.5"/></svg>` },
-  { value: 'distill',    label: 'Distill',   icon: `<svg ${ICON_ATTRS}><path d="M4 5h16l-6 8v7l-4-2v-5z"/></svg>` },
-  { value: 'polish',     label: 'Polish',    icon: `<svg ${ICON_ATTRS}><path d="M15 3l1 3 3 1-3 1-1 3-1-3-3-1 3-1z"/><path d="M7 13l0.6 1.8 1.8 0.6-1.8 0.6-0.6 1.8-0.6-1.8-1.8-0.6 1.8-0.6z"/></svg>` },
-  { value: 'typeset',    label: 'Typeset',   icon: `<svg ${ICON_ATTRS}><path d="M5 6h14" stroke-width="2.6"/><path d="M5 12h9" stroke-width="1.9"/><path d="M5 18h5" stroke-width="1.3"/></svg>` },
-  { value: 'colorize',   label: 'Colorize',  icon: `<svg ${ICON_ATTRS}><circle cx="9" cy="10" r="5"/><circle cx="15" cy="10" r="5"/><circle cx="12" cy="15" r="5"/></svg>` },
-  { value: 'layout',     label: 'Layout',    icon: `<svg ${ICON_ATTRS}><rect x="3" y="4" width="8" height="16" rx="0.5"/><rect x="13" y="4" width="8" height="7" rx="0.5"/><rect x="13" y="13" width="8" height="7" rx="0.5"/></svg>` },
-  { value: 'adapt',      label: 'Adapt',     icon: `<svg ${ICON_ATTRS}><rect x="2.5" y="5" width="12" height="11" rx="1"/><line x1="2.5" y1="19" x2="14.5" y2="19"/><rect x="16.5" y="8" width="5" height="11" rx="1"/></svg>` },
-  { value: 'animate',    label: 'Animate',   icon: `<svg ${ICON_ATTRS}><path d="M3 18c4-4 6-10 10-10"/><path d="M13 8c3 0 5 5 8 10"/><circle cx="13" cy="8" r="1.6" fill="currentColor" stroke="none"/></svg>` },
-  { value: 'delight',    label: 'Delight',   icon: `<svg ${ICON_ATTRS}><path d="M12 3l2 6 6 2-6 2-2 6-2-6-6-2 6-2z"/></svg>` },
-  { value: 'overdrive',  label: 'Overdrive', icon: `<svg ${ICON_ATTRS}><path d="M13 3L5 13h5l-1 8 9-12h-6z"/></svg>` },
-];
-
-// Action values accepted by the live event protocol, in palette order.
-export const VISUAL_ACTIONS = LIVE_COMMANDS.map((c) => c.value);
-
-/*
- * ---------------------------------------------------------------------------
- * Protocol vocabulary
- * ---------------------------------------------------------------------------
- * The enums below are the wire contract between the browser overlay, the live
- * helper server, and the durable session journal. They live here rather than in
- * the modules that use them so a value cannot be added to the validator without
- * the store and the server seeing it too.
- *
- * live-browser.js still cannot import this file (it is served raw and injected
- * as an IIFE), so its local phase table repeats the agent-phase names. Anything
- * the server can broadcast must appear in AGENT_PHASES here first.
- */
-
-/**
- * Phases the live server broadcasts as `agent_phase`, in lifecycle order.
- * Every one of these is emitted by `recordAgentPhase()` in live-server.mjs;
- * the validator rejects anything else, so a typo in a phase name fails loudly
- * instead of quietly ranking as an unknown phase in the browser's progress bar.
- */
-export const AGENT_PHASES = Object.freeze([
-  'picked_up',
-  'scaffolding',
-  'source_ready',
-  'scaffold_fallback',
-  'generation_ready',
-  'first_reviewable',
-  'second_reviewable',
-  'all_variants_ready',
-]);
-
-/** Event types the helper server accepts from the browser over POST /events. */
-export const CLIENT_EVENT_TYPES = Object.freeze([
-  'generate',
-  'accept',
-  'discard',
-  'checkpoint',
-  'agent_phase',
-  'variant_mounted',
-  'variant_mount_failed',
-  'exit',
-  'prefetch',
-  'manual_edits',
-  'steer',
-  'carbonize_cleanup',
-]);
-
-/**
- * Event types the durable journal applies. A superset of CLIENT_EVENT_TYPES:
- * the agent-side helpers (live-poll, live-complete) and the server itself
- * append the rest. An event type missing here lands as `unknown_event_type`
- * in the snapshot diagnostics.
- */
-export const JOURNAL_EVENT_TYPES = Object.freeze([
-  'generate',
-  'variant_plan',
-  'detector_waivers',
-  'agent_phase',
-  'variants_ready',
-  'agent_done',
-  'variant_mounted',
-  'variant_mount_failed',
-  'checkpoint',
-  'accept',
-  'accept_intent',
-  'manual_edit_apply',
-  'steer',
-  'steer_done',
-  'carbonize_cleanup',
-  'discard',
-  'discarded',
-  'complete',
-  'agent_error',
-]);
-
-/** Phases the session store assigns to a snapshot. */
-export const SESSION_PHASES = Object.freeze([
-  'new',
-  'generate_requested',
-  'variants_ready',
-  'carbonize_required',
-  'carbonize_cleanup_requested',
-  'manual_edit_apply_requested',
-  'steer_requested',
-  'steer_done',
-  'accept_requested',
-  'discard_requested',
-  'discarded',
-  'completed',
-  'agent_error',
-]);
-
-/** Phases that retire a session from the active list. */
-export const COMPLETED_SESSION_PHASES = Object.freeze(['completed', 'discarded']);
-
-/**
- * Phases after which a late generation write is a ghost from a canceled cycle.
- * The store journals such an event as a diagnostic instead of applying it.
- */
-export const GENERATION_FENCED_SESSION_PHASES = Object.freeze([
-  'accept_requested',
-  'discard_requested',
-  'carbonize_required',
-  'completed',
-  'discarded',
-]);
-
-/**
- * `reason` values carried on checkpoint events. Not validated (an unknown
- * reason is journaled, never rejected) because the reason is diagnostic
- * breadcrumb, not control flow. Two exceptions drive behavior and are split
- * out below.
- */
-export const CHECKPOINT_REASONS = Object.freeze([
-  'generate_started',
-  'variants_progress',
-  'variants_ready',
-  'browser_resumed',
-  'browser_resumed_svelte_component',
-  'param_changed',
-  'variant_anchor_missing',
-  'component_preview_anchor_missing',
-  'steer_input_focused',
-  'steer_submitted',
-  'steer_send_failed',
-  'steer_done',
-  'steer_error',
-]);
-
-/** Checkpoint reasons the server reads as variant-publication progress. */
-export const VARIANT_PROGRESS_CHECKPOINT_REASONS = Object.freeze([
-  'variants_progress',
-  'variants_ready',
-]);