docs(catalog): add forgejo-axi to the community catalog

[escidmore]

What Changed

• Added a forgejo-axi entry (escidmore, Forgejo domain) to the community list in catalog.yaml, describing pull request lifecycle, issues, and raw API access for self-hosted Forgejo with TOON output.
• Regenerated the community catalog rows in README.md and docs/index.html so both generated regions include the new entry.

Risk Assessment

✅ Low: The change is a 20-line docs-only catalog addition whose generated README/docs regions match the catalog.yaml source shape, with no executable code and a description fully corroborated by inspection of the referenced package's source.

Testing

Ran the repo's docs generator in check mode, which confirms the new catalog.yaml entry is faithfully reflected in both generated regions (README table and docs/index.html table) with no drift, plus the generator's own unit tests covering catalog cell rendering and escaping. Since this is a user-visible docs surface, I also opened the built docs page in a real browser and captured a screenshot of the community catalog showing the forgejo-axi row rendering as the final entry with a working repo link, author, domain, and description — matching the other community entries. Everything passed and the worktree is left clean.

• Evidence: Rendered community catalog on docs/index.html — forgejo-axi row (highlighted, last entry) (local file: /Users/host/.no-mistakes/evidence/01M0F9NQ4B87PENS3XZQBBY5NF/forgejo-axi-catalog.png)

Evidence: docs:check — generated regions match catalog.yaml

$ node scripts/generate-docs.mjs --check
docs:check ok — generated regions match their sources

Evidence: Live DOM read of the rendered catalog row

$ chrome-devtools-axi eval '() => document.querySelector("a[href*=\"escidmore/forgejo-axi\"]").closest("tr").innerText'
forgejo-axi escidmore Forgejo Pull request lifecycle, issues, and raw API access for self-hosted Forgejo - non-interactive, reconciling mutations, with token-efficient TOON output.

Pipeline

Updates from git push no-mistakes

⏭️ **intent** - skipped

✅ No issues found.

✅ **Rebase** - passed

✅ No issues found.

⚠️ **Review** - 2 infos

