prloom 0.1.1 → 0.1.3

package/dist/cli/index.js

@@ -7238,14 +7238,46 @@ var init_execa = __esm(() => {
   } = getIpcExport());
 });
 
+// src/lib/adapters/tmux.ts
+async function waitForTmuxSession(sessionName) {
+  while (true) {
+    const { exitCode } = await execa("tmux", ["has-session", "-t", sessionName], {
+      reject: false
+    });
+    if (exitCode !== 0) {
+      return;
+    }
+    await new Promise((resolve5) => setTimeout(resolve5, 1000));
+  }
+}
+var init_tmux = __esm(() => {
+  init_execa();
+});
+
 // src/lib/adapters/codex.ts
 var codexAdapter;
 var init_codex = __esm(() => {
   init_execa();
+  init_tmux();
   codexAdapter = {
     name: "codex",
-    async execute({ cwd, prompt }) {
-      const result = await execa("codex", ["exec", prompt, "--full-auto"], {
+    async execute({ cwd, prompt, tmux }) {
+      const args = ["exec", prompt, "--full-auto"];
+      if (tmux) {
+        await execa("tmux", [
+          "new-session",
+          "-d",
+          "-s",
+          tmux.sessionName,
+          "-c",
+          cwd,
+          "codex",
+          ...args
+        ], { reject: false });
+        await waitForTmuxSession(tmux.sessionName);
+        return { exitCode: 0 };
+      }
+      const result = await execa("codex", args, {
         cwd,
         timeout: 0,
         reject: false
@@ -7266,9 +7298,25 @@ var init_codex = __esm(() => {
 var opencodeAdapter;
 var init_opencode = __esm(() => {
   init_execa();
+  init_tmux();
   opencodeAdapter = {
     name: "opencode",
-    async execute({ cwd, prompt }) {
+    async execute({ cwd, prompt, tmux }) {
+      if (tmux) {
+        await execa("tmux", [
+          "new-session",
+          "-d",
+          "-s",
+          tmux.sessionName,
+          "-c",
+          cwd,
+          "opencode",
+          "run",
+          prompt
+        ], { reject: false });
+        await waitForTmuxSession(tmux.sessionName);
+        return { exitCode: 0 };
+      }
       const result = await execa("opencode", ["run", prompt], {
         cwd,
         timeout: 0,
@@ -7290,10 +7338,26 @@ var init_opencode = __esm(() => {
 var claudeAdapter;
 var init_claude = __esm(() => {
   init_execa();
+  init_tmux();
   claudeAdapter = {
     name: "claude",
-    async execute({ cwd, prompt }) {
-      const result = await execa("claude", ["-p", prompt, "--dangerously-skip-permissions"], {
+    async execute({ cwd, prompt, tmux }) {
+      const args = ["-p", prompt, "--dangerously-skip-permissions"];
+      if (tmux) {
+        await execa("tmux", [
+          "new-session",
+          "-d",
+          "-s",
+          tmux.sessionName,
+          "-c",
+          cwd,
+          "claude",
+          ...args
+        ], { reject: false });
+        await waitForTmuxSession(tmux.sessionName);
+        return { exitCode: 0 };
+      }
+      const result = await execa("claude", args, {
         cwd,
         timeout: 0,
         reject: false
@@ -7314,7 +7378,7 @@ var manualAdapter;
 var init_manual = __esm(() => {
   manualAdapter = {
     name: "manual",
-    async execute({ cwd, prompt }) {
+    async execute({ cwd, prompt, tmux }) {
       console.log("⚠️  Manual agent: execute() called but should be skipped by dispatcher.");
       console.log("   This plan is intended for IDE-driven execution.");
       return { exitCode: 0 };
@@ -16690,23 +16754,32 @@ var init_prompt_sources = __esm(() => {
   BUILTIN_PROMPTS = {
     designer_new: `# Designer: Create a New Plan
 
-You are helping a software engineer **plan** a coding task for prloom.
+You are helping a software engineer **plan** a coding task.
 
 > [!CAUTION] > **You are PLANNING, not building.**
 >
 > - Do NOT modify any code files
 > - The ONLY file you may edit is: \`{{plan_path}}\`
 
-## Your Philosophy
+## Repository Context
 
-You are working with a technical user who knows what they want. Your job is to **extract requirements**, not to make decisions for them.
+You are working in:
 
-- **Ask clarifying questions** — do not assume
-- **Do NOT fill in gaps** — wait for the user to provide details
-- **Defer to the user's judgment** on design and implementation
-- Only fill in details if the user explicitly says "fill in the details" or similar
+- **Repo**: \`{{repo_path}}\`
+- **Base branch**: \`{{base_branch}}\`
+- **Worker agent**: \`{{worker_agent}}\`
 
-The user will give you information bit by bit. Your responsibility is to synthesize their requirements into a structured plan.
+Explore the codebase freely to understand context. Do NOT ask questions you can answer by exploring (e.g., test commands, file locations, package.json contents).
+
+## Your Philosophy
+
+You are working with a technical user who knows what they want. Your job is to **extract requirements** and **discuss implementation**, not to make decisions for them.
+
+- **Explore the codebase** to understand context before asking questions
+- **Ask clarifying questions** about user preferences and acceptance criteria
+- **Discuss implementation approach** — do not jump straight to writing the plan
+- **Defer to the user's judgment** on design decisions
+- Only fill in the plan when the user confirms they're ready
 
 {{#if user_description}}
 
@@ -16714,35 +16787,51 @@ The user will give you information bit by bit. Your responsibility is to synthes
 
 > {{user_description}}
 
-Ask clarifying questions before filling in the plan. What files? What approach? Any constraints?
+Explore relevant files, then discuss the implementation approach with the user before writing the plan.
 {{else}}
 
 ## Your First Step
 
 Ask the user: **What would you like to build?**
 
-Then ask follow-up questions:
+Then:
 
-- How should it work?
-- What files are involved?
-- Any constraints or preferences?
-- What are the acceptance criteria?
-  {{/if}}
+1. Explore the codebase to understand the relevant areas
+2. Discuss how to implement it (files to change, approach, trade-offs)
+3. Confirm acceptance criteria
+4. When the user is ready, write the plan
+   {{/if}}
 
 ## Plan Structure
 
-Once you have the requirements, fill in:
+The plan file already has a template with these sections. Fill them in:
 
 - **Objective**: What will be built (1-2 sentences)
-- **Context**: Files to modify, test commands, constraints
-- **TODO**: Small, sequential tasks
+- **Context**: Files to modify, constraints, any notes the Worker needs
+- **TODO (Commits)**: Each item is ONE commit the Worker will make
 
-Leave the frontmatter alone.
+### TODO Rules
+
+Each TODO item represents a **single commit**. Think of them as the git log you want to see:
+
+✅ Good TODOs (commits):
+
+- \`Fix PDF viewer to load beyond 10 pages\`
+- \`Add horizontal resize handle to Learn panel\`
+- \`Update LearnStore to trigger page prefetch\`
+
+❌ Bad TODOs (not commits):
+
+- \`Run npm test\` — this is verification, not a commit
+- \`Trace the code to understand X\` — this is research, not a commit
+- \`Validate acceptance criteria\` — this is testing, not a commit
+
+The Worker will run tests and type-checks before each commit automatically.
 
-## Runtime Context
+## Important
 
-- Base branch: \`{{base_branch}}\`
-- Worker agent: \`{{worker_agent}}\`
+- The plan template already has a \`## Progress Log\` section — do NOT duplicate it
+- Leave the frontmatter (\`id\`, \`status\`, \`agent\`, \`base_branch\`) alone
 `,
     designer_edit: `# Designer: Edit an Existing Plan
 
@@ -16886,10 +16975,11 @@ function renderWorkerPrompt(repoRoot, plan, todo) {
     plan: plan.raw
   });
 }
-function renderDesignerNewPrompt(planPath, baseBranch, workerAgent, userDescription) {
+function renderDesignerNewPrompt(repoPath, planPath, baseBranch, workerAgent, userDescription) {
   const template = BUILTIN_PROMPTS["designer_new"];
   const compiled = import_handlebars.default.compile(template);
   return compiled({
+    repo_path: repoPath,
     plan_path: planPath,
     base_branch: baseBranch,
     worker_agent: workerAgent,
@@ -17266,7 +17356,7 @@ async function runNew(repoRoot, planId, agentOverride, noDesigner) {
   console.log(`Designer agent: ${designerAgent}`);
   console.log("");
   console.log("Starting Designer session to fill in the plan...");
-  const prompt = renderDesignerNewPrompt(planPath, baseBranch, workerAgent);
+  const prompt = renderDesignerNewPrompt(repoRoot, planPath, baseBranch, workerAgent);
   await adapter.interactive({ cwd: repoRoot, prompt });
   console.log("Designer session ended.");
   console.log("Plan is now in inbox. Run 'prloom start' to dispatch.");
@@ -17556,7 +17646,7 @@ __export(exports_dispatcher, {
 });
 import { join as join9 } from "path";
 import { existsSync as existsSync9, statSync as statSync5 } from "fs";
-async function runDispatcher(repoRoot) {
+async function runDispatcher(repoRoot, options2 = {}) {
   const config = loadConfig(repoRoot);
   const worktreesDir = resolveWorktreesDir(repoRoot, config);
   acquireLock(repoRoot);
@@ -17584,7 +17674,7 @@ async function runDispatcher(repoRoot) {
         await handleCommand2(state, cmd);
       }
       await ingestInboxPlans(repoRoot, worktreesDir, config, state);
-      await processActivePlans(repoRoot, config, state, botLogin);
+      await processActivePlans(repoRoot, config, state, botLogin, options2);
       saveState(repoRoot, state);
       await sleepUntilIpcOrTimeout(repoRoot, state.control_cursor, config.poll_interval_ms);
     } catch (error) {
@@ -17641,7 +17731,7 @@ function getFeedbackPollDecision(opts) {
     shouldUpdateLastPolledAt: !pollOnce && shouldPoll
   };
 }
-async function processActivePlans(repoRoot, config, state, botLogin) {
+async function processActivePlans(repoRoot, config, state, botLogin, options2 = {}) {
   for (const [planId, ps] of Object.entries(state.plans)) {
     try {
       const planPath = join9(ps.worktree, ps.planRelpath);
@@ -17676,7 +17766,7 @@ async function processActivePlans(repoRoot, config, state, botLogin) {
           if (newFeedback.length > 0) {
             console.log(`\uD83D\uDCAC ${newFeedback.length} new feedback for ${planId}`);
             if (!isManualAgent) {
-              await runTriage(repoRoot, config, ps, plan, newFeedback);
+              await runTriage(repoRoot, config, ps, plan, newFeedback, options2);
             }
             plan = parsePlan(planPath);
             const maxIds = getMaxFeedbackIds(newFeedback);
@@ -17699,7 +17789,15 @@ async function processActivePlans(repoRoot, config, state, botLogin) {
           const prompt = renderWorkerPrompt(repoRoot, plan, todo);
           const agentName = plan.frontmatter.agent ?? config.agents.default;
           const adapter = getAdapter(agentName);
-          await adapter.execute({ cwd: ps.worktree, prompt });
+          const tmuxConfig = options2.tmux ? { sessionName: `prloom-${planId}` } : undefined;
+          if (tmuxConfig) {
+            ps.tmuxSession = tmuxConfig.sessionName;
+            console.log(`   [spawned in tmux session: ${tmuxConfig.sessionName}]`);
+          }
+          await adapter.execute({ cwd: ps.worktree, prompt, tmux: tmuxConfig });
+          if (tmuxConfig) {
+            ps.tmuxSession = undefined;
+          }
           const committed = await commitAll(ps.worktree, `[prloom] ${planId}: TODO #${todo.index}`);
           if (committed) {
             await push(ps.worktree, ps.branch);
@@ -17747,13 +17845,14 @@ async function pollNewFeedback(repoRoot, ps, botLogin) {
   };
   return filterNewFeedback(allFeedback, cursors, botLogin);
 }
-async function runTriage(repoRoot, config, ps, plan, feedback) {
+async function runTriage(repoRoot, config, ps, plan, feedback, options2 = {}) {
   ensureWorktreePrloomDir(ps.worktree);
   const triageAgent = config.agents.designer ?? config.agents.default;
   const adapter = getAdapter(triageAgent);
   const prompt = renderTriagePrompt(repoRoot, plan, feedback);
   console.log(`\uD83D\uDD0D Running triage for ${plan.frontmatter.id}...`);
-  await adapter.execute({ cwd: ps.worktree, prompt });
+  const tmuxConfig = options2.tmux ? { sessionName: `prloom-triage-${plan.frontmatter.id}` } : undefined;
+  await adapter.execute({ cwd: ps.worktree, prompt, tmux: tmuxConfig });
   try {
     const result = readTriageResultFile(ps.worktree);
     if (result.rebase_requested) {
@@ -17967,6 +18066,35 @@ var init_open = __esm(() => {
   init_adapters();
 });
 
+// src/cli/watch.ts
+var exports_watch = {};
+__export(exports_watch, {
+  runWatch: () => runWatch
+});
+async function runWatch(repoRoot, planId) {
+  const state = loadState(repoRoot);
+  const ps = state.plans[planId];
+  if (!ps) {
+    console.error(`Plan not found in state: ${planId}`);
+    console.error("Make sure the plan has been dispatched at least once.");
+    process.exit(1);
+  }
+  if (!ps.tmuxSession) {
+    console.error(`No active tmux session for ${planId}`);
+    console.error("This plan may not be running, or dispatcher wasn't started with --tmux");
+    process.exit(1);
+  }
+  console.log(`Attaching to ${ps.tmuxSession} (read-only)...`);
+  console.log("Press Ctrl+B D to detach without interrupting the worker.");
+  await execa("tmux", ["attach", "-t", ps.tmuxSession, "-r"], {
+    stdio: "inherit"
+  });
+}
+var init_watch = __esm(() => {
+  init_execa();
+  init_state();
+});
+
 // src/cli/logs.ts
 var exports_logs = {};
 __export(exports_logs, {
@@ -23482,9 +23610,13 @@ yargs_default(hideBin(process.argv)).scriptName("prloom").usage("$0 <command> [o
 }), async (argv) => {
   const { runEdit: runEdit2 } = await Promise.resolve().then(() => (init_edit(), exports_edit));
   await runEdit2(await getRepoRoot(), argv["plan-id"], argv.agent, argv["no-designer"]);
-}).command("start", "Start the dispatcher", () => {}, async () => {
+}).command("start", "Start the dispatcher", (yargs) => yargs.option("tmux", {
+  type: "boolean",
+  describe: "Run workers in tmux sessions for observation",
+  default: false
+}), async (argv) => {
   const { runDispatcher: runDispatcher2 } = await Promise.resolve().then(() => (init_dispatcher(), exports_dispatcher));
-  await runDispatcher2(await getRepoRoot());
+  await runDispatcher2(await getRepoRoot(), { tmux: argv.tmux });
 }).command("status", "Show plan states", () => {}, async () => {
   const { runStatus: runStatus2 } = await Promise.resolve().then(() => (init_status(), exports_status));
   await runStatus2(await getRepoRoot());
@@ -23497,6 +23629,9 @@ yargs_default(hideBin(process.argv)).scriptName("prloom").usage("$0 <command> [o
 }).command("open <plan-id>", "Open TUI for manual work (requires paused)", (yargs) => yargs.positional("plan-id", { type: "string", demandOption: true }), async (argv) => {
   const { runOpen: runOpen2 } = await Promise.resolve().then(() => (init_open(), exports_open));
   await runOpen2(await getRepoRoot(), argv["plan-id"]);
+}).command("watch <plan-id>", "Observe a running worker (requires --tmux mode)", (yargs) => yargs.positional("plan-id", { type: "string", demandOption: true }), async (argv) => {
+  const { runWatch: runWatch2 } = await Promise.resolve().then(() => (init_watch(), exports_watch));
+  await runWatch2(await getRepoRoot(), argv["plan-id"]);
 }).command("logs <plan-id>", "Show session ID for a plan", (yargs) => yargs.positional("plan-id", { type: "string", demandOption: true }), async (argv) => {
   const { runLogs: runLogs2 } = await Promise.resolve().then(() => (init_logs(), exports_logs));
   await runLogs2(await getRepoRoot(), argv["plan-id"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prloom",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "bin": {
     "prloom": "./dist/cli/index.js"

package/prompts/designer_new.md

@@ -1,22 +1,31 @@
 # Designer: Create a New Plan
 
-You are helping a software engineer **plan** a coding task for prloom.
+You are helping a software engineer **plan** a coding task.
 
 > [!CAUTION] > **You are PLANNING, not building.**
 >
 > - Do NOT modify any code files
 > - The ONLY file you may edit is: `{{plan_path}}`
 
-## Your Philosophy
+## Repository Context
+
+You are working in:
+
+- **Repo**: `{{repo_path}}`
+- **Base branch**: `{{base_branch}}`
+- **Worker agent**: `{{worker_agent}}`
 
-You are working with a technical user who knows what they want. Your job is to **extract requirements**, not to make decisions for them.
+Explore the codebase freely to understand context. Do NOT ask questions you can answer by exploring (e.g., test commands, file locations, package.json contents).
 
-- **Ask clarifying questions** — do not assume
-- **Do NOT fill in gaps** — wait for the user to provide details
-- **Defer to the user's judgment** on design and implementation
-- Only fill in details if the user explicitly says "fill in the details" or similar
+## Your Philosophy
+
+You are working with a technical user who knows what they want. Your job is to **extract requirements** and **discuss implementation**, not to make decisions for them.
 
-The user will give you information bit by bit. Your responsibility is to synthesize their requirements into a structured plan.
+- **Explore the codebase** to understand context before asking questions
+- **Ask clarifying questions** about user preferences and acceptance criteria
+- **Discuss implementation approach** — do not jump straight to writing the plan
+- **Defer to the user's judgment** on design decisions
+- Only fill in the plan when the user confirms they're ready
 
 {{#if user_description}}
 
@@ -24,32 +33,48 @@ The user will give you information bit by bit. Your responsibility is to synthes
 
 > {{user_description}}
 
-Ask clarifying questions before filling in the plan. What files? What approach? Any constraints?
+Explore relevant files, then discuss the implementation approach with the user before writing the plan.
 {{else}}
 
 ## Your First Step
 
 Ask the user: **What would you like to build?**
 
-Then ask follow-up questions:
+Then:
 
-- How should it work?
-- What files are involved?
-- Any constraints or preferences?
-- What are the acceptance criteria?
-  {{/if}}
+1. Explore the codebase to understand the relevant areas
+2. Discuss how to implement it (files to change, approach, trade-offs)
+3. Confirm acceptance criteria
+4. When the user is ready, write the plan
+   {{/if}}
 
 ## Plan Structure
 
-Once you have the requirements, fill in:
+The plan file already has a template with these sections. Fill them in:
 
 - **Objective**: What will be built (1-2 sentences)
-- **Context**: Files to modify, test commands, constraints
-- **TODO**: Small, sequential tasks
+- **Context**: Files to modify, constraints, any notes the Worker needs
+- **TODO (Commits)**: Each item is ONE commit the Worker will make
+
+### TODO Rules
+
+Each TODO item represents a **single commit**. Think of them as the git log you want to see:
+
+✅ Good TODOs (commits):
+
+- `Fix PDF viewer to load beyond 10 pages`
+- `Add horizontal resize handle to Learn panel`
+- `Update LearnStore to trigger page prefetch`
+
+❌ Bad TODOs (not commits):
+
+- `Run npm test` — this is verification, not a commit
+- `Trace the code to understand X` — this is research, not a commit
+- `Validate acceptance criteria` — this is testing, not a commit
 
-Leave the frontmatter alone.
+The Worker will run tests and type-checks before each commit automatically.
 
-## Runtime Context
+## Important
 
-- Base branch: `{{base_branch}}`
-- Worker agent: `{{worker_agent}}`
+- The plan template already has a `## Progress Log` section — do NOT duplicate it
+- Leave the frontmatter (`id`, `status`, `agent`, `base_branch`) alone