@tarcisiopgs/lisa 1.30.0 → 1.32.0

package/README.md

@@ -40,7 +40,8 @@ If something fails — pre-push hooks, quota limits, stuck processes — Lisa ha
 - **7 issue trackers** — Linear, GitHub Issues, GitLab Issues, Jira, Trello, Plane, Shortcut
 - **8 AI agents** — Claude Code, Gemini CLI, GitHub Copilot CLI, Cursor Agent, Aider, Goose, OpenCode, Codex
 - **AI planning** — describe a goal, the AI brainstorms with you, decomposes it into issues with dependencies, created in your tracker
-- **Language-aware** — detects your goal's language (pt/en/es) and generates issues in the same language
+- **Language-aware** — responds in the same language you write your goal in
+- **Spec compliance** — LLM-verified acceptance criteria check before PR creation, with auto-retry
 - **Concurrent execution** — process multiple issues in parallel, each in its own worktree
 - **Multi-repo** — plans across repos, creates one PR per repo in the correct order
 - **Model fallback** — chain models; transient errors (429, quota, timeout) auto-switch to the next
@@ -48,6 +49,7 @@ If something fails — pre-push hooks, quota limits, stuck processes — Lisa ha
 - **CI monitoring** — polls CI after PR creation, re-invokes the agent to fix failures automatically
 - **Progress comments** — posts real-time status updates on issues as Lisa works through stages
 - **Context enrichment** — greps for issue-related files and surfaces them in the agent prompt
+- **PR reviewers & assignees** — auto-request reviews and assign PRs via config; `self` keyword resolves to the authenticated user
 - **Self-healing** — orphan recovery on startup, push failure retry, stuck process detection
 - **Guardrails** — past failures are injected into future prompts to avoid repeating mistakes
 - **Project context** — auto-generates `.lisa/context.md` with your stack, conventions, and constraints
@@ -101,6 +103,9 @@ lisa plan --no-brainstorm "goal" # skip brainstorming, decompose directly
 lisa plan --yes "goal"      # skip confirmations (CI/scripts)
 lisa init                   # create .lisa/config.yaml interactively
 lisa status                 # show session stats
+lisa config --show           # print current config
+lisa config --get loop.cooldown  # query a specific value
+lisa config --set loop.cooldown=5  # set nested config values
 lisa doctor                 # diagnose setup issues (config, provider, env, git)
 lisa context refresh        # regenerate project context
 lisa feedback --pr URL      # inject PR review feedback into guardrails
@@ -235,6 +240,11 @@ proof_of_work:
 validation:
   require_acceptance_criteria: true
 
+spec_compliance:
+  enabled: true
+  max_retries: 1             # retry agent to fix unmet criteria (default: 1)
+  block_on_failure: true     # skip PR when criteria aren't met (default: false)
+
 ci_monitor:
   enabled: true
   max_retries: 3             # fix attempts on CI failure
@@ -244,10 +254,41 @@ ci_monitor:
 
 progress_comments:
   enabled: true              # post real-time status on issues
