@ikieaneh/opencode-kit 0.6.2 → 0.6.3

package/docs/plans/2026-06-11-plugin-architecture.md

@@ -1,55 +0,0 @@
-# Plugin Architecture — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development
-
-**Goal:** Convert opencode-kit from a per-project scaffold to a global OpenCode plugin with local-override config
-
-**Architecture:** Pure JS plugin (superpowers pattern) using `@opencode-ai/plugin` SDK. Global config at `~/.config/opencode-kit/`, project override at `.opencode/`. Plugin registers skills + system prompt transform.
-
-**Tech Stack:** Node.js, @opencode-ai/plugin SDK, shell scripts
-
----
-
-### Task 1: Plugin Entry Point
-
-**Files:**
-- Create: `.opencode/plugins/opencode-kit.js` — main plugin JS
-- Create: `.claude-plugin/plugin.json` — metadata
-- Modify: `package.json` — add plugin entry, `@opencode-ai/plugin` dependency
-
-- [ ] Create `.opencode/plugins/opencode-kit.js` — system prompt transform hook that injects contract loading + preflight
-- [ ] Create `.claude-plugin/plugin.json` — name, description, version, author
-- [ ] Update `package.json` — `"main": ".opencode/plugins/opencode-kit.js"`, add `@opencode-ai/plugin` dep
-
-### Task 2: Global Config Resolution
-
-**Files:**
-- Create: `src/global-config.sh` — resolve config from local → global → plugin default
-
-- [ ] Write resolution chain: `.opencode/` → `~/.config/opencode-kit/` → plugin `templates/`
-- [ ] Add `init-global` command to copy plugin defaults to `~/.config/opencode-kit/`
-
-### Task 3: Plugin Schema
-
-**Files:**
-- Create: `templates/opencode-kit.schema.json` — validate opencode.json agent config
-
-- [ ] Schema defines default agents (orchestrator, planner, task-manager, etc.)
-- [ ] Documents plugin ordering requirement (must be first in plugin array)
-
-### Task 4: Init Coexistence
-
-**Files:**
-- Modify: `src/init.sh` — detect plugin, skip plugin-handled tasks
-
-- [ ] If plugin detected (via `.opencode/plugins/opencode-kit.js`), skip skill/agent scaffolding
-- [ ] Only scaffold per-project data: contract.json goal/scope, STATE.md, PROJECT.md
-
-### Task 5: Documentation
-
-**Files:**
-- Modify: `README.md` — plugin installation, ordering requirement
-- Modify: `CHANGELOG.md`
-
-- [ ] Add "Install as plugin" section to README
-- [ ] Document global vs local resolution

package/src/adr.sh

