sorokeep 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/commands/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiS5D"}

package/dist/commands/alerts.js

@@ -0,0 +1,256 @@
+import chalk from "chalk";
+import { randomBytes } from "node:crypto";
+import { getDatabase } from "../db/database.js";
+import { insertAlertConfig, getAlertConfigsForContract, getAlertConfigById, deleteAlertConfig, insertResourceAlertConfig, getContract, getAlertHistory, } from "../db/repositories.js";
+import { formatContractID, formatTimeToCloseLedger } from "../utils/formatting.js";
+import { deliverSingleAlert } from "../alerts/dispatcher.js";
+import { buildAlertEvent } from "../alerts/types.js";
+export function registerAlertsCommand(program) {
+    const alerts = program
+        .command("alerts")
+        .description("Manage alert configurations");
+    // ── alerts add ─────────────────────────────────────────────────────
+    alerts
+        .command("add")
+        .description("Add a new alert configuration (TTL-based or resource-based)")
+        .requiredOption("--contract <id>", "The contract ID to alert on")
+        .requiredOption("--type <type>", "The notification channel type ('webhook', 'slack', 'discord', 'telegram', or 'pagerduty')")
+        .option("--url <url>", "Webhook URL (required if --type is webhook or discord)")
+        .option("--channel <channel>", "Slack channel (required if --type is slack)")
+        .option("--routing-key <key>", "PagerDuty integration key (required if --type is pagerduty)")
+        .option("--secret <secret>", "HMAC secret for webhook signing (auto-generated if omitted for webhooks)")
+        .option("--threshold <ledgers>", "Threshold in number of ledgers (for TTL-based alerts)", (val) => parseInt(val, 10))
+        .option("--cpu-limit <instructions>", "CPU instruction limit for resource alerts (default: 100,000,000)", (val) => parseInt(val, 10))
+        .option("--mem-limit <bytes>", "Memory byte limit for resource alerts (default: 50,000,000)", (val) => parseInt(val, 10))
+        .action((options) => {
+        const contractId = options.contract;
+        // Determine if this is a TTL alert or resource alert
+        const isTTLAlert = typeof options.threshold !== "undefined";
+        const isResourceAlert = typeof options.cpuLimit !== "undefined" || typeof options.memLimit !== "undefined";
+        if (!isTTLAlert && !isResourceAlert) {
+            console.error(chalk.red("Error: You must specify either --threshold (for TTL alerts) or --cpu-limit/--mem-limit (for resource alerts)."));
+            process.exit(1);
+        }
+        if (isTTLAlert && isResourceAlert) {
+            console.error(chalk.red("Error: Cannot mix TTL alerts and resource alerts. Use either --threshold or --cpu-limit/--mem-limit, not both."));
+            process.exit(1);
+        }
+        const db = getDatabase();
+        const contract = getContract(db, contractId);
+        if (!contract) {
+            console.error(chalk.red(`Error: Contract ${formatContractID(contractId)} is not registered.`));
+            console.error(chalk.dim("Run 'sorokeep watch <contractId>' first."));
+            process.exit(1);
+        }
+        let target = "";
+        let webhookSecret;
+        if (options.type === "webhook") {
+            if (!options.url) {
+                console.error(chalk.red("Error: --url is required when --type is webhook."));
+                process.exit(1);
+            }
+            target = options.url;
+            webhookSecret = options.secret ?? randomBytes(32).toString("hex");
+        }
+        else if (options.type === "slack") {
+            if (!options.channel) {
+                console.error(chalk.red("Error: --channel is required when --type is slack."));
+                process.exit(1);
+            }
+            target = options.channel;
+        }
+        else if (options.type === "pagerduty") {
+            if (!options.routingKey) {
+                console.error(chalk.red("Error: --routing-key is required when --type is pagerduty."));
+                process.exit(1);
+            }
+            target = options.routingKey;
+        }
+        else if (options.type === "discord") {
+            if (!options.url) {
+                console.error(chalk.red("Error: --url is required when --type is discord. Paste the full Discord webhook URL."));
+                process.exit(1);
+            }
+            target = options.url;
+        }
+        else if (options.type === "telegram") {
+            if (!options.channel) {
+                console.error(chalk.red("Error: --channel is required when --type is telegram (use chat ID or @channelname)."));
+                process.exit(1);
+            }
+            target = options.channel;
+        }
+        else if (options.type === "email") {
+            console.error(chalk.red("Error: Email alerting is not yet implemented. Use 'webhook', 'slack', 'discord', 'telegram', or 'pagerduty'."));
+            process.exit(1);
+        }
+        else {
+            console.error(chalk.red("Error: --type must be 'webhook', 'slack', 'discord', 'telegram', or 'pagerduty'."));
+            process.exit(1);
+        }
+        if (isTTLAlert) {
+            const threshold = options.threshold;
+            if (isNaN(threshold) || threshold <= 0) {
+                console.error(chalk.red("Error: --threshold must be a positive integer."));
+                process.exit(1);
+            }
+            insertAlertConfig(db, {
+                contract_id: contractId,
+                channel_type: options.type,
+                channel_target: target,
+                threshold_ledgers: threshold,
+                webhook_secret: webhookSecret,
+            });
+            console.log(chalk.green(`Successfully added alert config: type=${options.type}, target=${target}, threshold=${threshold} ledgers`));
+            if (webhookSecret) {
+                console.log(`  ${chalk.bold("Webhook secret:")} ${webhookSecret}`);
+                console.log(chalk.dim("  Save this secret — it signs payloads via X-Sorokeep-Signature header."));
+            }
+        }
+        else {
+            // Resource alert
+            const cpuLimit = options.cpuLimit ?? 100_000_000;
+            const memLimit = options.memLimit ?? 50_000_000;
+            if (cpuLimit <= 0 || memLimit <= 0) {
+                console.error(chalk.red("Error: --cpu-limit and --mem-limit must be positive integers."));
+                process.exit(1);
+            }
+            insertResourceAlertConfig(db, {
+                contract_id: contractId,
+                channel_type: options.type,
+                channel_target: target,
+                cpu_limit: cpuLimit,
+                mem_limit: memLimit,
+                webhook_secret: webhookSecret,
+            });
+            console.log(chalk.green(`Successfully added alert config: type=${options.type}, target=${target}, CPU=${cpuLimit.toLocaleString()} instr, MEM=${memLimit.toLocaleString()} bytes`));
+            if (webhookSecret) {
+                console.log(`  ${chalk.bold("Webhook secret:")} ${webhookSecret}`);
+                console.log(chalk.dim("  Save this secret — it signs payloads via X-Sorokeep-Signature header."));
+            }
+        }
+    });
+    // ── alerts list ────────────────────────────────────────────────────
+    alerts
+        .command("list")
+        .description("List alert configurations for a contract")
+        .requiredOption("--contract <id>", "The contract ID to list alerts for")
+        .action((options) => {
+        const contractId = options.contract;
+        const db = getDatabase();
+        const contract = getContract(db, contractId);
+        if (!contract) {
+            console.error(chalk.red(`Error: Contract ${formatContractID(contractId)} is not registered.`));
+            process.exit(1);
+        }
+        const configs = getAlertConfigsForContract(db, contractId);
+        if (configs.length === 0) {
+            console.log(chalk.yellow(`No alert configurations found for contract ${formatContractID(contractId)}.`));
+            return;
+        }
+        console.log();
+        console.log(chalk.bold(`  Alert Configurations for ${contract.name ?? formatContractID(contractId)}`));
+        console.log();
+        for (const config of configs) {
+            const signed = config.webhook_secret ? chalk.green(" [signed]") : "";
+            console.log(`  ID: ${chalk.cyan(config.id.toString().padEnd(4))} | ` +
+                `Type: ${chalk.yellow(config.channel_type.padEnd(8))} | ` +
+                `Target: ${chalk.green(config.channel_target.padEnd(30))} | ` +
+                `Threshold: ${chalk.magenta(config.threshold_ledgers.toLocaleString())} ledgers` +
+                signed);
+        }
+        console.log();
+    });
+    // ── alerts remove ──────────────────────────────────────────────────
+    alerts
+        .command("remove")
+        .description("Remove an alert configuration")
+        .requiredOption("--id <id>", "The alert configuration ID to remove")
+        .action((options) => {
+        const id = parseInt(options.id, 10);
+        if (isNaN(id)) {
+            console.error(chalk.red("Error: --id must be a number."));
+            process.exit(1);
+        }
+        const db = getDatabase();
+        deleteAlertConfig(db, id);
+        console.log(chalk.green(`Successfully removed alert config ID ${id}.`));
+    });
+    // ── alerts test ────────────────────────────────────────────────────
+    alerts
+        .command("test")
+        .description("Send a test alert to verify channel connectivity")
+        .requiredOption("--id <id>", "The alert configuration ID to test")
+        .action(async (options) => {
+        const id = parseInt(options.id, 10);
+        if (isNaN(id)) {
+            console.error(chalk.red("Error: --id must be a number."));
+            process.exit(1);
+        }
+        const db = getDatabase();
+        const config = getAlertConfigById(db, id);
+        if (!config) {
+            console.error(chalk.red(`Error: Alert config ID ${id} not found.`));
+            process.exit(1);
+        }
+        const testEvent = buildAlertEvent({
+            type: "threshold_crossed",
+            contractId: config.contract_id,
+            contractName: null,
+            network: "testnet",
+            entryKeyXdr: "TEST_ENTRY_KEY",
+            entryType: "instance",
+            entryLabel: "test-entry",
+            configuredLedgers: config.threshold_ledgers,
+            remainingTTL: Math.floor(config.threshold_ledgers * 0.5),
+            firedAtLedger: 0,
+        });
+        console.log(`Sending test alert to ${config.channel_type}:${config.channel_target}...`);
+        const success = await deliverSingleAlert(config.channel_type, config.channel_target, testEvent, config.webhook_secret);
+        if (success) {
+            console.log(chalk.green("Test alert delivered successfully."));
+        }
+        else {
+            console.error(chalk.red("Test alert delivery failed. Check logs for details."));
+            process.exit(1);
+        }
+    });
+    // ── alerts history ─────────────────────────────────────────────────
+    alerts
+        .command("history")
+        .description("Show alert history for a contract")
+        .requiredOption("--contract <id>", "The contract ID to show history for")
+        .option("--limit <n>", "Max number of records to show", "20")
+        .action((options) => {
+        const contractId = options.contract;
+        const limit = parseInt(options.limit, 10);
+        const db = getDatabase();
+        const contract = getContract(db, contractId);
+        if (!contract) {
+            console.error(chalk.red(`Error: Contract ${formatContractID(contractId)} is not registered.`));
+            process.exit(1);
+        }
+        const history = getAlertHistory(db, contractId, limit > 0 ? limit : undefined);
+        if (history.length === 0) {
+            console.log(chalk.yellow("No alert history found."));
+            return;
+        }
+        const displayName = contract.name ?? formatContractID(contractId);
+        console.log(`\n${chalk.bold("Alert History")} — ${chalk.cyan(displayName)}\n`);
+        for (const record of history) {
+            const statusIcon = record.resolved ? chalk.green("✓") : chalk.yellow("●");
+            const deliveryIcon = record.delivered ? chalk.green("✓") : chalk.red("✗");
+            const label = record.entryLabel ?? record.entryType;
+            const ttlDisplay = formatTimeToCloseLedger(record.ttlAtFire);
+            console.log(`  ${statusIcon} ${chalk.dim(record.firedAt)} | ` +
+                `${label} | TTL: ${record.ttlAtFire.toLocaleString()} (${ttlDisplay}) | ` +
+                `${record.channelType}→${deliveryIcon} | ` +
+                `retries: ${record.retryCount}`);
+            if (record.resolvedAt) {
+                console.log(chalk.dim(`    Resolved: ${record.resolvedAt}`));
+            }
+        }
+        console.log();
+    });
+}
+//# sourceMappingURL=alerts.js.map

