@tarcisiopgs/lisa 1.0.3 → 1.2.0

package/dist/index.js

@@ -638,9 +638,11 @@ ${readmeBlock}${hookBlock}
    {
      "repoPath": "<absolute path to the chosen repo>",
      "branch": "<your English branch name>",
-     "prTitle": "<PR title in English, conventional commit format>"
+     "prTitle": "<PR title in English, conventional commit format>",
+     "prBody": "<English summary of what was implemented and why, 2-5 sentences>"
    }
    \`\`\`
+   The \`prBody\` should describe WHAT was changed and WHY, not just repeat the title. Mention key files modified, new behavior added, or bugs fixed. Write in English.
    Do NOT commit this file.
 
 ## Rules
@@ -699,8 +701,9 @@ ${testBlock}${readmeBlock}${hookBlock}
 
 4. **Write manifest**: Create \`.lisa-manifest.json\` in the **current directory** with JSON:
    \`\`\`json
-   {"branch": "<final English branch name>", "prTitle": "<English PR title, conventional commit format>"}
+   {"branch": "<final English branch name>", "prTitle": "<English PR title, conventional commit format>", "prBody": "<English summary of what was implemented and why, 2-5 sentences>"}
    \`\`\`
+   The \`prBody\` should describe WHAT was changed and WHY, not just repeat the title. Mention key files modified, new behavior added, or bugs fixed. Write in English.
    Do NOT commit this file.
 
 ## Rules
@@ -768,8 +771,9 @@ ${testBlock}${readmeBlock}${hookBlock}
 
 6. **Write manifest**: Before finishing, create \`${manifestPath}\` with JSON:
    \`\`\`json
-   {"repoPath": "<absolute path to this repo>", "branch": "<branch name>", "prTitle": "<English PR title, conventional commit format>"}
+   {"repoPath": "<absolute path to this repo>", "branch": "<branch name>", "prTitle": "<English PR title, conventional commit format>", "prBody": "<English summary of what was implemented and why, 2-5 sentences>"}
    \`\`\`
+   The \`prBody\` should describe WHAT was changed and WHY, not just repeat the title. Mention key files modified, new behavior added, or bugs fixed. Write in English.
    Do NOT commit this file.
 
 ## Rules
@@ -1715,6 +1719,50 @@ function createSource(name) {
   return factory();
 }
 
+// src/terminal.ts
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var SPINNER_INTERVAL_MS = 80;
+var spinnerTimer = null;
+var spinnerFrame = 0;
+function isTTY() {
+  return process.stdout.isTTY === true;
+}
+function writeOSC(title) {
+  process.stdout.write(`\x1B]0;${title}\x07`);
+}
+function setTitle(title) {
+  if (!isTTY()) return;
+  writeOSC(title);
+}
+function startSpinner(message) {
+  if (!isTTY()) return;
+  stopSpinner();
+  spinnerFrame = 0;
+  writeOSC(`${SPINNER_FRAMES[0]} Lisa \u2014 ${message}`);
+  spinnerTimer = setInterval(() => {
+    spinnerFrame = (spinnerFrame + 1) % SPINNER_FRAMES.length;
+    writeOSC(`${SPINNER_FRAMES[spinnerFrame]} Lisa \u2014 ${message}`);
+  }, SPINNER_INTERVAL_MS);
+}
+function stopSpinner(message) {
+  if (spinnerTimer) {
+    clearInterval(spinnerTimer);
+    spinnerTimer = null;
+  }
+  if (!isTTY()) return;
+  if (message) {
+    writeOSC(message);
+  }
+}
+function notify() {
+  if (!isTTY()) return;
+  process.stdout.write("\x07");
+}
+function resetTitle() {
+  if (!isTTY()) return;
+  writeOSC("");
+}
+
 // src/worktree.ts
 import { appendFileSync as appendFileSync5, existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 import { join as join6, resolve as resolve4 } from "path";
@@ -1851,10 +1899,15 @@ function resolveModels(config2) {
   if (config2.models && config2.models.length > 0) return config2.models;
   return [config2.provider];
 }
-function buildPrBody(issue, providerUsed) {
-  return `Closes ${issue.url}
-
-Implemented by [lisa](https://github.com/tarcisiopgs/lisa) using **${providerUsed}**.`;
+function buildPrBody(providerUsed, description) {
+  const lines = [];
+  if (description) {
+    lines.push(description, "");
+  }
+  lines.push(
+    `Implemented by [lisa](https://github.com/tarcisiopgs/lisa) using **${providerUsed}**.`
+  );
+  return lines.join("\n");
 }
 var PR_TITLE_FILE = ".pr-title";
 function readPrTitle(cwd) {
@@ -1946,6 +1999,8 @@ function installSignalHandlers() {
       process.exit(1);
     }
     shuttingDown = true;
+    stopSpinner();
+    resetTitle();
     warn(`Received ${signal}. Reverting active issue...`);
     if (activeCleanup) {
       const { issueId, previousStatus, source } = activeCleanup;
@@ -2022,12 +2077,14 @@ async function runLoop(config2, opts) {
     const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").substring(0, 19);
     const logFile = resolve5(config2.logs.dir, `session_${session}_${timestamp2}.log`);
     divider(session);
+    startSpinner("fetching issue...");
     if (opts.issueId) {
       log(`Fetching issue '${opts.issueId}' from ${config2.source}...`);
     } else {
       log(`Fetching next '${config2.source_config.label}' issue from ${config2.source}...`);
     }
     if (opts.dryRun) {
+      stopSpinner();
       if (opts.issueId) {
         log(`[dry-run] Would fetch issue '${opts.issueId}' from ${config2.source}`);
       } else {
@@ -2044,11 +2101,14 @@ async function runLoop(config2, opts) {
     try {
       issue = opts.issueId ? await source.fetchIssueById(opts.issueId) : await source.fetchNextIssue(config2.source_config);
     } catch (err) {
+      stopSpinner();
       error(`Failed to fetch issues: ${err instanceof Error ? err.message : String(err)}`);
       if (opts.once) break;
+      setTitle("Lisa \u2014 cooling down...");
       await sleep(config2.loop.cooldown * 1e3);
       continue;
     }
+    stopSpinner();
     if (!issue) {
       if (opts.issueId) {
         error(`Issue '${opts.issueId}' not found.`);
@@ -2058,6 +2118,7 @@ async function runLoop(config2, opts) {
       break;
     }
     ok(`Picked up: ${issue.id} \u2014 ${issue.title}`);
+    setTitle(`Lisa \u2014 ${issue.id}`);
     const previousStatus = config2.source_config.pick_from;
     try {
       const inProgress = config2.source_config.in_progress;
@@ -2071,6 +2132,7 @@ async function runLoop(config2, opts) {
     try {
       sessionResult = config2.workflow === "worktree" ? await runWorktreeSession(config2, issue, logFile, session, models) : await runBranchSession(config2, issue, logFile, session, models);
     } catch (err) {
+      stopSpinner();
       error(
         `Unhandled error in session for ${issue.id}: ${err instanceof Error ? err.message : String(err)}`
       );
@@ -2083,8 +2145,10 @@ async function runLoop(config2, opts) {
         );
       }
       activeCleanup = null;
+      notify();
       if (opts.once) break;
       log(`Cooling down ${config2.loop.cooldown}s before next issue...`);
+      setTitle("Lisa \u2014 cooling down...");
       await sleep(config2.loop.cooldown * 1e3);
       continue;
     }
@@ -2100,11 +2164,13 @@ async function runLoop(config2, opts) {
         );
       }
       activeCleanup = null;
+      notify();
       if (opts.once) {
         log("Single iteration mode. Exiting.");
         break;
       }
       log(`Cooling down ${config2.loop.cooldown}s before next issue...`);
+      setTitle("Lisa \u2014 cooling down...");
       await sleep(config2.loop.cooldown * 1e3);
       continue;
     }
@@ -2122,11 +2188,13 @@ async function runLoop(config2, opts) {
         );
       }
       activeCleanup = null;
+      notify();
       if (opts.once) {
         log("Single iteration mode. Exiting.");
         break;
       }
       log(`Cooling down ${config2.loop.cooldown}s before next issue...`);
+      setTitle("Lisa \u2014 cooling down...");
       await sleep(config2.loop.cooldown * 1e3);
       continue;
     }
@@ -2150,13 +2218,17 @@ async function runLoop(config2, opts) {
       error(`Failed to complete issue: ${err instanceof Error ? err.message : String(err)}`);
     }
     activeCleanup = null;
+    stopSpinner(`\u2713 Lisa \u2014 ${issue.id} \u2014 PR created`);
+    notify();
     if (opts.once) {
       log("Single iteration mode. Exiting.");
       break;
     }
     log(`Cooling down ${config2.loop.cooldown}s before next issue...`);
+    setTitle("Lisa \u2014 cooling down...");
     await sleep(config2.loop.cooldown * 1e3);
   }
+  resetTitle();
   ok(`lisa finished. ${session} session(s) run.`);
 }
 function logAttemptHistory(result) {
@@ -2205,11 +2277,13 @@ async function runWorktreeSession(config2, issue, logFile, session, models) {
   const repoPath = determineRepoPath(config2.repos, issue, workspace) ?? workspace;
   const defaultBranch = resolveBaseBranch(config2, repoPath);
   const branchName = generateBranchName(issue.id, issue.title);
+  startSpinner(`${issue.id} \u2014 creating worktree...`);
   log(`Creating worktree for ${branchName} (base: ${defaultBranch})...`);
   let worktreePath;
   try {
     worktreePath = await createWorktree(repoPath, branchName, defaultBranch);
   } catch (err) {
+    stopSpinner();
     error(`Failed to create worktree: ${err instanceof Error ? err.message : String(err)}`);
     return {
       success: false,
@@ -2224,10 +2298,13 @@ async function runWorktreeSession(config2, issue, logFile, session, models) {
       }
     };
   }
+  stopSpinner();
   ok(`Worktree created at ${worktreePath}`);
   const repo = findRepoConfig(config2, issue);
   if (repo?.lifecycle) {
+    startSpinner(`${issue.id} \u2014 starting resources...`);
     const started = await startResources(repo, worktreePath);
+    stopSpinner();
     if (!started) {
       error(`Lifecycle startup failed for ${issue.id}. Aborting session.`);
       await cleanupWorktree(repoPath, worktreePath);
@@ -2250,6 +2327,7 @@ async function runWorktreeSession(config2, issue, logFile, session, models) {
     log(`Detected test runner: ${testRunner}`);
   }
   const prompt = buildImplementPrompt(issue, config2, testRunner);
+  startSpinner(`${issue.id} \u2014 implementing...`);
   log(`Implementing in worktree... (log: ${logFile})`);
   initLogFile(logFile);
   const result = await runWithFallback(models, prompt, {
@@ -2259,6 +2337,7 @@ async function runWorktreeSession(config2, issue, logFile, session, models) {
     issueId: issue.id,
     overseer: config2.overseer
   });
+  stopSpinner();
   try {
     appendFileSync6(
       logFile,
@@ -2279,7 +2358,9 @@ ${result.output}
     await cleanupWorktree(repoPath, worktreePath);
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
+  startSpinner(`${issue.id} \u2014 validating tests...`);
   const testsPassed = await runTestValidation(worktreePath);
+  stopSpinner();
   if (!testsPassed) {
     error(`Tests failed for ${issue.id}. Blocking PR creation.`);
     await cleanupWorktree(repoPath, worktreePath);
@@ -2299,6 +2380,7 @@ ${result.output}
       );
     }
   }
+  startSpinner(`${issue.id} \u2014 pushing...`);
   const pushResult = await pushWithRecovery({
     branch: effectiveBranch,
     cwd: worktreePath,
@@ -2308,13 +2390,16 @@ ${result.output}
     issueId: issue.id,
     overseer: config2.overseer
   });
+  stopSpinner();
   if (!pushResult.success) {
     error(`Failed to push branch to remote: ${pushResult.error}`);
     cleanupManifest(worktreePath);
     await cleanupWorktree(repoPath, worktreePath);
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
+  startSpinner(`${issue.id} \u2014 creating PR...`);
   const prTitle = manifest?.prTitle ?? readPrTitle(worktreePath) ?? issue.title;
+  const prBody = manifest?.prBody;
   cleanupPrTitle(worktreePath);
   cleanupManifest(worktreePath);
   const prUrls = [];
@@ -2327,7 +2412,7 @@ ${result.output}
         head: effectiveBranch,
         base: defaultBranch,
         title: prTitle,
-        body: buildPrBody(issue, result.providerUsed)
+        body: buildPrBody(result.providerUsed, prBody)
       },
       config2.github
     );
@@ -2336,6 +2421,7 @@ ${result.output}
   } catch (err) {
     error(`Failed to create PR: ${err instanceof Error ? err.message : String(err)}`);
   }
+  stopSpinner();
   await cleanupWorktree(repoPath, worktreePath);
   ok(`Session ${session} complete for ${issue.id}`);
   return { success: true, providerUsed: result.providerUsed, prUrls, fallback: result };
@@ -2344,6 +2430,7 @@ async function runWorktreeMultiRepoSession(config2, issue, logFile, session, mod
   const workspace = resolve5(config2.workspace);
   cleanupManifest(workspace);
   const prompt = buildWorktreeMultiRepoPrompt(issue, config2);
+  startSpinner(`${issue.id} \u2014 implementing...`);
   log(`Multi-repo worktree session for ${issue.id} (agent selects repo and branch name)`);
   log(`Implementing (agent selects repo)... (log: ${logFile})`);
   initLogFile(logFile);
@@ -2354,6 +2441,7 @@ async function runWorktreeMultiRepoSession(config2, issue, logFile, session, mod
     issueId: issue.id,
     overseer: config2.overseer
   });
+  stopSpinner();
   try {
     appendFileSync6(
       logFile,
@@ -2387,13 +2475,16 @@ ${result.output}
   if (!hasWorktree) {
     warn(`Worktree not found at ${worktreePath} \u2014 using repo root for git operations`);
   }
+  startSpinner(`${issue.id} \u2014 validating tests...`);
   const testsPassed = await runTestValidation(effectiveCwd);
+  stopSpinner();
   if (!testsPassed) {
     error(`Tests failed for ${issue.id}. Blocking PR creation.`);
     if (hasWorktree) await cleanupWorktree(manifest.repoPath, worktreePath);
     cleanupManifest(workspace);
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
+  startSpinner(`${issue.id} \u2014 pushing...`);
   const pushResult = await pushWithRecovery({
     branch: manifest.branch,
     cwd: effectiveCwd,
@@ -2403,13 +2494,16 @@ ${result.output}
     issueId: issue.id,
     overseer: config2.overseer
   });
+  stopSpinner();
   if (!pushResult.success) {
     error(`Failed to push branch to remote: ${pushResult.error}`);
     if (hasWorktree) await cleanupWorktree(manifest.repoPath, worktreePath);
     cleanupManifest(workspace);
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
+  startSpinner(`${issue.id} \u2014 creating PR...`);
   const prTitle = manifest.prTitle ?? issue.title;
+  const prBody = manifest.prBody;
   const prUrls = [];
   try {
     const repoInfo = await getRepoInfo(effectiveCwd);
@@ -2420,7 +2514,7 @@ ${result.output}
         head: manifest.branch,
         base: baseBranch,
         title: prTitle,
-        body: buildPrBody(issue, result.providerUsed)
+        body: buildPrBody(result.providerUsed, prBody)
       },
       config2.github
     );
@@ -2429,6 +2523,7 @@ ${result.output}
   } catch (err) {
     error(`Failed to create PR: ${err instanceof Error ? err.message : String(err)}`);
   }
+  stopSpinner();
   cleanupManifest(workspace);
   if (hasWorktree) await cleanupWorktree(manifest.repoPath, worktreePath);
   ok(`Session ${session} complete for ${issue.id}`);
@@ -2444,8 +2539,10 @@ async function runBranchSession(config2, issue, logFile, session, models) {
   const prompt = buildImplementPrompt(issue, config2, testRunner);
   const repo = findRepoConfig(config2, issue);
   if (repo?.lifecycle) {
+    startSpinner(`${issue.id} \u2014 starting resources...`);
     const cwd = resolve5(workspace, repo.path);
     const started = await startResources(repo, cwd);
+    stopSpinner();
     if (!started) {
       error(`Lifecycle startup failed for ${issue.id}. Aborting session.`);
       return {
@@ -2462,6 +2559,7 @@ async function runBranchSession(config2, issue, logFile, session, models) {
       };
     }
   }
+  startSpinner(`${issue.id} \u2014 implementing...`);
   log(`Implementing... (log: ${logFile})`);
   initLogFile(logFile);
   const result = await runWithFallback(models, prompt, {
@@ -2471,6 +2569,7 @@ async function runBranchSession(config2, issue, logFile, session, models) {
     issueId: issue.id,
     overseer: config2.overseer
   });
+  stopSpinner();
   try {
     appendFileSync6(
       logFile,
@@ -2490,7 +2589,9 @@ ${result.output}
     error(`Session ${session} failed for ${issue.id}. Check ${logFile}`);
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
+  startSpinner(`${issue.id} \u2014 validating tests...`);
   const testsPassed = await runTestValidation(workspace);
+  stopSpinner();
   if (!testsPassed) {
     error(`Tests failed for ${issue.id}. Blocking PR creation.`);
     cleanupManifest(workspace);
@@ -2513,7 +2614,9 @@ ${result.output}
     ok(`Session ${session} complete for ${issue.id}`);
     return { success: true, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
+  startSpinner(`${issue.id} \u2014 creating PR...`);
   const prTitle = manifest?.prTitle ?? readPrTitle(workspace) ?? issue.title;
+  const prBody = manifest?.prBody;
   cleanupPrTitle(workspace);
   const prUrls = [];
   for (const { repoPath, branch } of detected) {
@@ -2528,7 +2631,7 @@ ${result.output}
           head: branch,
           base: baseBranch,
           title: prTitle,
-          body: buildPrBody(issue, result.providerUsed)
+          body: buildPrBody(result.providerUsed, prBody)
         },
         config2.github
       );
@@ -2538,6 +2641,7 @@ ${result.output}
       error(`Failed to create PR: ${err instanceof Error ? err.message : String(err)}`);
     }
   }
+  stopSpinner();
   ok(`Session ${session} complete for ${issue.id}`);
   return { success: true, providerUsed: result.providerUsed, prUrls, fallback: result };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tarcisiopgs/lisa",
-	"version": "1.0.3",
+	"version": "1.2.0",
 	"description": "Deterministic autonomous issue resolver — structured AI agent loop for Linear/Trello",
 	"license": "MIT",
 	"type": "module",