@decantr/content 3.8.0

package/schemas/page-pack.v1.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/page-pack.v1.json",
+  "title": "Decantr Page Execution Pack",
+  "type": "object",
+  "required": ["$schema", "packVersion", "packType", "objective", "target", "preset", "scope", "requiredSetup", "allowedVocabulary", "examples", "antiPatterns", "successChecks", "tokenBudget", "data", "renderedMarkdown"],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/page-pack.v1.json"
+    },
+    "packVersion": {
+      "const": "1.0.0"
+    },
+    "packType": {
+      "const": "page"
+    },
+    "objective": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+    },
+    "target": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackTarget"
+    },
+    "preset": {
+      "type": ["string", "null"]
+    },
+    "scope": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackScope"
+    },
+    "requiredSetup": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+    },
+    "allowedVocabulary": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackExample"
+      }
+    },
+    "antiPatterns": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackAntiPattern"
+      }
+    },
+    "successChecks": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackSuccessCheck"
+      }
+    },
+    "tokenBudget": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackTokenBudget"
+    },
+    "data": {
+      "type": "object",
+      "required": ["pageId", "path", "shell", "sectionId", "sectionRole", "features", "surface", "theme", "wiringSignals", "patterns"],
+      "properties": {
+        "pageId": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+        },
+        "path": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+        },
+        "shell": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+        },
+        "sectionId": {
+          "type": ["string", "null"]
+        },
+        "sectionRole": {
+          "type": ["string", "null"]
+        },
+        "features": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+        },
+        "surface": {
+          "type": "string"
+        },
+        "theme": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/themeRef"
+        },
+        "wiringSignals": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+        },
+        "patterns": {
+          "type": "array",
+          "items": {
+            "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/pagePattern"
+          }
+        },
+        "directives": {
+          "type": "array",
+          "description": "Execution-level directives emitted into page-pack rendering.",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      },
+      "additionalProperties": false
+    },
+    "renderedMarkdown": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/pattern.v2.json

