@appsforgood/next-supabase-kit 0.2.1 → 0.4.0

package/runtime-skills/visual-regression-qa/SKILL.md

@@ -1,8 +0,0 @@
----
-name: visual-regression-qa
-description: Use for user-facing screen changes, reusable components, visual design tokens, responsive layouts, image-heavy pages, and visual acceptance.
----
-
-Canonical workflow: read `skills/visual-regression-qa.md` or `.agent-kit/skills/visual-regression-qa.md`.
-
-Name the visual QA tier, capture important states and breakpoints, handle volatile regions, and keep visual checks separate from accessibility and data-boundary tests.

package/schemas/agent-roster.schema.json

@@ -1,54 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/agent-roster.schema.json",
-  "title": "Agent Kit Agent Roster",
-  "type": "object",
-  "required": ["schemaVersion", "id", "stack", "required", "defaultWorkflow", "agents", "workflows", "handoffRules"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "id": { "type": "string", "minLength": 1 },
-    "stack": { "type": "string", "minLength": 1 },
-    "required": { "type": "boolean" },
-    "defaultWorkflow": { "type": "string", "minLength": 1 },
-    "principle": { "type": "string" },
-    "agents": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["id", "skills"],
-        "additionalProperties": false,
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "name": { "type": "string" },
-          "file": { "type": "string" },
-          "defaultFor": { "type": "array", "items": { "type": "string" } },
-          "skills": { "type": "array", "minItems": 1, "items": { "type": "string" } },
-          "handsOffTo": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "workflows": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["id", "sequence", "council", "requiredOutputs"],
-        "additionalProperties": false,
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "triggers": { "type": "array", "items": { "type": "string" } },
-          "sequence": { "type": "array", "minItems": 1, "items": { "type": "string" } },
-          "council": { "type": "array", "items": { "type": "string" } },
-          "requiredOutputs": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "handoffRules": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string" }
-    }
-  }
-}

package/schemas/agentic-level.schema.json

@@ -1,47 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/agentic-level.schema.json",
-  "title": "Agent Kit Agentic Level Report",
-  "type": "object",
-  "required": ["currentLevel", "targetLevel", "maintainerProfile", "computedAt", "signals"],
-  "additionalProperties": false,
-  "properties": {
-    "currentLevel": { "type": "integer", "enum": [3, 4, 5, 6] },
-    "targetLevel": { "type": "integer", "enum": [3, 4, 5, 6, 7, 8] },
-    "maintainerProfile": { "type": "boolean" },
-    "computedAt": { "type": "string", "format": "date-time" },
-    "maintainerNote": { "type": "string" },
-    "signals": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "level", "label", "pass", "evidence", "remediation"],
-        "additionalProperties": false,
-        "properties": {
-          "id": { "type": "string" },
-          "level": { "type": "integer", "enum": [3, 4, 5, 6] },
-          "label": { "type": "string" },
-          "pass": { "type": "boolean" },
-          "evidence": { "type": "string" },
-          "remediation": { "type": "string" }
-        }
-      }
-    },
-    "climbSteps": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "level", "label", "pass", "evidence", "remediation"],
-        "additionalProperties": false,
-        "properties": {
-          "id": { "type": "string" },
-          "level": { "type": "integer", "enum": [3, 4, 5, 6] },
-          "label": { "type": "string" },
-          "pass": { "type": "boolean" },
-          "evidence": { "type": "string" },
-          "remediation": { "type": "string" }
-        }
-      }
-    }
-  }
-}

package/schemas/audit-report-v2.schema.json

