pantheon-opencode 1.0.0 → 1.0.6

package/README.md

@@ -7,11 +7,11 @@
 <p align="center">
   <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-v1.0.0-blue" alt="Version"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
-  <a href="docs/platforms/"><img src="https://img.shields.io/badge/platforms-vscode|opencode|claude|cursor|windsurf|cline|continue-green" alt="Platforms"></a>
+  <a href="docs/platforms/"><img src="https://img.shields.io/badge/platforms-opencode-green" alt="Platforms"></a>
   <a href="agents/README.md"><img src="https://img.shields.io/badge/agents-14-purple" alt="Agents"></a>
   <a href="skills/README.md"><img src="https://img.shields.io/badge/skills-14-orange" alt="Skills"></a>
   <a href="commands/"><img src="https://img.shields.io/badge/commands-14-red" alt="Commands"></a>
-  <a href="docs/platforms/"><img src="https://img.shields.io/badge/built%20with-copilot|opencode|claude|cursor|windsurf|cline|continue-8250DF" alt="Built with"></a>
+  <a href="docs/platforms/"><img src="https://img.shields.io/badge/built%20with-opencode-8250DF" alt="Built with"></a>
   <a href="https://github.com/ils15/pantheon/actions"><img src="https://img.shields.io/github/actions/workflow/status/ils15/pantheon/ci.yml?branch=main&label=CI" alt="CI"></a>
   <a href="https://github.com/ils15/pantheon/actions"><img src="https://img.shields.io/github/actions/workflow/status/ils15/pantheon/release.yml?branch=main&label=release" alt="Release"></a>
 </p>
@@ -20,7 +20,7 @@
 
 Stop settling for generalist single-agent coding. Pantheon's conductor-delegate architecture dispatches expert agents with isolated context windows — parallel execution, zero context bleed, and quality gates that block anything below 80% coverage.
 
-Supports **VS Code Copilot**, **OpenCode**, **Claude Code**, **Cursor**, **Windsurf**, **Cline**, and **Continue.dev**.
+Supports **OpenCode** — multi-agent orchestration for your editor.
 
 ---
 
@@ -51,13 +51,7 @@ Supports **VS Code Copilot**, **OpenCode**, **Claude Code**, **Cursor**, **Winds
 | 🔌 **MCP User Guide** | [docs/mcp-user-guide.md](docs/mcp-user-guide.md) — adding custom MCP servers |
 | 🗂️ **MCP Tiers** | `.pantheon/tiers.json` — 4-tier MCP selection (none/essential/recommended/full) |
 | ⚡ **Quick Start** | [docs/QUICKSTART.md](docs/QUICKSTART.md) |
-| 🖥️ **VS Code** | [docs/platforms/vscode.md](docs/platforms/vscode.md) |
 | ⚡ **OpenCode** | [docs/platforms/opencode.md](docs/platforms/opencode.md) |
-| 🤖 **Claude Code** | [docs/platforms/claude.md](docs/platforms/claude.md) |
-| 🔧 **Cursor** | [docs/platforms/cursor.md](docs/platforms/cursor.md) |
-| 🌊 **Windsurf** | [docs/platforms/windsurf.md](docs/platforms/windsurf.md) |
-| 🤖 **Cline** | [docs/platforms/cline.md](docs/platforms/cline.md) |
-| 🔄 **Continue.dev** | [docs/platforms/continue.md](docs/platforms/continue.md) |
 
 ---
 
