@jaimevalasek/aioson 1.3.0

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

@@ -0,0 +1,172 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://aiosforge.dev/schemas/squad-blueprint.schema.json",
+  "title": "AIOSON Squad Blueprint",
+  "description": "Schema para blueprints intermediários de design de squad",
+  "type": "object",
+  "required": ["id", "slug", "name", "problem", "goal", "mode"],
+  "properties": {
+    "id": { "type": "string", "description": "UUID do blueprint" },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$",
+      "minLength": 2,
+      "maxLength": 50
+    },
+    "name": { "type": "string", "maxLength": 100 },
+    "problem": { "type": "string", "description": "Problema principal" },
+    "goal": { "type": "string", "description": "Objetivo prático" },
+    "scope": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "O que está dentro do escopo"
+    },
+    "outOfScope": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "O que está explicitamente fora"
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["content", "software", "research", "mixed"]
+    },
+    "domain": { "type": "string" },
+    "executors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug", "role"],
+        "properties": {
+          "slug": { "type": "string" },
+          "title": { "type": "string" },
+          "role": { "type": "string" },
+          "focus": { "type": "array", "items": { "type": "string" } },
+          "skills": { "type": "array", "items": { "type": "string" } },
+          "genomes": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                { "type": "string" },
+                {
+                  "type": "object",
+                  "required": ["slug"],
+                  "properties": {
+                    "slug": { "type": "string" },
+                    "type": { "type": "string" },
+                    "mode": { "type": "string" },
+                    "source": { "type": "string" },
+                    "priority": { "type": "integer" },
+                    "version": { "type": "string" },
+                    "evidenceMode": { "type": "string" },
+                    "notes": { "type": "string" }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "slug": { "type": "string" },
+          "title": { "type": "string" },
+          "description": { "type": "string" },
+          "source": { "type": "string", "enum": ["local", "inherited", "catalog"] }
+        }
+      }
+    },
+    "mcps": { "type": "array", "items": { "type": "object" } },
+    "genomes": { "type": "array", "items": { "type": "object" } },
+    "genomeBindings": {
+      "type": "object",
+      "properties": {
+        "squad": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              {
+                "type": "object",
+                "required": ["slug"],
+                "properties": {
+                  "slug": { "type": "string" },
+                  "type": { "type": "string" },
+                  "mode": { "type": "string" },
+                  "source": { "type": "string" },
+                  "priority": { "type": "integer" },
+                  "version": { "type": "string" },
+                  "evidenceMode": { "type": "string" },
+                  "notes": { "type": "string" }
+                }
+              }
+            ]
+          }
+        },
+        "executors": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                { "type": "string" },
+                {
+                  "type": "object",
+                  "required": ["slug"],
+                  "properties": {
+                    "slug": { "type": "string" },
+                    "type": { "type": "string" },
+                    "mode": { "type": "string" },
+                    "source": { "type": "string" },
+                    "priority": { "type": "integer" },
+                    "version": { "type": "string" },
+                    "evidenceMode": { "type": "string" },
+                    "notes": { "type": "string" }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "contentBlueprints": { "type": "array", "items": { "type": "object" } },
+    "assumptions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Suposições feitas durante o design"
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "description": { "type": "string" },
+          "probability": { "type": "string", "enum": ["low", "medium", "high"] },
+          "impact": { "type": "string", "enum": ["low", "medium", "high"] },
+          "mitigation": { "type": "string" }
+        }
+      }
+    },
+    "readiness": {
+      "type": "object",
+      "description": "Estado de prontidão (detalhado na Fase 2)"
+    },
+    "sourceDocs": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Score de confiança geral"
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "userAdjustments": { "type": "integer", "minimum": 0 }
+  },
+  "additionalProperties": true
+}

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

