centient 2.25.1 → 3.1.0

package/CHANGELOG.md

@@ -5,6 +5,129 @@ All notable changes to the MCP Server for Context Engineering.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2026-01-12
+
+### Added
+
+- **Automatic Global Installation** - Slash commands install automatically on npm install
+  - `npm postinstall` script installs 11 commands to `~/.claude/commands/`
+  - Works for both fresh installs and upgrades
+  - Version comparison ensures outdated commands are updated
+  - Customized commands (no version header) are never overwritten
+  - Silent on no-op, logs only when changes made
+
+- **Manual Global Setup** - New CLI command for explicit control
+  - `centient setup-global` - Install/update global commands
+  - `centient setup-global --force` - Force reinstall all commands
+  - `centient setup-global --remove` - Remove centient commands from global location
+
+### Changed
+
+- **Zero-Config Experience** - No more `centient init` required per project
+  - After `npm install -g centient`, all 11 slash commands work everywhere
+  - Project-local commands (`.claude/commands/`) still override global
+  - `centient init` now only needed for project-specific customization
+
+- **Test Suite** - 1,422 tests (+17 new tests for setup-global CLI parsing and postinstall logic)
+
+### Documentation
+
+- Added "Automatic Global Installation" section to README.md
+- Updated CLI Commands documentation with setup-global command
+- All template versions bumped to 3.1.0
+
+## [3.0.0] - 2026-01-12
+
+### Changed
+
+- **MCP SDK Upgrade** - Major version upgrade from 0.5.0 to 1.25.2
+  - Breaking: MCP protocol compatibility updated to latest spec
+  - Enables latest MCP features and improvements
+
+- **Vitest Upgrade** - Major version upgrade from 1.6.1 to 4.0.17
+  - Breaking: `poolOptions` config moved to top-level options
+  - Breaking: Constructor mocks require `function`/`class`, not arrow functions
+  - Resolves all security vulnerabilities in esbuild/vite chain
+
+- **Qdrant Client Upgrade** - 1.15.1 to 1.16.2
+  - API change: `vectors_count` renamed to `indexed_vectors_count`
+
+### Updated Dependencies
+
+| Package | Before | After |
+|---------|--------|-------|
+| `@modelcontextprotocol/sdk` | 0.5.0 | 1.25.2 |
+| `@google/genai` | 1.29.0 | 1.35.0 |
+| `vitest` | 1.6.1 | 4.0.17 |
+| `@vitest/coverage-v8` | 1.6.1 | 4.0.17 |
+| `@qdrant/js-client-rest` | 1.15.1 | 1.16.2 |
+| `tsx` | 4.20.6 | 4.21.0 |
+
+### Security
+
+- Resolved 5 moderate severity vulnerabilities (esbuild ≤0.24.2)
+- Zero vulnerabilities in dependency tree
+
+## [2.25.1] - 2026-01-12
+
+### Fixed
+
+- **NPM Package** - Include `templates` directory in package files
+  - Templates were missing from v2.25.0 causing `centient init` to fail
+  - Added `templates` to the `files` array in package.json
+
+## [2.25.0] - 2026-01-12
+
+### Added
+
+- **CLI Scaffolding Commands** - Project initialization and maintenance
+  - `centient init` - Scaffold `.claude/` directory with slash command templates
+  - `centient check-commands` - Show status of installed commands (missing/outdated/current/customized)
+  - `centient update-commands` - Update outdated commands with version comparison
+  - `centient update-commands --dry-run` - Preview updates without modifying files
+
+- **Slash Command Templates** (11 commands)
+  - `/session-start` - Initialize session memory with Qdrant coordination
+  - `/checkpoint` - Save progress checkpoint with session notes
+  - `/finalize` - End session and create finalization artifacts
+  - `/note` - Add decision/hypothesis/blocker/learning/finding to session
+  - `/recall` - Recall context from session memory or Memory Bank
+  - `/patterns` - Search pattern library for reusable solutions
+  - `/check-duplicate` - Check for duplicate work before starting
+  - `/constraint` - Track and enforce session constraints
+  - `/history` - Query session history and temporal graph
+  - `/promote` - Promote learnings to cross-project meta-knowledge
+  - `/session-status` - Show current session status and statistics
+
+- **Version Tracking** - YAML frontmatter with `centient-version` header
+  - Enables automatic outdated detection via semver comparison
+  - Four-state model: missing, outdated, current, customized
+
+### Changed
+
+- **Test Suite** - 1,382 tests (42 new tests for CLI scaffolding)
+  - `tests/commands.test.ts` - 32 tests for version extraction and comparison
+  - `tests/cli.test.ts` - 10 tests for init/check-commands/update-commands parsing
+
+### Documentation
+
+- Added `docs/CLI_SCAFFOLDING_ARCHITECTURE.md` - 362-line architecture deep-dive
+- Updated README.md with CLI Commands section
+- Extracted CLI Scaffolding Pattern to shared pattern library
+
+## [2.24.0] - 2026-01-12
+
+### Added
+
+- **Vertex AI Memory Bank Sync** - Automatic sync on promote
+  - `promote_learning` and `promote_decision` now sync to Vertex AI Memory Bank
+  - Added `--json` flag for machine-readable output from Python sync script
+  - Configured via `metaKnowledge.vertex.syncOnPromote` in config
+
+### Changed
+
+- **push_to_memory_bank** - Added `--json` flag for machine-readable Python output
+
 ## [2.23.0] - 2026-01-11
 
 ### Changed
