@firedrill-tools/notion 0.1.1

package/firedrill/notion-workspace-read.drill.json

@@ -0,0 +1,258 @@
+{
+  "schemaVersion": 1,
+  "id": "notion-workspace-read",
+  "title": "Read the workspace: users, search, pages, blocks, databases, property items, markdown (pagination and validation errors)",
+  "targetId": "conformance-agent",
+  "scenarioId": "baseline",
+  "actorId": "member",
+  "task": {
+    "instruction": "Run the workspace-read conformance flow against the synthetic Notion Tool and fail loudly on any unexpected status, header or body."
+  },
+  "assertions": [
+    {
+      "id": "workspace-context-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "workspace.context"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "users-me-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "users.me"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "users-list-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "users.list"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "users-get-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "users.get"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "search-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "search"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-retrieve-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.retrieve"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "blocks-retrieve-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "blocks.retrieve"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "blocks-children-list-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "blocks.children.list"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-retrieve-property-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.retrieve-property"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-retrieve-markdown-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.retrieve-markdown"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "databases-retrieve-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "databases.retrieve"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "data-sources-retrieve-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "data-sources.retrieve"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "data-sources-query-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "data-sources.query"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "search-validation-errors",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "search"
+      },
+      "outcomes": [
+        "tool_error"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 2
+      }
+    },
+    {
+      "id": "pages-retrieve-property-validation-errors",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.retrieve-property"
+      },
+      "outcomes": [
+        "tool_error"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-unchanged",
+      "kind": "state.count",
+      "packageId": "notion",
+      "namespace": "pages",
+      "comparison": {
+        "operator": "equals",
+        "value": 28
+      }
+    },
+    {
+      "id": "blocks-unchanged",
+      "kind": "state.count",
+      "packageId": "notion",
+      "namespace": "blocks",
+      "comparison": {
+        "operator": "equals",
+        "value": 49
+      }
+    }
+  ]
+}

package/firedrill/notion-write-unavailable.drill.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 1,
+  "id": "notion-write-unavailable",
+  "title": "pages.create, pages.update, blocks.children.append and comments.create answer 503 without writing",
+  "targetId": "conformance-agent",
+  "scenarioId": "write-unavailable",
+  "actorId": "member",
+  "task": {
+    "instruction": "Run the write-unavailable conformance flow against the synthetic Notion Tool and fail loudly on any unexpected status, header or body."
+  },
+  "assertions": [
+    {
+      "id": "pages-create-error",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.create"
+      },
+      "outcomes": [
+        "tool_error"
+      ],
+      "comparison": {
+        "operator": "equals",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-update-error",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.update"
+      },
+      "outcomes": [
+        "tool_error"
+      ],
+      "comparison": {
+        "operator": "equals",
+        "value": 1
+      }
+    },
+    {
+      "id": "blocks-children-append-error",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "blocks.children.append"
+      },
+      "outcomes": [
+        "tool_error"
+      ],
+      "comparison": {
+        "operator": "equals",
+        "value": 1
+      }
+    },
+    {
+      "id": "comments-create-error",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "comments.create"
+      },
+      "outcomes": [
+        "tool_error"
+      ],
+      "comparison": {
+        "operator": "equals",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-create-never-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.create"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "equals",
+        "value": 0
+      }
+    },
+    {
+      "id": "pages-retrieve-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "pages.retrieve"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "blocks-update-ok",
+      "kind": "operation.count",
+      "operation": {
+        "packageId": "notion",
+        "operationId": "blocks.update"
+      },
+      "outcomes": [
+        "ok"
+      ],
+      "comparison": {
+        "operator": "greater_than_or_equal",
+        "value": 1
+      }
+    },
+    {
+      "id": "pages-unchanged",
+      "kind": "state.count",
+      "packageId": "notion",
+      "namespace": "pages",
+      "comparison": {
+        "operator": "equals",
+        "value": 28
+      }
+    },
+    {
+      "id": "comments-unchanged",
+      "kind": "state.count",
+      "packageId": "notion",
+      "namespace": "comments",
+      "comparison": {
+        "operator": "equals",
+        "value": 6
+      }
+    },
+    {
+      "id": "blocks-unchanged",
+      "kind": "state.count",
+      "packageId": "notion",
+      "namespace": "blocks",
+      "comparison": {
+        "operator": "equals",
+        "value": 49
+      }
+    },
+    {
+      "id": "page-created-events",
+      "kind": "event.count",
+      "event": {
+        "packageId": "notion",
+        "eventId": "page.created"
+      },
+      "phase": "emitted",
+      "comparison": {
+        "operator": "equals",
+        "value": 0
+      }
+    }
+  ]
+}

package/firedrill/rate-limited.scenario.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "id": "rate-limited",
+  "title": "search, data-sources.query, blocks.children.list and pages.retrieve answer 429 rate_limited with Retry-After",
+  "faults": [
+    {
+      "packageId": "notion",
+      "faultId": "rate-limited"
+    }
+  ]
+}

