@bike4mind/cli 0.1.3 → 0.1.5-feat-automate-cli-publishing.16903

package/README.md

@@ -9,6 +9,7 @@ Interactive command-line interface for Bike4Mind with ReAct agents.
 - 💾 Session persistence
 - 🛠️ B4M tools + MCP integration
 - 🎨 Rich terminal UI with Ink
+- 🐛 Debug logging with `--verbose` flag
 
 ## Installation
 
@@ -44,6 +45,29 @@ b4m
 
 The CLI will prompt you to authenticate with your Bike4Mind account on first run.
 
+### CLI Flags
+
+```bash
+b4m [options]
+```
+
+**Available flags:**
+- `--verbose`, `-v` - Show debug logs in console (useful for troubleshooting)
+- `--help`, `-h` - Show help information
+- `--version`, `-V` - Show CLI version
+
+**Examples:**
+```bash
+# Run with debug logs visible
+b4m --verbose
+
+# Check version
+b4m --version
+
+# Show help
+b4m --help
+```
+
 ## Commands
 
 While in interactive mode:
@@ -181,6 +205,38 @@ Each session includes:
 - Agent reasoning steps
 - Metadata
 
+## Debug Logs
+
+Debug logs are automatically written to `~/.bike4mind/debug/[session-id].txt` for every session, regardless of the `--verbose` flag.
+
+**What's logged:**
+- Session configuration (API endpoint, environment, model)
+- HTTP requests and responses (with size and preview)
+- SSE streaming events from LLM
+- Tool execution details with parameters
+- Error details including CloudFront/WAF errors
+- Authentication flow events
+
+**Accessing logs:**
+```bash
+# List all debug logs
+ls -lh ~/.bike4mind/debug/
+
+# View latest session log
+cat ~/.bike4mind/debug/[session-id].txt
+
+# View logs in real-time (during session)
+tail -f ~/.bike4mind/debug/[session-id].txt
+```
+
+**Log retention:**
+- Debug logs older than 30 days are automatically cleaned up on CLI startup
+- Each log file is named by session ID for easy correlation
+
+**Verbose mode:**
+- Without `--verbose`: Debug logs only written to file (clean console output)
+- With `--verbose`: Debug logs shown in console AND written to file
+
 ## Development
 
 ```bash
@@ -221,7 +277,7 @@ apps/cli/
 - `@bike4mind/mcp` - MCP integration
 - `@bike4mind/utils` - LLM backends
 - `ink` - React for CLIs
-- `commander` - CLI argument parsing
+- `yargs` - CLI argument parsing
 - `lowdb` - Local storage
 
 ## Development Status
@@ -235,6 +291,7 @@ Current implementation includes:
 ✅ Interactive UI with Ink
 ✅ B4M tools integration
 ✅ MCP tools support
+✅ Debug logging with --verbose flag
 
 Coming soon:
 

package/bin/bike4mind-cli.mjs

@@ -21,11 +21,32 @@ import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { existsSync } from 'fs';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const require = createRequire(import.meta.url);
 
+// Parse CLI arguments
+const argv = yargs(hideBin(process.argv))
+  .option('verbose', {
+    alias: 'v',
+    type: 'boolean',
+    description: 'Show debug logs in console',
+    default: false,
+  })
+  .help()
+  .alias('help', 'h')
+  .version()
+  .alias('version', 'V')
+  .parse();
+
+// Set environment variable for verbose mode
+if (argv.verbose) {
+  process.env.B4M_VERBOSE = '1';
+}
+
 // Auto-detect environment: prefer production mode when dist exists
 const distPath = join(__dirname, '../dist/index.js');
 const srcPath = join(__dirname, '../src/index.tsx');

package/dist/{artifactExtractor-QN34RFDM.js → artifactExtractor-Y5UYA5XK.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-MKO2KCCS.js";
+} from "./chunk-PG4BD2XZ.js";
 import "./chunk-PDX44BCA.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/artifactExtractor.js