npm - @agent-native/core - Versions diffs - 0.95.1 → 0.97.0 - Mend

@agent-native/core 0.95.1 → 0.97.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.

Files changed (655) hide show

package/corpus/templates/content/parity/matrix.md CHANGED Viewed

@@ -2,28 +2,28 @@
 This generated matrix tracks whether high-value Content UI operations use the same action surface agents can call, or have an explicit exception. Edit `matrix.ts`, then regenerate this file.
-| ID                                             | Surface     | User-visible action                                                                            | Status                | Actions                                                                                                                                                                                                                                                                                                                           | UI entrypoints                                                                                                                                                                            | Durable effect                                                                                                                                                                                                         | Exception / gap                                                                                                                                                                                                                            | Reliability risk | Spine priority | Test coverage | Coverage refs                                                                                                                                                   | Eval scenarios                   | Follow-up                      |
-| ---------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- | -------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------ |
-| comments.threads                               | comments    | List, add, reply, resolve, reopen, and delete comment threads                                  | action-backed         | `add-comment`, `delete-comment`, `list-comments`, `update-comment`                                                                                                                                                                                                                                                                | `app/components/editor/CommentsSidebar.tsx`, `app/hooks/use-comments.ts`                                                                                                                  | Comment threads, replies, anchors, mentions, resolution state, and deletion are stored through comment actions.                                                                                                        | -                                                                                                                                                                                                                                          | -                | P0             | seeded        | -                                                                                                                                                               | -                                | -                              |
-| database.form-submissions                      | database    | Submit public database forms as new rows                                                       | action-backed         | `submit-content-database-form`                                                                                                                                                                                                                                                                                                    | `app/components/editor/database/FormView.tsx`                                                                                                                                             | A validated form submission atomically creates a database row document and its editable property values.                                                                                                               | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/submit-content-database-form.db.test.ts`                                                                                                               | -                                | -                              |
-| database.lifecycle-and-trash                   | database    | Create, soft-delete, restore, list, and inspect content databases                              | action-backed         | `create-content-database`, `create-inline-content-database`, `delete-content-database`, `get-content-database`, `list-content-databases`, `list-trashed-content-databases`, `restore-content-database`                                                                                                                            | `app/components/editor/SlashCommandMenu.tsx`, `app/hooks/use-content-database.ts`, `app/hooks/use-documents.ts`                                                                           | Database pages and database records are created, read, soft-deleted, restored, and listed.                                                                                                                             | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`                                                                                                                 | `database-source-scope`          | -                              |
-| database.properties-and-view-config            | database    | Configure properties, values, ordering, and saved views                                        | action-backed         | `configure-document-property`, `delete-document-property`, `duplicate-document-property`, `get-content-database-personal-view`, `list-document-properties`, `reorder-document-property`, `set-document-property`, `update-content-database-personal-view`, `update-content-database-view`                                         | `app/components/editor/DocumentProperties.tsx`, `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-document-properties.ts`   | Property schemas, property values, property order, filters, sorts, grouping, hidden columns, view type, and view settings are stored.                                                                                  | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts` | `database-source-scope`          | -                              |
-| database.rows                                  | database    | Add, duplicate, move, open, and delete database rows                                           | action-backed         | `add-database-item`, `delete-database-items`, `delete-document`, `duplicate-database-items`, `duplicate-database-item`, `move-database-item`, `set-document-property`                                                                                                                                                             | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`                                                                                           | Database row backing documents and row ordering are created, duplicated, moved, edited, and deleted.                                                                                                                   | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/database-row-batch-actions.db.test.ts`, `parity/__tests__/database-row-batch-reliability.test.ts`                                                      | `database-bulk-row-reliability`  | -                              |
-| editor.agent-assist-prompts                    | editor      | Ask AI from slash generation or comment context                                                | client-assist         | -                                                                                                                                                                                                                                                                                                                                 | `app/components/editor/SlashCommandMenu.tsx`, `app/components/editor/CommentsSidebar.tsx`                                                                                                 | No direct durable mutation; the prompt asks the agent to use document actions when it decides to write.                                                                                                                | -                                                                                                                                                                                                                                          | -                | P1             | none          | -                                                                                                                                                               | -                                | -                              |
-| editor.client-formatting-and-insertions        | editor      | Rich text formatting, selection state, slash block insertion, and copy actions                 | client-only-ephemeral | -                                                                                                                                                                                                                                                                                                                                 | `app/components/editor/BubbleToolbar.tsx`, `app/components/editor/SlashCommandMenu.tsx`, `app/components/editor/DocumentToolbar.tsx`                                                      | -                                                                                                                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P1             | none          | -                                                                                                                                                               | -                                | -                              |
-| editor.document-body-and-title                 | editor      | Edit document title, body, icon, image alt text, and precise text                              | action-backed         | `edit-document`, `pull-document`, `set-image-alt-text`, `transcribe-media`, `update-document`                                                                                                                                                                                                                                     | `app/components/editor/DocumentEditor.tsx`, `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/extensions/ImageBlock.tsx`, `app/components/editor/SlashCommandMenu.tsx` | Document content, title, icon, image metadata, and text replacements are saved to the same document source.                                                                                                            | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                        | `document-search-edit`           | -                              |
-| local-files.components-workspace               | local-files | Register, list, and write local MDX component workspaces                                       | host-only             | `list-local-component-files`, `register-local-component-workspace`, `write-local-component-file`                                                                                                                                                                                                                                  | `app/routes/_app.local-files.tsx`, `actions/register-local-component-workspace.ts`, `actions/list-local-component-files.ts`, `actions/write-local-component-file.ts`                      | Trusted local component workspace registration and component file reads/writes support local MDX previews.                                                                                                             | Workspace registration depends on a trusted Desktop folder path and is intentionally hidden with agentTool: false.                                                                                                                         | -                | P1             | seeded        | -                                                                                                                                                               | -                                | Local folder exception/docs PR |
-| local-files.host-folder-handles                | local-files | Choose, persist, remove, and write trusted local folder handles                                | host-only             | -                                                                                                                                                                                                                                                                                                                                 | `app/routes/_app.local-files.tsx`                                                                                                                                                         | Host directory handles and browser/Desktop write permissions are managed outside SQL action state.                                                                                                                     | Mounted local folders require browser/Desktop host handles that agents cannot safely or portably hold as normal tools.                                                                                                                     | -                | P0             | none          | -                                                                                                                                                               | -                                | Local folder exception/docs PR |
-| local-files.import-export-mounted-folder       | local-files | Import, check, export, push, and remove local folder source files                              | action-backed         | `export-content-source`, `import-content-source`, `remove-local-file-source`                                                                                                                                                                                                                                                      | `app/routes/_app.local-files.tsx`, `actions/import-content-source.ts`, `actions/export-content-source.ts`                                                                                 | Local Markdown/MDX source files are imported into Content documents, editable Content documents are exported back to source-friendly files, and imported source entries can be removed without deleting files on disk. | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/_local-file-documents.test.ts`                                                                                                                         | `local-file-source-truth`        | -                              |
-| notion.route-backed-document-sync              | source-sync | Notion document sync status, link, unlink, pull, push, resolve, create, search, and disconnect | action-backed         | `connect-notion-status`, `create-and-link-notion-page`, `disconnect-notion`, `link-notion-page`, `list-notion-links`, `pull-notion-page`, `push-notion-page`, `refresh-notion-sync-status`, `resolve-notion-sync-conflict`, `search-notion-pages`, `sync-notion-comments`, `unlink-notion-page`                                   | `app/hooks/use-notion.ts`, `app/components/editor/DocumentToolbar.tsx`, `app/components/editor/NotionSyncBar.tsx`, `app/components/editor/DocumentEditor.tsx`                             | Notion connection state, page search, link metadata, and local/remote document body sync state are read or mutated through Content actions.                                                                            | Notion OAuth auth-url and callback routes remain route-shaped because they initiate and receive browser redirects rather than normal app data mutations.                                                                                   | -                | P0             | covered       | `parity/__tests__/matrix-route-gap-classify.test.ts`                                                                                                            | -                                | -                              |
-| sharing.document-discoverability-and-export    | sharing     | Share, hide from search, export, and reveal documents                                          | action-backed         | `export-document`, `reveal-local-source-file`, `set-document-discoverability`, `share-local-file-document`                                                                                                                                                                                                                        | `app/components/editor/DocumentToolbar.tsx`, `app/hooks/use-documents.ts`                                                                                                                 | Search discoverability, shareable copies, exports, and OS reveal requests are managed through Content actions.                                                                                                         | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/_local-file-documents.test.ts`                                                                                                                         | `local-file-source-truth`        | -                              |
-| sharing.os-reveal-local-source                 | sharing     | Reveal a local source file in the system file manager                                          | host-only             | `reveal-local-source-file`                                                                                                                                                                                                                                                                                                        | `app/components/editor/DocumentToolbar.tsx`, `actions/reveal-local-source-file.ts`                                                                                                        | -                                                                                                                                                                                                                      | OS reveal depends on trusted local host capabilities and should not spend agent tool surface or imply portable hosted behavior.                                                                                                            | -                | P2             | seeded        | -                                                                                                                                                               | -                                | Local folder exception/docs PR |
-| sidebar.chrome-state                           | sidebar     | Collapse sections and resize the sidebar                                                       | client-only-ephemeral | -                                                                                                                                                                                                                                                                                                                                 | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/layout/Layout.tsx`                                                                                                          | -                                                                                                                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P2             | none          | -                                                                                                                                                               | -                                | -                              |
-| sidebar.document-tree-crud                     | sidebar     | Create, delete, move, favorite, list, search, and open pages                                   | action-backed         | `create-document`, `delete-document`, `get-document`, `list-documents`, `move-document`, `search-documents`, `update-document`                                                                                                                                                                                                    | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/sidebar/DocumentTreeItem.tsx`, `app/hooks/use-documents.ts`                                                                 | Document tree rows and document metadata are created, updated, deleted, moved, searched, or read.                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                        | `document-search-edit`           | -                              |
-| sidebar.navigation-and-screen-context          | sidebar     | Navigate between documents and expose current screen context                                   | action-equivalent     | `navigate`, `view-screen`                                                                                                                                                                                                                                                                                                         | `app/components/sidebar/DocumentSidebar.tsx`, `actions/navigate.ts`, `actions/view-screen.ts`                                                                                             | Application navigation state is updated or read so the agent can reason about the user's current page/view.                                                                                                            | Human navigation is router-local, while agent navigation/screen inspection uses application-state actions to produce the same workspace orientation effect.                                                                                | -                | P1             | seeded        | -                                                                                                                                                               | -                                | -                              |
-| source-sync.builder-body-hydration-worker      | source-sync | Process queued Builder CMS body hydration work                                                 | action-backed         | `process-builder-body-hydration`                                                                                                                                                                                                                                                                                                  | `app/components/editor/DocumentEditor.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`                                                        | Queued Builder body hydration entries are processed into readable Content document/database body state.                                                                                                                | This action is intentionally hidden from the model with agentTool: false because it is an internal bounded queue worker; agents should use source refresh, review, and execution actions rather than manually driving hydration internals. | -                | P0             | covered       | `actions/_database-source-utils.test.ts`                                                                                                                        | -                                | -                              |
-| source-sync.builder-cms-review-and-write-gates | source-sync | Review, stage, validate, and execute Builder CMS source writes                                 | action-backed         | `execute-builder-source-batch`, `execute-builder-source-execution`, `prepare-builder-source-execution`, `prepare-builder-source-review`, `review-content-database-source-change-set`, `set-content-database-source-write-mode`, `stage-builder-source-bulk-update`, `stage-builder-revision`, `validate-builder-source-execution` | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/components/editor/database-sources/BuilderSourceReviewDialog.tsx`                   | Builder source write mode, staged reviews, validation records, and bounded execution records are created through guarded actions.                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/builder-source-review-gates.db.test.ts`, `actions/execute-builder-source-execution.test.ts`, `actions/stage-builder-source-bulk-update.db.test.ts`     | `builder-source-review-readonly` | -                              |
-| source-sync.builder-documents                  | source-sync | List, pull, check, and push Builder docs/blog MDX documents                                    | action-backed         | `check-builder-doc`, `list-builder-docs`, `pull-builder-doc`, `push-builder-doc`                                                                                                                                                                                                                                                  | `actions/list-builder-docs.ts`, `actions/pull-builder-doc.ts`, `actions/check-builder-doc.ts`, `actions/push-builder-doc.ts`                                                              | Builder docs/blog entries can be read into Content, checked locally, and pushed through guarded Builder document actions.                                                                                              | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                               | -                                | -                              |
-| source-sync.database-source-bindings           | source-sync | Attach, inspect, refresh, disconnect, join, and bind database sources                          | action-backed         | `add-content-database-source-field-property`, `attach-content-database-source`, `bind-content-database-source-field`, `change-content-database-source-role`, `disconnect-content-database-source`, `get-content-database-source`, `list-builder-cms-models`, `refresh-content-database-source`, `suggest-source-join-key`         | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/DocumentProperties.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`      | Mounted database source metadata, fields, source role, join keys, and source-field/property bindings are stored and refreshed.                                                                                         | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts` | `database-source-scope`          | -                              |
-| source-sync.provider-api-and-staged-datasets   | source-sync | Inspect provider APIs and stage/query/delete large provider datasets                           | action-backed         | `delete-staged-dataset`, `list-staged-datasets`, `provider-api-catalog`, `provider-api-docs`, `provider-api-request`, `query-staged-dataset`                                                                                                                                                                                      | `actions/provider-api-catalog.ts`, `actions/provider-api-docs.ts`, `actions/provider-api-request.ts`, `actions/query-staged-dataset.ts`                                                   | Provider API metadata and staged dataset scratch storage support scoped agent/source analysis.                                                                                                                         | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                               | -                                | -                              |
-| versions.history-and-restore                   | versions    | Open version history and restore a previous document version                                   | action-backed         | `list-document-versions`, `restore-document-version`                                                                                                                                                                                                                                                                              | `app/components/editor/VersionHistoryPanel.tsx`, `app/hooks/use-document-versions.ts`                                                                                                     | Document versions are listed and selected versions can restore the document while snapshotting current state.                                                                                                          | -                                                                                                                                                                                                                                          | -                | P0             | seeded        | -                                                                                                                                                               | -                                | -                              |
+| ID                                             | Surface     | User-visible action                                                                            | Status                | Actions                                                                                                                                                                                                                                                                                                                                                   | UI entrypoints                                                                                                                                                                            | Durable effect                                                                                                                                                                                                         | Exception / gap                                                                                                                                                                                                                            | Reliability risk | Spine priority | Test coverage | Coverage refs                                                                                                                                                   | Eval scenarios                   | Follow-up                      |
+| ---------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- | -------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------ |
+| comments.threads                               | comments    | List, add, reply, resolve, reopen, and delete comment threads                                  | action-backed         | `add-comment`, `delete-comment`, `list-comments`, `update-comment`                                                                                                                                                                                                                                                                                        | `app/components/editor/CommentsSidebar.tsx`, `app/hooks/use-comments.ts`                                                                                                                  | Comment threads, replies, anchors, mentions, resolution state, and deletion are stored through comment actions.                                                                                                        | -                                                                                                                                                                                                                                          | -                | P0             | seeded        | -                                                                                                                                                               | -                                | -                              |
+| database.form-submissions                      | database    | Submit public database forms as new rows                                                       | action-backed         | `submit-content-database-form`                                                                                                                                                                                                                                                                                                                            | `app/components/editor/database/FormView.tsx`                                                                                                                                             | A validated form submission atomically creates a database row document and its editable property values.                                                                                                               | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/submit-content-database-form.db.test.ts`                                                                                                               | -                                | -                              |
+| database.lifecycle-and-trash                   | database    | Create, soft-delete, restore, list, and inspect content databases                              | action-backed         | `create-content-database`, `create-inline-content-database`, `delete-content-database`, `get-content-database`, `list-content-databases`, `list-trashed-content-databases`, `restore-content-database`                                                                                                                                                    | `app/components/editor/SlashCommandMenu.tsx`, `app/hooks/use-content-database.ts`, `app/hooks/use-documents.ts`                                                                           | Database pages and database records are created, read, soft-deleted, restored, and listed.                                                                                                                             | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`                                                                                                                 | `database-source-scope`          | -                              |
+| database.properties-and-view-config            | database    | Configure properties, values, ordering, and saved views                                        | action-backed         | `configure-document-property`, `delete-document-property`, `duplicate-document-property`, `get-content-database-personal-view`, `list-document-properties`, `reorder-document-property`, `set-document-property`, `update-content-database-personal-view`, `update-content-database-view`                                                                 | `app/components/editor/DocumentProperties.tsx`, `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-document-properties.ts`   | Property schemas, property values, property order, filters, sorts, grouping, hidden columns, view type, and view settings are stored.                                                                                  | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts` | `database-source-scope`          | -                              |
+| database.rows                                  | database    | Add, duplicate, move, open, and delete database rows                                           | action-backed         | `add-database-item`, `delete-database-items`, `delete-document`, `duplicate-database-items`, `duplicate-database-item`, `move-database-item`, `set-document-property`                                                                                                                                                                                     | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`                                                                                           | Database row backing documents and row ordering are created, duplicated, moved, edited, and deleted.                                                                                                                   | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/database-row-batch-actions.db.test.ts`, `parity/__tests__/database-row-batch-reliability.test.ts`                                                      | `database-bulk-row-reliability`  | -                              |
+| editor.agent-assist-prompts                    | editor      | Ask AI from slash generation or comment context                                                | client-assist         | -                                                                                                                                                                                                                                                                                                                                                         | `app/components/editor/SlashCommandMenu.tsx`, `app/components/editor/CommentsSidebar.tsx`                                                                                                 | No direct durable mutation; the prompt asks the agent to use document actions when it decides to write.                                                                                                                | -                                                                                                                                                                                                                                          | -                | P1             | none          | -                                                                                                                                                               | -                                | -                              |
+| editor.client-formatting-and-insertions        | editor      | Rich text formatting, selection state, slash block insertion, and copy actions                 | client-only-ephemeral | -                                                                                                                                                                                                                                                                                                                                                         | `app/components/editor/BubbleToolbar.tsx`, `app/components/editor/SlashCommandMenu.tsx`, `app/components/editor/DocumentToolbar.tsx`                                                      | -                                                                                                                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P1             | none          | -                                                                                                                                                               | -                                | -                              |
+| editor.document-body-and-title                 | editor      | Edit document title, body, icon, image alt text, and precise text                              | action-backed         | `edit-document`, `pull-document`, `set-image-alt-text`, `transcribe-media`, `update-document`                                                                                                                                                                                                                                                             | `app/components/editor/DocumentEditor.tsx`, `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/extensions/ImageBlock.tsx`, `app/components/editor/SlashCommandMenu.tsx` | Document content, title, icon, image metadata, and text replacements are saved to the same document source.                                                                                                            | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                        | `document-search-edit`           | -                              |
+| local-files.components-workspace               | local-files | Register, list, and write local MDX component workspaces                                       | host-only             | `list-local-component-files`, `register-local-component-workspace`, `write-local-component-file`                                                                                                                                                                                                                                                          | `app/routes/_app.local-files.tsx`, `actions/register-local-component-workspace.ts`, `actions/list-local-component-files.ts`, `actions/write-local-component-file.ts`                      | Trusted local component workspace registration and component file reads/writes support local MDX previews.                                                                                                             | Workspace registration depends on a trusted Desktop folder path and is intentionally hidden with agentTool: false.                                                                                                                         | -                | P1             | seeded        | -                                                                                                                                                               | -                                | Local folder exception/docs PR |
+| local-files.host-folder-handles                | local-files | Choose, persist, remove, and write trusted local folder handles                                | host-only             | -                                                                                                                                                                                                                                                                                                                                                         | `app/routes/_app.local-files.tsx`                                                                                                                                                         | Host directory handles and browser/Desktop write permissions are managed outside SQL action state.                                                                                                                     | Mounted local folders require browser/Desktop host handles that agents cannot safely or portably hold as normal tools.                                                                                                                     | -                | P0             | none          | -                                                                                                                                                               | -                                | Local folder exception/docs PR |
+| local-files.import-export-mounted-folder       | local-files | Import, check, export, push, and remove local folder source files                              | action-backed         | `export-content-source`, `import-content-source`, `remove-local-file-source`                                                                                                                                                                                                                                                                              | `app/routes/_app.local-files.tsx`, `actions/import-content-source.ts`, `actions/export-content-source.ts`                                                                                 | Local Markdown/MDX source files are imported into Content documents, editable Content documents are exported back to source-friendly files, and imported source entries can be removed without deleting files on disk. | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/_local-file-documents.test.ts`                                                                                                                         | `local-file-source-truth`        | -                              |
+| notion.route-backed-document-sync              | source-sync | Notion document sync status, link, unlink, pull, push, resolve, create, search, and disconnect | action-backed         | `connect-notion-status`, `create-and-link-notion-page`, `disconnect-notion`, `link-notion-page`, `list-notion-links`, `pull-notion-page`, `push-notion-page`, `refresh-notion-sync-status`, `resolve-notion-sync-conflict`, `search-notion-pages`, `sync-notion-comments`, `unlink-notion-page`                                                           | `app/hooks/use-notion.ts`, `app/components/editor/DocumentToolbar.tsx`, `app/components/editor/NotionSyncBar.tsx`, `app/components/editor/DocumentEditor.tsx`                             | Notion connection state, page search, link metadata, and local/remote document body sync state are read or mutated through Content actions.                                                                            | Notion OAuth auth-url and callback routes remain route-shaped because they initiate and receive browser redirects rather than normal app data mutations.                                                                                   | -                | P0             | covered       | `parity/__tests__/matrix-route-gap-classify.test.ts`                                                                                                            | -                                | -                              |
+| sharing.document-discoverability-and-export    | sharing     | Share, hide from search, export, and reveal documents                                          | action-backed         | `export-document`, `reveal-local-source-file`, `set-document-discoverability`, `share-local-file-document`                                                                                                                                                                                                                                                | `app/components/editor/DocumentToolbar.tsx`, `app/hooks/use-documents.ts`                                                                                                                 | Search discoverability, shareable copies, exports, and OS reveal requests are managed through Content actions.                                                                                                         | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/_local-file-documents.test.ts`                                                                                                                         | `local-file-source-truth`        | -                              |
+| sharing.os-reveal-local-source                 | sharing     | Reveal a local source file in the system file manager                                          | host-only             | `reveal-local-source-file`                                                                                                                                                                                                                                                                                                                                | `app/components/editor/DocumentToolbar.tsx`, `actions/reveal-local-source-file.ts`                                                                                                        | -                                                                                                                                                                                                                      | OS reveal depends on trusted local host capabilities and should not spend agent tool surface or imply portable hosted behavior.                                                                                                            | -                | P2             | seeded        | -                                                                                                                                                               | -                                | Local folder exception/docs PR |
+| sidebar.chrome-state                           | sidebar     | Collapse sections and resize the sidebar                                                       | client-only-ephemeral | -                                                                                                                                                                                                                                                                                                                                                         | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/layout/Layout.tsx`                                                                                                          | -                                                                                                                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P2             | none          | -                                                                                                                                                               | -                                | -                              |
+| sidebar.document-tree-crud                     | sidebar     | Create, delete, move, favorite, list, search, and open pages                                   | action-backed         | `create-document`, `delete-document`, `get-document`, `list-documents`, `move-document`, `search-documents`, `update-document`                                                                                                                                                                                                                            | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/sidebar/DocumentTreeItem.tsx`, `app/hooks/use-documents.ts`                                                                 | Document tree rows and document metadata are created, updated, deleted, moved, searched, or read.                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                        | `document-search-edit`           | -                              |
+| sidebar.navigation-and-screen-context          | sidebar     | Navigate between documents and expose current screen context                                   | action-equivalent     | `navigate`, `view-screen`                                                                                                                                                                                                                                                                                                                                 | `app/components/sidebar/DocumentSidebar.tsx`, `actions/navigate.ts`, `actions/view-screen.ts`                                                                                             | Application navigation state is updated or read so the agent can reason about the user's current page/view.                                                                                                            | Human navigation is router-local, while agent navigation/screen inspection uses application-state actions to produce the same workspace orientation effect.                                                                                | -                | P1             | seeded        | -                                                                                                                                                               | -                                | -                              |
+| source-sync.builder-body-hydration-worker      | source-sync | Process queued Builder CMS body hydration work                                                 | action-backed         | `process-builder-body-hydration`                                                                                                                                                                                                                                                                                                                          | `app/components/editor/DocumentEditor.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`                                                        | Queued Builder body hydration entries are processed into readable Content document/database body state.                                                                                                                | This action is intentionally hidden from the model with agentTool: false because it is an internal bounded queue worker; agents should use source refresh, review, and execution actions rather than manually driving hydration internals. | -                | P0             | covered       | `actions/_database-source-utils.test.ts`                                                                                                                        | -                                | -                              |
+| source-sync.builder-cms-review-and-write-gates | source-sync | Review, stage, validate, and execute Builder CMS source writes                                 | action-backed         | `execute-builder-source-batch`, `execute-builder-source-execution`, `prepare-builder-source-execution`, `prepare-builder-source-review`, `review-content-database-source-change-set`, `set-content-database-source-write-mode`, `stage-builder-source-bulk-update`, `stage-builder-revision`, `validate-builder-source-execution`                         | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/components/editor/database-sources/BuilderSourceReviewDialog.tsx`                   | Builder source write mode, staged reviews, validation records, and bounded execution records are created through guarded actions.                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/builder-source-review-gates.db.test.ts`, `actions/execute-builder-source-execution.test.ts`, `actions/stage-builder-source-bulk-update.db.test.ts`     | `builder-source-review-readonly` | -                              |
+| source-sync.builder-documents                  | source-sync | List, pull, check, and push Builder docs/blog MDX documents                                    | action-backed         | `check-builder-doc`, `list-builder-docs`, `pull-builder-doc`, `push-builder-doc`                                                                                                                                                                                                                                                                          | `actions/list-builder-docs.ts`, `actions/pull-builder-doc.ts`, `actions/check-builder-doc.ts`, `actions/push-builder-doc.ts`                                                              | Builder docs/blog entries can be read into Content, checked locally, and pushed through guarded Builder document actions.                                                                                              | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                               | -                                | -                              |
+| source-sync.database-source-bindings           | source-sync | Attach, inspect, refresh, disconnect, join, and bind database sources                          | action-backed         | `add-content-database-source-field-property`, `attach-content-database-source`, `bind-content-database-source-field`, `change-content-database-source-role`, `disconnect-content-database-source`, `get-content-database-source`, `list-builder-cms-models`, `list-notion-database-sources`, `refresh-content-database-source`, `suggest-source-join-key` | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/DocumentProperties.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`      | Mounted database source metadata, fields, source role, join keys, and source-field/property bindings are stored and refreshed.                                                                                         | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts` | `database-source-scope`          | -                              |
+| source-sync.provider-api-and-staged-datasets   | source-sync | Inspect provider APIs and stage/query/delete large provider datasets                           | action-backed         | `delete-staged-dataset`, `list-staged-datasets`, `provider-api-catalog`, `provider-api-docs`, `provider-api-request`, `query-staged-dataset`                                                                                                                                                                                                              | `actions/provider-api-catalog.ts`, `actions/provider-api-docs.ts`, `actions/provider-api-request.ts`, `actions/query-staged-dataset.ts`                                                   | Provider API metadata and staged dataset scratch storage support scoped agent/source analysis.                                                                                                                         | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                               | -                                | -                              |
+| versions.history-and-restore                   | versions    | Open version history and restore a previous document version                                   | action-backed         | `list-document-versions`, `restore-document-version`                                                                                                                                                                                                                                                                                                      | `app/components/editor/VersionHistoryPanel.tsx`, `app/hooks/use-document-versions.ts`                                                                                                     | Document versions are listed and selected versions can restore the document while snapshotting current state.                                                                                                          | -                                                                                                                                                                                                                                          | -                | P0             | seeded        | -                                                                                                                                                               | -                                | -                              |

