@tarcisiopgs/lisa 1.26.2 → 1.28.0

package/README.md

@@ -45,6 +45,7 @@ If something fails — pre-push hooks, quota limits, stuck processes — Lisa ha
 - **Real-time TUI** — Kanban board with live provider output, keyboard controls, PR merge detection
 - **Self-healing** — orphan recovery on startup, push failure retry, stuck process detection
 - **Guardrails** — past failures are injected into future prompts to avoid repeating mistakes
+- **AI planning** — `lisa plan` decomposes goals into atomic issues with dependencies, creates them in your tracker
 - **Project context** — auto-generates `.lisa/context.md` with your stack, conventions, and constraints
 
 ## Providers
@@ -89,12 +90,18 @@ lisa run --watch             # poll for new issues after queue empties
 lisa run --concurrency 3     # process 3 issues in parallel
 lisa run --issue INT-42      # process a specific issue
 lisa run --limit 5           # stop after 5 issues
+lisa plan "Add rate limiting" # decompose goal into issues via AI
+lisa plan --issue EPIC-123   # decompose existing issue into sub-issues
+lisa plan --continue         # resume interrupted plan
 lisa init                    # create .lisa/config.yaml interactively
 lisa status                  # show session stats
+lisa doctor                  # diagnose setup issues (config, provider, env, git)
 lisa context refresh         # regenerate project context
 lisa feedback --pr URL       # inject PR review feedback into guardrails
 ```
 
+Append `--json` to any command for machine-readable output. Use `--verbose` / `--quiet` to control log verbosity.
+
 ## Configuration
 
 Config lives in `.lisa/config.yaml`. Run `lisa init` to create it interactively.
@@ -235,15 +242,24 @@ Acceptance criteria:
 
 ## TUI
 
-The real-time Kanban board shows issue progress, streams provider output, and detects PR merges.
+The real-time Kanban board shows issue progress, streams provider output, and detects PR merges. The sidebar legend updates contextually — only the shortcuts active in the current view are shown.
+
+**Board view**
 
 | Key | Action | Key | Action |
 |-----|--------|-----|--------|
 | `←` `→` | Switch columns | `p` | Pause / resume provider |
-| `↑` `↓` | Navigate cards | `k` | Kill current issue |
-| `↵` | Open detail view | `s` | Skip current issue |
-| `Esc` | Back to board | `o` | Open PR in browser |
-| `q` | Quit | | |
+| `1` `2` `3` | Jump to column | `k` | Kill current issue |
+| `↑` `↓` | Navigate cards | `s` | Skip current issue |
+| `↵` | Open detail view | `q` | Quit |
+
+**Detail view**
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Scroll output log |
+| `o` | Open PR in browser |
+| `Esc` | Back to board |
 
 ## License
 

package/dist/chunk-2TW2MJXF.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+// src/git/github.ts
+import { execa } from "execa";
+
+// src/git/pr-body.ts
+var PROVIDER_ATTRIBUTION_RE = /claude\.ai|claude\s+code|\banthropic\b|gemini\s+cli|\bgoogle\s+gemini\b|openai\s+codex|\bopenai\b|\bgoose\b|\baider\b|github\s+copilot|cursor\s+agent|\bopencode\b|\blisa\b/i;
+var AI_COAUTHOR_RE = /co-authored-by:[^\n]*(anthropic|claude|gemini|openai|codex|goose|aider|copilot|cursor|google)/i;
+function stripProviderAttribution(body) {
+  let result = body;
+  while (true) {
+    const sepIndex = result.lastIndexOf("\n---");
+    if (sepIndex === -1) break;
+    const section = result.slice(sepIndex);
+    if (PROVIDER_ATTRIBUTION_RE.test(section) || AI_COAUTHOR_RE.test(section)) {
+      result = result.slice(0, sepIndex).trimEnd();
+    } else {
+      break;
+    }
+  }
+  result = result.replace(
+    /\n+Co-Authored-By:[^\n]*(anthropic|claude|gemini|openai|codex|goose|aider|copilot|cursor|google)[^\n]*/gi,
+    ""
+  );
+  return result.trimEnd();
+}
+
+// src/git/github.ts
+async function isGhCliAvailable() {
+  try {
+    await execa("gh", ["auth", "status"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var PROVIDER_DISPLAY_NAMES = {
+  claude: "Claude Code",
+  gemini: "Gemini CLI",
+  opencode: "OpenCode",
+  copilot: "GitHub Copilot CLI",
+  cursor: "Cursor Agent",
+  goose: "Goose",
+  aider: "Aider",
+  codex: "OpenAI Codex"
+};
+function formatProviderName(providerUsed) {
+  const providerKey = providerUsed.split("/")[0] ?? providerUsed;
+  return PROVIDER_DISPLAY_NAMES[providerKey] ?? providerKey;
+}
+async function deleteProviderComments(prUrl) {
+  try {
+    const match = prUrl.match(/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/);
+    if (!match) return;
+    const [, owner, repo, prNumber] = match;
+    const { stdout } = await execa("gh", [
+      "api",
+      "--paginate",
+      "--jq",
+      ".[]",
+      `/repos/${owner}/${repo}/issues/${prNumber}/comments`
+    ]);
+    const comments = stdout.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line));
+    for (const comment of comments) {
+      if (PROVIDER_ATTRIBUTION_RE.test(comment.body)) {
+        try {
+          await execa("gh", [
+            "api",
+            "--method",
+            "DELETE",
+            `/repos/${owner}/${repo}/issues/comments/${comment.id}`
+          ]);
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+}
+async function appendPrAttribution(prUrl, providerUsed) {
+  await deleteProviderComments(prUrl);
+  try {
+    const { stdout: bodyJson } = await execa("gh", ["pr", "view", prUrl, "--json", "body"]);
+    const { body } = JSON.parse(bodyJson);
+    const providerName = formatProviderName(providerUsed);
+    const attribution = `
+
+---
+\u{1F916} Resolved by [lisa](https://github.com/tarcisiopgs/lisa) using **${providerName}**`;
+    const newBody = stripProviderAttribution(body ?? "") + attribution;
+    await execa("gh", ["pr", "edit", prUrl, "--body", newBody]);
+  } catch {
+  }
+}
+async function appendPrBody(prUrl, content) {
+  try {
+    const { stdout: bodyJson } = await execa("gh", ["pr", "view", prUrl, "--json", "body"]);
+    const { body } = JSON.parse(bodyJson);
+    const newBody = (body ?? "") + content;
+    await execa("gh", ["pr", "edit", prUrl, "--body", newBody]);
+  } catch {
+  }
+}
+
+// src/errors.ts
+function formatError(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+
+export {
+  stripProviderAttribution,
+  isGhCliAvailable,
+  appendPrAttribution,
+  appendPrBody,
+  formatError
+};

package/dist/{chunk-CDI22S63.js → chunk-3EOEDL3T.js}

@@ -81,7 +81,7 @@ ${newEntryText}`;
 
 ${rotated.join("\n\n")}`;
   }
