@jairodri/huckleberry-cli 1.0.0

package/scripts/heartbeat.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Huckleberry Heartbeat — reads taskmaster and reports status
+# Called by cron every 2-4 hours
+set -euo pipefail
+
+HB_DIR="${HOME}/.huckleberry"
+TASK_FILE="${HB_DIR}/taskmaster/tasks/tasks.json"
+STATE_FILE="${HB_DIR}/heartbeat-state.json"
+LOG="${HB_DIR}/heartbeat.log"
+
+log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> "$LOG"; }
+
+if [ ! -f "$TASK_FILE" ]; then
+    log "No task file found — first run or empty"
+    echo '{"last_report": null, "tasks_since_last": []}' > "$STATE_FILE"
+    exit 0
+fi
+
+log "=== Heartbeat ==="
+
+# Read task statuses
+COMPLETED=$(python3 -c "
+import json
+with open('$TASK_FILE') as f: d = json.load(f)
+tasks = d.get('tasks', [])
+done = [t for t in tasks if t.get('status') == 'done']
+active = [t for t in tasks if t.get('status') == 'in-progress']
+blocked = [t for t in tasks if t.get('status') == 'blocked']
+print(f'{len(done)}|{len(active)}|{len(blocked)}')
+" 2>/dev/null || echo "0|0|0")
+
+echo "$COMPLETED"
+log "Status: $COMPLETED tasks (done|active|blocked)"
+
+# Save state for COS to read
+echo "{
+  \"checked_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",
+  \"task_summary\": \"$COMPLETED\"
+}" > "$STATE_FILE"
+
+log "=== Heartbeat complete ==="

package/scripts/install-services.ps1

