@decantr/content 3.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Decantr AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @decantr/content
+
+Support status: `core-supported`  
+Release channel: `stable`
+
+Official Decantr content corpus for `@official` patterns, themes, shells, archetypes, and blueprints. This package is the source of truth for content-corpus search, schema validation, resolution, content health, and the Fly-hosted content API.
+
+## Install
+
+```bash
+npm install @decantr/content
+```
+
+## What It Exports
+
+- official corpus records under `patterns/`, `themes/`, `blueprints/`, `archetypes/`, and `shells/`
+- JSON Schemas under `schemas/`
+- `listContentRecords()`, `searchContent()`, `getContentRecord()`, and `resolveContent()`
+- `createContentResolver()` for pack compilation and compatibility callers
+- `validateContentData()` and `validateOfficialCorpus()`
+- `buildContentIntelligenceSummary()` for content coverage and recommendation metadata
+
+## Example
+
+```ts
+import {
+  createContentResolver,
+  searchContent,
+  validateOfficialCorpus,
+} from '@decantr/content';
+
+const results = searchContent({ q: 'dashboard', type: 'blueprints', recommended: true });
+const resolver = createContentResolver();
+const pattern = resolver.resolvePattern('data-table', 'product');
+const health = validateOfficialCorpus();
+```
+
+## Local Development
+
+From the monorepo root:
+
+```bash
+pnpm --filter @decantr/content validate
+pnpm --filter @decantr/content content:health
+pnpm --filter @decantr/content test
+```
+
+`decantr content check` is the preferred content-author workflow. `decantr content-health` remains as a backward-compatible primitive.
+
+## Product Boundary
+
+This corpus is official reference material. It is not a public marketplace, account system, or styling runtime. Brownfield attach and contract-only adoption must work without content API access. Project-owned local law created by `decantr codify --from-audit` belongs in the consuming app under `.decantr/local-patterns.json` and `.decantr/rules.json`.
+
+`@decantr/registry`, `decantr registry ...`, and MCP `decantr_registry` remain compatibility names in Decantr 3.x. New docs and scripts should prefer `@decantr/content` and `decantr content ...`.
+
+## License
+
+MIT

package/archetypes/about-hybrid.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "about-hybrid",
+  "role": "public",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "About Hybrid",
+  "description": "About page combining hero, company story, team grid, values, and call-to-action sections.",
+  "tags": [
+    "about",
+    "company",
+    "team",
+    "values",
+    "story"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "about us",
+        "about page",
+        "company info",
+        "team page"
+      ],
+      "secondary": [
+        "our story",
+        "our team",
+        "our values",
+        "mission"
+      ],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 1,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "about",
+      "patterns": [
+        {
+          "pattern": "hero",
+          "preset": "split",
+          "as": "hero"
+        },
+        {
+          "pattern": "prose-section",
+          "preset": "story",
+          "as": "story"
+        },
+        {
+          "pattern": "card-grid",
+          "preset": "team",
+          "as": "team"
+        },
+        {
+          "pattern": "card-grid",
+          "preset": "values",
+          "as": "values"
+        },
+        {
+          "pattern": "cta-section",
+          "preset": "standard",
+          "as": "cta"
+        }
+      ],
+      "default_layout": [
+        "hero",
+        "story",
+        "team",
+        "values",
+        "cta"
+      ],
+      "shell": "top-nav-footer"
+    }
+  ],
+  "page_briefs": {
+    "about": "Scroll-driven narrative page. Split hero with founder photo and headline at top, flowing into a long-form company story section. Below, a card grid of team member portraits with name and role, then a values grid with icon cards. Ends with a centered CTA banner."
+  },
+  "features": [
+    "team-grid",
+    "values-display"
+  ],
+  "shells": {
+    "top-nav-footer": "Standard marketing page layout with nav and footer"
+  },
+  "dependencies": {
+    "patterns": {
+      "hero": "^1.0.0",
+      "prose-section": "^1.0.0",
+      "card-grid": "^1.0.0",
+      "cta-section": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "carbon"
+    ],
+    "modes": [
+      "dark",
+      "light"
+    ]
+  }
+}

