@vpxa/aikit 0.1.364 → 0.1.366

package/scaffold/dist/definitions/skills/present.mjs

@@ -1,4 +1,4 @@
-function e(){return[{file:`SKILL.md`,content:`---
+import{BLOCK_CATALOG as e}from"../../generated/block-docs.mjs";function t(){return[{file:`SKILL.md`,content:`---
 name: present
 description: "Use the AI Kit present tool for rich dashboards, charts, timelines, status boards, data tables, reviews, approvals, and interactive MCP App surfaces. Load before calling present so output uses the right block/template/action contract and stays readable."
 metadata:
@@ -18,7 +18,7 @@ Use present for complex user-facing output: reports, dashboards, evidence maps,
 ## Authoring Model
 
 Choose one:
-- blocks: direct markdown/heading/table/chart/cards/metrics/checklist/timeline/status-board/etc.
+- blocks: direct markdown/heading/table/chart/cards/metrics/checklist/timeline/status-board/stat-group/alert/etc.
 - template + data: report, task-plan, review, dashboard, diff, checklist, picker, form.
 - raw JSON: complex surfaces where hand-authored object is clearer.
 
@@ -99,75 +99,7 @@ If validation fails, fix schema shape first. Use schema/preset/template resource
 Load on demand:
 - references/block-catalog.md — Complete 32-block type catalog with value shapes, best block for each data type, and rules.
 - references/presets-templates.md — Preset contracts (8 presets), viewer templates (7), MCP App templates (14), diagram renderers (5), and error recovery patterns.
-`},{file:`references/block-catalog.md`,content:`# Block Catalog — 32 Content Blocks
-
-Pass content as blocks array of { type, title?, value } objects.
-
-## Content Blocks
-
-| Type | Value shape | Use for |
-|------|-------------|---------|
-| prompt | string | Prompt or callout text |
-| text | string | Plain text without markdown parsing |
-| heading | string | Standalone section headings |
-| paragraph | string | Standalone paragraph copy |
-| markdown | string | Prose, headings, code snippets |
-| code | string | Code or diff excerpts |
-| list | string[] | Bullet list items |
-| separator | none | Visual divider |
-| diff | { files: [{ path, hunks }] } | File diffs with +/- highlights |
-| finding | { label, description?, severity? } | Finding with severity pill |
-
-## Data Blocks
-
-| Type | Value shape | Use for |
-|------|-------------|---------|
-| table | Record[] or { headers, rows } | Tabular data |
-| metrics | [{ label, value, trend?, status? }] | KPI cards |
-| kv | Record<string, string> | Key-value pairs |
-| tags | string[] | Tag pills |
-| data-table-schema | { fields: [{ name, type, required? }] } | Schema table |
-| chart | { chartType, data, xKey?, yKeys? } | line/area/bar/horizontal-bar/pie/donut/sparkline/heatmap |
-
-## Visualization Blocks
-
-| Type | Value shape | Use for |
-|------|-------------|---------|
-| cards | [{ title, body?, badge?, status? }] | Summary cards |
-| tree | { name, children? } | Hierarchies |
-| timeline | [{ title, description?, timestamp?, status? }] | Event sequences |
-| mermaid | string | Diagrams |
-| graph | { nodes, edges } | Network graphs |
-| comparison | [{title, items}] or {columns} | Side-by-side comparisons |
-| lifecycle-flow | { nodes, edges } | SVG flow diagram |
-| component-detail | { name, type?, description? } | Component detail view |
-
-## Interactive / Layout
-
-| Type | Value shape | Use for |
-|------|-------------|---------|
-| checklist | [{ label, checked }] | Task lists |
-| status-board | [{category, items}] | Service health |
-| progress | {label, value, max?} | Progress bars |
-| docs-browser | { files } | Documentation indexes |
-| annotation | { items } | Annotation groups |
-| approval | { options, comment? } | Approval with options/textarea |
-| docs-hub | { title, items } | Doc hub card grid |
-| actions | [{ type, id, label }] | Inline action group |
-
-## Data-to-Block Quick Reference
-
-| Your data looks like... | Use this block type |
-|---|---|
-| Array of strings | list or markdown |
-| Key-value pairs | kv or table (2 columns) |
-| Rows x columns | table |
-| Done/not-done state | checklist |
-| Hierarchical items | tree |
-| Numeric KPIs | metrics |
-| Before/after or A vs B | comparison |
-| Findings with severity | finding |
-`},{file:`references/presets-templates.md`,content:`# Presets, Templates, and Error Recovery
+`},{file:`references/block-catalog.md`,content:e},{file:`references/presets-templates.md`,content:`# Presets, Templates, and Error Recovery
 
 ## 8 Named Presets
 
@@ -508,4 +440,4 @@ For RENDER_FAILED errors: data is valid but rendering failed. Simplify surface o
 Use raw JSON string field for complex payloads — auto-repair handles unescaped newlines and trailing commas.
 
 A Feedback text-submit action is automatically appended to every actions array.
-`}]}export{e as default};
+`}]}export{t as default};

package/scaffold/dist/generated/block-docs.mjs

