docs: add mastra-axi to community catalog

[taltas]

Intent

Add mastra-axi to the AXI community catalog as a documentation-only contribution. Append exactly one catalog.yaml community entry using the requested name, repository URL, author, Mastra domain, and one-sentence description copied from mastra-axi's README; preserve the existing field order and style. Regenerate README.md and docs/index.html from catalog.yaml rather than editing generated regions by hand, do not touch release-please-generated files, validate formatting, lint, and docs synchronization, then push to the taltas/axi fork and open a PR against kunchenguid/axi main through no-mistakes without merging it.

What Changed

• Added mastra-axi to catalog.yaml community section with repository URL, author, domain, and description
• Regenerated README.md and docs/index.html to reflect the new catalog entry
• All generated files remain synchronized with the single source of truth in catalog.yaml

Risk Assessment

✅ Low: Documentation-only change adding a single catalog entry with properly regenerated files, all validation checks pass, and the change exactly follows the established catalog pattern.

Testing

Validated the mastra-axi catalog entry through automated checks (docs:check, format:check, lint) and manual diff analysis. All validation checks passed, confirming the catalog entry was properly added with correct structure, generated files were synchronized from catalog.yaml, and no release-please files were touched.

Evidence: Validation Summary

All user intent requirements satisfied: ✅ Single catalog.yaml entry added with all required fields ✅ Field order and style preserved ✅ README.md and docs/index.html regenerated (not hand-edited) ✅ Release-please files untouched ✅ Formatting validated (Prettier passes) ✅ Linting validated (ESLint passes) ✅ Docs synchronization validated (docs:check passes)

# mastra-axi Catalog Entry Validation

## User Intent Verification

**Required Constraints:**
✅ Add exactly one catalog.yaml community entry
✅ Use requested fields: name, repository URL, author, Mastra domain, one-sentence description
✅ Preserve existing field order and style
✅ Regenerate README.md and docs/index.html from catalog.yaml (not hand-edited)
✅ Do not touch release-please-generated files
✅ Validate formatting, lint, and docs synchronization

## Files Changed

`` `
README.md       |  1 +
catalog.yaml    |  5 +++++
docs/index.html | 14 ++++++++++++++
3 files changed, 20 insertions(+)
`` `

## catalog.yaml Entry

`` `yaml
  - name: mastra-axi
    url: https://github.com/taltas/mastra-axi
    author: taltas
    domain: Mastra
    description: "Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output."
`` `

**Field Validation:**
- ✅ name: `mastra-axi`
- ✅ url: `https://github.com/taltas/mastra-axi` (taltas fork)
- ✅ author: `taltas`
- ✅ domain: `Mastra`
- ✅ description: One sentence with domain context and TOON output mention
- ✅ Field order matches existing community entries
- ✅ Appended at end of community section

## Generated Files

### README.md
Added single table row in community catalog section:
`` `
| [`mastra-axi`](https://github.com/taltas/mastra-axi) | taltas | Mastra | Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output. |
`` `

### docs/index.html
Added single table row in community catalog HTML:
`` `html
<tr>
  <td><a href="https://github.com/taltas/mastra-axi"><code>mastra-axi</code></a></td>
  <td>taltas</td>
  <td>Mastra</td>
  <td>Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output.</td>
</tr>
`` `

## Validation Results

### docs:check
✅ PASSED - Generated regions match their sources
`` `
docs:check ok — generated regions match their sources
`` `

### format:check
✅ PASSED - All files use Prettier code style
`` `
All matched files use Prettier code style!
`` `

### lint
✅ PASSED - No ESLint errors
`` `
$ eslint packages/axi-sdk-js/src packages/axi-sdk-js/test eslint.config.mjs scripts
`` `

## Release-Please Files

✅ No release-please files were modified:
- `.release-please-manifest.json` - not touched
- `packages/axi-sdk-js/CHANGELOG.md` - not touched
- `packages/axi-sdk-js/package.json` - not touched

## Commit Details