@@ -442,6 +565,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+[3.1.0]: https://github.com/Szermer/centient/compare/v3.0.0...v3.1.0
+[3.0.0]: https://github.com/Szermer/centient/compare/v2.25.1...v3.0.0
+[2.25.1]: https://github.com/Szermer/centient/compare/v2.25.0...v2.25.1
+[2.25.0]: https://github.com/Szermer/centient/compare/v2.24.0...v2.25.0
+[2.24.0]: https://github.com/Szermer/centient/compare/v2.23.0...v2.24.0
+[2.23.0]: https://github.com/Szermer/centient/compare/v2.22.0...v2.23.0
+[2.22.0]: https://github.com/Szermer/centient/compare/v2.21.0...v2.22.0
 [2.21.0]: https://github.com/Szermer/centient/compare/v2.20.0...v2.21.0
 [2.20.0]: https://github.com/Szermer/centient/compare/v2.19.0...v2.20.0
 [2.19.0]: https://github.com/Szermer/centient/compare/v2.14.0...v2.19.0

package/README.md

@@ -1,9 +1,9 @@
 # Centient
 
-**Version:** 2.24.0
+**Version:** 3.1.0
 **Status:** Production Ready
-**Tools:** 93 across 16 modules
-**Tests:** 1343 passing
+**Tools:** 98 across 17 modules
+**Tests:** 1405 passing
 
 Centient is an MCP server that exposes context engineering operations as executable tools, enabling progressive skill loading and achieving **98.7% token reduction** through intelligent context management.
 
@@ -93,12 +93,12 @@ For full functionality, add environment variables to your config:
 
 ### Environment Variables
 
-| Variable             | Required            | Description                                        |
-| -------------------- | ------------------- | -------------------------------------------------- |
-| `OPENROUTER_API_KEY` | Consultation module | OpenRouter for LLM completions (unified billing)   |
-| `QDRANT_URL`         | Session module      | Qdrant Cloud URL                                   |
-| `QDRANT_API_KEY`     | Session module      | Qdrant API key                                     |
-| `GEMINI_API_KEY`     | Session + Search    | Gemini for embeddings and File Search              |
+| Variable             | Required            | Description                                      |
+| -------------------- | ------------------- | ------------------------------------------------ |
+| `OPENROUTER_API_KEY` | Consultation module | OpenRouter for LLM completions (unified billing) |
+| `QDRANT_URL`         | Session module      | Qdrant Cloud URL                                 |
+| `QDRANT_API_KEY`     | Session module      | Qdrant API key                                   |
+| `GEMINI_API_KEY`     | Session + Search    | Gemini for embeddings and File Search            |
 
 **API Key Usage:**
 
