@agentmanifest/cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to the AMP CLI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-15
+
+### Added
+- Initial release of `@agentmanifest/cli`
+- `amp init` command for interactive manifest creation
+  - Full wizard for all AMP v0.1 specification fields
+  - Support for multiple endpoints with parameters
+  - Category selection from controlled vocabulary
+  - Pricing and authentication configuration
+  - Optional rate limits and reliability metrics
+  - Contact information and agent notes
+- `amp validate` command for manifest validation
+  - Integration with validator API at validator.agent-manifest.com
+  - Detailed error reporting with field-level validation
+  - Warning messages for non-critical issues
+- `amp publish` command for registry submission
+  - Two-step process: validate then publish
+  - Automatic homepage URL prompting if missing
+  - Integration with registry API at agent-manifest.com
+  - Clear success/failure messaging
+- Comprehensive README with usage examples
+- TypeScript support with full type definitions
+- Error handling for common scenarios
+- MIT License
+
+### Features
+- Interactive prompts using `inquirer`
+- Colored terminal output using `chalk`
+- Commander-based CLI structure
+- HTTP API integration with `axios`
+- Semantic versioning validation
+- URL validation (HTTPS required)
+- JSON syntax validation
+- Category and primary category consistency checks
+- Minimum character requirements for descriptions and agent notes
+
+### Dependencies
+- commander ^12.0.0
+- inquirer ^9.2.15
+- chalk ^4.1.2
+- axios ^1.6.7
+- TypeScript ^5.3.3
+
+## [Unreleased]
+
+### Planned
+- Offline validation mode
+- Manifest update command
+- Multiple manifest management
+- Template system for common API types
+- Manifest comparison/diff tool
+- Batch validation for multiple manifests
+- JSON Schema export
+- OpenAPI to AMP conversion
+- Registry search from CLI

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brandon Weber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PROJECT_STRUCTURE.md

