markdownscribe 0.0.1 → 0.1.0

package/README.md

@@ -1,7 +1,49 @@
-# MarkdownScribe
+# markdownscribe (CLI)
 
-The unified Markdown utility kit — TOC, lint, format, frontmatter, Mermaid to SVG, URL to MD.
+Command-line interface for [MarkdownScribe](https://api-production-d0eb.up.railway.app) — frontmatter, table of contents, lint, format, Mermaid-to-SVG, and URL-to-Markdown, from your terminal or from a shell script/agent runner. Built on top of [`@markdownscribe/sdk`](../sdk/README.md).
 
-Coming soon at [markdownscribe.com](https://markdownscribe.com)
+## Install
 
-This package is reserved for the upcoming release.
+```bash
+npm install -g markdownscribe
+```
+
+Installs two equivalent binaries: `markdownscribe` and the shorter `mdscribe`.
+
+## Authentication
+
+Resolved in this order: `MDSCRIBE_API_KEY` env var → `API_KEY_MAT` env var → a `.env` file (`MDSCRIBE_API_KEY=...`) in the current directory.
+
+API base URL: `MDSCRIBE_URL` env var → `--base-url <url>` flag → production default.
+
+## Commands
+
+```bash
+mdscribe frontmatter <path>                     # file or directory (non-recursive)
+mdscribe toc <path> [--min-depth N] [--max-depth N]
+mdscribe format <path> [--prose-wrap preserve|always|never] [--write] [--check]
+mdscribe lint <path>
+mdscribe mermaid <path>                          # single .mmd or .md/.mdx file, writes <name>-diagram-N.svg
+mdscribe url <url> [--mode clean|raw] [--save <path>]
+```
+
+`frontmatter`/`toc`/`format`/`lint` accept a single file or a directory (non-recursive: only `.md`/`.mdx` files directly in it). `mermaid` and `url` take a single file / a single URL. Every successful run prints the credits charged for that call. Files written to disk (`format --write`, `mermaid`'s SVGs, `url --save`) are UTF-8 without a BOM.
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | Success |
+| 1 | Generic/config error |
+| 2 | Authentication failed (401) |
+| 3 | Insufficient credits (402) |
+| 4 | Rate limited (429) |
+| 5 | Invalid request (400/413/422) |
+| 6 | Upstream service unavailable (503/504/424) |
+| 7 | Not found (404) |
+
+Scriptable by design — every failure mode maps to a distinct, documented exit code, which the previous ad-hoc PowerShell scripts didn't guarantee.
+
+## Scope
+
+Covers the 6 REST markdown operations. A first-class MCP server — so this same functionality is directly callable from Claude and other agent runtimes without shelling out — is planned for a follow-up sprint (the "Claude channel": Extensions/Skills/Plugins). Until then, this CLI is the fastest way for both a human and an LLM-driven shell/agent to call MarkdownScribe correctly.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { MarkdownScribeClient } from "@markdownscribe/sdk";
+import { ConfigError, resolveConfig } from "./config.js";
+import { runFrontmatter } from "./commands/frontmatter.js";
+import { runToc } from "./commands/toc.js";
+import { runFormat } from "./commands/format.js";
+import { runLint } from "./commands/lint.js";
+import { runMermaid } from "./commands/mermaid.js";
+import { runUrl } from "./commands/url.js";
+function getClient(opts) {
+    const configOptions = { cwd: process.cwd() };
+    if (opts.baseUrl !== undefined)
+        configOptions.baseUrlFlag = opts.baseUrl;
+    const config = resolveConfig(configOptions);
+    return new MarkdownScribeClient(config);
+}
+// Nunca usar process.exit() aqui: no Node 24+ no Windows, forçar saída logo
+// depois de um fetch() cria uma corrida real com o fechamento de handles do
+// libuv e derruba o processo com "Assertion failed:
+// !(handle->flags & UV_HANDLE_CLOSING)" DEPOIS do resultado já ter sido
+// impresso corretamente — bug upstream do Node, sem fix lançado ainda
+// (nodejs/node#56645, nodejs/node#58091). Setar process.exitCode e deixar o
+// processo encerrar sozinho evita a corrida sem mudar o exit code observado
+// externamente.
+function emit(result) {
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    process.exitCode = result.exitCode;
+}
+async function execute(fn) {
+    try {
+        emit(await fn());
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+}
+const program = new Command();
+program
+    .name("markdownscribe")
+    .description("MarkdownScribe CLI — frontmatter, TOC, lint, format, mermaid and url-to-markdown from the terminal.")
+    .version("0.1.0")
+    .option("--base-url <url>", "override the MarkdownScribe API base URL");
+program
+    .command("frontmatter")
+    .description("Extract frontmatter from a Markdown file or directory")
+    .argument("<path>", "file or directory (non-recursive)")
+    .action((path) => execute(() => runFrontmatter(path, getClient(program.opts()))));
+program
+    .command("toc")
+    .description("Generate a table of contents for a Markdown file or directory")
+    .argument("<path>", "file or directory (non-recursive)")
+    .option("--min-depth <n>", "minimum heading depth", (v) => Number.parseInt(v, 10))
+    .option("--max-depth <n>", "maximum heading depth", (v) => Number.parseInt(v, 10))
+    .action((path, opts) => execute(() => runToc(path, opts, getClient(program.opts()))));
+program
+    .command("format")
+    .description("Normalize a Markdown file or directory")
+    .argument("<path>", "file or directory (non-recursive)")
+    .option("--prose-wrap <mode>", "preserve|always|never", "preserve")
+    .option("--write", "overwrite the file with the formatted content")
+    .option("--check", "report changed status without writing or printing")
+    .action((path, opts) => execute(() => runFormat(path, opts, getClient(program.opts()))));
+program
+    .command("lint")
+    .description("Lint a Markdown file or directory")
+    .argument("<path>", "file or directory (non-recursive)")
+    .action((path) => execute(() => runLint(path, getClient(program.opts()))));
+program
+    .command("mermaid")
+    .description("Render Mermaid diagrams from a .mmd or .md file to SVG")
+    .argument("<path>", "single .mmd or .md/.mdx file")
+    .action((path) => execute(() => runMermaid(path, getClient(program.opts()))));
+program
+    .command("url")
+    .description("Convert a web page to Markdown")
+    .argument("<url>", "http(s) URL")
+    .option("--mode <mode>", "clean|raw", "clean")
+    .option("--save <path>", "write the result to a file instead of stdout")
+    .action((url, opts) => execute(() => runUrl(url, opts, getClient(program.opts()))));
+await program.parseAsync(process.argv);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/commands/format.d.ts

@@ -0,0 +1,9 @@
+import type { MarkdownScribeClient } from "@markdownscribe/sdk";
+import type { CommandResult } from "./types.js";
+export interface FormatOptions {
+    proseWrap?: "preserve" | "always" | "never";
+    write?: boolean;
+    check?: boolean;
+}
+export declare function runFormat(pathArg: string, options: FormatOptions, client: MarkdownScribeClient): Promise<CommandResult>;
+//# sourceMappingURL=format.d.ts.map

package/dist/commands/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/commands/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA2CxB"}

package/dist/commands/format.js

@@ -0,0 +1,50 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+import { collectMarkdownFiles } from "../fs-utils.js";
+import { formatError } from "../output.js";
+export async function runFormat(pathArg, options, client) {
+    const files = collectMarkdownFiles(pathArg);
+    let stdout = "";
+    let stderr = "";
+    let exitCode = 0;
+    let totalCredits = 0;
+    for (const file of files) {
+        const markdown = readFileSync(file, "utf8");
+        try {
+            const result = await client.format({
+                markdown,
+                options: { prose_wrap: options.proseWrap ?? "preserve" },
+            });
+            totalCredits += result.meta.credits;
+            if (options.check) {
+                stdout += `${result.changed ? "changed" : "ok"}: ${file}\n`;
+            }
+            else if (options.write) {
+                if (result.changed) {
+                    // UTF-8 sem BOM (diferente de PowerShell Out-File -Encoding utf8,
+                    // que grava BOM — bug do script atual que este CLI corrige).
+                    writeFileSync(file, result.formatted, "utf8");
+                    stdout += `formatted: ${file}\n`;
+                }
+                else {
+                    stdout += `already formatted: ${file}\n`;
+                }
+            }
+            else {
+                stdout += result.formatted;
+            }
+        }
+        catch (err) {
+            if (!(err instanceof MarkdownScribeApiError))
+                throw err;
+            const formatted = formatError(err);
+            stderr += `${file}: ${formatted.message}\n`;
+            exitCode = formatted.exitCode;
+        }
+    }
+    if (exitCode === 0) {
+        stdout += `\ncredits charged: ${totalCredits}\n`;
+    }
+    return { exitCode, stdout, stderr };
+}
+//# sourceMappingURL=format.js.map

package/dist/commands/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/commands/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS3C,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAe,EACf,OAAsB,EACtB,MAA4B;IAE5B,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBACjC,QAAQ;gBACR,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE;aACzD,CAAC,CAAC;YACH,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAEpC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC;YAC9D,CAAC;iBAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACzB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,kEAAkE;oBAClE,6DAA6D;oBAC7D,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;oBAC9C,MAAM,IAAI,cAAc,IAAI,IAAI,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,sBAAsB,IAAI,IAAI,CAAC;gBAC3C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,sBAAsB,CAAC;gBAAE,MAAM,GAAG,CAAC;YACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,OAAO,IAAI,CAAC;YAC5C,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,sBAAsB,YAAY,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/commands/frontmatter.d.ts

@@ -0,0 +1,4 @@
+import type { MarkdownScribeClient } from "@markdownscribe/sdk";
+import type { CommandResult } from "./types.js";
+export declare function runFrontmatter(pathArg: string, client: MarkdownScribeClient): Promise<CommandResult>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/commands/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/commands/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CA0B1G"}

package/dist/commands/frontmatter.js

@@ -0,0 +1,31 @@
+import { readFileSync } from "node:fs";
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+import { collectMarkdownFiles } from "../fs-utils.js";
+import { formatError } from "../output.js";
+export async function runFrontmatter(pathArg, client) {
+    const files = collectMarkdownFiles(pathArg);
+    let stdout = "";
+    let stderr = "";
+    let exitCode = 0;
+    let totalCredits = 0;
+    for (const file of files) {
+        const markdown = readFileSync(file, "utf8");
+        try {
+            const result = await client.frontmatter({ markdown });
+            totalCredits += result.meta.credits;
+            stdout += `=== ${file} ===\n${JSON.stringify(result.frontmatter, null, 2)}\n`;
+        }
+        catch (err) {
+            if (!(err instanceof MarkdownScribeApiError))
+                throw err;
+            const formatted = formatError(err);
+            stderr += `${file}: ${formatted.message}\n`;
+            exitCode = formatted.exitCode;
+        }
+    }
+    if (exitCode === 0) {
+        stdout += `\ncredits charged: ${totalCredits}\n`;
+    }
+    return { exitCode, stdout, stderr };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/commands/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/commands/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,MAA4B;IAChF,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACpC,MAAM,IAAI,OAAO,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAChF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,sBAAsB,CAAC;gBAAE,MAAM,GAAG,CAAC;YACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,OAAO,IAAI,CAAC;YAC5C,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,sBAAsB,YAAY,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/commands/lint.d.ts

@@ -0,0 +1,4 @@
+import type { MarkdownScribeClient } from "@markdownscribe/sdk";
+import type { CommandResult } from "./types.js";
+export declare function runLint(pathArg: string, client: MarkdownScribeClient): Promise<CommandResult>;
+//# sourceMappingURL=lint.d.ts.map

package/dist/commands/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BnG"}

package/dist/commands/lint.js

@@ -0,0 +1,34 @@
+import { readFileSync } from "node:fs";
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+import { collectMarkdownFiles } from "../fs-utils.js";
+import { formatError } from "../output.js";
+export async function runLint(pathArg, client) {
+    const files = collectMarkdownFiles(pathArg);
+    let stdout = "";
+    let stderr = "";
+    let exitCode = 0;
+    let totalCredits = 0;
+    for (const file of files) {
+        const markdown = readFileSync(file, "utf8");
+        try {
+            const result = await client.lint({ markdown });
+            totalCredits += result.meta.credits;
+            stdout += `=== ${file} (${result.summary.total} finding(s)) ===\n`;
+            for (const finding of result.findings) {
+                stdout += `${finding.rule} line ${finding.line}: ${finding.message}\n`;
+            }
+        }
+        catch (err) {
+            if (!(err instanceof MarkdownScribeApiError))
+                throw err;
+            const formatted = formatError(err);
+            stderr += `${file}: ${formatted.message}\n`;
+            exitCode = formatted.exitCode;
+        }
+    }
+    if (exitCode === 0) {
+        stdout += `\ncredits charged: ${totalCredits}\n`;
+    }
+    return { exitCode, stdout, stderr };
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,MAA4B;IACzE,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/C,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACpC,MAAM,IAAI,OAAO,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,KAAK,oBAAoB,CAAC;YACnE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,SAAS,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,IAAI,CAAC;YACzE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,sBAAsB,CAAC;gBAAE,MAAM,GAAG,CAAC;YACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,OAAO,IAAI,CAAC;YAC5C,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,sBAAsB,YAAY,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/commands/mermaid.d.ts

@@ -0,0 +1,4 @@
+import type { MarkdownScribeClient } from "@markdownscribe/sdk";
+import type { CommandResult } from "./types.js";
+export declare function runMermaid(pathArg: string, client: MarkdownScribeClient): Promise<CommandResult>;
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/commands/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/commands/mermaid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgDtG"}

package/dist/commands/mermaid.js

@@ -0,0 +1,48 @@
+import { readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, join } from "node:path";
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+import { formatError } from "../output.js";
+export async function runMermaid(pathArg, client) {
+    const stat = statSync(pathArg);
+    if (stat.isDirectory()) {
+        return { exitCode: 5, stdout: "", stderr: "mermaid: pass a single file, not a directory\n" };
+    }
+    const content = readFileSync(pathArg, "utf8");
+    const isDiagram = extname(pathArg).toLowerCase() === ".mmd";
+    try {
+        const result = isDiagram
+            ? await client.mermaid({ diagram: content })
+            : await client.mermaid({ markdown: content });
+        if (result.summary.total === 0) {
+            return {
+                exitCode: 0,
+                stdout: `no mermaid blocks found (charged ${result.meta.credits} credit)\n`,
+                stderr: "",
+            };
+        }
+        const dir = dirname(pathArg);
+        const base = basename(pathArg, extname(pathArg));
+        let stdout = "";
+        let stderr = "";
+        for (const diagram of result.diagrams) {
+            const n = diagram.index + 1;
+            const svgPath = join(dir, `${base}-diagram-${n}.svg`);
+            // SVG em UTF-8 sem BOM (BOM quebra alguns viewers) — mesma escrita
+            // que o script mdscribe-mermaid.ps1 atual já faz.
+            writeFileSync(svgPath, diagram.svg, "utf8");
+            stdout += `ok: ${base}-diagram-${n}.svg\n`;
+        }
+        for (const diagramError of result.errors) {
+            stderr += `failed (diagram ${diagramError.index + 1}): ${diagramError.message}\n`;
+        }
+        stdout += `\n${result.summary.rendered}/${result.summary.total} rendered — ${result.meta.credits} credits\n`;
+        return { exitCode: 0, stdout, stderr };
+    }
+    catch (err) {
+        if (!(err instanceof MarkdownScribeApiError))
+            throw err;
+        const formatted = formatError(err);
+        return { exitCode: formatted.exitCode, stdout: "", stderr: `${formatted.message}\n` };
+    }
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/commands/mermaid.js.map

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

package/dist/commands/toc.d.ts

@@ -0,0 +1,8 @@
+import type { MarkdownScribeClient } from "@markdownscribe/sdk";
+import type { CommandResult } from "./types.js";
+export interface TocOptions {
+    minDepth?: number;
+    maxDepth?: number;
+}
+export declare function runToc(pathArg: string, options: TocOptions, client: MarkdownScribeClient): Promise<CommandResult>;
+//# sourceMappingURL=toc.d.ts.map

package/dist/commands/toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/commands/toc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA8BxB"}

package/dist/commands/toc.js

@@ -0,0 +1,36 @@
+import { readFileSync } from "node:fs";
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+import { collectMarkdownFiles } from "../fs-utils.js";
+import { formatError } from "../output.js";
+export async function runToc(pathArg, options, client) {
+    const files = collectMarkdownFiles(pathArg);
+    let stdout = "";
+    let stderr = "";
+    let exitCode = 0;
+    let totalCredits = 0;
+    const tocOptions = {};
+    if (options.minDepth !== undefined)
+        tocOptions.min_depth = options.minDepth;
+    if (options.maxDepth !== undefined)
+        tocOptions.max_depth = options.maxDepth;
+    for (const file of files) {
+        const markdown = readFileSync(file, "utf8");
+        try {
+            const result = await client.toc({ markdown, options: tocOptions });
+            totalCredits += result.meta.credits;
+            stdout += `=== ${file} ===\n${result.toc}\n`;
+        }
+        catch (err) {
+            if (!(err instanceof MarkdownScribeApiError))
+                throw err;
+            const formatted = formatError(err);
+            stderr += `${file}: ${formatted.message}\n`;
+            exitCode = formatted.exitCode;
+        }
+    }
+    if (exitCode === 0) {
+        stdout += `\ncredits charged: ${totalCredits}\n`;
+    }
+    return { exitCode, stdout, stderr };
+}
+//# sourceMappingURL=toc.js.map

package/dist/commands/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../src/commands/toc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQ3C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,OAAmB,EACnB,MAA4B;IAE5B,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,UAAU,GAA+C,EAAE,CAAC;IAClE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,UAAU,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC5E,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,UAAU,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IAE5E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YACnE,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACpC,MAAM,IAAI,OAAO,IAAI,SAAS,MAAM,CAAC,GAAG,IAAI,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,GAAG,YAAY,sBAAsB,CAAC;gBAAE,MAAM,GAAG,CAAC;YACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,OAAO,IAAI,CAAC;YAC5C,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,sBAAsB,YAAY,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/commands/types.d.ts

@@ -0,0 +1,6 @@
+export interface CommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/commands/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":""}

package/dist/commands/url.d.ts

@@ -0,0 +1,8 @@
+import type { MarkdownScribeClient } from "@markdownscribe/sdk";
+import type { CommandResult } from "./types.js";
+export interface UrlOptions {
+    mode?: "clean" | "raw";
+    save?: string;
+}
+export declare function runUrl(url: string, options: UrlOptions, client: MarkdownScribeClient): Promise<CommandResult>;
+//# sourceMappingURL=url.d.ts.map

package/dist/commands/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/commands/url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAsBxB"}

package/dist/commands/url.js

@@ -0,0 +1,27 @@
+import { writeFileSync } from "node:fs";
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+import { formatError } from "../output.js";
+export async function runUrl(url, options, client) {
+    try {
+        const result = await client.urlToMd({ url, mode: options.mode ?? "clean" });
+        let stdout = "";
+        if (options.save) {
+            // UTF-8 sem BOM — corrige o bug de BOM do script mdscribe-url.ps1
+            // atual (Out-File -Encoding utf8 grava BOM).
+            writeFileSync(options.save, result.markdown, "utf8");
+            stdout += `saved to: ${options.save}\n`;
+        }
+        else {
+            stdout += result.markdown;
+        }
+        stdout += `\ncredits charged: ${result.meta.credits}\n`;
+        return { exitCode: 0, stdout, stderr: "" };
+    }
+    catch (err) {
+        if (!(err instanceof MarkdownScribeApiError))
+            throw err;
+        const formatted = formatError(err);
+        return { exitCode: formatted.exitCode, stdout: "", stderr: `${formatted.message}\n` };
+    }
+}
+//# sourceMappingURL=url.js.map

package/dist/commands/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/commands/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQ3C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAW,EACX,OAAmB,EACnB,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;QAC5E,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,kEAAkE;YAClE,6CAA6C;YAC7C,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,IAAI,aAAa,OAAO,CAAC,IAAI,IAAI,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC;QAC5B,CAAC;QAED,MAAM,IAAI,sBAAsB,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;QAExD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,GAAG,YAAY,sBAAsB,CAAC;YAAE,MAAM,GAAG,CAAC;QACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+export declare class ConfigError extends Error {
+}
+export interface ResolveConfigOptions {
+    cwd: string;
+    baseUrlFlag?: string;
+}
+export interface CliConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+export declare function resolveConfig(options: ResolveConfigOptions): CliConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAEzC,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAgBtE"}

package/dist/config.js

@@ -0,0 +1,20 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { config as loadDotenv } from "dotenv";
+const DEFAULT_BASE_URL = "https://api-production-d0eb.up.railway.app";
+export class ConfigError extends Error {
+}
+// Resolução de chave: MDSCRIBE_API_KEY -> API_KEY_MAT (compat `railway run`)
+// -> .env no cwd, nessa ordem (SPEC-010 §CLI). Resolução de URL: MDSCRIBE_URL
+// -> --base-url -> default de produção.
+export function resolveConfig(options) {
+    const dotenvPath = join(options.cwd, ".env");
+    const dotenvResult = existsSync(dotenvPath) ? loadDotenv({ path: dotenvPath }).parsed : undefined;
+    const apiKey = process.env["MDSCRIBE_API_KEY"] ?? process.env["API_KEY_MAT"] ?? dotenvResult?.["MDSCRIBE_API_KEY"];
+    if (!apiKey) {
+        throw new ConfigError("No API key found. Set MDSCRIBE_API_KEY (or API_KEY_MAT), or add MDSCRIBE_API_KEY to a .env file in the current directory.");
+    }
+    const baseUrl = options.baseUrlFlag ?? process.env["MDSCRIBE_URL"] ?? DEFAULT_BASE_URL;
+    return { apiKey, baseUrl };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,gBAAgB,GAAG,4CAA4C,CAAC;AAEtE,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAYzC,6EAA6E;AAC7E,8EAA8E;AAC9E,wCAAwC;AACxC,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAElG,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,YAAY,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAEtG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,WAAW,CACnB,2HAA2H,CAC5H,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,gBAAgB,CAAC;IAEvF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/fs-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function collectMarkdownFiles(path: string): string[];
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAQA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAU3D"}

package/dist/fs-utils.js

@@ -0,0 +1,17 @@
+import { readdirSync, statSync } from "node:fs";
+import { extname, join } from "node:path";
+const MARKDOWN_EXTENSIONS = new Set([".md", ".mdx"]);
+// Não-recursiva por design (SPEC-010 §CLI) — pasta lista só os arquivos no
+// próprio nível, mesma regra que os scripts PowerShell atuais já seguem
+// (exceto mdscribe-fm.ps1 -Recurse, que fica fora de escopo do CLI).
+export function collectMarkdownFiles(path) {
+    const stat = statSync(path);
+    if (!stat.isDirectory()) {
+        return [path];
+    }
+    return readdirSync(path)
+        .filter((name) => MARKDOWN_EXTENSIONS.has(extname(name).toLowerCase()))
+        .map((name) => join(path, name))
+        .sort();
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAErD,2EAA2E;AAC3E,wEAAwE;AACxE,qEAAqE;AACrE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;SACtE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAC/B,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,8 @@
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+export declare function isTty(stream: NodeJS.WriteStream, jsonFlag: boolean): boolean;
+export interface FormattedError {
+    exitCode: number;
+    message: string;
+}
+export declare function formatError(err: MarkdownScribeApiError): FormattedError;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAG5E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,wBAAgB,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,cAAc,CA0BvE"}

package/dist/output.js

@@ -0,0 +1,41 @@
+import { MarkdownScribeApiError } from "@markdownscribe/sdk";
+export function isTty(stream, jsonFlag) {
+    if (jsonFlag)
+        return false;
+    return Boolean(stream.isTTY);
+}
+// Mapeia as 3 famílias de erro reais da API (toHttpError-shaped,
+// app.onError 500, e o grupo ad-hoc do serviço de extração — pesquisa do
+// D-037) pro contrato de exit code do CLI (SPEC-010 §CLI, 0-7). balance e
+// retry_after_seconds precisam sobreviver na mensagem — são o dado que
+// ancora a verificação de cobrança (blueprint §2.5.2).
+export function formatError(err) {
+    const detail = errorDetail(err);
+    switch (err.status) {
+        case 401:
+            return { exitCode: 2, message: `Authentication failed: ${detail}` };
+        case 402:
+            return { exitCode: 3, message: `Insufficient credits (balance: ${err.body["balance"]}): ${detail}` };
+        case 429:
+            return {
+                exitCode: 4,
+                message: `Rate limited (retry after ${err.body["retry_after_seconds"]}s): ${detail}`,
+            };
+        case 400:
+        case 413:
+        case 422:
+            return { exitCode: 5, message: `Invalid request: ${detail}` };
+        case 503:
+        case 504:
+        case 424:
+            return { exitCode: 6, message: `Upstream service unavailable: ${detail}` };
+        case 404:
+            return { exitCode: 7, message: `Not found: ${detail}` };
+        default:
+            return { exitCode: 1, message: `MarkdownScribe error: ${detail}` };
+    }
+}
+function errorDetail(err) {
+    return err.body.hint ? `${err.body.error} — ${err.body.hint}` : err.body.error;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,UAAU,KAAK,CAAC,MAA0B,EAAE,QAAiB;IACjE,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAOD,iEAAiE;AACjE,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,GAA2B;IACrD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,GAAG;YACN,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,0BAA0B,MAAM,EAAE,EAAE,CAAC;QACtE,KAAK,GAAG;YACN,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,kCAAkC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,MAAM,EAAE,EAAE,CAAC;QACvG,KAAK,GAAG;YACN,OAAO;gBACL,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,6BAA6B,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,MAAM,EAAE;aACrF,CAAC;QACJ,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,oBAAoB,MAAM,EAAE,EAAE,CAAC;QAChE,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,iCAAiC,MAAM,EAAE,EAAE,CAAC;QAC7E,KAAK,GAAG;YACN,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,MAAM,EAAE,EAAE,CAAC;QAC1D;YACE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,yBAAyB,MAAM,EAAE,EAAE,CAAC;IACvE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAA2B;IAC9C,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;AACjF,CAAC"}

package/package.json

@@ -1,10 +1,53 @@
-{
+{
   "name": "markdownscribe",
-  "version": "0.0.1",
-  "description": "MarkdownScribe — the unified Markdown utility kit. Coming soon at https://markdownscribe.com",
-  "main": "index.js",
-  "keywords": ["markdown", "toc", "lint", "format", "frontmatter", "mermaid", "utilities"],
-  "author": "Matheus Ramos <markdownscribe@gmail.com>",
-  "license": "MIT",
-  "homepage": "https://markdownscribe.com"
-}
+  "version": "0.1.0",
+  "description": "MarkdownScribe CLI — frontmatter, TOC, lint, format, mermaid and url-to-markdown from the terminal, built for humans and LLM/agent tooling.",
+  "keywords": [
+    "markdown",
+    "cli",
+    "frontmatter",
+    "toc",
+    "table-of-contents",
+    "lint",
+    "markdown-lint",
+    "format",
+    "mermaid",
+    "url-to-markdown",
+    "command-line",
+    "llm-tools",
+    "agent-tools",
+    "mdscribe"
+  ],
+  "type": "module",
+  "bin": {
+    "markdownscribe": "./dist/bin.js",
+    "mdscribe": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "dotenv": "^16.4.0",
+    "@markdownscribe/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "postgres": "^3.4.5",
+    "rimraf": "^6.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "echo 'lint TBD (eslint em fase futura)'",
+    "clean": "rimraf dist coverage .turbo *.tsbuildinfo"
+  }
+}

package/index.js

@@ -1,5 +0,0 @@
-// MarkdownScribe — coming soon at https://markdownscribe.com
-module.exports = {
-  status: "coming-soon",
-  homepage: "https://markdownscribe.com"
-};