@openplanr/protocol 0.2.0

package/registries/rules.json

@@ -0,0 +1,261 @@
+{
+  "kind": "rule-catalog",
+  "schemaVersion": "1.0.0",
+  "protocolVersion": "1.5.0",
+  "documentVersion": "1.0.0",
+  "digestAlgorithm": "sha256",
+  "canonicalization": "rfc8785",
+  "rules": [
+    {
+      "ruleId": "R1",
+      "ruleVersion": "1.0.0",
+      "title": "Request-directed workflow",
+      "status": "active",
+      "normativeText": "Planning requests produce planning artifacts. Implementation requests continue through code and the relevant engineering checks.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/plan-ship-boundary.mjs",
+          "symbol": "plan-ship-boundary"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R10",
+      "ruleVersion": "1.0.0",
+      "title": "Role QA parity",
+      "status": "active",
+      "normativeText": "No role is releasable without corresponding QA verification coverage and generated adapter parity.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/role-parity.mjs",
+          "symbol": "role-parity"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R2",
+      "ruleVersion": "1.0.0",
+      "title": "Bounded story decomposition",
+      "status": "active",
+      "normativeText": "A story produces at most two implementation tasks: frontend and backend when design or UI input exists, otherwise one backend task.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/task-decomposition.mjs",
+          "symbol": "task-decomposition"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R3",
+      "ruleVersion": "1.0.0",
+      "title": "Portable capability tiers",
+      "status": "active",
+      "normativeText": "Roles use registry-owned capability tiers and adapters own host model mapping; vendor model names are not protocol truth.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/role-resolution.mjs",
+          "symbol": "role-resolution"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R4",
+      "ruleVersion": "1.0.0",
+      "title": "Generated task custody",
+      "status": "active",
+      "normativeText": "Generated task documents are not manually edited; their reviewed parent source is corrected and deterministic generation is rerun.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/task-generation.mjs",
+          "symbol": "task-generation"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R5",
+      "ruleVersion": "1.0.0",
+      "title": "Immutable Preserve boundaries",
+      "status": "active",
+      "normativeText": "Every Preserve repository path is immutable for the complete task and SHIP run and is verified against its bound baseline.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/preserve-verification.mjs",
+          "symbol": "preserve-verification"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R6",
+      "ruleVersion": "1.0.0",
+      "title": "Adaptive recovery",
+      "status": "active",
+      "normativeText": "Use command results and diagnostics to choose useful corrections, continue while meaningful engineering progress is possible, and report a genuine impasse with the relevant error context.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/adaptive-recovery.mjs",
+          "symbol": "adaptive-recovery"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R7",
+      "ruleVersion": "1.0.0",
+      "title": "Proportional verification",
+      "status": "active",
+      "normativeText": "Local work uses verification proportional to its risk and directly corrects relevant failures. Dedicated release certification owns release closure.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/ship-closure.mjs",
+          "symbol": "ship-closure"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R8",
+      "ruleVersion": "1.0.0",
+      "title": "Read-only database inspection",
+      "status": "active",
+      "normativeText": "Database inspection is read-only and cannot issue DDL, DML, or any external mutation.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/database-authority.mjs",
+          "symbol": "database-authority"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    },
+    {
+      "ruleId": "R9",
+      "ruleVersion": "1.0.0",
+      "title": "Implementation ownership",
+      "status": "active",
+      "normativeText": "Frontend and backend ownership boundaries are binding; companion changes must be acceptance-required, disclosed, and outside Preserve.",
+      "enforcementPoints": [
+        {
+          "package": "@openplanr/pipeline",
+          "path": "packages/pipeline/lib/pipeline/ownership-boundary.mjs",
+          "symbol": "ownership-boundary"
+        }
+      ],
+      "testRefs": [
+        "tests/protocol/rule-catalog.test.mjs"
+      ],
+      "citedBy": [
+        "docs/rules.md",
+        "agents/shared/rules.md"
+      ],
+      "source": {
+        "path": "docs/rules.md",
+        "digest": "sha256:93a84c9011d50aa002659d20b8955faf1f316da3d59257570bfef16b57a81f20"
+      }
+    }
+  ],
+  "documentDigest": "sha256:b66d52fcdafac4eac1f7d11f54666d32bdcc78a55662550305e88ccb3f429480"
+}

package/registries/skill-host-profiles.json

