@naulon/sdk 0.1.0

package/dist/cli/check.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { makeSignedSettlementFixture } from "../crypto/fixture.ts";
+export interface CheckResult {
+    name: string;
+    ok: boolean;
+    detail: string;
+}
+export interface RunCheckOutcome {
+    checks: CheckResult[];
+    fixture?: ReturnType<typeof makeSignedSettlementFixture>;
+    allPassed: boolean;
+}
+export declare function runCheck(opts: {
+    baseUrl: string;
+    slug: string;
+    /** A slug expected NOT to exist — defaults injected by the CLI; explicit in tests. */
+    absentSlug: string;
+    token?: string;
+    secret?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<RunCheckOutcome>;
+export declare function checkMain(argv: string[]): Promise<number>;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":";AAgBA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IACzD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,eAAe,CAAC,CAoC3B;AAkBD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB/D"}

package/dist/cli/check.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * `naulon-kit check` — offline conformance for a publisher's credits endpoint.
+ *
+ *   npx @naulon/sdk check <baseUrl> --slug <s> [--token <t>] [--secret <sec>]
+ *
+ * It does two things a publisher gets wrong and can verify cheaply:
+ *   1. GET <baseUrl>/credits/<slug> parses against the shared contract (creditsSchema).
+ *   2. GET <baseUrl>/credits/<random> returns 404 — the deliberate "free read" signal.
+ *      (This checks the 404 *syntax*, never *policy*: the CLI can't know which slug
+ *      SHOULD be free.)
+ * Settlement is never POSTed to a live receiver (a money path gets no public "pretend"
+ * mode). With --secret the CLI prints a signed fixture you feed into YOUR receiver in
+ * YOUR test harness and assert a 200 + a written payout.
+ */
+import { parseCredits } from "../contract/credits.js";
+import { makeSignedSettlementFixture } from "../crypto/fixture.js";
+export async function runCheck(opts) {
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const base = opts.baseUrl.replace(/\/$/, "");
+    const auth = opts.token ? { authorization: `Bearer ${opts.token}` } : {};
+    const creditsUrl = (slug) => `${base}/credits/${encodeURIComponent(slug)}`;
+    const checks = [];
+    // 1. The credits endpoint returns a contract-valid body.
+    try {
+        const res = await fetchImpl(creditsUrl(opts.slug), { headers: auth });
+        if (res.status !== 200) {
+            checks.push({ name: "credits-endpoint", ok: false, detail: `expected 200 for "${opts.slug}", got ${res.status}` });
+        }
+        else {
+            const body = await res.json();
+            parseCredits(body, `credits for "${opts.slug}"`); // throws on any contract violation
+            checks.push({ name: "credits-endpoint", ok: true, detail: `200 + valid ArticleCredits for "${opts.slug}"` });
+        }
+    }
+    catch (e) {
+        checks.push({ name: "credits-endpoint", ok: false, detail: e instanceof Error ? e.message : String(e) });
+    }
+    // 2. A nonexistent slug answers 404 — the free-read signal (syntax, not policy).
+    try {
+        const res = await fetchImpl(creditsUrl(opts.absentSlug), { headers: auth });
+        checks.push(res.status === 404
+            ? { name: "free-signal-404", ok: true, detail: "nonexistent slug → 404 (free-read signal; syntax only, not policy)" }
+            : { name: "free-signal-404", ok: false, detail: `nonexistent slug should answer 404, got ${res.status}` });
+    }
+    catch (e) {
+        checks.push({ name: "free-signal-404", ok: false, detail: e instanceof Error ? e.message : String(e) });
+    }
+    const outcome = { checks, allPassed: checks.every((c) => c.ok) };
+    if (opts.secret)
+        outcome.fixture = makeSignedSettlementFixture({ secret: opts.secret });
+    return outcome;
+}
+// ── CLI entry ────────────────────────────────────────────────────────────────
+function parseArgs(argv) {
+    const out = {};
+    const rest = argv[0] === "check" ? argv.slice(1) : argv;
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === "--slug")
+            out.slug = rest[++i];
+        else if (a === "--token")
+            out.token = rest[++i];
+        else if (a === "--secret")
+            out.secret = rest[++i];
+        else if (a && !a.startsWith("--") && out.baseUrl === undefined)
+            out.baseUrl = a;
+    }
+    return out;
+}
+const USAGE = "usage: naulon-kit check <baseUrl> --slug <slug> [--token <t>] [--secret <sec>]";
+export async function checkMain(argv) {
+    const args = parseArgs(argv);
+    if (!args.baseUrl || !args.slug) {
+        console.error(USAGE);
+        return 2;
+    }
+    const out = await runCheck({
+        baseUrl: args.baseUrl,
+        slug: args.slug,
+        absentSlug: `__naulon-kit-absent-${Date.now()}__`,
+        token: args.token,
+        secret: args.secret,
+    });
+    for (const c of out.checks)
+        console.log(`${c.ok ? "PASS" : "FAIL"}  ${c.name}  —  ${c.detail}`);
+    if (out.fixture) {
+        console.log("\nSigned settlement fixture (POST to YOUR receiver in YOUR test harness — never production):");
+        console.log(`  x-naulon-timestamp: ${out.fixture.headers["x-naulon-timestamp"]}`);
+        console.log(`  x-naulon-signature: ${out.fixture.headers["x-naulon-signature"]}`);
+        console.log(`  body: ${out.fixture.rawBody}`);
+    }
+    console.log(out.allPassed ? "\n✓ all checks passed" : "\n✗ one or more checks failed");
+    return out.allPassed ? 0 : 1;
+}
+// Run only when invoked directly as the bin, not when imported (by a test or the dispatcher).
+if (process.argv[1] && /check\.(ts|js)$/.test(process.argv[1])) {
+    void checkMain(process.argv.slice(2)).then((c) => process.exit(c));
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

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

package/dist/cli/crawl.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import type { ArticleCredits } from "../contract/credits.ts";
+import type { CrawlConfig, SourceAdapterId } from "../crawl/types.ts";
+export interface CrawlFlags {
+    origin?: string;
+    prefixes?: string;
+    creditsPath?: string;
+    defaultWallet?: string;
+    feedUrl?: string;
+    adapter?: string;
+    allowPrivate: boolean;
+    dryRun: boolean;
+    dir: string;
+    envPath?: string;
+    help: boolean;
+}
+export declare function parseCrawlFlags(argv: string[]): CrawlFlags;
+export interface CrawlPlan {
+    origin: string;
+    articlePrefixes: string[];
+    creditsPath: string;
+    config: CrawlConfig;
+    existing: Record<string, ArticleCredits>;
+    allowPrivate: boolean;
+    forceAdapterId?: SourceAdapterId;
+}
+/** Resolve everything the crawl needs from flags + `.env` + the current credits file. Pure. */
+export declare function planCrawlInputs(flags: CrawlFlags, env: Record<string, string>, existingRaw: string | null): CrawlPlan;
+export declare function crawlMain(argv: string[]): Promise<number>;
+//# sourceMappingURL=crawl.d.ts.map

package/dist/cli/crawl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../../src/cli/crawl.ts"],"names":[],"mappings":";AAoBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMtE,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAaD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAY1D;AAcD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,SAAS,CAuCX;AAWD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB/D"}

package/dist/cli/crawl.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+/**
+ * `naulon crawl` — draft a `credits.json` by reading your own origin (the CLI shell).
+ *
+ *   naulon crawl                         # read origin/prefixes/credits from ./.env
+ *   naulon crawl https://mysite.com --prefixes essays,posts --default-wallet 0x…
+ *   naulon crawl --adapter rss --feed-url https://mysite.com/feed.xml
+ *   naulon crawl --dry-run               # report what it WOULD add, write nothing
+ *
+ * It probes on-origin, no-secret sources (WordPress REST / RSS / sitemap), derives the gate's
+ * credits-key slugs, and inserts NEW articles into your credits map. Two hard rules:
+ *   • insert-only — it never overwrites a slug you've already curated;
+ *   • money is never inferred — an article whose author maps to no wallet is REPORTED, not
+ *     written. Map the author (authorWalletMap / --default-wallet), then re-crawl.
+ *
+ * All value logic lives in `../crawl/*`; this file is only flags + I/O + the printed summary.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { parseEnvFile } from "../doctor/doctor.js";
+import { runCrawl } from "../crawl/crawl.js";
+import { makeGuardedFetcher } from "../crawl/fetcher.js";
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+const VALUE_FLAGS = {
+    "--origin": "origin",
+    "--prefixes": "prefixes",
+    "--credits": "creditsPath",
+    "--default-wallet": "defaultWallet",
+    "--feed-url": "feedUrl",
+    "--adapter": "adapter",
+    "--dir": "dir",
+    "--env": "envPath",
+};
+export function parseCrawlFlags(argv) {
+    const f = { allowPrivate: false, dryRun: false, dir: process.cwd(), help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a)
+            continue;
+        if (a === "--allow-private")
+            f.allowPrivate = true;
+        else if (a === "--dry-run" || a === "-n")
+            f.dryRun = true;
+        else if (a === "--help" || a === "-h")
+            f.help = true;
+        else if (VALUE_FLAGS[a])
+            f[VALUE_FLAGS[a]] = argv[++i];
+        else if (!a.startsWith("-") && f.origin === undefined)
+            f.origin = a; // positional origin
+    }
+    return f;
+}
+const ADAPTER_IDS = ["rss", "sitemap", "wordpress"];
+function isLoopbackOrigin(origin) {
+    try {
+        const u = new URL(origin);
+        const h = u.hostname.replace(/^\[|\]$/g, "");
+        return u.protocol === "http:" && (h === "localhost" || h === "127.0.0.1" || h === "::1");
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolve everything the crawl needs from flags + `.env` + the current credits file. Pure. */
+export function planCrawlInputs(flags, env, existingRaw) {
+    const origin = flags.origin ?? env["ORIGIN_URL"];
+    if (!origin) {
+        throw new Error("no origin — pass one (`naulon crawl https://mysite.com`) or set ORIGIN_URL in .env");
+    }
+    const prefixesCsv = flags.prefixes ?? env["ARTICLE_PATH_PREFIXES"];
+    if (!prefixesCsv) {
+        throw new Error("no article prefixes — pass --prefixes essays,posts or set ARTICLE_PATH_PREFIXES in .env");
+    }
+    const articlePrefixes = prefixesCsv.split(",").map((p) => p.trim()).filter(Boolean);
+    const creditsPath = flags.creditsPath ?? env["CREDITS_FIXTURES"] ?? "./credits.json";
+    if (flags.adapter && !ADAPTER_IDS.includes(flags.adapter)) {
+        throw new Error(`unknown adapter '${flags.adapter}' — one of: ${ADAPTER_IDS.join(", ")}`);
+    }
+    let existing = {};
+    if (existingRaw !== null && existingRaw.trim() !== "") {
+        const parsed = JSON.parse(existingRaw);
+        if (parsed && typeof parsed === "object")
+            existing = parsed;
+    }
+    const config = {
+        includeGlobs: [],
+        excludeGlobs: [],
+        authorWalletMap: {},
+        ...(flags.defaultWallet ? { defaultWallet: flags.defaultWallet } : {}),
+        ...(flags.feedUrl ? { feedUrl: flags.feedUrl } : {}),
+    };
+    return {
+        origin,
+        articlePrefixes,
+        creditsPath,
+        config,
+        existing,
+        allowPrivate: flags.allowPrivate || isLoopbackOrigin(origin),
+        ...(flags.adapter ? { forceAdapterId: flags.adapter } : {}),
+    };
+}
+const USAGE = `usage: naulon crawl [origin] [--prefixes <csv>] [--credits <path>]
+              [--default-wallet 0x…] [--feed-url <url>] [--adapter rss|sitemap|wordpress]
+              [--dry-run] [--allow-private] [--dir <path>] [--env <path>]
+
+Drafts a credits.json from your own origin. Reads ORIGIN_URL / ARTICLE_PATH_PREFIXES /
+CREDITS_FIXTURES from ./.env when the flags are omitted, so \`naulon crawl\` just works
+after \`naulon init\`. Insert-only (never overwrites a curated slug); an article whose
+author maps to no wallet is reported, never written (money is never inferred).`;
+export async function crawlMain(argv) {
+    const f = parseCrawlFlags(argv);
+    if (f.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    const dir = resolve(f.dir);
+    const envPath = f.envPath ? resolve(f.envPath) : join(dir, ".env");
+    const env = existsSync(envPath) ? parseEnvFile(readFileSync(envPath, "utf8")) : {};
+    let plan;
+    try {
+        // Resolve the credits path first (may be relative to the env dir), then read it if present.
+        const flags = f;
+        const creditsHint = flags.creditsPath ?? env["CREDITS_FIXTURES"] ?? "./credits.json";
+        const creditsAbs = isAbsolute(creditsHint) ? creditsHint : join(envPath ? dirname(envPath) : dir, creditsHint);
+        const existingRaw = existsSync(creditsAbs) ? readFileSync(creditsAbs, "utf8") : null;
+        plan = planCrawlInputs(flags, env, existingRaw);
+        // Stash the absolute write target on the plan-adjacent closure.
+        return await execute(plan, creditsAbs, f.dryRun);
+    }
+    catch (e) {
+        console.error(`✗ ${e instanceof Error ? e.message : String(e)}`);
+        return 2;
+    }
+}
+async function execute(plan, creditsAbs, dryRun) {
+    const fetch = makeGuardedFetcher({ origin: plan.origin, allowPrivate: plan.allowPrivate });
+    console.log(`\n  ${BOLD}naulon crawl${RESET} ${DIM}— ${plan.origin}${RESET}`);
+    const result = await runCrawl({
+        origin: plan.origin,
+        articlePrefixes: plan.articlePrefixes,
+        config: plan.config,
+        existing: plan.existing,
+        fetch,
+        ...(plan.forceAdapterId ? { forceAdapterId: plan.forceAdapterId } : {}),
+    });
+    if (result.adapterId === null) {
+        console.log(`  ${DIM}no source detected (tried WordPress REST, RSS, sitemap).${RESET}`);
+        console.log(`  ${DIM}↳ if your feed is at a non-standard path, pass --feed-url.${RESET}\n`);
+        return 1;
+    }
+    console.log(`  ${DIM}source: ${result.adapterId} · discovered ${result.discovered} · new ${result.added.length} · kept ${result.keptExisting.length} · unmapped ${result.unmapped.length}${RESET}\n`);
+    for (const slug of result.added)
+        console.log(`  ✓ ${slug}`);
+    if (result.unmapped.length > 0) {
+        console.log(`\n  ${BOLD}Needs a wallet${RESET} ${DIM}(not written — money is never guessed):${RESET}`);
+        for (const u of result.unmapped) {
+            console.log(`  ⚠ ${u.slug} ${DIM}— author ${u.author ? `"${u.author}"` : "(none stated)"}${RESET}`);
+        }
+        console.log(`  ${DIM}↳ map them in credits.json, or re-run with --default-wallet 0x…${RESET}`);
+    }
+    if (dryRun) {
+        console.log(`\n  ${DIM}--dry-run: nothing written.${RESET}\n`);
+        return 0;
+    }
+    if (result.added.length === 0) {
+        console.log(`\n  ${DIM}nothing new to write — ${creditsAbs} unchanged.${RESET}\n`);
+        return 0;
+    }
+    await writeFile(creditsAbs, JSON.stringify(result.credits, null, 2) + "\n", "utf8");
+    console.log(`\n  ✓ wrote ${result.added.length} new ${result.added.length === 1 ? "entry" : "entries"} to ${creditsAbs}\n`);
+    return 0;
+}
+// Run only when invoked directly as the bin, not when imported (by a test or the dispatcher).
+if (process.argv[1] && /crawl\.(ts|js)$/.test(process.argv[1])) {
+    void crawlMain(process.argv.slice(2)).then((c) => process.exit(c));
+}
+//# sourceMappingURL=crawl.js.map

package/dist/cli/crawl.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+interface DoctorFlags {
+    envPath: string;
+    gateUrl?: string;
+    probe: boolean;
+    help: boolean;
+}
+export declare function parseDoctorFlags(argv: string[]): DoctorFlags;
+export declare function doctorMain(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":";AA2BA,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAU5D;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BhE"}

package/dist/cli/doctor.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * `naulon doctor` — health-check your own gate (the CLI shell around `runDoctor`).
+ *
+ *   naulon doctor                    # reads ./.env, probes the gate if it's running
+ *   naulon doctor --env path/.env    # a different env file
+ *   naulon doctor --url http://…     # probe a gate at a specific address
+ *   naulon doctor --no-probe         # config-only, don't touch the network
+ *
+ * Exits non-zero if any check FAILED (warnings don't fail the run).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { runDoctor } from "../doctor/doctor.js";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const RED = "\x1b[31m";
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+const GLYPH = {
+    pass: `${GREEN}✓${RESET}`,
+    warn: `${YELLOW}⚠${RESET}`,
+    fail: `${RED}✗${RESET}`,
+};
+export function parseDoctorFlags(argv) {
+    const f = { envPath: resolve(process.cwd(), ".env"), probe: true, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--help" || a === "-h")
+            f.help = true;
+        else if (a === "--no-probe")
+            f.probe = false;
+        else if (a === "--env")
+            f.envPath = resolve(argv[++i] ?? f.envPath);
+        else if (a === "--url")
+            f.gateUrl = argv[++i];
+    }
+    return f;
+}
+const USAGE = "usage: naulon doctor [--env <path>] [--url <gateUrl>] [--no-probe]";
+export async function doctorMain(argv) {
+    const f = parseDoctorFlags(argv);
+    if (f.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    const outcome = await runDoctor({
+        envText: existsSync(f.envPath) ? readFileSync(f.envPath, "utf8") : null,
+        fileExists: existsSync,
+        readFile: (p) => readFileSync(p, "utf8"),
+        cwd: dirname(f.envPath),
+        fetchImpl: f.probe ? fetch : undefined,
+        gateUrl: f.gateUrl,
+    });
+    console.log(`\n  ${DIM}naulon doctor — ${f.envPath}${RESET}\n`);
+    for (const c of outcome.checks)
+        console.log(`  ${GLYPH[c.level]} ${c.name.padEnd(12)} ${c.detail}`);
+    const failed = outcome.checks.filter((c) => c.level === "fail").length;
+    const warned = outcome.checks.filter((c) => c.level === "warn").length;
+    console.log(outcome.ok
+        ? `\n  ${GREEN}healthy${RESET}${warned ? ` ${DIM}(${warned} warning${warned === 1 ? "" : "s"})${RESET}` : ""}`
+        : `\n  ${RED}${failed} check${failed === 1 ? "" : "s"} failed${RESET} — fix the ✗ above`);
+    return outcome.ok ? 0 : 1;
+}
+// Run only when invoked directly as the bin, not when imported (by a test or the dispatcher).
+if (process.argv[1] && /doctor\.(ts|js)$/.test(process.argv[1])) {
+    void doctorMain(process.argv.slice(2)).then((c) => process.exit(c));
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+interface Flags {
+    yes: boolean;
+    force: boolean;
+    dir: string;
+    help: boolean;
+    originUrl?: string;
+    priceUsdc?: string;
+    citationMultiplier?: string;
+    paymentMode?: string;
+    settlementNetwork?: string;
+    tollgatePort?: string;
+    articlePrefixes?: string;
+    creditsPath?: string;
+    defaultWallet?: string;
+    starterSlug?: string;
+    starterTitle?: string;
+    starterAuthorId?: string;
+}
+export declare function parseInitFlags(argv: string[]): Flags;
+export declare function initMain(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":";AAwBA,UAAU,KAAK;IACb,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IAEd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAcpD;AA4HD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C9D"}