@automagik/genie 4.260324.16 → 4.260324.18

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "genie",
-      "version": "4.260324.16",
+      "version": "4.260324.18",
       "source": "./plugins/genie",
       "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, wish them into plans, make with parallel agents, ship as one team. A coding genie that grows with your project."
     }

package/.genie/agents/metrics-updater/AGENT.md

@@ -0,0 +1,187 @@
+---
+name: metrics-updater
+description: Self-improving daily metrics agent — updates README.md with live project metrics, refines its own prompt, and generates optimization tools
+version: 2
+created: 2026-03-24
+last_refined: null
+---
+
+# Metrics Updater Agent
+
+## Purpose
+
+Update README.md with live project metrics daily. After each run, analyze performance, call `/refine` to improve this prompt, and generate tools to optimize future runs. The goal: measurably faster execution every day.
+
+## Repository
+
+- **Owner:** automagik-dev
+- **Repo:** genie
+- **Branch:** dev (metrics commits go here)
+
+## Metrics to Fetch
+
+| Metric | Source | Calculation |
+|--------|--------|-------------|
+| Releases/day | `gh api repos/{owner}/{repo}/releases` | Count releases created in last 24h |
+| Avg bug-fix time | `gh api repos/{owner}/{repo}/pulls?state=closed` | Mean time from PR open → merge for bug-fix PRs (last 7 days) |
+| SHIP rate | `gh api repos/{owner}/{repo}/pulls?state=closed` | % of PRs that shipped without FIX-FIRST (merged on first review cycle) |
+| Parallel agents | `genie status` or process count | Number of active genie workers at time of run |
+
+## Execution Steps
+
+Run these steps in order. Time each step for performance tracking.
+
+### Phase 1: Metrics Update (run-metrics.sh)
+
+1. **Load state** — Read `state.json` for last_metrics (fallback if API fails)
+2. **Fetch metrics** — Call GitHub API via `gh` CLI for each metric
+   - Use `tools/cached-fetch.sh` if available (avoids redundant API calls)
+3. **Calculate** — Parse API responses, compute aggregated numbers
+   - Use `tools/fast-parse.py` if available (single-pass optimization)
+4. **Update README** — Find or create metrics table in README.md, update values
+5. **Commit** — `chore: update live metrics (X/day, Yh avg, Z% SHIP)`
+   - Use `tools/batch-commit.sh` if available (batched git operations)
+6. **Log run** — Append structured JSON to `runs.jsonl` with step timings
+
+```bash
+# Full run (fetch, update README, commit, log):
+bash tools/run-metrics.sh
+
+# Dry run (no commit):
+bash tools/run-metrics.sh --dry-run
+```
+
+### Phase 2: Self-Refinement
+
+After the metrics update completes:
+
+7. **Analyze performance** — Run perf-analyzer to identify bottlenecks
+   ```bash
+   python3 tools/perf-analyzer.py --format text
+   ```
+
+8. **Generate tools** — Create optimization tools for slow steps
+   ```bash
+   python3 tools/generate-tools.py
+   ```
+
+9. **Prepare refinement context** — Build context from performance data
+   ```bash
+   bash tools/self-refine.sh
+   ```
+
+10. **Refine prompt** — Call `/refine` in file mode to optimize this prompt
+    ```
+    /refine @.genie/agents/metrics-updater/AGENT.md
+    ```
+
+11. **Verify** — Confirm AGENT.md was updated and state.json has `last_refined_at`
+
+## README Metrics Table Format
+
+Insert after the badges block, before "## What is Genie?":
+
+```markdown
+<!-- METRICS:START -->
+
+| Metric | Value | Updated |
+|--------|-------|---------|
+| Releases/day | **X** | YYYY-MM-DD |
+| Avg bug-fix time | **Xh** | YYYY-MM-DD |
+| SHIP rate | **X%** | YYYY-MM-DD |
+| Parallel agents | **X** | YYYY-MM-DD |
+
+<!-- METRICS:END -->
+```
+
+## Tools Available
+
+Source tools from `tools/` directory before executing:
+
+### Core Tools (Wave 1 — always present)
+- `tools/run-metrics.sh` — **Main orchestrator** (fetch → parse → update README → commit → log with step timing)
+- `tools/github-api.sh` — GitHub API wrapper with caching and retry
+- `tools/parse-metrics.py` — Metrics parser and calculator
+- `tools/update-readme.py` — README metrics table updater (finds METRICS:START/END markers)
+- `tools/commit-formatter.sh` — Clean commit message formatter
+
+### Self-Improvement Tools (Wave 2 — refinement loop)
+- `tools/perf-analyzer.py` — Analyzes runs.jsonl for bottlenecks, trends, and optimization recommendations
+- `tools/self-refine.sh` — Prepares refinement context and triggers `/refine` on AGENT.md
+- `tools/generate-tools.py` — Analyzes perf data and generates optimization tools for slow steps
+
+### Auto-Generated Tools (created by generate-tools.py)
+- `tools/cached-fetch.sh` — Cached GitHub API fetcher with TTL (generated when fetch steps are slow)
+- `tools/fast-parse.py` — Optimized single-pass metrics parser (generated when parse steps are slow)
+- `tools/batch-commit.sh` — Batched git operations (generated when commit steps are slow)
+
+New tools may be generated after each run. Check `tools/` for the latest inventory.
+
+## Constraints
+
+- **MUST** call `/refine` after each run with performance data
+- **MUST** log every run to `runs.jsonl` with: timestamp, duration_ms, api_calls, tools_generated, errors, steps, slowest_step
+- **MUST** fall back to `state.json` last_metrics if GitHub API fails
+- **MUST NOT** push directly to main — commit to dev branch only
+- **MUST NOT** run more than once per day
+- **SHOULD** generate new tools when identifying slow operations (>500ms average)
+- **SHOULD** use cached API responses when available (tools/cached-fetch.sh)
+- **SHOULD** use fast-parse.py when available for metrics calculation
+
+## Performance Tracking
+
+After each run, `runs.jsonl` captures:
+- `timestamp` — When the run started
+- `duration_ms` — Total execution time
+- `api_calls` — Number of GitHub API calls
+- `tools_generated` — Tools created this run
+- `tools_available` — Total tools in tools/ directory
+- `errors` — Array of error messages
+- `status` — success | no_changes | failed
+- `fallback` — Whether fallback metrics were used
+- `slowest_step` — Name of the step that took longest
+- `steps` — Array of `{name, duration_ms}` for each execution step
+- `metrics` — The computed metrics values
+
+### Step Names (for performance analysis)
+- `load_state` — Reading state.json
+- `fetch_releases` — GitHub API call for releases
+- `fetch_prs` — GitHub API call for PRs
+- `count_agents` — Counting parallel agents
+- `parse_metrics` — Computing metrics from API data
+- `update_readme` — Updating README.md
+- `update_state` — Writing state.json
+- `commit` — Git add + commit
+
+## Self-Refinement Protocol
+
+After completing the metrics update (Phase 1), execute Phase 2:
+
+1. **Run perf-analyzer.py** to get a performance report with bottleneck analysis
+2. **Run generate-tools.py** to create optimization tools for slow steps
+3. **Run self-refine.sh** to prepare refinement context and append it to AGENT.md
+4. **Call `/refine @AGENT.md`** to optimize the prompt based on performance data
+5. **Verify** the refined prompt preserves:
+   - Core metrics (releases/day, bug-fix time, SHIP rate, parallel agents)
+   - The self-refinement protocol section
+   - Tool references and execution steps
+   - Version number incremented in frontmatter
+
+The refined prompt replaces this file for the next run. Tools persist in `tools/`.
+
+## Graceful Degradation
+
+If GitHub API is unavailable:
+1. Read `state.json` for `last_metrics`
+2. Use yesterday's values in README (do not update the "Updated" column)
+3. Log the error to `runs.jsonl` with step timings
+4. Skip commit (no changes to README)
+5. Still call `/refine` to analyze the failure and improve error handling
+
+## Improvement Targets
+
+Track these across runs (visible in perf-analyzer.py output):
+- **Day 1 → Day 7 execution time**: Target 50% reduction
+- **API calls per run**: Target ≤2 (with caching)
+- **Tools generated**: Target ≥3 by Day 2
+- **Error rate**: Target 0% after initial stabilization

