@hasna/economy 0.3.6 → 0.3.7

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All notable changes to this repository are tracked here. This project follows semantic versioning for published npm packages when practical.
 
+## @hasna/economy 0.3.7 - 2026-07-24
+
+Reconciliation release: `main` had diverged from the published npm line. The `0.3.x`
+code (`0.3.0`-`0.3.6`, the unified `Store` refactor plus the cloud/self_hosted service
+surfaces) shipped to npm from `feature`-line commits and was never merged back, while
+`main` (`0.2.52`) carried two merged-but-unpublished features. This release is a real
+three-way merge that keeps **both** histories.
+
+- Merged the published `v0.3.6` tag (`4f76834`) into `main`, preserving both parents.
+- Forward-ported **compact CLI/MCP output defaults** (#4) onto the `Store` surfaces:
+  `--limit`/`--verbose`/`--json` on `breakdown`, `budget list`, `project list`,
+  `pricing list`, `goal list`, `goal status`, `usage`, `subscriptions list`, `fleet`;
+  `limit`/`verbose`/`json` params on the `get_model_breakdown`, `get_project_breakdown`,
+  `get_account_breakdown`, `get_budget_status`, `get_pricing`, `get_goals`,
+  `list_machines`, `get_session_detail`, `get_usage`, `get_savings`, `sync` and
+  `set_subscription` MCP tools.
+- Forward-ported **token cost centers** (#5) onto the `Store` architecture: added
+  `EconomyStore.costCenterBreakdown()` (local SQLite + cloud `/v1` transports),
+  `cost_center_id` on `BudgetInput`, and the `breakdown --by cost-center|loop|app|repo`
+  CLI dimension plus the `get_cost_center_breakdown` MCP tool. The cloud transport
+  drops rows the API did not attribute to a cost center, so an un-upgraded serve
+  reports "no cost-center usage" instead of mislabelling model rows.
+- Dropped the main-only code the `0.3.x` refactor deliberately removed as the
+  forbidden DSN-on-client pattern: `src/lib/peer-sync.ts`, `src/lib/cloud-sync.ts`
+  (and with it the `cloud schedule install|status|remove` commands) and
+  `src/lib/fleet-sync.ts`. The MCP `sync` tool no longer reports `cloud_pushed` /
+  `cloud_pulled` because `SyncAllResult` no longer carries them.
+- Replaced the `@hasna/agent-registry` and `@hasna/mcp-harness` `file:../open-*`
+  sibling pins with the registry ranges (`^0.1.0`) that every published tarball has
+  carried anyway. `bun install`, `tsc` and `src/mcp/http.test.ts` no longer require
+  unpublished sibling checkouts, and `package.json` now matches what actually ships.
+- Bumped strictly above the published `0.3.6` latest. (The `v0.3.6` tag commit itself
+  carried `package.json` version `0.3.5`; the `0.3.6` publish bumped the registry
+  without a follow-up commit.)
+
 ## @hasna/economy 0.2.43 - 2026-07-06
 
 - Added the self_hosted service surface: `economy-serve` foundation probes (`GET /health`, `/ready`, `/version` -> `{ status, version, mode }`) and a versioned `/v1` API covering summaries, sessions, breakdowns, budgets, goals, pricing, subscriptions, billing, and sync.

package/README.md

@@ -8,9 +8,9 @@ AI coding cost tracker for Claude Code, Takumi, Codex, Gemini, OpenCode, Cursor,
 ## Features
 
 - Ingests local Claude Code, Takumi, Codex, Gemini, OpenCode, Cursor, Pi, and Hermes usage.
-- Tracks sessions, requests, projects, machines, models, cache tokens, budgets, goals, and provider billing.
+- Tracks sessions, requests, projects, machines, models, cache tokens, cost centers, budgets, goals, and provider billing.
 - Attributes usage to `@hasna/accounts` profiles when agents run under managed account/profile config dirs.
-- Breaks down API-equivalent, metered API, subscription-included, estimated, and unknown cost by account and coding agent.
+- Breaks down API-equivalent, metered API, subscription-included, estimated, and unknown cost by account, coding agent, and cost center.
 - Seeds editable model pricing with input, output, cache-read, 5-minute cache-write, 1-hour cache-write, and context-cache storage rates.
 - Handles tiered pricing such as Gemini long-prompt rates and OpenAI long-context rates.
 - Reconciles estimates against Anthropic, OpenAI, and Gemini billing sources.
@@ -39,6 +39,26 @@ Open the dashboard with:
 economy dashboard --port 3456
 ```
 
+## CLI Output Defaults
+
+Economy CLI commands are compact by default so agent terminals do not fill their context with full records. High-cardinality list and status commands show essential columns, cap row counts, and print a hint when more rows are available.
+
+Use explicit detail paths when you need more:
+
+```bash
+economy sessions --limit 50
+economy session <id> --verbose
+economy accounts month --json
+economy usage month --verbose
+economy todos list --limit 20
+economy todos list --verbose
+economy todos show 9.7
+```
+
+`--json` remains the machine-readable path for commands that support it. Human output may truncate rows or long text; use `--json`, `--verbose`, `--limit`, or a `show`/detail command for complete data.
+
+Status subcommands follow the same rule. For example, `economy goal status` prints a compact human summary by default and `economy goal status --limit 5` or `--verbose` controls how many goals are listed.
+
 ## Agent Integrations
 
 Use the MCP server for live cost context inside coding agents:
@@ -71,7 +91,7 @@ Gemini settings:
 }
 ```
 
-The MCP server exposes read tools for summaries, sessions, machines, pricing, daily spend, budgets, goals, provider billing, usage snapshots, savings, project/account/agent breakdowns, and subscriptions. It also exposes mutation tools for budgets, pricing rows, goals, and subscriptions so coding agents can manage Economy data through the same validated surface as the CLI and REST API.
+The MCP server exposes read tools for summaries, sessions, machines, pricing, daily spend, budgets, goals, provider billing, usage snapshots, savings, project/account/agent/cost-center breakdowns, and subscriptions. MCP tools are compact by default for agent context safety; high-cardinality tools accept `limit`, `verbose`, or `json=true` where raw structured output is useful. It also exposes mutation tools for budgets, pricing rows, goals, and subscriptions so coding agents can manage Economy data through the same validated surface as the CLI and REST API.
 
 ## Ingest
 
@@ -92,8 +112,11 @@ economy sync --opencode
 economy sync --cursor
 economy sync --pi
 economy sync --hermes
+economy sync --loops
 ```
 
+`economy sync --loops` reads `~/.hasna/loops/loops.db` in read-only mode and imports OpenLoops orchestration/judge `goal_runs.tokens_used` into `loop:*` cost centers. It intentionally does not ingest dispatched coding-agent work from loops; heavy agent spend remains captured by the existing per-agent ingesters and can be analyzed alongside loop cost centers through account/profile attribution.
+
 Useful repair options:
 
 ```bash
@@ -116,6 +139,26 @@ economy breakdown --by account
 
 Account breakdowns report `api_equivalent_usd` for the API list-price value of the usage, plus `billable_usd`/`metered_api_usd` for known direct API spend and `subscription_included_usd` for usage covered by a subscription.
 
+Cost-center breakdowns group spend across loops, apps, repos, services, and teams:
+
+```bash
+economy breakdown --by cost-center
+economy breakdown --by loop
+economy breakdown --by app
+economy breakdown --by repo
+```
+
+Apps and services can report usage through the local `economy-otel` sidecar:
+
+```bash
+economy-otel --port 4318
+curl -X POST http://127.0.0.1:4318/ingest \
+  -H 'content-type: application/json' \
+  -d '{"source":"app","cost_center":"alumia","cost_center_kind":"app","project_path":"/workspace/alumia","model":"gpt-5-mini","cost_usd":0.12,"input_tokens":1200,"output_tokens":300}'
+```
+
+Accepted `/ingest` attribution fields include `cost_center`, `cost_center_kind`, `cost_center_id`, `attribution_tag`, `project_path`, `repo`, `account_key`, `account_tool`, `account_name`, `account_email`, and explicit `cost_usd`.
+
 Subscription plans can be configured locally and are used by savings calculations:
 
 ```bash
@@ -164,6 +207,7 @@ Gemini billing export files may be JSON arrays, JSON objects with `rows`, JSONL,
 ```bash
 economy budget set --period monthly --limit 50 --alert 80
 economy budget set --agent codex --period weekly --limit 25 --alert 70
+economy budget set --cost-center loop:fleet-evaluator --period weekly --limit 10
 economy budget list
 economy goal set --period month --limit 40
 economy goal set --agent gemini --period week --limit 15
@@ -172,7 +216,7 @@ economy config set webhook-url https://example.com/economy-webhook
 economy config webhook-test
 ```
 
-Budgets and goals can be global, project-scoped with `--project`, agent-scoped with `--agent`, or both. Valid agent scopes are `claude`, `takumi`, `codex`, `gemini`, `opencode`, `cursor`, `pi`, and `hermes`.
+Budgets can be global, project-scoped with `--project`, agent-scoped with `--agent`, cost-center scoped with `--cost-center`, or combined. Goals can be global, project-scoped, agent-scoped, or both. Valid agent scopes are `claude`, `takumi`, `codex`, `gemini`, `opencode`, `cursor`, `pi`, and `hermes`.
 
 Budget webhooks fire after sync when the alert threshold is crossed. Failed webhook deliveries are not marked as fired, so the next sync can retry them.
 
@@ -193,6 +237,8 @@ Common endpoints:
 - `GET /api/models`
 - `GET /api/projects?period=month`
 - `GET /api/breakdown?by=agent&period=month`
+- `GET /api/breakdown?by=cost-center&period=month`
+- `GET /api/breakdown?by=loop&period=month`
 - `GET /api/accounts?period=month`
 - `GET /api/usage?period=month`
 - `GET /api/savings?period=month`

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

@@ -1 +1 @@
-{"version":3,"file":"extras.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/extras.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsCnC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmR/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B5D"}
+{"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/todos.d.ts

@@ -20,6 +20,9 @@ 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;

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

@@ -1 +1 @@
-{"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;AAkBD,wBAAgB,cAAc,IAAI,IAAI,CAkCrC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAyBzC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAyBlF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAmBlD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsC3D"}
+{"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"}