@tarcisiopgs/lisa 1.12.1 → 1.12.2

package/README.md

@@ -12,6 +12,13 @@
   Lisa is an autonomous issue resolver that turns your backlog into pull requests — no babysitting required.
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/@tarcisiopgs/lisa"><img src="https://img.shields.io/npm/v/@tarcisiopgs/lisa.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@tarcisiopgs/lisa"><img src="https://img.shields.io/npm/dm/@tarcisiopgs/lisa.svg" alt="npm downloads" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
+  <img src="https://img.shields.io/node/v/%40tarcisiopgs%2Flisa" alt="Node.js version" />
+</p>
+
 ---
 
 ## Quickstart
@@ -24,6 +31,8 @@ lisa run
 
 That's it. Lisa picks up the next labeled issue, implements it, pushes a branch, opens a pull request, and moves the ticket to "In Review" — all without you touching it.
 
+`lisa init` offers pre-defined templates for the most common source + provider combinations (GitHub Issues + Claude, Linear + Claude, Jira + Claude, and more). Select a template to pre-fill sensible defaults, or choose "Configure manually" for full control.
+
 ## Try it safely first
 
 Before letting Lisa touch real issues, verify your configuration with `--dry-run`. No issues will be fetched, no code will be written, no PRs will be created.
@@ -53,11 +62,11 @@ Lisa follows a deterministic pipeline:
 └─────────┘    └──────────┘    └───────────┘    └──────────┘    └────┘    └────────┘
 ```
 
-1. **Fetch** — Pulls the next issue from Linear, Trello, Plane, Shortcut, GitLab Issues, GitHub Issues, or Jira matching the configured label, team, and project. Issues are sorted by priority. Blocked issues are skipped.
+1. **Fetch** — Pulls the next issue from your project tracker matching the configured label, team, and project. Issues are sorted by priority. Blocked issues are skipped.
 2. **Activate** — Moves the issue to `in_progress` so your team knows it's being worked on.
 3. **Implement** — Builds a structured prompt with full issue context and sends it to the AI agent. The agent works in a worktree or branch, implements the change, runs tests, and commits.
 4. **Validate** — If the agent's tests pass and pre-push hooks succeed, the branch is pushed. If hooks fail, Lisa re-invokes the agent with the error output and retries.
-5. **PR** — Pushes the branch and creates a pull request referencing the original issue.
+5. **PR** — Pushes the branch and creates a pull request (or merge request) referencing the original issue.
 6. **Update** — Moves the issue to the `done` status and removes the pickup label.
 7. **Next** — Picks the next issue. When there are no more matching issues, Lisa stops.
 
@@ -71,7 +80,29 @@ Lisa follows a deterministic pipeline:
 - **Self-healing** — Orphan issues stuck in "In Progress" are recovered on startup. Pre-push failures trigger the agent to fix and retry.
 - **Guardrails** — Past failures are logged and injected into future prompts so the agent avoids repeating mistakes.
 
-## Providers
+---
+
+## Issue Sources
+
+Lisa integrates with **7 project trackers** out of the box:
+
+| Source | Key | Notes |
+|--------|-----|-------|
+| Linear | `linear` | GraphQL API — priority-sorted, project-scoped, blocker-aware |
+| GitHub Issues | `github-issues` | Native GitHub issues with label-based pickup |
+| Jira | `jira` | Atlassian Jira via REST API (cloud and self-hosted) |
+| GitLab Issues | `gitlab-issues` | GitLab issues with label transitions |
+| Trello | `trello` | Card-based workflow via Trello REST API |
+| Plane | `plane` | Open-source project management (cloud and self-hosted) |
+| Shortcut | `shortcut` | Story-based tracking (formerly Clubhouse) |
+
+Each source supports label filtering, priority ordering, and status transitions out of the box. See [Source-Specific Fields](#source-specific-fields) for configuration details.
+
+---
+
+## AI Providers
+
+Lisa supports **8 AI coding agents** as implementation backends:
 
 | Provider | Key | Command |
 |----------|-----|---------|
@@ -102,6 +133,33 @@ models:
   - claude-haiku-4-5    # fallback 2
 ```
 
