swarmdo 1.27.0 → 1.30.0

package/v3/@swarmdo/cli/dist/src/usage/spend-forecast.d.ts

@@ -0,0 +1,28 @@
+/**
+ * spend-forecast.ts — project month-end Claude Code spend from month-to-date
+ * burn, for budgeting ("on pace for ~$420 this month").
+ *
+ * The quota forecaster (limits.ts) answers "will I hit the rolling cap"; this
+ * answers "what will the calendar month cost at the current daily average".
+ * Pure + deterministic: month-to-date total, the day-of-month, and the days in
+ * the month are passed in, so it's unit-tested without a clock.
+ */
+export interface SpendProjection {
+    monthToDateUsd: number;
+    dayOfMonth: number;
+    daysInMonth: number;
+    /** month-to-date / day-of-month */
+    dailyAverageUsd: number;
+    /** dailyAverage × daysInMonth — projected month-end total */
+    projectedUsd: number;
+    /** projectedUsd − monthToDateUsd — the remaining projected spend */
+    remainingUsd: number;
+}
+/** Days in the calendar month of an ISO `YYYY-MM` (or `YYYY-MM-DD`). Pure. */
+export declare function daysInMonthOf(iso: string): number;
+/**
+ * Project month-end spend at the current daily average. `dayOfMonth` is how many
+ * days (inclusive of today) have accrued the month-to-date total. Pure.
+ */
+export declare function projectMonthEnd(monthToDateUsd: number, dayOfMonth: number, daysInMonth: number): SpendProjection;
+//# sourceMappingURL=spend-forecast.d.ts.map

package/v3/@swarmdo/cli/dist/src/usage/spend-forecast.js

@@ -0,0 +1,33 @@
+/**
+ * spend-forecast.ts — project month-end Claude Code spend from month-to-date
+ * burn, for budgeting ("on pace for ~$420 this month").
+ *
+ * The quota forecaster (limits.ts) answers "will I hit the rolling cap"; this
+ * answers "what will the calendar month cost at the current daily average".
+ * Pure + deterministic: month-to-date total, the day-of-month, and the days in
+ * the month are passed in, so it's unit-tested without a clock.
+ */
+/** Days in the calendar month of an ISO `YYYY-MM` (or `YYYY-MM-DD`). Pure. */
+export function daysInMonthOf(iso) {
+    const [y, m] = iso.split('-').map(Number);
+    if (!Number.isFinite(y) || !Number.isFinite(m) || m < 1 || m > 12)
+        return NaN;
+    return new Date(y, m, 0).getDate(); // day 0 of the next month = last day of this one
+}
+/**
+ * Project month-end spend at the current daily average. `dayOfMonth` is how many
+ * days (inclusive of today) have accrued the month-to-date total. Pure.
+ */
+export function projectMonthEnd(monthToDateUsd, dayOfMonth, daysInMonth) {
+    const dailyAverageUsd = dayOfMonth > 0 ? monthToDateUsd / dayOfMonth : 0;
+    const projectedUsd = dailyAverageUsd * daysInMonth;
+    return {
+        monthToDateUsd,
+        dayOfMonth,
+        daysInMonth,
+        dailyAverageUsd,
+        projectedUsd,
+        remainingUsd: Math.max(0, projectedUsd - monthToDateUsd),
+    };
+}
+//# sourceMappingURL=spend-forecast.js.map

package/v3/@swarmdo/cli/dist/src/usage/transcript-errors.d.ts

@@ -31,6 +31,20 @@ export interface ToolErrorReport {
     filesScanned: number;
     sessionsWithErrors: number;
 }
