@infograb/notion-cli 5.9.0

package/dist/commands/page/create.d.ts

@@ -0,0 +1,33 @@
+import { Command } from '@oclif/core';
+export default class PageCreate extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'page-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        retry: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-cache': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        minimal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        columns: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        filter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        csv: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        extended: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-truncate': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-header': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        parent_page_id: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        parent_data_source_id: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        file_path: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        title_property: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        properties: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'simple-properties': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/page/create.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const table_formatter_1 = require("../../utils/table-formatter");
+const notion = require("../../notion");
+const fs = require("fs");
+const path = require("path");
+const markdown_to_blocks_1 = require("../../utils/markdown-to-blocks");
+const helper_1 = require("../../helper");
+const notion_resolver_1 = require("../../utils/notion-resolver");
+const base_flags_1 = require("../../base-flags");
+const errors_1 = require("../../errors");
+const property_expander_1 = require("../../utils/property-expander");
+class PageCreate extends core_1.Command {
+    async run() {
+        const { flags } = await this.parse(PageCreate);
+        try {
+            let pageProps;
+            let pageParent;
+            if (flags.parent_page_id) {
+                // Resolve parent page ID from URL, direct ID, or name (future)
+                const parentPageId = await (0, notion_resolver_1.resolveNotionId)(flags.parent_page_id, 'page');
+                pageParent = {
+                    page_id: parentPageId,
+                };
+            }
+            else {
+                // Resolve parent database ID from URL, direct ID, or name (future)
+                const parentDataSourceId = await (0, notion_resolver_1.resolveNotionId)(flags.parent_data_source_id, 'database');
+                pageParent = {
+                    data_source_id: parentDataSourceId,
+                };
+            }
+            // Build properties object
+            let properties = {};
+            // Handle properties flag
+            if (flags.properties) {
+                try {
+                    const parsedProps = JSON.parse(flags.properties);
+                    if (flags['simple-properties']) {
+                        // User provided simple format - expand to Notion format
+                        // Need to get database schema first
+                        if (!flags.parent_data_source_id) {
+                            throw new Error('The --simple-properties flag requires --parent_data_source_id (-d) to be set. ' +
+                                'Simple properties need the database schema for validation.');
+                        }
+                        const parentDataSourceId = await (0, notion_resolver_1.resolveNotionId)(flags.parent_data_source_id, 'database');
+                        const dbSchema = await notion.retrieveDataSource(parentDataSourceId);
+                        properties = await (0, property_expander_1.expandSimpleProperties)(parsedProps, dbSchema.properties);
+                    }
+                    else {
+                        // Use raw Notion format
+                        properties = parsedProps;
+                    }
+                }
+                catch (error) {
+                    if (error.message.includes('Unexpected token') || error.message.includes('JSON')) {
+                        throw new Error(`Invalid JSON in --properties flag: ${error.message}\n` +
+                            `Example: --properties '{"Name": "Task", "Status": "Done"}'`);
+                    }
+                    throw error;
+                }
+            }
+            if (flags.file_path) {
+                const p = path.join('./', flags.file_path);
+                const fileName = path.basename(flags.file_path);
+                const md = fs.readFileSync(p, { encoding: 'utf-8' });
+                const blocks = (0, markdown_to_blocks_1.markdownToBlocks)(md);
+                // Extract title from H1 heading or use filename without extension
+                const extractTitle = (markdown, filename) => {
+                    const h1Match = markdown.match(/^#\s+(.+)$/m);
+                    if (h1Match && h1Match[1]) {
+                        return h1Match[1].trim();
+                    }
+                    // Fallback: use filename without extension
+                    return filename.replace(/\.md$/, '');
+                };
+                const pageTitle = extractTitle(md, fileName);
+                // If no properties were provided via flag, use extracted title
+                if (!flags.properties) {
+                    properties = {
+                        [flags.title_property]: {
+                            title: [{ text: { content: pageTitle } }],
+                        },
+                    };
+                }
+                else {
+                    // Merge with existing properties, but ensure title is set
+                    if (!properties[flags.title_property]) {
+                        properties[flags.title_property] = {
+                            title: [{ text: { content: pageTitle } }],
+                        };
+                    }
+                }
+                pageProps = {
+                    parent: pageParent,
+                    properties,
+                    children: blocks,
+                };
+            }
+            else {
+                pageProps = {
+                    parent: pageParent,
+                    properties,
+                };
+            }
+            const res = await notion.createPage(pageProps);
+            // Handle JSON output for automation
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: res,
+                    timestamp: new Date().toISOString()
+                }, null, 2));
+                process.exit(0);
+                return;
+            }
+            // Handle raw JSON output (legacy)
+            if (flags.raw) {
+                (0, helper_1.outputRawJson)(res);
+                process.exit(0);
+                return;
+            }
+            // Handle table output
+            const columns = {
+                title: {
+                    get: (row) => {
+                        return (0, helper_1.getPageTitle)(row);
+                    },
+                },
+                object: {},
+                id: {},
+                url: {},
+            };
+            const options = {
+                printLine: this.log.bind(this),
+                ...flags,
+            };
+            (0, table_formatter_1.formatTable)([res], columns, options);
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    resourceType: 'page',
+                    endpoint: 'pages.create'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+PageCreate.description = 'Create a page';
+PageCreate.aliases = ['page:c'];
+PageCreate.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`,
+    },
+];
+PageCreate.flags = {
+    parent_page_id: core_1.Flags.string({
+        char: 'p',
+        description: 'Parent page ID or URL (to create a sub-page)',
+    }),
+    parent_data_source_id: core_1.Flags.string({
+        char: 'd',
+        description: 'Parent data source ID or URL (to create a page in a table)',
+    }),
+    file_path: core_1.Flags.string({
+        char: 'f',
+        description: 'Path to a source markdown file',
+    }),
+    title_property: core_1.Flags.string({
+        char: 't',
+        description: 'Name of the title property (defaults to "Name" if not specified)',
+        default: 'Name',
+    }),
+    properties: core_1.Flags.string({
+        description: 'Page properties as JSON string',
+    }),
+    'simple-properties': core_1.Flags.boolean({
+        char: 'S',
+        description: 'Use simplified property format (flat key-value pairs, recommended for AI agents)',
+        default: false,
+    }),
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = PageCreate;

package/dist/commands/page/retrieve/property_item.d.ts

@@ -0,0 +1,24 @@
+import { Command } from '@oclif/core';
+export default class PageRetrievePropertyItem extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        page_id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        property_id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'page-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        retry: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-cache': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        minimal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/page/retrieve/property_item.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const notion = require("../../../notion");
+const helper_1 = require("../../../helper");
+const base_flags_1 = require("../../../base-flags");
+const errors_1 = require("../../../errors");
+class PageRetrievePropertyItem extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(PageRetrievePropertyItem);
+        try {
+            const res = await notion.retrievePageProperty(args.page_id, args.property_id);
+            // Handle JSON output for automation
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: res,
+                    timestamp: new Date().toISOString()
+                }, null, 2));
+                process.exit(0);
+                return;
+            }
+            // Handle raw JSON output (default for this command)
+            (0, helper_1.outputRawJson)(res);
+            process.exit(0);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    resourceType: 'page',
+                    attemptedId: args.page_id,
+                    endpoint: 'pages.properties.retrieve'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+PageRetrievePropertyItem.description = 'Retrieve a page property item';
+PageRetrievePropertyItem.aliases = ['page:r:pi'];
+PageRetrievePropertyItem.examples = [
+    {
+        description: 'Retrieve a page property item',
+        command: `$ notion-cli page retrieve:property_item PAGE_ID PROPERTY_ID`,
+    },
+    {
+        description: 'Retrieve a page property item and output raw json',
+        command: `$ notion-cli page retrieve:property_item PAGE_ID PROPERTY_ID -r`,
+    },
+    {
+        description: 'Retrieve a page property item and output JSON for automation',
+        command: `$ notion-cli page retrieve:property_item PAGE_ID PROPERTY_ID --json`,
+    },
+];
+PageRetrievePropertyItem.args = {
+    page_id: core_1.Args.string({ required: true }),
+    property_id: core_1.Args.string({ required: true }),
+};
+PageRetrievePropertyItem.flags = {
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json',
+    }),
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = PageRetrievePropertyItem;

package/dist/commands/page/retrieve.d.ts

@@ -0,0 +1,36 @@
+import { Command } from '@oclif/core';
+export default class PageRetrieve extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        page_id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'page-size': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        retry: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-cache': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        minimal: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        markdown: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'compact-json': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        pretty: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        columns: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        filter: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        csv: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        extended: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-truncate': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-header': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        map: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        recursive: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'max-depth': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/page/retrieve.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const table_formatter_1 = require("../../utils/table-formatter");
+const notion = require("../../notion");
+const helper_1 = require("../../helper");
+const notion_to_md_1 = require("notion-to-md");
+const base_flags_1 = require("../../base-flags");
+const notion_resolver_1 = require("../../utils/notion-resolver");
+const errors_1 = require("../../errors");
+class PageRetrieve extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(PageRetrieve);
+        try {
+            // Resolve ID from URL, direct ID, or name (future)
+            const pageId = await (0, notion_resolver_1.resolveNotionId)(args.page_id, 'page');
+            // Handle map flag (fast structure discovery with parallel fetching)
+            if (flags.map) {
+                const mapData = await notion.mapPageStructure(pageId);
+                // Handle JSON output for automation (takes precedence)
+                if (flags.json) {
+                    this.log(JSON.stringify({
+                        success: true,
+                        data: mapData,
+                        timestamp: new Date().toISOString()
+                    }, null, 2));
+                    process.exit(0);
+                    return;
+                }
+                // Handle compact JSON output
+                if (flags['compact-json']) {
+                    (0, helper_1.outputCompactJson)(mapData);
+                    process.exit(0);
+                    return;
+                }
+                // Default: pretty JSON output for map
+                this.log(JSON.stringify(mapData, null, 2));
+                process.exit(0);
+                return;
+            }
+            // Handle page content as markdown (uses NotionToMarkdown)
+            if (flags.markdown) {
+                const n2m = new notion_to_md_1.NotionToMarkdown({ notionClient: notion.client });
+                const mdBlocks = await n2m.pageToMarkdown(pageId);
+                const mdString = n2m.toMarkdownString(mdBlocks);
+                console.log(mdString.parent);
+                process.exit(0);
+                return;
+            }
+            // Handle recursive fetching
+            if (flags.recursive) {
+                const recursiveData = await notion.retrievePageRecursive(pageId, 0, flags['max-depth']);
+                // Handle JSON output for automation (takes precedence)
+                if (flags.json) {
+                    this.log(JSON.stringify({
+                        success: true,
+                        data: recursiveData,
+                        timestamp: new Date().toISOString()
+                    }, null, 2));
+                    process.exit(0);
+                    return;
+                }
+                // Handle compact JSON output
+                if (flags['compact-json']) {
+                    (0, helper_1.outputCompactJson)(recursiveData);
+                    process.exit(0);
+                    return;
+                }
+                // Handle raw JSON output
+                if (flags.raw) {
+                    (0, helper_1.outputRawJson)(recursiveData);
+                    process.exit(0);
+                    return;
+                }
+                // For other formats, show a message that they're not supported with recursive
+                this.error('Recursive mode only supports --json, --compact-json, or --raw output formats');
+                process.exit(1);
+                return;
+            }
+            const pageProps = {
+                page_id: pageId,
+            };
+            let res = await notion.retrievePage(pageProps);
+            // Apply minimal flag to strip metadata
+            if (flags.minimal) {
+                res = (0, helper_1.stripMetadata)(res);
+            }
+            // Handle JSON output for automation (takes precedence)
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: true,
+                    data: res,
+                    timestamp: new Date().toISOString()
+                }, null, 2));
+                process.exit(0);
+                return;
+            }
+            // Define columns for table output
+            const columns = {
+                title: {
+                    get: (row) => {
+                        return (0, helper_1.getPageTitle)(row);
+                    },
+                },
+                object: {},
+                id: {},
+                url: {},
+            };
+            // Handle compact JSON output
+            if (flags['compact-json']) {
+                (0, helper_1.outputCompactJson)(res);
+                process.exit(0);
+                return;
+            }
+            // Handle pretty table output
+            if (flags.pretty) {
+                (0, helper_1.outputPrettyTable)([res], columns);
+                // Show hint after table output
+                (0, helper_1.showRawFlagHint)(1, res);
+                process.exit(0);
+                return;
+            }
+            // Handle raw JSON output
+            if (flags.raw) {
+                (0, helper_1.outputRawJson)(res);
+                process.exit(0);
+                return;
+            }
+            // Handle table output (default)
+            const options = {
+                printLine: this.log.bind(this),
+                ...flags,
+            };
+            (0, table_formatter_1.formatTable)([res], columns, options);
+            // Show hint after table output to make -r flag discoverable
+            (0, helper_1.showRawFlagHint)(1, res);
+        }
+        catch (error) {
+            const cliError = error instanceof errors_1.NotionCLIError
+                ? error
+                : (0, errors_1.wrapNotionError)(error, {
+                    resourceType: 'page',
+                    attemptedId: args.page_id,
+                    endpoint: 'pages.retrieve'
+                });
+            if (flags.json) {
+                this.log(JSON.stringify(cliError.toJSON(), null, 2));
+            }
+            else {
+                this.error(cliError.toHumanString());
+            }
+            process.exit(1);
+        }
+    }
+}
+PageRetrieve.description = 'Retrieve a page';
+PageRetrieve.aliases = ['page:r'];
+PageRetrieve.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: 'Retrieve a page and output JSON for automation',
+        command: `$ notion-cli page retrieve PAGE_ID --json`,
+    },
+];
+PageRetrieve.args = {
+    page_id: core_1.Args.string({
+        required: true,
+        description: 'Page ID or full Notion URL (e.g., https://notion.so/...)',
+    }),
+};
+PageRetrieve.flags = {
+    raw: core_1.Flags.boolean({
+        char: 'r',
+        description: 'output raw json (recommended for AI assistants - returns all fields)',
+    }),
+    markdown: core_1.Flags.boolean({
+        char: 'm',
+        description: 'output page content as markdown',
+    }),
+    map: core_1.Flags.boolean({
+        description: 'fast structure discovery (returns minimal info: titles, types, IDs)',
+        default: false,
+        exclusive: ['raw', 'markdown'],
+    }),
+    recursive: core_1.Flags.boolean({
+        char: 'R',
+        description: 'recursively fetch all blocks and nested pages (reduces API calls)',
+        default: false,
+    }),
+    'max-depth': core_1.Flags.integer({
+        description: 'maximum recursion depth for --recursive (default: 3)',
+        default: 3,
+        min: 1,
+        max: 10,
+        dependsOn: ['recursive'],
+    }),
+    ...table_formatter_1.tableFlags,
+    ...base_flags_1.OutputFormatFlags,
+    ...base_flags_1.AutomationFlags,
+};
+exports.default = PageRetrieve;