@hasna/economy 0.3.8 → 0.3.9

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to this repository are tracked here. This project follows semantic versioning for published npm packages when practical.
 
+## @hasna/economy 0.3.9 - 2026-08-04
+
+Release-only bump. Four PRs merged after `0.3.8` and were never published, because
+this repo has no workflow that runs `npm publish` — the registry sat at `0.3.8`
+while `main` accumulated a contracts migration, a data-correctness fix and a
+metadata correction.
+
+**Breaking for server operators.** `HASNA_ECONOMY_STORAGE_MODE` (and the
+`ECONOMY_STORAGE_MODE` alias) are retired for server backend selection. They are
+now *rejected at startup with a migration hint* rather than normalized, so a
+half-migrated deployment fails loudly instead of quietly serving the wrong store.
+The server data backend is `sqlite | postgresql`, selected by the presence of
+`HASNA_ECONOMY_DATABASE_URL` alone. If you set `HASNA_ECONOMY_STORAGE_MODE=cloud`
+to reach Postgres, unset it and rely on the database URL.
+
+- **#27** `fix(client)` — hard-fail a half-applied cloud flip instead of silently
+  serving local data. An `API_URL` set *without* an `API_KEY` previously resolved
+  to `local` with no warning, byte-identical to an unconfigured host: the CLI
+  served the local SQLite store while the operator had pointed it at the cloud
+  API — a different dataset rendered as plausible spend numbers. It now reports
+  `misconfigured` and refuses. An unconfigured machine (neither variable set)
+  stays silently local; that negative control is covered by a test.
+- **#28** `fix(contracts)` — migrate `storage.mode` to `storage.backend` for
+  contract kit `0.9.0`; declare `hosting` and `serviceSurfaces` in
+  `hasna.contract.json`. Bumps `@hasna/contracts` `^0.4.2` -> `^0.9.0`.
+- **#29** `fix(server)` — make the runtime speak the `0.9.0` backend vocabulary it
+  declares; `isCloudMode()` is replaced by `resolveEconomyServerBackend()` and
+  `isPostgresBackend()` (both internal — neither was ever exported from the
+  package root).
+- **#30** `fix(package)` — describe Gemini CLI support as legacy rather than
+  active, and name the Gemini API billing ingest separately. Google retired the
+  Gemini CLI on 2026-06-18.
+
 ## @hasna/economy 0.3.7 - 2026-07-24
 
 Reconciliation release: `main` had diverged from the published npm line. The `0.3.x`

package/docs/configuration.md

@@ -62,7 +62,7 @@ The server serves `dashboard/dist` and falls back to its `index.html` for non-AP
 
 ## Self-hosted server
 
-The server switches to direct Postgres mode when `HASNA_ECONOMY_STORAGE_MODE=cloud` or when a DSN is present:
+The server backend follows the database URL alone — `postgresql` when one of these is set, `sqlite` when none is:
 
 ```text
 HASNA_ECONOMY_DATABASE_URL
@@ -70,7 +70,9 @@ ECONOMY_DATABASE_URL
 DATABASE_URL
 ```
 
