@ikieaneh/opencode-kit 0.5.0

package/src/adr.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# opencode-kit ADR — auto-generate Architecture Decision Record
+# Usage: bash src/adr.sh <title>
+# Then enter context, decision, alternatives, consequences interactively.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+. "$SCRIPT_DIR/platform.sh"
+
+CONTRACT_FILE=".opencode/orchestration/contract.json"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# --- Check contract exists ---
+if [ ! -f "$CONTRACT_FILE" ]; then
+  echo -e "${RED}❌ $CONTRACT_FILE not found. Run 'opencode-kit init' first.${NC}"
+  exit 1
+fi
+
+# --- Parse args ---
+TITLE=""
+CONTEXT=""
+DECISION=""
+ALTERNATIVES=""
+CONSEQUENCES=""
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --title|-t) TITLE="$2"; shift 2 ;;
+    --context|-c) CONTEXT="$2"; shift 2 ;;
+    --decision|-d) DECISION="$2"; shift 2 ;;
+    --alternatives|-a) ALTERNATIVES="$2"; shift 2 ;;
+    --consequences|-q) CONSEQUENCES="$2"; shift 2 ;;
+    *) TITLE="$1"; shift ;;
+  esac
+done
+
+# --- Interactive mode if no title provided ---
+if [ -z "$TITLE" ]; then
+  echo -e "${CYAN}[opencode-kit ADR]${NC} Interactive mode"
+  echo ""
+  read -r -p "Title: " TITLE
+  [ -z "$TITLE" ] && { echo -e "${RED}Title required${NC}"; exit 1; }
+  read -r -p "Context (why this decision?): " CONTEXT
+  read -r -p "Decision (what we decided): " DECISION
+  read -r -p "Alternatives considered: " ALTERNATIVES
+  read -r -p "Consequences (positive + negative): " CONSEQUENCES
+fi
+
+# --- Validate required fields ---
+if [ -z "$TITLE" ]; then
+  echo -e "${RED}❌ Title is required. Use: bash src/adr.sh \"Your Decision Title\"${NC}"
+  exit 1
+fi
+
+# --- Compute next ADR ID ---
+NEXT_ID=$($PYTHON_CMD -c "
+import json
+with open('$CONTRACT_FILE') as f: d = json.load(f)
+log = d.get('decisions', {}).get('adr_log', [])
+if not log:
+  print('ADR-001')
+else:
+  last = max(int(entry.get('id','ADR-000').replace('ADR-','')) for entry in log)
+  print(f'ADR-{last+1:03d}')
+")
+
+# --- Check for duplicate title ---
+DUP=$($PYTHON_CMD -c "
+import json
+with open('$CONTRACT_FILE') as f: d = json.load(f)
+log = d.get('decisions', {}).get('adr_log', [])
+for entry in log:
+  if entry.get('title','').lower().strip() == '$TITLE'.lower().strip():
+    print(entry.get('id',''))
+    break
+" 2>/dev/null)
+if [ -n "$DUP" ]; then
+  echo -e "${YELLOW}⚠️  Duplicate title found: $DUP — '$TITLE'${NC}"
+  echo "  Skipping. Update existing ADR instead."
+  exit 0
+fi
+
+# --- Build ADR entry ---
+# --- Build ADR entry via heredoc to avoid nested quote issues ---
+$PYTHON_CMD -c "
+import json, sys, os
+
+title = '$TITLE'
+date_val = '$(date +%Y-%m-%d)'
+next_id = '$NEXT_ID'
+
+entry = {
+  'id': next_id,
+  'date': date_val,
+  'title': title,
+  'context': '''$(echo "$CONTEXT" | sed "s/'/\\\\'/g")''',
+  'decision': '''$(echo "$DECISION" | sed "s/'/\\\\'/g")''',
+  'alternatives': '''$(echo "$ALTERNATIVES" | sed "s/'/\\\\'/g")''',
+  'consequences': '''$(echo "$CONSEQUENCES" | sed "s/'/\\\\'/g")'''
+}
+
+with open('/tmp/opencode-adr-entry.json', 'w') as f:
+  json.dump(entry, f, indent=2)
+print('Entry written')
+"
+
+# --- Inject into contract.json ---
+$PYTHON_CMD -c "
+import json
+
+with open('$CONTRACT_FILE') as f:
+  contract = json.load(f)
+
+with open('/tmp/opencode-adr-entry.json') as f:
+  entry = json.load(f)
+
+if 'decisions' not in contract:
+  contract['decisions'] = {}
+if 'adr_log' not in contract['decisions']:
+  contract['decisions']['adr_log'] = []
+
+contract['decisions']['adr_log'].append(entry)
+
+with open('$CONTRACT_FILE', 'w') as f:
+  json.dump(contract, f, indent=2)
+
+print(json.dumps(entry, indent=2))
+"
+
+echo ""
+echo -e "${GREEN}[opencode-kit] ✅ ADR recorded: $NEXT_ID${NC}"
+echo "  Title:        $TITLE"
+echo "  File:         $CONTRACT_FILE"
+echo "  Next:         Persist via: lean-ctx ctx_knowledge remember key orchestration-contract value \"\$(cat $CONTRACT_FILE)\""

package/src/cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * opencode-kit CLI — version and help
+ * Usage: npx opencode-kit --version
+ *        npx opencode-kit --help
+ */
+import { fileURLToPath } from 'url';
+import path from 'path';
+import fs from 'fs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkgPath = path.resolve(__dirname, '../package.json');
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+
+const args = process.argv.slice(2);
+
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+  console.log(`
+opencode-kit v${pkg.version}
+
+Usage:
+  npx opencode-kit [command]
+
+Commands:
+  init [--force]    Scaffold orchestration framework into project
+  update [--dry-run] Pull latest templates from GitHub
+  --version, -v     Print version
+  --help, -h        Print this help
+
+Plugin mode:
+  Add "opencode-kit" to opencode.json plugin array (FIRST position).
+  Skills are auto-registered. Contract auto-initialized on first run.
+
+Config resolution:
+  1. .opencode/            (project override)
+  2. ~/.config/opencode-kit/ (global defaults)
+  3. plugin templates/      (shipped defaults)
+
+Docs: ${pkg.homepage}
+`);
+  process.exit(0);
+}

package/src/global-config.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+# opencode-kit global-config — resolve config from local → global → plugin default
+# Usage: source src/global-config.sh && resolve_config "contract.json"
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+. "$SCRIPT_DIR/platform.sh"
+
+PLUGIN_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+GLOBAL_CONFIG_DIR="$HOME/.config/opencode-kit"
+
+# Resolve a config file from the lookup chain:
+#   1. .opencode/<path>      (project override)
+#   2. ~/.config/opencode-kit/<path>  (global defaults)
+#   3. <plugin>/<path>       (plugin defaults)
+# Returns: path to the first file found, or empty string if none found
+resolve_config() {
+  local rel_path="$1"
+
+  # 1. Project override
+  if [ -f ".opencode/$rel_path" ]; then
+    echo ".opencode/$rel_path"
+    return 0
+  fi
+
+  # 2. Global defaults
+  if [ -f "$GLOBAL_CONFIG_DIR/$rel_path" ]; then
+    echo "$GLOBAL_CONFIG_DIR/$rel_path"
+    return 0
+  fi
+
+  # 3. Plugin defaults (templates/)
+  if [ -f "$PLUGIN_ROOT/templates/$rel_path" ]; then
+    echo "$PLUGIN_ROOT/templates/$rel_path"
+    return 0
+  fi
+
+  # 4. Plugin defaults (root/)
+  if [ -f "$PLUGIN_ROOT/$rel_path" ]; then
+    echo "$PLUGIN_ROOT/$rel_path"
+    return 0
+  fi
+
+  echo ""
+  return 1
+}
+
+# Initialize global config from plugin defaults
+# Copies templates/* and rules/* to ~/.config/opencode-kit/
+init_global_config() {
+  echo "[opencode-kit] Initializing global config at $GLOBAL_CONFIG_DIR"
+
+  mkdir -p "$GLOBAL_CONFIG_DIR/orchestration" "$GLOBAL_CONFIG_DIR/rules"
+
+  # Copy contract template
+  if [ ! -f "$GLOBAL_CONFIG_DIR/orchestration/contract.json" ]; then
+    cp "$PLUGIN_ROOT/templates/contract.json" "$GLOBAL_CONFIG_DIR/orchestration/contract.json"
+    echo "  ✅ contract.json → global config"
+  fi
+
+  # Copy rules
+  if [ ! -f "$GLOBAL_CONFIG_DIR/rules/rules.json" ]; then
+    cp "$PLUGIN_ROOT/rules/rules.json" "$GLOBAL_CONFIG_DIR/rules/rules.json"
+    echo "  ✅ rules.json → global config"
+  fi
+
+  echo "[opencode-kit] ✅ Global config initialized"
+}
+
+# Detect if the opencode-kit plugin is active
+is_plugin_active() {
+  # Check if .opencode/plugins/opencode-kit.js exists (sign of plugin mode)
+  [ -f ".opencode/plugins/opencode-kit.js" ] && return 0
+  # Check if ~/.config/opencode-kit exists (sign of global config)
+  [ -d "$GLOBAL_CONFIG_DIR" ] && return 0
+  return 1
+}
+
+# Export functions
+export -f resolve_config init_global_config is_plugin_active
+export GLOBAL_CONFIG_DIR

package/src/init.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+# opencode-kit init — scaffold orchestration framework into target project
+# Usage: npx opencode-kit init [--force]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+. "$SCRIPT_DIR/platform.sh"
+. "$SCRIPT_DIR/global-config.sh"
+KIT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+FORCE="${1:-}"
+TARGET_DIR="${PWD}"
+TIMESTAMP=$(date +%Y%m%d%H%M%S)
+
+echo "[opencode-kit] 🚀 Initializing orchestration framework in $TARGET_DIR"
+
+# --- Dependency check ---
+echo ""
+echo "[opencode-kit] Checking dependencies..."
+
+deps_ok=0
+for cmd in git node; do
+  if command -v "$cmd" &>/dev/null; then
+    echo "  ✅ $cmd: $(command -v $cmd)"
+  else
+    echo "  ❌ $cmd: NOT FOUND — install $cmd first"
+    deps_ok=1
+  fi
+done
+
+# Check lean-ctx via MCP key (soft check — warn, don't block)
+if command -v lean-ctx &>/dev/null; then
+  echo "  ✅ lean-ctx available"
+else
+  echo "  ⚠️  lean-ctx not detected — ensure it's configured in MCP"
+fi
+
+if [ "$deps_ok" -eq 1 ]; then
+  echo -e "${RED}❌ Missing dependencies. Install them and retry.${NC}"
+  exit 1
+fi
+
+# --- Git check ---
+if ! git rev-parse --git-dir &>/dev/null; then
+  echo ""
+  echo "[opencode-kit] Not a git repository. Initializing..."
+  git init
+  echo "  ✅ git initialized"
+fi
+
+# --- Detect plugin mode ---
+PLUGIN_MODE=false
+if is_plugin_active; then
+  PLUGIN_MODE=true
+  echo ""
+  echo -e "${CYAN}[opencode-kit] Plugin detected — scaffolding project data only${NC}"
+fi
+
+# --- Handle existing .opencode/ ---
+if [ -d ".opencode" ]; then
+  if [ "$FORCE" = "--force" ]; then
+    BACKUP=".opencode.bak.$TIMESTAMP"
+    echo ""
+    echo -e "${YELLOW}⚠️  --force: Backing up existing .opencode/ to $BACKUP${NC}"
+    cp -r ".opencode" "$BACKUP"
+    rm -rf ".opencode"
+    echo "  ✅ Backed up to $BACKUP"
+  else
+    echo ""
+    echo -e "${YELLOW}⚠️  .opencode/ already exists. Use --force to overwrite (backup + clean scaffold).${NC}"
+    echo "  Missing files will be added. Existing files will NOT be overwritten."
+  fi
+fi
+
+# --- Scaffold directories ---
+mkdir -p .opencode/orchestration .opencode/rules .opencode/agents .opencode/src
+
+# --- Copy templates ---
+echo ""
+echo "[opencode-kit] Scaffolding files..."
+
+cp "$KIT_DIR/templates/contract.json" .opencode/orchestration/contract.json
+echo "  ✅ contract.json"
+
+cp "$KIT_DIR/templates/superpowers-contract.json" .opencode/templates/superpowers-contract.json
+echo "  ✅ superpowers-contract.json"
+
+cp "$KIT_DIR/rules/rules.json" .opencode/rules/rules.json
+echo "  ✅ rules.json"
+
+cp "$KIT_DIR/src/verify.sh" .opencode/src/verify.sh
+chmod +x .opencode/src/verify.sh
+echo "  ✅ verify.sh (executable)"
+
+cp "$KIT_DIR/src/platform.sh" .opencode/src/platform.sh
+chmod +x .opencode/src/platform.sh
+echo "  ✅ platform.sh (executable)"
+
+# Plugin-specific: scripts that exist locally for CLI access
+if [ "$PLUGIN_MODE" = false ]; then
+  # Non-plugin mode: copy all shell scripts
+  cp "$KIT_DIR/rules/validation.sh" .opencode/rules/validation.sh
+  chmod +x .opencode/rules/validation.sh
+  echo "  ✅ rules/validation.sh"
+
+  cp "$KIT_DIR/src/preflight.sh" .opencode/src/preflight.sh
+  chmod +x .opencode/src/preflight.sh
+  echo "  ✅ preflight.sh (executable)"
+
+  cp "$KIT_DIR/src/postflight.sh" .opencode/src/postflight.sh
+  chmod +x .opencode/src/postflight.sh
+  echo "  ✅ postflight.sh (executable)"
+
+  cp "$KIT_DIR/src/update.sh" .opencode/src/update.sh
+  chmod +x .opencode/src/update.sh
+  echo "  ✅ update.sh (executable)"
+
+  cp "$KIT_DIR/src/adr.sh" .opencode/src/adr.sh
+  chmod +x .opencode/src/adr.sh
+  echo "  ✅ adr.sh (executable)"
+
+  cp "$KIT_DIR/src/telemetry.sh" .opencode/src/telemetry.sh
+  chmod +x .opencode/src/telemetry.sh
+  echo "  ✅ telemetry.sh (executable)"
+
+  # --- Copy agent templates (pre-flight gates) ---
+  for agent in orchestrator planner task-manager code-reviewer learner fixer; do
+    if [ -f "$KIT_DIR/templates/agents/$agent.md" ]; then
+      cp "$KIT_DIR/templates/agents/$agent.md" ".opencode/agents/$agent.md"
+      echo "  ✅ agents/$agent.md"
+    fi
+  done
+fi
+
+# --- Git ignore .opencode/src (scripts are project-specific) ---
+if [ -f ".gitignore" ]; then
+  if ! grep -q ".opencode/src" .gitignore 2>/dev/null; then
+    echo ".opencode/src/" >> .gitignore
+  fi
+fi
+
+# --- Verify ---
+echo ""
+echo "[opencode-kit] Running verification..."
+if "$KIT_DIR/src/verify.sh"; then
+  echo ""
+  echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${GREEN}  ✅ opencode-kit v0.5.0 initialized${NC}"
+  echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo ""
+  echo "  Next steps:"
+  echo "  1. Set GOAL & SCOPE in .opencode/orchestration/contract.json"
+  echo "  2. Set your project rules in .opencode/rules/rules.json"
+  echo "  3. Read AGENTS.md for writing conventions"
+  echo "  4. Start with: Load contract → Plan → Execute → Review"
+else
+  echo -e "${RED}❌ Verification failed. Check errors above.${NC}"
+  exit 1
+fi

package/src/platform.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# opencode-kit platform — cross-platform detection and helpers
+# Source this from any script: . "$(dirname "$0")/platform.sh"
+set -euo pipefail
+
+# --- OS Detection ---
+OS="unknown"
+case "$(uname -s)" in
+  Darwin) OS="macos" ;;
+  Linux)  OS="linux"  ;;
+  *)      OS="other"  ;;
+esac
+
+# --- Architecture ---
+ARCH="unknown"
+case "$(uname -m)" in
+  arm64|aarch64) ARCH="arm64" ;;
+  x86_64|amd64)  ARCH="amd64" ;;
+  *)             ARCH="other" ;;
+esac
+
+# --- Python command (python3 on macOS, python on some Linux) ---
+PYTHON_CMD=""
+if command -v python3 &>/dev/null; then
+  PYTHON_CMD="python3"
+elif command -v python &>/dev/null; then
+  PYTHON_CMD="python"
+fi
+
+# --- Bash compatibility ---
+BASH_VERSION=$(bash --version | head -1 | grep -oE '[0-9]+\.[0-9]+' | head -1 || echo "0")
+
+# --- Export ---
+export OS ARCH PYTHON_CMD BASH_VERSION