@@ -1,71 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/audit-report-v2.schema.json",
-  "title": "Agent Kit Audit Report v2",
-  "type": "object",
-  "required": ["schemaVersion", "generatedAt", "tool", "root", "summary", "readiness", "findings"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 2 },
-    "generatedAt": { "type": "string", "format": "date-time" },
-    "tool": {
-      "type": "object",
-      "required": ["name", "version"],
-      "additionalProperties": false,
-      "properties": {
-        "name": { "const": "agent-kit" },
-        "version": { "type": "string", "minLength": 1 }
-      }
-    },
-    "root": { "const": "." },
-    "summary": {
-      "type": "object",
-      "required": ["pass", "warn", "fail", "suppressed"],
-      "additionalProperties": false,
-      "properties": {
-        "pass": { "type": "integer", "minimum": 0 },
-        "warn": { "type": "integer", "minimum": 0 },
-        "fail": { "type": "integer", "minimum": 0 },
-        "suppressed": { "type": "integer", "minimum": 0 }
-      }
-    },
-    "readiness": { "$ref": "audit-report.schema.json#/$defs/readiness" },
-    "findings": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["level", "area", "message", "ruleId", "ruleVersion", "confidence", "evidence"],
-        "additionalProperties": false,
-        "properties": {
-          "level": { "type": "string", "enum": ["pass", "warn", "fail"] },
-          "area": { "type": "string", "minLength": 1 },
-          "message": { "type": "string", "minLength": 1 },
-          "remediation": { "type": "string", "minLength": 1 },
-          "ruleId": { "type": "string", "minLength": 1 },
-          "ruleVersion": { "type": "string", "minLength": 1 },
-          "helpUri": { "type": "string", "format": "uri" },
-          "confidence": { "type": "string", "enum": ["low", "medium", "high"] },
-          "fixable": { "type": "boolean" },
-          "suppressed": { "type": "boolean" },
-          "suppressionReason": { "type": "string", "minLength": 1 },
-          "evidence": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": ["kind", "summary"],
-              "additionalProperties": false,
-              "properties": {
-                "kind": { "type": "string", "enum": ["file", "command", "configuration", "runtime"] },
-                "summary": { "type": "string", "minLength": 1 },
-                "path": { "type": "string", "minLength": 1 },
-                "line": { "type": "integer", "minimum": 1 },
-                "column": { "type": "integer", "minimum": 1 },
-                "observedAt": { "type": "string", "format": "date-time" }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}

package/schemas/audit-report.schema.json

@@ -1,50 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/audit-report.schema.json",
-  "title": "Agent Kit Audit Report",
-  "$defs": {
-    "readiness": {
-      "type": "object",
-      "required": ["level", "summary", "nextActions"],
-      "additionalProperties": false,
-      "properties": {
-        "level": {
-          "type": "string",
-          "enum": ["needs-setup", "baseline-setup", "needs-improvement", "best-practice-candidate"]
-        },
-        "summary": { "type": "string", "minLength": 1 },
-        "nextActions": { "type": "array", "items": { "type": "string" } }
-      }
-    }
-  },
-  "type": "object",
-  "required": ["summary", "readiness", "findings"],
-  "additionalProperties": false,
-  "properties": {
-    "summary": {
-      "type": "object",
-      "required": ["pass", "warn", "fail"],
-      "additionalProperties": false,
-      "properties": {
-        "pass": { "type": "integer", "minimum": 0 },
-        "warn": { "type": "integer", "minimum": 0 },
-        "fail": { "type": "integer", "minimum": 0 }
-      }
-    },
-    "readiness": { "$ref": "#/$defs/readiness" },
-    "findings": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["level", "area", "message"],
-        "additionalProperties": false,
-        "properties": {
-          "level": { "type": "string", "enum": ["pass", "warn", "fail"] },
-          "area": { "type": "string", "minLength": 1 },
-          "message": { "type": "string", "minLength": 1 },
-          "remediation": { "type": "string", "minLength": 1 }
-        }
-      }
-    }
-  }
-}

package/schemas/correction-rules.schema.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/correction-rules.schema.json",
-  "title": "Agent Kit Correction Rules",
-  "type": "object",
-  "required": ["schemaVersion", "rules"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "rules": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "scope", "status", "text", "createdAt"],
-        "additionalProperties": false,
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "scope": { "type": "string", "enum": ["session", "project", "agent", "upstream-proposal"] },
-          "status": { "type": "string", "enum": ["active", "retired", "proposed"] },
-          "text": { "type": "string", "minLength": 1 },
-          "appliesToAgents": { "type": "array", "items": { "type": "string" } },
-          "agentId": { "type": "string", "minLength": 1 },
-          "sourceSessionId": { "type": "string", "minLength": 1 },
-          "createdAt": { "type": "string", "format": "date-time" },
-          "reviewedAt": { "type": ["string", "null"], "format": "date-time" },
-          "retiredAt": { "type": "string", "format": "date-time" },
-          "reason": { "type": "string" }
-        }
-      }
-    }
-  }
-}

