@litfamily/litgrok 1.0.0

package/.grok/skills/frontend-ui-ux/references/ui-ux-db/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography, google-fonts
+Stacks: react, nextjs, vue, svelte, astro, swiftui, react-native, flutter, nuxtjs, nuxt-ui, html-tailwind, shadcn, jetpack-compose, threejs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help=f"Stack-specific search. Available: {', '.join(AVAILABLE_STACKS)}")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/.grok/skills/frontend-ui-ux/references/visual-language.md

@@ -0,0 +1,84 @@
+Visual language is a closed set of named roles with fixed values. What a component cannot name in that set is drift, not creativity.
+
+## Name type by role, not by family
+
+Decide the roles the product needs, bind values to each, and choose a family last.
+
+- Cap at 7 roles: display, page title, section title, body, body-strong, meta, label. Add mono only for code.
+- Every role fixes size, weight, line height, tracking, and wrapping behavior.
+- Line height 1.5 for body, 1.2-1.3 for headings, 1.6 for CJK body copy.
+- Use tabular numerals anywhere a number updates in place.
+- Two families plus one mono. A third family requires a named exception.
+
+## Bind color to semantic roles
+
+Components consume roles. A numbered palette scale is a foundation value, never a component decision.
+
+- Roles: canvas, surface, surface-raised, text, text-muted, border, border-strong, accent, accent-text, positive, warning, negative, focus, selection, overlay.
+- Ship each role as a foreground/background pair, so contrast belongs to the pair.
+- Ship a state ladder for interactive roles: default, hover, active, disabled.
+- Raw scales fail: `gray-500` carries no meaning, cannot invert per theme, cannot be audited, and multiplies one-offs.
+
+## State contrast as numbers
+
+Contrast is measured per theme against the painted background, never judged by eye.
+
+- Body and small text: 4.5:1 minimum.
+- Text at 24 px, or 19 px at bold and above: 3:1 minimum.
+- Meaningful icons, chart marks, and control boundaries: 3:1 minimum.
+- Focus indicator: 2 px minimum thickness at 3:1 against both adjacent colors.
+- Measure placeholder, muted metadata, and disabled labels explicitly; those fail first.
+
+## Keep one icon system
+
+One geometry, one weight, one metaphor vocabulary. An icon sharpens a label; it never replaces one.
+
+- Single grid at 24 px, one stroke weight, one corner and terminal treatment.
+- Name every meaningful icon, hide decorative ones from assistive technology, and never leave a destructive action on an icon alone.
+- Metaphor risk: obsolete objects, hand gestures, animals, and local symbols shift meaning by locale. Verify each shipped locale.
+
+## Treat imagery as tokens
+
+Imagery inherits system values. Undecided imagery becomes layout instability at load.
+
+- Aspect-ratio tokens, a declared focal point, and a reserved box before the asset lands.
+- Never bake text into an image; it cannot translate, zoom, or be announced.
+- Text over imagery needs a scrim that restores the measured contrast minimum.
+
+## Run surface, depth, and elevation as one ladder
+
+Surface color, border, and shadow move together. Three systems produce three mismatched hierarchies.
+
+- At most three levels above canvas: raised, overlay, modal.
+- Each level defines its surface color, border, and shadow in one entry.
+- Never nest more than two surfaces; a third means the structure is wrong.
+- Radius is a system value with two or three options, not a per-component choice.
+
+## Pick the data display from the question
+
+Choose the form from the question, then check that the encoding carries it.
+
+- Comparing a few categories: bar, ordered by value unless the axis is time.
+- Change over time: line, one unit per axis, no second axis without a stated reason.
+- Part of a whole: stacked bar; a circular form only at two or three parts.
+- One value against a target: large numeral with the target and a signed delta.
+- Add a non-hue channel — position, label, or pattern — to every color encoding.
+
+## Catch drift before review
+
+Drift is mechanically detectable. Run these before the independent review pass.
+
+1. Search components for raw hex, `rgb(`, and hardcoded px spacing. Expect zero hits.
+2. Count type roles, elevation levels, and radius values against the direction card.
+3. Re-measure contrast in light theme, dark theme, and forced colors.
+4. Record every accepted deviation in `accepted_exceptions` with an owner and expiry.
+
+## Failure patterns
+
+Reject:
+
+- A component importing a palette scale directly.
+- Status carried by hue alone.
+- Contrast reported as "looks fine" with no ratio.
+- Two icon families on one surface.
+- A pie chart with seven slices, or a chart where a table answers the question.