package/archetypes/admin-analytics.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "admin-analytics",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Admin Analytics",
+  "description": "Revenue and sales analytics for e-commerce administrators with KPI dashboards, trend charts, and inline sparkline data tables.",
+  "tags": ["analytics", "revenue", "charts", "kpi", "admin", "ecommerce", "2026"],
+  "classification": {
+    "triggers": {
+      "primary": ["admin analytics", "sales analytics", "revenue analytics", "store analytics"],
+      "secondary": ["sales report", "revenue chart", "conversion analytics", "product analytics"],
+      "negative": ["storefront", "checkout", "customer-facing"]
+    },
+    "implies": ["analytics", "reporting"],
+    "weight": 1,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "analytics",
+      "patterns": [
+        {
+          "pattern": "kpi-grid",
+          "preset": "dashboard",
+          "as": "revenue-kpis"
+        },
+        {
+          "pattern": "chart-grid",
+          "preset": "standard",
+          "as": "analytics-charts"
+        },
+        {
+          "pattern": "sparkline-cell",
+          "preset": "standard",
+          "as": "trend-sparklines"
+        }
+      ],
+      "default_layout": ["revenue-kpis", "analytics-charts", "trend-sparklines"],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "analytics": "KPI grid at top showing total revenue, order count, average order value, and refund rate with period-over-period change indicators. Chart grid below with revenue trend line, sales by category stacked bar, conversion funnel, and top products horizontal bar. Sparkline cells embedded in summary tables showing 7-day trends for each metric."
+  },
+  "features": ["analytics-state", "data-export", "date-range-picker"],
+  "shells": {
+    "sidebar-main": "Sidebar navigation with main content area"
+  },
+  "suggested_theme": {
+    "ids": ["auradecantism", "carbon"],
+    "modes": ["dark", "light"]
+  },
+  "dependencies": {
+    "patterns": {
+      "kpi-grid": ">=1.0.0",
+      "chart-grid": ">=1.0.0",
+      "sparkline-cell": ">=1.0.0"
+    },
+    "styles": {}
+  }
+}

