kenzoboard 0.1.1 → 0.1.3

package/dist/index.js

@@ -1,5 +1,4 @@
-#!/usr/bin/env bun
-// @bun
+#!/usr/bin/env node
 import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -29,146 +28,65 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// ../shared/dist/adapters/sqlite-adapter.js
-var exports_sqlite_adapter = {};
-__export(exports_sqlite_adapter, {
-  createSqliteAdapter: () => createSqliteAdapter
-});
-import { Database } from "bun:sqlite";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
-import { dirname as dirname2 } from "path";
-function createSqliteAdapter(filePath) {
-  const dir = dirname2(filePath);
-  if (!existsSync2(dir)) {
-    mkdirSync2(dir, { recursive: true });
-  }
-  const db2 = new Database(filePath, { create: true });
-  db2.exec("PRAGMA journal_mode = WAL");
-  db2.exec("CREATE TABLE IF NOT EXISTS store (id INTEGER PRIMARY KEY CHECK (id = 1), data TEXT NOT NULL)");
-  const selectStmt = db2.prepare("SELECT data FROM store WHERE id = 1");
-  const insertStmt = db2.prepare("INSERT INTO store (id, data) VALUES (1, ?)");
-  const updateStmt = db2.prepare("UPDATE store SET data = ? WHERE id = 1");
-  let _data = { ...defaultData2 };
-  const readFromDb = () => {
-    const row = selectStmt.get();
-    if (row?.data) {
-      try {
-        return JSON.parse(row.data);
-      } catch {
-        return { ...defaultData2 };
-      }
-    }
-    return { ...defaultData2 };
-  };
-  return {
-    get data() {
-      return _data;
-    },
-    read() {
-      _data = readFromDb();
-      if (!selectStmt.get()) {
-        insertStmt.run(JSON.stringify(_data));
-      }
-    },
-    write() {
-      db2.transaction(() => {
-        const current = readFromDb();
-        const merged = {
-          projects: mergeById(current.projects, _data.projects),
-          epics: mergeById(current.epics, _data.epics),
-          tasks: mergeById(current.tasks, _data.tasks),
-          blobs: mergeById(current.blobs || [], _data.blobs || [])
-        };
-        const serialized = JSON.stringify(merged);
-        const row = selectStmt.get();
-        if (row) {
-          updateStmt.run(serialized);
-        } else {
-          insertStmt.run(serialized);
-        }
-        _data = merged;
-      })();
-    }
-  };
-}
-function mergeById(current, updated) {
-  const result = new Map;
-  for (const item of current) {
-    result.set(item.id, item);
-  }
-  for (const item of updated) {
-    result.set(item.id, item);
-  }
-  return Array.from(result.values());
-}
-var defaultData2;
-var init_sqlite_adapter = __esm(() => {
-  defaultData2 = {
-    projects: [],
-    epics: [],
-    tasks: []
-  };
-});
-
 // ../shared/dist/blob-storage.js
 var exports_blob_storage = {};
 __export(exports_blob_storage, {
-  setBlobStorage: () => setBlobStorage2,
+  setBlobStorage: () => setBlobStorage,
   getBlobStorage: () => getBlobStorage,
-  createFilesystemBlobStorage: () => createFilesystemBlobStorage2
+  createFilesystemBlobStorage: () => createFilesystemBlobStorage
 });
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4, unlinkSync as unlinkSync2 } from "fs";
-import { join as join2 } from "path";
-import { createHash as createHash2 } from "crypto";
-function blobPath2(blobsDir, hash) {
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync } from "fs";
+import { join } from "path";
+import { createHash } from "crypto";
+function blobPath(blobsDir, hash) {
   const prefix = hash.slice(0, 2);
-  return join2(blobsDir, prefix, hash);
+  return join(blobsDir, prefix, hash);
 }
