@trentapps/manager-protocol 1.2.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +136 -17
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -78,9 +78,33 @@ AI agents are powerful, but without guardrails they can:
78
78
  npm install @trentapps/manager-protocol
79
79
  ```
80
80
 
81
- ### MCP Configuration
81
+ ### Claude Code
82
82
 
83
- Add to your Claude Desktop or MCP client configuration:
83
+ The fastest way to get started with Claude Code:
84
+
85
+ **Option 1: Using the CLI (Recommended)**
86
+ ```bash
87
+ claude mcp add agent-supervisor -- npx @trentapps/manager-protocol
88
+ ```
89
+
90
+ **Option 2: Manual Configuration**
91
+
92
+ Add to your MCP settings file (`~/.claude/settings.json` or `.mcp.json` in your project):
93
+
94
+ ```json
95
+ {
96
+ "mcpServers": {
97
+ "agent-supervisor": {
98
+ "command": "npx",
99
+ "args": ["@trentapps/manager-protocol"]
100
+ }
101
+ }
102
+ }
103
+ ```
104
+
105
+ ### Other MCP Clients
106
+
107
+ For Claude Desktop or other MCP clients, add to your configuration file:
84
108
 
85
109
  ```json
86
110
  {
@@ -274,6 +298,73 @@ Evaluate CSS before adding it. Checks for duplicates, recommends externalization
274
298
  }
275
299
  ```
276
300
 
301
+ ### Task Management Tools
302
+
303
+ The supervisor includes full GitHub-integrated task management:
304
+
305
+ | Tool | Description |
306
+ |------|-------------|
307
+ | `create_task` | Create a new task (GitHub Issue) |
308
+ | `get_tasks` | List tasks with filtering |
309
+ | `get_pending_tasks` | Get tasks needing approval |
310
+ | `get_approved_tasks` | Get tasks ready to work on |
311
+ | `update_task` | Update task metadata |
312
+ | `close_task_with_comment` | Close with resolution |
313
+ | `add_task_comment` | Add comment to task |
314
+ | `link_commits` | Link commits to tasks |
315
+
316
+ ### App Monitoring Tools
317
+
318
+ Monitor production applications for health and uptime:
319
+
320
+ | Tool | Description |
321
+ |------|-------------|
322
+ | `add_monitored_app` | Register app for monitoring |
323
+ | `check_app_health` | Immediate health check |
324
+ | `check_all_apps_health` | Health check all apps |
325
+ | `get_app_status` | Get detailed app status |
326
+ | `list_monitored_apps` | List all monitored apps |
327
+ | `get_offline_apps` | List currently offline apps |
328
+
329
+ ### Session Management Tools
330
+
331
+ Track agent sessions for audit and observability:
332
+
333
+ | Tool | Description |
334
+ |------|-------------|
335
+ | `register_session` | Register a Claude session |
336
+ | `complete_session` | Mark session complete |
337
+ | `health_check` | Check supervisor health |
338
+
339
+ ### Rules Management Tools
340
+
341
+ | Tool | Description |
342
+ |------|-------------|
343
+ | `list_rules` | List configured rules (use filters!) |
344
+ | `add_rule` | Add custom rule |
345
+ | `remove_rule` | Remove rule |
346
+ | `load_preset` | Load rule preset |
347
+ | `discover_relevant_rules` | Auto-detect project tech stack |
348
+ | `list_project_profiles` | List available profiles |
349
+
350
+ ### Approval Workflow Tools
351
+
352
+ | Tool | Description |
353
+ |------|-------------|
354
+ | `list_pending_approvals` | List pending approvals |
355
+ | `approve_request` | Approve a request |
356
+ | `deny_request` | Deny a request |
357
+ | `check_approval_status` | Check approval status |
358
+
359
+ ### Audit Tools
360
+
361
+ | Tool | Description |
362
+ |------|-------------|
363
+ | `get_audit_events` | Query audit log |
364
+ | `get_audit_stats` | Get statistics |
365
+ | `export_audit_log` | Export as JSON |
366
+ | `get_approval_stats` | Approval workflow stats |
367
+
277
368
  ---
278
369
 
279
370
  ## Custom Rules
@@ -357,6 +448,24 @@ Built-in support for:
357
448
 
358
449
  ---
359
450
 
451
+ ## Configuration
452
+
453
+ ### Environment Variables
454
+
455
+ | Variable | Description | Default |
456
+ |----------|-------------|---------|
457
+ | `GITHUB_TOKEN` | GitHub personal access token for task management and approvals | Required for GitHub features |
458
+ | `DASHBOARD_PORT` | HTTP dashboard port | `3100` |
459
+ | `AUDIT_DB_PATH` | Path to SQLite audit database | `./data/audit.db` |
460
+ | `NODE_ENV` | Environment (development/production) | `development` |
461
+ | `DEBUG` | Enable debug logging | `false` |
462
+
463
+ ### Node.js Requirements
464
+
465
+ - Node.js 18.0.0 or higher required
466
+
467
+ ---
468
+
360
469
  ## Security & Deployment
361
470
 
362
471
  ### Local Usage (Default)
@@ -388,21 +497,31 @@ If deploying in a production environment with network access:
388
497
  ## Architecture
389
498
 
390
499
  ```
