@braingrid/cli 0.2.51 → 0.2.53

package/dist/cli.js

@@ -228,7 +228,7 @@ async function axiosWithRetry(config2, options) {
 
 // src/build-config.ts
 var BUILD_ENV = true ? "production" : process.env.NODE_ENV === "test" ? "development" : "production";
-var CLI_VERSION = true ? "0.2.51" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.53" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -2629,9 +2629,39 @@ var ProjectService = class {
 };
 
 // src/services/setup-service.ts
-import * as fs2 from "fs/promises";
-import * as path2 from "path";
+import * as fs3 from "fs/promises";
+import * as path3 from "path";
 import axios5 from "axios";
+
+// src/utils/cli-logger.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+var logFile = null;
+var logStream = null;
+function initLogger(logPath) {
+  if (logStream) {
+    logStream.end();
+  }
+  const dir = path2.dirname(logPath);
+  fs2.mkdirSync(dir, { recursive: true });
+  logFile = logPath;
+  logStream = fs2.createWriteStream(logPath, { flags: "a" });
+}
+function log(level, component, event, details = "") {
+  if (!logStream) return;
+  const now = /* @__PURE__ */ new Date();
+  const ts = now.toLocaleTimeString("en-US", { hour12: false });
+  const line = `${ts} [${level.padEnd(5)}] ${component} | ${event} | ${details}
+`;
+  logStream.write(line);
+}
+function closeLogger() {
+  logStream?.end();
+  logStream = null;
+  logFile = null;
+}
+
+// src/services/setup-service.ts
 var GITHUB_OWNER = "BrainGridAI";
 var GITHUB_REPO = "braingrid";
 var GITHUB_API_BASE = `https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents`;
@@ -2664,6 +2694,12 @@ async function githubGet(url) {
     return await axios5.get(url, { headers });
   } catch (error) {
     if (axios5.isAxiosError(error) && error.response?.status === 401 && cachedHeaders?.Authorization) {
+      log(
+        "WARN",
+        "github-api",
+        "auth_fallback",
+        "dropping expired token, retrying unauthenticated"
+      );
       delete cachedHeaders.Authorization;
       return axios5.get(url, { headers: cachedHeaders });
     }
@@ -2683,6 +2719,7 @@ async function withRetry(fn, retries = MAX_RETRIES, delay = INITIAL_RETRY_DELAY)
     if (!isNetworkError) {
       throw error;
     }
+    log("WARN", "github-api", "retry", `attempt=${MAX_RETRIES - retries + 1} delay=${delay}ms`);
     await new Promise((resolve2) => setTimeout(resolve2, delay));
     return withRetry(fn, retries - 1, delay * 2);
   }
