@openplanr/protocol 0.2.0

package/schemas/v1.0.0/story.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/story.schema.json",
+  "title": "OpenPlanr User Story frontmatter (v1.0.0)",
+  "description": "JSON Schema for the YAML frontmatter of a user story artifact. Accepts both planr-pipeline modes via a top-level `oneOf` over the parent reference: spec-driven user stories (US-NNN-{slug}.md under <SPEC_DIR>/stories/) carry `specId: \"SPEC-NNN\"` and live scoped to a parent SPEC; default-mode user stories (output/feats/feat-{slug}/us-N/us-N.md) carry `featureSlug: \"<slug>\"` and live scoped to a parent feature folder. Exactly one of the two parent-reference fields must be present per story; the other must be absent.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "title",
+    "slug",
+    "schemaVersion",
+    "status",
+    "created",
+    "updated"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^US-\\d{3}$",
+      "description": "User Story identifier (e.g. US-001). Scoped to the parent SPEC (spec-driven) or parent feature (default mode)."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable story title."
+    },
+    "specId": {
+      "type": "string",
+      "pattern": "^SPEC-\\d{3}$",
+      "description": "ID of the parent spec this story belongs to. Spec-driven mode only — must be absent in default mode."
+    },
+    "featureSlug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "minLength": 1,
+      "description": "Slug of the parent feature folder this story belongs to. Default mode only — must be absent in spec-driven mode."
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "minLength": 1,
+      "description": "URL-safe lowercase slug used in the story file name."
+    },
+    "schemaVersion": {
+      "const": "1.0.0",
+      "description": "Pinned to the OpenPlanr Protocol reader version."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["pending", "implementing", "done", "blocked"],
+      "description": "Current lifecycle state of the story."
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["P0", "P1", "P2", "P3"],
+      "description": "Optional priority tier (inherits from parent spec when absent)."
+    },
+    "created": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "ISO date (YYYY-MM-DD) of story creation."
+    },
+    "updated": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "ISO date (YYYY-MM-DD) bumped on every edit."
+    },
+    "kanbanosId": {
+      "type": "string",
+      "minLength": 8,
+      "pattern": "^[A-Za-z0-9_-]{8,128}$",
+      "description": "Optional opaque entity id on the kanbanos hosted board, written back by the sync tool after a successful push (the linearId precedent from the OpenPlanr CLI Linear integration). Sync-tool-owned: humans and planning agents never author or edit it by hand. Absent until the artifact is first pushed. See ADR-012."
+    },
+    "contentHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Optional digest of the artifact content at the last successful board sync, written back by the sync tool alongside kanbanosId so drift between file and board is detectable. Same sha256:<hex> shape as operating-evidence-index-item@1.3.0. Sync-tool-owned: humans and planning agents never author or edit it by hand. See ADR-012."
+    }
+  },
+  "oneOf": [
+    {
+      "title": "spec-driven story → requires specId, forbids featureSlug",
+      "required": ["specId"],
+      "not": { "required": ["featureSlug"] }
+    },
+    {
+      "title": "default-mode story → requires featureSlug, forbids specId",
+      "required": ["featureSlug"],
+      "not": { "required": ["specId"] }
+    }
+  ]
+}

