@utopia-studio-design/design-system-cli 0.6.2 → 0.7.0

package/data/manifests/logo-skills.json

@@ -0,0 +1,174 @@
+{
+  "version": 1,
+  "source": "Daedalus/lib/design-logo-skills",
+  "toolId": "logo-maker",
+  "qualityFramework": {
+    "methodology": "docs/design-system/logo-maker-methodology.md",
+    "universalChecks": [
+      "Distinct at 16px and 24px",
+      "Intact as a one-color mark",
+      "Equivalent on light and dark surfaces",
+      "Clear silhouette, counters, spacing, and clear space",
+      "Usable in every declared lockup and badge context",
+      "One ownable idea rather than a generic category mark",
+      "Third-party references inform analysis only and are not copied or morphed",
+      "Redrawable as clean production vector geometry"
+    ],
+    "results": ["pass", "review", "fail"],
+    "approvalPolicy": "A blocking check without artifact evidence prevents approval. Similarity review is not trademark clearance."
+  },
+  "workflow": {
+    "sequence": [
+      "read-room-context",
+      "choose-skill",
+      "collect-brief",
+      "add-optional-references",
+      "prepare-run",
+      "generate-draft",
+      "human-review",
+      "checkpoint-approved-artifact"
+    ],
+    "approvalRequired": true,
+    "referencePolicy": "Third-party marks are analysis context only and must never be copied or morphed."
+  },
+  "skills": [
+    {
+      "id": "wordmark",
+      "name": "Wordmark",
+      "tagline": "Your name, beautifully set",
+      "description": "The company name itself becomes the logo.",
+      "guidance": "Best for early-stage brands with a short, distinctive name (Google, Coca-Cola). Works when you want maximum name recognition and the venture name is the primary asset.",
+      "example": "Stripe, Google, Uber",
+      "recommended": false,
+      "referenceIds": ["google-wordmark", "coca-cola-wordmark", "ibm-wordmark"],
+      "requirements": [
+        "This is a WORDMARK logo, custom typography is the entire logo; the brand name is the hero",
+        "Extract the brand name from the description and render it with distinctive, ownable letterforms",
+        "Typography should express the brand personality: weight, spacing, and character shape must match the described tone",
+        "Avoid generic system fonts, aim for custom or heavily refined typographic treatment",
+        "Use a restrained color palette of 1-2 colors; strong contrast for legibility",
+        "The wordmark must be instantly readable and memorable at small and large sizes",
+        "No separate symbol or icon, the name alone is the mark",
+        "Present on a pure white background with clean, professional spacing",
+        "Style: flat vector typography, professional brand identity, polished wordmark quality",
+        "Output: a single polished wordmark logo centered on white"
+      ]
+    },
+    {
+      "id": "lettermark",
+      "name": "Lettermark",
+      "tagline": "Initials with impact",
+      "description": "One to three letters form a compact, iconic mark.",
+      "guidance": "Best suited for companies with multi-word names that are commonly referred to by acronym or a single initial (IBM, Notion, HBO). Also powerful for luxury and professional services brands seeking a monogram aesthetic.",
+      "example": "IBM, Notion, HBO",
+      "recommended": false,
+      "referenceIds": ["ibm", "notion", "hbo"],
+      "requirements": [
+        "This is a LETTERMARK logo, 1 to 3 initials or abbreviation letters form the entire logo",
+        "Extract the most meaningful initials or abbreviation from the brand name described",
+        "The letters should be rendered with exceptional typographic craft: custom letterforms, precise geometry, or elegant calligraphic treatment",
+        "The lettermark may use stacking, interlocking, overlapping, or monogram arrangements of the letters",
+        "Apply a bold, confident visual weight, lettermarks must be instantly legible at small sizes",
+        "Use a sophisticated color palette of 1-2 colors; consider a strong primary color with a subtle secondary accent",
+        "The composition should be balanced, optically centered, and work equally well as a square or circular badge",
+        "Optionally enclose the letters in a minimal geometric container (circle, square, shield) if it strengthens the mark",
+        "White or very light neutral background for clean presentation",
+        "Style: flat vector, professional monogram or abbreviation treatment, premium finish",
+        "Output: a single polished lettermark logo centered on white, suitable for app icons and brand use"
+      ]
+    },
+    {
+      "id": "brandmark",
+      "name": "Brand Mark",
+      "tagline": "A symbol that speaks for itself",
+      "description": "A standalone symbol with no text, recognized through shape alone.",
+      "guidance": "Best for brands that are already well-known or plan to invest heavily in brand building (Apple, Nike, Dropbox). Requires consistent exposure to build recognition.",
+      "example": "Apple, Nike, Dropbox",
+      "recommended": false,
+      "referenceIds": ["apple", "nike", "dropbox"],
+      "requirements": [
+        "This is a BRAND MARK logo, a standalone graphic symbol or icon with absolutely NO text or letters",
+        "The symbol must be a single, unified graphic shape that communicates the brand's essence, values, or industry",
+        "Design for maximum simplicity and memorability: the mark should be recognizable at 16px favicon size and billboard scale",
+        "The symbol should feel original, ownable, and not derivative of existing famous logos",
+        "Use clean, precise geometry or purposeful organic curves: avoid complexity, gradients, or photographic detail",
+        "The mark should work as a single flat color (for embossing, engraving) as well as in the chosen brand color",
+        "Preferred aesthetic: bold, confident, minimal, a shape that could become iconic with repetition",
+        "Use 1-2 colors maximum; the symbol should read clearly on both white and dark backgrounds",
+        "Center the symbol on a pure white background with generous breathing room",
+        "Style: flat vector symbol, icon-grade precision, no decorative elements, no text whatsoever",
+        "Output: a single polished brand mark symbol centered on white, no text included"
+      ]
+    },
+    {
+      "id": "combinedmark",
+      "name": "Combined Mark",
+      "tagline": "Symbol and name, unified",
+      "description": "A symbol and brand name designed as one cohesive lockup.",
+      "guidance": "The most versatile logo type for growing brands. Recommended for most startups and scale-ups.",
+      "example": "Adidas, Starbucks, Lacoste",
+      "recommended": true,
+      "referenceIds": ["adidas", "starbucks", "airbnb-wordmark"],
+      "requirements": [
+        "This is a COMBINED MARK logo, a graphic symbol/icon paired with the brand name in text, unified as one cohesive logo",
+        "The symbol and wordmark must feel designed together, not assembled from separate parts",
+        "The icon/symbol should be placed to the left of, above, or integrated with the brand name text",
+        "The symbol should be simple, distinctive, and directly relevant to the brand's identity or values",
+        "The wordmark portion should use a clean, professional typeface (custom or refined) that complements the symbol's style",
+        "Maintain clear visual hierarchy: the symbol and name should have balanced visual weight",
+        "The overall composition should be horizontal (icon left, text right) or stacked (icon above, text below)",
+        "Use a cohesive color palette of 2-3 colors maximum; the symbol may use an accent color while the wordmark uses a neutral",
+        "Present on a pure white background with clean, professional spacing",
+        "Style: flat vector, professional brand identity system, polished and versatile",
+        "Output: a single polished combined mark logo (symbol + brand name) centered on white"
+      ]
+    },
+    {
+      "id": "monoline",
+      "name": "Monoline/Illustrative",
+      "tagline": "Artisan craft in every line",
+      "description": "Consistent line work or fine illustration becomes the primary visual.",
+      "guidance": "Ideal for craft goods, wellness, fashion, or any industry where artisan quality and authenticity are core values.",
+      "example": "Craft breweries, artisan coffee, boutique fashion",
+      "recommended": false,
+      "referenceIds": ["line", "linear", "patreon"],
+      "requirements": [
+        "This is a MONOLINE / ILLUSTRATIVE logo, the design uses continuous lines of consistent weight, or detailed fine-line illustration as the primary visual element",
+        "The illustration or line-work should be intricate yet balanced: think artisan craft, precision engraving, or elegant geometric line art",
+        "The line weight must be consistent and uniform throughout the entire mark (monoline principle)",
+        "The illustration can depict an animal, object, geometric pattern, botanical element, abstract form, or scene relevant to the brand",
+        "The design should feel handcrafted and premium: suitable for artisan, craft, boutique, or heritage brands",
+        "Include the brand name in a complementary typeface integrated harmoniously with the illustration",
+        "Use a restrained color palette: ideally 1-2 colors, or a classic combination like black on white, navy on cream, or gold on dark",
+        "The overall composition should be badge-like, circular, or shield-shaped, or a refined horizontal lockup",
+        "Present on a pure white background",
+        "Style: fine-line illustration, monoline vector art, artisan/craft aesthetic, premium hand-drawn quality",
+        "Output: a single polished monoline illustrative logo centered on white"
+      ]
+    },
+    {
+      "id": "mascot",
+      "name": "Mascot",
+      "tagline": "Give your brand a face",
+      "description": "An original illustrated character becomes the face of the brand.",
+      "guidance": "Perfect for brands targeting families, youth, or communities where personality and relatability are key.",
+      "example": "KFC, Michelin, GitHub",
+      "recommended": false,
+      "referenceIds": ["kfc", "michelin", "github"],
+      "requirements": [
+        "This is a MASCOT logo, a distinctive illustrated character or persona that becomes the face and personality of the brand",
+        "The mascot should be an original, memorable character: could be a stylized human, animal, creature, robot, or abstract personified figure",
+        "The character must have a clear, expressive personality that aligns with the brand's tone (friendly, bold, playful, authoritative, quirky, etc.)",
+        "Design the mascot in a clean, modern illustration style, not overly cartoonish unless the brand calls for it",
+        "The character should have a strong, readable silhouette that works at small sizes",
+        "Include a confident, characteristic pose or expression that conveys the brand's energy",
+        "Integrate the brand name below or beside the mascot in a complementary typeface",
+        "Use a bold, vibrant color palette of 2-4 colors that gives the character life and personality",
+        "The mascot and name should be composed as a unified logo, not separate elements",
+        "Present on a pure white background with clean composition",
+        "Style: professional character illustration, flat or semi-flat design, brand mascot quality",
+        "Output: a single polished mascot logo (character + brand name) centered on white"
+      ]
+    }
+  ]
+}

