@rubicon-caliga/cli 0.1.0 → 0.1.2

package/dist/quickstart.js

@@ -0,0 +1,270 @@
+import { parseUsdcToAtomic, settlementNetworkInfo } from "@rubicon-caliga/core";
+import { stringFlag } from "./args.js";
+import { circleAgentWallet, circleAuthStatus, classifyCircleError, circleGatewayBalance, circleGatewayFaucet, circleGuidance, circleVersion, } from "./circle.js";
+import { HOSTED_GATEWAY_URL, writeConfig } from "./config.js";
+import { CliError } from "./errors.js";
+import { articleJson, formatAtomic } from "./format.js";
+import { saveReceipt } from "./receipts.js";
+export async function runDoctor(runtime, deps = {}) {
+    const checks = [];
+    checks.push({
+        name: "cliVersion",
+        ok: true,
+        status: "ok",
+        value: deps.cliVersion ?? "unknown",
+    });
+    checks.push({
+        name: "gatewayConfig",
+        ok: Boolean(runtime.config.gatewayUrl || process.env.RUBICON_GATEWAY_URL || runtime.gatewayUrl),
+        status: runtime.config.gatewayUrl || process.env.RUBICON_GATEWAY_URL ? "ok" : "warning",
+        value: runtime.gatewayUrl,
+        guidance: runtime.config.gatewayUrl || process.env.RUBICON_GATEWAY_URL
+            ? undefined
+            : `No gateway config found; using hosted default ${HOSTED_GATEWAY_URL}. Run rubicon config set gateway-url <url> to pin it.`,
+    });
+    try {
+        const fetcher = deps.fetch ?? fetch;
+        const response = await fetcher(`${runtime.gatewayUrl}/health`);
+        checks.push({
+            name: "gatewayReachability",
+            ok: response.ok,
+            status: response.ok ? "ok" : "error",
+            value: { status: response.status },
+            guidance: response.ok ? undefined : "Gateway health check failed. Confirm the URL and network access.",
+        });
+    }
+    catch (error) {
+        checks.push({
+            name: "gatewayReachability",
+            ok: false,
+            status: "error",
+            value: errorMessage(error),
+            guidance: "Gateway is not reachable from this context. Retry in a network-capable shell or configure a reachable gateway.",
+        });
+    }
+    await addCircleCheck(checks, "circleCli", () => circleVersion(circleInput(runtime, deps)));
+    await addCircleCheck(checks, "circleAuth", () => circleAuthStatus(circleInput(runtime, deps)));
+    const chain = runtime.circleChain ?? runtime.config.circleChain ?? "ARC-TESTNET";
+    let walletAddress;
+    await addCircleCheck(checks, "arcTestnetWallet", async () => {
+        const wallet = await circleAgentWallet({
+            ...circleInput(runtime, deps),
+            chain,
+            configuredAddress: runtime.config.agentWalletAddress ?? envAddress("CIRCLE_AGENT_WALLET_ADDRESS"),
+        });
+        walletAddress = wallet.address;
+        return wallet.address;
+    });
+    if (walletAddress) {
+        await addCircleCheck(checks, "arcTestnetBalance", async () => circleGatewayBalance({ ...circleInput(runtime, deps), chain, address: walletAddress }));
+    }
+    else {
+        checks.push({
+            name: "arcTestnetBalance",
+            ok: false,
+            status: "warning",
+            guidance: "Balance check skipped because no Arc Testnet Agent Wallet was found.",
+        });
+    }
+    const balance = checks.find((check) => check.name === "arcTestnetBalance")?.value;
+    checks.push({
+        name: "testnetTokenStatus",
+        ok: Boolean(balance?.balanceAtomic && BigInt(balance.balanceAtomic) > 0n),
+        status: balance?.balanceAtomic && BigInt(balance.balanceAtomic) > 0n ? "ok" : "warning",
+        value: balance?.balanceAtomic ? { balanceAtomic: balance.balanceAtomic, balanceUsdc: formatAtomic(balance.balanceAtomic) } : undefined,
+        guidance: balance?.balanceAtomic && BigInt(balance.balanceAtomic) > 0n
+            ? undefined
+            : "Arc Testnet reads can be funded with the Circle testnet faucet / Gateway testnet funding flow. Do not send mainnet funds for testnet articles.",
+    });
+    return {
+        success: checks.every((check) => check.status !== "error"),
+        gatewayUrl: runtime.gatewayUrl,
+        paymentMode: runtime.paymentMode,
+        checks,
+    };
+}
+export async function runQuickstartRead(runtime, deps = {}) {
+    if (runtime.parsed.positionals[1] !== "--first" && !runtime.parsed.flags.first) {
+        throw new CliError("MISSING_FIRST", "rubicon quickstart-read currently requires --first.");
+    }
+    const goal = stringFlag(runtime.parsed.flags, "goal");
+    if (!goal)
+        throw new CliError("MISSING_GOAL", "rubicon quickstart-read requires --goal.");
+    const maxSpendAtomic = parseQuickstartBudget(runtime.parsed);
+    const approvedBudgetUsdc = formatAtomic(maxSpendAtomic);
+    const wroteGatewayConfig = await ensureGatewayConfig(runtime);
+    const repository = await runtime.client.getRepository();
+    const article = repository.articles[0];
+    if (!article)
+        throw new CliError("NO_ARTICLES", "No public articles are available from the configured gateway.");
+    const navigation = await runtime.client.getNavigation(article.articleId, goal);
+    const sectionId = navigation.navigation.sellerAgent.recommendedSectionId;
+    const estimate = estimateRead(article, sectionId, maxSpendAtomic);
+    if (!estimate.withinBudget) {
+        throw new CliError("DRY_RUN_OVER_BUDGET", `Dry-run estimate is ${formatAtomic(estimate.estimatedMaxCostAtomic)} USDC, which exceeds the approved ${approvedBudgetUsdc} USDC budget.`);
+    }
+    const networkInfo = settlementNetworkInfo(article.paymentTerms?.network);
+    const chain = article.paymentTerms?.circleChain ?? networkInfo.circleChain ?? runtime.circleChain ?? "ARC-TESTNET";
+    const environment = article.paymentTerms?.environment ?? networkInfo.environment;
+    let circleWalletAddress;
+    let balanceAtomic;
+    if (runtime.paymentMode === "circle-cli") {
+        try {
+            await circleAuthStatus(circleInput(runtime, deps));
+            const wallet = await circleAgentWallet({
+                ...circleInput(runtime, deps),
+                chain,
+                configuredAddress: runtime.config.agentWalletAddress ?? envAddress("CIRCLE_AGENT_WALLET_ADDRESS"),
+            });
+            circleWalletAddress = wallet.address;
+            let balance = await circleGatewayBalance({ ...circleInput(runtime, deps), chain, address: wallet.address });
+            balanceAtomic = balance.balanceAtomic;
+            if (BigInt(balance.balanceAtomic) < BigInt(estimate.estimatedMaxCostAtomic)) {
+                if (environment !== "testnet") {
+                    throw new CliError("INSUFFICIENT_FUNDS", "Wallet balance is below the dry-run estimate. Refusing to suggest mainnet funding for this article.");
+                }
+                await circleGatewayFaucet({ ...circleInput(runtime, deps), chain, address: wallet.address });
+                balance = await circleGatewayBalance({ ...circleInput(runtime, deps), chain, address: wallet.address });
+                balanceAtomic = balance.balanceAtomic;
+            }
+        }
+        catch (error) {
+            if (error instanceof CliError)
+                throw error;
+            const guidance = circleGuidance(error) ?? circleGuidance(classifyCircleError(error));
+            if (guidance)
+                throw new CliError(guidance.code.toUpperCase(), `${guidance.message} ${guidance.guidance}`);
+            throw error;
+        }
+    }
+    const receipt = await runtime.client.run({
+        articleId: article.articleId,
+        goal,
+        sectionId,
+        maxSpendAtomic,
+        chunkWords: 32,
+        streamMode: "bundled",
+        metadata: { quickstart: true, stopAfterSection: true },
+    });
+    const stored = await saveReceipt(receipt);
+    return {
+        success: true,
+        gatewayUrl: runtime.gatewayUrl,
+        gatewayConfigured: wroteGatewayConfig || Boolean(runtime.config.gatewayUrl || process.env.RUBICON_GATEWAY_URL),
+        selectedArticle: articleJson(article),
+        navigation: navigation.navigation,
+        dryRun: {
+            ...estimate,
+            estimatedMaxCostUsdc: formatAtomic(estimate.estimatedMaxCostAtomic),
+        },
+        wallet: {
+            chain,
+            environment,
+            circleWalletAddress,
+            balanceAtomic,
+            balanceUsdc: balanceAtomic ? formatAtomic(balanceAtomic) : undefined,
+        },
+        receiptId: stored.receiptId,
+        savedAt: stored.savedAt,
+        receipt: finalReceiptJson({
+            receipt,
+            article,
+            receiptId: stored.receiptId,
+            goal,
+            approvedBudgetUsdc,
+            circleWalletAddress,
+        }),
+    };
+}
+async function ensureGatewayConfig(runtime) {
+    if (runtime.config.gatewayUrl || process.env.RUBICON_GATEWAY_URL)
+        return false;
+    runtime.config.gatewayUrl = runtime.gatewayUrl;
+    await writeConfig(runtime.config);
+    return true;
+}
+export function finalReceiptJson(input) {
+    const paymentIds = input.receipt.payments.map((payment) => payment.paymentId).filter(Boolean);
+    const buyerWalletAddress = input.receipt.buyerWalletAddress;
+    const mismatch = buyerWalletAddress && input.circleWalletAddress && buyerWalletAddress.toLowerCase() !== input.circleWalletAddress.toLowerCase();
+    return {
+        articleId: input.article.articleId,
+        title: input.article.title,
+        author: input.article.author,
+        sessionId: input.receipt.sessionId,
+        receiptId: input.receiptId,
+        goal: input.goal,
+        approvedBudgetUsdc: input.approvedBudgetUsdc,
+        amountPaidAtomic: input.receipt.amountPaidAtomic,
+        amountPaidUsdc: formatAtomic(input.receipt.amountPaidAtomic),
+        wordsRead: input.receipt.wordsRead,
+        completed: input.receipt.completed,
+        stopReason: input.receipt.stopReason,
+        paymentIds,
+        settlementIds: input.receipt.settlementIds,
+        transactionHashes: input.receipt.transactionHashes,
+        buyerWalletAddress,
+        circleWalletAddress: input.circleWalletAddress,
+        walletAddressMismatchExplanation: mismatch
+            ? "Circle CLI signs with the Agent Wallet, while x402/Gateway receipts can show the Gateway backing EOA that actually authorizes settlement."
+            : undefined,
+    };
+}
+function estimateRead(article, sectionId, maxSpendAtomic) {
+    const section = sectionId ? article.sections.find((candidate) => candidate.sectionId === sectionId) : undefined;
+    const estimatedWords = section?.wordCount ?? article.totalWords;
+    const estimatedMaxCostAtomic = `${BigInt(article.pricePerWordAtomic) * BigInt(estimatedWords)}`;
+    return {
+        sectionId,
+        estimatedWords,
+        estimatedMaxCostAtomic,
+        withinBudget: BigInt(maxSpendAtomic) >= BigInt(estimatedMaxCostAtomic),
+    };
+}
+function parseQuickstartBudget(parsed) {
+    const maxUsdc = stringFlag(parsed.flags, "max-usdc");
+    const maxAtomic = stringFlag(parsed.flags, "max-atomic");
+    if (!maxUsdc && !maxAtomic) {
+        throw new CliError("MISSING_BUDGET", "rubicon quickstart-read refuses paid reads without explicit --max-usdc or --max-atomic.");
+    }
+    if (maxUsdc && maxAtomic) {
+        throw new CliError("MULTIPLE_BUDGETS", "Use either --max-usdc or --max-atomic, not both.");
+    }
+    if (maxAtomic) {
+        if (!/^\d+$/.test(maxAtomic))
+            throw new CliError("INVALID_BUDGET", "--max-atomic must be an integer.");
+        return maxAtomic;
+    }
+    try {
+        return `${parseUsdcToAtomic(maxUsdc)}`;
+    }
+    catch {
+        throw new CliError("INVALID_BUDGET", "--max-usdc must be a decimal USDC amount.");
+    }
+}
+async function addCircleCheck(checks, name, task) {
+    try {
+        checks.push({ name, ok: true, status: "ok", value: await task() });
+    }
+    catch (error) {
+        const guidance = circleGuidance(error) ?? circleGuidance(classifyCircleError(error));
+        checks.push({
+            name,
+            ok: false,
+            status: name === "circleCli" ? "error" : "warning",
+            value: errorMessage(error),
+            guidance: guidance?.guidance ?? "Check Circle CLI setup and retry.",
+        });
+    }
+}
+function circleInput(_runtime, deps) {
+    return { command: deps.circleCommand, runner: deps.circleRunner };
+}
+function envAddress(name) {
+    const value = process.env[name];
+    return value?.startsWith("0x") ? value : undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=quickstart.js.map

package/dist/quickstart.js.map

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

package/dist/quickstart.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quickstart.test.d.ts.map

package/dist/quickstart.test.d.ts.map

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

package/dist/quickstart.test.js

@@ -0,0 +1,229 @@
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { parseArgs } from "./args.js";
+import { CliError } from "./errors.js";
+import { finalReceiptJson, runDoctor, runQuickstartRead } from "./quickstart.js";
+test("doctor reports missing gateway config and Circle CLI missing", async () => {
+    const runtime = runtimeFor();
+    const result = await runDoctor(runtime, {
+        cliVersion: "0.1.1",
+        fetch: okFetch,
+        circleRunner: async () => {
+            throw new Error("spawn circle ENOENT");
+        },
+    });
+    const checks = result.checks;
+    assert.equal(checks.find((check) => check.name === "gatewayConfig")?.status, "warning");
+    assert.match(checks.find((check) => check.name === "gatewayConfig")?.guidance ?? "", /hosted default/);
+    assert.equal(checks.find((check) => check.name === "circleCli")?.status, "error");
+    assert.match(checks.find((check) => check.name === "circleCli")?.guidance ?? "", /Install Circle CLI/);
+});
+test("doctor explains Circle CLI not logged in and sandbox network failures", async () => {
+    const notLoggedIn = await runDoctor(runtimeFor(), {
+        fetch: okFetch,
+        circleRunner: async (_command, args) => {
+            if (args[0] === "--version")
+                return "circle 1.0.0";
+            throw new Error("unauthorized: please login");
+        },
+    });
+    const notLoggedChecks = notLoggedIn.checks;
+    assert.match(notLoggedChecks.find((check) => check.name === "circleAuth")?.guidance ?? "", /login/);
+    const networkFailure = await runDoctor(runtimeFor(), {
+        fetch: (async () => {
+            throw new Error("fetch failed");
+        }),
+        circleRunner: async () => "circle 1.0.0",
+    });
+    const networkChecks = networkFailure.checks;
+    assert.match(networkChecks.find((check) => check.name === "gatewayReachability")?.guidance ?? "", /network-capable/);
+});
+test("quickstart refuses paid reads without explicit budget", async () => {
+    await assert.rejects(() => runQuickstartRead(runtimeFor({ argv: ["quickstart-read", "--first", "--goal", "answer"] })), (error) => error instanceof CliError && error.code === "MISSING_BUDGET");
+});
+test("quickstart detects expired OTP request IDs", async () => {
+    await assert.rejects(() => runQuickstartRead(runtimeFor(), {
+        circleRunner: async (_command, args) => {
+            if (args[0] === "auth")
+                throw new Error("OTP request id expired");
+            return circleOutput(args, "1000000");
+        },
+    }), (error) => error instanceof CliError && error.code === "OTP_EXPIRED" && /fresh Circle auth OTP/.test(error.message));
+});
+test("quickstart stops when dry-run estimate exceeds budget", async () => {
+    await assert.rejects(() => runQuickstartRead(runtimeFor({ article: article({ pricePerWordAtomic: "1000000" }) })), (error) => error instanceof CliError && error.code === "DRY_RUN_OVER_BUDGET");
+});
+test("quickstart uses existing Arc Testnet balance without faucet", async () => {
+    const calls = [];
+    const result = await runQuickstartRead(runtimeFor(), {
+        circleRunner: async (_command, args) => {
+            calls.push(args);
+            return circleOutput(args, "1000000");
+        },
+    });
+    assert.equal(result.receipt.amountPaidAtomic, "2");
+    assert.equal(calls.some((args) => args[0] === "gateway" && args[1] === "faucet"), false);
+});
+test("quickstart faucet-funds only the testnet path when needed", async () => {
+    const calls = [];
+    let funded = false;
+    const result = await runQuickstartRead(runtimeFor(), {
+        circleRunner: async (_command, args) => {
+            calls.push(args);
+            if (args[0] === "gateway" && args[1] === "faucet") {
+                funded = true;
+                return JSON.stringify({ ok: true });
+            }
+            return circleOutput(args, funded ? "1000000" : "0");
+        },
+    });
+    assert.equal(calls.some((args) => args[0] === "gateway" && args[1] === "faucet"), true);
+    assert.equal(result.wallet.balanceAtomic, "1000000");
+});
+test("quickstart refuses to suggest mainnet funding", async () => {
+    await assert.rejects(() => runQuickstartRead(runtimeFor({ article: article({ environment: "mainnet", network: "eip155:1", circleChain: "ETH" }) }), {
+        circleRunner: async (_command, args) => circleOutput(args, "0"),
+    }), (error) => error instanceof CliError && error.code === "INSUFFICIENT_FUNDS" && /Refusing to suggest mainnet funding/.test(error.message));
+});
+test("final receipt schema includes buyer/Circle wallet mismatch explanation", () => {
+    const shaped = finalReceiptJson({
+        article: article(),
+        receipt: receipt(),
+        receiptId: "receipt_1",
+        goal: "answer",
+        approvedBudgetUsdc: "0.01",
+        circleWalletAddress: "0x1111111111111111111111111111111111111111",
+    });
+    assert.deepEqual(Object.keys(shaped), [
+        "articleId",
+        "title",
+        "author",
+        "sessionId",
+        "receiptId",
+        "goal",
+        "approvedBudgetUsdc",
+        "amountPaidAtomic",
+        "amountPaidUsdc",
+        "wordsRead",
+        "completed",
+        "stopReason",
+        "paymentIds",
+        "settlementIds",
+        "transactionHashes",
+        "buyerWalletAddress",
+        "circleWalletAddress",
+        "walletAddressMismatchExplanation",
+    ]);
+    assert.match(String(shaped.walletAddressMismatchExplanation), /Gateway backing EOA/);
+});
+function runtimeFor(input = {}) {
+    process.env.HOME = mkdtempSync(join(tmpdir(), "rubicon-cli-test-"));
+    const articleFixture = input.article ?? article();
+    const client = {
+        async getRepository() {
+            return { repository: "articles", articles: [articleFixture] };
+        },
+        async getNavigation() {
+            return {
+                article: articleFixture,
+                navigation: {
+                    articleId: articleFixture.articleId,
+                    sections: articleFixture.sections,
+                    sellerAgent: {
+                        recommendedSectionId: "intro",
+                        alternativeSectionIds: [],
+                        rationale: "Start here.",
+                        safeHints: [],
+                        withheld: [],
+                    },
+                    stopConditions: [],
+                },
+            };
+        },
+        async run() {
+            return receipt();
+        },
+    };
+    return {
+        parsed: parseArgs(input.argv ?? ["quickstart-read", "--first", "--goal", "answer", "--max-usdc", "0.01"]),
+        config: {},
+        gatewayUrl: "https://rubicon.test",
+        paymentMode: "circle-cli",
+        circleChain: "ARC-TESTNET",
+        client,
+    };
+}
+function article(input = {}) {
+    return {
+        articleId: "article_1",
+        creatorId: "creator_1",
+        creatorUsername: "creator",
+        title: "Rubicon Field Notes",
+        author: "Ada",
+        state: "live",
+        totalWords: 2,
+        pricePerWordAtomic: input.pricePerWordAtomic ?? "1",
+        maxArticlePriceAtomic: `${BigInt(input.pricePerWordAtomic ?? "1") * 2n}`,
+        paymentTerms: {
+            asset: "USDC",
+            network: input.network ?? "eip155:5042002",
+            circleChain: input.circleChain ?? "ARC-TESTNET",
+            environment: input.environment ?? "testnet",
+            fundingMethod: "Circle testnet faucet.",
+            payTo: "0x3333333333333333333333333333333333333333",
+            pricePerWordAtomic: input.pricePerWordAtomic ?? "1",
+            meteringUnit: "word",
+        },
+        sections: [{ sectionId: "intro", heading: "Intro", level: 1, wordStart: 0, wordCount: 2 }],
+    };
+}
+function receipt() {
+    return {
+        sessionId: "session_1",
+        articleId: "article_1",
+        conversationId: "conversation_1",
+        wordsRead: 2,
+        amountPaidAtomic: "2",
+        payments: [
+            {
+                paymentId: "payment_1",
+                sessionId: "session_1",
+                articleId: "article_1",
+                sequence: 0,
+                meteringUnit: "word",
+                amountAtomic: "2",
+                currency: "USDC",
+                settlementIds: ["settlement_1"],
+                transactionHashes: ["0xtx"],
+                buyerWalletAddress: "0x2222222222222222222222222222222222222222",
+                settledAt: "2026-06-19T12:00:00.000Z",
+            },
+        ],
+        transactionHashes: ["0xtx"],
+        settlementIds: ["settlement_1"],
+        buyerWalletAddress: "0x2222222222222222222222222222222222222222",
+        sellerPayTo: "0x3333333333333333333333333333333333333333",
+        network: "eip155:5042002",
+        text: "hello world",
+        completed: true,
+        stopReason: "article_completed",
+    };
+}
+function circleOutput(args, balanceAtomic) {
+    if (args[0] === "--version")
+        return "circle 1.0.0";
+    if (args[0] === "auth")
+        return JSON.stringify({ loggedIn: true });
+    if (args[0] === "wallet") {
+        return JSON.stringify({ data: { wallets: [{ address: "0x1111111111111111111111111111111111111111" }] } });
+    }
+    if (args[0] === "gateway" && args[1] === "balance") {
+        return JSON.stringify({ data: { balanceAtomic, backingEOA: "0x2222222222222222222222222222222222222222" } });
+    }
+    return JSON.stringify({ ok: true });
+}
+const okFetch = (async () => new Response("ok", { status: 200 }));
+//# sourceMappingURL=quickstart.test.js.map

package/dist/quickstart.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.test.js","sourceRoot":"","sources":["../src/quickstart.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,iBAAiB,EAAuB,MAAM,iBAAiB,CAAC;AAEtG,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;IAC9E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;QACtC,UAAU,EAAE,OAAO;QACnB,KAAK,EAAE,OAAO;QACd,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAoE,CAAC;IAC3F,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACxF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACvG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;AACzG,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;IACvF,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE;QAChD,KAAK,EAAE,OAAO;QACd,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;gBAAE,OAAO,cAAc,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,WAAW,CAAC,MAAoD,CAAC;IACzF,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAEpG,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE;QACnD,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC,CAA4B;QAC7B,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,cAAc;KACzC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,cAAc,CAAC,MAAoD,CAAC;IAC1F,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACvH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,EACjG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CACxE,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC5D,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,iBAAiB,CAAC,UAAU,EAAE,EAAE;QAC9B,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAClE,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;KACF,CAAC,EACJ,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CACpH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,EAC5F,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAC7E,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;IAC7E,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,EAAE;QACnD,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAE,MAAM,CAAC,OAAmC,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;IAC3E,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,EAAE;QACnD,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;IACxF,MAAM,CAAC,KAAK,CAAE,MAAM,CAAC,MAAkC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;IAC/D,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,iBAAiB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE;QACvH,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC;KAChE,CAAC,EACJ,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CACzI,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;IAClF,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE;QAClB,OAAO,EAAE,OAAO,EAAE;QAClB,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,QAAQ;QACd,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,4CAA4C;KAClE,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QACpC,WAAW;QACX,OAAO;QACP,QAAQ;QACR,WAAW;QACX,WAAW;QACX,MAAM;QACN,oBAAoB;QACpB,kBAAkB;QAClB,gBAAgB;QAChB,WAAW;QACX,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,eAAe;QACf,mBAAmB;QACnB,oBAAoB;QACpB,qBAAqB;QACrB,kCAAkC;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,gCAAgC,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACvF,CAAC,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,QAAuD,EAAE;IAC3E,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG;QACb,KAAK,CAAC,aAAa;YACjB,OAAO,EAAE,UAAU,EAAE,UAAmB,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;QACzE,CAAC;QACD,KAAK,CAAC,aAAa;YACjB,OAAO;gBACL,OAAO,EAAE,cAAc;gBACvB,UAAU,EAAE;oBACV,SAAS,EAAE,cAAc,CAAC,SAAS;oBACnC,QAAQ,EAAE,cAAc,CAAC,QAAQ;oBACjC,WAAW,EAAE;wBACX,oBAAoB,EAAE,OAAO;wBAC7B,qBAAqB,EAAE,EAAE;wBACzB,SAAS,EAAE,aAAa;wBACxB,SAAS,EAAE,EAAE;wBACb,QAAQ,EAAE,EAAE;qBACb;oBACD,cAAc,EAAE,EAAE;iBACnB;aACF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG;YACP,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;KAC0B,CAAC;IAC9B,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACzG,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,sBAAsB;QAClC,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,aAAa;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,QAKb,EAAE;IACJ,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,WAAW;QACtB,eAAe,EAAE,SAAS;QAC1B,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,CAAC;QACb,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,GAAG;QACnD,qBAAqB,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,GAAG,CAAC,GAAG,EAAE,EAAiB;QACvF,YAAY,EAAE;YACZ,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,gBAAgB;YAC1C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,aAAa;YAC/C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;YAC3C,aAAa,EAAE,wBAAwB;YACvC,KAAK,EAAE,4CAA4C;YACnD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,GAAG;YACnD,YAAY,EAAE,MAAM;SACrB;QACD,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,SAAS,OAAO;IACd,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,WAAW;QACtB,cAAc,EAAE,gBAAgB;QAChC,SAAS,EAAE,CAAC;QACZ,gBAAgB,EAAE,GAAG;QACrB,QAAQ,EAAE;YACR;gBACE,SAAS,EAAE,WAAW;gBACtB,SAAS,EAAE,WAAW;gBACtB,SAAS,EAAE,WAAW;gBACtB,QAAQ,EAAE,CAAC;gBACX,YAAY,EAAE,MAAM;gBACpB,YAAY,EAAE,GAAG;gBACjB,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,CAAC,cAAc,CAAC;gBAC/B,iBAAiB,EAAE,CAAC,MAAM,CAAC;gBAC3B,kBAAkB,EAAE,4CAA4C;gBAChE,SAAS,EAAE,0BAA0B;aACtC;SACF;QACD,iBAAiB,EAAE,CAAC,MAAM,CAAC;QAC3B,aAAa,EAAE,CAAC,cAAc,CAAC;QAC/B,kBAAkB,EAAE,4CAA4C;QAChE,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,mBAAmB;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAc,EAAE,aAA0B;IAC9D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;QAAE,OAAO,cAAc,CAAC;IACnD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,4CAA4C,EAAE,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAA4B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubicon-caliga/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Terminal-native Rubicon CLI for buyer agents consuming pay-per-word articles.",
   "license": "MIT",
   "type": "module",
@@ -27,19 +27,21 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx --test src/**/*.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {
-    "@rubicon-caliga/agent-sdk": "0.1.2",
-    "@rubicon-caliga/core": "0.1.0"
+    "@rubicon-caliga/agent-sdk": "workspace:*",
+    "@rubicon-caliga/core": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsx src/index.ts",
-    "lint": "tsc -p tsconfig.json --noEmit",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}