package/schemas/v1.0.0/task.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/task.schema.json",
+  "title": "OpenPlanr Task frontmatter (v1.0.0)",
+  "description": "JSON Schema for the YAML frontmatter of a task artifact. Encodes two orthogonal correlations via `allOf`: (1) type-to-agent — UI tasks use frontend-agent, Tech tasks use backend-agent or db-agent; (2) parent reference — spec-driven tasks (T-NNN-{slug}.md under <SPEC_DIR>/tasks/) carry `specId: \"SPEC-NNN\"` (with a `storyId` pointing at a US-NNN within that SPEC), default-mode tasks (output/feats/feat-{slug}/us-N/tasks/task-N.md) carry `featureSlug: \"<slug>\"` instead of specId. Exactly one of the two parent-reference fields must be present per task; the other must be absent.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "title",
+    "storyId",
+    "slug",
+    "schemaVersion",
+    "type",
+    "agent",
+    "status",
+    "created",
+    "updated"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^T-\\d{3}$",
+      "description": "Task identifier (e.g. T-001). Scoped to the parent SPEC (spec-driven) or parent User Story (default mode)."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable task title."
+    },
+    "storyId": {
+      "type": "string",
+      "pattern": "^US-\\d{3}$",
+      "description": "ID of the parent User Story this task belongs to."
+    },
+    "specId": {
+      "type": "string",
+      "pattern": "^SPEC-\\d{3}$",
+      "description": "ID of the grandparent spec this task ultimately belongs to. Spec-driven mode only — must be absent in default mode."
+    },
+    "featureSlug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "minLength": 1,
+      "description": "Slug of the parent feature folder this task ultimately belongs to. Default mode only — must be absent in spec-driven mode."
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "minLength": 1,
+      "description": "URL-safe lowercase slug used in the task file name."
+    },
+    "schemaVersion": {
+      "const": "1.0.0",
+      "description": "Pinned to the OpenPlanr Protocol reader version."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["UI", "Tech"],
+      "description": "UI = frontend-bearing task; Tech = backend / data / infra task."
+    },
+    "agent": {
+      "type": "string",
+      "enum": ["frontend-agent", "backend-agent", "db-agent"],
+      "description": "DEV agent responsible for executing this task. Must correlate with `type` (see allOf type/agent branch)."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["pending", "in-progress", "done", "blocked"],
+      "description": "Current lifecycle state of the task."
+    },
+    "created": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "ISO date (YYYY-MM-DD) of task creation."
+    },
+    "updated": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "ISO date (YYYY-MM-DD) bumped on every edit."
+    },
+    "rationale": {
+      "type": "string",
+      "description": "1-3 sentence explanation of why this task exists and why these specific files were chosen. Populated by the specification-agent during decomposition. Read by qa-agent to check implementation drift."
+    },
+    "dependsOn": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^T-\\d{3}$" },
+      "uniqueItems": true,
+      "default": [],
+      "description": "Task IDs (within the same parent) that must reach status done before this task is dispatched. Optional; absent/empty means no declared dependency."
+    },
+    "preserve": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["repositoryKey", "path"],
+        "properties": {
+          "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "path": { "type": "string", "minLength": 1 }
+        }
+      },
+      "uniqueItems": true,
+      "description": "Optional machine-enforceable repository-relative Preserve boundaries. New SHIP closure runs require this property to be explicitly present (an empty array is valid); legacy body prose remains human guidance only."
+    },
+    "review_risks": {
+      "type": "array",
+      "items": { "type": "string", "enum": ["security", "performance", "migration", "api-contract", "data-integrity"] },
+      "uniqueItems": true,
+      "description": "Optional reviewed specialist risk declarations. The deterministic SHIP classifier, not the caller, maps these IDs into the frozen consolidated roster."
+    },
+    "browser_surfaces": {
+      "type": "array",
+      "items": { "type": "string", "enum": ["ui", "authentication", "session", "navigation", "network"] },
+      "uniqueItems": true,
+      "description": "Optional reviewed browser-sensitive surfaces. Any declared entry makes browser QA mandatory for the SHIP candidate."
+    },
+    "kanbanosId": {
+      "type": "string",
+      "minLength": 8,
+      "pattern": "^[A-Za-z0-9_-]{8,128}$",
+      "description": "Optional opaque entity id on the kanbanos hosted board, written back by the sync tool after a successful push (the linearId precedent from the OpenPlanr CLI Linear integration). Sync-tool-owned: humans and planning agents never author or edit it by hand. Absent until the artifact is first pushed. See ADR-012."
+    },
+    "contentHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Optional digest of the artifact content at the last successful board sync, written back by the sync tool alongside kanbanosId so drift between file and board is detectable. Same sha256:<hex> shape as operating-evidence-index-item@1.3.0. Sync-tool-owned: humans and planning agents never author or edit it by hand. See ADR-012."
+    }
+  },
+  "allOf": [
+    {
+      "title": "type-to-agent correlation",
+      "oneOf": [
+        {
+          "title": "UI task → frontend-agent",
+          "properties": {
+            "type": { "const": "UI" },
+            "agent": { "const": "frontend-agent" }
+          },
+          "required": ["type", "agent"]
+        },
+        {
+          "title": "Tech task → backend-agent or db-agent",
+          "properties": {
+            "type": { "const": "Tech" },
+            "agent": { "enum": ["backend-agent", "db-agent"] }
+          },
+          "required": ["type", "agent"]
+        }
+      ]
+    },
+    {
+      "title": "parent-reference correlation (mode-dependent)",
+      "oneOf": [
+        {
+          "title": "spec-driven task → requires specId, forbids featureSlug",
+          "required": ["specId"],
+          "not": { "required": ["featureSlug"] }
+        },
+        {
+          "title": "default-mode task → requires featureSlug, forbids specId",
+          "required": ["featureSlug"],
+          "not": { "required": ["specId"] }
+        }
+      ]
+    }
+  ]
+}