package/data/manifests/motion-profiles.json

@@ -18,7 +18,7 @@
     {
       "id": "ceremonial",
       "label": "Ceremonial reveal",
-      "themes": ["utopia-default"],
+      "themes": ["utopia-default", "utopia-cloudblur"],
       "personality": "ceremonial",
       "description": "A composed, high-fidelity reveal with restrained blur and long deceleration.",
       "rules": ["Keep direct feedback fast", "Use blur only for page and large-surface reveals", "Make exits shorter than entrances"],
@@ -52,7 +52,7 @@
     {
       "id": "swift",
       "label": "Swift response",
-      "themes": ["dextrum"],
+      "themes": ["dextrum", "prism-mono", "y2k-pop"],
       "personality": "swift",
       "description": "Fast, compact movement for dense technical workflows.",
       "rules": ["No reveal blur", "No orchestration delay", "Prefer short directional shifts"],

package/data/manifests/patterns.json

@@ -2,26 +2,205 @@
   "intent": "AI-first, shadcn-founded, theme-extensible, Arabic-friendly, architectural, precise, and commercially credible.",
   "principles": [
     "Design System is the parent system; production sites are consumers.",
+    "Every interface element resolves through a registered semantic token, component, slot, state, or composition pattern.",
+    "Pages own content and orchestration only; they never own or import CSS.",
     "Use shadcn/ui as the component architecture foundation.",
     "Use semantic tokens before raw primitives.",
     "Core owns semantic contracts and component architecture, not brand-specific visual philosophy.",
     "Themes are token-contract and visual-policy implementations, not decorative skins.",
-    "Arabic-friendly support is a baseline requirement."
+    "Arabic-friendly support is a baseline requirement.",
+    "Scroll containers retain native wheel, touch and keyboard scrolling while scrollbar chrome stays hidden, including hover and focus states."
+  ],
+  "antiPatterns": [
+    "Invented tokens",
+    "Generic SaaS gradients",
+    "Rounded marketing cards",
+    "Marketing-page hierarchy on product surfaces",
+    "Glassmorphism",
+    "Raw left/right APIs",
+    "Unreviewed Arabic copy"
   ],
-  "antiPatterns": ["Invented tokens", "Generic SaaS gradients", "Rounded marketing cards", "Glassmorphism", "Raw left/right APIs", "Unreviewed Arabic copy"],
   "patterns": [
+    {
+      "id": "scroll-without-chrome",
+      "title": "Native scrolling without visible scrollbars",
+      "contract": "Hide scrollbar chrome for every axis and state. Preserve overflow scrolling, keyboard navigation, focus visibility and touch gestures. Never reveal scrollbars on hover or focus.",
+      "source": "packages/design-system/src/core.css",
+      "states": [
+        "idle",
+        "hover",
+        "focus",
+        "scrolling"
+      ]
+    },
+    {
+      "id": "semantic-page-composition",
+      "title": "Semantic page composition without page-owned CSS",
+      "contract": "Pages compose registered components and patterns, bind data, and manage routing. They never import CSS, hardcode visual primitives, or create local visual variants; missing presentation behavior must be added to the semantic contract first.",
+      "ownership": [
+        "semantic tokens",
+        "components",
+        "registered patterns",
+        "themes"
+      ],
+      "forbidden": [
+        "page CSS files",
+        "CSS imports in pages",
+        "raw brand primitives",
+        "page-local visual variants"
+      ]
+    },
+    {
+      "id": "workspace-setup",
+      "title": "Workspace setup onboarding",
+      "contract": "The onboarding flow keeps a product-scale page title, progress, current task, and actions in one semantic sequence.",
+      "source": "src/patterns/workspace-setup.css",
+      "slots": [
+        "workspace-setup",
+        "workspace-setup-header",
+        "workspace-setup-progress",
+        "workspace-setup-stage",
+        "workspace-setup-actions"
+      ],
+      "states": [
+        "room",
+        "repository",
+        "agent",
+        "review",
+        "complete"
+      ],
+      "ownership": [
+        "semantic tokens",
+        "Button",
+        "Forms",
+        "localized workflow copy"
+      ],
+      "forbidden": [
+        "marketing headline scale",
+        "page-owned CSS",
+        "raw color or radius values"
+      ]
+    },
+    {
+      "id": "brand-room-empty-start",
+      "title": "Empty Brand Room start surface",
+      "contract": "A new Brand Room presents a compact page identity, empty-state truth, first action, and setup sequence as one connected work surface. Registered Ceramic discovery media may sit beside the empty-state explanation, but it never replaces state copy or the first action. Brand and project names identify the workspace; they are not oversized campaign headlines. Arabic headings retain the same product-scale semantic roles as Latin headings; only explicitly registered display text resolves through the Arabic display scale. The shared topbar mirrors its complete brand, navigation, and action groups in RTL. The pattern must not imply that identity, theme, assets, or production work already exists.",
+      "source": "src/patterns/brand-room-empty.css",
+      "slots": [
+        "brand-workspace",
+        "brand-room-empty-state",
+        "brand-room-empty-visual"
+      ],
+      "states": [
+        "empty",
+        "current",
+        "upcoming"
+      ],
+      "ownership": [
+        "semantic tokens",
+        "Button",
+        "registered discovery media",
+        "localized workflow copy"
+      ],
+      "forbidden": [
+        "seeded brand data",
+        "page-owned CSS",
+        "detached CTA cards",
+        "oversized marketing headlines",
+        "decorative kicker or ready-state copy",
+        "image-generated text or logos",
+        "media replacing state or action",
+        "raw color or radius values"
+      ]
+    },
+    {
+      "id": "designer-agent-workbench",
+      "title": "Three-pane agent workspace template",
+      "contract": "Entering Designer Agent changes the product shell into a focused, viewport-height agent workspace while preserving a compact Ceramic topbar. Documentation navigation, account chrome, and the legal footer leave the active workspace; the topbar instead communicates Room, current stage, language, and an explicit exit without marketing-scale height, shadow, or capsule geometry. Account management remains available after exiting to the Room. A navigation rail, one primary scrollable conversation with a bottom-docked composer, and a scrollable context rail form the reusable desktop template. The managed message scroller restores the live edge on entry, follows streaming only while the user remains there, preserves reading position when older history is prepended, and reveals a localized jump-to-latest action for offscreen updates. It never drags a user away from content they intentionally scrolled back to. A submitted message immediately exposes a truthful busy state, blocks duplicate sends while its model run is queued or running, and resolves to either a durable response or an in-conversation failure with retry. Live interpretation, elapsed working time, and truthful activity stay in the conversation immediately before the response; the progress record remains visible after completion and does not disappear during the run-to-message synchronization gap. A Refine in chat action keeps the selected output visible for comparison, identifies that concept in the composer context, moves focus to the composer, and brings that composer into view so the user's next instruction can create a revised version. Journey and Artifact register use the same rail heading scale and row density. Completed and current Journey stages are keyboard-reachable view controls, while locked future stages remain disabled; revisiting an earlier stage changes only the visible working context and never rolls back approved progress. Journey and Artifact register collapse independently to the registered workspace rail width, so the user reclaims only the side they choose. Each column resize is a Framer layout transition driven by the active Ceramic layout recipe; content exit and direction-aware affordances use the same registered motion policy, and reduced-motion users receive the final layout immediately. Collapsed rails never leak clipped content. Discovery begins with one focused question and optional response starters; starters support rather than replace a user's own response. An approved discovery brief is versioned as a Markdown artifact and supplied as durable Brand Room memory to later agent turns. Logo structure guidance uses compact visual schematics rather than explanatory text cards; the selected structure and selected references combine a semantic selected surface, strong outline, and check indicator instead of relying on a subtle color shift. Optional reference search stays collapsed until requested, uses a clipping-safe internal focus treatment, and adapts result columns to the tool panel width so logos and labels remain legible. Existing-evidence upload remains a compact composer accessory across agent stages instead of becoming a leading CTA or message; accepted-file guidance stays available to assistive technology and the file picker without competing with the prompt. Search, configuration, connection, and approval inputs appear as compact, collapsible Chat Tool Panels in the conversation flow, with bounded internal overflow when expanded. Truthful activity rows in that flow summarize the latest user-meaningful state for each durable subject; raw lifecycle identifiers and superseded intermediate events stay hidden. Generated previews, visual variants, approval state, version actions, files, and other durable results update in the context/output rail only after a real run produces that result; interpretation prose and activity never move into that rail, and the rail never fabricates an idle artifact or logo before output exists. Operational connection state belongs to that same context rail. Workspace typography, row height, panel padding, content measure, composer height, and topbar chrome resolve through the shared workspace semantic token family; pages never scale these locally. Mobile starts both supporting rails collapsed with their labels visible, removes collapsed bodies from layout, and reflows an expanded Journey into two columns without a second horizontal scroll axis. Compact layouts keep the conversation primary and move supporting rails into bounded, internally scrollable regions without transferring overflow to the document.",
+      "source": "src/patterns/designer-agent-workspace.css",
+      "slots": [
+        "brand-designer-agent",
+        "designer-agent-workbench",
+        "agent-workspace-navigation",
+        "agent-workspace-conversation",
+        "agent-live-interpretation",
+        "chat-message-scroller",
+        "chat-composer",
+        "chat-composer-toolbar",
+        "agent-prompt-options",
+        "agent-source-intake",
+        "agent-logo-direction-guide",
+        "agent-reference-library",
+        "agent-workspace-context",
+        "agent-workspace-tool",
+        "agent-workspace-output",
+        "topbar-agent-context"
+      ],
+      "states": [
+        "discovery",
+        "active",
+        "working",
+        "settled",
+        "empty",
+        "complete",
+        "current",
+        "locked"
+      ],
+      "ownership": [
+        "semantic tokens",
+        "MotionProvider layout recipe",
+        "Framer Motion React adapter",
+        "WorkspaceJourney",
+        "Card",
+        "Chat Layout",
+        "Chat Message Scroller",
+        "Chat Tool Panel",
+        "Chat Composer",
+        "Attachment",
+        "Alert",
+        "Badge",
+        "Button"
+      ],
+      "forbidden": [
+        "page-owned CSS",
+        "documentation navigation inside agent mode",
+        "legal footer inside the active workspace",
+        "decorative kicker or prototype badge",
+        "oversized marketing headline",
+        "detached connection callout",
+        "tool forms appended below the workbench",
+        "generated results inside the input flow",
+        "speculative idle artifact previews",
+        "raw audit event identifiers",
+        "duplicated activity labels",
+        "invented or optimistic activity claims without a durable server event",
+        "document-owned workbench scrolling",
+        "composer separated from the conversation",
+        "duplicated stage and artifact lists",
+        "three detached dashboard cards",
+        "raw color or radius values"
+      ]
+    },
     {
       "id": "composite-keyboard-navigation",
       "title": "Keyboard navigation in composite widgets",
       "contract": "Keep one tab stop, move roving focus with logical arrows, support Home/End and documented Page movement, and preserve the active key when data changes.",
-      "requiredAlternatives": ["pointer", "keyboard", "touch"],
+      "requiredAlternatives": [
+        "pointer",
+        "keyboard",
+        "touch"
+      ],
       "rtl": "Inline ArrowLeft and ArrowRight movement follows reading direction; block movement does not flip."
     },
     {
       "id": "inclusive-drag-and-drop",
       "title": "Drag and drop with keyboard and touch alternatives",
       "contract": "Every drag action has Move earlier/Move later controls, announces the result, and restores focus to the moved item.",
-      "requiredAlternatives": ["pointer drag", "keyboard move", "touch move controls"],
+      "requiredAlternatives": [
+        "pointer drag",
+        "keyboard move",
+        "touch move controls"
+      ],
       "reducedMotion": "Commit the final order without animated displacement."
     },
     {
@@ -38,7 +217,13 @@
       "id": "chart-period-comparison",
       "title": "Period comparison and benchmark analysis",
       "contract": "Keep current, previous, target, forecast, and benchmark series semantically distinct in labels, line patterns, tokens, and the data table; never rely on hue alone.",
-      "states": ["loading", "empty", "error", "partial", "ready"],
+      "states": [
+        "loading",
+        "empty",
+        "error",
+        "partial",
+        "ready"
+      ],
       "rtl": "Chronological start follows reading direction while period labels and numbers preserve their locale."
     },
     {
@@ -110,14 +295,23 @@
       "id": "todo-completion-and-recovery",
       "title": "Complete and recover a task",
       "contract": "Task completion remains keyboard and pointer operable, announces aggregate progress, keeps product data controlled, and does not make Layout JSON own task records.",
-      "states": ["loading", "empty", "error", "ready"],
+      "states": [
+        "loading",
+        "empty",
+        "error",
+        "ready"
+      ],
       "rtl": "Checkbox, task label, metadata, and destructive action follow logical reading order."
     },
     {
       "id": "agent-dashboard-composition",
       "title": "Agent and human dashboard composition",
       "contract": "Agents and human arrange controls write the same versioned Layout JSON, validate before commit, preserve locked blocks and regions, and render only registered semantic props.",
-      "requiredAlternatives": ["agent mutation", "keyboard controls", "touch controls"],
+      "requiredAlternatives": [
+        "agent mutation",
+        "keyboard controls",
+        "touch controls"
+      ],
       "rtl": "Placement uses logical reading order while registered column and span values remain deterministic."
     }
   ]

package/data/manifests/presentation-assets.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://utopia-studio.co/schemas/ceramic-presentation-assets.schema.json",
+  "title": "Ceramic presentation asset library",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "assets"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "schemaVersion": { "const": "1.0.0" },
+    "assets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "src", "alt", "usage", "themes", "placements", "aspectRatios", "license", "credit"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "kind": { "enum": ["logo", "wordmark", "photography", "illustration", "texture", "diagram", "icon"] },
+          "src": { "type": "string", "pattern": "^(?!https?://)(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+\\.(?:avif|gif|jpe?g|png|svg|webp)$" },
+          "alt": { "type": "string", "minLength": 1 },
+          "usage": { "type": "string", "minLength": 1 },
+          "themes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+          "locales": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 }, "default": ["*"] },
+          "placements": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "enum": ["cover", "section-divider", "image-led", "case-study", "quote", "closing", "background"] }
+          },
+          "aspectRatios": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["16:9", "4:3", "3:2", "1:1", "portrait", "free"] } },
+          "focalPoint": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y"],
+            "properties": { "x": { "type": "number", "minimum": 0, "maximum": 1 }, "y": { "type": "number", "minimum": 0, "maximum": 1 } }
+          },
+          "license": { "type": "string", "minLength": 1 },
+          "credit": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/data/manifests/templates.json