+
+pr:
+  reviewers:                   # auto-request reviews on every PR
+    - octocat
+    - hubot
+  assignees:                   # auto-assign PRs ("self" = authenticated user)
+    - self
+
+hooks:
+  before_run: "./scripts/setup.sh"
+  after_run: "./scripts/cleanup.sh"
+  timeout: 60000             # ms, default 60000
 ```
 
 </details>
 
+## Validation Pipeline
+
+After the agent implements an issue, Lisa runs a multi-stage validation pipeline before creating a PR:
+
+```
+Agent implements → Proof of Work (lint/test/typecheck) → Spec Compliance → PR
+```
+
+**Proof of Work** runs configured shell commands (lint, typecheck, test). If any fail, the agent is re-invoked with the error output to fix the issue.
+
+**Spec Compliance** extracts acceptance criteria from the issue description (`- [ ]` checklists) and asks the LLM to verify each one against the git diff. The result is a structured JSON with met/not-met verdicts and evidence. If criteria are unmet, the agent is re-invoked to fix them. Results are appended to the PR body as a Markdown table:
+
+| Criterion | Status | Evidence |
+|-----------|--------|----------|
+| Returns 429 on rate limit | Met | Rate limit middleware returns 429 |
+| Headers include X-RateLimit | Not Met | No header injection found |
+
+Both stages support `max_retries` and `block_on_failure` — when blocking is enabled, the PR is skipped entirely on failure.
+
 ## Writing Good Issues
 
 Issue quality = PR quality. Lisa validates issues and skips vague ones (labeling them `needs-spec`).
@@ -290,15 +331,23 @@ The real-time Kanban board shows issue progress, streams provider output, and de
 | `m` | Merge PR (warns if CI not passed) |
 | `Esc` | Back to board |
 
-**Plan mode**
+**Plan chat**
+
+| Key | Action |
+|-----|--------|
+| `↵` | Send message |
+| `↑` `↓` | Scroll chat history |
+| `Esc` | Cancel |
+
+**Plan review**
 
 | Key | Action |
 |-----|--------|
-| `↵` | Send message / view detail |
+| `↵` | View issue detail |
 | `e` | Edit issue in $EDITOR |
 | `d` | Delete issue |
 | `a` | Approve and create issues |
-| `Esc` | Cancel / back |
+| `Esc` | Back |
 
 In CLI mode, the plan wizard also offers **Regenerate with feedback** — describe what to change and the AI regenerates the entire plan incorporating your feedback.
 

package/dist/{chunk-PBPVDKID.js → chunk-AAWXKEV7.js}

@@ -4,6 +4,10 @@ import {
   analyzeProject,
   appendPlatformAttribution,
   appendPlatformProofOfWork,
+  appendPlatformSpecCompliance,
+  applyPrReviewersAndAssignees,
+  buildCompliancePrompt,
+  buildComplianceRecoveryPrompt,
   buildContinuationPrompt,
   buildImplementPrompt,
   buildNativeWorktreePrompt,
@@ -15,14 +19,18 @@ import {
   createSource,
   detectPackageManager,
   detectTestRunner,
+  extractAcceptanceCriteria,
   getContextPath,
+  getFullDiff,
   isCompleteProviderExhaustion,
   isProofOfWorkEnabled,
+  isSpecComplianceEnabled,
+  parseComplianceResponse,
   readContext,
   resolveModels,
   runValidationCommands,
   runWithFallback
-} from "./chunk-IMIDFVMI.js";
+} from "./chunk-NHC3JG2C.js";
 import {
   divider,
   error,
@@ -185,6 +193,23 @@ function findConfigDir(startDir = process.cwd()) {
     dir = parent;
   }
 }
+var USERNAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,38}$/;
+function isValidPrUsername(s) {
+  return s === "self" || USERNAME_RE.test(s);
+}
+function isStringArray(v) {
+  return Array.isArray(v) && v.every((item) => typeof item === "string");
+}
+function parsePrConfig(raw) {
+  if (!raw) return void 0;
+  const reviewers = isStringArray(raw.reviewers) ? raw.reviewers.filter(isValidPrUsername) : void 0;
+  const assignees = isStringArray(raw.assignees) ? raw.assignees.filter(isValidPrUsername) : void 0;
+  if (!reviewers?.length && !assignees?.length) return void 0;
+  return {
+    reviewers: reviewers?.length ? reviewers : void 0,
+    assignees: assignees?.length ? assignees : void 0
+  };
+}
 function loadConfig(cwd = process.cwd()) {
   const configPath = getConfigPath(cwd);
   if (!existsSync(configPath)) {
@@ -225,7 +250,9 @@ function loadConfig(cwd = process.cwd()) {
   const rawProofOfWork = parsed.proof_of_work;
   const rawReconciliation = parsed.reconciliation;
   const rawCiMonitor = parsed.ci_monitor;
+  const rawSpecCompliance = parsed.spec_compliance;
   const rawProgress = parsed.progress_comments;
+  const rawPr = parsed.pr;
   const config = {
     ...DEFAULT_CONFIG,
     ...parsedWithoutLogs,
@@ -265,7 +292,13 @@ function loadConfig(cwd = process.cwd()) {
       poll_timeout: rawCiMonitor.poll_timeout,
       block_on_failure: rawCiMonitor.block_on_failure
     } : void 0,
+    spec_compliance: rawSpecCompliance ? {
+      enabled: rawSpecCompliance.enabled ?? false,
+      max_retries: rawSpecCompliance.max_retries,
+      block_on_failure: rawSpecCompliance.block_on_failure
+    } : void 0,
     progress_comments: rawProgress ? { enabled: rawProgress.enabled ?? false } : void 0,
+    pr: parsePrConfig(rawPr),
     provider_options: {
       ...DEFAULT_CONFIG.provider_options || {},
       ...parsed.provider_options ?? {}
@@ -1175,7 +1208,7 @@ async function startInfra(issueId, cwd, config) {
 function startReconciliationMonitor(source, issueId, config) {
   return source && config.reconciliation?.enabled ? startReconciliation(source, issueId, config.reconciliation, config.source_config) : null;
 }
-async function runProofOfWork(config, issue, models, cwd, logFile, workspace, lifecycleEnv, result) {
+async function runProofOfWork(config, issue, models, cwd, logFile, workspace, lifecycleEnv, _result) {
   if (!isProofOfWorkEnabled(config.proof_of_work)) return {};
   const pow = config.proof_of_work;
   let retriesLeft = pow?.max_retries ?? 2;
@@ -1229,6 +1262,90 @@ async function runProofOfWork(config, issue, models, cwd, logFile, workspace, li
     }
   }
 }
+async function runSpecCompliance(config, issue, models, cwd, baseBranch, logFile, workspace, lifecycleEnv) {
+  if (!isSpecComplianceEnabled(config.spec_compliance)) return {};
+  const criteria = extractAcceptanceCriteria(issue.description);
+  if (criteria.length === 0) {
+    warn(`No extractable acceptance criteria for ${issue.id}. Skipping spec compliance.`);
+    return {};
+  }
+  const sc = config.spec_compliance;
+  let retriesLeft = sc?.max_retries ?? 1;
+  while (true) {
+    if (reconciliationSet.has(issue.id)) {
+      reconciliationSet.delete(issue.id);
+      warn(`Issue ${issue.id} was closed/cancelled during spec compliance. Skipping.`);
+      return { reconciled: true };
+    }
+    startSpinner(`${issue.id} \u2014 checking spec compliance...`);
+    const diff = await getFullDiff(cwd, baseBranch);
+    if (!diff) {
+      stopSpinner();
+      warn(`No diff available for spec compliance on ${issue.id}. Skipping.`);
+      return {};
+    }
+    const compliancePrompt = buildCompliancePrompt(issue, criteria, diff);
+    const checkResult = await runWithFallback(
+      models,
+      compliancePrompt,
+      buildRunOptions(config, issue, cwd, logFile, workspace, lifecycleEnv)
+    );
+    stopSpinner();
+    if (!checkResult.success) {
+      warn(`Spec compliance check failed to run for ${issue.id}. Proceeding without it.`);
+      return {};
+    }
+    const compliance = parseComplianceResponse(checkResult.output);
+    if (!compliance) {
+      warn(
+        `Could not parse spec compliance response for ${issue.id}. Proceeding without it.`
+      );
+      return {};
+    }
+    if (compliance.passed) {
+      ok(`Spec compliance passed for ${issue.id}: ${compliance.summary}`);
+      return { result: compliance };
+    }
+    const unmet = compliance.criteria.filter((c) => !c.met);
+    warn(
+      `Spec compliance failed for ${issue.id}: ${compliance.summary} (${unmet.length} unmet)`
+    );
+    if (retriesLeft <= 0) {
+      if (sc?.block_on_failure) {
+        error(
+          `Spec compliance failed after max retries for ${issue.id}. Blocking PR creation.`
+        );
+        return { result: compliance, blocked: true };
+      }
+      warn(
+        `Spec compliance failed after max retries for ${issue.id}. Creating PR with failures noted.`
+      );
+      return { result: compliance };
+    }
+    retriesLeft--;
+    warn(
+      `Re-invoking agent to fix unmet criteria for ${issue.id} (${retriesLeft} retries left)...`
+    );
+    const recoveryPrompt = buildComplianceRecoveryPrompt(issue, unmet);
+    startSpinner(`${issue.id} \u2014 fixing unmet criteria...`);
+    const recoveryResult = await runWithFallback(
+      models,
+      recoveryPrompt,
+      buildRunOptions(config, issue, cwd, logFile, workspace, lifecycleEnv)
+    );
+    stopSpinner();
+    if (!recoveryResult.success) {
+      if (sc?.block_on_failure) {
+        error(`Spec compliance recovery failed for ${issue.id}. Blocking PR creation.`);
+        return { result: compliance, blocked: true };
+      }
+      warn(
+        `Spec compliance recovery failed for ${issue.id}. Creating PR with failures noted.`
+      );
+      return { result: compliance };
+    }
+  }
+}
 
 // src/loop/recovery.ts
 async function injectRejectedPrFeedback(workspace, issueId, prUrls) {
@@ -2480,6 +2597,7 @@ ${contResult.output}
   await executeHook("before_remove", config.hooks, worktreePath, hookEnv);
   await cleanupWorktree(repoPath, worktreePath);
   await appendPlatformAttribution(prUrl, result.providerUsed, config.platform);
+  await applyPrReviewersAndAssignees(prUrl, config.pr, config.platform);
   ok(`Step ${stepNum} complete: ${repoPath} \u2014 PR: ${prUrl}`);
   return {
     success: true,
@@ -2649,6 +2767,7 @@ async function runNativeWorktreeSession(config, issue, logFile, session, models,
   }
   ok(`PR created by provider: ${prUrl}`);
   await appendPlatformAttribution(prUrl, result.providerUsed, config.platform);
+  await applyPrReviewersAndAssignees(prUrl, config.pr, config.platform);
   if (isCiMonitorEnabled(config.ci_monitor)) {
     const manifestBranch = manifest?.branch;
     if (manifestBranch) {
@@ -2794,6 +2913,29 @@ async function runManualWorktreeSession(config, issue, logFile, session, models,
   if (validationResults) {
     await reporter.update("validating", "Validation passed");
   }
+  const complianceResult = await runSpecCompliance(
+    config,
+    issue,
+    models,
+    worktreePath,
+    baseBranch,
+    logFile,
+    workspace,
+    lifecycleEnv
+  );
+  if (complianceResult.reconciled) {
+    await cleanupWorktree(repoPath, worktreePath);
+    return failureResult(result.providerUsed, result);
+  }
+  if (complianceResult.blocked) {
+    error(
+      `Skipping PR for ${issue.id} \u2014 spec compliance failed with block_on_failure enabled.`
+    );
+    await reporter.fail("Spec compliance failed");
+    await executeHook("before_remove", config.hooks, worktreePath, hookEnv);
+    await cleanupWorktree(repoPath, worktreePath);
+    return failureResult(result.providerUsed, result);
+  }
   const manifest = readManifestFile(manifestPath);
   let prUrl = manifest?.prUrl;
   if (!prUrl) {
@@ -2847,9 +2989,13 @@ async function runManualWorktreeSession(config, issue, logFile, session, models,
   }
   ok(`PR created by provider: ${prUrl}`);
   await appendPlatformAttribution(prUrl, result.providerUsed, config.platform);
+  await applyPrReviewersAndAssignees(prUrl, config.pr, config.platform);
   if (validationResults) {
     await appendPlatformProofOfWork(prUrl, validationResults, config.platform);
   }
+  if (complianceResult.result) {
+    await appendPlatformSpecCompliance(prUrl, complianceResult.result, config.platform);
+  }
   if (isCiMonitorEnabled(config.ci_monitor)) {
     const manifestBranch = manifest?.branch ?? branchName;
     const ciResult = await monitorCi(
@@ -3308,6 +3454,26 @@ async function runBranchSession(config, issue, logFile, session, models, source,
   if (validationResults) {
     await reporter.update("validating", "Validation passed");
   }
+  const complianceResult = await runSpecCompliance(
+    config,
+    issue,
+    models,
+    workspace,
+    config.base_branch,
+    logFile,
+    workspace,
+    lifecycleEnv
+  );
+  if (complianceResult.reconciled) {
+    return failureResult(result.providerUsed, result);
+  }
+  if (complianceResult.blocked) {
+    error(
+      `Skipping PR for ${issue.id} \u2014 spec compliance failed with block_on_failure enabled.`
+    );
+    await reporter.fail("Spec compliance failed");
+    return failureResult(result.providerUsed, result);
+  }
   const manifest = readManifestFile(manifestPath);
   try {
     unlinkSync3(manifestPath);
@@ -3327,9 +3493,13 @@ async function runBranchSession(config, issue, logFile, session, models, source,
   }
   ok(`PR created by provider: ${prUrl}`);
   await appendPlatformAttribution(prUrl, result.providerUsed, config.platform);
+  await applyPrReviewersAndAssignees(prUrl, config.pr, config.platform);
   if (validationResults) {
     await appendPlatformProofOfWork(prUrl, validationResults, config.platform);
   }
+  if (complianceResult.result) {
+    await appendPlatformSpecCompliance(prUrl, complianceResult.result, config.platform);
+  }
   if (isCiMonitorEnabled(config.ci_monitor)) {
     const manifestBranch = manifest?.branch;
     if (manifestBranch) {

package/dist/{chunk-5GZPXARF.js → chunk-K2ILRYXS.js}

@@ -4,7 +4,7 @@ import {
   readContext,
   resolveModels,
   runWithFallback
-} from "./chunk-IMIDFVMI.js";
+} from "./chunk-NHC3JG2C.js";
 import {
   error,
   log,
@@ -208,164 +208,7 @@ _Depends on: ${depRefs}_`;
 
 // src/plan/prompt.ts
 import { resolve } from "path";