package/firedrill/tools/notion/app/assets/ATTRIBUTION.md

@@ -0,0 +1,35 @@
+# Third-party assets used by the Notion Tool app
+
+The browser app is served from `../site/`. This directory keeps the attribution record, the font licence and the
+original downloads; the copies under `../site/assets/` are byte-identical (the framework serves only
+html/css/js/json/image/font files, so this Markdown file and the licence text cannot live inside the served root).
+
+## Logos (trademarks of Notion Labs, Inc.)
+
+| file | served copy | source | brand version |
+|---|---|---|---|
+| `notion.svg` | `../site/assets/notion.svg` | https://logos.lndev.me/logos/notion.svg (library: https://github.com/ln-dev7/logos-apps) | The current Notion product mark: the black "N" glyph on a white page with the folded top-left corner, in use since the 2018 rebrand and unchanged today (favicon, app icon, login page). |
+| `notion-wordmark.svg` | `../site/assets/notion-wordmark.svg` | https://logos.lndev.me/logos/notion-wordmark.svg (library: https://github.com/ln-dev7/logos-apps) | The same mark followed by the "Notion" wordmark in the brand's serif-free lettering, as shown on notion.com. |
+
+Downloaded on 2026-09-14 and used unmodified (no other `notion*` variants exist in the library's name list, so no
+superseded mark had to be rejected). Where they appear: `notion.svg` is the page favicon and the mark in the workspace
+switcher menu and the help popover; `notion-wordmark.svg` is shown on the "not connected" screen and in the help
+popover. Inside the app itself the sidebar shows the *workspace* icon and name, exactly as the real product does.
+
+Notion and the Notion logo are trademarks of Notion Labs, Inc. They identify the simulated service inside a test
+environment only; this package is not affiliated with or endorsed by Notion Labs, Inc.
+
+## Font
+
+| file | served copy | source | licence |
+|---|---|---|---|
+| `fonts/inter-latin.woff2` | `../site/assets/fonts/inter-latin.woff2` | https://fonts.gstatic.com/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2 (Inter v20, latin subset, variable weight axis, as served by https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700) | SIL Open Font License 1.1 — `fonts/OFL.txt` (copied from https://raw.githubusercontent.com/google/fonts/main/ofl/inter/OFL.txt) |
+
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter). Notion's web client renders its UI with the
+platform's system sans-serif stack; Inter is the closest permissively licensed match and is the face Notion itself
+lists in that stack, so the app declares `Inter, ui-sans-serif, -apple-system, "Segoe UI", Helvetica, Arial, sans-serif`.
+
+## Icons
+
+All interface icons in `../site/icons.js` are original monochrome SVG paths drawn for this package in the visual style
+of the product (1.5–2 px strokes, 20 px grid); none are copied from Notion.

