@profullstack/readm3 0.2.0 → 0.4.0

package/README.md

@@ -1,7 +1,12 @@
 # readm3
 
-A terminal markdown reader. File browser on the left, the rendered document on
-the right, and nothing else in the way.
+Markdown editing and sharing for people and teams, with a terminal reader and editor. File browser on the left, the rendered
+document on the right, and nothing else in the way. Press `e` to edit the file
+you are looking at, `esc` to see it rendered again.
+
+CommonMark and GitHub Flavored Markdown, plus the extras each dialect added on
+top: GitHub alerts, footnotes and `:emoji:`, and Reddit spoilers, superscript
+and `r/` `u/` links.
 
 Built on [HQTUI](https://github.com/profullstack/hqtui) — truecolor, mouse, and
 a terminal that gets restored no matter how the process dies.
@@ -76,22 +81,73 @@ pruned, `node_modules` and friends are never walked, and README sorts first.
 | `enter` | open the file | `esc` | clear the filter |
 | `space` `b` | page down / up | `r` | rescan and reload |
 | `g` `G` | top / bottom | `[` `]` | sidebar width |
-| `?` | help | `q` `ctrl+c` | quit |
+| `e` `i` | edit this file | `s` | reveal spoilers |
+| `ctrl+s` | save | `?` | help |
+| | | `q` `ctrl+c` | quit |
 
 The mouse works too: the wheel scrolls whichever pane it is over, and a click
 opens a file.
 
+### Editing
+
+`e` puts the caret in the file. `esc` takes it out, and the preview re-renders
+what you just typed — there is no separate preview pane to keep in step,
+because both modes read the same buffer.
+
+| | | | |
+|---|---|---|---|
+| `esc` | back to the preview | `ctrl+s` | save |
+| `ctrl+z` `ctrl+y` | undo / redo | `ctrl+g` | keys |
+| `ctrl+a` `ctrl+e` | line start / end | `ctrl+k` | kill to end of line |
+| `ctrl+←` `ctrl+→` | move by word | `ctrl+u` | kill to start of line |
+| `ctrl+home` `ctrl+end` | top / bottom | `tab` | indent two spaces |
+
+`enter` continues the list you are in — the same bullet, the next number, an
+unchecked box for a task — and ends it when you press it on an empty item.
+Quitting or switching files with unsaved changes asks first. `--read-only`
+turns editing off entirely, for use as a pager.
+
+There is no selection, and so no cut and paste: this is a place to fix a typo
+and add a paragraph, not a replacement for your editor. `$EDITOR` is still
+`$EDITOR`.
+
 ## What it renders
 
-Headings, **bold**, *italic*, `inline code`, links, fenced and indented code
-blocks with a language label, ordered and unordered lists, nested lists, task
-lists, blockquotes, tables with per-column alignment, horizontal rules, images
-as labelled placeholders, and YAML front matter — shown rather than hidden,
-because it is usually what you opened the file for.
+Parsing is [marked](https://github.com/markedjs/marked) — CommonMark and GFM.
+The terminal UI uses HQTUI; the cloud tools use the official MCP SDK.
+
+Headings, **bold**, *italic*, `inline code`, links, reference links, bare URLs,
+fenced and indented code blocks with a language label, ordered and unordered
+lists, nested lists, task lists, blockquotes, tables with per-column alignment,
+strikethrough, hard line breaks, horizontal rules, images as labelled
+placeholders, and YAML front matter — shown rather than hidden, because it is
+usually what you opened the file for.
 
 The HTML that real READMEs are full of is folded back into markdown rather than
-printed as tags, and inline code is held out of that, so `Array<string>`
-survives.
+printed as tags, and code is held out of that, so `Array<string>` survives.
+
+### Flavors
+
+`--flavor` picks which dialect's extras are honored. The default is `github`.
+
+| flavor | adds |
+|---|---|
+| `commonmark` | nothing beyond CommonMark |
+| `github` | GFM, alerts (`> [!WARNING]`), footnotes (`[^1]`), `:emoji:` |
+| `reddit` | GFM, spoilers (`>!hidden!<`), superscript (`^(text)`), `r/` and `u/` links |
+| `all` | both dialects at once |
+
+It matters which one you pick. `2^32` is a number in a README and a superscript
+on Reddit, and `>!spoiler!<` is a blockquote everywhere except Reddit — so the
+flavor decides, rather than every document getting every rule.
+
+Alerts get a gutter colored by severity. Footnotes are numbered in order of
+first reference and collected under a rule at the foot of the document.
+Superscript uses real Unicode glyphs when every character has one (`mc^2`
+becomes mc²) and keeps its caret when they do not, because there is no
+superscript `q`. Spoilers are blocked out with `█` rather than colored out, so
+they stay hidden in a pipe and with `--color never`; `s` reveals them in the
+reader, `--spoilers` in `--print`.
 
 ## Options
 
@@ -103,6 +159,9 @@ survives.
                      monochrome, high-contrast, light
 -w, --width <n>      sidebar width in columns, or the render width with --print
                      (default: 28% of the terminal, its full width printing)
+-f, --flavor <name>  commonmark, github (default), reddit, or all
+    --spoilers       reveal spoiler text instead of blocking it out
+-R, --read-only      refuse to edit, for use as a pager
 -a, --all            include dot-directories and dotfiles
 -M, --no-mouse       disable mouse tracking
 -v, --version
@@ -111,8 +170,8 @@ survives.
 
 ## As a library
 
-The renderer and the file tree are pure and need no terminal, so they can be
-reused on their own:
+The renderer, the file tree and the edit buffer are pure and need no terminal,
+so they can be reused on their own:
 
 ```ts
 import { renderMarkdown, toText, renderAnsi, scan, files } from "@profullstack/readm3";
@@ -121,9 +180,26 @@ const lines = renderMarkdown("# Hello\n\nSome **text**.", 60);
 console.log(toText(lines));
 // [ 'Hello', '━━━…', '', 'Some text.' ]
 
+// A flavor, and spoilers revealed.
+renderMarkdown(post, 60, { flavor: "reddit", spoilers: true });
+
 for (const file of files(scan("./docs"))) console.log(file.path);
 ```
 
+The edit buffer is a plain object with functions over it, so the editing rules
+can be tested without a screen:
+
+```ts
+import { createEditor, insert, newline, undo, text } from "@profullstack/readm3";
+
+const ed = createEditor("- first");
+ed.col = 7;
+newline(ed);          // continues the list
+insert(ed, "second");
+console.log(text(ed)); // "- first\n- second"
+undo(ed);
+```
+
 `renderMarkdown` returns lines of spans carrying a semantic `role` — `h1`,
 `code`, `link`, `quote` and so on — rather than colors, so the same document can
 be re-themed without re-parsing. `renderAnsi(source, width, theme, depth)` is
@@ -139,12 +215,145 @@ Windows Terminal.
 ```bash
 bun install
 bun src/cli.ts .     # run it against its own repo
-bun test test/       # 68 tests, no TTY needed
+bun test ./test       # 68 tests, no TTY needed
 npm test             # the same tests on node
 bun run typecheck
 bun run build
 ```
 
+## Shared documents, organizations, and teams
+
+Read and edit online at https://readm3.com/viewer, and manage your account at
+https://readm3.com/admin. Create private Markdown files, share view or edit links,
+add named collaborators, and grant access to an organization or team. Every link
+opens in read mode. File owners manage permissions and deletion; editors save new
+versions; the super administrator can manage every user's documents.
+
+Every online save creates an immutable version with a short ID and SHA-256 checksum.
+Stale saves are rejected so concurrent edits cannot silently overwrite each other.
+Owners can restore prior versions, pin links to a version, and revoke links.
+
+```sh
+readm3 login --token-stdin             # token from /admin → API tokens
+readm3 orgs list
+readm3 share README.md --org ORG_ID    # view link by default
+readm3 docs update DOC_ID notes.md --base VERSION_ID
+readm3 docs history DOC_ID
+readm3 mcp                            # stdio MCP, same account permissions
+```
+
+The REST API is at `/api/v1`, with all operations also available through
+`POST /api/v1/actions` and `readm3 cloud OPERATION --args JSON`.
+Full permissions, accounts, CLI, API, and MCP documentation: https://readm3.com/sharing.
+
+## Web reader
+
+Open https://readm3.com/viewer for the same two-pane Markdown reader in your browser.
+Open local files or a folder, drop Markdown files into the window, open a raw URL or
+GitHub file link, or start a new note. The explorer filters files, prunes hidden and
+build directories, and sorts README first. All nine themes and Markdown flavors use
+the same renderer as the terminal.
+
+Press `/` to filter, `e` to edit, `Escape` to return to reading, and `?` for shortcuts.
+`Ctrl+S` / `⌘S` downloads the current Markdown. Files and edits are saved in IndexedDB
+on this device; originals on disk are never overwritten. Reopening a file adds a copy
+so an existing draft is preserved. Clearing browser site data removes the workspace.
+
+Install through your browser’s app menu, or Share → Add to Home Screen on iOS.
+After the first visit, the application and saved workspace work offline. Remote URLs
+need a connection and a host that permits browser access (CORS); files are fetched
+directly with no credentials or server proxy. Local files are uploaded only when you explicitly choose Share → Save online.
+
+Imports are limited to 4 MB per file, 20 MB per workspace, and 1,000 files.
+
+## The website
+
+### Accounts
+
+Open https://readm3.com/account to create an email-verified account or sign in.
+The email link expires after 15 minutes and works once. A confirmation button
+prevents email scanners from consuming links. Accounts are created only after
+verification; returning users sign in to the same identity. Account settings
+include display name, sign out, and sign out on all devices.
+
+The server stores accounts, hashed sessions, verification challenges, and rate
+limits in SQLite. Set `READM3_DB` to a persistent volume path (production uses
+`/data/readm3.sqlite`), `READM3_URL` to the canonical public origin,
+`READM3_MAIL_FROM` to a verified sender, and `RESEND_API_KEY` to an email-sending key.
+Missing or failed mail delivery returns an error; verification links are never
+printed to logs. Production cookies are Secure, HttpOnly, SameSite=Lax, and
+host-scoped. The account page and APIs are excluded from offline caches.
+
+On Railway, attach a volume at `/data`, keep a single replica, and set
+`RAILWAY_RUN_UID=0` for the root-owned volume. Back up the volume before changing
+the account schema. The local reader remains usable without an account.
+
+```bash
+bun run test:accounts  # account security tests and browser signup flow
+```
+
+The account service is `server/accounts.ts`. It can accept an existing Bun SQLite
+`Database` so workspace APIs share the same `users` and `sessions` tables.
+`account_emails` holds the verified identity associated with each user ID.
+Use `Accounts.authenticate(token)` or `Accounts.requireAccount(request)` when
+authorizing organization, team, role, or API-token operations: these methods
+reject sessions whose user has no verified email. Browser sessions use
+`__Host-readm3_session` over HTTPS and `readm3_session` on localhost.
+Do not enable a separate unverified registration or password-recovery path.
+
+| Endpoint | Purpose |
+| --- | --- |
+| `POST /api/auth/email` | Send a sign-in link for an email address |
+| `POST /api/auth/preview` | Show the email associated with an unconsumed link |
+| `POST /api/auth/verify` | Consume the link and set a browser session |
+| `GET /api/auth/session` | Return the verified account, or `null` |
+| `POST /api/auth/profile` | Update the current account's display name |
+| `POST /api/auth/logout` | Revoke the current session |
+| `POST /api/auth/logout-all` | Revoke all sessions belonging to the account |
+
+POST requests require JSON and an `Origin` matching `READM3_URL`.
+
+### Building and serving
+
+[readm3.com](https://readm3.com) is built from this repository by `site/build.ts`,
+which renders every document on the page through `renderMarkdown` and takes every
+color from a real HQTUI theme. There is no second implementation to keep in sync:
+change the parser and the site changes with it.
+
+```bash
+bun run site:build   # writes site/dist
+bun run site:start   # serves it on $PORT, default 3000
+bun x playwright install chromium  # once, for browser checks
+bun run test:site    # imports, editing, persistence, offline PWA, and mobile layout
+```
+
+The site build bundles `site/viewer.ts` for browsers, generates content-addressed
+assets, and precaches the viewer shell through a service worker scoped to `/viewer`.
+Updates wait until the reader chooses **Update available**; drafts are saved before
+reloading. The web viewer does not load the marketing site’s third-party scripts.
+
+## Hosting shared documents
+
+The web server uses Bun and SQLite. Set `READM3_DB` to a database file on persistent
+storage, and `READM3_URL` to the public HTTPS origin. The Docker image uses
+`/data/readm3.sqlite`; mount a volume at `/data`. On Railway set `RAILWAY_RUN_UID=0`
+for access to the mounted volume. Use one service replica for SQLite and configure
+volume backups in the hosting platform.
+
+Set `READM3_ADMIN_BOOTSTRAP_SECRET` to a random secret. Sign in at `/account` as
+the intended super administrator, then open `/admin#claim=YOUR_SECRET`. This is a
+one-time claim stored in the database. Never publish this URL; remove the environment
+secret after claiming. Email sign-in never grants administrator access by itself.
+
+Accounts use verified email sign-in and HttpOnly cookies. API tokens and share
+capabilities are stored as SHA-256 hashes. Shared documents are not cached in the
+PWA or saved in the browser's local workspace, so revocation applies to future access.
+
+```sh
+bun run test:server  # auth, roles, version history, persistence, CLI and MCP
+bun run test:site    # local/offline reader plus browser sharing and admin workflows
+```
+
 ## License
 
 MIT.

package/dist/cli.d.ts

@@ -1,12 +1,16 @@
 import { type ColorMode } from "./print.ts";
 import { type ViewerOptions } from "./viewer.ts";
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.4.0";
+/** The help text, exported so a test can hold it to the flags it documents. */
+export declare const USAGE: string;
 export interface ParsedArgs extends ViewerOptions {
     help: boolean;
     version: boolean;
     /** Render to stdout instead of opening the reader. */
     print: boolean;
     color: ColorMode;
+    /** Reveal spoiler text rather than blocking it out. */
+    spoilers: boolean;
 }
 export declare function parseArgs(argv: string[]): ParsedArgs;
 export declare function main(argv?: string[]): Promise<void>;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAO,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,OAAO,UAAU,CAAC;AAiC/B,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2FpD;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAO,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,+EAA+E;AAC/E,eAAO,MAAM,KAAK,QA2CH,CAAC;AAEhB,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6GpD;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyChF"}

package/dist/cli.js

@@ -5,10 +5,13 @@ import { statSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { themeList } from "@profullstack/hqtui";
+import { FLAVORS, isFlavor } from "./flavors.js";
 import { printDocument, COLOR_MODES } from "./print.js";
 import { run } from "./viewer.js";
-export const VERSION = "0.2.0";
-const USAGE = `readm3 — a terminal markdown reader
+import { isCloudCommand, cloudMain, CLOUD_USAGE } from "./cloud-cli.js";
+export const VERSION = "0.4.0";
+/** The help text, exported so a test can hold it to the flags it documents. */
+export const USAGE = `readm3 — a terminal markdown reader and editor
 
 Usage
   readm3 [path] [options]
@@ -25,6 +28,11 @@ Options
   -w, --width <n>      Sidebar width in columns, or the render width with
                        --print. Default: 28% of the terminal, and its full
                        width when printing
+  -f, --flavor <name>  Markdown dialect. One of: ${FLAVORS.join(", ")}.
+                       Default: github (GFM, alerts, footnotes, :emoji:).
+                       reddit adds spoilers, superscript and r/ u/ links
+      --spoilers       Reveal spoiler text instead of blocking it out
+  -R, --read-only      Refuse to edit, for use as a pager
   -a, --all            Include dot-directories and dotfiles
   -M, --no-mouse       Disable mouse tracking
   -v, --version        Print the version
@@ -35,9 +43,18 @@ Keys
   right/left l h expand or collapse    /        filter files
   enter          open the file         r        rescan and reload
   space / b      page down / up        [ ]      sidebar width
-  g / G          top / bottom          ?        help
-                                       q        quit
-`;
+  g / G          top / bottom          s        reveal spoilers
+  e / i          edit this file        ?        help
+  ctrl+s         save                  q        quit
+
+Editing
+  esc            back to the preview, which re-renders as you left it
+  ctrl+z ctrl+y  undo / redo           ctrl+k   kill to end of line
+  ctrl+a ctrl+e  line start / end      ctrl+u   kill to start of line
+  ctrl+arrow     move by word          enter    split, continuing a list
+  ctrl+g         keys for editing      tab      indent two spaces
+
+${CLOUD_USAGE}`;
 class UsageError extends Error {
 }
 export function parseArgs(argv) {
@@ -47,8 +64,10 @@ export function parseArgs(argv) {
         version: false,
         print: false,
         color: "auto",
+        spoilers: false,
         mouse: true,
         all: false,
+        readOnly: false,
     };
     let target;
     for (let i = 0; i < argv.length; i++) {
@@ -92,6 +111,22 @@ export function parseArgs(argv) {
                 parsed.color = value;
                 break;
             }
+            case "-f":
+            case "--flavor": {
+                const value = next();
+                if (!isFlavor(value)) {
+                    throw new UsageError(`--flavor must be one of: ${FLAVORS.join(", ")}`);
+                }
+                parsed.flavor = value;
+                break;
+            }
+            case "--spoilers":
+                parsed.spoilers = true;
+                break;
+            case "-R":
+            case "--read-only":
+                parsed.readOnly = true;
+                break;
             case "-a":
             case "--all":
                 parsed.all = true;
@@ -136,6 +171,10 @@ export function parseArgs(argv) {
     return parsed;
 }
 export async function main(argv = process.argv.slice(2)) {
+    if (isCloudCommand(argv[0])) {
+        await cloudMain(argv);
+        return;
+    }
     let args;
     try {
         args = parseArgs(argv);
@@ -157,7 +196,14 @@ export async function main(argv = process.argv.slice(2)) {
         return;
     }
     if (args.print) {
-        printDocument({ path: args.open, width: args.sidebar, theme: args.theme, color: args.color });
+        printDocument({
+            path: args.open,
+            width: args.sidebar,
+            theme: args.theme,
+            color: args.color,
+            flavor: args.flavor,
+            spoilers: args.spoilers,
+        });
         return;
     }
     if (!process.stdout.isTTY) {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/cloud-cli.d.ts

@@ -0,0 +1,4 @@
+export declare const CLOUD_USAGE = "Shared Markdown\n  readm3 login --token-stdin              Save a personal API token securely\n  readm3 logout                           Remove the local token\n  readm3 share FILE --org ID [--role view|edit]\n  readm3 docs list [--org ID] [--search TEXT] [--limit N] [--offset N]\n  readm3 docs get ID [--raw]\n  readm3 docs create FILE --org ID [--title NAME]\n  readm3 docs update ID FILE --base VERSION\n  readm3 docs delete ID\n  readm3 docs history ID\n  readm3 docs restore ID --version VERSION --base CURRENT\n  readm3 docs share ID [--role view|edit] [--version VERSION]\n  readm3 docs revoke ID --share SHARE_ID\n  readm3 docs transfer ID --username USERNAME\n  readm3 shared get URL [--raw]\n  readm3 shared update URL FILE --base VERSION\n  readm3 orgs list | create --name NAME | update ID --name NAME | delete ID\n  readm3 teams list --org ID | create --org ID --name NAME\n  readm3 members list --org ID\n  readm3 cloud OPERATION --args '{\"key\":\"value\"}'\n  readm3 mcp                              Start the stdio MCP server\n\nFILE may be - for stdin. --raw prints Markdown; other results are JSON.\nREADM3_URL selects a self-hosted server; READM3_TOKEN supplies an API token.\nView links cannot write. Edit links can save versions. Owners administer files.\nUse readm3 cloud for the full API, including team membership and permissions.\n";
+export declare function isCloudCommand(command: string | undefined): boolean;
+export declare function cloudMain(argv: string[]): Promise<void>;
+//# sourceMappingURL=cloud-cli.d.ts.map

package/dist/cloud-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-cli.d.ts","sourceRoot":"","sources":["../src/cloud-cli.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW,m1CA0BvB,CAAC;AAaF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,WAEzD;AACD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,iBAiJ7C"}

package/dist/cloud-cli.js

@@ -0,0 +1,192 @@
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { cloudAction, cloudConfig, cloudRequest, clearCloudConfig, saveCloudConfig, sharedLocation, } from "./cloud-client.js";
+export const CLOUD_USAGE = `Shared Markdown
+  readm3 login --token-stdin              Save a personal API token securely
+  readm3 logout                           Remove the local token
+  readm3 share FILE --org ID [--role view|edit]
+  readm3 docs list [--org ID] [--search TEXT] [--limit N] [--offset N]
+  readm3 docs get ID [--raw]
+  readm3 docs create FILE --org ID [--title NAME]
+  readm3 docs update ID FILE --base VERSION
+  readm3 docs delete ID
+  readm3 docs history ID
+  readm3 docs restore ID --version VERSION --base CURRENT
+  readm3 docs share ID [--role view|edit] [--version VERSION]
+  readm3 docs revoke ID --share SHARE_ID
+  readm3 docs transfer ID --username USERNAME
+  readm3 shared get URL [--raw]
+  readm3 shared update URL FILE --base VERSION
+  readm3 orgs list | create --name NAME | update ID --name NAME | delete ID
+  readm3 teams list --org ID | create --org ID --name NAME
+  readm3 members list --org ID
+  readm3 cloud OPERATION --args '{"key":"value"}'
+  readm3 mcp                              Start the stdio MCP server
+
+FILE may be - for stdin. --raw prints Markdown; other results are JSON.
+READM3_URL selects a self-hosted server; READM3_TOKEN supplies an API token.
+View links cannot write. Edit links can save versions. Owners administer files.
+Use readm3 cloud for the full API, including team membership and permissions.
+`;
+const commands = new Set([
+    "login",
+    "logout",
+    "share",
+    "docs",
+    "shared",
+    "orgs",
+    "teams",
+    "members",
+    "cloud",
+    "mcp",
+]);
+export function isCloudCommand(command) {
+    return !!command && commands.has(command);
+}
+export async function cloudMain(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(CLOUD_USAGE);
+        return;
+    }
+    const command = argv[0];
+    if (command === "mcp") {
+        const { runMcp } = await import("./mcp.js");
+        await runMcp();
+        return;
+    }
+    const flags = {};
+    const positional = [];
+    for (let i = 1; i < argv.length; i++) {
+        const value = argv[i];
+        if (value.startsWith("--")) {
+            const name = value.slice(2);
+            if (["raw", "token-stdin", "json"].includes(name))
+                flags[name] = "true";
+            else {
+                if (!argv[i + 1] || argv[i + 1].startsWith("--"))
+                    throw new Error(`${value} needs a value.`);
+                flags[name] = argv[++i];
+            }
+        }
+        else
+            positional.push(value);
+    }
+    const output = (value) => process.stdout.write(JSON.stringify(value, null, 2) + "\n");
+    const fileSource = (file) => {
+        if (!file)
+            throw new Error("A Markdown file is required.");
+        const value = readFileSync(file === "-" ? 0 : file, "utf8");
+        if (Buffer.byteLength(value) > 1024 * 1024)
+            throw new Error("Shared documents are limited to 1 MB.");
+        return value;
+    };
+    if (command === "login") {
+        if (!flags["token-stdin"])
+            throw new Error("Use --token-stdin and paste the API token, then end input (Ctrl+D). Tokens are created at /admin.");
+        const token = readFileSync(0, "utf8").trim();
+        if (!token)
+            throw new Error("No token supplied.");
+        const config = { ...cloudConfig(), token };
+        const user = await cloudAction("account_me", {}, config);
+        saveCloudConfig(config);
+        output({ signedIn: true, user });
+        return;
+    }
+    if (command === "logout") {
+        clearCloudConfig();
+        output({
+            signedOut: true,
+            note: "Revoke the token in /admin to invalidate other copies.",
+        });
+        return;
+    }
+    if (command === "cloud") {
+        if (!positional[0])
+            throw new Error(CLOUD_USAGE);
+        const args = flags.args ? JSON.parse(flags.args) : {};
+        output(await cloudAction(positional[0], args));
+        return;
+    }
+    if (command === "shared") {
+        const [verb, url, file] = positional;
+        if (!["get", "update"].includes(verb))
+            throw new Error("Use shared get or shared update.");
+        if (!url)
+            throw new Error("A shared document URL is required.");
+        const { token, config } = sharedLocation(url);
+        const result = await cloudRequest(`shared/${token}`, verb === "update" ? "PATCH" : "GET", verb === "update"
+            ? { source: fileSource(file), baseVersion: flags.base }
+            : undefined, config);
+        if (!["get", "update"].includes(verb))
+            throw new Error("Use shared get or shared update.");
+        if (flags.raw)
+            process.stdout.write(result.version.source);
+        else
+            output(result);
+        return;
+    }
+    const args = {};
+    const names = {
+        org: "orgId",
+        team: "teamId",
+        base: "baseVersion",
+        version: "versionId",
+        share: "shareId",
+        user: "userId",
+    };
+    for (const [name, value] of Object.entries(flags))
+        if (!["raw", "json"].includes(name))
+            args[names[name] || name] = value;
+    if (command === "share") {
+        const file = positional[0];
+        const doc = await cloudAction("documents_create", {
+            ...args,
+            title: flags.title || basename(file || "Document.md"),
+            source: fileSource(file),
+        });
+        output(await cloudAction("shares_create", {
+            documentId: doc.id,
+            role: flags.role || "view",
+        }));
+        return;
+    }
+    const [verb, identifier, file] = positional;
+    if (command === "docs") {
+        const operations = {
+            list: "documents_list",
+            get: "documents_get",
+            create: "documents_create",
+            update: "documents_update",
+            delete: "documents_delete",
+            history: "versions_list",
+            restore: "versions_restore",
+            share: "shares_create",
+            revoke: "shares_revoke",
+            transfer: "documents_transfer",
+        };
+        const op = operations[verb];
+        if (!op)
+            throw new Error(CLOUD_USAGE);
+        if (verb === "create") {
+            args.source = fileSource(identifier);
+            args.title = flags.title || basename(identifier || "Document.md");
+        }
+        else if (verb !== "list")
+            args.documentId = identifier;
+        if (verb === "update")
+            args.source = fileSource(file);
+        const result = await cloudAction(op, args);
+        if (flags.raw && result.version)
+            process.stdout.write(result.version.source);
+        else
+            output(result);
+        return;
+    }
+    const prefix = command === "orgs" ? "organizations" : command;
+    if (!["list", "create", "update", "delete", "remove"].includes(verb))
+        throw new Error(CLOUD_USAGE);
+    if (identifier)
+        args[command === "orgs" ? "orgId" : command === "teams" ? "teamId" : "userId"] = identifier;
+    output(await cloudAction(`${prefix}_${verb}`, args));
+}
+//# sourceMappingURL=cloud-cli.js.map