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

[kube]

🌟 What is the purpose of this PR?

Top of the Notebook view stack, stacked on #9408: the user guide page for the new view, its registration with the in-app AI assistant, and the stack's patch changeset.

🔗 Related links

• FE-1509 (internal)

🔍 What does this change?

• Adds docs/notebook-view.md (cells, keyboard and search, badges, ordering, the graph explorer, limits) and links it from the docs index and the visual settings page.
• Registers the page in petrinautDocNames / petrinautDocSummaries and the raw docs content map, so the AI assistant can read it; the existing tests enforce all three stay in sync.
• Records one patch changeset for @hashintel/petrinaut and @hashintel/petrinaut-core, covering the whole stack.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• modifies an npm-publishable library and I have added a changeset file(s)

📜 Does this require a change to the docs?

The changes in this PR:

• require changes to docs which are made as part of this PR

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• do not affect the execution graph

⚠️ Known issues

• The docs page has no screenshots yet; candidates to be added before the stack merges.

🛡 What tests cover this?

ai.test.ts and petrinaut-docs-content.test.ts fail if the page is missing from the name enum, the summaries, or the content map.

❓ How to test this?

1. Open the AI assistant in the notebook view and ask about the Notebook — the assistant should cite the new page.
2. Read libs/@hashintel/petrinaut/docs/notebook-view.md against the running view.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview	Aug 30, 2026 2:04pm
petrinaut	Ready	Preview	Aug 30, 2026 2:04pm
petrinaut-docs	Ready	Preview	Aug 30, 2026 2:04pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hashdotdesign-tokens	Ignored	Preview	Aug 30, 2026 2:04pm

[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.