-function createFilesystemBlobStorage2(blobsDir) {
-  mkdirSync4(blobsDir, { recursive: true });
+function createFilesystemBlobStorage(blobsDir) {
+  mkdirSync2(blobsDir, { recursive: true });
   return {
     write(content) {
-      const hash = createHash2("sha256").update(content).digest("hex");
+      const hash = createHash("sha256").update(content).digest("hex");
       const size = content.length;
-      const filePath = blobPath2(blobsDir, hash);
-      if (!existsSync5(filePath)) {
-        const prefixDir = join2(blobsDir, hash.slice(0, 2));
-        mkdirSync4(prefixDir, { recursive: true });
-        writeFileSync4(filePath, content);
+      const filePath = blobPath(blobsDir, hash);
+      if (!existsSync2(filePath)) {
+        const prefixDir = join(blobsDir, hash.slice(0, 2));
+        mkdirSync2(prefixDir, { recursive: true });
+        writeFileSync2(filePath, content);
       }
       return { hash, size };
     },
     read(hash) {
-      const filePath = blobPath2(blobsDir, hash);
-      if (!existsSync5(filePath))
+      const filePath = blobPath(blobsDir, hash);
+      if (!existsSync2(filePath))
         return null;
-      return readFileSync4(filePath);
+      return readFileSync2(filePath);
     },
     exists(hash) {
-      return existsSync5(blobPath2(blobsDir, hash));
+      return existsSync2(blobPath(blobsDir, hash));
     },
     remove(hash) {
-      const filePath = blobPath2(blobsDir, hash);
-      if (!existsSync5(filePath))
+      const filePath = blobPath(blobsDir, hash);
+      if (!existsSync2(filePath))
         return false;
-      unlinkSync2(filePath);
+      unlinkSync(filePath);
       return true;
     }
   };
 }
-function setBlobStorage2(bs) {
-  blobStorage2 = bs;
+function setBlobStorage(bs) {
+  blobStorage = bs;
 }
 function getBlobStorage() {
-  return blobStorage2;
+  return blobStorage;
 }
-var blobStorage2 = null;
+var blobStorage = null;
 var init_blob_storage = () => {};
 
 // src/index.ts
-import { resolve as resolve4, dirname as dirname5, basename as basename2 } from "path";
+import { resolve as resolve4, dirname as dirname4, basename as basename2 } from "path";
 import { execSync } from "child_process";
-import { existsSync as existsSync9, readFileSync as readFileSync7, writeFileSync as writeFileSync6, mkdirSync as mkdirSync5, appendFileSync, cpSync, realpathSync } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync5, mkdirSync as mkdirSync3, appendFileSync, cpSync, realpathSync } from "fs";
 import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
 import { createInterface } from "readline";
 
@@ -680,11 +598,14 @@ function createJsonAdapter(filePath) {
 
 // ../shared/dist/adapters/index.js
 var _createSqliteAdapter;
-try {
-  const mod = await Promise.resolve().then(() => (init_sqlite_adapter(), exports_sqlite_adapter));
-  _createSqliteAdapter = mod.createSqliteAdapter;
-} catch {}
-function createSqliteAdapter2(filePath) {
+if ("Bun" in globalThis) {
+  try {
+    const runtimeImport = new Function("specifier", "return import(specifier)");
+    const mod = await runtimeImport("./sqlite-adapter.js");
+    _createSqliteAdapter = mod.createSqliteAdapter;
+  } catch {}
+}
+function createSqliteAdapter(filePath) {
   if (!_createSqliteAdapter) {
     throw new Error("SQLite adapter requires Bun runtime");
   }
@@ -692,59 +613,17 @@ function createSqliteAdapter2(filePath) {
 }
 function createAdapter(filePath) {
   if (filePath.endsWith(".sqlite") || filePath.endsWith(".db")) {
-    return createSqliteAdapter2(filePath);
+    return createSqliteAdapter(filePath);
   }
   return createJsonAdapter(filePath);
 }
 
-// ../shared/dist/blob-storage.js
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync } from "fs";
-import { join } from "path";
-import { createHash } from "crypto";
-function blobPath(blobsDir, hash) {
-  const prefix = hash.slice(0, 2);
-  return join(blobsDir, prefix, hash);
-}
-function createFilesystemBlobStorage(blobsDir) {
-  mkdirSync3(blobsDir, { recursive: true });
-  return {
-    write(content) {
-      const hash = createHash("sha256").update(content).digest("hex");
-      const size = content.length;
-      const filePath = blobPath(blobsDir, hash);
-      if (!existsSync3(filePath)) {
-        const prefixDir = join(blobsDir, hash.slice(0, 2));
-        mkdirSync3(prefixDir, { recursive: true });
-        writeFileSync2(filePath, content);
-      }
-      return { hash, size };
-    },
-    read(hash) {
-      const filePath = blobPath(blobsDir, hash);
-      if (!existsSync3(filePath))
-        return null;
-      return readFileSync2(filePath);
-    },
-    exists(hash) {
-      return existsSync3(blobPath(blobsDir, hash));
-    },
-    remove(hash) {
-      const filePath = blobPath(blobsDir, hash);
-      if (!existsSync3(filePath))
-        return false;
-      unlinkSync(filePath);
-      return true;
-    }
-  };
-}
-var blobStorage = null;
-function setBlobStorage(bs) {
-  blobStorage = bs;
-}
+// src/index.ts
+init_blob_storage();
 
 // ../shared/dist/config.js
-import { resolve, dirname as dirname3 } from "path";
-import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3, chmodSync } from "fs";
+import { resolve, dirname as dirname2 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3, chmodSync } from "fs";
 function expandEnv(value) {
   if (!value?.startsWith("$"))
     return value;
@@ -755,20 +634,20 @@ function findFluxDir() {
     return process.env.FLUX_DIR;
   }
   let dir = process.cwd();
-  while (dirname3(dir) !== dir) {
+  while (dirname2(dir) !== dir) {
     const fluxDir = resolve(dir, ".flux");
-    if (existsSync4(fluxDir)) {
+    if (existsSync3(fluxDir)) {
       return fluxDir;
     }
-    dir = dirname3(dir);
+    dir = dirname2(dir);
   }
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
   return resolve(homeDir, ".flux");
 }
 function loadEnvLocal(fluxDir) {
-  const repoRoot = dirname3(fluxDir);
+  const repoRoot = dirname2(fluxDir);
   const envPath = resolve(repoRoot, ".env.local");
-  if (existsSync4(envPath)) {
+  if (existsSync3(envPath)) {
     const content = readFileSync3(envPath, "utf-8");
     for (const line of content.split(`
 `)) {
@@ -788,7 +667,7 @@ function loadEnvLocal(fluxDir) {
 }
 function readConfigRaw(fluxDir) {
   const configPath = resolve(fluxDir, "config.json");
-  if (existsSync4(configPath)) {
+  if (existsSync3(configPath)) {
     try {
       return JSON.parse(readFileSync3(configPath, "utf-8"));
     } catch {
@@ -2302,8 +2181,8 @@ var _baseMimes = {
 var baseMimes = _baseMimes;
 
 // ../../node_modules/.bun/@hono+node-server@1.19.8+fd698e00a3b2abce/node_modules/@hono/node-server/dist/serve-static.mjs
-import { createReadStream, statSync, existsSync as existsSync6 } from "fs";
-import { join as join3 } from "path";
+import { createReadStream, statSync, existsSync as existsSync4 } from "fs";
+import { join as join2 } from "path";
 import { versions } from "process";
 import { Readable as Readable2 } from "stream";
 var COMPRESSIBLE_CONTENT_TYPE_REGEX = /^\s*(?:text\/[^;\s]+|application\/(?:javascript|json|xml|xml-dtd|ecmascript|dart|postscript|rtf|tar|toml|vnd\.dart|vnd\.ms-fontobject|vnd\.ms-opentype|wasm|x-httpd-php|x-javascript|x-ns-proxy-autoconfig|x-sh|x-tar|x-virtualbox-hdd|x-virtualbox-ova|x-virtualbox-ovf|x-virtualbox-vbox|x-virtualbox-vdi|x-virtualbox-vhd|x-virtualbox-vmdk|x-www-form-urlencoded)|font\/(?:otf|ttf)|image\/(?:bmp|vnd\.adobe\.photoshop|vnd\.microsoft\.icon|vnd\.ms-dds|x-icon|x-ms-bmp)|message\/rfc822|model\/gltf-binary|x-shader\/x-fragment|x-shader\/x-vertex|[^;\s]+?\+(?:json|text|xml|yaml))(?:[;\s]|$)/i;
@@ -2350,7 +2229,7 @@ var getStats = (path) => {
 var serveStatic = (options = { root: "" }) => {
   const root = options.root || "";
   const optionPath = options.path;
-  if (root !== "" && !existsSync6(root)) {
+  if (root !== "" && !existsSync4(root)) {
     console.error(`serveStatic: root path '${root}' is not found, are you sure it's correct?`);
   }
   return async (c, next) => {
@@ -2371,11 +2250,11 @@ var serveStatic = (options = { root: "" }) => {
         return next();
       }
     }
-    let path = join3(root, !optionPath && options.rewriteRequestPath ? options.rewriteRequestPath(filename, c) : filename);
+    let path = join2(root, !optionPath && options.rewriteRequestPath ? options.rewriteRequestPath(filename, c) : filename);
     let stats = getStats(path);
     if (stats && stats.isDirectory()) {
       const indexFile = options.index ?? "index.html";
-      path = join3(path, indexFile);
+      path = join2(path, indexFile);
       stats = getStats(path);
     }
     if (!stats) {
@@ -4033,32 +3912,12 @@ var cors = (options) => {
 };
 
 // src/commands/serve.ts
-import { join as join4, dirname as dirname4, resolve as resolve2, sep } from "path";
+import { join as join3, dirname as dirname3, resolve as resolve2, sep } from "path";
 import { fileURLToPath } from "url";
-import { existsSync as existsSync7, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
 import { spawn } from "child_process";
-
-// ../shared/dist/adapters/index.js
-var _createSqliteAdapter2;
-try {
-  const mod = await Promise.resolve().then(() => (init_sqlite_adapter(), exports_sqlite_adapter));
-  _createSqliteAdapter2 = mod.createSqliteAdapter;
-} catch {}
-function createSqliteAdapter3(filePath) {
-  if (!_createSqliteAdapter2) {
-    throw new Error("SQLite adapter requires Bun runtime");
-  }
-  return _createSqliteAdapter2(filePath);
-}
-function createAdapter2(filePath) {
-  if (filePath.endsWith(".sqlite") || filePath.endsWith(".db")) {
-    return createSqliteAdapter3(filePath);
-  }
-  return createJsonAdapter(filePath);
-}
-
-// src/commands/serve.ts
-var __dirname2 = dirname4(fileURLToPath(import.meta.url));
+import { createServer } from "net";
+var __dirname2 = dirname3(fileURLToPath(import.meta.url));
 function openBrowser(url) {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
   const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
@@ -4177,8 +4036,7 @@ function createApp() {
 }
 function isPortAvailable(port) {
   return new Promise((resolve3) => {
-    const net = __require("net");
-    const server = net.createServer();
+    const server = createServer();
     server.once("error", () => resolve3(false));
     server.once("listening", () => {
       server.close();
@@ -4212,25 +4070,27 @@ async function serveCommand(args, flags, options = {}) {
     console.error(e.message);
     process.exit(1);
   }
-  const adapter = createAdapter2(dataFile);
+  const adapter = createAdapter(dataFile);
   setStorageAdapter(adapter);
   initStore();
   const app = createApp();
   const webDistPaths = [
-    join4(__dirname2, "../../../web/dist"),
-    join4(__dirname2, "../../web/dist"),
-    join4(process.cwd(), "packages/web/dist")
+    join3(__dirname2, "web"),
+    join3(__dirname2, "../web"),
+    join3(__dirname2, "../../../web/dist"),
+    join3(__dirname2, "../../web/dist"),
+    join3(process.cwd(), "packages/web/dist")
   ];
   let webDistPath = null;
   for (const p of webDistPaths) {
-    if (existsSync7(join4(p, "index.html"))) {
+    if (existsSync5(join3(p, "index.html"))) {
       webDistPath = p;
       break;
     }
   }
   app.all("/api/*", (c) => c.json({ error: "Not found" }, 404));
   if (webDistPath) {
-    const indexHtml = readFileSync5(join4(webDistPath, "index.html"), "utf-8");
+    const indexHtml = readFileSync4(join3(webDistPath, "index.html"), "utf-8");
     const staticHandler = serveStatic({ root: webDistPath });
     const staticExtensions = /\.(js|css|png|jpg|jpeg|gif|svg|ico|woff2?|ttf|eot|map|json|webp|webm|mp4|mp3|pdf)$/i;
     app.use("/*", async (c, next) => {
@@ -4239,11 +4099,11 @@ async function serveCommand(args, flags, options = {}) {
         return next();
       }
       if (staticExtensions.test(path)) {
-        const filePath = join4(webDistPath, path);
+        const filePath = join3(webDistPath, path);
         if (!filePath.startsWith(webDistPath + sep)) {
           return c.notFound();
         }
-        if (existsSync7(filePath) && statSync2(filePath).isFile()) {
+        if (existsSync5(filePath) && statSync2(filePath).isFile()) {
           return staticHandler(c, next);
         }
         return c.notFound();
@@ -4254,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("");
@@ -4494,11 +4361,11 @@ ${c.red}✗${c.reset} Auth timed out. Try again.`);
 }
 
 // src/commands/blob.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync8 } from "fs";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync6 } from "fs";
 import { basename, resolve as resolve3, extname } from "path";
 function guessMimeType(filename) {
   const ext = extname(filename).toLowerCase();
-  const types3 = {
+  const types2 = {
     ".png": "image/png",
     ".jpg": "image/jpeg",
     ".jpeg": "image/jpeg",
@@ -4528,7 +4395,7 @@ function guessMimeType(filename) {
     ".xls": "application/vnd.ms-excel",
     ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
   };
-  return types3[ext] || "application/octet-stream";
+  return types2[ext] || "application/octet-stream";
 }
 async function blobCommand(subcommand, args, flags, json) {
   switch (subcommand) {
@@ -4539,11 +4406,11 @@ async function blobCommand(subcommand, args, flags, json) {
         console.error("Usage: kenzoboard blob attach <task-id> <file-path>");
         process.exit(1);
       }
-      if (!existsSync8(filePath)) {
+      if (!existsSync6(filePath)) {
         console.error(`File not found: ${filePath}`);
         process.exit(1);
       }
-      const content = readFileSync6(filePath);
+      const content = readFileSync5(filePath);
       const filename = basename(filePath);
       const mime_type = guessMimeType(filename);
       const blob = await uploadBlob(Buffer.from(content), filename, mime_type, taskId);
@@ -4568,7 +4435,7 @@ async function blobCommand(subcommand, args, flags, json) {
         process.exit(1);
       }
       const destPath = outputPath || resolve3(process.cwd(), result.blob.filename);
-      writeFileSync5(destPath, result.content);
+      writeFileSync4(destPath, result.content);
       if (json) {
         output({ path: destPath, ...result.blob }, true);
       } else {
@@ -4626,6 +4493,7 @@ function formatSize(bytes) {
     return `${(bytes / 1024).toFixed(1)}KB`;
   return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
 }
+
 // src/index.ts
 var c2 = {
   reset: "\x1B[0m",
@@ -4649,7 +4517,7 @@ function prompt(question) {
 function isInteractive() {
   return process.stdin.isTTY === true;
 }
-var __dirname3 = dirname5(fileURLToPath2(import.meta.url));
+var __dirname3 = dirname4(fileURLToPath2(import.meta.url));
 function publicCommandName() {
   const invoked = basename2(process.argv[1] || "");
   return invoked === "flux" ? "flux" : "kenzoboard";
@@ -4666,22 +4534,11 @@ function isCliEntrypoint() {
 function defaultServePort() {
   return publicCommandName() === "flux" ? 3589 : 3000;
 }
-function findExistingFluxDirFromCwd() {
-  let dir = process.cwd();
-  while (dirname5(dir) !== dir) {
-    const fluxDir = resolve4(dir, ".flux");
-    if (existsSync9(fluxDir)) {
-      return fluxDir;
-    }
-    dir = dirname5(dir);
-  }
-  return null;
-}
 function ensureFluxIgnored() {
   const gitRoot = findGitRoot();
   const gitignorePath = gitRoot ? resolve4(gitRoot, ".gitignore") : resolve4(process.cwd(), ".gitignore");
   const gitignoreEntry = ".flux/";
-  let gitignoreContent = existsSync9(gitignorePath) ? readFileSync7(gitignorePath, "utf-8") : "";
+  let gitignoreContent = existsSync7(gitignorePath) ? readFileSync6(gitignorePath, "utf-8") : "";
   if (!gitignoreContent.split(`
 `).some((line) => line.trim() === gitignoreEntry)) {
     const newline = gitignoreContent.length > 0 && !gitignoreContent.endsWith(`
@@ -4689,26 +4546,30 @@ function ensureFluxIgnored() {
 ` : "";
     appendFileSync(gitignorePath, `${newline}${gitignoreEntry}
 `);
-    console.log(`Added .flux/ to ${gitRoot ? gitignorePath : ".gitignore"}`);
+    return true;
   }
+  return false;
 }
 async function ensureKenzoWorkspace() {
-  const fluxDir = findExistingFluxDirFromCwd() || resolve4(process.cwd(), ".flux");
+  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");
-  if (!existsSync9(fluxDir)) {
-    mkdirSync5(fluxDir, { recursive: true });
+  let createdWorkspace = false;
+  let createdProject = false;
+  let gitignoreUpdated = false;
+  if (!existsSync7(fluxDir)) {
+    mkdirSync3(fluxDir, { recursive: true });
     writeConfig(fluxDir, {});
-    writeFileSync6(jsonPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
-    ensureFluxIgnored();
-    console.log(`Created local Kenzo workspace at ${fluxDir}`);
-  } else if (!existsSync9(configPath)) {
+    writeFileSync5(jsonPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
+    gitignoreUpdated = ensureFluxIgnored();
+    createdWorkspace = true;
+  } else if (!existsSync7(configPath)) {
     writeConfig(fluxDir, {});
   }
   const config = readConfigRaw(fluxDir);
-  if (!config.server && !existsSync9(jsonPath) && !existsSync9(sqlitePath)) {
-    writeFileSync6(jsonPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
+  if (!config.server && !existsSync7(jsonPath) && !existsSync7(sqlitePath)) {
+    writeFileSync5(jsonPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
   }
   const storage = initStorage();
   const projects = await getProjects2();
@@ -4722,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;
@@ -4730,39 +4591,75 @@ 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 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';
+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");
-  console.log(`${c2.bold}Agent setup${c2.reset} ${c2.dim}(MCP resources remain flux:// for compatibility)${c2.reset}
-`);
-  if (existsSync9(localMcpPath)) {
-    console.log(`${c2.bold}Codex:${c2.reset}`);
-    console.log(`  codex mcp add flux -- bun ${localMcpPath}`);
-    console.log(`${c2.bold}Claude Code:${c2.reset}`);
-    console.log(`  claude mcp add flux -- bun ${localMcpPath}`);
-  } else {
-    console.log(`${c2.bold}Codex:${c2.reset}`);
-    console.log(`  codex mcp add flux -- ${dockerCommand}`);
-    console.log(`${c2.bold}Claude Code:${c2.reset}`);
-    console.log(`  claude mcp add flux -- ${dockerCommand}`);
+  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(`Run ${c2.cyan}${command} ready${c2.reset} to see agent-ready work.`);
+  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';
+  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}`);
+  console.log(`  ${codexMcpCommand(fluxDir)}`);
+  console.log(`${c2.bold}Claude Code:${c2.reset}`);
+  console.log(`  ${claudeMcpCommand(fluxDir)}`);
+  console.log("");
+  console.log(`${c2.bold}Global install:${c2.reset}`);
+  console.log(`  ${installedMcpCommand}`);
+  console.log("");
+  console.log(`${c2.bold}Advanced Docker:${c2.reset}`);
+  console.log(`  ${dockerCommand}`);
+  console.log("");
+  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
@@ -4788,7 +4685,7 @@ function updateAgentInstructions() {
   let targetFile = null;
   for (const name of candidates) {
     const path = resolve4(cwd, name);
-    if (existsSync9(path)) {
+    if (existsSync7(path)) {
       targetFile = path;
       break;
     }
@@ -4796,7 +4693,7 @@ function updateAgentInstructions() {
   if (!targetFile) {
     targetFile = resolve4(cwd, "AGENTS.md");
   }
-  let content = existsSync9(targetFile) ? readFileSync7(targetFile, "utf-8") : "";
+  let content = existsSync7(targetFile) ? readFileSync6(targetFile, "utf-8") : "";
   const startMarker = "<!-- FLUX:START -->";
   const endMarker = "<!-- FLUX:END -->";
   const startIdx = content.indexOf(startMarker);
@@ -4809,7 +4706,7 @@ function updateAgentInstructions() {
 ` + FLUX_INSTRUCTIONS + `
 `;
   }
-  writeFileSync6(targetFile, content.trimStart());
+  writeFileSync5(targetFile, content.trimStart());
   return targetFile;
 }
 function findGitRoot() {
@@ -4821,7 +4718,7 @@ function findGitRoot() {
 }
 function ensureWorktree(gitRoot) {
   const worktreePath = resolve4(gitRoot, ".git", "flux-worktree");
-  if (existsSync9(worktreePath)) {
+  if (existsSync7(worktreePath)) {
     return worktreePath;
   }
   const branchExists = ["flux-data", "origin/flux-data"].some((ref) => {
@@ -4875,7 +4772,7 @@ async function doctorCommand(flags) {
 `);
     return;
   }
-  const fluxDirExists = existsSync9(fluxDir);
+  const fluxDirExists = existsSync7(fluxDir);
   if (!fluxDirExists) {
     console.log(`${c2.yellow}!${c2.reset} .flux directory not found at ${fluxDir}`);
     console.log(`  Run ${c2.cyan}${publicCommandName()} init${c2.reset} to initialize
@@ -4884,7 +4781,7 @@ async function doctorCommand(flags) {
   }
   console.log(`${c2.green}OK${c2.reset} .flux directory: ${fluxDir}`);
   const configPath = resolve4(fluxDir, "config.json");
-  const configExists = existsSync9(configPath);
+  const configExists = existsSync7(configPath);
   if (configExists) {
     const config2 = readConfig(fluxDir);
     const mode = config2.server ? "server" : "local";
@@ -4896,8 +4793,8 @@ async function doctorCommand(flags) {
   }
   const jsonPath = resolve4(fluxDir, "data.json");
   const sqlitePath = resolve4(fluxDir, "data.sqlite");
-  const jsonExists = existsSync9(jsonPath);
-  const sqliteExists = existsSync9(sqlitePath);
+  const jsonExists = existsSync7(jsonPath);
+  const sqliteExists = existsSync7(sqlitePath);
   const countRecords = (path) => {
     try {
       const adapter = createAdapter(path);
@@ -4968,8 +4865,8 @@ ${c2.cyan}Merging ${otherFile} into ${configuredFile}...${c2.reset}`);
       console.log(`
 ${c2.dim}data.json is empty (likely created by old MCP/Server bug)${c2.reset}`);
       if (fix) {
-        const { unlinkSync: unlinkSync3 } = await import("fs");
-        unlinkSync3(jsonPath);
+        const { unlinkSync: unlinkSync2 } = await import("fs");
+        unlinkSync2(jsonPath);
         console.log(`${c2.green}OK${c2.reset} Removed empty data.json`);
         fixed++;
       } else {
@@ -4980,8 +4877,8 @@ ${c2.dim}data.json is empty (likely created by old MCP/Server bug)${c2.reset}`);
       console.log(`
 ${c2.dim}data.sqlite is empty${c2.reset}`);
       if (fix) {
-        const { unlinkSync: unlinkSync3 } = await import("fs");
-        unlinkSync3(sqlitePath);
+        const { unlinkSync: unlinkSync2 } = await import("fs");
+        unlinkSync2(sqlitePath);
         console.log(`${c2.green}OK${c2.reset} Removed empty data.sqlite`);
         fixed++;
       } else {
@@ -5073,14 +4970,14 @@ async function main() {
     const dataFileName = useSqlite ? "data.sqlite" : "data.json";
     const dataPath = resolve4(fluxDir, dataFileName);
     const configPath = resolve4(fluxDir, "config.json");
-    const isNew = !existsSync9(resolve4(fluxDir, "data.json")) && !existsSync9(resolve4(fluxDir, "data.sqlite"));
-    mkdirSync5(fluxDir, { recursive: true });
+    const isNew = !existsSync7(resolve4(fluxDir, "data.json")) && !existsSync7(resolve4(fluxDir, "data.sqlite"));
+    mkdirSync3(fluxDir, { recursive: true });
     let serverUrl2 = parsed.flags.server;
     let apiKey2 = parsed.flags["api-key"];
     const useGit = parsed.flags.git === true;
-    if (existsSync9(configPath)) {
+    if (existsSync7(configPath)) {
       try {
-        const existing = JSON.parse(readFileSync7(configPath, "utf-8"));
+        const existing = JSON.parse(readFileSync6(configPath, "utf-8"));
         const warnings = [];
         if (existing.server && (useGit || parsed.flags.sqlite)) {
           warnings.push(`Repo uses server mode (${existing.server}), you're setting up git mode`);
@@ -5150,7 +5047,7 @@ Overwrite existing config? [y/N]: `);
     const gitRoot = findGitRoot();
     const gitignorePath = gitRoot ? resolve4(gitRoot, ".gitignore") : resolve4(process.cwd(), ".gitignore");
     const gitignoreEntry = ".flux/";
-    let gitignoreContent = existsSync9(gitignorePath) ? readFileSync7(gitignorePath, "utf-8") : "";
+    let gitignoreContent = existsSync7(gitignorePath) ? readFileSync6(gitignorePath, "utf-8") : "";
     if (!gitignoreContent.split(`
 `).some((line) => line.trim() === gitignoreEntry)) {
       const newline = gitignoreContent.length > 0 && !gitignoreContent.endsWith(`
@@ -5160,13 +5057,13 @@ Overwrite existing config? [y/N]: `);
 `);
       console.log(`Added .flux/ to ${gitRoot ? gitignorePath : ".gitignore"}`);
     }
-    if (!serverUrl2 && !existsSync9(dataPath)) {
+    if (!serverUrl2 && !existsSync7(dataPath)) {
       if (useSqlite) {
         const adapter = createAdapter(dataPath);
         setStorageAdapter(adapter);
         initStore();
       } else {
-        writeFileSync6(dataPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
+        writeFileSync5(dataPath, JSON.stringify({ projects: [], epics: [], tasks: [] }, null, 2));
       }
     }
     if (isNew) {
@@ -5268,15 +5165,15 @@ Select a project:`);
         const localBlobs = resolve4(fluxDir, "blobs");
         execSync("git fetch origin flux-data", { stdio: "pipe", cwd: worktree });
         execSync("git reset --hard origin/flux-data", { stdio: "pipe", cwd: worktree });
-        if (existsSync9(worktreeData)) {
-          mkdirSync5(fluxDir, { recursive: true });
-          writeFileSync6(dataPath, readFileSync7(worktreeData, "utf-8"));
+        if (existsSync7(worktreeData)) {
+          mkdirSync3(fluxDir, { recursive: true });
+          writeFileSync5(dataPath, readFileSync6(worktreeData, "utf-8"));
           console.log("Pulled latest tasks from flux-data branch");
         } else {
           console.log("No .flux/data.json in flux-data branch yet");
         }
-        if (existsSync9(worktreeBlobs)) {
-          mkdirSync5(localBlobs, { recursive: true });
+        if (existsSync7(worktreeBlobs)) {
+          mkdirSync3(localBlobs, { recursive: true });
           cpSync(worktreeBlobs, localBlobs, { recursive: true });
           console.log("Pulled blobs from flux-data branch");
         }
@@ -5286,7 +5183,7 @@ Select a project:`);
       }
     } else {
       const msg = parsed.subcommand || "update tasks";
-      if (!existsSync9(dataPath)) {
+      if (!existsSync7(dataPath)) {
         console.error(`No .flux/data.json found. Run: ${publicCommandName()} init`);
         process.exit(1);
       }
@@ -5296,14 +5193,14 @@ Select a project:`);
         const worktreeData = resolve4(worktreeFlux, "data.json");
         const localBlobs = resolve4(fluxDir, "blobs");
         const worktreeBlobs = resolve4(worktreeFlux, "blobs");
-        mkdirSync5(worktreeFlux, { recursive: true });
-        writeFileSync6(worktreeData, readFileSync7(dataPath, "utf-8"));
-        if (existsSync9(localBlobs)) {
-          mkdirSync5(worktreeBlobs, { recursive: true });
+        mkdirSync3(worktreeFlux, { recursive: true });
+        writeFileSync5(worktreeData, readFileSync6(dataPath, "utf-8"));
+        if (existsSync7(localBlobs)) {
+          mkdirSync3(worktreeBlobs, { recursive: true });
           cpSync(localBlobs, worktreeBlobs, { recursive: true });
         }
         execSync("git add .flux/data.json", { stdio: "pipe", cwd: worktree });
-        if (existsSync9(worktreeBlobs)) {
+        if (existsSync7(worktreeBlobs)) {
           execSync("git add .flux/blobs", { stdio: "pipe", cwd: worktree });
         }
         try {
@@ -5338,7 +5235,7 @@ Select a project:`);
   if (parsed.command === "prime") {
     const fluxDir = findFluxDir();
     const configPath = resolve4(fluxDir, "config.json");
-    if (!existsSync9(configPath)) {
+    if (!existsSync7(configPath)) {
       return;
     }
     try {
@@ -5382,7 +5279,7 @@ Select a project:`);
       const output2 = JSON.stringify(data, null, 2);
       const outFile = parsed.flags.o || parsed.flags.output;
       if (outFile) {
-        writeFileSync6(outFile, output2);
+        writeFileSync5(outFile, output2);
         console.log(`Exported to ${outFile}`);
       } else {
         console.log(output2);
@@ -5403,11 +5300,11 @@ Select a project:`);
         }
         content = Buffer.concat(chunks).toString("utf-8");
       } else {
-        if (!existsSync9(file)) {
+        if (!existsSync7(file)) {
           console.error(`File not found: ${file}`);
           process.exit(1);
         }
-        content = readFileSync7(file, "utf-8");
+        content = readFileSync6(file, "utf-8");
       }
       const data = JSON.parse(content);
       const merge = parsed.flags.merge === true;