@codyswann/lisa 2.119.0 → 2.121.0

package/plugins/lisa-copilot/skills/pull-request-review/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: pull-request-review
+description: This skill should be used when checking for code review comments on a pull request and implementing them if required. It fetches PR metadata and comments, generates a brief from unresolved feedback, and bootstraps a project to address the review comments.
+allowed-tools: ["Read", "Bash", "Glob", "Grep"]
+---
+
+# Review PR Comments
+
+Target PR: $ARGUMENTS
+
+If no argument provided, prompt the user for a PR link or number.
+
+## Step 1: Gather Requirements
+
+1. **Fetch PR metadata and comments** using the GitHub CLI:
+   ```bash
+   gh pr view $ARGUMENTS --json number,title,body,reviews,comments
+   gh api repos/{owner}/{repo}/pulls/{pr_number}/comments
+   ```
+2. **Extract each unresolved review comment**:
+   - Comment ID
+   - File path
+   - Line number
+   - Comment body
+   - Author
+
+If no unresolved comments exist, report success and exit.
+
+## Step 2: Create Plan
+
+In plan mode, create a plan that includes the following details:
+
+```markdown
+Implement PR review feedback for $ARGUMENTS.
+
+## PR Overview
+- Title: [PR title]
+- Description: [PR description summary]
+
+## Review Comments to Address (ordered by file)
+
+### 1. [file_path]:[line_number] (Comment ID: [id])
+**Reviewer**: [author]
+**Comment**: [full comment body]
+**Action Required**: [brief description of what needs to change]
+
+### 2. [file_path]:[line_number] (Comment ID: [id])
+**Reviewer**: [author]
+**Comment**: [full comment body]
+**Action Required**: [brief description of what needs to change]
+
+...
+
+## Implementation Guidelines
+- Evaluate each comment for validity before implementing
+- If a comment is not valid, document the reasoning
+- Ensure changes follow project coding standards
+- Run relevant tests to verify changes work
+
+## Acceptance Criteria
+- All valid review comments addressed
+- Tests pass after changes
+- `bun run lint` passes
+
+## Verification
+Command: `bun run lint && bun run test`
+Expected: All checks pass
+```

package/plugins/lisa-copilot/skills/quality-review/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: quality-review
+description: "Code quality review checklist. Correctness, coding philosophy compliance, test coverage, documentation quality. Findings ranked by severity in plain English."
+---
+
+# Quality Review
+
+Review code quality for changed files. Explain all findings in plain English as if speaking to someone with no programming background.
+
+## Review Checklist
+
+For each changed file, evaluate:
+
+1. **Correctness** -- Does the code do what the task says? Logic errors, off-by-one mistakes, missing edge cases?
+2. **Coding philosophy** -- Immutability patterns (no `let`, no mutations, functional transformations)? Correct function structure (variables, side effects, return)?
+3. **Test coverage** -- Tests present? Testing behavior, not implementation details? Edge cases covered?
+4. **Documentation** -- JSDoc on new functions explaining "why"? Preambles on new files?
+5. **Code clarity** -- Readable variable names? Unnecessary complexity? Could a new team member understand this?
+
+## Output Format
+
+Rank findings by severity:
+
+### Critical (must fix before merge)
+Broken logic or violates hard project rules.
+
+### Warning (should fix)
+Could cause problems later or reduce maintainability.
+
+### Suggestion (nice to have)
+Minor improvements, not blocking.
+
+## Finding Format
+
+For each finding:
+
+- **What** -- Plain English description, no jargon
+- **Why** -- What could go wrong? Concrete examples
+- **Where** -- File path and line number
+- **Fix** -- Specific, actionable suggestion
+
+### Example
+
+> **What:** The function changes the original list instead of creating a new one.
+> **Why:** Other code using that list could see unexpected changes, causing hard-to-track bugs.
+> **Where:** `src/utils/transform.ts:42`
+> **Fix:** Use `[...items].sort()` instead of `items.sort()` to create a copy first.
+
+## Rules
+
+- Run `bun run test` to confirm tests pass
+- Run the task's proof command to confirm the implementation works
+- Never approve code with failing tests
+- If no issues found, say so clearly -- do not invent problems