@@ -42,7 +42,7 @@
       "entryPath": "templates/saas-solution-homepage/index.html",
       "manifestPath": "templates/saas-solution-homepage/template.manifest.json",
       "bundlePath": "templates/saas-solution-homepage",
-      "pageCount": 10,
+      "pageCount": 13,
       "pages": [
         "Home",
         "Product",
@@ -52,8 +52,11 @@
         "Customers",
         "Customer Story",
         "Pricing",
+        "Team",
         "Changelog",
         "Contact Sales"
+        ,"Terms of Use"
+        ,"Privacy Policy"
       ],
       "useWhen": [
         "A SaaS product needs a complete product-led marketing narrative",
@@ -68,6 +71,23 @@
         "kind": "saas-solution-homepage",
         "density": "balanced"
       },
+      "executionContract": {
+        "defaultMode": "adapt",
+        "alwaysLocked": ["semanticRoles", "accessibility", "componentAllowlist"],
+        "modes": {
+          "exact": { "locked": ["sectionOrder", "componentTree", "layoutGrid", "spacingScale", "typeScale", "responsiveRules"], "editable": ["content", "media", "approvedData"] },
+          "adapt": { "locked": ["sectionOrder", "componentTree", "layoutGrid", "responsiveRules"], "editable": ["content", "media", "semanticTheme", "approvedVariants", "approvedData"] },
+          "explore": { "locked": [], "editable": ["content", "media", "semanticTheme", "approvedVariants", "sectionOrder", "optionalSections"] }
+        },
+        "componentAllowlist": ["TopNav", "TopNavItem", "Button", "Badge", "Card", "CardContent", "CardDescription", "CardHeader", "CardTitle", "Select", "SelectContent", "SelectItem", "SelectTrigger", "SelectValue", "Textarea", "TextInput", "MotionProvider"],
+        "tokenPolicy": { "mapping": "semantic-role-only", "forbidRawBrandPrimitives": true },
+        "contentPolicy": {
+          "sectionOrder": ["Hero", "Product interface preview", "Core workflow", "Agents and automation", "Integrations", "Security and reliability", "Team proof", "Adoption CTA", "Footer"],
+          "headlineMaxLines": 3,
+          "ctaCount": { "min": 1, "max": 2 }
+        },
+        "validation": { "allowUnknownComponents": false, "allowAdHocColors": false, "allowAdHocSpacing": false, "requireResponsiveRules": true, "requireReducedMotion": true, "requireRTL": true }
+      },
       "translations": {
         "ar": {
           "title": "موقع متكامل لحل SaaS",
@@ -437,6 +457,72 @@
           ]
         }
       }