@@ -0,0 +1,276 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://aiosforge.dev/schemas/squad-manifest.schema.json",
+  "title": "AIOSON Squad Manifest",
+  "description": "Schema para squad.manifest.json",
+  "type": "object",
+  "required": ["schemaVersion", "slug", "name", "mode", "mission", "goal"],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Versão do schema (semver)"
+    },
+    "packageVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$",
+      "minLength": 2,
+      "maxLength": 50,
+      "description": "Identificador kebab-case do squad"
+    },
+    "name": {
+      "type": "string",
+      "maxLength": 100
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["content", "software", "research", "mixed"],
+      "description": "Tipo principal do squad"
+    },
+    "mission": { "type": "string", "maxLength": 500 },
+    "goal": { "type": "string", "maxLength": 500 },
+    "visibility": {
+      "type": "string",
+      "enum": ["private", "public"],
+      "default": "private"
+    },
+    "aiosLiteCompatibility": { "type": "string" },
+    "storagePolicy": {
+      "type": "object",
+      "properties": {
+        "primary": { "type": "string", "enum": ["sqlite", "file"] },
+        "artifacts": { "type": "string" },
+        "exports": {
+          "type": "object",
+          "properties": {
+            "html": { "type": "boolean" },
+            "markdown": { "type": "boolean" },
+            "json": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "package": {
+      "type": "object",
+      "properties": {
+        "rootDir": { "type": "string" },
+        "agentsDir": { "type": "string" },
+        "skillsDir": { "type": "string" },
+        "templatesDir": { "type": "string" },
+        "docsDir": { "type": "string" }
+      }
+    },
+    "rules": {
+      "type": "object",
+      "properties": {
+        "outputsDir": { "type": "string" },
+        "logsDir": { "type": "string" },
+        "mediaDir": { "type": "string" },
+        "reviewPolicy": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "executors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug", "role", "file"],
+        "properties": {
+          "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "title": { "type": "string" },
+          "role": { "type": "string" },
+          "file": { "type": "string" },
+          "skills": { "type": "array", "items": { "type": "string" } },
+          "genomes": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                { "type": "string" },
+                {
+                  "type": "object",
+                  "required": ["slug"],
+                  "properties": {
+                    "slug": { "type": "string" },
+                    "type": { "type": "string" },
+                    "mode": { "type": "string" },
+                    "source": { "type": "string" },
+                    "priority": { "type": "integer" },
+                    "version": { "type": "string" },
+                    "evidenceMode": { "type": "string" },
+                    "notes": { "type": "string" }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug"],
+        "properties": {
+          "slug": { "type": "string" },
+          "title": { "type": "string" },
+          "description": { "type": "string" }
+        }
+      }
+    },
+    "mcps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug"],
+        "properties": {
+          "slug": { "type": "string" },
+          "required": { "type": "boolean" },
+          "purpose": { "type": "string" }
+        }
+      }
+    },
+    "subagents": {
+      "type": "object",
+      "properties": {
+        "allowed": { "type": "boolean" },
+        "when": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "genomes": {
+      "oneOf": [
+        {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              { "type": "object" }
+            ]
+          }
+        },
+        {
+          "type": "object",
+          "properties": {
+            "squad": {
+              "type": "array",
+              "items": {
+                "oneOf": [
+                  { "type": "string" },
+                  {
+                    "type": "object",
+                    "required": ["slug"],
+                    "properties": {
+                      "slug": { "type": "string" },
+                      "type": { "type": "string" },
+                      "mode": { "type": "string" },
+                      "source": { "type": "string" },
+                      "priority": { "type": "integer" },
+                      "version": { "type": "string" },
+                      "evidenceMode": { "type": "string" },
+                      "notes": { "type": "string" }
+                    }
+                  }
+                ]
+              }
+            },
+            "executors": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "oneOf": [
+                    { "type": "string" },
+                    {
+                      "type": "object",
+                      "required": ["slug"],
+                      "properties": {
+                        "slug": { "type": "string" },
+                        "type": { "type": "string" },
+                        "mode": { "type": "string" },
+                        "source": { "type": "string" },
+                        "priority": { "type": "integer" },
+                        "version": { "type": "string" },
+                        "evidenceMode": { "type": "string" },
+                        "notes": { "type": "string" }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "contentBlueprints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug", "contentType", "layoutType"],
+        "properties": {
+          "slug": { "type": "string" },
+          "contentType": { "type": "string" },
+          "layoutType": {
+            "type": "string",
+            "enum": ["document", "tabs", "accordion", "stack", "mixed"]
+          },
+          "description": { "type": "string" },
+          "sections": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["key", "label"],
+              "properties": {
+                "key": { "type": "string" },
+                "label": { "type": "string" },
+                "blockTypes": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "ports": {
+    "type": "object",
+    "description": "Declaração de inputs e outputs para conexão inter-squad",
+    "properties": {
+      "inputs": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": ["key"],
+          "properties": {
+            "key": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+            "dataType": { "type": "string", "enum": ["text", "json", "file", "file-list", "any"], "default": "any" },
+            "description": { "type": "string" },
+            "required": { "type": "boolean", "default": false }
+          }
+        }
+      },
+      "outputs": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": ["key"],
+          "properties": {
+            "key": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+            "dataType": { "type": "string", "enum": ["text", "json", "file", "file-list", "any"], "default": "any" },
+            "description": { "type": "string" },
+            "contentBlueprintSlug": { "type": "string" }
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/template/.aioson/skills/dynamic/README.md

@@ -0,0 +1,30 @@
+# Dynamic Skills
+
+Files in this folder are **live-reference stubs** — they tell the agent where and how to fetch current documentation rather than embedding static (potentially stale) content.
+
+## Pattern
+
+When an agent reads a file here, it receives:
+1. What this skill covers
+2. Which MCP tool or URL to fetch from
+3. What to look for (focus area)
+
+The agent then fetches the current docs at runtime, preventing outdated patterns in generated code.
+
+## When to use these vs static skills
+
+| Situation | Use |
+|---|---|
+| Framework conventions, project structure, best practices | `skills/static/` |
+| Current API signatures, latest package versions, changelog entries | `skills/dynamic/` (this folder) |
+
+## Available dynamic skills
+
+| File | Covers | Source |
+|---|---|---|
+| `laravel-docs.md` | Current Laravel syntax, helpers, Eloquent methods | laravel.com/docs |
+| `ethereum-docs.md` | EVM tooling, Solidity compiler notes, library changes | docs.soliditylang.org |
+| `solana-docs.md` | Anchor account model, SDK changes | docs.solana.com |
+| `cardano-docs.md` | UTXO/validator patterns, off-chain SDK | docs.cardano.org |
+| `flux-ui-docs.md` | Flux UI component APIs | fluxui.dev/docs |
+| `npm-packages.md` | Package compatibility, version stability | npmjs.com |

package/template/.aioson/skills/dynamic/cardano-docs.md

@@ -0,0 +1,16 @@
+# Dynamic Skill: Cardano Docs
+
+Use MCP or official Cardano references to verify UTXO/validator patterns, off-chain SDK details, and network-specific release constraints before implementation.
+
+**Fetch from:**
+- Cardano Docs: https://docs.cardano.org
+- Aiken: https://aiken-lang.org/
+- Lucid: https://lucid.spacebudz.io/docs/
+
+**Focus areas:**
+- eUTXO model constraints (datum, redeemer, script context)
+- Current Aiken syntax (evolving fast — always verify)
+- Lucid API version compatibility
+- Network-specific epoch parameters
+
+**MCP tool example:** `mcp_fetch url="https://aiken-lang.org/language-tour/validators" topic="validator types"`

package/template/.aioson/skills/dynamic/ethereum-docs.md

@@ -0,0 +1,17 @@
+# Dynamic Skill: Ethereum Docs
+
+Use MCP or official sources to validate current EVM tooling, Solidity compiler notes, and client library changes before implementing or reviewing code.
+
+**Fetch from:**
+- Solidity: https://docs.soliditylang.org/en/latest/
+- Ethers.js v6: https://docs.ethers.org/v6/
+- Hardhat: https://hardhat.org/docs
+- OpenZeppelin: https://docs.openzeppelin.com/contracts/
+
+**Focus areas:**
+- Solidity version-specific syntax (custom errors, named return values, etc.)
+- ABI encoding edge cases
+- Gas optimization patterns (SSTORE vs SLOAD costs)
+- Current OpenZeppelin contract versions and breaking changes
+
+**MCP tool example:** `mcp_fetch url="https://docs.soliditylang.org/en/latest/control-structures.html" topic="error handling"`

package/template/.aioson/skills/dynamic/flux-ui-docs.md

@@ -0,0 +1,13 @@
+# Dynamic Skill: Flux UI Docs
+
+Use MCP documentation tools to confirm current Flux UI component APIs and best practices before implementation.
+
+**Fetch from:** https://fluxui.dev/docs
+
+**Focus areas:**
+- Component prop signatures (frequently updated)
+- Dark mode token conventions
+- Form components with validation integration
+- Breaking changes between Flux versions
+
+**MCP tool example:** `mcp_fetch url="https://fluxui.dev/docs/button" topic="variants"`

package/template/.aioson/skills/dynamic/laravel-docs.md

@@ -0,0 +1,41 @@
+# Dynamic Skill: Laravel Docs
+
+Use MCP documentation tools or fetch directly from the official docs to get current Laravel references before suggesting syntax or patterns.
+
+---
+
+## Installation paths
+
+Before scaffolding a Laravel project, confirm which installation path was used — each ships different defaults:
+
+| Path | URL | What it includes |
+|---|---|---|
+| **Standard (Herd / Installer)** | https://laravel.com/docs/12.x/installation | Bare Laravel, no auth scaffolding. Add Breeze/Jetstream manually. |
+| **Sail (Docker)** | https://laravel.com/docs/10.x/installation#choosing-your-sail-services | Chooses services (MySQL, Redis, Meilisearch…) at creation. Works on all versions. |
+| **Jetstream + Livewire** | https://jetstream.laravel.com/installation.html | Full auth (login, register, 2FA, teams, API tokens) + Livewire already installed. ⚠️ Must be chosen at project creation — late install is risky. |
+
+**Jetstream detection signals:** presence of `laravel/jetstream` in `composer.json`, `app/Livewire/` folder, `resources/views/livewire/` folder, `JetstreamServiceProvider`.
+
+**Sail detection signals:** `docker-compose.yml` in project root, `vendor/laravel/sail` in composer.
+
+---
+
+## Fetch targets
+
+**Fetch from:** https://laravel.com/docs (latest version)
+
+**Focus areas:**
+- Eloquent method signatures (especially new helpers added per version)
+- Artisan command options
+- Service container bindings
+- Vite asset bundling changes
+- Breaking changes in the current major version
+- Livewire v3 component lifecycle (if Jetstream detected)
+
+**MCP tool examples:**
+```
+mcp_fetch url="https://laravel.com/docs/eloquent" topic="relationships"
+mcp_fetch url="https://laravel.com/docs/12.x/installation" topic="herd quick start"
+mcp_fetch url="https://jetstream.laravel.com/installation.html" topic="livewire stack"
+mcp_fetch url="https://livewire.laravel.com/docs/components" topic="lifecycle hooks"
+```

package/template/.aioson/skills/dynamic/npm-packages.md

@@ -0,0 +1,16 @@
+# Dynamic Skill: npm Packages
+
+Use trusted package metadata and changelogs to verify compatibility, version stability, and maintenance status before adding a dependency.
+
+**Fetch from:**
+- Registry: https://registry.npmjs.org/{package-name}
+- Changelog: https://github.com/{owner}/{repo}/blob/main/CHANGELOG.md
+
+**What to verify:**
+- Weekly downloads (>10k/week = safe; <1k = risk)
+- Last publish date (>1 year without update = maintenance risk)
+- Open issues / CVEs (check https://snyk.io/vuln/)
+- Peer dependency constraints (avoid major version conflicts)
+- Bundle size: https://bundlephobia.com/package/{name}
+
+**MCP tool example:** `mcp_fetch url="https://registry.npmjs.org/zod" topic="latest version and peer deps"`

package/template/.aioson/skills/dynamic/solana-docs.md

@@ -0,0 +1,16 @@
+# Dynamic Skill: Solana Docs
+
+Use MCP or official Solana/Anchor references to confirm current account model constraints, program patterns, and SDK changes before coding.
+
+**Fetch from:**
+- Solana: https://docs.solana.com
+- Anchor: https://www.anchor-lang.com/docs
+- Solana Web3.js v2: https://solana-labs.github.io/solana-web3.js/
+
+**Focus areas:**
+- Anchor IDL changes across versions
+- Account discriminator constraints
+- PDA derivation patterns
+- Current @solana/web3.js v2 API (breaking from v1)
+
+**MCP tool example:** `mcp_fetch url="https://www.anchor-lang.com/docs/pdas" topic="PDA derivation"`