@ikieaneh/opencode-kit 0.5.4 → 0.5.6

package/.opencode/plugins/opencode-kit.js

@@ -171,8 +171,20 @@ export const OpencodeKitPlugin = async ({ client, directory }) => {
       config.skills = config.skills || {};
       config.skills.paths = config.skills.paths || [];
 
+      // Detect if other plugins might conflict with opencode-kit's system prompt
+      if (config.plugins && Array.isArray(config.plugins)) {
+        const kitIndex = config.plugins.findIndex(p =>
+          typeof p === 'string' && p.includes('opencode-kit')
+        );
+        if (kitIndex > 0) {
+          const firstPlugin = config.plugins[0];
+          log('warn', `Plugin ordering conflict: opencode-kit should be FIRST, but found '${firstPlugin}' at position 0 and opencode-kit at position ${kitIndex}`);
+        }
+      }
+
       // Register user project skills FIRST (higher priority)
       const userSkillsDir = path.join(projectDir, '.opencode/skills');
+      const userSkillsDir = path.join(projectDir, '.opencode/skills');
       if (fs.existsSync(userSkillsDir) && !config.skills.paths.includes(userSkillsDir)) {
         config.skills.paths.push(userSkillsDir);
         log('info', `Registered user skills: ${userSkillsDir}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikieaneh/opencode-kit",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Standardized OpenCode orchestration framework — contract-based, rules-enforced, zero-touch agent workflow. Install as plugin.",
   "license": "MIT",
   "author": "RizkiRachman",

package/src/analytics.sh

@@ -0,0 +1,79 @@
+#!/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)"
+. "$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/doctor.sh

@@ -0,0 +1,123 @@
+#!/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)"
+. "$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
+
+# === 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
+
+# === 3. MCP 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
+
+# === 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/init.sh

@@ -138,6 +138,22 @@ if [ "$PLUGIN_MODE" = false ]; then
   chmod +x .opencode/src/telemetry.sh
   echo "  ✅ telemetry.sh (executable)"
 
+  cp "$KIT_DIR/src/doctor.sh" .opencode/src/doctor.sh
+  chmod +x .opencode/src/doctor.sh
+  echo "  ✅ doctor.sh (executable)"
+
+  cp "$KIT_DIR/src/status.sh" .opencode/src/status.sh
+  chmod +x .opencode/src/status.sh
+  echo "  ✅ status.sh (executable)"
+
+  cp "$KIT_DIR/src/new-skill.sh" .opencode/src/new-skill.sh
+  chmod +x .opencode/src/new-skill.sh
+  echo "  ✅ new-skill.sh (executable)"
+
+  cp "$KIT_DIR/src/analytics.sh" .opencode/src/analytics.sh
+  chmod +x .opencode/src/analytics.sh
+  echo "  ✅ analytics.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

package/src/new-skill.sh

@@ -0,0 +1,60 @@
+#!/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"

package/src/status.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# opencode-kit status — pretty terminal dashboard
+# Usage: bash src/status.sh
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+. "$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']
+required_mcps = list(r.get('required_mcps', {}).keys())
+required_mcps = [m for m in required_mcps if m != 'description']
+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/verify.sh

@@ -41,7 +41,7 @@ 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"; do
+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

package/templates/contract.json

@@ -53,7 +53,8 @@
       "max_test_failures": 3,
       "max_score_drop": 30,
       "max_compile_errors": 1
-    }
+    },
+    "rule_overrides": {}
   },
   "outputs": {
     "plan": null,