aios-core 2.2.1 → 2.3.1

package/.aios-core/quality/schemas/quality-metrics.schema.json

@@ -1,233 +1,233 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://aios.dev/schemas/quality-metrics.schema.json",
-  "title": "Quality Metrics",
-  "description": "Schema for quality gate metrics data",
-  "type": "object",
-  "required": ["version", "lastUpdated", "layers", "trends", "history"],
-  "properties": {
-    "version": {
-      "type": "string",
-      "const": "1.0",
-      "description": "Schema version"
-    },
-    "lastUpdated": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Last time metrics were updated"
-    },
-    "retentionDays": {
-      "type": "integer",
-      "default": 30,
-      "minimum": 1,
-      "maximum": 365,
-      "description": "Number of days to retain history"
-    },
-    "layers": {
-      "type": "object",
-      "description": "Aggregated metrics per layer",
-      "properties": {
-        "layer1": { "$ref": "#/definitions/layerMetrics" },
-        "layer2": { "$ref": "#/definitions/layer2Metrics" },
-        "layer3": { "$ref": "#/definitions/layerMetrics" }
-      },
-      "additionalProperties": false
-    },
-    "trends": {
-      "type": "object",
-      "description": "Trend data over time",
-      "properties": {
-        "autoCatchRate": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/trendPoint" },
-          "description": "Auto-catch rate trend (Layer 2 automated detection)"
-        },
-        "passRates": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/trendPoint" },
-          "description": "Overall pass rate trend"
-        }
-      },
-      "additionalProperties": false
-    },
-    "history": {
-      "type": "array",
-      "items": { "$ref": "#/definitions/runRecord" },
-      "description": "Historical run records"
-    }
-  },
-  "definitions": {
-    "layerMetrics": {
-      "type": "object",
-      "description": "Aggregated metrics for a layer",
-      "properties": {
-        "passRate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Pass rate (0-1)"
-        },
-        "avgTimeMs": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Average execution time in milliseconds"
-        },
-        "totalRuns": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Total number of runs"
-        },
-        "lastRun": {
-          "type": ["string", "null"],
-          "description": "Timestamp of last run (null if never run)"
-        }
-      },
-      "additionalProperties": false
-    },
-    "layer2Metrics": {
-      "type": "object",
-      "description": "Extended metrics for Layer 2 (PR automation)",
-      "properties": {
-        "passRate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Pass rate (0-1)"
-        },
-        "avgTimeMs": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Average execution time in milliseconds"
-        },
-        "totalRuns": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Total number of runs"
-        },
-        "lastRun": {
-          "type": ["string", "null"],
-          "description": "Timestamp of last run (null if never run)"
-        },
-        "autoCatchRate": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Rate of issues caught automatically"
-        },
-        "coderabbit": {
-          "type": "object",
-          "description": "CodeRabbit specific metrics",
-          "properties": {
-            "active": {
-              "type": "boolean",
-              "description": "Whether CodeRabbit is active"
-            },
-            "findingsCount": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Total findings count"
-            },
-            "severityBreakdown": {
-              "type": "object",
-              "properties": {
-                "critical": { "type": "integer", "minimum": 0 },
-                "high": { "type": "integer", "minimum": 0 },
-                "medium": { "type": "integer", "minimum": 0 },
-                "low": { "type": "integer", "minimum": 0 }
-              },
-              "additionalProperties": false
-            }
-          },
-          "additionalProperties": false
-        },
-        "quinn": {
-          "type": "object",
-          "description": "Quinn (QA agent) specific metrics",
-          "properties": {
-            "findingsCount": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Total findings count"
-            },
-            "topCategories": {
-              "type": "array",
-              "items": { "type": "string" },
-              "description": "Top issue categories"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "trendPoint": {
-      "type": "object",
-      "description": "A single point in a trend",
-      "required": ["date", "value"],
-      "properties": {
-        "date": {
-          "type": "string",
-          "format": "date",
-          "description": "Date of the data point (YYYY-MM-DD)"
-        },
-        "value": {
-          "type": "number",
-          "description": "Value at this point"
-        }
-      },
-      "additionalProperties": false
-    },
-    "runRecord": {
-      "type": "object",
-      "description": "Record of a single run",
-      "required": ["timestamp", "layer", "passed"],
-      "properties": {
-        "timestamp": {
-          "type": "string",
-          "format": "date-time",
-          "description": "When the run occurred"
-        },
-        "layer": {
-          "type": "integer",
-          "enum": [1, 2, 3],
-          "description": "Which layer was run"
-        },
-        "passed": {
-          "type": "boolean",
-          "description": "Whether the run passed"
-        },
-        "durationMs": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Duration in milliseconds"
-        },
-        "findingsCount": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of findings/issues"
-        },
-        "metadata": {
-          "type": "object",
-          "description": "Additional metadata for the run",
-          "properties": {
-            "storyId": { "type": "string" },
-            "branchName": { "type": "string" },
-            "commitHash": { "type": "string" },
-            "triggeredBy": { "type": "string" },
-            "severityBreakdown": {
-              "type": "object",
-              "properties": {
-                "critical": { "type": "integer" },
-                "high": { "type": "integer" },
-                "medium": { "type": "integer" },
-                "low": { "type": "integer" }
-              }
-            }
-          },
-          "additionalProperties": true
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "additionalProperties": false
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://aios.dev/schemas/quality-metrics.schema.json",
+  "title": "Quality Metrics",
+  "description": "Schema for quality gate metrics data",
+  "type": "object",
+  "required": ["version", "lastUpdated", "layers", "trends", "history"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "1.0",
+      "description": "Schema version"
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last time metrics were updated"
+    },
+    "retentionDays": {
+      "type": "integer",
+      "default": 30,
+      "minimum": 1,
+      "maximum": 365,
+      "description": "Number of days to retain history"
+    },
+    "layers": {
+      "type": "object",
+      "description": "Aggregated metrics per layer",
+      "properties": {
+        "layer1": { "$ref": "#/definitions/layerMetrics" },
+        "layer2": { "$ref": "#/definitions/layer2Metrics" },
+        "layer3": { "$ref": "#/definitions/layerMetrics" }
+      },
+      "additionalProperties": false
+    },
+    "trends": {
+      "type": "object",
+      "description": "Trend data over time",
+      "properties": {
+        "autoCatchRate": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/trendPoint" },
+          "description": "Auto-catch rate trend (Layer 2 automated detection)"
+        },
+        "passRates": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/trendPoint" },
+          "description": "Overall pass rate trend"
+        }
+      },
+      "additionalProperties": false
+    },
+    "history": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/runRecord" },
+      "description": "Historical run records"
+    }
+  },
+  "definitions": {
+    "layerMetrics": {
+      "type": "object",
+      "description": "Aggregated metrics for a layer",
+      "properties": {
+        "passRate": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Pass rate (0-1)"
+        },
+        "avgTimeMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Average execution time in milliseconds"
+        },
+        "totalRuns": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total number of runs"
+        },
+        "lastRun": {
+          "type": ["string", "null"],
+          "description": "Timestamp of last run (null if never run)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "layer2Metrics": {
+      "type": "object",
+      "description": "Extended metrics for Layer 2 (PR automation)",
+      "properties": {
+        "passRate": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Pass rate (0-1)"
+        },
+        "avgTimeMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Average execution time in milliseconds"
+        },
+        "totalRuns": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total number of runs"
+        },
+        "lastRun": {
+          "type": ["string", "null"],
+          "description": "Timestamp of last run (null if never run)"
+        },
+        "autoCatchRate": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Rate of issues caught automatically"
+        },
+        "coderabbit": {
+          "type": "object",
+          "description": "CodeRabbit specific metrics",
+          "properties": {
+            "active": {
+              "type": "boolean",
+              "description": "Whether CodeRabbit is active"
+            },
+            "findingsCount": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Total findings count"
+            },
+            "severityBreakdown": {
+              "type": "object",
+              "properties": {
+                "critical": { "type": "integer", "minimum": 0 },
+                "high": { "type": "integer", "minimum": 0 },
+                "medium": { "type": "integer", "minimum": 0 },
+                "low": { "type": "integer", "minimum": 0 }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "quinn": {
+          "type": "object",
+          "description": "Quinn (QA agent) specific metrics",
+          "properties": {
+            "findingsCount": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Total findings count"
+            },
+            "topCategories": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Top issue categories"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "trendPoint": {
+      "type": "object",
+      "description": "A single point in a trend",
+      "required": ["date", "value"],
+      "properties": {
+        "date": {
+          "type": "string",
+          "format": "date",
+          "description": "Date of the data point (YYYY-MM-DD)"
+        },
+        "value": {
+          "type": "number",
+          "description": "Value at this point"
+        }
+      },
+      "additionalProperties": false
+    },
+    "runRecord": {
+      "type": "object",
+      "description": "Record of a single run",
+      "required": ["timestamp", "layer", "passed"],
+      "properties": {
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the run occurred"
+        },
+        "layer": {
+          "type": "integer",
+          "enum": [1, 2, 3],
+          "description": "Which layer was run"
+        },
+        "passed": {
+          "type": "boolean",
+          "description": "Whether the run passed"
+        },
+        "durationMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Duration in milliseconds"
+        },
+        "findingsCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of findings/issues"
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Additional metadata for the run",
+          "properties": {
+            "storyId": { "type": "string" },
+            "branchName": { "type": "string" },
+            "commitHash": { "type": "string" },
+            "triggeredBy": { "type": "string" },
+            "severityBreakdown": {
+              "type": "object",
+              "properties": {
+                "critical": { "type": "integer" },
+                "high": { "type": "integer" },
+                "medium": { "type": "integer" },
+                "low": { "type": "integer" }
+              }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/.aios-core/schemas/squad-schema.json

@@ -0,0 +1,185 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/SynkraAI/aios-core/schemas/squad-schema.json",
+  "title": "AIOS Squad Manifest",
+  "description": "Schema for squad.yaml manifest files (Task-First Architecture)",
+  "type": "object",
+  "required": ["name", "version"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Squad name in kebab-case (e.g., my-squad-name)",
+      "minLength": 2,
+      "maxLength": 50
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (e.g., 1.0.0)"
+    },
+    "short-title": {
+      "type": "string",
+      "maxLength": 100,
+      "description": "Short title for the squad"
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "Brief description of the squad's purpose"
+    },
+    "author": {
+      "type": "string",
+      "description": "Author name or organization"
+    },
+    "license": {
+      "type": "string",
+      "enum": ["MIT", "Apache-2.0", "ISC", "GPL-3.0", "UNLICENSED"],
+      "default": "MIT",
+      "description": "License type"
+    },
+    "slashPrefix": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Prefix for slash commands (e.g., 'etl' for /etl-*)"
+    },
+    "aios": {
+      "type": "object",
+      "properties": {
+        "minVersion": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Minimum AIOS version required"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["squad"],
+          "description": "Must be 'squad'"
+        }
+      }
+    },
+    "requires": {
+      "type": "object",
+      "description": "Runtime requirements",
+      "properties": {
+        "node": {
+          "type": "string",
+          "description": "Node.js version requirement (e.g., >=18.0.0)"
+        },
+        "aios": {
+          "type": "string",
+          "description": "AIOS version requirement (e.g., >=2.0.0)"
+        }
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Keywords for discovery"
+    },
+    "components": {
+      "type": "object",
+      "description": "Task-first: tasks are primary entry point",
+      "properties": {
+        "tasks": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of task files (primary - task-first!)"
+        },
+        "agents": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of agent definition files"
+        },
+        "workflows": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of workflow files"
+        },
+        "checklists": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of checklist files"
+        },
+        "templates": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of template files"
+        },
+        "tools": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of tool scripts"
+        },
+        "scripts": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of automation scripts"
+        }
+      }
+    },
+    "scripts": {
+      "type": "object",
+      "description": "Script definitions organized by category",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    },
+    "config": {
+      "type": "object",
+      "description": "Configuration inheritance from aios-core",
+      "properties": {
+        "extends": {
+          "type": "string",
+          "enum": ["extend", "override", "none"],
+          "default": "extend",
+          "description": "How to handle core config (extend adds rules, override replaces)"
+        },
+        "coding-standards": {
+          "type": "string",
+          "description": "Path to squad-specific coding standards (relative to squad root)"
+        },
+        "tech-stack": {
+          "type": "string",
+          "description": "Path to squad-specific tech stack doc"
+        },
+        "source-tree": {
+          "type": "string",
+          "description": "Path to squad-specific source tree doc"
+        }
+      }
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "node": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Node.js package dependencies"
+        },
+        "python": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Python package dependencies"
+        },
+        "squads": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Other squads this depends on"
+        }
+      }
+    },
+    "mcps": {
+      "type": "object",
+      "description": "MCP server configurations",
+      "additionalProperties": true
+    },
+    "integration": {
+      "type": "object",
+      "description": "Integration configurations",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}