letmecook 0.0.21 → 0.0.23

package/index.ts

@@ -1,50 +1,78 @@
 #!/usr/bin/env bun
 
+import { loadEnv } from "./src/env";
+
+// Load env files from ~/.letmecook/.env and ./.env
+loadEnv();
+
 import pkg from "./package.json";
-import { parseRepoSpec, type RepoSpec } from "./src/types";
-import {
-  listSessions,
-  getSession,
-  updateLastAccessed,
-  deleteAllSessions,
-  deleteSession,
-} from "./src/sessions";
-import { createRenderer, destroyRenderer } from "./src/ui/renderer";
-import { showNewSessionPrompt } from "./src/ui/new-session";
-import { showSessionList } from "./src/ui/list";
-import { showNukeConfirm } from "./src/ui/confirm-nuke";
-import { createNewSession, resumeSession } from "./src/flows";
 import { handleTUIMode } from "./src/tui-mode";
+import { handleCLIMode } from "./src/cli-mode";
+
+const block = (r: number, g: number, b: number): string => `\x1b[48;2;${r};${g};${b}m  \x1b[0m`;
 
 function printUsage(): void {
   console.log(`
 letmecook - Multi-repo workspace manager for AI coding sessions
 
 Usage:
-  letmecook                                    Launch interactive TUI (recommended)
+  letmecook                                    Launch interactive TUI (default)
   letmecook --tui                              Launch interactive TUI explicitly
-  letmecook <owner/repo> [owner/repo:branch...] Create or resume a session (CLI)
-  letmecook --list                             List all sessions
-  letmecook --resume <session-name>            Resume a session
-  letmecook --delete <session-name>            Delete a session
-  letmecook --nuke [--yes]                     Nuke everything
+  letmecook --cli <owner/repo> [...]           Create or resume a session (CLI mode)
+  letmecook --cli --list                       List all sessions
+  letmecook --cli --resume <session-name>      Resume a session
+  letmecook --cli --delete <session-name>      Delete a session
+  letmecook --cli --nuke [--yes]               Nuke everything
   letmecook --why                              Show why this tool exists
   letmecook --help                             Show this help
   letmecook --version                          Show version
 
 Examples:
-  # Interactive mode (new - recommended)
+  # Interactive mode (default, recommended)
   letmecook
 
-  # CLI mode
-  letmecook microsoft/playwright
-  letmecook facebook/react openai/agents
-  letmecook --resume playwright-agent-tests
+  # CLI mode (requires --cli prefix)
+  letmecook --cli microsoft/playwright
+  letmecook --cli facebook/react openai/agents
+  letmecook --cli --resume playwright-agent-tests
   `);
 }
 
 function printWhy(): void {
+  const palette: Record<string, string> = {
+    ".": "  ",
+    s: block(200, 200, 200), // steam
+    d: block(88, 62, 52), // dark brown
+    l: block(121, 85, 72), // light brown (crust)
+    r: block(214, 64, 36), // red (pepperoni)
+    o: block(245, 124, 0), // orange
+    y: block(255, 193, 7), // yellow (cheese)
+    Y: block(255, 220, 80), // bright yellow (cheese highlight)
+    g: block(76, 175, 80), // green (basil)
+    k: block(20, 20, 20), // black (nori)
+    w: block(236, 236, 236), // white (rice)
+    b: block(79, 118, 170), // blue (fish)
+  };
+  const arts = [
+    // Pizza slice (7x7)
+    ["..yy...", ".yyyy..", ".yryry.", "yyyyyyy", "yygyrry", "lllllll", "ddddddd"],
+    // Burger (7x7)
+    [".yyyyy.", "ggggggg", "rrrrrrr", "ddddddd", "ggggggg", "ooooooo", ".yyyyy."],
+    // Fried egg (7x7)
+    ["..www..", ".wwwww.", "wwwyyww", "wwyyyyw", "wwwyyww", ".wwwww.", "..www.."],
+  ];
+  const artRows = arts[Math.floor(Math.random() * arts.length)]!;
+  const art = artRows
+    .map((row) =>
+      row
+        .split("")
+        .map((cell) => palette[cell] ?? "  ")
+        .join(""),
+    )
+    .join("\n");
   console.log(`
+${art}
+
 Your dev folder is full of traps: outdated code, abandoned experiments, naming
 collisions that send agents down rabbit holes until they hit context limits.
 
@@ -54,257 +82,63 @@ Agents are good at problem-solving when you give them what they need and let the
   `);
 }
 