+---
+
+## PR Delivery
+
+Lisa delivers pull requests and merge requests to **4 platforms**:
+
+| Platform | Key | Auth | Output |
+|----------|-----|------|--------|
+| GitHub CLI | `cli` | `gh auth login` | Pull Request |
+| GitHub API | `token` | `GITHUB_TOKEN` | Pull Request |
+| GitLab | `gitlab` | `GITLAB_TOKEN` | Merge Request |
+| Bitbucket | `bitbucket` | `BITBUCKET_TOKEN` + `BITBUCKET_USERNAME` | Pull Request |
+
+Set `github` in your config (or pass `--github` at runtime) to select the delivery method:
+
+```yaml
+github: gitlab   # or: cli, token, bitbucket
+```
+
+```bash
+lisa run --github bitbucket   # override at runtime
+```
+
+Each platform appends a `🤖 Resolved by lisa` attribution comment to the PR/MR after creation.
+
+---
+
 ## Install
 
 ```bash
@@ -111,8 +169,11 @@ npm install -g @tarcisiopgs/lisa
 ## Environment Variables
 
 ```bash
-# Required for PR creation (at least one)
-export GITHUB_TOKEN=""    # or have `gh` CLI authenticated
+# PR/MR delivery — set one based on your platform
+export GITHUB_TOKEN=""       # GitHub — or have `gh` CLI authenticated (github: cli or token)
+export GITLAB_TOKEN=""       # GitLab MR creation (github: gitlab)
+export BITBUCKET_TOKEN=""    # Bitbucket PR creation (github: bitbucket)
+export BITBUCKET_USERNAME="" # Bitbucket username (required with BITBUCKET_TOKEN)
 
 # Required when source = linear
 export LINEAR_API_KEY=""
@@ -129,7 +190,7 @@ export PLANE_WORKSPACE="" # optional; fallback when team is not set in config
 # Required when source = shortcut
 export SHORTCUT_API_TOKEN=""
 
-# Required when source = gitlab-issues
+# Required when source = gitlab-issues or github = gitlab
 export GITLAB_TOKEN=""
 export GITLAB_BASE_URL=""  # optional; defaults to https://gitlab.com
 
@@ -140,6 +201,10 @@ export GITHUB_TOKEN=""     # same token used for PR creation
 export JIRA_BASE_URL=""        # e.g. https://yourcompany.atlassian.net
 export JIRA_EMAIL=""           # Atlassian account email
 export JIRA_API_TOKEN=""       # Atlassian API token
+
+# Optional — anonymous crash reporting (disabled by default)
+export LISA_TELEMETRY=1        # enable anonymous crash/error reporting
+export LISA_NO_TELEMETRY=1     # disable reporting (overrides LISA_TELEMETRY and config)
 ```
 
 ## Commands
@@ -157,15 +222,16 @@ export JIRA_API_TOKEN=""       # Atlassian API token
 | `lisa run --provider NAME` | Override AI provider |
 | `lisa run --source NAME` | Override issue source |
 | `lisa run --label NAME` | Override label filter |
-| `lisa run --github METHOD` | Override GitHub method (`cli` or `token`) |
+| `lisa run --github METHOD` | Override PR platform (`cli`, `token`, `gitlab`, or `bitbucket`) |
 | `lisa run --no-bell` | Disable terminal bell on issue completion/failure |
-| `lisa init` | Create `.lisa/config.yaml` interactively |
+| `lisa init` | Create `.lisa/config.yaml` interactively (offers pre-defined templates) |
 | `lisa config` | Edit config interactively |
 | `lisa config --show` | Print current config as JSON |
 | `lisa config --set key=value` | Set a single config value |
 | `lisa status` | Show session stats |
 | `lisa issue get <id>` | Fetch full issue details as JSON (for use inside worktrees) |
 | `lisa issue done <id> --pr-url <url>` | Complete issue, attach PR, update status, remove label |
+| `lisa feedback --pr <url> --issue <id>` | Inject PR review comments from a closed-without-merge PR into guardrails |
 
 ## TUI
 
@@ -219,7 +285,7 @@ source_config:
   in_progress: In Progress
   done: In Review
 
-github: cli          # "cli" (gh) or "token" (GITHUB_TOKEN)
+github: cli          # "cli" (gh), "token" (GITHUB_TOKEN), "gitlab" (GITLAB_TOKEN), or "bitbucket" (BITBUCKET_TOKEN)
 workspace: .
 base_branch: main
 
@@ -249,6 +315,10 @@ overseer:
 # Optional — validate issue spec before accepting
 validation:
   require_acceptance_criteria: true  # skip issues without detectable acceptance criteria (default: true)
+
+# Optional — anonymous crash/error reporting (disabled by default)
+telemetry:
+  enabled: true  # set via `lisa init` prompt or LISA_TELEMETRY=1; override with LISA_NO_TELEMETRY=1
 ```
 
 ### Source-Specific Fields
