Github Issue Lifecycle

GitHub issue lifecycle tracker for swamp. Drives issues from open through triage, planning, implementation, PR linkage, and merge as versioned swamp data — with optional label sync and comment posting back to the issue.

No external dependencies beyond the gh CLI. Designed for solo developers or small teams working on GitHub repos who want observable, queryable issue lifecycle data without leaving the terminal.

State Machine

opened ──[start]──> triaging
triaging ──[triage]──> classified
classified ──[plan]──> planned
planned ──[iterate]──> planned  (feedback loop)
planned ──[approve]──> approved
approved ──[implement]──> implementing
implementing ──[link_pr]──> pr_open
pr_open ──[pr_merged]──> done
pr_open ──[pr_failed]──> pr_failed
pr_failed ──[link_pr]──> pr_open  (retry)
Any ──[close]──> closed

Usage

swamp extension pull @webframp/github-issue-lifecycle

# Create a lifecycle tracker for a repo
swamp model create @webframp/github-issue-lifecycle tracker \
  --global repo=webframp/swamp-extensions

# Start tracking an issue
swamp model method run tracker start --input issue_number=42

# Triage it
swamp model method run tracker triage \
  --input issue_number=42 --input kind=bug --input priority=high

# Plan implementation
swamp model method run tracker plan \
  --input issue_number=42 \
  --input summary="Fix pagination bug" \
  --input steps='["Read current code","Fix off-by-one","Add test"]'

# Approve and implement
swamp model method run tracker approve --input issue_number=42
swamp model method run tracker implement --input issue_number=42

# Link a PR
swamp model method run tracker link_pr \
  --input issue_number=42 \
  --input pr_url=https://github.com/webframp/swamp-extensions/pull/100

# Record merge
swamp model method run tracker pr_merged --input issue_number=42

Prerequisites

• gh CLI installed and authenticated (gh auth login)
• swamp initialized in the repository (swamp init)

2026.07.27.1

Fixed: The fmt task ran deno fmt --check, so deno task fmt verified formatting instead of applying it and there was no way to format the extension through its own task. fmt now formats and a new fmt:check verifies, matching every other extension in the repository.

Fixed: deno fmt no longer inspects CLAUDE.md / AGENTS.md. Those files are gitignored and never present in CI, but deno fmt does not read .gitignore, so deno task fmt:check could fail locally on a file CI does not have.

Upgrade note: Tooling and formatting only. No model, method, schema, or behavior change — nothing to do on upgrade.