package/plugins/lisa-copilot/skills/queue-status/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: queue-status
+description: "Read-only operator surface for the current project's PRD and build backlog health. Resolves the configured PRD source and build tracker from the same Lisa contract used by intake and repair, summarizes lifecycle-role counts, distinguishes idle queues from setup problems, and highlights actionable blocked, in-review, claimed, or shipped work."
+allowed-tools: ["Skill", "Bash", "Read"]
+---
+
+# Queue Status: $ARGUMENTS
+
+`/lisa:queue-status` is the operator-facing inspection surface for Lisa's live backlog state. It answers, for the **current repo only**, what Lisa's configured PRD queue and build queue currently look like, whether the queues appear healthy or stuck, and which items are most actionable next.
+
+This command is **read-only** in v1. It does not create, claim, relabel, repair, transition, comment on, or otherwise mutate queue items. It complements `/lisa:intake`, `/lisa:repair-intake`, `/lisa:verify-prd`, `/lisa:automation-status`, and the underlying vendor trackers; it does not replace them.
+
+## Confirmation policy
+
+Do **not** ask for confirmation once invoked. This skill inspects queue state and reports what it finds. There are no write-side effects in the v1 surface.
+
+## Scope
+
+Inspect only the Lisa queues for the current project:
+
+- the configured PRD source queue
+- the configured build tracker queue
+
+Resolve queue source, tracker, lifecycle roles, and queue arguments from the **same contract** Lisa already uses for `/lisa:intake` and `/lisa:repair-intake`. Do **not** invent a second source of truth for queue detection, lifecycle naming, or stack support.
+
+Support a repo-scoped queue selector when requested:
+
+- default: inspect both queues
+- `queue=prd`: inspect only the PRD queue
+- `queue=build`: inspect only the build queue
+
+## Operator usage
+
+Typical entrypoints:
+
+```text
+/lisa:queue-status
+/lisa:queue-status queue=prd
+/lisa:queue-status queue=build
+```
+
+Use this command when an operator needs to answer one of these questions for the current repo:
+
+- "Is this queue truly idle, or is it misconfigured?"
+- "Which item is the most actionable next?"
+- "Should I run `/lisa:intake`, `/lisa:repair-intake`, `/lisa:automation-status`, or `/lisa:verify-prd` next?"
+
+Keep the report terminal-first and immediately actionable: observable queue facts first, then the smallest useful next command.
+
+## What to report
+
+Render the report in **grouped sections** so operators can scan it top-down without reading raw tracker dumps:
+
+1. An optional overall queue-health summary when inspecting both queues.
+2. One PRD queue section when the PRD queue is in scope.
+3. One build queue section when the build queue is in scope.
+
+For each inspected queue, report:
+
+1. The queue source or tracker Lisa resolved.
+2. Lifecycle counts using the repo's configured role names.
+3. Whether the queue appears `IDLE`, `HEALTHY`, `ATTENTION_NEEDED`, or `MISCONFIGURED`.
+4. Whether the lifecycle namespace appears adopted versus absent.
+5. The oldest or most actionable blocked, in-review, claimed, shipped, or similar stuck items Lisa can surface without mutating work.
+6. A concise remediation hint when attention is needed.
+
+The report should stay terminal-first and immediately actionable: observable queue facts first, then the smallest useful next step.
+
+## Highlight semantics
+
+Each queue section may include one or more highlighted items. A highlight is not a raw dump of every issue in that role; it is the single oldest or otherwise most actionable item Lisa can justify surfacing without mutating work.
+
+Interpret highlights by role:
+
+- `ready`: work is waiting to be claimed. The usual next step is `/lisa:intake <queue>`.
+- `blocked`: work is stuck behind an explicit blocker or failed pre-flight. The usual next step is `/lisa:repair-intake <queue>` after validating the blocker context.
+- `claimed` or in-review/review states: work is in motion but may be aging. The usual next step is to inspect the active implementation or review path before escalating to `/lisa:repair-intake <queue>`.
+- `shipped`: PRD work looks ready for initiative-level acceptance. The usual next step is `/lisa:verify-prd <prd-ref>`.
+
+If both queues look unexpectedly quiet or stale, mention `/lisa:automation-status` as the scheduler-health follow-up before implying the queues themselves are empty or broken.
+
+## Output shape
+
+Use a stable terminal-friendly shape:
+
+1. `Overall verdict` line when both queues are shown.
+2. `PRD queue` heading with resolved source, verdict, lifecycle counts, actionable highlights, and remediation.
+3. `Build queue` heading with resolved tracker, verdict, lifecycle counts, actionable highlights, and remediation.
+
+Queue sections should stay visually grouped. Do not interleave PRD and build facts item-by-item.
+
+## Runtime and vendor expectations
+
+- Reuse the same config-resolution defaults and queue-routing rules that `intake` and `repair-intake` use.
+- Work from the current repo's `.lisa.config.json` instead of hardcoding one vendor's lifecycle names.
+- Support the vendor families already served by Lisa intake: GitHub, Linear, JIRA, Notion, and Confluence.
+- If a queue cannot be resolved or its lifecycle namespace has not been adopted, report that explicitly as `MISCONFIGURED` rather than pretending the queue is empty.
+
+## Verdicts and remediation
+
+- `IDLE`: the queue resolved successfully and no actionable ready or stuck work is present.
+- `HEALTHY`: the queue resolved successfully and the current backlog/state appears normal.
+- `ATTENTION_NEEDED`: the queue resolved, but blocked, stalled, or accumulating work needs operator follow-up.
+- `MISCONFIGURED`: Lisa could not resolve the queue, could not find the expected lifecycle namespace, or detected another setup/adoption problem.
+
+When both queues are in scope, derive the **overall verdict** from the queue sections:
+
+- `MISCONFIGURED` if any inspected queue is misconfigured.
+- Otherwise `ATTENTION_NEEDED` if any inspected queue needs operator follow-up.
+- Otherwise `HEALTHY` if any inspected queue has normal actionable work in motion.
+- Otherwise `IDLE`.
+
+Status-specific remediation guidance:
+
+- `IDLE`: explain that the queue is currently quiet and no immediate operator action is required.
+- `HEALTHY`: point operators to `/lisa:intake` or `/lisa:repair-intake` when they want Lisa to act on the reported state.
+- `ATTENTION_NEEDED`: identify the most actionable blocked or stalled items and suggest the next Lisa or tracker-native command to investigate.
+- `MISCONFIGURED`: show which queue contract is missing or unresolved and recommend fixing `.lisa.config.json`, adopting the lifecycle namespace, or rerunning the relevant setup flow.
+
+Command handoff expectations:
+
+- Prefer `/lisa:intake <queue>` when the actionable highlight is `ready` work.
+- Prefer `/lisa:repair-intake <queue>` when the actionable highlight is blocked, stalled, or suspiciously old claimed/review work.
+- Prefer `/lisa:verify-prd <prd-ref>` when the PRD side surfaces shipped work that appears ready for initiative-level verification.
+- Prefer `/lisa:automation-status` when queue output suggests scheduler drift, stale unattended execution, or a mismatch between expected and observed queue activity.
+
+## Rules
+
+- Stay **read-only**. Never create, update, claim, relabel, repair, transition, or comment on queue items from this skill.
+- Keep the report repo-scoped to the current project instead of aggregating unrelated repos or teams.
+- Distinguish truly idle queues from lifecycle-namespace absence or unresolved config.
+- Reuse `intake` and `repair-intake` contract semantics so queue health reporting does not drift from execution behavior.
+- Keep observable queue facts separate from remediation guidance so operators can tell the current state from the recommended next step.