• ℹ️ catalog.yaml:217 - Independent source review (VISION.md catalog clause) of escidmore/forgejo-axi at pinned revision 307abb76cdd3d964efa5dffdfd8eaa735f2ee19d (v1.2.0 + merged upstream PRs Make SessionStart hook installation opt-in instead of auto-installing on every CLI invocation #40/Deal with asdf-managed environments better in session hooks #41): every claim in the description is source-backed. pr <find|list|view|history|reviews|diff|create|update|checks|mergeability|merge|merged> and issue <...> exist in src/help.ts:36-80; raw API access is api METHOD PATH [--data JSON] [--paginate] (src/help.ts:15); TOON is the default encoder with --json opt-in at the single output boundary (src/cli.ts:2, src/cli.ts:1660); mutations are reconciling (src/forgejo.ts:1755 reconcilePull, pr create/pr update/label create idempotent); non-interactive is verified by the absence of any readline/prompt/console.*/process.stderr use in src/ and bin/. License MIT, package forgejo-axi@1.2.0 builds on axi-sdk-js. The two gaps recorded in PR docs: propose forgejo-axi for the community catalog #150 (principle 7 setup hooks, principle 10 --version fast path) are closed upstream, so no admission: exception block is warranted here.
• ℹ️ catalog.yaml:217 - Open PR docs: propose forgejo-axi for the community catalog #150 ("docs: propose forgejo-axi for the community catalog", author Freudator86) proposes this same entry, with a self-disclosure that its author is not the tool's author and that CONTRIBUTING.md asks for "one entry for your AXI". This branch is the author's own entry, which supersedes it and will conflict on catalog.yaml/README.md/docs/index.html. Decide whether docs: propose forgejo-axi for the community catalog #150 should be closed with a pointer to this change; that is a maintainer call on an external PR, not a defect in this diff.

✅ **Test** - passed

✅ No issues found.

• node scripts/generate-docs.mjs --check — confirms the README.md and docs/index.html generated:catalog-community regions are in sync with the new catalog.yaml entry (no drift; this is the same check the docs-check workflow runs)
• node --test scripts/generate-docs.test.mjs — the generator's own unit tests (Markdown/HTML cell escaping, link destinations, table formatting) that govern how a catalog entry is rendered
• Manual browser verification: opened docs/index.html in Chrome via chrome-devtools-axi open, located the forgejo-axi row by its repo URL, scrolled it into view and highlighted it, then captured a viewport screenshot of the rendered community catalog table
• chrome-devtools-axi eval on the rendered row — read back the live DOM cell text as forgejo-axi | escidmore | Forgejo | Pull request lifecycle, issues, and raw API access for self-hosted Forgejo - non-interactive, reconciling mutations, with token-efficient TOON output.
• git status --porcelain — confirmed testing left no stray files in the worktree

✅ **Document** - passed

✅ No issues found.

✅ **Lint** - passed

✅ No issues found.

✅ **Push** - passed

✅ No issues found.

[kunchenguid]

Speaking as Kun's firstmate: I reviewed the diff (catalog.yaml plus generated README.md / docs/index.html only) and independently inspected the package.

#150 already proposed the same package (escidmore/forgejo-axi) and was not admitted at pin 3b28d091. This PR is a distinct add from the author, so I still inspected the pin rather than closing as a second path.

Independent source review at pin 3b28d0917eb5745eb679484a285f1d78f53db0d7 (tag v1.2.0, also current main HEAD). Files read: bin/forgejo-axi.ts, src/cli.ts, src/help.ts, package.json, plus the recursive tree at that revision. Direct observations at that revision:

• axi-sdk-js runAxiCli, TOON via @toon-format/toon at the output boundary, --json opt-in
• commands in src/cli.ts are status / repo / api / pr / label / issue / run only; generated skills/forgejo-axi/SKILL.md exists
• principle 7 not held: no setup hooks command; no hooks module in the tree
• principle 10 --version fast path not held: bin/forgejo-axi.ts statically imports ../src/cli.js
• principle 9 partial: listOutput omits next when the displayed list is complete and untruncated, including empty lists

VISION.md per-rule:

• AXI principles: does not align for a positive admission — principle 7 is not held at this pin.
• Catalog: cannot tell / not admitted. VISION.md requires the inspected source to satisfy applicable AXI principles before a positive verdict. I will not merge this entry at v1.2.0.
• SDKs: aligns (docs-only catalog add; no SDK change).

CI (no-mistakes, docs-check, generated-files) is green. The PR is CONFLICTING with main; I am not resolving conflicts because it is not otherwise auto-merge-ready. If you later pin a revision that holds principle 7, re-request review.

[kunchenguid]

Speaking as Kun's firstmate: catalog-only diff, no security issue. Package is not admitted at the inspected pin (see comment).

[escidmore]

Re-requesting catalog review at exact Forgejo revision 307abb76cdd3d964efa5dffdfd8eaa735f2ee19d. Since the previous inspection, setup hooks merged in PR 41 and the bare version fast path merged in PR 40, addressing the admission blockers identified in the earlier comment. This branch is also merged with current AXI main; pnpm run docs:check, generator tests, and format checks pass.

[kunchenguid]

Speaking as Kun's firstmate: re-triage after your new pin. I ignored the earlier firstmate not-admit (that pin is stale) and independently inspected the package at the revision you named.

Independent source review at pin 307abb76cdd3d964efa5dffdfd8eaa735f2ee19d (not a release tag; v1.2.0 is 3b28d091, later v1.3.0/main is bb2d38c and was not inspected). Files/paths read at that revision: bin/forgejo-axi.ts, src/version.ts, src/cli.ts (command graph, homeOutput, setupHooks, listOutput, render), src/help.ts, package.json, test/setup.test.ts, plus the recursive tree. Direct observations at that revision:

• axi-sdk-js runAxiCli; TOON via @toon-format/toon encode at the single output boundary; --json opt-in
• commands: status / repo / api / pr / label / issue / run / setup; generated skills/forgejo-axi/SKILL.md exists
• principle 7 held: setup hooks is registered and implemented via installSessionStartHooks (Claude Code, Codex, OpenCode); help and tests cover install/repair/unknown-command
• principle 10 --version fast path held: bin/forgejo-axi.ts uses tryFastPath from axi-sdk-js/fast-path and a dynamic import() of cli.js; version comes from src/version.ts
• no-args home is live connection/status, not help; mutations are reconciling; soft-delete requires --yes (no prompt)
• principle 9 residual: listOutput still omits next when the displayed list is complete and untruncated (including empty lists)

Catalog description (PR lifecycle, issues, raw api METHOD PATH, non-interactive, reconciling mutations, TOON) is source-backed at this pin.

VISION.md per-rule:

• AXI principles: aligns for a positive admission at this pin (P7 and P10 blockers from 3b28d091 are closed; P9 residual is not an admission blocker).
• Catalog: aligns. Independent source review at 307abb76cdd3d964efa5dffdfd8eaa735f2ee19d supports admission. Merging the catalog add.
• SDKs: aligns (docs-only catalog add; no SDK change).

Diff is catalog.yaml plus generated README.md / docs/index.html only; no security issue. Fork CI (no-mistakes, docs-check, generated-files) is green on f37f911f after approving the waiting workflow runs.

[kunchenguid]

Speaking as Kun's firstmate: catalog-only diff, no security issue. Independent source review at pin 307abb76 admits forgejo-axi (see comment).

[kunchenguid]

Speaking as Kun's firstmate: this is merged. Thank you @escidmore — really appreciate you taking the time on this.