@vibeprospecting/vpai 0.1.1 → 0.1.4

package/README.md

@@ -35,7 +35,7 @@ npm install -g @vibeprospecting/vpai
 
 ```bash
 git clone <repo>
-cd mcp-cli
+cd vpai-cli
 npm install
 npm run build
 ```
@@ -136,12 +136,27 @@ OAuth runs automatically on first use (browser opens). Tokens are cached by mcpo
 
 MCP server URL, OAuth settings, and timeout are embedded in the build (`src/embedded-config.ts`). No external config files.
 
+### Error handling
+
+All failure paths set `process.exitCode = 1` or call `process.exit(1)` so the process exits with a non-zero code:
+
+| Failure | Behavior |
+|---------|----------|
+| Runtime init (`ensureRuntime`) | Logs "Failed to initialize MCP runtime", rethrows, CLI catches and exits 1 |
+| List tools (`listTools`) | Logs "Failed to list tools from MCP server", rethrows, CLI catches and exits 1 |
+| Schema resolution (`resolveToolSchema`) | Logs "Schema resolution failed", sets exitCode 1 |
+| Tool execution (timeout, API error) | Logs "Tool execution timed out" or "Tool execution failed", sets exitCode 1 |
+| Invalid `--args` JSON | Logs "Invalid JSON in --args", sets exitCode 1 |
+| Non-object `--args` | Logs "--args must be a JSON object", sets exitCode 1 |
+
+Errors are logged as JSON to stderr. No unhandled promise rejections or silent failures.
+
 ---
 
 ## Project Structure
 
 ```
-mcp-cli/
+vpai-cli/
 ├── src/
 │   ├── cli.ts             # Entry point
 │   ├── proxy.ts           # Tool registration