@tarcisiopgs/lisa 1.3.0 → 1.4.0

package/README.md

@@ -15,7 +15,7 @@ Most AI agent loops work like Ralph — they grab an issue, throw it at a model,
 Lisa is deterministic. She follows a structured pipeline with clear stages (fetch, activate, implement, validate, PR, update) and stops when the work is done. This means:
 
 - **Token efficiency** — Each issue gets one focused prompt with full context. No wasted retries, no speculative exploration, no idle polling.
-- **Multi-repo awareness** — Lisa detects which repos the agent touched and creates one PR per repo. Monorepos with multiple packages just work.
+- **Multi-repo awareness** — Lisa plans across multiple repos, executes in the correct order (e.g., backend before frontend), and creates one PR per repo.
 - **Model fallback** — Configure a chain of models (`claude → gemini → opencode`). Transient errors (429, quota, timeout) trigger the next model; non-transient errors stop the chain.
 - **Workflow integration** — Issues move through your board in real time (Backlog → In Progress → In Review). Your team always knows what's being worked on.
 - **Self-healing** — Orphan issues (stuck in "In Progress" from interrupted runs) are automatically recovered on startup. Pre-push hook failures trigger the agent to fix and retry.
@@ -76,7 +76,9 @@ lisa run --provider gemini --once
 | `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) |
 | `lisa run --label NAME` | Override label filter |
+| `lisa run --github METHOD` | Override GitHub method (cli, token) |
 | `lisa run --json` | Output as JSON lines |
 | `lisa run --quiet` | Suppress non-essential output |
 | `lisa config` | Interactive config wizard |
@@ -99,12 +101,13 @@ All providers use `child_process.spawn` with `sh -c`. Prompts are written to a t
 
 ### Fallback Chain
 
-Configure multiple models in the `models` array. Lisa tries them in order — transient errors (429, quota, timeout, network) trigger the next model. Non-transient errors stop the chain immediately.
+Configure a fallback chain in the `models` array. Lisa tries each provider in order — transient errors (429, quota, timeout, network) trigger the next provider. Non-transient errors stop the chain immediately.
 
 ```yaml
 models:
   - claude
   - gemini
+  - opencode
 ```
 
 If `models` is not set, Lisa uses the single `provider` field.
@@ -119,7 +122,12 @@ The AI agent creates a branch directly in your current checkout, implements the
 
 Lisa creates an isolated [git worktree](https://git-scm.com/docs/git-worktree) for each issue under `.worktrees/`. The agent works inside the worktree without touching your main checkout. After the PR is created, the worktree is cleaned up automatically.
 
-In multi-repo workspaces, the agent selects the correct repository, creates the worktree, implements, and writes a `.lisa-manifest.json` with the repo path, branch name, and PR title. Lisa reads the manifest to push and create the PR.
+**Native worktree support** — When using Claude Code, Lisa delegates worktree lifecycle directly to the provider via the `--worktree` flag. Lisa auto-detects whether the primary provider supports native worktrees and uses the appropriate mode. Other providers use Lisa-managed worktrees.
+
+**Multi-repo workspaces** — When multiple repos are configured, Lisa uses a two-phase flow:
+
+1. **Planning phase** — A planning agent analyzes the issue and produces a `.lisa-plan.json` with ordered steps (one per affected repo), determining which repos need changes and in what order (e.g., backend API before frontend consumer).
+2. **Execution phase** — Lisa executes each step sequentially, creating one worktree and one PR per repo. Cross-repo context (branch names, PR URLs from previous steps) is passed to each subsequent step so the agent can reference them.
 
 Worktree mode is ideal when you want to keep working in the repo while Lisa resolves issues in the background.
 
@@ -129,9 +137,6 @@ Config lives in `.lisa/config.yaml`. Run `lisa init` to create it interactively.
 
 ```yaml
 provider: claude
-models:
-  - claude
-  - gemini
 source: linear
 workflow: worktree
 
@@ -151,6 +156,7 @@ repos:
   - name: my-api
     path: ./api
     base_branch: main
+    match: "[API]"        # route issues whose title starts with "[API]" to this repo
   - name: my-app
     path: ./app
     base_branch: main
@@ -227,6 +233,22 @@ Lisa starts resources before the agent runs, waits for the port to be ready, run
 - **Signal handling** — SIGINT/SIGTERM gracefully revert the active issue to its previous status before exiting.
 - **Guardrails** — Failed sessions are logged to `.lisa/guardrails.md` and injected into future prompts so the agent avoids repeating the same mistakes.
 