package/corpus/templates/content/parity/matrix.ts CHANGED Viewed

@@ -341,6 +341,7 @@ export const parityMatrix: ParityRow[] = [
       "disconnect-content-database-source",
       "get-content-database-source",
       "list-builder-cms-models",
+      "list-notion-database-sources",
       "refresh-content-database-source",
       "suggest-source-join-key",
     ],

package/corpus/templates/content/server/routes/api/documents/[id]/move.patch.ts CHANGED Viewed

@@ -7,6 +7,10 @@ import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, sql } from "drizzle-orm";
 import { defineEventHandler, createError } from "h3";
+import {
+  documentsPositionScope,
+  withPositionLock,
+} from "../../../../../actions/_position-utils.js";
 import { getDb } from "../../../../db/index.js";
 import { schema } from "../../../../db/index.js";
 import {
@@ -107,37 +111,50 @@ export default defineEventHandler(async (event) => {
         updates.parentId = body.parentId;
       }
+      const applyUpdate = () =>
+        db
+          .update(schema.documents)
+          .set(updates)
+          .where(
+            and(
+              eq(schema.documents.id, id),
+              eq(schema.documents.ownerEmail, ownerEmail),
+            ),
+          );
       if (body.position !== undefined) {
         updates.position = body.position;
+        await applyUpdate();
       } else if (body.parentId !== undefined) {
-        // Auto-assign position at end of new parent's children
+        // Auto-assign position at end of new parent's children. Reads
+        // MAX(position) then writes MAX+1 — serialize the read through the
+        // write so a concurrent move/create/add targeting the same parent
+        // can't read the same MAX (see actions/_position-utils.ts).
         const parentId = body.parentId;
-        const maxPos = await db
-          .select({ max: sql<number>`COALESCE(MAX(position), -1)` })
-          .from(schema.documents)
-          .where(
-            parentId
-              ? and(
-                  eq(schema.documents.ownerEmail, ownerEmail),
-                  eq(schema.documents.parentId, parentId),
-                )
-              : and(
-                  eq(schema.documents.ownerEmail, ownerEmail),
-                  sql`parent_id IS NULL`,
-                ),
-          );
-        updates.position = (maxPos[0]?.max ?? -1) + 1;
-      }
-      await db
-        .update(schema.documents)
-        .set(updates)
-        .where(
-          and(
-            eq(schema.documents.id, id),
-            eq(schema.documents.ownerEmail, ownerEmail),
-          ),
+        await withPositionLock(
+          documentsPositionScope(ownerEmail, parentId),
+          async () => {
+            const maxPos = await db
+              .select({ max: sql<number>`COALESCE(MAX(position), -1)` })
+              .from(schema.documents)
+              .where(
+                parentId
+                  ? and(
+                      eq(schema.documents.ownerEmail, ownerEmail),
+                      eq(schema.documents.parentId, parentId),
+                    )
+                  : and(
+                      eq(schema.documents.ownerEmail, ownerEmail),
+                      sql`parent_id IS NULL`,
+                    ),
+              );
+            updates.position = (maxPos[0]?.max ?? -1) + 1;
+            await applyUpdate();
+          },
         );
+      } else {
+        await applyUpdate();
+      }
       const [doc] = await db
         .select()

package/corpus/templates/content/shared/api.ts CHANGED Viewed

@@ -397,7 +397,8 @@ export interface ContentDatabaseSourceOverlay {
 export type ContentDatabaseSourceType =
   | "mock-local"
   | "builder-cms"
-  | "local-table";
+  | "local-table"
+  | "notion-database";
 export type ContentDatabaseSourceSyncState =
   | "idle"
   | "linked"
@@ -672,6 +673,20 @@ export interface BuilderCmsModelsResponse {
   message: string | null;
 }
+export interface NotionDatabaseSourceSummary {
+  id: string;
+  name: string;
+  url: string | null;
+}
+export interface NotionDatabaseSourcesResponse {
+  connected: boolean;
+  workspaceName: string | null;
+  sources: NotionDatabaseSourceSummary[];
+  hasMore: boolean;
+  nextCursor: string | null;
+}
 export interface ContentDatabaseResponse {
   database: ContentDatabase;
   properties: DocumentProperty[];

package/corpus/templates/design/.agents/skills/visual-edit/SKILL.md CHANGED Viewed

@@ -209,10 +209,14 @@ the connected app's text/code files through the bridge
   changed since it was read fails with a version conflict instead of being
   overwritten.
 - React/TSX canvas edits use build/debug provenance to locate the responsible
-  source, but structural meaning belongs to the coding agent. Do not apply a
-  generic AST reparent/group/ungroup transform. Hand off the exact subject and
-  target source anchors plus their runtime relationship; repeated `.map()`
-  instances, shared components, dynamic expressions, and cross-file edits
+  source. A single-instance leaf text edit, literal `className`/`class` edit, or
+  flat literal `style={{ ... }}` property may use `apply-visual-edit` with a
+  `local-file` source and exact `target.sourceAnchor`. Preview first (omit
+  `persist`), inspect `proposedDiff`, then call with `persist: true`; the action
+  re-reads and writes through the consented, version-guarded local bridge.
+  Structural meaning still belongs to the coding agent. Do not apply a generic
+  AST reparent/group/ungroup transform. Repeated `.map()` instances, shared
+  components, dynamic expressions, breakpoint edits, and cross-file edits
   always require semantic inspection.
 - For every semantic React write, read the file first, pass that exact
   `versionHash` to `write-local-file` with `requireExpectedVersionHash: true`,

package/corpus/templates/design/AGENTS.md CHANGED Viewed

@@ -269,6 +269,14 @@ patterns live in `.agents/skills/`.
   layers: text, classes, styles, attributes, source order, and small structural
   changes. Use it for selected-element edits before falling back to full
   `update-design` / `generate-design` rewrites.
+- For localhost JSX/TSX, `apply-visual-edit` also supports a narrow deterministic
+  slice: single-instance leaf text, literal `className`/`class`, and flat literal
+  `style={{ ... }}` properties. Pass `source.kind: "local-file"`, `designId`,
+  `connectionId`, the verified project-relative `path`, and
+  `intent.target.sourceAnchor`. Call once without `persist` and inspect
+  `proposedDiff`; call again with `persist: true` only when it is exact. The
+  action reads the current bridge version and writes through `write-local-file`,
+  so human consent and compare-and-swap remain mandatory.
 - For localhost React/TSX screens, treat compiler/debug metadata (project-relative
   source file, line, column, component, and runtime multiplicity) as evidence
   for locating source, not as permission to run a generic AST transform.
@@ -288,8 +296,10 @@ patterns live in `.agents/skills/`.
   persist by updating that attribute.
 - Inline/Alpine screens continue to use deterministic HTML code-layer edits.
   Localhost React/TSX screens use the semantic coding-agent handoff above;
-  deterministic direct React writes remain intentionally limited to narrowly
-  proven literal edits and never include generic structural transforms.
+  deterministic direct React writes remain intentionally limited to the leaf
+  literal slice above and never include generic structural transforms,
+  breakpoint writes, dynamic expressions, repeated renders, shared component
+  definitions, generated/out-of-root paths, or remote URLs.
 ## Code Workspace

package/corpus/templates/design/DEVELOPING.md CHANGED Viewed

@@ -104,8 +104,11 @@ The shared source model lives in `shared/source-mode.ts`. Use `inline` for
 SQL-backed prototype files, `localhost` for local dev-server artboards, and
 `fusion` only for future hybrid/hosted sources. Bridge operations are named
 `select`, `resolveNodeToFile`, `readFile`, `applyEdit`, `writeFile`,
-`captureSnapshot`, and `captureState`; current localhost writes are contract-only
-until the bridge adds explicit permission hardening.
+`captureSnapshot`, and `captureState`. Localhost file writes run through the
+token-authenticated bridge and require an explicit, time-boxed human consent
+grant. Deterministic JSX write-back is intentionally limited to exact
+single-instance leaf text and literal class/style edits; ambiguous or semantic
+changes fail closed for coding-agent inspection.
 ## Editor Model
@@ -130,10 +133,11 @@ Selectors are fallback aliases, not the primary identity. Localhost React mode
 should resolve through build-time source/debug metadata (generated stable id,
 component, file, and line) before using selector fallbacks.
-Inline source mode supports local code-layer projection and deterministic HTML
-edits through `get-code-layer-projection` and `apply-visual-edit`. Current
-limitations: visual code-layer edits are HTML-only, and localhost reads/writes
-are still bridge-contract scaffolding until permission controls are hardened.
+Inline source mode supports code-layer projection and deterministic HTML edits
+through `get-code-layer-projection` and `apply-visual-edit`. Localhost JSX/TSX
+supports diff-first literal leaf text/class/style edits when an exact source
+anchor resolves to one current file; structural, dynamic, repeated, shared, and
+breakpoint edits remain semantic coding-agent work.
 ## Adding a Route-Only Endpoint