@tarcisiopgs/lisa 1.3.1 → 1.5.0

package/README.md

@@ -101,16 +101,17 @@ All providers use `child_process.spawn` with `sh -c`. Prompts are written to a t
 
 ### Fallback Chain
 
-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.
+Configure a fallback chain in the `models` array. Lisa tries each model in order — transient errors (429, quota, timeout, network) trigger the next model. Non-transient errors stop the chain immediately.
 
 ```yaml
+provider: claude
 models:
-  - claude
-  - gemini
-  - opencode
+  - claude-sonnet-4-6   # primary
+  - claude-opus-4-6     # fallback 1
+  - claude-haiku-4-5    # fallback 2
 ```
 
-If `models` is not set, Lisa uses the single `provider` field.
+If `models` is not set, Lisa uses the provider's default model.
 
 ## Workflow Modes
 
@@ -208,7 +209,7 @@ repos:
         - "npx prisma db push"
 ```
 
-Lisa starts resources before the agent runs, waits for the port to be ready, runs setup commands, then stops everything after the session.
+Lisa starts resources before the agent runs, waits for the port to be ready, runs setup commands, then stops everything after the session. In multi-repo workflows, resources are started and stopped per repo step.
 
 ## How It Works
 
@@ -237,9 +238,9 @@ Lisa starts resources before the agent runs, waits for the port to be ready, run
 
 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
+### Test Runner and Package Manager 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.
+Lisa auto-detects `vitest` or `jest` in the project's `package.json` dependencies. It also detects the package manager from lockfiles (`bun.lockb`/`bun.lock` → `bun`, `pnpm-lock.yaml` → `pnpm`, `yarn.lock` → `yarn`, otherwise `npm`). When a test runner is found, mandatory test instructions are injected into the agent prompt with the correct test command (e.g., `bun run test`, `pnpm run test`).
 
 ### PR Body Formatting
 

package/dist/index.js

@@ -1,9 +1,10 @@
 #!/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 { tmpdir as tmpdir6 } from "os";
+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 +332,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
@@ -516,6 +517,12 @@ function sanitizePrBody(raw) {
 // src/prompt.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { join, resolve as resolve3 } from "path";
+function detectPackageManager(cwd) {
+  if (existsSync3(join(cwd, "bun.lockb")) || existsSync3(join(cwd, "bun.lock"))) return "bun";
+  if (existsSync3(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync3(join(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
 function detectTestRunner(cwd) {
   const packageJsonPath = join(cwd, "package.json");
   if (!existsSync3(packageJsonPath)) return null;
@@ -529,20 +536,21 @@ function detectTestRunner(cwd) {
     return null;
   }
 }
-function buildImplementPrompt(issue, config2, testRunner) {
+function buildImplementPrompt(issue, config2, testRunner, pm) {
   if (config2.workflow === "worktree") {
-    return buildWorktreePrompt(issue, testRunner);
+    return buildWorktreePrompt(issue, testRunner, pm);
   }
-  return buildBranchPrompt(issue, config2, testRunner);
+  return buildBranchPrompt(issue, config2, testRunner, pm);
 }
-function buildTestInstructions(testRunner) {
+function buildTestInstructions(testRunner, pm = "npm") {
   if (!testRunner) return "";
+  const testCmd = pm === "bun" ? "bun run test" : `${pm} run test`;
   return `
 **MANDATORY \u2014 Unit Tests:**
 This project uses **${testRunner}** as its test runner.
 - You MUST write unit tests (\`*.test.ts\`) for every new file or module you create.
 - Tests should cover the main functionality, edge cases, and error scenarios.
-- Run \`npm run test\` and ensure ALL tests pass before committing.
+- Run \`${testCmd}\` and ensure ALL tests pass before committing.
 - Do NOT skip writing tests \u2014 the PR will be blocked if tests are missing or failing.
 `;
 }
@@ -591,8 +599,8 @@ function buildPrBodyInstructions() {
    \`\`\`
    Write in English. Do NOT write a wall of text \u2014 structure the summary using the template above.`;
 }
