omo-suites 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -1,8 +1,28 @@
 ---
 # OMO Suites Changelog
 
+## [1.16.0] - 2026-03-31
+### Added
+- Shell Completion: updated `omocs completion` with all 34 CLI commands for bash, zsh, and fish.
+- CI/CD: GitHub Actions workflows for continuous integration (`ci.yml`) and automated npm releases (`release.yml`).
+- API Documentation: comprehensive command reference at `docs/API.md` covering all commands, config schema, plugin API, and environment variables.
+
+### Fixed
+- Test Fixes: resolved `vi.mock` hoisting issues in `auto.test.ts`, `store.test.ts`, and `telemetry.test.ts` using `vi.hoisted()`.
+- Test Fix: corrected password mismatch in `crypto.test.ts` encrypt/decrypt test.
+- All 221 tests now pass (16 test files, 0 failures).
+
+## [1.15.0] - 2026-03-28
+### Added
+- Diagnostics: `omocs doctor` and `omocs self-test` for system health checks and core integration validation.
+- Configuration Management: strict config validation (`omocs config validate`), plus `import`/`export` for profiles.
+- Setup & Initialization: new setup wizard and bootstrap generator for templates (`omocs template`).
+- Robust Operations: global `--debug` and `--verbose` flags across all commands, structured logging with auto-rotation, and retry wrappers with timeouts for network calls.
+- Self-Update Mechanism: safe self-update flow with backup and rollback if verification fails.
+- Plugin Architecture: plugin isolation layer.
+- Telemetry: opt-in telemetry system.
+- Testing & Release: Vitest foundation for unit and smoke testing, plus automated docs/release prep.
+
 ## Unreleased
 ### Added
-- Setup Vitest foundation for unit and smoke testing
 - Structured logging option via `src/utils/logger/index.ts` with auto rotation (`OMOCS_NO_LOGS` to disable)
-# omocs bootstrap

package/README.md

@@ -1,3 +1,5 @@
+[![CI](https://github.com/TheFahmi/omo-suites-installer/actions/workflows/ci.yml/badge.svg)](https://github.com/TheFahmi/omo-suites-installer/actions/workflows/ci.yml)
+
 ```
    ██████╗ ███╗   ███╗ ██████╗     ███████╗██╗   ██╗██╗████████╗███████╗███████╗
   ██╔═══██╗████╗ ████║██╔═══██╗    ██╔════╝██║   ██║██║╚══██╔══╝██╔════╝██╔════╝
@@ -8,6 +10,7 @@
 ```
 
 <p align="center">
+  <a href="https://github.com/TheFahmi/omo-suites-installer/actions/workflows/ci.yml"><img src="https://github.com/TheFahmi/omo-suites-installer/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
   <a href="https://www.npmjs.com/package/omo-suites"><img src="https://img.shields.io/npm/v/omo-suites.svg" alt="NPM Version" /></a>
   <a href="https://www.npmjs.com/package/omo-suites"><img src="https://img.shields.io/npm/dm/omo-suites.svg" alt="NPM Downloads" /></a>
   <a href="https://www.npmjs.com/package/omo-suites"><img src="https://img.shields.io/npm/l/omo-suites.svg" alt="License" /></a>

package/dist/cli/omocs.js

@@ -39343,7 +39343,7 @@ _omocs_completions() {
     prev="\${COMP_WORDS[COMP_CWORD-1]}"
 
     # Top-level commands
-    commands="init init-deep doctor account profile agent lsp mcp stats status launchboard export import diff benchmark plan cost check memory completion index help"
+    commands="init init-deep doctor account profile agent lsp mcp stats status launchboard export import diff benchmark plan cost check memory completion index compact session worktree template bootstrap fallback watch marketplace squad auto config self-test help"
 
     case "\${prev}" in
         omocs|omo)
@@ -39390,6 +39390,46 @@ _omocs_completions() {
             COMPREPLY=( $(compgen -W "setup start status" -- "\${cur}") )
             return 0
             ;;
+        compact)
+            COMPREPLY=( $(compgen -W "config memory index stats all" -- "\${cur}") )
+            return 0
+            ;;
+        session)
+            COMPREPLY=( $(compgen -W "list search show diff" -- "\${cur}") )
+            return 0
+            ;;
+        worktree)
+            COMPREPLY=( $(compgen -W "list create remove prune" -- "\${cur}") )
+            return 0
+            ;;
+        template)
+            COMPREPLY=( $(compgen -W "save list load delete export" -- "\${cur}") )
+            return 0
+            ;;
+        fallback)
+            COMPREPLY=( $(compgen -W "show add remove" -- "\${cur}") )
+            return 0
+            ;;
+        watch)
+            COMPREPLY=( $(compgen -W "start generate" -- "\${cur}") )
+            return 0
+            ;;
+        marketplace)
+            COMPREPLY=( $(compgen -W "search install uninstall installed publish" -- "\${cur}") )
+            return 0
+            ;;
+        squad)
+            COMPREPLY=( $(compgen -W "launch status kill clean" -- "\${cur}") )
+            return 0
+            ;;
+        auto)
+            COMPREPLY=( $(compgen -W "run reset suppress status" -- "\${cur}") )
+            return 0
+            ;;
+        config)
+            COMPREPLY=( $(compgen -W "validate telemetry" -- "\${cur}") )
+            return 0
+            ;;
     esac
 
     COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