-
-// src/plan/language.ts
-var STOP_WORDS = {
-  pt: /* @__PURE__ */ new Set([
-    "n\xE3o",
-    "tamb\xE9m",
-    "j\xE1",
-    "est\xE1",
-    "s\xE3o",
-    "nos",
-    "das",
-    "dos",
-    "pelo",
-    "pela",
-    "uma",
-    "nas",
-    "aos",
-    "essa",
-    "esse",
-    "isso",
-    "aqui",
-    "muito",
-    "quando",
-    "como",
-    "mais",
-    "ainda",
-    "fazer",
-    "deve",
-    "pode",
-    "cada",
-    "todos",
-    "todas",
-    "entre",
-    "ap\xF3s",
-    "sobre",
-    "seus",
-    "suas",
-    "desta",
-    "deste",
-    "onde",
-    "apenas",
-    // Common contractions (preposition + article)
-    "na",
-    "no",
-    "da",
-    "do",
-    "ao",
-    "num",
-    "numa",
-    "para",
-    "com",
-    "sem",
-    "ou"
-  ]),
-  es: /* @__PURE__ */ new Set([
-    "tambi\xE9n",
-    "m\xE1s",
-    "pero",
-    "muy",
-    "est\xE1",
-    "est\xE1n",
-    "puede",
-    "todo",
-    "esta",
-    "este",
-    "como",
-    "cuando",
-    "donde",
-    "cada",
-    "entre",
-    "sobre",
-    "despu\xE9s",
-    "antes",
-    "desde",
-    "hasta",
-    "seg\xFAn",
-    "durante",
-    "todos",
-    "todas",
-    "otro",
-    "otra",
-    "otros",
-    "otras",
-    "hacer",
-    "debe",
-    "aqu\xED",
-    "ahora",
-    "siempre",
-    "nunca"
-  ]),
-  en: /* @__PURE__ */ new Set([
-    "the",
-    "is",
-    "are",
-    "was",
-    "were",
-    "been",
-    "being",
-    "have",
-    "has",
-    "had",
-    "having",
-    "does",
-    "did",
-    "will",
-    "would",
-    "could",
-    "should",
-    "might",
-    "shall",
-    "this",
-    "that",
-    "these",
-    "those",
-    "with",
-    "from",
-    "into",
-    "through",
-    "during",
-    "before",
-    "after",
-    "above",
-    "below",
-    "between",
-    "each",
-    "every",
-    "which",
-    "when",
-    "where",
-    "while"
-  ])
-};
-var LANGUAGE_NAMES = {
-  pt: "Portuguese",
-  es: "Spanish",
-  en: "English"
-};
-function detectLanguage(text2) {
-  const words = text2.toLowerCase().replace(/[^\p{L}\s]/gu, "").split(/\s+/).filter((w) => w.length > 1);
-  if (words.length === 0) return "en";
-  const scores = { pt: 0, es: 0, en: 0 };
-  for (const word of words) {
-    for (const [lang, stopWords] of Object.entries(STOP_WORDS)) {
-      if (stopWords.has(word)) {
-        scores[lang]++;
-      }
-    }
-  }
-  const best = Object.entries(scores).sort((a, b) => b[1] - a[1])[0];
-  return best[1] > 0 ? best[0] : "en";
-}
-function languageName(code) {
-  return LANGUAGE_NAMES[code] ?? "English";
-}
-
-// src/plan/prompt.ts
 function buildPlanningPrompt(goal, config, parentIssueDescription) {
-  const language = detectLanguage(goal);
   const workspace = resolve(config.workspace);
   const contextMd = readContext(workspace);
   const contextBlock = buildContextMdBlock(contextMd);
@@ -379,6 +222,8 @@ ${parentIssueDescription}
 ` : "";
   return `You are a project planning agent. Your job is to decompose a high-level goal into atomic, implementable issues.
 
+Always respond in the same language the user wrote their goal in.
+
 ## Goal
 
 ${goal}
@@ -399,10 +244,6 @@ For each issue, provide:
 - **order**: Integer (1-based) \u2014 execution order based on dependencies
 - **dependsOn**: Array of order numbers this issue depends on (empty if independent)
 ${config.repos.length > 1 ? "- **repo**: Name of the target repository from the list above (required for multi-repo)\n" : ""}
-## Language
-
-Respond in ${languageName(language)}. Generate all issue titles, descriptions, and acceptance criteria in ${languageName(language)}.
-
 ## Rules
 
 1. Each issue MUST be self-contained and completable in a single session
@@ -751,8 +592,6 @@ function markdownToIssue(content, original) {
 
 export {
   CliError,
-  detectLanguage,
-  languageName,
   parseStructuredOutput,
   createPlanIssues,
   buildPlanningPrompt,