@tarcisiopgs/lisa 1.4.0 → 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

@@ -3,6 +3,7 @@
 // src/cli.ts
 import { execSync as execSync6 } from "child_process";
 import { existsSync as existsSync7, readdirSync, readFileSync as readFileSync6 } from "fs";
+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";
@@ -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();
@@ -1294,9 +1302,10 @@ var CursorProvider = class {
     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`],
+        ["-c", `${bin} -p "$(cat '${promptFile}')" --output-format text --force ${modelFlag}`],
         {
           cwd: opts.cwd,
           stdio: ["ignore", "pipe", "pipe"]
@@ -2215,6 +2224,15 @@ function resolveModels(config2) {
       );
     }
   }
+  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
@@ -2608,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) {
@@ -2678,8 +2697,9 @@ async function runNativeWorktreeSession(config2, issue, logFile, session, models
   }
   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);
@@ -2828,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);
@@ -3044,7 +3065,19 @@ async function runMultiRepoStep(config2, issue, step, previousResults, logFile,
   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,
@@ -3054,6 +3087,7 @@ async function runMultiRepoStep(config2, issue, step, previousResults, logFile,
     overseer: config2.overseer
   });
   stopSpinner();
+  if (repoConfig?.lifecycle) await stopResources();
   try {
     appendFileSync8(
       logFile,
@@ -3148,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...`);
@@ -3408,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",
@@ -3426,7 +3511,7 @@ async function runConfigWizard() {
     cursor: "Cursor Agent"
   };
   const providerModels = {
-    claude: ["claude-opus-4-5", "claude-sonnet-4-5", "claude-haiku-4-5"],
+    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();
@@ -3459,14 +3544,22 @@ After installing, run ${pc2.cyan("lisa init")} again.`
     providerName = selected;
   }
   let selectedModels = [];
-  const availableModels = providerModels[providerName];
+  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? (first = primary, rest = fallbacks in order)",
-      options: availableModels.map((m, i) => ({
+      message: "Which models to use? Select in order: primary first, then fallbacks",
+      options: availableModels.map((m) => ({
         value: m,
-        label: m,
-        hint: i === 0 ? "primary" : `fallback ${i}`
+        label: m
       })),
       required: false
     });

package/package.json

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