+    },
+    {
+      "id": "template-chat-workspace",
+      "title": "Chat Workspace",
+      "category": "application-workspace",
+      "status": "available",
+      "purpose": "A runnable managed conversation template for assistant, support, and collaborative chat products with compact governed tools and a separate generated-output rail.",
+      "starterFor": ["AI assistants", "support workspaces", "collaborative chat products"],
+      "sections": ["Product mode header", "Managed conversation", "Compact tool panel", "Docked composer", "Generated output rail"],
+      "requiredComponents": ["Chat Layout", "Chat Message Scroller", "Chat Message", "Chat Message Bubble", "Chat Tool Panel", "Chat Composer", "Chat Send Button"],
+      "sourcePath": "templates/chat-workspace/main.tsx",
+      "entryPath": "templates/chat-workspace/index.html",
+      "manifestPath": "templates/chat-workspace/template.manifest.json",
+      "bundlePath": "templates/chat-workspace",
+      "pageCount": 1,
+      "pages": ["Chat Workspace"],
+      "useWhen": [
+        "A viewport-height product needs streaming-aware conversation scrolling",
+        "Input tools and generated output need an explicit ownership boundary"
+      ],
+      "avoidWhen": [
+        "A short static transcript intentionally belongs to document scrolling",
+        "The surface is a marketing testimonial rather than an interactive product"
+      ],
+      "rtlReady": true,
+      "preview": { "kind": "chat-workspace", "density": "compact" },
+      "translations": {
+        "ar": {
+          "title": "مساحة عمل للمحادثة",
+          "purpose": "قالب محادثة مُدار وقابل للتشغيل للمساعدات والدعم والتعاون مع أدوات إدخال مدمجة ومنطقة منفصلة للمخرجات المنشأة.",
+          "starterFor": ["مساعدات الذكاء الاصطناعي", "مساحات عمل الدعم", "منتجات المحادثة التعاونية"],
+          "sections": ["رأس وضع المنتج", "المحادثة المُدارة", "لوحة الأدوات", "محرر الرسالة المثبت", "منطقة المخرجات"]
+        }
+      }
+    },
+    {
+      "id": "template-quantum-verification-story",
+      "title": "Quantum Verification Story",
+      "category": "website-page",
+      "status": "available",
+      "purpose": "A code-level Next.js and shadcn full-height narrative website adapted from the vy3 project with neutral identity and Ceramic theme tokens.",
+      "referenceNote": "Imported from the local source linked to the vy3 Vercel project; presentation sections, motion, and route structure are preserved.",
+      "starterFor": ["Security consultancies", "Technical product storytelling", "High-authority enterprise launches"],
+      "sections": ["Dark verification hero", "Problem", "Offer", "Comparison", "Audience profiles", "Pilot", "Contact"],
+      "requiredComponents": ["shadcn primitives", "Radix UI", "Framer Motion", "Ceramic theme bridge"],
+      "sourcePath": "templates/quantum-verification-story/src/app/page.tsx",
+      "entryPath": "templates/quantum-verification-story/src/app/page.tsx",
+      "manifestPath": "templates/quantum-verification-story/template.manifest.json",
+      "bundlePath": "templates/quantum-verification-story",
+      "runtime": "nextjs",
+      "previewUrl": "/templates/quantum-verification-story/index.html",
+      "pageCount": 4,
+      "pages": ["Home", "Products", "Assessment", "Continuous Verification"],
+      "useWhen": ["A presentation-like enterprise homepage needs full-height storytelling", "A shadcn-based Next.js starter is preferred"],
+      "avoidWhen": ["Seeded compliance claims have not been reviewed", "The final brand identity is unavailable"],
+      "rtlReady": true,
+      "themeable": true,
+      "preview": { "kind": "nextjs-shadcn", "density": "presentation" },
+      "translations": {
+        "ar": {
+          "title": "سرد التحقق من التشفير الكمي",
+          "purpose": "موقع سردي متكامل الارتفاع مبني على Next.js وshadcn بهوية محايدة ورموز سمات Ceramic قابلة للتبديل.",
+          "starterFor": ["استشارات الأمن", "سرد المنتجات التقنية", "إطلاقات المؤسسات"],
+          "sections": ["واجهة تحقق داكنة", "المشكلة", "العرض", "المقارنة", "ملفات الجمهور", "البرنامج التجريبي", "التواصل"]
+        }
+      }
     }
   ]
 }