-Apply migrations with `economy-serve migrate`. `ECONOMY_PG_POOL_MAX` defaults to 5. A non-loopback cloud server also requires one of `HASNA_ECONOMY_API_SIGNING_KEY`, `HASNA_API_SIGNING_KEY`, or `API_KEY_SIGNING_SECRET`; API keys are then verified by `@hasna/contracts`. The signing secret belongs only on the server.
+`HASNA_ECONOMY_STORAGE_MODE` (and `HASNA_ECONOMY_MODE`, `ECONOMY_STORAGE_MODE`, `ECONOMY_MODE`) no longer selects a backend: the server refuses to start and prints a migration hint. Delete it and set a DSN instead. This is server-only — the CLI/MCP client still reads the mode variable described above.
+
+Apply migrations with `economy-serve migrate`. `ECONOMY_PG_POOL_MAX` defaults to 5. A non-loopback server also requires one of `HASNA_ECONOMY_API_SIGNING_KEY`, `HASNA_API_SIGNING_KEY`, or `API_KEY_SIGNING_SECRET`; API keys are then verified by `@hasna/contracts`. The signing secret belongs only on the server.
 
 See [REST API authentication](rest-api.md#authentication) for request headers and open probes.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hasna/economy",
-  "version": "0.3.8",
-  "description": "AI coding cost tracker — CLI + MCP server + REST API + web dashboard for Claude Code, Codex, Gemini, OpenCode, Cursor, Pi, and Hermes",
+  "version": "0.3.9",
+  "description": "AI coding cost tracker — CLI + MCP server + REST API + web dashboard for Claude Code, Codex, OpenCode, Cursor, Pi, and Hermes, with legacy Gemini CLI session and Gemini API billing ingestion",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hasna/economy.git"
@@ -72,7 +72,7 @@
   "dependencies": {
     "@hasna/accounts": "0.2.23",
     "@hasna/agent-registry": "^0.1.0",
-    "@hasna/contracts": "^0.4.2",
+    "@hasna/contracts": "^0.9.0",
     "@hasna/events": "^0.1.7",
     "@hasna/mcp-harness": "^0.1.0",
     "@hasna/projects": "0.1.95",

package/dist/cli/brains.d.ts

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

package/dist/cli/brains.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"brains.d.ts","sourceRoot":"","sources":["../../src/cli/brains.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoL5D"}

package/dist/cli/commands/brief.d.ts

@@ -1,11 +0,0 @@
-import { Command } from 'commander';
-import { formatAge } from '../../lib/brief.js';
-import type { EconomyBrief } from '../../lib/brief.js';
-export type { EconomyBrief } from '../../lib/brief.js';
-interface BriefCommandDeps {
-    beforeRead?: () => void | Promise<void>;
-}
-export declare function renderBriefText(brief: EconomyBrief): string;
-export { formatAge };
-export declare function registerBriefCommand(program: Command, deps?: BriefCommandDeps): void;
-//# sourceMappingURL=brief.d.ts.map

package/dist/cli/commands/brief.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/brief.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AA4CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAyE3D;AAGD,OAAO,EAAE,SAAS,EAAE,CAAA;AAEpB,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB,GAAG,IAAI,CAgCxF"}

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

@@ -1,2 +0,0 @@
-export declare function printCompletion(shell: string): void;
-//# sourceMappingURL=completion.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/completion.ts"],"names":[],"mappings":"AA0FA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAenD"}

package/dist/cli/commands/extras.d.ts

@@ -1,4 +0,0 @@
-import { Command } from 'commander';
-export declare function registerExtendedCommands(program: Command): void;
-export declare function registerFleetCommands(program: Command): void;
-//# sourceMappingURL=extras.d.ts.map

package/dist/cli/commands/extras.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extras.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/extras.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgDnC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyS/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyC5D"}

package/dist/cli/commands/menubar.d.ts

@@ -1,7 +0,0 @@
-export declare function menubarInstall(opts: {
-    force?: boolean;
-}): Promise<void>;
-export declare function menubarUninstall(): void;
-export declare function menubarStart(): void;
-export declare function menubarStop(): void;
-//# sourceMappingURL=menubar.d.ts.map

package/dist/cli/commands/menubar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"menubar.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/menubar.ts"],"names":[],"mappings":"AA0BA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0E7E;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAcvC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED,wBAAgB,WAAW,IAAI,IAAI,CAWlC"}

package/dist/cli/commands/notification.d.ts

@@ -1,8 +0,0 @@
-type ExecFile = (file: string, args: string[], options: {
-    stdio: 'ignore';
-}) => unknown;
-export declare function appleScriptString(value: string): string;
-export declare function notificationScript(title: string, body: string): string;
-export declare function sendNotification(title: string, body: string, execFile?: ExecFile): void;
-export {};
-//# sourceMappingURL=notification.d.ts.map

