docs: add tasks-axi to community catalog by RooseveltAdvisors · Pull Request #103 · kunchenguid/axi

RooseveltAdvisors · 2026-07-19T12:37:48Z

Intent

Contribute the existing tasks-axi tool to the AXI catalog by editing only catalog.yaml, placing it in the community section with an author field, and accurately describing the shipped Markdown backend without overstating planned capabilities. Verify upstream metadata, version, link, license, and AXI compliance; regenerate derived files and run all documented formatting, lint, SDK, test, docs, link, and version checks. Preserve scope by making no tasks-axi code, SDK/runtime, release-note, publishing, or unrelated catalog changes. Use the authorized public RooseveltAdvisors/axi fork as the push target, resume no-mistakes, and produce an unmerged upstream PR with green CI while remaining inside the worktree.

What Changed

Add tasks-axi to the community catalog with its author, repository, domain, and Markdown-backed capabilities.
Regenerate the catalog listings in README.md and the documentation site.

Risk Assessment

✅ Low: The change is a well-bounded catalog addition whose generated documentation and description align with the shipped tasks-axi Markdown backend.

Testing

After frozen dependency setup, the docs tests and drift check, semantic scope verification, browser rendering, upstream metadata checks, and a released tasks-axi v0.2.3 Markdown-backlog workflow all confirmed the truthful Community listing. Setup/invocation probes were corrected and retried, transient node_modules were removed, and no lint, formatting, or static-analysis commands were run per the testing rules.

Evidence: Rendered AXI Community catalog with tasks-axi entry (local file: /tmp/no-mistakes-evidence/01KXX5F3EF53R695KKB7E59XW9/axi-community-catalog.png)
Evidence: Focused rendered tasks-axi catalog row (local file: /tmp/no-mistakes-evidence/01KXX5F3EF53R695KKB7E59XW9/tasks-axi-catalog-row.png)

Evidence: Released tasks-axi end-to-end Markdown backend transcript

$ npx -y [email protected] --version
0.2.3

$ npx -y [email protected] add blocker-b1 "Prepare schema" --kind ship --file backlog.md
ok: added blocker-b1 (ship) -> Queued
task:
  id: blocker-b1
  title: Prepare schema
  state: queued
  blocked: no
  blocked_by: none
  held: no
  hold_reason: "-"
  hold_kind: "-"
  hold_until: "-"
  kind: ship
  repo: "-"
  priority: "-"
  created: 2026-07-19
  closed: "-"
  deps: none
  links: none
  body: ""
help[2]:
  - Run `tasks-axi start blocker-b1 --file=backlog.md` to move it to in flight
  - Run `tasks-axi block blocker-b1 --by <other> --file=backlog.md` to record a dependency

$ npx -y [email protected] add dependent-d2 "Publish docs" --kind docs --blocked-by blocker-b1 --file backlog.md
ok: added dependent-d2 (docs) -> Queued
task:
  id: dependent-d2
  title: Publish docs
  state: queued
  blocked: yes
  blocked_by: blocker-b1
  held: no
  hold_reason: "-"
  hold_kind: "-"
  hold_until: "-"
  kind: docs
  repo: "-"
  priority: "-"
  created: 2026-07-19
  closed: "-"
  deps: "blocked-by:blocker-b1"
  links: none
  body: ""
help[2]:
  - Run `tasks-axi start dependent-d2 --file=backlog.md` to move it to in flight
  - Run `tasks-axi block dependent-d2 --by <other> --file=backlog.md` to record a dependency

$ npx -y [email protected] add held-h3 "Announce release" --kind docs --file backlog.md
ok: added held-h3 (docs) -> Queued
task:
  id: held-h3
  title: Announce release
  state: queued
  blocked: no
  blocked_by: none
  held: no
  hold_reason: "-"
  hold_kind: "-"
  hold_until: "-"
  kind: docs
  repo: "-"
  priority: "-"
  created: 2026-07-19
  closed: "-"
  deps: none
  links: none
  body: ""
help[2]:
  - Run `tasks-axi start held-h3 --file=backlog.md` to move it to in flight
  - Run `tasks-axi block held-h3 --by <other> --file=backlog.md` to record a dependency

$ npx -y [email protected] hold held-h3 --reason "review pending" --kind external --file backlog.md
ok: hold held-h3 -> held (external)
task:
  id: held-h3
  title: Announce release
  state: queued
  blocked: no
  blocked_by: none
  held: yes
  hold_reason: review pending
  hold_kind: external
  hold_until: "-"
  kind: docs
  repo: "-"
  priority: "-"
  created: 2026-07-19
  closed: "-"
  deps: none
  links: none
  body: ""
