feat(notes): add planned links and note inspector

Author: antonreshetov

README.md

@@ -98,11 +98,13 @@ Write longer markdown documents right next to your snippets: project docs, draft
 - Dashboard with activity overview, recent notes, top linked notes, and a notes graph preview
 - Editor, Live Preview, and Preview modes
 - Editable markdown tables with row and column controls
+- Internal links to notes, snippets, and HTTP requests, with placeholders for items you plan to create later
+- Note inspector with section navigation and reordering, link filters, and grouped callouts
 - Fullscreen notes graph for exploring internal links between notes
 - Integrated [Mermaid](https://mermaid-js.github.io/mermaid/#) diagrams
 - Mind maps generated from markdown heading structure
 - Fullscreen presentation mode for demos and meetings
-- Callout blocks and image embedding
+- Callout blocks, including TODOs for unfinished writing, and image embedding
 
 ### HTTP Client
 

docs/website/.vitepress/components/features/TheFeatures.vue

@@ -22,6 +22,12 @@ import FeaturesItem from './FeaturesItem.vue'
       Write in Markdown with live preview, add status, priority, and due dates
       to task notes, organize with folders and tags, and use Mermaid diagrams,
       mindmaps, or fullscreen presentation mode when you need more structure.
+      Plan linked notes, snippets, and requests while writing, then create them
+      when ready. Use the
+      <AppLink href="/documentation/notes/inspector">
+        Note inspector
+      </AppLink>
+      to reorder sections, inspect links, and find callouts.
     </FeaturesItem>
     <FeaturesItem title="HTTP Client">
       Build and test HTTP, GraphQL, and WebSocket APIs. Organize collections

docs/website/.vitepress/config.mts

@@ -204,6 +204,7 @@ export default defineConfig({
             { text: 'Folders', link: '/documentation/notes/folders' },
             { text: 'Tags', link: '/documentation/notes/tags' },
             { text: 'Internal Links', link: '/documentation/notes/internal-links' },
+            { text: 'Note Inspector', link: '/documentation/notes/inspector' },
             { text: 'Images', link: '/documentation/notes/images' },
             { text: 'Callouts', link: '/documentation/notes/callouts' },
             { text: 'Mermaid', link: '/documentation/notes/mermaid' },

docs/website/documentation/index.md

@@ -21,6 +21,8 @@ Use [Code](/documentation/code/) to build a reusable snippet library across proj
 
 Use [Notes](/documentation/notes/) for longer markdown documents that do not fit well into snippets: project notes, [task notes](/documentation/notes/tasks) with status, priority, due dates, cleanup controls, drafts, technical docs, meeting notes, and personal knowledge bases. It uses the same three-column layout as Code and adds a Notes Dashboard, live preview with editable tables, a notes graph, mindmaps, and fullscreen presentation mode.
 
+Use [Note inspector](/documentation/notes/inspector) to navigate and reorder sections, inspect links, and find callouts. [Planned links](/documentation/notes/internal-links#plan-notes-snippets-and-requests) let you leave placeholders for notes, snippets, and HTTP requests, then create them when ready. <AppVersion text=">=5.12" />
+
 ## HTTP
 
 Use [HTTP](/documentation/http/) as a lightweight API client inside massCode. Store requests in folders, import collections from OpenAPI, Postman, or Bruno, switch environments, preview the outgoing request as raw HTTP or cURL, send it from the editor, and inspect the response body and headers without leaving your workspace.

docs/website/documentation/notes/callouts.md

@@ -22,7 +22,7 @@ Start a blockquote with one of the supported markers:
 > Use warnings for risks, destructive actions, or anything that needs extra care.
 ```
 
-Supported callout types are `NOTE`, `IMPORTANT`, and `WARNING`. The marker is case-insensitive, so `> [!note]` works the same as `> [!NOTE]`.
+Supported callout types are `NOTE`, `IMPORTANT`, and `WARNING`. [`TODO`](#authoring-todos-and-annotations) is available starting with 5.12. The marker is case-insensitive, so `> [!note]` works the same as `> [!NOTE]`.
 
 ## Multi-line Callouts
 
@@ -36,3 +36,16 @@ Keep each line inside the same blockquote:
 ```
 
 Callouts are shown with dedicated styling in **Live Preview** and **Preview** modes. In editable modes, the marker stays visible while the cursor is on the callout line, so the markdown remains easy to edit.
+
+## Authoring TODOs and Annotations
+
+<AppVersion text=">=5.12" />
+
+Use a TODO callout to mark unfinished work in the current note:
+
+```md
+> [!TODO]
+> Add an example of error handling.
+```
+
+Open [Note inspector → Annotations](/documentation/notes/inspector#annotations) to find all callouts in the note, grouped and filtered by type. These are ordinary Markdown blocks, not separate tasks.

docs/website/documentation/notes/index.md

@@ -1,6 +1,6 @@
 ---
 title: Markdown Notes
-description: "Write markdown notes in massCode with a Notes Dashboard, tasks, live preview, a three-column layout, and features for diagrams, mind maps, and presentations."
+description: "Write markdown notes in massCode with a Notes Dashboard, tasks, live preview, planned links, a Note inspector, diagrams, mind maps, and presentations."
 ---
 
 # Notes
@@ -23,6 +23,12 @@ Use Notes when you want to keep markdown documents close to your snippets and da
 - prepare presentations from markdown
 - turn note outlines into mind maps
 
+## Note Inspector
+
+<AppVersion text=">=5.12" />
+
+Use [Note inspector](/documentation/notes/inspector) to navigate and reorder sections, inspect links, and find callouts while writing. [Planned links](/documentation/notes/internal-links#plan-notes-snippets-and-requests) let you leave placeholders for notes, snippets, and HTTP requests, then create them when you are ready.
+
 ## Creating a Note
 
 - Select **"File"** > **"New Note"** from the menu bar.
@@ -66,7 +72,7 @@ The editor is built on CodeMirror 6 and includes:
 - Editable markdown tables in Live Preview
 - One-click copying for fenced code blocks in Live Preview and Preview <AppVersion text=">=5.9" />
 - Line break normalization for hard-wrapped terminal text from **Editor** > **Normalize Line Breaks** <AppVersion text=">=5.9" />
-- [Internal links](/documentation/notes/internal-links) to notes and snippets
+- [Internal links](/documentation/notes/internal-links) to notes, snippets, and HTTP requests
 - [Task notes](/documentation/notes/tasks) with status, priority, due dates, and smart views
 - [Mermaid diagram](/documentation/notes/mermaid) support
 - [Image embedding](/documentation/notes/images)

docs/website/documentation/notes/inspector.md

@@ -0,0 +1,66 @@
+---
+title: Note Inspector
+description: "Navigate and reorder note sections, inspect links and planned items, and find callouts in massCode."
+---
+
+# Note Inspector
+
+<AppVersion text=">=5.12" />
+
+The Note inspector keeps a note’s structure, linked items, and callouts within reach while you write. Open **View → Note inspector** or click the right-panel button at the end of the editor toolbar.
+
+<img :src="withBase('/notes-inspector.png')" alt="Note inspector showing linked notes, snippets, HTTP requests, external links, and planned items beside an API integration checklist">
+
+Choose **Outline**, **Links**, or **Annotations**. Drag the inspector’s left edge to resize it. The selected tab, panel visibility, and width are remembered. The **?** button at the bottom explains the actions in the current tab.
+
+## Outline
+
+Use **Outline** to navigate a long note. Headings H1–H6 appear in a tree; expand or collapse sections to focus on the structure you need. Click a heading to jump to it. The current section is highlighted as you move the cursor in the editor.
+
+In Raw and Live Preview, drag a heading:
+
+- **Above or below another heading** to move the section to the same level.
+- **Onto a heading** to nest the section inside it.
+
+The entire section moves with its content and nested headings. Preview supports navigation only. Headings inside code blocks, quotes, and lists are excluded.
+
+## Links
+
+Use **Links** to see which items a note uses and what is still planned or missing.
+
+- **Note, Snippet, and HTTP request** groups contain existing linked items.
+- **External** contains web addresses.
+- **Planned** contains placeholders for items you intend to create.
+- **Missing** contains internal links whose targets cannot be found.
+
+Each row shows the target’s name and location. Custom labels used in the note are shown alongside the target name. Repeated references share a row with an occurrence count. The summary counts unique targets and addresses across the whole note.
+
+Filter by **status** and **space** to narrow the list, for example to planned snippets. The list updates as you edit.
+
+### Find a link in the note
+
+Click the locate button (the target icon) to jump to a link. The cursor moves to the link text without selecting it; Live Preview reveals its Markdown for editing. Click again to cycle through repeated occurrences.
+
+### Create a planned item
+
+In Raw or Live Preview, hold <kbd>Cmd</kbd> on macOS or <kbd>Ctrl</kbd> on Windows/Linux and click the locate button beside a planned item. This creates the item and opens its usual space, just like clicking the placeholder in the editor with the same modifier. Use **Back** to return to your note.
+
+See [Plan Notes, Snippets, and Requests](/documentation/notes/internal-links#plan-notes-snippets-and-requests) for inserting placeholders and choosing the item type.
+
+### Open an external link
+
+Click the external-link button beside a web address to open it in your browser. The locate button takes you to its occurrence in the note instead.
+
+External links include HTTP and HTTPS Markdown links, reference links, autolinks, and plain URLs. Code examples and image sources are excluded. massCode does not check website availability or classify external addresses as missing.
+
+## Annotations
+
+Use **Annotations** to find callouts throughout the note. All supported types appear in groups: **Todo**, **Note**, **Important**, and **Warning**. Filter by type to focus on a group, then click the locate button to jump to a callout in the editor.
+
+The list and counts update as you edit. Each callout has its own row, even when its text matches another callout. Deleting a callout from the note removes it from the inspector.
+
+Use a [Todo callout](/documentation/notes/callouts#authoring-todos-and-annotations) to mark unfinished writing, such as an example to add or a fact to check. Callouts remain ordinary Markdown in the note.
+
+<script setup>
+import { withBase } from 'vitepress'
+</script>

docs/website/documentation/notes/internal-links.md

@@ -7,7 +7,7 @@ description: "Link notes, snippets, and HTTP requests together inside massCode N
 
 <AppVersion text=">=5.1" />
 
-Internal Links let you connect notes, snippets, and HTTP requests with wiki-style links directly inside Notes. Use them to build lightweight documentation, link reference snippets or saved API requests from prose, and move through related material without leaving massCode.
+Internal Links let you connect notes, snippets, and HTTP requests with wiki-style links directly inside Notes. Use them to build lightweight documentation, link reference snippets or saved API requests from prose, and move through related item without leaving massCode.
 
 <img :src="withBase('/notes-internal-links.png')">
 
@@ -47,6 +47,48 @@ Start typing `[[` in the Notes editor to open the internal links picker.
 
 The picker inserts the shortest unambiguous form: just the name when it is unique, or a folder path when another item shares the same name.
 
+## Plan Notes, Snippets, and Requests
+
+<AppVersion text=">=5.12" />
+
+Plan a note, snippet, or HTTP request right where you need it in your writing. Insert a placeholder, continue the note, and create the item later without losing your place.
+
+<img :src="withBase('/notes-planned.png')" alt="Internal link picker with Plan Note, Plan Snippet, and Plan HTTP request actions below existing results">
+
+### Insert a placeholder
+
+1. Type `[[` followed by the title you have in mind.
+2. Choose **Plan Note**, **Plan Snippet**, or **Plan HTTP request** with the arrow keys and <kbd>Enter</kbd>, or click the action.
+3. Continue writing. The placeholder has a dashed border in Live Preview; the actual item does not exist yet.
+
+The **Plan…** action stays pinned below the search results. To reach it without stepping through matching items, press <kbd>Cmd</kbd>+<kbd>Enter</kbd> on macOS or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> on Windows/Linux. This selects **Plan Note**; press <kbd>Enter</kbd> to insert it, or use the arrow keys to choose another type. <kbd>Tab</kbd> keeps its usual indentation behavior.
+
+### Create the planned item
+
+Hold <kbd>Cmd</kbd> on macOS or <kbd>Ctrl</kbd> on Windows/Linux and click the placeholder. massCode creates the item, replaces the placeholder with its link, and opens the usual Notes, Code, or HTTP space with the title selected for renaming.
+
+Fill in the item normally, then use **Back** to return to your note through the existing navigation history. The placeholder is now a regular link to the created item.
+
+Notes and snippets are created in **Inbox**. HTTP requests are created in the **Inbox** collection, which is created on demand. Names are checked when you activate the placeholder: if the name is taken, a numeric suffix is added, such as `Example 1` or `Example 2`.
+
+Find all placeholders in [Note inspector → Links](/documentation/notes/inspector#links) by choosing the **Planned** status filter.
+
+### Markdown syntax
+
+Placeholders are stored as Markdown:
+
+```md
+[[masscode:planned:note|Authentication guide]]
+[[masscode:planned:snippet|Token refresh helper]]
+[[masscode:planned:http-request|Refresh access token]]
+```
+
+Only the clicked placeholder is replaced. A planned item has no backlinks or export link until it is created. Repeated clicks while creation is in progress do not create another object. If a step fails, an error notification offers a retry when it is safe to continue.
+
+::: warning Reserved link targets
+The three exact targets above are reserved for placeholders. Existing links using them change meaning; your notes are not rewritten automatically. To link to an imported or older item with one of these names, select it in the picker, which writes an explicit ID link.
+:::
+
 ## Opening Links
 
 Hold <kbd>Cmd</kbd> on macOS or <kbd>Ctrl</kbd> on Windows or Linux, then click the link.
@@ -67,6 +109,12 @@ Hover an internal link while holding <kbd>Cmd</kbd> on macOS or <kbd>Ctrl</kbd>
 
 This helps you confirm the target before you navigate away from the current note.
 
+## Note Inspector
+
+<AppVersion text=">=5.12" />
+
+Open the **Links** tab in [Note inspector](/documentation/notes/inspector#links) to inspect linked items, planned placeholders, missing targets, and external addresses. Filter by status or space and use the locate button to find each occurrence in your note.
+
 ## Navigation History
 
 When you follow internal links, massCode keeps a small link navigation history for that session.