openplanr 1.25.3 → 2.0.0

package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@openplanr/protocol",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./src/index.d.mts",
+      "import": "./src/index.mjs",
+      "default": "./src/index.mjs"
+    },
+    "./errors": {
+      "types": "./src/errors.d.mts",
+      "import": "./src/errors.mjs"
+    },
+    "./canonical-json": {
+      "types": "./src/canonical-json.d.mts",
+      "import": "./src/canonical-json.mjs"
+    },
+    "./json-schema": {
+      "types": "./src/json-schema.d.mts",
+      "import": "./src/json-schema.mjs"
+    },
+    "./semver": {
+      "types": "./src/semver.d.mts",
+      "import": "./src/semver.mjs"
+    },
+    "./contracts": {
+      "types": "./src/contracts.d.mts",
+      "import": "./src/contracts.mjs"
+    },
+    "./browser-contracts": {
+      "types": "./src/browser-contracts.d.mts",
+      "import": "./src/browser-contracts.mjs"
+    },
+    "./diagram-contracts": {
+      "types": "./src/diagram-contracts.d.mts",
+      "import": "./src/diagram-contracts.mjs"
+    },
+    "./design-contracts": {
+      "types": "./src/design-contracts.d.mts",
+      "import": "./src/design-contracts.mjs"
+    },
+    "./design-publication-contracts": {
+      "types": "./src/design-publication-contracts.d.mts",
+      "import": "./src/design-publication-contracts.mjs"
+    },
+    "./registries": {
+      "types": "./src/registries.d.mts",
+      "import": "./src/registries.mjs"
+    },
+    "./task-contracts": {
+      "types": "./src/task-contracts.d.mts",
+      "import": "./src/task-contracts.mjs"
+    },
+    "./planning-contracts": {
+      "types": "./src/planning-contracts.d.mts",
+      "import": "./src/planning-contracts.mjs"
+    },
+    "./dashboard/*": "./lib/dashboard/*",
+    "./operate-contract-catalog-v2": "./src/generated/contract-catalog-v2.mjs",
+    "./operate-experience-live-patch": "./src/compat/operate-experience-live-patch.mjs",
+    "./live-evidence-v2": "./src/compat/live-evidence-v2.mjs",
+    "./operating-planning-contracts": "./src/compat/operating-planning-contracts.mjs",
+    "./schemas/*": "./schemas/*",
+    "./registry/*": "./registry/*",
+    "./registries/*": "./registries/*",
+    "./package.json": "./package.json",
+    "./workspace-contracts": {
+      "types": "./src/workspace-contracts.d.mts",
+      "import": "./src/workspace-contracts.mjs"
+    },
+    "./review-experience-contracts": {
+      "types": "./src/review-experience-contracts.d.mts",
+      "import": "./src/review-experience-contracts.mjs"
+    },
+    "./enterprise-contracts": {
+      "types": "./src/enterprise-contracts.d.mts",
+      "import": "./src/enterprise-contracts.mjs"
+    }
+  },
+  "files": [
+    "schemas/**/*.json",
+    "registry/**/*.json",
+    "registries/**/*.json",
+    "lib/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "generate": "node scripts/generate-protocol-assets.mjs",
+    "check": "node scripts/generate-protocol-assets.mjs --check",
+    "test": "node --test ../../tests/protocol/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openplanr/OpenPlanr.git",
+    "directory": "packages/protocol"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "esbuild": "0.28.1",
+    "miniflare": "4.20260708.1",
+    "playwright": "1.61.1",
+    "typescript": "6.0.2"
+  }
+}

package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/registry/artifact-theme.json

