@v1nvn/md 0.45.0 → 0.45.1

package/README.md

@@ -23,9 +23,9 @@ claude plugin install md@agentic
 In a terminal, last reply or a named file:
 
 ```sh
-npx -y @v1nvn/md@0.45.0              # editable — both panes
-npx -y @v1nvn/md@0.45.0 --view       # read-only — preview pane only
-npx -y @v1nvn/md@0.45.0 reply.md
+npx -y @v1nvn/md@0.45.1              # editable — both panes
+npx -y @v1nvn/md@0.45.1 --view       # read-only — preview pane only
+npx -y @v1nvn/md@0.45.1 reply.md
 ```
 
 ## Usage
@@ -34,10 +34,10 @@ npx -y @v1nvn/md@0.45.0 reply.md
 |---|---|
 | `/md-edit` | the previous assistant reply → viewer, edit pane enabled, one dim status row |
 | `/md-view` | the same share read-only — preview pane only |
-| `npx -y @v1nvn/md@0.45.0` | the same share, printed bare |
-| `npx -y @v1nvn/md@0.45.0 --view` | read-only share |
-| `npx -y @v1nvn/md@0.45.0 reply.md` | that file instead of the last reply |
-| `npx -y @v1nvn/md@0.45.0 -` | Markdown from stdin |
+| `npx -y @v1nvn/md@0.45.1` | the same share, printed bare |
+| `npx -y @v1nvn/md@0.45.1 --view` | read-only share |
+| `npx -y @v1nvn/md@0.45.1 reply.md` | that file instead of the last reply |
+| `npx -y @v1nvn/md@0.45.1 -` | Markdown from stdin |
 
 `MD_VIEWER_URL` sets the viewer (default `https://md.v1n.space`); any set
 `MD_NO_OPEN` value (not just `1`) skips opening the browser.

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@v1nvn/md",
-  "version": "0.45.0",
+  "version": "0.45.1",
   "description": "Send a Markdown reply to the Markdown-Viewer as a #share= URL — the md-send CLI behind the md plugin.",
   "type": "module",
   "bin": {
-    "md-send": "./src/index.ts"
+    "md-send": "./src/index.js"
   },
   "scripts": {
     "test": "yarn run -T vitest run",
@@ -34,6 +34,6 @@
     "node": ">=23.6"
   },
   "dependencies": {
-    "@v1nvn/agentic-core": "0.45.0"
+    "@v1nvn/agentic-core": "0.45.1"
   }
 }

package/src/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { lastReply, readMarkdownFile, readStdin, runCli, } from '@v1nvn/agentic-core';
+import { mdSend } from "./share.js";
+const spec = {
+    name: 'md-send',
+    description: 'Send a Markdown reply to the Markdown-Viewer as a #share= URL',
+    argument: {
+        flags: '[file]',
+        description: 'Markdown file, - for stdin; the last reply when omitted',
+    },
+    options: [
+        {
+            flags: '--view',
+            description: 'open the viewer read-only, without the edit pane',
+        },
+    ],
+    run: async (options, args) => {
+        const arg = args.at(0);
+        const markdown = arg === '-'
+            ? await readStdin()
+            : arg === undefined
+                ? lastReply()
+                : readMarkdownFile(arg);
+        console.log(mdSend(markdown, options.view === true));
+    },
+};
+process.exitCode = await runCli(spec, process.argv.slice(2));

package/src/share.js

@@ -0,0 +1,71 @@
+/**
+ * Send Markdown to the self-hosted Markdown-Viewer as a #share= URL — opens it
+ * in the browser and copies the URL.
+ *
+ *   md-send path/to/reply.md     # from a file
+ *   md-send -                    # from stdin
+ *   md-send                      # from the last Claude reply (core.lastReply)
+ *   md-send --view               # open read-only (no edit pane)
+ *
+ * Env knobs: MD_VIEWER_URL (default: https://md.v1n.space), MD_NO_OPEN (any value skips the browser).
+ */
+import { spawnSync } from 'node:child_process';
+import { deflateSync } from 'node:zlib';
+/**
+ * Encode Markdown into the Markdown-Viewer share token.
+ *
+ * Pipeline: UTF-8 bytes → zlib deflate (RFC 1950, pako.deflate-compatible) →
+ * base64url. Matches Markdown-Viewer's encodeMarkdownForShare() in script.js
+ * byte-for-byte — the decoder (pako.inflate) accepts any valid zlib stream, so
+ * compression level is irrelevant.
+ */
+export function encodeShare(markdown) {
+    return deflateSync(Buffer.from(markdown, 'utf8'))
+        .toString('base64')
+        .replaceAll('+', '-')
+        .replaceAll('/', '_')
+        .replace(/=+$/, '');
+}
+export function shareUrl(markdown, view = false) {
+    const base = (process.env.MD_VIEWER_URL ?? 'https://md.v1n.space').replace(/\/+$/, '');
+    const mode = view ? '' : '&edit=1';
+    // Without `edit=1` the viewer opens the snapshot read-only — preview pane
+    // only, with edit and split disabled (Markdown-Viewer script.js: loadFromShareHash).
+    return `${base}/#share=${encodeShare(markdown)}${mode}`;
+}
+function copyToClipboard(text) {
+    try {
+        return (spawnSync('pbcopy', { input: text, stdio: ['pipe', 'ignore', 'ignore'] })
+            .status === 0);
+    }
+    catch {
+        return false;
+    }
+}
+function openUrl(url) {
+    try {
+        return spawnSync('open', [url], { stdio: 'ignore' }).status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function statusLine(opened, copied) {
+    if (opened && copied) {
+        return 'Opened in Markdown-Viewer (link copied).';
+    }
+    if (opened) {
+        return 'Opened in Markdown-Viewer.';
+    }
+    if (copied) {
+        return 'Markdown-Viewer link copied to clipboard.';
+    }
+    return 'Markdown-Viewer link ready.';
+}
+/** Shares the markdown and returns the status line; the URL itself is never printed. */
+export function mdSend(markdown, view = false) {
+    const url = shareUrl(markdown, view);
+    const copied = copyToClipboard(url);
+    const opened = process.env.MD_NO_OPEN === undefined && openUrl(url);
+    return statusLine(opened, copied);
+}