-async function handleNewSessionCLI(repos: RepoSpec[]): Promise<void> {
-  const renderer = await createRenderer();
-
-  try {
-    const { goal, cancelled } = await showNewSessionPrompt(renderer, repos);
-
-    if (cancelled) {
-      destroyRenderer();
-      console.log("\nCancelled.");
-      return;
-    }
-
-    const result = await createNewSession(renderer, {
-      repos,
-      goal,
-      mode: "cli",
-    });
-
-    if (!result) {
-      destroyRenderer();
-      console.log("\nCancelled.");
-      return;
-    }
-
-    const { session, skipped } = result;
-
-    if (skipped) {
-      destroyRenderer();
-      console.log(`\nResuming existing session: ${session.name}\n`);
-      await resumeSession(renderer, {
-        session,
-        mode: "cli",
-        initialRefresh: true,
-      });
-      return;
-    }
-
-    destroyRenderer();
-    console.log(`\nSession created: ${session.name}`);
-    console.log(`Path: ${session.path}\n`);
-
-    await resumeSession(renderer, {
-      session,
-      mode: "cli",
-      initialRefresh: false,
-    });
-  } catch (error) {
-    destroyRenderer();
-    console.error("\nError:", error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-
-async function handleList(): Promise<void> {
-  const renderer = await createRenderer();
-
-  try {
-    while (true) {
-      const sessions = await listSessions();
-      const action = await showSessionList(renderer, sessions);
-
-      switch (action.type) {
-        case "resume":
-          destroyRenderer();
-          await updateLastAccessed(action.session.name);
-          console.log(`\nResuming session: ${action.session.name}\n`);
-          await resumeSession(renderer, {
-            session: action.session,
-            mode: "cli",
-            initialRefresh: true,
-          });
-          return;
-
-        case "delete":
-          console.log("[TODO] Delete session flow");
-          break;
-
-        case "nuke": {
-          const choice = await showNukeConfirm(renderer, sessions.length);
-          if (choice === "confirm") {
-            const count = await deleteAllSessions();
-            destroyRenderer();
-            console.log(`\nNuked ${count} session(s) and all data.`);
-            return;
-          }
-          break;
-        }
-
-        case "quit":
-          destroyRenderer();
-          return;
-      }
-    }
-  } catch (error) {
-    destroyRenderer();
-    console.error("\nError:", error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-
-async function handleResume(sessionName: string): Promise<void> {
-  const session = await getSession(sessionName);
-
-  if (!session) {
-    console.error(`Session not found: ${sessionName}`);
-    console.log("\nAvailable sessions:");
-    const sessions = await listSessions();
-    if (sessions.length === 0) {
-      console.log("  (none)");
-    } else {
-      sessions.forEach((s) => console.log(`  - ${s.name}`));
-    }
-    process.exit(1);
-  }
-
-  await updateLastAccessed(session.name);
-  console.log(`\nResuming session: ${session.name}\n`);
-
-  const renderer = await createRenderer();
-  await resumeSession(renderer, {
-    session,
-    mode: "cli",
-    initialRefresh: true,
-  });
-}
-
-async function handleDelete(sessionName: string): Promise<void> {
-  const session = await getSession(sessionName);
-
-  if (!session) {
-    console.error(`Session not found: ${sessionName}`);
-    const sessions = await listSessions();
-    if (sessions.length > 0) {
-      console.log("\nAvailable sessions:");
-      sessions.forEach((s) => console.log(`  - ${s.name}`));
-    }
-    process.exit(1);
-  }
-
-  const deleted = await deleteSession(sessionName);
-  if (deleted) {
-    console.log(`Deleted session: ${sessionName}`);
-  } else {
-    console.error(`Failed to delete session: ${sessionName}`);
-    process.exit(1);
-  }
-}
-
-async function handleNuke(skipConfirm = false): Promise<void> {
-  const sessions = await listSessions();
-  if (sessions.length === 0) {
-    console.log("Nothing to nuke.");
-    return;
-  }
-
-  // Skip confirmation if --yes flag or non-interactive (piped input)
-  if (skipConfirm || !process.stdin.isTTY) {
-    const count = await deleteAllSessions();
-    console.log(`Nuked ${count} session(s) and all data.`);
-    return;
-  }
-
-  const renderer = await createRenderer();
-  const choice = await showNukeConfirm(renderer, sessions.length);
-  destroyRenderer();
-
-  if (choice === "confirm") {
-    const count = await deleteAllSessions();
-    console.log(`Nuked ${count} session(s) and all data.`);
-  } else {
-    console.log("Cancelled.");
-  }
-}
-
-async function handleCLIMode(args: string[]): Promise<void> {
-  const firstArg = args[0];
-
-  if (firstArg === "--list" || firstArg === "-l") {
-    await handleList();
-  } else if (firstArg === "--resume" || firstArg === "-r") {
-    const sessionName = args[1];
-    if (!sessionName) {
-      console.error("Missing session name. Usage: letmecook --resume <session-name>");
-      process.exit(1);
-    }
-    await handleResume(sessionName);
-  } else if (firstArg === "--delete" || firstArg === "-d") {
-    const sessionName = args[1];
-    if (!sessionName) {
-      console.error("Missing session name. Usage: letmecook --delete <session-name>");
-      process.exit(1);
-    }
-    await handleDelete(sessionName);
-  } else if (firstArg === "--nuke") {
-    const hasYes = args.includes("--yes") || args.includes("-y");
-    await handleNuke(hasYes);
-  } else if (firstArg?.startsWith("-")) {
-    console.error(`Unknown option: ${firstArg}`);
-    printUsage();
-    process.exit(1);
-  } else {
-    try {
-      const repos = parseRepos(args);
-      await handleNewSessionCLI(repos);
-    } catch (error) {
-      console.error("Error:", error instanceof Error ? error.message : error);
-      process.exit(1);
-    }
-  }
-}
-
-function parseRepos(args: string[]): RepoSpec[] {
-  const repos: RepoSpec[] = [];
-
-  for (const arg of args) {
-    if (!arg || arg.startsWith("-")) continue;
-
-    if (!arg.includes("/")) {
-      throw new Error(`Invalid repo format: ${arg} (expected owner/repo)`);
-    }
-
-    const repo = parseRepoSpec(arg);
-    repos.push(repo);
-  }
-
-  return repos;
-}
-
 console.clear();
 const args = process.argv.slice(2);
 const firstArg = args[0];
 
+// Version flag
 if (firstArg === "--version" || firstArg === "-v") {
   console.log(`letmecook v${pkg.version}`);
   process.exit(0);
 }
 
+// Why flag
 if (firstArg === "--why") {
   printWhy();
   process.exit(0);
 }
 
-if (args.length === 0 || firstArg === "--help" || firstArg === "-h") {
+// Help flag
+if (firstArg === "--help" || firstArg === "-h") {
   printUsage();
   process.exit(0);
 }
 
+// CLI mode with --cli prefix
+if (firstArg === "--cli") {
+  const cliArgs = args.slice(1);
+  await handleCLIMode(cliArgs);
+  process.exit(0);
+}
+
+// Explicit TUI mode
 if (firstArg === "--tui") {
   await handleTUIMode();
-} else if (args.length === 0) {
+  process.exit(0);
+}
+
+// Default: TUI mode (no args)
+if (args.length === 0) {
   await handleTUIMode();
-} else {
-  await handleCLIMode(args);
+  process.exit(0);
+}
+
+// Catch bare repo args without --cli prefix
+if (firstArg && !firstArg.startsWith("-") && firstArg.includes("/")) {
+  console.error(`Error: Repo arguments require --cli prefix.`);
+  console.log(`\nUsage: letmecook --cli ${args.join(" ")}`);
+  console.log(`\nOr launch the interactive TUI: letmecook`);
+  process.exit(1);
 }
+
+// Unknown flag
+if (firstArg?.startsWith("-")) {
+  console.error(`Unknown option: ${firstArg}`);
+  printUsage();
+  process.exit(1);
+}
+
+// Unknown positional argument that's not a repo
+console.error(`Unknown argument: ${firstArg}`);
+printUsage();
+process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letmecook",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "repository": {
     "type": "git",
     "url": "https://github.com/rustydotwtf/letmecook.git"
@@ -28,13 +28,18 @@
     "format:check": "oxfmt --check .",
     "check": "bun run typecheck && bun run lint && bun run format:check",
     "fix": "bun run lint:fix && bun run format",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "test:tui": "bun test tests/tui",
     "docs": "cd docs && bun start",
     "docs:build": "cd docs && bun run build",
     "docs:serve": "cd docs && bun run serve"
   },
   "dependencies": {
     "@opentui/core": "^0.1.63",
-    "ai": "^6.0.3"
+    "ai": "^6.0.3",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/agents-md.ts

@@ -11,19 +11,19 @@ export function generateAgentsMd(session: Session): string {
     minute: "2-digit",
   });
 
-  const hasReferenceRepos = session.repos.some((repo) => repo.reference);
+  const hasReadOnlyRepos = session.repos.some((repo) => repo.readOnly);
   const hasSkills = session.skills && session.skills.length > 0;
 
   const repoRows = session.repos
     .map((repo) => {
       const branch = repo.branch || "default";
       const url = `https://github.com/${repo.owner}/${repo.name}`;
-      const referenceStatus = repo.reference ? "**YES**" : "no";
-      return `| \`${repo.dir}/\` | [${repo.owner}/${repo.name}](${url}) | ${branch} | ${referenceStatus} |`;
+      const readOnlyStatus = repo.readOnly ? "**YES**" : "no";
+      return `| \`${repo.dir}/\` | [${repo.owner}/${repo.name}](${url}) | ${branch} | ${readOnlyStatus} |`;
     })
     .join("\n");
 
-  const referenceRepos = session.repos.filter((repo) => repo.reference);
+  const readOnlyRepos = session.repos.filter((repo) => repo.readOnly);
 
   const skillsSection = hasSkills
     ? `
@@ -37,24 +37,21 @@ These skills are available for use in this session and are automatically updated
 `
     : "";
 
-  const referenceWarning = hasReferenceRepos
+  const readOnlyWarning = hasReadOnlyRepos
     ? `
-## ⚠️ Reference Repositories
+## ⚠️ Read-Only Repositories
 
-**WARNING: The following repositories are REFERENCES (symlinked from shared cache):**
+**WARNING: The following repositories are marked as READ-ONLY:**
 
-${referenceRepos.map((repo) => `- \`${repo.dir}/\` (${repo.owner}/${repo.name})`).join("\n")}
+${readOnlyRepos.map((repo) => `- \`${repo.dir}/\` (${repo.owner}/${repo.name})`).join("\n")}
 
 **AI agents must NOT:**
 - Create, modify, or delete any files in these directories
 - Make commits affecting these repositories
 - Use bash commands to circumvent file permissions
 
-**Why are these references?**
-- These directories are **symlinks** to a shared cache (~/.letmecook/references/)
-- Any modifications would affect ALL sessions using this repository
-- They are automatically refreshed to latest before each session resume
-- They are included for reference only - the user wants to read and understand the code without risk of accidental modifications
+**Why are these read-only?**
+These repositories are included for reference only. The user wants to read and understand the code without risk of accidental modifications.
 `
     : "";
 
@@ -66,10 +63,10 @@ ${session.goal ? `> ${session.goal}\n` : ""}
 
 ## Repositories
 
-| Directory | Repository | Branch | Reference |
+| Directory | Repository | Branch | Read-Only |
 |-----------|------------|--------|-----------|
 ${repoRows}
-${referenceWarning}
+${readOnlyWarning}
 ${skillsSection}
 ## Important Notes