@tarcisiopgs/lisa 0.5.0

package/README.md

@@ -0,0 +1,113 @@
+# lisa
+
+Autonomous issue resolver — picks up issues from Linear or Trello, sends them to an AI coding agent (Claude Code, Gemini CLI, or OpenCode), and opens PRs via the GitHub API. No MCP servers required.
+
+## Install
+
+```bash
+npm install -g @tarcisiopgs/lisa
+```
+
+## Environment Variables
+
+lisa calls external APIs directly. Set these in your shell profile (`~/.zshrc` or `~/.bashrc`):
+
+```bash
+# Required (always)
+export GITHUB_TOKEN=""
+
+# Required when source = linear
+export LINEAR_API_KEY=""
+
+# Required when source = trello
+export TRELLO_API_KEY=""
+export TRELLO_TOKEN=""
+```
+
+The CLI will warn you if any required variable is missing.
+
+## Quick Start
+
+```bash
+# Interactive setup
+lisa init
+
+# Run continuously
+lisa run
+
+# Single issue
+lisa run --once
+
+# Preview without executing
+lisa run --dry-run
+
+# Override provider
+lisa run --provider gemini --once
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `lisa run` | Run the agent loop |
+| `lisa run --once` | Process a single issue |
+| `lisa run --limit N` | Process up to N issues |
+| `lisa run --dry-run` | Preview without executing |
+| `lisa config` | Interactive config wizard |
+| `lisa config --show` | Show current config |
+| `lisa config --set key=value` | Set a config value |
+| `lisa init` | Create `.lisa/config.yaml` |
+| `lisa status` | Show session stats |
+
+## Providers
+
+| Provider | CLI | Auto-approve Flag |
+|----------|-----|-------------------|
+| Claude Code | `claude` | `--dangerously-skip-permissions` |
+| Gemini CLI | `gemini` | `--yolo` |
+| OpenCode | `opencode` | implicit in `run` |
+
+At least one provider must be installed and available in your PATH.
+
+## Configuration
+
+Config lives in `.lisa/config.yaml`:
+
+```yaml
+provider: claude
+
+source: linear
+source_config:
+  team: Internal
+  project: Zenixx
+  label: ready
+  status: Backlog
+
+workspace: .
+repos:
+  - name: app
+    path: ./app
+    match: "App:"
+
+loop:
+  cooldown: 10
+  max_sessions: 0
+
+logs:
+  dir: .lisa/logs
+  format: text
+```
+
+CLI flags override config values:
+
+```bash
+lisa run --provider gemini --label "urgent"
+```
+
+## How It Works
+
+1. **Fetch** — Calls the Linear GraphQL API or Trello REST API to get the next issue matching the configured label, team, and project. Issues are sorted by priority.
+2. **Implement** — Builds a prompt with the issue title, description, and repo context, then sends it to the AI coding agent. The agent creates a branch, implements the changes, and pushes to origin.
+3. **PR** — Creates a pull request via the GitHub API referencing the original issue.
+4. **Update** — Moves the issue status to "In Review" and removes the pickup label via the source API.
+5. **Loop** — Waits `cooldown` seconds, then picks the next issue. Repeats until no issues remain or the limit is reached.

package/dist/index.js

@@ -0,0 +1,1157 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2, readdirSync } from "fs";
+import { join, resolve as resolvePath } from "path";
+import { defineCommand, runMain } from "citty";
+import * as clack from "@clack/prompts";
+import pc2 from "picocolors";
+
+// src/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { parse, stringify } from "yaml";
+var CONFIG_DIR = ".lisa";
+var CONFIG_FILE = "config.yaml";
+var DEFAULT_CONFIG = {
+  provider: "",
+  source: "",
+  source_config: {
+    team: "",
+    project: "",
+    label: "",
+    status: ""
+  },
+  github: "cli",
+  workspace: "",
+  repos: [],
+  loop: {
+    cooldown: 0,
+    max_sessions: 0
+  },
+  logs: {
+    dir: "",
+    format: ""
+  }
+};
+function getConfigPath(cwd = process.cwd()) {
+  return resolve(cwd, CONFIG_DIR, CONFIG_FILE);
+}
+function configExists(cwd = process.cwd()) {
+  return existsSync(getConfigPath(cwd));
+}
+function loadConfig(cwd = process.cwd()) {
+  const configPath = getConfigPath(cwd);
+  if (!existsSync(configPath)) {
+    return { ...DEFAULT_CONFIG };
+  }
+  const raw = readFileSync(configPath, "utf-8");
+  const parsed = parse(raw);
+  return {
+    ...DEFAULT_CONFIG,
+    ...parsed,
+    source_config: { ...DEFAULT_CONFIG.source_config, ...parsed.source_config },
+    loop: { ...DEFAULT_CONFIG.loop, ...parsed.loop },
+    logs: { ...DEFAULT_CONFIG.logs, ...parsed.logs }
+  };
+}
+function saveConfig(config2, cwd = process.cwd()) {
+  const configPath = getConfigPath(cwd);
+  const dir = resolve(cwd, CONFIG_DIR);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(configPath, stringify(config2), "utf-8");
+}
+function mergeWithFlags(config2, flags) {
+  const merged = { ...config2 };
+  if (flags.provider) merged.provider = flags.provider;
+  if (flags.source) merged.source = flags.source;
+  if (flags.github) merged.github = flags.github;
+  if (flags.label) merged.source_config = { ...merged.source_config, label: flags.label };
+  return merged;
+}
+
+// src/logger.ts
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
+import { dirname } from "path";
+import pc from "picocolors";
+var logFilePath = null;
+var outputMode = "default";
+var jsonEvents = [];
+function setOutputMode(mode) {
+  outputMode = mode;
+}
+function initLogFile(path) {
+  const dir = dirname(path);
+  if (!existsSync2(dir)) {
+    mkdirSync2(dir, { recursive: true });
+  }
+  logFilePath = path;
+}
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
+}
+function writeToFile(level, message) {
+  if (logFilePath) {
+    appendFileSync(logFilePath, `[${timestamp()}] [${level}] ${message}
+`);
+  }
+}
+function emitJson(level, message) {
+  const event = { time: timestamp(), level, message };
+  jsonEvents.push(event);
+  console.log(JSON.stringify(event));
+}
+function log(message) {
+  if (outputMode === "json") return emitJson("info", message);
+  if (outputMode !== "quiet") {
+    console.log(`${pc.cyan("[lisa]")} ${pc.dim(timestamp())} ${message}`);
+  }
+  writeToFile("info", message);
+}
+function warn(message) {
+  if (outputMode === "json") return emitJson("warn", message);
+  if (outputMode !== "quiet") {
+    console.error(`${pc.yellow("[lisa]")} ${pc.dim(timestamp())} ${message}`);
+  }
+  writeToFile("warn", message);
+}
+function error(message) {
+  if (outputMode === "json") return emitJson("error", message);
+  console.error(`${pc.red("[lisa]")} ${pc.dim(timestamp())} ${message}`);
+  writeToFile("error", message);
+}
+function ok(message) {
+  if (outputMode === "json") return emitJson("ok", message);
+  if (outputMode !== "quiet") {
+    console.log(`${pc.green("[lisa]")} ${pc.dim(timestamp())} ${message}`);
+  }
+  writeToFile("ok", message);
+}
+function divider(session) {
+  log(`${"\u2501".repeat(3)} Session ${session} ${"\u2501".repeat(3)}`);
+}
+function banner() {
+  if (outputMode !== "default") return;
+  console.log(
+    pc.cyan(`
+  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+  \u2502  lisa \u2014 autonomous issue resolver  \u2502
+  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+`)
+  );
+}
+
+// src/loop.ts
+import { resolve as resolve3 } from "path";
+import { appendFileSync as appendFileSync2 } from "fs";
+
+// src/prompt.ts
+import { resolve as resolve2 } from "path";
+function buildImplementPrompt(issue, config2) {
+  const workspace = resolve2(config2.workspace);
+  const repoEntries = config2.repos.map((r) => `   - If it says "Repo: ${r.name}" or title starts with "${r.match}" \u2192 \`${resolve2(workspace, r.path)}\``).join("\n");
+  return `You are an autonomous implementation agent. Your job is to implement a single
+issue, validate it, commit, and push the branch.
+
+## Issue
+
+- **ID:** ${issue.id}
+- **Title:** ${issue.title}
+- **URL:** ${issue.url}
+
+### Description
+
+${issue.description}
+
+## Instructions
+
+1. **Identify the repo**: Look at the issue description for relevant files or repo references.
+${repoEntries}
+   - If it references multiple repos, pick the PRIMARY one (the one with the most files listed).
+
+2. **Create a branch**: From the repo's main branch, create a branch named after the issue
+   (e.g., \`feat/${issue.id.toLowerCase()}-short-description\`).
+
+3. **Implement**: Follow the issue description exactly:
+   - Read all relevant files listed in the description first (if present)
+   - Follow the implementation instructions exactly
+   - Verify each acceptance criteria (if present)
+   - Respect any stack or technical constraints (if present)
+
+4. **Validate**: Run the project's linter/typecheck/tests if available:
+   - Check \`package.json\` (or equivalent) for lint, typecheck, check, or test scripts.
+   - Run whichever validation scripts exist (e.g., \`npm run lint\`, \`npm run typecheck\`).
+   - Fix any errors before proceeding.
+
+5. **Commit & Push**: Make atomic commits with conventional commit messages.
+   Push the branch to origin.
+   **IMPORTANT \u2014 Language rules:**
+   - All commit messages MUST be in English.
+   - Use conventional commits format: \`feat: ...\`, \`fix: ...\`, \`refactor: ...\`, \`chore: ...\`
+
+## Rules
+
+- **ALL git commits, branch names MUST be in English.**
+- The issue description may be in any language \u2014 read it for context but write all code artifacts in English.
+- Do NOT modify files outside the target repo.
+- Do NOT install new dependencies unless the issue explicitly requires it.
+- If you get stuck or the issue is unclear, STOP and explain why.
+- One issue only. Do not pick up additional issues.
+- If the repo has a CLAUDE.md, read it first and follow its conventions.
+- Do NOT create pull requests \u2014 the caller handles that.
+- Do NOT update the issue tracker \u2014 the caller handles that.`;
+}
+
+// src/providers/claude.ts
+import { execa } from "execa";
+var ClaudeProvider = class {
+  name = "claude";
+  async isAvailable() {
+    try {
+      await execa("claude", ["--version"]);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async run(prompt, opts) {
+    const start = Date.now();
+    try {
+      const proc = execa(
+        "claude",
+        ["--dangerously-skip-permissions", "-p", prompt, "--output-format", "text"],
+        {
+          cwd: opts.cwd,
+          timeout: 30 * 60 * 1e3,
+          reject: false
+        }
+      );
+      proc.stdout?.pipe(process.stdout);
+      proc.stderr?.pipe(process.stderr);
+      const result = await proc;
+      const output = result.stdout + (result.stderr ? `
+${result.stderr}` : "");
+      return {
+        success: result.exitCode === 0,
+        output,
+        duration: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: err instanceof Error ? err.message : String(err),
+        duration: Date.now() - start
+      };
+    }
+  }
+};
+
+// src/providers/gemini.ts
+import { execa as execa2 } from "execa";
+var GeminiProvider = class {
+  name = "gemini";
+  async isAvailable() {
+    try {
+      await execa2("gemini", ["--version"]);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async run(prompt, opts) {
+    const start = Date.now();
+    try {
+      const proc = execa2(
+        "gemini",
+        ["--yolo", "-p", prompt],
+        {
+          cwd: opts.cwd,
+          timeout: 30 * 60 * 1e3,
+          reject: false
+        }
+      );
+      proc.stdout?.pipe(process.stdout);
+      proc.stderr?.pipe(process.stderr);
+      const result = await proc;
+      const output = result.stdout + (result.stderr ? `
+${result.stderr}` : "");
+      return {
+        success: result.exitCode === 0,
+        output,
+        duration: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: err instanceof Error ? err.message : String(err),
+        duration: Date.now() - start
+      };
+    }
+  }
+};
+
+// src/providers/opencode.ts
+import { execa as execa3 } from "execa";
+var OpenCodeProvider = class {
+  name = "opencode";
+  async isAvailable() {
+    try {
+      await execa3("opencode", ["--version"]);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async run(prompt, opts) {
+    const start = Date.now();
+    try {
+      const proc = execa3(
+        "opencode",
+        ["run", prompt],
+        {
+          cwd: opts.cwd,
+          timeout: 30 * 60 * 1e3,
+          reject: false
+        }
+      );
+      proc.stdout?.pipe(process.stdout);
+      proc.stderr?.pipe(process.stderr);
+      const result = await proc;
+      const output = result.stdout + (result.stderr ? `
+${result.stderr}` : "");
+      return {
+        success: result.exitCode === 0,
+        output,
+        duration: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        success: false,
+        output: err instanceof Error ? err.message : String(err),
+        duration: Date.now() - start
+      };
+    }
+  }
+};
+
+// src/providers/index.ts
+var providers = {
+  claude: () => new ClaudeProvider(),
+  gemini: () => new GeminiProvider(),
+  opencode: () => new OpenCodeProvider()
+};
+async function getAvailableProviders() {
+  const all = Object.values(providers).map((f) => f());
+  const results = await Promise.all(
+    all.map(async (p) => ({ provider: p, available: await p.isAvailable() }))
+  );
+  return results.filter((r) => r.available).map((r) => r.provider);
+}
+function createProvider(name) {
+  const factory = providers[name];
+  if (!factory) {
+    throw new Error(`Unknown provider: ${name}. Available: ${Object.keys(providers).join(", ")}`);
+  }
+  return factory();
+}
+
+// src/sources/linear.ts
+var API_URL = "https://api.linear.app/graphql";
+var REQUEST_TIMEOUT_MS = 3e4;
+function getApiKey() {
+  const key = process.env.LINEAR_API_KEY;
+  if (!key) throw new Error("LINEAR_API_KEY is not set");
+  return key;
+}
+async function gql(query, variables) {
+  const res = await fetch(API_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: getApiKey()
+    },
+    body: JSON.stringify({ query, variables }),
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+  });
+  if (!res.ok) {
+    const text2 = await res.text();
+    throw new Error(`Linear API error (${res.status}): ${text2}`);
+  }
+  const json = await res.json();
+  if (json.errors?.length) {
+    throw new Error(`Linear GraphQL error: ${json.errors.map((e) => e.message).join(", ")}`);
+  }
+  return json.data;
+}
+var LinearSource = class {
+  name = "linear";
+  async fetchNextIssue(config2) {
+    const data = await gql(
+      `query($teamName: String!, $projectName: String!, $labelName: String!, $statusName: String!) {
+				issues(
+					filter: {
+						team: { name: { eq: $teamName } }
+						project: { name: { eq: $projectName } }
+						labels: { name: { eq: $labelName } }
+						state: { name: { eq: $statusName } }
+					}
+					first: 20
+				) {
+					nodes {
+						id
+						identifier
+						title
+						description
+						url
+						priority
+					}
+				}
+			}`,
+      {
+        teamName: config2.team,
+        projectName: config2.project,
+        labelName: config2.label,
+        statusName: config2.status
+      }
+    );
+    const issues = data.issues.nodes;
+    if (issues.length === 0) return null;
+    issues.sort((a, b) => {
+      const pa = a.priority === 0 ? 5 : a.priority;
+      const pb = b.priority === 0 ? 5 : b.priority;
+      return pa - pb;
+    });
+    const issue = issues[0];
+    return {
+      id: issue.identifier,
+      title: issue.title,
+      description: issue.description || "",
+      url: issue.url
+    };
+  }
+  async updateStatus(issueId, statusName) {
+    const issueData = await gql(
+      `query($identifier: String!) {
+				issue(id: $identifier) {
+					id
+					team { id }
+				}
+			}`,
+      { identifier: issueId }
+    );
+    const statesData = await gql(
+      `query($teamId: String!) {
+				workflowStates(filter: { team: { id: { eq: $teamId } } }) {
+					nodes { id name }
+				}
+			}`,
+      { teamId: issueData.issue.team.id }
+    );
+    const state = statesData.workflowStates.nodes.find(
+      (s) => s.name.toLowerCase() === statusName.toLowerCase()
+    );
+    if (!state) {
+      const available = statesData.workflowStates.nodes.map((s) => s.name).join(", ");
+      throw new Error(`Status "${statusName}" not found. Available: ${available}`);
+    }
+    await gql(
+      `mutation($issueId: String!, $stateId: String!) {
+				issueUpdate(id: $issueId, input: { stateId: $stateId }) {
+					success
+				}
+			}`,
+      { issueId: issueData.issue.id, stateId: state.id }
+    );
+  }
+  async removeLabel(issueId, labelName) {
+    const issueData = await gql(
+      `query($identifier: String!) {
+				issue(id: $identifier) {
+					id
+					labels { nodes { id name } }
+				}
+			}`,
+      { identifier: issueId }
+    );
+    const currentLabels = issueData.issue.labels.nodes;
+    const filtered = currentLabels.filter(
+      (l) => l.name.toLowerCase() !== labelName.toLowerCase()
+    );
+    if (filtered.length === currentLabels.length) return;
+    await gql(
+      `mutation($issueId: String!, $labelIds: [String!]!) {
+				issueUpdate(id: $issueId, input: { labelIds: $labelIds }) {
+					success
+				}
+			}`,
+      {
+        issueId: issueData.issue.id,
+        labelIds: filtered.map((l) => l.id)
+      }
+    );
+  }
+};
+
+// src/sources/trello.ts
+var API_URL2 = "https://api.trello.com/1";
+var REQUEST_TIMEOUT_MS2 = 3e4;
+function getAuthHeaders() {
+  const key = process.env.TRELLO_API_KEY;
+  const token = process.env.TRELLO_TOKEN;
+  if (!key || !token) throw new Error("TRELLO_API_KEY and TRELLO_TOKEN must be set");
+  return {
+    Authorization: `OAuth oauth_consumer_key="${key}", oauth_token="${token}"`
+  };
+}
+async function trelloFetch(method, path, params = "") {
+  const sep = params ? "?" : "";
+  const url = `${API_URL2}${path}${sep}${params}`;
+  const res = await fetch(url, {
+    method,
+    headers: getAuthHeaders(),
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS2)
+  });
+  if (!res.ok) {
+    const text2 = await res.text();
+    throw new Error(`Trello API error (${res.status}): ${text2}`);
+  }
+  if (method === "DELETE") return void 0;
+  return await res.json();
+}
+async function trelloGet(path, params = "") {
+  return trelloFetch("GET", path, params);
+}
+async function trelloPut(path, params = "") {
+  return trelloFetch("PUT", path, params);
+}
+async function trelloDelete(path) {
+  await trelloFetch("DELETE", path);
+}
+async function findBoardByName(name) {
+  const boards = await trelloGet("/members/me/boards", "fields=name");
+  const board = boards.find((b) => b.name.toLowerCase() === name.toLowerCase());
+  if (!board) throw new Error(`Trello board "${name}" not found`);
+  return board;
+}
+async function findListByName(boardId, name) {
+  const lists = await trelloGet(`/boards/${boardId}/lists`, "fields=name");
+  const list = lists.find((l) => l.name.toLowerCase() === name.toLowerCase());
+  if (!list) {
+    const available = lists.map((l) => l.name).join(", ");
+    throw new Error(`Trello list "${name}" not found. Available: ${available}`);
+  }
+  return list;
+}
+async function findLabelByName(boardId, name) {
+  const labels = await trelloGet(`/boards/${boardId}/labels`, "fields=name");
+  const label = labels.find((l) => l.name.toLowerCase() === name.toLowerCase());
+  if (!label) throw new Error(`Trello label "${name}" not found`);
+  return label;
+}
+var TrelloSource = class {
+  name = "trello";
+  async fetchNextIssue(config2) {
+    const board = await findBoardByName(config2.team);
+    const list = await findListByName(board.id, config2.project);
+    const label = await findLabelByName(board.id, config2.label);
+    const cards = await trelloGet(
+      `/lists/${list.id}/cards`,
+      "fields=name,desc,url,idLabels,idList"
+    );
+    const matching = cards.filter((c) => c.idLabels.includes(label.id));
+    if (matching.length === 0) return null;
+    const card = matching[0];
+    return {
+      id: card.id,
+      title: card.name,
+      description: card.desc || "",
+      url: card.url
+    };
+  }
+  async updateStatus(cardId, listName) {
+    const card = await trelloGet(`/cards/${cardId}`, "fields=idBoard");
+    const list = await findListByName(card.idBoard, listName);
+    await trelloPut(`/cards/${cardId}`, `idList=${list.id}`);
+  }
+  async removeLabel(cardId, labelName) {
+    const card = await trelloGet(
+      `/cards/${cardId}`,
+      "fields=idBoard,idLabels"
+    );
+    const label = await findLabelByName(card.idBoard, labelName);
+    if (!card.idLabels.includes(label.id)) return;
+    await trelloDelete(`/cards/${cardId}/idLabels/${label.id}`);
+  }
+};
+
+// src/sources/index.ts
+var sources = {
+  linear: () => new LinearSource(),
+  trello: () => new TrelloSource()
+};
+function createSource(name) {
+  const factory = sources[name];
+  if (!factory) {
+    throw new Error(`Unknown source: ${name}. Available: ${Object.keys(sources).join(", ")}`);
+  }
+  return factory();
+}
+
+// src/github.ts
+import { execa as execa4 } from "execa";
+var API_URL3 = "https://api.github.com";
+var REQUEST_TIMEOUT_MS3 = 3e4;
+async function isGhCliAvailable() {
+  try {
+    await execa4("gh", ["auth", "status"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getToken() {
+  const token = process.env.GITHUB_TOKEN;
+  if (!token) throw new Error("GITHUB_TOKEN is not set");
+  return token;
+}
+async function createPullRequest(opts, method = "cli") {
+  if (method === "cli" && await isGhCliAvailable()) {
+    return createPullRequestWithGhCli(opts);
+  }
+  const res = await fetch(`${API_URL3}/repos/${opts.owner}/${opts.repo}/pulls`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${getToken()}`,
+      Accept: "application/vnd.github+json",
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      title: opts.title,
+      body: opts.body,
+      head: opts.head,
+      base: opts.base
+    }),
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS3)
+  });
+  if (!res.ok) {
+    const text2 = await res.text();
+    throw new Error(`GitHub API error (${res.status}): ${text2}`);
+  }
+  const data = await res.json();
+  return { number: data.number, html_url: data.html_url };
+}
+async function createPullRequestWithGhCli(opts) {
+  const result = await execa4("gh", [
+    "pr",
+    "create",
+    "--repo",
+    `${opts.owner}/${opts.repo}`,
+    "--head",
+    opts.head,
+    "--base",
+    opts.base,
+    "--title",
+    opts.title,
+    "--body",
+    opts.body
+  ]);
+  const url = result.stdout.trim();
+  const prNumberMatch = url.match(/\/pull\/(\d+)/);
+  const number = prNumberMatch ? Number.parseInt(prNumberMatch[1], 10) : 0;
+  return { number, html_url: url };
+}
+async function getRepoInfo(cwd) {
+  const { stdout: remoteUrl } = await execa4("git", ["remote", "get-url", "origin"], { cwd });
+  let owner;
+  let repo;
+  const sshMatch = remoteUrl.match(/git@github\.com:(.+?)\/(.+?)(?:\.git)?$/);
+  const httpsMatch = remoteUrl.match(/github\.com\/(.+?)\/(.+?)(?:\.git)?$/);
+  if (sshMatch) {
+    owner = sshMatch[1];
+    repo = sshMatch[2];
+  } else if (httpsMatch) {
+    owner = httpsMatch[1];
+    repo = httpsMatch[2];
+  } else {
+    throw new Error(`Cannot parse GitHub owner/repo from remote URL: ${remoteUrl}`);
+  }
+  const { stdout: branch } = await execa4("git", ["branch", "--show-current"], { cwd });
+  const { stdout: defaultBranch } = await execa4(
+    "git",
+    ["symbolic-ref", "refs/remotes/origin/HEAD", "--short"],
+    { cwd, reject: false }
+  ).then(
+    (r) => r,
+    () => ({ stdout: "origin/main" })
+  );
+  return {
+    owner,
+    repo,
+    branch: branch.trim(),
+    defaultBranch: defaultBranch.replace("origin/", "").trim()
+  };
+}
+
+// src/loop.ts
+async function runLoop(config2, opts) {
+  const provider = createProvider(config2.provider);
+  const source = createSource(config2.source);
+  const available = await provider.isAvailable();
+  if (!available) {
+    error(`Provider "${config2.provider}" is not installed or not in PATH.`);
+    process.exit(1);
+  }
+  log(
+    `Starting loop (provider: ${config2.provider}, source: ${config2.source}, label: ${config2.source_config.label})`
+  );
+  let session = 0;
+  while (true) {
+    session++;
+    if (opts.limit > 0 && session > opts.limit) {
+      ok(`Reached limit of ${opts.limit} issues. Stopping.`);
+      break;
+    }
+    const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").substring(0, 19);
+    const logFile = resolve3(config2.logs.dir, `session_${session}_${timestamp2}.log`);
+    divider(session);
+    log(`Fetching next '${config2.source_config.label}' issue from ${config2.source}...`);
+    if (opts.dryRun) {
+      log(`[dry-run] Would fetch issue from ${config2.source} (${config2.source_config.team}/${config2.source_config.project})`);
+      log("[dry-run] Then implement, push, create PR, and update issue status");
+      break;
+    }
+    let issue;
+    try {
+      issue = await source.fetchNextIssue(config2.source_config);
+    } catch (err) {
+      error(`Failed to fetch issues: ${err instanceof Error ? err.message : String(err)}`);
+      if (opts.once) break;
+      await sleep(config2.loop.cooldown * 1e3);
+      continue;
+    }
+    if (!issue) {
+      warn(
+        `No issues with label '${config2.source_config.label}' found. Sleeping ${config2.loop.cooldown}s...`
+      );
+      if (opts.once) break;
+      await sleep(config2.loop.cooldown * 1e3);
+      continue;
+    }
+    ok(`Picked up: ${issue.id} \u2014 ${issue.title}`);
+    const prompt = buildImplementPrompt(issue, config2);
+    log(`Implementing... (log: ${logFile})`);
+    initLogFile(logFile);
+    const workspace = resolve3(config2.workspace);
+    const result = await provider.run(prompt, {
+      logFile,
+      cwd: workspace
+    });
+    try {
+      appendFileSync2(logFile, `
+${"=".repeat(80)}
+Full output:
+${result.output}
+`);
+    } catch {
+    }
+    if (!result.success) {
+      error(`Session ${session} failed for ${issue.id}. Check ${logFile}`);
+      if (opts.once) break;
+      await sleep(config2.loop.cooldown * 1e3);
+      continue;
+    }
+    try {
+      const repoInfo = await getRepoInfo(workspace);
+      const pr = await createPullRequest({
+        owner: repoInfo.owner,
+        repo: repoInfo.repo,
+        head: repoInfo.branch,
+        base: repoInfo.defaultBranch,
+        title: issue.title,
+        body: `Closes ${issue.url}
+
+Implemented by lisa.`
+      }, config2.github);
+      ok(`PR created: ${pr.html_url}`);
+    } catch (err) {
+      error(`Failed to create PR: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+      await source.updateStatus(issue.id, "In Review");
+      ok(`Updated ${issue.id} status to "In Review"`);
+    } catch (err) {
+      error(`Failed to update status: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+      await source.removeLabel(issue.id, config2.source_config.label);
+      ok(`Removed label "${config2.source_config.label}" from ${issue.id}`);
+    } catch (err) {
+      error(`Failed to remove label: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    ok(
+      `Session ${session} complete for ${issue.id} (${formatDuration(result.duration)})`
+    );
+    if (opts.once) {
+      log("Single iteration mode. Exiting.");
+      break;
+    }
+    log(`Cooling down ${config2.loop.cooldown}s before next issue...`);
+    await sleep(config2.loop.cooldown * 1e3);
+  }
+  ok(`lisa finished. ${session} session(s) run.`);
+}
+function sleep(ms) {
+  return new Promise((resolve4) => setTimeout(resolve4, ms));
+}
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const remaining = seconds % 60;
+  if (minutes > 0) return `${minutes}m ${remaining}s`;
+  return `${seconds}s`;
+}
+
+// src/cli.ts
+var run = defineCommand({
+  meta: { name: "run", description: "Run the agent loop" },
+  args: {
+    once: { type: "boolean", description: "Run a single iteration", default: false },
+    limit: { type: "string", description: "Max number of issues to process", default: "0" },
+    "dry-run": { type: "boolean", description: "Preview without executing", default: false },
+    provider: { type: "string", description: "AI provider (claude, gemini, opencode)" },
+    source: { type: "string", description: "Issue source (linear, trello)" },
+    label: { type: "string", description: "Label to filter issues" },
+    github: { type: "string", description: "GitHub method: cli or token" },
+    json: { type: "boolean", description: "Output as JSON lines", default: false },
+    quiet: { type: "boolean", description: "Suppress non-essential output", default: false }
+  },
+  async run({ args }) {
+    if (args.json) setOutputMode("json");
+    else if (args.quiet) setOutputMode("quiet");
+    banner();
+    const config2 = loadConfig();
+    const merged = mergeWithFlags(config2, {
+      provider: args.provider,
+      source: args.source,
+      github: args.github,
+      label: args.label
+    });
+    const missingVars = await getMissingEnvVars(merged.source);
+    if (missingVars.length > 0) {
+      const shell = process.env.SHELL?.includes("zsh") ? "~/.zshrc" : "~/.bashrc";
+      console.error(pc2.red(`Missing required environment variables:
+${missingVars.map((v) => `  ${v}`).join("\n")}`));
+      console.error(pc2.dim(`
+Add them to your ${shell} and run: source ${shell}`));
+      process.exit(1);
+    }
+    await runLoop(merged, {
+      once: args.once,
+      limit: Number.parseInt(args.limit, 10),
+      dryRun: args["dry-run"]
+    });
+  }
+});
+var config = defineCommand({
+  meta: { name: "config", description: "Manage configuration" },
+  args: {
+    show: { type: "boolean", description: "Show current config", default: false },
+    set: { type: "string", description: "Set a config value (key=value)" }
+  },
+  async run({ args }) {
+    if (args.show) {
+      const cfg = loadConfig();
+      console.log(pc2.cyan("\nCurrent configuration:\n"));
+      console.log(JSON.stringify(cfg, null, 2));
+      return;
+    }
+    if (args.set) {
+      const [key, value] = args.set.split("=");
+      if (!key || !value) {
+        console.error(pc2.red("Usage: lisa config --set key=value"));
+        process.exit(1);
+      }
+      const cfg = loadConfig();
+      cfg[key] = value;
+      saveConfig(cfg);
+      log(`Set ${key} = ${value}`);
+      return;
+    }
+    await runConfigWizard();
+  }
+});
+var init = defineCommand({
+  meta: { name: "init", description: "Initialize lisa configuration" },
+  async run() {
+    if (!process.stdin.isTTY) {
+      console.error(pc2.red("Interactive mode requires a TTY. Cannot run init in non-interactive environments."));
+      process.exit(1);
+    }
+    if (configExists()) {
+      const overwrite = await clack.confirm({
+        message: "Config already exists. Overwrite?"
+      });
+      if (clack.isCancel(overwrite) || !overwrite) {
+        log("Cancelled.");
+        return;
+      }
+    }
+    await runConfigWizard();
+  }
+});
+var status = defineCommand({
+  meta: { name: "status", description: "Show session status and stats" },
+  async run() {
+    banner();
+    const config2 = loadConfig();
+    console.log(pc2.cyan("Configuration:"));
+    console.log(`  Provider: ${pc2.bold(config2.provider)}`);
+    console.log(`  Source:   ${pc2.bold(config2.source)}`);
+    console.log(`  Label:    ${pc2.bold(config2.source_config.label)}`);
+    console.log(`  Team:     ${pc2.bold(config2.source_config.team)}`);
+    console.log(`  Project:  ${pc2.bold(config2.source_config.project)}`);
+    console.log(`  Logs:     ${pc2.dim(config2.logs.dir)}`);
+    const { readdirSync: readdirSync2, existsSync: existsSync4 } = await import("fs");
+    if (existsSync4(config2.logs.dir)) {
+      const logs = readdirSync2(config2.logs.dir).filter((f) => f.endsWith(".log"));
+      console.log(`
+${pc2.cyan("Sessions:")} ${logs.length} log file(s) found`);
+    } else {
+      console.log(`
+${pc2.dim("No sessions yet.")}`);
+    }
+  }
+});
+function getVersion() {
+  try {
+    const pkgPath = resolvePath(new URL(".", import.meta.url).pathname, "../package.json");
+    const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+var main = defineCommand({
+  meta: {
+    name: "lisa",
+    version: getVersion(),
+    description: "Autonomous issue resolver \u2014 AI agent loop for Linear/Trello"
+  },
+  subCommands: { run, config, init, status }
+});
+var LISA_ART = pc2.yellow(`
+                                             @@@@@@@
+                                           @@@%+=*@@@@
+                                         @@@@+-----#@@@
+                                       @@@@*--------+@@@            @@@@@
+                                      @@@*-----------=%@@      @@@@@@@@@@@
+                     @@@@@@@@@@@@@@@@@@#---------------*@@@@@@@@@%#*+=-=@@
+                    @@@#########%%%%%*=-----------------=%%%#*+=--------@@@
+                    @@*-------------------------------------------------#@@
+                    @@*-------------------------------------------------+@@
+                    @@*--------------------------------------------------@@@
+                    @@*--------------------------------------------------%@@
+                    @@*--------------------------------------------------*@@@
+                    @@*--------------------------------------------------=%@@@@@@@@
+                   @@@+------------------------------------------------------=+#%@@@@@@
+                @@@@@*------------------------------------------------------------=+*%@@@
+             @@@@%*=------------------------------------------------------------------=@@
+          @@@@#+----------------------------------------------------------------------%@@
+         @@%=------------------------------------------------------------------------*@@
+         @@@+--------------=%*------=#*-----*+------+@*-----------------------------=@@@
+          @@@#-------------+@#-----=@@=-----@@-----=@@=-----------------------------@@@
+            @@@=----##-----=@@-----%@+------%@@@@@@@@@#*+-----=--------------------%@@
+             @@@*---*@%++*#@@@@@@@@@@*---=*@@@#+======+*%@%#%@%#------------------+@@@
+               @@@*--=@@@#+=:::::::-+%@#*@@#=::::::::::::-*@@+--------------------#@@
+                @@@@*%@#::::::::::::::*@@#::::::::::::::::::%@*-------------------+@@@
+                  @@@@%:::::::::::::::+@%:::::::::::::::::::-@@--------------------+@@@
+                @@@@@@+:::-**-::::::::%@=:::::::::-=:::::::::@@*+==-----------------=%@@@
+                 @@@@@+:::%@@*::::::::@@-::::::::+@@%:::::::-@@#%%#-------------------*@@@
+                    @@#::::==:::::::::#@+::::::::-%@*:::::::%@+-------------------------#@@@
+                     @@+::::::::-====+#@@=::::::::::::::::-%@*-------------------------=@@@
+                     @@@+::::+%@%%%%%%#*%@%=:::::::::::::+@@+-------------------------#@@@
+                       @@%#*#@#----------+%@@*+=--::::-*@@@=-----------------------=*@@@
+                      @@@#*#@@--------------+#%@@@@@@@@@*+-------==--------------=%@@@@
+                    @@@%=---@@=--------==--------===----------=%@@@@%*-----------%@@
+                   @@%=-----=#@%*****#%@%---------------------%@+---+@@=---------*@@
+                  @@#----------+*#%%%#*=------------------------=**+-*@#----------@@@
+                  @@----------------------------------%@=------+@@%%=*@#----------*@@
+                  @@*--------------------------------=#@@=-----=*=---@@+----------=@@
+                  @@@@*=----------------------==+*#%@@@@@*----##+-=*@@+-------=++**@@@
+                    @@@@@%%#*++====+++**##%@@@@@%#*+=-=@@----=@@@@@@#=---=*%@@@@@@@@@
+                        @@@@@@@@@@@@@@@%%##*++=--------+-----*@#--------*@@@@@
+                                  @@#------------------------#@*--------%@@
+                                   @@@@#---------------------%@@@%#*+==+@@
+                                     @@@---------------------%@@@@@@@@@@@@
+                                     @@%---------------------%@@
+                                  @@@@@@***+--------------*#@@@@@@
+                                @@@*=*@@%%%@@#%%%#+-=*%%%%@#=-:=@@
+                                @@-:-@@-:::+@@****@@@%***@@=:::-@@
+                                @@#=%@+::::#@*::::@@@-:::+@@#*#@@@
+                                 @@@@@@%%%@@@%*=*%@@@%+=*@@@@@@@
+                                      @@@@@@@@@%@@@ @%%%%@@
+`);
+async function runConfigWizard() {
+  console.log(LISA_ART);
+  clack.intro(pc2.cyan("lisa \u2014 autonomous issue resolver"));
+  const providerLabels = {
+    claude: "Claude Code",
+    gemini: "Gemini CLI",
+    opencode: "OpenCode"
+  };
+  const available = await getAvailableProviders();
+  if (available.length === 0) {
+    clack.log.error("No compatible AI providers found.");
+    clack.log.info(
+      `Install at least one of the following providers to continue:
+
+  ${pc2.bold("Claude Code")}   ${pc2.dim("npm i -g @anthropic-ai/claude-code")}
+  ${pc2.bold("Gemini CLI")}    ${pc2.dim("npm i -g @anthropic-ai/gemini-cli")}
+  ${pc2.bold("OpenCode")}      ${pc2.dim("npm i -g opencode")}
+
+After installing, run ${pc2.cyan("lisa init")} again.`
+    );
+    return process.exit(1);
+  }
+  let providerName;
+  if (available.length === 1) {
+    providerName = available[0].name;
+    clack.log.info(`Found provider: ${pc2.bold(providerLabels[providerName])}`);
+  } else {
+    const selected = await clack.select({
+      message: "Which AI provider do you want to use?",
+      options: available.map((p) => ({
+        value: p.name,
+        label: providerLabels[p.name]
+      }))
+    });
+    if (clack.isCancel(selected)) return process.exit(0);
+    providerName = selected;
+  }
+  const source = await clack.select({
+    message: "Where do your issues live?",
+    options: [
+      { value: "linear", label: "Linear" },
+      { value: "trello", label: "Trello" }
+    ]
+  });
+  if (clack.isCancel(source)) return process.exit(0);
+  const missing = await getMissingEnvVars(source);
+  if (missing.length > 0) {
+    const shell = process.env.SHELL?.includes("zsh") ? "~/.zshrc" : "~/.bashrc";
+    clack.log.warning(
+      `Missing environment variables:
+${missing.map((v) => `  ${pc2.bold(v)}`).join("\n")}
+
+Add them to your environment variables:
+${missing.map((v) => `  export ${v}="your-key-here"`).join("\n")}
+
+Then run: ${pc2.cyan(`source ${shell}`)}`
+    );
+  }
+  const teamAnswer = await clack.text({
+    message: source === "linear" ? "Linear team name?" : "Trello board name?",
+    initialValue: "Internal"
+  });
+  if (clack.isCancel(teamAnswer)) return process.exit(0);
+  const team = teamAnswer;
+  const projectAnswer = await clack.text({
+    message: source === "linear" ? "Project name?" : "Trello list name?",
+    initialValue: "Zenixx"
+  });
+  if (clack.isCancel(projectAnswer)) return process.exit(0);
+  const project = projectAnswer;
+  const labelAnswer = await clack.text({
+    message: "Label to pick up?",
+    initialValue: "ready"
+  });
+  if (clack.isCancel(labelAnswer)) return process.exit(0);
+  const label = labelAnswer;
+  const githubMethod = await detectGitHubMethod();
+  const repos = await detectGitRepos();
+  const cfg = {
+    provider: providerName,
+    source,
+    source_config: {
+      team,
+      project,
+      label,
+      status: "Backlog"
+    },
+    github: githubMethod,
+    workspace: ".",
+    repos,
+    loop: { cooldown: 10, max_sessions: 0 },
+    logs: { dir: ".lisa/logs", format: "text" }
+  };
+  saveConfig(cfg);
+  clack.outro(pc2.green("Config saved to .lisa/config.yaml"));
+}
+async function detectGitHubMethod() {
+  const hasToken = !!process.env.GITHUB_TOKEN;
+  const hasCli = await isGhCliAvailable();
+  if (hasToken && hasCli) {
+    const selected = await clack.select({
+      message: "Both GitHub CLI and GITHUB_TOKEN detected. Which do you want to use?",
+      options: [
+        { value: "cli", label: "GitHub CLI", hint: "gh" },
+        { value: "token", label: "GitHub API", hint: "GITHUB_TOKEN" }
+      ]
+    });
+    if (clack.isCancel(selected)) return process.exit(0);
+    return selected;
+  }
+  if (hasCli) {
+    clack.log.info("Using GitHub CLI for pull requests.");
+    return "cli";
+  }
+  if (hasToken) {
+    clack.log.info("Using GITHUB_TOKEN for pull requests.");
+    return "token";
+  }
+  return "token";
+}
+async function detectGitRepos() {
+  const cwd = process.cwd();
+  if (existsSync3(join(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() && existsSync3(join(cwd, e.name, ".git"))).map((e) => e.name);
+  if (gitDirs.length === 0) {
+    return [];
+  }
+  const selected = await clack.multiselect({
+    message: "Select the repos to include in the workspace:",
+    options: gitDirs.map((dir) => ({ value: dir, label: dir }))
+  });
+  if (clack.isCancel(selected)) return process.exit(0);
+  return selected.map((dir) => ({
+    name: dir,
+    path: `./${dir}`,
+    match: ""
+  }));
+}
+async function getMissingEnvVars(source) {
+  const missing = [];
+  if (!process.env.GITHUB_TOKEN) {
+    const ghAvailable = await isGhCliAvailable();
+    if (!ghAvailable) missing.push("GITHUB_TOKEN");
+  }
+  if (source === "linear") {
+    if (!process.env.LINEAR_API_KEY) missing.push("LINEAR_API_KEY");
+  } else if (source === "trello") {
+    if (!process.env.TRELLO_API_KEY) missing.push("TRELLO_API_KEY");
+    if (!process.env.TRELLO_TOKEN) missing.push("TRELLO_TOKEN");
+  }
+  return missing;
+}
+function runCli() {
+  runMain(main);
+}
+
+// src/index.ts
+runCli();

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@tarcisiopgs/lisa",
+	"version": "0.5.0",
+	"description": "Autonomous issue resolver — AI agent loop for Linear/Trello",
+	"type": "module",
+	"bin": {
+		"lisa": "dist/index.js"
+	},
+	"scripts": {
+		"build": "tsup",
+		"dev": "npx tsx src/index.ts",
+		"check": "biome check src/",
+		"format": "biome format --write src/",
+		"lint": "biome lint src/"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.0.1",
+		"citty": "^0.2.1",
+		"execa": "^9.6.1",
+		"picocolors": "^1.1.1",
+		"yaml": "^2.8.2"
+	},
+	"devDependencies": {
+		"@types/node": "^22.13.4",
+		"tsup": "^8.4.0",
+		"tsx": "^4.19.3",
+		"typescript": "^5.9.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist"
+	]
+}