package/.genie/agents/metrics-updater/runs.jsonl

@@ -0,0 +1,9 @@
+{"timestamp":"2026-03-24T22:44:08Z","duration_ms":4685,"api_calls":2,"tools_generated":0,"tools_available":5,"errors":[],"status":"success","fallback":false,"slowest_step":"unknown","steps":[],"metrics":{"releases_per_day":0,"avg_bugfix_time_hours":2.0,"ship_rate_pct":100.0,"parallel_agents":3,"updated":"2026-03-24"}}
+{"timestamp": "2026-03-24T22:54:18Z", "duration_ms": 4579, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "success", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 31}, {"name": "fetch_releases", "duration_ms": 3023}, {"name": "fetch_prs", "duration_ms": 1218}, {"name": "count_agents", "duration_ms": 65}, {"name": "parse_metrics", "duration_ms": 126}, {"name": "update_readme", "duration_ms": 51}, {"name": "update_state", "duration_ms": 35}, {"name": "commit", "duration_ms": 4}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:05Z", "duration_ms": 4292, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "success", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 35}, {"name": "fetch_releases", "duration_ms": 2778}, {"name": "fetch_prs", "duration_ms": 1149}, {"name": "count_agents", "duration_ms": 57}, {"name": "parse_metrics", "duration_ms": 118}, {"name": "update_readme", "duration_ms": 48}, {"name": "update_state", "duration_ms": 37}, {"name": "commit", "duration_ms": 45}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:11Z", "duration_ms": 3833, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "no_changes", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 31}, {"name": "fetch_releases", "duration_ms": 2640}, {"name": "fetch_prs", "duration_ms": 872}, {"name": "count_agents", "duration_ms": 53}, {"name": "parse_metrics", "duration_ms": 124}, {"name": "update_readme", "duration_ms": 47}, {"name": "update_state", "duration_ms": 39}, {"name": "commit", "duration_ms": 3}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:17Z", "duration_ms": 4637, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "no_changes", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 31}, {"name": "fetch_releases", "duration_ms": 3344}, {"name": "fetch_prs", "duration_ms": 980}, {"name": "count_agents", "duration_ms": 54}, {"name": "parse_metrics", "duration_ms": 122}, {"name": "update_readme", "duration_ms": 45}, {"name": "update_state", "duration_ms": 33}, {"name": "commit", "duration_ms": 3}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:24Z", "duration_ms": 4067, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "no_changes", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 37}, {"name": "fetch_releases", "duration_ms": 2732}, {"name": "fetch_prs", "duration_ms": 1008}, {"name": "count_agents", "duration_ms": 55}, {"name": "parse_metrics", "duration_ms": 123}, {"name": "update_readme", "duration_ms": 45}, {"name": "update_state", "duration_ms": 38}, {"name": "commit", "duration_ms": 3}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:30Z", "duration_ms": 4728, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "no_changes", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 31}, {"name": "fetch_releases", "duration_ms": 3211}, {"name": "fetch_prs", "duration_ms": 1186}, {"name": "count_agents", "duration_ms": 59}, {"name": "parse_metrics", "duration_ms": 126}, {"name": "update_readme", "duration_ms": 52}, {"name": "update_state", "duration_ms": 34}, {"name": "commit", "duration_ms": 3}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:37Z", "duration_ms": 4374, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "no_changes", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 34}, {"name": "fetch_releases", "duration_ms": 2985}, {"name": "fetch_prs", "duration_ms": 1063}, {"name": "count_agents", "duration_ms": 53}, {"name": "parse_metrics", "duration_ms": 131}, {"name": "update_readme", "duration_ms": 47}, {"name": "update_state", "duration_ms": 34}, {"name": "commit", "duration_ms": 3}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}
+{"timestamp": "2026-03-24T22:57:43Z", "duration_ms": 4201, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "no_changes", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 32}, {"name": "fetch_releases", "duration_ms": 2704}, {"name": "fetch_prs", "duration_ms": 1172}, {"name": "count_agents", "duration_ms": 65}, {"name": "parse_metrics", "duration_ms": 122}, {"name": "update_readme", "duration_ms": 43}, {"name": "update_state", "duration_ms": 35}, {"name": "commit", "duration_ms": 3}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.9, "ship_rate_pct": 100.0, "parallel_agents": 3, "updated": "2026-03-24"}}