package/src/postflight.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# opencode-kit postflight — persist contract + telemetry + update STATE.md
+# Run after every delegation or phase change.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+. "$SCRIPT_DIR/platform.sh"
+
+CONTRACT_KEY="orchestration-contract"
+CONTRACT_FILE=".opencode/orchestration/contract.json"
+STATE_FILE="STATE.md"
+TELEMETRY_DIR=".opencode/telemetry"
+START_TIME_FILE=".opencode/telemetry/.phase_start"
+
+echo "[opencode-kit] Post-flight: persisting state..."
+
+# --- Telemetry: record phase completion ---
+mkdir -p "$TELEMETRY_DIR"
+PHASE_START=$(cat "$START_TIME_FILE" 2>/dev/null || echo "")
+if [ -n "$PHASE_START" ]; then
+  PHASE_ELAPSED=$(( $(date +%s) - PHASE_START ))
+  # Read current state from contract
+  if [ -f "$CONTRACT_FILE" ]; then
+    CURRENT_STATE=$($PYTHON_CMD -c "
+import json
+with open('$CONTRACT_FILE') as f: d=json.load(f)
+print(d.get('state','UNKNOWN'))
+" 2>/dev/null || echo "UNKNOWN")
+    PREV_STATE=""
+    [ -f "$TELEMETRY_DIR/phases.jsonl" ] && PREV_STATE=$(tail -1 "$TELEMETRY_DIR/phases.jsonl" 2>/dev/null | $PYTHON_CMD -c "import sys,json; print(json.load(sys.stdin).get('to','INIT'))" 2>/dev/null || echo "INIT")
+    echo "{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"from\":\"$PREV_STATE\",\"to\":\"$CURRENT_STATE\",\"elapsed_ms\":$((PHASE_ELAPSED * 1000))}" >> "$TELEMETRY_DIR/phases.jsonl"
+    echo "  📊 Telemetry: $PREV_STATE → $CURRENT_STATE (${PHASE_ELAPSED}s)"
+  fi
+  rm -f "$START_TIME_FILE"
+fi
+
+# --- Step 1: Re-read contract from lean-ctx (the source of truth) ---
+CURRENT_CONTRACT=$(lean-ctx ctx_knowledge recall --query "$CONTRACT_KEY" 2>/dev/null || cat "$CONTRACT_FILE")
+
+# --- Step 2: Write back to lean-ctx ---
+lean-ctx ctx_knowledge remember \
+  category architecture \
+  key "$CONTRACT_KEY" \
+  value "$CURRENT_CONTRACT" 2>/dev/null && \
+  echo "  ✅ Contract persisted to lean-ctx" || \
+  echo "  ⚠️  lean-ctx persist failed"
+
+# --- Step 3: Sync STATE.md ---
+mkdir -p "$(dirname "$STATE_FILE")"
+if [ -f "$CONTRACT_FILE" ]; then
+  STATE=$(echo "$CURRENT_CONTRACT" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('state','UNKNOWN'))" 2>/dev/null || echo "UNKNOWN")
+  PHASE=$(echo "$CURRENT_CONTRACT" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); r=d.get('retry',{}); print(r.get('current_phase','none'))" 2>/dev/null || echo "none")
+  SCORE=$(echo "$CURRENT_CONTRACT" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); s=d.get('score',{}); print(s.get('combined','?'))" 2>/dev/null || echo "?")
+  echo "  📝 Contract state: $STATE (phase: $PHASE, score: $SCORE)"
+
+  # Create or update STATE.md with current focus
+  cat > "$STATE_FILE" << STATEMD
+# Project State
+
+## Current Focus
+Agent orchestration — $STATE (phase: ${PHASE:-none}). Score: $SCORE.
+
+## Known Blockers
+$(echo "$CURRENT_CONTRACT" | $PYTHON_CMD -c "
+import sys,json
+d=json.load(sys.stdin)
+r=d.get('retry',{})
+issues=r.get('issues',[])
+if issues:
+  for i in issues: print(f'- {i}')
+else:
+  print('None')
+" 2>/dev/null || echo "None")
+
+## Active Decisions
+$(echo "$CURRENT_CONTRACT" | $PYTHON_CMD -c "
+import sys,json
+d=json.load(sys.stdin)
+log=d.get('decisions',{}).get('adr_log',[])
+if log:
+  for entry in log[-3:]:
+    print(f'- {entry.get(\"id\",\"?\")}: {entry.get(\"title\",\"\")}')
+else:
+  print('No ADRs recorded')
+" 2>/dev/null || echo "None")
+
+## Recent Changes
+- Last state transition: $(echo "$CURRENT_CONTRACT" | $PYTHON_CMD -c "
+import sys,json
+d=json.load(sys.stdin)
+phases=d.get('metrics',{}).get('phases_completed',[])
+print(phases[-1] if phases else 'INIT')
+" 2>/dev/null || echo "INIT")
+STATEMD
+  echo "  ✅ STATE.md synced"
+fi
+
+# --- Step 4: Save ctx_session ---
+lean-ctx ctx_session save 2>/dev/null && \
+  echo "  ✅ Session saved" || \
+  echo "  ⚠️  ctx_session save skipped (not available)"
+
+# --- Step 5: Update telemetry summary ---
+if [ -f "$TELEMETRY_DIR/phases.jsonl" ] && [ -n "$PYTHON_CMD" ]; then
+  $PYTHON_CMD -c "
+import json
+total_ms = 0
+agents = set()
+phases = []
+with open('$TELEMETRY_DIR/phases.jsonl') as f:
+  for line in f:
+    line=line.strip()
+    if not line: continue
+    try:
+      entry=json.loads(line)
+      total_ms+=entry.get('elapsed_ms',0)
+      phases.append(entry.get('to',''))
+    except: pass
+
+summary = {
+  'phases_completed': phases,
+  'total_elapsed_ms': total_ms,
+  'total_elapsed_s': round(total_ms/1000, 1),
+  'updated_at': '$(date -u +%Y-%m-%dT%H:%M:%SZ)'
+}
+with open('$TELEMETRY_DIR/summary.json', 'w') as f:
+  json.dump(summary, f, indent=2)
+print(f'  📈 Telemetry summary: {len(phases)} phases, {total_ms/1000:.0f}s total')
+" 2>/dev/null || true
+fi
+
+echo "[opencode-kit] ✅ Post-flight complete."