@tarcisiopgs/lisa 1.27.0 → 1.28.1

package/README.md

@@ -1,7 +1,7 @@
 # Lisa
 
 <p align="center">
-  <strong>Label an issue. Walk away. Come back to a PR.</strong>
+  <strong>Plan issues. Run agents. Get PRs.</strong>
 </p>
 
 <p align="center">
@@ -15,23 +15,23 @@
   <img src="assets/demo.gif" alt="Lisa demo" />
 </p>
 
-Lisa connects your issue tracker to an AI coding agent and delivers pull requests — autonomously. Tag an issue with a label, Lisa picks it up, implements it, opens a PR, and updates your board. No babysitting.
+Lisa connects your issue tracker to an AI coding agent and delivers pull requests — autonomously. Describe a goal, Lisa decomposes it into issues, picks them up, implements each one, opens PRs, and updates your board. No babysitting.
 
 ## Quickstart
 
 ```bash
 npm install -g @tarcisiopgs/lisa
 lisa init    # interactive setup wizard
-lisa run
+lisa         # start the agent loop
 ```
 
 ## How It Works
 
 ```
-  Fetch issue → Activate → Build context → Implement → Push → Open PR → Update board → Next
+  Plan → Create issues → Fetch → Implement → Push → Open PR → Update board → Next
 ```
 
-Lisa picks the highest-priority labeled issue, moves it to "In Progress", sends a structured prompt to the AI agent, and monitors execution. The agent works in an isolated git worktree, implements the change, runs tests, and commits. Lisa pushes, opens a PR, moves the ticket to "In Review", and picks up the next one.
+Lisa starts and shows a Kanban board. If the queue is empty, press `n` to plan — describe a goal and the AI decomposes it into atomic issues, created directly in your tracker. Press `r` to start processing. Lisa picks the highest-priority labeled issue, moves it to "In Progress", sends a structured prompt to the AI agent, and monitors execution. The agent works in an isolated git worktree, implements the change, runs tests, and commits. Lisa pushes, opens a PR, moves the ticket to "In Review", and picks up the next one.
 
 If something fails — pre-push hooks, quota limits, stuck processes — Lisa handles it: retries with error context, falls back to the next model, or kills and moves on.
 
@@ -39,10 +39,11 @@ If something fails — pre-push hooks, quota limits, stuck processes — Lisa ha
 
 - **7 issue trackers** — Linear, GitHub Issues, GitLab Issues, Jira, Trello, Plane, Shortcut
 - **8 AI agents** — Claude Code, Gemini CLI, GitHub Copilot CLI, Cursor Agent, Aider, Goose, OpenCode, Codex
+- **AI planning** — describe a goal, the AI decomposes it into issues with dependencies, created in your tracker
 - **Concurrent execution** — process multiple issues in parallel, each in its own worktree
 - **Multi-repo** — plans across repos, creates one PR per repo in the correct order
 - **Model fallback** — chain models; transient errors (429, quota, timeout) auto-switch to the next
-- **Real-time TUI** — Kanban board with live provider output, keyboard controls, PR merge detection
+- **Real-time TUI** — Kanban board with live provider output, plan mode, 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
 - **Project context** — auto-generates `.lisa/context.md` with your stack, conventions, and constraints
@@ -82,18 +83,21 @@ provider_options:
 ## Commands
 
 ```bash
-lisa run                     # start the agent loop
-lisa run --once              # process a single issue
-lisa run --once --dry-run    # preview config without executing
-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 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
+lisa                        # start the agent loop (Kanban TUI)
+lisa --once                 # process a single issue
+lisa --once --dry-run       # preview config without executing
+lisa --watch                # poll for new issues after queue empties
+lisa -c 3                   # process 3 issues in parallel
+lisa --issue INT-42         # process a specific issue
+lisa --limit 5              # stop after 5 issues
+lisa plan "Add rate limiting" # decompose goal into issues via AI (CLI mode)
+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.
@@ -238,16 +242,16 @@ Acceptance criteria:
 
 ## TUI
 
-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.
+The real-time Kanban board shows issue progress, streams provider output, and detects PR merges. When the queue is empty, Lisa enters idle mode — plan new issues with `n`, then start processing with `r`.
 
 **Board view**
 
 | Key | Action | Key | Action |
 |-----|--------|-----|--------|
-| `←` `→` | Switch columns | `p` | Pause / resume provider |
-| `1` `2` `3` | Jump to column | `k` | Kill current issue |
-| `↑` `↓` | Navigate cards | `s` | Skip current issue |
-| `↵` | Open detail view | `q` | Quit |
+| `←` `→` | Switch columns | `k` | Kill current issue |
+| `↑` `↓` | Navigate cards | `n` | Open plan mode |
+| `↵` | Open detail view | `r` | Run (from idle) |
+| `p` | Pause / resume | `q` | Quit |
 
 **Detail view**
 
@@ -257,6 +261,16 @@ The real-time Kanban board shows issue progress, streams provider output, and de
 | `o` | Open PR in browser |
 | `Esc` | Back to board |
 
+**Plan mode**
+
+| Key | Action |
+|-----|--------|
+| `↵` | Send message / view detail |
+| `e` | Edit issue in $EDITOR |
+| `d` | Delete issue |
+| `a` | Approve and create issues |
+| `Esc` | Cancel / back |
+
 ## License
 
 [MIT](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-JRCAT5PI.js → chunk-42NKASE3.js}

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+import {
+  formatError,
+  isGhCliAvailable
+} from "./chunk-2TW2MJXF.js";
 
 // src/cli/detection.ts
 import { execSync } from "child_process";
@@ -6,115 +10,6 @@ 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/errors.ts
-function formatError(err) {
-  return err instanceof Error ? err.message : String(err);
-}
-
-// 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/cli/detection.ts
 function getVersion() {
   try {
     const pkgPath = resolvePath(new URL(".", import.meta.url).pathname, "../package.json");
@@ -353,11 +248,6 @@ async function getMissingEnvVars(source) {
 }
 
 export {
-  stripProviderAttribution,
-  isGhCliAvailable,
-  appendPrAttribution,
-  appendPrBody,
-  formatError,
   getVersion,
   isCursorFreePlan,
   fetchCursorModels,

package/dist/{chunk-SSSFEMF4.js → chunk-5N4BWHIT.js}

@@ -3,13 +3,6 @@ import {
   notify
 } from "./chunk-72CYGBT4.js";
 
-// src/ui/state.ts
-import { EventEmitter } from "events";
-import { useEffect, useState } from "react";
-
-// src/sources/github-issues.ts
-import { execa } from "execa";
-
 // src/output/logger.ts
 import { appendFileSync, existsSync, mkdirSync, writeFileSync } from "fs";
 import { dirname } from "path";
@@ -100,6 +93,13 @@ function updateNotice(update) {
 `));
 }
 