-  writeFileSync(path, content, "utf-8");
+  writeFileSync(path, content, { encoding: "utf-8", mode: 384 });
 }
 function appendRawEntry(dir, entryText) {
   writeLock = writeLock.then(() => appendRawEntrySync(dir, entryText)).catch(() => {
@@ -108,7 +108,7 @@ ${entryText}`;
 
 ${rotated.join("\n\n")}`;
   }
-  writeFileSync(path, content, "utf-8");
+  writeFileSync(path, content, { encoding: "utf-8", mode: 384 });
 }
 function formatEntry(entry) {
   return [

package/dist/{chunk-AGYOJQBR.js → chunk-42NKASE3.js}

@@ -1,106 +1,15 @@
 #!/usr/bin/env node
+import {
+  formatError,
+  isGhCliAvailable
+} from "./chunk-2TW2MJXF.js";
 
 // src/cli/detection.ts
 import { execSync } from "child_process";
-import { existsSync, readdirSync, readFileSync } from "fs";
+import { existsSync, readdirSync, readFileSync, rmSync } from "fs";
 import { tmpdir } from "os";
 import { join, resolve as resolvePath } from "path";
 import * as clack from "@clack/prompts";
-
-// src/git/github.ts
-import { execa } from "execa";
-
-// src/git/pr-body.ts
-var PROVIDER_ATTRIBUTION_RE = /claude\.ai|claude\s+code|\banthropic\b|gemini\s+cli|\bgoogle\s+gemini\b|openai\s+codex|\bopenai\b|\bgoose\b|\baider\b|github\s+copilot|cursor\s+agent|\bopencode\b|\blisa\b/i;
-var AI_COAUTHOR_RE = /co-authored-by:[^\n]*(anthropic|claude|gemini|openai|codex|goose|aider|copilot|cursor|google)/i;
-function stripProviderAttribution(body) {
-  let result = body;
-  while (true) {
-    const sepIndex = result.lastIndexOf("\n---");
-    if (sepIndex === -1) break;
-    const section = result.slice(sepIndex);
-    if (PROVIDER_ATTRIBUTION_RE.test(section) || AI_COAUTHOR_RE.test(section)) {
-      result = result.slice(0, sepIndex).trimEnd();
-    } else {
-      break;
-    }
-  }
-  result = result.replace(
-    /\n+Co-Authored-By:[^\n]*(anthropic|claude|gemini|openai|codex|goose|aider|copilot|cursor|google)[^\n]*/gi,
-    ""
-  );
-  return result.trimEnd();
-}
-
-// src/git/github.ts
-async function isGhCliAvailable() {
-  try {
-    await execa("gh", ["auth", "status"]);
-    return true;
-  } catch {
-    return false;
-  }
-}
-var PROVIDER_DISPLAY_NAMES = {
-  claude: "Claude Code",
-  gemini: "Gemini CLI",
-  opencode: "OpenCode",
-  copilot: "GitHub Copilot CLI",
-  cursor: "Cursor Agent",
-  goose: "Goose",
-  aider: "Aider",
-  codex: "OpenAI Codex"
-};
-function formatProviderName(providerUsed) {
-  const providerKey = providerUsed.split("/")[0] ?? providerUsed;
-  return PROVIDER_DISPLAY_NAMES[providerKey] ?? providerKey;
-}
-async function deleteProviderComments(prUrl) {
-  try {
-    const match = prUrl.match(/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/);
-    if (!match) return;
-    const [, owner, repo, prNumber] = match;
-    const { stdout } = await execa("gh", [
-      "api",
-      "--paginate",
-      "--jq",
-      ".[]",
-      `/repos/${owner}/${repo}/issues/${prNumber}/comments`
-    ]);
-    const comments = stdout.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line));
-    for (const comment of comments) {
-      if (PROVIDER_ATTRIBUTION_RE.test(comment.body)) {
-        try {
-          await execa("gh", [
-            "api",
-            "--method",
-            "DELETE",
-            `/repos/${owner}/${repo}/issues/comments/${comment.id}`
-          ]);
-        } catch {
-        }
-      }
-    }
-  } catch {
-  }
-}
-async function appendPrAttribution(prUrl, providerUsed) {
-  await deleteProviderComments(prUrl);
-  try {
-    const { stdout: bodyJson } = await execa("gh", ["pr", "view", prUrl, "--json", "body"]);
-    const { body } = JSON.parse(bodyJson);
-    const providerName = formatProviderName(providerUsed);
-    const attribution = `
-
----
-\u{1F916} Resolved by [lisa](https://github.com/tarcisiopgs/lisa) using **${providerName}**`;
-    const newBody = stripProviderAttribution(body ?? "") + attribution;
-    await execa("gh", ["pr", "edit", prUrl, "--body", newBody]);
-  } catch {
-  }
-}
-
-// src/cli/detection.ts
 function getVersion() {
   try {
     const pkgPath = resolvePath(new URL(".", import.meta.url).pathname, "../package.json");
@@ -112,7 +21,7 @@ function getVersion() {
 }
 var CURSOR_FREE_PLAN_ERROR = "Free plans can only use Auto";
 async function isCursorFreePlan() {
-  const { mkdtempSync, unlinkSync, writeFileSync } = await import("fs");
+  const { mkdtempSync, writeFileSync } = await import("fs");
   const tmpDir = mkdtempSync(join(tmpdir(), "lisa-cursor-check-"));
   const promptFile = join(tmpDir, "prompt.txt");
   writeFileSync(promptFile, "test", "utf-8");
@@ -133,15 +42,11 @@ async function isCursorFreePlan() {
     });
     return output.includes(CURSOR_FREE_PLAN_ERROR);
   } catch (err) {
-    const errorOutput = err instanceof Error ? err.message : String(err);
+    const errorOutput = formatError(err);
     return errorOutput.includes(CURSOR_FREE_PLAN_ERROR);
   } finally {
     try {
-      unlinkSync(promptFile);
-    } catch {
-    }
-    try {
-      execSync(`rm -rf ${tmpDir}`, { stdio: "ignore" });
+      rmSync(tmpDir, { recursive: true, force: true });
     } catch {
     }
   }
@@ -343,9 +248,6 @@ async function getMissingEnvVars(source) {
 }
 
 export {
-  stripProviderAttribution,
-  isGhCliAvailable,
-  appendPrAttribution,
   getVersion,
   isCursorFreePlan,
   fetchCursorModels,