@@ -365,7 +435,8 @@ Lisa detects blocked issues using the `completedBlockerIds` from your issue trac
 - **Orphan recovery** — On startup, Lisa scans for issues stuck in `in_progress` from interrupted runs and reverts them to `pick_from`.
 - **Push recovery** — If `git push` fails due to pre-push hooks (linter, typecheck, tests), Lisa re-invokes the agent with the error output and retries the push.
 - **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.
+- **Guardrails** — Failed sessions and rejected PR reviews are logged and injected into future prompts so the agent avoids repeating the same mistakes.
+- **PR feedback injection** — When a PR created by Lisa is closed without merge, review comments are automatically captured and injected as guardrails for the next run of the same issue. Use `lisa feedback --pr <url> --issue <id>` to inject feedback manually.
 
 ### Overseer
 

package/dist/chunk-DGL33SDZ.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+// src/git/pr-feedback.ts
+import { execa } from "execa";
+function parsePrUrl(prUrl) {
+  const match = prUrl.match(/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/);
+  if (!match) return null;
+  return { owner: match[1] ?? "", repo: match[2] ?? "", prNumber: match[3] ?? "" };
+}
+async function fetchPrFeedback(prUrl) {
+  const parsed = parsePrUrl(prUrl);
+  if (!parsed) {
+    throw new Error(`Invalid GitHub PR URL: ${prUrl}`);
+  }
+  const { owner, repo, prNumber } = parsed;
+  const { stdout: prJson } = await execa("gh", [
+    "pr",
+    "view",
+    prUrl,
+    "--json",
+    "title,state,mergedAt"
+  ]);
+  const { title, state, mergedAt } = JSON.parse(prJson);
+  let prState;
+  if (mergedAt) {
+    prState = "merged";
+  } else if (state === "CLOSED") {
+    prState = "closed";
+  } else {
+    prState = "open";
+  }
+  const { stdout: reviewsJson } = await execa("gh", [
+    "api",
+    `/repos/${owner}/${repo}/pulls/${prNumber}/reviews`
+  ]);
+  const rawReviews = JSON.parse(reviewsJson);
+  const reviews = rawReviews.filter((r) => r.body.trim()).map((r) => ({
+    author: r.user.login,
+    state: r.state,
+    body: r.body,
+    submittedAt: r.submitted_at
+  }));
+  const { stdout: commentsJson } = await execa("gh", [
+    "api",
+    `/repos/${owner}/${repo}/pulls/${prNumber}/comments`
+  ]);
+  const rawComments = JSON.parse(commentsJson);
+  const comments = rawComments.map((c) => ({
+    author: c.user.login,
+    body: c.body,
+    path: c.path,
+    line: c.line,
+    createdAt: c.created_at
+  }));
+  return { prUrl, title, state: prState, reviews, comments };
+}
+function formatPrFeedbackEntry(feedback, issueId, date) {
+  const lines = [
+    `## PR Feedback for Issue ${issueId} (${date})`,
+    `- PR: ${feedback.prUrl}`,
+    `- Title: ${feedback.title}`,
+    `- Status: Closed without merge`
+  ];
+  if (feedback.reviews.length > 0) {
+    lines.push("- Reviews:");
+    lines.push("```");
+    for (const review of feedback.reviews) {
+      lines.push(`[${review.author}] ${review.state}: ${review.body}`);
+    }
+    lines.push("```");
+  }
+  if (feedback.comments.length > 0) {
+    lines.push("- Inline comments:");
+    lines.push("```");
+    for (const comment of feedback.comments) {
+      const location = comment.path ? ` (${comment.path}${comment.line ? `:${comment.line}` : ""})` : "";
+      lines.push(`[${comment.author}]${location}: ${comment.body}`);
+    }
+    lines.push("```");
+  }
+  return lines.join("\n");
+}
+
+export {
+  parsePrUrl,
+  fetchPrFeedback,
+  formatPrFeedbackEntry
+};

