@jaimevalasek/aioson 1.3.0 → 1.4.0

package/template/.aioson/schemas/squad-manifest.schema.json

@@ -38,6 +38,15 @@
       "enum": ["private", "public"],
       "default": "private"
     },
+    "ephemeral": {
+      "type": "boolean",
+      "default": false,
+      "description": "Temporary squad — created ad-hoc for a one-off task, no persistence. Auto-cleaned after session ends."
+    },
+    "ttl": {
+      "type": "string",
+      "description": "Time-to-live for ephemeral squads (e.g. '24h', '7d'). After TTL, squad files are eligible for cleanup."
+    },
     "aiosLiteCompatibility": { "type": "string" },
     "storagePolicy": {
       "type": "object",
@@ -59,6 +68,9 @@
       "properties": {
         "rootDir": { "type": "string" },
         "agentsDir": { "type": "string" },
+        "workersDir": { "type": "string", "description": "Directory for deterministic worker scripts (no LLM)" },
+        "workflowsDir": { "type": "string", "description": "Directory for workflow .md files with phases and handoffs" },
+        "checklistsDir": { "type": "string", "description": "Directory for quality checklist .md files" },
         "skillsDir": { "type": "string" },
         "templatesDir": { "type": "string" },
         "docsDir": { "type": "string" }
@@ -80,12 +92,95 @@
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["slug", "role", "file"],
+        "required": ["slug", "role"],
         "properties": {
           "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
           "title": { "type": "string" },
+          "type": {
+            "type": "string",
+            "enum": ["worker", "agent", "clone", "assistant", "human-gate"],
+            "default": "agent",
+            "description": "Executor type: worker (deterministic script, no LLM), agent (LLM with defined role), clone (cognitive replica of real person), assistant (domain specialist with behavioral profile), human-gate (human approval checkpoint)"
+          },
           "role": { "type": "string" },
           "file": { "type": "string" },
+          "deterministic": {
+            "type": "boolean",
+            "description": "Whether the executor always produces the same output for the same input"
+          },
+          "usesLLM": {
+            "type": "boolean",
+            "description": "Whether the executor uses an LLM (false = zero LLM cost)"
+          },
+          "runtime": {
+            "type": "string",
+            "enum": ["python", "bash", "node", "other"],
+            "description": "Runtime for worker executors"
+          },
+          "entrypoint": {
+            "type": "string",
+            "description": "Script path for worker executors"
+          },
+          "domain": {
+            "type": "string",
+            "description": "Specialized domain for assistant executors"
+          },
+          "behavioralProfile": {
+            "type": "string",
+            "enum": [
+              "dominant-driver",
+              "influential-expressive",
+              "steady-amiable",
+              "compliant-analytical",
+              "dominant-influential",
+              "influential-steady",
+              "steady-compliant",
+              "compliant-dominant"
+            ],
+            "description": "DISC-based behavioral profile for assistant executors. Primary-secondary pattern: D=results-driven, I=people-oriented, S=stability-focused, C=precision-oriented"
+          },
+          "genomeSource": {
+            "type": "string",
+            "description": "Path to genome file for clone executors"
+          },
+          "fidelityScore": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Cognitive fidelity score for clone executors (0-1)"
+          },
+          "personReal": {
+            "type": "boolean",
+            "description": "Whether the clone is based on a real person"
+          },
+          "trigger": {
+            "type": "string",
+            "description": "Condition that activates a human-gate executor"
+          },
+          "escalation": {
+            "type": "object",
+            "description": "Graduated escalation rules for human-gate executors",
+            "properties": {
+              "rules": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "condition": { "type": "string" },
+                    "action": {
+                      "type": "string",
+                      "enum": ["auto", "consult", "approve", "block"]
+                    },
+                    "consultAgent": { "type": "string" },
+                    "notifyVia": {
+                      "type": "array",
+                      "items": { "type": "string" }
+                    }
+                  }
+                }
+              }
+            }
+          },
           "skills": { "type": "array", "items": { "type": "string" } },
           "genomes": {
             "type": "array",
@@ -208,6 +303,99 @@
         }
       ]
     },
+    "checklists": {
+      "type": "array",
+      "description": "Quality checklists for post-execution validation",
+      "items": {
+        "type": "object",
+        "required": ["slug", "file"],
+        "properties": {
+          "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "title": { "type": "string" },
+          "file": { "type": "string", "description": "Path to the checklist .md file" },
+          "scope": {
+            "type": "string",
+            "enum": ["squad", "workflow", "phase", "executor"],
+            "default": "squad",
+            "description": "When this checklist applies"
+          },
+          "appliesTo": {
+            "type": "string",
+            "description": "Slug of the workflow, phase, or executor this checklist validates"
+          }
+        }
+      }
+    },
+    "workflows": {
+      "type": "array",
+      "description": "Pipelines with phases, executors, handoffs, and execution modes",
+      "items": {
+        "type": "object",
+        "required": ["slug", "title"],
+        "properties": {
+          "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "title": { "type": "string" },
+          "trigger": { "type": "string", "description": "Condition or user action that starts this workflow" },
+          "executionMode": {
+            "type": "string",
+            "enum": ["sequential", "parallel", "mixed"],
+            "default": "sequential",
+            "description": "How phases run: sequential (each waits for previous), parallel (all at once), mixed (phases declare their own mode)"
+          },
+          "estimatedDuration": { "type": "string", "description": "Human-readable estimate, e.g. '30-60min'" },
+          "file": { "type": "string", "description": "Path to the workflow .md file" },
+          "phases": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["id", "title", "executor"],
+              "properties": {
+                "id": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+                "title": { "type": "string" },
+                "executor": {
+                  "oneOf": [
+                    { "type": "string" },
+                    { "type": "array", "items": { "type": "string" } }
+                  ],
+                  "description": "Executor slug(s) responsible for this phase"
+                },
+                "executorType": {
+                  "type": "string",
+                  "enum": ["worker", "agent", "clone", "assistant", "human-gate"]
+                },
+                "dependsOn": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "description": "Phase IDs that must complete before this phase starts"
+                },
+                "parallel": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Whether this phase can run in parallel with siblings"
+                },
+                "input": { "type": "string", "description": "Expected input description or source" },
+                "output": { "type": "string", "description": "Expected output artifact or description" },
+                "humanGate": {
+                  "type": "object",
+                  "description": "Optional human approval checkpoint within this phase",
+                  "properties": {
+                    "condition": { "type": "string", "description": "Expression that triggers the gate" },
+                    "action": {
+                      "type": "string",
+                      "enum": ["auto", "consult", "approve", "block"]
+                    },
+                    "consultAgent": { "type": "string" },
+                    "notifyVia": { "type": "array", "items": { "type": "string" } },
+                    "reason": { "type": "string" }
+                  }
+                },
+                "checklist": { "type": "string", "description": "Path to quality checklist for this phase" }
+              }
+            }
+          }
+        }
+      }
+    },
     "contentBlueprints": {
       "type": "array",
       "items": {
@@ -240,6 +428,74 @@
       }
     }
   },
+  "outputStrategy": {
+    "type": "object",
+    "description": "How the squad routes, stores and delivers its outputs",
+    "properties": {
+      "mode": {
+        "type": "string",
+        "enum": ["files", "sqlite", "hybrid"],
+        "default": "hybrid",
+        "description": "Primary output strategy: files (physical output only), sqlite (database only), hybrid (both)"
+      },
+      "fileOutput": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "dir": { "type": "string", "description": "Output directory path" },
+          "formats": {
+            "type": "array",
+            "items": { "type": "string", "enum": ["html", "md", "json", "pdf", "csv"] },
+            "description": "Enabled export formats"
+          }
+        }
+      },
+      "dataOutput": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "storage": { "type": "string", "enum": ["sqlite"], "default": "sqlite" },
+          "table": { "type": "string", "default": "content_items" },
+          "contentItems": { "type": "boolean", "default": true, "description": "Use the content_items model for structured data" }
+        }
+      },
+      "delivery": {
+        "type": "object",
+        "properties": {
+          "webhooks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["slug", "trigger"],
+              "properties": {
+                "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+                "url": { "type": "string", "description": "Webhook URL or {{ENV:VAR}} placeholder" },
+                "trigger": {
+                  "type": "string",
+                  "enum": ["on-publish", "on-create", "manual"],
+                  "default": "on-publish",
+                  "description": "When to fire the webhook"
+                },
+                "format": {
+                  "type": "string",
+                  "enum": ["json", "form-data"],
+                  "default": "json"
+                },
+                "headers": {
+                  "type": "object",
+                  "additionalProperties": { "type": "string" },
+                  "description": "Custom headers (supports {{ENV:VAR}} placeholders)"
+                },
+                "worker": { "type": "string", "description": "Path to delivery worker script" }
+              }
+            }
+          },
+          "cloudPublish": { "type": "boolean", "default": false, "description": "Publish to aioson.com cloud" },
+          "autoPublish": { "type": "boolean", "default": false, "description": "Auto-publish on content creation (opt-in)" }
+        }
+      }
+    }
+  },
   "ports": {
     "type": "object",
     "description": "Declaração de inputs e outputs para conexão inter-squad",

package/template/.aioson/skills/design/cognitive-core-ui/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: cognitive-core-ui
+description: Cognitive Core UI is the visual identity system for premium, command-center-style interfaces inspired by the Mentes Sintéticas platform. Use it when `design_skill: cognitive-core-ui` is set in project.context.md OR when the user explicitly asks for "cognitive core", "mentes sintéticas layout", "cognitive core style", "aquele layout escuro", "dark dashboard command center", or similar. Supports dashboards, admin panels, detail/profile pages, landing pages, and websites — all with dark (default) and light themes via a single toggle. Do NOT use this skill unless explicitly selected.
+---
+
+# Cognitive Core UI
+
+The Cognitive Core system sits at the intersection of **military-grade data dashboard** and **refined SaaS UI** — dense, structured, and polished. This is the visual identity of the Mentes Sintéticas platform.
+
+**This is one visual system.** Never combine it with another design skill.
+
+## Package structure
+
+```text
+.aioson/skills/design/cognitive-core-ui/
+  SKILL.md                      ← you are here (load this first)
+  references/
+    design-tokens.md            ← CSS variables dark + light, typography, token scope guardrails
+    components.md               ← All reusable components (nav, stat card, badges, table, modal, DNA panel, etc.)
+    patterns.md                 ← Page layouts: dashboard shell, detail/profile, settings, auth, list-detail
+    dashboards.md               ← Dashboard presets: inventory, control center, analytics, ops cockpit, CRM
+    websites.md                 ← Landing page, frontpage, institutional layouts + anti-patterns
+    motion.md                   ← Animations: keyframes, entrance sequences, scroll reveal, loading states
+```
+
+## Activation rules
+
+- Apply this package **only** when `project.context.md` contains `design_skill: "cognitive-core-ui"` or the user explicitly chooses it.
+- If another design skill is selected, do **not** load this package.
+- Never auto-select this skill — always require explicit confirmation.
+- If no skill is set yet, the active agent must ask or confirm before applying.
+
+## Responsibility boundary
+
+This skill defines:
+- Visual direction and aesthetic DNA
+- Design tokens (colors, typography, spacing, radius, shadows)
+- Component vocabulary and anatomy
+- Page composition patterns
+- Theme switching behavior (dark/light)
+
+This skill does **not** decide:
+- Stack (React, Vue, Blade, HTML, etc.)
+- Output format (single file, multi-file, CSS modules, Tailwind, etc.)
+- Icon library choice
+- Whether a theme toggle exists in the product (the agent decides)
+
+## Loading guide
+
+Always load only what the current task needs:
+
+| Task | Load |
+|---|---|
+| Any UI work | `references/design-tokens.md` |
+| Reusable components | `references/design-tokens.md` + `references/components.md` |
+| Dashboard or admin panel | `references/design-tokens.md` + `references/components.md` + `references/patterns.md` + `references/dashboards.md` |
+| Detail / profile page | `references/design-tokens.md` + `references/components.md` + `references/patterns.md` |
+| Landing page or website | `references/design-tokens.md` + `references/components.md` + `references/websites.md` |
+| Motion / animation | add `references/motion.md` when animation materially improves the result |
+| Full UI build | all six reference files |
+
+## Visual signature — three pillars
+
+1. **Command-center authority** — Dense information when the product is operational. Monospaced uppercase labels on every section. Large numeric stat readouts. Everything feels like a mission control panel.
+2. **Premium refinement** — Three depth levels minimum (void → base → surface → elevated). Subtle borders (`rgba(255,255,255,0.06)` in dark). Teal/cyan as the only accent — used for active states, borders, glow effects. Never harsh contrasts.
+3. **Structured rhythm** — Tab navigation, sidebar trees, card grids, section headers with icons. Information is organized into labeled zones. One focal block per viewport.
+
+## Theme system
+
+```html
+<div data-theme="dark">   <!-- or data-theme="light" -->
+```
+
+- **Dark (default)**: Dashboards, monitoring, analytics, dev tools, anything data-heavy or operational
+- **Light**: Client-facing apps, content-heavy pages, e-commerce admin, institutional websites
+- **Both with toggle**: When the user asks, or when the target audience varies
+
+If the user does not specify: default to **dark with a theme toggle** in the top bar.
+
+## Visual DNA (from reference screenshots)
+
+### Colors — dark theme
+- Background void: `#060910`
+- Background base: `#0B0F15` (main app background)
+- Surface: `#111827` (cards)
+- Elevated: `#1A2332` (hover, nested)
+- Primary accent: `#22D3EE` (teal/cyan) — active tabs, badges, glow, borders
+- Text heading: `#F9FAFB`
+- Text primary: `#E5E7EB`
+- Text secondary: `#9CA3AF`
+- Text muted: `#6B7280`
+
+### Colors — light theme
+- Background void: `#F1F5F9`
+- Background base: `#F8FAFC`
+- Surface: `#FFFFFF`
+- Primary accent: `#0891B2` (deeper teal for legibility)
+- Text heading: `#0F172A`
+- Text primary: `#334155`
+
+### Typography
+- Headings: `Inter`, `weight-black (900)`, `letter-spacing: -0.02em`
+- Body: `Inter`, `weight-normal (400)`, `line-height: 1.6`
+- Labels (most distinctive): `JetBrains Mono`, `weight-semibold`, `uppercase`, `letter-spacing: 0.15em`, `font-size: 0.675rem`
+- Stats: `Inter`, `weight-bold (700)`, `font-size: 2.75rem`
+
+### Layout structure (dashboards)
+```
+┌──────────────────────────────────────────────────────────┐
+│  TOP BAR: [Logo + Name] [Tab Nav (center)] [Actions]     │
+├──────────────────────────────────────────────────────────┤
+│  [Optional: breadcrumbs]                                  │
+│  PROFILE/HEADER ZONE: avatar + name + badges + stat cards│
+├──────────────────────────────────────────────────────────┤
+│  TAB NAVIGATION (full width)                              │
+├───────────┬──────────────────────────────────────────────┤
+│ SIDEBAR   │  CONTENT                                      │
+│ 200px     │  SECTION HEADER (mono label + icon)           │
+│ tree nav  │  CARD GRID (2-4 col, auto-fill)               │
+│           │  SECTION HEADER                               │
+│           │  CARD GRID                                    │
+└───────────┴──────────────────────────────────────────────┘
+```
+
+### Signature details
+- Monospace uppercase labels on every section (never skip this)
+- Badge chips with teal/cyan glow in dark mode
+- Progress bars with colored semantic fills (green/red/amber/purple)
+- Featured quote blocks: italic large text + mono attribution
+- Cards with `1px` border + subtle hover glow (never box shadows only)
+- Active tab: teal bottom border `3px` + teal text
+- Sidebar active item: `border-left: 3px solid var(--accent)` + `bg-elevated`
+- Theme transition: `250ms ease` on background, color, border-color, box-shadow
+
+## Application rules
+
+- Treat `references/design-tokens.md` as the source of truth for ALL tokens.
+- Resolve the page variant before composing: dashboard uses dense operational rhythm; website/landing page uses more whitespace, hero typography, and narrative hierarchy.
+- Never combine this package with `interface-design`, `premium-command-center-ui`, or any other design skill in the same task.
+- Reuse the project's component library if one exists — map Cognitive Core tokens onto it instead of rebuilding primitives.
+- Adapt code examples to the active stack. Reference snippets are design specifications, not copy-paste code.
+- Accessibility, responsiveness, and production semantics are the agent's responsibility (not this skill).
+
+## Delivery modes
+
+### Greenfield
+1. Choose page variant (dashboard, detail, settings, landing, institutional)
+2. Load relevant references
+3. Apply token scope from `design-tokens.md`
+4. Compose layout from `patterns.md` or `websites.md`
+5. Build components from `components.md`
+
+### Brownfield
+1. Audit existing UI before rewriting
+2. Map Cognitive Core tokens onto the existing component library
+3. Fix token scope issues (font/color variables must be on the correct container)
+4. Prefer targeted upgrades over full rewrites unless the user asks for a redesign