@tangle-network/agent-app 0.45.25 → 0.45.27

package/dist/spend/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import {
+  formatSpendReport,
+  reconcileSpend,
+  spendReportToJson
+} from "../chunk-NEJ7OMQS.js";
+
+// src/spend/cli-args.ts
+import { pathToFileURL } from "url";
+import { resolve } from "path";
+var SpendUsageError = class extends Error {
+};
+var DEFAULT_CONFIG_FILE = "spend.config.mjs";
+var USAGE = [
+  "agent-app-spend-check \u2014 reconcile settled sandbox compute against what this product asked for.",
+  "",
+  "Usage: agent-app-spend-check [--config <file>] [--json] [--as-of <iso>] [--skip <check,check>]",
+  "",
+  `  --config <file>   Config module. Default ${DEFAULT_CONFIG_FILE}.`,
+  "  --json            Emit the report as JSON instead of a table.",
+  '  --as-of <iso>     Treat this instant as "now". Default: the current time.',
+  "  --skip <checks>   Comma-separated check ids to leave out.",
+  "",
+  "The config module default-exports (or exports as `config`) the reconcile options,",
+  "or a function returning them. It supplies the two things this package cannot:",
+  "the product's own expectation store, and an authenticated fetch of its settled",
+  "ledger rows. Scope that fetch to boxes this product owns.",
+  "",
+  "Exit 0 = clean, 1 = findings, 2 = usage or config error."
+].join("\n");
+function parseSpendArgs(argv) {
+  let configFile = DEFAULT_CONFIG_FILE;
+  let json = false;
+  let asOf;
+  let skip = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--json") {
+      json = true;
+    } else if (arg === "--config") {
+      const value = argv[++i];
+      if (!value) throw new SpendUsageError("--config needs a file path");
+      configFile = value;
+    } else if (arg === "--as-of") {
+      const value = argv[++i];
+      if (!value) throw new SpendUsageError("--as-of needs an ISO instant");
+      const parsed = Date.parse(value);
+      if (Number.isNaN(parsed)) throw new SpendUsageError(`--as-of is not a date: ${value}`);
+      asOf = parsed;
+    } else if (arg === "--skip") {
+      const value = argv[++i];
+      if (!value) throw new SpendUsageError("--skip needs a comma-separated list of check ids");
+      skip = value.split(",").map((part) => part.trim()).filter(Boolean);
+    } else if (arg === "--help" || arg === "-h") {
+      throw new SpendUsageError("help");
+    } else if (arg !== void 0) {
+      throw new SpendUsageError(`unrecognized argument: ${arg}`);
+    }
+  }
+  return { configFile, json, asOf, skip };
+}
+async function loadSpendConfig(configFile) {
+  const resolved = resolve(process.cwd(), configFile);
+  let module;
+  try {
+    module = await import(pathToFileURL(resolved).href);
+  } catch (err) {
+    throw new SpendUsageError(
+      `could not load ${resolved}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  const exported = module.default ?? module.config;
+  const value = typeof exported === "function" ? await exported() : exported;
+  if (!value || typeof value !== "object") {
+    throw new SpendUsageError(`${resolved} must export reconcile options as \`default\` or \`config\``);
+  }
+  const options = value;
+  if (!Array.isArray(options.rows)) {
+    throw new SpendUsageError(`${resolved} must supply \`rows\` \u2014 the product's own settled-ledger fetch`);
+  }
+  if (!options.store) {
+    throw new SpendUsageError(`${resolved} must supply \`store\` \u2014 the product's expectation ledger`);
+  }
+  return options;
+}
+
+// src/spend/cli.ts
+async function main() {
+  const args = parseSpendArgs(process.argv.slice(2));
+  const config = await loadSpendConfig(args.configFile);
+  const report = await reconcileSpend({
+    ...config,
+    ...args.asOf !== void 0 ? { asOf: args.asOf } : {},
+    ...args.skip.length > 0 ? { skip: args.skip } : {}
+  });
+  const rendered = args.json ? spendReportToJson(report) : formatSpendReport(report);
+  if (report.ok) process.stdout.write(`${rendered}
+`);
+  else process.stderr.write(`${rendered}
+`);
+  return report.ok ? 0 : 1;
+}
+try {
+  process.exit(await main());
+} catch (err) {
+  if (err instanceof SpendUsageError) {
+    process.stderr.write(`${err.message === "help" ? "" : `${err.message}
+
+`}${USAGE}
+`);
+    process.exit(2);
+  }
+  process.stderr.write(
+    `agent-app-spend-check failed: ${err instanceof Error ? err.message : String(err)}
+`
+  );
+  process.exit(2);
+}
+//# sourceMappingURL=cli.js.map

