ai-spend-agent 0.5.6 → 0.5.8

package/dist/index.js

@@ -6,6 +6,9 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { analyzeSpend, attributeUsageRecords, buildUsageGlance, loadContextHealth, detectLocalCredentials, detectLocalPlans, redactSecrets, readSafeStateText, resolveSafeScanRoot, resolveSafeStateDirectory, subscriptionPlans, unsafeScanRootReason, selectProviderFinancialHeadlineRecords, writeSafeStateText, loadDeadContext, sampleDeadContext, loadLocalAgentUsage, loadSampleUsageData, scanLocalUsageSignals, buildMissingSourcePrompts, confirmMapping, createProviderConnectorStub, createLocalFolderSourceRegistry, createScanAuditLog, fetchProviderUsageRecords, addApprovedSource, slugifySourceId } from "@agent-finops/core";
 import { generateActionPlanMarkdown, generateApplyArtifactMarkdown, generateDemoPackageMarkdown, generateHtmlReport, generateMarkdownReport, generatePlainEnglishSummary, generatePolicyConfigDraftMarkdown, generateReportCardCaption, generateReportCardSvg, generateVerificationPlanMarkdown, groupByDimensions } from "@agent-finops/report";
 export async function runCli(argv = process.argv.slice(2)) {
+    if (argv.includes("--version") || argv.includes("-v")) {
+        return ok(await cliVersion());
+    }
     if (argv.includes("--help") || argv.includes("-h") || argv[0] === "help") {
         return ok(helpText());
     }
@@ -91,7 +94,12 @@ async function quickstartCommand(args) {
     // Persona: --plan override wins; otherwise read the plans the coding agents
     // themselves persisted locally (read-only, whitelisted fields, no network).
     let detectedPlans;
-    if (args.plan) {
+    if (args.sample) {
+        // An explicit sample run must be deterministic and safe to record/share.
+        // Never mix the developer's real local plan into illustrative output.
+        detectedPlans = [];
+    }
+    else if (args.plan) {
         const override = planOverrideFromFlag(args.plan);
         if (!override) {
             return {
@@ -111,7 +119,12 @@ async function quickstartCommand(args) {
     }
     // Surface auto-detected credentials so the user knows their next 2-min step,
     // without ever printing a raw secret.
-    const detection = await detectLocalCredentials({ cwd: resolve(args.path) });
+    // Sample output is designed for demos, docs, and screenshots. Keeping local
+    // credential discovery out of that path prevents even redacted machine-
+    // specific hints from leaking into a recording.
+    const detection = args.sample
+        ? { credentials: [], scannedFiles: [] }
+        : await detectLocalCredentials({ cwd: resolve(args.path) });
     const nextSteps = quickstartNextSteps(mode, detection.credentials);
     // Dead-context cost, globalized across the user's whole Claude Code setup
     // (all projects' MCP + user-scope skills/agents/commands, vs. every
@@ -396,7 +409,7 @@ async function doctorCommand(args) {
             ? "your local agent logs (estimated at API-equivalent rates)"
             : "demo sample (illustrative)";
     const lines = [
-        "AI Spend Analyst doctor",
+        "aibill doctor",
         `node version: ${process.version}`,
         `cli version: ${await cliVersion()}`,
         "local-first mode: enabled (no cloud upload, no telemetry)",
@@ -434,7 +447,7 @@ async function resetCommand(args) {
         if (!isNodeError(error, "ENOENT"))
             throw error;
         return ok([
-            "AI Spend Analyst reset",
+            "aibill reset",
             `path: ${rootPath}`,
             "nothing to clear (no persisted spend state found)",
             "next run will re-read your real local agent logs (or demo sample if none)."
@@ -454,7 +467,7 @@ async function resetCommand(args) {
         }
     }
     return ok([
-        "AI Spend Analyst reset",
+        "aibill reset",
         `path: ${rootPath}`,
         removed.length > 0 ? `cleared: ${removed.join(", ")}` : "nothing to clear (no persisted spend state found)",
         "next run will re-read your real local agent logs (or demo sample if none)."
@@ -466,7 +479,7 @@ async function initCommand(args) {
     await mkdir(stateDir, { recursive: true });
     const registry = createLocalFolderSourceRegistry(rootPath);
     await writeJson(join(stateDir, "manifest.json"), {
-        product: "AI Spend Analyst Agent",
+        product: "aibill",
         mode: "local-first-demo",
         cloudUpload: false,
         cronJobsEnabled: false,
@@ -490,7 +503,7 @@ async function initCommand(args) {
         }
     ]));
     return ok([
-        "AI Spend Analyst Agent init",
+        "aibill init",
         `path: ${rootPath}`,
         "demo mode: local-first sample workflow",
         "cloud upload: disabled",
@@ -567,7 +580,7 @@ async function scanCommand(args) {
     await writeJson(join(stateDir, "discovery.json"), discovery);
     await writeJson(join(stateDir, "missing-sources.json"), missingSourcePrompts);
     const lines = [
-        "AI Spend Analyst Agent scan",
+        "aibill scan",
         `path: ${rootPath}`,
         "source registry: .ai-spend-agent/sources.json",
         "audit log: .ai-spend-agent/audit-log.json",
@@ -776,7 +789,7 @@ async function addSourceCommand(args) {
         detail: `${args.sourceType} approved via CLI add-source.`
     });
     return ok([
-        "AI Spend Analyst Agent add-source",
+        "aibill add-source",
         `source added: ${id}`,
         `type: ${args.sourceType}`,
         `path: ${sourcePath}`,
@@ -789,7 +802,7 @@ async function listSourcesCommand(args) {
     const stateDir = join(rootPath, ".ai-spend-agent");
     const registry = await readSourceRegistry(stateDir, rootPath);
     const lines = [
-        "AI Spend Analyst Agent sources",
+        "aibill sources",
         `approved sources: ${registry.approvedSources.length}`
     ];
     for (const source of registry.approvedSources) {
@@ -847,7 +860,7 @@ async function connectCommand(args) {
     const detection = await detectLocalCredentials({ cwd: rootPath });
     const detected = detection.credentials.find((credential) => credential.provider === provider);
     const lines = [
-        "AI Spend Analyst Agent connect",
+        "aibill connect",
         `connector stub: ${source.id}`,
         `provider: ${provider}`,
         `type: ${type}`,
@@ -980,7 +993,7 @@ async function syncProviderCommand(args) {
             detail: `${args.provider} provider connector synced ${result.records.length} evidence records with ${result.coverage} coverage. Auth reference only; no raw secrets stored.`
         });
         return ok([
-            "AI Spend Analyst Agent sync-provider",
+            "aibill sync-provider",
             `provider: ${result.provider}`,
             `source: ${result.source.id}`,
             `verification: ${result.source.verification}`,
@@ -1032,7 +1045,7 @@ async function confirmMappingCommand(args) {
         detail: `${args.provider} mapped to ${[args.team, args.project, args.workflow].filter(Boolean).join(" / ")}`
     });
     return ok([
-        "AI Spend Analyst Agent confirm-mapping",
+        "aibill confirm-mapping",
         `mapping confirmed: ${mapping.id}`,
         `provider: ${mapping.provider}`,
         `target: ${[mapping.team, mapping.project, mapping.workflow].filter(Boolean).join(" / ")}`,
@@ -1051,7 +1064,7 @@ async function reportCommand(args) {
         await writeLocalReportFile(htmlPath, generateHtmlReport(reportInput), stateDir);
         const artifactPaths = await writeApplyArtifacts(stateDir, reportInput);
         return ok([
-            "AI Spend Analyst Agent report",
+            "aibill report",
             `path: ${rootPath}`,
             `markdown: ${markdownPath}`,
             `html: ${htmlPath}`,
@@ -1136,7 +1149,7 @@ async function applyArtifactCommand(args) {
         // user can copy it right here instead of hunting for a file path.
         const codingPrompt = await readFile(artifactPaths.codingPrompt, "utf8");
         return ok([
-            "AI Spend Analyst Agent apply-artifact",
+            "aibill apply-artifact",
             `path: ${rootPath}`,
             `action plan: ${artifactPaths.actionPlan}`,
             `policy/config draft: ${artifactPaths.policyConfigDraft}`,
@@ -1618,13 +1631,13 @@ function helpText() {
         "aibill — your AI cost and usage evidence in one private view",
         "",
         "Run with no command for an instant, zero-key demo:",
-        "  ai-spend-agent                       Show where your AI money goes (sample/auto-detected data)",
+        "  ai-spend-agent                       Show available AI cost/value evidence (sample or local data)",
         "  ai-spend-agent --group-by agent      Drill down by source|model|client|project|agent|user|workspace|apiKey",
         "  ai-spend-agent --plan <id>           Declare your plan when auto-detection can't (claude-max-5x|claude-max-20x|claude-pro|chatgpt-plus|chatgpt-pro)",
         "",
-        "Connect your real spend (cost data is ADMIN/owner-gated):",
-        "  ai-spend-agent connect openai        Self-serve in ~2 min with an org-owner Admin key",
-        "  ai-spend-agent connect anthropic     Self-serve in ~2 min with an Admin key",
+        "Add official provider-reported cost (ADMIN/owner-gated):",
+        "  ai-spend-agent connect openai        Requires an org-owner Admin key",
+        "  ai-spend-agent connect anthropic     Requires an Admin key",
         "  ai-spend-agent connect cursor        Upgrade: requires a Cursor team-admin key (Business plan)",
         "  ai-spend-agent connect github-copilot Upgrade: requires a GitHub billing-admin token",
         "  ai-spend-agent sync-provider ...     Pull provider cost/usage evidence via a local env: reference (never a raw key)",
@@ -1634,6 +1647,7 @@ function helpText() {
         "    [--cycles N] [--group-by ...]  --cycles 0 runs forever; default 1 (cron-friendly)",
         "",
         "Other commands:",
+        "  --version, -v           Print the package version without reading local data",
         "  init [--path <dir>]     Initialize local state",
         "  doctor                  Launch-grade diagnostics: data mode, logs found, provider keys, warnings",
         "  reset [--path <dir>]    Clear persisted spend state (so sample state can't mask real logs)",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-spend-agent",
-  "version": "0.5.6",
-  "description": "Local-first financial intelligence CLI for Claude Code and Codex activity, provider-reported cost, attribution, runway, provenance, and Context Health.",
+  "version": "0.5.8",
+  "description": "Local-first financial accountability CLI for Claude Code and Codex work, cost evidence, attribution, runway, provenance, and Context Health.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -54,8 +54,8 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@agent-finops/core": "0.5.6",
-    "@agent-finops/report": "0.5.6",
+    "@agent-finops/core": "0.5.8",
+    "@agent-finops/report": "0.5.8",
     "yocto-spinner": "^1.2.0"
   }
 }