Skip to content

docs: add mastra-axi to community catalog - #101

Open
taltas wants to merge 1 commit into
kunchenguid:mainfrom
taltas:feat/mastra-axi-catalog
Open

docs: add mastra-axi to community catalog#101
taltas wants to merge 1 commit into
kunchenguid:mainfrom
taltas:feat/mastra-axi-catalog

Conversation

@taltas

@taltas taltas commented Jul 19, 2026

Copy link
Copy Markdown

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.

@taltas
taltas force-pushed the feat/mastra-axi-catalog branch 2 times, most recently from d5841fd to 5136b23 Compare July 22, 2026 00:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant