@andrzejchm/notion-cli 0.4.0 → 0.5.0

package/dist/cli.js

@@ -4,229 +4,11 @@
 import { readFileSync } from "fs";
 import { dirname, join as join3 } from "path";
 import { fileURLToPath } from "url";
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 
 // src/commands/append.ts
 import { Command } from "commander";
 
-// src/blocks/md-to-blocks.ts
-var INLINE_RE = /(\*\*[^*]+\*\*|_[^_]+_|\*[^*]+\*|`[^`]+`|\[[^\]]+\]\([^)]+\)|[^*_`[]+)/g;
-function parseInlineMarkdown(text) {
-  const result = [];
-  let match;
-  INLINE_RE.lastIndex = 0;
-  while ((match = INLINE_RE.exec(text)) !== null) {
-    const segment = match[0];
-    if (segment.startsWith("**") && segment.endsWith("**")) {
-      const content = segment.slice(2, -2);
-      result.push({
-        type: "text",
-        text: { content, link: null },
-        annotations: {
-          bold: true,
-          italic: false,
-          strikethrough: false,
-          underline: false,
-          code: false,
-          color: "default"
-        }
-      });
-      continue;
-    }
-    if (segment.startsWith("_") && segment.endsWith("_") || segment.startsWith("*") && segment.endsWith("*")) {
-      const content = segment.slice(1, -1);
-      result.push({
-        type: "text",
-        text: { content, link: null },
-        annotations: {
-          bold: false,
-          italic: true,
-          strikethrough: false,
-          underline: false,
-          code: false,
-          color: "default"
-        }
-      });
-      continue;
-    }
-    if (segment.startsWith("`") && segment.endsWith("`")) {
-      const content = segment.slice(1, -1);
-      result.push({
-        type: "text",
-        text: { content, link: null },
-        annotations: {
-          bold: false,
-          italic: false,
-          strikethrough: false,
-          underline: false,
-          code: true,
-          color: "default"
-        }
-      });
-      continue;
-    }
-    const linkMatch = segment.match(/^\[([^\]]+)\]\(([^)]+)\)$/);
-    if (linkMatch) {
-      const [, label, url] = linkMatch;
-      result.push({
-        type: "text",
-        text: { content: label, link: { url } },
-        annotations: {
-          bold: false,
-          italic: false,
-          strikethrough: false,
-          underline: false,
-          code: false,
-          color: "default"
-        }
-      });
-      continue;
-    }
-    result.push({
-      type: "text",
-      text: { content: segment, link: null },
-      annotations: {
-        bold: false,
-        italic: false,
-        strikethrough: false,
-        underline: false,
-        code: false,
-        color: "default"
-      }
-    });
-  }
-  return result;
-}
-function makeRichText(text) {
-  return parseInlineMarkdown(text);
-}
-function mdToBlocks(md) {
-  if (!md) return [];
-  const lines = md.split("\n");
-  const blocks = [];
-  let inFence = false;
-  let fenceLang = "";
-  const fenceLines = [];
-  for (const line of lines) {
-    if (!inFence && line.startsWith("```")) {
-      inFence = true;
-      fenceLang = line.slice(3).trim() || "plain text";
-      fenceLines.length = 0;
-      continue;
-    }
-    if (inFence) {
-      if (line.startsWith("```")) {
-        const content = fenceLines.join("\n");
-        blocks.push({
-          type: "code",
-          code: {
-            rich_text: [
-              {
-                type: "text",
-                text: { content, link: null },
-                annotations: {
-                  bold: false,
-                  italic: false,
-                  strikethrough: false,
-                  underline: false,
-                  code: false,
-                  color: "default"
-                }
-              }
-            ],
-            // biome-ignore lint/suspicious/noExplicitAny: Notion SDK language type is too narrow
-            language: fenceLang
-          }
-        });
-        inFence = false;
-        fenceLang = "";
-        fenceLines.length = 0;
-      } else {
-        fenceLines.push(line);
-      }
-      continue;
-    }
-    if (line.trim() === "") continue;
-    const h1 = line.match(/^# (.+)$/);
-    if (h1) {
-      blocks.push({
-        type: "heading_1",
-        heading_1: { rich_text: makeRichText(h1[1]) }
-      });
-      continue;
-    }
-    const h2 = line.match(/^## (.+)$/);
-    if (h2) {
-      blocks.push({
-        type: "heading_2",
-        heading_2: { rich_text: makeRichText(h2[1]) }
-      });
-      continue;
-    }
-    const h3 = line.match(/^### (.+)$/);
-    if (h3) {
-      blocks.push({
-        type: "heading_3",
-        heading_3: { rich_text: makeRichText(h3[1]) }
-      });
-      continue;
-    }
-    const bullet = line.match(/^[-*] (.+)$/);
-    if (bullet) {
-      blocks.push({
-        type: "bulleted_list_item",
-        bulleted_list_item: { rich_text: makeRichText(bullet[1]) }
-      });
-      continue;
-    }
-    const numbered = line.match(/^\d+\. (.+)$/);
-    if (numbered) {
-      blocks.push({
-        type: "numbered_list_item",
-        numbered_list_item: { rich_text: makeRichText(numbered[1]) }
-      });
-      continue;
-    }
-    const quote = line.match(/^> (.+)$/);
-    if (quote) {
-      blocks.push({
-        type: "quote",
-        quote: { rich_text: makeRichText(quote[1]) }
-      });
-      continue;
-    }
-    blocks.push({
-      type: "paragraph",
-      paragraph: { rich_text: makeRichText(line) }
-    });
-  }
-  if (inFence && fenceLines.length > 0) {
-    const content = fenceLines.join("\n");
-    blocks.push({
-      type: "code",
-      code: {
-        rich_text: [
-          {
-            type: "text",
-            text: { content, link: null },
-            annotations: {
-              bold: false,
-              italic: false,
-              strikethrough: false,
-              underline: false,
-              code: false,
-              color: "default"
-            }
-          }
-        ],
-        // biome-ignore lint/suspicious/noExplicitAny: Notion SDK language type is too narrow
-        language: fenceLang
-      }
-    });
-  }
-  return blocks;
-}
-
 // src/errors/cli-error.ts
 var CliError = class extends Error {
   constructor(code, message, suggestion, cause) {
@@ -775,13 +557,61 @@ async function addComment(client, pageId, text, options = {}) {
     ...options.asUser && { display_name: { type: "user" } }
   });
 }
-async function appendBlocks(client, blockId, blocks) {
-  await client.blocks.children.append({
-    block_id: blockId,
-    children: blocks
+async function appendMarkdown(client, pageId, markdown) {
+  await client.pages.updateMarkdown({
+    page_id: pageId,
+    type: "insert_content",
+    insert_content: { content: markdown }
+  });
+}
+function countOccurrences(text, sub) {
+  let count = 0;
+  let pos = text.indexOf(sub, 0);
+  while (pos !== -1) {
+    count++;
+    pos = text.indexOf(sub, pos + 1);
+  }
+  return count;
+}
+function buildContentRange(content) {
+  const START_LEN = 15;
+  const STEP = 10;
+  if (content.length <= START_LEN * 2) {
+    return content;
+  }
+  const start = content.slice(0, START_LEN);
+  for (let endLen = START_LEN; endLen < content.length - START_LEN; endLen += STEP) {
+    const end = content.slice(-endLen);
+    if (countOccurrences(content, end) === 1) {
+      return `${start}...${end}`;
+    }
+  }
+  return content;
+}
+async function replaceMarkdown(client, pageId, newMarkdown) {
+  const current = await client.pages.retrieveMarkdown({ page_id: pageId });
+  const currentContent = current.markdown.trim();
+  if (!currentContent) {
+    if (newMarkdown.trim()) {
+      await client.pages.updateMarkdown({
+        page_id: pageId,
+        type: "insert_content",
+        insert_content: { content: newMarkdown }
+      });
+    }
+    return;
+  }
+  await client.pages.updateMarkdown({
+    page_id: pageId,
+    type: "replace_content_range",
+    replace_content_range: {
+      content: newMarkdown,
+      content_range: buildContentRange(currentContent),
+      allow_deleting_content: true
+    }
   });
 }
-async function createPage(client, parentId, title, blocks) {
+async function createPage(client, parentId, title, markdown) {
   const response = await client.pages.create({
     parent: { type: "page_id", page_id: parentId },
     properties: {
@@ -789,29 +619,46 @@ async function createPage(client, parentId, title, blocks) {
         title: [{ type: "text", text: { content: title, link: null } }]
       }
     },
-    children: blocks
+    ...markdown.trim() ? { markdown } : {}
   });
   return response.url;
 }
 
 // src/commands/append.ts
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
 function appendCommand() {
   const cmd = new Command("append");
-  cmd.description("append markdown content to a Notion page").argument("<id/url>", "Notion page ID or URL").requiredOption("-m, --message <markdown>", "markdown content to append").action(
+  cmd.description("append markdown content to a Notion page").argument("<id/url>", "Notion page ID or URL").option("-m, --message <markdown>", "markdown content to append").action(
     withErrorHandling(async (idOrUrl, opts) => {
       const { token, source } = await resolveToken();
       reportTokenSource(source);
       const client = createNotionClient(token);
-      const pageId = parseNotionId(idOrUrl);
-      const uuid = toUuid(pageId);
-      const blocks = mdToBlocks(opts.message);
-      if (blocks.length === 0) {
+      let markdown = "";
+      if (opts.message) {
+        markdown = opts.message;
+      } else if (!process.stdin.isTTY) {
+        markdown = await readStdin();
+      } else {
+        throw new CliError(
+          ErrorCodes.INVALID_ARG,
+          "No content to append.",
+          "Pass markdown via -m/--message or pipe it through stdin"
+        );
+      }
+      if (!markdown.trim()) {
         process.stdout.write("Nothing to append.\n");
         return;
       }
-      await appendBlocks(client, uuid, blocks);
-      process.stdout.write(`Appended ${blocks.length} block(s).
-`);
+      const pageId = parseNotionId(idOrUrl);
+      const uuid = toUuid(pageId);
+      await appendMarkdown(client, uuid, markdown);
+      process.stdout.write("Appended.\n");
     })
   );
   return cmd;
@@ -825,8 +672,8 @@ function authDefaultAction(authCmd2) {
 }
 
 // src/commands/auth/login.ts
-import { input as input2, select } from "@inquirer/prompts";
-import { Command as Command3 } from "commander";
+import { input } from "@inquirer/prompts";
+import { Command as Command2 } from "commander";
 
 // src/oauth/oauth-flow.ts
 import { spawn } from "child_process";
@@ -1071,108 +918,10 @@ Waiting for callback (up to 120 seconds)...
   });
 }
 
-// src/commands/init.ts
-import { confirm, input, password } from "@inquirer/prompts";
-import { Command as Command2 } from "commander";
-async function runInitFlow() {
-  const profileName = await input({
-    message: "Profile name:",
-    default: "default"
-  });
-  const token = await password({
-    message: "Integration token (from notion.so/profile/integrations/internal):",
-    mask: "*"
-  });
-  stderrWrite("Validating token...");
-  const { workspaceName, workspaceId } = await validateToken(token);
-  stderrWrite(success(`\u2713 Connected to workspace: ${bold(workspaceName)}`));
-  const config = await readGlobalConfig();
-  if (config.profiles?.[profileName]) {
-    const replace = await confirm({
-      message: `Profile "${profileName}" already exists. Replace?`,
-      default: false
-    });
-    if (!replace) {
-      stderrWrite("Aborted.");
-      return;
-    }
-  }
-  const profiles = config.profiles ?? {};
-  profiles[profileName] = {
-    token,
-    workspace_name: workspaceName,
-    workspace_id: workspaceId
-  };
-  await writeGlobalConfig({
-    ...config,
-    profiles,
-    active_profile: profileName
-  });
-  stderrWrite(success(`Profile "${profileName}" saved and set as active.`));
-  stderrWrite(dim("Checking integration access..."));
-  try {
-    const notion = createNotionClient(token);
-    const probe = await notion.search({ page_size: 1 });
-    if (probe.results.length === 0) {
-      stderrWrite("");
-      stderrWrite("\u26A0\uFE0F  Your integration has no pages connected.");
-      stderrWrite("   To grant access, open any Notion page or database:");
-      stderrWrite("     1. Click \xB7\xB7\xB7 (three dots) in the top-right corner");
-      stderrWrite('     2. Select "Connect to"');
-      stderrWrite(`     3. Choose "${workspaceName}"`);
-      stderrWrite("   Then re-run any notion command to confirm access.");
-    } else {
-      stderrWrite(
-        success(
-          `\u2713 Integration has access to content in ${bold(workspaceName)}.`
-        )
-      );
-    }
-  } catch {
-    stderrWrite(
-      dim("(Could not verify integration access \u2014 run `notion ls` to check)")
-    );
-  }
-  stderrWrite("");
-  stderrWrite(
-    dim("Write commands (comment, append, create-page) require additional")
-  );
-  stderrWrite(dim("capabilities in your integration settings:"));
-  stderrWrite(
-    dim("  notion.so/profile/integrations/internal \u2192 your integration \u2192")
-  );
-  stderrWrite(
-    dim(
-      '  Capabilities: enable "Read content", "Insert content", "Read comments", "Insert comments"'
-    )
-  );
-  stderrWrite("");
-  stderrWrite(
-    dim("To post comments and create pages attributed to your user account:")
-  );
-  stderrWrite(dim("  notion auth login"));
-}
-function initCommand() {
-  const cmd = new Command2("init");
-  cmd.description("authenticate with Notion and save a profile").action(
-    withErrorHandling(async () => {
-      if (!process.stdin.isTTY) {
-        throw new CliError(
-          ErrorCodes.AUTH_NO_TOKEN,
-          "Cannot run interactive init in non-TTY mode.",
-          "Set NOTION_API_TOKEN environment variable or create .notion.yaml"
-        );
-      }
-      await runInitFlow();
-    })
-  );
-  return cmd;
-}
-
 // src/commands/auth/login.ts
 function loginCommand() {
-  const cmd = new Command3("login");
-  cmd.description("authenticate with Notion \u2014 choose OAuth or integration token").option("--profile <name>", "profile name to store credentials in").option(
+  const cmd = new Command2("login");
+  cmd.description("authenticate with Notion via OAuth").option("--profile <name>", "profile name to store credentials in").option(
     "--manual",
     "print auth URL instead of opening browser (for headless OAuth)"
   ).action(
@@ -1184,76 +933,57 @@ function loginCommand() {
           "Use --manual flag to get an auth URL you can open in a browser"
         );
       }
-      const method = await select({
-        message: "How do you want to authenticate with Notion?",
-        choices: [
-          {
-            name: "OAuth user login  (browser required)",
-            value: "oauth",
-            description: "Opens Notion in your browser. Comments and pages are attributed to your account. Tokens auto-refresh."
-          },
-          {
-            name: "Internal integration token  (CI/headless friendly)",
-            value: "token",
-            description: "Paste a token from notion.so/profile/integrations. No browser needed. Write ops attributed to integration bot."
-          }
-        ]
-      });
-      if (method === "oauth") {
-        const result = await runOAuthFlow({ manual: opts.manual });
-        const response = await exchangeCode(result.code);
-        const userName = response.owner?.user?.name ?? "unknown user";
-        const workspaceName = response.workspace_name ?? "unknown workspace";
-        const config = await readGlobalConfig();
-        const existingProfiles = config.profiles ?? {};
-        let profileName = opts.profile;
-        if (!profileName) {
-          const suggested = workspaceName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "default";
-          profileName = await input2({
-            message: "Profile name to save this account under:",
-            default: suggested
-          });
-        }
-        const isUpdate = Boolean(existingProfiles[profileName]);
-        const isFirst = Object.keys(existingProfiles).length === 0;
-        if (isUpdate) {
-          stderrWrite(dim(`Updating existing profile "${profileName}"...`));
-        }
-        await saveOAuthTokens(profileName, response);
-        if (isFirst) {
-          const updated = await readGlobalConfig();
-          await writeGlobalConfig({
-            ...updated,
-            active_profile: profileName
-          });
-        }
-        stderrWrite(
-          success(`\u2713 Logged in as ${userName} to workspace ${workspaceName}`)
-        );
-        stderrWrite(dim(`Saved as profile "${profileName}".`));
-        if (!isFirst && !isUpdate) {
-          stderrWrite(
-            dim(
-              `Run "notion auth use ${profileName}" to switch to this profile.`
-            )
-          );
-        }
+      const result = await runOAuthFlow({ manual: opts.manual });
+      const response = await exchangeCode(result.code);
+      const userName = response.owner?.user?.name ?? "unknown user";
+      const workspaceName = response.workspace_name ?? "unknown workspace";
+      const config = await readGlobalConfig();
+      const existingProfiles = config.profiles ?? {};
+      let profileName = opts.profile;
+      if (!profileName) {
+        const suggested = workspaceName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "default";
+        profileName = await input({
+          message: "Profile name to save this account under:",
+          default: suggested
+        });
+      }
+      const isUpdate = Boolean(existingProfiles[profileName]);
+      const isFirst = Object.keys(existingProfiles).length === 0;
+      if (isUpdate) {
+        stderrWrite(dim(`Updating existing profile "${profileName}"...`));
+      }
+      await saveOAuthTokens(profileName, response);
+      if (isFirst) {
+        const updated = await readGlobalConfig();
+        await writeGlobalConfig({
+          ...updated,
+          active_profile: profileName
+        });
+      }
+      stderrWrite(
+        success(`\u2713 Logged in as ${userName} to workspace ${workspaceName}`)
+      );
+      stderrWrite(dim(`Saved as profile "${profileName}".`));
+      if (!isFirst && !isUpdate) {
         stderrWrite(
           dim(
-            "Your comments and pages will now be attributed to your Notion account."
+            `Run "notion auth use ${profileName}" to switch to this profile.`
           )
         );
-      } else {
-        await runInitFlow();
       }
+      stderrWrite(
+        dim(
+          "Your comments and pages will now be attributed to your Notion account."
+        )
+      );
     })
   );
   return cmd;
 }
 
 // src/commands/auth/logout.ts
-import { select as select2 } from "@inquirer/prompts";
-import { Command as Command4 } from "commander";
+import { select } from "@inquirer/prompts";
+import { Command as Command3 } from "commander";
 function profileLabel(name, profile) {
   const parts = [];
   if (profile.oauth_access_token)
@@ -1266,7 +996,7 @@ function profileLabel(name, profile) {
   return `${bold(name)}  ${dim(authDesc)}${workspace}`;
 }
 function logoutCommand() {
-  const cmd = new Command4("logout");
+  const cmd = new Command3("logout");
   cmd.description("remove a profile and its credentials").option(
     "--profile <name>",
     "profile name to remove (skips interactive selector)"
@@ -1288,7 +1018,7 @@ function logoutCommand() {
             "Use --profile <name> to specify the profile to remove"
           );
         }
-        profileName = await select2({
+        profileName = await select({
           message: "Which profile do you want to log out of?",
           choices: profileNames.map((name) => ({
             // biome-ignore lint/style/noNonNullAssertion: key is from Object.keys, always present
@@ -1324,9 +1054,9 @@ function logoutCommand() {
 }
 
 // src/commands/auth/status.ts
-import { Command as Command5 } from "commander";
+import { Command as Command4 } from "commander";
 function statusCommand() {
-  const cmd = new Command5("status");
+  const cmd = new Command4("status");
   cmd.description("show authentication status for the active profile").option("--profile <name>", "profile name to check").action(
     withErrorHandling(async (opts) => {
       let profileName = opts.profile;
@@ -1384,9 +1114,9 @@ function statusCommand() {
 }
 
 // src/commands/comment-add.ts
-import { Command as Command6 } from "commander";
+import { Command as Command5 } from "commander";
 function commentAddCommand() {
-  const cmd = new Command6("comment");
+  const cmd = new Command5("comment");
   cmd.description("add a comment to a Notion page").argument("<id/url>", "Notion page ID or URL").requiredOption("-m, --message <text>", "comment text to post").action(
     withErrorHandling(async (idOrUrl, opts) => {
       const { token, source } = await resolveToken();
@@ -1404,7 +1134,7 @@ function commentAddCommand() {
 }
 
 // src/commands/comments.ts
-import { Command as Command7 } from "commander";
+import { Command as Command6 } from "commander";
 
 // src/output/format.ts
 var _mode = "auto";
@@ -1489,7 +1219,7 @@ async function paginateResults(fetcher) {
 
 // src/commands/comments.ts
 function commentsCommand() {
-  const cmd = new Command7("comments");
+  const cmd = new Command6("comments");
   cmd.description("list comments on a Notion page").argument("<id/url>", "Notion page ID or URL").option("--json", "output as JSON").action(
     withErrorHandling(async (idOrUrl, opts) => {
       if (opts.json) setOutputMode("json");
@@ -1520,7 +1250,7 @@ function commentsCommand() {
 }
 
 // src/commands/completion.ts
-import { Command as Command8 } from "commander";
+import { Command as Command7 } from "commander";
 var BASH_COMPLETION = `# notion bash completion
 _notion_completion() {
   local cur prev words cword
@@ -1622,7 +1352,7 @@ complete -c notion -n '__fish_seen_subcommand_from completion' -a zsh -d 'zsh co
 complete -c notion -n '__fish_seen_subcommand_from completion' -a fish -d 'fish completion script'
 `;
 function completionCommand() {
-  const cmd = new Command8("completion");
+  const cmd = new Command7("completion");
   cmd.description("output shell completion script").argument("<shell>", "shell type (bash, zsh, fish)").action(
     withErrorHandling(async (shell) => {
       switch (shell) {
@@ -1648,8 +1378,8 @@ function completionCommand() {
 }
 
 // src/commands/create-page.ts
-import { Command as Command9 } from "commander";
-async function readStdin() {
+import { Command as Command8 } from "commander";
+async function readStdin2() {
   const chunks = [];
   for await (const chunk of process.stdin) {
     chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
@@ -1657,7 +1387,7 @@ async function readStdin() {
   return Buffer.concat(chunks).toString("utf-8");
 }
 function createPageCommand() {
-  const cmd = new Command9("create-page");
+  const cmd = new Command8("create-page");
   cmd.description("create a new Notion page under a parent page").requiredOption("--parent <id/url>", "parent page ID or URL").requiredOption("--title <title>", "page title").option(
     "-m, --message <markdown>",
     "inline markdown content for the page body"
@@ -1671,11 +1401,15 @@ function createPageCommand() {
         if (opts.message) {
           markdown = opts.message;
         } else if (!process.stdin.isTTY) {
-          markdown = await readStdin();
+          markdown = await readStdin2();
         }
-        const blocks = mdToBlocks(markdown);
         const parentUuid = toUuid(parseNotionId(opts.parent));
-        const url = await createPage(client, parentUuid, opts.title, blocks);
+        const url = await createPage(
+          client,
+          parentUuid,
+          opts.title,
+          markdown
+        );
         process.stdout.write(`${url}
 `);
       }
@@ -1685,7 +1419,7 @@ function createPageCommand() {
 }
 
 // src/commands/db/query.ts
-import { Command as Command10 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/services/database.service.ts
 import { isFullPage } from "@notionhq/client";
@@ -1879,7 +1613,7 @@ function autoSelectColumns(schema, entries) {
   return selected;
 }
 function dbQueryCommand() {
-  return new Command10("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
+  return new Command9("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
     "--filter <filter>",
     'Filter entries (repeatable): --filter "Status=Done"',
     collect,
@@ -1934,9 +1668,9 @@ function collect(value, previous) {
 }
 
 // src/commands/db/schema.ts
-import { Command as Command11 } from "commander";
+import { Command as Command10 } from "commander";
 function dbSchemaCommand() {
-  return new Command11("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").option("--json", "Output raw JSON").action(
+  return new Command10("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").option("--json", "Output raw JSON").action(
     withErrorHandling(async (id, options) => {
       const { token } = await resolveToken();
       const client = createNotionClient(token);
@@ -1959,9 +1693,156 @@ function dbSchemaCommand() {
   );
 }
 
+// src/commands/edit-page.ts
+import { Command as Command11 } from "commander";
+async function readStdin3() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+function editPageCommand() {
+  const cmd = new Command11("edit-page");
+  cmd.description(
+    "replace the entire content of a Notion page with new markdown"
+  ).argument("<id/url>", "Notion page ID or URL").option(
+    "-m, --message <markdown>",
+    "new markdown content for the page body"
+  ).action(
+    withErrorHandling(async (idOrUrl, opts) => {
+      const { token, source } = await resolveToken();
+      reportTokenSource(source);
+      const client = createNotionClient(token);
+      let markdown = "";
+      if (opts.message) {
+        markdown = opts.message;
+      } else if (!process.stdin.isTTY) {
+        markdown = await readStdin3();
+        if (!markdown.trim()) {
+          throw new CliError(
+            ErrorCodes.INVALID_ARG,
+            "No content provided (stdin was empty).",
+            "Pass markdown via -m/--message or pipe non-empty content through stdin"
+          );
+        }
+      } else {
+        throw new CliError(
+          ErrorCodes.INVALID_ARG,
+          "No content provided.",
+          "Pass markdown via -m/--message or pipe it through stdin"
+        );
+      }
+      const pageId = parseNotionId(idOrUrl);
+      const uuid = toUuid(pageId);
+      await replaceMarkdown(client, uuid, markdown);
+      process.stdout.write("Page content replaced.\n");
+    })
+  );
+  return cmd;
+}
+
+// src/commands/init.ts
+import { confirm, input as input2, password } from "@inquirer/prompts";
+import { Command as Command12 } from "commander";
+async function runInitFlow() {
+  const profileName = await input2({
+    message: "Profile name:",
+    default: "default"
+  });
+  const token = await password({
+    message: "Integration token (from notion.so/profile/integrations/internal):",
+    mask: "*"
+  });
+  stderrWrite("Validating token...");
+  const { workspaceName, workspaceId } = await validateToken(token);
+  stderrWrite(success(`\u2713 Connected to workspace: ${bold(workspaceName)}`));
+  const config = await readGlobalConfig();
+  if (config.profiles?.[profileName]) {
+    const replace = await confirm({
+      message: `Profile "${profileName}" already exists. Replace?`,
+      default: false
+    });
+    if (!replace) {
+      stderrWrite("Aborted.");
+      return;
+    }
+  }
+  const profiles = config.profiles ?? {};
+  profiles[profileName] = {
+    token,
+    workspace_name: workspaceName,
+    workspace_id: workspaceId
+  };
+  await writeGlobalConfig({
+    ...config,
+    profiles,
+    active_profile: profileName
+  });
+  stderrWrite(success(`Profile "${profileName}" saved and set as active.`));
+  stderrWrite(dim("Checking integration access..."));
+  try {
+    const notion = createNotionClient(token);
+    const probe = await notion.search({ page_size: 1 });
+    if (probe.results.length === 0) {
+      stderrWrite("");
+      stderrWrite("\u26A0\uFE0F  Your integration has no pages connected.");
+      stderrWrite("   To grant access, open any Notion page or database:");
+      stderrWrite("     1. Click \xB7\xB7\xB7 (three dots) in the top-right corner");
+      stderrWrite('     2. Select "Connect to"');
+      stderrWrite(`     3. Choose "${workspaceName}"`);
+      stderrWrite("   Then re-run any notion command to confirm access.");
+    } else {
+      stderrWrite(
+        success(
+          `\u2713 Integration has access to content in ${bold(workspaceName)}.`
+        )
+      );
+    }
+  } catch {
+    stderrWrite(
+      dim("(Could not verify integration access \u2014 run `notion ls` to check)")
+    );
+  }
+  stderrWrite("");
+  stderrWrite(
+    dim("Write commands (comment, append, create-page) require additional")
+  );
+  stderrWrite(dim("capabilities in your integration settings:"));
+  stderrWrite(
+    dim("  notion.so/profile/integrations/internal \u2192 your integration \u2192")
+  );
+  stderrWrite(
+    dim(
+      '  Capabilities: enable "Read content", "Insert content", "Read comments", "Insert comments"'
+    )
+  );
+  stderrWrite("");
+  stderrWrite(
+    dim("To post comments and create pages attributed to your user account:")
+  );
+  stderrWrite(dim("  notion auth login"));
+}
+function initCommand() {
+  const cmd = new Command12("init");
+  cmd.description("authenticate with Notion and save a profile").action(
+    withErrorHandling(async () => {
+      if (!process.stdin.isTTY) {
+        throw new CliError(
+          ErrorCodes.AUTH_NO_TOKEN,
+          "Cannot run interactive init in non-TTY mode.",
+          "Set NOTION_API_TOKEN environment variable or create .notion.yaml"
+        );
+      }
+      await runInitFlow();
+    })
+  );
+  return cmd;
+}
+
 // src/commands/ls.ts
 import { isFullPageOrDataSource } from "@notionhq/client";
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 function getTitle(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -1978,7 +1859,7 @@ function displayType(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function lsCommand() {
-  const cmd = new Command12("ls");
+  const cmd = new Command13("ls");
   cmd.description("list accessible Notion pages and databases").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2041,10 +1922,10 @@ function lsCommand() {
 // src/commands/open.ts
 import { exec } from "child_process";
 import { promisify } from "util";
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 var execAsync = promisify(exec);
 function openCommand() {
-  const cmd = new Command13("open");
+  const cmd = new Command14("open");
   cmd.description("open a Notion page in the default browser").argument("<id/url>", "Notion page ID or URL").action(
     withErrorHandling(async (idOrUrl) => {
       const id = parseNotionId(idOrUrl);
@@ -2060,9 +1941,9 @@ function openCommand() {
 }
 
 // src/commands/profile/list.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 function profileListCommand() {
-  const cmd = new Command14("list");
+  const cmd = new Command15("list");
   cmd.description("list all authentication profiles").action(
     withErrorHandling(async () => {
       const config = await readGlobalConfig();
@@ -2091,9 +1972,9 @@ function profileListCommand() {
 }
 
 // src/commands/profile/remove.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 function profileRemoveCommand() {
-  const cmd = new Command15("remove");
+  const cmd = new Command16("remove");
   cmd.description("remove an authentication profile").argument("<name>", "profile name to remove").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2119,9 +2000,9 @@ function profileRemoveCommand() {
 }
 
 // src/commands/profile/use.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function profileUseCommand() {
-  const cmd = new Command16("use");
+  const cmd = new Command17("use");
   cmd.description("switch the active profile").argument("<name>", "profile name to activate").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2144,264 +2025,7 @@ function profileUseCommand() {
 }
 
 // src/commands/read.ts
-import { Command as Command17 } from "commander";
-
-// src/blocks/rich-text.ts
-function richTextToMd(richText) {
-  return richText.map(segmentToMd).join("");
-}
-function segmentToMd(segment) {
-  if (segment.type === "equation") {
-    return `$${segment.equation.expression}$`;
-  }
-  if (segment.type === "mention") {
-    const text = segment.plain_text;
-    return segment.href ? `[${text}](${segment.href})` : text;
-  }
-  const annotated = applyAnnotations(segment.text.content, segment.annotations);
-  return segment.text.link ? `[${annotated}](${segment.text.link.url})` : annotated;
-}
-function applyAnnotations(text, annotations) {
-  let result = text;
-  if (annotations.code) result = `\`${result}\``;
-  if (annotations.strikethrough) result = `~~${result}~~`;
-  if (annotations.italic) result = `_${result}_`;
-  if (annotations.bold) result = `**${result}**`;
-  return result;
-}
-
-// src/blocks/converters.ts
-function indentChildren(childrenMd) {
-  return `${childrenMd.split("\n").filter(Boolean).map((line) => `  ${line}`).join("\n")}
-`;
-}
-var converters = {
-  paragraph(block) {
-    const b = block;
-    return `${richTextToMd(b.paragraph.rich_text)}
-`;
-  },
-  heading_1(block) {
-    const b = block;
-    return `# ${richTextToMd(b.heading_1.rich_text)}
-`;
-  },
-  heading_2(block) {
-    const b = block;
-    return `## ${richTextToMd(b.heading_2.rich_text)}
-`;
-  },
-  heading_3(block) {
-    const b = block;
-    return `### ${richTextToMd(b.heading_3.rich_text)}
-`;
-  },
-  bulleted_list_item(block, ctx) {
-    const b = block;
-    const text = richTextToMd(b.bulleted_list_item.rich_text);
-    const header = `- ${text}
-`;
-    if (ctx?.childrenMd) {
-      return header + indentChildren(ctx.childrenMd);
-    }
-    return header;
-  },
-  numbered_list_item(block, ctx) {
-    const b = block;
-    const num = ctx?.listNumber ?? 1;
-    return `${num}. ${richTextToMd(b.numbered_list_item.rich_text)}
-`;
-  },
-  to_do(block) {
-    const b = block;
-    const checkbox = b.to_do.checked ? "[x]" : "[ ]";
-    return `- ${checkbox} ${richTextToMd(b.to_do.rich_text)}
-`;
-  },
-  code(block) {
-    const b = block;
-    const lang = b.code.language === "plain text" ? "" : b.code.language;
-    const content = richTextToMd(b.code.rich_text);
-    return `\`\`\`${lang}
-${content}
-\`\`\`
-`;
-  },
-  quote(block) {
-    const b = block;
-    return `> ${richTextToMd(b.quote.rich_text)}
-`;
-  },
-  divider() {
-    return "---\n";
-  },
-  callout(block) {
-    const b = block;
-    const text = richTextToMd(b.callout.rich_text);
-    const icon = b.callout.icon;
-    if (icon?.type === "emoji") {
-      return `> ${icon.emoji} ${text}
-`;
-    }
-    return `> ${text}
-`;
-  },
-  toggle(block, ctx) {
-    const b = block;
-    const header = `**${richTextToMd(b.toggle.rich_text)}**
-`;
-    if (ctx?.childrenMd) {
-      return header + ctx.childrenMd;
-    }
-    return header;
-  },
-  image(block) {
-    const b = block;
-    const caption = richTextToMd(b.image.caption);
-    if (b.image.type === "file") {
-      const url2 = b.image.file.url;
-      const expiry = b.image.file.expiry_time;
-      return `![${caption}](${url2}) <!-- expires: ${expiry} -->
-`;
-    }
-    const url = b.image.external.url;
-    return `![${caption}](${url})
-`;
-  },
-  bookmark(block) {
-    const b = block;
-    const caption = richTextToMd(b.bookmark.caption);
-    const text = caption || b.bookmark.url;
-    return `[${text}](${b.bookmark.url})
-`;
-  },
-  child_page(block) {
-    const b = block;
-    return `### ${b.child_page.title}
-`;
-  },
-  child_database(block) {
-    const b = block;
-    return `### ${b.child_database.title}
-`;
-  },
-  link_preview(block) {
-    const b = block;
-    return `[${b.link_preview.url}](${b.link_preview.url})
-`;
-  }
-};
-function blockToMd(block, ctx) {
-  const converter = converters[block.type];
-  if (converter) {
-    return converter(block, ctx);
-  }
-  return `<!-- unsupported block: ${block.type} -->
-`;
-}
-
-// src/blocks/properties.ts
-function formatFormula(f) {
-  if (f.type === "string") return f.string ?? "";
-  if (f.type === "number") return f.number !== null ? String(f.number) : "";
-  if (f.type === "boolean") return String(f.boolean);
-  if (f.type === "date") return f.date?.start ?? "";
-  return "";
-}
-function formatRollup(r) {
-  if (r.type === "number") return r.number !== null ? String(r.number) : "";
-  if (r.type === "date") return r.date?.start ?? "";
-  if (r.type === "array") return `[${r.array.length} items]`;
-  return "";
-}
-function formatUser(p) {
-  return "name" in p && p.name ? p.name : p.id;
-}
-function formatPropertyValue(_name, prop) {
-  switch (prop.type) {
-    case "title":
-      return prop.title.map((rt) => rt.plain_text).join("");
-    case "rich_text":
-      return prop.rich_text.map((rt) => rt.plain_text).join("");
-    case "number":
-      return prop.number !== null ? String(prop.number) : "";
-    case "select":
-      return prop.select?.name ?? "";
-    case "status":
-      return prop.status?.name ?? "";
-    case "multi_select":
-      return prop.multi_select.map((s) => s.name).join(", ");
-    case "date":
-      if (!prop.date) return "";
-      return prop.date.end ? `${prop.date.start} \u2192 ${prop.date.end}` : prop.date.start;
-    case "checkbox":
-      return prop.checkbox ? "true" : "false";
-    case "url":
-      return prop.url ?? "";
-    case "email":
-      return prop.email ?? "";
-    case "phone_number":
-      return prop.phone_number ?? "";
-    case "people":
-      return prop.people.map(formatUser).join(", ");
-    case "relation":
-      return prop.relation.map((r) => r.id).join(", ");
-    case "formula":
-      return formatFormula(prop.formula);
-    case "rollup":
-      return formatRollup(prop.rollup);
-    case "created_time":
-      return prop.created_time;
-    case "last_edited_time":
-      return prop.last_edited_time;
-    case "created_by":
-      return "name" in prop.created_by ? prop.created_by.name ?? prop.created_by.id : prop.created_by.id;
-    case "last_edited_by":
-      return "name" in prop.last_edited_by ? prop.last_edited_by.name ?? prop.last_edited_by.id : prop.last_edited_by.id;
-    case "files":
-      return prop.files.map((f) => f.type === "external" ? f.external.url : f.name).join(", ");
-    case "unique_id":
-      return prop.unique_id.prefix ? `${prop.unique_id.prefix}-${prop.unique_id.number}` : String(prop.unique_id.number ?? "");
-    default:
-      return "";
-  }
-}
-
-// src/blocks/render.ts
-function buildPropertiesHeader(page) {
-  const lines = ["---"];
-  for (const [name, prop] of Object.entries(page.properties)) {
-    const value = formatPropertyValue(name, prop);
-    if (value) {
-      lines.push(`${name}: ${value}`);
-    }
-  }
-  lines.push("---", "");
-  return lines.join("\n");
-}
-function renderBlockTree(blocks) {
-  const parts = [];
-  let listCounter = 0;
-  for (const node of blocks) {
-    if (node.block.type === "numbered_list_item") {
-      listCounter++;
-    } else {
-      listCounter = 0;
-    }
-    const childrenMd = node.children.length > 0 ? renderBlockTree(node.children) : "";
-    const md = blockToMd(node.block, {
-      listNumber: node.block.type === "numbered_list_item" ? listCounter : void 0,
-      childrenMd: childrenMd || void 0
-    });
-    parts.push(md);
-  }
-  return parts.join("");
-}
-function renderPageMarkdown({ page, blocks }) {
-  const header = buildPropertiesHeader(page);
-  const content = renderBlockTree(blocks);
-  return header + content;
-}
+import { Command as Command18 } from "commander";
 
 // src/output/markdown.ts
 import { Chalk as Chalk2 } from "chalk";
@@ -2531,69 +2155,43 @@ function renderInline(text) {
 }
 
 // src/services/page.service.ts
-import {
-  collectPaginatedAPI,
-  isFullBlock
-} from "@notionhq/client";
-var MAX_CONCURRENT_REQUESTS = 3;
-async function fetchBlockTree(client, blockId, depth, maxDepth) {
-  if (depth >= maxDepth) return [];
-  const rawBlocks = await collectPaginatedAPI(client.blocks.children.list, {
-    block_id: blockId
-  });
-  const blocks = rawBlocks.filter(isFullBlock);
-  const SKIP_RECURSE = /* @__PURE__ */ new Set(["child_page", "child_database"]);
-  const nodes = [];
-  for (let i = 0; i < blocks.length; i += MAX_CONCURRENT_REQUESTS) {
-    const batch = blocks.slice(i, i + MAX_CONCURRENT_REQUESTS);
-    const batchNodes = await Promise.all(
-      batch.map(async (block) => {
-        const children = block.has_children && !SKIP_RECURSE.has(block.type) ? await fetchBlockTree(client, block.id, depth + 1, maxDepth) : [];
-        return { block, children };
-      })
-    );
-    nodes.push(...batchNodes);
-  }
-  return nodes;
-}
-async function fetchPageWithBlocks(client, pageId) {
-  const page = await client.pages.retrieve({
-    page_id: pageId
-  });
-  const blocks = await fetchBlockTree(client, pageId, 0, 10);
-  return { page, blocks };
+async function fetchPageMarkdown(client, pageId) {
+  const [page, markdownResponse] = await Promise.all([
+    client.pages.retrieve({ page_id: pageId }),
+    client.pages.retrieveMarkdown({ page_id: pageId })
+  ]);
+  return { page, markdown: markdownResponse.markdown };
 }
 
 // src/commands/read.ts
 function readCommand() {
-  return new Command17("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").option("--json", "Output raw JSON instead of markdown").option("--md", "Output raw markdown (no terminal styling)").action(
-    withErrorHandling(
-      async (id, options) => {
-        const { token } = await resolveToken();
-        const client = createNotionClient(token);
-        const pageId = parseNotionId(id);
-        const pageWithBlocks = await fetchPageWithBlocks(client, pageId);
-        if (options.json) {
-          process.stdout.write(
-            `${JSON.stringify(pageWithBlocks, null, 2)}
+  return new Command18("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").action(
+    withErrorHandling(async (id) => {
+      const { token } = await resolveToken();
+      const client = createNotionClient(token);
+      const pageId = parseNotionId(id);
+      const pageWithMarkdown = await fetchPageMarkdown(client, pageId);
+      const mode = getOutputMode();
+      if (mode === "json") {
+        process.stdout.write(
+          `${JSON.stringify(pageWithMarkdown, null, 2)}
 `
-          );
+        );
+      } else {
+        const { markdown } = pageWithMarkdown;
+        if (mode === "md" || !isatty()) {
+          process.stdout.write(markdown);
         } else {
-          const markdown = renderPageMarkdown(pageWithBlocks);
-          if (options.md || !isatty()) {
-            process.stdout.write(markdown);
-          } else {
-            process.stdout.write(renderMarkdown(markdown));
-          }
+          process.stdout.write(renderMarkdown(markdown));
         }
       }
-    )
+    })
   );
 }
 
 // src/commands/search.ts
 import { isFullPageOrDataSource as isFullPageOrDataSource2 } from "@notionhq/client";
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 function getTitle2(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -2613,7 +2211,7 @@ function displayType2(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function searchCommand() {
-  const cmd = new Command18("search");
+  const cmd = new Command19("search");
   cmd.description("search Notion workspace by keyword").argument("<query>", "search keyword").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2671,7 +2269,7 @@ function searchCommand() {
 }
 
 // src/commands/users.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function getEmailOrWorkspace(user) {
   if (user.type === "person") {
     return user.person.email ?? "\u2014";
@@ -2683,7 +2281,7 @@ function getEmailOrWorkspace(user) {
   return "\u2014";
 }
 function usersCommand() {
-  const cmd = new Command19("users");
+  const cmd = new Command20("users");
   cmd.description("list all users in the workspace").option("--json", "output as JSON").action(
     withErrorHandling(async (opts) => {
       if (opts.json) setOutputMode("json");
@@ -2714,7 +2312,7 @@ var __dirname = dirname(__filename);
 var pkg = JSON.parse(
   readFileSync(join3(__dirname, "../package.json"), "utf-8")
 );
-var program = new Command20();
+var program = new Command21();
 program.name("notion").description("Notion CLI \u2014 read Notion pages and databases from the terminal").version(pkg.version);
 program.option("--verbose", "show API requests/responses").option("--color", "force color output").option("--json", "force JSON output (overrides TTY detection)").option("--md", "force markdown output for page content");
 program.configureOutput({
@@ -2735,7 +2333,7 @@ program.hook("preAction", (thisCommand) => {
     setOutputMode("md");
   }
 });
-var authCmd = new Command20("auth").description("manage Notion authentication");
+var authCmd = new Command21("auth").description("manage Notion authentication");
 authCmd.action(authDefaultAction(authCmd));
 authCmd.addCommand(loginCommand());
 authCmd.addCommand(logoutCommand());
@@ -2745,7 +2343,7 @@ authCmd.addCommand(profileUseCommand());
 authCmd.addCommand(profileRemoveCommand());
 program.addCommand(authCmd);
 program.addCommand(initCommand(), { hidden: true });
-var profileCmd = new Command20("profile").description(
+var profileCmd = new Command21("profile").description(
   "manage authentication profiles"
 );
 profileCmd.addCommand(profileListCommand());
@@ -2761,7 +2359,8 @@ program.addCommand(readCommand());
 program.addCommand(commentAddCommand());
 program.addCommand(appendCommand());
 program.addCommand(createPageCommand());
-var dbCmd = new Command20("db").description("Database operations");
+program.addCommand(editPageCommand());
+var dbCmd = new Command21("db").description("Database operations");
 dbCmd.addCommand(dbSchemaCommand());
 dbCmd.addCommand(dbQueryCommand());
 program.addCommand(dbCmd);