@@ -109,26 +109,37 @@ For full functionality, add environment variables to your config:
 
 ## CLI Commands
 
-Centient provides CLI commands for project scaffolding and diagnostics.
+Centient provides CLI commands for slash command management and diagnostics.
 
-### Project Scaffolding
+### Automatic Global Installation (v3.1.0+)
 
-Initialize and maintain slash commands in your project:
+**Slash commands are automatically installed when you install centient:**
 
 ```bash
-# Initialize .claude/ directory with command templates
-centient init
+npm install -g centient
+# → Automatically installs 11 slash commands to ~/.claude/commands/
+# → Commands are now available in ALL projects
+```
 
-# Force overwrite existing files
-centient init --force
+On upgrade, outdated commands are automatically updated while preserving your customizations.
 
-# Check status of installed commands
-centient check-commands
+### Manual Command Management
 
-# Update outdated commands (preserves customizations)
-centient update-commands
+```bash
+# Check global command status
+centient setup-global           # Install/update global commands
+centient setup-global --force   # Force reinstall all
+centient setup-global --remove  # Remove centient commands (preserves custom)
+
+# Project-local commands (optional, overrides global)
+centient init                   # Initialize .claude/ directory with commands
+centient init --force           # Force overwrite existing files
+centient check-commands         # Check status of installed commands
+centient update-commands        # Update outdated commands
 ```
 
+**Command precedence:** Project-local (`.claude/commands/`) overrides global (`~/.claude/commands/`)
+
 **Command Status:**
 | Status | Description |
 |--------|-------------|
@@ -137,23 +148,29 @@ centient update-commands
 | Outdated | Installed version lower than template |
 | Customized | No version header (user modified) |
 
-**What `centient init` creates:**
+**Global commands installed automatically** (in `~/.claude/commands/`):
+
+| Command | Description |
+|---------|-------------|
+| `/session-start` | Initialize session memory |
+| `/note` | Add decision/hypothesis/blocker |
+| `/checkpoint` | Save progress checkpoint |
+| `/finalize` | End session, create artifacts |
+| `/promote` | Promote to cross-project knowledge |
+| `/patterns` | Search pattern library |
+| `/recall` | Recall from memory |
+| `/check-duplicate` | Detect duplicate work |
+| `/constraint` | Manage constraints |
+| `/history` | Browse session history |
+| `/session-status` | Show session state |
+
+**Optional project-local structure** (via `centient init`):
+
 ```
 .claude/
-├── commands/
-│   ├── session-start.md    # Initialize session memory
-│   ├── note.md             # Add decision/hypothesis/blocker
-│   ├── checkpoint.md       # Save progress checkpoint
-│   ├── finalize.md         # End session, create artifacts
-│   ├── promote.md          # Promote to cross-project knowledge
-│   ├── patterns.md         # Search pattern library
-│   ├── recall.md           # Recall from memory
-│   ├── check-duplicate.md  # Detect duplicate work
-│   ├── constraint.md       # Manage constraints
-│   ├── history.md          # Browse session history
-│   └── session-status.md   # Show session state
-├── hooks/                  # (if templates exist)
-└── settings.json           # (if template exists)
+├── commands/           # Project-specific command overrides
+├── hooks/              # Git hooks (if templates exist)
+└── settings.json       # Project settings
 ```
 
 ### Diagnostics
@@ -165,7 +182,7 @@ centient --version
 # Show help
 centient --help
 
-# List all 93 MCP tools
+# List all 98 MCP tools
 centient --list-tools
 
 # Run health check (validates API connections)
@@ -185,7 +202,7 @@ centient --monitor --follow     # Live tail mode
 
 ## Architecture
 
-### 16 Modules, 93 Tools
+### 17 Modules, 98 Tools
 
 | Module                               | Tools | Purpose                                                 |
 | ------------------------------------ | ----- | ------------------------------------------------------- |