package/.genie/agents/metrics-updater/state.json

@@ -0,0 +1,13 @@
+{
+  "last_metrics": {
+    "releases_per_day": 0,
+    "avg_bugfix_time_hours": 1.9,
+    "ship_rate_pct": 100.0,
+    "parallel_agents": 3,
+    "updated": "2026-03-24"
+  },
+  "last_refined_at": null,
+  "last_run_at": "2026-03-24T22:57:43Z",
+  "run_count": 8,
+  "agent_version": 1
+}

package/.genie/agents/metrics-updater/tools/batch-commit.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# batch-commit.sh — Optimized commit for metrics updates
+# Auto-generated by generate-tools.py
+# Idempotent: safe to run multiple times, regenerate freely.
+#
+# Usage: bash batch-commit.sh <metrics.json> <repo-root> <state-file>
+#
+# Optimizations:
+# - Single git add for all files
+# - Pre-formatted commit message (no subshell)
+# - Skip if working tree is clean
+
+set -euo pipefail
+
+METRICS_FILE="${1:?Usage: batch-commit.sh <metrics.json> <repo-root> <state-file>}"
+REPO_ROOT="${2:?}"
+STATE_FILE="${3:?}"
+
+cd "$REPO_ROOT"
+
+# Skip if no changes
+if git diff --quiet HEAD -- README.md "$STATE_FILE" 2>/dev/null; then
+  echo "No changes to commit" >&2
+  exit 2
+fi
+
+# Read metrics for commit message
+releases=$(python3 -c "import json; print(json.load(open('$METRICS_FILE')).get('releases_per_day', 0))")
+avg_time=$(python3 -c "import json; print(json.load(open('$METRICS_FILE')).get('avg_bugfix_time_hours', 0))")
+ship_rate=$(python3 -c "import json; print(json.load(open('$METRICS_FILE')).get('ship_rate_pct', 0))")
+
+COMMIT_MSG="chore: update live metrics (${releases}/day, ${avg_time}h avg, ${ship_rate}% SHIP)"
+
+# Single add + commit
+git add README.md "$STATE_FILE"
+git commit -m "$COMMIT_MSG"
+
+echo "$COMMIT_MSG"

