fips-agents-cli 0.8.2__tar.gz → 0.9.1__tar.gz

{fips_agents_cli-0.8.2 → fips_agents_cli-0.9.1}/CLAUDE.md

@@ -6,7 +6,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **fips-agents-cli** is a Python-based CLI tool for scaffolding FIPS-compliant AI agent projects. It scaffolds MCP (Model Context Protocol) servers and AI agent projects from production-ready templates, customizes them for new projects, and prepares them for immediate development use.
 
-**Current Status:** Scaffolding commands implemented: `create mcp-server`, `create agent`, `create gateway`, `create ui`, `create sandbox`, `create model-car`. Post-scaffolding commands: `generate` (tool, resource, prompt, middleware), `patch` (check, generators, core, docs, build, all), `add` (code-executor), `vendor`. Note: `create workflow` exists in code but is not yet working.
+**Current Status:** Scaffolding commands implemented: `create mcp-server`, `create agent`, `create gateway`, `create ui`, `create sandbox`, `create model-car`. Post-scaffolding commands: `generate` (tool, resource, prompt, middleware), `patch` (check, all + type-specific category subcommands — see below), `add` (code-executor), `vendor`. Note: `create workflow` exists in code but is not yet working.
+
+The `patch` command is type-aware via `template.type` in `.template-info`:
+- **MCP server** projects expose `patch generators | core | docs | build`.
+- **Agent / workflow** projects expose `patch chart | docs | build | claude`.
+Running an MCP-only subcommand inside an agent project (or vice versa) exits with a clear "available categories" error. `patch check` and `patch all` work for any supported type.
 
 ## Development Commands
 

