@tarcisiopgs/lisa 1.28.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,13 +39,13 @@ 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
-- **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
@@ -83,21 +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 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
+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.
@@ -242,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**
 
@@ -261,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-W73XGHD4.js → chunk-KDAXGOFF.js}

@@ -2917,18 +2917,56 @@ function installSignalHandlers(onBeforeExit) {
 
 // src/loop/demo.ts
 async function runDemoLoop() {
-  const demoIssues = [
-    { id: "INT-514", title: "Dark mode UI" },
-    { id: "INT-513", title: "WebSocket leak fix" },
-    { id: "INT-512", title: "Rate limiter middleware" },
-    { id: "INT-511", title: "Sidebar navigation icons" },
-    { id: "INT-510", title: "Blog post CRUD" },
-    { id: "INT-509", title: "Admin FAQ management" },
-    { id: "INT-508", title: "Changelog CRUD" }
-  ];
   await sleep(3e3);
   kanbanEmitter.emit("provider:model-changed", "claude-sonnet-4-6");
-  await sleep(400);
+  kanbanEmitter.emit("work:empty");
+  await sleep(2e3);
+  kanbanEmitter.emit("demo:open-plan", "Add a FAQ section to the web app");
+  await sleep(2500);
+  const plannedIssues = [
+    {
+      title: "Add FAQ shared types to @playground/shared",
+      description: "Create TypeScript interfaces for FAQ data models",
+      order: 1,
+      dependsOn: [],
+      relevantFiles: ["packages/shared/src/types/faq.ts"],
+      acceptanceCriteria: ["FAQ type exported", "Tests pass"]
+    },
+    {
+      title: "Create GET /faq API route returning FAQ data",
+      description: "Add Fastify route that returns FAQ entries as JSON",
+      order: 2,
+      dependsOn: [1],
+      relevantFiles: ["apps/api/src/routes/faq.ts"],
+      acceptanceCriteria: ["GET /faq returns 200", "Response matches schema"]
+    },
+    {
+      title: "Create FAQ page with accordion UI",
+      description: "Build the FAQ page component with expandable sections",
+      order: 3,
+      dependsOn: [1, 2],
+      relevantFiles: ["apps/web/src/pages/faq.tsx"],
+      acceptanceCriteria: ["Page renders FAQ items", "Accordion expands/collapses"]
+    },
+    {
+      title: "Add FAQ link to the navigation menu",
+      description: "Add a navigation entry pointing to the FAQ page",
+      order: 4,
+      dependsOn: [3],
+      relevantFiles: ["apps/web/src/components/nav.tsx"],
+      acceptanceCriteria: ["Link visible in nav", "Navigates to /faq"]
+    }
+  ];
+  kanbanEmitter.emit("plan:issues-ready", plannedIssues);
+  await sleep(3e3);
+  kanbanEmitter.emit("demo:approve-plan");
+  await sleep(500);
+  const demoIssues = [
+    { id: "INT-601", title: "Add FAQ shared types to @playground/shared" },
+    { id: "INT-602", title: "Create GET /faq API route returning FAQ data" },
+    { id: "INT-603", title: "Create FAQ page with accordion UI" },
+    { id: "INT-604", title: "Add FAQ link to the navigation menu" }
+  ];
   for (const issue of demoIssues) {
     kanbanEmitter.emit("issue:queued", {
       id: issue.id,
@@ -2938,57 +2976,27 @@ async function runDemoLoop() {
     });
     await sleep(200);
   }
-  await sleep(1e3);
-  const issue1 = demoIssues[0];
-  kanbanEmitter.emit("issue:started", issue1.id);
-  const outputs1 = [
-    "Reading issue description...\n",
-    "Analyzing codebase structure...\n",
-    "Creating src/theme/dark-mode.ts...\n",
-    "Updating CSS variables for dark palette...\n",
-    "Adding toggle component...\n",
-    "Running tests... all passing \u2713\n",
-    "Pushing branch int-514-dark-mode-ui...\n"
-  ];
-  for (const line of outputs1) {
-    kanbanEmitter.emit("issue:output", issue1.id, line);
-    await sleep(500);
-  }
-  kanbanEmitter.emit("issue:done", issue1.id, ["https://github.com/acme/webapp/pull/91"]);
-  await sleep(1e3);
-  const issue2 = demoIssues[1];
-  kanbanEmitter.emit("issue:started", issue2.id);
-  const outputs2 = [
-    "Reading issue description...\n",
-    "Locating WebSocket connection handler...\n",
-    "Patching connection lifecycle in src/ws/handler.ts...\n",
-    "Adding cleanup in disconnect callback...\n",
-    "Running tests... all passing \u2713\n",
-    "Pushing branch int-513-fix-ws-leak...\n"
-  ];
-  for (const line of outputs2) {
-    kanbanEmitter.emit("issue:output", issue2.id, line);
-    await sleep(500);
-  }
-  kanbanEmitter.emit("issue:done", issue2.id, ["https://github.com/acme/webapp/pull/92"]);
-  await sleep(1e3);
-  const issue3 = demoIssues[2];
-  kanbanEmitter.emit("issue:started", issue3.id);
-  const outputs3 = [
-    "Reading issue description...\n",
-    "Creating src/middleware/rateLimiter.ts...\n",
-    "Writing sliding window rate limiter...\n",
-    "Adding tests in rateLimiter.test.ts...\n",
-    "Running tests... all passing \u2713\n",
-    "Pushing branch int-512-rate-limiting...\n"
-  ];
-  for (const line of outputs3) {
-    kanbanEmitter.emit("issue:output", issue3.id, line);
-    await sleep(500);
+  kanbanEmitter.emit("work:resumed");
+  await sleep(1500);
+  for (let i = 0; i < demoIssues.length; i++) {
+    const issue = demoIssues[i];
+    kanbanEmitter.emit("issue:started", issue.id);
+    const steps = [
+      "Reading issue description...\n",
+      "Analyzing codebase...\n",
+      "Implementing changes...\n",
+      "Running tests... all passing \u2713\n",
+      `Pushing branch feat/${issue.id.toLowerCase()}...
+`
+    ];
+    for (const step of steps) {
+      kanbanEmitter.emit("issue:output", issue.id, step);
+      await sleep(400);
+    }
+    kanbanEmitter.emit("issue:done", issue.id, [`https://github.com/acme/webapp/pull/${90 + i}`]);
+    await sleep(800);
   }
-  kanbanEmitter.emit("issue:done", issue3.id, ["https://github.com/acme/webapp/pull/93"]);
-  await sleep(1e3);
-  kanbanEmitter.emit("work:complete", { total: 3, duration: 127e3 });
+  kanbanEmitter.emit("work:complete", { total: 4, duration: 185e3 });
   await sleep(4e3);
   kanbanEmitter.emit("tui:exit");
 }

package/dist/index.js

@@ -36,7 +36,7 @@ import {
   runLoop,
   saveConfig,
   validateConfig
-} from "./chunk-W73XGHD4.js";
+} from "./chunk-KDAXGOFF.js";
 import {
   createProvider,
   createSource,
@@ -1286,7 +1286,7 @@ async function reviewAndCreate(plan2, planPath, opts) {
     log("Run `lisa run` when ready.");
     return;
   }
-  const { runLoop: runLoop2 } = await import("./loop-KNJIRK7T.js");
+  const { runLoop: runLoop2 } = await import("./loop-SXI4PQOI.js");
   await runLoop2(config2, {
     once: false,
     watch: false,
@@ -1637,7 +1637,7 @@ async function executeRun(args) {
     if (isTTY) {
       const { render } = await import("ink");
       const { createElement } = await import("react");
-      const { KanbanApp } = await import("./kanban-2WMA5VPQ.js");
+      const { KanbanApp } = await import("./kanban-HFUBTOF4.js");
       const demoConfig = {
         provider: "claude",
         source: "linear",
@@ -1745,7 +1745,7 @@ Add them to your ${shell} and run: source ${shell}`));
     };
     const { render } = await import("ink");
     const { createElement } = await import("react");
-    const { KanbanApp } = await import("./kanban-2WMA5VPQ.js");
+    const { KanbanApp } = await import("./kanban-HFUBTOF4.js");
     render(createElement(KanbanApp, { config: merged, initialCards }), { exitOnCtrlC: false });
   }
   await runLoop(merged, {

package/dist/{kanban-2WMA5VPQ.js → kanban-HFUBTOF4.js}

@@ -1016,15 +1016,28 @@ function KanbanApp({ config, initialCards = [] }) {
         return next;
       });
     };
+    const onDemoOpenPlan = (userMessage) => {
+      setActiveView("plan-chat");
+      setPlanMessages([{ role: "user", content: userMessage }]);
+      setPlanGoal(userMessage);
+      setPlanThinking(true);
+    };
+    const onDemoApprovePlan = () => {
+      setActiveView("board");
+    };
     kanbanEmitter.on("plan:ai-message", onAiMessage);
     kanbanEmitter.on("plan:thinking", onThinking);
     kanbanEmitter.on("plan:issues-ready", onIssuesReady);
     kanbanEmitter.on("plan:edit-result", onEditResult);
+    kanbanEmitter.on("demo:open-plan", onDemoOpenPlan);
+    kanbanEmitter.on("demo:approve-plan", onDemoApprovePlan);
     return () => {
       kanbanEmitter.off("plan:ai-message", onAiMessage);
       kanbanEmitter.off("plan:thinking", onThinking);
       kanbanEmitter.off("plan:issues-ready", onIssuesReady);
       kanbanEmitter.off("plan:edit-result", onEditResult);
+      kanbanEmitter.off("demo:open-plan", onDemoOpenPlan);
+      kanbanEmitter.off("demo:approve-plan", onDemoApprovePlan);
     };
   }, []);
   const backlog = [...cards.filter((c) => c.column === "backlog")].sort((a, b) => {

package/dist/{loop-KNJIRK7T.js → loop-SXI4PQOI.js}

@@ -3,7 +3,7 @@ import {
   checkoutBaseBranches,
   runDemoLoop,
   runLoop
-} from "./chunk-W73XGHD4.js";
+} from "./chunk-KDAXGOFF.js";
 import {
   WATCH_POLL_INTERVAL_MS
 } from "./chunk-UXVSQQID.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarcisiopgs/lisa",
-  "version": "1.28.0",
+  "version": "1.28.1",
   "description": "Autonomous issue resolver",
   "keywords": [
     "loop",