FE-1509: Document the Notebook view and register it with the AI assistant

[kube]

Important

User guide, AI-assistant registration, and the stack's changeset.

Summary

Before this PR, the Notebook view ships undocumented. The in-app AI assistant reads the user guide at runtime through its docs tool, so a missing page means the assistant cannot answer questions about the view at all.

Adds the Notebook View guide page covering cells, in-place editing, keyboard flow, badges, and the graph explorer, links it from the guide index, and registers it with the assistant's docs tool. Carries the stack's one patch changeset.

Links

• Ticket FE-1509
• Docs Notebook View guide

Changes

• New notebook-view.md user guide page

  Cells and their summaries, per-cell keyboard navigation, in-place editing, the badges, search and ordering, dependency lines, and the graph explorer.

• Guide index gains the page and a fourth mode bullet

  Visual settings page documents the Notebook view toggle.

• Page registered with the AI assistant's docs tool

  Name, summary and raw content entry; the ai.test.ts and petrinaut-docs-content.test.ts suites enforce all three stay in step.

• One patch changeset for the notebook feature

Test coverage

• ai.test.ts, petrinaut-docs-content.test.ts:

  Every registered doc name has a summary and a content entry.

How to test

• Open Petrinaut preview on Vercel
• Viewport controls > Settings > Notebook view
• Top bar > Notebook
• Compare behaviour against the guide page
• AI assistant > ask how to use the Notebook view
• Expect an answer grounded in the page

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hash	Ready	Preview	Sep 3, 2026 11:44pm UTC
petrinaut	Ready	Preview	Sep 3, 2026 11:44pm UTC
petrinaut-docs	Ready	Preview	Sep 3, 2026 11:44pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Sep 3, 2026 11:44pm UTC

[semgrep-code-hashintel]

Semgrep found 2 detect-non-literal-regexp findings:

• libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts
  • L196 - Triage
  • L196 - Triage

RegExp() called with a variableName function argument, this might allow an attacker to cause a Regular Expression Denial-of-Service (ReDoS) within your application as RegExP blocks the main thread. For this reason, it is recommended to use hardcoded regexes instead. If your regex is run on user-controlled input, consider performing input validation or use a regex checking/sanitization library such as https://www.npmjs.com/package/recheck to verify that the regex does not appear vulnerable to ReDoS.

View Dataflow Graph

flowchart LR
    classDef invis fill:white, stroke: none
    classDef default fill:#e7f5ff, color:#1c7fd6, stroke: none

    subgraph File0["<b>libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts</b>"]
        direction LR
        %% Source

        subgraph Source
            direction LR

            v0["<a href=https://github.com/hashintel/hash/blob/37624eb2e9bcfe0d83be67cd886a346f2019f70f/libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts#L191 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 191] variableName</a>"]
        end
        %% Intermediate

        subgraph Traces0[Traces]
            direction TB

            v2["<a href=https://github.com/hashintel/hash/blob/37624eb2e9bcfe0d83be67cd886a346f2019f70f/libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts#L191 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 191] variableName</a>"]

            v3["<a href=https://github.com/hashintel/hash/blob/37624eb2e9bcfe0d83be67cd886a346f2019f70f/libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts#L196 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 196] escapeRegExp</a>"]

            v4["<a href=https://github.com/hashintel/hash/blob/37624eb2e9bcfe0d83be67cd886a346f2019f70f/libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts#L184 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 184] value</a>"]

            v5["<a href=https://github.com/hashintel/hash/blob/37624eb2e9bcfe0d83be67cd886a346f2019f70f/libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts#L196 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 196] `</a>"]
        end
            v2 --> v3
            v3 --> v4
            v4 --> v5
        %% Sink

        subgraph Sink
            direction LR

            v1["<a href=https://github.com/hashintel/hash/blob/37624eb2e9bcfe0d83be67cd886a346f2019f70f/libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts#L196 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 196] new RegExp(`\\b${escapeRegExp(variableName)}\\b`, &quot;u&quot;)</a>"]
        end
    end
    %% Class Assignment
    Source:::invis
    Sink:::invis

    Traces0:::invis
    File0:::invis

    %% Connections

    Source --> Traces0
    Traces0 --> Sink

Loading

Semgrep found 1 regex_dos finding:

• libs/@hashintel/petrinaut/src/ui/views/Notebook/notebook-model.ts
  • L196 - Triage

Ensure that the regex used to compare with user supplied input is safe from regular expression denial of service.