package/schemas/v1.0.0/taste-profile.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/taste-profile.schema.json",
+  "title": "OpenPlanr design taste profile (v1.0.0)",
+  "description": "Per-project taste memory at ~/.planr/designs/<project>/taste-profile.json. Updated on BOTH approve and reject. `confidence` is stored raw; the 5%/week decay is computed AT READ TIME by lib/design-engine/taste.mjs (never persisted back as decayed). Conflicts between the profile and a new brief are FLAGGED to the user, never silently resolved. NOTE: each dimension inlines the same entry shape — the conformance validator's schema subset has no $ref.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "profile_version", "dimensions", "sessions"],
+  "properties": {
+    "schema_version": { "const": "1.0.0", "description": "Schema version pin." },
+    "profile_version": { "const": 1, "description": "Taste-profile format generation." },
+    "dimensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fonts", "colors", "layouts", "aesthetics"],
+      "properties": {
+        "fonts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["value", "confidence", "approved_count", "rejected_count", "last_seen"],
+            "properties": {
+              "value": { "type": "string", "minLength": 1 },
+              "confidence": { "type": "number", "minimum": 0 },
+              "approved_count": { "type": "number", "minimum": 0 },
+              "rejected_count": { "type": "number", "minimum": 0 },
+              "last_seen": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "colors": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["value", "confidence", "approved_count", "rejected_count", "last_seen"],
+            "properties": {
+              "value": { "type": "string", "minLength": 1 },
+              "confidence": { "type": "number", "minimum": 0 },
+              "approved_count": { "type": "number", "minimum": 0 },
+              "rejected_count": { "type": "number", "minimum": 0 },
+              "last_seen": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "layouts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["value", "confidence", "approved_count", "rejected_count", "last_seen"],
+            "properties": {
+              "value": { "type": "string", "minLength": 1 },
+              "confidence": { "type": "number", "minimum": 0 },
+              "approved_count": { "type": "number", "minimum": 0 },
+              "rejected_count": { "type": "number", "minimum": 0 },
+              "last_seen": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "aesthetics": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["value", "confidence", "approved_count", "rejected_count", "last_seen"],
+            "properties": {
+              "value": { "type": "string", "minLength": 1 },
+              "confidence": { "type": "number", "minimum": 0 },
+              "approved_count": { "type": "number", "minimum": 0 },
+              "rejected_count": { "type": "number", "minimum": 0 },
+              "last_seen": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      },
+      "description": "Each dimension is an array of attribute entries {value, confidence, approved_count, rejected_count, last_seen}."
+    },
+    "sessions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["sessionId", "verdict", "at"],
+        "properties": {
+          "sessionId": { "type": "string", "minLength": 1 },
+          "verdict": { "type": "string", "enum": ["approved", "rejected"] },
+          "at": { "type": "string", "minLength": 1, "description": "ISO timestamp." },
+          "artifact": { "type": "string", "description": "Path of the judged artifact." }
+        }
+      },
+      "description": "Audit trail of every taste update."
+    }
+  }
+}