@@ -0,0 +1,290 @@
+# AMP CLI - Project Structure
+
+Complete Node.js CLI tool for the Agent Manifest Protocol, ready for npm publication.
+
+## Directory Structure
+
+```
+amp-cli/
+├── src/                          # TypeScript source files
+│   ├── commands/                 # Command implementations
+│   │   ├── init.ts              # Interactive manifest creation
+│   │   ├── validate.ts          # Manifest validation
+│   │   └── publish.ts           # Registry submission
+│   ├── constants.ts             # Controlled vocabularies
+│   ├── types.ts                 # TypeScript type definitions
+│   └── index.ts                 # CLI entry point
+├── dist/                         # Compiled JavaScript (generated)
+│   ├── commands/
+│   ├── *.js
+│   ├── *.d.ts
+│   └── *.map
+├── node_modules/                # Dependencies (gitignored)
+├── package.json                 # Package configuration
+├── tsconfig.json                # TypeScript configuration
+├── README.md                    # Comprehensive documentation
+├── CHANGELOG.md                 # Version history
+├── LICENSE                      # MIT License
+├── .gitignore                   # Git ignore rules
+└── .npmignore                   # npm publish exclusions
+```
+
+## Files Overview
+
+### Source Files (`src/`)
+
+#### `index.ts` (Entry Point)
+- Sets up Commander CLI structure
+- Defines three main commands: init, validate, publish
+- Includes version and help information
+
+#### `commands/init.ts` (Interactive Scaffolding)
+- Full wizard for creating agent-manifest.json
+- Inquirer prompts for all required fields
+- Validates user input in real-time
+- Supports multiple endpoints with parameters
+- Generates compliant AMP v0.1 manifest
+
+#### `commands/validate.ts` (Validation)
+- Reads manifest from filesystem
+- POSTs to validator API at validator.agent-manifest.com
+- Displays detailed error/warning messages
+- Provides clear pass/fail feedback
+
+#### `commands/publish.ts` (Registry Submission)
+- Two-step process: validate then publish
+- Prompts for missing homepage URL
+- Submits to registry at agent-manifest.com
+- Returns listing ID and registry URL
+
+#### `constants.ts` (Controlled Vocabularies)
+- Standard categories (15 categories)
+- Pricing models (free, usage_based, subscription)
+- Authentication types (none, api_key, oauth2, bearer)
+
+#### `types.ts` (TypeScript Definitions)
+- Complete type definitions for AMP v0.1
+- Interfaces for all manifest sections
+- Type safety for parameters and responses
+
+### Configuration Files
+
+#### `package.json`
+- Package name: `@agentmanifest/cli`
+- Binary: `amp`
+- Dependencies: commander, inquirer, chalk, axios
+- DevDependencies: TypeScript, tsx, @types/*
+- Build scripts
+- Node.js 18+ requirement
+
+#### `tsconfig.json`
+- Target: ES2020
+- Module: CommonJS
+- Strict mode enabled
+- Source maps and declarations
+
+#### `.gitignore`
+- node_modules, dist, logs
+- OS files (.DS_Store)
+- IDE files (.vscode, .idea)
+- Environment variables
+
+#### `.npmignore`
+- Source files (only publish dist/)
+- Tests and development files
+- Documentation (except README)
+- Git and CI/CD files
+
+### Documentation
+
+#### `README.md` (13 Sections)
+1. Installation instructions
+2. Requirements
+3. Command reference (init, validate, publish)
+4. Complete workflow examples
+5. Manifest schema documentation
+6. Validation rules
+7. API endpoint references
+8. Troubleshooting guide
+9. Resources and links
+10. Contributing guidelines
+11. License information
+12. Support contacts
+13. Project vision
+
+#### `CHANGELOG.md`
+- Version history (semantic versioning)
+- Initial v0.1.0 release notes
+- Feature list
+- Planned improvements
+
+#### `LICENSE`
+- MIT License
+- Copyright 2026 Brandon Weber
+- Full license text
+
+## Key Features
+
+### Interactive Creation (`amp init`)
+- Step-by-step wizard
+- Real-time validation
+- Multi-endpoint support
+- Parameter configuration
+- Optional sections (rate limits, reliability)
+- Contact information
+- Agent guidance notes
+
+### Validation (`amp validate`)
+- API integration
+- JSON syntax checking
+- Field-level validation
+- Length requirements (description ≥100, agent_notes ≥50)
+- Semantic versioning check
+- Category consistency
+- Detailed error reporting
+
+### Publication (`amp publish`)
+- Pre-publication validation
+- Homepage URL requirement
+- Two-step submission process
+- Registry integration
+- Listing ID generation
+- Success confirmation
+
+## Dependencies
+
+### Production
+- `commander@^12.0.0` - CLI framework
+- `inquirer@^9.2.15` - Interactive prompts
+- `chalk@^4.1.2` - Terminal colors
+- `axios@^1.6.7` - HTTP client
+
+### Development
+- `typescript@^5.3.3` - Type system
+- `tsx@^4.7.1` - TypeScript executor
+- `@types/node@^20.11.19` - Node.js types
+- `@types/inquirer@^9.0.7` - Inquirer types
+
+## Build Process
+
+```bash
+# Install dependencies
+npm install
+
+# Compile TypeScript to JavaScript
+npm run build
+
+# Development mode (no compilation)
+npm run dev
+
+# Prepare for publishing
+npm run prepublishOnly
+```
+
+## Output (dist/)
+
+The compiled output includes:
+- JavaScript files (.js)
+- TypeScript declarations (.d.ts)
+- Source maps (.js.map, .d.ts.map)
+- Preserves directory structure
+
+## Testing
+
+The CLI has been tested with:
+- Successful compilation (TypeScript → JavaScript)
+- Help command output verification
+- Command structure validation
+- Proper exit codes
+- Error handling
+
+## Publication Readiness
+
+The package is ready to publish to npm:
+
+```bash
+# Login to npm
+npm login
+
+# Publish (runs prepublishOnly automatically)
+npm publish --access public
+```
+
+## API Integration
+
+### Validator API
+- Endpoint: `https://validator.agent-manifest.com/validate`
+- Method: POST
+- Timeout: 10 seconds
+- Returns: `{ valid: boolean, errors: [], warnings: [] }`
+
+### Registry API
+- Endpoint: `https://agent-manifest.com/listings/submit`
+- Method: POST
+- Timeout: 15 seconds
+- Returns: `{ success: boolean, listing_id: string, url: string }`
+
+## Command Line Interface
+
+### Binary Name: `amp`
+
+Available globally after `npm install -g @agentmanifest/cli`
+
+### Commands
+1. `amp init` - Create new manifest
+2. `amp validate [-f <path>]` - Validate manifest
+3. `amp publish [-f <path>]` - Publish to registry
+4. `amp --version` - Show version
+5. `amp --help` - Show help
+
+## Error Handling
+
+The CLI includes robust error handling for:
+- File not found
+- Invalid JSON syntax
+- Validation failures
+- API connection errors
+- Permission denied
+- Network timeouts
+- Malformed responses
+
+## Color Coding
+
+Terminal output uses color coding:
+- **Cyan**: Headers, informational
+- **Green**: Success messages
+- **Red**: Errors
+- **Yellow**: Warnings
+- **Gray**: Secondary information
+
+## Future Enhancements
+
+Planned for future versions:
+- Offline validation mode
+- Manifest update command
+- Template system
+- Batch operations
+- OpenAPI conversion
+- Registry search
+- Diff tool
+
+## Contributing
+
+Contributions welcome at:
+- Repository: https://github.com/AMProtocol/amp-cli
+- Issues: Submit bugs and feature requests
+- Pull Requests: Code contributions
+
+## Support
+
+- Email: brandon@agent-manifest.com
+- GitHub: @brandon-weber
+- Website: https://agent-manifest.com
+
+---
+
+**Status**: ✅ Complete and Ready for Publication
+
+**Version**: 0.1.0
+
+**Last Updated**: February 15, 2026

package/QUICK_START.md

@@ -0,0 +1,188 @@
+# AMP CLI - Quick Start Guide
+
+Get started with the Agent Manifest Protocol CLI in 5 minutes.
+
+## Installation
+
+```bash
+npm install -g @agentmanifest/cli
+```
+
+## Basic Usage
+
+### 1. Create a New Manifest
+
+```bash
+cd /path/to/your/api
+amp init
+```
+
+Follow the prompts to create your `agent-manifest.json`.
+
+### 2. Validate Your Manifest
+
+```bash
+amp validate
+```
+
+### 3. Publish to Registry
+
+```bash
+amp publish
+```
+
+## Example: Complete Workflow
+
+```bash
+# Navigate to your API project
+cd ~/projects/my-api
+
+# Create manifest interactively
+amp init
+# Answer the prompts...
+
+# Check if it's valid
+amp validate
+
+# If validation passes, publish
+amp publish
+
+# Done! Your API is now discoverable by AI agents
+```
+
+## Minimal Manifest Example
+
+The wizard will help you create something like this:
+
+```json
+{
+  "spec_version": "agentmanifest-0.1",
+  "name": "Weather Data API",
+  "version": "1.0.0",
+  "description": "Provides real-time weather data and forecasts for locations worldwide with high accuracy and comprehensive coverage including current conditions, hourly forecasts, and historical data.",
+  "homepage": "https://api.weather-data.com",
+  "categories": ["weather"],
+  "primary_category": "weather",
+  "endpoints": [
+    {
+      "path": "/current",
+      "method": "GET",
+      "description": "Get current weather for a location",
+      "response": {
+        "type": "object",
+        "description": "Current weather conditions"
+      }
+    }
+  ],
+  "pricing": {
+    "model": "free"
+  },
+  "authentication": {
+    "type": "none"
+  },
+  "agent_notes": "Simple weather API. Use location parameter with city names or coordinates for precise results.",
+  "last_updated": "2026-02-15T10:30:00Z"
+}
+```
+
+## Common Workflows
+
+### Check Validation Without Publishing
+
+```bash
+amp validate
+```
+
+### Validate Custom File
+
+```bash
+amp validate -f ./custom-manifest.json
+```
+
+### Publish Custom File
+
+```bash
+amp publish -f ./custom-manifest.json
+```
+
+### Update Existing Manifest
+
+```bash
+# Edit your manifest file manually
+vim agent-manifest.json
+
+# Validate the changes
+amp validate
+
+# If valid, publish the update
+amp publish
+```
+
+## Tips
+
+1. **Description Length**: Must be ≥100 characters. Be descriptive!
+2. **Agent Notes**: Must be ≥50 characters. Tell agents how to use your API.
+3. **Categories**: Choose the most relevant. Primary category must be in your categories list.
+4. **Homepage**: This is where your manifest will be hosted (`https://your-api.com/.well-known/agent-manifest.json`)
+
+## Hosting Your Manifest
+
+After creating your manifest, you need to host it at:
+
+```
+https://your-api.com/.well-known/agent-manifest.json
+```
+
+### Express.js Example
+
+```javascript
+const express = require('express');
+const manifest = require('./agent-manifest.json');
+
+const app = express();
+
+app.get('/.well-known/agent-manifest.json', (req, res) => {
+  res.json(manifest);
+});
+
+app.listen(3000);
+```
+
+### Static Hosting
+
+Just place your `agent-manifest.json` file in:
+```
+public/.well-known/agent-manifest.json
+```
+
+## Troubleshooting
+
+### "Description too short"
+Make your description at least 100 characters. Explain what your API does in detail.
+
+### "Agent notes too short"
+Make agent notes at least 50 characters. Provide implementation guidance for AI agents.
+
+### "Primary category not in categories"
+Your primary_category must be one of the values in your categories array.
+
+### "File not found"
+Run `amp init` first to create a manifest, or use `-f` flag to specify the file path.
+
+## Next Steps
+
+1. **Read the full README**: `cat README.md`
+2. **Check the spec**: Visit https://agent-manifest.com/docs
+3. **See examples**: Check out BakeBase at https://github.com/AMProtocol/BakeBase
+4. **Join the community**: Follow updates at https://agent-manifest.com
+
+## Help
+
+- Run `amp --help` for command list
+- Run `amp <command> --help` for command details
+- Visit https://agent-manifest.com for documentation
+- Email: brandon@agent-manifest.com
+
+---
+
+**Ready to make your API discoverable by AI agents? Run `amp init` now!**