package/dist/cli/commands/notification.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/notification.ts"],"names":[],"mappings":"AAEA,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,KAAK,OAAO,CAAA;AAEvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAuB,GAAG,IAAI,CAIrG"}

package/dist/cli/commands/todos.d.ts

@@ -1,29 +0,0 @@
-import { Command } from 'commander';
-export type TodoStatus = 'pending' | 'in_progress' | 'done';
-export interface TodoTask {
-    id: string;
-    title: string;
-    status: TodoStatus;
-    deps?: string[];
-}
-export interface TodoPhase {
-    id: string;
-    title: string;
-    summary: string;
-    tasks: TodoTask[];
-}
-export declare const ROADMAP_VERSION = "2026-05-23-b";
-export declare const ROADMAP_GOAL = "Unified AI spend across 4+ machines: auto-sync local telemetry, track subscription usage & savings, ingest all major coding agents, and expose proactive CLI/MCP intelligence \u2014 not just per-machine API cost estimates.";
-export declare const ROADMAP_PHASES: TodoPhase[];
-export declare function printTodosHelp(): void;
-export declare function printTodosOverview(): void;
-export declare function printTodosList(opts: {
-    phase?: string;
-    status?: TodoStatus;
-    limit?: number;
-    verbose?: boolean;
-    json?: boolean;
-}): void;
-export declare function printTodoShow(taskId: string): void;
-export declare function registerTodosCommand(program: Command): void;
-//# sourceMappingURL=todos.d.ts.map

package/dist/cli/commands/todos.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"todos.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/todos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAA;AAE3D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAC7C,eAAO,MAAM,YAAY,kOACmM,CAAA;AAE5N,eAAO,MAAM,cAAc,EAAE,SAAS,EAuqBrC,CAAA;AAgDD,wBAAgB,cAAc,IAAI,IAAI,CAoCrC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CA0BzC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CA+DrI;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAmBlD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+C3D"}

package/dist/cli/commands/tui.d.ts

@@ -1,26 +0,0 @@
-import { type EconomyStore } from '../../lib/store/index.js';
-import type { SavingsSummary } from '../../lib/savings.js';
-import type { CostSummary } from '../../types/index.js';
-/** Everything the status surfaces need, gathered through the Store (never sqlite
- * directly) so local and self_hosted/cloud render the same numbers. */
-export interface StatusData {
-    today: CostSummary;
-    week: CostSummary;
-    month: CostSummary;
-    savings: SavingsSummary;
-    machineCount: number;
-    topAgent: string;
-    quota: string | null;
-    transport: EconomyStore['transport'];
-}
-/** Collect the status snapshot from the active Store transport. */
-export declare function gatherStatusData(store?: EconomyStore): Promise<StatusData>;
-export declare function buildStatusLine(data: StatusData): string;
-export declare function buildWaybarJson(data: StatusData): Record<string, unknown>;
-export declare function printStatusLine(): Promise<void>;
-export declare function printWaybarJson(): Promise<void>;
-export declare function runTui(opts: {
-    watch?: boolean;
-    interval?: number;
-}): Promise<void>;
-//# sourceMappingURL=tui.d.ts.map

package/dist/cli/commands/tui.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tui.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAkB,WAAW,EAAiB,MAAM,sBAAsB,CAAA;AAMtF;uEACuE;AACvE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,cAAc,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;CACrC;AAmBD,mEAAmE;AACnE,wBAAsB,gBAAgB,CAAC,KAAK,GAAE,YAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB5F;AAQD,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAUxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzE;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxF"}

package/dist/cli/commands/watch.d.ts

@@ -1,10 +0,0 @@
-import type { Agent } from '../../types/index.js';
-interface WatchOptions {
-    interval: number;
-    agent?: Agent;
-    notify?: number;
-    daemon?: boolean;
-}
-export declare function watchCosts(opts: WatchOptions): Promise<void>;
-export {};
-//# sourceMappingURL=watch.d.ts.map

package/dist/cli/commands/watch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAGjD,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AA4BD,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHlE"}

package/dist/cli/index.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env bun
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}