@@ -194,26 +188,18 @@ flowchart TD
 - **OpenCode** — Pantheon v1.0 is OpenCode-only. [Installation guide](docs/INSTALLATION.md).
 
 ```bash
-# 1. Clone the repo
-git clone https://github.com/ils15/pantheon.git
-cd pantheon
-npm install
-
-# 2. Install Pantheon (choose your mode)
-npm run install:lite        # agents + skills + instructions only (no MCP, no deps)
-npm run install:full        # everything: agents + skills + MCP servers + venv
-npm run install:runtime     # just MCP infrastructure (if agents already installed)
-
-# 3. Open your editor and test
-# OpenCode: @zeus in chat
-# Claude Code: @zeus
-# Cursor: @zeus in Agent mode
-# VS Code: @zeus in Copilot Chat
-# Cline: @zeus
-# Windsurf: @zeus in Cascade
+# Install Pantheon globally
+npx pantheon-opencode init
+
+# (Optional) Install MCP servers + skills + TUI plugin
+npm run setup
+
+# Launch OpenCode with background subagents
+export OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true
+opencode
 ```
 
-> **Lite vs Full:** `install:lite` is fast (~5s) and installs only the agent files. `install:full` also creates a Python venv and installs MCP servers (includes `pantheon-memory` for vector search and `pantheon-persistence` for KV cache). Choose lite if you just want the agents without MCP infrastructure.
+> **Minimal vs Full:** `npx pantheon-opencode init --no-mcp` installs only agents (~2s). `npx pantheon-opencode init` (without `--no-mcp`) also creates a Python venv and installs MCP servers (includes `pantheon-memory` for vector search and `pantheon-persistence` for KV cache).
 
 ---
 
@@ -472,7 +458,7 @@ subscription (OpenCode Go, Copilot Pro, Claude Pro, etc.).
 ### /forge — Model Presets
 
 Pantheon ships with **`/forge`** — a model configuration command that applies named presets from
-`platform/forge.json`. Each preset maps 4 tiers to concrete models across all 14 agents.
+`built-in presets`. Each preset maps 4 tiers to concrete models across all 14 agents.
 
 **Usage:**
 ```
@@ -503,43 +489,36 @@ Pantheon ships with **`/forge`** — a model configuration command that applies
 
 > 🤔 = thinking habilitado
 
-See `platform/forge.json` for full preset definitions and `docs/platforms/` for per-platform setup guides.
+Built-in presets available (opencode-go, deepseek-flash, etc.) and `docs/platforms/` for per-platform setup guides.
 
 ---
 
 ## Quick Start
 
-### 1. Choose your platform
+### 1. Install Pantheon
 
-Pantheon supports OpenCode. Pick the one that matches your editor:
+Pantheon runs on **OpenCode**. Install it globally:
 
-- **VS Code Copilot** — native `.agent.md` files, full subagent orchestration, lifecycle hooks
-- **OpenCode** — config-based agent loading, permission blocks, tool mapping adapter
-- **Claude Code** — CLI-based, agent handoff workflow, skills via markdown rules
-- **Cursor** — `.mdc` rules with `alwaysApply` and `globs` for Agent mode
-- **Windsurf** — markdown agent definitions with workflow support (preview)
-- **Cline** — custom agent definitions with skills via instruction files
-- **Continue.dev** — IDE-agnostic rule-based agent configuration with markdown skills
+```bash
+npx pantheon-opencode init
+```
 
-> Follow the [Platform Setup Guides](docs/platforms/) for your chosen platform.
+For MCP servers (memory, persistence):
 
-### 2. Set up the framework
+```bash
+npm run setup
+```
 
-Installation varies by platform, but generally involves:
+### 2. Launch OpenCode
 
 ```bash
-git clone https://github.com/ils15/pantheon.git
-cd pantheon
-
-# Optional: install dependencies for sync/install tools
-npm install
+export OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true
+opencode
 ```
 
-Then run the platform-specific installer from the guides above.
-
 ### 3. Run your first feature
 
-Once agents are loaded in your editor, invoke the orchestrator:
+Once agents are loaded, invoke the orchestrator:
 
 ```
 @zeus: Implement JWT authentication with refresh tokens and rate limiting
@@ -555,24 +534,25 @@ Zeus will:
 
 ## Commands
 