@@ -1,148 +0,0 @@
-#!/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)"
-# shellcheck source=./platform.sh
-. "$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=$(CONTRACT_FILE="$CONTRACT_FILE" $PYTHON_CMD -c "
-import json, os
-with open(os.environ['CONTRACT_FILE']) as f: d = json.load(f)
-log = d.get('decisions', {}).get('adr_log', [])
-if not log:
-  print('ADR-001')
-else:
-  last = 0
-  for entry in log:
-    try:
-      num = int(entry.get('id','ADR-000').replace('ADR-',''))
-      if num > last: last = num
-    except ValueError:
-      continue
-  print(f'ADR-{last+1:03d}')
-")
-
-# --- Check for duplicate title ---
-DUP=$(CONTRACT_FILE="$CONTRACT_FILE" TITLE="$TITLE" $PYTHON_CMD -c "
-import json, os
-with open(os.environ['CONTRACT_FILE']) as f: d = json.load(f)
-log = d.get('decisions', {}).get('adr_log', [])
-search_title = os.environ.get('TITLE', '').lower().strip()
-for entry in log:
-  if entry.get('title','').lower().strip() == search_title:
-    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 via Python (avoids shell injection) ---
-ENTRY_FILE=$(mktemp /tmp/opencode-adr-entry-XXXXX.json)
-trap 'rm -f "$ENTRY_FILE"' EXIT INT TERM
-
-TITLE="$TITLE" CONTEXT="$CONTEXT" DECISION="$DECISION" ALTERNATIVES="$ALTERNATIVES" CONSEQUENCES="$CONSEQUENCES" NEXT_ID="$NEXT_ID" ENTRY_FILE="$ENTRY_FILE" $PYTHON_CMD -c "
-import json, os
-from datetime import date
-
-entry = {
-    'id': os.environ['NEXT_ID'],
-    'date': date.today().isoformat(),
-    'title': os.environ.get('TITLE', ''),
-    'context': os.environ.get('CONTEXT', ''),
-    'decision': os.environ.get('DECISION', ''),
-    'alternatives': os.environ.get('ALTERNATIVES', ''),
-    'consequences': os.environ.get('CONSEQUENCES', '')
-}
-
-with open(os.environ['ENTRY_FILE'], 'w') as f:
-    json.dump(entry, f, indent=2)
-print('Entry written')
-"
-
-# --- Inject into contract.json ---
-CONTRACT_FILE="$CONTRACT_FILE" ENTRY_FILE="$ENTRY_FILE" $PYTHON_CMD -c "
-import json, os
-
-with open(os.environ['CONTRACT_FILE']) as f:
-  contract = json.load(f)
-
-with open(os.environ['ENTRY_FILE']) 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(os.environ['CONTRACT_FILE'], 'w') as f:
-  json.dump(contract, f, indent=2)
-
-print(json.dumps(entry, indent=2))
-"
-
-rm -f "$ENTRY_FILE"
-
-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/analytics.sh

@@ -1,80 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit analytics — aggregate telemetry across phases
-# Usage: bash src/analytics.sh [--json]
-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:-table}"
-
-echo -e "${CYAN}📊 opencode-kit Analytics${NC}"
-echo ""
-
-if [ ! -f "$TELEMETRY_DIR/phases.jsonl" ] || [ ! -f "$TELEMETRY_DIR/summary.json" ]; then
-  echo -e "${YELLOW}No telemetry data yet. Run a few phases first.${NC}"
-  exit 0
-fi
-
-if [ -z "$PYTHON_CMD" ]; then
-  echo -e "${RED}Python required for analytics.${NC}"
-  exit 1
-fi
-
-$PYTHON_CMD -c "
-import json
-
-# Load phases
-phases = []
-try:
-    with open('$TELEMETRY_DIR/phases.jsonl') as f:
-        for line in f:
-            line = line.strip()
-            if line:
-                phases.append(json.loads(line))
-except:
-    pass
-
-# Load summary
-summary = {}
-try:
-    with open('$TELEMETRY_DIR/summary.json') as f:
-        summary = json.load(f)
-except:
-    pass
-
-if not phases:
-    print('  No phases recorded')
-    exit(0)
-
-total_ms = sum(p.get('elapsed_ms', 0) for p in phases)
-avg_ms = total_ms / len(phases) if phases else 0
-
-print(f'  Total sessions:  {len(phases)}')
-print(f'  Total time:      {total_ms/1000:.1f}s ({total_ms/60000:.1f}m)')
-print(f'  Avg per phase:   {avg_ms/1000:.1f}s')
-print('')
-print(f'  Phase Breakdown:')
-for p in phases:
-    frm = p.get('from', '?')
-    to = p.get('to', '?')
-    ms = p.get('elapsed_ms', 0)
-    bar = '#' * max(1, int(ms / max(1, total_ms) * 30))
-    print(f'    {frm:16s} → {to:16s}  {ms/1000:6.1f}s  {bar}')
-
-# Cost estimate (rough: ~$0.15/1M tokens, ~1000 tok/s)
-est_tokens = int(total_ms / 1000 * 1000)  # rough: 1000 tok/sec
-est_cost = est_tokens / 1_000_000 * 0.15
-print(f'')
-print(f'  Estimated tokens: {est_tokens:,} (~{est_cost:.4f} USD at $0.15/1M tok)')
-" 2>/dev/null || echo "  ⚠️  Analytics failed"

package/src/diff.sh