package/dist/commands/alerts.js.map

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

package/dist/commands/budget.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerBudgetCommand(program: Command): void;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/commands/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkD5D"}

package/dist/commands/budget.js

@@ -0,0 +1,47 @@
+import chalk from "chalk";
+import { getDatabase } from "../db/database.js";
+import { setContractBudget, getMonthlySpendProgress } from "../core/budget.js";
+import { formatContractID } from "../utils/formatting.js";
+export function registerBudgetCommand(program) {
+    const budgetCmd = program
+        .command("budget")
+        .description("Manage monthly spending bounds for contracts");
+    budgetCmd
+        .command("set")
+        .description("Set a monthly budget limit for a contract")
+        .requiredOption("--contract <contractId>", "Contract ID to set budget for")
+        .requiredOption("--limit <limit>", "Monthly limit in XLM", parseFloat)
+        .action((options) => {
+        const db = getDatabase();
+        if (isNaN(options.limit) || options.limit < 0) {
+            console.log(chalk.red("Invalid limit. Must be a positive number."));
+            process.exit(1);
+        }
+        setContractBudget(db, options.contract, options.limit);
+        console.log(chalk.green(`Budget set to ${options.limit} XLM for ${formatContractID(options.contract)}.`));
+    });
+    budgetCmd
+        .command("status <contractId>")
+        .description("View current budget status and spend progress")
+        .action((contractId) => {
+        const db = getDatabase();
+        const progress = getMonthlySpendProgress(db, contractId);
+        if (!progress) {
+            console.log(chalk.yellow(`No budget configured for ${formatContractID(contractId)}.`));
+            process.exit(0);
+            return;
+        }
+        const { limit, spend, percentage } = progress;
+        console.log();
+        console.log(chalk.bold(`  Budget Status`) + chalk.dim(` (${formatContractID(contractId)})`));
+        // Draw progress bar
+        const barWidth = 40;
+        const filledWidth = Math.min(barWidth, Math.floor((percentage / 100) * barWidth));
+        const emptyWidth = barWidth - filledWidth;
+        const bar = chalk.green("█".repeat(filledWidth)) + chalk.dim("░".repeat(emptyWidth));
+        console.log(`  ${bar} ${percentage.toFixed(1)}%`);
+        console.log(`  ${spend.toFixed(2)} / ${limit.toFixed(2)} XLM spent this month`);
+        console.log();
+    });
+}
+//# sourceMappingURL=budget.js.map