-function buildWorktreePrompt(issue, testRunner) {
-  const testBlock = buildTestInstructions(testRunner ?? null);
+function buildWorktreePrompt(issue, testRunner, pm) {
+  const testBlock = buildTestInstructions(testRunner ?? null, pm);
   const readmeBlock = buildReadmeInstructions();
   const hookBlock = buildPreCommitHookInstructions();
   return `You are an autonomous implementation agent. Your job is to implement a single
@@ -652,13 +660,13 @@ ${testBlock}${readmeBlock}${hookBlock}
 - Do NOT create pull requests \u2014 the caller handles that.
 - Do NOT update the issue tracker \u2014 the caller handles that.`;
 }
-function buildBranchPrompt(issue, config2, testRunner) {
+function buildBranchPrompt(issue, config2, testRunner, pm) {
   const workspace = resolve3(config2.workspace);
   const repoEntries = config2.repos.map(
     (r) => `   - If it says "Repo: ${r.name}" or title starts with "${r.match}" \u2192 \`${resolve3(workspace, r.path)}\` (base branch: \`${r.base_branch}\`)`
   ).join("\n");
   const baseBranchInstruction = config2.repos.length > 0 ? "From the repo's base branch (listed above)" : `From \`${config2.base_branch}\``;
-  const testBlock = buildTestInstructions(testRunner ?? null);
+  const testBlock = buildTestInstructions(testRunner ?? null, pm);
   const readmeBlock = buildReadmeInstructions();
   const hookBlock = buildPreCommitHookInstructions();
   const manifestPath = join(workspace, ".lisa-manifest.json");
@@ -748,8 +756,8 @@ ${hookErrors}
 
 Focus only on fixing the hook errors. Do not make unrelated changes.`;
 }
-function buildNativeWorktreePrompt(issue, repoPath, testRunner) {
-  const testBlock = buildTestInstructions(testRunner ?? null);
+function buildNativeWorktreePrompt(issue, repoPath, testRunner, pm) {
+  const testBlock = buildTestInstructions(testRunner ?? null, pm);
   const readmeBlock = buildReadmeInstructions();
   const hookBlock = buildPreCommitHookInstructions();
   const prBodyBlock = buildPrBodyInstructions();
@@ -864,8 +872,8 @@ ${repoBlock}
 - Do NOT push, create pull requests, or update the issue tracker.
 - If only one repo is affected, the plan should have a single step.`;
 }
-function buildScopedImplementPrompt(issue, step, previousResults, testRunner) {
-  const testBlock = buildTestInstructions(testRunner ?? null);
+function buildScopedImplementPrompt(issue, step, previousResults, testRunner, pm) {
+  const testBlock = buildTestInstructions(testRunner ?? null, pm);
   const readmeBlock = buildReadmeInstructions();
   const hookBlock = buildPreCommitHookInstructions();
   const prBodyBlock = buildPrBodyInstructions();
@@ -1128,6 +1136,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 +1195,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 +1216,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 +1268,181 @@ 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 modelFlag = opts.model ? `--model ${opts.model}` : "";
+      const proc = spawn4(
+        "sh",
+        ["-c", `${bin} -p "$(cat '${promptFile}')" --output-format text --force ${modelFlag}`],
+        {
+          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 +1450,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 +1465,7 @@ var OpenCodeProvider = class {
         process.stdout.write(text2);
         chunks.push(text2);
         try {
-          appendFileSync4(opts.logFile, text2);
+          appendFileSync6(opts.logFile, text2);
         } catch {
         }
       });
@@ -1297,7 +1473,7 @@ var OpenCodeProvider = class {
         const text2 = chunk.toString();
         process.stderr.write(text2);
         try {
-          appendFileSync4(opts.logFile, text2);
+          appendFileSync6(opts.logFile, text2);
         } catch {
         }
       });
@@ -1323,7 +1499,7 @@ var OpenCodeProvider = class {
       };
     } finally {
       try {
-        unlinkSync3(promptFile);
+        unlinkSync5(promptFile);
       } catch {
       }
     }
@@ -1334,7 +1510,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 +1549,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 +1589,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 +1598,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 +1616,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 +1627,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 +1637,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 +2081,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 +2097,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 +2110,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 +2125,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 +2165,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 +2213,30 @@ 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.`
+      );
+    }
+  }
+  if (config2.provider === "cursor") {
+    const hasAuto = config2.models.some((m) => m.toLowerCase() === "auto");
+    if (!hasAuto) {
+      warn(
+        "Cursor Free plan detected (or model not set to 'auto'). Forcing 'auto' model. Set model to 'auto' explicitly in .lisa/config.yaml to silence this warning."
+      );
+      return [{ provider: config2.provider, model: "auto" }];
+    }
+  }
+  return config2.models.map((m) => ({
+    provider: config2.provider,
+    model: m === config2.provider ? void 0 : m
+  }));
 }
 function buildPrBody(providerUsed, description) {
   const lines = [];
@@ -2046,7 +2256,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 +2264,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 +2280,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 +2296,7 @@ function readLisaManifest(dir) {
 }
 function cleanupManifest(dir) {
   try {
-    unlinkSync4(join7(dir, MANIFEST_FILE));
+    unlinkSync6(join9(dir, MANIFEST_FILE));
   } catch {
   }
 }
@@ -2212,7 +2422,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 +2453,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 +2531,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);
@@ -2408,9 +2626,10 @@ function findRepoConfig(config2, issue) {
 async function runTestValidation(cwd) {
   const testRunner = detectTestRunner(cwd);
   if (!testRunner) return true;
-  log(`Running test validation (${testRunner} detected)...`);
+  const pm = detectPackageManager(cwd);
+  log(`Running test validation (${testRunner} via ${pm})...`);
   try {
-    await execa3("npm", ["run", "test"], { cwd, stdio: "pipe" });
+    await execa3(pm, ["run", "test"], { cwd, stdio: "pipe" });
     ok("Tests passed.");
     return true;
   } catch (err) {
@@ -2444,7 +2663,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,13 +2692,14 @@ 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);
   if (testRunner) log(`Detected test runner: ${testRunner}`);
+  const pm = detectPackageManager(repoPath);
   cleanupManifest(repoPath);
-  const prompt = buildNativeWorktreePrompt(issue, repoPath, testRunner);
+  const prompt = buildNativeWorktreePrompt(issue, repoPath, testRunner, pm);
   startSpinner(`${issue.id} \u2014 implementing (native worktree)...`);
   log(`Implementing with native worktree... (log: ${logFile})`);
   initLogFile(logFile);
@@ -2493,7 +2713,7 @@ async function runNativeWorktreeSession(config2, issue, logFile, session, models
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2589,13 +2809,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 +2832,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: []
         }
       };
@@ -2628,7 +2848,8 @@ async function runManualWorktreeSession(config2, issue, logFile, session, models
   if (testRunner) {
     log(`Detected test runner: ${testRunner}`);
   }
-  const prompt = buildImplementPrompt(issue, config2, testRunner);
+  const pm = detectPackageManager(worktreePath);
+  const prompt = buildImplementPrompt(issue, config2, testRunner, pm);
   startSpinner(`${issue.id} \u2014 implementing...`);
   log(`Implementing in worktree... (log: ${logFile})`);
   initLogFile(logFile);
@@ -2641,7 +2862,7 @@ async function runManualWorktreeSession(config2, issue, logFile, session, models
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2745,7 +2966,7 @@ async function runWorktreeMultiRepoSession(config2, issue, logFile, session, mod
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2838,13 +3059,25 @@ 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}`);
   const testRunner = detectTestRunner(worktreePath);
   if (testRunner) log(`Detected test runner: ${testRunner}`);
-  const prompt = buildScopedImplementPrompt(issue, step, previousResults, testRunner);
+  const pm = detectPackageManager(worktreePath);
+  const repoConfig = config2.repos.find((r) => resolve5(config2.workspace, r.path) === step.repoPath);
+  if (repoConfig?.lifecycle) {
+    startSpinner(`${issue.id} step ${stepNum} \u2014 starting resources...`);
+    const started = await startResources(repoConfig, worktreePath);
+    stopSpinner();
+    if (!started) {
+      error(`Lifecycle startup failed for step ${stepNum}. Aborting.`);
+      await cleanupWorktree(repoPath, worktreePath);
+      return failResult(models[0]?.provider ?? "claude");
+    }
+  }
+  const prompt = buildScopedImplementPrompt(issue, step, previousResults, testRunner, pm);
   startSpinner(`${issue.id} step ${stepNum} \u2014 implementing...`);
   const result = await runWithFallback(models, prompt, {
     logFile,
@@ -2854,8 +3087,9 @@ async function runMultiRepoStep(config2, issue, step, previousResults, logFile,
     overseer: config2.overseer
   });
   stopSpinner();
+  if (repoConfig?.lifecycle) await stopResources();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -2948,7 +3182,8 @@ async function runBranchSession(config2, issue, logFile, session, models) {
   if (testRunner) {
     log(`Detected test runner: ${testRunner}`);
   }
-  const prompt = buildImplementPrompt(issue, config2, testRunner);
+  const pm = detectPackageManager(workspace);
+  const prompt = buildImplementPrompt(issue, config2, testRunner, pm);
   const repo = findRepoConfig(config2, issue);
   if (repo?.lifecycle) {
     startSpinner(`${issue.id} \u2014 starting resources...`);
@@ -2959,13 +3194,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 +3218,7 @@ async function runBranchSession(config2, issue, logFile, session, models) {
   });
   stopSpinner();
   try {
-    appendFileSync6(
+    appendFileSync8(
       logFile,
       `
 ${"=".repeat(80)}
@@ -3208,6 +3443,56 @@ function getVersion() {
     return "0.0.0";
   }
 }
+var CURSOR_FREE_PLAN_ERROR = "Free plans can only use Auto";
+async function isCursorFreePlan() {
+  const { mkdtempSync: mkdtempSync6, unlinkSync: unlinkSync7, writeFileSync: writeFileSync9 } = await import("fs");
+  const tmpDir = mkdtempSync6(join10(tmpdir6(), "lisa-cursor-check-"));
+  const promptFile = join10(tmpDir, "prompt.txt");
+  writeFileSync9(promptFile, "test", "utf-8");
+  try {
+    const bin = ["agent", "cursor-agent"].find((b) => {
+      try {
+        execSync6(`${b} --version`, { stdio: "ignore" });
+        return true;
+      } catch {
+        return false;
+      }
+    });
+    if (!bin) return false;
+    const output = execSync6(`${bin} -p "$(cat '${promptFile}')" --output-format text`, {
+      cwd: process.cwd(),
+      encoding: "utf-8",
+      timeout: 3e4
+    });
+    return output.includes(CURSOR_FREE_PLAN_ERROR);
+  } catch (err) {
+    const errorOutput = err instanceof Error ? err.message : String(err);
+    return errorOutput.includes(CURSOR_FREE_PLAN_ERROR);
+  } finally {
+    try {
+      unlinkSync7(promptFile);
+    } catch {
+    }
+    try {
+      execSync6(`rm -rf ${tmpDir}`, { stdio: "ignore" });
+    } catch {
+    }
+  }
+}
+var CURSOR_MODELS = [
+  "auto",
+  "composer-1.5",
+  "composer-1",
+  "gpt-5.3-codex",
+  "gpt-5.3-codex-low",
+  "gpt-5.3-codex-high",
+  "gpt-5.3-codex-xhigh",
+  "gpt-5.3-codex-fast",
+  "sonnet-4.6",
+  "sonnet-4.6-thinking",
+  "sonnet-4.5",
+  "sonnet-4.5-thinking"
+];
 var main = defineCommand({
   meta: {
     name: "lisa",
@@ -3221,7 +3506,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-sonnet-4-6", "claude-opus-4-6", "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 +3543,29 @@ After installing, run ${pc2.cyan("lisa init")} again.`
     if (clack.isCancel(selected)) return process.exit(0);
     providerName = selected;
   }
+  let selectedModels = [];
+  let availableModels = providerModels[providerName];
+  if (providerName === "cursor") {
+    const isFree = await isCursorFreePlan();
+    if (isFree) {
+      availableModels = ["auto"];
+      clack.log.info("Cursor Free plan detected. Using 'auto' model only.");
+    } else {
+      availableModels = CURSOR_MODELS;
+    }
+  }
+  if (availableModels && availableModels.length > 0) {
+    const modelSelection = await clack.multiselect({
+      message: "Which models to use? Select in order: primary first, then fallbacks",
+      options: availableModels.map((m) => ({
+        value: m,
+        label: m
+      })),
+      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 +3692,7 @@ Then run: ${pc2.cyan(`source ${shell}`)}`
   }
   const cfg = {
     provider: providerName,
+    ...selectedModels.length > 0 ? { models: selectedModels } : {},
     source,
     source_config: {
       team,
@@ -3424,12 +3739,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 +3754,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 +3762,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 +3773,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.1",
+	"version": "1.5.0",
 	"description": "Deterministic autonomous issue resolver — structured AI agent loop for Linear/Trello",
 	"license": "MIT",
 	"type": "module",