package/schemas/v1.1.0/adapter-registry.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/adapter-registry.schema.json",
+  "title": "OpenPlanr runtime adapter registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "pipelineVersion", "adapters"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "pipelineVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" },
+    "adapters": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "version", "capabilityLevel", "installScopes", "entrypoints", "capabilities", "assets", "healthChecks", "drivers"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" },
+          "capabilityLevel": { "type": "string", "enum": ["artifact", "workflow", "product"] },
+          "installScopes": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "type": "string", "enum": ["user", "project"] }
+          },
+          "entrypoints": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["plan", "ship", "artifact"],
+            "properties": {
+              "plan": { "type": "string", "minLength": 1 },
+              "design": { "type": "string", "minLength": 1 },
+              "ship": { "type": "string", "minLength": 1 },
+              "dashboard": { "type": "string", "minLength": 1 },
+              "artifact": { "type": "string", "minLength": 1 },
+              "sync": { "type": "string", "minLength": 1 },
+              "doctor": { "type": "string", "minLength": 1 }
+            }
+          },
+          "capabilities": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["subagents", "hooks", "toolIsolation", "parallelDispatch", "headlessLaunch", "artifactReview"],
+            "properties": {
+              "subagents": { "type": "string", "enum": ["native", "advisory", "sequential", "dynamic"] },
+              "hooks": { "type": "boolean" },
+              "toolIsolation": { "type": "string", "enum": ["enforced", "advisory"] },
+              "parallelDispatch": { "type": "string", "enum": ["native", "host", "sequential", "dynamic"] },
+              "headlessLaunch": { "type": "boolean" },
+              "artifactReview": { "type": "boolean" }
+            }
+          },
+          "assets": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+          "healthChecks": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+          "drivers": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["install", "migrate", "rollback", "uninstall"],
+            "properties": {
+              "install": { "type": "string", "minLength": 1 },
+              "migrate": { "type": "string", "minLength": 1 },
+              "rollback": { "type": "string", "minLength": 1 },
+              "uninstall": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/artifact-envelope.schema.json

@@ -0,0 +1,142 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-envelope.schema.json",
+  "title": "OpenPlanr self-contained HTML artifact envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "artifacts", "viewer"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "artifacts": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 256,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "title", "sha256", "html", "viewport", "colorScheme"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+          "kind": { "const": "html" },
+          "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+          "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+          "html": { "type": "string", "minLength": 1 },
+          "viewport": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["width", "height"],
+            "properties": {
+              "width": { "type": "integer", "minimum": 1, "maximum": 16384 },
+              "height": { "type": "integer", "minimum": 1, "maximum": 16384 }
+            }
+          },
+          "colorScheme": { "type": "string", "enum": ["light", "dark"] }
+        }
+      }
+    },
+    "viewer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "activeArtifactId"],
+      "properties": {
+        "mode": { "type": "string", "enum": ["single", "variants"] },
+        "activeArtifactId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "presentation": { "type": "string", "enum": ["document", "canvas"] }
+      }
+    },
+    "review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "reviewId", "reviewOf", "decision", "overall", "pins"],
+      "properties": {
+        "schemaVersion": { "const": "1.0.0" },
+        "reviewId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "reviewOf": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "decision": { "type": "string", "enum": ["pending", "approved", "changes_requested"] },
+        "overall": { "type": "string", "maxLength": 65536 },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "pins": {
+          "type": "array",
+          "maxItems": 10000,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "author", "artifactId", "region", "viewport", "intent", "status", "comment", "replies", "createdAt", "updatedAt"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+              "author": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["name"],
+                "properties": {
+                  "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                  "name": { "type": "string", "minLength": 1, "maxLength": 256 }
+                }
+              },
+              "artifactId": { "type": "string", "minLength": 1, "maxLength": 128 },
+              "variant": { "type": "string", "minLength": 1, "maxLength": 128 },
+              "region": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["x", "y", "w", "h"],
+                "properties": {
+                  "x": { "type": "number", "minimum": 0, "maximum": 1 },
+                  "y": { "type": "number", "minimum": 0, "maximum": 1 },
+                  "w": { "type": "number", "minimum": 0, "maximum": 1 },
+                  "h": { "type": "number", "minimum": 0, "maximum": 1 }
+                }
+              },
+              "viewport": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["width", "height"],
+                "properties": {
+                  "width": { "type": "integer", "minimum": 1, "maximum": 16384 },
+                  "height": { "type": "integer", "minimum": 1, "maximum": 262144 }
+                }
+              },
+              "anchor": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["planrId"],
+                "properties": {
+                  "planrId": { "type": "string", "minLength": 1, "maxLength": 512 },
+                  "screen": { "type": "string", "minLength": 1, "maxLength": 128 }
+                }
+              },
+              "intent": { "type": "string", "enum": ["fix", "improve", "question"] },
+              "status": { "type": "string", "enum": ["open", "addressed", "resolved"] },
+              "comment": { "type": "string", "minLength": 1, "maxLength": 65536 },
+              "replies": {
+                "type": "array",
+                "maxItems": 10000,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["id", "author", "comment", "createdAt"],
+                  "properties": {
+                    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                    "author": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": ["name"],
+                      "properties": {
+                        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                        "name": { "type": "string", "minLength": 1, "maxLength": 256 }
+                      }
+                    },
+                    "comment": { "type": "string", "minLength": 1, "maxLength": 65536 },
+                    "createdAt": { "type": "string", "format": "date-time" }
+                  }
+                }
+              },
+              "createdAt": { "type": "string", "format": "date-time" },
+              "updatedAt": { "type": "string", "format": "date-time" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/artifact-paste.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-paste.schema.json",
+  "title": "OpenPlanr encrypted artifact paste boundary",
+  "oneOf": [
+    {
+      "title": "Create paste request",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "operation", "iv", "ciphertext", "ttl"],
+      "properties": {
+        "schemaVersion": { "const": "1.0.0" },
+        "operation": { "const": "create" },
+        "iv": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16}$" },
+        "ciphertext": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$" },
+        "ttl": { "type": "string", "enum": ["1d", "7d", "30d"] }
+      }
+    },
+    {
+      "title": "Created paste response",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "operation", "id", "expiresAt", "deletionToken"],
+      "properties": {
+        "schemaVersion": { "const": "1.0.0" },
+        "operation": { "const": "created" },
+        "id": { "type": "string", "minLength": 16, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "deletionToken": { "type": "string", "minLength": 32, "maxLength": 256, "pattern": "^[A-Za-z0-9_-]+$" }
+      }
+    },
+    {
+      "title": "Ciphertext storage record",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "operation", "id", "iv", "ciphertext", "expiresAt", "size", "deletionTokenHash"],
+      "properties": {
+        "schemaVersion": { "const": "1.0.0" },
+        "operation": { "const": "stored" },
+        "id": { "type": "string", "minLength": 16, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" },
+        "iv": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16}$" },
+        "ciphertext": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$" },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 5242880 },
+        "deletionTokenHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    }
+  ]
+}