+### Overseer
+
+Lisa can detect stuck providers — agents that appear to be running but are making no progress. When enabled, the overseer periodically checks `git status` in the working directory. If no changes are detected within the `stuck_threshold`, the provider process is killed and the error is eligible for fallback to the next model in the chain.
+
+### Test Runner Auto-Detection
+
+Lisa auto-detects `vitest` or `jest` in the project's `package.json` dependencies. When a test runner is found, mandatory test instructions are injected into the agent prompt, requiring the agent to write unit tests for new code and run `npm run test` before committing.
+
+### PR Body Formatting
+
+Agent-produced PR descriptions are automatically sanitized before creating the pull request: HTML tags are stripped, `*` bullets are normalized to `-`, and wall-of-text (single-line) descriptions are split into bullet points at sentence boundaries. Agents are also instructed to follow a structured markdown template (What / Why / Key changes / Testing).
+
+### Terminal Integration
+
+Lisa updates the terminal title to reflect the current activity (fetching, implementing, pushing, cooling down) and plays a bell notification when a session completes. This works in any terminal that supports OSC title sequences.
+
 ## License
 
 [MIT](LICENSE)

package/dist/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { execSync as execSync4 } from "child_process";
+import { execSync as execSync6 } from "child_process";
 import { existsSync as existsSync7, readdirSync, readFileSync as readFileSync6 } from "fs";
-import { join as join8, resolve as resolvePath } from "path";
+import { join as join10, resolve as resolvePath } from "path";
 import * as clack from "@clack/prompts";
 import { defineCommand, runMain } from "citty";
 import pc2 from "picocolors";
@@ -331,8 +331,8 @@ function banner() {
 }
 
 // src/loop.ts
-import { appendFileSync as appendFileSync6, existsSync as existsSync6, readFileSync as readFileSync5, unlinkSync as unlinkSync4 } from "fs";
-import { join as join7, resolve as resolve5 } from "path";
+import { appendFileSync as appendFileSync8, existsSync as existsSync6, readFileSync as readFileSync5, unlinkSync as unlinkSync6 } from "fs";
+import { join as join9, resolve as resolve5 } from "path";
 import { execa as execa3 } from "execa";
 
 // src/lifecycle.ts