+// src/ui/state.ts
+import { EventEmitter } from "events";
+import { useEffect, useState } from "react";
+
+// src/sources/github-issues.ts
+import { execa } from "execa";
+
 // src/sources/base.ts
 var REQUEST_TIMEOUT_MS = 3e4;
 function normalizeLabels(config) {
@@ -425,6 +425,16 @@ var GitHubIssuesSource = class {
     } catch {
     }
   }
+  async createIssue(opts, config) {
+    const { owner, repo } = parseOwnerRepo(config.scope);
+    const labels = Array.isArray(opts.label) ? opts.label : [opts.label];
+    const issue = await api().post(`/repos/${owner}/${repo}/issues`, {
+      title: opts.title,
+      body: opts.description,
+      labels
+    });
+    return makeIssueId(owner, repo, issue.number);
+  }
 };
 
 // src/sources/gitlab-issues.ts
@@ -642,6 +652,30 @@ var GitLabIssuesSource = class {
       labels: filtered.join(",")
     });
   }
+  async createIssue(opts, config) {
+    const encodedProject = parseGitLabProject(config.scope);
+    const labels = Array.isArray(opts.label) ? opts.label : [opts.label];
+    const issue = await api2().post(`/projects/${encodedProject}/issues`, {
+      title: opts.title,
+      description: opts.description,
+      labels: labels.join(","),
+      ...opts.order !== void 0 && { weight: opts.order }
+    });
+    return makeIssueId2(config.scope, issue.iid);
+  }
+  async linkDependency(issueId, dependsOnId) {
+    const source = splitIssueId(issueId);
+    const target = splitIssueId(dependsOnId);
+    const encodedProject = parseGitLabProject(source.project);
+    const projectInfo = await api2().get(
+      `/projects/${parseGitLabProject(target.project)}`
+    );
+    await api2().post(`/projects/${encodedProject}/issues/${source.iid}/links`, {
+      target_project_id: projectInfo.id,
+      target_issue_iid: Number(target.iid),
+      link_type: "is_blocked_by"
+    });
+  }
 };
 function parseGitLabProject(input) {
   if (/^\d+$/.test(input)) return input;
@@ -874,6 +908,7 @@ function useKanbanState(bellEnabled, initialCards = []) {
     const onModelChanged = (model) => setModelInUse(model);
     kanbanEmitter.on("provider:model-changed", onModelChanged);
     const onEmpty = () => setIsEmpty(true);
+    const onResumed = () => setIsEmpty(false);
     const onComplete = (data) => setWorkComplete(data);
     const onWatching = () => setIsWatching(true);
     const onWatchResume = () => setIsWatching(false);
@@ -883,6 +918,7 @@ function useKanbanState(bellEnabled, initialCards = []) {
     };
     const onWatchPromptResolved = () => setIsWatchPrompt(false);
     kanbanEmitter.on("work:empty", onEmpty);
+    kanbanEmitter.on("work:resumed", onResumed);
     kanbanEmitter.on("work:complete", onComplete);
     kanbanEmitter.on("work:watching", onWatching);
     kanbanEmitter.on("work:watch-resume", onWatchResume);
@@ -909,6 +945,7 @@ function useKanbanState(bellEnabled, initialCards = []) {
       kanbanEmitter.off("issue:output", onOutput);
       kanbanEmitter.off("provider:model-changed", onModelChanged);
       kanbanEmitter.off("work:empty", onEmpty);
+      kanbanEmitter.off("work:resumed", onResumed);
       kanbanEmitter.off("work:complete", onComplete);
       kanbanEmitter.off("work:watching", onWatching);
       kanbanEmitter.off("work:watch-resume", onWatchResume);