ntion 0.1.2 → 0.2.0

package/README.md

@@ -35,6 +35,14 @@ A single "get all my tasks" workflow tells the whole story:
 2. **No schema bloat** — MCP's database fetch includes ~2 KB of SQLite DDL, ~800 B of XML boilerplate, and ~1.4 KB of base64 `collectionPropertyOption://` URLs that are never used for reads. ntion returns only actionable data.
 3. **Markdown-first** — Page content defaults to markdown, matching what agents actually consume. No manual format negotiation needed.
 
+## Agent skill
+
+ntion ships with an [agent skill](https://docs.anthropic.com/en/docs/claude-code/skills) that teaches AI agents how to use the CLI. Install it with:
+
+```bash
+npx skills add https://github.com/mbroton/notion-cli --skill ntion-cli
+```
+
 ## Install
 
 ```bash

package/dist/notion/markdown.js

@@ -9,13 +9,142 @@ function chunkText(content) {
     }
     return chunks;
 }
+const DEFAULT_ANNOTATIONS = {
+    bold: false,
+    italic: false,
+    strikethrough: false,
+    code: false,
+};
+function findClosingStar(text, start) {
+    for (let i = start; i < text.length; i++) {
+        if (text[i] === "*" && text[i + 1] !== "*" && text[i - 1] !== "*") {
+            return i;
+        }
+    }
+    return -1;
+}
+function parseInlineSegments(text, inherited, linkUrl) {
+    const segments = [];
+    let i = 0;
+    let plain = "";
+    const flush = () => {
+        if (plain) {
+            segments.push({ content: plain, annotations: { ...inherited }, link: linkUrl });
+            plain = "";
+        }
+    };
+    while (i < text.length) {
+        // Inline code (no nesting inside)
+        if (text[i] === "`") {
+            const close = text.indexOf("`", i + 1);
+            if (close !== -1) {
+                flush();
+                segments.push({
+                    content: text.slice(i + 1, close),
+                    annotations: { ...inherited, code: true },
+                    link: linkUrl,
+                });
+                i = close + 1;
+                continue;
+            }
+        }
+        // Link [text](url)
+        if (text[i] === "[") {
+            const bracketClose = text.indexOf("]", i + 1);
+            if (bracketClose !== -1 && text[bracketClose + 1] === "(") {
+                const parenClose = text.indexOf(")", bracketClose + 2);
+                if (parenClose !== -1) {
+                    flush();
+                    const linkText = text.slice(i + 1, bracketClose);
+                    const url = text.slice(bracketClose + 2, parenClose);
+                    segments.push(...parseInlineSegments(linkText, inherited, url));
+                    i = parenClose + 1;
+                    continue;
+                }
+            }
+        }
+        // *** bold+italic
+        if (text[i] === "*" && text[i + 1] === "*" && text[i + 2] === "*") {
+            const close = text.indexOf("***", i + 3);
+            if (close !== -1) {
+                flush();
+                segments.push(...parseInlineSegments(text.slice(i + 3, close), { ...inherited, bold: true, italic: true }, linkUrl));
+                i = close + 3;
+                continue;
+            }
+        }
+        // ** bold
+        if (text[i] === "*" && text[i + 1] === "*") {
+            const close = text.indexOf("**", i + 2);
+            if (close !== -1) {
+                flush();
+                segments.push(...parseInlineSegments(text.slice(i + 2, close), { ...inherited, bold: true }, linkUrl));
+                i = close + 2;
+                continue;
+            }
+        }
+        // * italic
+        if (text[i] === "*") {
+            const close = findClosingStar(text, i + 1);
+            if (close !== -1) {
+                flush();
+                segments.push(...parseInlineSegments(text.slice(i + 1, close), { ...inherited, italic: true }, linkUrl));
+                i = close + 1;
+                continue;
+            }
+        }
+        // ~~ strikethrough
+        if (text[i] === "~" && text[i + 1] === "~") {
+            const close = text.indexOf("~~", i + 2);
+            if (close !== -1) {
+                flush();
+                segments.push(...parseInlineSegments(text.slice(i + 2, close), { ...inherited, strikethrough: true }, linkUrl));
+                i = close + 2;
+                continue;
+            }
+        }
+        plain += text[i];
+        i++;
+    }
+    flush();
+    return segments;
+}
+function segmentToRichText(segment) {
+    return chunkText(segment.content).map((chunk) => {
+        const textObj = { content: chunk };
+        if (segment.link) {
+            textObj.link = { url: segment.link };
+        }
+        const obj = { type: "text", text: textObj };
+        const { bold, italic, strikethrough, code } = segment.annotations;
+        if (bold || italic || strikethrough || code) {
+            const annotations = {};
+            if (bold)
+                annotations.bold = true;
+            if (italic)
+                annotations.italic = true;
+            if (strikethrough)
+                annotations.strikethrough = true;
+            if (code)
+                annotations.code = true;
+            obj.annotations = annotations;
+        }
+        return obj;
+    });
+}
 function toRichText(content) {
+    const normalized = content.length > 0 ? content : " ";
+    const segments = parseInlineSegments(normalized, DEFAULT_ANNOTATIONS);
+    if (segments.length === 0) {
+        return [{ type: "text", text: { content: " " } }];
+    }
+    return segments.flatMap(segmentToRichText);
+}
+function toPlainRichText(content) {
     const normalized = content.length > 0 ? content : " ";
     return chunkText(normalized).map((chunk) => ({
         type: "text",
-        text: {
-            content: chunk,
-        },
+        text: { content: chunk },
     }));
 }
 function paragraphBlock(text) {
@@ -131,7 +260,7 @@ function codeBlock(text, language) {
         object: "block",
         type: "code",
         code: {
-            rich_text: toRichText(text),
+            rich_text: toPlainRichText(text),
             language,
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ntion",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Token-efficient CLI for personal Notion workspaces",
   "type": "module",
   "license": "MIT",