package/schemas/council-session.schema.json

@@ -1,65 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/council-session.schema.json",
-  "title": "Agent Kit Council Session",
-  "type": "object",
-  "required": ["schemaVersion", "sessionId", "createdAt", "workflowId", "status", "request", "handoffs", "requiredOutputs", "verification"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "sessionId": { "type": "string", "minLength": 1 },
-    "createdAt": { "type": "string", "format": "date-time" },
-    "workflowId": { "type": "string", "minLength": 1 },
-    "status": { "type": "string", "enum": ["planned", "in-progress", "blocked", "complete"] },
-    "request": { "type": "string", "minLength": 1 },
-    "affectedLayers": {
-      "type": "array",
-      "items": { "type": "string" }
-    },
-    "handoffs": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["agentId", "decision", "risk", "nextHandoff"],
-        "additionalProperties": false,
-        "properties": {
-          "agentId": { "type": "string", "minLength": 1 },
-          "decision": { "type": "string", "minLength": 1 },
-          "risk": { "type": "string", "minLength": 1 },
-          "nextHandoff": { "type": "string", "minLength": 1 },
-          "evidence": {
-            "type": "array",
-            "items": { "type": "string" }
-          }
-        }
-      }
-    },
-    "requiredOutputs": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "status"],
-        "additionalProperties": false,
-        "properties": {
-          "name": { "type": "string", "minLength": 1 },
-          "status": { "type": "string", "enum": ["missing", "partial", "complete", "not-applicable"] },
-          "evidence": { "type": "string" }
-        }
-      }
-    },
-    "verification": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["command", "result"],
-        "additionalProperties": false,
-        "properties": {
-          "command": { "type": "string", "minLength": 1 },
-          "result": { "type": "string", "enum": ["pass", "fail", "skipped"] },
-          "notes": { "type": "string" }
-        }
-      }
-    }
-  }
-}

package/schemas/model-routing.schema.json

@@ -1,72 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/model-routing.schema.json",
-  "title": "Agent Kit Model Routing",
-  "type": "object",
-  "required": ["schemaVersion", "id", "stack", "reviewedAt", "reviewCadence", "principle", "profiles", "agentRoutes", "toolSurfaces", "updatePolicy"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "id": { "type": "string", "minLength": 1 },
-    "stack": { "type": "string", "minLength": 1 },
-    "reviewedAt": { "type": "string", "minLength": 1 },
-    "reviewCadence": { "type": "string", "minLength": 1 },
-    "principle": { "type": "string", "minLength": 1 },
-    "profiles": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["id", "label", "intent", "reasoningEffort", "contextWindow", "latency", "cost", "preferredFor"],
-        "additionalProperties": false,
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "label": { "type": "string", "minLength": 1 },
-          "intent": { "type": "string", "minLength": 1 },
-          "reasoningEffort": { "type": "string", "enum": ["low", "medium", "high", "varies"] },
-          "contextWindow": { "type": "string", "enum": ["small", "medium", "large", "very-large", "varies"] },
-          "latency": { "type": "string", "enum": ["low", "medium", "high", "varies"] },
-          "cost": { "type": "string", "enum": ["low", "medium", "high", "varies"] },
-          "preferredFor": { "type": "array", "minItems": 1, "items": { "type": "string" } }
-        }
-      }
-    },
-    "agentRoutes": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["agentId", "profileId", "defaultEffort"],
-        "additionalProperties": false,
-        "properties": {
-          "agentId": { "type": "string", "minLength": 1 },
-          "profileId": { "type": "string", "minLength": 1 },
-          "defaultEffort": { "type": "string", "enum": ["low", "medium", "high"] },
-          "escalationProfileId": { "type": "string", "minLength": 1 },
-          "notes": { "type": "string" }
-        }
-      }
-    },
-    "toolSurfaces": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["tool", "instructionSurface", "modelSelection", "enforcement", "adapter"],
-        "additionalProperties": false,
-        "properties": {
-          "tool": { "type": "string", "minLength": 1 },
-          "instructionSurface": { "type": "string", "minLength": 1 },
-          "modelSelection": { "type": "string", "minLength": 1 },
-          "enforcement": { "type": "string", "enum": ["enforced", "partial", "advisory", "manual"] },
-          "adapter": { "type": "string", "minLength": 1 }
-        }
-      }
-    },
-    "updatePolicy": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string" }
-    }
-  }
-}