@@ -1,4 +1,4 @@
-const e="| Type | Description | Value Shape |\n|------|-------------|-------------|\n| `markdown` | Markdown content rendered with the marked parser. | `string` |\n| `code` | Formatted code block rendered inside pre/code tags. | `string` |\n| `mermaid` | Mermaid diagram source rendered in a mermaid pre block. | `string` |\n| `architecture-diagram` | Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering. | `object ({ components, connections, boundaries? })` |\n| `workflow-diagram` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. | `object ({ lanes, nodes, edges })` |\n| `sequence-diagram` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. | `object ({ participants, messages })` |\n| `dataflow-diagram` | Data flow diagram with stage-based columns, nodes, and classification-colored edges. Produces SVG with mermaid rendering. | `object ({ stages, nodes, flows })` |\n| `lifecycle-diagram` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. | `object ({ lanes, states, transitions })` |\n| `table` | Tabular data rendered from records or explicit headers and rows. | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` |\n| `metrics` | Metric cards showing label/value pairs with optional trend and status. | `Array<{ label: string; value: string | number; trend?: string | number; status?: string }>` |\n| `cards` | Card grid for titled items with optional body, badge, and status. | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` |\n| `tree` | Hierarchical object or name/children tree rendered recursively. | `{ name: string; children?: unknown[] } | Record<string, unknown>` |\n| `graph` | Node and edge graph rendered as a Mermaid flow graph in HTML mode. | `{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }` |\n| `chart` | Structured chart definition rendered as SVG. | `{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }` |\n| `timeline` | Timeline entries rendered as a vertical sequence of events. | `Array<{ title: string; description?: string; timestamp?: string; status?: string }>` |\n| `checklist` | Checklist items with boolean checked state. | `Array<{label, checked}> | {items: Array<{label, checked}>}` |\n| `comparison` | Side-by-side comparison columns with titled item lists. | `Array<{title, items}> | {columns: Array<{title, items}>}` |\n| `status-board` | Status categories containing labeled status items. | `Array<{category, items}> | {items: Array<{category, items}>}` |\n| `prompt` | Prompt payload rendered through the prompt display helper. | `unknown` |\n| `progress` | Progress bar with current value and optional maximum. | `{label, value, max?} | {items: Array<{label, value, max?, color?}>}` |\n| `docs-browser` | Documentation file list with inline content previews for chat-safe rendering. | `{ files: Array<{ path: string; title?: string; content?: string; status?: \"current\" | \"stale\" | \"missing\" }>; title?: string }` |\n| `text` | Plain text content rendered through the markdown parser. | `string` |\n| `heading` | Single heading with configurable level from h1 to h6. | `string` |\n| `paragraph` | Single paragraph rendered inside a p tag. | `string` |\n| `separator` | Horizontal rule used to separate adjacent blocks. | `undefined` |\n| `actions` | Action bar containing button and select action definitions. | `Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>` |\n| `diff` | Diff view with +/- lines for showing changes between text. | `string | { content: string } | { before: string; after: string }` |\n| `finding` | Finding with severity pill showing title, severity, and detail. | `{ title?: string; severity?: string; detail?: unknown }` |\n| `kv` | Key-value pairs rendered as labeled entries. | `Array<{ key: string; value: unknown }> | Record<string, unknown>` |\n| `tags` | Tag pills rendered with optional tone/color. | `Array<string | { text?: string; label?: string; status?: string; tone?: string; color?: string }> | { items: Array<...> }` |\n| `list` | Bullet list items rendered as an unordered list. | `string[]` |\n| `lifecycle-flow` | SVG flow diagram with labeled steps, edges, and status colors. | `{ title?: string; steps: Array<{ id: string; label: string; type?: string; status?: string; description?: string }>; edges?: Array<{ from: string; to: string; label?: string }> }` |\n| `component-detail` | Component detail view with name, type, technology, responsibilities, interfaces, dependencies, metrics, and code links. | `{ name: string; description?: string; type?: string; technology?: string; responsibilities?: string[]; interfaces?: Array<{ name: string; type: string; description?: string }>; dependencies?: Array<{ name: string; relationship?: string }>; metrics?: Record<string, string | number>; codeLinks?: Array<{ href: string; label: string }> }` |\n| `data-table-schema` | Schema table with field names, types, constraints, and indexes. | `{ name: string; description?: string; fields: Array<{ name: string; type: string; required?: boolean; default?: unknown; constraints?: string[]; description?: string }>; indexes?: Array<{ name: string; columns: string[]; unique?: boolean }> }` |\n| `annotation` | Annotation groups with COMMENT, DELETION, and GLOBAL_COMMENT types. | `Array<{ id: string; type: \"COMMENT\" | \"DELETION\" | \"GLOBAL_COMMENT\"; body: string; author?: string; createdAt?: string }>` |\n| `approval` | Approval widget with radio options and optional comment textarea. | `{ prompt: string; options: Array<{ id: string; label: string; description?: string }>; requireComment?: boolean }` |\n| `docs-hub` | Doc hub card grid with titled pages, descriptions, categories, and statuses. | `{ title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: \"draft\" | \"published\" | \"deprecated\" }> }` |\n\n### Usage Examples\n\n#### `architecture-diagram`\n\n```typescript\n{\n  type: 'architecture-diagram',\n  value: {\n    components: [\n      { id: 'api', label: 'API Server', type: 'backend' },\n      { id: 'web', label: 'Web App', type: 'frontend' }\n    ],\n    connections: [\n      { from: 'web', to: 'api', label: 'HTTPS' }\n    ]\n  }\n}\n```\n\n#### `docs-browser`\n\n```typescript\n{\n  type: 'docs-browser',\n  value: {\n    title: 'Project Docs',\n    files: [\n      { path: 'docs/README.md', title: 'Overview', status: 'current' },\n      { path: 'docs/api.md', title: 'API Reference', status: 'stale' },\n    ],\n  },\n}\n```",t=`  - type:"markdown" → value: string
+const e="| Type | Description | Value Shape |\n|------|-------------|-------------|\n| `markdown` | Markdown content rendered with the marked parser. | `string` |\n| `code` | Formatted code block rendered inside pre/code tags. | `string` |\n| `mermaid` | Mermaid diagram source rendered in a mermaid pre block. | `string` |\n| `architecture-diagram` | Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering. | `object ({ components, connections, boundaries? })` |\n| `workflow-diagram` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. | `object ({ lanes, nodes, edges })` |\n| `sequence-diagram` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. | `object ({ participants, messages })` |\n| `dataflow-diagram` | Data flow diagram with stage-based columns, nodes, and classification-colored edges. Produces SVG with mermaid rendering. | `object ({ stages, nodes, flows })` |\n| `lifecycle-diagram` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. | `object ({ lanes, states, transitions })` |\n| `table` | Tabular data rendered from records or explicit headers and rows. | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` |\n| `metrics` | Metric cards showing label/value pairs with optional trend and status. | `Array<{ label: string; value: string | number; trend?: string | number; status?: string }>` |\n| `cards` | Card grid for titled items with optional body, badge, and status. | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` |\n| `tree` | Hierarchical object or name/children tree rendered recursively. | `{ name: string; children?: unknown[] } | Record<string, unknown>` |\n| `graph` | Node and edge graph rendered as a Mermaid flow graph in HTML mode. | `{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }` |\n| `chart` | Structured chart definition rendered as SVG. | `{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }` |\n| `timeline` | Timeline entries rendered as a vertical sequence of events. | `Array<{ title: string; description?: string; timestamp?: string; status?: string }>` |\n| `checklist` | Checklist items with boolean checked state. | `Array<{label, checked}> | {items: Array<{label, checked}>}` |\n| `comparison` | Side-by-side comparison columns with titled item lists. | `Array<{title, items}> | {columns: Array<{title, items}>}` |\n| `status-board` | Status categories containing labeled status items. | `Array<{category, items}> | {items: Array<{category, items}>}` |\n| `stat-group` | Colored stat/gauge cards with label, value, and tone. Ideal for summary counts, KPI dashboards, and status overviews. | `Array<{ label: string; value: string | number; color?: string }>` |\n| `alert` | Alert/callout box with icon, title, and body text. Tone supports: info (default), success, warning, danger, accent. | `string | { title?: string; value?: string; tone?: string; severity?: string }` |\n| `prompt` | Prompt payload rendered through the prompt display helper. | `unknown` |\n| `progress` | Progress bar with current value and optional maximum. | `{label, value, max?} | {items: Array<{label, value, max?, color?}>}` |\n| `docs-browser` | Documentation file list with inline content previews for chat-safe rendering. | `{ files: Array<{ path: string; title?: string; content?: string; status?: \"current\" | \"stale\" | \"missing\" }>; title?: string }` |\n| `text` | Plain text content rendered through the markdown parser. | `string` |\n| `heading` | Single heading with configurable level from h1 to h6. | `string` |\n| `paragraph` | Single paragraph rendered inside a p tag. | `string` |\n| `separator` | Horizontal rule used to separate adjacent blocks. | `undefined` |\n| `actions` | Action bar containing button and select action definitions. | `Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>` |\n| `diff` | Diff view with +/- lines for showing changes between text. | `string | { content: string } | { before: string; after: string }` |\n| `finding` | Finding with severity pill showing title, severity, and detail. | `{ title?: string; severity?: string; detail?: unknown }` |\n| `kv` | Key-value pairs rendered as labeled entries. | `Array<{ key: string; value: unknown }> | Record<string, unknown>` |\n| `tags` | Tag pills rendered with optional tone/color. | `Array<string | { text?: string; label?: string; status?: string; tone?: string; color?: string }> | { items: Array<...> }` |\n| `list` | Bullet list items rendered as an unordered list. | `string[]` |\n| `lifecycle-flow` | SVG flow diagram with labeled steps, edges, and status colors. | `{ title?: string; steps: Array<{ id: string; label: string; type?: string; status?: string; description?: string }>; edges?: Array<{ from: string; to: string; label?: string }> }` |\n| `component-detail` | Component detail view with name, type, technology, responsibilities, interfaces, dependencies, metrics, and code links. | `{ name: string; description?: string; type?: string; technology?: string; responsibilities?: string[]; interfaces?: Array<{ name: string; type: string; description?: string }>; dependencies?: Array<{ name: string; relationship?: string }>; metrics?: Record<string, string | number>; codeLinks?: Array<{ href: string; label: string }> }` |\n| `data-table-schema` | Schema table with field names, types, constraints, and indexes. | `{ name: string; description?: string; fields: Array<{ name: string; type: string; required?: boolean; default?: unknown; constraints?: string[]; description?: string }>; indexes?: Array<{ name: string; columns: string[]; unique?: boolean }> }` |\n| `annotation` | Annotation groups with COMMENT, DELETION, and GLOBAL_COMMENT types. | `Array<{ id: string; type: \"COMMENT\" | \"DELETION\" | \"GLOBAL_COMMENT\"; body: string; author?: string; createdAt?: string }>` |\n| `approval` | Approval widget with radio options and optional comment textarea. | `{ prompt: string; options: Array<{ id: string; label: string; description?: string }>; requireComment?: boolean }` |\n| `docs-hub` | Doc hub card grid with titled pages, descriptions, categories, and statuses. | `{ title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: \"draft\" | \"published\" | \"deprecated\" }> }` |\n\n### Usage Examples\n\n#### `architecture-diagram`\n\n```typescript\n{\n  type: 'architecture-diagram',\n  value: {\n    components: [\n      { id: 'api', label: 'API Server', type: 'backend' },\n      { id: 'web', label: 'Web App', type: 'frontend' }\n    ],\n    connections: [\n      { from: 'web', to: 'api', label: 'HTTPS' }\n    ]\n  }\n}\n```\n\n#### `stat-group`\n\n```typescript\n{\n  type: 'stat-group',\n  title: 'Status Overview',\n  value: [\n    { label: 'Passed', value: '42', color: 'green' },\n    { label: 'Failed', value: '3', color: 'red' },\n    { label: 'Pending', value: '7', color: 'yellow' },\n  ],\n}\n```\n\n#### `alert`\n\n```typescript\n{\n  type: 'alert',\n  title: 'Critical Path — Complete',\n  value: 'All delivery stages are wired end-to-end.',\n  tone: 'success',\n}\n```\n\n#### `docs-browser`\n\n```typescript\n{\n  type: 'docs-browser',\n  value: {\n    title: 'Project Docs',\n    files: [\n      { path: 'docs/README.md', title: 'Overview', status: 'current' },\n      { path: 'docs/api.md', title: 'API Reference', status: 'stale' },\n    ],\n  },\n}\n```",t=`  - type:"markdown" → value: string
   - type:"code" → value: string
   - type:"mermaid" → value: string
   - type:"architecture-diagram" → value: object ({ components, connections, boundaries? })
@@ -16,6 +16,8 @@ const e="| Type | Description | Value Shape |\n|------|-------------|-----------
   - type:"checklist" → value: Array<{label, checked}> | {items: Array<{label, checked}>}
   - type:"comparison" → value: Array<{title, items}> | {columns: Array<{title, items}>}
   - type:"status-board" → value: Array<{category, items}> | {items: Array<{category, items}>}
+  - type:"stat-group" → value: Array<{ label: string; value: string | number; color?: string }>
+  - type:"alert" → value: string | { title?: string; value?: string; tone?: string; severity?: string }
   - type:"prompt" → value: unknown
   - type:"progress" → value: {label, value, max?} | {items: Array<{label, value, max?, color?}>}
   - type:"docs-browser" → value: { files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }
@@ -34,7 +36,7 @@ const e="| Type | Description | Value Shape |\n|------|-------------|-----------
   - type:"data-table-schema" → value: { name: string; description?: string; fields: Array<{ name: string; type: string; required?: boolean; default?: unknown; constraints?: string[]; description?: string }>; indexes?: Array<{ name: string; columns: string[]; unique?: boolean }> }
   - type:"annotation" → value: Array<{ id: string; type: "COMMENT" | "DELETION" | "GLOBAL_COMMENT"; body: string; author?: string; createdAt?: string }>
   - type:"approval" → value: { prompt: string; options: Array<{ id: string; label: string; description?: string }>; requireComment?: boolean }
-  - type:"docs-hub" → value: { title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: "draft" | "published" | "deprecated" }> }`,n={present:"| Type | Description | Value Shape |\n|------|-------------|-------------|\n| `markdown` | Markdown content rendered with the marked parser. | `string` |\n| `code` | Formatted code block rendered inside pre/code tags. | `string` |\n| `mermaid` | Mermaid diagram source rendered in a mermaid pre block. | `string` |\n| `architecture-diagram` | Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering. | `object ({ components, connections, boundaries? })` |\n| `workflow-diagram` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. | `object ({ lanes, nodes, edges })` |\n| `sequence-diagram` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. | `object ({ participants, messages })` |\n| `dataflow-diagram` | Data flow diagram with stage-based columns, nodes, and classification-colored edges. Produces SVG with mermaid rendering. | `object ({ stages, nodes, flows })` |\n| `lifecycle-diagram` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. | `object ({ lanes, states, transitions })` |\n| `table` | Tabular data rendered from records or explicit headers and rows. | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` |\n| `metrics` | Metric cards showing label/value pairs with optional trend and status. | `Array<{ label: string; value: string | number; trend?: string | number; status?: string }>` |\n| `cards` | Card grid for titled items with optional body, badge, and status. | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` |\n| `tree` | Hierarchical object or name/children tree rendered recursively. | `{ name: string; children?: unknown[] } | Record<string, unknown>` |\n| `graph` | Node and edge graph rendered as a Mermaid flow graph in HTML mode. | `{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }` |\n| `chart` | Structured chart definition rendered as SVG. | `{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }` |\n| `timeline` | Timeline entries rendered as a vertical sequence of events. | `Array<{ title: string; description?: string; timestamp?: string; status?: string }>` |\n| `checklist` | Checklist items with boolean checked state. | `Array<{label, checked}> | {items: Array<{label, checked}>}` |\n| `comparison` | Side-by-side comparison columns with titled item lists. | `Array<{title, items}> | {columns: Array<{title, items}>}` |\n| `status-board` | Status categories containing labeled status items. | `Array<{category, items}> | {items: Array<{category, items}>}` |\n| `prompt` | Prompt payload rendered through the prompt display helper. | `unknown` |\n| `progress` | Progress bar with current value and optional maximum. | `{label, value, max?} | {items: Array<{label, value, max?, color?}>}` |\n| `docs-browser` | Documentation file list with inline content previews for chat-safe rendering. | `{ files: Array<{ path: string; title?: string; content?: string; status?: \"current\" | \"stale\" | \"missing\" }>; title?: string }` |\n\n### Usage Examples\n\n#### `architecture-diagram`\n\n```typescript\n{\n  type: 'architecture-diagram',\n  value: {\n    components: [\n      { id: 'api', label: 'API Server', type: 'backend' },\n      { id: 'web', label: 'Web App', type: 'frontend' }\n    ],\n    connections: [\n      { from: 'web', to: 'api', label: 'HTTPS' }\n    ]\n  }\n}\n```\n\n#### `docs-browser`\n\n```typescript\n{\n  type: 'docs-browser',\n  value: {\n    title: 'Project Docs',\n    files: [\n      { path: 'docs/README.md', title: 'Overview', status: 'current' },\n      { path: 'docs/api.md', title: 'API Reference', status: 'stale' },\n    ],\n  },\n}\n```",docs:"| Type | Description | Value Shape |\n|------|-------------|-------------|\n| `markdown` | Markdown content rendered with the marked parser. | `string` |\n| `code` | Formatted code block rendered inside pre/code tags. | `string` |\n| `mermaid` | Mermaid diagram source rendered in a mermaid pre block. | `string` |\n| `workflow-diagram` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. | `object ({ lanes, nodes, edges })` |\n| `sequence-diagram` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. | `object ({ participants, messages })` |\n| `lifecycle-diagram` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. | `object ({ lanes, states, transitions })` |\n| `table` | Tabular data rendered from records or explicit headers and rows. | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` |\n| `cards` | Card grid for titled items with optional body, badge, and status. | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` |\n| `docs-browser` | Documentation file list with inline content previews for chat-safe rendering. | `{ files: Array<{ path: string; title?: string; content?: string; status?: \"current\" | \"stale\" | \"missing\" }>; title?: string }` |\n\n### Usage Examples\n\n#### `docs-browser`\n\n```typescript\n{\n  type: 'docs-browser',\n  value: {\n    title: 'Project Docs',\n    files: [\n      { path: 'docs/README.md', title: 'Overview', status: 'current' },\n      { path: 'docs/api.md', title: 'API Reference', status: 'stale' },\n    ],\n  },\n}\n```","c4-architecture":`| Type | Description | Value Shape |
+  - type:"docs-hub" → value: { title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: "draft" | "published" | "deprecated" }> }`,n='# Block Catalog — 39 Content Blocks\n\nPass content as blocks array of { type, title?, value } objects.\n\n## Content Blocks\n\n| Type | Value shape | Use for |\n|------|-------------|---------|\n| markdown | `string` | Markdown content rendered with the marked parser. |\n| code | `string` | Formatted code block rendered inside pre/code tags. |\n| alert | `string | { title?: string; value?: string; tone?: string; severity?: string }` | Alert/callout box with icon, title, and body text. Tone supports: info (default), success, warning, danger, accent. |\n| text | `string` | Plain text content rendered through the markdown parser. |\n| heading | `string` | Single heading with configurable level from h1 to h6. |\n| paragraph | `string` | Single paragraph rendered inside a p tag. |\n| diff | `string | { content: string } | { before: string; after: string }` | Diff view with +/- lines for showing changes between text. |\n| finding | `{ title?: string; severity?: string; detail?: unknown }` | Finding with severity pill showing title, severity, and detail. |\n| list | `string[]` | Bullet list items rendered as an unordered list. |\n| docs-hub | `{ title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: "draft" | "published" | "deprecated" }> }` | Doc hub card grid with titled pages, descriptions, categories, and statuses. |\n\n## Data Blocks\n\n| Type | Value shape | Use for |\n|------|-------------|---------|\n| table | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` | Tabular data rendered from records or explicit headers and rows. |\n| metrics | `Array<{ label: string; value: string | number; trend?: string | number; status?: string }>` | Metric cards showing label/value pairs with optional trend and status. |\n| chart | `{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }` | Structured chart definition rendered as SVG. |\n| stat-group | `Array<{ label: string; value: string | number; color?: string }>` | Colored stat/gauge cards with label, value, and tone. Ideal for summary counts, KPI dashboards, and status overviews. |\n| kv | `Array<{ key: string; value: unknown }> | Record<string, unknown>` | Key-value pairs rendered as labeled entries. |\n| tags | `Array<string | { text?: string; label?: string; status?: string; tone?: string; color?: string }> | { items: Array<...> }` | Tag pills rendered with optional tone/color. |\n| data-table-schema | `{ name: string; description?: string; fields: Array<{ name: string; type: string; required?: boolean; default?: unknown; constraints?: string[]; description?: string }>; indexes?: Array<{ name: string; columns: string[]; unique?: boolean }> }` | Schema table with field names, types, constraints, and indexes. |\n\n## Visualization Blocks\n\n| Type | Value shape | Use for |\n|------|-------------|---------|\n| mermaid | `string` | Mermaid diagram source rendered in a mermaid pre block. |\n| architecture-diagram | `object ({ components, connections, boundaries? })` | Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering. |\n| workflow-diagram | `object ({ lanes, nodes, edges })` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. |\n| sequence-diagram | `object ({ participants, messages })` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. |\n| dataflow-diagram | `object ({ stages, nodes, flows })` | Data flow diagram with stage-based columns, nodes, and classification-colored edges. Produces SVG with mermaid rendering. |\n| lifecycle-diagram | `object ({ lanes, states, transitions })` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. |\n| cards | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` | Card grid for titled items with optional body, badge, and status. |\n| tree | `{ name: string; children?: unknown[] } | Record<string, unknown>` | Hierarchical object or name/children tree rendered recursively. |\n| graph | `{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }` | Node and edge graph rendered as a Mermaid flow graph in HTML mode. |\n| lifecycle-flow | `{ title?: string; steps: Array<{ id: string; label: string; type?: string; status?: string; description?: string }>; edges?: Array<{ from: string; to: string; label?: string }> }` | SVG flow diagram with labeled steps, edges, and status colors. |\n| component-detail | `{ name: string; description?: string; type?: string; technology?: string; responsibilities?: string[]; interfaces?: Array<{ name: string; type: string; description?: string }>; dependencies?: Array<{ name: string; relationship?: string }>; metrics?: Record<string, string | number>; codeLinks?: Array<{ href: string; label: string }> }` | Component detail view with name, type, technology, responsibilities, interfaces, dependencies, metrics, and code links. |\n\n## Interactive / Layout\n\n| Type | Value shape | Use for |\n|------|-------------|---------|\n| timeline | `Array<{ title: string; description?: string; timestamp?: string; status?: string }>` | Timeline entries rendered as a vertical sequence of events. |\n| checklist | `Array<{label, checked}> | {items: Array<{label, checked}>}` | Checklist items with boolean checked state. |\n| comparison | `Array<{title, items}> | {columns: Array<{title, items}>}` | Side-by-side comparison columns with titled item lists. |\n| status-board | `Array<{category, items}> | {items: Array<{category, items}>}` | Status categories containing labeled status items. |\n| prompt | `unknown` | Prompt payload rendered through the prompt display helper. |\n| progress | `{label, value, max?} | {items: Array<{label, value, max?, color?}>}` | Progress bar with current value and optional maximum. |\n| docs-browser | `{ files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }` | Documentation file list with inline content previews for chat-safe rendering. |\n| separator | `undefined` | Horizontal rule used to separate adjacent blocks. |\n| actions | `Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>` | Action bar containing button and select action definitions. |\n| annotation | `Array<{ id: string; type: "COMMENT" | "DELETION" | "GLOBAL_COMMENT"; body: string; author?: string; createdAt?: string }>` | Annotation groups with COMMENT, DELETION, and GLOBAL_COMMENT types. |\n| approval | `{ prompt: string; options: Array<{ id: string; label: string; description?: string }>; requireComment?: boolean }` | Approval widget with radio options and optional comment textarea. |\n\n## Data-to-Block Quick Reference\n\n| Your data looks like... | Use this block type |\n|-------------------------|---------------------|\n| Array of strings | list or markdown |\n| Key-value pairs | kv or table (2 columns) |\n| Rows x columns | table |\n| Colored status counts / KPIs with labels | stat-group or metrics |\n| Status update / callout message | alert |\n| Done/not-done state | checklist |\n| Hierarchical items | tree |\n| Numeric KPIs | metrics |\n| Before/after or A vs B | comparison |\n| Findings with severity | finding |\n',r={present:"| Type | Description | Value Shape |\n|------|-------------|-------------|\n| `markdown` | Markdown content rendered with the marked parser. | `string` |\n| `code` | Formatted code block rendered inside pre/code tags. | `string` |\n| `mermaid` | Mermaid diagram source rendered in a mermaid pre block. | `string` |\n| `architecture-diagram` | Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering. | `object ({ components, connections, boundaries? })` |\n| `workflow-diagram` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. | `object ({ lanes, nodes, edges })` |\n| `sequence-diagram` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. | `object ({ participants, messages })` |\n| `dataflow-diagram` | Data flow diagram with stage-based columns, nodes, and classification-colored edges. Produces SVG with mermaid rendering. | `object ({ stages, nodes, flows })` |\n| `lifecycle-diagram` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. | `object ({ lanes, states, transitions })` |\n| `table` | Tabular data rendered from records or explicit headers and rows. | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` |\n| `metrics` | Metric cards showing label/value pairs with optional trend and status. | `Array<{ label: string; value: string | number; trend?: string | number; status?: string }>` |\n| `cards` | Card grid for titled items with optional body, badge, and status. | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` |\n| `tree` | Hierarchical object or name/children tree rendered recursively. | `{ name: string; children?: unknown[] } | Record<string, unknown>` |\n| `graph` | Node and edge graph rendered as a Mermaid flow graph in HTML mode. | `{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }` |\n| `chart` | Structured chart definition rendered as SVG. | `{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }` |\n| `timeline` | Timeline entries rendered as a vertical sequence of events. | `Array<{ title: string; description?: string; timestamp?: string; status?: string }>` |\n| `checklist` | Checklist items with boolean checked state. | `Array<{label, checked}> | {items: Array<{label, checked}>}` |\n| `comparison` | Side-by-side comparison columns with titled item lists. | `Array<{title, items}> | {columns: Array<{title, items}>}` |\n| `status-board` | Status categories containing labeled status items. | `Array<{category, items}> | {items: Array<{category, items}>}` |\n| `stat-group` | Colored stat/gauge cards with label, value, and tone. Ideal for summary counts, KPI dashboards, and status overviews. | `Array<{ label: string; value: string | number; color?: string }>` |\n| `alert` | Alert/callout box with icon, title, and body text. Tone supports: info (default), success, warning, danger, accent. | `string | { title?: string; value?: string; tone?: string; severity?: string }` |\n| `prompt` | Prompt payload rendered through the prompt display helper. | `unknown` |\n| `progress` | Progress bar with current value and optional maximum. | `{label, value, max?} | {items: Array<{label, value, max?, color?}>}` |\n| `docs-browser` | Documentation file list with inline content previews for chat-safe rendering. | `{ files: Array<{ path: string; title?: string; content?: string; status?: \"current\" | \"stale\" | \"missing\" }>; title?: string }` |\n\n### Usage Examples\n\n#### `architecture-diagram`\n\n```typescript\n{\n  type: 'architecture-diagram',\n  value: {\n    components: [\n      { id: 'api', label: 'API Server', type: 'backend' },\n      { id: 'web', label: 'Web App', type: 'frontend' }\n    ],\n    connections: [\n      { from: 'web', to: 'api', label: 'HTTPS' }\n    ]\n  }\n}\n```\n\n#### `stat-group`\n\n```typescript\n{\n  type: 'stat-group',\n  title: 'Status Overview',\n  value: [\n    { label: 'Passed', value: '42', color: 'green' },\n    { label: 'Failed', value: '3', color: 'red' },\n    { label: 'Pending', value: '7', color: 'yellow' },\n  ],\n}\n```\n\n#### `alert`\n\n```typescript\n{\n  type: 'alert',\n  title: 'Critical Path — Complete',\n  value: 'All delivery stages are wired end-to-end.',\n  tone: 'success',\n}\n```\n\n#### `docs-browser`\n\n```typescript\n{\n  type: 'docs-browser',\n  value: {\n    title: 'Project Docs',\n    files: [\n      { path: 'docs/README.md', title: 'Overview', status: 'current' },\n      { path: 'docs/api.md', title: 'API Reference', status: 'stale' },\n    ],\n  },\n}\n```",docs:"| Type | Description | Value Shape |\n|------|-------------|-------------|\n| `markdown` | Markdown content rendered with the marked parser. | `string` |\n| `code` | Formatted code block rendered inside pre/code tags. | `string` |\n| `mermaid` | Mermaid diagram source rendered in a mermaid pre block. | `string` |\n| `workflow-diagram` | Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering. | `object ({ lanes, nodes, edges })` |\n| `sequence-diagram` | Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering. | `object ({ participants, messages })` |\n| `lifecycle-diagram` | Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering. | `object ({ lanes, states, transitions })` |\n| `table` | Tabular data rendered from records or explicit headers and rows. | `Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }` |\n| `cards` | Card grid for titled items with optional body, badge, and status. | `Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>` |\n| `docs-browser` | Documentation file list with inline content previews for chat-safe rendering. | `{ files: Array<{ path: string; title?: string; content?: string; status?: \"current\" | \"stale\" | \"missing\" }>; title?: string }` |\n\n### Usage Examples\n\n#### `docs-browser`\n\n```typescript\n{\n  type: 'docs-browser',\n  value: {\n    title: 'Project Docs',\n    files: [\n      { path: 'docs/README.md', title: 'Overview', status: 'current' },\n      { path: 'docs/api.md', title: 'API Reference', status: 'stale' },\n    ],\n  },\n}\n```","c4-architecture":`| Type | Description | Value Shape |
 |------|-------------|-------------|
 | \`mermaid\` | Mermaid diagram source rendered in a mermaid pre block. | \`string\` |
 | \`architecture-diagram\` | Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering. | \`object ({ components, connections, boundaries? })\` |
@@ -79,4 +81,4 @@ const e="| Type | Description | Value Shape |\n|------|-------------|-----------
     ]
   }
 }
-\`\`\``};export{e as ALL_BLOCK_DOCS,n as BLOCK_DOCS_BY_SKILL,t as BLOCK_TYPE_LIST};
+\`\`\``};export{e as ALL_BLOCK_DOCS,n as BLOCK_CATALOG,r as BLOCK_DOCS_BY_SKILL,t as BLOCK_TYPE_LIST};

package/scaffold/general/hooks/scripts/session-reminder.mjs

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 /**
- * session-reminder — SessionStart hook that injects AI Kit protocol
- * essentials at every session start.
+ * session-reminder — SessionStart hook that injects the orchestrator
+ * skill protocol at every session start.
  *
- * Reads the aikit skill SKILL.md and strips YAML frontmatter to extract
- * actionable tool judgment and session protocol instructions.
+ * Reads ~/.claude/skills/orchestrator/SKILL.md, strips YAML frontmatter,
+ * and injects the "Delegate, never implement" protocol as additionalContext.
  * Falls back to inline essentials if skill file is unavailable.
  *
- * Unlike CLAUDE.md (which the model can downrank for being too long),
- * this hook's additionalContext is injected fresh into every session
- * right before the first user message — harder for the model to skip.
+ * The orchestrator agent file already references the aikit skill — this
+ * hook reinforces the orchestrator-specific delegation protocol that the
+ * model is most likely to skip.
  *
  * @category signal
  * @event SessionStart
@@ -22,7 +22,7 @@ import { createHook } from './_runtime.mjs';
 
 createHook(
   () => {
-    const skillPath = resolve(homedir(), '.claude', 'skills', 'aikit', 'SKILL.md');
+    const skillPath = resolve(homedir(), '.claude', 'skills', 'orchestrator', 'SKILL.md');
     let extracted = '';
 
     try {
@@ -37,32 +37,27 @@ createHook(
     const content =
       extracted ||
       [
-        '## AI Kit Protocol',
+        '# Orchestrator Protocol — MANDATORY',
         '',
-        '**Tool rules:**',
-        '- `mcp__aikit__search/find` over Bash grep',
-        '- `mcp__aikit__file_summary({ tier: "T1" })` over Read for understanding',
-        '- `mcp__aikit__check` over Bash for tsc/lint',
-        '- `mcp__aikit__test_run` over Bash for tests',
-        '- `mcp__aikit__symbol/trace` over manual code tracing',
-        '- `mcp__aikit__knowledge` for cross-session memory',
-        '- `mcp__aikit__digest` over multiple Reads',
-        'Raw Read only for exact lines before Edit.',
+        'YOU MUST FOLLOW THIS PROTOCOL ON EVERY TASK. You are an orchestrator, not an implementer.',
         '',
-        '**Session start:**',
-        '- `flow({ action: "status" })` — check active flow first',
-        '- `status({ includePrelude: true })` → onboard if missing',
-        '- `search({ query: "SESSION CHECKPOINT" })` before planning',
+        '**RULE 1 — Decompose everything.** Every task gets a TODO list in your first response. Break it into independent, parallelizable subtasks.',
         '',
-        '**Session end:**',
-        '- `mcp__aikit__reindex` → `mcp__aikit__produce_knowledge`',
-        '- `mcp__aikit__knowledge({ action: "remember", category: "session" })`',
+        '**RULE 2 — Delegate, never implement.** For every subtask, spawn a sub-agent. If you catch yourself about to edit a file directly, STOP. Spawn a sub-agent.',
         '',
-        '**Default agent:** orchestrator (set in ~/.claude/settings.json)',
-        '**Agents at:** ~/.claude/agents/',
+        '**RULE 3 — Wait and synthesize.** After all sub-agents complete, consolidate their outputs. Only then deliver the final result to the user.',
+        '',
+        '**RULE 4 — No direct coding.** You NEVER write, edit, or create files yourself. That is sub-agent work.',
+        '',
+        '**RULE 5 — Parallel fan-out.** Subtasks without data dependencies MUST run in parallel.',
+        '',
+        '**RULE 6 — Full cycle per phase.** Each phase (Plan → Implement → Review → Verify) gets its own delegation cycle.',
+        '',
+        '**Exceptions (ONLY these):** ≤5 lines trivial, fixing sub-agent output, no sub-agent available.',
+        'When in doubt, delegate. When unsure, spawn an extra sub-agent.',
       ].join('\n');
 
-    return { additionalContext: `── AI Kit Protocol ──\n${content}` };
+    return { additionalContext: `── Orchestrator Protocol ──\n${content}` };
   },
   { event: 'SessionStart' },
 );

package/packages/server/dist/prelude-BgvW6Hp5.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{n as e,t}from"./server-DUWF6mtP.js";export{t as buildPreludeInjection,e as generatePrelude};

package/packages/server/dist/prelude-Di-ZDdDk.js

@@ -1 +0,0 @@
-import{n as e,t}from"./server-Bsceh-AT.js";export{t as buildPreludeInjection,e as generatePrelude};

package/packages/server/dist/sampling-CFWUnzbA.js

@@ -1 +0,0 @@
-import{r as e}from"./server-Bsceh-AT.js";export{e as createSamplingClient};

package/packages/server/dist/sampling-lcC_v6KY.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{r as e}from"./server-DUWF6mtP.js";export{e as createSamplingClient};