procsi 0.2.7 → 0.3.1

package/README.md

@@ -4,35 +4,31 @@
 [![CI](https://github.com/mtford90/procsi/actions/workflows/ci.yml/badge.svg)](https://github.com/mtford90/procsi/actions/workflows/ci.yml)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 
-HTTP interception for the terminal. Each project gets its own proxy, its own traffic database, its own mocks — all in a `.procsi/` directory that lives alongside your code.
+Procsi is a terminal-based HTTP proxy with a powerful MCP server. Quickly intercept, inspect & rewrite HTTP traffic.
 
 ![procsi demo](demo.gif)
 
-No browser extensions, no global system proxy, no separate apps. A MITM proxy captures your traffic, a lazygit-style TUI lets you browse it, TypeScript files let you mock it, and AI agents can query and manipulate all of it via MCP.
+## Feature Highlights
+
+- **Project isolation** — each project gets its own `.procsi/` directory with a separate daemon, database, CA cert and interceptors. 
+- **MCP server** — AI agents get full access to your captured traffic and can write interceptor files for you. Search, filter, inspect, mock — all via tool calls.
+- **Interceptors** — mock, modify or observe traffic with `.ts` files. Match on anything, query past traffic from within handlers, compose complex scenarios.
 
 ## Quick Start
 
 ```bash
 npm install -g procsi
 
-# In your project directory
+# Configure environment e.g. HTTP_PROXY
 eval "$(procsi on)"
+
+# Send a request
 curl https://api.example.com/users
+
+# Open UI
 procsi tui
 ```
 
-Requires Node.js 20+.
-
-## Features
-
-- **Project-scoped** — each project gets its own `.procsi/` directory with a separate daemon, database, CA cert and interceptors. No cross-project bleed.
-- **TypeScript interceptors** — mock, modify or observe traffic with `.ts` files. Match on anything, query past traffic from within handlers, compose complex scenarios.
-- **MCP server** — AI agents get full access to your captured traffic and can write interceptor files for you. Search, filter, inspect, mock — all via tool calls.
-- **Terminal TUI** — vim-style keybindings, mouse support, JSON explorer, filtering. Stays in your terminal where you're already working.
-- **HTTPS** — automatic CA certificate generation and trust
-- **Export** — copy as curl, export as HAR, save bodies to disk
-- **Zero config** — works with curl, wget, Node.js, Python, Go, Rust and anything else that respects `HTTP_PROXY`
-
 ## Project Isolation
 
 procsi doesn't use a global system proxy. Each project gets its own `.procsi/` directory in the project root (detected by `.git` or an existing `.procsi/`):
@@ -50,7 +46,120 @@ your-project/
 └── src/...
 ```
 
-Separate daemon, separate database, separate certificates. You can run procsi in multiple projects at the same time without them interfering with each other.
+Separate daemon, database, certificates etc. You can run procsi in multiple projects at the same time without them interfering with each other.
+
+## Use cases
+
+- AI analysis
+- Chaos monkey
+- Mock out APIs that do not yet exist
+
+## MCP Integration
+
+procsi has a built-in [MCP](https://modelcontextprotocol.io/) server that gives AI agents full access to your captured traffic and interceptor system. Agents can search through requests, inspect headers and bodies, and write interceptor files directly into `.procsi/interceptors/`.
+
+This means you can ask things like:
+
+- "Find all failing requests to the payments API and write mocks that return valid responses"
+- "Make every 5th request to /api/users return a 429 so I can test rate limiting"
+- "What's the average response time for requests to the auth service in the last hour?"
+- "Write an interceptor that logs all requests with missing auth headers"
+- "Send me a notification whenever an api request fails"
+
+The agent reads your traffic, writes the TypeScript, and procsi hot-reloads it.
+
+### Setup
+
+Add procsi to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "procsi": {
+      "command": "procsi",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+The proxy must be running (`eval "$(procsi on)"`) — the MCP server connects to the same daemon as the TUI.
+
+### Agent Skill
+
+procsi also ships an agent skill that teaches AI assistants how to use the MCP tools properly. Gets you better results out of the box.
+
+**Claude Code:**
+
+```bash
+/plugin marketplace add mtford90/procsi
+/plugin install procsi
+```
+
+**npm-agentskills** (works with Cursor, Copilot, Codex, etc.):
+
+```bash
+npx agents export --target claude
+```
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `procsi_get_status` | Daemon status, proxy port, request count |
+| `procsi_list_requests` | Search and filter captured requests |
+| `procsi_get_request` | Full request details by ID (headers, bodies, timing) |
+| `procsi_search_bodies` | Full-text search through body content |
+| `procsi_query_json` | Extract values from JSON bodies via JSONPath |
+| `procsi_count_requests` | Count matching requests |
+| `procsi_clear_requests` | Delete all captured requests |
+| `procsi_list_sessions` | List active proxy sessions |
+| `procsi_list_interceptors` | List loaded interceptors with status and errors |
+| `procsi_reload_interceptors` | Reload interceptors from disk |
+
+### Filtering
+
+Most tools accept these filters:
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `method` | HTTP method(s), comma-separated | `"GET,POST"` |
+| `status_range` | Status code, Nxx pattern, or range | `"4xx"`, `"401"`, `"500-503"` |
+| `search` | Substring match on URL/path | `"api/users"` |
+| `host` | Exact or suffix match (prefix with `.`) | `"api.example.com"`, `".example.com"` |
+| `path` | Path prefix match | `"/api/v2"` |
+| `since` / `before` | Time window (ISO 8601) | `"2024-01-15T10:30:00Z"` |
+| `header_name` | Filter by header existence or value | `"content-type"` |
+| `header_value` | Exact header value (requires `header_name`) | `"application/json"` |
+| `header_target` | Which headers to search | `"request"`, `"response"`, `"both"` |
+| `intercepted_by` | Filter by interceptor name | `"mock-users"` |
+| `offset` | Pagination offset (0-based) | `0` |
+| `limit` | Max results (default 50, max 500) | `100` |
+
+`procsi_get_request` accepts comma-separated IDs for batch fetching (e.g. `"id1,id2,id3"`).
+
+`procsi_query_json` also takes:
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `target` | Which body to query: `"request"`, `"response"`, or `"both"` (default) | `"response"` |
+| `value` | Exact value match after JSONPath extraction | `"active"` |
+
+### Output Formats
+
+All query tools accept a `format` parameter:
+
+- `text` (default) — markdown summaries, readable by humans and AI
+- `json` — structured JSON for programmatic use
+
+### Examples
+
+```
+procsi_list_requests({ status_range: "5xx", path: "/api" })
+procsi_search_bodies({ query: "error_code", method: "POST" })
+procsi_query_json({ json_path: "$.user.id", target: "response" })
+procsi_list_requests({ header_name: "authorization", header_target: "request" })
+```
 
 ## Interceptors
 
@@ -176,112 +285,6 @@ export default {
 - `ctx.log()` writes to `.procsi/procsi.log` since `console.log` goes nowhere in the daemon
 - Use `satisfies Interceptor` for full intellisense
 
-## MCP Integration
-
-procsi has a built-in [MCP](https://modelcontextprotocol.io/) server that gives AI agents full access to your captured traffic and interceptor system. Agents can search through requests, inspect headers and bodies, and write interceptor files directly into `.procsi/interceptors/`.
-
-This means you can ask things like:
-
-- "Find all failing requests to the payments API and write mocks that return valid responses"
-- "Make every 5th request to /api/users return a 429 so I can test rate limiting"
-- "What's the average response time for requests to the auth service in the last hour?"
-- "Write an interceptor that logs all requests with missing auth headers"
-
-The agent reads your traffic, writes the TypeScript, and procsi hot-reloads it.
-
-### Setup
-
-Add procsi to your MCP client config:
-
-```json
-{
-  "mcpServers": {
-    "procsi": {
-      "command": "procsi",
-      "args": ["mcp"]
-    }
-  }
-}
-```
-
-The proxy must be running (`eval "$(procsi on)"`) — the MCP server connects to the same daemon as the TUI.
-
-### Agent Skill
-
-procsi also ships an agent skill that teaches AI assistants how to use the MCP tools properly. Gets you better results out of the box.
-
-**Claude Code:**
-
-```bash
-/plugin marketplace add mtford90/procsi
-/plugin install procsi
-```
-
-**npm-agentskills** (works with Cursor, Copilot, Codex, etc.):
-
-```bash
-npx agents export --target claude
-```
-
-### Available Tools
-
-| Tool | Description |
-|------|-------------|
-| `procsi_get_status` | Daemon status, proxy port, request count |
-| `procsi_list_requests` | Search and filter captured requests |
-| `procsi_get_request` | Full request details by ID (headers, bodies, timing) |
-| `procsi_search_bodies` | Full-text search through body content |
-| `procsi_query_json` | Extract values from JSON bodies via JSONPath |
-| `procsi_count_requests` | Count matching requests |
-| `procsi_clear_requests` | Delete all captured requests |
-| `procsi_list_sessions` | List active proxy sessions |
-| `procsi_list_interceptors` | List loaded interceptors with status and errors |
-| `procsi_reload_interceptors` | Reload interceptors from disk |
-
-### Filtering
-
-Most tools accept these filters:
-
-| Parameter | Description | Example |
-|-----------|-------------|---------|
-| `method` | HTTP method(s), comma-separated | `"GET,POST"` |
-| `status_range` | Status code, Nxx pattern, or range | `"4xx"`, `"401"`, `"500-503"` |
-| `search` | Substring match on URL/path | `"api/users"` |
-| `host` | Exact or suffix match (prefix with `.`) | `"api.example.com"`, `".example.com"` |
-| `path` | Path prefix match | `"/api/v2"` |
-| `since` / `before` | Time window (ISO 8601) | `"2024-01-15T10:30:00Z"` |
-| `header_name` | Filter by header existence or value | `"content-type"` |
-| `header_value` | Exact header value (requires `header_name`) | `"application/json"` |
-| `header_target` | Which headers to search | `"request"`, `"response"`, `"both"` |
-| `intercepted_by` | Filter by interceptor name | `"mock-users"` |
-| `offset` | Pagination offset (0-based) | `0` |
-| `limit` | Max results (default 50, max 500) | `100` |
-
-`procsi_get_request` accepts comma-separated IDs for batch fetching (e.g. `"id1,id2,id3"`).
-
-`procsi_query_json` also takes:
-
-| Parameter | Description | Example |
-|-----------|-------------|---------|
-| `target` | Which body to query: `"request"`, `"response"`, or `"both"` (default) | `"response"` |
-| `value` | Exact value match after JSONPath extraction | `"active"` |
-
-### Output Formats
-
-All query tools accept a `format` parameter:
-
-- `text` (default) — markdown summaries, readable by humans and AI
-- `json` — structured JSON for programmatic use
-
-### Examples
-
-```
-procsi_list_requests({ status_range: "5xx", path: "/api" })
-procsi_search_bodies({ query: "error_code", method: "POST" })
-procsi_query_json({ json_path: "$.user.id", target: "response" })
-procsi_list_requests({ header_name: "authorization", header_target: "request" })
-```
-
 ## How It Works
 
 ```
@@ -502,6 +505,94 @@ Stop the daemon.
 
 Restart the daemon (or start it if not running).
 
+### `procsi requests`
+
+List and filter captured requests. Output is a colour-coded table with short IDs — pipe to other tools or use `--json` for structured output.
+
+```bash
+procsi requests                              # list recent (default limit 50)
+procsi requests --method GET,POST            # filter by method
+procsi requests --status 4xx                 # filter by status range
+procsi requests --host api.example.com       # filter by host
+procsi requests --path /api/v2               # filter by path prefix
+procsi requests --search "keyword"           # substring match on URL
+procsi requests --since 5m                   # last 5 minutes
+procsi requests --since yesterday            # since midnight yesterday
+procsi requests --since 10am --before 11am   # time window
+procsi requests --header "content-type:application/json"  # header filter
+procsi requests --intercepted-by mock-users  # interceptor filter
+procsi requests --limit 100 --offset 50      # pagination
+procsi requests --json                       # JSON output
+```
+
+| Flag | Description |
+|------|-------------|
+| `--method <methods>` | Filter by HTTP method (comma-separated) |
+| `--status <range>` | Status range: `2xx`, `4xx`, exact `401`, etc. |
+| `--host <host>` | Filter by hostname |
+| `--path <prefix>` | Filter by path prefix |
+| `--search <text>` | Substring match on URL |
+| `--since <time>` | Since time (5m, 2h, 10am, yesterday, monday, 2024-01-01) |
+| `--before <time>` | Before time (same formats as --since) |
+| `--header <spec>` | Header name or name:value |
+| `--header-target <target>` | `request`, `response`, or `both` (default) |
+| `--intercepted-by <name>` | Filter by interceptor name |
+| `--limit <n>` | Max results (default 50) |
+| `--offset <n>` | Skip results (default 0) |
+| `--json` | JSON output |
+
+#### `procsi requests search <query>`
+
+Full-text search through request and response bodies.
+
+#### `procsi requests query <jsonpath>`
+
+Query JSON bodies using JSONPath expressions (e.g. `$.data.id`). Supports `--value`, `--target` (request/response/both).
+
+#### `procsi requests count`
+
+Count requests matching the current filters.
+
+#### `procsi requests clear`
+
+Clear all captured requests. Prompts for confirmation unless `--yes` is passed.
+
+### `procsi request <id>`
+
+View a single request in detail. Accepts full UUIDs or abbreviated prefixes (first 7+ characters).
+
+```bash
+procsi request a1b2c3d              # full detail view
+procsi request a1b2c3d --json       # JSON output
+```
+
+#### `procsi request <id> body`
+
+Dump the response body to stdout (raw, pipeable). Use `--request` for the request body instead.
+
+```bash
+procsi request a1b2c3d body                # response body
+procsi request a1b2c3d body --request      # request body
+procsi request a1b2c3d body | jq .         # pipe to jq
+```
+
+#### `procsi request <id> export <format>`
+
+Export a request as `curl` or `har`.
+
+```bash
+procsi request a1b2c3d export curl
+procsi request a1b2c3d export har
+```
+
+### `procsi sessions`
+
+List active proxy sessions.
+
+| Flag | Description |
+|------|-------------|
+| `--json` | JSON output |
+
 ### `procsi clear`
 
 Clear all captured requests.
@@ -530,6 +621,41 @@ Scaffold an example interceptor in `.procsi/interceptors/`.
 
 Reload interceptors from disk without restarting the daemon.
 
+### `procsi interceptors logs`
+
+View the interceptor event log. Events include match results, mock responses, errors, timeouts, and `ctx.log()` output.
+
+```bash
+procsi interceptors logs                         # recent events
+procsi interceptors logs --name mock-users       # filter by interceptor
+procsi interceptors logs --level error           # filter by level
+procsi interceptors logs --limit 100             # more results
+procsi interceptors logs --follow                # live tail (Ctrl+C to stop)
+procsi interceptors logs --follow --json         # live tail as NDJSON
+```
+
+| Flag | Description |
+|------|-------------|
+| `--name <interceptor>` | Filter by interceptor name |
+| `--level <level>` | Filter by level (info, warn, error) |
+| `--limit <n>` | Max events (default 50) |
+| `--follow` | Live tail — poll for new events |
+| `--json` | JSON output |
+
+#### `procsi interceptors logs clear`
+
+Clear the interceptor event log.
+
+### `procsi completions <shell>`
+
+Generate shell completion scripts. Supports `zsh`, `bash`, and `fish`.
+
+```bash
+eval "$(procsi completions zsh)"    # add to .zshrc
+eval "$(procsi completions bash)"   # add to .bashrc
+procsi completions fish | source    # add to fish config
+```
+
 ## Development
 
 ```bash
@@ -570,7 +696,7 @@ The TUI needs at least 60 columns by 10 rows.
 
 ### Requests not appearing
 
-Your HTTP client needs to respect proxy environment variables. Browsers typically don't — use curl, wget, or language-level HTTP clients instead.
+Your HTTP client needs to respect proxy environment variables. 
 
 ## Licence
 

package/dist/cli/commands/completions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `procsi completions <shell>` — generate shell completion scripts.
+ *
+ * Outputs a completion script that the user sources in their shell config.
+ * Generated by walking the Commander program tree.
+ */
+import { Command } from "commander";
+export declare const completionsCommand: Command;
+//# sourceMappingURL=completions.d.ts.map

package/dist/cli/commands/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/completions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8KpC,eAAO,MAAM,kBAAkB,SAuB3B,CAAC"}

package/dist/cli/commands/completions.js

@@ -0,0 +1,170 @@
+/**
+ * `procsi completions <shell>` — generate shell completion scripts.
+ *
+ * Outputs a completion script that the user sources in their shell config.
+ * Generated by walking the Commander program tree.
+ */
+import { Command } from "commander";
+const SUPPORTED_SHELLS = ["zsh", "bash", "fish"];
+/**
+ * Escape a string for use inside a single-quoted shell string.
+ * Replaces ' with '\'' (end quote, escaped quote, start quote).
+ */
+function escapeForShell(str) {
+    return str.replace(/'/g, "'\\''");
+}
+function collectCommands(cmd) {
+    return cmd.commands.map((sub) => ({
+        name: sub.name(),
+        description: sub.description(),
+        options: sub.options.map((opt) => ({
+            flags: opt.long ?? opt.short ?? "",
+            description: opt.description,
+        })),
+        subcommands: collectCommands(sub),
+    }));
+}
+/**
+ * Generate a zsh completion script.
+ */
+function generateZshCompletions(program) {
+    const commands = collectCommands(program);
+    const globalOptions = program.options.map((opt) => `'${escapeForShell(opt.long ?? opt.short ?? "")}[${escapeForShell(opt.description)}]'`);
+    const subcmdCases = commands
+        .map((cmd) => {
+        const opts = cmd.options
+            .map((o) => `'${escapeForShell(o.flags)}[${escapeForShell(o.description)}]'`)
+            .join(" \\\n          ");
+        const subs = cmd.subcommands
+            .map((s) => `'${escapeForShell(s.name)}:${escapeForShell(s.description)}'`)
+            .join(" ");
+        const subsSection = subs
+            ? `\n        local -a ${cmd.name}_subcommands\n        ${cmd.name}_subcommands=(${subs})\n        _describe -t commands '${escapeForShell(cmd.name)} subcommand' ${cmd.name}_subcommands`
+            : "";
+        return `      ${cmd.name})\n        _arguments ${opts}${subsSection}\n        ;;`;
+    })
+        .join("\n");
+    const cmdList = commands
+        .map((c) => `'${escapeForShell(c.name)}:${escapeForShell(c.description)}'`)
+        .join(" \\\n    ");
+    return `#compdef procsi
+
+# Auto-generated by procsi completions zsh
+# Add to your .zshrc: eval "$(procsi completions zsh)"
+
+_procsi() {
+  local -a commands
+  commands=(
+    ${cmdList}
+  )
+
+  _arguments -C \\
+    ${globalOptions.join(" \\\n    ")} \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case "$state" in
+    command)
+      _describe -t commands 'procsi command' commands
+      ;;
+    args)
+      case "$words[1]" in
+${subcmdCases}
+      esac
+      ;;
+  esac
+}
+
+compdef _procsi procsi
+`;
+}
+/**
+ * Generate a bash completion script.
+ */
+function generateBashCompletions(program) {
+    const commands = collectCommands(program);
+    const cmdNames = commands.map((c) => c.name).join(" ");
+    const subcmdCases = commands
+        .map((cmd) => {
+        const opts = cmd.options.map((o) => escapeForShell(o.flags)).join(" ");
+        const subs = cmd.subcommands.map((s) => escapeForShell(s.name)).join(" ");
+        return `    ${cmd.name})\n      COMPREPLY=($(compgen -W "${opts} ${subs}" -- "$cur"))\n      ;;`;
+    })
+        .join("\n");
+    return `# Auto-generated by procsi completions bash
+# Add to your .bashrc: eval "$(procsi completions bash)"
+
+_procsi() {
+  local cur prev words cword
+  _init_completion || return
+
+  local commands="${cmdNames}"
+
+  if [[ $cword -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+    return
+  fi
+
+  case "\${words[1]}" in
+${subcmdCases}
+  esac
+}
+
+complete -F _procsi procsi
+`;
+}
+/**
+ * Generate a fish completion script.
+ */
+function generateFishCompletions(program) {
+    const commands = collectCommands(program);
+    const lines = [
+        "# Auto-generated by procsi completions fish",
+        "# Add to your config: procsi completions fish | source",
+        "",
+        "# Disable file completions by default",
+        "complete -c procsi -f",
+        "",
+    ];
+    // Top-level commands
+    for (const cmd of commands) {
+        lines.push(`complete -c procsi -n '__fish_use_subcommand' -a '${escapeForShell(cmd.name)}' -d '${escapeForShell(cmd.description)}'`);
+    }
+    lines.push("");
+    // Subcommand options
+    for (const cmd of commands) {
+        for (const opt of cmd.options) {
+            const flag = opt.flags.replace(/^--/, "");
+            lines.push(`complete -c procsi -n '__fish_seen_subcommand_from ${cmd.name}' -l '${escapeForShell(flag)}' -d '${escapeForShell(opt.description)}'`);
+        }
+        for (const sub of cmd.subcommands) {
+            lines.push(`complete -c procsi -n '__fish_seen_subcommand_from ${cmd.name}' -a '${escapeForShell(sub.name)}' -d '${escapeForShell(sub.description)}'`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+export const completionsCommand = new Command("completions")
+    .description("Generate shell completion scripts")
+    .argument("<shell>", `shell type (${SUPPORTED_SHELLS.join(", ")})`)
+    .action((shell, _opts, command) => {
+    if (!SUPPORTED_SHELLS.includes(shell)) {
+        console.error(`Unsupported shell: "${shell}"`);
+        console.error(`Supported shells: ${SUPPORTED_SHELLS.join(", ")}`);
+        process.exit(1);
+    }
+    // Walk up to the root program
+    let root = command;
+    while (root.parent) {
+        root = root.parent;
+    }
+    if (shell === "zsh") {
+        console.log(generateZshCompletions(root));
+    }
+    else if (shell === "bash") {
+        console.log(generateBashCompletions(root));
+    }
+    else if (shell === "fish") {
+        console.log(generateFishCompletions(root));
+    }
+});
+//# sourceMappingURL=completions.js.map

package/dist/cli/commands/completions.js.map

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

package/dist/cli/commands/helpers.d.ts

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import { ControlClient } from "../../shared/control-client.js";
 export interface GlobalOptions {
     verbose: number;
     dir?: string;
@@ -15,4 +16,12 @@ export declare function requireProjectRoot(override?: string): string;
  * Extract a human-readable message from an unknown error value.
  */
 export declare function getErrorMessage(err: unknown): string;
+/**
+ * Connect to the running daemon and return a ControlClient.
+ * Exits with error if the daemon is not running.
+ */
+export declare function connectToDaemon(command: Command): Promise<{
+    client: ControlClient;
+    projectRoot: string;
+}>;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/cli/commands/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAMhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAMhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/D,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAaD"}

package/dist/cli/commands/helpers.js

@@ -1,4 +1,6 @@
-import { findProjectRoot } from "../../shared/project.js";
+import { findProjectRoot, getProcsiPaths } from "../../shared/project.js";
+import { isDaemonRunning } from "../../shared/daemon.js";
+import { ControlClient } from "../../shared/control-client.js";
 /**
  * Validate and extract global CLI options from a Commander command.
  */
@@ -31,4 +33,20 @@ export function requireProjectRoot(override) {
 export function getErrorMessage(err) {
     return err instanceof Error ? err.message : "Unknown error";
 }
+/**
+ * Connect to the running daemon and return a ControlClient.
+ * Exits with error if the daemon is not running.
+ */
+export async function connectToDaemon(command) {
+    const globalOpts = getGlobalOptions(command);
+    const projectRoot = requireProjectRoot(globalOpts.dir);
+    const paths = getProcsiPaths(projectRoot);
+    const running = await isDaemonRunning(projectRoot);
+    if (!running) {
+        console.error("Daemon is not running. Start it with: procsi on");
+        process.exit(1);
+    }
+    const client = new ControlClient(paths.controlSocketFile);
+    return { client, projectRoot };
+}
 //# sourceMappingURL=helpers.js.map

package/dist/cli/commands/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/cli/commands/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAO1D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,EAA6B,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,GAAG,EAAE,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,wBAAwB,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/cli/commands/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAO/D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,EAA6B,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,GAAG,EAAE,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,wBAAwB,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB;IAIpD,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC"}