@hasna/economy 0.3.7 → 0.3.8

package/dist/server/index.js

@@ -17,6 +17,62 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
+// src/db/sqlite-adapter.ts
+import { Database } from "bun:sqlite";
+
+class SqliteAdapter {
+  db;
+  constructor(path) {
+    this.db = new Database(path, { create: true });
+    this.db.exec("PRAGMA journal_mode=WAL");
+    this.db.exec("PRAGMA foreign_keys=ON");
+  }
+  run(sql, ...params) {
+    const result = this.db.prepare(sql).run(...params);
+    return { changes: result.changes, lastInsertRowid: result.lastInsertRowid };
+  }
+  get(sql, ...params) {
+    return this.db.prepare(sql).get(...params);
+  }
+  all(sql, ...params) {
+    return this.db.prepare(sql).all(...params);
+  }
+  exec(sql) {
+    this.db.exec(sql);
+  }
+  query(sql) {
+    return this.db.query(sql);
+  }
+  prepare(sql) {
+    const stmt = this.db.prepare(sql);
+    return {
+      run(...params) {
+        const r = stmt.run(...params);
+        return { changes: r.changes, lastInsertRowid: r.lastInsertRowid };
+      },
+      get(...params) {
+        return stmt.get(...params);
+      },
+      all(...params) {
+        return stmt.all(...params);
+      },
+      finalize() {
+        stmt.finalize();
+      }
+    };
+  }
+  close() {
+    this.db.close();
+  }
+  transaction(fn) {
+    return this.db.transaction(fn)();
+  }
+  get raw() {
+    return this.db;
+  }
+}
+var init_sqlite_adapter = () => {};
+
 // src/lib/pricing.ts
 var exports_pricing = {};
 __export(exports_pricing, {
@@ -535,7 +591,6 @@ var init_pricing = __esm(() => {
 });
 
 // src/db/database.ts
-import { SqliteAdapter as Database } from "@hasna/cloud";
 import { execFileSync } from "child_process";
 import { copyFileSync, existsSync, mkdirSync, readdirSync, statSync } from "fs";
 import { hostname, platform } from "os";
@@ -628,7 +683,7 @@ function openDatabase(dbPath, skipSeed = false) {
       mkdirSync(dir, { recursive: true });
   }
   const db = withSqliteBusyRetry(() => {
-    const opened = new Database(path);
+    const opened = new SqliteAdapter(path);
     try {
       opened.exec("PRAGMA busy_timeout = 10000");
       opened.exec("PRAGMA journal_mode = WAL");
@@ -1216,9 +1271,12 @@ function labelForPath(projectPath, projectName) {
 function groupKeyForPath(projectPath, projectName) {
   return labelForPath(projectPath, projectName).trim().toLowerCase();
 }
-function queryProjectBreakdown(db, period = "all", machine) {
-  const requestWhere = requestPeriodWhere(period);
-  const sessionWhere = sessionPeriodWhere(period);
+function laterTimestamp(current, candidate) {
+  if (!candidate)
+    return current;
+  return candidate > current ? candidate : current;
+}
+function queryProjectBreakdownScoped(db, requestWhere, sessionWhere, requestScopeParams = [], sessionScopeParams = [], machine) {
   const sessionMachineClause = machine ? " AND (machine_id = ? OR id IN (SELECT DISTINCT session_id FROM requests WHERE machine_id = ?))" : "";
   const requestMachineClause = machine ? " AND machine_id = ?" : "";
   const sessionMachineParams = machine ? [machine, machine] : [];
@@ -1226,67 +1284,89 @@ function queryProjectBreakdown(db, period = "all", machine) {
   const sessionOnlyMachineClause = machine ? " AND machine_id = ?" : "";
   const sessionOnlyMachineParams = machine ? [machine] : [];
   const sessions = db.prepare(`
-    SELECT id, project_path, project_name, total_cost_usd, started_at
+    SELECT id, project_path, project_name
     FROM sessions
     WHERE (project_path != '' OR project_name != '')${sessionMachineClause}
   `).all(...sessionMachineParams);
   const groups = new Map;
+  const groupKeyBySession = new Map;
   for (const s of sessions) {
     const label = labelForPath(s.project_path, s.project_name);
     if (!label)
       continue;
     const key = groupKeyForPath(s.project_path, s.project_name);
-    const g = groups.get(key) ?? { label, sessionIds: [], samplePath: s.project_path };
-    g.sessionIds.push(s.id);
+    const g = groups.get(key) ?? { label, samplePath: s.project_path, sessions: 0, requests: 0, total_tokens: 0, cost_usd: 0, last_active: "" };
     if (!g.samplePath)
       g.samplePath = s.project_path;
     groups.set(key, g);
+    groupKeyBySession.set(s.id, key);
+  }
+  const groupFor = (sessionId) => {
+    const key = groupKeyBySession.get(sessionId);
+    return key === undefined ? undefined : groups.get(key);
+  };
+  const requestRows = db.prepare(`
+    SELECT session_id,
+           COUNT(*) as requests,
+           COALESCE(SUM(cost_usd), 0) as cost_usd,
+           COALESCE(SUM(input_tokens + output_tokens + cache_read_tokens + cache_create_tokens), 0) as total_tokens,
+           MAX(timestamp) as last_active
+    FROM requests
+    WHERE ${requestWhere}${requestMachineClause}
+    GROUP BY session_id
+  `).all(...requestScopeParams, ...requestMachineParams);
+  for (const row of requestRows) {
+    const g = groupFor(row.session_id);
+    if (!g)
+      continue;
+    g.sessions += 1;
+    g.requests += row.requests;
+    g.cost_usd += row.cost_usd;
+    g.total_tokens += row.total_tokens;
+    g.last_active = laterTimestamp(g.last_active, row.last_active);
+  }
+  const sessionsWithRequests = new Set(db.prepare(`SELECT DISTINCT session_id FROM requests`).all().map((row) => row.session_id));
+  const sessionOnlyRows = db.prepare(`
+    SELECT id,
+           COALESCE(request_count, 0) as request_count,
+           COALESCE(total_tokens, 0) as total_tokens,
+           COALESCE(total_cost_usd, 0) as total_cost_usd,
+           started_at
+    FROM sessions
+    WHERE ${sessionWhere}${sessionOnlyMachineClause}
+  `).all(...sessionScopeParams, ...sessionOnlyMachineParams);
+  for (const row of sessionOnlyRows) {
+    if (sessionsWithRequests.has(row.id))
+      continue;
+    const g = groupFor(row.id);
+    if (!g)
+      continue;
+    g.sessions += 1;
+    g.requests += row.request_count;
+    g.total_tokens += row.total_tokens;
+    g.cost_usd += row.total_cost_usd;
+    g.last_active = laterTimestamp(g.last_active, row.started_at);
   }
   const result = [];
   for (const g of groups.values()) {
-    const placeholders = g.sessionIds.map(() => "?").join(",");
-    const reqStats = placeholders.length ? db.prepare(`
-          SELECT
-            COUNT(DISTINCT session_id) as sessions,
-            COUNT(*) as requests,
-            COALESCE(SUM(cost_usd), 0) as cost_usd,
-            COALESCE(SUM(input_tokens + output_tokens + cache_read_tokens + cache_create_tokens), 0) as total_tokens,
-            MAX(timestamp) as last_active
-          FROM requests
-          WHERE session_id IN (${placeholders})
-            AND ${requestWhere}
-            ${requestMachineClause}
-        `).get(...g.sessionIds, ...requestMachineParams) : { sessions: 0, requests: 0, cost_usd: 0, total_tokens: 0, last_active: null };
-    const sessionOnlyStats = placeholders.length ? db.prepare(`
-          SELECT
-            COUNT(*) as sessions,
-            COALESCE(SUM(request_count), 0) as requests,
-            COALESCE(SUM(total_tokens), 0) as total_tokens,
-            COALESCE(SUM(total_cost_usd), 0) as cost_usd,
-            MAX(started_at) as last_active
-          FROM sessions
-          WHERE id IN (${placeholders})
-            AND ${sessionWhere}
-            ${sessionOnlyMachineClause}
-            AND id NOT IN (SELECT DISTINCT session_id FROM requests)
-        `).get(...g.sessionIds, ...sessionOnlyMachineParams) : { sessions: 0, requests: 0, total_tokens: 0, cost_usd: 0, last_active: null };
-    const totalSessions = reqStats.sessions + sessionOnlyStats.sessions;
-    if (totalSessions === 0)
+    if (g.sessions === 0)
       continue;
-    const lastActive = [reqStats.last_active, sessionOnlyStats.last_active].filter(Boolean).sort().at(-1) ?? "";
     result.push({
       project_path: g.samplePath,
       project_name: g.label,
-      sessions: totalSessions,
-      requests: reqStats.requests + sessionOnlyStats.requests,
-      total_tokens: reqStats.total_tokens + sessionOnlyStats.total_tokens,
-      cost_usd: reqStats.cost_usd + sessionOnlyStats.cost_usd,
-      last_active: lastActive
+      sessions: g.sessions,
+      requests: g.requests,
+      total_tokens: g.total_tokens,
+      cost_usd: g.cost_usd,
+      last_active: g.last_active
     });
   }
   result.sort((a, b) => b.cost_usd - a.cost_usd);
   return result;
 }
+function queryProjectBreakdown(db, period = "all", machine) {
+  return queryProjectBreakdownScoped(db, requestPeriodWhere(period), sessionPeriodWhere(period), [], [], machine);
+}
 function normalizeAccountEmail(email) {
   return (email ?? "").trim().toLowerCase();
 }
@@ -1560,6 +1640,9 @@ function queryCostCenterBreakdown(db, period = "all", filter = {}) {
   filtered.sort((a, b) => b.cost_usd - a.cost_usd);
   return filtered;
 }
+function queryProjectBreakdownSince(db, since, machine) {
+  return queryProjectBreakdownScoped(db, "timestamp >= ?", "started_at >= ?", [since], [since], machine);
+}
 function queryDailyBreakdown(db, days = 30, machine) {
   const machineClause = machine ? " AND machine_id = ?" : "";
   const params = machine ? [`-${days}`, machine] : [`-${days}`];
@@ -2119,14 +2202,52 @@ var numOr = (v, d = 0) => {
   const num = Number(v);
   return Number.isFinite(num) ? num : d;
 }, strOr = (v, d = "") => v == null ? d : String(v);
-var init_database = () => {};
+var init_database = __esm(() => {
+  init_sqlite_adapter();
+});
+
+// src/db/dialect.ts
+function translateSql(sql, dialect) {
+  if (dialect === "sqlite")
+    return sql;
+  return sqliteToPostgres(sql);
+}
+function translateParams(params) {
+  const flat = params.length === 1 && Array.isArray(params[0]) ? params[0] : params;
+  return flat.map((p) => p === undefined ? null : p);
+}
+function sqliteToPostgres(sql) {
+  let out = sql;
+  let paramIdx = 0;
+  out = out.replace(/\?/g, () => `$${++paramIdx}`);
+  out = out.replace(/datetime\s*\(\s*'now'\s*\)/gi, "NOW()");
+  out = out.replace(/datetime\s*\(\s*'now'\s*,\s*'(-?\d+)\s+(minutes?|hours?|days?|seconds?)'\s*\)/gi, (_match, amount, unit) => {
+    const n = parseInt(amount, 10);
+    const absN = Math.abs(n);
+    const normalizedUnit = unit.toLowerCase().replace(/s$/, "");
+    const plural = absN === 1 ? normalizedUnit : `${normalizedUnit}s`;
+    return n < 0 ? `NOW() - INTERVAL '${absN} ${plural}'` : `NOW() + INTERVAL '${absN} ${plural}'`;
+  });
+  out = out.replace(/lower\s*\(\s*hex\s*\(\s*randomblob\s*\(\s*\d+\s*\)\s*\)\s*\)/gi, "gen_random_uuid()::text");
+  out = out.replace(/GROUP_CONCAT\s*\(/gi, "STRING_AGG(");
+  out = out.replace(/json_extract\s*\(\s*(\w+)\s*,\s*'\$\.(\w+)'\s*\)/gi, (_match, col, key) => `${col}->>'${key}'`);
+  out = out.replace(/\bAUTOINCREMENT\b/gi, "GENERATED ALWAYS AS IDENTITY");
+  out = out.replace(/(?<![I])LIKE/gi, "ILIKE");
+  out = out.replace(/\bIFNULL\s*\(/gi, "COALESCE(");
+  out = out.replace(/INSERT\s+OR\s+REPLACE\s+INTO\s+"?(\w+)"?\s*\(([^)]+)\)\s*VALUES/gi, (_match, table, colList) => `INSERT INTO "${table}" (${colList}) VALUES`);
+  out = out.replace(/INSERT\s+OR\s+REPLACE\s+INTO/gi, "INSERT INTO");
+  if (/INSERT\s+OR\s+IGNORE\s+INTO/i.test(out)) {
+    out = out.replace(/INSERT\s+OR\s+IGNORE\s+INTO/gi, "INSERT INTO");
+    out = out.replace(/;?\s*$/, " ON CONFLICT DO NOTHING");
+  }
+  return out;
+}
 
 // src/db/sync-pg.ts
 import { Worker, MessageChannel, receiveMessageOnPort } from "worker_threads";
 import { fileURLToPath } from "url";
 import { dirname, join as join10 } from "path";
 import { existsSync as existsSync11 } from "fs";
-import { translateSql, translateParams } from "@hasna/cloud";
 function translateSqliteDates(sql) {
   let s = sql;
   const isoDate = (expr) => `to_char(${expr}, 'YYYY-MM-DD')`;
@@ -2248,6 +2369,54 @@ class SyncPgAdapter {
 }
 var init_sync_pg = () => {};
 
+// src/db/pg-migrate.ts
+var exports_pg_migrate = {};
+__export(exports_pg_migrate, {
+  resolvePgSsl: () => resolvePgSsl,
+  applyPgMigrations: () => applyPgMigrations
+});
+import pg from "pg";
+function resolvePgSsl(dsn) {
+  return dsn.includes("sslmode=require") || dsn.includes("ssl=true") ? { rejectUnauthorized: false } : undefined;
+}
+async function applyPgMigrations(connectionString, migrations, service = "unknown") {
+  const pool = new pg.Pool({ connectionString, ssl: resolvePgSsl(connectionString) });
+  const result = {
+    service,
+    applied: [],
+    alreadyApplied: [],
+    errors: [],
+    totalMigrations: migrations.length
+  };
+  try {
+    await pool.query(`CREATE TABLE IF NOT EXISTS _pg_migrations (
+        id SERIAL PRIMARY KEY,
+        version INT UNIQUE NOT NULL,
+        applied_at TIMESTAMPTZ DEFAULT NOW()
+      )`);
+    const existing = await pool.query("SELECT version FROM _pg_migrations ORDER BY version");
+    const appliedSet = new Set(existing.rows.map((row) => Number(row["version"])));
+    for (let i = 0;i < migrations.length; i++) {
+      if (appliedSet.has(i)) {
+        result.alreadyApplied.push(i);
+        continue;
+      }
+      try {
+        await pool.query(migrations[i]);
+        await pool.query("INSERT INTO _pg_migrations (version) VALUES ($1) ON CONFLICT DO NOTHING", [i]);
+        result.applied.push(i);
+      } catch (err) {
+        result.errors.push(`Migration ${i}: ${err instanceof Error ? err.message : String(err)}`);
+        break;
+      }
+    }
+  } finally {
+    await pool.end().catch(() => {});
+  }
+  return result;
+}
+var init_pg_migrate = () => {};
+
 // src/db/pg-migrations.ts
 var PG_MIGRATIONS;
 var init_pg_migrations = __esm(() => {
@@ -2491,7 +2660,7 @@ __export(exports_cloud, {
   cloudMigrations: () => cloudMigrations,
   authClientFromPool: () => authClientFromPool
 });
-import pg from "pg";
+import pg2 from "pg";
 function getCloudDatabaseUrl() {
   return process.env["HASNA_ECONOMY_DATABASE_URL"]?.trim() || process.env["ECONOMY_DATABASE_URL"]?.trim() || process.env["DATABASE_URL"]?.trim() || undefined;
 }
@@ -2515,8 +2684,7 @@ function openCloudDatabase(dsn = getCloudDatabaseUrl()) {
 function createCloudPool(dsn = getCloudDatabaseUrl()) {
   if (!dsn)
     throw new Error("economy cloud mode requires a Postgres DSN (HASNA_ECONOMY_DATABASE_URL)");
-  const ssl = dsn.includes("sslmode=require") || dsn.includes("ssl=true") ? { rejectUnauthorized: false } : undefined;
-  const pool = new pg.Pool({ connectionString: dsn, ssl, max: Number(process.env["ECONOMY_PG_POOL_MAX"] ?? "5"), connectionTimeoutMillis: 1e4 });
+  const pool = new pg2.Pool({ connectionString: dsn, ssl: resolvePgSsl(dsn), max: Number(process.env["ECONOMY_PG_POOL_MAX"] ?? "5"), connectionTimeoutMillis: 1e4 });
   pool.on("error", (err) => {
     console.error(JSON.stringify({ evt: "pg_pool_error", message: err.message }));
   });
@@ -2542,6 +2710,7 @@ function cloudMigrations() {
 }
 var init_cloud = __esm(() => {
   init_sync_pg();
+  init_pg_migrate();
   init_pg_migrations();
 });
 
@@ -2820,13 +2989,14 @@ async function syncOpenProjectsRegistry(db, listActiveProjects) {
   let imported = 0;
   let skipped = 0;
   for (const project of projects) {
-    if (!project.path) {
+    const path = resolveProjectPath(project);
+    if (!path) {
       skipped++;
       continue;
     }
     upsertProject(db, {
       id: project.id,
-      path: project.path,
+      path,
       name: project.name,
       description: project.description,
       tags: project.tags ?? [],
@@ -2836,6 +3006,7 @@ async function syncOpenProjectsRegistry(db, listActiveProjects) {
   }
   return { imported, skipped };
 }
+var resolveProjectPath = (project) => project.primary_path || project.path || "";
 var init_open_projects = __esm(() => {
   init_database();
 });
@@ -3154,6 +3325,7 @@ function defaultCostBasisForAgent(agent) {
 }
 
 // src/lib/accounts.ts
+import { appliedProfileName, resolveStore } from "@hasna/accounts";
 var AGENT_ACCOUNT_TOOLS = {
   claude: ["claude"],
   takumi: ["takumi", "claude"],
@@ -3218,57 +3390,35 @@ function envOverride(agent, env) {
     account_source: "override"
   };
 }
-function knownToolIds(api) {
-  try {
-    return new Set(api.listTools().map((tool) => tool.id));
-  } catch {
-    return new Set;
-  }
-}
-function profileForEnvDir(api, tool, env) {
+async function profileForEnvDir(store, tool, env) {
   const configuredDir = env[tool.envVar];
   if (!configuredDir)
     return null;
   const normalized = normalizeDir(configuredDir);
-  try {
-    return api.listProfiles(tool.id).find((profile) => normalizeDir(profile.dir) === normalized) ?? null;
-  } catch {
-    return null;
-  }
+  return (await store.listProfiles(tool.id)).find((profile) => normalizeDir(profile.dir) === normalized) ?? null;
 }
 async function resolveAccountForAgent(agent, env = process.env) {
   const override = envOverride(agent, env);
   if (override)
     return override;
-  let api;
-  try {
-    api = await import("@hasna/accounts");
-  } catch {
-    return null;
-  }
-  const toolIds = knownToolIds(api);
+  const store = resolveStore(env);
+  const tools = new Map((await store.listTools()).map((tool) => [tool.id, tool]));
   for (const toolId of AGENT_ACCOUNT_TOOLS[agent]) {
-    if (!toolIds.has(toolId))
-      continue;
-    let tool;
-    try {
-      tool = api.getTool(toolId);
-    } catch {
+    const tool = tools.get(toolId);
+    if (!tool)
       continue;
-    }
-    const envProfile = profileForEnvDir(api, tool, env);
+    const envProfile = await profileForEnvDir(store, tool, env);
     if (envProfile)
       return fromProfile(envProfile, "env");
-    try {
-      const applied = api.appliedProfile(toolId);
+    const appliedName = appliedProfileName(toolId);
+    if (appliedName) {
+      const applied = await store.findProfile(appliedName, toolId);
       if (applied)
         return fromProfile(applied, "applied");
-    } catch {}
-    try {
-      const current = api.currentProfile(toolId);
-      if (current)
-        return fromProfile(current, "current");
-    } catch {}
+    }
+    const current = await store.currentProfile(toolId);
+    if (current)
+      return fromProfile(current, "current");
   }
   return null;
 }
@@ -6446,6 +6596,15 @@ var openApiSpec = {
               type: "string"
             }
           },
+          {
+            name: "since",
+            in: "query",
+            description: "ISO timestamp lower bound; takes precedence over period",
+            schema: {
+              type: "string",
+              format: "date-time"
+            }
+          },
           {
             name: "machine",
             in: "query",
@@ -7538,9 +7697,10 @@ function createHandler(db, options = {}) {
     if (path === "/api/breakdown" && method === "GET") {
       const by = url.searchParams.get("by") ?? "model";
       const period = url.searchParams.get("period") ?? "all";
+      const since = url.searchParams.get("since") ?? undefined;
       const machine = url.searchParams.get("machine") ?? undefined;
       if (by === "project")
-        return ok(queryProjectBreakdown(db, period, machine));
+        return ok(since ? queryProjectBreakdownSince(db, since, machine) : queryProjectBreakdown(db, period, machine));
       if (by === "agent")
         return ok(queryAgentBreakdown(db, period, machine));
       if (by === "account")
@@ -7934,12 +8094,12 @@ function parsePort(raw, label) {
 }
 async function runMigrate() {
   const { getCloudDatabaseUrl: getCloudDatabaseUrl2, createCloudPool: createCloudPool2, authClientFromPool: authClientFromPool2, cloudMigrations: cloudMigrations2 } = await Promise.resolve().then(() => (init_cloud(), exports_cloud));
-  const { applyPgMigrations } = await import("@hasna/cloud");
+  const { applyPgMigrations: applyPgMigrations2 } = await Promise.resolve().then(() => (init_pg_migrate(), exports_pg_migrate));
   const { ApiKeyStore: ApiKeyStore2 } = await import("@hasna/contracts/auth");
   const dsn = getCloudDatabaseUrl2();
   if (!dsn)
     throw new Error("migrate requires a Postgres DSN: set HASNA_ECONOMY_DATABASE_URL (or ECONOMY_DATABASE_URL / DATABASE_URL)");
-  const result = await applyPgMigrations(dsn, cloudMigrations2(), "economy");
+  const result = await applyPgMigrations2(dsn, cloudMigrations2(), "economy");
   const pool = createCloudPool2(dsn);
   try {
     await new ApiKeyStore2(authClientFromPool2(pool)).ensureSchema();

package/dist/server/serve.d.ts

@@ -1,4 +1,4 @@
-import type { SqliteAdapter as Database } from '@hasna/cloud';
+import type { SqliteAdapter as Database } from '../db/sqlite-adapter.js';
 /** The serve OpenAPI document (source of the generated SDK), version-synced. */
 export declare function openApiDocument(): Record<string, unknown>;
 /**

package/dist/server/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAA;AA8C7D,gFAAgF;AAChF,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzD;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAC7F,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E;AAuBD,UAAU,kBAAkB;IAC1B,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AA6ED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,YAAY,SAAwB,IACzF,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAwB7D;AAQD,MAAM,WAAW,cAAc;IAC7B;;wEAEoE;IACpE,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,IACxC,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA8e/D;AAMD,wBAAgB,WAAW,CAAC,IAAI,SAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAkDvG"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AA8CxE,gFAAgF;AAChF,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzD;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAC7F,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E;AAuBD,UAAU,kBAAkB;IAC1B,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AA6ED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,YAAY,SAAwB,IACzF,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAwB7D;AAQD,MAAM,WAAW,cAAc;IAC7B;;wEAEoE;IACpE,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,IACxC,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA+e/D;AAMD,wBAAgB,WAAW,CAAC,IAAI,SAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAkDvG"}

package/docs/README.md

@@ -0,0 +1,12 @@
+# Economy documentation
+
+Economy can run as an on-machine SQLite application or as a client of a shared self-hosted HTTP service. These guides describe the current command and network surfaces:
+
+- [CLI reference](cli.md) — the `economy` command and the four installed binaries.
+- [Ingestion](ingestion.md) — supported sources, default paths, sync behavior, billing, and account attribution.
+- [Configuration and deployment](configuration.md) — data paths, environment variables, local/server modes, and authentication.
+- [REST API](rest-api.md) — canonical `/v1` routes, request conventions, probes, and legacy aliases.
+- [MCP server](mcp.md) — stdio/HTTP setup and the available tools.
+- [OTLP sidecar](otel.md) — OTLP metrics and the simplified `/ingest` payload.
+
+For generated API details, start `economy-serve` and open [`/openapi.json`](http://127.0.0.1:3456/openapi.json). The checked-in source is [`openapi/economy.json`](../openapi/economy.json).

package/docs/cli.md

@@ -0,0 +1,88 @@
+# CLI reference
+
+Installing `@hasna/economy` provides four binaries:
+
+| Binary | Purpose |
+| --- | --- |
+| `economy` | Ingest, query, and manage Economy data. |
+| `economy-mcp` | Run the MCP server over stdio or Streamable HTTP. |
+| `economy-serve` | Serve the REST API and built dashboard, or migrate a self-hosted database. |
+| `economy-otel` | Ingest OTLP/HTTP metrics or simplified cost events into local SQLite. |
+
+Use `<binary> --help` and `economy <command> --help` for the exact help emitted by the installed version.
+
+## Core commands
+
+The supported coding-agent values are `claude`, `takumi`, `codex`, `gemini`, `opencode`, `cursor`, `pi`, and `hermes`.
+
+| Command | Current behavior and principal options |
+| --- | --- |
+| `economy sync` | Ingest every local source, or select sources with `--claude`, `--takumi`, `--codex`, `--gemini`, `--opencode`, `--cursor`, `--pi`, `--hermes`, or `--loops`. Maintenance flags are `--force`, `--backfill-machine`, and `--recalculate`; `--verbose` prints source details. |
+| `economy today`, `week`, `month` | Auto-sync in local mode and print the corresponding summary. Auto-sync is skipped in cloud-client mode. |
+| `economy sessions` | List sessions. Filters: `--agent`, `--project`, `--account`, `--machine`, `--since`, and `--search`; `--limit` defaults to 20; `--format` is `table`, `compact`, `csv`, or `json`. |
+| `economy session <id>` | Show one session and its requests. IDs may be prefixes. `--limit` defaults to 20 and `--verbose` shows up to 50 requests. |
+| `economy top` | Rank expensive sessions with `-n`, `--agent`, and `--since`. |
+| `economy breakdown` | Group by `model`, `agent`, `project`, `account`, `cost-center`, `loop`, `app`, or `repo`; accepts `--since`, `--limit`, `--verbose`, and `--json`. |
+| `economy accounts [period]` | Account/profile totals for `today`, `week`, `month`, `year`, or `all`; accepts `--limit`, `--verbose`, and `--json`. |
+| `economy machines` | Machines represented in stored data; accepts `--limit` and `--verbose`. |
+| `economy fleet` | Shared summary plus per-machine rows; accepts `--period`, `--limit`, `--verbose`, and `--json`. |
+| `economy brief` | Fleet brief with `--since <24h|7d|ISO-date>`, `--machine <id|all>`, or `--json`. |
+| `economy usage [period]` | Quota/usage snapshots with `--agent`, `--limit`, `--verbose`, or `--json`. |
+| `economy savings [period]` | Subscription-versus-API-equivalent savings with `--agent` or `--json`. |
+| `economy watch` | Poll recent costs, or use `--daemon` to sync watched local paths. Also accepts `--interval`, `--agent`, and macOS `--notify`. In cloud mode it streams the API and does not ingest local files. |
+| `economy status` | Print one-line spend, fleet, storage, top-agent, and available quota status. |
+| `economy doctor` | Check source paths/token availability, storage mode, pricing gaps, deduplication, and billing drift. |
+| `economy init` | Print first-run local and cloud-client setup hints. |
+
+Human output for high-cardinality commands is intentionally capped. Use the command's `--json`, `--verbose`, or `--limit` option when available. JSON output is complete; `--verbose` has command-specific semantics, so consult `--help`.
+
+## Analysis and export
+
+| Command | Behavior |
+| --- | --- |
+| `economy export` | Export `sessions` or `requests` as CSV. `--period` accepts `today`, `week`, `month`, or `all`; `--output` writes a file instead of stdout. |
+| `economy compare <period1> <period2>` | Compare `today`, `yesterday`, `week`, `lastweek`, `month`, or `lastmonth`. |
+| `economy forecast` | Project the current month's total from the observed burn rate. |
+| `economy efficiency` | Show output/input ratio, cache-hit percentage, and cost per 1,000 output tokens by model. |
+| `economy estimate --model <id>` | Estimate cost from `--input` and `--output` token counts using the active pricing table. |
+| `economy tui` | Terminal dashboard; `--watch` refreshes at `--interval` seconds. |
+| `economy waybar` | Emit a Waybar-compatible JSON status object. |
+| `economy bar tui`, `bar waybar` | Aliases for the TUI and Waybar commands. |
+
+## Data management
+
+| Command group | Subcommands |
+| --- | --- |
+| `economy budget` | `set` (`--limit` required; optional `--project`, `--agent`, `--cost-center`, `--period`, `--alert`), `list` (`--limit`, `--verbose`), `remove <id>`. |
+| `economy goal` | `set` (`--limit` required; optional `--period`, `--project`, `--agent`), `list`, `status`, `remove <id>`. List/status accept `--limit` and `--verbose`. |
+| `economy project` | `add <path> [--name]`, `list`, `show <nameOrPath>`, `rename <path> <name>`, `remove <path>`. |
+| `economy pricing` | `list`, `set <model>`, `remove <model>`. Set accepts `--input`, `--output`, `--cache-read`, `--cache-write`, `--cache-write-1h`, and `--cache-storage`. |
+| `economy subscriptions` | `set` (requires `--provider` and `--plan`; optional `--agent`, `--fee`, `--included`), `list`, `remove <id>`. |
+| `economy billing` | `sync` (`--days`, provider selectors), `show --period`, and `diff --period`. Provider sync is local-only. |
+| `economy config` | Show config, `get <key>`, `set <key> <value>`, or `webhook-test`. See [configuration](configuration.md). |
+| `economy remove <type> <id>` | Top-level alias for removing a `budget`, `project`, `goal`, or `pricing` row. Alias: `rm`. |
+
+## Integrations and utilities
+
+| Command | Behavior |
+| --- | --- |
+| `economy serve --port <port>` | Start the REST API in-process. Equivalent server controls are documented under [`economy-serve`](configuration.md#rest-server). |
+| `economy dashboard --port <port>` | Start the server when necessary and open the dashboard URL. |
+| `economy mcp` | Print Claude Code, Codex, and Gemini MCP configuration; select one or use `--all`. |
+| `economy completion <shell>` | Print completion for `bash`, `zsh`, or `fish`. |
+| `economy menubar` | `install [--force]`, `start`, `stop`, or `uninstall` the macOS Economy Bar app. |
+| `economy brains` | `gather`, `train`, `model [set|clear]`, and `status`. Fine-tuning requires the optional `@hasna/brains` package; gathering does not. |
+| `economy events`, `economy webhooks` | Event emit/list/replay and event-subscription commands supplied by `@hasna/events`; use the nested `--help` for options. |
+| `economy todos` | Display the bundled Economy roadmap, filter tasks, or show a task ID. This is project planning data, not live service status. |
+
+## Other binary help
+
+```text
+economy-mcp [--http] [--port <port>]
+economy-serve [--port <port>]
+economy-serve migrate
+economy-serve version
+economy-otel [--port <port>]
+```
+
+`economy-mcp` and `economy-serve` support `--version`. See [MCP](mcp.md), [configuration](configuration.md), and [OTLP](otel.md) for environment controls and endpoints.