ai-spend-agent 0.2.0 → 0.2.2

package/dist/index.js

@@ -124,7 +124,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 +175,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,14 +834,19 @@ 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) {
         return {
             exitCode: 1,
             stdout: "",
-            stderr: `No local spend state found at ${stateDir}. Run scan --sample --path <dir> first. ${error instanceof Error ? error.message : ""}`
+            stderr: `Couldn't build a report: ${error instanceof Error ? error.message : String(error)}`
         };
     }
 }
@@ -882,30 +893,56 @@ 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) {
         return {
             exitCode: 1,
             stdout: "",
-            stderr: `No local spend state found at ${stateDir}. Run scan --sample --path <dir> first. ${error instanceof Error ? error.message : ""}`
+            stderr: `Couldn't build apply artifacts: ${error instanceof Error ? error.message : String(error)}`
         };
     }
 }
 async function buildReportInput(stateDir, rootPath) {
-    const [spendState, discovery, mappings, sourceRegistry, missingSourcePrompts, confirmedMappings, providerRecordsState] = await Promise.all([
-        readJson(join(stateDir, "spend.json")),
-        readJson(join(stateDir, "discovery.json")),
-        readJson(join(stateDir, "mappings.json")),
+    let spendState = await readOptionalJson(join(stateDir, "spend.json"), undefined);
+    let mappings = await readOptionalJson(join(stateDir, "mappings.json"), undefined);
+    // The quickstart intentionally writes nothing — so `report`/`apply-artifact`
+    // right after a first run must fall back to the SAME live local-log read
+    // (never sample data), then persist it so subsequent runs are consistent.
+    if (!spendState?.summary || !spendState.records || spendState.records.length === 0) {
+        const logs = await loadLocalAgentUsage({
+            claudeProjectsDir: process.env.AI_SPEND_CLAUDE_LOGS_DIR,
+            codexSessionsDir: process.env.AI_SPEND_CODEX_LOGS_DIR
+        }).catch(() => undefined);
+        if (!logs || logs.records.length === 0) {
+            throw new Error("no persisted spend state and no local Claude Code/Codex logs found. " +
+                "Run `npx ai-spend-agent` first (or `npx ai-spend-agent scan --sample --path <dir>` for a demo-data report).");
+        }
+        const records = logs.records;
+        const summary = analyzeSpend(records);
+        const liveMappings = attributeUsageRecords(records);
+        await mkdir(stateDir, { recursive: true });
+        await writeLocalSpendState(stateDir, records, summary, liveMappings, "local_logs");
+        spendState = { summary, records, mode: "local_logs" };
+        mappings = liveMappings;
+    }
+    const [discovery, sourceRegistry, missingSourcePrompts, confirmedMappings, providerRecordsState] = await Promise.all([
+        readOptionalJson(join(stateDir, "discovery.json"), emptyDiscovery(rootPath)),
         readSourceRegistry(stateDir, rootPath),
         readOptionalJson(join(stateDir, "missing-sources.json"), []),
         readConfirmedMappings(stateDir),
@@ -918,7 +955,7 @@ async function buildReportInput(stateDir, rootPath) {
         allRecords: spendState.records ?? [],
         dataMode: spendState.mode,
         discovery,
-        mappings,
+        mappings: mappings ?? [],
         sourceRegistry,
         missingSourcePrompts,
         confirmedMappings,
@@ -926,6 +963,17 @@ async function buildReportInput(stateDir, rootPath) {
         providerQa: providerRecordsState.qa ? [providerRecordsState.qa] : []
     };
 }
+function emptyDiscovery(rootPath) {
+    return {
+        rootPath,
+        scannedFiles: 0,
+        skippedDirectories: [],
+        unreadablePaths: [],
+        signals: [],
+        secretsDetected: [],
+        redactedEvidence: []
+    };
+}
 async function writeApplyArtifacts(stateDir, reportInput) {
     const paths = {
         codingPrompt: join(stateDir, "ai-spend-coding-agent-prompt.md"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-spend-agent",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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.0",
-    "@agent-finops/report": "0.2.0",
+    "@agent-finops/core": "0.2.2",
+    "@agent-finops/report": "0.2.2",
     "yocto-spinner": "^1.2.0"
   }
 }