{fips_agents_cli-0.8.2 → fips_agents_cli-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fips-agents-cli
-Version: 0.8.2
+Version: 0.9.1
 Summary: CLI tool for creating and managing FIPS-compliant AI agent projects
 Project-URL: Homepage, https://github.com/fips-agents/fips-agents-cli
 Project-URL: Repository, https://github.com/fips-agents/fips-agents-cli
@@ -557,7 +557,9 @@ When using `--params` with `generate tool` or `generate prompt`, provide a JSON
 
 ### Patch Commands
 
-The `patch` command group updates files in existing MCP server projects from the upstream template repository without overwriting your custom code. It shows interactive diffs for files that may contain customizations.
+The `patch` command group updates files in existing projects from the upstream template repository without overwriting your custom code. It shows interactive diffs for files that may contain customizations.
+
+Supported project types: **MCP server**, **agent**, **workflow**. The available category subcommands depend on the project type — `patch` reads `template.type` from `.template-info` and surfaces a clear error if you run a category that doesn't apply (e.g. `patch generators` inside an agent project).
 
 Run these commands from within your project directory.
 
@@ -567,47 +569,35 @@ Run these commands from within your project directory.
 fips-agents patch check
 ```
 
-Check for available template updates. Shows what files have changed in the template since your project was created, organized by category.
-
-#### `patch generators`
-
-```bash
-fips-agents patch generators [--dry-run]
-```
-
-Update code generator templates (Jinja2 templates in `.fips-agents-cli/generators/`).
+Check for available template updates. Shows what files have changed in the template since your project was created, organized by category. Works for any supported project type.
 
-#### `patch core`
-
-```bash
-fips-agents patch core [--dry-run]
-```
-
-Update core infrastructure files (loaders, server bootstrap).
-
-#### `patch docs`
+#### `patch all`
 
 ```bash
-fips-agents patch docs [--dry-run]
+fips-agents patch all [--dry-run] [--skip-confirmation]
 ```
 
-Update documentation files and examples.
-
-#### `patch build`
+Update every category that applies to the current project type. Prompts for confirmation before starting unless `--skip-confirmation` is passed.
 
-```bash
-fips-agents patch build [--dry-run]
-```
+#### MCP server categories
 
-Update build and deployment files (Makefile, Containerfile).
+| Subcommand           | Patches                                                                  |
+|----------------------|--------------------------------------------------------------------------|
+| `patch generators`   | Jinja2 templates in `.fips-agents-cli/generators/`                       |
+| `patch core`         | Core infrastructure (loaders, server bootstrap)                          |
+| `patch docs`         | Documentation files and examples                                         |
+| `patch build`        | Build and deployment files (Makefile, Containerfile)                     |
 
-#### `patch all`
+#### Agent / workflow categories
 
-```bash
-fips-agents patch all [--dry-run] [--skip-confirmation]
-```
+| Subcommand     | Patches                                                                       |
+|----------------|-------------------------------------------------------------------------------|
+| `patch chart`  | Helm chart templates (`chart/templates/**`, `chart/Chart.yaml`)                |
+| `patch docs`   | `CLAUDE.md`, `AGENTS.md`, `docs/**`                                            |
+| `patch build`  | `Makefile`, `Containerfile`, `deploy.sh`, `redeploy.sh`                        |
+| `patch claude` | Claude Code slash commands shipped with the template (`.claude/commands/**`)   |
 
-Update all patchable file categories at once. Prompts for confirmation before starting unless `--skip-confirmation` is passed.
+User-customized files are never patched: for MCP this means `src/tools/`, `src/resources/`, `src/prompts/`, `src/middleware/`, `pyproject.toml`, etc. For agent/workflow it means `src/agent.py`, `agent.yaml`, `chart/values.yaml`, `src/fipsagents/**` (managed by `fips-agents vendor`), and `pyproject.toml`.
 
 All patch subcommands (except `check`) accept `--dry-run` to preview changes without modifying files.
 
@@ -946,6 +936,22 @@ MIT License - see LICENSE file for details
 
 ## Changelog
 
+### Version 0.9.1
+
+- Chore: Realign `tests/` formatting with black 26.3.1 to match CI (v0.9.0's release pipeline failed because local black 24.x produced different output than CI's 26.x; no functional change)
+
+### Version 0.9.0
+
+- Feature: `fips-agents patch` now supports agent and workflow projects in addition to MCP servers (#12)
+- Feature: New `patch chart` and `patch claude` subcommands for agent/workflow projects (#15)
+- Feature: `.template-info` now records `template.type` and (for monorepo templates) `template.subdir` so post-scaffolding commands can route by project type (#13)
+- Feature: New `find_fips_project_root()` walks up to `.template-info`, replacing the MCP-only fastmcp-dependency probe in patch commands (#14)
+- Improvement: `_clone_template_for_patch()` resolves the monorepo subdir during patching, so glob/compare runs against `templates/agent-loop/` instead of the monorepo root (#16)
+- Improvement: Running an MCP-only subcommand inside an agent project (or vice versa) now exits with a clear "available categories" error
+- Improvement: `patch all` enumerates the project's actual category set instead of assuming MCP layout
+- Backwards compat: Projects scaffolded before `template.type` existed default to `mcp-server`; no migration required
+- Tests: 20 new tests in `tests/test_patch.py` covering the type-aware patch flow end-to-end against a fake-scaffolded agent project
+
 ### Version 0.8.2
 
 - Test: New `TestGenerateMiddlewareRealTemplate` integration test renders the real v3.x middleware Jinja2 template against each `--hook-type` and the no-flag case, with templates committed under `tests/fixtures/middleware_template/` so the suite runs offline (#3)

{fips_agents_cli-0.8.2 → fips_agents_cli-0.9.1}/README.md

@@ -524,7 +524,9 @@ When using `--params` with `generate tool` or `generate prompt`, provide a JSON
 
 ### Patch Commands
 
-The `patch` command group updates files in existing MCP server projects from the upstream template repository without overwriting your custom code. It shows interactive diffs for files that may contain customizations.
+The `patch` command group updates files in existing projects from the upstream template repository without overwriting your custom code. It shows interactive diffs for files that may contain customizations.
+
+Supported project types: **MCP server**, **agent**, **workflow**. The available category subcommands depend on the project type — `patch` reads `template.type` from `.template-info` and surfaces a clear error if you run a category that doesn't apply (e.g. `patch generators` inside an agent project).
 
 Run these commands from within your project directory.
 
@@ -534,47 +536,35 @@ Run these commands from within your project directory.
 fips-agents patch check
 ```
 
-Check for available template updates. Shows what files have changed in the template since your project was created, organized by category.
-
-#### `patch generators`
-
-```bash
-fips-agents patch generators [--dry-run]
-```
-
-Update code generator templates (Jinja2 templates in `.fips-agents-cli/generators/`).
+Check for available template updates. Shows what files have changed in the template since your project was created, organized by category. Works for any supported project type.
 
-#### `patch core`
-
-```bash
-fips-agents patch core [--dry-run]
-```
-
-Update core infrastructure files (loaders, server bootstrap).
-
-#### `patch docs`
+#### `patch all`
 
 ```bash
-fips-agents patch docs [--dry-run]
+fips-agents patch all [--dry-run] [--skip-confirmation]
 ```
 
-Update documentation files and examples.
-
-#### `patch build`
+Update every category that applies to the current project type. Prompts for confirmation before starting unless `--skip-confirmation` is passed.
 
-```bash
-fips-agents patch build [--dry-run]
-```
+#### MCP server categories
 
-Update build and deployment files (Makefile, Containerfile).
+| Subcommand           | Patches                                                                  |
+|----------------------|--------------------------------------------------------------------------|
+| `patch generators`   | Jinja2 templates in `.fips-agents-cli/generators/`                       |
+| `patch core`         | Core infrastructure (loaders, server bootstrap)                          |
+| `patch docs`         | Documentation files and examples                                         |
+| `patch build`        | Build and deployment files (Makefile, Containerfile)                     |
 
-#### `patch all`
+#### Agent / workflow categories
 
-```bash
-fips-agents patch all [--dry-run] [--skip-confirmation]
-```
+| Subcommand     | Patches                                                                       |
+|----------------|-------------------------------------------------------------------------------|
+| `patch chart`  | Helm chart templates (`chart/templates/**`, `chart/Chart.yaml`)                |
+| `patch docs`   | `CLAUDE.md`, `AGENTS.md`, `docs/**`                                            |
+| `patch build`  | `Makefile`, `Containerfile`, `deploy.sh`, `redeploy.sh`                        |
+| `patch claude` | Claude Code slash commands shipped with the template (`.claude/commands/**`)   |
 
-Update all patchable file categories at once. Prompts for confirmation before starting unless `--skip-confirmation` is passed.
+User-customized files are never patched: for MCP this means `src/tools/`, `src/resources/`, `src/prompts/`, `src/middleware/`, `pyproject.toml`, etc. For agent/workflow it means `src/agent.py`, `agent.yaml`, `chart/values.yaml`, `src/fipsagents/**` (managed by `fips-agents vendor`), and `pyproject.toml`.
 
 All patch subcommands (except `check`) accept `--dry-run` to preview changes without modifying files.
 
@@ -913,6 +903,22 @@ MIT License - see LICENSE file for details
 
 ## Changelog
 
+### Version 0.9.1
+
+- Chore: Realign `tests/` formatting with black 26.3.1 to match CI (v0.9.0's release pipeline failed because local black 24.x produced different output than CI's 26.x; no functional change)
+
+### Version 0.9.0
+
+- Feature: `fips-agents patch` now supports agent and workflow projects in addition to MCP servers (#12)
+- Feature: New `patch chart` and `patch claude` subcommands for agent/workflow projects (#15)
+- Feature: `.template-info` now records `template.type` and (for monorepo templates) `template.subdir` so post-scaffolding commands can route by project type (#13)
+- Feature: New `find_fips_project_root()` walks up to `.template-info`, replacing the MCP-only fastmcp-dependency probe in patch commands (#14)
+- Improvement: `_clone_template_for_patch()` resolves the monorepo subdir during patching, so glob/compare runs against `templates/agent-loop/` instead of the monorepo root (#16)
+- Improvement: Running an MCP-only subcommand inside an agent project (or vice versa) now exits with a clear "available categories" error
+- Improvement: `patch all` enumerates the project's actual category set instead of assuming MCP layout
+- Backwards compat: Projects scaffolded before `template.type` existed default to `mcp-server`; no migration required
+- Tests: 20 new tests in `tests/test_patch.py` covering the type-aware patch flow end-to-end against a fake-scaffolded agent project
+
 ### Version 0.8.2
 
 - Test: New `TestGenerateMiddlewareRealTemplate` integration test renders the real v3.x middleware Jinja2 template against each `--hook-type` and the no-flag case, with templates committed under `tests/fixtures/middleware_template/` so the suite runs offline (#3)

{fips_agents_cli-0.8.2 → fips_agents_cli-0.9.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fips-agents-cli"
-version = "0.8.2"
+version = "0.9.1"
 description = "CLI tool for creating and managing FIPS-compliant AI agent projects"
 readme = "README.md"
 requires-python = ">=3.10"

{fips_agents_cli-0.8.2 → fips_agents_cli-0.9.1}/src/fips_agents_cli/commands/create.py

@@ -263,6 +263,7 @@ def mcp_server(
                         project_name,
                         MCP_SERVER_TEMPLATE_URL,
                         template_commit,
+                        template_type="mcp-server",
                         github_repo=github_repo,
                         github_url=github_url,
                     )
@@ -545,6 +546,8 @@ def agent(
                         project_name,
                         AGENT_TEMPLATE_URL,
                         template_commit,
+                        template_type="agent",
+                        template_subdir=AGENT_TEMPLATE_SUBDIR,
                         github_repo=github_repo,
                         github_url=github_url,
                     )
@@ -804,6 +807,8 @@ def workflow(
                         project_name,
                         AGENT_TEMPLATE_URL,
                         template_commit,
+                        template_type="workflow",
+                        template_subdir=WORKFLOW_TEMPLATE_SUBDIR,
                         github_repo=github_repo,
                         github_url=github_url,
                     )
@@ -1062,6 +1067,7 @@ def gateway(
                         project_name,
                         GATEWAY_TEMPLATE_URL,
                         template_commit,
+                        template_type="gateway",
                         github_repo=github_repo,
                         github_url=github_url,
                     )
@@ -1320,6 +1326,7 @@ def ui(
                         project_name,
                         UI_TEMPLATE_URL,
                         template_commit,
+                        template_type="ui",
                         github_repo=github_repo,
                         github_url=github_url,
                     )
@@ -1577,6 +1584,7 @@ def sandbox(
                         project_name,
                         SANDBOX_TEMPLATE_URL,
                         template_commit,
+                        template_type="sandbox",
                         github_repo=github_repo,
                         github_url=github_url,
                     )

{fips_agents_cli-0.8.2 → fips_agents_cli-0.9.1}/src/fips_agents_cli/commands/patch.py

@@ -10,10 +10,10 @@ from rich.table import Table
 from fips_agents_cli.tools.patching import (
     check_for_updates,
     get_available_categories,
-    get_template_info,
+    get_project_type,
     patch_category,
 )
-from fips_agents_cli.tools.validation import find_project_root
+from fips_agents_cli.tools.validation import find_fips_project_root
 
 console = Console()
 
@@ -33,23 +33,14 @@ def check():
     """
     console.print("\n[bold cyan]Checking for Template Updates[/bold cyan]\n")
 
-    # Find project root
-    project_root = find_project_root()
-    if not project_root:
+    found = find_fips_project_root()
+    if not found:
         console.print(
             "[red]✗[/red] Not in a project directory\n"
             "[yellow]Hint:[/yellow] Run this command from within a project created by fips-agents"
         )
         sys.exit(1)
-
-    # Get template info
-    template_info = get_template_info(project_root)
-    if not template_info:
-        console.print(
-            "[red]✗[/red] No template metadata found\n"
-            "[yellow]Hint:[/yellow] This project may not have been created by fips-agents-cli"
-        )
-        sys.exit(1)
+    project_root, template_info = found
 
     console.print("[green]✓[/green] Project created from template")
     console.print(f"  Template: {template_info['template']['url']}")
@@ -134,6 +125,37 @@ def build(dry_run: bool):
     _patch_category("build", dry_run)
 
 
+@patch.command("chart")
+@click.option(
+    "--dry-run",
+    is_flag=True,
+    help="Show what would be updated without making changes",
+)
+def chart(dry_run: bool):
+    """
+    Update Helm chart templates (agent / workflow projects only).
+
+    Patches files under chart/templates/ and chart/Chart.yaml.
+    chart/values.yaml is never patched (user-customized).
+    """
+    _patch_category("chart", dry_run)
+
+
+@patch.command("claude")
+@click.option(
+    "--dry-run",
+    is_flag=True,
+    help="Show what would be updated without making changes",
+)
+def claude(dry_run: bool):
+    """
+    Update Claude Code slash commands (agent / workflow projects only).
+
+    Patches files under .claude/commands/ that ship with the template.
+    """
+    _patch_category("claude", dry_run)
+
+
 @patch.command("all")
 @click.option(
     "--dry-run",
@@ -153,13 +175,23 @@ def all_categories(dry_run: bool, skip_confirmation: bool):
     """
     console.print("\n[bold cyan]Patching All Categories[/bold cyan]\n")
 
+    found = find_fips_project_root()
+    if not found:
+        console.print(
+            "[red]✗[/red] Not in a project directory\n"
+            "[yellow]Hint:[/yellow] Run this command from within a project created by fips-agents"
+        )
+        sys.exit(1)
+    _, template_info = found
+    project_type = get_project_type(template_info)
+
     if not skip_confirmation:
         confirm = click.confirm("This will update multiple files. Continue?", default=True)
         if not confirm:
             console.print("[yellow]Cancelled[/yellow]")
             sys.exit(0)
 
-    categories = get_available_categories()
+    categories = get_available_categories(project_type)
     for category in categories:
         console.print(f"\n[bold]Processing category: {category}[/bold]")
         _patch_category(category, dry_run, skip_confirmation=skip_confirmation)
@@ -174,23 +206,14 @@ def _patch_category(category: str, dry_run: bool, skip_confirmation: bool = Fals
         dry_run: If True, only show what would be changed
         skip_confirmation: If True, don't ask for confirmation
     """
-    # Find project root
-    project_root = find_project_root()
-    if not project_root:
+    found = find_fips_project_root()
+    if not found:
         console.print(
             "[red]✗[/red] Not in a project directory\n"
             "[yellow]Hint:[/yellow] Run this command from within a project created by fips-agents"
         )
         sys.exit(1)
-
-    # Get template info
-    template_info = get_template_info(project_root)
-    if not template_info:
-        console.print(
-            "[red]✗[/red] No template metadata found\n"
-            "[yellow]Hint:[/yellow] This project may not have been created by fips-agents-cli"
-        )
-        sys.exit(1)
+    project_root, template_info = found
 
     # Perform patch
     success, message = patch_category(