@@ -0,0 +1,82 @@
+# Huckleberry Windows Services Setup
+# Creates Scheduled Tasks matching the 12 macOS launchd agents
+# Run as Administrator: Right-click > Run as Administrator
+
+$hbDir = "$env:USERPROFILE\.huckleberry"
+$kimakiDir = "$env:USERPROFILE\.kimaki"
+$logDir = "$env:USERPROFILE\.huckleberry\logs"
+New-Item -ItemType Directory -Path $logDir -Force | Out-Null
+
+function New-Task {
+    param(
+        [string]$Name,
+        [string]$Command,
+        [string]$Args = "",
+        [string]$Trigger = "AtStartup",
+        [int]$IntervalSeconds = 0,
+        [string]$Description = ""
+    )
+
+    $taskName = "Huckleberry-$Name"
+    $action = New-ScheduledTaskAction -Execute $Command -Argument $Args
+    $settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1)
+
+    if ($Trigger -eq "AtStartup") {
+        $trigger = New-ScheduledTaskTrigger -AtStartup -RandomDelay (New-TimeSpan -Seconds 30)
+    } elseif ($Trigger -eq "Repetition") {
+        $trigger = New-ScheduledTaskTrigger -Once -At (Get-Date) -RepetitionInterval (New-TimeSpan -Seconds $IntervalSeconds) -RepetitionDuration ([TimeSpan]::MaxValue)
+    }
+
+    try {
+        Unregister-ScheduledTask -TaskName $taskName -Confirm:$false -ErrorAction SilentlyContinue
+        Register-ScheduledTask -TaskName $taskName -Action $action -Trigger $trigger -Settings $settings -Description $Description -Force | Out-Null
+        Write-Host "  [OK] $taskName" -ForegroundColor Green
+    } catch {
+        Write-Host "  [WARN] $taskName — $_" -ForegroundColor Yellow
+    }
+}
+
+Write-Host ""
+Write-Host "  Huckleberry — Setting up Windows services..." -ForegroundColor Cyan
+Write-Host ""
+
+# 1. kimaki bot (KeepAlive = always running)
+New-Task -Name "kimaki-bot" -Command "powershell.exe" -Args "-WindowStyle Hidden -Command `"cd '$kimakiDir'; .\start-kimaki.sh`"" -Description "Huckleberry kimaki Discord bridge"
+
+# 2. kimaki watchdog
+New-Task -Name "kimaki-watchdog" -Command "node" -Args "$kimakiDir\watchdog\index.js" -Description "Huckleberry kimaki watchdog"
+
+# 3. Health monitor (every 5 min)
+New-Task -Name "kimaki-monitor" -Command "powershell.exe" -Args "-WindowStyle Hidden -File `"$hbDir\scripts\keepalive.ps1`"" -Trigger "Repetition" -IntervalSeconds 300 -Description "Huckleberry health monitor (every 5min)"
+
+# 4. Kanban server
+New-Task -Name "kanban-server" -Command "node" -Args "$hbDir\kanban\src\server.mjs" -Description "Huckleberry kanban API server"
+
+# 5. Kanban dispatcher
+New-Task -Name "kanban-dispatcher" -Command "node" -Args "$hbDir\kanban\src\dispatcher.mjs" -Description "Huckleberry kanban task dispatcher"
+
+# 6. Kanban completion watchdog
+New-Task -Name "kanban-completion-watchdog" -Command "node" -Args "$hbDir\kanban\src\completion-watchdog.mjs" -Description "Huckleberry kanban completion tracker"
+
+# 7. Kanban stall detector
+New-Task -Name "kanban-stall-detector" -Command "node" -Args "$hbDir\kanban\src\stall-detector.mjs" -Description "Huckleberry kanban stall detection"
+
+# 8. Kanban tunnel (keepalive)
+New-Task -Name "kanban-tunnel" -Command "powershell.exe" -Args "-WindowStyle Hidden -File `"$hbDir\scripts\keepalive.ps1`"" -Description "Huckleberry kanban tunnel keepalive"
+
+# 9. Dream dispatcher (every 30 min)
+New-Task -Name "dream-dispatcher" -Command "node" -Args "$hbDir\taskmaster\dispatcher.mjs" -Trigger "Repetition" -IntervalSeconds 1800 -Description "Huckleberry dream cycle dispatcher (every 30min)"
+
+# 10. Dream distiller (hourly)
+New-Task -Name "dream-distiller" -Command "powershell.exe" -Args "-WindowStyle Hidden -File `"$hbDir\scripts\heartbeat.ps1`"" -Trigger "Repetition" -IntervalSeconds 3600 -Description "Huckleberry memory distiller"
+
+# 11. Keystone load balancer
+New-Task -Name "keystone" -Command "node" -Args "$env:USERPROFILE\keystone\keystone.js" -Description "Huckleberry keystone load balancer"
+
+# 12. Monitor and notify (every 5 min)
+New-Task -Name "monitor-and-notify" -Command "powershell.exe" -Args "-WindowStyle Hidden -File `"$hbDir\scripts\heartbeat.ps1`"" -Trigger "Repetition" -IntervalSeconds 300 -Description "Huckleberry notifications"
+
+Write-Host ""
+Write-Host "  Services configured. Start manually or reboot." -ForegroundColor Green
+Write-Host "  To remove: .\huckleberry\scripts\uninstall-services.ps1" -ForegroundColor DarkGray
+Write-Host ""

package/scripts/install-services.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# Huckleberry macOS Services Setup
+# Installs launchd plist files matching the 12 agents
+set -euo pipefail
+
+HB_DIR="$HOME/.huckleberry"
+LAUNCH_DIR="$HOME/Library/LaunchAgents"
+LOG_DIR="$HB_DIR/logs"
+mkdir -p "$LAUNCH_DIR" "$LOG_DIR"
+
+SERVICES=(
+  # Name, Label, Program, Args, Interval (0 = KeepAlive)
+  "kimaki-bot:com.huckleberry.kimaki.bot:/bin/bash:$HOME/.kimaki/start-kimaki.sh:0"
+  "kimaki-watchdog:com.huckleberry.kimaki.watchdog:/opt/homebrew/bin/node:$HOME/.kimaki/watchdog/index.js:0"
+  "kimaki-monitor:com.huckleberry.kimaki.monitor:/bin/bash:$HB_DIR/scripts/keepalive.sh:300"
+  "kanban-server:com.huckleberry.kanban.server:/opt/homebrew/bin/node:$HB_DIR/kanban/src/server.mjs:0"
+  "kanban-dispatcher:com.huckleberry.kanban.dispatcher:/opt/homebrew/bin/node:$HB_DIR/kanban/src/dispatcher.mjs:0"
+  "kanban-completion-watchdog:com.huckleberry.kanban.completion-watchdog:/opt/homebrew/bin/node:$HB_DIR/kanban/src/completion-watchdog.mjs:0"
+  "kanban-stall-detector:com.huckleberry.kanban.stall-detector:/opt/homebrew/bin/node:$HB_DIR/kanban/src/stall-detector.mjs:0"
+  "kanban-tunnel:com.huckleberry.kanban.tunnel:/bin/bash:$HB_DIR/scripts/keepalive.sh:0"
+  "dream-dispatcher:com.huckleberry.dream.dispatcher:/opt/homebrew/bin/node:$HB_DIR/taskmaster/dispatcher.mjs:1800"
+  "dream-distiller:com.huckleberry.dream.distiller:/bin/bash:$HB_DIR/scripts/heartbeat.sh:3600"
+  "keystone:com.huckleberry.keystone:/opt/homebrew/bin/node:$HOME/keystone/keystone.js:0"
+  "monitor-and-notify:com.huckleberry.monitor.notify:/bin/bash:$HB_DIR/scripts/heartbeat.sh:300"
+)
+
+for service in "${SERVICES[@]}"; do
+  IFS=":" read -r name label prog args interval <<< "$service"
+  PLIST="$LAUNCH_DIR/$label.plist"
+
+  cat > "$PLIST" << PLISTEOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>$label</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>$prog</string>
+        <string>$args</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+PLISTEOF
+
+  if [ "$interval" = "0" ]; then
+    # KeepAlive service (always running)
+    cat >> "$PLIST" << 'KEEPA'
+    <key>KeepAlive</key>
+    <true/>
+KEEPA
+  else
+    # Periodic service
+    echo "    <key>StartInterval</key>" >> "$PLIST"
+    echo "    <integer>$interval</integer>" >> "$PLIST"
+  fi
+
+  cat >> "$PLIST" << 'ENDPLIST'
+    <key>StandardOutPath</key>
+    <string>'$LOG_DIR'/'$name'.log</string>
+    <key>StandardErrorPath</key>
+    <string>'$LOG_DIR'/'$name'.err</string>
+</dict>
+</plist>
+ENDPLIST
+
+  # Load the plist
+  launchctl load "$PLIST" 2>/dev/null && echo "  [OK] $label" || echo "  [WARN] $label"
+done
+
+echo ""
+echo "  All services installed. Check with: launchctl list | grep huckleberry"
+echo "  Remove: launchctl unload ~/Library/LaunchAgents/com.huckleberry.*.plist"

package/scripts/keep-awake.ps1

@@ -0,0 +1,48 @@
+# Huckleberry Sleep Prevention
+# Prevents Windows from sleeping while Huckleberry services are running
+# Equivalent to macOS `caffeinate`
+
+$scriptName = "huckleberry-keep-awake"
+$logFile = "$env:USERPROFILE\.huckleberry\keep-awake.log"
+
+function Log($msg) {
+    $ts = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Add-Content -Path $logFile -Value "[$ts] $msg"
+}
+
+Log "Keep-awake started"
+
+# Method 1: Disable sleep via powercfg (temporary, needs admin)
+try {
+    powercfg -change -standby-timeout-ac 0 2>&1 | Out-Null
+    powercfg -change -hibernate-timeout-ac 0 2>&1 | Out-Null
+    Log "Sleep disabled via powercfg"
+} catch {
+    Log "powercfg failed (may need admin): $_"
+}
+
+# Method 2: Keep system awake by setting thread execution state
+# Run this in a loop to prevent sleep
+while ($true) {
+    try {
+        # Use Add-Type to call kernel32 SetThreadExecutionState
+        Add-Type -TypeDefinition @"
+using System;
+using System.Runtime.InteropServices;
+public class SleepPreventer {
+    [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
+    public static extern uint SetThreadExecutionState(uint esFlags);
+    public static void PreventSleep() {
+        SetThreadExecutionState(0x80000003); // ES_CONTINUOUS | ES_SYSTEM_REQUIRED | ES_DISPLAY_REQUIRED
+    }
+    public static void AllowSleep() {
+        SetThreadExecutionState(0x80000000); // ES_CONTINUOUS
+    }
+}
+"@ -ErrorAction SilentlyContinue
+        [SleepPreventer]::PreventSleep()
+    } catch {
+        # Fallback: keep process alive
+    }
+    Start-Sleep -Seconds 60
+}

package/scripts/keep-awake.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# Huckleberry macOS Sleep Prevention
+# Uses caffeinate to prevent sleep while services run
+
+LOGFILE="$HOME/.huckleberry/keep-awake.log"
+PIDFILE="$HOME/.huckleberry/keep-awake.pid"
+
+log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> "$LOGFILE"; }
+
+case "${1:-start}" in
+  start)
+    log "Starting caffeinate..."
+    caffeinate -dimsu -w $$ &
+    CPID=$!
+    echo $CPID > "$PIDFILE"
+    log "caffeinate PID: $CPID"
+    ;;
+  stop)
+    if [ -f "$PIDFILE" ]; then
+      kill $(cat "$PIDFILE") 2>/dev/null && log "caffeinate stopped"
+      rm -f "$PIDFILE"
+    fi
+    ;;
+  status)
+    if [ -f "$PIDFILE" ] && kill -0 $(cat "$PIDFILE") 2>/dev/null; then
+      echo "Keep-awake is running"
+    else
+      echo "Keep-awake is stopped"
+    fi
+    ;;
+esac

package/scripts/keepalive.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Huckleberry Keepalive — checks and restarts critical services
+set -euo pipefail
+
+HB_DIR="${HOME}/.huckleberry"
+LOG="${HB_DIR}/keepalive.log"
+MAX_RESTARTS=3
+RESTART_COUNT=0
+
+log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> "$LOG"; }
+
+check_service() {
+    local name=$1
+    local pid_pattern=$2
+    local restart_cmd=$3
+
+    if pgrep -f "$pid_pattern" > /dev/null 2>&1; then
+        log "$name: OK"
+        return 0
+    else
+        log "$name: DOWN — restarting..."
+        eval "$restart_cmd" &
+        log "$name: restart issued"
+        return 1
+    fi
+}
+
+log "=== Keepalive check ==="
+
+# Check Inkstone MCP
+check_service "inkstone" "inkstone.*mcp/server" "node ~/.huckleberry/mcp/inkstone/dist/mcp/server.js &"
+
+# Check opencode server if running
+if pgrep -f "opencode" > /dev/null 2>&1; then
+    log "opencode: OK"
+fi
+
+# Check kimaki
+if pgrep -f "kimaki" > /dev/null 2>&1; then
+    log "kimaki: OK"
+fi
+
+log "=== Keepalive complete ==="

package/skills/curated.txt

@@ -0,0 +1,68 @@
+# Curated Skills for Huckleberry Starter Pack (~45)
+
+# Core Infrastructure
+claw-compactor
+context-recovery
+humanizer
+guardrail-framework
+self-improve
+
+# Memory & Knowledge
+inkstone-admin
+project-rag
+notebooklm
+
+# Research & Intelligence
+agent-reach
+smart-search
+firecrawl
+perplexity-research
+competitive-intel
+
+# Content & Writing
+copywriting
+copy-editing
+concreteness-fixer
+article-generator
+seo-content
+narrative-research-article
+hook-generator
+content-strategy
+
+# Brand & Voice
+brand-voice
+voice-extraction
+voice-brand-alignment
+positioning-angles
+
+# Outreach & Sales
+cold-email
+lead-email-craft
+warm-outbound
+b2b-cold-outreach
+
+# Social Distribution
+social-construction
+social-campaign
+typefully
+x-post-generator-openclaw
+muse
+platform-formatting
+
+# Marketing & Growth
+cmo
+brainstorm
+audience-research
+landing-page-architect
+content-repost-manager
+
+# SEO & Analytics
+keyword-research
+ai-seo
+seo-audit
+schema-markup
+auto-indexing
+
+# Creative
+image-gen
+visual-style

package/src/cli.js

@@ -0,0 +1,227 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync, copyFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import { runInterview } from "./interview.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+const PACKAGE_ROOT = ROOT;
+
+const VERSION = JSON.parse(
+  readFileSync(join(PACKAGE_ROOT, "package.json"), "utf-8")
+).version;
+
+const commands = { install, update, "install-pack": installPack, interview: runInterview, help, version: () => console.log(`@huckleberry/cli v${VERSION}`) };
+
+export async function run(args) {
+  const cmd = args[0];
+  if (!cmd || cmd === "--help" || cmd === "-h") return help();
+  if (cmd === "--version" || cmd === "-v") return console.log(`@huckleberry/cli v${VERSION}`);
+  const handler = commands[cmd];
+  if (!handler) {
+    console.error(`Unknown command: ${cmd}\nRun 'huckleberry help' for usage.`);
+    process.exit(1);
+  }
+  try { await handler(args.slice(1)); }
+  catch (err) { console.error(`[ERROR] ${err.message}`); process.exit(1); }
+}
+
+async function install() {
+  console.log(`\n  Huckleberry AI System v${VERSION} — Installing...`);
+  const homeDir = process.env.HOME || process.env.USERPROFILE;
+  const hbDir = join(homeDir, ".huckleberry");
+  const templateDir = join(PACKAGE_ROOT, "templates");
+
+  console.log(`  [1/8] Platform: ${detectPlatform()}`);
+  console.log(`  [2/8] Priming OmniRoute with free models...`);
+
+  console.log(`  [3/8] Creating bootstrap files...`);
+  mkdirSync(hbDir, { recursive: true });
+  mkdirSync(join(hbDir, "memory"), { recursive: true });
+  mkdirSync(join(hbDir, "taskmaster", "tasks"), { recursive: true });
+  mkdirSync(join(hbDir, "scripts"), { recursive: true });
+  mkdirSync(join(hbDir, "wiki"), { recursive: true });
+  mkdirSync(join(hbDir, "agents", "hermes"), { recursive: true });
+  mkdirSync(join(hbDir, "agents", "hermes", "fix-kimaki"), { recursive: true });
+
+  for (const t of ["SOUL.md","IDENTITY.md","COS_PROTOCOLS.md","TOOLS.md","HEARTBEAT.md","AGENTS.md","MEMORY.md","EXECUTIVE-MODE.md","ORG.md"]) {
+    const src = join(templateDir, t);
+    if (existsSync(src)) copyTemplate(src, join(hbDir, t));
+  }
+
+  // Copy Hermes agent bootstrap files
+  const hermesSrc = join(PACKAGE_ROOT, "agents", "hermes");
+  if (existsSync(hermesSrc)) copyDirSync(hermesSrc, join(hbDir, "agents", "hermes"));
+  // Copy agent configs
+  if (existsSync(join(PACKAGE_ROOT, "agents", "cos.json"))) copyFileSync(join(PACKAGE_ROOT, "agents", "cos.json"), join(hbDir, "agents", "cos.json"));
+  if (existsSync(join(PACKAGE_ROOT, "agents", "hermes.json"))) copyFileSync(join(PACKAGE_ROOT, "agents", "hermes.json"), join(hbDir, "agents", "hermes.json"));
+
+  console.log(`  [4/8] Setting up ~/.opencode/...`);
+  const opencodeDir = join(homeDir, ".opencode");
+  mkdirSync(opencodeDir, { recursive: true });
+  mkdirSync(join(opencodeDir, "plugin"), { recursive: true });
+  mkdirSync(join(opencodeDir, "mcp"), { recursive: true });
+
+  const ocConfig = join(templateDir, "opencode.json");
+  if (existsSync(ocConfig)) {
+    const config = readFileSync(ocConfig, "utf-8")
+      .replace(/\{\{USERPROFILE\}\}/g, homeDir.replace(/\\/g, "/"))
+      .replace(/\{\{HUCKLEBERRY_HOME\}\}/g, hbDir.replace(/\\/g, "/"));
+    writeFileSync(join(opencodeDir, "opencode.json"), config, "utf-8");
+  }
+
+  if (existsSync(join(PACKAGE_ROOT, "plugins"))) copyDirSync(join(PACKAGE_ROOT, "plugins"), join(opencodeDir, "plugin"));
+  if (existsSync(join(PACKAGE_ROOT, "mcp"))) copyDirSync(join(PACKAGE_ROOT, "mcp"), join(opencodeDir, "mcp"));
+
+  console.log(`  [5/8] Deploying skills...`);
+  const skillsDir = join(homeDir, ".claude", "skills");
+  mkdirSync(skillsDir, { recursive: true });
+  const curated = join(PACKAGE_ROOT, "skills", "curated.txt");
+  if (existsSync(curated)) {
+    const list = readFileSync(curated, "utf-8").split("\n").filter(Boolean);
+    console.log(`    Skills manifest: ${list.length} skills listed`);
+  }
+
+  console.log(`  [6/8] Setting up taskmaster...`);
+  const taskmasterSrc = join(PACKAGE_ROOT, "taskmaster");
+  if (existsSync(taskmasterSrc)) copyDirSync(taskmasterSrc, join(hbDir, "taskmaster"));
+  writeFileSync(join(hbDir, "taskmaster", "tasks", "tasks.json"), JSON.stringify({ projects: [], tasks: [] }, null, 2), "utf-8");
+
+  console.log(`  [7/10] Writing scripts...`);
+  if (existsSync(join(PACKAGE_ROOT, "scripts"))) copyDirSync(join(PACKAGE_ROOT, "scripts"), join(hbDir, "scripts"));
+
+  console.log(`  [8/10] Writing wiki...`);
+  if (existsSync(join(PACKAGE_ROOT, "wiki"))) copyDirSync(join(PACKAGE_ROOT, "wiki"), join(hbDir, "wiki"));
+
+  console.log(`  [9/10] Installing Inkstone memory system...`);
+  const inkstoneDir = join(hbDir, "mcp", "inkstone");
+  mkdirSync(inkstoneDir, { recursive: true });
+  // Create a standalone package.json that depends on @jairodri/huckleberry-inkstone
+  writeFileSync(
+    join(inkstoneDir, "package.json"),
+    JSON.stringify({
+      name: "inkstone",
+      private: true,
+      version: "1.0.0",
+      dependencies: { "@jairodri/huckleberry-inkstone": "^1.0.0" },
+    }, null, 2),
+    "utf-8"
+  );
+  try {
+    execSync("npm install --production 2>/dev/null", { cwd: inkstoneDir, stdio: "pipe", timeout: 120000 });
+    console.log(`    Inkstone installed to ${inkstoneDir}`);
+  } catch {
+    console.error(`    Inkstone npm install failed. Run manually: cd ${inkstoneDir} && npm install`);
+  }
+
+  console.log(`  [10/10] Setting up kanban workflows...`);
+  const kanbanDir = join(hbDir, "kanban");
+  mkdirSync(kanbanDir, { recursive: true });
+  mkdirSync(join(kanbanDir, "src"), { recursive: true });
+  mkdirSync(join(kanbanDir, "templates"), { recursive: true });
+  const kanbanSrc = join(PACKAGE_ROOT, "kanban");
+  if (existsSync(kanbanSrc)) copyDirSync(kanbanSrc, kanbanDir);
+  // Init kanban DB
+  try {
+    execSync("node src/cli.mjs init 2>/dev/null", { cwd: kanbanDir, stdio: "pipe", timeout: 30000 });
+    console.log(`    Kanban workflows installed`);
+  } catch {
+    console.error(`    Kanban init skipped (requires bcrypt-sqlite). Install: cd ${kanbanDir} && npm install`);
+  }
+
+  console.log(`  [11/12] Setting up background services...`);
+  const platform = detectPlatform();
+  const scriptsDir = join(hbDir, "scripts");
+  if (platform === "Windows" && existsSync(join(scriptsDir, "install-services.ps1"))) {
+    try {
+      execSync(`powershell -ExecutionPolicy Bypass -File "${join(scriptsDir, "install-services.ps1")}" 2>&1`, { stdio: "pipe", timeout: 60000 });
+      console.log(`    12 Windows Scheduled Tasks created`);
+    } catch {
+      console.error(`    Windows services setup skipped (run manually: install-services.ps1)`);
+    }
+  } else if (platform === "macOS" && existsSync(join(scriptsDir, "install-services.sh"))) {
+    try {
+      execSync(`bash "${join(scriptsDir, "install-services.sh")}" 2>&1`, { stdio: "pipe", timeout: 30000 });
+      console.log(`    12 macOS launchd agents installed`);
+    } catch {
+      console.error(`    macOS services setup skipped (run manually: install-services.sh)`);
+    }
+  } else {
+    console.log(`    Service setup skipped for ${platform}`);
+  }
+
+  console.log(`  [12/12] Sleep prevention...`);
+  if (platform === "Windows") {
+    console.log(`    Windows: Huckleberry prevents sleep while running (keep-awake.ps1)`);
+    console.log(`    Disable sleep manually: powercfg -change -standby-timeout-ac 0`);
+  } else if (platform === "macOS") {
+    console.log(`    macOS: caffeinate prevents sleep while running (keep-awake.sh)`);
+  }
+
+  console.log(`\n  ✓ Huckleberry v${VERSION} installed to ${hbDir}`);
+  console.log(`  ✓ Config: ${join(opencodeDir, "opencode.json")}`);
+  console.log(`\n  Next steps:`);
+  console.log(`    1. npm install -g opencode`);
+  console.log(`    2. npm install -g kimaki`);
+  console.log(`    3. huckleberry interview`);
+  console.log(`    4. cd ~/.huckleberry && opencode\n`);
+}
+
+async function update() {
+  console.log(`\n  Updating Huckleberry...\n`);
+  try {
+    execSync("npm update -g @huckleberry/cli", { stdio: "inherit" });
+    console.log(`  ✓ @huckleberry/cli updated`);
+  } catch {
+    console.error(`  ⚠ @huckleberry/cli update failed`);
+  }
+
+  // Update Inkstone independently
+  const homeDir = process.env.HOME || process.env.USERPROFILE;
+  const inkstoneDir = join(homeDir, ".huckleberry", "mcp", "inkstone");
+  if (existsSync(join(inkstoneDir, "package.json"))) {
+    console.log(`  Updating Inkstone memory system...`);
+    try {
+      execSync("npm update @jairodri/huckleberry-inkstone 2>/dev/null", { cwd: inkstoneDir, stdio: "pipe", timeout: 60000 });
+      console.log(`  ✓ Inkstone updated`);
+    } catch {
+      console.error(`  ⚠ Inkstone update failed. Run: cd ${inkstoneDir} && npm install`);
+    }
+  }
+
+  console.log(`\n  ✓ Huckleberry updated\n`);
+}
+
+async function installPack(args) {
+  const packName = args[0];
+  if (!packName) { console.error("Usage: huckleberry install-pack <pack-name>\nAvailable packs: content-creator, outreach, seo, creative, video"); process.exit(1); }
+  console.log(`\n  Installing pack: ${packName}...\n`);
+  console.log(`  Pack system coming soon — each pack includes: agent config + skills + kanban templates + channel setup\n`);
+}
+
+function help() {
+  console.log(`\n  Huckleberry AI System v${VERSION}\n\n  Usage: huckleberry <command>\n\n  Commands:\n    install         One-click install\n    update          Update to latest version\n    install-pack    Install agent/skill pack\n    help            Show this help\n    version         Show version\n\n  Packs:\n    content-creator   Writing + social + content agent\n    outreach          Sales + cold email + lead management\n    seo               Keyword research + rankings\n    creative          Images + branding + design\n    video             Video production\n`);
+}
+
+function detectPlatform() {
+  const p = process.platform;
+  return p === "darwin" ? "macOS" : p === "win32" ? "Windows" : p;
+}
+
+function copyTemplate(src, dst) {
+  try {
+    let content = readFileSync(src, "utf-8");
+    content = content.replace(/\{\{VERSION\}\}/g, VERSION).replace(/\{\{INSTALL_DATE\}\}/g, new Date().toISOString().split("T")[0]);
+    writeFileSync(dst, content, "utf-8");
+  } catch (err) { console.error(`    Failed: ${src} — ${err.message}`); }
+}
+
+function copyDirSync(src, dst) {
+  mkdirSync(dst, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    if (entry === ".git" || entry === "node_modules") continue;
+    const s = join(src, entry), d = join(dst, entry);
+    if (statSync(s).isDirectory()) copyDirSync(s, d); else copyFileSync(s, d);
+  }
+}