@ikieaneh/opencode-kit 0.6.1 → 0.6.3

package/src/preflight.sh

@@ -1,138 +0,0 @@
-#!/usr/bin/env bash
-# ⛔ opencode-kit preflight — MANDATORY enforcement gate
-# Must run before any tool call. Exits with error if rules violated.
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-CONTRACT_KEY="orchestration-contract"
-RULES_FILE=".opencode/rules/rules.json"
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-echo "[opencode-kit] ⛔ Pre-flight check..."
-
-# --- Check 1: contract.json exists on disk ---
-if [ ! -f "$CONTRACT_FILE" ]; then
-  echo -e "${RED}⛔ FAILED: $CONTRACT_FILE not found. Run 'opencode-kit init' first.${NC}"
-  exit 1
-fi
-echo "  ✅ contract.json exists"
-
-# --- Check 2: not on main ---
-BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  echo -e "${RED}⛔ FAILED: On '$BRANCH' branch. Create a feature branch first.${NC}"
-  echo "  → git checkout -b feature/<YYYYMMDD>-<description>"
-  exit 1
-fi
-echo "  ✅ Branch: $BRANCH (safe)"
-
-# --- Check 3: MCP Availability (from rules.json) ---
-echo ""
-echo "  Checking MCP availability from rules.json..."
-
-MCP_FAIL=0
-
-if [ -n "$PYTHON_CMD" ] && [ -f "$RULES_FILE" ]; then
-  # Parse required_mcps from rules.json
-  $PYTHON_CMD -c "
-import json, sys, subprocess, os
-
-with open('$RULES_FILE') as f:
-    rules = json.load(f)
-
-mcps = rules.get('required_mcps', {})
-if not isinstance(mcps, dict) or 'description' in mcps:
-    # Skip the meta-description field
-    mcps = {k: v for k, v in mcps.items() if k != 'description' and isinstance(v, dict)}
-
-if not mcps:
-    print('  ℹ️  No required_mcps defined in rules.json — skipping MCP checks')
-    sys.exit(0)
-
-failures = []
-for name, cfg in mcps.items():
-    cli_check = cfg.get('check_cli', '')
-    tool_check = cfg.get('check_tool', '')
-    severity = cfg.get('severity', 'optional')
-    desc = cfg.get('description', name)
-
-    available = False
-    # Try CLI check first
-    if cli_check:
-        try:
-            result = subprocess.run(cli_check, shell=True, capture_output=True, timeout=5)
-            if result.returncode == 0:
-                available = True
-        except:
-            pass
-
-    # Try tool check as fallback
-    if not available and tool_check:
-        try:
-            result = subprocess.run(tool_check, shell=True, capture_output=True, timeout=5)
-            if result.returncode == 0:
-                available = True
-        except:
-            pass
-
-    if available:
-        print(f'  ✅ {name}: available — {desc}')
-    elif severity == 'required':
-        print(f'  ❌ {name}: NOT DETECTED — {desc}')
-        failures.append(name)
-    else:
-        print(f'  ⚠️  {name}: not detected — {desc} (optional)')
-
-if failures:
-    print('')
-    for name in failures:
-        print(f'  → Ensure {name} is configured in opencode.json MCP servers')
-    sys.exit(1)
-else:
-    sys.exit(0)
-" 2>&1 || MCP_FAIL=1
-fi
-
-echo ""
-
-# --- Check 4: rules.json exists ---
-if [ ! -f "$RULES_FILE" ]; then
-  echo -e "${YELLOW}⚠️  WARNING: $RULES_FILE not found. Rules enforcement disabled.${NC}"
-else
-  echo "  ✅ rules.json found"
-fi
-
-# --- Telemetry: record phase start ---
-mkdir -p .opencode/telemetry
-echo $(date +%s) > .opencode/telemetry/.phase_start
-
-# --- Check 5: contract state validation ---
-if [ -n "$PYTHON_CMD" ] && [ -f "$CONTRACT_FILE" ]; then
-  STATE=$($PYTHON_CMD -c "
-import json,sys
-try:
-  with open('$CONTRACT_FILE') as f: d=json.load(f)
-  print(d.get('state','UNKNOWN'))
-except: print('PARSE_ERROR')
-" 2>/dev/null)
-  if [ "$STATE" = "PARSE_ERROR" ] || [ "$STATE" = "UNKNOWN" ]; then
-    echo -e "${YELLOW}  ⚠️  Contract state: unknown — contract.json may be malformed${NC}"
-  else
-    echo "  ✅ Contract state: $STATE"
-  fi
-fi
-
-# --- Final verdict ---
-if [ "$MCP_FAIL" -eq 1 ]; then
-  echo -e "${YELLOW}[opencode-kit] ⛔ Pre-flight completed with WARNINGS. Missing MCPs may cause failures.${NC}"
-else
-  echo "[opencode-kit] ✅ Pre-flight passed. All MCPs available. Proceed."
-fi

package/src/status.sh

@@ -1,113 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit status — pretty terminal dashboard
-# Usage: bash src/status.sh
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-RULES_FILE=".opencode/rules/rules.json"
-TELEMETRY_DIR=".opencode/telemetry"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-BOLD='\033[1m'
-NC='\033[0m'
-
-echo ""
-echo -e "${CYAN}${BOLD}##══════════════════════════════════════════╗${NC}"
-echo -e "${CYAN}${BOLD}#        opencode-kit Dashboard            #${NC}"
-echo -e "${CYAN}${BOLD}##══════════════════════════════════════════╝${NC}"
-echo ""
-
-# === Contract State ===
-if [ -f "$CONTRACT_FILE" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('$CONTRACT_FILE') as f:
-    c = json.load(f)
-
-state = c.get('state', 'UNKNOWN')
-ver = c.get('contract_version', '?')
-goal = c.get('requirements', {}).get('goal', 'Not set')
-phases = c.get('metrics', {}).get('phases_completed', [])
-score = c.get('score', {}).get('combined', 0)
-verdict = c.get('score', {}).get('verdict', 'PENDING')
-adrs = len(c.get('decisions', {}).get('adr_log', []))
-ext_skills = c.get('governance', {}).get('extension_skills', [])
-
-# State color
-state_colors = {
-    'INIT': '\033[0;36m',
-    'PLAN': '\033[1;33m',
-    'PLAN_SCORED': '\033[1;33m',
-    'EXECUTE': '\033[0;32m',
-    'EXECUTE_SCORED': '\033[0;32m',
-    'REVIEW': '\033[0;34m',
-    'REVIEW_SCORED': '\033[0;34m',
-    'COMPLETE': '\033[0;32m',
-    'BLOCKED': '\033[0;31m',
-}
-color = state_colors.get(state, '\033[0m')
-nc = '\033[0m'
-
-print(f'  ${BOLD}Contract State:${NC} {color}{state}{nc}  (v{ver})')
-print(f'  ${BOLD}Goal:${NC}           {goal[:70]}...' if len(goal) > 70 else f'  ${BOLD}Goal:${NC}           {goal}')
-print(f'  ${BOLD}Score:${NC}          {score}/100 ({verdict})')
-print(f'  ${BOLD}Phases:${NC}         {len(phases)} completed: {\" → \".join(phases[-4:])}')
-print(f'  ${BOLD}ADRs:${NC}           {adrs} recorded')
-if ext_skills:
-    print(f'  ${BOLD}Extension Skills:${NC} {\", \".join(ext_skills)}')
-" 2>/dev/null || echo "  ⚠️  Could not parse contract"
-else
-  echo -e "  ${YELLOW}⚠️  No contract found${NC}"
-fi
-
-# === Telemetry ===
-echo ""
-echo -e "${BOLD}⏱  Telemetry${NC}"
-if [ -f "$TELEMETRY_DIR/summary.json" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('$TELEMETRY_DIR/summary.json') as f:
-    t = json.load(f)
-total_s = t.get('total_elapsed_s', 0)
-phases = t.get('phases_completed', [])
-print(f'  Total time:  {total_s}s across {len(phases)} phases')
-" 2>/dev/null
-else
-  echo -e "  ${YELLOW}No telemetry data yet${NC}"
-fi
-
-# === Rules ===
-echo ""
-echo -e "${BOLD}📋 Rules${NC}"
-if [ -f "$RULES_FILE" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('$RULES_FILE') as f:
-    r = json.load(f)
-rules = r.get('rules', [])
-critical = [x for x in rules if x.get('severity') == 'CRITICAL']
-high = [x for x in rules if x.get('severity') == 'HIGH']
-    mcps = list(r.get('required_mcps', {}).keys())
-    mcps = [m for m in mcps if m != 'description']
-print(f'  {len(critical)} CRITICAL rules, {len(high)} HIGH rules')
-if mcps:
-    print(f'  Required MCPs: {\", \".join(mcps)}')
-" 2>/dev/null
-else
-  echo -e "  ${YELLOW}No rules.json${NC}"
-fi
-
-# === Quick actions ===
-echo ""
-echo -e "${BOLD}⚡ Quick Actions${NC}"
-echo "  bash .opencode/src/doctor.sh    — Run diagnostics"
-echo "  bash .opencode/src/telemetry.sh  — View telemetry details"
-echo "  bash .opencode/src/adr.sh        — Record new ADR"
-echo ""

package/src/telemetry.sh

@@ -1,67 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit telemetry — view phase telemetry
-# Usage: bash src/telemetry.sh [--json|--summary|--phases]
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-TELEMETRY_DIR=".opencode/telemetry"
-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'
-
-MODE="${1:-summary}"
-
-echo -e "${CYAN}[opencode-kit] 📊 Telemetry${NC}"
-echo ""
-
-case "$MODE" in
-  --json)
-    if [ -f "$TELEMETRY_DIR/summary.json" ]; then
-      cat "$TELEMETRY_DIR/summary.json"
-    else
-      echo -e "${YELLOW}No telemetry data yet. Run a phase first.${NC}"
-    fi
-    ;;
-  --phases)
-    if [ -f "$TELEMETRY_DIR/phases.jsonl" ]; then
-      echo "Phase transitions:"
-      cat "$TELEMETRY_DIR/phases.jsonl" | while IFS= read -r line; do
-        [ -z "$line" ] && continue
-        FROM=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('from','?'))" 2>/dev/null)
-        TO=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('to','?'))" 2>/dev/null)
-        MS=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('elapsed_ms',0))" 2>/dev/null)
-        printf "  %-20s → %-20s  %5.1fs\n" "$FROM" "$TO" "$($PYTHON_CMD -c "print($MS/1000)" 2>/dev/null || echo "0.0")"
-      done
-    else
-      echo -e "${YELLOW}No phase data yet.${NC}"
-    fi
-    ;;
-  --summary|*)
-    if [ -f "$TELEMETRY_DIR/summary.json" ]; then
-      TOTAL_S=$($PYTHON_CMD -c "import json; d=json.load(open('$TELEMETRY_DIR/summary.json')); print(d.get('total_elapsed_s',0))" 2>/dev/null || echo "0")
-      PHASES=$($PYTHON_CMD -c "import json; d=json.load(open('$TELEMETRY_DIR/summary.json')); print(len(d.get('phases_completed',[])))" 2>/dev/null || echo "0")
-      echo "  Total elapsed: ${TOTAL_S}s"
-      echo "  Phases completed: $PHASES"
-      echo ""
-      echo "  Latest phases:"
-      tail -5 "$TELEMETRY_DIR/phases.jsonl" 2>/dev/null | while IFS= read -r line; do
-        [ -z "$line" ] && continue
-        TS=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('ts','?'))" 2>/dev/null | cut -dT -f2 | cut -d. -f1)
-        FROM=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('from','?'))" 2>/dev/null)
-        TO=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('to','?'))" 2>/dev/null)
-        MS=$(echo "$line" | $PYTHON_CMD -c "import sys,json; d=json.load(sys.stdin); print(d.get('elapsed_ms',0))" 2>/dev/null)
-        echo "    $TS  $FROM → $TO  ($((MS/1000))s)"
-      done
-    else
-      echo -e "${YELLOW}No telemetry data yet. Run a phase first.${NC}"
-      echo "  Phases are recorded automatically by postflight.sh"
-    fi
-    ;;
-esac