package/dist/spend/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/spend/cli-args.ts","../../src/spend/cli.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url'\nimport { resolve } from 'node:path'\nimport type { ReconcileSpendOptions } from './reconcile'\n\n/** A usage or config problem — exit code 2, never a finding. */\nexport class SpendUsageError extends Error {}\n\nconst DEFAULT_CONFIG_FILE = 'spend.config.mjs'\n\nexport const USAGE = [\n  'agent-app-spend-check — reconcile settled sandbox compute against what this product asked for.',\n  '',\n  'Usage: agent-app-spend-check [--config <file>] [--json] [--as-of <iso>] [--skip <check,check>]',\n  '',\n  `  --config <file>   Config module. Default ${DEFAULT_CONFIG_FILE}.`,\n  '  --json            Emit the report as JSON instead of a table.',\n  '  --as-of <iso>     Treat this instant as \"now\". Default: the current time.',\n  '  --skip <checks>   Comma-separated check ids to leave out.',\n  '',\n  'The config module default-exports (or exports as `config`) the reconcile options,',\n  'or a function returning them. It supplies the two things this package cannot:',\n  'the product\\'s own expectation store, and an authenticated fetch of its settled',\n  'ledger rows. Scope that fetch to boxes this product owns.',\n  '',\n  'Exit 0 = clean, 1 = findings, 2 = usage or config error.',\n].join('\\n')\n\nexport interface SpendCliArgs {\n  readonly configFile: string\n  readonly json: boolean\n  readonly asOf: number | undefined\n  readonly skip: readonly string[]\n}\n\n/** Parse argv. Split out of `cli.ts` so it is testable without a `process.exit`. */\nexport function parseSpendArgs(argv: readonly string[]): SpendCliArgs {\n  let configFile = DEFAULT_CONFIG_FILE\n  let json = false\n  let asOf: number | undefined\n  let skip: string[] = []\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]\n    if (arg === '--json') {\n      json = true\n    } else if (arg === '--config') {\n      const value = argv[++i]\n      if (!value) throw new SpendUsageError('--config needs a file path')\n      configFile = value\n    } else if (arg === '--as-of') {\n      const value = argv[++i]\n      if (!value) throw new SpendUsageError('--as-of needs an ISO instant')\n      const parsed = Date.parse(value)\n      if (Number.isNaN(parsed)) throw new SpendUsageError(`--as-of is not a date: ${value}`)\n      asOf = parsed\n    } else if (arg === '--skip') {\n      const value = argv[++i]\n      if (!value) throw new SpendUsageError('--skip needs a comma-separated list of check ids')\n      skip = value.split(',').map((part) => part.trim()).filter(Boolean)\n    } else if (arg === '--help' || arg === '-h') {\n      throw new SpendUsageError('help')\n    } else if (arg !== undefined) {\n      throw new SpendUsageError(`unrecognized argument: ${arg}`)\n    }\n  }\n\n  return { configFile, json, asOf, skip }\n}\n\n/**\n * Load the product's reconcile options.\n *\n * A function export is awaited, so a config can open its database connection and\n * mint its platform credential at load time rather than at module scope.\n */\nexport async function loadSpendConfig(configFile: string): Promise<ReconcileSpendOptions> {\n  const resolved = resolve(process.cwd(), configFile)\n  let module: Record<string, unknown>\n  try {\n    module = (await import(pathToFileURL(resolved).href)) as Record<string, unknown>\n  } catch (err) {\n    throw new SpendUsageError(\n      `could not load ${resolved}: ${err instanceof Error ? err.message : String(err)}`,\n    )\n  }\n  const exported = module.default ?? module.config\n  const value = typeof exported === 'function' ? await (exported as () => unknown)() : exported\n  if (!value || typeof value !== 'object') {\n    throw new SpendUsageError(`${resolved} must export reconcile options as \\`default\\` or \\`config\\``)\n  }\n  const options = value as Partial<ReconcileSpendOptions>\n  if (!Array.isArray(options.rows)) {\n    throw new SpendUsageError(`${resolved} must supply \\`rows\\` — the product's own settled-ledger fetch`)\n  }\n  if (!options.store) {\n    throw new SpendUsageError(`${resolved} must supply \\`store\\` — the product's expectation ledger`)\n  }\n  return options as ReconcileSpendOptions\n}\n","#!/usr/bin/env node\n/**\n * `agent-app-spend-check` — reconcile what the platform charged for sandbox\n * compute against what this product believes it asked for.\n *\n * Runs in the CONSUMER's repo, on a schedule, over the consumer's own ledger\n * fetch and expectation store — the two things this package deliberately does\n * not reach for. Add it next to the other gates:\n *\n *     \"scripts\": { \"spend-check\": \"agent-app-spend-check\" }\n *\n * Exits 1 on any finding, 0 when clean, 2 on a usage or config error. It never\n * disputes, refunds, or writes anything; the output is evidence a human acts on.\n */\nimport { SpendUsageError, USAGE, loadSpendConfig, parseSpendArgs } from './cli-args'\nimport { reconcileSpend } from './reconcile'\nimport { formatSpendReport, spendReportToJson } from './report'\nimport type { SpendCheckId } from './types'\n\nasync function main(): Promise<number> {\n  const args = parseSpendArgs(process.argv.slice(2))\n  const config = await loadSpendConfig(args.configFile)\n  const report = await reconcileSpend({\n    ...config,\n    ...(args.asOf !== undefined ? { asOf: args.asOf } : {}),\n    ...(args.skip.length > 0 ? { skip: args.skip as SpendCheckId[] } : {}),\n  })\n  const rendered = args.json ? spendReportToJson(report) : formatSpendReport(report)\n  // A clean report is routine output; a failing one belongs on stderr so a cron\n  // that only forwards stderr still delivers the alert.\n  if (report.ok) process.stdout.write(`${rendered}\\n`)\n  else process.stderr.write(`${rendered}\\n`)\n  return report.ok ? 0 : 1\n}\n\ntry {\n  process.exit(await main())\n} catch (err) {\n  if (err instanceof SpendUsageError) {\n    process.stderr.write(`${err.message === 'help' ? '' : `${err.message}\\n\\n`}${USAGE}\\n`)\n    process.exit(2)\n  }\n  process.stderr.write(\n    `agent-app-spend-check failed: ${err instanceof Error ? err.message : String(err)}\\n`,\n  )\n  process.exit(2)\n}\n"],"mappings":"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","names":[]}