@@ -0,0 +1,247 @@
+{
+  "kind": "skill-host-profile-registry",
+  "schemaVersion": "1.1.0",
+  "protocolVersion": "1.7.0",
+  "documentVersion": "1.1.0",
+  "digestAlgorithm": "sha256",
+  "canonicalization": "rfc8785",
+  "profiles": [
+    {
+      "hostProfileId": "claude-code-default",
+      "hostProfileVersion": "1.0.0",
+      "host": "claude-code",
+      "description": "Claude Code profile with native questions and portable interactive fallbacks.",
+      "authorityCeiling": {
+        "repositoryAccess": "read-only",
+        "externalDataAccess": "none",
+        "allowedCapabilities": [
+          "read"
+        ],
+        "allowedTools": [
+          "read"
+        ],
+        "allowedOperations": [
+          "render"
+        ],
+        "allowedOutputClasses": [
+          "A"
+        ],
+        "forbiddenEffects": [
+          "network-write"
+        ]
+      },
+      "source": {
+        "path": "packages/protocol/host-profiles/claude-code.md",
+        "digest": "sha256:00ff4377d76f438c453547e24484d197d60e6830fba17e17a9e6051293efc030"
+      },
+      "overlayModules": [],
+      "runtimeCapabilities": [
+        "attached-terminal",
+        "native-questions",
+        "structured-chat"
+      ],
+      "interactionBindings": [
+        {
+          "surface": "native",
+          "protocolInteraction": "native",
+          "capabilityId": "native-questions"
+        },
+        {
+          "surface": "chat",
+          "protocolInteraction": "chat",
+          "capabilityId": "structured-chat"
+        },
+        {
+          "surface": "terminal",
+          "protocolInteraction": "terminal",
+          "capabilityId": "attached-terminal"
+        },
+        {
+          "surface": "headless",
+          "protocolInteraction": "none"
+        }
+      ]
+    },
+    {
+      "hostProfileId": "codex-default",
+      "hostProfileVersion": "1.0.0",
+      "host": "codex",
+      "description": "Codex profile with composer questions and portable interactive fallbacks.",
+      "authorityCeiling": {
+        "repositoryAccess": "read-only",
+        "externalDataAccess": "none",
+        "allowedCapabilities": [
+          "read"
+        ],
+        "allowedTools": [
+          "read"
+        ],
+        "allowedOperations": [
+          "render"
+        ],
+        "allowedOutputClasses": [
+          "A"
+        ],
+        "forbiddenEffects": [
+          "network-write"
+        ]
+      },
+      "source": {
+        "path": "packages/protocol/host-profiles/codex.md",
+        "digest": "sha256:fe7f1efa8a4ef5b4c51765e270cfc68368b060fdecb54148bdf1874688f01007"
+      },
+      "overlayModules": [],
+      "runtimeCapabilities": [
+        "attached-terminal",
+        "native-questions",
+        "structured-chat"
+      ],
+      "interactionBindings": [
+        {
+          "surface": "native",
+          "protocolInteraction": "native",
+          "capabilityId": "native-questions"
+        },
+        {
+          "surface": "chat",
+          "protocolInteraction": "chat",
+          "capabilityId": "structured-chat"
+        },
+        {
+          "surface": "terminal",
+          "protocolInteraction": "terminal",
+          "capabilityId": "attached-terminal"
+        },
+        {
+          "surface": "headless",
+          "protocolInteraction": "none"
+        }
+      ]
+    },
+    {
+      "hostProfileId": "cursor-default",
+      "hostProfileVersion": "1.0.0",
+      "host": "cursor",
+      "description": "Cursor profile with structured chat and attached-terminal fallbacks.",
+      "authorityCeiling": {
+        "repositoryAccess": "read-only",
+        "externalDataAccess": "none",
+        "allowedCapabilities": [
+          "read"
+        ],
+        "allowedTools": [
+          "read"
+        ],
+        "allowedOperations": [
+          "render"
+        ],
+        "allowedOutputClasses": [
+          "A"
+        ],
+        "forbiddenEffects": [
+          "network-write"
+        ]
+      },
+      "source": {
+        "path": "packages/protocol/host-profiles/cursor.md",
+        "digest": "sha256:a57cd97781cf646c4150da44235ddbd0b7904db3bbf009855a7ea022f6545098"
+      },
+      "overlayModules": [],
+      "runtimeCapabilities": [
+        "attached-terminal",
+        "structured-chat"
+      ],
+      "interactionBindings": [
+        {
+          "surface": "chat",
+          "protocolInteraction": "chat",
+          "capabilityId": "structured-chat"
+        },
+        {
+          "surface": "terminal",
+          "protocolInteraction": "terminal",
+          "capabilityId": "attached-terminal"
+        },
+        {
+          "surface": "headless",
+          "protocolInteraction": "none"
+        }
+      ]
+    },
+    {
+      "hostProfileId": "pipeline-default",
+      "hostProfileVersion": "1.0.0",
+      "host": "pipeline",
+      "description": "Host-neutral pipeline projection profile; narrows to read-only repository access.",
+      "authorityCeiling": {
+        "repositoryAccess": "read-only",
+        "externalDataAccess": "none",
+        "allowedCapabilities": [
+          "read"
+        ],
+        "allowedTools": [
+          "read"
+        ],
+        "allowedOperations": [
+          "render"
+        ],
+        "allowedOutputClasses": [
+          "A"
+        ],
+        "forbiddenEffects": [
+          "network-write"
+        ]
+      },
+      "source": {
+        "path": "packages/protocol/host-profiles/pipeline.md",
+        "digest": "sha256:f5039bb4c67fac1e934ed803d0728723806a6712b53c5dd3c99ce6144ffb5482"
+      },
+      "overlayModules": []
+    },
+    {
+      "hostProfileId": "pipeline-default",
+      "hostProfileVersion": "1.1.0",
+      "host": "pipeline",
+      "description": "Host-neutral pipeline profile with terminal and headless fallbacks.",
+      "authorityCeiling": {
+        "repositoryAccess": "read-only",
+        "externalDataAccess": "none",
+        "allowedCapabilities": [
+          "read"
+        ],
+        "allowedTools": [
+          "read"
+        ],
+        "allowedOperations": [
+          "render"
+        ],
+        "allowedOutputClasses": [
+          "A"
+        ],
+        "forbiddenEffects": [
+          "network-write"
+        ]
+      },
+      "source": {
+        "path": "packages/protocol/host-profiles/pipeline-capabilities.md",
+        "digest": "sha256:5f032622114c45adb510d85b73a019b9a0e2a347b868dff82440445e463c1a1f"
+      },
+      "overlayModules": [],
+      "runtimeCapabilities": [
+        "attached-terminal"
+      ],
+      "interactionBindings": [
+        {
+          "surface": "terminal",
+          "protocolInteraction": "terminal",
+          "capabilityId": "attached-terminal"
+        },
+        {
+          "surface": "headless",
+          "protocolInteraction": "none"
+        }
+      ]
+    }
+  ],
+  "documentDigest": "sha256:e1b8a3c4e1b3d66bc01bb1c0cf0b43591e596e232f1330285083b00a93b38db2"
+}