@@ -39407,7 +39447,10 @@ function generateZshCompletion() {
 # Or: omocs completion zsh >> ~/.zshrc
 
 _omocs() {
-    local -a commands memory_cmds index_cmds completion_cmds profile_cmds agent_cmds account_cmds lsp_cmds mcp_cmds lb_cmds
+    local -a commands
+    local -a memory_cmds index_cmds completion_cmds profile_cmds agent_cmds account_cmds
+    local -a lsp_cmds mcp_cmds lb_cmds compact_cmds session_cmds worktree_cmds
+    local -a template_cmds fallback_cmds watch_cmds marketplace_cmds squad_cmds auto_cmds config_cmds
 
     commands=(
         'init:Initialize OMO Suites configuration'
@@ -39431,6 +39474,18 @@ _omocs() {
         'memory:Workspace memory notes'
         'completion:Generate shell completions'
         'index:Workspace index builder'
+        'compact:Clean up config, memory, indexes, and stats data'
+        'session:Browse, search, and manage OpenCode sessions'
+        'worktree:Git worktree management for task isolation'
+        'template:Save, load, and share config templates'
+        'bootstrap:Scaffold a new OMO Suites workspace'
+        'fallback:View and edit model fallback chains'
+        'watch:Watch project structure and auto-regenerate AGENTS.md'
+        'marketplace:Browse, install, and manage community plugins'
+        'squad:Launch and manage parallel OpenCode agent instances'
+        'auto:Manage automatic background checks'
+        'config:Manage OMOCS configuration'
+        'self-test:Run a light smoke test to check core integration'
         'help:Display help'
     )
 
@@ -39493,6 +39548,74 @@ _omocs() {
         'status:Check Launchboard status'
     )
 
+    compact_cmds=(
+        'config:Scan and clean stale config entries'
+        'memory:Trim old workspace memory notes'
+        'index:Clean up orphaned workspace indexes'
+        'stats:Trim old stats data'
+        'all:Run all compact operations'
+    )
+
+    session_cmds=(
+        'list:List all OpenCode sessions'
+        'search:Search session content across all sessions'
+        'show:Show messages from a session'
+        'diff:Show git diff for a session workspace'
+    )
+
+    worktree_cmds=(
+        'list:List all git worktrees'
+        'create:Create a new worktree for isolated task work'
+        'remove:Remove a worktree'
+        'prune:Clean up stale worktree references'
+    )
+
+    template_cmds=(
+        'save:Save current workspace config as a named template'
+        'list:List saved templates'
+        'load:Load a template into current workspace'
+        'delete:Delete a saved template'
+        'export:Export a template as a shareable JSON file'
+    )
+
+    fallback_cmds=(
+        'show:Display current model fallback configuration'
+        'add:Add a fallback to a model'
+        'remove:Remove a fallback from a model'
+    )
+
+    watch_cmds=(
+        'start:Start watching for file structure changes'
+        'generate:Generate AGENTS.md once (no watching)'
+    )
+
+    marketplace_cmds=(
+        'search:Search the plugin registry'
+        'install:Install a plugin from the registry'
+        'uninstall:Remove an installed plugin'
+        'installed:List installed plugins'
+        'publish:Package a plugin for sharing'
+    )
+
+    squad_cmds=(
+        'launch:Launch a new OpenCode instance with a task'
+        'status:Show all running agents'
+        'kill:Kill a running agent'
+        'clean:Remove all completed/dead agents from the list'
+    )
+
+    auto_cmds=(
+        'run:Run all auto checks now'
+        'reset:Reset auto state (force re-run all checks)'
+        'suppress:Suppress a specific auto warning'
+        'status:Show auto check state'
+    )
+
+    config_cmds=(
+        'validate:Validate the syntax and structure of the config file'
+        'telemetry:Manage telemetry settings'
+    )
+
     if (( CURRENT == 2 )); then
         _describe 'command' commands
     elif (( CURRENT == 3 )); then
@@ -39506,6 +39629,16 @@ _omocs() {
             lsp) _describe 'subcommand' lsp_cmds ;;
             mcp) _describe 'subcommand' mcp_cmds ;;
             launchboard|lb) _describe 'subcommand' lb_cmds ;;
+            compact) _describe 'subcommand' compact_cmds ;;
+            session) _describe 'subcommand' session_cmds ;;
+            worktree) _describe 'subcommand' worktree_cmds ;;
+            template) _describe 'subcommand' template_cmds ;;
+            fallback) _describe 'subcommand' fallback_cmds ;;
+            watch) _describe 'subcommand' watch_cmds ;;
+            marketplace) _describe 'subcommand' marketplace_cmds ;;
+            squad) _describe 'subcommand' squad_cmds ;;
+            auto) _describe 'subcommand' auto_cmds ;;
+            config) _describe 'subcommand' config_cmds ;;
         esac
     fi
 }