help[2]:
  - Run `tasks-axi unhold held-h3 --file=backlog.md` to resume dispatch
  - Run `tasks-axi ready --include-held --file=backlog.md` to review paused work

$ npx -y [email protected] ready --include-held --file backlog.md
count: 1
ready[1]{id,state,kind,repo,title}:
  blocker-b1,queued,ship,"-",Prepare schema
ready_public_followups: 0 delivery-ready obligations
held[1]{id,state,kind,repo,title,hold_reason,hold_kind,hold_until}:
  held-h3,queued,docs,"-",Announce release,review pending,external,"-"
help[1]:
  - Run `tasks-axi start <id> --file=backlog.md` to dispatch one of these

$ npx -y [email protected] done blocker-b1 --file backlog.md
ok: done blocker-b1 -> Done
help[1]:
  - Run `tasks-axi ready --file=backlog.md` to dispatch work unblocked by this

$ npx -y [email protected] unhold held-h3 --file backlog.md
ok: unhold held-h3 -> cleared
task:
  id: held-h3
  title: Announce release
  state: queued
  blocked: no
  blocked_by: none
  held: no
  hold_reason: "-"
  hold_kind: "-"
  hold_until: "-"
  kind: docs
  repo: "-"
  priority: "-"
  created: 2026-07-19
  closed: "-"
  deps: none
  links: none
  body: ""
help[1]:
  - Run `tasks-axi ready --file=backlog.md` to see dispatchable work

$ npx -y [email protected] ready --file backlog.md
count: 2
ready[2]{id,state,kind,repo,title}:
  dependent-d2,queued,docs,"-",Publish docs
  held-h3,queued,docs,"-",Announce release
ready_public_followups: 0 delivery-ready obligations
help[1]:
  - Run `tasks-axi start <id> --file=backlog.md` to dispatch one of these

$ cat backlog.md
# Backlog

## In flight
## Queued
- [ ] dependent-d2 - Publish docs blocked-by: blocker-b1 (kind: docs) (since 2026-07-19)
- [ ] held-h3 - Announce release (kind: docs) (since 2026-07-19)
## Done
- [x] blocker-b1 - Prepare schema (kind: ship) (done 2026-07-19)

Evidence: tasks-axi AXI behavior smoke transcript

$ npx -y [email protected]  # content-first default dashboard
bin: ~/.npm-global/bin/tasks-axi
description: "Agent ergonomic task & backlog manager for the current workspace. Prefer this over hand-editing backlog.md for task state, dependency, or hold changes."
in_flight: 0 tasks
summary:
  queued: 2
  ready: 2
queued[2]{id,title,kind,blocked_by}:
  dependent-d2,Publish docs,docs,none
  held-h3,Announce release,docs,none
public_followups: 0 obligations
done: 1 retained
help[3]:
  - Run `tasks-axi list` for the full backlog
  - Run `tasks-axi ready` to see unblocked queued work
  - "Run `tasks-axi add <id> \"<title>\" --start` to add and start a task"

$ npx -y [email protected] ready --help  # per-subcommand help
usage: tasks-axi ready [--repo <name>] [--include-held]
List unblocked, unheld queued work dispatchable right now.
Public-followup obligations are never dispatchable and appear only in the separate
ready_public_followups group; use tasks-axi public-followup ready for their full payloads.
Held work is excluded by default; --include-held shows it in a separate held group.
$ npx -y [email protected] list --state in_flight --file backlog.md  # definitive empty state
count: 0
tasks: 0 in_flight tasks in this backlog

$ npx -y [email protected] unhold held-h3 --file backlog.md  # idempotent repeat
ok: unhold held-h3 already not held
already: true
task:
  id: held-h3
  title: Announce release
  state: queued
  blocked: no
  blocked_by: none
  held: no
  hold_reason: "-"
  hold_kind: "-"
  hold_until: "-"
  kind: docs
  repo: "-"
  priority: "-"
  created: 2026-07-19
  closed: "-"
  deps: none
  links: none
  body: ""
help[1]:
  - Run `tasks-axi ready --file=backlog.md` to see dispatchable work
exit: 0

$ npx -y [email protected] ready --not-a-flag  # structured usage error
exit: 2
stdout:
error: "Unknown flag: --not-a-flag"
code: VALIDATION_ERROR
help[1]: Run the command with --help to see supported flags
stderr:
(empty)

Evidence: Upstream repository, release, license, backend, and CI metadata