@@ -1,109 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit diff — compare contract state between branches
-# Usage: bash src/diff.sh [branch1] [branch2]
-#   Default: compares current branch vs main
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-BRANCH_A="${1:-main}"
-BRANCH_B="${2:-HEAD}"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-echo -e "${CYAN}📋 opencode-kit diff: $BRANCH_A ↔ $BRANCH_B${NC}"
-echo ""
-
-# Extract contract from a git ref
-get_contract_state() {
-  local branch="$1"
-  local content
-  content=$(git show "$branch:$CONTRACT_FILE" 2>/dev/null || echo "")
-  if [ -z "$content" ]; then
-    echo ""
-    return 1
-  fi
-  echo "$content"
-}
-
-CONTRACT_A=$(get_contract_state "$BRANCH_A")
-CONTRACT_B=$(get_contract_state "$BRANCH_B")
-
-if [ -z "$CONTRACT_A" ] && [ -z "$CONTRACT_B" ]; then
-  echo -e "${YELLOW}No contract found in either branch.${NC}"
-  exit 0
-fi
-
-# Show state diff
-# Write contract data to temp files for safe Python consumption
-CONTRACT_A_FILE=$(mktemp /tmp/opencode-diff-a-XXXXXX.json 2>/dev/null || mktemp /tmp/opencode-diff-a-XXXXXX)
-CONTRACT_B_FILE=$(mktemp /tmp/opencode-diff-b-XXXXXX.json 2>/dev/null || mktemp /tmp/opencode-diff-b-XXXXXX)
-trap 'rm -f "$CONTRACT_A_FILE" "$CONTRACT_B_FILE"' EXIT INT TERM
-
-echo "$CONTRACT_A" > "$CONTRACT_A_FILE"
-echo "$CONTRACT_B" > "$CONTRACT_B_FILE"
-
-if [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json, sys
-
-def get_state(filepath):
-    try:
-        with open(filepath) as f:
-            content = f.read().strip()
-        if not content:
-            return None
-        d = json.loads(content)
-        return {
-            'state': d.get('state', '?'),
-            'goal': (d.get('requirements', {}) or {}).get('goal', '?'),
-            'score': (d.get('score', {}) or {}).get('combined', '?'),
-            'phases': (d.get('metrics', {}) or {}).get('phases_completed', []),
-            'adrs': len((d.get('decisions', {}) or {}).get('adr_log', [])),
-            'version': d.get('contract_version', '?')
-        }
-    except:
-        return None
-
-a = get_state('$CONTRACT_A_FILE')
-b = get_state('$CONTRACT_B_FILE')
-
-if a and b:
-    print(f'  Field                   $BRANCH_A          $BRANCH_B')
-    print(f'  {\"-\"*50}')
-    for field in ['state', 'goal', 'score', 'version']:
-        va = str(a.get(field, '?'))[:20]
-        vb = str(b.get(field, '?'))[:20]
-        marker = ' ←→' if va != vb else '   '
-        print(f'  {field:20s}  {va:20s} {marker} {vb:20s}')
-    print(f'  phases                 {len(a.get(\"phases\",[])):3d} completed     {len(b.get(\"phases\",[])):3d} completed')
-    print(f'  ADRs                   {a.get(\"adrs\",0):3d} recorded      {b.get(\"adrs\",0):3d} recorded')
-elif a and not b:
-    print(f'  Contract exists in $BRANCH_A but NOT in $BRANCH_B')
-    print(f'  State: {a.get(\"state\",\"?\")}')
-elif b and not a:
-    print(f'  Contract exists in $BRANCH_B but NOT in $BRANCH_A')
-    print(f'  State: {b.get(\"state\",\"?\")}')
-" 2>/dev/null || echo -e "${YELLOW}Could not parse contract JSON${NC}"
-
-rm -f "$CONTRACT_A_FILE" "$CONTRACT_B_FILE"
-fi
-
-# Raw git diff
-echo ""
-echo -e "${CYAN}Raw diff:${NC}"
-if git diff "$BRANCH_A" "$BRANCH_B" -- "$CONTRACT_FILE" 2>/dev/null | head -40; then
-  if ! git diff --exit-code "$BRANCH_A" "$BRANCH_B" -- "$CONTRACT_FILE" &>/dev/null; then
-    :
-  fi
-fi
-echo ""
-echo -e "Run: ${GREEN}bash .opencode/src/diff.sh${NC} (default: main vs HEAD)"
-echo -e "     ${GREEN}bash .opencode/src/diff.sh staging feature-x${NC} (custom branches)"

package/src/doctor.sh

@@ -1,160 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit doctor — diagnostic command
-# Checks: MCPs, contract, rules, permissions, git branch, agent configs
-# Usage: bash src/doctor.sh [--json] [--fix]
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-. "$SCRIPT_DIR/global-config.sh"
-
-RULES_FILE=".opencode/rules/rules.json"
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-OPENCODE_JSON="opencode.json"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-ISSUES=0
-mode="${1:-}"
-
-echo -e "${CYAN}🔍 opencode-kit doctor${NC}"
-echo ""
-
-# === 1. Contract check ===
-echo -e "${CYAN}[CONTRACT]${NC} Checking orchestration contract..."
-if [ ! -f "$CONTRACT_FILE" ]; then
-  echo -e "  ${RED}❌ contract.json not found — run 'opencode-kit init'${NC}"
-  ISSUES=$((ISSUES + 1))
-else
-  if [ -n "$PYTHON_CMD" ]; then
-    STATE=$($PYTHON_CMD -c "import json; d=json.load(open('$CONTRACT_FILE')); print(d.get('state','?'))" 2>/dev/null || echo "parse_error")
-    if [ "$STATE" = "parse_error" ]; then
-      echo -e "  ${RED}❌ contract.json is malformed JSON${NC}"
-      ISSUES=$((ISSUES + 1))
-    else
-      echo -e "  ✅ State: $STATE"
-    fi
-  fi
-fi
-
-# === 1b. Contract schema validation ===
-SCHEMA_FILE=".opencode/templates/contract.schema.json"
-if [ -f "$CONTRACT_FILE" ] && [ -f "$SCHEMA_FILE" ] && [ -n "$PYTHON_CMD" ]; then
-  if $PYTHON_CMD -c "
-import json, sys
-with open('$CONTRACT_FILE') as f: contract = json.load(f)
-with open('$SCHEMA_FILE') as f: schema = json.load(f)
-# Basic required-field validation
-errors = []
-if not contract.get('state'): errors.append('Missing state')
-if not contract.get('requirements', {}).get('goal'): errors.append('Missing requirements.goal')
-if contract.get('state') not in ['INIT','PLAN','PLAN_SCORED','EXECUTE','EXECUTE_SCORED','REVIEW','REVIEW_SCORED','COMPLETE','BLOCKED']:
-  errors.append('Invalid state')
-if errors:
-  print('; '.join(errors))
-  sys.exit(1)
-else:
-  print('OK')
-" 2>/dev/null; then
-    echo -e "  ✅ Contract schema valid"
-  else
-    echo -e "  ⚠️  Contract schema issues found (non-blocking)"
-    ISSUES=$((ISSUES + 1))
-  fi
-fi
-
-# === 2. Rules check ===
-echo -e "${CYAN}[RULES]${NC} Checking rules.json..."
-if [ ! -f "$RULES_FILE" ]; then
-  echo -e "  ${RED}❌ rules.json not found${NC}"
-  ISSUES=$((ISSUES + 1))
-else
-  if [ -n "$PYTHON_CMD" ]; then
-    RULE_COUNT=$($PYTHON_CMD -c "import json; d=json.load(open('$RULES_FILE')); print(len(d.get('rules',[])))" 2>/dev/null || echo "0")
-    echo -e "  ✅ $RULE_COUNT rules loaded"
-  fi
-fi
-
-# === 3a. MCP CLI checks ===
-echo -e "${CYAN}[MCP]${NC} Checking required MCPs..."
-if [ -f "$RULES_FILE" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json, subprocess, sys
-with open('$RULES_FILE') as f:
-    rules = json.load(f)
-mcps = rules.get('required_mcps', {})
-mcps.pop('description', None)
-for name, cfg in mcps.items():
-    cli = cfg.get('check_cli', '')
-    severity = cfg.get('severity', 'optional')
-    result = subprocess.run(cli, shell=True, capture_output=True, timeout=5)
-    ok = result.returncode == 0
-    if ok:
-        print(f'  ✅ {name}: available')
-    elif severity == 'required':
-        print(f'  ❌ {name}: MISSING (required)')
-        sys.exit(1)
-    else:
-        print(f'  ⚠️  {name}: not detected (optional)')
-" 2>/dev/null || ISSUES=$((ISSUES + 1))
-fi
-
-# === 3b. MCP connectivity ===
-echo -e "${CYAN}[MCP_CONNECT]${NC} Testing MCP connectivity..."
-if command -v lean-ctx &>/dev/null; then
-  if lean-ctx ctx_knowledge status &>/dev/null 2>&1; then
-    echo -e "  ✅ lean-ctx MCP: responding"
-  else
-    echo -e "  ⚠️  lean-ctx CLI found but MCP not responding (expected in CI)"
-  fi
-fi
-
-# === 4. Git branch ===
-echo -e "${CYAN}[GIT]${NC} Checking branch..."
-BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  echo -e "  ${YELLOW}⚠️  On '$BRANCH' — create a feature branch for development${NC}"
-else
-  echo -e "  ✅ Branch: $BRANCH"
-fi
-
-# === 5. Lean-ctx persistence ===
-echo -e "${CYAN}[PERSIST]${NC} Checking persistence..."
-if command -v lean-ctx &>/dev/null; then
-  echo -e "  ✅ lean-ctx CLI available"
-  LEAN_OK=$(lean-ctx ctx_knowledge recall --query "orchestration-contract" &>/dev/null && echo "yes" || echo "no")
-  if [ "$LEAN_OK" = "yes" ]; then
-    echo -e "  ✅ Contract found in lean-ctx"
-  else
-    echo -e "  ⚠️  Contract not in lean-ctx (file fallback active)"
-  fi
-else
-  echo -e "  ⚠️  lean-ctx not detected (file fallback active)"
-fi
-
-# === 6. Plugin in opencode.json ===
-echo -e "${CYAN}[PLUGIN]${NC} Checking plugin configuration..."
-if [ -f "$OPENCODE_JSON" ]; then
-  if grep -q "@ikieaneh/opencode-kit" "$OPENCODE_JSON" 2>/dev/null; then
-    echo -e "  ✅ Plugin registered in opencode.json"
-  else
-    echo -e "  ${YELLOW}⚠️  Plugin not found in opencode.json — add to your plugin array${NC}"
-  fi
-else
-  echo -e "  ${YELLOW}⚠️  No opencode.json found${NC}"
-fi
-
-# === Summary ===
-echo ""
-if [ "$ISSUES" -eq 0 ]; then
-  echo -e "${GREEN}✅ All checks passed. System healthy.${NC}"
-  exit 0
-else
-  echo -e "${RED}❌ $ISSUES issue(s) found. Review warnings above.${NC}"
-  exit 1
-fi

package/src/global-config.sh

@@ -1,82 +0,0 @@
-#!/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)"
-# shellcheck source=./platform.sh
-. "$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/new-skill.sh

@@ -1,60 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit new skill — scaffold a new skill SKILL.md
-# Usage: bash src/new-skill.sh <skill-name> [description]
-set -euo pipefail
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-NAME="${1:-}"
-DESC="${2:-A custom skill for this project}"
-SKILLS_DIR=".opencode/skills"
-
-if [ -z "$NAME" ]; then
-  echo -e "${RED}Usage: bash src/new-skill.sh <skill-name> [description]${NC}"
-  echo "  Example: bash src/new-skill.sh python-conventions \"Python/Django conventions\""
-  exit 1
-fi
-
-SKILL_PATH="$SKILLS_DIR/$NAME"
-SKILL_FILE="$SKILL_PATH/SKILL.md"
-
-if [ -d "$SKILL_PATH" ]; then
-  echo -e "${RED}❌ Skill already exists: $SKILL_PATH${NC}"
-  exit 1
-fi
-
-mkdir -p "$SKILL_PATH"
-
-cat > "$SKILL_FILE" << SKILLEOF
----
-description: $DESC
----
-
-# $NAME
-
-## Conventions
-
-...
-
-## Commands
-
-| Action | Command |
-|--------|---------|
-| Test | ... |
-| Build | ... |
-| Format | ... |
-
-## Rules
-
-...
-SKILLEOF
-
-echo -e "${GREEN}✅ Skill created: $SKILL_FILE${NC}"
-echo ""
-echo "  To use it, add to opencode.json:"
-echo '  "skills": ["'$NAME'", "orchestration-template"]'
-echo ""
-echo "  Or load it ad-hoc with: /skill $NAME"