`` `
commit a8eb300dbee9319fe3c818a4753a360757834028
Author: Toray Altas <toray.altas@gmail.com>
Date:   Sat Jul 18 23:28:43 2026 -0400

    docs: add mastra-axi to community catalog
`` `

## Summary

All user intent requirements satisfied:
1. ✅ Single catalog.yaml entry added with all required fields
2. ✅ Field order and style preserved (matches existing community entries)
3. ✅ README.md and docs/index.html regenerated (not hand-edited)
4. ✅ Release-please files untouched
5. ✅ Formatting validated (Prettier passes)
6. ✅ Linting validated (ESLint passes)
7. ✅ Docs synchronization validated (docs:check passes)

The documentation change is ready for PR submission.

Evidence: Catalog Context

mastra-axi entry appended at end of community catalog with all required fields in correct order

# Community Catalog Context (showing mastra-axi in position)

## Last 3 entries before mastra-axi:

kubernetes-axi | thatdudealso | Kubernetes | Discover, inspect, deploy, debug, scale, roll out, expose, and clean up Kubernetes workloads through safe token-efficient CLI workflows.
redis-axi      | thatdudealso | Redis      | Discover, inspect, query, export, import, maintain, and diagnose Redis databases through safe token-efficient CLI workflows.
celery-axi     | thatdudealso | Celery     | Discover, inspect, run, debug, monitor, schedule, control, and safely operate Celery task queues through token-efficient CLI workflows.

## NEW ENTRY:

mastra-axi     | taltas       | Mastra     | Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output.

---

## catalog.yaml structure verification:

Entry fields in order:
1. name: mastra-axi
2. url: https://github.com/taltas/mastra-axi
3. author: taltas
4. domain: Mastra
5. description: "Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output."

Matches the field order of other community entries ✓

Evidence: docs:check output

docs:check ok — generated regions match their sources

Evidence: format:check output

All matched files use Prettier code style!

Evidence: lint output

$ eslint packages/axi-sdk-js/src packages/axi-sdk-js/test eslint.config.mjs scripts
(no errors)

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 run docs:check - verified generated files synchronization
• pnpm run format:check - verified Prettier formatting
• pnpm run lint - verified ESLint compliance
• git diff analysis - verified catalog.yaml entry structure and field order
• git diff analysis - verified README.md and docs/index.html were regenerated correctly
• git diff --name-only - verified no release-please files were modified

✅ **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.

Independent source review at pin 625136925624fd9adcbb1c815ff11a2d19f0c268 (current main HEAD; no tags). Files/paths read at that revision: package.json, bin/mastra-axi.ts, src/cli.ts, src/commands/setup.ts, src/commands/home.ts, src/format/toon.ts, plus the recursive tree. Direct observations at that revision:

• axi-sdk-js runAxiCli; TOON via @toon-format/toon encode at the output boundary; commands agent / tool / workflow / setup; generated skills/mastra-axi/SKILL.md exists
• principle 7 held: mastra-axi setup hooks calls installSessionStartHooks for Claude Code, Codex, and OpenCode
• no-args home lists live project agents, tools, and workflows with next-step help
• principle 10 fast path not held: bin/mastra-axi.ts dynamically imports cli.js without tryFastPath (SDK still serves --version)

Catalog description (discover and run a Mastra app's agents, tools, and workflows with compact TOON output) is source-backed at this pin.

VISION.md per-rule:

• AXI principles: aligns for a positive admission at this pin (missing --version fast path is not an admission blocker).
• Catalog: aligns. Independent source review at 625136925624fd9adcbb1c815ff11a2d19f0c268 supports admission.
• SDKs: aligns (docs-only catalog add; no SDK change).

Diff is catalog-only; no security issue. Fork CI is green. The PR is CONFLICTING with main; I will resolve and land if the fork can be updated.

[kunchenguid]

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

[kunchenguid]

Speaking as Kun's firstmate.

This catalog entry landed via last-resort port #157 (squash merge feed36965577e59ed694a80383439f93b92ed222) because #101 stayed CONFLICTING on the fork and we could not fast-forward a resolve there. No rebase was requested. Closing this original as redundant now that mastra-axi is on main.