aiforcecli 0.3.0 → 0.4.0

package/README.md

@@ -2,9 +2,10 @@
 
 **One interface over every coding agent — that you can trust and afford.**
 
-`aiforcecli` wraps multiple coding agents — **Claude Code**, **OpenAI Codex**, and more —
-behind a single normalized interface, and adds the things a single-agent CLI structurally
-can't:
+`aiforcecli` wraps multiple coding agents — **Claude Code**, **OpenAI Codex**, **Aider**
+(which itself routes to DeepSeek, Mistral/Codestral, Qwen, Ollama, OpenRouter, and more), and
+**Antigravity** (Google's `agy`, for Gemini models) — behind a single normalized interface, and
+adds the things a single-agent CLI structurally can't:
 
 - 🧭 **Advise** — instantly recommend the best agent+model for a task (public benchmarks blended with *your* results), before you spend a cent.
 - 🏁 **Race** — run several agents in parallel in isolated git worktrees, **verify each against your tests**, and apply the winner.
@@ -44,8 +45,8 @@ That's it — you're productive on day one.
 
 | Command | What it does |
 | --- | --- |
-| `aiforcecli run "<task>"` | Run a task with an agent. With no `--agent`, `aiforcecli` **auto-routes** to the best agent+model for the task within budget. Add `--heal` to **verify and self-heal** (see below). Flags: `--agent claude-code\|codex`, `--model <m>`, `--cwd <path>`, `--budget <usd>`, `--explain`, `--resume <sessionId>`, `--json`, `--heal`, `--max-attempts <n>`, `--verify <cmd>`, `--skip-verify`. |
-| `aiforcecli advise "<task>"` | **Recommend** which agent + model to use — instantly, without running anything. Blends a public benchmark scorecard with your private outcomes. `--cwd <path>`, `--json`. |
+| `aiforcecli run "<task>"` | Run a task with an agent. With no `--agent`, `aiforcecli` **auto-routes** to the best agent+model for the task within budget. Add `--heal` to **verify and self-heal** (see below). Flags: `--agent claude-code\|codex\|aider\|antigravity`, `--model <m>`, `--cwd <path>`, `--budget <usd>`, `--route deterministic\|bayesian`, `--explore`/`--no-explore` (bayesian), `--explain`, `--resume <sessionId>`, `--json`, `--heal`, `--max-attempts <n>`, `--verify <cmd>`, `--skip-verify`. |
+| `aiforcecli advise "<task>"` | **Recommend** which agent + model to use — instantly, without running anything. Blends a public benchmark scorecard with your private outcomes. `--cwd <path>`, `--budget <usd>` (preview under a cap), `--explore`, `--json`. |
 | `aiforcecli race "<task>"` | Run the task on **several agents in parallel** (isolated git worktrees), verify each, and apply the winner. Flags: `--agents claude-code,codex`, `--budget <usd>` (total, split across agents), `--select cheapest\|fastest\|first-pass`, `--verify <cmd>`, `--keep`, `--json`. |
 | `aiforcecli eval` | Run the **private eval suite** to calibrate `advise` on your codebase. `--dir <path>`, `--agents <ids>`, `--json`. |
 | `aiforcecli bench` | **Leaderboard** from your local history: which agent/model wins which task class, per dollar. `--since 7d\|24h\|<ISO>`, `--by-task`, `--json`. |
@@ -233,8 +234,9 @@ leaderboard (off by default; never sends prompts, paths, or output).
   (Claude Code reports `total_cost_usd`). When a CLI reports tokens only (Codex), cost is
   **computed** from a local pricing table — `costSource` records which, so reports are
   never silently wrong.
-- **Daily cap (`dailyCapUsd`):** checked *before* a run starts. If today's spend already
-  meets the cap, the run is refused (exit code `2`).
+- **Window caps (`dailyCapUsd`, `weeklyCapUsd`, `monthlyCapUsd`):** checked *before* a run
+  starts. If spend in any window already meets its cap (today / this calendar week from Monday /
+  this calendar month), the run is refused (exit code `2`). They also tighten the routing budget.
 - **Per-run cap (`maxCostPerRunUsd`, or `--budget`):** enforced *during* the run. As usage
   events arrive, if cumulative cost crosses the cap the subprocess is aborted
   (SIGTERM → SIGKILL).
@@ -261,16 +263,16 @@ is separate from config — installing it once is enough; settings come from the
 
 | Block | Key | Default | Purpose |
 | --- | --- | --- | --- |
-| `agents.<id>` | `model`, `bin`, `defaultFlags`, `allowedTools` | — | Per-agent overrides (binary path, forced model, default flags, tool allow-list). |
+| `agents.<id>` | `enabled`, `model`, `bin`, `defaultFlags`, `allowedTools` | `enabled:true` | Per-agent settings. `enabled:false` removes the agent everywhere. Plus binary path, forced model, default flags, tool allow-list. |
 | `defaultAgent` | | `claude-code` | Agent used by `run` when routing is off and no `--agent`. |
-| `routing` | `enabled`, `prefer`, `only`, `models` | `enabled:true` | Budget-aware auto-routing; `only` restricts the catalog, `models` adds custom entries. |
+| `routing` | `enabled`, `strategy`, `prefer`, `only`, `models` | `enabled:true`, `strategy:deterministic` | Auto-routing. `strategy`: `deterministic` (budget-aware tier router) or `bayesian` (learned engine; honors `advise.explore`). `only` restricts the catalog, `models` adds entries. Per-run override: `run --route`. |
 | `verify` | `enabled`, `command`, `timeoutMs` | `enabled:true`, 300 s | How results are verified; `command` overrides auto-detection. |
 | `heal` | `enabled`, `maxAttempts`, `escalate` | `false`, `3`, `true` | Self-healing loop behavior for `run --heal`. |
 | `race` | `agents`, `select`, `keepWorktrees`, `linkPaths` | `select:cheapest` | Defaults for `race`; `linkPaths` symlinks extra dep dirs into worktrees. |
 | `advise` | `weights`, `privatePseudocount`, `explore` | `0.7/0.2/0.1`, `5`, `false` | Recommendation scoring weights, prior strength, and Thompson-Sampling exploration. |
 | `eval` | `dir`, `models` | `.aiforcecli/evals` | Private eval suite location and which catalog models to evaluate. |
 | `telemetry` | `enabled`, `endpoint` | `false` | Opt-in anonymized outcome upload for the shared leaderboard. |
-| `budgets` | `maxCostPerRunUsd`, `dailyCapUsd` | — | Per-run and daily spend caps. |
+| `budgets` | `maxCostPerRunUsd`, `dailyCapUsd`, `weeklyCapUsd`, `monthlyCapUsd` | — | Per-run cap + daily/weekly/monthly spend caps (refuse to start once a window cap is hit). |
 | top-level | `timeoutMs`, `inactivityTimeoutMs` | 600 s, 120 s | Wall-clock and inactivity watchdogs for every run. |
 
 ## Development

package/aiforcecli.config.example.json

@@ -43,7 +43,9 @@
   },
   "budgets": {
     "maxCostPerRunUsd": 1.0,
-    "dailyCapUsd": 10.0
+    "dailyCapUsd": 10.0,
+    "weeklyCapUsd": 50.0,
+    "monthlyCapUsd": 150.0
   },
   "timeoutMs": 600000,
   "inactivityTimeoutMs": 120000