@openplanr/protocol 0.12.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -79,6 +79,15 @@ and validators from `@openplanr/protocol/design-contracts`. Rendering and review
79
79
  belong to the design and artifact packages. Legacy manifests and frozen schema
80
80
  families retain their existing formats.
81
81
 
82
+ The additive `schemas/v1.20.0/design-document.schema.json` accepts optional
83
+ canvas board positions, section headings and content-sized frame heights. The
84
+ current design validator accepts authored `schemaVersion: "1.0.0"`, including
85
+ `height: "auto"`. Use auto-height frames for pages that scroll; any auto-height
86
+ frame makes `board-root-box-sizing`, `vertical-overflow` and `outside-frame`
87
+ errors throughout the document. Otherwise these checks are warnings and do not
88
+ block verification or handoff readiness. Layout and schema version never change
89
+ severity. The original Protocol 1.9 schema bytes are unchanged.
90
+
82
91
  Design comment categories are separate from the frozen artifact pin intent.
83
92
  Protocol 1.11 adds metadata payload `schemaVersion: "1.1.0"` for the explicit
84
93
  `change-request` category. `assertDesignReviewMetadata()` accepts both 1.0.0 and
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openplanr/protocol",
3
- "version": "0.12.0",
3
+ "version": "0.14.0",
4
4
  "type": "module",
5
5
  "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
6
6
  "license": "MIT",
@@ -119,6 +119,10 @@
119
119
  "./enterprise-journey-contracts": {
120
120
  "types": "./src/enterprise-journey-contracts.d.mts",
121
121
  "import": "./src/enterprise-journey-contracts.mjs"
122
+ },
123
+ "./shape-library-contracts": {
124
+ "types": "./src/shape-library-contracts.d.mts",
125
+ "import": "./src/shape-library-contracts.mjs"
122
126
  }
123
127
  },
124
128
  "files": [
@@ -147,9 +151,9 @@
147
151
  "access": "public"
148
152
  },
149
153
  "devDependencies": {
150
- "esbuild": "0.28.1",
151
- "miniflare": "4.20260708.1",
152
- "playwright": "1.61.1",
154
+ "esbuild": "0.28.2",
155
+ "miniflare": "4.20260730.0",
156
+ "playwright": "1.64.0",
153
157
  "typescript": "6.0.2"
154
158
  }
155
159
  }
@@ -314,7 +314,7 @@
314
314
  "ownerPackage": "openplanr",
315
315
  "source": {
316
316
  "path": "packages/cli/src/cli/commands/doctor.ts",
317
- "digest": "sha256:11a1b5732b15ab42862719f0924c57cd6c07b925b10bbe49a3b1c6356c7a3f8d"
317
+ "digest": "sha256:cdb7e033ae890130d47d06936d0e5b10f38a4b803c39f62abef72add38160e1e"
318
318
  },
319
319
  "authorityClass": "workflow",
320
320
  "machineJson": false,
@@ -356,7 +356,7 @@
356
356
  "ownerPackage": "openplanr",
357
357
  "source": {
358
358
  "path": "skills/planr-plan/SKILL.md",
359
- "digest": "sha256:1f4d7295484abacb0dbe8e0b59398248d9a7d272d9706a235d51bb3990ec9643"
359
+ "digest": "sha256:ee27dc8136cada6ffed75baa68ebdfd12c4d6414b069d4c89e627e4ec8beb68e"
360
360
  },
361
361
  "authorityClass": "workflow",
362
362
  "machineJson": false,
@@ -377,7 +377,7 @@
377
377
  "ownerPackage": "openplanr",
378
378
  "source": {
379
379
  "path": "docs/generated/utility-command-catalog.json",
380
- "digest": "sha256:af86a0898b4fe76e08a4078c7afe8f70094efdcd63e642a0d61ec02709d680b0"
380
+ "digest": "sha256:70f33f5d875899bb2c2b861b6c880aebda58c071d9c11abd3712362318974f15"
381
381
  },
382
382
  "authorityClass": "workflow",
383
383
  "machineJson": false,
@@ -482,7 +482,7 @@
482
482
  "ownerPackage": "openplanr",