@@ -0,0 +1,232 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/pattern.v2.json",
+  "title": "Decantr Pattern",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "version",
+    "name",
+    "description",
+    "components",
+    "default_preset",
+    "presets"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/pattern.v2.json"
+    },
+    "id": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "version": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "decantr_compat": {
+      "type": "string"
+    },
+    "name": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "description": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "tags": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "components": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "default_preset": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "presets": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "description",
+          "layout"
+        ],
+        "properties": {
+          "description": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          },
+          "components": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+          },
+          "layout": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/patternLayoutSpec"
+          },
+          "code": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/codeSpec"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "contained": {
+      "type": "boolean"
+    },
+    "io": {
+      "type": "object",
+      "properties": {
+        "produces": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "consumes": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "actions": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        }
+      },
+      "additionalProperties": true
+    },
+    "code": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/codeSpec"
+    },
+    "default_layout": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/patternLayoutSpec"
+    },
+    "visual_brief": {
+      "type": "string"
+    },
+    "composition": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "motion": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "interactions": {
+      "type": "array",
+      "description": "Declared runtime interactions that the rendered pattern MUST implement. Surfaced as a checkbox checklist in the per-page execution pack; enforced by decantr check --strict. Each value maps to a canonical implementation: a specific treatment class, handler pattern, or both — see 'Interaction Requirements' table in DECANTR.md for the mapping. Before this field, motion/interactivity lived only as prose philosophy that cold LLMs categorized as 'nice to have'.",
+      "items": {
+        "type": "string",
+        "enum": [
+          "animate-on-mount",
+          "stagger-children",
+          "status-pulse",
+          "shimmer-skeleton",
+          "float-idle",
+          "glow-hover",
+          "lift-hover",
+          "scale-hover",
+          "ripple-click",
+          "drag-nodes",
+          "drag-reorder",
+          "pan-background",
+          "zoom-scroll",
+          "zoom-pinch",
+          "click-select",
+          "click-connect",
+          "inline-edit",
+          "hover-tooltip",
+          "hover-reveal",
+          "live-simulation",
+          "real-time-updates",
+          "scroll-reveal",
+          "keyboard-navigation",
+          "focus-trap"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "responsive": {
+      "type": "object",
+      "description": "Per-breakpoint adaptation. Keys are viewport breakpoint tokens (e.g., 'mobile', 'tablet', 'desktop', or '<768px', '>=900px'). Values may be either a legacy prose string OR a structured ResponsiveBreakpointRule object. Prefer structured rules so the LLM can adapt mechanically instead of paraphrasing.",
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Legacy prose form — kept for backward compatibility."
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "layout": {
+                "type": "string",
+                "enum": ["stack", "grid", "flex-row", "flex-column", "hide", "alternate-pattern"],
+                "description": "Top-level layout strategy at this breakpoint. 'hide' removes the pattern entirely; 'alternate-pattern' swaps to the pattern id in alternate_pattern_id."
+              },
+              "columns": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 12,
+                "description": "Grid column count when layout=grid."
+              },
+              "gap": {
+                "type": "string",
+                "description": "Gap as a CSS length, density-token, or atom (e.g., '1rem', 'var(--d-content-gap)', '_gap4')."
+              },
+              "hide_components": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Component ids/aliases rendered by this pattern that should be hidden at this breakpoint."
+              },
+              "stack_order": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Explicit order when layout=stack. Useful when the default DOM order doesn't map to the intended mobile reading order."
+              },
+              "alternate_pattern_id": {
+                "type": "string",
+                "description": "Pattern id to substitute when layout=alternate-pattern. Use for desktop-only patterns that need a mobile-specific counterpart."
+              },
+              "horizontal_scroll": {
+                "type": "boolean",
+                "description": "If true: permit horizontal scroll at this breakpoint (e.g., data table on mobile). Default false."
+              },
+              "notes": {
+                "type": "string",
+                "description": "Prose that doesn't fit the structured fields. Short."
+              }
+            }
+          }
+        ]
+      }
+    },
+    "accessibility": {
+      "type": "object",
+      "properties": {
+        "role": {
+          "type": "string"
+        },
+        "aria-label": {
+          "type": "string"
+        },
+        "keyboard": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "announcements": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "focus_management": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "layout_hints": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "category": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/public-content-list.v1.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/public-content-list.v1.json",
+  "title": "Decantr Public Content List Response",
+  "type": "object",
+  "required": [
+    "items",
+    "total"
+  ],
+  "properties": {
+    "items": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/public-content-summary.v1.json"
+      }
+    },
+    "total": {
+      "type": "number"
+    },
+    "limit": {
+      "type": "number"
+    },
+    "offset": {
+      "type": "number"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/public-content-record.v1.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/public-content-record.v1.json",
+  "title": "Decantr Public Content Record",
+  "type": "object",
+  "required": [
+    "id",
+    "slug",
+    "namespace",
+    "type",
+    "version",
+    "data",
+    "visibility",
+    "status",
+    "created_at",
+    "updated_at"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "slug": {
+      "type": "string"
+    },
+    "namespace": {
+      "type": "string"
+    },
+    "type": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string"
+    },
+    "data": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "visibility": {
+      "enum": [
+        "public",
+        "private"
+      ]
+    },
+    "status": {
+      "enum": [
+        "pending",
+        "approved",
+        "rejected",
+        "published"
+      ]
+    },
+    "created_at": {
+      "type": "string"
+    },
+    "updated_at": {
+      "type": "string"
+    },
+    "published_at": {
+      "type": "string"
+    },
+    "owner_name": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "owner_username": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "thumbnail_url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "intelligence": {
+      "anyOf": [
+        {
+          "$ref": "https://decantr.ai/schemas/content-intelligence.v1.json"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/public-content-summary.v1.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/public-content-summary.v1.json",
+  "title": "Decantr Public Content Summary",
+  "type": "object",
+  "required": [
+    "id",
+    "slug",
+    "namespace",
+    "type"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "slug": {
+      "type": "string"
+    },
+    "namespace": {
+      "type": "string"
+    },
+    "type": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "published_at": {
+      "type": "string"
+    },
+    "owner_name": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "owner_username": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "thumbnail_url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "blueprint_portfolio": {
+      "anyOf": [
+        {
+          "type": "object",
+          "required": [
+            "visibility",
+            "maturity",
+            "rationale",
+            "artifact"
+          ],
+          "properties": {
+            "visibility": {
+              "enum": [
+                "featured",
+                "public",
+                "labs",
+                "hidden"
+              ]
+            },
+            "maturity": {
+              "enum": [
+                "certified-flagship",
+                "supported-contract",
+                "experimental",
+                "fold-candidate",
+                "legacy-hidden"
+              ]
+            },
+            "rationale": {
+              "type": "string"
+            },
+            "recommended_alternative": {
+              "type": "string"
+            },
+            "artifact": {
+              "type": "object",
+              "required": [
+                "status"
+              ],
+              "properties": {
+                "status": {
+                  "enum": [
+                    "none",
+                    "planned",
+                    "candidate",
+                    "certified"
+                  ]
+                },
+                "showcase": {
+                  "type": "string"
+                },
+                "notes": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "intelligence": {
+      "anyOf": [
+        {
+          "$ref": "https://decantr.ai/schemas/content-intelligence.v1.json"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/registry-intelligence-summary.v1.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/registry-intelligence-summary.v1.json",
+  "title": "Decantr Registry Intelligence Summary",
+  "type": "object",
+  "required": [
+    "$schema",
+    "generated_at",
+    "namespace",
+    "totals",
+    "by_type"
+  ],
+  "$defs": {
+    "bucket": {
+      "type": "object",
+      "required": [
+        "total_public_items",
+        "with_intelligence",
+        "recommended",
+        "authored",
+        "benchmark",
+        "hybrid",
+        "missing_source",
+        "smoke_green",
+        "build_green",
+        "high_confidence",
+        "verified_confidence"
+      ],
+      "properties": {
+        "total_public_items": { "type": "integer", "minimum": 0 },
+        "with_intelligence": { "type": "integer", "minimum": 0 },
+        "recommended": { "type": "integer", "minimum": 0 },
+        "authored": { "type": "integer", "minimum": 0 },
+        "benchmark": { "type": "integer", "minimum": 0 },
+        "hybrid": { "type": "integer", "minimum": 0 },
+        "missing_source": { "type": "integer", "minimum": 0 },
+        "smoke_green": { "type": "integer", "minimum": 0 },
+        "build_green": { "type": "integer", "minimum": 0 },
+        "high_confidence": { "type": "integer", "minimum": 0 },
+        "verified_confidence": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/registry-intelligence-summary.v1.json"
+    },
+    "generated_at": {
+      "type": "string"
+    },
+    "namespace": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "totals": {
+      "$ref": "#/$defs/bucket"
+    },
+    "by_type": {
+      "type": "object",
+      "required": [
+        "pattern",
+        "theme",
+        "blueprint",
+        "archetype",
+        "shell"
+      ],
+      "properties": {
+        "pattern": { "$ref": "#/$defs/bucket" },
+        "theme": { "$ref": "#/$defs/bucket" },
+        "blueprint": { "$ref": "#/$defs/bucket" },
+        "archetype": { "$ref": "#/$defs/bucket" },
+        "shell": { "$ref": "#/$defs/bucket" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}