package/.grok/skills/frontend-ui-ux/references/visual-reconstruction.md

@@ -0,0 +1,97 @@
+A reference shows one state at one width, produced by a stack you do not control. Rebuild it as
+real markup with real semantics; never close the gap with a screenshot.
+
+## Claim classes
+
+Label every claim about the reference and carry the labels into its `references` entry.
+
+- Observed: measurable in the image — a pixel distance, a sampled hex value, a glyph.
+- Inferred: a reading the image does not prove, such as a scale behind three gaps.
+- Unknown: not depicted — hover, focus, error, empty, loading, any other width.
+
+Only observed claims are criteria; inferred claims need an owner, unknowns are user questions.
+
+## Measurement pass
+
+Measure before writing code. Guessed numbers cost the most to unwind.
+
+1. Record pixel dimensions and device scale; divide the scale out before quoting.
+2. Sample color at flat interior pixels, never on an edge or in a gradient.
+3. Measure cap height and baseline-to-baseline distance per size; derive line height.
+4. Fit every gap, gutter, and outer margin to the smallest plausible scale.
+
+## Semantic reconstruction
+
+Build the structure the content deserves, then style it toward the reference.
+
+- Headings become heading elements in outline order; large and bold is not an `h1`.
+- A row of links becomes a navigation list, not a flex row of `div`s.
+- Text baked into the image becomes real, selectable, translatable text.
+- Contrast failures and suppressed focus in the reference are not reproduced.
+
+## Asset decisions
+
+Decide per asset and record the decision.
+
+- Recreate: geometric shapes, rules, dividers, simple icons, gradients.
+- Extract: only assets you are permitted to use, at source resolution.
+- Substitute: a placeholder at identical dimensions, marked as a placeholder.
+- Omit: decoration carrying no information; record it in `omissions`.
+
+Never recreate a logo, wordmark, or licensed photograph. Substitute and raise a hard stop.
+
+## Metric-compatible font fallback
+
+When the reference face is unavailable or unlicensed, choose the fallback by metrics.
+
+1. Match units-per-em, cap height, x-height, and default advance width.
+2. Hold line boxes with `size-adjust`, `ascent-override`, `descent-override`.
+3. Verify the longest real label still fits at the fallback's advance.
+4. Record the substitution and its metric delta as an owned inferred claim.
+
+## Responsive inference from one frame
+
+One frame proves one width. State every adaptation as an assumption until confirmed.
+
+- Classify each region: fixed rail, fluid column, or centered maximum width.
+- Break where your measured content breaks, not at the reference's width.
+- Name what wraps, stacks, collapses, or scrolls below that width.
+- Check the narrowest supported width and one width above each break.
+
+## Iteration loop
+
+Iterate on measured deltas, never on impressions.
+
+1. Capture your build at the reference's exact dimensions and device scale.
+2. Compare region by region in order: structure, spacing, type, then color.
+3. Fix the single largest measured delta and recapture.
+4. Stop after three passes that do not reduce total delta; report the remainder.
+
+## Fidelity report
+
+Report per region so no reviewer has to re-measure.
+
+- Region name, measured delta per axis, both artifact paths compared.
+- Every inferred claim with its owner, every unknown state still awaiting input.
+- Substituted or omitted assets, with the reason.
+- Verdict `PASS`, `FAIL`, or `BLOCKED`, handed to the independent review pass bound to the design
+  contract hash.
+
+## The "pixel perfect" gate
+
+Use the phrase only when all five hold. Otherwise state measured fidelity as a number.
+
+1. Both captures share identical dimensions and device scale.
+2. Every observed claim is checked, with zero unexplained delta.
+3. No inferred claim is unowned and no unknown state unanswered.
+4. The reference face is licensed and loaded, not a metric fallback.
+5. The comparison covers every declared state, not one frame.
+
+## Failure patterns
+
+Reject:
+
+- A screenshot used as a background, an overlay, or filler content.
+- A spacing value chosen because it "looks right".
+- A reproduced logo or licensed image with no permission recorded.
+- "Pixel perfect" asserted from one width and one state.