-Pantheon provides slash commands via OpenCode. On other platforms (Copilot, Cursor, Claude Code), use natural language with the agent name.
-
-| Command | Agent | Description |
-|---------|-------|-------------|
-| `/pantheon` | zeus | Multi-perspective synthesis (Council) via inline agents |
-| `/pantheon-install` | zeus | Sync + install + verify pipeline with `--tier` (none/essential/recommended/full), `--backup`, `--detect`, `--dry-run` |
-| `/pantheon-update` | iris | Version bump + changelog + git tag + GitHub Release |
-| `/pantheon-deepwork` | zeus | Heavy multi-phase task with persisted checkpoints |
-| `/pantheon-reflect` | zeus | Analyze repeated work friction, suggest improvements |
-| `/pantheon-focus` | zeus | Pin a session goal |
-| `/pantheon-sketch` | athena | Turn rough idea into spec |
-| `/pantheon-audit` | themis | Code review + security audit |
-| `/pantheon-optimize` | zeus | Context optimization & token audit |
-| `/pantheon-metamorphosis` | zeus | Intelligent refactoring with TDD |
-| `/pantheon-status` | zeus | Show system health and agent status |
-| `/cancel` | zeus | Stop auto-continuation |
-
-> **Multi-platform note:** Commands are native to OpenCode. On VS Code Copilot, use `@agent-name` in chat. On Cursor/Claude Code, describe the task in natural language.
+Type these in the OpenCode chat:
+
+| Command | Description |
+|---------|-------------|
+| `/pantheon` | Multi-perspective synthesis (Council) via inline agents |
+| `/pantheon-audit` | Code review + security audit |
+| `/pantheon-bg` | List background tasks |
+| `/pantheon-consolidate` | Consolidate memory |
+| `/pantheon-deepwork` | Heavy multi-phase task with persisted checkpoints |
+| `/pantheon-doc` | Generate documentation |
+| `/pantheon-focus` | Pin a session goal |
+| `/pantheon-forget` | Compress/consolidate memories |
+| `/pantheon-hash` | Hash edit verification |
+| `/pantheon-optimize` | Context optimization & token audit |
+| `/pantheon-remember` | Store in memory |
+| `/pantheon-search` | Search memory |
+| `/pantheon-status` | Show system health and agent status |
+| `/pantheon-todo` | Create and maintain task list |
+
 
 ### TUI Sidebar Plugin (OpenCode) — Temporarily Disabled
 
@@ -682,20 +662,14 @@ pantheon/
 │   ├── README.md
 │   └── dynamic/                * generated prompts
 │
-├── platform/                  — platform-specific configurations
+├── platform/                  — OpenCode-only configuration
 │   ├── optimize-context.sh    * context optimization script
-│   ├── copilot/               * VS Code Copilot configs
-│   ├── opencode/              * OpenCode configs
-│   ├── claude/                * Claude Code configs & agents
-│   ├── cursor/                * Cursor rules
-│   ├── windsurf/              * Windsurf configs
-│   ├── continue/              * Continue.dev rules
-│   ├── cline/                 * Cline configs
-│   └── _template/             * template for new platforms
+│   └── opencode/              * OpenCode configs
 │
 ├── scripts/                   — tooling, automation & lifecycle hooks
-│   ├── install.mjs            * multi-platform installer
-│   ├── sync-platforms.mjs     * agent format sync engine
+│   ├── postinstall.mjs        * npm post-install hook
+│   ├── doctor.mjs             * health check CLI
+│   
 │   ├── validate-sync.mjs      * sync integrity check
 │       └── hooks/                 * agent lifecycle hooks (10 .sh scripts)
 │       ├── audit-imports.sh
@@ -709,7 +683,7 @@ pantheon/
 │       ├── validate-talos-scope.sh
 │       └── validate-tool-safety.sh
 │
-├── commands/                  # 19 interaction commands
+├── commands/                  # 14 interaction commands
 │   ├── cancel.md
 │   ├── pantheon-audit.md
 │   ├── pantheon-deepwork.md