package/schemas/onboarding-state.schema.json

@@ -1,36 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/onboarding-state.schema.json",
-  "title": "Agent Kit Onboarding State",
-  "type": "object",
-  "required": [
-    "schemaVersion",
-    "depth",
-    "startedAt",
-    "lastVisitedAt",
-    "completedSections",
-    "skippedSections",
-    "currentSection",
-    "currentStep",
-    "wizardVersion"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "depth": { "type": "string", "enum": ["quick", "standard", "complete", "undecided"] },
-    "startedAt": { "type": "string", "format": "date-time" },
-    "lastVisitedAt": { "type": "string", "format": "date-time" },
-    "completedAt": { "type": "string", "format": "date-time" },
-    "completedSections": { "type": "array", "items": { "type": "string" } },
-    "skippedSections": { "type": "array", "items": { "type": "string" } },
-    "currentSection": { "type": "string" },
-    "currentStep": { "type": "integer", "minimum": 0 },
-    "wizardVersion": { "type": "string" },
-    "ideSurface": { "type": "string", "enum": ["cursor", "copilot", "claude", "codex", "other"] },
-    "ideVerifiedAt": { "type": "string", "format": "date-time" },
-    "visualQaTier": { "type": "string", "enum": ["baseline", "strong", "mature"] },
-    "targetAgenticLevel": { "type": "integer", "enum": [3, 4, 5, 6, 7, 8] },
-    "lastAgenticLevel": { "type": "integer", "enum": [3, 4, 5, 6] },
-    "lastAgenticComputedAt": { "type": "string", "format": "date-time" }
-  }
-}

package/schemas/orchestrator.schema.json