@@ -1128,6 +1128,9 @@ var ClaudeProvider = class {
     writeFileSync4(promptFile, prompt, "utf-8");
     try {
       const flags = ["-p", "--dangerously-skip-permissions"];
+      if (opts.model) {
+        flags.push("--model", opts.model);
+      }
       if (opts.useNativeWorktree) {
         flags.push("--worktree");
       }
@@ -1184,16 +1187,16 @@ var ClaudeProvider = class {
   }
 };
 
-// src/providers/gemini.ts
+// src/providers/copilot.ts
 import { execSync as execSync2, spawn as spawn3 } from "child_process";
 import { appendFileSync as appendFileSync3, mkdtempSync as mkdtempSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync5 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join4 } from "path";
-var GeminiProvider = class {
-  name = "gemini";
+var CopilotProvider = class {
+  name = "copilot";
   async isAvailable() {
     try {
-      execSync2("gemini --version", { stdio: "ignore" });
+      execSync2("copilot version", { stdio: "ignore" });
       return true;
     } catch {
       return false;
@@ -1205,7 +1208,7 @@ var GeminiProvider = class {
     const promptFile = join4(tmpDir, "prompt.md");
     writeFileSync5(promptFile, prompt, "utf-8");
     try {
-      const proc = spawn3("sh", ["-c", `gemini --yolo -p "$(cat '${promptFile}')"`], {
+      const proc = spawn3("sh", ["-c", `copilot --allow-all -p "$(cat '${promptFile}')"`], {
         cwd: opts.cwd,
         stdio: ["ignore", "pipe", "pipe"]
       });
@@ -1257,16 +1260,180 @@ var GeminiProvider = class {
   }
 };
 
-// src/providers/opencode.ts
+// src/providers/cursor.ts
 import { execSync as execSync3, spawn as spawn4 } from "child_process";
 import { appendFileSync as appendFileSync4, mkdtempSync as mkdtempSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync6 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
 import { join as join5 } from "path";
+function findCursorBinary() {
+  for (const bin of ["agent", "cursor-agent"]) {
+    try {
+      execSync3(`${bin} --version`, { stdio: "ignore" });
+      return bin;
+    } catch {
+    }
+  }
+  return null;
+}
+var CursorProvider = class {
+  name = "cursor";
+  async isAvailable() {
+    return findCursorBinary() !== null;
+  }
+  async run(prompt, opts) {
+    const start = Date.now();
+    const bin = findCursorBinary();
+    if (!bin) {
+      return {
+        success: false,
+        output: "cursor agent (agent / cursor-agent) is not installed or not in PATH",
+        duration: Date.now() - start
+      };
+    }
+    const tmpDir = mkdtempSync3(join5(tmpdir3(), "lisa-"));
+    const promptFile = join5(tmpDir, "prompt.md");
+    writeFileSync6(promptFile, prompt, "utf-8");
+    try {
+      const proc = spawn4(
+        "sh",
+        ["-c", `${bin} -p "$(cat '${promptFile}')" --output-format text --force`],
+        {
+          cwd: opts.cwd,
+          stdio: ["ignore", "pipe", "pipe"]
+        }
+      );
+      const overseer = opts.overseer?.enabled ? startOverseer(proc, opts.cwd, opts.overseer) : null;
+      const chunks = [];
+      proc.stdout.on("data", (chunk) => {
+        const text2 = chunk.toString();
+        process.stdout.write(text2);
+        chunks.push(text2);
+        try {
+          appendFileSync4(opts.logFile, text2);
+        } catch {
+        }
+      });
+      proc.stderr.on("data", (chunk) => {
+        const text2 = chunk.toString();
+        process.stderr.write(text2);
+        try {
+          appendFileSync4(opts.logFile, text2);
+        } catch {
+        }
+      });
+      const exitCode = await new Promise((resolve6) => {
+        proc.on("close", (code) => {
+          overseer?.stop();
+          resolve6(code ?? 1);
+        });
+      });
+      if (overseer?.wasKilled()) {
+        chunks.push(STUCK_MESSAGE);
+      }
+      return {
+        success: exitCode === 0 && !overseer?.wasKilled(),
+        output: chunks.join(""),
+        duration: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: err instanceof Error ? err.message : String(err),
+        duration: Date.now() - start
+      };
+    } finally {
+      try {
+        unlinkSync3(promptFile);
+      } catch {
+      }
+    }
+  }
+};
+
+// src/providers/gemini.ts
+import { execSync as execSync4, spawn as spawn5 } from "child_process";
+import { appendFileSync as appendFileSync5, mkdtempSync as mkdtempSync4, unlinkSync as unlinkSync4, writeFileSync as writeFileSync7 } from "fs";
+import { tmpdir as tmpdir4 } from "os";
+import { join as join6 } from "path";
+var GeminiProvider = class {
+  name = "gemini";
+  async isAvailable() {
+    try {
+      execSync4("gemini --version", { stdio: "ignore" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async run(prompt, opts) {
+    const start = Date.now();
+    const tmpDir = mkdtempSync4(join6(tmpdir4(), "lisa-"));
+    const promptFile = join6(tmpDir, "prompt.md");
+    writeFileSync7(promptFile, prompt, "utf-8");
+    try {
+      const modelFlag = opts.model ? `--model ${opts.model}` : "";
+      const proc = spawn5("sh", ["-c", `gemini --yolo ${modelFlag} -p "$(cat '${promptFile}')"`], {
+        cwd: opts.cwd,
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      const overseer = opts.overseer?.enabled ? startOverseer(proc, opts.cwd, opts.overseer) : null;
+      const chunks = [];
+      proc.stdout.on("data", (chunk) => {
+        const text2 = chunk.toString();
+        process.stdout.write(text2);
+        chunks.push(text2);
+        try {
+          appendFileSync5(opts.logFile, text2);
+        } catch {
+        }
+      });
+      proc.stderr.on("data", (chunk) => {
+        const text2 = chunk.toString();
+        process.stderr.write(text2);
+        try {
+          appendFileSync5(opts.logFile, text2);
+        } catch {
+        }
+      });
+      const exitCode = await new Promise((resolve6) => {
+        proc.on("close", (code) => {
+          overseer?.stop();
+          resolve6(code ?? 1);
+        });
+      });
+      if (overseer?.wasKilled()) {
+        chunks.push(STUCK_MESSAGE);
+      }
+      return {
+        success: exitCode === 0 && !overseer?.wasKilled(),
+        output: chunks.join(""),
+        duration: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: err instanceof Error ? err.message : String(err),
+        duration: Date.now() - start
+      };
+    } finally {
+      try {
+        unlinkSync4(promptFile);
+      } catch {
+      }
+    }
+  }
+};
+
+// src/providers/opencode.ts
+import { execSync as execSync5, spawn as spawn6 } from "child_process";
+import { appendFileSync as appendFileSync6, mkdtempSync as mkdtempSync5, unlinkSync as unlinkSync5, writeFileSync as writeFileSync8 } from "fs";
+import { tmpdir as tmpdir5 } from "os";
+import { join as join7 } from "path";
 var OpenCodeProvider = class {
   name = "opencode";
   async isAvailable() {
     try {
-      execSync3("opencode --version", { stdio: "ignore" });
+      execSync5("opencode --version", { stdio: "ignore" });
       return true;
     } catch {
       return false;
@@ -1274,11 +1441,11 @@ var OpenCodeProvider = class {
   }
   async run(prompt, opts) {
     const start = Date.now();
-    const tmpDir = mkdtempSync3(join5(tmpdir3(), "lisa-"));
-    const promptFile = join5(tmpDir, "prompt.md");
-    writeFileSync6(promptFile, prompt, "utf-8");
+    const tmpDir = mkdtempSync5(join7(tmpdir5(), "lisa-"));
+    const promptFile = join7(tmpDir, "prompt.md");
+    writeFileSync8(promptFile, prompt, "utf-8");
     try {
-      const proc = spawn4("sh", ["-c", `opencode run "$(cat '${promptFile}')"`], {
+      const proc = spawn6("sh", ["-c", `opencode run "$(cat '${promptFile}')"`], {
         cwd: opts.cwd,
         stdio: ["ignore", "pipe", "pipe"]
       });
@@ -1289,7 +1456,7 @@ var OpenCodeProvider = class {
         process.stdout.write(text2);
         chunks.push(text2);
         try {
-          appendFileSync4(opts.logFile, text2);
+          appendFileSync6(opts.logFile, text2);
         } catch {
         }
       });
@@ -1297,7 +1464,7 @@ var OpenCodeProvider = class {
         const text2 = chunk.toString();
         process.stderr.write(text2);
         try {
-          appendFileSync4(opts.logFile, text2);
+          appendFileSync6(opts.logFile, text2);
         } catch {
         }
       });
@@ -1323,7 +1490,7 @@ var OpenCodeProvider = class {
       };
     } finally {
       try {
-        unlinkSync3(promptFile);
+        unlinkSync5(promptFile);
       } catch {
       }
     }
@@ -1334,7 +1501,9 @@ var OpenCodeProvider = class {
 var providers = {
   claude: () => new ClaudeProvider(),
   gemini: () => new GeminiProvider(),
-  opencode: () => new OpenCodeProvider()
+  opencode: () => new OpenCodeProvider(),
+  copilot: () => new CopilotProvider(),
+  cursor: () => new CursorProvider()
 };
 async function getAvailableProviders() {
   const all = Object.values(providers).map((f) => f());
@@ -1371,31 +1540,39 @@ var ELIGIBLE_ERROR_PATTERNS = [
   /not installed/i,
   /not in PATH/i,
   /command not found/i,
-  /lisa-overseer/i
+  /lisa-overseer/i,
+  /named models unavailable/i,
+  /free plans can only use/i
 ];
 function isEligibleForFallback(output) {
   return ELIGIBLE_ERROR_PATTERNS.some((pattern) => pattern.test(output));
 }
+function isCompleteProviderExhaustion(attempts) {
+  if (attempts.length === 0) return false;
+  return attempts.every((a) => !a.success && a.error !== "Non-eligible error");
+}
 async function runWithFallback(models, prompt, opts) {
   const attempts = [];
-  for (const model of models) {
-    const provider = createProvider(model);
+  for (const spec of models) {
+    const provider = createProvider(spec.provider);
     const available = await provider.isAvailable();
     if (!available) {
       attempts.push({
-        provider: model,
+        provider: spec.provider,
+        model: spec.model,
         success: false,
-        error: `Provider "${model}" is not installed or not in PATH`,
+        error: `Provider "${spec.provider}" is not installed or not in PATH`,
         duration: 0
       });
       continue;
     }
     const guardrailsSection = opts.guardrailsDir ? buildGuardrailsSection(opts.guardrailsDir) : "";
     const fullPrompt = guardrailsSection ? `${prompt}${guardrailsSection}` : prompt;
-    const result = await provider.run(fullPrompt, opts);
+    const result = await provider.run(fullPrompt, { ...opts, model: spec.model });
     if (result.success) {
       attempts.push({
-        provider: model,
+        provider: spec.provider,
+        model: spec.model,
         success: true,
         duration: result.duration
       });
@@ -1403,7 +1580,7 @@ async function runWithFallback(models, prompt, opts) {
         success: true,
         output: result.output,
         duration: result.duration,
-        providerUsed: model,
+        providerUsed: spec.model ? `${spec.provider}/${spec.model}` : spec.provider,
         provider,
         attempts
       };
@@ -1412,14 +1589,15 @@ async function runWithFallback(models, prompt, opts) {
       appendEntry(opts.guardrailsDir, {
         issueId: opts.issueId,
         date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-        provider: model,
+        provider: spec.provider,
         errorType: extractErrorType(result.output),
         context: extractContext(result.output)
       });
     }
     const eligible = isEligibleForFallback(result.output);
     attempts.push({
-      provider: model,
+      provider: spec.provider,
+      model: spec.model,
       success: false,
       error: eligible ? "Eligible error (quota/unavailable/timeout)" : "Non-eligible error",
       duration: result.duration
@@ -1429,7 +1607,7 @@ async function runWithFallback(models, prompt, opts) {
         success: false,
         output: result.output,
         duration: result.duration,
-        providerUsed: model,
+        providerUsed: spec.model ? `${spec.provider}/${spec.model}` : spec.provider,
         provider,
         attempts
       };
@@ -1440,7 +1618,7 @@ async function runWithFallback(models, prompt, opts) {
     success: false,
     output: formatAttemptsReport(attempts),
     duration: totalDuration,
-    providerUsed: attempts[attempts.length - 1]?.provider ?? models[0] ?? "claude",
+    providerUsed: attempts[attempts.length - 1]?.provider ?? models[0]?.provider ?? "claude",
     attempts
   };
 }
@@ -1450,7 +1628,8 @@ function formatAttemptsReport(attempts) {
     const status2 = a.success ? "OK" : "FAILED";
     const error2 = a.error ? ` \u2014 ${a.error}` : "";
     const duration = a.duration > 0 ? ` (${Math.round(a.duration / 1e3)}s)` : "";
-    lines.push(`  ${i + 1}. ${a.provider}: ${status2}${error2}${duration}`);
+    const label = a.model ? `${a.provider}/${a.model}` : a.provider;
+    lines.push(`  ${i + 1}. ${label}: ${status2}${error2}${duration}`);
   }
   return lines.join("\n");
 }
@@ -1893,8 +2072,8 @@ function resetTitle() {
 }
 
 // src/worktree.ts
-import { appendFileSync as appendFileSync5, existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
-import { join as join6, resolve as resolve4 } from "path";
+import { appendFileSync as appendFileSync7, existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
+import { join as join8, resolve as resolve4 } from "path";
 import { execa as execa2 } from "execa";
 var WORKTREES_DIR = ".worktrees";
 function generateBranchName(issueId, title) {
@@ -1909,7 +2088,7 @@ async function cleanupOrphanedWorktree(repoRoot, branchName) {
   if (!branchList.trim()) {
     return false;
   }
-  const worktreePath = join6(repoRoot, WORKTREES_DIR, branchName);
+  const worktreePath = join8(repoRoot, WORKTREES_DIR, branchName);
   const { stdout: worktreeList } = await execa2("git", ["worktree", "list", "--porcelain"], {
     cwd: repoRoot,
     reject: false
@@ -1922,7 +2101,7 @@ async function cleanupOrphanedWorktree(repoRoot, branchName) {
   return true;
 }
 async function createWorktree(repoRoot, branchName, baseBranch) {
-  const worktreePath = join6(repoRoot, WORKTREES_DIR, branchName);
+  const worktreePath = join8(repoRoot, WORKTREES_DIR, branchName);
   await cleanupOrphanedWorktree(repoRoot, branchName);
   await execa2("git", ["fetch", "origin", baseBranch], { cwd: repoRoot });
   await execa2("git", ["worktree", "add", "-b", branchName, worktreePath, `origin/${baseBranch}`], {
@@ -1937,16 +2116,16 @@ async function removeWorktree(repoRoot, worktreePath) {
   await execa2("git", ["worktree", "prune"], { cwd: repoRoot });
 }
 function ensureWorktreeGitignore(repoRoot) {
-  const gitignorePath = join6(repoRoot, ".gitignore");
+  const gitignorePath = join8(repoRoot, ".gitignore");
   if (!existsSync5(gitignorePath)) {
-    appendFileSync5(gitignorePath, `${WORKTREES_DIR}
+    appendFileSync7(gitignorePath, `${WORKTREES_DIR}
 `);
     return;
   }
   const content = readFileSync4(gitignorePath, "utf-8");
   if (!content.split("\n").some((line) => line.trim() === WORKTREES_DIR)) {
     const separator = content.endsWith("\n") ? "" : "\n";
-    appendFileSync5(gitignorePath, `${separator}${WORKTREES_DIR}
+    appendFileSync7(gitignorePath, `${separator}${WORKTREES_DIR}
 `);
   }
 }
@@ -1977,15 +2156,15 @@ function determineRepoPath(repos, issue, workspace) {
   if (repos.length === 0) return void 0;
   if (issue.repo) {
     const match = repos.find((r) => r.name === issue.repo);
-    if (match) return join6(workspace, match.path);
+    if (match) return join8(workspace, match.path);
   }
   for (const r of repos) {
     if (r.match && issue.title.startsWith(r.match)) {
-      return join6(workspace, r.path);
+      return join8(workspace, r.path);
     }
   }
   const first = repos[0];
-  return first ? join6(workspace, first.path) : void 0;
+  return first ? join8(workspace, first.path) : void 0;
 }
 async function detectFeatureBranches(repos, issueId, workspace, globalBaseBranch) {
   const entries = repos.length > 0 ? repos.map((r) => ({ path: resolve4(workspace, r.path), baseBranch: r.base_branch })) : [{ path: workspace, baseBranch: globalBaseBranch }];
@@ -2025,8 +2204,21 @@ async function detectFeatureBranches(repos, issueId, workspace, globalBaseBranch
 var activeCleanup = null;
 var shuttingDown = false;
 function resolveModels(config2) {
-  if (config2.models && config2.models.length > 0) return config2.models;
-  return [config2.provider];
+  if (!config2.models || config2.models.length === 0) {
+    return [{ provider: config2.provider }];
+  }
+  const knownProviders = /* @__PURE__ */ new Set(["claude", "gemini", "opencode", "copilot", "cursor"]);
+  for (const m of config2.models) {
+    if (knownProviders.has(m) && m !== config2.provider) {
+      warn(
+        `Model "${m}" looks like a provider name but provider is "${config2.provider}". Since v1.4.0, "models" lists model names within the configured provider, not provider names. Update your .lisa/config.yaml.`
+      );
+    }
+  }
+  return config2.models.map((m) => ({
+    provider: config2.provider,
+    model: m === config2.provider ? void 0 : m
+  }));
 }
 function buildPrBody(providerUsed, description) {
   const lines = [];
@@ -2046,7 +2238,7 @@ function buildPrBody(providerUsed, description) {
 var PR_TITLE_FILE = ".pr-title";
 function readPrTitle(cwd) {
   try {
-    const title = readFileSync5(join7(cwd, PR_TITLE_FILE), "utf-8").trim().split("\n")[0]?.trim();
+    const title = readFileSync5(join9(cwd, PR_TITLE_FILE), "utf-8").trim().split("\n")[0]?.trim();
     return title || null;
   } catch {
     return null;
@@ -2054,13 +2246,13 @@ function readPrTitle(cwd) {
 }
 function cleanupPrTitle(cwd) {
   try {
-    unlinkSync4(join7(cwd, PR_TITLE_FILE));
+    unlinkSync6(join9(cwd, PR_TITLE_FILE));
   } catch {
   }
 }
 var PLAN_FILE = ".lisa-plan.json";
 function readLisaPlan(dir) {
-  const planPath = join7(dir, PLAN_FILE);
+  const planPath = join9(dir, PLAN_FILE);
   if (!existsSync6(planPath)) return null;
   try {
     return JSON.parse(readFileSync5(planPath, "utf-8").trim());
@@ -2070,13 +2262,13 @@ function readLisaPlan(dir) {
 }
 function cleanupPlan(dir) {
   try {
-    unlinkSync4(join7(dir, PLAN_FILE));
+    unlinkSync6(join9(dir, PLAN_FILE));
   } catch {
   }
 }
 var MANIFEST_FILE = ".lisa-manifest.json";
 function readLisaManifest(dir) {
-  const manifestPath = join7(dir, MANIFEST_FILE);
+  const manifestPath = join9(dir, MANIFEST_FILE);
   if (!existsSync6(manifestPath)) return null;
   try {
     return JSON.parse(readFileSync5(manifestPath, "utf-8").trim());
@@ -2086,7 +2278,7 @@ function readLisaManifest(dir) {
 }
 function cleanupManifest(dir) {
   try {
-    unlinkSync4(join7(dir, MANIFEST_FILE));
+    unlinkSync6(join9(dir, MANIFEST_FILE));
   } catch {
   }
 }
@@ -2212,7 +2404,7 @@ async function runLoop(config2, opts) {
   const models = resolveModels(config2);
   installSignalHandlers();
   log(
-    `Starting loop (models: ${models.join(" \u2192 ")}, source: ${config2.source}, label: ${config2.source_config.label}, workflow: ${config2.workflow})`
+    `Starting loop (models: ${models.map((m) => m.model ? `${m.provider}/${m.model}` : m.provider).join(" \u2192 ")}, source: ${config2.source}, label: ${config2.source_config.label}, workflow: ${config2.workflow})`
   );
   if (!opts.dryRun) {
     await recoverOrphanIssues(source, config2);
@@ -2243,7 +2435,9 @@ async function runLoop(config2, opts) {
         );
       }
       log(`[dry-run] Workflow mode: ${config2.workflow}`);
-      log(`[dry-run] Models priority: ${models.join(" \u2192 ")}`);
+      log(
+        `[dry-run] Models priority: ${models.map((m) => m.model ? `${m.provider}/${m.model}` : m.provider).join(" \u2192 ")}`
+      );
       log("[dry-run] Then implement, push, create PR, and update issue status");
       break;
     }
@@ -2319,6 +2513,12 @@ async function runLoop(config2, opts) {
         log("Single iteration mode. Exiting.");
         break;
       }
+      if (isCompleteProviderExhaustion(sessionResult.fallback.attempts)) {
+        error(
+          "All providers exhausted due to infrastructure issues (quota, plan limits, or not installed). Fix your provider configuration and restart lisa."
+        );
+        break;
+      }
       log(`Cooling down ${config2.loop.cooldown}s before next issue...`);
       setTitle("Lisa \u2014 cooling down...");
       await sleep(config2.loop.cooldown * 1e3);
@@ -2444,7 +2644,7 @@ async function runWorktreeSession(config2, issue, logFile, session, models) {
   const workspace = resolve5(config2.workspace);
   const repoPath = determineRepoPath(config2.repos, issue, workspace) ?? workspace;
   const defaultBranch = resolveBaseBranch(config2, repoPath);
-  const primaryProvider = createProvider(models[0] ?? "claude");
+  const primaryProvider = createProvider(models[0]?.provider ?? "claude");
   const useNativeWorktree = primaryProvider.supportsNativeWorktree === true;
   if (useNativeWorktree) {
     return runNativeWorktreeSession(
@@ -2473,7 +2673,7 @@ async function runNativeWorktreeSession(config2, issue, logFile, session, models
     stopSpinner();
     if (!started) {
       error(`Lifecycle startup failed for ${issue.id}. Aborting session.`);
-      return failResult(models[0] ?? "claude");
+      return failResult(models[0]?.provider ?? "claude");
     }
   }
   const testRunner = detectTestRunner(repoPath);
@@ -2493,7 +2693,7 @@ async function runNativeWorktreeSession(config2, issue, logFile, session, models
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2589,13 +2789,13 @@ async function runManualWorktreeSession(config2, issue, logFile, session, models
     error(`Failed to create worktree: ${err instanceof Error ? err.message : String(err)}`);
     return {
       success: false,
-      providerUsed: models[0] ?? "claude",
+      providerUsed: models[0]?.provider ?? "claude",
       prUrls: [],
       fallback: {
         success: false,
         output: "",
         duration: 0,
-        providerUsed: models[0] ?? "claude",
+        providerUsed: models[0]?.provider ?? "claude",
         attempts: []
       }
     };
@@ -2612,13 +2812,13 @@ async function runManualWorktreeSession(config2, issue, logFile, session, models
       await cleanupWorktree(repoPath, worktreePath);
       return {
         success: false,
-        providerUsed: models[0] ?? "claude",
+        providerUsed: models[0]?.provider ?? "claude",
         prUrls: [],
         fallback: {
           success: false,
           output: "",
           duration: 0,
-          providerUsed: models[0] ?? "claude",
+          providerUsed: models[0]?.provider ?? "claude",
           attempts: []
         }
       };
@@ -2641,7 +2841,7 @@ async function runManualWorktreeSession(config2, issue, logFile, session, models
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2745,7 +2945,7 @@ async function runWorktreeMultiRepoSession(config2, issue, logFile, session, mod
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2838,7 +3038,7 @@ async function runMultiRepoStep(config2, issue, step, previousResults, logFile,
   } catch (err) {
     stopSpinner();
     error(`Failed to create worktree: ${err instanceof Error ? err.message : String(err)}`);
-    return failResult(models[0] ?? "claude");
+    return failResult(models[0]?.provider ?? "claude");
   }
   stopSpinner();
   ok(`Worktree created at ${worktreePath}`);
@@ -2855,7 +3055,7 @@ async function runMultiRepoStep(config2, issue, step, previousResults, logFile,
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2959,13 +3159,13 @@ async function runBranchSession(config2, issue, logFile, session, models) {
       error(`Lifecycle startup failed for ${issue.id}. Aborting session.`);
       return {
         success: false,
-        providerUsed: models[0] ?? "claude",
+        providerUsed: models[0]?.provider ?? "claude",
         prUrls: [],
         fallback: {
           success: false,
           output: "",
           duration: 0,
-          providerUsed: models[0] ?? "claude",
+          providerUsed: models[0]?.provider ?? "claude",
           attempts: []
         }
       };
@@ -2983,7 +3183,7 @@ async function runBranchSession(config2, issue, logFile, session, models) {
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -3221,7 +3421,13 @@ async function runConfigWizard() {
   const providerLabels = {
     claude: "Claude Code",
     gemini: "Gemini CLI",
-    opencode: "OpenCode"
+    opencode: "OpenCode",
+    copilot: "GitHub Copilot CLI",
+    cursor: "Cursor Agent"
+  };
+  const providerModels = {
+    claude: ["claude-opus-4-5", "claude-sonnet-4-5", "claude-haiku-4-5"],
+    gemini: ["gemini-2.5-pro", "gemini-2.0-flash", "gemini-1.5-pro"]
   };
   const available = await getAvailableProviders();
   if (available.length === 0) {
@@ -3252,6 +3458,21 @@ After installing, run ${pc2.cyan("lisa init")} again.`
     if (clack.isCancel(selected)) return process.exit(0);
     providerName = selected;
   }
+  let selectedModels = [];
+  const availableModels = providerModels[providerName];
+  if (availableModels && availableModels.length > 0) {
+    const modelSelection = await clack.multiselect({
+      message: "Which models to use? (first = primary, rest = fallbacks in order)",
+      options: availableModels.map((m, i) => ({
+        value: m,
+        label: m,
+        hint: i === 0 ? "primary" : `fallback ${i}`
+      })),
+      required: false
+    });
+    if (clack.isCancel(modelSelection)) return process.exit(0);
+    selectedModels = modelSelection ?? [];
+  }
   const source = await clack.select({
     message: "Where do your issues live?",
     options: [
@@ -3378,6 +3599,7 @@ Then run: ${pc2.cyan(`source ${shell}`)}`
   }
   const cfg = {
     provider: providerName,
+    ...selectedModels.length > 0 ? { models: selectedModels } : {},
     source,
     source_config: {
       team,
@@ -3424,12 +3646,12 @@ async function detectGitHubMethod() {
 }
 async function detectGitRepos() {
   const cwd = process.cwd();
-  if (existsSync7(join8(cwd, ".git"))) {
+  if (existsSync7(join10(cwd, ".git"))) {
     clack.log.info(`Detected git repository in current directory.`);
     return [];
   }
   const entries = readdirSync(cwd, { withFileTypes: true });
-  const gitDirs = entries.filter((e) => e.isDirectory() && existsSync7(join8(cwd, e.name, ".git"))).map((e) => e.name);
+  const gitDirs = entries.filter((e) => e.isDirectory() && existsSync7(join10(cwd, e.name, ".git"))).map((e) => e.name);
   if (gitDirs.length === 0) {
     return [];
   }
@@ -3439,7 +3661,7 @@ async function detectGitRepos() {
   });
   if (clack.isCancel(selected)) return process.exit(0);
   return selected.map((dir) => ({
-    name: getGitRepoName(join8(cwd, dir)) ?? dir,
+    name: getGitRepoName(join10(cwd, dir)) ?? dir,
     path: `./${dir}`,
     match: "",
     base_branch: ""
@@ -3447,7 +3669,7 @@ async function detectGitRepos() {
 }
 function detectDefaultBranch(repoPath) {
   try {
-    const ref = execSync4("git symbolic-ref refs/remotes/origin/HEAD --short", {
+    const ref = execSync6("git symbolic-ref refs/remotes/origin/HEAD --short", {
       cwd: repoPath,
       encoding: "utf-8"
     }).trim();
@@ -3458,7 +3680,7 @@ function detectDefaultBranch(repoPath) {
 }
 function getGitRepoName(repoPath) {
   try {
-    const url = execSync4("git remote get-url origin", { cwd: repoPath, encoding: "utf-8" }).trim();
+    const url = execSync6("git remote get-url origin", { cwd: repoPath, encoding: "utf-8" }).trim();
     const match = url.match(/\/([^/]+?)(?:\.git)?$/) ?? url.match(/:([^/]+?)(?:\.git)?$/);
     return match?.[1] ?? null;
   } catch {

package/package.json

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