package/dist/commands/budget.js.map

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

package/dist/commands/channels.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerChannelsCommand(program: Command): void;
+//# sourceMappingURL=channels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/commands/channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiG9D"}

package/dist/commands/channels.js

@@ -0,0 +1,84 @@
+import chalk from "chalk";
+import { getDatabase } from "../db/database.js";
+import { getChannelAccounts } from "../db/repositories.js";
+import { addChannel, fundChannels } from "../core/channels.js";
+import { formatContractID } from "../utils/formatting.js";
+export function registerChannelsCommand(program) {
+    const channels = program
+        .command("channels")
+        .description("Manage channel accounts for fee bumping and transaction parallelism");
+    // ── channels add ────────────────────────────────────────────────────────
+    channels
+        .command("add")
+        .description("Register a channel account public key")
+        .requiredOption("--key <publicKey>", "Stellar public key of the channel account")
+        .option("--label <label>", "Optional human-readable label")
+        .option("--network <network>", "Network (testnet or mainnet)", "testnet")
+        .action((options) => {
+        const db = getDatabase();
+        const existing = getChannelAccounts(db, options.network)
+            .find((a) => a.public_key === options.key);
+        if (existing) {
+            console.error(chalk.red(`Error: Key ${formatContractID(options.key)} is already registered.`));
+            process.exit(1);
+        }
+        addChannel(db, options.key, options.network, options.label);
+        console.log(chalk.green(`✔ Channel account registered successfully.`) +
+            `\n  Key:     ${chalk.cyan(options.key)}` +
+            (options.label ? `\n  Label:   ${options.label}` : "") +
+            `\n  Network: ${options.network}`);
+    });
+    // ── channels list ───────────────────────────────────────────────────────
+    channels
+        .command("list")
+        .description("List registered channel accounts")
+        .option("--network <network>", "Network (testnet or mainnet)", "testnet")
+        .action((options) => {
+        const db = getDatabase();
+        const accounts = getChannelAccounts(db, options.network);
+        if (accounts.length === 0) {
+            console.log(chalk.yellow(`No channel accounts registered for network: ${options.network}.`));
+            return;
+        }
+        console.log();
+        console.log(chalk.bold(`  Channel Accounts (${options.network})`));
+        console.log();
+        for (const account of accounts) {
+            const fundedBadge = account.funded ? chalk.green(" [funded]") : chalk.dim(" [unfunded]");
+            const label = account.label ? chalk.yellow(` ${account.label}`) : "";
+            console.log(`  ${chalk.cyan(account.public_key)}${label}${fundedBadge}`);
+        }
+        console.log();
+    });
+    // ── channels fund ───────────────────────────────────────────────────────
+    channels
+        .command("fund")
+        .description("Send XLM from master wallet to all registered channel accounts")
+        .requiredOption("--master-key <secretKey>", "Master wallet secret key (source of funds)")
+        .option("--amount <xlm>", "Amount of XLM to send to each channel account", "10")
+        .option("--network <network>", "Network (testnet or mainnet)", "testnet")
+        .option("-r, --rpc-url <url>", "Custom RPC endpoint URL")
+        .action(async (options) => {
+        const db = getDatabase();
+        const accounts = getChannelAccounts(db, options.network);
+        if (accounts.length === 0) {
+            console.error(chalk.red(`No channel accounts registered for network: ${options.network}.`));
+            console.error(chalk.dim("Run 'sorokeep channels add --key <key>' first."));
+            process.exit(1);
+        }
+        console.log(`Funding ${accounts.length} channel account(s) with ${options.amount} XLM each...`);
+        const result = await fundChannels(db, options.masterKey, options.amount, options.network, options.rpcUrl);
+        if (result.errors.length > 0) {
+            for (const err of result.errors) {
+                console.error(chalk.red(`Error: ${err}`));
+            }
+        }
+        if (result.funded > 0) {
+            console.log(chalk.green(`✔ Funded ${result.funded} channel account(s) successfully.`));
+            if (result.txHash) {
+                console.log(`  Tx hash: ${chalk.cyan(result.txHash)}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=channels.js.map

package/dist/commands/channels.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerCheckCommand(program: Command): void;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmE3D"}

package/dist/commands/check.js

@@ -0,0 +1,58 @@
+import chalk from "chalk";
+import { getDatabase } from "../db/database.js";
+import { getContract, getEntriesForContract } from "../db/repositories.js";
+import { classifyTTL, statusIndicator, formatTimeToCloseLedger, formatContractID, } from "../utils/formatting.js";
+export function registerCheckCommand(program) {
+    program
+        .command("check <contractId>")
+        .description("Check TTL health for a watched contract (CI-friendly, can be forced)")
+        .option("--force", "Bypass CI TTL failures and exit 0")
+        .requiredOption("--fail-under <ledgers>", "Exit with code 1 if any entry TTL is below this many ledgers", parseInt)
+        .action((contractId, options) => {
+        const db = getDatabase();
+        const contract = getContract(db, contractId);
+        if (!contract) {
+            console.log(chalk.red(`Contract ${formatContractID(contractId)} is not registered.`));
+            console.log(chalk.dim("Run 'sorokeep watch <contractId>' first."));
+            process.exit(1);
+        }
+        const entries = getEntriesForContract(db, contractId);
+        const lastChecked = contract.last_checked_ledger;
+        if (entries.length === 0 || lastChecked == null) {
+            console.log(chalk.green("All TTLs are safe."));
+            process.exit(0);
+        }
+        let hasFailure = false;
+        for (const entry of entries) {
+            if (entry.live_until_ledger == null)
+                continue;
+            const remainingTTL = entry.live_until_ledger - lastChecked;
+            const label = entry.entry_type === "instance"
+                ? "Instance"
+                : entry.entry_type === "wasm"
+                    ? "WASM Code"
+                    : entry.label ?? entry.entry_type;
+            const timeStr = formatTimeToCloseLedger(remainingTTL);
+            const status = classifyTTL(remainingTTL);
+            if (remainingTTL < options.failUnder) {
+                hasFailure = true;
+                console.log(`${chalk.bold(label)}  TTL: ${remainingTTL.toLocaleString().padStart(9)} ledgers (${timeStr})  ${statusIndicator(status)}  ${chalk.red("FAIL")}`);
+            }
+            else {
+                console.log(`${chalk.bold(label)}  TTL: ${remainingTTL.toLocaleString().padStart(9)} ledgers (${timeStr})  ${statusIndicator(status)}  ${chalk.green("PASS")}`);
+            }
+        }
+        if (hasFailure) {
+            if (options.force) {
+                console.log("WARNING: CI checks bypassed with --force");
+                process.exit(0);
+            }
+            else {
+                process.exit(1);
+            }
+        }
+        console.log(chalk.green("All TTLs are safe."));
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/completion.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerCompletionCommand(program: Command): void;
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkChE"}

package/dist/commands/completion.js

@@ -0,0 +1,36 @@
+import { getDatabase } from "../db/database.js";
+import { getCompletionSuggestions, renderBashCompletionScript, renderZshCompletionScript, } from "../core/completion.js";
+export function registerCompletionCommand(program) {
+    program
+        .command("completion")
+        .description("Generate or query shell completion suggestions")
+        .option("--script <shell>", "Generate a completion script for bash or zsh")
+        .option("--query", "Query completion suggestions for the current command line")
+        .option("--cursor <index>", "Cursor position for the current word", (val) => parseInt(val, 10))
+        .argument("[words...]", "Current command line words")
+        .action((words, options) => {
+        if (options.query) {
+            const cursor = Number.isInteger(options.cursor) ? options.cursor : words.length - 1;
+            const db = getDatabase();
+            const suggestions = getCompletionSuggestions(db, ["sorokeep", ...words], cursor);
+            process.stdout.write(suggestions.join("\n"));
+            return;
+        }
+        if (options.script) {
+            if (options.script === "bash") {
+                process.stdout.write(renderBashCompletionScript());
+                return;
+            }
+            if (options.script === "zsh") {
+                process.stdout.write(renderZshCompletionScript());
+                return;
+            }
+            console.error("Unsupported shell for completion script. Use 'bash' or 'zsh'.");
+            process.exit(1);
+        }
+        process.stdout.write("Generate shell completion scripts or query suggestions for shell integration.\n");
+        process.stdout.write("Use '--script bash' or '--script zsh' to print a completion script.\n");
+        process.stdout.write("Use '--query --cursor <index> [words...]' to query suggestions.\n");
+    });
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,kBAAkB,EAAE,8CAA8C,CAAC;SAC1E,MAAM,CAAC,SAAS,EAAE,2DAA2D,CAAC;SAC9E,MAAM,CAAC,kBAAkB,EAAE,sCAAsC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;SAC9F,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAC;SACpD,MAAM,CAAC,CAAC,KAAe,EAAE,OAA8D,EAAE,EAAE;QAC1F,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACrF,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,wBAAwB,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACxG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC9F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/costs.d.ts

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import type { RentWindowsResult } from "../core/rent_projection.js";
+/**
+ * Render a single RentWindowsResult as a table under the "Forecasted Rent"
+ * section. Returns an array of console lines (without printing) so callers can
+ * test the output easily.
+ *
+ * @param result    - Output of `projectRentWindows` for one entry.
+ * @param entryType - Human-readable entry type label (instance, wasm, …).
+ * @param budget    - Monthly budget in XLM (optional). When provided, windows
+ *                    that exceed the budget are flagged in red.
+ */
+export declare function formatForecastedRentEntry(result: RentWindowsResult, entryType: string, budget?: number): string[];
+export declare function registerCostsCommand(program: Command): void;
+//# sourceMappingURL=costs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/commands/costs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAwDpE;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,CAoBV;AAKD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuR3D"}