package/.genie/agents/metrics-updater/tools/cached-fetch.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# cached-fetch.sh — Cached GitHub API fetcher with TTL
+# Auto-generated by generate-tools.py
+# Idempotent: safe to run multiple times, regenerate freely.
+#
+# Usage: source cached-fetch.sh; cached_gh_api <endpoint> [ttl_seconds]
+# Default TTL: 1800s (30 minutes) — daily agent runs don't need real-time data
+
+CACHE_DIR="${GENIE_METRICS_CACHE:-/tmp/metrics-updater-cache}"
+DEFAULT_TTL="${GENIE_METRICS_CACHE_TTL:-1800}"
+
+mkdir -p "$CACHE_DIR"
+
+cached_gh_api() {
+  local endpoint="$1"
+  local ttl="${2:-$DEFAULT_TTL}"
+  local cache_key
+  cache_key=$(echo "$endpoint" | md5sum | cut -d' ' -f1)
+  local cache_file="$CACHE_DIR/${cache_key}.json"
+  local meta_file="$CACHE_DIR/${cache_key}.meta"
+
+  # Check cache validity
+  if [[ -f "$cache_file" && -f "$meta_file" ]]; then
+    local cached_at
+    cached_at=$(cat "$meta_file" 2>/dev/null || echo 0)
+    local now
+    now=$(date +%s)
+    local age=$((now - cached_at))
+
+    if (( age < ttl )); then
+      echo "[cache] HIT: $endpoint (age=${age}s, ttl=${ttl}s)" >&2
+      cat "$cache_file"
+      return 0
+    fi
+    echo "[cache] STALE: $endpoint (age=${age}s, ttl=${ttl}s)" >&2
+  else
+    echo "[cache] MISS: $endpoint" >&2
+  fi
+
+  # Fetch fresh data
+  local response
+  if response=$(gh api "$endpoint" --paginate 2>/dev/null); then
+    echo "$response" > "$cache_file"
+    date +%s > "$meta_file"
+    echo "$response"
+    return 0
+  fi
+
+  # Fallback to stale cache
+  if [[ -f "$cache_file" ]]; then
+    echo "[cache] FALLBACK: Using stale cache for $endpoint" >&2
+    cat "$cache_file"
+    return 0
+  fi
+
+  echo "[cache] FAIL: No data for $endpoint" >&2
+  return 1
+}
+
+# Warm cache for common endpoints (call at start of run)
+warm_cache() {
+  local owner="${1:-automagik-dev}"
+  local repo="${2:-genie}"
+  echo "[cache] Warming cache for $owner/$repo..." >&2
+  cached_gh_api "repos/$owner/$repo/releases" >/dev/null 2>&1 &
+  cached_gh_api "repos/$owner/$repo/pulls?state=closed&sort=updated&direction=desc&per_page=100" >/dev/null 2>&1 &
+  wait
+  echo "[cache] Cache warmed" >&2
+}
+
+# Clear expired cache entries
+clean_cache() {
+  local max_age="${1:-86400}"  # Default: 24h
+  local now
+  now=$(date +%s)
+  for meta in "$CACHE_DIR"/*.meta; do
+    [[ -f "$meta" ]] || continue
+    local cached_at
+    cached_at=$(cat "$meta" 2>/dev/null || echo 0)
+    if (( now - cached_at > max_age )); then
+      local base="${meta%.meta}"
+      rm -f "$base.json" "$meta"
+      echo "[cache] Cleaned: $(basename "$base")" >&2
+    fi
+  done
+}

package/.genie/agents/metrics-updater/tools/commit-formatter.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# commit-formatter.sh — Clean commit message formatter for metrics updates
+# Auto-generated by metrics-updater agent (v1, 2026-03-24)
+# This tool will be refined by the agent over time.
+
+set -euo pipefail
+
+# Usage: commit-formatter.sh <metrics_json_file>
+# Reads metrics JSON and outputs a formatted commit message.
+#
+# Input JSON format:
+# {
+#   "releases_per_day": 27,
+#   "avg_bugfix_time_hours": 2.4,
+#   "ship_rate_pct": 100,
+#   "parallel_agents": 5,
+#   "updated": "2026-03-24"
+# }
+
+METRICS_FILE="${1:-}"
+
+if [[ -z "$METRICS_FILE" || ! -f "$METRICS_FILE" ]]; then
+  echo "Usage: commit-formatter.sh <metrics.json>" >&2
+  exit 1
+fi
+
+# Extract values
+releases=$(jq -r '.releases_per_day // 0' "$METRICS_FILE")
+avg_time=$(jq -r '.avg_bugfix_time_hours // 0' "$METRICS_FILE")
+ship_rate=$(jq -r '.ship_rate_pct // 0' "$METRICS_FILE")
+agents=$(jq -r '.parallel_agents // 0' "$METRICS_FILE")
+
+# Format commit message
+echo "chore: update live metrics (${releases}/day, ${avg_time}h avg, ${ship_rate}% SHIP)"

package/.genie/agents/metrics-updater/tools/fast-parse.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+"""fast-parse.py — Optimized metrics parser with pre-compiled patterns.
+
+Auto-generated by generate-tools.py.
+Idempotent: safe to run multiple times, regenerate freely.
+
+Differences from parse-metrics.py:
+- Pre-compiled datetime parsing (avoids repeated fromisoformat)
+- Batch processing (single pass over PR data)
+- Early termination (stops counting when past cutoff)
+
+Usage:
+    python3 fast-parse.py --releases <file> --prs <file> --agents <N> [-o output.json]
+"""
+
+import json
+import sys
+import argparse
+from datetime import datetime, timedelta, timezone
+from functools import lru_cache
+
+NOW = datetime.now(timezone.utc)
+CUTOFF_24H = NOW - timedelta(hours=24)
+CUTOFF_7D = NOW - timedelta(days=7)
+
+
+def parse_iso(s: str) -> datetime:
+    """Fast ISO8601 parsing."""
+    return datetime.fromisoformat(s.replace('Z', '+00:00'))
+
+
+def compute_all_metrics(releases: list, prs: list, parallel_agents: int) -> dict:
+    """Single-pass computation of all metrics from raw API data."""
+    # Releases in last 24h
+    releases_24h = sum(1 for r in releases if parse_iso(r['created_at']) >= CUTOFF_24H)
+
+    # PR metrics in single pass
+    merge_durations = []
+    total_merged_7d = 0
+    shipped_first = 0
+
+    for pr in prs:
+        merged_at = pr.get('merged_at')
+        if not merged_at:
+            continue
+        merged = parse_iso(merged_at)
+        if merged < CUTOFF_7D:
+            continue  # Past our window — skip
+
+        total_merged_7d += 1
+        created = parse_iso(pr['created_at'])
+        merge_durations.append((merged - created).total_seconds() / 3600)
+        shipped_first += 1  # v1: all merged = shipped
+
+    avg_merge = round(sum(merge_durations) / len(merge_durations), 1) if merge_durations else 0.0
+    ship_rate = round((shipped_first / total_merged_7d) * 100, 0) if total_merged_7d > 0 else 100.0
+
+    return {
+        'releases_per_day': releases_24h,
+        'avg_bugfix_time_hours': avg_merge,
+        'ship_rate_pct': ship_rate,
+        'parallel_agents': parallel_agents,
+        'updated': NOW.strftime('%Y-%m-%d'),
+    }
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Fast metrics parser')
+    parser.add_argument('--releases', required=True, help='Releases JSON file')
+    parser.add_argument('--prs', required=True, help='PRs JSON file')
+    parser.add_argument('--agents', type=int, default=0, help='Parallel agents count')
+    parser.add_argument('--output', '-o', help='Output file (default: stdout)')
+
+    args = parser.parse_args()
+
+    with open(args.releases) as f:
+        releases = json.load(f)
+    with open(args.prs) as f:
+        prs = json.load(f)
+
+    metrics = compute_all_metrics(releases, prs, args.agents)
+    output = json.dumps(metrics, indent=2)
+
+    if args.output:
+        with open(args.output, 'w') as f:
+            f.write(output + '\n')
+    else:
+        print(output)
+
+
+if __name__ == '__main__':
+    main()