kenzoboard 0.1.2 → 0.1.3

package/dist/index.js

@@ -4114,15 +4114,22 @@ async function serveCommand(args, flags, options = {}) {
     app.get("/", (c) => c.text("Web UI not found. API available at /api/*"));
   }
   const url = `http://localhost:${port}`;
-  console.log(`Starting Kenzo on ${url}`);
-  console.log(`Data file: ${dataFile}`);
-  if (webDistPath) {
-    console.log(`Web UI: ${webDistPath}`);
+  if (options.compact) {
+    console.log("");
+    console.log(`Kenzo is running at ${url}`);
   } else {
-    console.log("Web UI: not found (API only mode)");
+    console.log(`Starting Kenzo on ${url}`);
+    console.log(`Data file: ${dataFile}`);
+    if (webDistPath) {
+      console.log(`Web UI: ${webDistPath}`);
+    } else {
+      console.log("Web UI: not found (API only mode)");
+    }
   }
   if (options.open || flags.open === true) {
-    console.log(`Opening ${url}`);
+    if (!options.compact) {
+      console.log(`Opening ${url}`);
+    }
     openBrowser(url);
   }
   console.log("");
@@ -4539,20 +4546,24 @@ function ensureFluxIgnored() {
 ` : "";
     appendFileSync(gitignorePath, `${newline}${gitignoreEntry}
 `);
-    console.log(`Added .flux/ to ${gitRoot ? gitignorePath : ".gitignore"}`);
+    return true;
   }
+  return false;
 }
 async function ensureKenzoWorkspace() {
   const fluxDir = process.env.FLUX_DIR || resolve4(process.cwd(), ".flux");
   const configPath = resolve4(fluxDir, "config.json");
   const jsonPath = resolve4(fluxDir, "data.json");
   const sqlitePath = resolve4(fluxDir, "data.sqlite");
+  let createdWorkspace = false;
+  let createdProject = false;
+  let gitignoreUpdated = false;
   if (!existsSync7(fluxDir)) {
     mkdirSync3(fluxDir, { recursive: true });
     writeConfig(fluxDir, {});
     writeFileSync5(jsonPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
-    ensureFluxIgnored();
-    console.log(`Created local Kenzo workspace at ${fluxDir}`);
+    gitignoreUpdated = ensureFluxIgnored();
+    createdWorkspace = true;
   } else if (!existsSync7(configPath)) {
     writeConfig(fluxDir, {});
   }
@@ -4572,7 +4583,7 @@ async function ensureKenzoWorkspace() {
     const nextConfig = readConfigRaw(fluxDir);
     nextConfig.project = project.id;
     writeConfig(fluxDir, nextConfig);
-    console.log(`Created first project: ${project.name} (${project.id})`);
+    createdProject = true;
   } else if (!projectId || !projects.some((project) => project.id === projectId)) {
     const project = projects[0];
     projectId = project.id;
@@ -4580,29 +4591,58 @@ async function ensureKenzoWorkspace() {
     const nextConfig = readConfigRaw(fluxDir);
     nextConfig.project = project.id;
     writeConfig(fluxDir, nextConfig);
-    console.log(`Using project: ${project.name} (${project.id})`);
   }
-  return { projectId, projectName };
+  return { fluxDir, projectId, projectName, createdWorkspace, createdProject, gitignoreUpdated };
 }
-function printMcpSetup(command = publicCommandName()) {
-  const npxMcpCommand = "npx -y --package kenzoboard kenzoboard-mcp";
+function codexCliCommand() {
+  const macAppCli = "/Applications/Codex.app/Contents/Resources/codex";
+  return process.platform === "darwin" && existsSync7(macAppCli) ? macAppCli : "codex";
+}
+function quoteShell(value) {
+  return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
+function mcpPackageCommand() {
+  const localMcpPath = resolve4(process.cwd(), "packages/mcp/dist/index.js");
+  return existsSync7(localMcpPath) ? `bun ${quoteShell(localMcpPath)}` : "npx -y --package kenzoboard kenzoboard-mcp";
+}
+function codexMcpCommand(fluxDir) {
+  return `${codexCliCommand()} mcp add flux --env FLUX_DIR=${quoteShell(fluxDir)} -- ${mcpPackageCommand()}`;
+}
+function claudeMcpCommand(fluxDir) {
+  return `claude mcp add flux --env FLUX_DIR=${quoteShell(fluxDir)} -- ${mcpPackageCommand()}`;
+}
+function printLaunchSummary(workspace, command = publicCommandName()) {
+  const projectLabel = workspace.projectName && workspace.projectId ? `${workspace.projectName} (${workspace.projectId})` : "No project selected";
+  console.log(`${c2.green}${c2.bold}Kenzo is ready.${c2.reset}`);
+  console.log(`Project: ${projectLabel}`);
+  if (workspace.createdWorkspace || workspace.createdProject || workspace.gitignoreUpdated) {
+    const details = [
+      workspace.createdWorkspace ? "local workspace" : undefined,
+      workspace.createdProject ? "first project" : undefined,
+      workspace.gitignoreUpdated ? ".flux/ in .gitignore" : undefined
+    ].filter(Boolean).join(", ");
+    console.log(`${c2.dim}Set up ${details}.${c2.reset}`);
+  }
+  console.log("");
+  console.log(`${c2.bold}Connect Codex:${c2.reset}`);
+  console.log(`  ${codexMcpCommand(workspace.fluxDir)}`);
+  console.log("");
+  console.log(`${c2.bold}Then ask Codex:${c2.reset}`);
+  console.log("  Pick the next ready Kenzo task, implement it, and mark it done.");
+  console.log("");
+  console.log(`CLI fallback: ${c2.cyan}${command} ready${c2.reset}`);
+  console.log(`More setup:   ${c2.cyan}${command} mcp${c2.reset}`);
+}
+function printMcpSetup(command = publicCommandName(), fluxDir = findFluxDir()) {
   const installedMcpCommand = "kenzoboard-mcp";
   const dockerCommand = 'docker run -i --rm -v "$(pwd)/.flux:/app/packages/data" -e FLUX_DATA=/app/packages/data/flux.sqlite flux-mcp bun packages/mcp/dist/index.js';
-  const localMcpPath = resolve4(process.cwd(), "packages/mcp/dist/index.js");
-  console.log(`${c2.bold}Agent setup${c2.reset} ${c2.dim}(MCP resources remain flux:// for compatibility)${c2.reset}
+  console.log(`${c2.bold}Agent setup${c2.reset} ${c2.dim}(MCP resources remain flux:// for compatibility)${c2.reset}`);
+  console.log(`${c2.dim}Using Kenzo workspace: ${fluxDir}${c2.reset}
 `);
   console.log(`${c2.bold}Codex:${c2.reset}`);
-  if (existsSync7(localMcpPath)) {
-    console.log(`  codex mcp add flux -- bun ${localMcpPath}`);
-  } else {
-    console.log(`  codex mcp add flux -- ${npxMcpCommand}`);
-  }
+  console.log(`  ${codexMcpCommand(fluxDir)}`);
   console.log(`${c2.bold}Claude Code:${c2.reset}`);
-  if (existsSync7(localMcpPath)) {
-    console.log(`  claude mcp add flux -- bun ${localMcpPath}`);
-  } else {
-    console.log(`  claude mcp add flux -- ${npxMcpCommand}`);
-  }
+  console.log(`  ${claudeMcpCommand(fluxDir)}`);
   console.log("");
   console.log(`${c2.bold}Global install:${c2.reset}`);
   console.log(`  ${installedMcpCommand}`);
@@ -4610,18 +4650,16 @@ function printMcpSetup(command = publicCommandName()) {
   console.log(`${c2.bold}Advanced Docker:${c2.reset}`);
   console.log(`  ${dockerCommand}`);
   console.log("");
-  console.log(`Run ${c2.cyan}${command} ready${c2.reset} to see agent-ready work.`);
+  console.log(`${c2.bold}Agent workflow:${c2.reset}`);
+  console.log(`  1. Run ${c2.cyan}${command} ready${c2.reset} or ask the MCP server for ready tasks.`);
+  console.log("  2. Start one task, implement it, add notes as needed, then mark it done.");
+  console.log("  3. If MCP is not connected yet, Codex can still use the CLI commands from AGENTS.md.");
 }
 async function launchKenzoApp() {
   const command = publicCommandName();
-  const { projectId, projectName } = await ensureKenzoWorkspace();
-  if (projectId && projectName) {
-    console.log(`Opening project: ${projectName} (${projectId})`);
-  }
-  console.log("");
-  console.log(`${c2.bold}Next step after Kenzo opens:${c2.reset}`);
-  printMcpSetup(command);
-  await serveCommand([], { port: String(defaultServePort()) }, { defaultPort: defaultServePort(), open: true });
+  const workspace = await ensureKenzoWorkspace();
+  printLaunchSummary(workspace, command);
+  await serveCommand([], { port: String(defaultServePort()) }, { defaultPort: defaultServePort(), open: true, compact: true });
 }
 var FLUX_INSTRUCTIONS = `<!-- FLUX:START -->
 ## Flux Task Management

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenzoboard",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Kenzo board for human-led AI work, powered by the Flux engine",
   "type": "module",
   "bin": {