@tarcisiopgs/lisa 1.7.5 → 1.7.7

package/README.md

@@ -14,8 +14,6 @@
 
 ---
 
-<!-- Add a GIF or screen recording of the full pipeline here (fetch → implement → PR) -->
-
 ## Quickstart
 
 ```bash
@@ -57,9 +55,9 @@ Lisa follows a deterministic pipeline:
 
 1. **Fetch** — Pulls the next issue from Linear, Trello, Plane, Shortcut, GitLab Issues, GitHub Issues, or Jira matching the configured label, team, and project. Issues are sorted by priority. Blocked issues are skipped.
 2. **Activate** — Moves the issue to `in_progress` so your team knows it's being worked on.
-3. **Implement** — Builds a structured prompt with full issue context and sends it to the AI agent. The agent works in a worktree or branch, implements the change, and commits.
-4. **Validate** — Runs the project's test suite. If tests fail, the session is aborted and the issue reverts.
-5. **PR** — Pushes the branch and creates a pull request referencing the original issue. If pre-push hooks fail, Lisa re-invokes the agent to fix the errors and retries.
+3. **Implement** — Builds a structured prompt with full issue context and sends it to the AI agent. The agent works in a worktree or branch, implements the change, runs tests, and commits.
+4. **Validate** — If the agent's tests pass and pre-push hooks succeed, the branch is pushed. If hooks fail, Lisa re-invokes the agent with the error output and retries.
+5. **PR** — Pushes the branch and creates a pull request referencing the original issue. The PR body includes a footer crediting the provider that resolved it.
 6. **Update** — Moves the issue to the `done` status and removes the pickup label.
 7. **Next** — Picks the next issue. When there are no more matching issues, Lisa stops.
 
@@ -75,18 +73,20 @@ Lisa follows a deterministic pipeline:
 
 ## Providers
 
-| Provider | CLI | Auto-approve Flag |
-|----------|-----|-------------------|
-| Claude Code | `claude` | `--dangerously-skip-permissions` |
-| Gemini CLI | `gemini` | `--yolo` |
-| OpenCode | `opencode` | implicit in `run` |
-| GitHub Copilot CLI | `copilot` | `--allow-all` |
-| Cursor Agent | `agent` | `--force` |
-| Goose | `goose` | implicit in `run` |
-| Aider | `aider` | `--yes-always` |
+| Provider | Key | Command |
+|----------|-----|---------|
+| Claude Code | `claude` | `claude` |
+| Gemini CLI | `gemini` | `gemini` |
+| OpenCode | `opencode` | `opencode` |
+| GitHub Copilot CLI | `copilot` | `copilot` |
+| Cursor Agent | `cursor` | `agent` / `cursor-agent` |
+| Goose | `goose` | `goose` |
+| Aider | `aider` | `aider` |
 
 At least one provider must be installed and available in your PATH.
 
+> **Cursor Free plan** — `lisa init` automatically detects Free accounts and restricts model selection to `auto` only. On paid plans, a curated list of top-tier models is shown (`composer-1.5`, `opus-4.6`, `sonnet-4.6`, `gpt-5.3-codex`, etc.).
+
 ### Fallback Chain
 
 Configure multiple models — Lisa tries each in order. Transient errors (429, quota, timeout, network) trigger the next model; non-transient errors stop the chain.
@@ -108,7 +108,7 @@ npm install -g @tarcisiopgs/lisa
 ## Environment Variables
 
 ```bash
-# Required (at least one)
+# Required for PR creation (at least one)
 export GITHUB_TOKEN=""    # or have `gh` CLI authenticated
 
 # Required when source = linear
@@ -150,16 +150,48 @@ export JIRA_API_TOKEN=""       # Atlassian API token
 | `lisa run --limit N` | Process up to N issues |
 | `lisa run --dry-run` | Preview without executing |
 | `lisa run --provider NAME` | Override AI provider |
-| `lisa run --source NAME` | Override issue source (linear, trello, plane, shortcut, gitlab-issues, github-issues, jira) |
+| `lisa run --source NAME` | Override issue source |
 | `lisa run --label NAME` | Override label filter |
-| `lisa run --github METHOD` | Override GitHub method (cli, token) |
+| `lisa run --github METHOD` | Override GitHub method (`cli` or `token`) |
 | `lisa run --json` | Output as JSON lines |
 | `lisa run --quiet` | Suppress non-essential output |