+export interface Delegation {
+    /** tool_use calls to the `Task` tool (subagent spawns) */
+    taskCalls: number;
+    /** all tool_use calls */
+    toolCalls: number;
+    /** taskCalls / toolCalls, 0..1 (0 when no tool calls) */
+    ratio: number;
+}
+/**
+ * Delegation ratio: what fraction of tool calls spawned a subagent (the `Task`
+ * tool), from an already-collected tool report. The report's parsing/counting
+ * is the tested collectToolErrors path — this just extracts the Task share. Pure.
+ */
+export declare function delegationFromReport(report: Pick<ToolErrorReport, 'tools' | 'totalCalls'>): Delegation;
 export interface ParsedLine {
     type?: string;
     timestamp?: string;

package/v3/@swarmdo/cli/dist/src/usage/transcript-errors.js

@@ -12,6 +12,16 @@
  */
 import * as fs from 'node:fs';
 import { defaultClaudeProjectDirs, findTranscriptFiles, normalizeDateBound } from './transcript-usage.js';
+/**
+ * Delegation ratio: what fraction of tool calls spawned a subagent (the `Task`
+ * tool), from an already-collected tool report. The report's parsing/counting
+ * is the tested collectToolErrors path — this just extracts the Task share. Pure.
+ */
+export function delegationFromReport(report) {
+    const taskCalls = report.tools.find((t) => t.tool === 'Task')?.calls ?? 0;
+    const toolCalls = report.totalCalls;
+    return { taskCalls, toolCalls, ratio: toolCalls > 0 ? taskCalls / toolCalls : 0 };
+}
 export function newAccum() {
     return { idToTool: new Map(), calls: new Map(), errors: new Map(), sigs: new Map(), sessionsWithErrors: new Set() };
 }

package/v3/@swarmdo/cli/dist/src/usage/transcript-usage.js

@@ -182,7 +182,7 @@ function toUsageEvent(line, project, seen, unpriced) {
     const cacheWrite1hTokens = usage.cache_creation?.ephemeral_1h_input_tokens ?? 0;
     let costUsd;
     let costSource;
-    const price = resolveTranscriptPrice(model);
+    const price = resolveTranscriptPrice(model, ts.getTime());
     if (typeof line.costUSD === 'number') {
         costUsd = line.costUSD;
         costSource = 'transcript';

package/v3/@swarmdo/cli/dist/src/util/csv.d.ts

@@ -0,0 +1,14 @@
+/**
+ * csv.ts — minimal RFC 4180 CSV serialization for exporting tabular command
+ * output (e.g. `usage --csv` into a spreadsheet / expense report).
+ *
+ * Pure and dependency-free. A field is quoted only when it must be — it contains
+ * a comma, a double-quote, or a line break — and interior double-quotes are
+ * doubled. Rows are joined with '\n' (LF), which every spreadsheet importer
+ * accepts.
+ */
+/** Quote + escape a single CSV field per RFC 4180 (only when necessary). Pure. */
+export declare function escapeCsvField(value: string | number | boolean | null | undefined): string;
+/** Serialize a header row + data rows to a CSV string. Pure. */
+export declare function toCsv(headers: string[], rows: Array<Array<string | number | boolean | null | undefined>>): string;
+//# sourceMappingURL=csv.d.ts.map

package/v3/@swarmdo/cli/dist/src/util/csv.js

@@ -0,0 +1,20 @@
+/**
+ * csv.ts — minimal RFC 4180 CSV serialization for exporting tabular command
+ * output (e.g. `usage --csv` into a spreadsheet / expense report).
+ *
+ * Pure and dependency-free. A field is quoted only when it must be — it contains
+ * a comma, a double-quote, or a line break — and interior double-quotes are
+ * doubled. Rows are joined with '\n' (LF), which every spreadsheet importer
+ * accepts.
+ */
+/** Quote + escape a single CSV field per RFC 4180 (only when necessary). Pure. */
+export function escapeCsvField(value) {
+    const s = value === null || value === undefined ? '' : String(value);
+    return /[",\r\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+}
+/** Serialize a header row + data rows to a CSV string. Pure. */
+export function toCsv(headers, rows) {
+    const line = (cells) => cells.map(escapeCsvField).join(',');
+    return [line(headers), ...rows.map(line)].join('\n');
+}
+//# sourceMappingURL=csv.js.map

package/v3/@swarmdo/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmdo/cli",
-  "version": "1.27.0",
+  "version": "1.30.0",
   "type": "module",
   "description": "Swarmdo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",
@@ -83,7 +83,7 @@
     "test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
     "postinstall": "node ./scripts/postinstall.cjs",
     "build:standalone": "node scripts/build-standalone.mjs",
-    "prepublishOnly": "node -e \"if (process.env.npm_command === 'publish') { console.error('\\n@swarmdo/cli must be published from the self-contained staging dir (file:../ siblings do not ship from here):\\n\\n  npm run build && npm run build:standalone && npm publish dist-standalone/\\n'); process.exit(1); } // pnpm runs prepublishOnly when packing local directory deps during install \u2014 that path must not fail\""
+    "prepublishOnly": "node -e \"if (process.env.npm_command === 'publish') { console.error('\\n@swarmdo/cli must be published from the self-contained staging dir (file:../ siblings do not ship from here):\\n\\n  npm run build && npm run build:standalone && npm publish dist-standalone/\\n'); process.exit(1); } // pnpm runs prepublishOnly when packing local directory deps during install — that path must not fail\""
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",