@@ -729,14 +703,8 @@ pantheon/
 │   ├── PLATFORMS.md           — platform comparison
 │   ├── RELEASING.md           — versioning & release process
 │   ├── INDEX.md               — documentation index
-│   ├── platforms/             — platform-specific setup guides
-│   │   ├── vscode.md
-│   │   ├── opencode.md
-│   │   ├── claude.md
-│   │   ├── cursor.md
-│   │   ├── windsurf.md
-│   │   ├── cline.md
-│   │   └── continue.md
+│   ├── platforms/             — OpenCode configuration guide
+│   │   └── opencode.md
 │   └── memory-bank/           — project memory (Mnemosyne's domain)
 │       ├── 00-project.md      * project overview
 │       ├── 01-active-context.md * current sprint focus (priority file)
@@ -745,7 +713,7 @@ pantheon/
 │       └── _tasks/            * sprint task records
 │
 ├── template/                  — project templates
-│   ├── CLAUDE.md
+
 │   └── README.md
 │
 ├── logs/                      — agent session audit logs
@@ -892,12 +860,6 @@ Create IMPLEMENTATION_SUMMARY.md with what we did
 3. Reference relevant agents in the skill body
 4. Invoke `@mnemosyne Update README skills table and count`
 
-### Adding a new platform
-
-1. Create `platform/<name>/` with platform-specific configs
-2. Add a setup guide to `docs/platforms/<name>.md`
-3. Extend `scripts/install.mjs` and `scripts/sync-platforms.mjs`
-
 ---
 
 ## Security & Privacy
@@ -930,16 +892,13 @@ The `.opencode/plugins/pantheon-hooks.ts` plugin bridges these shell scripts to
 ## FAQ
 
 **How much does this cost?**
-You need an existing subscription for your AI coding editor (Copilot, Claude Pro, Cursor
-Pro, or OpenCode). Pantheon itself is free and open-source (MIT).
+You need an existing subscription for your AI coding editor (OpenCode). Pantheon itself is free and open-source (MIT).
 
-**Can I use this outside VS Code?**
-Yes — OpenCode supported (VS Code, OpenCode, Claude Code, Cursor, Windsurf, Cline, Continue.dev). See
-[Platform Setup Guides](docs/platforms/).
+**Can I use this outside OpenCode?**
+No — Pantheon v1.0 is OpenCode-only. It uses OpenCode's native agent system, permission blocks, and MCP integration.
 
 **How are platform configs synced?**
-Edit `agents/*.agent.md` (the canonical format), then run `npm run sync`.
-The sync engine transforms agents into every platform's native format.
+Edit `src/agents/*.agent.md` (the canonical format), then run the sync script to update platform copies.
 
 **Can I override Themis's code review?**
 You can proceed past the review gate even if Themis flags issues — except test coverage.
@@ -986,16 +945,9 @@ Pantheon draws from the broader multi-agent landscape while diverging in key way
 | [CHANGELOG.md](CHANGELOG.md) | Release history |
 | [docs/INSTALLATION.md](docs/INSTALLATION.md) | Generic installation guide |
 | [docs/platforms/](docs/platforms/) | Platform-specific setup guides (OpenCode) |
-| [docs/platforms/vscode.md](docs/platforms/vscode.md) | VS Code setup |
-| [docs/platforms/opencode.md](docs/platforms/opencode.md) | OpenCode setup |
-| [docs/platforms/claude.md](docs/platforms/claude.md) | Claude Code setup |
-| [docs/platforms/cursor.md](docs/platforms/cursor.md) | Cursor setup |
-| [docs/platforms/windsurf.md](docs/platforms/windsurf.md) | Windsurf setup |
-| [docs/platforms/cline.md](docs/platforms/cline.md) | Cline setup |
-| [docs/platforms/continue.md](docs/platforms/continue.md) | Continue.dev setup |
+| [docs/platforms/opencode.md](docs/platforms/opencode.md) | OpenCode setup guide |
 | [agents/README.md](agents/README.md) | Agent directory |
 | [skills/README.md](skills/README.md) | Skill directory |
-| [docs/platforms/](docs/platforms/) | Per-platform setup guides |
 | [docs/mcp-tools.md](docs/mcp-tools.md) | Canonical MCP tool registry |
 | [docs/mcp-user-guide.md](docs/mcp-user-guide.md) | Adding custom MCP servers |
 | [docs/mcp-recommendations.md](docs/mcp-recommendations.md) | Recommended MCP servers per project type |

package/bin/pantheon-init.mjs

@@ -1,39 +1,36 @@
 #!/usr/bin/env node
+/**
+ * pantheon-init.mjs — Pantheon OpenCode CLI entry point
+ *
+ * Usage: npx pantheon-opencode init [options]
+ *
+ * Thin CLI wrapper that parses arguments and delegates to
+ * installOpenCode() from scripts/install/opencode.mjs.
+ */
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { homedir, platform } from 'os';
-import { execSync } from 'child_process';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const ROOT = path.resolve(__dirname, '..');
-const CFG = path.join(homedir(), '.config', 'opencode');
+
+const REQUIRED_NODE_MAJOR = 18;
+if (parseInt(process.versions.node.split('.')[0], 10) < REQUIRED_NODE_MAJOR) {
+  console.error(`❌ Node.js >= ${REQUIRED_NODE_MAJOR} required (current: ${process.versions.node})`);
+  process.exit(1);
+}
 
 function printUsage() {
-  console.log('Pantheon Orchestrator — Multi-agent orchestration platform');
+  console.log('Pantheon OpenCode — Multi-agent orchestration platform');
   console.log('');
   console.log('Usage:');
-  console.log('  npx pantheon-orchestrator init              # Install globally');
-  console.log('  npx pantheon-orchestrator init --project    # Install in project');
-  console.log('  npx pantheon-orchestrator init --dry-run    # Preview only');
-  console.log('  npx pantheon-orchestrator init --no-mcp     # Skip MCP + venv');
-  console.log('  npx pantheon-orchestrator init --force      # Overwrite + recreate venv');
-  console.log('  npx pantheon-orchestrator --help            # Show this help');
-}
-
-function getPkgVersion() {
-  try {
-    const p = path.join(ROOT, 'package.json');
-    return JSON.parse(fs.readFileSync(p, 'utf8')).version || '?';
-  } catch { return '?'; }
-}
-
-function getAgentList() {
-  const agentsDir = path.resolve(ROOT, 'src', 'agents');
-  if (!fs.existsSync(agentsDir)) return [];
-  return fs.readdirSync(agentsDir)
-    .filter(f => f.endsWith('.md') && f !== 'README.md')
-    .map(f => f.replace('.md', ''));
+  console.log('  npx pantheon-opencode init              # Install globally');
+  console.log('  npx pantheon-opencode init --project    # Install in project');
+  console.log('  npx pantheon-opencode init --dry-run    # Preview only');
+  console.log('  npx pantheon-opencode init --no-mcp     # Skip MCP + venv');
+  console.log('  npx pantheon-opencode init --force      # Overwrite + recreate venv');
+  console.log('  npx pantheon-opencode init --doctor     # Run health check after install');
+  console.log('  npx pantheon-opencode --help            # Show this help');
 }
 
 async function main() {
@@ -47,132 +44,56 @@ async function main() {
     const isDryRun = args.includes('--dry-run');
     const skipMCP = args.includes('--no-mcp');
     const forceReinstall = args.includes('--force');
-    const base = isProject
-      ? path.join(process.cwd(), '.opencode')
-      : CFG;
-
-    const version = getPkgVersion();
-    console.log(`Pantheon Orchestrator v${version} — ${isDryRun ? 'DRY RUN' : 'Installing...'}`);
-    if (forceReinstall && !isDryRun) console.log('  🔄 Force mode — overwriting existing files + recreating venv');
-    console.log(`Target: ${base}${isProject ? ' (project-local)' : ' (global)'}`);
-    console.log('');
-
-    // Force: delete old venv to force clean install
-    if (forceReinstall && !isDryRun) {
-      const venvPath = path.join(base, '.venv');
-      if (fs.existsSync(venvPath)) {
-        fs.rmSync(venvPath, { recursive: true, force: true });
-      }
-    }
-
-    // 1. Agents
-    console.log('  Agents:');
-    const agentList = getAgentList();
-    let count = 0;
-    for (const agent of agentList) {
-      const s = path.join(ROOT, 'src', 'agents', `${agent}.md`);
-      const d = path.join(base, 'agents', `${agent}.md`);
-      if (fs.existsSync(s)) {
-        if (!isDryRun) {
-          fs.mkdirSync(path.join(base, 'agents'), { recursive: true });
-          fs.copyFileSync(s, d);
-        }
-        count++;
-      }
-    }
-    console.log(`    ${count} agent files → ${isDryRun ? '(preview)' : `${base}/agents/`}`);
+    const runDoctor = args.includes('--doctor');
 
-    // 2. Skills
-    console.log('  Skills:');
-    const skillsSrc = path.resolve(ROOT, 'src', 'skills');
-    if (fs.existsSync(skillsSrc)) {
-      const skills = fs.readdirSync(skillsSrc).filter(f => fs.statSync(path.join(skillsSrc, f)).isDirectory());
-      if (!isDryRun) {
-        for (const skill of skills) {
-          const s = path.join(skillsSrc, skill);
-          const d = path.join(base, 'skills', skill);
-          fs.cpSync(s, d, { recursive: true, force: true });
-        }
-      }
-      console.log(`    ${skills.length} skills → ${isDryRun ? '(preview)' : `${base}/skills/`}`);
-    }
+    const components = ['agents', 'skills', 'instructions', 'commands', 'plugins'];
+    if (!skipMCP) components.push('runtime');
 
-    // 3. Instructions
-    console.log('  Instructions:');
-    const instrSrc = path.resolve(ROOT, 'src', 'instructions');
-    if (fs.existsSync(instrSrc)) {
-      const instrs = fs.readdirSync(instrSrc).filter(f => f.endsWith('.instructions.md'));
-      if (!isDryRun) {
-        fs.mkdirSync(path.join(base, 'instructions'), { recursive: true });
-        for (const f of instrs) {
-          fs.copyFileSync(path.join(instrSrc, f), path.join(base, 'instructions', f));
-        }
-      }
-      console.log(`    ${instrs.length} files → ${isDryRun ? '(preview)' : `${base}/instructions/`}`);
-    }
+    // Version info
+    let version = '?';
+    try {
+      const pkgPath = path.join(ROOT, 'package.json');
+      version = JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version || '?';
+    } catch { /* use default */ }
 
-    // 4. Commands
-    console.log('  Commands:');
-    const cmdSrc = path.resolve(ROOT, 'commands');
-    if (fs.existsSync(cmdSrc)) {
-      const cmds = fs.readdirSync(cmdSrc).filter(f => f.endsWith('.md'));
-      if (!isDryRun) {
-        fs.mkdirSync(path.join(base, 'commands'), { recursive: true });
-        for (const f of cmds) {
-          fs.copyFileSync(path.join(cmdSrc, f), path.join(base, 'commands', f));
-        }
-      }
-      console.log(`    ${cmds.length} commands → ${isDryRun ? '(preview)' : `${base}/commands/`}`);
-    }
-
-    // 5. TUI plugin
-    console.log('  TUI Plugin:');
-    const tuiSrc = path.resolve(ROOT, 'src', 'plugins', 'tui');
-    if (fs.existsSync(tuiSrc)) {
-      if (!isDryRun) {
-        fs.cpSync(tuiSrc, path.join(base, 'plugins', 'pantheon-tui'), { recursive: true, force: true });
-        const tuiJson = path.join(base, 'tui.json');
-        const tuiConfig = { $schema: 'https://opencode.ai/tui.json', plugin: ['plugins/pantheon-tui'] };
-        fs.writeFileSync(tuiJson, JSON.stringify(tuiConfig, null, 2));
-      }
-      console.log(`    Plugin → ${isDryRun ? '(preview)' : `${base}/plugins/pantheon-tui/`}`);
-      console.log(`    tui.json → ${isDryRun ? '(preview)' : `${base}/tui.json`}`);
-    }
+    console.log(`Pantheon OpenCode v${version} — ${isDryRun ? 'DRY RUN' : 'Installing...'}`);
+    console.log('');
 
-    // 6. AGENTS.md
-    const agentsMd = path.resolve(ROOT, 'AGENTS.md');
-    if (fs.existsSync(agentsMd) && !isDryRun) {
-      fs.copyFileSync(agentsMd, path.join(base, 'AGENTS.md'));
+    try {
+      const { installOpenCode } = await import('../scripts/install/opencode.mjs');
+      const target = isProject ? process.cwd() : undefined;
+      installOpenCode(target, isDryRun, forceReinstall, components);
+    } catch (err) {
+      console.error(`❌ Installation failed:\n${err.stack}`);
+      process.exit(1);
     }
 
-    // 7. .venv + MCP servers (skip if --no-mcp)
-    if (!skipMCP && !isDryRun) {
+    if (runDoctor && !isDryRun) {
       console.log('');
-      console.log('  MCP Servers + .venv...');
-      const installScript = path.resolve(ROOT, 'scripts', 'install.mjs');
-      if (fs.existsSync(installScript)) {
-        try {
-          execSync(`node "${installScript}" "${base}"`, { stdio: 'inherit', cwd: ROOT });
-        } catch (e) {
-          console.log('  ⚠️  MCP install issue (non-fatal):', e.message.split('\n')[0]);
-        }
+      console.log('  Running health check...');
+      try {
+        const { spawnSync } = await import('child_process');
+        const doctorScript = path.join(ROOT, 'scripts', 'doctor.mjs');
+        spawnSync(process.execPath, [doctorScript], { stdio: 'inherit', cwd: ROOT });
+      } catch {
+        console.log('  ⚠️  Could not run doctor.mjs');
       }
     }
 
-    // 8. Done
     console.log('');
     console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log(`  ✅ Pantheon Orchestrator v${version} installed!`);
+    console.log(`  ✅ Pantheon OpenCode v${version} installed!`);
     console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
     console.log('');
     console.log('  Next steps:');
-    console.log('  1. Enable background subagents:');
-    console.log('     echo \'export OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true\' >> ~/.zshrc');
-    console.log('  2. Launch OpenCode:');
-    console.log('     source ~/.zshrc && opencode');
-    console.log('  3. Test background delegation:');
-    console.log('     @zeus, dispatch 2 apollo in parallel to research');
+    console.log('  1. Verify installation:');
+    console.log('     npx pantheon-opencode doctor');
+    console.log('  2. Launch your AI coding tool (OpenCode, Claude Code, Cursor, etc.)');
+    console.log('  3. Invoke agents with @agent-name in chat');
+    console.log('  4. For project-local install:');
+    console.log('     npx pantheon-opencode init --project');
     console.log('');
+
     return;
   }
 
@@ -180,4 +101,4 @@ async function main() {
   process.exit(1);
 }
 
-main().catch(err => { console.error('Error:', err.message); process.exit(1); });
+main().catch(err => { console.error('Error:', err.stack); process.exit(1); });

package/commands/pantheon-audit.md

@@ -1,6 +1,6 @@
 ---
 description: "Audit: heuristic scan (zero LLM) + Themis review. Usage: /pantheon-audit [--light|--full|--plan]"
-agent: "themis"
+agent: "zeus"
 ---
 # /pantheon-audit — Quality & Security Audit