-| `lisa config` | Interactive config wizard |
-| `lisa config --show` | Show current config |
-| `lisa config --set key=value` | Set a config value |
-| `lisa init` | Create `.lisa/config.yaml` |
+| `lisa init` | Create `.lisa/config.yaml` interactively |
+| `lisa config` | Edit config interactively |
+| `lisa config --show` | Print current config as JSON |
+| `lisa config --set key=value` | Set a single config value |
 | `lisa status` | Show session stats |
+| `lisa issue get <id>` | Fetch full issue details as JSON (for use inside worktrees) |
+| `lisa issue done <id> --pr-url <url>` | Complete issue, attach PR, update status, remove label |
+
+## TUI
+
+When running in an interactive terminal, `lisa run` renders a real-time Kanban board:
+
+```
+┌──────────────────────────┐ ┌───────────────────────────┐ ┌───────────────────────────┐
+│ ▶ BACKLOG            [3] │ │ ▶ IN PROGRESS         [1] │ │ ▶ IN REVIEW           [2] │
+│                          │ │                           │ │                           │
+│ ┌────────────────────┐   │ │ ┌─────────────────────┐   │ │ ┌─────────────────────┐   │
+│ │ ENG-42             │   │ │ │ ● ENG-38             │   │ │ │ ✓ ENG-35            │   │
+│ │ Add dark mode      │   │ │ │ Fix login redirect   │   │ │ │ Update dependencies │   │
+│ │ ready              │   │ │ │ ~1 running           │   │ │ │ PR created          │   │
+│ └────────────────────┘   │ │ └─────────────────────┘   │ │ └─────────────────────┘   │
+└──────────────────────────┘ └───────────────────────────┘ └───────────────────────────┘
+```
+
+### Keyboard shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Tab` | Move to next column |
+| `Shift+Tab` | Move to previous column |
+| `↑` / `↓` | Navigate cards / scroll output |
+| `Enter` | Open issue detail view (streams provider output) |
+| `Esc` | Close detail view, return to board |
+| `p` | Pause / resume — loop finishes the current issue then waits |
+| `q` | Quit |
+
+The sidebar legend updates contextually: board shortcuts when browsing the Kanban, scroll and back hints when viewing issue detail. The terminal tab title also updates in real time: it shows a spinner with the active issue ID while work is in progress, and a checkmark when done.
 
 ## Configuration
 

package/dist/index.js

