fips-agents-cli 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{fips_agents_cli-0.1.0.dist-info → fips_agents_cli-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fips-agents-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: CLI tool for creating and managing FIPS-compliant AI agent projects
 Project-URL: Homepage, https://github.com/rdwj/fips-agents-cli
 Project-URL: Repository, https://github.com/rdwj/fips-agents-cli
@@ -13,15 +13,15 @@ Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: click>=8.1.0
 Requires-Dist: gitpython>=3.1.0
+Requires-Dist: jinja2>=3.1.2
 Requires-Dist: rich>=13.0.0
 Requires-Dist: tomlkit>=0.12.0
 Provides-Extra: dev
@@ -40,25 +40,38 @@ A command-line tool for creating and managing FIPS-compliant AI agent projects,
 - 🚀 Quick project scaffolding from templates
 - 📦 MCP server project generation
 - 🔧 Automatic project customization
+- ⚡ Component generation (tools, resources, prompts, middleware)
 - 🎨 Beautiful CLI output with Rich
 - ✅ Git repository initialization
-- 🧪 Comprehensive test coverage
+- 🧪 Comprehensive test coverage with auto-run
 
 ## Installation
 
-### Using pipx (Recommended)
+**Recommended:** Install with [pipx](https://pipx.pypa.io/) for isolated command-line tools:
 
 ```bash
 pipx install fips-agents-cli
 ```
 
-### Using pip
+pipx installs the CLI in an isolated environment while making it globally available. This prevents dependency conflicts with other Python packages.
+
+<details>
+<summary><b>Alternative: Using pip</b></summary>
+
+If you prefer pip or don't have pipx installed:
 
 ```bash
 pip install fips-agents-cli
 ```
 
-### From Source (Development)
+**Note:** Consider using a virtual environment to avoid dependency conflicts.
+
+</details>
+
+<details>
+<summary><b>Alternative: Install from source (for development)</b></summary>
+
+For contributing or local development:
 
 ```bash
 # Clone the repository
@@ -73,6 +86,8 @@ source venv/bin/activate  # On Windows: venv\Scripts\activate
 pip install -e .[dev]
 ```
 
+</details>
+
 ## Quick Start
 
 ### Create a new MCP server project
@@ -99,6 +114,25 @@ fips-agents create mcp-server my-server --target-dir ~/projects
 fips-agents create mcp-server my-server --no-git
 ```
 
+### Generate components in an existing project
+
+```bash
+# Navigate to your MCP server project
+cd my-mcp-server
+
+# Generate a new tool
+fips-agents generate tool search_documents --description "Search through documents"
+
+# Generate a resource
+fips-agents generate resource config_data --description "Application configuration"
+
+# Generate a prompt
+fips-agents generate prompt code_review --description "Review code for best practices"
+
+# Generate middleware
+fips-agents generate middleware auth_middleware --description "Authentication middleware"
+```
+
 ## Usage
 
 ### Basic Commands
@@ -111,6 +145,8 @@ fips-agents --version
 fips-agents --help
 fips-agents create --help
 fips-agents create mcp-server --help
+fips-agents generate --help
+fips-agents generate tool --help
 ```
 
 ### Create MCP Server
@@ -140,6 +176,168 @@ fips-agents create mcp-server my-server -t ~/projects
 fips-agents create mcp-server my-server --no-git
 ```
 
+### Generate Components
+
+The `generate` command group allows you to scaffold MCP components (tools, resources, prompts, middleware) in existing MCP server projects.
+
+**Important**: Run these commands from within your MCP server project directory.
+
+#### Generate Tool
+
+```bash
+fips-agents generate tool <name> [OPTIONS]
+```
+
+**Arguments:**
+- `name`: Tool name in snake_case (e.g., `search_documents`, `fetch_data`)
+
+**Options:**
+- `--description, -d TEXT`: Tool description
+- `--async/--sync`: Generate async or sync function (default: async)
+- `--with-context`: Include FastMCP Context parameter
+- `--with-auth`: Include authentication decorator
+- `--params PATH`: JSON file with parameter definitions
+- `--read-only`: Mark as read-only operation (default: true)
+- `--idempotent`: Mark as idempotent (default: true)
+- `--open-world`: Mark as open-world operation
+- `--return-type TEXT`: Return type annotation (default: str)
+- `--dry-run`: Show what would be generated without creating files
+
+**Examples:**
+
+```bash
+# Basic tool generation
+fips-agents generate tool search_documents --description "Search through documents"
+
+# Tool with context and authentication
+fips-agents generate tool fetch_user_data --description "Fetch user data" --with-context --with-auth
+
+# Tool with parameters from JSON file
+fips-agents generate tool advanced_search --params params.json
+
+# Sync tool with custom return type
+fips-agents generate tool process_data --sync --return-type "dict[str, Any]"
+
+# Dry run to preview
+fips-agents generate tool test_tool --description "Test" --dry-run
+```
+
+#### Generate Resource
+
+```bash
+fips-agents generate resource <name> [OPTIONS]
+```
+
+**Arguments:**
+- `name`: Resource name in snake_case (e.g., `config_data`, `user_profile`)
+
+**Options:**
+- `--description, -d TEXT`: Resource description
+- `--async/--sync`: Generate async or sync function (default: async)
+- `--with-context`: Include FastMCP Context parameter
+- `--uri TEXT`: Resource URI (default: `resource://<name>`)
+- `--mime-type TEXT`: MIME type for resource (default: text/plain)
+- `--dry-run`: Show what would be generated without creating files
+
+**Examples:**
+
+```bash
+# Basic resource
+fips-agents generate resource config_data --description "Application configuration"
+
+# Resource with custom URI
+fips-agents generate resource user_profile --uri "resource://users/{id}" --description "User profile data"
+
+# Resource with specific MIME type
+fips-agents generate resource json_config --mime-type "application/json"
+```
+
+#### Generate Prompt
+
+```bash
+fips-agents generate prompt <name> [OPTIONS]
+```
+
+**Arguments:**
+- `name`: Prompt name in snake_case (e.g., `code_review`, `summarize_text`)
+
+**Options:**
+- `--description, -d TEXT`: Prompt description
+- `--params PATH`: JSON file with parameter definitions
+- `--with-schema`: Include JSON schema in prompt
+- `--dry-run`: Show what would be generated without creating files
+
+**Examples:**
+
+```bash
+# Basic prompt
+fips-agents generate prompt code_review --description "Review code for best practices"
+
+# Prompt with parameters
+fips-agents generate prompt summarize_text --params params.json --with-schema
+```
+
+#### Generate Middleware
+
+```bash
+fips-agents generate middleware <name> [OPTIONS]
+```
+
+**Arguments:**
+- `name`: Middleware name in snake_case (e.g., `auth_middleware`, `rate_limiter`)
+
+**Options:**
+- `--description, -d TEXT`: Middleware description
+- `--async/--sync`: Generate async or sync function (default: async)
+- `--dry-run`: Show what would be generated without creating files
+
+**Examples:**
+
+```bash
+# Basic middleware
+fips-agents generate middleware auth_middleware --description "Authentication middleware"
+
+# Sync middleware
+fips-agents generate middleware rate_limiter --sync --description "Rate limiting middleware"
+```
+
+#### Parameters JSON Schema
+
+When using `--params` flag, provide a JSON file with parameter definitions:
+
+```json
+[
+  {
+    "name": "query",
+    "type": "str",
+    "description": "Search query",
+    "required": true,
+    "min_length": 1,
+    "max_length": 100
+  },
+  {
+    "name": "limit",
+    "type": "int",
+    "description": "Maximum results to return",
+    "required": false,
+    "default": 10,
+    "ge": 1,
+    "le": 100
+  }
+]
+```
+
+**Supported Types:**
+- `str`, `int`, `float`, `bool`
+- `list[str]`, `list[int]`, `list[float]`
+- `Optional[str]`, `Optional[int]`, `Optional[float]`, `Optional[bool]`
+
+**Pydantic Field Constraints:**
+- `min_length`, `max_length` (for strings)
+- `ge`, `le`, `gt`, `lt` (for numbers)
+- `pattern` (for regex validation on strings)
+- `default` (default value when optional)
+
 ## Project Name Requirements
 
 Project names must follow these rules:
@@ -249,7 +447,7 @@ fips-agents-cli/
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Git (for cloning templates and initializing repositories)
 
 ## Dependencies
@@ -258,6 +456,7 @@ fips-agents-cli/
 - **rich** (>=13.0.0): Terminal output formatting
 - **gitpython** (>=3.1.0): Git operations
 - **tomlkit** (>=0.12.0): TOML file manipulation
+- **jinja2** (>=3.1.2): Template rendering for component generation
 
 ## Contributing
 
@@ -295,6 +494,28 @@ If template cloning fails:
 - Verify the template repository is accessible: https://github.com/rdwj/mcp-server-template
 - Try again later if GitHub is experiencing issues
 
+### "Not in an MCP server project directory"
+
+When using `generate` commands:
+- Ensure you're running the command from within an MCP server project
+- Check that `pyproject.toml` exists with `fastmcp` dependency
+- If the project wasn't created with `fips-agents create mcp-server`, generator templates may be missing
+
+### "Component already exists"
+
+If you see this error:
+- Choose a different component name
+- Manually remove the existing component file from `src/<component-type>/`
+- Check the component type directory for existing files
+
+### Invalid component name
+
+Component names must:
+- Be valid Python identifiers (snake_case)
+- Not be Python keywords (`for`, `class`, etc.)
+- Start with a letter or underscore
+- Contain only letters, numbers, and underscores
+
 ## License
 
 MIT License - see LICENSE file for details
@@ -307,6 +528,23 @@ MIT License - see LICENSE file for details
 
 ## Changelog
 
+### Version 0.1.2
+
+- Documentation: Updated documentation and improved release management guidance
+- Automation: Added `/create-release` slash command for automated release workflow
+- Automation: Created `scripts/release.sh` for streamlined version management and tagging
+- Documentation: Added `RELEASE_CHECKLIST.md` with comprehensive release procedures
+
+### Version 0.1.1
+
+- Added `fips-agents generate` command group
+- Component generation: tools, resources, prompts, middleware
+- Jinja2-based template rendering
+- Parameter validation and JSON schema support
+- Auto-run pytest on generated components
+- Dry-run mode for previewing changes
+- Comprehensive error handling and validation
+
 ### Version 0.1.0 (MVP)
 
 - Initial release

fips_agents_cli-0.1.2.dist-info/RECORD

@@ -0,0 +1,18 @@
+fips_agents_cli/__init__.py,sha256=Jfo6y6T4HIQ-BeeF89w7F-F4BED63KyCIc1yoFGn9OM,167
+fips_agents_cli/__main__.py,sha256=rUeQY3jrV6hQVAI2IE0qZCcUnvXDMj5LiCjhlXsc9PQ,130
+fips_agents_cli/cli.py,sha256=c6ZSIfqZXTAfGc_2sKXanWDuWbxXTUjp4nSbl7yeDig,799
+fips_agents_cli/version.py,sha256=IWx_DJXC-x6jhTpUmUSr_yPgJMJaMDnt7gi9jml40BU,70
+fips_agents_cli/commands/__init__.py,sha256=AGxi2-Oc-gKE3sR9F39nIxwnzz-4bcfkkJzaP1qhMvU,40
+fips_agents_cli/commands/create.py,sha256=wWJZTa2NOoF40lnqIGKXKNcZT5jIZxInGk3CAkUfa3w,6372
+fips_agents_cli/commands/generate.py,sha256=hoPERkaYGlt-R79PRWnxE6vwNtWfun7SMtJN2zaOIKo,14113
+fips_agents_cli/tools/__init__.py,sha256=ah4OrYFuyQavuhwguFwFS0o-7ZLGIm5ZWWQK5ZTZZSs,47
+fips_agents_cli/tools/filesystem.py,sha256=1AOOJtkDSw-pqkuUJyVUbquuczpZBZMT4HLl3qCPB3k,3276
+fips_agents_cli/tools/generators.py,sha256=bwHKBzWkfJxug4YQXrkRQB_-BxR78kZqe46AjC7haHY,9372
+fips_agents_cli/tools/git.py,sha256=-z2EO7vNZhN6Vuzh34ZbqNteZE4vNnLG8oysgzhmypk,3042
+fips_agents_cli/tools/project.py,sha256=vgnctNgdRJJB14uqy7WM0bqpAoPoK_fZu16Io5Rn2hA,5699
+fips_agents_cli/tools/validation.py,sha256=3947i5UI46BmwBw4F0yLNdkWvkGJig8qH1nJzvQS6RA,5771
+fips_agents_cli-0.1.2.dist-info/METADATA,sha256=9vncWTElQE2__DYjak7QTKGvPrEdrD-IyxX5AjDQd9o,15514
+fips_agents_cli-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fips_agents_cli-0.1.2.dist-info/entry_points.txt,sha256=srO4LAGNp6zcB9zuPW1toLGPyLbcsad9YWsfNxgz20s,57
+fips_agents_cli-0.1.2.dist-info/licenses/LICENSE,sha256=kxsuNJY2W19dYjR8OstG1UT3RFCJKmtelxPMHMwXrck,1122
+fips_agents_cli-0.1.2.dist-info/RECORD,,

{fips_agents_cli-0.1.0.dist-info → fips_agents_cli-0.1.2.dist-info}/licenses/LICENSE

@@ -2,6 +2,8 @@ MIT License
 
 Copyright (c) 2025 Wes Jackson
 
+Note: Some code in this project was written with AI.
+
 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

fips_agents_cli-0.1.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-fips_agents_cli/__init__.py,sha256=Jfo6y6T4HIQ-BeeF89w7F-F4BED63KyCIc1yoFGn9OM,167
-fips_agents_cli/__main__.py,sha256=rUeQY3jrV6hQVAI2IE0qZCcUnvXDMj5LiCjhlXsc9PQ,130
-fips_agents_cli/cli.py,sha256=e2QGiAH73pHAjpdf7JdovyNZtc2nyb83LaVaLbLqS5o,718
-fips_agents_cli/version.py,sha256=EeROn-Cy9mXSPq-OrZ--hVR0oQvwMNqIyAgy4w-YowU,70
-fips_agents_cli/commands/__init__.py,sha256=AGxi2-Oc-gKE3sR9F39nIxwnzz-4bcfkkJzaP1qhMvU,40
-fips_agents_cli/commands/create.py,sha256=GvGm8VgsIfqZV_yIXXYzeV-nasLIwuD85_l831YjAho,6403
-fips_agents_cli/tools/__init__.py,sha256=ah4OrYFuyQavuhwguFwFS0o-7ZLGIm5ZWWQK5ZTZZSs,47
-fips_agents_cli/tools/filesystem.py,sha256=G9wzHrgQpoMw3z5EslsyEL91VLlUT6Cf5Rt80DtkwOw,3313
-fips_agents_cli/tools/git.py,sha256=-z2EO7vNZhN6Vuzh34ZbqNteZE4vNnLG8oysgzhmypk,3042
-fips_agents_cli/tools/project.py,sha256=d_qIhsEzPOM55ONSLzheTozXuyuiEEf9OG4hVXISAbk,5730
-fips_agents_cli-0.1.0.dist-info/METADATA,sha256=j3-wAEIftpKnjwj4BVKykYPQh4eDXGva_RNIKh55Qiw,8220
-fips_agents_cli-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fips_agents_cli-0.1.0.dist-info/entry_points.txt,sha256=srO4LAGNp6zcB9zuPW1toLGPyLbcsad9YWsfNxgz20s,57
-fips_agents_cli-0.1.0.dist-info/licenses/LICENSE,sha256=dQJIqi2t9SinZu0yALTYJ8juzosu29KPbjU8WhyboRc,1068
-fips_agents_cli-0.1.0.dist-info/RECORD,,