Release Checklist
Use this checklist before publishing the package or cutting a public documentation update.
Package Checks
- Confirm the package name and ownership on npm.
- Confirm
package.jsonmetadata, keywords, license, and export map. - Confirm the package still targets Node.js 20 or newer and ESM-only usage.
- Confirm the root export and subpath exports match the documented entry points.
- Run
npm testin the package. - Run
npm pack --dry-runand inspect included files. - Review generated type declarations.
Contract Checks
- Review
README.mdand docs landing copy for positioning consistency. - Confirm the docs still describe Ageniti as infrastructure for apps that agents can use, not an agent framework.
- Confirm destructive and private action exposure rules are documented correctly.
- Run the demo CLI and inspect
actions,manifest,lint, andmcpoutput. - Run
npx @ageniti/core doctoror the equivalent project check before shipping launchers. - Run your generated app CLI, for example
task-app build, and inspect generatedcli.mjs,mcp-stdio.mjs, andageniti.mcp.json. - Confirm the local dev console still starts successfully.
Website Checks
- Build the documentation website.
- Confirm English and Chinese docs both have real titles and real localised content.
- Click through internal documentation links.
- Confirm new exports or runtime behaviours have corresponding docs updates.
Recommended Commands
## package
cd ../ageniti
npm test
npm pack --dry-run
npm publish --dry-run --access public --registry=https://registry.npmjs.org
node examples/demo.cli.js search-tasks --status open
node examples/demo.cli.js create-task --title "Follow up with design review"
node examples/demo.cli.js lint
node examples/demo.cli.js manifest
node examples/demo.cli.js mcp
node examples/demo.cli.js dev --port 4321
## website
cd ../website
npm run buildPublishing
npm publish --access publicDo not publish until package name, ownership, and registry target are confirmed.
If the local npm config points at a mirror, publish with:
npm publish --access public --registry=https://registry.npmjs.org