@@ -39524,7 +39657,7 @@ complete -c omocs -f
 complete -c omo -f
 
 # Top-level commands
-set -l commands init init-deep doctor account profile agent lsp mcp stats status launchboard export import diff benchmark plan cost check memory completion index help
+set -l commands init init-deep doctor account profile agent lsp mcp stats status launchboard export import diff benchmark plan cost check memory completion index compact session worktree template bootstrap fallback watch marketplace squad auto config self-test help
 
 complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a init -d "Initialize OMO Suites configuration"
 complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a init-deep -d "Auto-generate hierarchical AGENTS.md"
@@ -39547,6 +39680,18 @@ complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a check -d "Co
 complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a memory -d "Workspace memory notes"
 complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a completion -d "Shell completions"
 complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a index -d "Workspace index builder"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a compact -d "Clean up config, memory, indexes, stats"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a session -d "Browse and manage OpenCode sessions"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a worktree -d "Git worktree management"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a template -d "Save, load, share config templates"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a bootstrap -d "Scaffold a new workspace"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a fallback -d "View and edit model fallback chains"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a watch -d "Watch and auto-regenerate AGENTS.md"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a marketplace -d "Browse and manage community plugins"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a squad -d "Launch parallel OpenCode agents"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a auto -d "Manage automatic background checks"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a config -d "Manage OMOCS configuration"
+complete -c omocs -n "not __fish_seen_subcommand_from $commands" -a self-test -d "Run smoke test for core integration"
 
 # Memory subcommands
 complete -c omocs -n "__fish_seen_subcommand_from memory" -a list -d "Show all notes"
@@ -39581,20 +39726,95 @@ complete -c omocs -n "__fish_seen_subcommand_from account" -a remove -d "Remove
 complete -c omocs -n "__fish_seen_subcommand_from account" -a rotate -d "Rotate keys"
 
 # LSP subcommands
-complete -c omocs -n "__fish_seen_subcommand_from lsp" -a "list detect install remove status" -d "LSP operations"
+complete -c omocs -n "__fish_seen_subcommand_from lsp" -a list -d "List LSP servers"
+complete -c omocs -n "__fish_seen_subcommand_from lsp" -a detect -d "Auto-detect LSP servers"
+complete -c omocs -n "__fish_seen_subcommand_from lsp" -a install -d "Install LSP server"
+complete -c omocs -n "__fish_seen_subcommand_from lsp" -a remove -d "Remove LSP server"
+complete -c omocs -n "__fish_seen_subcommand_from lsp" -a status -d "Check LSP status"
 
 # MCP subcommands