package/firedrill/tools/notion/app/assets/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/firedrill/tools/notion/app/assets/notion-wordmark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 178"><path fill="#fff" d="M10.691 7.666L109.012.404c12.077-1.037 15.181-.338 22.774 5.183l31.386 22.11c5.177 3.803 6.9 4.84 6.9 8.98v121.26c0 7.6-2.76 12.095-12.42 12.782l-114.177 6.912c-7.25.344-10.703-.693-14.5-5.532L5.864 142.046C1.718 136.514 0 132.374 0 127.535V19.748C0 13.535 2.76 8.353 10.691 7.666"/><path d="M109.012.404L10.691 7.666C2.761 8.353 0 13.536 0 19.748v107.787c0 4.839 1.718 8.979 5.864 14.511L28.975 172.1c3.797 4.84 7.25 5.876 14.5 5.532l114.177-6.912c9.654-.687 12.42-5.182 12.42-12.782V36.677c0-3.928-1.551-5.059-6.118-8.411l-.788-.569l-31.38-22.11C124.193.067 121.09-.633 109.012.404M46.057 34.692c-9.323.628-11.437.77-16.732-3.536L15.862 20.447c-1.368-1.386-.681-3.115 2.766-3.459l94.519-6.906c7.936-.693 12.07 2.073 15.174 4.49l16.212 11.745c.693.35 2.416 2.417.343 2.417l-97.61 5.875zM35.188 156.901V53.96c0-4.496 1.38-6.57 5.515-6.919l112.11-6.562c3.802-.344 5.52 2.073 5.52 6.562v102.255c0 4.495-.693 8.298-6.9 8.641l-107.283 6.22c-6.207.343-8.962-1.724-8.962-7.256M141.091 59.48c.687 3.11 0 6.219-3.11 6.574l-5.17 1.025v76.004c-4.49 2.416-8.624 3.796-12.077 3.796c-5.52 0-6.9-1.73-11.035-6.906l-33.814-53.2v51.47l10.697 2.423s0 6.22-8.63 6.22l-23.792 1.38c-.693-1.387 0-4.84 2.41-5.527l6.214-1.724V72.96l-8.624-.698c-.693-3.11 1.03-7.6 5.863-7.95l25.528-1.717l35.183 53.887V68.808l-8.967-1.03c-.693-3.809 2.067-6.575 5.514-6.912zm104.322 66.39V79.02h.811l33.785 46.85h10.637V57.022h-11.828v46.803h-.811l-33.785-46.803h-10.679v68.842h11.876zm78.663 1.055c15.607 0 25.101-10.212 25.101-27.151c0-16.893-9.542-27.151-25.101-27.151c-15.507 0-25.096 10.306-25.096 27.15c0 16.94 9.447 27.152 25.096 27.152m0-9.927c-8.251 0-12.972-6.296-12.972-17.224c0-10.88 4.721-17.224 12.972-17.224c8.209 0 12.93 6.343 12.93 17.224c0 10.928-4.674 17.224-12.93 17.224m35.91-56.109v13.12h-8.25v9.447h8.25v28.484c0 10.116 4.775 14.173 16.75 14.173c2.287 0 4.485-.237 6.202-.574v-9.258c-1.433.142-2.34.237-4.01.237c-4.957 0-7.155-2.286-7.155-7.44V83.457h11.165V74.01h-11.165V60.883h-11.786zm30.042 64.981h11.787V73.671h-11.787zm5.87-60.829c3.909 0 7.06-3.157 7.06-7.113c0-3.963-3.145-7.161-7.06-7.161c-3.862 0-7.06 3.198-7.06 7.16c0 3.957 3.198 7.108 7.06 7.108zm38.25 61.884c15.601 0 25.096-10.212 25.096-27.151c0-16.893-9.542-27.151-25.096-27.151c-15.512 0-25.101 10.306-25.101 27.15c0 16.94 9.447 27.152 25.101 27.152m0-9.927c-8.256 0-12.983-6.296-12.983-17.224c0-10.88 4.727-17.224 12.983-17.224c8.204 0 12.93 6.343 12.93 17.224c0 10.928-4.679 17.224-12.93 17.224m32.138 8.872h11.835V95.48c0-7.683 4.442-12.551 11.496-12.551c7.208 0 10.543 4.01 10.543 11.976v30.965H512V92.092c0-12.456-6.35-19.47-17.988-19.47c-7.783 0-13.03 3.578-15.512 9.4h-.812v-8.35h-11.402z"/></svg>

package/firedrill/tools/notion/app/assets/notion.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 268"><path fill="#fff" d="M16.092 11.538L164.09.608c18.179-1.56 22.85-.508 34.28 7.801l47.243 33.282C253.406 47.414 256 48.975 256 55.207v182.527c0 11.439-4.155 18.205-18.696 19.24L65.44 267.378c-10.913.517-16.11-1.043-21.825-8.327L8.826 213.814C2.586 205.487 0 199.254 0 191.97V29.726c0-9.352 4.155-17.153 16.092-18.188"/><path d="M164.09.608L16.092 11.538C4.155 12.573 0 20.374 0 29.726v162.245c0 7.284 2.585 13.516 8.826 21.843l34.789 45.237c5.715 7.284 10.912 8.844 21.825 8.327l171.864-10.404c14.532-1.035 18.696-7.801 18.696-19.24V55.207c0-5.911-2.336-7.614-9.21-12.66l-1.185-.856L198.37 8.409C186.94.1 182.27-.952 164.09.608M69.327 52.22c-14.033.945-17.216 1.159-25.186-5.323L23.876 30.778c-2.06-2.086-1.026-4.69 4.163-5.207l142.274-10.395c11.947-1.043 18.17 3.12 22.842 6.758l24.401 17.68c1.043.525 3.638 3.637.517 3.637L71.146 52.095zm-16.36 183.954V81.222c0-6.767 2.077-9.887 8.3-10.413L230.02 60.93c5.724-.517 8.31 3.12 8.31 9.879v153.917c0 6.767-1.044 12.49-10.387 13.008l-161.487 9.361c-9.343.517-13.489-2.594-13.489-10.921M212.377 89.53c1.034 4.681 0 9.362-4.681 9.897l-7.783 1.542v114.404c-6.758 3.637-12.981 5.715-18.18 5.715c-8.308 0-10.386-2.604-16.609-10.396l-50.898-80.079v77.476l16.1 3.646s0 9.362-12.989 9.362l-35.814 2.077c-1.043-2.086 0-7.284 3.63-8.318l9.351-2.595V109.823l-12.98-1.052c-1.044-4.68 1.55-11.439 8.826-11.965l38.426-2.585l52.958 81.113v-71.76l-13.498-1.552c-1.043-5.733 3.111-9.896 8.3-10.404z"/></svg>