483
483
  "source": {
484
484
  "path": "packages/cli/src/cli/commands/init-deterministic.ts",
485
- "digest": "sha256:1b0096935b968df8ee70985a7100dd39b6d79febbcdcf396e5b65466fe589a41"
485
+ "digest": "sha256:cef1f26019ce66c7caf2cfec5c995c96e259e40e1c893e8bcfd7ad54c56c3f39"
486
486
  },
487
487
  "authorityClass": "workflow",
488
488
  "machineJson": false,
@@ -566,7 +566,7 @@
566
566
  "ownerPackage": "openplanr",
567
567
  "source": {
568
568
  "path": "docs/generated/utility-command-catalog.json",
569
- "digest": "sha256:af86a0898b4fe76e08a4078c7afe8f70094efdcd63e642a0d61ec02709d680b0"
569
+ "digest": "sha256:70f33f5d875899bb2c2b861b6c880aebda58c071d9c11abd3712362318974f15"
570
570
  },
571
571
  "authorityClass": "workflow",
572
572
  "machineJson": true,
@@ -587,7 +587,7 @@
587
587
  "ownerPackage": "openplanr",
588
588
  "source": {
589
589
  "path": "skills/planr-plan/SKILL.md",
590
- "digest": "sha256:1f4d7295484abacb0dbe8e0b59398248d9a7d272d9706a235d51bb3990ec9643"
590
+ "digest": "sha256:ee27dc8136cada6ffed75baa68ebdfd12c4d6414b069d4c89e627e4ec8beb68e"
591
591
  },
592
592
  "authorityClass": "workflow",
593
593
  "machineJson": false,
@@ -1028,7 +1028,7 @@
1028
1028
  "ownerPackage": "planr-pipeline",
1029
1029
  "source": {
1030
1030
  "path": "skills/planr-design/SKILL.md",
1031
- "digest": "sha256:234ec0b1c7a983590982462a59df017647ed8d76e45727417534e483e2f5ab5b"
1031
+ "digest": "sha256:d4f027660fe2cc6e2a1bce254916fe65d01d0ad484f96eebb13f4711685143b8"
1032
1032
  },
1033
1033
  "authorityClass": "compatibility-router",
1034
1034
  "machineJson": false,
@@ -1091,7 +1091,7 @@
1091
1091
  "ownerPackage": "planr-pipeline",
1092
1092
  "source": {
1093
1093
  "path": "skills/planr-plan/SKILL.md",
1094
- "digest": "sha256:1f4d7295484abacb0dbe8e0b59398248d9a7d272d9706a235d51bb3990ec9643"
1094
+ "digest": "sha256:ee27dc8136cada6ffed75baa68ebdfd12c4d6414b069d4c89e627e4ec8beb68e"
1095
1095
  },
1096
1096
  "authorityClass": "compatibility-router",
1097
1097
  "machineJson": false,
@@ -1112,7 +1112,7 @@
1112
1112
  "ownerPackage": "planr-pipeline",
1113
1113
  "source": {
1114
1114
  "path": "skills/planr-ship/SKILL.md",
1115
- "digest": "sha256:4a2a029a2a3557a621da8816c6905d7cfc19921da9ca74516838a2aff9f94245"
1115
+ "digest": "sha256:a1f65ddec4596070d9627e40d3cb4a1b59470bc1dd97ed68b1962aa30224b6ad"
1116
1116
  },
1117
1117
  "authorityClass": "compatibility-router",
1118
1118
  "machineJson": false,
@@ -1133,7 +1133,7 @@
1133
1133
  "ownerPackage": "planr-pipeline",
1134
1134
  "source": {
1135
1135
  "path": "skills/planr-status/SKILL.md",
1136
- "digest": "sha256:d1d4ef34075312827cf9a4a67896977ed1608c1bf8881b8a8ed164340034c0cc"
1136
+ "digest": "sha256:09683973f4415f5356e9ab57b61df93106c4a2bc886e8b64e409fcfb539ad885"
1137
1137
  },
1138
1138
  "authorityClass": "compatibility-router",
