specrails-desktop 2.0.0

package/server/dist/schemas/profile.v1.json

@@ -0,0 +1,151 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://raw.githubusercontent.com/fjpulidop/specrails-desktop/main/server/schemas/profile.v1.json",
+    "title": "specrails agent profile (v1)",
+    "description": "Declarative configuration for the specrails implement pipeline. Describes which agents participate, which models they run with, and how tasks are routed to specialists. Consumed by `implement.md` and produced by tools like specrails-desktop. This is specrails-desktop's derivative of specrails-core's canonical v1 profile schema: it adds the optional top-level `provider` field and relaxes `modelAlias` to any non-empty string (provider-catalog validation happens in profile-manager.validateStructural). Per core's schema-identity contract, a diverging vendored copy must carry its own $id — only byte-identical copies may share the canonical core $id.",
+    "type": "object",
+    "required": ["schemaVersion", "name", "orchestrator", "agents", "routing"],
+    "additionalProperties": false,
+    "properties": {
+        "schemaVersion": {
+            "const": 1,
+            "description": "Profile schema version. v1 is the only supported value at this time."
+        },
+        "name": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "minLength": 1,
+            "maxLength": 64,
+            "description": "Human-readable identifier for this profile (kebab-case)."
+        },
+        "description": {
+            "type": "string",
+            "maxLength": 512,
+            "description": "Optional short summary of when to use this profile."
+        },
+        "provider": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Optional provider id (e.g. `claude`, `codex`). When set, the profile's model values are validated against that provider's adapter catalog. When omitted, validation falls back to the project's resolved provider."
+        },
+        "orchestrator": {
+            "type": "object",
+            "required": ["model"],
+            "additionalProperties": false,
+            "properties": {
+                "model": {
+                    "$ref": "#/$defs/modelAlias",
+                    "description": "Model used to run the top-level implement orchestrator. The JSON schema accepts any non-empty string; provider-specific validation runs at the structural-check layer (see profile-manager.validateStructural)."
+                }
+            }
+        },
+        "agents": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/agentEntry" },
+            "description": "Ordered chain of agents that participate in the pipeline when this profile is active. Every profile (default + custom) must include the baseline trio (sr-architect, sr-developer, sr-reviewer) — the pipeline depends on all three. Custom profiles add optional agents on top of the baseline. sr-merge-resolver is an optional utility agent and is no longer required.",
+            "allOf": [
+                {
+                    "description": "Required baseline agent: sr-architect",
+                    "contains": {
+                        "type": "object",
+                        "properties": { "id": { "const": "sr-architect" } },
+                        "required": ["id"]
+                    }
+                },
+                {
+                    "description": "Required baseline agent: sr-developer",
+                    "contains": {
+                        "type": "object",
+                        "properties": { "id": { "const": "sr-developer" } },
+                        "required": ["id"]
+                    }
+                },
+                {
+                    "description": "Required baseline agent: sr-reviewer",
+                    "contains": {
+                        "type": "object",
+                        "properties": { "id": { "const": "sr-reviewer" } },
+                        "required": ["id"]
+                    }
+                }
+            ]
+        },
+        "routing": {
+            "type": "array",
+            "minItems": 0,
+            "description": "Ordered routing rules. The first rule whose `tags` intersects the task's tag set wins. If a `default: true` entry is present it MUST be the last element. Custom profiles may omit routing entirely — tasks then fall through to the first developer-shaped agent in the chain.",
+            "items": { "$ref": "#/$defs/routingRule" }
+        }
+    },
+    "$defs": {
+        "modelAlias": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "description": "Accepted model alias. JSON schema accepts any non-empty string; provider-specific catalog enforcement runs at runtime (see profile-manager.validateStructural)."
+        },
+        "agentEntry": {
+            "type": "object",
+            "required": ["id"],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "pattern": "^(sr|custom)-[a-z0-9][a-z0-9-]*$",
+                    "description": "Agent identifier. MUST correspond to a file at `.claude/agents/<id>.md`."
+                },
+                "model": {
+                    "$ref": "#/$defs/modelAlias",
+                    "description": "Model override for this agent when this profile is active. When omitted, the agent's frontmatter `model:` is used as a fallback."
+                },
+                "required": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "If true, the agent cannot be routed past. Baseline agents (sr-architect, sr-developer, sr-reviewer) SHOULD be marked required. sr-merge-resolver is optional and defaults to required: false."
+                }
+            }
+        },
+        "routingRule": {
+            "oneOf": [
+                {
+                    "type": "object",
+                    "required": ["tags", "agent"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "tags": {
+                            "type": "array",
+                            "minItems": 1,
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[a-z0-9][a-z0-9-]*$"
+                            },
+                            "description": "Task tags that trigger this rule. Rule wins if any tag intersects."
+                        },
+                        "agent": {
+                            "type": "string",
+                            "pattern": "^(sr|custom)-[a-z0-9][a-z0-9-]*$",
+                            "description": "Agent to route the task to when this rule wins."
+                        }
+                    }
+                },
+                {
+                    "type": "object",
+                    "required": ["default", "agent"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "default": {
+                            "const": true,
+                            "description": "Marks this rule as the terminal catch-all. Exactly one entry with `default: true` is allowed, and it MUST be the last element of `routing`."
+                        },
+                        "agent": {
+                            "type": "string",
+                            "pattern": "^(sr|custom)-[a-z0-9][a-z0-9-]*$",
+                            "description": "Agent to route the task to when no earlier rule matched."
+                        }
+                    }
+                }
+            ]
+        }
+    }
+}