ai-spend-agent 0.2.1 → 0.3.0

package/dist/index.js

@@ -68,7 +68,9 @@ export async function runCli(argv = process.argv.slice(2)) {
 async function quickstartCommand(args) {
     const { records, mode, warnings } = await loadInstantReadData(args);
     const summary = analyzeSpend(records);
-    const groupBy = args.groupBy ?? "model";
+    // For real local-log users the by-project view is the flagship table
+    // ("which project burns my plan"); demo/connected keep by-model.
+    const groupBy = args.groupBy ?? (mode === "local-logs" ? "project" : "model");
     const color = args.noColor ? false : undefined;
     // Persona: --plan override wins; otherwise read the plans the coding agents
     // themselves persisted locally (read-only, whitelisted fields, no network).
@@ -124,7 +126,10 @@ async function quickstartCommand(args) {
         mode,
         nextSteps,
         deadContext,
-        detectedPlans
+        detectedPlans,
+        // An explicit --group-by is a drill-down question: answer with just the
+        // table + window instead of repeating the whole readout.
+        view: args.groupBy ? "breakdown" : "full"
     });
     const header = [`  ${dataModeBanner(mode)}`, ...warnings.map((warning) => `  ! ${warning}`)].join("\n");
     return ok(`${header}\n${summaryText}`);
@@ -172,7 +177,10 @@ async function loadInstantReadData(args) {
         codexSessionsDir: process.env.AI_SPEND_CODEX_LOGS_DIR
     }).catch(() => undefined);
     if (logs && logs.records.length > 0) {
-        if (persisted && persisted.records.length > 0 && persisted.mode !== "connected_provider") {
+        // Persisted local_logs state (written by report/apply-artifact) is the
+        // same data source we just re-read — superseding it silently is correct,
+        // not worth a scary "sample/legacy" warning.
+        if (persisted && persisted.records.length > 0 && persisted.mode !== "connected_provider" && persisted.mode !== "local_logs") {
             warnings.push("Ignored persisted sample/legacy state in .ai-spend-agent/spend.json — showing your real local agent logs. Run `ai-spend-agent reset` to clear it, or pass --ignore-state.");
         }
         return { records: logs.records, mode: "local-logs", warnings };
@@ -828,7 +836,12 @@ async function reportCommand(args) {
             `verification plan: ${artifactPaths.verificationPlan}`,
             `demo package: ${artifactPaths.demoPackage}`,
             `total spend: $${reportInput.summary.totalUsd.toFixed(2)}`,
-            "privacy: local files only; no cloud upload performed"
+            "privacy: local files only; no cloud upload performed",
+            "",
+            "next:",
+            `  open ${htmlPath}       view the full report in your browser`,
+            `  less ${markdownPath}       read it in the terminal`,
+            "  npx ai-spend-agent apply-artifact       print the paste-ready coding-agent prompt"
         ].join("\n"));
     }
     catch (error) {
@@ -882,15 +895,21 @@ async function applyArtifactCommand(args) {
     try {
         const reportInput = await buildReportInput(stateDir, rootPath);
         const artifactPaths = await writeApplyArtifacts(stateDir, reportInput);
+        // The prompt IS the product of this command — print it so a terminal
+        // 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",
             `path: ${rootPath}`,
-            `coding prompt: ${artifactPaths.codingPrompt}`,
             `action plan: ${artifactPaths.actionPlan}`,
             `policy/config draft: ${artifactPaths.policyConfigDraft}`,
             `verification plan: ${artifactPaths.verificationPlan}`,
             `demo package: ${artifactPaths.demoPackage}`,
-            "safety: generated artifacts only; no external systems changed"
+            "safety: generated artifacts only; no external systems changed",
+            "",
+            `──── copy everything below into Claude Code / Codex (also saved at ${artifactPaths.codingPrompt}) ────`,
+            "",
+            codingPrompt.trimEnd()
         ].join("\n"));
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-spend-agent",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Your AI spend in one view, in 90 seconds — local-first CLI for OpenAI, Anthropic, Cursor, Copilot + Claude Code/Codex session logs, with a ranked savings cut list, and flags the tools your agent loads but never uses (dead context).",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,8 +49,8 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@agent-finops/core": "0.2.1",
-    "@agent-finops/report": "0.2.1",
+    "@agent-finops/core": "0.3.0",
+    "@agent-finops/report": "0.3.0",
     "yocto-spinner": "^1.2.0"
   }
 }