package/archetypes/admin-moderation.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "admin-moderation",
+  "role": "auxiliary",
+  "version": "1.0.1",
+  "decantr_compat": ">=2.0.0",
+  "name": "Admin Moderation",
+  "description": "Admin moderation queue for reviewing, approving, and rejecting community-submitted registry content.",
+  "tags": [
+    "admin",
+    "moderation",
+    "review",
+    "queue",
+    "approval"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "moderation",
+        "admin-queue",
+        "content-review",
+        "approval"
+      ],
+      "secondary": [
+        "reject",
+        "approve",
+        "flagged",
+        "pending"
+      ],
+      "negative": []
+    },
+    "implies": [
+      "auth"
+    ],
+    "weight": 0.7,
+    "tier": "optional"
+  },
+  "pages": [
+    {
+      "id": "moderation-queue",
+      "path": "/admin/moderation",
+      "default_layout": [
+        "search-filter-bar",
+        "moderation-queue-item"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "moderation-detail",
+      "path": "/admin/moderation/[id]",
+      "default_layout": [
+        "content-detail-hero",
+        "json-viewer",
+        "moderation-queue-item"
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "moderation-queue": "Dense but readable admin list view with a responsive search/filter header. Queue items should wrap naturally and keep decision actions accessible without forcing everything into one horizontal strip. Admin access, navigation visibility, and queue actions should all agree with one shared admin capability source instead of scattered page-level checks.",
+    "moderation-detail": "Detail layout with content hero, artifact viewer, and moderation actions. Two-column when space allows, single-column below tablet widths. Action bars and metadata should stay compact but never cramped. Admin shell state should match the same identity and capability model used by the broader authenticated workspace."
+  },
+  "features": [
+    "auth",
+    "admin"
+  ],
+  "shells": {
+    "sidebar-main": "Sidebar navigation with main content area"
+  },
+  "dependencies": {
+    "patterns": {
+      "search-filter-bar": "^1.0.0",
+      "moderation-queue-item": "^1.0.0",
+      "content-detail-hero": "^1.0.0",
+      "json-viewer": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "luminarum"
+    ],
+    "modes": [
+      "dark"
+    ]
+  }
+}

package/archetypes/admin-overview.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "admin-overview",
+  "role": "primary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Admin Overview Dashboard",
+  "description": "Store operations dashboard with KPIs, sales charts, activity feed, and quick action cards. Central hub for e-commerce administrators.",
+  "tags": ["admin", "dashboard", "kpi", "overview", "ecommerce", "2026"],
+  "classification": {
+    "triggers": {
+      "primary": ["admin dashboard", "store dashboard", "admin overview", "operations dashboard"],
+      "secondary": ["sales metrics", "store kpi", "admin home", "revenue overview"],
+      "negative": ["storefront", "checkout", "customer-facing"]
+    },
+    "implies": ["analytics", "reporting"],
+    "weight": 1,
+    "tier": "core"
+  },
+  "pages": [
+    {
+      "id": "dashboard",
+      "patterns": [
+        {
+          "pattern": "kpi-grid",
+          "preset": "dashboard",
+          "as": "store-kpis"
+        },
+        {
+          "pattern": "chart-grid",
+          "preset": "standard",
+          "as": "sales-charts"
+        },
+        {
+          "pattern": "activity-feed",
+          "preset": "compact",
+          "as": "recent-activity"
+        }
+      ],
+      "default_layout": ["store-kpis", "sales-charts", "recent-activity"],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "quick-actions",
+      "patterns": [
+        {
+          "pattern": "card-grid",
+          "preset": "icon",
+          "as": "action-cards"
+        }
+      ],
+      "default_layout": ["action-cards"],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "dashboard": "KPI grid at top showing today's revenue, total orders, conversion rate, and average order value with sparkline trends. Chart grid below with sales trend line chart, top products bar chart, and order status donut chart. Compact activity feed at bottom with recent orders, low-stock alerts, and return requests.",
+    "quick-actions": "Grid of icon cards for common admin actions: Add Product, Process Returns, View Low Stock, Export Reports, Create Promotion, and Manage Shipping. Each card has an icon, label, and brief description."
+  },
+  "features": ["analytics-state", "notifications", "quick-actions"],
+  "shells": {
+    "sidebar-main": "Sidebar navigation grouped by domain with main content area"
+  },
+  "suggested_theme": {
+    "ids": ["auradecantism", "carbon"],
+    "modes": ["dark", "light"]
+  },
+  "dependencies": {
+    "patterns": {
+      "kpi-grid": ">=1.0.0",
+      "chart-grid": ">=1.0.0",
+      "activity-feed": ">=1.0.0",
+      "card-grid": ">=1.0.0"
+    },
+    "styles": {}
+  }
+}

package/archetypes/agent-orchestrator.json

@@ -0,0 +1,178 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "agent-orchestrator",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Agent Orchestrator",
+  "description": "Multi-agent management dashboard for monitoring, configuring, and orchestrating autonomous agent swarms with real-time status and marketplace discovery.",
+  "tags": [
+    "agents",
+    "orchestration",
+    "dashboard",
+    "ai",
+    "monitoring",
+    "real-time",
+    "2026"
+  ],
+  "role": "primary",
+  "classification": {
+    "triggers": {
+      "primary": [
+        "agent",
+        "orchestrator",
+        "swarm",
+        "multi-agent",
+        "agent-management"
+      ],
+      "secondary": [
+        "autonomous",
+        "agentic",
+        "pipeline",
+        "workflow-agent",
+        "crew",
+        "fleet"
+      ],
+      "negative": [
+        "chatbot",
+        "single-agent"
+      ]
+    },
+    "implies": [
+      "monitoring",
+      "real-time"
+    ],
+    "weight": 1,
+    "tier": "core"
+  },
+  "pages": [
+    {
+      "id": "agent-overview",
+      "default_layout": [
+        {
+          "pattern": "agent-swarm-canvas",
+          "as": "swarm-topology"
+        },
+        {
+          "pattern": "agent-timeline",
+          "as": "activity-feed"
+        }
+      ],
+      "shell": "sidebar-main",
+      "notes": "Primary dashboard: swarm canvas shows agent topology with live status; timeline shows recent agent actions and handoffs"
+    },
+    {
+      "id": "agent-detail",
+      "default_layout": [
+        {
+          "pattern": "agent-timeline",
+          "as": "agent-history"
+        },
+        {
+          "pattern": "neural-feedback-loop",
+          "as": "feedback-inspector"
+        }
+      ],
+      "shell": "sidebar-main",
+      "notes": "Single agent deep-dive: timeline shows execution trace; neural-feedback-loop visualizes decision cycles and confidence"
+    },
+    {
+      "id": "agent-config",
+      "default_layout": [
+        "nav-header",
+        {
+          "pattern": "form-sections",
+          "preset": "structured",
+          "as": "agent-parameters"
+        }
+      ],
+      "shell": "sidebar-main",
+      "notes": "Agent configuration: settings-nav for config sections; form-sections for parameters, prompts, tool assignments"
+    },
+    {
+      "id": "agent-marketplace",
+      "default_layout": [
+        {
+          "pattern": "hero",
+          "preset": "section-primary",
+          "as": "marketplace-hero"
+        },
+        {
+          "pattern": "generative-card-grid",
+          "as": "agent-catalog"
+        }
+      ],
+      "shell": "sidebar-main",
+      "notes": "Discover and install agent templates; generative-card-grid renders agent cards with capability tags and ratings"
+    }
+  ],
+  "page_briefs": {
+    "agent-overview": "Dense monitoring dashboard. Swarm topology canvas dominates the center showing agent nodes with live status indicators and connection lines. Activity feed timeline in a right sidebar or below, scrolling with timestamped agent actions.",
+    "agent-detail": "Deep-dive view with agent name and status ring in header. Timeline shows execution trace with expandable entries. Neural feedback loop visualization below with circular confidence diagrams and decision cycle charts.",
+    "agent-config": "Form-heavy page with grouped settings sections. Toggle switches for boolean config, text inputs for endpoints, dropdown for model selection. Settings nav on the left for jumping between parameter groups.",
+    "agent-marketplace": "Discovery page with hero banner at top and search bar. Below, a generative card grid of agent templates showing capability tags, ratings, and install buttons on each card."
+  },
+  "features": [
+    "agents",
+    "monitoring",
+    "orchestration",
+    "real-time",
+    "websockets"
+  ],
+  "directives": [
+    "Header is 52px sticky. Use `d-interactive[data-size=sm]` for all header action buttons (~32px tall, not 40px+).",
+    "Hotkey chords (e.g., `g a`) bind keyboard only — never render them as visible nav labels.",
+    "Auth bypass for dev: `localStorage.decantr_authenticated = 'true'` gates protected routes. Accept any credentials on the login page and redirect to `/agents`.",
+    "Swarm canvas nodes hide minimap + zoom controls below `_mdmax:` (< 768px) and collapse to a vertical status list per the pattern's structured responsive field.",
+    "Swarm canvas drag-vs-click threshold: only engage drag once pointermove distance from pointerdown exceeds 4px. Below the threshold, treat as a click (selects the node). Apply `cursor: grab` on node default, `cursor: grabbing` only after drag engages. Without this threshold, every click registers as a drag and selection becomes impossible.",
+    "Pan-background applies to canvas BACKGROUND only — not nodes. Nodes get pointerdown/pointermove for drag. Canvas background gets its own pointerdown/pointermove that translates the viewport transform. Wire the two via `e.stopPropagation()` from the node handler so the canvas pan doesn't fire when dragging a node."
+  ],
+  "navigation_items": [
+    {
+      "label": "Agents",
+      "route": "/agents",
+      "icon": "bot",
+      "hotkey": "g a",
+      "active_match": "^/agents(?:/|$)"
+    },
+    {
+      "label": "Marketplace",
+      "route": "/marketplace",
+      "icon": "shopping-bag",
+      "hotkey": "g m"
+    },
+    {
+      "label": "Config",
+      "route": "/agents/config",
+      "icon": "settings",
+      "active_match": "^/agents/config"
+    }
+  ],
+  "shells": {
+    "sidebar-main": "Collapsible sidebar with agent navigation tree and main content area"
+  },
+  "suggested_theme": {
+    "ids": [
+      "neon-dark",
+      "carbon"
+    ],
+    "modes": [
+      "dark"
+    ]
+  },
+  "dependencies": {
+    "patterns": {
+      "agent-swarm-canvas": ">=1.0.0",
+      "agent-timeline": ">=1.0.0",
+      "neural-feedback-loop": ">=1.0.0",
+      "generative-card-grid": ">=1.0.0",
+      "form-sections": ">=1.0.0",
+      "hero": ">=1.0.0",
+      "nav-header": ">=1.0.0"
+    },
+    "styles": {}
+  },
+  "certification": {
+    "tier": "demo",
+    "rationale": "Contains dev auth-bypass guidance and must not ship in enterprise artifact sets until rewritten with production-safe auth guidance."
+  }
+}