@@ -2712,6 +2749,7 @@ function parseGitHubError(error) {
 }
 async function fetchFileFromGitHub(filePath) {
   return withRetry(async () => {
+    log("INFO", "github-api", "fetch", `path=${filePath}`);
     try {
       const { data: response } = await githubGet(
         `${GITHUB_API_BASE}/${filePath}`
@@ -2768,9 +2806,9 @@ async function listGitHubDirectory(dirPath) {
 async function copyFileFromGitHub(sourcePath, targetPath) {
   try {
     const content = await fetchFileFromGitHub(sourcePath);
-    const parentDir = path2.dirname(targetPath);
-    await fs2.mkdir(parentDir, { recursive: true });
-    await fs2.writeFile(targetPath, content, { encoding: "utf8", mode: 420 });
+    const parentDir = path3.dirname(targetPath);
+    await fs3.mkdir(parentDir, { recursive: true });
+    await fs3.writeFile(targetPath, content, { encoding: "utf8", mode: 420 });
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     throw new Error(`Failed to copy file ${sourcePath} to ${targetPath}: ${errorMessage}`);
@@ -2781,7 +2819,7 @@ async function injectContentIntoFile(targetPath, content) {
     let fileContent;
     let fileExists3 = false;
     try {
-      fileContent = await fs2.readFile(targetPath, "utf8");
+      fileContent = await fs3.readFile(targetPath, "utf8");
       fileExists3 = true;
     } catch {
       fileContent = "";
@@ -2803,7 +2841,7 @@ async function injectContentIntoFile(targetPath, content) {
         const newContent = `${before}${BEGIN_MARKER}
 ${cleanContent}
 ${END_MARKER}${after}`;
-        await fs2.writeFile(targetPath, newContent, { encoding: "utf8" });
+        await fs3.writeFile(targetPath, newContent, { encoding: "utf8" });
       } else {
         const newContent = `${fileContent}
 
@@ -2811,16 +2849,16 @@ ${BEGIN_MARKER}
 ${cleanContent}
 ${END_MARKER}
 `;
-        await fs2.writeFile(targetPath, newContent, { encoding: "utf8" });
+        await fs3.writeFile(targetPath, newContent, { encoding: "utf8" });
       }
     } else {
-      const parentDir = path2.dirname(targetPath);
-      await fs2.mkdir(parentDir, { recursive: true });
+      const parentDir = path3.dirname(targetPath);
+      await fs3.mkdir(parentDir, { recursive: true });
       const newContent = `${BEGIN_MARKER}
 ${cleanContent}
 ${END_MARKER}
 `;
-      await fs2.writeFile(targetPath, newContent, { encoding: "utf8", mode: 420 });
+      await fs3.writeFile(targetPath, newContent, { encoding: "utf8", mode: 420 });
     }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
@@ -2829,9 +2867,9 @@ ${END_MARKER}
 }
 async function installStatusLineScript(scriptContent, targetPath = ".claude/statusline.sh") {
   try {
-    const parentDir = path2.dirname(targetPath);
-    await fs2.mkdir(parentDir, { recursive: true });
-    await fs2.writeFile(targetPath, scriptContent, { encoding: "utf8", mode: 493 });
+    const parentDir = path3.dirname(targetPath);
+    await fs3.mkdir(parentDir, { recursive: true });
+    await fs3.writeFile(targetPath, scriptContent, { encoding: "utf8", mode: 493 });
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     throw new Error(`Failed to install status line script to ${targetPath}: ${errorMessage}`);
@@ -2839,9 +2877,9 @@ async function installStatusLineScript(scriptContent, targetPath = ".claude/stat
 }
 async function installHookScript(scriptContent, targetPath) {
   try {
-    const parentDir = path2.dirname(targetPath);
-    await fs2.mkdir(parentDir, { recursive: true });
-    await fs2.writeFile(targetPath, scriptContent, { encoding: "utf8", mode: 493 });
+    const parentDir = path3.dirname(targetPath);
+    await fs3.mkdir(parentDir, { recursive: true });
+    await fs3.writeFile(targetPath, scriptContent, { encoding: "utf8", mode: 493 });
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     throw new Error(`Failed to install hook script to ${targetPath}: ${errorMessage}`);
@@ -2850,11 +2888,17 @@ async function installHookScript(scriptContent, targetPath) {
 async function copyBraingridReadme(targetPath = ".braingrid/README.md") {
   try {
     const content = await fetchFileFromGitHub("claude-code/README.md");
-    const parentDir = path2.dirname(targetPath);
-    await fs2.mkdir(parentDir, { recursive: true });
-    await fs2.writeFile(targetPath, content, { encoding: "utf8", mode: 420 });
+    const parentDir = path3.dirname(targetPath);
+    await fs3.mkdir(parentDir, { recursive: true });
+    await fs3.writeFile(targetPath, content, { encoding: "utf8", mode: 420 });
     return true;
-  } catch {
+  } catch (error) {
+    log(
+      "WARN",
+      "setup",
+      "readme_failed",
+      `error=${error instanceof Error ? error.message : String(error)}`
+    );
     return false;
   }
 }
@@ -2920,7 +2964,7 @@ async function updateClaudeSettings(settingsPath = ".claude/settings.json", stat
   try {
     let settings = {};
     try {
-      const content2 = await fs2.readFile(settingsPath, "utf8");
+      const content2 = await fs3.readFile(settingsPath, "utf8");
       settings = JSON.parse(content2);
     } catch {
     }
@@ -2966,10 +3010,10 @@ async function updateClaudeSettings(settingsPath = ".claude/settings.json", stat
       ...existingHooks,
       ...mergedByType
     };
-    const parentDir = path2.dirname(settingsPath);
-    await fs2.mkdir(parentDir, { recursive: true });
+    const parentDir = path3.dirname(settingsPath);
+    await fs3.mkdir(parentDir, { recursive: true });
     const content = JSON.stringify(settings, null, "	");
-    await fs2.writeFile(settingsPath, content, { encoding: "utf8" });
+    await fs3.writeFile(settingsPath, content, { encoding: "utf8" });
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     throw new Error(`Failed to update Claude settings at ${settingsPath}: ${errorMessage}`);
@@ -3177,7 +3221,7 @@ function getManualInstallInstructions() {
 
 // src/utils/github-repo.ts
 import { exec as exec3 } from "child_process";
-import path3 from "path";
+import path4 from "path";
 import { promisify as promisify3 } from "util";
 var execAsync4 = promisify3(exec3);
 async function initGitRepo() {
@@ -3197,7 +3241,7 @@ async function isGhAuthenticated() {
   }
 }
 function getCurrentDirectoryName() {
-  return path3.basename(process.cwd());
+  return path4.basename(process.cwd());
 }
 async function createGitHubRepoWithGh(name, isPrivate) {
   try {
@@ -3230,11 +3274,11 @@ async function canUseGhAutomation() {
 
 // src/utils/gitignore.ts
 import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 async function addBraingridTempToGitignore() {
   const gitRoot = await getGitRoot();
   if (!gitRoot) return;
-  const gitignorePath = path4.join(gitRoot, ".gitignore");
+  const gitignorePath = path5.join(gitRoot, ".gitignore");
   const entry = ".braingrid/temp/";
   let content = "";
   try {
@@ -3253,8 +3297,8 @@ ${entry}
 }
 
 // src/utils/local-store.ts
-import fs3 from "fs";
-import path5 from "path";
+import fs4 from "fs";
+import path6 from "path";
 
 // src/types/local-project.ts
 import { z } from "zod";
@@ -3284,28 +3328,28 @@ async function getDefaultCwd() {
 }
 async function getBraingridDir(cwd) {
   const dir = cwd ?? await getDefaultCwd();
-  return path5.join(dir, BRAINGRID_DIR);
+  return path6.join(dir, BRAINGRID_DIR);
 }
 async function getProjectConfigPath(cwd) {
   const braingridDir = await getBraingridDir(cwd);
-  return path5.join(braingridDir, PROJECT_CONFIG_FILE);
+  return path6.join(braingridDir, PROJECT_CONFIG_FILE);
 }
 async function projectConfigExists(cwd) {
   const configPath = await getProjectConfigPath(cwd);
-  return fs3.existsSync(configPath);
+  return fs4.existsSync(configPath);
 }
 async function ensureBraingridDir(cwd) {
   const dir = await getBraingridDir(cwd);
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true });
+  if (!fs4.existsSync(dir)) {
+    fs4.mkdirSync(dir, { recursive: true });
   }
 }
 async function loadProjectConfig(cwd) {
   const configPath = await getProjectConfigPath(cwd);
-  if (!fs3.existsSync(configPath)) {
+  if (!fs4.existsSync(configPath)) {
     throw new Error(`Project not initialized. Run 'braingrid init' to initialize this repository.`);
   }
-  const content = fs3.readFileSync(configPath, "utf8");
+  const content = fs4.readFileSync(configPath, "utf8");
   const data = JSON.parse(content);
   return LocalProjectConfigSchema.parse(data);
 }
@@ -3313,7 +3357,7 @@ async function saveProjectConfig(config2, cwd) {
   await ensureBraingridDir(cwd);
   const configPath = await getProjectConfigPath(cwd);
   const content = JSON.stringify(config2, null, 2);
-  fs3.writeFileSync(configPath, content, "utf8");
+  fs4.writeFileSync(configPath, content, "utf8");
 }
 async function getLocalProjectId(cwd) {
   try {
@@ -3504,13 +3548,13 @@ async function checkAndShowUpdateWarning() {
 }
 
 // src/handlers/setup.handlers.ts
-import * as fs4 from "fs/promises";
-import * as path6 from "path";
+import * as fs5 from "fs/promises";
+import * as path7 from "path";
 import { select } from "@inquirer/prompts";
 import chalk9 from "chalk";
 async function fileExists(filePath) {
   try {
-    await fs4.access(filePath);
+    await fs5.access(filePath);
     return true;
   } catch {
     return false;
@@ -3523,7 +3567,7 @@ async function getFileList(sourcePaths, targetPaths) {
       const items = await listGitHubDirectory(sourceDir);
       for (const item of items) {
         if (item.type === "file") {
-          const itemTargetPath = path6.join(targetDir, item.name);
+          const itemTargetPath = path7.join(targetDir, item.name);
           const exists = await fileExists(itemTargetPath);
           operations.push({
             type: "copy",
@@ -3533,11 +3577,17 @@ async function getFileList(sourcePaths, targetPaths) {
             dirIndex
           });
         } else if (item.type === "dir") {
-          const itemTargetPath = path6.join(targetDir, item.name);
+          const itemTargetPath = path7.join(targetDir, item.name);
           await processDirectory(item.path, itemTargetPath, dirIndex);
         }
       }
     } catch (error) {
+      log(
+        "WARN",
+        "setup",
+        "list_dir_failed",
+        `source=${sourceDir} error=${error instanceof Error ? error.message : String(error)}`
+      );
       console.warn(
         chalk9.yellow(`\u26A0\uFE0F  Could not list directory: ${sourceDir}`),
         error instanceof Error ? error.message : String(error)
@@ -3591,6 +3641,7 @@ async function installFiles(operations, force, dirCount) {
       if (response === "quit") {
         return { installedPerDir, skipped, cancelled: true };
       } else if (response === "skip") {
+        log("INFO", "setup", "skip_file", `target=${operation.targetPath} reason=user_skip`);
         skipped++;
         continue;
       } else if (response === "all") {
@@ -3599,10 +3650,17 @@ async function installFiles(operations, force, dirCount) {
     }
     try {
       await copyFileFromGitHub(operation.sourcePath, operation.targetPath);
+      log("INFO", "setup", "copy_file", `target=${operation.targetPath}`);
       if (operation.dirIndex !== void 0) {
         installedPerDir[operation.dirIndex]++;
       }
     } catch (error) {
+      log(
+        "ERROR",
+        "setup",
+        "copy_file_failed",
+        `target=${operation.targetPath} error=${error instanceof Error ? error.message : String(error)}`
+      );
       console.error(
         chalk9.red(`Failed to copy ${operation.targetPath}:`),
         error instanceof Error ? error.message : String(error)
@@ -3613,6 +3671,13 @@ async function installFiles(operations, force, dirCount) {
   return { installedPerDir, skipped, cancelled: false };
 }
 async function _handleSetup(config2, opts) {
+  initLogger(".braingrid/temp/setup-debug.log");
+  log(
+    "INFO",
+    "setup",
+    "start",
+    `integration=${config2.name} force=${opts.force} dry_run=${opts.dryRun}`
+  );
   console.log(chalk9.bold(`\u{1F680} Setting up ${config2.name} integration...
 `));
   const operations = await getFileList(config2.sourceDirs, config2.targetDirs);
@@ -3646,13 +3711,23 @@ async function _handleSetup(config2, opts) {
   try {
     const content = await fetchFileFromGitHub(config2.injection.sourceFile);
     await injectContentIntoFile(config2.injection.targetFile, content);
+    log("INFO", "setup", "inject", `target=${config2.injection.targetFile}`);
   } catch (error) {
+    log(
+      "ERROR",
+      "setup",
+      "inject_failed",
+      `target=${config2.injection.targetFile} error=${error instanceof Error ? error.message : String(error)}`
+    );
     console.error(
       chalk9.red(`Failed to inject content into ${config2.injection.targetFile}:`),
       error instanceof Error ? error.message : String(error)
     );
   }
-  await copyBraingridReadme();
+  const readmeCopied = await copyBraingridReadme();
+  if (readmeCopied) {
+    log("INFO", "setup", "readme", "path=.braingrid/README.md");
+  }
   return {
     success: true,
     data: {
@@ -3720,7 +3795,14 @@ async function handleSetupClaudeCode(opts) {
       const scriptContent = await fetchFileFromGitHub("claude-code/statusline.sh");
       await installStatusLineScript(scriptContent);
       statusLineInstalled = true;
+      log("INFO", "setup", "statusline", "path=.claude/statusline.sh");
     } catch (error) {
+      log(
+        "ERROR",
+        "setup",
+        "statusline_failed",
+        `error=${error instanceof Error ? error.message : String(error)}`
+      );
       console.error(
         chalk9.yellow("\u26A0\uFE0F  Failed to install status line script:"),
         error instanceof Error ? error.message : String(error)
@@ -3728,7 +3810,14 @@ async function handleSetupClaudeCode(opts) {
     }
     try {
       await updateClaudeSettings();
+      log("INFO", "setup", "settings", "path=.claude/settings.json");
     } catch (error) {
+      log(
+        "ERROR",
+        "setup",
+        "settings_failed",
+        `error=${error instanceof Error ? error.message : String(error)}`
+      );
       console.error(
         chalk9.yellow("\u26A0\uFE0F  Failed to update Claude settings:"),
         error instanceof Error ? error.message : String(error)
@@ -3746,7 +3835,14 @@ async function handleSetupClaudeCode(opts) {
         const content = await fetchFileFromGitHub(`claude-code/hooks/${script}`);
         await installHookScript(content, `.claude/hooks/${script}`);
         installedHooks.push(script);
+        log("INFO", "setup", "hook", `script=${script}`);
       } catch (error) {
+        log(
+          "ERROR",
+          "setup",
+          "hook_failed",
+          `script=${script} error=${error instanceof Error ? error.message : String(error)}`
+        );
         console.error(
           chalk9.yellow(`\u26A0\uFE0F  Failed to install hook ${script}:`),
           error instanceof Error ? error.message : String(error)
@@ -3756,12 +3852,22 @@ async function handleSetupClaudeCode(opts) {
     const statusLineMessage = statusLineInstalled ? chalk9.dim("  Status line: .claude/statusline.sh\n") : "";
     const hooksMessage = installedHooks.map((s) => chalk9.dim(`  Hook script: .claude/hooks/${s}
 `)).join("");
+    const totalInstalled = displayPerDir.reduce((a, b) => a + b, 0);
+    log(
+      "INFO",
+      "setup",
+      "complete",
+      `installed=${totalInstalled} skipped=${setupResult.data.skipped} hooks=${installedHooks.length}`
+    );
+    closeLogger();
     return {
       success: true,
       message: buildSuccessMessage(config2, displayPerDir, statusLineMessage + hooksMessage)
     };
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
+    log("ERROR", "setup", "fatal", `error=${errorMessage}`);
+    closeLogger();
     return {
       success: false,
       message: chalk9.red(`\u274C Setup failed: ${errorMessage}`)
@@ -3788,13 +3894,18 @@ async function handleSetupCursor(opts) {
     if (!isSetupResult(setupResult)) {
       return setupResult;
     }
-    const { installedPerDir } = setupResult.data;
+    const { installedPerDir, skipped } = setupResult.data;
+    const totalInstalled = installedPerDir.reduce((a, b) => a + b, 0);
+    log("INFO", "setup", "complete", `installed=${totalInstalled} skipped=${skipped}`);
+    closeLogger();
     return {
       success: true,
       message: buildSuccessMessage(config2, installedPerDir, "")
     };
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
+    log("ERROR", "setup", "fatal", `error=${errorMessage}`);
+    closeLogger();
     return {
       success: false,
       message: chalk9.red(`\u274C Setup failed: ${errorMessage}`)
@@ -4147,7 +4258,13 @@ async function handleNoProjectForRepository(owner, name, gitInfo, githubService,
   try {
     const installationsResponse = await githubService.listInstallations({ limit: 100 });
     allInstallations = installationsResponse.installations;
-  } catch {
+  } catch (error) {
+    log(
+      "WARN",
+      "init",
+      "list_installations_failed",
+      `error=${error instanceof Error ? error.message : String(error)}`
+    );
     allInstallations = [];
   }
   const webUrl = config2.getWebAppUrl();
@@ -4296,6 +4413,9 @@ async function handleNoGitRemote() {
 }
 async function handleInit(opts) {
   try {
+    const initStartTime = Date.now();
+    initLogger(".braingrid/temp/init-debug.log");
+    log("INFO", "init", "start", `force=${opts.force} project=${opts.project || "auto-detect"}`);
     const updateInfo = await isUpdateAvailable();
     if (updateInfo.available && updateInfo.latestVersion) {
       console.log(
@@ -4316,6 +4436,12 @@ async function handleInit(opts) {
       }
       console.log();
     }
+    log(
+      "INFO",
+      "init",
+      "update_check",
+      `available=${updateInfo.available} current=${updateInfo.currentVersion}${updateInfo.latestVersion ? ` latest=${updateInfo.latestVersion}` : ""}`
+    );
     const config2 = getConfig();
     const { projectService, githubService, repositoryService, auth } = getServices();
     if (!await isGitInstalled()) {
@@ -4340,12 +4466,14 @@ async function handleInit(opts) {
       console.log(installResult.message);
       console.log();
       if (!await isGitInstalled()) {
+        log("ERROR", "init", "git_check", "installed=false post_install=true");
         return {
           success: false,
           message: chalk11.red("\u274C Git installation completed but git command not found\n\n") + chalk11.dim("You may need to restart your terminal or add Git to your PATH.\n") + getManualInstallInstructions()
         };
       }
     }
+    log("INFO", "init", "git_check", "installed=true");
     if (!await isGhInstalled()) {
       console.log(chalk11.blue("\n\u{1F4A1} GitHub CLI is highly recommended for working with BrainGrid."));
       console.log(
@@ -4369,6 +4497,7 @@ async function handleInit(opts) {
         console.log(chalk11.dim("Skipping GitHub CLI installation.\n"));
       }
     }
+    log("INFO", "init", "gh_check", `installed=${await isGhInstalled()}`);
     if (await projectConfigExists() && !opts.force) {
       try {
         const existing = await loadProjectConfig();
@@ -4379,7 +4508,13 @@ async function handleInit(opts) {
 
 `) + chalk11.dim("Use --force to reinitialize")
         };
-      } catch {
+      } catch (error) {
+        log(
+          "ERROR",
+          "init",
+          "config_load",
+          `error=${error instanceof Error ? error.message : String(error)}`
+        );
         return {
           success: false,
           message: chalk11.yellow("\u26A0\uFE0F  Invalid project configuration found.\n") + chalk11.dim("Use --force to reinitialize")
@@ -4387,6 +4522,7 @@ async function handleInit(opts) {
       }
     }
     const isAuthenticated = await auth.isAuthenticated();
+    log("INFO", "init", "auth_check", `authenticated=${isAuthenticated}`);
     if (!isAuthenticated) {
       const shouldLogin = await confirm2({
         message: "You need to be authenticated. Would you like to log in / sign up now?",
@@ -4398,15 +4534,18 @@ async function handleInit(opts) {
           message: chalk11.yellow("\u26A0\uFE0F  Authentication required.\n") + chalk11.dim("Run ") + chalk11.cyan("braingrid login") + chalk11.dim(" when you're ready to authenticate.")
         };
       }
+      log("WARN", "init", "login_required", "prompted=true");
       console.log();
       const loginResult = await handleLogin();
       if (!loginResult.success) {
+        log("ERROR", "init", "login_failed", "error=login handler returned failure");
         return {
           success: false,
           message: chalk11.red("\u274C Login failed.\n") + chalk11.dim("Please try running ") + chalk11.cyan("braingrid login") + chalk11.dim(" again.")
         };
       }
       if (!await auth.isAuthenticated()) {
+        log("ERROR", "init", "login_failed", "error=login not completed");
         return {
           success: false,
           message: chalk11.red("\u274C Login was not completed.\n") + chalk11.dim("Please try running ") + chalk11.cyan("braingrid login") + chalk11.dim(" again.")
@@ -4445,7 +4584,13 @@ async function handleInit(opts) {
     if (opts.project) {
       try {
         project2 = await projectService.getProject(opts.project);
-      } catch {
+      } catch (error) {
+        log(
+          "ERROR",
+          "init",
+          "project_fetch",
+          `project=${opts.project} error=${error instanceof Error ? error.message : String(error)}`
+        );
         return {
           success: false,
           message: chalk11.red(`\u274C Project not found: ${opts.project}
@@ -4532,6 +4677,7 @@ async function handleInit(opts) {
       }
       project2 = response.projects[0];
     }
+    log("INFO", "init", "project_found", `id=${project2.short_id} name=${project2.name}`);
     const projectInfo = chalk11.bold("\n\u{1F4E6} BrainGrid Project Found\n\n") + chalk11.dim("Project:     ") + chalk11.cyan(project2.name) + "\n" + chalk11.dim("ID:          ") + chalk11.gray(project2.short_id) + "\n" + (project2.description ? `${chalk11.dim("Description: ") + chalk11.gray(project2.description)}
 ` : "") + chalk11.dim("Repository:  ") + chalk11.gray(project2.repository?.full_name || "N/A") + "\n\n";
     console.log(projectInfo);
@@ -4565,12 +4711,19 @@ async function handleInit(opts) {
       created_at: project2.created_at
     };
     await saveProjectConfig(localConfig);
+    log("INFO", "init", "config_saved", "path=.braingrid/project.json");
     await addBraingridTempToGitignore();
     await copyBraingridReadme();
     console.log(
       chalk11.green("\u2705 Repository initialized successfully!\n\n") + chalk11.dim("Project:    ") + chalk11.cyan(project2.name) + chalk11.dim(` (${project2.short_id})`) + "\n" + chalk11.dim("Config:     ") + chalk11.gray(".braingrid/project.json") + "\n"
     );
     const installedIDEs = await detectInstalledIDEs();
+    log(
+      "INFO",
+      "init",
+      "ide_detect",
+      `claude_code=${installedIDEs.claudeCode} cursor=${installedIDEs.cursor}`
+    );
     if (installedIDEs.claudeCode) {
       const claudeSetupExists = await fileExists2(".claude/commands/specify.md");
       console.log("");
@@ -4579,6 +4732,7 @@ async function handleInit(opts) {
         default: true
       });
       if (setupClaude) {
+        log("INFO", "init", "setup_claude", `force=${claudeSetupExists}`);
         console.log("");
         try {
           const result = await handleSetupClaudeCode({
@@ -4592,7 +4746,13 @@ async function handleInit(opts) {
               chalk11.dim("You can run ") + chalk11.cyan("braingrid setup claude-code") + chalk11.dim(" later.")
             );
           }
-        } catch {
+        } catch (error) {
+          log(
+            "ERROR",
+            "init",
+            "setup_claude_failed",
+            `error=${error instanceof Error ? error.message : String(error)}`
+          );
           console.log(chalk11.yellow("\u26A0\uFE0F  Claude Code setup encountered an error."));
           console.log(
             chalk11.dim("You can run ") + chalk11.cyan("braingrid setup claude-code") + chalk11.dim(" later.")
@@ -4609,6 +4769,7 @@ async function handleInit(opts) {
         default: true
       });
       if (setupCursor) {
+        log("INFO", "init", "setup_cursor", `force=${cursorSetupExists}`);
         console.log("");
         try {
           const result = await handleSetupCursor({
@@ -4622,7 +4783,13 @@ async function handleInit(opts) {
               chalk11.dim("You can run ") + chalk11.cyan("braingrid setup cursor") + chalk11.dim(" later.")
             );
           }
-        } catch {
+        } catch (error) {
+          log(
+            "ERROR",
+            "init",
+            "setup_cursor_failed",
+            `error=${error instanceof Error ? error.message : String(error)}`
+          );
           console.log(chalk11.yellow("\u26A0\uFE0F  Cursor setup encountered an error."));
           console.log(
             chalk11.dim("You can run ") + chalk11.cyan("braingrid setup cursor") + chalk11.dim(" later.")
@@ -4631,14 +4798,22 @@ async function handleInit(opts) {
         console.log("");
       }
     }
+    const initDuration = Math.round((Date.now() - initStartTime) / 1e3);
+    log("INFO", "init", "complete", `project=${project2.short_id} duration=${initDuration}s`);
+    closeLogger();
     return {
       success: true,
-      message: chalk11.dim(
-        "You can now use project-scoped commands without specifying a project ID."
-      ),
+      message: chalk11.dim("You can now use project-scoped commands without specifying a project ID.") + "\n" + chalk11.dim("Debug log: .braingrid/temp/init-debug.log"),
       data: localConfig
     };
   } catch (error) {
+    log(
+      "ERROR",
+      "init",
+      "fatal",
+      `error=${error instanceof Error ? error.message : String(error)}`
+    );
+    closeLogger();
     return {
       success: false,
       message: formatError(error, "initializing repository")
@@ -5844,6 +6019,18 @@ var WorkspaceManager = class {
         projectId: normalized
       };
     }
+    const configExists = await projectConfigExists();
+    if (configExists) {
+      try {
+        await loadProjectConfig();
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+          success: false,
+          error: chalk13.red("\u274C Found .braingrid/project.json but failed to load it:") + "\n" + chalk13.dim(`  ${msg}`) + "\n\n" + chalk13.dim("Try re-initializing with:\n") + chalk13.cyan("  braingrid init --force")
+        };
+      }
+    }
     return {
       success: false,
       error: chalk13.red("\u274C No project specified and no local project found.") + "\n\n" + chalk13.dim("To initialize this workspace, run:\n") + chalk13.cyan("  braingrid init") + "\n\n" + chalk13.dim("Or specify a project explicitly:\n") + chalk13.cyan("  braingrid <command> -p PROJ-123")