391
- ┌──────────────────────────────────────────────────────────────┐
392
- │ Agent Supervisor │
393
- ├──────────────────────────────────────────────────────────────┤
394
- │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
395
- │ │ Rules │ │ Rate │ │ Approval │ │
396
- │ │ Engine │ │ Limiter │ │ Manager │ │
397
- │ └─────────────┘ └─────────────┘ └─────────────────────┘ │
398
- │ ┌─────────────────────────────────────────────────────────┐│
399
- │ │ Audit Logger ││
400
- │ └─────────────────────────────────────────────────────────┘│
401
- ├──────────────────────────────────────────────────────────────┤
402
- │ MCP Server │
403
- │ evaluate_action | apply_business_rules | require_approval │
404
- │ log_event | list_rules | add_rule | get_audit_events ... │
405
- └──────────────────────────────────────────────────────────────┘
500
+ ┌──────────────────────────────────────────────────────────────────┐
501
+ │ Agent Supervisor │
502
+ ├──────────────────────────────────────────────────────────────────┤
503
+ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
504
+ │ │ Rules │ │ Rate │ │ GitHub Approval │ │
505
+ │ │ Engine │ │ Limiter │ │ Manager │ │
506
+ │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │
507
+ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
508
+ │ │ Task │ │ App │ │ CSS │ │
509
+ │ │ Manager │ │ Monitor │ │ Analyzer │ │
510
+ │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │
511
+ │ ┌───────────────────────────────────────────────────────────┐ │
512
+ │ │ Audit Logger (SQLite) │ │
513
+ │ └───────────────────────────────────────────────────────────┘ │
514
+ ├──────────────────────────────────────────────────────────────────┤
515
+ │ MCP Server (stdio) │
516
+ │ evaluate_action | create_task | check_app_health | css_eval │
517
+ │ log_event | register_session | list_rules | require_approval │
518
+ └──────────────────────────────────────────────────────────────────┘
519
+ │ │
520
+ ▼ ▼
521
+ ┌─────────────────────┐ ┌─────────────────────┐
522
+ │ GitHub Issues │ │ HTTP Dashboard │
523
+ │ (Task Storage) │ │ (localhost:3100) │
524
+ └─────────────────────┘ └─────────────────────┘
406
525
  ```
407
526
 
408
527
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trentapps/manager-protocol",
3
- "version": "1.2.0",
3
+ "version": "1.2.1",
4
4
  "description": "Enterprise Agent Supervisor - Rules Engine MCP Server for AI Agent Governance",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -52,7 +52,7 @@
52
52
  "prettier": "^3.1.1",
53
53
  "tsx": "^4.6.2",
54
54
  "typescript": "^5.3.2",
55
- "vitest": "^1.0.4"
55
+ "vitest": "^4.0.17"
56
56
  },
57
57
  "engines": {
58
58
  "node": ">=18.0.0"