$ curl -L -sS -o /dev/null -w ... https://github.com/kunchenguid/tasks-axi
HTTP 200; final URL https://github.com/kunchenguid/tasks-axi

$ gh api repos/kunchenguid/tasks-axi (selected metadata)
{"archived":false,"default_branch":"main","full_name":"kunchenguid/tasks-axi","html_url":"https://github.com/kunchenguid/tasks-axi","license":"MIT","owner":"kunchenguid","visibility":"public"}

$ npm view tasks-axi version license repository.url dist-tags.latest --json
{
  "version": "0.2.3",
  "license": "MIT",
  "repository.url": "git+https://github.com/kunchenguid/tasks-axi.git",
  "dist-tags.latest": "0.2.3"
}

$ gh api repos/kunchenguid/tasks-axi/releases/latest (selected metadata)
{"html_url":"https://github.com/kunchenguid/tasks-axi/releases/tag/tasks-axi-v0.2.3","published_at":"2026-07-13T22:56:41Z","tag_name":"tasks-axi-v0.2.3"}

$ upstream README backend status table
## Backends

P1 ships the **markdown** backend only, behind a narrow `Store` interface so additional backends slot in without touching the CLI layer.

| Backend                | Status  |
| ---------------------- | ------- |
| markdown               | shipped |
| sqlite                 | planned |
| github / jira / linear | planned |

## Development

$ latest upstream main CI run
{"conclusion":"success","head_sha":"0e2cf5904cc227bb66fed66bddac23da6ee449db","html_url":"https://github.com/kunchenguid/tasks-axi/actions/runs/29291494425","name":"CI","status":"completed"}

Evidence: Catalog semantic scope verification

{
  "result": "ok",
  "officialEntriesUnchanged": 4,
  "existingCommunityEntriesUnchanged": 22,
  "addedCommunityEntry": {
    "name": "tasks-axi",
    "url": "https://github.com/kunchenguid/tasks-axi",
    "author": "kunchenguid",
    "domain": "Tasks / backlog",
    "description": "Manages task backlogs with a Markdown backend, dependency-aware ready queries, structured holds, and token-efficient TOON output."
  },
  "changedFiles": [
    "README.md",
    "catalog.yaml",
    "docs/index.html"
  ]
}

Pipeline

Updates from git push no-mistakes

✅ **intent** - passed

✅ No issues found.

✅ **Rebase** - passed

✅ No issues found.

✅ **Review** - passed

✅ No issues found.

✅ **Test** - passed

✅ No issues found.

pnpm install --frozen-lockfile
pnpm run docs:test
pnpm run docs:check
node --input-type=module semantic comparison of base and target catalogs, asserting one Community addition and only generated documentation changes
curl, gh api, and npm view checks for the repository link, owner, license, release/version, shipped backend, and upstream CI
npx -y [email protected] end-to-end Markdown backlog workflow covering dependencies, holds, ready queries, persistence, TOON output, empty states, idempotency, help, and structured errors
Local python3 -m http.server plus Playwright Chromium rendering of docs/index.html and screenshot capture of the Community catalog
pnpm dlx [email protected] --version was blocked by the configured minimum-release-age policy; retried successfully with npx -y [email protected] --version
An initial list --state in-flight probe used an invalid state spelling; corrected and successfully retried as list --state in_flight

✅ **Document** - passed

✅ No issues found.

✅ **Lint** - passed

✅ No issues found.

✅ **Push** - passed

✅ No issues found.

kunchenguid · 2026-07-20T06:43:06Z

Thanks for the contribution, but tasks-axi is maintained by the repo owner, who will add it to the community catalog when the time is right. Closing this PR.

RooseveltAdvisors added 2 commits July 19, 2026 07:36

docs: add tasks-axi to official catalog

9732981

no-mistakes(review): Move tasks-axi to truthful community catalog entry

5f51520

github-actions Bot mentioned this pull request Jul 19, 2026

[axi#103] docs: add tasks-axi to community catalog kunchenguid/wheelhouse#1493

Closed

5 tasks

kunchenguid closed this Jul 20, 2026

Navigation Menu

docs: add tasks-axi to community catalog - #103

docs: add tasks-axi to community catalog#103
RooseveltAdvisors wants to merge 2 commits into
kunchenguid:mainfrom
RooseveltAdvisors:fm/axi-catalog-tasks-axi

RooseveltAdvisors commented Jul 19, 2026

Uh oh!

kunchenguid commented Jul 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

RooseveltAdvisors commented Jul 19, 2026

Intent

What Changed

Risk Assessment

Testing

Pipeline

Uh oh!

kunchenguid commented Jul 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants