@jaimevalasek/aioson 1.3.0 → 1.5.1

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,122 @@
       "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" }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "modelTier": {
+            "type": "string",
+            "enum": ["powerful", "balanced", "fast", "none"],
+            "default": "balanced",
+            "description": "Model tier for this executor. powerful: best model (Opus/o3). balanced: good model (Sonnet/GPT-4o). fast: cheap model (Haiku/Flash). none: no LLM (workers)."
+          },
+          "tasks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["slug", "title", "order"],
+              "properties": {
+                "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+                "title": { "type": "string" },
+                "order": { "type": "integer", "minimum": 1 },
+                "file": { "type": "string", "description": "Path to the task .md file" },
+                "input": { "type": "string", "description": "What this task receives" },
+                "output": { "type": "string", "description": "What this task produces" }
+              }
+            },
+            "description": "Granular tasks within this executor, executed in order"
+          },
+          "formats": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Format slugs from the format catalog that this executor uses"
+          },
           "skills": { "type": "array", "items": { "type": "string" } },
           "genomes": {
             "type": "array",
@@ -208,6 +330,249 @@
         }
       ]
     },
+    "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" },
+                "review": {
+                  "type": "object",
+                  "properties": {
+                    "reviewer": {
+                      "type": "string",
+                      "description": "Executor slug that reviews this phase's output"
+                    },
+                    "criteria": {
+                      "type": "array",
+                      "items": { "type": "string" },
+                      "description": "What the reviewer checks"
+                    },
+                    "onReject": {
+                      "type": "string",
+                      "description": "Phase ID to return to on rejection"
+                    },
+                    "maxRetries": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 5,
+                      "default": 2,
+                      "description": "Max rejection cycles before escalation"
+                    },
+                    "retryStrategy": {
+                      "type": "string",
+                      "enum": ["feedback", "fresh", "alternative"],
+                      "default": "feedback",
+                      "description": "feedback: send rejection reason back. fresh: restart from scratch. alternative: ask a different executor."
+                    },
+                    "escalateOnMaxRetries": {
+                      "type": "string",
+                      "enum": ["human", "skip", "fail"],
+                      "default": "human",
+                      "description": "What to do when maxRetries exceeded"
+                    }
+                  }
+                },
+                "vetoConditions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["condition", "action"],
+                    "properties": {
+                      "condition": {
+                        "type": "string",
+                        "description": "Natural language condition to check"
+                      },
+                      "action": {
+                        "type": "string",
+                        "enum": ["reject", "block", "warn"],
+                        "description": "reject: auto-retry. block: stop pipeline. warn: continue with warning."
+                      },
+                      "message": {
+                        "type": "string",
+                        "description": "Message to show when condition is triggered"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "contextMonitor": {
+      "type": "object",
+      "description": "Context window monitoring configuration (Fase 1 — PRD 19.2 §3.1)",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable context window monitoring for this squad"
+        },
+        "windowSize": {
+          "type": "integer",
+          "minimum": 1000,
+          "description": "Override context window size in tokens (default: inferred from model tier)"
+        },
+        "thresholds": {
+          "type": "object",
+          "description": "Warning level thresholds as ratios (0–1)",
+          "properties": {
+            "warning":  { "type": "number", "minimum": 0, "maximum": 1, "default": 0.85 },
+            "critical": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.95 }
+          }
+        },
+        "notify": {
+          "type": "object",
+          "description": "Which events trigger notifications",
+          "properties": {
+            "contextWarning":  { "type": "boolean", "default": true,  "description": "Notify at warning threshold (default 85%)" },
+            "contextCritical": { "type": "boolean", "default": true,  "description": "Notify at critical threshold (default 95%)" }
+          }
+        }
+      }
+    },
+    "isolation": {
+      "type": "object",
+      "description": "Execution isolation strategy for agent branches (Fase 2 — PRD 19.2 §3.5)",
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "enum": ["worktree", "branch-only", "shared"],
+          "default": "shared",
+          "description": "worktree: separate git worktree per agent. branch-only: create branch but no worktree. shared: no isolation."
+        },
+        "branchPrefix": {
+          "type": "string",
+          "default": "aioson",
+          "description": "Prefix for auto-created branches: {prefix}/{squadSlug}/{agentSlug}"
+        },
+        "autoMerge": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically fast-forward merge when agent task completes"
+        },
+        "cleanupOnComplete": {
+          "type": "boolean",
+          "default": true,
+          "description": "Remove worktree/branch after successful merge"
+        }
+      }
+    },
+    "recovery": {
+      "type": "object",
+      "description": "Context recovery configuration after a compact event (Fase 3 — PRD 19.2 §3.6)",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable automatic recovery-context.md generation"
+        },
+        "autoInject": {
+          "type": "boolean",
+          "default": true,
+          "description": "Automatically inject recovery-context.md when a compact is detected (>30% drop in context)"
+        },
+        "maxTokens": {
+          "type": "integer",
+          "minimum": 500,
+          "maximum": 4000,
+          "default": 2000,
+          "description": "Maximum token budget for the generated recovery-context.md"
+        },
+        "refreshOn": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["task_completed", "decision_made", "handoff"]
+          },
+          "default": ["task_completed", "decision_made", "handoff"],
+          "description": "Runtime event types that trigger an automatic recovery context refresh"
+        }
+      }
+    },
     "contentBlueprints": {
       "type": "array",
       "items": {
@@ -240,6 +605,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",