-complete -c omocs -n "__fish_seen_subcommand_from mcp" -a "list install remove status" -d "MCP operations"
+complete -c omocs -n "__fish_seen_subcommand_from mcp" -a list -d "List MCP servers"
+complete -c omocs -n "__fish_seen_subcommand_from mcp" -a install -d "Install MCP server"
+complete -c omocs -n "__fish_seen_subcommand_from mcp" -a remove -d "Remove MCP server"
+complete -c omocs -n "__fish_seen_subcommand_from mcp" -a status -d "Check MCP health"
 
 # Launchboard subcommands
-complete -c omocs -n "__fish_seen_subcommand_from launchboard" -a "setup start status" -d "Launchboard operations"
+complete -c omocs -n "__fish_seen_subcommand_from launchboard" -a setup -d "Set up Launchboard"
+complete -c omocs -n "__fish_seen_subcommand_from launchboard" -a start -d "Start Launchboard"
+complete -c omocs -n "__fish_seen_subcommand_from launchboard" -a status -d "Check Launchboard status"
+
+# Compact subcommands
+complete -c omocs -n "__fish_seen_subcommand_from compact" -a config -d "Clean stale config entries"
+complete -c omocs -n "__fish_seen_subcommand_from compact" -a memory -d "Trim old memory notes"
+complete -c omocs -n "__fish_seen_subcommand_from compact" -a index -d "Clean orphaned indexes"
+complete -c omocs -n "__fish_seen_subcommand_from compact" -a stats -d "Trim old stats data"
+complete -c omocs -n "__fish_seen_subcommand_from compact" -a all -d "Run all compact operations"
+
+# Session subcommands
+complete -c omocs -n "__fish_seen_subcommand_from session" -a list -d "List all sessions"
+complete -c omocs -n "__fish_seen_subcommand_from session" -a search -d "Search session content"
+complete -c omocs -n "__fish_seen_subcommand_from session" -a show -d "Show session messages"
+complete -c omocs -n "__fish_seen_subcommand_from session" -a diff -d "Show session git diff"
+
+# Worktree subcommands
+complete -c omocs -n "__fish_seen_subcommand_from worktree" -a list -d "List worktrees"
+complete -c omocs -n "__fish_seen_subcommand_from worktree" -a create -d "Create a worktree"
+complete -c omocs -n "__fish_seen_subcommand_from worktree" -a remove -d "Remove a worktree"
+complete -c omocs -n "__fish_seen_subcommand_from worktree" -a prune -d "Clean up stale worktrees"
+
+# Template subcommands
+complete -c omocs -n "__fish_seen_subcommand_from template" -a save -d "Save config as template"
+complete -c omocs -n "__fish_seen_subcommand_from template" -a list -d "List saved templates"
+complete -c omocs -n "__fish_seen_subcommand_from template" -a load -d "Load a template"
+complete -c omocs -n "__fish_seen_subcommand_from template" -a delete -d "Delete a template"
+complete -c omocs -n "__fish_seen_subcommand_from template" -a export -d "Export template as JSON"
+
+# Fallback subcommands
+complete -c omocs -n "__fish_seen_subcommand_from fallback" -a show -d "Show fallback config"
+complete -c omocs -n "__fish_seen_subcommand_from fallback" -a add -d "Add a fallback"
+complete -c omocs -n "__fish_seen_subcommand_from fallback" -a remove -d "Remove a fallback"
+
+# Watch subcommands
+complete -c omocs -n "__fish_seen_subcommand_from watch" -a start -d "Start watching"
+complete -c omocs -n "__fish_seen_subcommand_from watch" -a generate -d "Generate AGENTS.md once"
+
+# Marketplace subcommands
+complete -c omocs -n "__fish_seen_subcommand_from marketplace" -a search -d "Search plugins"
+complete -c omocs -n "__fish_seen_subcommand_from marketplace" -a install -d "Install a plugin"
+complete -c omocs -n "__fish_seen_subcommand_from marketplace" -a uninstall -d "Remove a plugin"
+complete -c omocs -n "__fish_seen_subcommand_from marketplace" -a installed -d "List installed plugins"
+complete -c omocs -n "__fish_seen_subcommand_from marketplace" -a publish -d "Package a plugin"
+
+# Squad subcommands
+complete -c omocs -n "__fish_seen_subcommand_from squad" -a launch -d "Launch agent with task"
+complete -c omocs -n "__fish_seen_subcommand_from squad" -a status -d "Show running agents"
+complete -c omocs -n "__fish_seen_subcommand_from squad" -a kill -d "Kill an agent"
+complete -c omocs -n "__fish_seen_subcommand_from squad" -a clean -d "Remove completed agents"
+
+# Auto subcommands
+complete -c omocs -n "__fish_seen_subcommand_from auto" -a run -d "Run all auto checks"
+complete -c omocs -n "__fish_seen_subcommand_from auto" -a reset -d "Reset auto state"
+complete -c omocs -n "__fish_seen_subcommand_from auto" -a suppress -d "Suppress a warning"
+complete -c omocs -n "__fish_seen_subcommand_from auto" -a status -d "Show auto check state"
+
+# Config subcommands
+complete -c omocs -n "__fish_seen_subcommand_from config" -a validate -d "Validate config file"
+complete -c omocs -n "__fish_seen_subcommand_from config" -a telemetry -d "Manage telemetry"
 
 # Also register for 'omo' alias
 complete -c omo -w omocs
 `;
 }
 function registerCompletionCommand(program2) {
-  program2.command("completion <shell>").description("Generate shell completion scripts (bash, zsh, fish)").action((shell) => {
+  program2.command("completion <shell>").description("Generate shell completion scripts (bash, zsh, fish)").addHelpText("after", `
+Installation:
+  ${source_default.cyan("omocs completion bash")} >> ~/.bashrc       # Bash
+  ${source_default.cyan("omocs completion bash")} >> ~/.bash_profile  # Bash (macOS)
+  ${source_default.cyan('eval "$(omocs completion bash)"')}           # Bash (current session)
+  ${source_default.cyan("omocs completion zsh")}  >> ~/.zshrc         # Zsh
+  ${source_default.cyan('eval "$(omocs completion zsh)"')}            # Zsh (current session)
+  ${source_default.cyan("omocs completion fish")} > ~/.config/fish/completions/omocs.fish  # Fish
+`).action((shell) => {
     try {
       const validShells = ["bash", "zsh", "fish"];
       const shellLower = shell.toLowerCase();

package/docs/API.md

@@ -0,0 +1,336 @@
+# OMO Suites — API & Command Reference
+
+## Installation
+
+```bash
+npm install -g omo-suites
+```
+
+After installation, two CLI commands are available: `omocs` and `omo` (alias).
+
+---
+
+## CLI Commands
+
+### `omocs init`
+Interactive setup wizard for OpenCode projects. Creates `opencode.json`, `AGENTS.md`, and configures LLM providers.
+
+```bash
+omocs init              # Interactive setup
+omocs init --deep       # Deep initialization with advanced options
+```
+
+### `omocs doctor`
+System health check. Validates configuration, checks dependencies, and detects common issues.
+
+```bash
+omocs doctor            # Run all health checks
+omocs doctor --fix      # Auto-fix detected issues
+```
+
+### `omocs self-test`
+Core integration validation. Tests LLM connectivity, MCP servers, and plugin functionality.
+
+```bash
+omocs self-test
+```
+
+### `omocs config`
+Configuration management with schema validation.
+
+```bash
+omocs config validate   # Validate current config against schema
+omocs config show       # Display current configuration
+omocs config set <key> <value>  # Set a config value
+omocs config get <key>  # Get a config value
+```
+
+### `omocs profile`
+Manage configuration profiles for different contexts (work, personal, projects).
+
+```bash
+omocs profile list      # List all profiles
+omocs profile use <name>  # Switch to a profile
+omocs profile create <name>  # Create new profile
+omocs profile delete <name>  # Delete a profile
+omocs profile export <name> <path>  # Export profile to file
+omocs profile import <path>  # Import profile from file
+```
+
+### `omocs agent`
+Manage AI agent configurations and routing.
+
+```bash
+omocs agent list        # List configured agents
+omocs agent add <name>  # Add new agent
+omocs agent remove <name>  # Remove agent
+omocs agent show <name>  # Show agent details
+```
+
+### `omocs mcp`
+Manage MCP (Model Context Protocol) server configurations.
+
+```bash
+omocs mcp list          # List configured MCP servers
+omocs mcp add <name>    # Add MCP server
+omocs mcp remove <name> # Remove MCP server
+omocs mcp status        # Check MCP server connectivity
+```
+
+### `omocs lsp`
+Manage LSP (Language Server Protocol) configurations.
+
+```bash
+omocs lsp list          # List configured LSP servers
+omocs lsp add <name>    # Add LSP server
+omocs lsp remove <name> # Remove LSP server
+```
+
+### `omocs compact`
+Compact and optimize project data.
+
+```bash
+omocs compact config    # Compact configuration
+omocs compact memory    # Compact memory/context
+omocs compact index     # Compact search index
+omocs compact stats     # Show compaction stats
+omocs compact all       # Compact everything
+```
+
+### `omocs session`
+Manage OpenCode sessions.
+
+```bash
+omocs session list      # List sessions
+omocs session show <id> # Show session details
+omocs session clean     # Clean old sessions
+```
+
+### `omocs worktree`
+Manage git worktrees for parallel development.
+
+```bash
+omocs worktree list     # List worktrees
+omocs worktree create <branch>  # Create worktree
+omocs worktree remove <branch>  # Remove worktree
+```
+
+### `omocs template`
+Bootstrap project templates.
+
+```bash
+omocs template list     # List available templates
+omocs template create <name>  # Create from template
+```
+
+### `omocs squad`
+Multi-agent squad management.
+
+```bash
+omocs squad launch      # Launch agent squad
+omocs squad status      # Check squad status
+omocs squad kill        # Kill running squad
+omocs squad clean       # Clean squad artifacts
+```
+
+### `omocs auto`
+Auto-check runner (used by OpenCode plugin on startup).
+
+```bash
+omocs auto              # Run auto checks
+omocs auto --skip-compact  # Skip compaction checks
+```
+
+### `omocs watch`
+File watcher for auto-indexing and live updates.
+
+```bash
+omocs watch             # Start watching project
+omocs watch --dir <path>  # Watch specific directory
+```
+
+### `omocs stats`
+Project and usage statistics.
+
+```bash
+omocs stats             # Show project stats
+```
+
+### `omocs cost`
+LLM usage cost tracking.
+
+```bash
+omocs cost              # Show cost summary
+omocs cost --detailed   # Detailed breakdown
+```
+
+### `omocs benchmark`
+Run LLM benchmarks.
+
+```bash
+omocs benchmark         # Run default benchmark
+omocs benchmark --model <name>  # Benchmark specific model
+```
+
+### `omocs plan`
+Generate implementation plans.
+
+```bash
+omocs plan <description>  # Generate plan from description
+```
+
+### `omocs diff`
+Smart diff viewer with AI analysis.
+
+```bash
+omocs diff              # Show staged changes
+omocs diff --ai         # AI-powered diff analysis
+```
+
+### `omocs memory`
+Manage project memory/context.
+
+```bash
+omocs memory show       # Show current memory
+omocs memory clear      # Clear memory
+```
+
+### `omocs account`
+Manage OMO Suites account.
+
+```bash
+omocs account           # Show account info
+omocs account login     # Login
+omocs account logout    # Logout
+```
+
+### `omocs marketplace`
+Browse and install community extensions.
+
+```bash
+omocs marketplace list  # List available extensions
+omocs marketplace install <name>  # Install extension
+```
+
+### `omocs launchboard`
+Interactive TUI dashboard.
+
+```bash
+omocs launchboard       # Open dashboard
+```
+
+### `omocs fallback`
+Configure LLM fallback chains.
+
+```bash
+omocs fallback list     # List fallback chains
+omocs fallback set <primary> <fallback>  # Set fallback
+```
+
+### `omocs completion`
+Shell completion scripts for bash, zsh, and fish.
+
+```bash
+omocs completion bash   # Output bash completions
+omocs completion zsh    # Output zsh completions
+omocs completion fish   # Output fish completions
+
+# Installation:
+omocs completion bash >> ~/.bashrc
+omocs completion zsh >> ~/.zshrc
+omocs completion fish > ~/.config/fish/completions/omocs.fish
+```
+
+### `omocs status`
+Quick status overview.
+
+```bash
+omocs status            # Show status
+```
+
+### `omocs check`
+Run project checks.
+
+```bash
+omocs check             # Run all checks
+```
+
+---
+
+## Global Flags
+
+All commands support these flags:
+
+| Flag | Description |
+|------|-------------|
+| `--debug` | Enable debug output |
+| `--verbose` | Enable verbose logging |
+| `--help` | Show command help |
+| `--version` | Show version |
+
+---
+
+## Configuration Schema
+
+OMO Suites uses `opencode.json` in the project root:
+
+```json
+{
+  "provider": "anthropic",
+  "model": "claude-sonnet-4-20250514",
+  "apiKey": "sk-...",
+  "mcpServers": {
+    "server-name": {
+      "command": "npx",
+      "args": ["-y", "mcp-server"],
+      "env": {}
+    }
+  },
+  "agents": {
+    "default": {
+      "model": "claude-sonnet-4-20250514",
+      "systemPrompt": "..."
+    }
+  }
+}
+```
+
+Global config lives at `~/.omocs/config.json`.
+
+---
+
+## Plugin API (OpenCode Integration)
+
+OMO Suites can be loaded as an OpenCode plugin:
+
+```json
+// opencode.json
+{
+  "plugins": ["omo-suites"]
+}
+```
+
+The plugin provides:
+- **Auto-checks** on startup (doctor, compact, index)
+- **Agent routing** for multi-model orchestration
+- **MCP/LSP management** with health monitoring
+- **Session management** with context compaction
+- **Telemetry** (opt-in) for usage analytics
+
+### Plugin Entry Point
+
+```typescript
+import plugin from 'omo-suites';
+// Plugin exports conform to OpenCode's plugin interface
+```
+
+---
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `OMOCS_NO_LOGS` | Disable structured logging |
+| `OMOCS_DEBUG` | Enable debug mode |
+| `OMOCS_HOME` | Override config directory (default: `~/.omocs`) |
+| `OPENCODE_CONFIG` | Override opencode.json path |

package/docs/release/1.15.0.md

@@ -0,0 +1,32 @@
+# OMO Suites 1.15.0 Post-Release Verification\n\n- **Date:** 2026-03-28\n- **Package:** `omo-suites@1.15.0`\n- **Status:** ✅ Verified\n\n## Verification Results\n\n- **npm metadata:** 
+omo-suites@1.15.0 | MIT | deps: 8 | versions: 26
+OMO Suites — OpenCode plugin + CLI toolkit. Multi-model orchestration, profiles, agent routing, MCP/LSP management.
+https://github.com/TheFahmi/omo-suites-installer#readme
+
+keywords: opencode, cli, developer-tools, ai, coding-assistant, plugin, profiles, mcp, lsp, agent-routing, omo-suites
+
+bin: omocs, omo
+
+dist
+.tarball: https://registry.npmjs.org/omo-suites/-/omo-suites-1.15.0.tgz
+.shasum: f529997a80f5fe55ee0c847d997d118316e1264e
+.integrity: sha512-wiRHIOglRhTMI0asWm9HijS1xbrPTCGGqpVA+kyBMZcxn2yyYlhjTGK+KOcA+j67jQGmNPUswKiLcOpcpd34CQ==
+.unpackedSize: 2.4 MB
+
+dependencies:
+@opencode-ai/plugin: ^1.2.20
+boxen: ^8.0.0
+chalk: ^5.4.0
+cli-table3: ^0.6.0
+commander: ^13.0.0
+inquirer: ^12.0.0
+ora: ^8.0.0
+zod: ^4.3.6
+
+maintainers:
+- thefahmi <hello.fahmihassan@gmail.com>
+
+dist-tags:
+latest: 1.15.0
+
+published 2 minutes ago by thefahmi <hello.fahmihassan@gmail.com> returned successfully. The  dist-tag points to .\n- **npx invocation:** 1.5.0 correctly output .\n- **Quirks/Notes:** \n  - A warning was shown about Node.js v18.20.8 not being officially supported by npm v11.9.0.\n  - The package installed and executed cleanly without other issues.\n  - `prebuild-install@7.1.3` was flagged as deprecated during installation.\n\n## Confidence Assessment\nHigh confidence. The package is published, available, and executable via npx.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omo-suites",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "OMO Suites — OpenCode plugin + CLI toolkit. Multi-model orchestration, profiles, agent routing, MCP/LSP management.",
   "type": "module",
   "main": "dist/plugin.js",