package/dist/chunk-NXGXGHS3.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import {
+  getGuardrailsPath
+} from "./chunk-OYQ6TOAG.js";
+
+// src/session/guardrails.ts
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
+var LEGACY_GUARDRAILS_FILE = ".lisa/guardrails.md";
+var MAX_ENTRIES = 20;
+var CONTEXT_LINES = 20;
+var writeLock = Promise.resolve();
+function guardrailsPath(cwd) {
+  return getGuardrailsPath(cwd);
+}
+function migrateGuardrails(cwd) {
+  const legacyPath = join(cwd, LEGACY_GUARDRAILS_FILE);
+  if (!existsSync(legacyPath)) return;
+  const cachePath = getGuardrailsPath(cwd);
+  if (existsSync(cachePath)) return;
+  const cacheDir = dirname(cachePath);
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
+  }
+  copyFileSync(legacyPath, cachePath);
+}
+function readGuardrails(cwd) {
+  const path = getGuardrailsPath(cwd);
+  if (!existsSync(path)) return "";
+  try {
+    return readFileSync(path, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function buildGuardrailsSection(cwd) {
+  const content = readGuardrails(cwd);
+  if (!content.trim()) return "";
+  return `
+## Guardrails \u2014 Avoid these known pitfalls
+
+${content}
+`;
+}
+function extractContext(output) {
+  const lines = output.trim().split("\n");
+  return lines.slice(-CONTEXT_LINES).join("\n");
+}
+function extractErrorType(output) {
+  if (/429|rate.?limit|quota/i.test(output)) return "Rate limit / quota exceeded";
+  if (/ETIMEDOUT|ECONNREFUSED|ECONNRESET|ENOTFOUND/.test(output)) return "Network error";
+  if (/timeout|timed?\s*out/i.test(output)) return "Timeout";
+  const exitMatch = output.match(/exit code[:\s]+(\d+)/i);
+  if (exitMatch) return `Exit code ${exitMatch[1]}`;
+  if (/exit(?:ed)? with/i.test(output)) return "Non-zero exit code";
+  return "Unknown error";
+}
+function appendEntry(dir, entry) {
+  writeLock = writeLock.then(() => appendEntrySync(dir, entry)).catch(() => {
+  });
+}
+function appendEntrySync(dir, entry) {
+  const path = guardrailsPath(dir);
+  const guardrailsDir = dirname(path);
+  if (!existsSync(guardrailsDir)) {
+    mkdirSync(guardrailsDir, { recursive: true });
+  }
+  const existing = existsSync(path) ? readFileSync(path, "utf-8") : "";
+  const newEntryText = formatEntry(entry);
+  let content;
+  if (!existing.trim()) {
+    content = `# Guardrails \u2014 Li\xE7\xF5es aprendidas
+
+${newEntryText}`;
+  } else {
+    const header = extractHeader(existing);
+    const entries = splitEntries(existing);
+    entries.push(newEntryText);
+    const rotated = entries.length > MAX_ENTRIES ? entries.slice(-MAX_ENTRIES) : entries;
+    content = `${header}
+
+${rotated.join("\n\n")}`;
+  }
+  writeFileSync(path, content, "utf-8");
+}
+function appendRawEntry(dir, entryText) {
+  writeLock = writeLock.then(() => appendRawEntrySync(dir, entryText)).catch(() => {
+  });
+}
+function appendRawEntrySync(dir, entryText) {
+  const path = guardrailsPath(dir);
+  const guardrailsDir = dirname(path);
+  if (!existsSync(guardrailsDir)) {
+    mkdirSync(guardrailsDir, { recursive: true });
+  }
+  const existing = existsSync(path) ? readFileSync(path, "utf-8") : "";
+  let content;
+  if (!existing.trim()) {
+    content = `# Guardrails \u2014 Li\xE7\xF5es aprendidas
+
+${entryText}`;
+  } else {
+    const header = extractHeader(existing);
+    const entries = splitEntries(existing);
+    entries.push(entryText);
+    const rotated = entries.length > MAX_ENTRIES ? entries.slice(-MAX_ENTRIES) : entries;
+    content = `${header}
+
+${rotated.join("\n\n")}`;
+  }
+  writeFileSync(path, content, "utf-8");
+}
+function formatEntry(entry) {
+  return [
+    `## Issue ${entry.issueId} (${entry.date})`,
+    `- Provider: ${entry.provider}`,
+    `- Erro: ${entry.errorType}`,
+    `- Contexto:`,
+    "```",
+    entry.context,
+    "```"
+  ].join("\n");
+}
+function extractHeader(content) {
+  const firstEntry = content.search(/^## /m);
+  if (firstEntry === -1) return content.trim();
+  return content.slice(0, firstEntry).trim();
+}
+function splitEntries(content) {
+  const positions = [];
+  const regex = /^## /gm;
+  for (const match of content.matchAll(regex)) {
+    positions.push(match.index);
+  }
+  return positions.map((start, i) => {
+    const end = positions[i + 1] ?? content.length;
+    return content.slice(start, end).trim();
+  });
+}
+
+export {
+  guardrailsPath,
+  migrateGuardrails,
+  readGuardrails,
+  buildGuardrailsSection,
+  extractContext,
+  extractErrorType,
+  appendEntry,
+  appendEntrySync,
+  appendRawEntry,
+  appendRawEntrySync
+};

package/dist/chunk-OYQ6TOAG.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+// src/paths.ts
+import { createHash } from "crypto";
+import { existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from "fs";
+import { homedir } from "os";
+import { join, resolve } from "path";
+var MAX_LOG_FILES = 20;
+function projectHash(cwd) {
+  const absolute = resolve(cwd);
+  return createHash("sha256").update(absolute).digest("hex").slice(0, 12);
+}
+function getCacheDir(cwd) {
+  const base = process.env.XDG_CACHE_HOME || join(homedir(), ".cache");
+  return join(base, "lisa", projectHash(cwd));
+}
+function getLogsDir(cwd) {
+  return join(getCacheDir(cwd), "logs");
+}
+function getGuardrailsPath(cwd) {
+  return join(getCacheDir(cwd), "guardrails.md");
+}
+function getManifestPath(cwd, issueId) {
+  if (issueId) {
+    const safe = issueId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(getCacheDir(cwd), `manifest-${safe}.json`);
+  }
+  return join(getCacheDir(cwd), "manifest.json");
+}
+function getPrCachePath(cwd) {
+  return join(getCacheDir(cwd), "pr-cache.json");
+}
+function getPlanPath(cwd, issueId) {
+  if (issueId) {
+    const safe = issueId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(getCacheDir(cwd), `plan-${safe}.json`);
+  }
+  return join(getCacheDir(cwd), "plan.json");
+}
+function ensureCacheDir(cwd) {
+  const dir = getCacheDir(cwd);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function rotateLogFiles(cwd) {
+  const logsDir = getLogsDir(cwd);
+  if (!existsSync(logsDir)) return;
+  const files = readdirSync(logsDir).filter((f) => f.endsWith(".log")).map((f) => ({
+    name: f,
+    path: join(logsDir, f),
+    mtime: statSync(join(logsDir, f)).mtimeMs
+  })).sort((a, b) => a.mtime - b.mtime);
+  const excess = files.length - MAX_LOG_FILES;
+  if (excess <= 0) return;
+  for (const file of files.slice(0, excess)) {
+    try {
+      unlinkSync(file.path);
+    } catch {
+    }
+  }
+}
+
+export {
+  projectHash,
+  getCacheDir,
+  getLogsDir,
+  getGuardrailsPath,
+  getManifestPath,
+  getPrCachePath,
+  getPlanPath,
+  ensureCacheDir,
+  rotateLogFiles
+};

package/dist/guardrails-KI5NEJVE.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  appendEntry,
+  appendEntrySync,
+  appendRawEntry,
+  appendRawEntrySync,
+  buildGuardrailsSection,
+  extractContext,
+  extractErrorType,
+  guardrailsPath,
+  migrateGuardrails,
+  readGuardrails
+} from "./chunk-NXGXGHS3.js";
+import "./chunk-OYQ6TOAG.js";
+export {
+  appendEntry,
+  appendEntrySync,
+  appendRawEntry,
+  appendRawEntrySync,
+  buildGuardrailsSection,
+  extractContext,
+  extractErrorType,
+  guardrailsPath,
+  migrateGuardrails,
+  readGuardrails
+};