1139
1139
  "machineJson": false,
@@ -1154,7 +1154,7 @@
1154
1154
  "ownerPackage": "planr-pipeline",
1155
1155
  "source": {
1156
1156
  "path": "skills/planr-sync/SKILL.md",
1157
- "digest": "sha256:0e63252ba06b2842f7d6005782056100930a1559ae393164d7afd615df63384b"
1157
+ "digest": "sha256:4fb542bc7a0685904b6d6f58ec9fae3c539531793e1933474fbc3c3d34702e24"
1158
1158
  },
1159
1159
  "authorityClass": "compatibility-router",
1160
1160
  "machineJson": false,
@@ -1948,5 +1948,5 @@
1948
1948
  ]
1949
1949
  }
1950
1950
  ],
1951
- "documentDigest": "sha256:735f3c5f9f5e3b1a14ea614361083192768652bd993ea0e47cda9384f1c85da1"
1951
+ "documentDigest": "sha256:7f82307cddbb39e34a8c2399a6fbb950f0e1a293756201cc46896e7dc59a0edc"
1952
1952
  }
@@ -373,6 +373,67 @@
373
373
  "evaluation/skills/migrations/planr-cmo-review.json"
374
374
  ]
375
375
  },
376
+ {
377
+ "skillId": "planr-connect",
378
+ "skillVersion": "1.0.0",
379
+ "description": "Report which chat, project tracker and source control connections the host has, and guide connecting the missing ones through the host. Use when the user wants to connect a service for OpenPlanr or asks what is connected.",
380
+ "lifecycle": "active",
381
+ "authorityClass": "diagnostic",
382
+ "source": "skills/planr-connect/openplanr.skill.json",
383
+ "sourceDigest": "sha256:e231e5a446e409f860079f4df07c7abb5d160f35b578c4252516094e100d3994",
384
+ "triggerPolicy": {
385
+ "include": [
386
+ "Connect chat, a project tracker or source control for OpenPlanr",
387
+ "Check which services OpenPlanr can reach through the host's connections"
388
+ ],
389
+ "exclude": [
390
+ "Diagnose OpenPlanr installation or runtime health",
391
+ "Synchronize planning artifacts with a tracker"
392
+ ],
393
+ "deferTo": []
394
+ },
395
+ "contracts": {
396
+ "inputs": [],
397
+ "outputs": [
398
+ {
399
+ "id": "connect-result",
400
+ "version": "1.0.0"
401
+ }
402
+ ]
403
+ },
404
+ "cliRequirements": [],
405
+ "ruleIds": [
406
+ "R1",
407
+ "R5",
408
+ "R7"
409
+ ],
410
+ "contributionManifestRefs": [
411
+ "packages/skill-runtime/contributions/workflows.json"
412
+ ],
413
+ "hosts": [
414
+ {
415
+ "host": "claude-code",
416
+ "entrypoint": "/planr:connect",
417
+ "path": "dist/plugins/claude/openplanr/skills/connect/SKILL.md"
418
+ },
419
+ {
420
+ "host": "codex",
421
+ "entrypoint": "$planr:connect",
422
+ "path": "dist/plugins/openai/openplanr/skills/connect/SKILL.md"
423
+ },
424
+ {
425
+ "host": "cursor",
426
+ "entrypoint": "planr-connect",
427
+ "path": "dist/plugins/cursor/openplanr/rules/planr-connect.mdc"
428
+ }
429
+ ],
430
+ "testRefs": [
431
+ "tests/protocol/skill-catalog.test.mjs"
432
+ ],
433
+ "certificationRefs": [
434
+ "evaluation/skills/migrations/planr-connect.json"
435
+ ]
436
+ },
376
437
  {
377
438
  "skillId": "planr-coo-review",
378
439
  "skillVersion": "2.0.1",
@@ -694,7 +755,7 @@
694
755
  "lifecycle": "active",
695
756
  "authorityClass": "planning-write",
696
757
  "source": "skills/planr-design/openplanr.skill.json",
697
- "sourceDigest": "sha256:ec8ec0d5e7abf163604ba3932112c626480bc49613ec07bf2e9046f03633db2c",
758
+ "sourceDigest": "sha256:99baa3d561a0e0e603c8617e1ccce8e0cab27c6cd1304e47f6fd57379076bb95",
698
759
  "triggerPolicy": {
699
760
  "include": [
700
761
  "Create an initial product design direction",
@@ -755,7 +816,7 @@
755
816
  "lifecycle": "active",
756
817
  "authorityClass": "planning-write",
757
818
  "source": "skills/planr-design-loop/openplanr.skill.json",
758
- "sourceDigest": "sha256:8ef5762d5a6618b4ed0352d03e751f02fc99b7219a797650a538b284e09ef604",
819
+ "sourceDigest": "sha256:a1c876dc9bd9770ea7d5c43c8696f3be2e252dd52d084e9411b1d4842f25e636",
759
820
  "triggerPolicy": {
760
821
  "include": [
761
822
  "Explore multiple design directions or variants",
@@ -816,7 +877,7 @@
816
877
  "lifecycle": "active",
817
878
  "authorityClass": "review-evidence",
818
879
  "source": "skills/planr-design-review/openplanr.skill.json",
819
- "sourceDigest": "sha256:ffea22b6ec59f0d48cfc3cc02689f62e59e69f33eba9135e6a2427515d722377",
880
+ "sourceDigest": "sha256:96d799efff004279b4726b0a285d42b660e3aff5527aa8e2a7ddf8fcee1a67c4",
820
881
  "triggerPolicy": {
821
882
  "include": [
822
883
  "Review or critique an existing OpenPlanr design",
@@ -1004,7 +1065,7 @@
1004
1065
  "lifecycle": "active",
1005
1066
  "authorityClass": "diagnostic",
1006
1067
  "source": "skills/planr-investigate/openplanr.skill.json",
1007
- "sourceDigest": "sha256:7b594b78a18409eb195a7bb8a2c189c06cf9e8022361a82a2f7e344abb9e5f95",
1068
+ "sourceDigest": "sha256:ad1422ac497f638b739d362a93af8eddc9cd0634c8a737a2c408023bd5cb9797",
1008
1069
  "triggerPolicy": {
1009
1070
  "include": [
1010
1071
  "Investigate a bug, regression, error, or unexplained behavior",
@@ -1424,6 +1485,67 @@
1424
1485
  "evaluation/skills/migrations/planr-release.json"
1425
1486
  ]
1426
1487
  },
1488
+ {
1489
+ "skillId": "planr-share",
1490
+ "skillVersion": "1.0.0",
1491
+ "description": "Share a status report, sprint note or release notes with the team as a chat message draft that the user approves and sends. Use when the user asks to post a planning update to chat.",
1492
+ "lifecycle": "active",
1493
+ "authorityClass": "external-write",
1494
+ "source": "skills/planr-share/openplanr.skill.json",
1495
+ "sourceDigest": "sha256:832195e643d77f5457d468a530c76512935b4df0d6acf7ab5f3d88b06338c4b2",
1496
+ "triggerPolicy": {
1497
+ "include": [
1498
+ "Share the delivery status, sprint note or release notes with the team in chat",
1499
+ "Post a planning update to a chat channel as a draft"
1500
+ ],
1501
+ "exclude": [
1502
+ "Report delivery status without sharing it",
1503
+ "Write or publish release notes"
1504
+ ],
1505
+ "deferTo": []
1506
+ },
1507
+ "contracts": {
1508
+ "inputs": [],
1509
+ "outputs": [
1510
+ {
1511
+ "id": "share-result",
1512
+ "version": "1.0.0"
1513
+ }
1514
+ ]
1515
+ },
1516
+ "cliRequirements": [],
1517
+ "ruleIds": [
1518
+ "R1",
1519
+ "R5",
1520
+ "R7"
1521
+ ],
1522
+ "contributionManifestRefs": [
1523
+ "packages/skill-runtime/contributions/workflows.json"
1524
+ ],
1525
+ "hosts": [
1526
+ {
1527
+ "host": "claude-code",
1528
+ "entrypoint": "/planr:share",
1529
+ "path": "dist/plugins/claude/openplanr/skills/share/SKILL.md"
1530
+ },
1531
+ {
1532
+ "host": "codex",
1533
+ "entrypoint": "$planr:share",
1534
+ "path": "dist/plugins/openai/openplanr/skills/share/SKILL.md"
1535
+ },
1536
+ {
1537
+ "host": "cursor",
1538
+ "entrypoint": "planr-share",
1539
+ "path": "dist/plugins/cursor/openplanr/rules/planr-share.mdc"
1540
+ }
1541
+ ],
1542
+ "testRefs": [
1543
+ "tests/protocol/skill-catalog.test.mjs"
1544
+ ],
1545
+ "certificationRefs": [
1546
+ "evaluation/skills/migrations/planr-share.json"
1547
+ ]
1548
+ },
1427
1549
  {
1428
1550
  "skillId": "planr-ship",
1429
1551
  "skillVersion": "1.2.1",
@@ -1431,7 +1553,7 @@
1431
1553
  "lifecycle": "active",
1432
1554
  "authorityClass": "implementation",
1433
1555
  "source": "skills/planr-ship/openplanr.skill.json",
1434
- "sourceDigest": "sha256:548373bee9817aa5649f53c6964b8911666c29aa9a55b5e6a7288ef12482179b",
1556
+ "sourceDigest": "sha256:2fe2353469bb1fbb77029334fcc51b94240bb3baf56c69c5829b47908e2d7d33",
1435
1557
  "triggerPolicy": {
1436
1558
  "include": [
1437
1559
  "Implement a plan, specification, task, fix, or clearly stated local request",
@@ -1563,7 +1685,7 @@
1563
1685
  "lifecycle": "active",
1564
1686
  "authorityClass": "planning-write",
1565
1687
  "source": "skills/planr-sprint/openplanr.skill.json",
1566
- "sourceDigest": "sha256:62a62e58bc27242c36c06e170bd875d38ceb1457e467556839e1a80e26a459c9",
1688
+ "sourceDigest": "sha256:95efe995ab6cd8ed38b09b6d503223d34ea4111de92117346c7984603502b895",
1567
1689
  "triggerPolicy": {
1568
1690
  "include": [
1569
1691
  "Refine the open backlog and select what fits the next sprint or release cut",
@@ -1625,7 +1747,7 @@
1625
1747
  "lifecycle": "active",
1626
1748
  "authorityClass": "read-only-view",
1627
1749
  "source": "skills/planr-status/openplanr.skill.json",
1628
- "sourceDigest": "sha256:414afb2187111d04a1c3030f28c7b20a58ad7b4eb3e0e724852a34e152ecceae",
1750
+ "sourceDigest": "sha256:e6c422eacd009a5db91e038fded747cfe25badae06e5cbde13775982dd258e01",
1629
1751
  "triggerPolicy": {
1630
1752
  "include": [
1631
1753
  "Report current OpenPlanr delivery status or outstanding work",
@@ -1686,7 +1808,7 @@
1686
1808
  "lifecycle": "active",
1687
1809
  "authorityClass": "planning-write",
1688
1810
  "source": "skills/planr-sync/openplanr.skill.json",
1689
- "sourceDigest": "sha256:e45162758f758bae447c126d121ec1a220b40e03bd09a14b9b4fc2e6643f53da",
1811
+ "sourceDigest": "sha256:c8061714181e6f4e330c65ba033a3586bf4118352e778865e3e3e0e802ad2cf6",
1690
1812
  "triggerPolicy": {
1691
1813
  "include": [
1692
1814
  "Audit planning artifacts for graph, schema, or protocol drift",
@@ -1742,5 +1864,5 @@
1742
1864
  }
1743
1865
  ],
1744
1866
  "compatibilityAliases": [],
1745
- "documentDigest": "sha256:163ce04f19cd71e9f2ed50eaa85085cd0c0e061570bda19c9c925350982b5764"
1867
+ "documentDigest": "sha256:7201c5ca3f0b6820214e18c4f6a5268e30b9b5be897ff092bb95e196230dbf0b"
1746
1868
  }