@decibelsystems/tools 2.0.1 → 2.1.0

package/README.md

@@ -1,8 +1,8 @@
 # @decibelsystems/tools
 
-MCP server for project intelligence. 26 facade tools (170+ internal handlers) across 20 domains: work tracking, architecture, experiments, design, git forensics, agent coordination, and more.
+MCP server for project intelligence. 27 facade tools (170+ internal handlers) across work tracking, architecture, experiments, design, git forensics, agent coordination, and more.
 
-Tested with Claude Desktop, Claude Code, and Cursor. [Learn more →](https://decibel.systems/tools)
+Tested with Claude Desktop, Claude Code, and Cursor. [Learn more](https://decibel.systems/tools)
 
 <a href="https://github.com/decibelsystems/decibel-tools-mcp#cursor">
   <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add to Cursor" height="32" />
@@ -10,23 +10,6 @@ Tested with Claude Desktop, Claude Code, and Cursor. [Learn more →](https://de
 
 > **Note:** The one-click Cursor install only works on GitHub. [Click here](https://github.com/decibelsystems/decibel-tools-mcp#cursor) or see manual setup below.
 
-## What It Does
-
-| Domain | Purpose | Example Tools |
-|--------|---------|---------------|
-| **Sentinel** | Work tracking | `sentinel_create_issue`, `sentinel_log_epic`, `sentinel_list_epics` |
-| **Dojo** | AI incubator | `dojo_add_wish`, `dojo_create_proposal`, `dojo_run_experiment` |
-| **Architect** | Decisions | `architect_createAdr`, `architect_createPolicy` |
-| **Roadmap** | Strategy | `roadmap_get`, `roadmap_getHealth`, `roadmap_linkEpic` |
-| **Oracle** | Recommendations | `oracle_next_actions`, `oracle_roadmap` |
-| **Designer** | Design decisions | `designer_record_design_decision`, `designer_crit` |
-| **Friction** | Pain points | `friction_log`, `friction_bump`, `friction_resolve` |
-| **Learnings** | Knowledge base | `learnings_append`, `learnings_list` |
-| **Context** | AI memory | `decibel_context_pin`, `decibel_context_refresh` |
-| **Registry** | Project management | `project_init`, `registry_list`, `registry_add` |
-| **Agentic** | Config compilation | `agentic_compile_pack`, `agentic_render` |
-| **Provenance** | Audit trail | `provenance_list` |
-
 ## Quick Start
 
 ```bash
@@ -37,11 +20,23 @@ npm install -g @decibelsystems/tools
 npx @decibelsystems/tools
 ```
 
+### Project Setup
+
+After installing, initialize your first project:
+
+```bash
+# Copy the example registry (one-time setup)
+cp projects.example.json projects.json
+# Edit projects.json with your project paths
+```
+
+Or use the MCP tools directly — call `project_init` with your project path and it will create the `.decibel/` folder and register the project automatically.
+
 ## Platform Setup
 
-### Cursor
+### Claude Code
 
-Add to `~/.cursor/mcp.json`:
+Add to `.mcp.json` in your project root or `~/.claude/settings.json`:
 
 ```json
 {
@@ -54,9 +49,9 @@ Add to `~/.cursor/mcp.json`:
 }
 ```
 
-### Claude Code
+### Cursor
 
-Add to `.mcp.json` in your project root or `~/.claude/settings.json`:
+Add to `~/.cursor/mcp.json`:
 
 ```json
 {
@@ -86,152 +81,86 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 
 ---
 
-## Tools Reference
-
-### Sentinel (16 tools)
-*Work tracking: issues, epics, test specs*
-
-| Tool | Description |
-|------|-------------|
-| `sentinel_create_issue` | Create a tracked issue with severity (low/med/high/critical) |
-| `sentinel_close_issue` | Close an issue with resolution note |
-| `sentinel_list_repo_issues` | List issues for a project, optionally filtered by status |
-| `sentinel_listIssues` | List issues with filtering by epic or status |
-| `sentinel_createIssue` | Create issue (YAML format with auto-generated ID) |
-| `sentinel_log_epic` | Create a new epic (large feature) record |
-| `sentinel_list_epics` | List all epics with optional filters |
-| `sentinel_get_epic` | Get details of a specific epic |
-| `sentinel_get_epic_issues` | Get all issues linked to an epic |
-| `sentinel_resolve_epic` | Fuzzy search for epics by name or keyword |
-| `sentinel_scan` | Scan project data for validation, orphans, stale items |
-| `sentinel_scanData` | Scan using Python Sentinel Data Inspector |
-| `sentinel_createTestSpec` | Create a test specification atom |
-| `sentinel_listTestSpecs` | List all test specifications |
-| `sentinel_compileTests` | Compile test specs into documentation |
-| `sentinel_auditPolicies` | Audit policy compliance and freshness |
-
-### Dojo (10 tools)
-*AI Feature Incubator: wishes, proposals, experiments*
-
-| Tool | Description |
-|------|-------------|
-| `dojo_add_wish` | Add a capability wish (what, why, inputs, outputs) |
-| `dojo_list_wishes` | List wishes from the wishlist |
-| `dojo_create_proposal` | Create a proposal for a feature or capability |
-| `dojo_scaffold_experiment` | Create experiment skeleton from a proposal |
-| `dojo_list` | List proposals, experiments, and wishes |
-| `dojo_run_experiment` | Run an experiment in sandbox mode |
-| `dojo_get_results` | Get results from a previous experiment run |
-| `dojo_read_artifact` | Read artifact file from experiment results |
-| `dojo_can_graduate` | Check if experiment can graduate to real tool |
-| `dojo_projects` | List available projects for Dojo operations |
-
-### Architect (6 tools)
-*Architecture decisions and policies*
-
-| Tool | Description |
-|------|-------------|
-| `architect_record_arch_decision` | Record an ADR (markdown format) |
-| `architect_createAdr` | Create ADR (YAML format with auto ID) |
-| `architect_createPolicy` | Create a policy with rules and enforcement |
-| `architect_listPolicies` | List all policies, filter by severity/tags |
-| `architect_getPolicy` | Get details of a specific policy |
-| `architect_compileOversight` | Compile policies into documentation |
-
-### Roadmap (6 tools)
-*Strategic planning and health tracking*
-
-| Tool | Description |
-|------|-------------|
-| `roadmap_get` | Get full roadmap (objectives, themes, milestones) |
-| `roadmap_list` | List epics with roadmap context and health scores |
-| `roadmap_getEpicContext` | Get strategic context for a specific epic |
-| `roadmap_getHealth` | Get epics with low health scores needing attention |
-| `roadmap_linkEpic` | Link epic to theme, milestone, objectives |
-| `roadmap_init` | Initialize a new roadmap.yaml scaffold |
-
-### Oracle (2 tools)
-*AI-powered recommendations*
-
-| Tool | Description |
-|------|-------------|
-| `oracle_next_actions` | Get recommended next actions for a project |
-| `oracle_roadmap` | Evaluate roadmap progress against milestones |
-
-### Designer (7 tools)
-*Design decisions, Figma integration, and creative feedback*
-
-| Tool | Description |
-|------|-------------|
-| `designer_record_design_decision` | Record a design decision |
-| `designer_crit` | Log early creative feedback (gut reactions, hunches) |
-| `designer_list_crits` | List crit observations, filter by area/sentiment |
-| `designer_sync_tokens` | Sync design tokens from Figma variables |
-| `designer_review_figma` | Review Figma component against design principles |
-| `designer_upsert_principle` | Create or update a design principle |
-| `designer_list_principles` | List design principles, filter by category |
-
-### Friction (4 tools)
-*Track recurring pain points*
-
-| Tool | Description |
-|------|-------------|
-| `friction_log` | Log a friction point (context, description, impact) |
-| `friction_list` | List friction points sorted by impact/signal |
-| `friction_resolve` | Mark friction as resolved with solution reference |
-| `friction_bump` | Bump signal count when encountering same friction |
-
-### Learnings (2 tools)
-*Living knowledge documents*
-
-| Tool | Description |
-|------|-------------|
-| `learnings_append` | Append entry to project's learnings document |
-| `learnings_list` | List entries, filter by category |
-
-### Context (8 tools)
-*AI memory: pinned facts, events, artifacts*
-
-| Tool | Description |
-|------|-------------|
-| `decibel_context_refresh` | Compile full context pack for AI memory |
-| `decibel_context_pin` | Pin a fact to persistent memory |
-| `decibel_context_unpin` | Remove a pinned fact |
-| `decibel_context_list` | List all pinned facts |
-| `decibel_event_append` | Append event to activity journal |
-| `decibel_event_search` | Search events in journal |
-| `decibel_artifact_list` | List artifacts for a run |
-| `decibel_artifact_read` | Read artifact content |
-
-### Registry (7 tools)
-*Project discovery and management*
-
-| Tool | Description |
-|------|-------------|
-| `project_init` | Initialize .decibel/ folder in a project |
-| `project_status` | Check project status and available tools |
-| `registry_list` | List all registered projects |
-| `registry_add` | Register a project in the registry |
-| `registry_remove` | Remove project from registry |
-| `registry_alias` | Add alias to a project |
-| `registry_resolve` | Test resolution of project ID/alias |
-
-### Agentic (4 tools)
-*Configuration compilation and rendering*
-
-| Tool | Description |
-|------|-------------|
-| `agentic_compile_pack` | Compile config into versioned, hashed pack |
-| `agentic_render` | Transform payload into rendered text |
-| `agentic_lint` | Validate output against renderer constraints |
-| `agentic_golden_eval` | Run golden eval regression tests |
-
-### Provenance (1 tool)
-*Audit trail*
-
-| Tool | Description |
-|------|-------------|
-| `provenance_list` | List provenance events for artifact/actor |
+## Facade Tools
+
+All tools are accessed through **facade commands** — one tool per domain, with an `action` parameter to select the operation. For example: `sentinel` with action `create_issue`.
+
+### Core (always available)
+
+| Facade | Domain | Key Actions |
+|--------|--------|-------------|
+| **sentinel** | Work tracking | `create_issue`, `close_issue`, `log_epic`, `list_epics`, `scan` |
+| **architect** | Decisions | `create_adr`, `create_policy`, `list_policies`, `compile_oversight` |
+| **dojo** | Incubation | `add_wish`, `create_proposal`, `scaffold_experiment`, `run_experiment` |
+| **designer** | Design | `record_design_decision`, `crit`, `sync_tokens`, `review_figma` |
+| **oracle** | Recommendations | `next_actions`, `roadmap` |
+| **roadmap** | Strategy | `get`, `list`, `get_health`, `link_epic`, `init` |
+| **git** | Git forensics | `history`, `changes`, `link_issue` |
+| **workflow** | Composites | `status`, `preflight`, `ship`, `investigate` |
+| **vector** | Agent runs | `track`, `drift`, `score` |
+| **context** | AI memory | `pin`, `unpin`, `list`, `refresh`, `event_append`, `event_search` |
+| **auditor** | Code quality | `health`, `refactor_score` |
+| **forecast** | Estimation | `estimate`, `decompose`, `capacity` |
+| **velocity** | Metrics | `trends`, `contributors` |
+| **coordinator** | Multi-agent | `lock`, `unlock`, `heartbeat`, `log`, `message` |
+| **swarm** | Agent sessions | `start_session`, `join_session`, `emit_signal`, `claim_signal` |
+| **friction** | Pain points | `log`, `list`, `resolve`, `bump` |
+| **registry** | Projects | `add`, `remove`, `list`, `alias`, `init`, `status` |
+| **feedback** | Tool feedback | `submit`, `list` |
+| **learnings** | Knowledge | `append`, `list` |
+| **provenance** | Audit trail | `list` |
+| **bench** | Benchmarks | `run`, `compare` |
+| **guardian** | Security | `scan_deps`, `scan_secrets`, `scan_http`, `scan_config`, `report` |
+
+### Pro (requires `DECIBEL_PRO=1`)
+
+| Facade | Domain | Key Actions |
+|--------|--------|-------------|
+| **voice** | Voice inbox | `sync`, `list`, `process` |
+| **studio** | Creative assets | `generate_image`, `generate_video` |
+| **corpus** | Code patterns | `search`, `index` |
+| **agentic** | Config compilation | `compile_pack`, `render`, `lint`, `golden_eval` |
+
+> All tiers are auto-enabled in development (`NODE_ENV !== 'production'`).
+
+---
+
+## Daemon Mode
+
+Run as a persistent background service with HTTP transport:
+
+```bash
+# Start daemon (default port 4888)
+npx @decibelsystems/tools --daemon
+
+# Dual mode: stdio + HTTP from one process
+npx @decibelsystems/tools --daemon --stdio
+
+# macOS launchd management
+npx @decibelsystems/tools --daemon install
+npx @decibelsystems/tools --daemon uninstall
+npx @decibelsystems/tools --daemon status
+```
+
+The daemon includes log rotation, crash loop protection (5 crashes in 60s), graceful shutdown with request draining, and a `/health` endpoint.
+
+### Configuration
+
+Create `~/.decibel/config.yaml` to configure the daemon:
+
+```yaml
+daemon:
+  port: 4888
+  host: localhost
+  auth_token: your-secret-token
+  log_max_size_mb: 10
+  log_max_files: 3
+  rate_limit_rpm: 60
+license:
+  key: your-license-key
+```
+
+CLI flags override config file values. Send `SIGHUP` to reload config without restarting.
 
 ---
 
@@ -252,88 +181,41 @@ Data is stored in project-local `.decibel/` folders:
     │   ├── proposals/   # DOJO-PROP-{nnnn}.yml
     │   ├── experiments/ # DOJO-EXP-{nnnn}/
     │   └── wishes/      # WISH-{nnnn}.yml
-    ├── designer/        # Design decisions
+    ├── designer/        # Design decisions, principles, crits
     ├── friction/        # Pain point logs
     ├── learnings/       # Knowledge documents
     ├── context/         # Pinned facts, events
+    ├── guardian/        # Security scan results, allowlists
     └── voice/inbox/     # Voice messages
 ```
 
-## Configuration
+## Environment Variables
+
+### Core
 
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `DECIBEL_ENV` | `dev` | Environment (dev, staging, prod) |
-| `DECIBEL_ORG` | `mediareason` | Organization name |
+| `DECIBEL_ORG` | `default` | Organization name |
 | `DECIBEL_MCP_ROOT` | `~/.decibel` | Global data storage root |
+| `DECIBEL_PROJECT_ROOT` | — | Current project root path |
+| `DECIBEL_REGISTRY_PATH` | — | Custom registry file location |
 
-Optional for cloud features:
-- `SUPABASE_URL` - Supabase project URL
-- `SUPABASE_SERVICE_KEY` - Supabase service role key
-- `OPENAI_API_KEY` - For image generation
-- `FIGMA_ACCESS_TOKEN` - For Figma integration (designer_sync_tokens, designer_review_figma)
+### Optional Integrations
 
-## Usage Examples
-
-### Example 1: Initialize a Project and Create an Epic
-
-```
-User: "Initialize decibel for this project and create an epic for user authentication"
-
-AI uses: project_init → sentinel_log_epic
-
-Result: Creates .decibel/ folder structure and EPIC-0001.yml for "User Authentication"
-```
-
-### Example 2: Track Work with Issues Linked to Epics
-
-```
-User: "Create issues for the auth epic: login form, password reset, and session management"
-
-AI uses: sentinel_resolve_epic → sentinel_createIssue (×3)
-
-Result: Creates ISS-0001, ISS-0002, ISS-0003 all linked to EPIC-0001
-```
-
-### Example 3: Record Architecture Decisions
-
-```
-User: "We decided to use JWT tokens instead of sessions. Document this ADR."
-
-AI uses: architect_createAdr
-
-Result: Creates ADR-0001.yml with context, decision, and consequences
-```
-
-### Example 4: AI Feature Incubation (Dojo)
-
-```
-User: "I wish we had a tool that detects rate limit patterns in logs"
-
-AI uses: dojo_add_wish → dojo_create_proposal → dojo_scaffold_experiment
-
-Result: WISH-0001.yml → DOJO-PROP-0001.yml → DOJO-EXP-0001/ with entrypoint ready to implement
-```
-
-### Example 5: Get Recommended Next Actions
-
-```
-User: "What should I work on next?"
-
-AI uses: oracle_next_actions
-
-Result: Prioritized list based on stale issues, epic health, pending experiments
-```
+| Variable | Used By |
+|----------|---------|
+| `SUPABASE_URL` | Voice inbox, swarm sessions |
+| `SUPABASE_SERVICE_KEY` | Supabase service role key |
+| `FIGMA_ACCESS_TOKEN` | Designer: `sync_tokens`, `review_figma` |
+| `OPENAI_API_KEY` | Studio: image generation |
+| `TOGETHER_API_KEY` | Studio: alternative image generation |
 
 ## Privacy Policy
 
 **Local Storage Only**: All project data is stored locally in `.decibel/` folders within your project directories. No data is sent to external servers by default.
 
-**Optional Cloud Integrations**: Some tools optionally connect to external services when you explicitly configure API keys:
-- **Figma API** (`designer_sync_tokens`, `designer_review_figma`) - requires `FIGMA_ACCESS_TOKEN`
-- **Supabase** (voice inbox sync) - requires `SUPABASE_URL` and `SUPABASE_SERVICE_KEY`
-
-These optional integrations are clearly marked with `openWorldHint: true` in their tool annotations.
+**Optional Cloud Integrations**: Some tools optionally connect to external services when you explicitly configure API keys (Figma, Supabase, OpenAI). These are clearly marked with `openWorldHint: true` in their tool annotations.
 
 **No Telemetry**: This MCP server does not collect telemetry, usage analytics, or any form of tracking data.
 

package/dist/client/facade-client.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'events';
-import type { FacadeClientConfig, BatchCall, BatchResult } from './types.js';
+import type { FacadeClientConfig, CallContext, BatchCall, BatchResult } from './types.js';
 export declare class FacadeClient {
     private transport;
     private config;
@@ -18,18 +18,24 @@ export declare class FacadeClient {
     /**
      * Call a facade action.
      *
+     * @param context  Per-call context that overrides config-level defaults.
+     *
      * @example
      *   const epics = await client.call('sentinel', 'list_epics');
      *   const issue = await client.call('sentinel', 'create_issue', { title: 'Fix login' });
+     *   const scoped = await client.call('sentinel', 'list_epics', {}, { scope: 'portfolio' });
      */
-    call<T = unknown>(facade: string, action: string, params?: Record<string, unknown>): Promise<T>;
+    call<T = unknown>(facade: string, action: string, params?: Record<string, unknown>, context?: CallContext): Promise<T>;
     /**
      * Batch multiple facade calls (max 20, parallel execution).
      *
+     * @param context  Batch-level context applied to all calls.
+     *   Individual BatchCall.context merges with (and overrides) this.
+     *
      * For HTTP transport, uses the daemon's /batch endpoint directly.
      * For stdio transport, runs calls in parallel via Promise.all.
      */
-    batch(calls: BatchCall[]): Promise<BatchResult[]>;
+    batch(calls: BatchCall[], context?: CallContext): Promise<BatchResult[]>;
     /** Whether the client is currently connected */
     get isConnected(): boolean;
     /** Current transport mode for diagnostics */

package/dist/client/facade-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facade-client.d.ts","sourceRoot":"","sources":["../../src/client/facade-client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU7E,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,GAAG,CAAwB;IAEnC,QAAQ,CAAC,MAAM,wBAAsB;gBAEzB,MAAM,EAAE,kBAAkB;IAYtC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAyDb;;;;;OAKG;IACG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsEvD,gDAAgD;IAChD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6CAA6C;IAC7C,IAAI,IAAI,IAAI,MAAM,CAOjB;YAMa,SAAS;IAmCvB,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;CASzB"}
+{"version":3,"file":"facade-client.d.ts","sourceRoot":"","sources":["../../src/client/facade-client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU1F,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,GAAG,CAAwB;IAEnC,QAAQ,CAAC,MAAM,wBAAsB;gBAEzB,MAAM,EAAE,kBAAkB;IAYtC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;;;;OASG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC;IAkEb;;;;;;;;OAQG;IACG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsF9E,gDAAgD;IAChD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6CAA6C;IAC7C,IAAI,IAAI,IAAI,MAAM,CAOjB;YAMa,SAAS;IAmCvB,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/client/facade-client.js

@@ -15,6 +15,7 @@
 //   await client.disconnect();
 // ============================================================================
 import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
 import { StdioTransport, HttpTransport, BridgeTransport, } from './transports.js';
 const MAX_BATCH_SIZE = 20;
 export class FacadeClient {
@@ -60,11 +61,14 @@ export class FacadeClient {
     /**
      * Call a facade action.
      *
+     * @param context  Per-call context that overrides config-level defaults.
+     *
      * @example
      *   const epics = await client.call('sentinel', 'list_epics');
      *   const issue = await client.call('sentinel', 'create_issue', { title: 'Fix login' });
+     *   const scoped = await client.call('sentinel', 'list_epics', {}, { scope: 'portfolio' });
      */
-    async call(facade, action, params) {
+    async call(facade, action, params, context) {
         // Enforce allowlist
         if (this.config.allowedFacades && !this.config.allowedFacades.includes(facade)) {
             throw new Error(`Facade "${facade}" not in allowed scope. Allowed: [${this.config.allowedFacades.join(', ')}]`);
@@ -73,29 +77,36 @@ export class FacadeClient {
         await this.connect();
         // Build args: facade dispatch expects { action, ...params }
         const args = { action, ...params };
-        // Auto-inject project_id from config if not already provided
-        if (this.config.projectId && !args.project_id) {
-            args.project_id = this.config.projectId;
+        // Resolve effective scope: per-call > config-level
+        const effectiveScope = context?.scope ?? this.config.projectId;
+        // Auto-inject project_id from effective scope if not already provided
+        if (effectiveScope && !args.project_id) {
+            args.project_id = effectiveScope;
         }
+        // Generate request correlation ID
+        const requestId = randomUUID();
         // Thread DispatchContext via _meta (MCP convention)
-        if (this.config.agentId || this.config.projectId) {
-            args._meta = {
-                agentId: this.config.agentId,
-                scope: this.config.projectId,
-            };
-        }
-        this.log(`call ${facade}.${action}`);
+        // Per-call context merges with and overrides config-level defaults
+        args._meta = {
+            agentId: context?.agentId ?? this.config.agentId,
+            scope: effectiveScope,
+            runId: context?.runId,
+            engagementMode: context?.engagementMode,
+            userKey: context?.userKey,
+            requestId,
+        };
+        this.log(`call ${facade}.${action} (req=${requestId.slice(0, 8)})`);
         const startTime = Date.now();
         try {
             const result = await this.transport.call(facade, args);
             const duration = Date.now() - startTime;
-            this.events.emit('result', { facade, action, duration_ms: duration, success: true });
+            this.events.emit('result', { facade, action, duration_ms: duration, success: true, requestId });
             return result;
         }
         catch (err) {
             const duration = Date.now() - startTime;
             const message = err instanceof Error ? err.message : String(err);
-            this.events.emit('error', { facade, action, duration_ms: duration, error: message });
+            this.events.emit('error', { facade, action, duration_ms: duration, error: message, requestId });
             // Try to parse structured error from the server
             if (err.isCallError && err.raw) {
                 try {
@@ -114,10 +125,13 @@ export class FacadeClient {
     /**
      * Batch multiple facade calls (max 20, parallel execution).
      *
+     * @param context  Batch-level context applied to all calls.
+     *   Individual BatchCall.context merges with (and overrides) this.
+     *
      * For HTTP transport, uses the daemon's /batch endpoint directly.
      * For stdio transport, runs calls in parallel via Promise.all.
      */
-    async batch(calls) {
+    async batch(calls, context) {
         if (calls.length === 0)
             return [];
         if (calls.length > MAX_BATCH_SIZE) {
@@ -132,33 +146,48 @@ export class FacadeClient {
             }
         }
         await this.connect();
+        // Resolve effective batch-level context (per-batch > config defaults)
+        const effectiveScope = context?.scope ?? this.config.projectId;
+        const effectiveAgentId = context?.agentId ?? this.config.agentId;
         // Try native /batch endpoint for HTTP transport
         const httpTransport = this.getHttpTransport();
         if (httpTransport) {
             this.log(`batch (HTTP) — ${calls.length} calls`);
-            const context = {
-                agentId: this.config.agentId,
-                scope: this.config.projectId,
+            const httpContext = {
+                agentId: effectiveAgentId,
+                scope: effectiveScope,
+                runId: context?.runId,
+                engagementMode: context?.engagementMode,
+                userKey: context?.userKey,
+                requestId: randomUUID(),
             };
             // Inject project_id into each call's params
-            const enrichedCalls = calls.map(c => ({
-                ...c,
-                params: {
-                    ...c.params,
-                    ...(this.config.projectId && !c.params?.project_id
-                        ? { project_id: this.config.projectId }
-                        : {}),
-                },
-            }));
-            const result = await httpTransport.batch(enrichedCalls, context);
+            const enrichedCalls = calls.map(c => {
+                const callScope = c.context?.scope ?? effectiveScope;
+                return {
+                    facade: c.facade,
+                    action: c.action,
+                    params: {
+                        ...c.params,
+                        ...(callScope && !c.params?.project_id
+                            ? { project_id: callScope }
+                            : {}),
+                    },
+                };
+            });
+            const result = await httpTransport.batch(enrichedCalls, httpContext);
             return result;
         }
-        // Stdio fallback: parallel Promise.all
+        // Stdio fallback: parallel Promise.all (each call gets its own requestId via call())
         this.log(`batch (stdio) — ${calls.length} calls`);
         const results = await Promise.all(calls.map(async (c) => {
             const start = Date.now();
+            // Per-call context merges: call-level > batch-level > config
+            const callCtx = c.context
+                ? { ...context, ...c.context }
+                : context;
             try {
-                const data = await this.call(c.facade, c.action, c.params);
+                const data = await this.call(c.facade, c.action, c.params, callCtx);
                 return {
                     facade: c.facade,
                     action: c.action,

package/dist/client/facade-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"facade-client.js","sourceRoot":"","sources":["../../src/client/facade-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"facade-client.js","sourceRoot":"","sources":["../../src/client/facade-client.ts"],"names":[],"mappings":"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"}