package/src/update.sh

@@ -1,181 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit update — pull latest templates and scripts from GitHub
-# Preserves existing contract.json state (goal, scope, decisions).
-# Usage: bash src/update.sh [--dry-run] [--version <tag>]
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-DRY_RUN=false
-VERSION="main"
-REPO_URL="https://github.com/RizkiRachman/opencode-kit.git"
-
-# --- Parse args ---
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --dry-run) DRY_RUN=true; shift ;;
-    --version) VERSION="$2"; shift 2 ;;
-    -v) VERSION="$2"; shift 2 ;;
-    *) echo -e "${RED}Unknown: $1${NC}"; exit 1 ;;
-  esac
-done
-
-echo -e "${CYAN}[opencode-kit] 🔄 Update check${NC}"
-echo "  Current dir: $PWD"
-echo "  Source:      $REPO_URL (branch: $VERSION)"
-echo "  Dry run:     $DRY_RUN"
-echo ""
-
-# --- Check we're in an opencode-kit project ---
-if [ ! -d ".opencode" ]; then
-  echo -e "${RED}❌ No .opencode/ directory found. Are you in an opencode-kit project?${NC}"
-  exit 1
-fi
-
-# --- Clone latest to temp ---
-TEMP_DIR=$(mktemp -d /tmp/opencode-kit-XXXXX)
-echo "  Cloning latest version to $TEMP_DIR..."
-
-if ! git clone --depth 1 --branch "$VERSION" "$REPO_URL" "$TEMP_DIR" 2>/dev/null; then
-  echo -e "${RED}❌ Failed to clone $REPO_URL (branch: $VERSION)${NC}"
-  rm -rf "$TEMP_DIR"
-  exit 1
-fi
-echo "  ✅ Cloned"
-
-# --- Read versions ---
-CURRENT_VERSION=""
-if [ -f ".opencode/orchestration/contract.json" ]; then
-  CURRENT_VERSION=$($PYTHON_CMD -c "
-import json
-with open('.opencode/orchestration/contract.json') as f:
-  d=json.load(f)
-print(d.get('contract_version', 'unknown'))
-" 2>/dev/null || echo "unknown")
-fi
-
-LATEST_VERSION=$($PYTHON_CMD -c "
-import json
-with open('$TEMP_DIR/templates/contract.json') as f:
-  d=json.load(f)
-print(d.get('contract_version', 'unknown'))
-" 2>/dev/null || echo "unknown")
-
-echo "  Current version: $CURRENT_VERSION"
-echo "  Latest version:  $LATEST_VERSION"
-echo ""
-
-if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ] && [ "$VERSION" = "main" ]; then
-  echo -e "${GREEN}✅ Already up to date (v$CURRENT_VERSION)${NC}"
-  rm -rf "$TEMP_DIR"
-  exit 0
-fi
-
-# --- Backup contract state ---
-echo "  Backing up contract state..."
-STATE_BACKUP=$(mktemp /tmp/opencode-contract-state-XXXXX.json)
-$PYTHON_CMD -c "
-import json
-with open('.opencode/orchestration/contract.json') as f:
-  d = json.load(f)
-# Extract only the state fields to preserve
-state = {
-  'requirements': d.get('requirements', {}),
-  'scope': d.get('scope', {}),
-  'decisions': d.get('decisions', {}),
-  'governance': d.get('governance', {}),
-  'metrics': d.get('metrics', {}),
-  'lessons_learned': d.get('lessons_learned', []),
-  'retry': d.get('retry', {}),
-  'score': d.get('score', {}),
-  'outputs': d.get('outputs', {})
-}
-with open('$STATE_BACKUP', 'w') as f:
-  json.dump(state, f, indent=2)
-" 2>/dev/null || echo "  ⚠️  Could not backup contract state"
-echo "  ✅ State backed up"
-
-# --- Files to update ---
-echo ""
-echo "  Files to update:"
-UPDATES=0
-
-update_file() {
-  local src="$1"
-  local dst="$2"
-  local label="$3"
-  if [ -f "$src" ]; then
-    if [ "$DRY_RUN" = true ]; then
-      echo "  [DRY-RUN] Would update: $label"
-    else
-      cp "$src" "$dst"
-      chmod +x "$dst" 2>/dev/null || true
-      echo "  ✅ Updated: $label"
-    fi
-    UPDATES=$((UPDATES + 1))
-  else
-    echo "  ⚠️  Source not found: $src"
-  fi
-}
-
-# Update scripts
-for script in preflight.sh postflight.sh verify.sh adr.sh platform.sh; do
-  update_file "$TEMP_DIR/src/$script" ".opencode/src/$script" "src/$script"
-done
-
-# Update init.sh (for future --force re-inits)
-update_file "$TEMP_DIR/src/init.sh" ".opencode/src/init.sh" "src/init.sh"
-
-# Update update.sh itself
-update_file "$TEMP_DIR/src/update.sh" ".opencode/src/update.sh" "src/update.sh"
-
-# Update rules
-update_file "$TEMP_DIR/rules/rules.json" ".opencode/rules/rules.json" "rules/rules.json"
-update_file "$TEMP_DIR/rules/validation.sh" ".opencode/rules/validation.sh" "rules/validation.sh"
-
-# Update agent templates (but NOT contract.json — preserve state)
-for agent in orchestrator planner task-manager code-reviewer learner fixer; do
-  update_file "$TEMP_DIR/templates/agents/$agent.md" ".opencode/agents/$agent.md" "agents/$agent.md"
-done
-
-# Update superpowers contract template
-update_file "$TEMP_DIR/templates/superpowers-contract.json" ".opencode/templates/superpowers-contract.json" "superpowers-contract.json"
-
-# --- Restore contract state ---
-if [ "$DRY_RUN" = false ] && [ -f "$STATE_BACKUP" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('.opencode/orchestration/contract.json') as f:
-  contract = json.load(f)
-with open('$STATE_BACKUP') as f:
-  state = json.load(f)
-# Merge preserved state back into new contract
-for key, val in state.items():
-  if val:  # only overwrite if backup has data
-    contract[key] = val
-# Update contract_version to latest
-contract['contract_version'] = '$LATEST_VERSION'
-with open('.opencode/orchestration/contract.json', 'w') as f:
-  json.dump(contract, f, indent=2)
-" 2>/dev/null && echo "  ✅ Contract state restored" || echo "  ⚠️  Contract state restore failed"
-fi
-
-# --- Cleanup ---
-rm -rf "$TEMP_DIR" "$STATE_BACKUP"
-
-# --- Summary ---
-echo ""
-if [ "$DRY_RUN" = true ]; then
-  echo -e "${YELLOW}[opencode-kit] 🔄 Dry run complete. $UPDATES files would be updated.${NC}"
-else
-  echo -e "${GREEN}[opencode-kit] ✅ Update complete. $UPDATES files updated.${NC}"
-  echo "  Run .opencode/src/verify.sh to verify installation."
-fi

package/src/verify.sh

@@ -1,67 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit verify — check installation health
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-echo "[opencode-kit] 🔍 Verify: checking installation..."
-FAIL=0
-
-# --- Check 1: required files exist ---
-for f in \
-  ".opencode/orchestration/contract.json" \
-  ".opencode/rules/rules.json" \
-  ".opencode/templates/superpowers-contract.json"; do
-  if [ -f "$f" ]; then
-    echo "  ✅ $f"
-  else
-    echo "  ❌ $f MISSING"
-    FAIL=1
-  fi
-done
-
-# --- Check 2: agent .md files exist ---
-for agent in orchestrator planner task-manager code-reviewer learner fixer; do
-  FILE=".opencode/agents/$agent.md"
-  if [ -f "$FILE" ]; then
-    # Check pre-flight gate exists in file
-    if grep -q "load contract" "$FILE" 2>/dev/null; then
-      echo "  ✅ agents/$agent.md (has pre-flight gate)"
-    else
-      echo "  ⚠️  agents/$agent.md (MISSING pre-flight gate)"
-    fi
-  else
-    echo "  ❌ agents/$agent.md MISSING"
-    FAIL=1
-  fi
-done
-
-# --- Check 3: telemetry directory ---
-mkdir -p .opencode/telemetry 2>/dev/null
-echo "  ✅ telemetry directory ready"
-
-# --- Check 4: scripts executable ---
-for script in ".opencode/src/preflight.sh" ".opencode/src/postflight.sh" ".opencode/src/telemetry.sh" ".opencode/src/doctor.sh" ".opencode/src/status.sh"; do
-  if [ -x "$script" ]; then
-    echo "  ✅ $script (executable)"
-  elif [ -f "$script" ]; then
-    echo "  ⚠️  $script (not executable — run chmod +x)"
-  else
-    echo "  ❌ $script MISSING"
-    FAIL=1
-  fi
-done
-
-# --- Check 5: not on main ---
-BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  echo "  ⚠️  On '$BRANCH' branch — create a feature branch"
-fi
-echo "  ℹ️  Branch: $BRANCH"
-
-if [ "$FAIL" -eq 1 ]; then
-  echo "[opencode-kit] ❌ Verify FAILED — run 'opencode-kit init' to repair"
-  exit 1
-fi
-
-echo "[opencode-kit] ✅ All checks passed"