@@ -204,6 +221,7 @@ centient --monitor --follow     # Live tail mode
 | [Branching](#branching-module)       | 6     | Session branching and decision trees                    |
 | [Knowledge](#knowledge-module)       | 3     | Cross-project meta-knowledge                            |
 | [Trails](#trails-module)             | 8     | DevLex syntopic trail discovery                         |
+| [Channels](#channels-module)         | 5     | Channel-based agent communication                       |
 | [RLVR](#rlvr-module)                 | 1     | Reinforcement learning verification                     |
 
 ### Patterns Module (13 tools)
@@ -392,6 +410,16 @@ DevLex syntopic trail discovery for knowledge exploration:
 - `trail_list` - List existing trails
 - `trail_view` - View trail details
 
+### Channels Module (5 tools)
+
+Channel-based agent communication for multi-agent coordination:
+
+- `channel_create` - Create a new channel for agent communication
+- `channel_message` - Post message with threading, @mentions, task linking
+- `channel_read` - Read messages with filtering (unread, mentions, time)
+- `channel_list` - List all channels with optional unread counts
+- `channel_delete` - Delete a channel and all its messages
+
 ### RLVR Module (1 tool)
 
 Reinforcement learning verification:
@@ -492,7 +520,7 @@ npm run lint           # Type checking
 ```
 src/
 ├── index.ts              # Entry point (stdio transport)
-├── server.ts             # MCP server config (93 tools)
+├── server.ts             # MCP server config (98 tools)
 ├── tools/
 │   ├── patterns/         # Progressive skill loading (13 tools)
 │   ├── artifacts/        # Historical knowledge (5 tools)
@@ -509,11 +537,13 @@ src/
 │   ├── branching/        # Session branching (6 tools)
 │   ├── knowledge/        # Cross-project meta-knowledge (3 tools)
 │   ├── trails/           # DevLex syntopic discovery (8 tools)
+│   ├── channels/         # Agent communication (5 tools)
 │   └── rlvr/             # RLVR verification (1 tool)
 └── utils/
     ├── SessionCoordinator.ts   # Qdrant session management
     ├── ResearchCoordinator.ts  # Research session management
     ├── MetaKnowledgeManager.ts # Cross-project meta-knowledge
+    ├── ChannelCoordinator.ts   # Agent communication channels
     └── tokenEstimator.ts       # Token usage tracking
 ```
 

package/dist/cli.d.ts

@@ -28,11 +28,16 @@ export interface UpdateOptions {
     force: boolean;
     dryRun: boolean;
 }
+export interface SetupGlobalOptions {
+    force: boolean;
+    remove: boolean;
+}
 export declare function parseArgs(args: string[]): {
-    action: "server" | "version" | "help" | "list-tools" | "health" | "config" | "monitor" | "log" | "stats" | "init" | "check-commands" | "update-commands";
+    action: "server" | "version" | "help" | "list-tools" | "health" | "config" | "monitor" | "log" | "stats" | "init" | "setup-global" | "check-commands" | "update-commands";
     monitorOptions?: MonitorOptions;
     logOptions?: LogOptions;
     initOptions?: InitOptions;
+    setupGlobalOptions?: SetupGlobalOptions;
     updateOptions?: UpdateOptions;
 };
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAgC1D,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAKD,wBAAgB,SAAS,IAAI,IAAI,CAgDhC;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAoF9C;AAKD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqFjD;AAKD,wBAAgB,WAAW,IAAI,IAAI,CAsClC;AAgID,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA8GhD;AAKD,wBAAsB,GAAG,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGnF;AAmMD,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFpE;AAKD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAKD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IACzC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IACzJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAuIA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAkC1D,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAKD,wBAAgB,SAAS,IAAI,IAAI,CAqDhC;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CA4I9C;AAKD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA6FjD;AAKD,wBAAgB,WAAW,IAAI,IAAI,CAgDlC;AAqID,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA+HhD;AAKD,wBAAsB,GAAG,CAAC,OAAO,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiHhB;AAiND,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2FpE;AAKD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAKD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IACzC,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,KAAK,GACL,OAAO,GACP,MAAM,GACN,cAAc,GACd,gBAAgB,GAChB,iBAAiB,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAyJA"}

package/dist/cli.js

@@ -5,7 +5,7 @@ import { homedir } from "os";
 import { createReadStream } from "fs";
 import { createInterface } from "readline";
 import { listInstances, getAggregatedStats, formatUptime, isHeartbeatStale, } from "./utils/InstanceRegistry.js";
-import { getAuditLogPath as getConfigAuditLogPath, getMetaKnowledgeConfig } from "./utils/config.js";
+import { getAuditLogPath as getConfigAuditLogPath, getMetaKnowledgeConfig, } from "./utils/config.js";
 import { getSharedPatternsPath } from "./utils/filesystem.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function getVersion() {
@@ -28,7 +28,8 @@ export function printHelp() {
 Usage: centient [command] [options]
 
 Commands:
-  init                    Initialize .claude/ directory with commands
+  init                    Initialize .claude/ directory with commands (project-local)
+  setup-global            Install commands to ~/.claude/commands/ (global)
   check-commands          Show missing/outdated commands
   update-commands         Update outdated commands
 
@@ -39,8 +40,9 @@ Options:
       --health            Run health check and exit
       --config            Show current configuration
       --stats             Show usage statistics and exit
-      --force             Force overwrite (for init/update-commands)
+      --force             Force overwrite (for init/update-commands/setup-global)
       --dry-run           Show what would be updated without making changes
+      --remove            Remove global commands (for setup-global)
 
 Instance Monitoring (like ps):
       --monitor           List all running centient instances
@@ -58,8 +60,11 @@ Audit Log (per-project):
 Running without arguments starts the MCP server (stdio transport).
 
 Examples:
-  centient init                   # Initialize project with commands
+  centient init                   # Initialize project with commands (local)
   centient init --force           # Overwrite existing commands
+  centient setup-global           # Install commands globally (~/.claude/commands/)
+  centient setup-global --force   # Force reinstall global commands
+  centient setup-global --remove  # Remove global centient commands
   centient check-commands         # Check command status
   centient update-commands        # Update outdated commands
   centient update-commands --dry-run  # Preview what would be updated
@@ -77,28 +82,50 @@ export function printTools(tools) {
     for (const tool of tools) {
         let module = "other";
         const name = tool.name;
-        if (name.includes("Pattern") || name.includes("Skill") || name === "findPatterns") {
+        if (name.includes("Pattern") ||
+            name.includes("Skill") ||
+            name === "findPatterns") {
             module = "patterns";
         }
-        else if (name.includes("Artifact") || (name.includes("Session") && name.includes("load"))) {
+        else if (name.includes("Artifact") ||
+            (name.includes("Session") && name.includes("load"))) {
             module = "artifacts";
         }
-        else if (name.includes("Note") || name === "getDecisions" || name === "getHypotheses") {
+        else if (name.includes("Note") ||
+            name === "getDecisions" ||
+            name === "getHypotheses") {
             module = "memory";
         }
-        else if (name.includes("Compression") || name.includes("Reuse") || name.includes("Cost") || name.includes("Analytics") || name.includes("Audit")) {
+        else if (name.includes("Compression") ||
+            name.includes("Reuse") ||
+            name.includes("Cost") ||
+            name.includes("Analytics") ||
+            name.includes("Audit")) {
             module = "metrics";
         }
-        else if (name.includes("semantic") || (name.includes("index") && name.includes("Session")) || name.includes("SearchStats")) {
+        else if (name.includes("semantic") ||
+            (name.includes("index") && name.includes("Session")) ||
+            name.includes("SearchStats")) {
             module = "search";
         }
-        else if (name.includes("session") || name.includes("Session") || name.includes("Constraint") || name.includes("Claim") || name.includes("Citation") || name.includes("Verification") || name.includes("Feasibility") || name.includes("Duplicate") || name.includes("Approval")) {
+        else if (name.includes("session") ||
+            name.includes("Session") ||
+            name.includes("Constraint") ||
+            name.includes("Claim") ||
+            name.includes("Citation") ||
+            name.includes("Verification") ||
+            name.includes("Feasibility") ||
+            name.includes("Duplicate") ||
+            name.includes("Approval")) {
             module = "session";
         }
         else if (name.includes("Stuck") || name.includes("Recovery")) {
             module = "stuck";
         }
-        else if (name.includes("Health") || name.includes("Circuit") || name.includes("RateLimit") || name.includes("Qdrant")) {
+        else if (name.includes("Health") ||
+            name.includes("Circuit") ||
+            name.includes("RateLimit") ||
+            name.includes("Qdrant")) {
             module = "health";
         }
         else if (name.includes("Research") || name.includes("Model")) {
@@ -107,19 +134,29 @@ export function printTools(tools) {
         else if (name.includes("memory_bank")) {
             module = "memory-bank";
         }
-        else if (name.includes("Relationship") || name.includes("Graph") || name.includes("link")) {
+        else if (name.includes("Relationship") ||
+            name.includes("Graph") ||
+            name.includes("link")) {
             module = "graph";
         }
-        else if (name.includes("consult") || name.includes("Consultation") || name.includes("Consensus") || name.includes("Review") || (name.includes("Decision") && name.includes("validate"))) {
+        else if (name.includes("consult") ||
+            name.includes("Consultation") ||
+            name.includes("Consensus") ||
+            name.includes("Review") ||
+            (name.includes("Decision") && name.includes("validate"))) {
             module = "consultation";
         }
-        else if (name.includes("Branch") || name.includes("branch") || (name.includes("Decision") && name.includes("Point"))) {
+        else if (name.includes("Branch") ||
+            name.includes("branch") ||
+            (name.includes("Decision") && name.includes("Point"))) {
             module = "branching";
         }
         else if (name.includes("rlvr")) {
             module = "rlvr";
         }
-        else if (name.includes("Learning") || name.includes("Knowledge") || name.includes("promote")) {
+        else if (name.includes("Learning") ||
+            name.includes("Knowledge") ||
+            name.includes("promote")) {
             module = "knowledge";
         }
         else if (name.includes("trail")) {
@@ -171,7 +208,9 @@ export async function printHealth() {
     };
     console.log("Environment:");
     for (const [key, value] of Object.entries(envVars)) {
-        const status = value ? "\x1b[32m✓\x1b[0m configured" : "\x1b[31m✗\x1b[0m not set";
+        const status = value
+            ? "\x1b[32m✓\x1b[0m configured"
+            : "\x1b[31m✗\x1b[0m not set";
         console.log(`  ${key.padEnd(20)} ${status}`);
     }
     console.log("\nServices:");
@@ -276,31 +315,33 @@ export function printConfig() {
     console.log("");
 }
 const isTTY = process.stdout.isTTY ?? false;
-const colors = isTTY ? {
-    reset: "\x1b[0m",
-    bright: "\x1b[1m",
-    dim: "\x1b[2m",
-    red: "\x1b[31m",
-    green: "\x1b[32m",
-    yellow: "\x1b[33m",
-    blue: "\x1b[34m",
-    magenta: "\x1b[35m",
-    cyan: "\x1b[36m",
-    white: "\x1b[37m",
-    gray: "\x1b[90m",
-} : {
-    reset: "",
-    bright: "",
-    dim: "",
-    red: "",
-    green: "",
-    yellow: "",
-    blue: "",
-    magenta: "",
-    cyan: "",
-    white: "",
-    gray: "",
-};
+const colors = isTTY
+    ? {
+        reset: "\x1b[0m",
+        bright: "\x1b[1m",
+        dim: "\x1b[2m",
+        red: "\x1b[31m",
+        green: "\x1b[32m",
+        yellow: "\x1b[33m",
+        blue: "\x1b[34m",
+        magenta: "\x1b[35m",
+        cyan: "\x1b[36m",
+        white: "\x1b[37m",
+        gray: "\x1b[90m",
+    }
+    : {
+        reset: "",
+        bright: "",
+        dim: "",
+        red: "",
+        green: "",
+        yellow: "",
+        blue: "",
+        magenta: "",
+        cyan: "",
+        white: "",
+        gray: "",
+    };
 function formatLogEntry(entry) {
     const time = new Date(entry.timestamp).toLocaleTimeString();
     const outcomeColor = entry.outcome === "success" ? colors.green : colors.red;
@@ -381,9 +422,12 @@ export async function printStats() {
         }
         stats.lastTimestamp = entry.timestamp;
         stats.toolCounts[entry.tool] = (stats.toolCounts[entry.tool] || 0) + 1;
-        stats.toolTotalDurations[entry.tool] = (stats.toolTotalDurations[entry.tool] || 0) + entry.duration;
-        stats.toolDurationCounts[entry.tool] = (stats.toolDurationCounts[entry.tool] || 0) + 1;
-        stats.eventTypeCounts[entry.eventType] = (stats.eventTypeCounts[entry.eventType] || 0) + 1;
+        stats.toolTotalDurations[entry.tool] =
+            (stats.toolTotalDurations[entry.tool] || 0) + entry.duration;
+        stats.toolDurationCounts[entry.tool] =
+            (stats.toolDurationCounts[entry.tool] || 0) + 1;
+        stats.eventTypeCounts[entry.eventType] =
+            (stats.eventTypeCounts[entry.eventType] || 0) + 1;
         if (entry.outcome === "success") {
             stats.successCount++;
         }
@@ -550,7 +594,7 @@ function printInstancesJson(instances) {
     const stats = getAggregatedStats();
     const output = {
         timestamp: new Date().toISOString(),
-        instances: instances.map(i => ({
+        instances: instances.map((i) => ({
             ...i,
             reqPerMin: calculateReqPerMin(i),
             stale: isHeartbeatStale(i),
@@ -578,7 +622,7 @@ function printInstancesSummary(version) {
     console.log(`Memory:        ${stats.totalMemoryMB} MB total`);
     console.log(`Requests:      ${stats.totalRequests} total`);
     if (instances.length > 0) {
-        const oldest = instances.reduce((a, b) => a.uptime > b.uptime ? a : b);
+        const oldest = instances.reduce((a, b) => (a.uptime > b.uptime ? a : b));
         console.log(`Oldest:        ${formatUptime(oldest.uptime)} (${oldest.projectName})`);
     }
     console.log("");
@@ -639,7 +683,7 @@ export async function monitor(options) {
     const version = getVersion();
     let instances = listInstances();
     if (options.project) {
-        instances = instances.filter(i => i.projectName.toLowerCase().includes(options.project.toLowerCase()));
+        instances = instances.filter((i) => i.projectName.toLowerCase().includes(options.project.toLowerCase()));
     }
     if (options.quiet) {
         printInstancesQuiet(instances);
@@ -704,9 +748,11 @@ export function parseArgs(args) {
     let monitorSummary = false;
     let initForce = false;
     let updateDryRun = false;
+    let setupGlobalRemove = false;
     let hasMonitor = false;
     let hasLog = false;
     let hasInit = false;
+    let hasSetupGlobal = false;
     let hasCheckCommands = false;
     let hasUpdateCommands = false;
     for (let i = 0; i < args.length; i++) {
@@ -730,6 +776,9 @@ export function parseArgs(args) {
             case "init":
                 hasInit = true;
                 break;
+            case "setup-global":
+                hasSetupGlobal = true;
+                break;
             case "check-commands":
                 hasCheckCommands = true;
                 break;
@@ -765,6 +814,9 @@ export function parseArgs(args) {
             case "--dry-run":
                 updateDryRun = true;
                 break;
+            case "--remove":
+                setupGlobalRemove = true;
+                break;
             case "-p":
             case "--project":
                 const projectArg = args[i + 1];
@@ -805,11 +857,20 @@ export function parseArgs(args) {
     if (hasInit) {
         return { action: "init", initOptions: { force: initForce } };
     }
+    if (hasSetupGlobal) {
+        return {
+            action: "setup-global",
+            setupGlobalOptions: { force: initForce, remove: setupGlobalRemove },
+        };
+    }
     if (hasCheckCommands) {
         return { action: "check-commands" };
     }
     if (hasUpdateCommands) {
-        return { action: "update-commands", updateOptions: { force: initForce, dryRun: updateDryRun } };
+        return {
+            action: "update-commands",
+            updateOptions: { force: initForce, dryRun: updateDryRun },
+        };
     }
     return { action: "server" };
 }