@@ -1,167 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-skills.dev/schemas/orchestrator.schema.json",
-  "title": "Agent Kit Orchestrator Configuration",
-  "type": "object",
-  "required": ["schemaVersion"],
-  "additionalProperties": false,
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "enabled": { "type": "boolean", "default": false },
-    "defaultWorkflow": { "type": "string", "minLength": 1, "default": "planning" },
-    "defaultAlias": { "type": "string", "minLength": 1, "default": "balanced" },
-    "databasePath": { "type": "string", "minLength": 1, "default": ".agent-kit/runtime/runtime.sqlite" },
-    "providers": {
-      "type": "object",
-      "additionalProperties": { "$ref": "#/$defs/provider" },
-      "default": {}
-    },
-    "modelAliases": {
-      "type": "object",
-      "additionalProperties": { "$ref": "#/$defs/modelAlias" },
-      "default": {}
-    },
-    "agentRoutes": {
-      "type": "object",
-      "additionalProperties": { "type": "string", "minLength": 1 },
-      "default": {}
-    },
-    "agentExecutors": {
-      "type": "object",
-      "additionalProperties": { "enum": ["model", "cursor"] },
-      "default": {}
-    },
-    "mutationAgents": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 },
-      "uniqueItems": true
-    },
-    "cursor": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": { "type": "boolean", "default": false },
-        "command": { "type": "string", "minLength": 1, "default": "cursor-agent" },
-        "args": { "type": "array", "items": { "type": "string" } },
-        "timeoutMs": { "type": "integer", "minimum": 1000, "maximum": 3600000 }
-      }
-    },
-    "mcpServers": {
-      "type": "object",
-      "additionalProperties": { "$ref": "#/$defs/mcpServer" },
-      "default": {}
-    },
-    "sandbox": { "$ref": "#/$defs/sandbox" },
-    "approvals": { "$ref": "#/$defs/approvals" },
-    "limits": { "$ref": "#/$defs/limits" }
-  },
-  "$defs": {
-    "credentialRef": {
-      "type": "string",
-      "pattern": "^(?:env:[A-Z][A-Z0-9_]*|keychain:[a-zA-Z0-9_.:@/-]+)$"
-    },
-    "capability": {
-      "enum": ["text", "tools", "parallel-tools", "structured-output", "streaming", "vision", "reasoning", "usage"]
-    },
-    "provider": {
-      "type": "object",
-      "required": ["kind"],
-      "additionalProperties": false,
-      "properties": {
-        "kind": {
-          "enum": ["openai", "anthropic", "gemini", "xai", "deepseek", "kimi", "glm", "openrouter", "ollama", "lm-studio", "vllm", "openai-compatible"]
-        },
-        "baseUrl": { "type": "string", "format": "uri" },
-        "credentialRef": { "$ref": "#/$defs/credentialRef" },
-        "allowPrivateNetwork": { "type": "boolean", "default": false },
-        "capabilities": { "type": "array", "items": { "$ref": "#/$defs/capability" }, "uniqueItems": true },
-        "timeoutMs": { "type": "integer", "minimum": 1000, "maximum": 600000 }
-      }
-    },
-    "modelAlias": {
-      "type": "object",
-      "required": ["candidates"],
-      "additionalProperties": false,
-      "properties": {
-        "candidates": {
-          "type": "array",
-          "minItems": 1,
-          "items": {
-            "type": "object",
-            "required": ["provider", "model"],
-            "additionalProperties": false,
-            "properties": {
-              "provider": { "type": "string", "minLength": 1 },
-              "model": { "type": "string", "minLength": 1 }
-            }
-          }
-        },
-        "requiredCapabilities": { "type": "array", "items": { "$ref": "#/$defs/capability" }, "uniqueItems": true },
-        "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 10 }
-      }
-    },
-    "mcpServer": {
-      "oneOf": [
-        {
-          "type": "object",
-          "required": ["transport", "command"],
-          "additionalProperties": false,
-          "properties": {
-            "transport": { "const": "stdio" },
-            "command": { "type": "string", "minLength": 1 },
-            "args": { "type": "array", "items": { "type": "string" } },
-            "envRefs": { "type": "object", "additionalProperties": { "$ref": "#/$defs/credentialRef" } },
-            "allowHostExecution": { "type": "boolean", "default": false },
-            "allowedTools": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
-          }
-        },
-        {
-          "type": "object",
-          "required": ["transport", "url", "allowedHosts"],
-          "additionalProperties": false,
-          "properties": {
-            "transport": { "const": "streamable-http" },
-            "url": { "type": "string", "format": "uri" },
-            "authRef": { "$ref": "#/$defs/credentialRef" },
-            "allowedHosts": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
-            "allowPrivateNetwork": { "type": "boolean", "default": false },
-            "allowedTools": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
-          }
-        }
-      ]
-    },
-    "sandbox": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "provider": { "enum": ["docker", "host-readonly"] },
-        "image": { "type": "string", "minLength": 1 },
-        "network": { "enum": ["none", "approved"] },
-        "allowHostMutations": { "type": "boolean" },
-        "timeoutMs": { "type": "integer", "minimum": 1000, "maximum": 3600000 },
-        "memoryMb": { "type": "integer", "minimum": 128, "maximum": 32768 },
-        "cpus": { "type": "number", "exclusiveMinimum": 0, "maximum": 32 }
-      }
-    },
-    "approvals": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "mode": { "const": "risk-tiered" },
-        "requirePlan": { "type": "boolean" },
-        "requireFinalCommit": { "type": "boolean" }
-      }
-    },
-    "limits": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "maxSteps": { "type": "integer", "minimum": 1, "maximum": 100 },
-        "maxAgentVisits": { "type": "integer", "minimum": 1, "maximum": 10 },
-        "maxRetriesPerNode": { "type": "integer", "minimum": 0, "maximum": 5 },
-        "maxToolCallsPerAgent": { "type": "integer", "minimum": 0, "maximum": 100 },
-        "runTimeoutMs": { "type": "integer", "minimum": 1000, "maximum": 86400000 }
-      }
-    }
-  }
-}