@catafal/notion-cli 5.9.0 → 5.9.2

package/oclif.manifest.json

@@ -3002,99 +3002,6 @@
         "info.js"
       ]
     },
-    "config:set-token": {
-      "aliases": [
-        "config:token"
-      ],
-      "args": {
-        "token": {
-          "description": "Notion integration token (starts with secret_ or ntn_)",
-          "name": "token",
-          "required": false
-        }
-      },
-      "description": "Set NOTION_TOKEN in your shell configuration file",
-      "examples": [
-        {
-          "description": "Set Notion token interactively",
-          "command": "notion-cli config set-token"
-        },
-        {
-          "description": "Set Notion token directly",
-          "command": "notion-cli config set-token ntn_abc123..."
-        },
-        {
-          "description": "Set token with JSON output",
-          "command": "notion-cli config set-token ntn_abc123... --json"
-        }
-      ],
-      "flags": {
-        "json": {
-          "char": "j",
-          "description": "Output as JSON (recommended for automation)",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page-size": {
-          "description": "Items per page (1-100, default: 100 for automation)",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "retry": {
-          "description": "Auto-retry on rate limit (respects Retry-After header)",
-          "name": "retry",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Request timeout in milliseconds",
-          "name": "timeout",
-          "default": 30000,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-cache": {
-          "description": "Bypass cache and force fresh API calls",
-          "name": "no-cache",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Enable verbose logging to stderr (retry events, cache stats) - never pollutes stdout",
-          "env": "NOTION_CLI_VERBOSE",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "minimal": {
-          "description": "Strip unnecessary metadata (created_by, last_edited_by, object fields, request_id, etc.) - reduces response size by ~40%",
-          "name": "minimal",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "config:set-token",
-      "pluginAlias": "@catafal/notion-cli",
-      "pluginName": "@catafal/notion-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "config",
-        "set-token.js"
-      ]
-    },
     "daily": {
       "aliases": [
         "d"
@@ -4260,27 +4167,105 @@
         "update.js"
       ]
     },
-    "user:list": {
+    "page:create": {
       "aliases": [
-        "user:l"
+        "page:c"
       ],
       "args": {},
-      "description": "List all users",
+      "description": "Create a page",
       "examples": [
         {
-          "description": "List all users",
-          "command": "$ notion-cli user list"
+          "description": "Create a page via interactive mode",
+          "command": "$ notion-cli page create"
         },
         {
-          "description": "List all users and output raw json",
-          "command": "$ notion-cli user list -r"
+          "description": "Create a page with a specific parent_page_id",
+          "command": "$ notion-cli page create -p PARENT_PAGE_ID"
         },
         {
-          "description": "List all users and output JSON for automation",
-          "command": "$ notion-cli user list --json"
+          "description": "Create a page with a parent page URL",
+          "command": "$ notion-cli page create -p https://notion.so/PARENT_PAGE_ID"
+        },
+        {
+          "description": "Create a page with a specific parent_db_id",
+          "command": "$ notion-cli page create -d PARENT_DB_ID"
+        },
+        {
+          "description": "Create a page with simple properties (recommended for AI agents)",
+          "command": "$ notion-cli page create -d DATA_SOURCE_ID -S --properties '{\"Name\": \"My Task\", \"Status\": \"In Progress\", \"Due Date\": \"2025-12-31\"}'"
+        },
+        {
+          "description": "Create a page with simple properties using relative dates",
+          "command": "$ notion-cli page create -d DATA_SOURCE_ID -S --properties '{\"Name\": \"Review\", \"Due Date\": \"tomorrow\", \"Priority\": \"High\"}'"
+        },
+        {
+          "description": "Create a page with simple properties and multi-select",
+          "command": "$ notion-cli page create -d DATA_SOURCE_ID -S --properties '{\"Name\": \"Bug Fix\", \"Tags\": [\"urgent\", \"bug\"], \"Status\": \"Done\"}'"
+        },
+        {
+          "description": "Create a page with a specific source markdown file and parent_page_id",
+          "command": "$ notion-cli page create -f ./path/to/source.md -p PARENT_PAGE_ID"
+        },
+        {
+          "description": "Create a page with a specific source markdown file and parent_db_id",
+          "command": "$ notion-cli page create -f ./path/to/source.md -d PARENT_DB_ID"
+        },
+        {
+          "description": "Create a page with a specific source markdown file and output raw json with parent_page_id",
+          "command": "$ notion-cli page create -f ./path/to/source.md -p PARENT_PAGE_ID -r"
+        },
+        {
+          "description": "Create a page and output JSON for automation",
+          "command": "$ notion-cli page create -p PARENT_PAGE_ID --json"
         }
       ],
       "flags": {
+        "parent_page_id": {
+          "char": "p",
+          "description": "Parent page ID or URL (to create a sub-page)",
+          "name": "parent_page_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "parent_data_source_id": {
+          "char": "d",
+          "description": "Parent data source ID or URL (to create a page in a table)",
+          "name": "parent_data_source_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file_path": {
+          "char": "f",
+          "description": "Path to a source markdown file",
+          "name": "file_path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title_property": {
+          "char": "t",
+          "description": "Title property name (auto-detected: \"title\" for sub-pages, \"Name\" for databases)",
+          "name": "title_property",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "properties": {
+          "description": "Page properties as JSON string",
+          "name": "properties",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "simple-properties": {
+          "char": "S",
+          "description": "Use simplified property format (flat key-value pairs, recommended for AI agents)",
+          "name": "simple-properties",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "raw": {
           "char": "r",
           "description": "output raw json",
@@ -4395,7 +4380,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "user:list",
+      "id": "page:create",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -4405,38 +4390,40 @@
       "relativePath": [
         "dist",
         "commands",
-        "user",
-        "list.js"
+        "page",
+        "create.js"
       ]
     },
-    "user:retrieve": {
+    "page:delete": {
       "aliases": [
-        "user:r"
+        "page:d"
       ],
       "args": {
-        "user_id": {
-          "name": "user_id"
+        "page_id": {
+          "description": "Page ID or full Notion URL",
+          "name": "page_id",
+          "required": true
         }
       },
-      "description": "Retrieve a user",
+      "description": "Archive (soft-delete) a Notion page",
       "examples": [
         {
-          "description": "Retrieve a user",
-          "command": "$ notion-cli user retrieve USER_ID"
+          "description": "Delete (archive) a page by ID",
+          "command": "$ notion-cli page delete PAGE_ID"
         },
         {
-          "description": "Retrieve a user and output raw json",
-          "command": "$ notion-cli user retrieve USER_ID -r"
+          "description": "Delete (archive) a page by URL",
+          "command": "$ notion-cli page delete https://notion.so/PAGE_ID"
         },
         {
-          "description": "Retrieve a user and output JSON for automation",
-          "command": "$ notion-cli user retrieve USER_ID --json"
+          "description": "Delete and output JSON for automation",
+          "command": "$ notion-cli page delete PAGE_ID --json"
         }
       ],
       "flags": {
         "raw": {
           "char": "r",
-          "description": "output raw json",
+          "description": "Output raw JSON",
           "name": "raw",
           "allowNo": false,
           "type": "boolean"
@@ -4548,7 +4535,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "user:retrieve",
+      "id": "page:delete",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -4558,40 +4545,64 @@
       "relativePath": [
         "dist",
         "commands",
-        "user",
-        "retrieve.js"
+        "page",
+        "delete.js"
       ]
     },
-    "template:get": {
+    "page:export": {
       "aliases": [
-        "tpl:get"
+        "page:e"
       ],
       "args": {
-        "name": {
-          "description": "Template name",
-          "name": "name",
+        "page_id": {
+          "description": "Page ID or full Notion URL",
+          "name": "page_id",
           "required": true
         }
       },
-      "description": "View a saved template",
+      "description": "Export a Notion page to markdown or JSON",
       "examples": [
         {
-          "description": "View a template",
-          "command": "$ notion-cli template get \"meeting\""
-        }
-      ],
-      "flags": {
-        "json": {
-          "char": "j",
-          "description": "Output as JSON (recommended for automation)",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "Export page as markdown to stdout",
+          "command": "$ notion-cli page export PAGE_ID"
         },
-        "page-size": {
-          "description": "Items per page (1-100, default: 100 for automation)",
-          "name": "page-size",
-          "default": 100,
+        {
+          "description": "Export page as markdown to a file",
+          "command": "$ notion-cli page export PAGE_ID -o notes.md"
+        },
+        {
+          "description": "Export page as JSON to a file",
+          "command": "$ notion-cli page export PAGE_ID --json -o page.json"
+        },
+        {
+          "description": "Export using a Notion URL",
+          "command": "$ notion-cli page export \"https://notion.so/My-Page-abc123\" -o notes.md"
+        },
+        {
+          "description": "Pipe markdown to another command",
+          "command": "$ notion-cli page export PAGE_ID | head -20"
+        }
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "File path to write (omit for stdout)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "char": "j",
+          "description": "Output as JSON (recommended for automation)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page-size": {
+          "description": "Items per page (1-100, default: 100 for automation)",
+          "name": "page-size",
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4633,7 +4644,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:get",
+      "id": "page:export",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -4643,23 +4654,119 @@
       "relativePath": [
         "dist",
         "commands",
-        "template",
-        "get.js"
+        "page",
+        "export.js"
       ]
     },
-    "template:list": {
+    "page:retrieve": {
       "aliases": [
-        "tpl:ls"
+        "page:r"
       ],
-      "args": {},
-      "description": "List all saved templates",
+      "args": {
+        "page_id": {
+          "description": "Page ID or full Notion URL (e.g., https://notion.so/...)",
+          "name": "page_id",
+          "required": true
+        }
+      },
+      "description": "Retrieve a page",
       "examples": [
         {
-          "description": "List all templates",
-          "command": "$ notion-cli template list"
+          "description": "Retrieve a page with full data (recommended for AI assistants)",
+          "command": "$ notion-cli page retrieve PAGE_ID -r"
+        },
+        {
+          "description": "Fast structure overview (90% faster than full fetch)",
+          "command": "$ notion-cli page retrieve PAGE_ID --map"
+        },
+        {
+          "description": "Fast structure overview with compact JSON",
+          "command": "$ notion-cli page retrieve PAGE_ID --map --compact-json"
+        },
+        {
+          "description": "Retrieve entire page tree with all nested content (35% token reduction)",
+          "command": "$ notion-cli page retrieve PAGE_ID --recursive --compact-json"
+        },
+        {
+          "description": "Retrieve page tree with custom depth limit",
+          "command": "$ notion-cli page retrieve PAGE_ID -R --max-depth 5 --json"
+        },
+        {
+          "description": "Retrieve a page and output table",
+          "command": "$ notion-cli page retrieve PAGE_ID"
+        },
+        {
+          "description": "Retrieve a page via URL",
+          "command": "$ notion-cli page retrieve https://notion.so/PAGE_ID"
+        },
+        {
+          "description": "Retrieve a page and output raw json",
+          "command": "$ notion-cli page retrieve PAGE_ID -r"
+        },
+        {
+          "description": "Retrieve a page and output markdown",
+          "command": "$ notion-cli page retrieve PAGE_ID -m"
+        },
+        {
+          "description": "Retrieve a page metadata and output as markdown table",
+          "command": "$ notion-cli page retrieve PAGE_ID --markdown"
+        },
+        {
+          "description": "Retrieve a page metadata and output as compact JSON",
+          "command": "$ notion-cli page retrieve PAGE_ID --compact-json"
+        },
+        {
+          "description": "Retrieve a page and output JSON for automation",
+          "command": "$ notion-cli page retrieve PAGE_ID --json"
         }
       ],
       "flags": {
+        "raw": {
+          "char": "r",
+          "description": "output raw json (recommended for AI assistants - returns all fields)",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "markdown": {
+          "char": "m",
+          "description": "Output as markdown table (GitHub-flavored)",
+          "exclusive": [
+            "compact-json",
+            "pretty"
+          ],
+          "name": "markdown",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "map": {
+          "description": "fast structure discovery (returns minimal info: titles, types, IDs)",
+          "exclusive": [
+            "raw",
+            "markdown"
+          ],
+          "name": "map",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "recursive": {
+          "char": "R",
+          "description": "recursively fetch all blocks and nested pages (reduces API calls)",
+          "name": "recursive",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-depth": {
+          "dependsOn": [
+            "recursive"
+          ],
+          "description": "maximum recursion depth for --recursive (default: 3)",
+          "name": "max-depth",
+          "default": 3,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "columns": {
           "description": "Only show provided columns (comma-separated)",
           "exclusive": [
@@ -4715,6 +4822,28 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "compact-json": {
+          "char": "c",
+          "description": "Output as compact JSON (single-line, ideal for piping)",
+          "exclusive": [
+            "markdown",
+            "pretty"
+          ],
+          "name": "compact-json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pretty": {
+          "char": "P",
+          "description": "Output as pretty table with borders",
+          "exclusive": [
+            "markdown",
+            "compact-json"
+          ],
+          "name": "pretty",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "char": "j",
           "description": "Output as JSON (recommended for automation)",
@@ -4767,7 +4896,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:list",
+      "id": "page:retrieve",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -4777,43 +4906,173 @@
       "relativePath": [
         "dist",
         "commands",
-        "template",
-        "list.js"
+        "page",
+        "retrieve.js"
       ]
     },
-    "template:remove": {
+    "page:update": {
       "aliases": [
-        "tpl:rm"
+        "page:u"
       ],
       "args": {
-        "name": {
-          "description": "Template name to remove",
-          "name": "name",
+        "page_id": {
+          "description": "Page ID or full Notion URL (e.g., https://notion.so/...)",
+          "name": "page_id",
           "required": true
         }
       },
-      "description": "Remove a saved template",
+      "description": "Update a page",
       "examples": [
         {
-          "description": "Remove a template",
-          "command": "$ notion-cli template remove \"meeting\""
+          "description": "Update a page and output table",
+          "command": "$ notion-cli page update PAGE_ID"
+        },
+        {
+          "description": "Update a page via URL",
+          "command": "$ notion-cli page update https://notion.so/PAGE_ID -a"
+        },
+        {
+          "description": "Update page properties with simple format (recommended for AI agents)",
+          "command": "$ notion-cli page update PAGE_ID -S --properties '{\"Status\": \"Done\", \"Priority\": \"High\"}'"
+        },
+        {
+          "description": "Update page properties with relative date",
+          "command": "$ notion-cli page update PAGE_ID -S --properties '{\"Due Date\": \"tomorrow\", \"Status\": \"In Progress\"}'"
+        },
+        {
+          "description": "Update page with multi-select tags",
+          "command": "$ notion-cli page update PAGE_ID -S --properties '{\"Tags\": [\"urgent\", \"bug\"], \"Status\": \"Done\"}'"
+        },
+        {
+          "description": "Update a page and output raw json",
+          "command": "$ notion-cli page update PAGE_ID -r"
+        },
+        {
+          "description": "Update a page and archive",
+          "command": "$ notion-cli page update PAGE_ID -a"
+        },
+        {
+          "description": "Update a page and unarchive",
+          "command": "$ notion-cli page update PAGE_ID -u"
+        },
+        {
+          "description": "Update a page and archive and output raw json",
+          "command": "$ notion-cli page update PAGE_ID -a -r"
+        },
+        {
+          "description": "Update a page and unarchive and output raw json",
+          "command": "$ notion-cli page update PAGE_ID -u -r"
+        },
+        {
+          "description": "Update a page and output JSON for automation",
+          "command": "$ notion-cli page update PAGE_ID -a --json"
         }
       ],
       "flags": {
-        "json": {
-          "char": "j",
-          "description": "Output as JSON (recommended for automation)",
-          "name": "json",
+        "archived": {
+          "char": "a",
+          "description": "Archive the page",
+          "name": "archived",
           "allowNo": false,
           "type": "boolean"
         },
-        "page-size": {
-          "description": "Items per page (1-100, default: 100 for automation)",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "unarchive": {
+          "char": "u",
+          "description": "Unarchive the page",
+          "name": "unarchive",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "properties": {
+          "description": "Page properties to update as JSON string",
+          "name": "properties",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "simple-properties": {
+          "char": "S",
+          "description": "Use simplified property format (flat key-value pairs, recommended for AI agents)",
+          "name": "simple-properties",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "raw": {
+          "char": "r",
+          "description": "output raw json",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "columns": {
+          "description": "Only show provided columns (comma-separated)",
+          "exclusive": [
+            "extended"
+          ],
+          "name": "columns",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Property to sort by (prepend with - for descending)",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter property by substring match",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "csv": {
+          "description": "Output in CSV format",
+          "exclusive": [
+            "no-truncate"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "extended": {
+          "char": "x",
+          "description": "Show extra columns",
+          "name": "extended",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-truncate": {
+          "description": "Do not truncate output to fit screen",
+          "exclusive": [
+            "csv"
+          ],
+          "name": "no-truncate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-header": {
+          "description": "Hide table header from output",
+          "name": "no-header",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "Output as JSON (recommended for automation)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page-size": {
+          "description": "Items per page (1-100, default: 100 for automation)",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "retry": {
           "description": "Auto-retry on rate limit (respects Retry-After header)",
@@ -4852,7 +5111,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:remove",
+      "id": "page:update",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -4862,56 +5121,37 @@
       "relativePath": [
         "dist",
         "commands",
-        "template",
-        "remove.js"
+        "page",
+        "update.js"
       ]
     },
-    "template:save": {
+    "config:set-token": {
       "aliases": [
-        "tpl:save"
+        "config:token"
       ],
       "args": {
-        "name": {
-          "description": "Template name (e.g. \"meeting\", \"task\")",
-          "name": "name",
-          "required": true
+        "token": {
+          "description": "Notion integration token (starts with secret_ or ntn_)",
+          "name": "token",
+          "required": false
         }
       },
-      "description": "Save a reusable page template",
+      "description": "Set NOTION_TOKEN in your shell configuration file",
       "examples": [
         {
-          "description": "Save a template with properties",
-          "command": "$ notion-cli template save \"meeting\" --properties '{\"Status\": \"To Do\", \"Type\": \"Meeting\"}'"
+          "description": "Set Notion token interactively",
+          "command": "notion-cli config set-token"
         },
         {
-          "description": "Save with properties, body content, and icon",
-          "command": "$ notion-cli template save \"standup\" --properties '{\"Status\": \"In Progress\"}' --content \"# Standup\\n\\n## Done\\n\\n## Doing\\n\\n## Blockers\" --icon \"🧑‍💻\""
+          "description": "Set Notion token directly",
+          "command": "notion-cli config set-token ntn_abc123..."
+        },
+        {
+          "description": "Set token with JSON output",
+          "command": "notion-cli config set-token ntn_abc123... --json"
         }
       ],
       "flags": {
-        "properties": {
-          "char": "p",
-          "description": "Properties as JSON (simple format, e.g. '{\"Status\": \"To Do\"}')",
-          "name": "properties",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "char": "c",
-          "description": "Markdown body content for the page",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "icon": {
-          "description": "Emoji icon (e.g. \"📋\")",
-          "name": "icon",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "json": {
           "char": "j",
           "description": "Output as JSON (recommended for automation)",
@@ -4964,7 +5204,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:save",
+      "id": "config:set-token",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -4974,49 +5214,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "template",
-        "save.js"
+        "config",
+        "set-token.js"
       ]
     },
-    "template:use": {
+    "template:get": {
       "aliases": [
-        "tpl:use"
+        "tpl:get"
       ],
       "args": {
         "name": {
-          "description": "Template name to use",
+          "description": "Template name",
           "name": "name",
           "required": true
         }
       },
-      "description": "Create a page from a saved template",
+      "description": "View a saved template",
       "examples": [
         {
-          "description": "Create a page from a template",
-          "command": "$ notion-cli template use \"meeting\" --to tasks --title \"Sprint Planning\""
-        },
-        {
-          "description": "Use default bookmark as target",
-          "command": "$ notion-cli template use \"task\" --title \"Fix login bug\""
+          "description": "View a template",
+          "command": "$ notion-cli template get \"meeting\""
         }
       ],
       "flags": {
-        "to": {
-          "description": "Target bookmark name, database name, or ID (defaults to default bookmark)",
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "char": "t",
-          "description": "Page title (overrides any title in template properties)",
-          "name": "title",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "json": {
           "char": "j",
           "description": "Output as JSON (recommended for automation)",
@@ -5069,7 +5289,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "template:use",
+      "id": "template:get",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -5080,128 +5300,35 @@
         "dist",
         "commands",
         "template",
-        "use.js"
+        "get.js"
       ]
     },
-    "page:create": {
+    "template:list": {
       "aliases": [
-        "page:c"
+        "tpl:ls"
       ],
       "args": {},
-      "description": "Create a page",
+      "description": "List all saved templates",
       "examples": [
         {
-          "description": "Create a page via interactive mode",
-          "command": "$ notion-cli page create"
-        },
-        {
-          "description": "Create a page with a specific parent_page_id",
-          "command": "$ notion-cli page create -p PARENT_PAGE_ID"
-        },
-        {
-          "description": "Create a page with a parent page URL",
-          "command": "$ notion-cli page create -p https://notion.so/PARENT_PAGE_ID"
-        },
-        {
-          "description": "Create a page with a specific parent_db_id",
-          "command": "$ notion-cli page create -d PARENT_DB_ID"
-        },
-        {
-          "description": "Create a page with simple properties (recommended for AI agents)",
-          "command": "$ notion-cli page create -d DATA_SOURCE_ID -S --properties '{\"Name\": \"My Task\", \"Status\": \"In Progress\", \"Due Date\": \"2025-12-31\"}'"
-        },
-        {
-          "description": "Create a page with simple properties using relative dates",
-          "command": "$ notion-cli page create -d DATA_SOURCE_ID -S --properties '{\"Name\": \"Review\", \"Due Date\": \"tomorrow\", \"Priority\": \"High\"}'"
-        },
-        {
-          "description": "Create a page with simple properties and multi-select",
-          "command": "$ notion-cli page create -d DATA_SOURCE_ID -S --properties '{\"Name\": \"Bug Fix\", \"Tags\": [\"urgent\", \"bug\"], \"Status\": \"Done\"}'"
-        },
-        {
-          "description": "Create a page with a specific source markdown file and parent_page_id",
-          "command": "$ notion-cli page create -f ./path/to/source.md -p PARENT_PAGE_ID"
-        },
-        {
-          "description": "Create a page with a specific source markdown file and parent_db_id",
-          "command": "$ notion-cli page create -f ./path/to/source.md -d PARENT_DB_ID"
-        },
-        {
-          "description": "Create a page with a specific source markdown file and output raw json with parent_page_id",
-          "command": "$ notion-cli page create -f ./path/to/source.md -p PARENT_PAGE_ID -r"
-        },
-        {
-          "description": "Create a page and output JSON for automation",
-          "command": "$ notion-cli page create -p PARENT_PAGE_ID --json"
+          "description": "List all templates",
+          "command": "$ notion-cli template list"
         }
       ],
       "flags": {
-        "parent_page_id": {
-          "char": "p",
-          "description": "Parent page ID or URL (to create a sub-page)",
-          "name": "parent_page_id",
+        "columns": {
+          "description": "Only show provided columns (comma-separated)",
+          "exclusive": [
+            "extended"
+          ],
+          "name": "columns",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "parent_data_source_id": {
-          "char": "d",
-          "description": "Parent data source ID or URL (to create a page in a table)",
-          "name": "parent_data_source_id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file_path": {
-          "char": "f",
-          "description": "Path to a source markdown file",
-          "name": "file_path",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title_property": {
-          "char": "t",
-          "description": "Title property name (auto-detected: \"title\" for sub-pages, \"Name\" for databases)",
-          "name": "title_property",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "properties": {
-          "description": "Page properties as JSON string",
-          "name": "properties",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "simple-properties": {
-          "char": "S",
-          "description": "Use simplified property format (flat key-value pairs, recommended for AI agents)",
-          "name": "simple-properties",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "raw": {
-          "char": "r",
-          "description": "output raw json",
-          "name": "raw",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "columns": {
-          "description": "Only show provided columns (comma-separated)",
-          "exclusive": [
-            "extended"
-          ],
-          "name": "columns",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort": {
-          "description": "Property to sort by (prepend with - for descending)",
-          "name": "sort",
+        "sort": {
+          "description": "Property to sort by (prepend with - for descending)",
+          "name": "sort",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5296,7 +5423,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "page:create",
+      "id": "template:list",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -5306,99 +5433,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "create.js"
+        "template",
+        "list.js"
       ]
     },
-    "page:delete": {
+    "template:remove": {
       "aliases": [
-        "page:d"
+        "tpl:rm"
       ],
       "args": {
-        "page_id": {
-          "description": "Page ID or full Notion URL",
-          "name": "page_id",
+        "name": {
+          "description": "Template name to remove",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Archive (soft-delete) a Notion page",
+      "description": "Remove a saved template",
       "examples": [
         {
-          "description": "Delete (archive) a page by ID",
-          "command": "$ notion-cli page delete PAGE_ID"
-        },
-        {
-          "description": "Delete (archive) a page by URL",
-          "command": "$ notion-cli page delete https://notion.so/PAGE_ID"
-        },
-        {
-          "description": "Delete and output JSON for automation",
-          "command": "$ notion-cli page delete PAGE_ID --json"
+          "description": "Remove a template",
+          "command": "$ notion-cli template remove \"meeting\""
         }
       ],
       "flags": {
-        "raw": {
-          "char": "r",
-          "description": "Output raw JSON",
-          "name": "raw",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "columns": {
-          "description": "Only show provided columns (comma-separated)",
-          "exclusive": [
-            "extended"
-          ],
-          "name": "columns",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort": {
-          "description": "Property to sort by (prepend with - for descending)",
-          "name": "sort",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter": {
-          "description": "Filter property by substring match",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "csv": {
-          "description": "Output in CSV format",
-          "exclusive": [
-            "no-truncate"
-          ],
-          "name": "csv",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "extended": {
-          "char": "x",
-          "description": "Show extra columns",
-          "name": "extended",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-truncate": {
-          "description": "Do not truncate output to fit screen",
-          "exclusive": [
-            "csv"
-          ],
-          "name": "no-truncate",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-header": {
-          "description": "Hide table header from output",
-          "name": "no-header",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "json": {
           "char": "j",
           "description": "Output as JSON (recommended for automation)",
@@ -5451,7 +5508,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "page:delete",
+      "id": "template:remove",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -5461,49 +5518,52 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "delete.js"
+        "template",
+        "remove.js"
       ]
     },
-    "page:export": {
+    "template:save": {
       "aliases": [
-        "page:e"
+        "tpl:save"
       ],
       "args": {
-        "page_id": {
-          "description": "Page ID or full Notion URL",
-          "name": "page_id",
+        "name": {
+          "description": "Template name (e.g. \"meeting\", \"task\")",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Export a Notion page to markdown or JSON",
+      "description": "Save a reusable page template",
       "examples": [
         {
-          "description": "Export page as markdown to stdout",
-          "command": "$ notion-cli page export PAGE_ID"
-        },
-        {
-          "description": "Export page as markdown to a file",
-          "command": "$ notion-cli page export PAGE_ID -o notes.md"
-        },
-        {
-          "description": "Export page as JSON to a file",
-          "command": "$ notion-cli page export PAGE_ID --json -o page.json"
-        },
-        {
-          "description": "Export using a Notion URL",
-          "command": "$ notion-cli page export \"https://notion.so/My-Page-abc123\" -o notes.md"
+          "description": "Save a template with properties",
+          "command": "$ notion-cli template save \"meeting\" --properties '{\"Status\": \"To Do\", \"Type\": \"Meeting\"}'"
         },
         {
-          "description": "Pipe markdown to another command",
-          "command": "$ notion-cli page export PAGE_ID | head -20"
+          "description": "Save with properties, body content, and icon",
+          "command": "$ notion-cli template save \"standup\" --properties '{\"Status\": \"In Progress\"}' --content \"# Standup\\n\\n## Done\\n\\n## Doing\\n\\n## Blockers\" --icon \"🧑‍💻\""
         }
       ],
       "flags": {
-        "output": {
-          "char": "o",
-          "description": "File path to write (omit for stdout)",
-          "name": "output",
+        "properties": {
+          "char": "p",
+          "description": "Properties as JSON (simple format, e.g. '{\"Status\": \"To Do\"}')",
+          "name": "properties",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "char": "c",
+          "description": "Markdown body content for the page",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "icon": {
+          "description": "Emoji icon (e.g. \"📋\")",
+          "name": "icon",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5560,7 +5620,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "page:export",
+      "id": "template:save",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -5570,196 +5630,49 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "export.js"
+        "template",
+        "save.js"
       ]
     },
-    "page:retrieve": {
+    "template:use": {
       "aliases": [
-        "page:r"
+        "tpl:use"
       ],
       "args": {
-        "page_id": {
-          "description": "Page ID or full Notion URL (e.g., https://notion.so/...)",
-          "name": "page_id",
+        "name": {
+          "description": "Template name to use",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Retrieve a page",
+      "description": "Create a page from a saved template",
       "examples": [
         {
-          "description": "Retrieve a page with full data (recommended for AI assistants)",
-          "command": "$ notion-cli page retrieve PAGE_ID -r"
-        },
-        {
-          "description": "Fast structure overview (90% faster than full fetch)",
-          "command": "$ notion-cli page retrieve PAGE_ID --map"
-        },
-        {
-          "description": "Fast structure overview with compact JSON",
-          "command": "$ notion-cli page retrieve PAGE_ID --map --compact-json"
-        },
-        {
-          "description": "Retrieve entire page tree with all nested content (35% token reduction)",
-          "command": "$ notion-cli page retrieve PAGE_ID --recursive --compact-json"
-        },
-        {
-          "description": "Retrieve page tree with custom depth limit",
-          "command": "$ notion-cli page retrieve PAGE_ID -R --max-depth 5 --json"
-        },
-        {
-          "description": "Retrieve a page and output table",
-          "command": "$ notion-cli page retrieve PAGE_ID"
-        },
-        {
-          "description": "Retrieve a page via URL",
-          "command": "$ notion-cli page retrieve https://notion.so/PAGE_ID"
-        },
-        {
-          "description": "Retrieve a page and output raw json",
-          "command": "$ notion-cli page retrieve PAGE_ID -r"
-        },
-        {
-          "description": "Retrieve a page and output markdown",
-          "command": "$ notion-cli page retrieve PAGE_ID -m"
-        },
-        {
-          "description": "Retrieve a page metadata and output as markdown table",
-          "command": "$ notion-cli page retrieve PAGE_ID --markdown"
-        },
-        {
-          "description": "Retrieve a page metadata and output as compact JSON",
-          "command": "$ notion-cli page retrieve PAGE_ID --compact-json"
+          "description": "Create a page from a template",
+          "command": "$ notion-cli template use \"meeting\" --to tasks --title \"Sprint Planning\""
         },
         {
-          "description": "Retrieve a page and output JSON for automation",
-          "command": "$ notion-cli page retrieve PAGE_ID --json"
+          "description": "Use default bookmark as target",
+          "command": "$ notion-cli template use \"task\" --title \"Fix login bug\""
         }
       ],
       "flags": {
-        "raw": {
-          "char": "r",
-          "description": "output raw json (recommended for AI assistants - returns all fields)",
-          "name": "raw",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "markdown": {
-          "char": "m",
-          "description": "Output as markdown table (GitHub-flavored)",
-          "exclusive": [
-            "compact-json",
-            "pretty"
-          ],
-          "name": "markdown",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "map": {
-          "description": "fast structure discovery (returns minimal info: titles, types, IDs)",
-          "exclusive": [
-            "raw",
-            "markdown"
-          ],
-          "name": "map",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "recursive": {
-          "char": "R",
-          "description": "recursively fetch all blocks and nested pages (reduces API calls)",
-          "name": "recursive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "max-depth": {
-          "dependsOn": [
-            "recursive"
-          ],
-          "description": "maximum recursion depth for --recursive (default: 3)",
-          "name": "max-depth",
-          "default": 3,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "columns": {
-          "description": "Only show provided columns (comma-separated)",
-          "exclusive": [
-            "extended"
-          ],
-          "name": "columns",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort": {
-          "description": "Property to sort by (prepend with - for descending)",
-          "name": "sort",
+        "to": {
+          "description": "Target bookmark name, database name, or ID (defaults to default bookmark)",
+          "name": "to",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "filter": {
-          "description": "Filter property by substring match",
-          "name": "filter",
+        "title": {
+          "char": "t",
+          "description": "Page title (overrides any title in template properties)",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "csv": {
-          "description": "Output in CSV format",
-          "exclusive": [
-            "no-truncate"
-          ],
-          "name": "csv",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "extended": {
-          "char": "x",
-          "description": "Show extra columns",
-          "name": "extended",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-truncate": {
-          "description": "Do not truncate output to fit screen",
-          "exclusive": [
-            "csv"
-          ],
-          "name": "no-truncate",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-header": {
-          "description": "Hide table header from output",
-          "name": "no-header",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "compact-json": {
-          "char": "c",
-          "description": "Output as compact JSON (single-line, ideal for piping)",
-          "exclusive": [
-            "markdown",
-            "pretty"
-          ],
-          "name": "compact-json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pretty": {
-          "char": "P",
-          "description": "Output as pretty table with borders",
-          "exclusive": [
-            "markdown",
-            "compact-json"
-          ],
-          "name": "pretty",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "json": {
           "char": "j",
           "description": "Output as JSON (recommended for automation)",
@@ -5812,7 +5725,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "page:retrieve",
+      "id": "template:use",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -5822,97 +5735,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "retrieve.js"
+        "template",
+        "use.js"
       ]
     },
-    "page:update": {
+    "user:list": {
       "aliases": [
-        "page:u"
+        "user:l"
       ],
-      "args": {
-        "page_id": {
-          "description": "Page ID or full Notion URL (e.g., https://notion.so/...)",
-          "name": "page_id",
-          "required": true
-        }
-      },
-      "description": "Update a page",
+      "args": {},
+      "description": "List all users",
       "examples": [
         {
-          "description": "Update a page and output table",
-          "command": "$ notion-cli page update PAGE_ID"
-        },
-        {
-          "description": "Update a page via URL",
-          "command": "$ notion-cli page update https://notion.so/PAGE_ID -a"
-        },
-        {
-          "description": "Update page properties with simple format (recommended for AI agents)",
-          "command": "$ notion-cli page update PAGE_ID -S --properties '{\"Status\": \"Done\", \"Priority\": \"High\"}'"
-        },
-        {
-          "description": "Update page properties with relative date",
-          "command": "$ notion-cli page update PAGE_ID -S --properties '{\"Due Date\": \"tomorrow\", \"Status\": \"In Progress\"}'"
-        },
-        {
-          "description": "Update page with multi-select tags",
-          "command": "$ notion-cli page update PAGE_ID -S --properties '{\"Tags\": [\"urgent\", \"bug\"], \"Status\": \"Done\"}'"
-        },
-        {
-          "description": "Update a page and output raw json",
-          "command": "$ notion-cli page update PAGE_ID -r"
-        },
-        {
-          "description": "Update a page and archive",
-          "command": "$ notion-cli page update PAGE_ID -a"
-        },
-        {
-          "description": "Update a page and unarchive",
-          "command": "$ notion-cli page update PAGE_ID -u"
-        },
-        {
-          "description": "Update a page and archive and output raw json",
-          "command": "$ notion-cli page update PAGE_ID -a -r"
-        },
-        {
-          "description": "Update a page and unarchive and output raw json",
-          "command": "$ notion-cli page update PAGE_ID -u -r"
+          "description": "List all users",
+          "command": "$ notion-cli user list"
         },
         {
-          "description": "Update a page and output JSON for automation",
-          "command": "$ notion-cli page update PAGE_ID -a --json"
-        }
-      ],
-      "flags": {
-        "archived": {
-          "char": "a",
-          "description": "Archive the page",
-          "name": "archived",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "unarchive": {
-          "char": "u",
-          "description": "Unarchive the page",
-          "name": "unarchive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "properties": {
-          "description": "Page properties to update as JSON string",
-          "name": "properties",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "simple-properties": {
-          "char": "S",
-          "description": "Use simplified property format (flat key-value pairs, recommended for AI agents)",
-          "name": "simple-properties",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "List all users and output raw json",
+          "command": "$ notion-cli user list -r"
         },
+        {
+          "description": "List all users and output JSON for automation",
+          "command": "$ notion-cli user list --json"
+        }
+      ],
+      "flags": {
         "raw": {
           "char": "r",
           "description": "output raw json",
@@ -6027,7 +5874,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "page:update",
+      "id": "user:list",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -6037,42 +5884,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "page",
-        "update.js"
+        "user",
+        "list.js"
       ]
     },
-    "block:retrieve:children": {
+    "user:retrieve": {
       "aliases": [
-        "block:r:c"
+        "user:r"
       ],
       "args": {
-        "block_id": {
-          "description": "block_id or page_id",
-          "name": "block_id",
-          "required": true
+        "user_id": {
+          "name": "user_id"
         }
       },
-      "description": "Retrieve block children (supports database discovery via --show-databases)",
+      "description": "Retrieve a user",
       "examples": [
         {
-          "description": "Retrieve block children",
-          "command": "$ notion-cli block retrieve:children BLOCK_ID"
-        },
-        {
-          "description": "Retrieve block children and output raw json",
-          "command": "$ notion-cli block retrieve:children BLOCK_ID -r"
-        },
-        {
-          "description": "Retrieve block children and output JSON for automation",
-          "command": "$ notion-cli block retrieve:children BLOCK_ID --json"
+          "description": "Retrieve a user",
+          "command": "$ notion-cli user retrieve USER_ID"
         },
         {
-          "description": "Discover databases on a page with queryable IDs",
-          "command": "$ notion-cli block retrieve:children PAGE_ID --show-databases"
+          "description": "Retrieve a user and output raw json",
+          "command": "$ notion-cli user retrieve USER_ID -r"
         },
         {
-          "description": "Get databases as JSON for automation",
-          "command": "$ notion-cli block retrieve:children PAGE_ID --show-databases --json"
+          "description": "Retrieve a user and output JSON for automation",
+          "command": "$ notion-cli user retrieve USER_ID --json"
         }
       ],
       "flags": {
@@ -6083,13 +5920,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "show-databases": {
-          "char": "d",
-          "description": "show only child databases with their queryable IDs (data_source_id)",
-          "name": "show-databases",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "columns": {
           "description": "Only show provided columns (comma-separated)",
           "exclusive": [
@@ -6197,7 +6027,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "block:retrieve:children",
+      "id": "user:retrieve",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -6207,29 +6037,42 @@
       "relativePath": [
         "dist",
         "commands",
-        "block",
-        "retrieve",
-        "children.js"
+        "user",
+        "retrieve.js"
       ]
     },
-    "user:retrieve:bot": {
+    "block:retrieve:children": {
       "aliases": [
-        "user:r:b"
+        "block:r:c"
       ],
-      "args": {},
-      "description": "Retrieve a bot user",
+      "args": {
+        "block_id": {
+          "description": "block_id or page_id",
+          "name": "block_id",
+          "required": true
+        }
+      },
+      "description": "Retrieve block children (supports database discovery via --show-databases)",
       "examples": [
         {
-          "description": "Retrieve a bot user",
-          "command": "$ notion-cli user retrieve:bot"
+          "description": "Retrieve block children",
+          "command": "$ notion-cli block retrieve:children BLOCK_ID"
         },
         {
-          "description": "Retrieve a bot user and output raw json",
-          "command": "$ notion-cli user retrieve:bot -r"
+          "description": "Retrieve block children and output raw json",
+          "command": "$ notion-cli block retrieve:children BLOCK_ID -r"
         },
         {
-          "description": "Retrieve a bot user and output JSON for automation",
-          "command": "$ notion-cli user retrieve:bot --json"
+          "description": "Retrieve block children and output JSON for automation",
+          "command": "$ notion-cli block retrieve:children BLOCK_ID --json"
+        },
+        {
+          "description": "Discover databases on a page with queryable IDs",
+          "command": "$ notion-cli block retrieve:children PAGE_ID --show-databases"
+        },
+        {
+          "description": "Get databases as JSON for automation",
+          "command": "$ notion-cli block retrieve:children PAGE_ID --show-databases --json"
         }
       ],
       "flags": {
@@ -6240,6 +6083,13 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "show-databases": {
+          "char": "d",
+          "description": "show only child databases with their queryable IDs (data_source_id)",
+          "name": "show-databases",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "columns": {
           "description": "Only show provided columns (comma-separated)",
           "exclusive": [
@@ -6347,7 +6197,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "user:retrieve:bot",
+      "id": "block:retrieve:children",
       "pluginAlias": "@catafal/notion-cli",
       "pluginName": "@catafal/notion-cli",
       "pluginType": "core",
@@ -6357,9 +6207,9 @@
       "relativePath": [
         "dist",
         "commands",
-        "user",
+        "block",
         "retrieve",
-        "bot.js"
+        "children.js"
       ]
     },
     "page:retrieve:property_item": {
@@ -6465,7 +6315,157 @@
         "retrieve",
         "property_item.js"
       ]
+    },
+    "user:retrieve:bot": {
+      "aliases": [
+        "user:r:b"
+      ],
+      "args": {},
+      "description": "Retrieve a bot user",
+      "examples": [
+        {
+          "description": "Retrieve a bot user",
+          "command": "$ notion-cli user retrieve:bot"
+        },
+        {
+          "description": "Retrieve a bot user and output raw json",
+          "command": "$ notion-cli user retrieve:bot -r"
+        },
+        {
+          "description": "Retrieve a bot user and output JSON for automation",
+          "command": "$ notion-cli user retrieve:bot --json"
+        }
+      ],
+      "flags": {
+        "raw": {
+          "char": "r",
+          "description": "output raw json",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "columns": {
+          "description": "Only show provided columns (comma-separated)",
+          "exclusive": [
+            "extended"
+          ],
+          "name": "columns",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Property to sort by (prepend with - for descending)",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter property by substring match",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "csv": {
+          "description": "Output in CSV format",
+          "exclusive": [
+            "no-truncate"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "extended": {
+          "char": "x",
+          "description": "Show extra columns",
+          "name": "extended",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-truncate": {
+          "description": "Do not truncate output to fit screen",
+          "exclusive": [
+            "csv"
+          ],
+          "name": "no-truncate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-header": {
+          "description": "Hide table header from output",
+          "name": "no-header",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "Output as JSON (recommended for automation)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page-size": {
+          "description": "Items per page (1-100, default: 100 for automation)",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "retry": {
+          "description": "Auto-retry on rate limit (respects Retry-After header)",
+          "name": "retry",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Request timeout in milliseconds",
+          "name": "timeout",
+          "default": 30000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-cache": {
+          "description": "Bypass cache and force fresh API calls",
+          "name": "no-cache",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Enable verbose logging to stderr (retry events, cache stats) - never pollutes stdout",
+          "env": "NOTION_CLI_VERBOSE",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "minimal": {
+          "description": "Strip unnecessary metadata (created_by, last_edited_by, object fields, request_id, etc.) - reduces response size by ~40%",
+          "name": "minimal",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "user:retrieve:bot",
+      "pluginAlias": "@catafal/notion-cli",
+      "pluginName": "@catafal/notion-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "user",
+        "retrieve",
+        "bot.js"
+      ]
     }
   },
-  "version": "5.9.0"
+  "version": "5.9.2"
 }