@@ -0,0 +1,60 @@
+{
+  "schemaVersion": "1.0.0",
+  "name": "OpenPlanr Artifact Review",
+  "typography": {
+    "display": "Outfit",
+    "body": "DM Sans",
+    "mono": "Source Code Pro"
+  },
+  "layout": {
+    "toolbarHeight": 48,
+    "reviewRailWidth": 344,
+    "radiusSmall": 8,
+    "radiusMedium": 12,
+    "radiusLarge": 16,
+    "motionFastMs": 120,
+    "motionBaseMs": 180
+  },
+  "themes": {
+    "dark": {
+      "background": "#08080c",
+      "chrome": "#0e0e14",
+      "panel": "#141420",
+      "raised": "#1a1a2a",
+      "stage": "#0a0b0e",
+      "rule": "#222236",
+      "text": "#f4f4fa",
+      "textMuted": "#9999b8",
+      "primary": "#5eead4",
+      "primaryStrong": "#2dd4bf",
+      "warning": "#f59e0b",
+      "danger": "#f87171",
+      "onDanger": "#08080c",
+      "question": "#60a5fa",
+      "onQuestion": "#08080c",
+      "resolved": "#8e8eb4",
+      "onResolved": "#08080c",
+      "onImprove": "#08080c"
+    },
+    "light": {
+      "background": "#f6f7f9",
+      "chrome": "#ffffff",
+      "panel": "#fbfbfd",
+      "raised": "#f0f2f5",
+      "stage": "#e9edf2",
+      "rule": "#dfe3ea",
+      "text": "#171722",
+      "textMuted": "#65657d",
+      "primary": "#087f73",
+      "primaryStrong": "#06665d",
+      "warning": "#a85f00",
+      "danger": "#c53f4f",
+      "onDanger": "#ffffff",
+      "question": "#2563a8",
+      "onQuestion": "#ffffff",
+      "resolved": "#697386",
+      "onResolved": "#ffffff",
+      "onImprove": "#ffffff"
+    }
+  }
+}

package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/schemas/v1.0.0/design-manifest.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/design-manifest.schema.json",
+  "title": "OpenPlanr design manifest — finalized.json (v1.0.0)",
+  "description": "Metadata written alongside a generated design artifact by /planr-pipeline:design, at <design-dir>/finalized.json. The discriminator field is `design_format`, NOT `format` (the latter is a reserved JSON-Schema keyword). Cross-field rules (framework 'react' only for canvas) are enforced by lib/design/manifest.mjs validateManifest, not expressible in this schema subset.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "design_format",
+    "source",
+    "content_provenance",
+    "framework",
+    "screens",
+    "screen_count",
+    "iterations",
+    "generated_at"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0.0",
+      "description": "Schema version pin."
+    },
+    "design_format": {
+      "type": "string",
+      "enum": ["prototype", "walkthrough", "canvas"],
+      "description": "Which renderer produced the artifact."
+    },
+    "source": {
+      "type": "string",
+      "enum": ["spec", "png", "describe"],
+      "description": "How the design was sourced (mirrors the --from flag)."
+    },
+    "content_provenance": {
+      "type": "string",
+      "enum": ["spec", "inferred"],
+      "description": "Whether screen content came from the spec or was inferred to fill a thin spec."
+    },
+    "framework": {
+      "type": "string",
+      "enum": ["vanilla", "react"],
+      "description": "Render substrate. prototype/walkthrough = vanilla + Pretext; canvas = react."
+    },
+    "screens": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "description": "Ordered screen names rendered in the artifact."
+    },
+    "screen_count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Length of screens (denormalized for quick status reads)."
+    },
+    "iterations": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of evolve passes applied to this artifact."
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$"
+    },
+    "nav_mode": {
+      "type": "string",
+      "enum": ["anchor", "lazy"],
+      "description": "Walkthrough navigation mode; omitted for non-walkthrough formats."
+    },
+    "screen_name": {
+      "type": "string",
+      "description": "Primary screen / output-directory basename."
+    },
+    "branch": {
+      "type": "string",
+      "description": "Git branch at generation time."
+    },
+    "spec_id": {
+      "type": "string",
+      "description": "Owning SPEC/FEAT id (e.g. SPEC-015)."
+    },
+    "html_file": {
+      "type": "string",
+      "description": "Primary artifact filename (e.g. finalized.html, canvas.html)."
+    },
+    "pretext_tier": {
+      "type": "string",
+      "description": "Pretext API tier chosen for vanilla formats."
+    }
+  }
+}

package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/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/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/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}$" }
+      }
+    }
+  ]
+}

package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/protocol/schemas/v1.1.0/artifact-review.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/artifact-review.schema.json",
+  "title": "OpenPlanr immutable artifact 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" }
+        }
+      }
+    }
+  }
+}