@bike4mind/cli 0.6.0 → 0.6.1

package/README.md

@@ -384,18 +384,111 @@ tail -f ~/.bike4mind/debug/[session-id].txt
 
 ## Development
 
+This section covers the contributor workflow for hacking on the CLI from a checkout of the monorepo. For end-user installation see [Installation](#installation) above.
+
+### How the bin resolves source vs. built code
+
+`apps/cli/bin/bike4mind-cli.mjs` auto-detects which mode to run in:
+
+- If `apps/cli/dist/index.mjs` exists → runs the bundled production build
+- Otherwise → falls back to `tsx` and imports `src/index.tsx` directly
+
+This means **you do not need to rebuild the CLI itself between source edits** — `tsx` reads `src/` live on every invocation. The rebuild burden is only on the workspace packages that the CLI imports (see below).
+
+### Quick start
+
+From the repo root:
+
 ```bash
-# Run in development mode
+# 1. Install all workspace dependencies
+pnpm install
+
+# 2. Build the @bike4mind/* core packages so the CLI can import their dist/ outputs
+pnpm turbo:core:build
+
+# 3. Make the `b4m` and `bike4mind` commands point at this checkout
 cd apps/cli
-pnpm dev
+pnpm link --global
+
+# 4. Verify
+which b4m
+b4m --version
+```
+
+After step 3, running `b4m` anywhere on your system executes this working tree. Re-run `pnpm link --global` if you move or rename the repo.
+
+### Editing CLI source (`apps/cli/src/`)
+
+Just run `b4m`. The bin's `tsx` fallback picks up your edits on the next invocation — no build step needed.
+
+If you want to test the bundled production path (the same code an end user would run after `npm install -g @bike4mind/cli`):
+
+```bash
+pnpm --filter @bike4mind/cli build
+b4m   # now uses dist/index.mjs
+```
+
+To drop back into source mode, delete `dist/`:
+
+```bash
+rm -rf apps/cli/dist
+```
 
-# Build for production
-pnpm build
+### Editing workspace dependencies (`b4m-core/*`)
 
-# Type check
+The CLI imports `@bike4mind/agents`, `@bike4mind/services`, `@bike4mind/utils`, `@bike4mind/mcp`, and `@bike4mind/common` via pnpm symlinks that resolve to each package's `dist/` (per its `exports` field). Source edits in those packages require a rebuild before `b4m` will see them.
+
+Rebuild only the package you touched:
+
+```bash
+pnpm --filter @bike4mind/agents build
+```
+
+Or rebuild the whole core graph (cached, near-instant if only one package changed):
+
+```bash
+pnpm turbo:core:build
+```
+
+The next `b4m` invocation picks up the change. The CLI itself does not need to be rebuilt.
+
+### Watch mode (optional)
+
+Each core package exposes `"dev": "tsdown --watch"`. In a separate terminal:
+
+```bash
+pnpm --filter @bike4mind/agents dev
+```
+
+`dist/` rebuilds on save, so the next `b4m` invocation sees changes without a manual `build`.
+
+Caveats:
+- This does **not** hot-reload an already-running interactive `b4m` session — you still exit and re-run.
+- Running multiple watchers in parallel (one per package you're touching) hasn't been load-tested in this repo. If watch seems to miss changes or feels unreliable, fall back to manual `pnpm --filter <pkg> build`.
+
+### Verification commands
+
+```bash
+# Inside apps/cli
 pnpm typecheck
+pnpm test
+pnpm test:watch
+
+# From repo root (cached, recommended)
+pnpm turbo:typecheck
+pnpm turbo:test
+
+# Run with debug logs
+b4m --verbose
 ```
 
+### Common pitfalls
+
+- **Don't `pnpm --filter @bike4mind/cli build` after every CLI source edit.** It's wasted work — the `tsx` fallback already runs your source live.
+- **Don't use `npm link`.** This repo is pnpm-only; mixing tools breaks symlink resolution.
+- **A stale `apps/cli/dist/` will mask your source changes.** If `b4m` is showing old behavior, check whether `dist/index.mjs` exists — the bin will prefer it over `src/`. Delete `dist/` to drop back to source mode.
+- **First-run native module errors** (`better-sqlite3`, `sharp`): see [Build Requirements](#build-requirements) above. The postinstall hook handles most cases automatically.
+
 ## Architecture
 
 ```

package/dist/commands/doctorCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as version, n as fetchLatestVersion, r as forceCheckForUpdate } from "../updateChecker-DZXWZfKF.mjs";
+import { a as version, n as compareSemver, r as fetchLatestVersion } from "../updateChecker-D-xoVcN3.mjs";
 import { execSync } from "child_process";
 import { constants, existsSync, promises } from "fs";
 import { homedir } from "os";
@@ -25,29 +25,29 @@ async function handleDoctorCommand() {
 		status: "fail",
 		message: `${nodeVersion} (>= 18 required, please upgrade)`
 	});
+	const currentVersion = version;
 	const latestVersion = await fetchLatestVersion();
-	if (latestVersion) results.push({
-		name: "NPM registry",
-		status: "pass",
-		message: `Accessible (latest: v${latestVersion})`
-	});
-	else results.push({
+	if (latestVersion) {
+		results.push({
+			name: "NPM registry",
+			status: "pass",
+			message: `Accessible (latest: v${latestVersion})`
+		});
+		if (compareSemver(latestVersion, currentVersion) > 0) results.push({
+			name: "Version",
+			status: "warn",
+			message: `v${currentVersion} installed, v${latestVersion} available. Run: b4m update`
+		});
+		else results.push({
+			name: "Version",
+			status: "pass",
+			message: `v${currentVersion} (latest)`
+		});
+	} else results.push({
 		name: "NPM registry",
 		status: "fail",
 		message: "Not accessible — check your internet connection"
 	});
-	const currentVersion = version;
-	const updateResult = await forceCheckForUpdate(currentVersion);
-	if (updateResult) if (updateResult.updateAvailable) results.push({
-		name: "Version",
-		status: "warn",
-		message: `v${currentVersion} installed, v${updateResult.latestVersion} available. Run: b4m update`
-	});
-	else results.push({
-		name: "Version",
-		status: "pass",
-		message: `v${currentVersion} (latest)`
-	});
 	try {
 		const npmPrefix = execSync("npm config get prefix", {
 			encoding: "utf-8",

package/dist/commands/headlessCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as getApiUrl, C as WebSocketLlmBackend, G as isReadOnlyTool, J as CheckpointStore, K as ReActAgent, M as PermissionManager, N as generateCliTools, S as FallbackLlmBackend, T as McpManager, U as buildCoreSystemPrompt, V as setWebSocketToolExecutor, X as SessionStore, _ as createSkillTool, b as WebSocketToolExecutor, c as createFindDefinitionTool, d as createCoordinateTaskTool, f as createBackgroundAgentTools, g as SubagentOrchestrator, h as AgentStore, k as loadContextFiles, l as createTodoStore, m as createAgentDelegateTool, p as BackgroundAgentManager, q as CustomCommandStore, s as createGetFileStructureTool, u as createWriteTodosTool, w as ServerLlmBackend, x as WebSocketConnectionManager, y as ApiClient } from "../tools-dIVxi-6-.mjs";
+import { A as getApiUrl, C as WebSocketLlmBackend, G as isReadOnlyTool, J as CheckpointStore, K as ReActAgent, M as PermissionManager, N as generateCliTools, S as FallbackLlmBackend, T as McpManager, U as buildCoreSystemPrompt, V as setWebSocketToolExecutor, X as SessionStore, _ as createSkillTool, b as WebSocketToolExecutor, c as createFindDefinitionTool, d as createCoordinateTaskTool, f as createBackgroundAgentTools, g as SubagentOrchestrator, h as AgentStore, k as loadContextFiles, l as createTodoStore, m as createAgentDelegateTool, p as BackgroundAgentManager, q as CustomCommandStore, s as createGetFileStructureTool, u as createWriteTodosTool, w as ServerLlmBackend, x as WebSocketConnectionManager, y as ApiClient } from "../tools-BUs_OkJc.mjs";
 import { n as logger, t as ConfigStore } from "../ConfigStore-Dt6utdSA.mjs";
 import { t as DEFAULT_SANDBOX_CONFIG } from "../types-DBEjF9YS.mjs";
 import { t as createSandboxRuntime } from "../SandboxRuntimeAdapter-C1B4t20N.mjs";

package/dist/commands/updateCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as version, r as forceCheckForUpdate } from "../updateChecker-DZXWZfKF.mjs";
+import { a as version, i as forceCheckForUpdate } from "../updateChecker-D-xoVcN3.mjs";
 import { execSync } from "child_process";
 //#region src/commands/updateCommand.ts
 /**

package/dist/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { n as useCliStore, t as selectActiveBackgroundAgents } from "./store-B7-LLvvx.mjs";
-import { $ as processFileReferences, A as getApiUrl, B as registerFeatureModuleTools, C as WebSocketLlmBackend, D as formatStep, E as substituteArguments, F as DEFAULT_AGENT_MODEL, G as isReadOnlyTool, H as OllamaBackend, I as DEFAULT_MAX_ITERATIONS, J as CheckpointStore, K as ReActAgent, L as DEFAULT_RETRY_CONFIG, M as PermissionManager, N as generateCliTools, O as extractCompactInstructions, P as ALWAYS_DENIED_FOR_AGENTS, Q as hasFileReferences, R as DEFAULT_THOROUGHNESS, S as FallbackLlmBackend, T as McpManager, U as buildCoreSystemPrompt, V as setWebSocketToolExecutor, W as buildSkillsPromptSection, X as SessionStore, Y as CommandHistoryStore, Z as OAuthClient, _ as createSkillTool, a as createDecisionStore, b as WebSocketToolExecutor, c as createFindDefinitionTool, d as createCoordinateTaskTool, et as searchCommands, f as createBackgroundAgentTools, g as SubagentOrchestrator, h as AgentStore, i as createDecisionLogTool, it as warmFileCache, j as getEnvironmentName, k as loadContextFiles, l as createTodoStore, m as createAgentDelegateTool, n as createBlockerTools, nt as formatFileSize, o as formatDecisionsOutput, p as BackgroundAgentManager, q as CustomCommandStore, r as formatBlockersOutput, rt as searchFiles, s as createGetFileStructureTool, t as createBlockerStore, tt as mergeCommands, u as createWriteTodosTool, v as parseAgentConfig, w as ServerLlmBackend, x as WebSocketConnectionManager, y as ApiClient, z as clearFeatureModuleTools } from "./tools-dIVxi-6-.mjs";
+import { $ as processFileReferences, A as getApiUrl, B as registerFeatureModuleTools, C as WebSocketLlmBackend, D as formatStep, E as substituteArguments, F as DEFAULT_AGENT_MODEL, G as isReadOnlyTool, H as OllamaBackend, I as DEFAULT_MAX_ITERATIONS, J as CheckpointStore, K as ReActAgent, L as DEFAULT_RETRY_CONFIG, M as PermissionManager, N as generateCliTools, O as extractCompactInstructions, P as ALWAYS_DENIED_FOR_AGENTS, Q as hasFileReferences, R as DEFAULT_THOROUGHNESS, S as FallbackLlmBackend, T as McpManager, U as buildCoreSystemPrompt, V as setWebSocketToolExecutor, W as buildSkillsPromptSection, X as SessionStore, Y as CommandHistoryStore, Z as OAuthClient, _ as createSkillTool, a as createDecisionStore, b as WebSocketToolExecutor, c as createFindDefinitionTool, d as createCoordinateTaskTool, et as searchCommands, f as createBackgroundAgentTools, g as SubagentOrchestrator, h as AgentStore, i as createDecisionLogTool, it as warmFileCache, j as getEnvironmentName, k as loadContextFiles, l as createTodoStore, m as createAgentDelegateTool, n as createBlockerTools, nt as formatFileSize, o as formatDecisionsOutput, p as BackgroundAgentManager, q as CustomCommandStore, r as formatBlockersOutput, rt as searchFiles, s as createGetFileStructureTool, t as createBlockerStore, tt as mergeCommands, u as createWriteTodosTool, v as parseAgentConfig, w as ServerLlmBackend, x as WebSocketConnectionManager, y as ApiClient, z as clearFeatureModuleTools } from "./tools-BUs_OkJc.mjs";
 import { Mt as validateNotebookPath$1, g as ChatModels, jt as validateJupyterKernelName, m as CREDIT_DEDUCT_TRANSACTION_TYPES, n as logger, t as ConfigStore } from "./ConfigStore-Dt6utdSA.mjs";
-import { i as version, t as checkForUpdate } from "./updateChecker-DZXWZfKF.mjs";
+import { a as version, t as checkForUpdate } from "./updateChecker-D-xoVcN3.mjs";
 import React, { useCallback, useEffect, useMemo, useReducer, useRef, useState } from "react";
 import { Box, Static, Text, render, useApp, useInput } from "ink";
 import { execSync } from "child_process";
@@ -5335,7 +5335,8 @@ function CliApp() {
 				console.log("\n🔐 Welcome to B4M CLI! Authentication is required to get started.\n");
 				setState((prev) => ({
 					...prev,
-					showLoginFlow: true
+					showLoginFlow: true,
+					config
 				}));
 				return;
 			}
@@ -5345,7 +5346,8 @@ function CliApp() {
 				await state.configStore.clearAuthTokens();
 				setState((prev) => ({
 					...prev,
-					showLoginFlow: true
+					showLoginFlow: true,
+					config
 				}));
 				return;
 			}

package/dist/{tools-dIVxi-6-.mjs → tools-BUs_OkJc.mjs}

@@ -2906,7 +2906,7 @@ const TOOL_FILE_READ = "file_read";
 const TOOL_EDIT_LOCAL_FILE = "edit_local_file";
 const TOOL_CREATE_FILE = "create_file";
 const TOOL_BASH_EXECUTE = "bash_execute";
-const TOOL_SUBAGENT_DELEGATE = "subagent_delegate";
+const TOOL_SUBAGENT_DELEGATE = "agent_delegate";
 const TOOL_WRITE_TODOS = "write_todos";
 const TOOL_CREATE_DYNAMIC_AGENT = "create_dynamic_agent";
 const EXPLORE_SUBAGENT_TYPE = "explore";
@@ -3025,7 +3025,7 @@ EXAMPLES:
 - "how about Japan?" → use weather tool for Japan (applying same question from context)
 - "enhance README" → ${TOOL_FILE_READ} → generate → ${TOOL_EDIT_LOCAL_FILE}
 - "what packages installed?" → ${TOOL_GLOB_FILES} "**/package.json" → ${TOOL_FILE_READ}
-- "find all components using React hooks" → ${TOOL_SUBAGENT_DELEGATE}(task="find all components using React hooks", type="explore")
+- "find all components using React hooks" → ${TOOL_SUBAGENT_DELEGATE}(task="find all components using React hooks", agent="explore")
 
 Remember: Use context from previous messages to understand follow-up questions.
 
@@ -21995,7 +21995,7 @@ Describe the expected output format here.
 	*/
 	getDirectoryContext() {
 		if (this.agents.size === 0) return "No sub-agents are currently available.";
-		let context = "Use `subagent_delegate` for complex tasks requiring specialized analysis.\n";
+		let context = "Use `agent_delegate` for complex tasks requiring specialized analysis.\n";
 		for (const [name, def] of this.agents) context += ` - **${name}**: ${def.description}\n`;
 		return context;
 	}

package/dist/{updateChecker-DZXWZfKF.mjs → updateChecker-D-xoVcN3.mjs}

@@ -4,7 +4,7 @@ import { homedir } from "os";
 import path from "path";
 import axios from "axios";
 //#region package.json
-var version = "0.6.0";
+var version = "0.6.1";
 //#endregion
 //#region src/utils/updateChecker.ts
 /**
@@ -53,7 +53,7 @@ async function readCache() {
 	try {
 		const data = await promises.readFile(CACHE_FILE, "utf-8");
 		const parsed = JSON.parse(data);
-		if (parsed && typeof parsed.lastChecked === "string" && typeof parsed.latestVersion === "string") return parsed;
+		if (parsed && typeof parsed.lastChecked === "string" && typeof parsed.latestVersion === "string" && typeof parsed.currentVersion === "string") return parsed;
 		return null;
 	} catch {
 		return null;
@@ -117,4 +117,4 @@ async function forceCheckForUpdate(currentVersion) {
 	};
 }
 //#endregion
-export { version as i, fetchLatestVersion as n, forceCheckForUpdate as r, checkForUpdate as t };
+export { version as a, forceCheckForUpdate as i, compareSemver as n, fetchLatestVersion as r, checkForUpdate as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -103,7 +103,7 @@
     "yauzl": "^3.3.0",
     "zod": "^4.3.6",
     "zod-validation-error": "^5.0.0",
-    "zustand": "^5.0.13"
+    "zustand": "^4.5.4"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -118,11 +118,11 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
-    "@bike4mind/agents": "0.0.0-changeset-release-main-20260505221459",
-    "@bike4mind/common": "0.0.0-changeset-release-main-20260505221459",
-    "@bike4mind/mcp": "0.0.0-changeset-release-main-20260505221459",
-    "@bike4mind/services": "0.0.0-changeset-release-main-20260505221459",
-    "@bike4mind/utils": "0.0.0-changeset-release-main-20260505221459"
+    "@bike4mind/agents": "0.6.3",
+    "@bike4mind/common": "2.92.1",
+    "@bike4mind/mcp": "1.37.3",
+    "@bike4mind/services": "2.79.3",
+    "@bike4mind/utils": "2.19.3"
   },
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.17.1"