package/.grok/skills/frontend-ui-ux/schemas/design-contract-v1alpha1.schema.json

@@ -0,0 +1,306 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "litfamily.design-contract/v1alpha1",
+  "title": "LitFamily Design Contract v1alpha1",
+  "description": "Twelve-key finite design contract. This document mirrors the rules that scripts/design-contract-rules.mjs executes; typed identifier prefixes, referential integrity, auth safety coupling, global identifier uniqueness, strict UTC timestamps, duplicate-key rejection, and canonical form are enforced only in that runtime.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id", "contract_id", "source_hash", "intent", "direction", "inventory",
+    "accessibility", "localization", "performance", "evidence_policy", "omissions",
+    "accepted_exceptions"
+  ],
+  "properties": {
+    "schema_id": { "const": "litfamily.design-contract/v1alpha1" },
+    "contract_id": { "type": "string", "pattern": "^contract:[a-z0-9][a-z0-9._/-]*$" },
+    "source_hash": { "$ref": "#/$defs/hash" },
+    "intent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["audiences", "tasks", "qualities", "constraints", "non_goals"],
+      "properties": {
+        "audiences": { "$ref": "#/$defs/requiredPhrases" },
+        "tasks": { "$ref": "#/$defs/requiredPhrases" },
+        "qualities": { "$ref": "#/$defs/requiredPhrases" },
+        "constraints": { "$ref": "#/$defs/optionalPhrases" },
+        "non_goals": { "$ref": "#/$defs/optionalPhrases" }
+      }
+    },
+    "direction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "principles", "token_strategy", "voice"],
+      "properties": {
+        "name": { "$ref": "#/$defs/text" },
+        "principles": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 7,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/text" }
+        },
+        "token_strategy": { "enum": ["reuse", "extend", "create"] },
+        "voice": { "$ref": "#/$defs/text" }
+      }
+    },
+    "inventory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "routes", "regions", "components", "interactions", "states", "viewports",
+        "references", "authenticated_surfaces"
+      ],
+      "properties": {
+        "routes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 128,
+          "items": { "$ref": "#/$defs/route" }
+        },
+        "regions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 256,
+          "items": { "$ref": "#/$defs/region" }
+        },
+        "components": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 512,
+          "items": { "$ref": "#/$defs/component" }
+        },
+        "interactions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 256,
+          "items": { "$ref": "#/$defs/interaction" }
+        },
+        "states": {
+          "type": "array",
+          "maxItems": 512,
+          "items": { "$ref": "#/$defs/state" }
+        },
+        "viewports": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/viewport" }
+        },
+        "references": {
+          "type": "array",
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/reference" }
+        },
+        "authenticated_surfaces": {
+          "type": "array",
+          "maxItems": 128,
+          "items": { "$ref": "#/$defs/authenticatedSurface" }
+        }
+      }
+    },
+    "accessibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target", "keyboard", "screen_reader", "reduced_motion", "forced_colors",
+        "zoom_percent"
+      ],
+      "properties": {
+        "target": { "const": "WCAG 2.2 AA" },
+        "keyboard": { "type": "boolean" },
+        "screen_reader": { "type": "boolean" },
+        "reduced_motion": { "type": "boolean" },
+        "forced_colors": { "type": "boolean" },
+        "zoom_percent": { "type": "integer", "minimum": 200, "maximum": 400 }
+      }
+    },
+    "localization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "locales", "text_expansion_percent", "cjk_line_break_review",
+        "font_fallback_review", "ime_review", "rtl_review"
+      ],
+      "properties": {
+        "locales": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^[a-z]{2,3}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?$" }
+        },
+        "text_expansion_percent": { "type": "integer", "minimum": 0, "maximum": 300 },
+        "cjk_line_break_review": { "type": "boolean" },
+        "font_fallback_review": { "type": "boolean" },
+        "ime_review": { "type": "boolean" },
+        "rtl_review": { "type": "boolean" }
+      }
+    },
+    "performance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lcp_ms", "cls", "inp_ms", "initial_js_kb", "initial_css_kb"],
+      "properties": {
+        "lcp_ms": { "type": "integer", "minimum": 1, "maximum": 60000 },
+        "cls": { "type": "number", "minimum": 0, "maximum": 1 },
+        "inp_ms": { "type": "integer", "minimum": 1, "maximum": 60000 },
+        "initial_js_kb": { "type": "integer", "minimum": 0, "maximum": 1048576 },
+        "initial_css_kb": { "type": "integer", "minimum": 0, "maximum": 1048576 }
+      }
+    },
+    "evidence_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["independent_review_required", "required_channels", "cleanup_required"],
+      "properties": {
+        "independent_review_required": { "type": "boolean" },
+        "required_channels": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 7,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "tests", "browser", "keyboard", "accessibility-tree", "screen-reader",
+              "performance", "localization"
+            ]
+          }
+        },
+        "cleanup_required": { "type": "boolean" }
+      }
+    },
+    "omissions": { "$ref": "#/$defs/scopeRecords" },
+    "accepted_exceptions": { "$ref": "#/$defs/scopeRecords" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "text": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^\\S(?:.*\\S)?$" },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+    },
+    "requiredPhrases": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/text" }
+    },
+    "optionalPhrases": {
+      "type": "array",
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/text" }
+    },
+    "route": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "primary", "auth_required"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" },
+        "path": { "$ref": "#/$defs/text" },
+        "primary": { "type": "boolean" },
+        "auth_required": { "type": "boolean" }
+      }
+    },
+    "region": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "route_id", "purpose"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^region:[a-z0-9][a-z0-9._/-]*$" },
+        "route_id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" },
+        "purpose": { "$ref": "#/$defs/text" }
+      }
+    },
+    "component": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "region_id", "role"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^component:[a-z0-9][a-z0-9._/-]*$" },
+        "region_id": { "type": "string", "pattern": "^region:[a-z0-9][a-z0-9._/-]*$" },
+        "role": { "$ref": "#/$defs/text" }
+      }
+    },
+    "interaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "route_id", "critical", "input_modes"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^interaction:[a-z0-9][a-z0-9._/-]*$" },
+        "route_id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" },
+        "critical": { "type": "boolean" },
+        "input_modes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 5,
+          "uniqueItems": true,
+          "items": { "enum": ["keyboard", "pointer", "touch", "voice", "switch"] }
+        }
+      }
+    },
+    "state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "route_id", "kind"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^state:[a-z0-9][a-z0-9._/-]*$" },
+        "route_id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" },
+        "kind": {
+          "enum": [
+            "loading", "empty", "error", "success", "disabled", "permission", "offline",
+            "ready"
+          ]
+        }
+      }
+    },
+    "viewport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "category", "width_px", "height_px"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^viewport:[a-z0-9][a-z0-9._/-]*$" },
+        "category": { "enum": ["compact", "medium", "expanded"] },
+        "width_px": { "type": "integer", "minimum": 240, "maximum": 7680 },
+        "height_px": { "type": "integer", "minimum": 240, "maximum": 4320 }
+      }
+    },
+    "reference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "sha256", "provenance"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^reference:[a-z0-9][a-z0-9._/-]*$" },
+        "kind": { "enum": ["user-provided", "repo-local", "generated", "measured"] },
+        "sha256": { "$ref": "#/$defs/hash" },
+        "provenance": { "$ref": "#/$defs/text" }
+      }
+    },
+    "authenticatedSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["route_id", "safe_test_account"],
+      "properties": {
+        "route_id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" },
+        "safe_test_account": { "const": true }
+      }
+    },
+    "scopeRecords": {
+      "type": "array",
+      "maxItems": 64,
+      "items": { "$ref": "#/$defs/scopeRecord" }
+    },
+    "scopeRecord": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "reason", "owner"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*:[a-z0-9][a-z0-9._/-]*$" },
+        "reason": { "$ref": "#/$defs/text" },
+        "owner": { "$ref": "#/$defs/text" },
+        "expires_at": { "$ref": "#/$defs/timestamp" }
+      }
+    }
+  }
+}