@automagik/genie 3.260323.2 → 3.260403.1

package/.claude/commands/level-up.md

@@ -107,7 +107,7 @@ Silently scan the user's environment. Do NOT ask permission for each check. Just
    - Cron jobs, launchd services, or systemd services calling Claude on a schedule?
    - Background agents running 24/7 (pm2, systemd)?
    - Autonomous loop scripts (PRD + test suite patterns)?
-   - Agent orchestration configs (Agent Teams, Gastown, OpenClaw)?
+   - Agent orchestration configs (Agent Teams, Gastown)?
    - Evidence of agents managing other agents?
 ```
 
@@ -541,7 +541,7 @@ Show ONLY the next level transition. Do not dump all 10 levels. Focus is everyth
    - Agents talk to each other through shared files. One agent writes a task list, another picks up items, does the work, and marks them done. They coordinate through your project folder and git branches, like coworkers using a shared task board.
 
 4. **Always-on assistants**
-   - OpenClaw: an open source framework that runs Claude as a persistent assistant you can message via WhatsApp or Telegram. You text it like a colleague. It's always available, always has your context.
+   - Persistent agent frameworks that run Claude as an always-available assistant you can message via WhatsApp or Telegram. You text it like a colleague. It's always available, always has your context.
 
 **Community tip:** Level 10 is experimental. The community is actively building and testing these patterns. Things break. The value is in the learning. Very few people are here, and those who are spend significant time managing the systems. This is not "set and forget." This is "build, monitor, iterate."
 

package/.claude/settings.json

@@ -10,6 +10,50 @@
             "timeout": 5
           }
         ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "genie hook dispatch",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "genie hook dispatch",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "genie hook dispatch",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "genie hook dispatch",
+            "timeout": 5
+          }
+        ]
       }
     ]
   }

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "genie",
-      "version": "3.260322.1",
+      "version": "4.260402.20",
       "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,29 @@
+# metrics-updater Agent
+
+Fetches live GitHub metrics daily and updates the README metrics table.
+
+## Metrics Collected
+
+- **Releases/day** — releases published in the last 24h
+- **Avg merge time** — mean lead time (created→merged) for PRs closed in last 7d
+- **SHIP rate** — merged / total closed PRs in last 7d (%)
+- **Merged PRs (7d)** — count of merged PRs in the rolling 7-day window
+
+## README Markers
+
+The agent updates the block between `<!-- METRICS:START -->` and `<!-- METRICS:END -->` in README.md.
+
+If markers are missing, insert the table after the badges block, before `## What is Genie?`.
+
+## Commit Convention
+
+```
+chore: update live metrics (X/day, Yh avg, Z% SHIP)
+```
+
+Push to `dev` branch only. Never push to `main`.
+
+## State Files
+
+- `state.json` — last successful metrics run
+- `runs.jsonl` — append-only log of every run

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

@@ -0,0 +1,17 @@
+{"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"}}
+{"timestamp": "2026-03-25T00:03:05Z", "duration_ms": 5882, "api_calls": 2, "tools_generated": 0, "tools_available": 10, "errors": [], "status": "success", "fallback": false, "slowest_step": "fetch_releases", "steps": [{"name": "load_state", "duration_ms": 33}, {"name": "fetch_releases", "duration_ms": 3458}, {"name": "fetch_prs", "duration_ms": 1046}, {"name": "count_agents", "duration_ms": 53}, {"name": "parse_metrics", "duration_ms": 1191}, {"name": "update_readme", "duration_ms": 45}, {"name": "update_state", "duration_ms": 30}, {"name": "commit", "duration_ms": 4}], "metrics": {"releases_per_day": 0, "avg_bugfix_time_hours": 1.7, "ship_rate_pct": 100.0, "loc_changed_24h": 7418, "commits_24h": 66, "prs_24h": 28, "parallel_agents": 3, "updated": "2026-03-25T00:03:04Z"}}
+{"timestamp":"2026-03-25T00:00:00Z","duration_ms":31579683120,"api_calls":3,"tools_generated":1,"errors":0,"metrics":{"releases_24h":0,"avg_merge_time_hours":0.7,"ship_rate_pct":96,"merged_prs_7d":48}}
+{"timestamp":"2026-03-28T00:00:00Z","duration_ms":45000,"api_calls":3,"tools_generated":0,"errors":[],"metrics":{"releases_24h":0,"avg_merge_time_hours":2.9,"ship_rate_pct":94,"merged_prs_7d":47}}
+{"timestamp":"2026-03-29T00:00:00Z","duration_ms":52000,"api_calls":2,"tools_generated":0,"errors":[],"metrics":{"releases_24h":0,"avg_merge_time_hours":3.0,"ship_rate_pct":92,"merged_prs_7d":46}}
+{"timestamp":"2026-03-30T00:00:00Z","duration_ms":5000,"api_calls":3,"tools_generated":0,"errors":0,"metrics":{"releases_24h":0,"releases_per_day":0,"avg_merge_time_hours":0.3,"ship_rate_pct":84,"merged_prs_7d":32,"closed_prs_7d":38}}
+{"timestamp":"2026-03-31T00:00:00Z","duration_ms":5002,"api_calls":2,"tools_generated":4,"errors":0,"metrics":{"releases_24h":0,"merged_prs_7d":35,"avg_merge_time_h":0.3,"ship_rate_pct":85}}
+{"timestamp":"2026-04-01T00:00:00Z","duration_ms":8000,"api_calls":0,"tools_generated":0,"errors":["gh CLI unavailable","GitHub MCP tools not loaded in session"],"status":"failed","fallback":false,"metrics":null}
+{"timestamp":"2026-04-02T00:00:00.000Z","duration_ms":15000,"api_calls":0,"tools_generated":0,"errors":["gh CLI not available","GitHub MCP tools not present in session"],"status":"failed","fallback":false,"metrics":null}

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

@@ -0,0 +1,10 @@
+{
+  "last_run": "2026-04-02T00:00:00.000Z",
+  "last_run_status": "failed",
+  "last_metrics": {
+    "releases_24h": 0,
+    "merged_prs_7d": 35,
+    "avg_merge_time_h": 0.3,
+    "ship_rate_pct": 85
+  }
+}

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,27 @@
+#!/usr/bin/env bash
+# commit-formatter.sh — Clean commit message formatter for metrics updates
+# Auto-generated by metrics-updater agent (v1, 2026-03-24)
+# Updated: v2 — includes LoC/commits/PRs in commit message
+
+set -euo pipefail
+
+# Usage: commit-formatter.sh <metrics_json_file>
+# Reads metrics JSON and outputs a formatted commit message.
+
+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")
+loc=$(jq -r '.loc_changed_24h // 0' "$METRICS_FILE")
+commits=$(jq -r '.commits_24h // 0' "$METRICS_FILE")
+prs=$(jq -r '.prs_24h // 0' "$METRICS_FILE")
+
+# Format commit message
+echo "chore: update live metrics (${releases}/day, ${avg_time}h avg, ${ship_rate}% SHIP, ${loc} LoC, ${commits} commits, ${prs} PRs)"

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()