@@ -179,6 +179,33 @@ async function isGhCliAvailable() {
     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"
+};
+function formatProviderName(providerUsed) {
+  const providerKey = providerUsed.split("/")[0] ?? providerUsed;
+  return PROVIDER_DISPLAY_NAMES[providerKey] ?? providerKey;
+}
+async function appendPrAttribution(prUrl, providerUsed) {
+  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 = (body ?? "") + attribution;
+    await execa("gh", ["pr", "edit", prUrl, "--body", newBody]);
+  } catch {
+  }
+}
 
 // src/git/worktree.ts
 import { appendFileSync, existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
@@ -3127,6 +3154,13 @@ function createSource(name) {
 var activeCleanup = null;
 var activeProviderPid = null;
 var shuttingDown = false;
+var loopPaused = false;
+kanbanEmitter.on("loop:pause", () => {
+  loopPaused = true;
+});
+kanbanEmitter.on("loop:resume", () => {
+  loopPaused = false;
+});
 function resolveModels(config2) {
   if (!config2.models || config2.models.length === 0) {
     return [{ provider: config2.provider }];
@@ -3293,6 +3327,7 @@ 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);
+    await waitIfPaused();
     startSpinner("fetching issue...");
     if (opts.issueId) {
       log(`Fetching issue '${opts.issueId}' from ${config2.source}...`);
@@ -3602,6 +3637,7 @@ ${result.output}
   }
   const worktreePath = await findWorktreeForBranch(repoPath, manifest.branch ?? "");
   ok(`PR created by provider: ${manifest.prUrl}`);
+  await appendPrAttribution(manifest.prUrl, result.providerUsed);
   if (worktreePath) await cleanupWorktree(repoPath, worktreePath);
   ok(`Session ${session} complete for ${issue2.id}`);
   return {
@@ -3708,6 +3744,7 @@ ${result.output}
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
   ok(`PR created by provider: ${manifest.prUrl}`);
+  await appendPrAttribution(manifest.prUrl, result.providerUsed);
   await cleanupWorktree(repoPath, worktreePath);
   ok(`Session ${session} complete for ${issue2.id}`);
   return {
@@ -3896,6 +3933,7 @@ ${result.output}
     return { ...failResult(result.providerUsed, result), branch: branchName };
   }
   await cleanupWorktree(repoPath, worktreePath);
+  await appendPrAttribution(manifest.prUrl, result.providerUsed);
   ok(`Step ${stepNum} complete: ${repoPath} \u2014 PR: ${manifest.prUrl}`);
   return {
     success: true,
@@ -3976,6 +4014,7 @@ ${result.output}
     return { success: false, providerUsed: result.providerUsed, prUrls: [], fallback: result };
   }
   ok(`PR created by provider: ${manifest.prUrl}`);
+  await appendPrAttribution(manifest.prUrl, result.providerUsed);
   ok(`Session ${session} complete for ${issue2.id}`);
   return {
     success: true,
@@ -3995,6 +4034,11 @@ async function cleanupWorktree(repoRoot, worktreePath) {
 function sleep(ms) {
   return new Promise((resolve6) => setTimeout(resolve6, ms));
 }
+async function waitIfPaused() {
+  while (loopPaused) {
+    await sleep(500);
+  }
+}
 
 // src/cli.ts
 function sleep2(ms) {
@@ -4051,7 +4095,7 @@ Add them to your ${shell} and run: source ${shell}`));
     if (isTUI) {
       const { render } = await import("ink");
       const { createElement } = await import("react");
-      const { KanbanApp } = await import("./kanban-YP3TJJUT.js");
+      const { KanbanApp } = await import("./kanban-5C3WZIKC.js");
       render(createElement(KanbanApp, { config: merged }), { exitOnCtrlC: false });
     }
     await runLoop(merged, {
@@ -4247,15 +4291,21 @@ var issue = defineCommand({
   meta: { name: "issue", description: "Issue tracker operations for use inside worktrees" },
   subCommands: { get: issueGet, done: issueDone }
 });
-var CURSOR_MODELS_FALLBACK = [
+var CURSOR_PREFERRED_MODELS = [
   "auto",
   "composer-1.5",
+  "composer-1",
+  "gpt-5.3-codex",
+  "gpt-5.2",
+  "gpt-5.1-codex-max",
   "opus-4.6-thinking",
   "opus-4.6",
+  "sonnet-4.6-thinking",
   "sonnet-4.6",
-  "gpt-5.3-codex",
-  "gpt-5.2",
-  "gemini-3.1-pro"
+  "gemini-3.1-pro",
+  "gemini-3-pro",
+  "grok",
+  "kimi-k2.5"
 ];
 function fetchCursorModels() {
   try {
@@ -4267,13 +4317,14 @@ function fetchCursorModels() {
         return false;
       }
     });
-    if (!bin) return CURSOR_MODELS_FALLBACK;
+    if (!bin) return CURSOR_PREFERRED_MODELS;
     const raw = execSync8(`${bin} --list-models`, { encoding: "utf-8", timeout: 1e4 });
     const clean = raw.replace(/\x1b\[[0-9;]*[mGKHFA-Z]/g, "");
-    const models = clean.split("\n").map((l) => l.trim()).filter((l) => l.includes(" - ")).map((l) => (l.split(" - ")[0] ?? "").trim()).filter(Boolean);
-    return models.length > 0 ? models : CURSOR_MODELS_FALLBACK;
+    const all = clean.split("\n").map((l) => l.trim()).filter((l) => l.includes(" - ")).map((l) => (l.split(" - ")[0] ?? "").trim()).filter(Boolean);
+    const filtered = CURSOR_PREFERRED_MODELS.filter((m) => all.includes(m));
+    return filtered.length > 0 ? filtered : CURSOR_PREFERRED_MODELS;
   } catch {
-    return CURSOR_MODELS_FALLBACK;
+    return CURSOR_PREFERRED_MODELS;
   }
 }
 function fetchOpenCodeModels() {

package/dist/{kanban-YP3TJJUT.js → kanban-5C3WZIKC.js}

@@ -337,11 +337,7 @@ function IssueDetail({ card, onBack }) {
         ] }) : visibleLines.map((line, i) => (
           // biome-ignore lint/suspicious/noArrayIndexKey: log lines have no stable key
           /* @__PURE__ */ jsx4(Text4, { color: "white", dimColor: true, children: line }, i)
-        )) }),
-        /* @__PURE__ */ jsxs4(Box4, { justifyContent: "space-between", borderStyle: "single", borderColor: "gray", paddingX: 1, children: [
-          /* @__PURE__ */ jsx4(Text4, { color: "gray", dimColor: true, children: "[\u2191\u2193] scroll" }),
-          /* @__PURE__ */ jsx4(Text4, { color: "yellow", dimColor: true, children: "[Esc] back to board" })
-        ] })
+        )) })
       ]
     }
   );
@@ -352,14 +348,15 @@ import { existsSync } from "fs";
 import { basename, join } from "path";
 import { Box as Box5, Text as Text5 } from "ink";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
-function Sidebar({ provider, source, cwd }) {
-  const dir = basename(cwd);
+function Sidebar({ provider, source, cwd, activeView, paused = false }) {
+  const dir = basename(cwd).toUpperCase();
   const cwdLabel = existsSync(join(cwd, ".git")) ? "REPOSITORY" : "WORKSPACE";
   return /* @__PURE__ */ jsxs5(
     Box5,
     {
       flexDirection: "column",
       width: 28,
+      flexShrink: 0,
       borderStyle: "single",
       borderColor: "yellow",
       paddingX: 1,
@@ -377,8 +374,8 @@ function Sidebar({ provider, source, cwd }) {
           /* @__PURE__ */ jsx5(Text5, { color: "yellow", children: "\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D" })
         ] }),
         /* @__PURE__ */ jsxs5(Box5, { marginBottom: 1, children: [
-          /* @__PURE__ */ jsx5(Text5, { color: "green", children: "\u25B6 " }),
-          /* @__PURE__ */ jsx5(Text5, { color: "green", bold: true, children: "RUNNING" })
+          /* @__PURE__ */ jsx5(Text5, { color: paused ? "yellow" : "green", children: paused ? "\u23F8 " : "\u25B6 " }),
+          /* @__PURE__ */ jsx5(Text5, { color: paused ? "yellow" : "green", bold: true, children: paused ? "PAUSED" : "RUNNING" })
         ] }),
         /* @__PURE__ */ jsx5(Text5, { color: "yellow", children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }),
         /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", marginTop: 1, children: [
@@ -404,11 +401,15 @@ function Sidebar({ provider, source, cwd }) {
         ] }),
         /* @__PURE__ */ jsx5(Box5, { flexGrow: 1 }),
         /* @__PURE__ */ jsx5(Text5, { color: "yellow", children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }),
-        /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
+        activeView === "board" ? /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
           /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[Tab]  next column" }),
           /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[\u2191\u2193]  navigate    " }),
           /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[\u21B5]   view detail " }),
+          /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: paused ? "[p]   resume      " : "[p]   pause       " }),
           /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[q]   quit        " })
+        ] }) : /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
+          /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[\u2191\u2193]  scroll      " }),
+          /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[Esc] back to board" })
         ] })
       ]
     }
@@ -423,6 +424,7 @@ function KanbanApp({ config }) {
   const [activeView, setActiveView] = useState3("board");
   const [activeColIndex, setActiveColIndex] = useState3(0);
   const [activeCardIndex, setActiveCardIndex] = useState3(0);
+  const [paused, setPaused] = useState3(false);
   useEffect3(() => {
     const onExit = () => exit();
     kanbanEmitter.on("tui:exit", onExit);
@@ -454,6 +456,12 @@ function KanbanApp({ config }) {
       if (key.escape) setActiveView("board");
       return;
     }
+    if (input === "p") {
+      const next = !paused;
+      setPaused(next);
+      kanbanEmitter.emit(next ? "loop:pause" : "loop:resume");
+      return;
+    }
     if (key.tab && !key.shift) {
       const nextCol = (activeColIndex + 1) % 3;
       setActiveColIndex(nextCol);
@@ -489,7 +497,16 @@ function KanbanApp({ config }) {
   };
   const selectedCard = activeView === "detail" ? columnCards[activeColIndex]?.[activeCardIndex] ?? null : null;
   return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "row", height: process.stdout.rows, children: [
-    /* @__PURE__ */ jsx6(Sidebar, { provider: config.provider, source: config.source, cwd: process.cwd() }),
+    /* @__PURE__ */ jsx6(
+      Sidebar,
+      {
+        provider: config.provider,
+        source: config.source,
+        cwd: process.cwd(),
+        activeView,
+        paused
+      }
+    ),
     activeView === "board" || !selectedCard ? /* @__PURE__ */ jsx6(
       Board,
       {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tarcisiopgs/lisa",
-	"version": "1.7.5",
+	"version": "1.7.7",
 	"description": "Autonomous issue resolver",
 	"license": "MIT",
 	"type": "module",