csrd-utils 0.5.1__tar.gz → 0.5.2__tar.gz

csrd_utils-0.5.2/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: csrd-utils
+Version: 0.5.2
+Summary: CLI utilities for csrd service generation and feature augmentation
+Project-URL: Repository, https://github.com/csrd-api/fastapi-common
+Project-URL: Documentation, https://github.com/csrd-api/fastapi-common/tree/main/packages/utils
+Project-URL: Changelog, https://github.com/csrd-api/fastapi-common/blob/main/CHANGELOG.md
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: cookiecutter<3,>=2.6
+Requires-Dist: pydantic<3,>=2.6
+Requires-Dist: pyyaml<7,>=6
+Requires-Dist: ruamel-yaml<1,>=0.18
+Description-Content-Type: text/markdown
+
+# csrd-utils
+
+CLI and runtime helpers for generating csrd services and augmenting existing services with optional features.
+
+## Install
+
+```bash
+pip install "csrd-utils @ git+https://github.com/csrd-api/fastapi-common.git#subdirectory=packages/utils"
+```
+
+## CLI
+
+```bash
+csrd --help
+csrd --version
+
+# Workspace-level generation (compose-based)
+csrd generate                                     # interactive menu (context-aware)
+csrd generate workspace --name my-ws              # create empty workspace
+csrd generate preset --name my-ws                 # create workspace from preset
+csrd generate add-service --name inventory        # add service to current workspace
+csrd generate rename-service --service-name old-service --new-name new-service
+csrd generate remove-service --service-name old   # remove service from spec
+csrd generate add-infra --infra-type postgres     # add infra to workspace
+csrd generate remove-infra --infra-type postgres  # remove infra from workspace
+csrd generate add-augment                         # interactive augment selection
+csrd generate list-augments                       # list available augments
+
+# Feature augmentation
+csrd feature list
+csrd feature plan workers --service .
+csrd feature plan workers --service . --json
+csrd feature add workers --service .
+
+# Diagnostics
+csrd doctor --service .
+csrd audit                                        # workspace-aware: scans all services
+csrd audit --service .                            # explicitly audit one service path
+
+# Shell completion
+csrd completion bash                              # print bash completion script
+csrd completion install                           # install to ~/.local/share/bash-completion/
+csrd completion uninstall                         # remove installed completion
+```
+
+`feature plan --json` is useful for CI or tooling wrappers.
+
+### Bash tab completion
+
+Install completion (one-time, persists across shells):
+
+```bash
+csrd completion install
+```
+
+This writes a completion script to `~/.local/share/bash-completion/completions/csrd`,
+which bash auto-loads — no `.bashrc` edit needed. To remove: `csrd completion uninstall`.
+
+Manual alternative:
+
+```bash
+source <(csrd completion bash)
+```
+
+### Non-TTY mode
+
+Set `CSRD_NO_TTY=1` to force numbered-fallback prompts instead of the
+arrow-key TUI. Useful for manual testing or piping input:
+
+```bash
+CSRD_NO_TTY=1 csrd generate
+```
+
+### Interactive generation behavior
+
+- `csrd generate` shows a context-aware menu (workspace actions when inside a workspace, workspace creation otherwise).
+- Services, augments, and infra are managed via `csrd-compose.yaml` (the workspace spec).
+- `csrd generate rename-service` renames the service in the spec, renames `src/`, `tests/`, and `Dockerfile.*`, and rewrites Python imports and string references.
+- All yes/no prompts default to `No` (`y/N`).
+
+## Typical workflow
+
+```bash
+# 0) Create a workspace and add services
+csrd generate workspace --name local-dev
+cd local-dev
+csrd generate add-service --name inventory --features database --port 8081
+csrd generate add-service --name pricing --port 8082
+
+# 1) Verify service compatibility
+csrd doctor --service .
+
+# 1b) Audit for weak/insecure defaults
+csrd audit
+
+# 2) Inspect available bundled features
+csrd feature list
+
+# 3) Dry-run a feature
+csrd feature plan workers --service .
+
+# 4) Apply feature files/merges
+csrd feature add workers --service .
+
+# 5) Rename a service
+csrd generate rename-service --service-name pricing-service --new-name billing-service
+```
+
+## Bundled assets
+
+- `features/workers/` feature manifests and fragments
+- `templates/service/` template starter
+
+## Python API
+
+```python
+from pathlib import Path
+from csrd_utils import ServiceAugmentor
+from csrd_utils.resources import features_path
+
+with features_path() as feature_lib:
+    augmentor = ServiceAugmentor(Path("."), feature_lib)
+    ok, changes = augmentor.add_feature("workers", plan=True)
+```
+
+## Documentation
+
+- `docs/CLI_REFERENCE.md` - full command/flag reference
+- `docs/FEATURES.md` - bundled feature catalog and behavior
+- `docs/FUTURE_WORK.md` - remaining provider-specific CI wiring work (Phase 5B)
+- `docs/AGENT_SMOKE_TESTS.md` - copy/paste validation flow for clean workspaces
+- `docs/COMMAND_MATRIX.yaml` - machine-readable command matrix for automation
+- `AGENTS.md` - package-local rules for autonomous agents
+
+## CLI-only agent mode
+
+If an agent can only see the installed CLI (not source files), use this exploration sequence:
+
+```bash
+csrd --help
+csrd generate --help
+csrd feature --help
+csrd doctor --help
+csrd audit --help
+csrd completion --help
+csrd feature list
+csrd generate list-augments
+```
+
+Then run a clean smoke flow:
+
+```bash
+mkdir -p /tmp/csrd-smoke && cd /tmp/csrd-smoke
+csrd generate workspace --name ws
+cd ws
+csrd generate add-service --name demo-svc --port 8080
+csrd doctor --service .
+csrd audit
+csrd feature plan workers --service .
+csrd feature add workers --service .
+csrd generate rename-service --service-name demo-svc-service --new-name renamed-svc
+```

csrd_utils-0.5.2/README.md

@@ -0,0 +1,162 @@
+# csrd-utils
+
+CLI and runtime helpers for generating csrd services and augmenting existing services with optional features.
+
+## Install
+
+```bash
+pip install "csrd-utils @ git+https://github.com/csrd-api/fastapi-common.git#subdirectory=packages/utils"
+```
+
+## CLI
+
+```bash
+csrd --help
+csrd --version
+
+# Workspace-level generation (compose-based)
+csrd generate                                     # interactive menu (context-aware)
+csrd generate workspace --name my-ws              # create empty workspace
+csrd generate preset --name my-ws                 # create workspace from preset
+csrd generate add-service --name inventory        # add service to current workspace
+csrd generate rename-service --service-name old-service --new-name new-service
+csrd generate remove-service --service-name old   # remove service from spec
+csrd generate add-infra --infra-type postgres     # add infra to workspace
+csrd generate remove-infra --infra-type postgres  # remove infra from workspace
+csrd generate add-augment                         # interactive augment selection
+csrd generate list-augments                       # list available augments
+
+# Feature augmentation
+csrd feature list
+csrd feature plan workers --service .
+csrd feature plan workers --service . --json
+csrd feature add workers --service .
+
+# Diagnostics
+csrd doctor --service .
+csrd audit                                        # workspace-aware: scans all services
+csrd audit --service .                            # explicitly audit one service path
+
+# Shell completion
+csrd completion bash                              # print bash completion script
+csrd completion install                           # install to ~/.local/share/bash-completion/
+csrd completion uninstall                         # remove installed completion
+```
+
+`feature plan --json` is useful for CI or tooling wrappers.
+
+### Bash tab completion
+
+Install completion (one-time, persists across shells):
+
+```bash
+csrd completion install
+```
+
+This writes a completion script to `~/.local/share/bash-completion/completions/csrd`,
+which bash auto-loads — no `.bashrc` edit needed. To remove: `csrd completion uninstall`.
+
+Manual alternative:
+
+```bash
+source <(csrd completion bash)
+```
+
+### Non-TTY mode
+
+Set `CSRD_NO_TTY=1` to force numbered-fallback prompts instead of the
+arrow-key TUI. Useful for manual testing or piping input:
+
+```bash
+CSRD_NO_TTY=1 csrd generate
+```
+
+### Interactive generation behavior
+
+- `csrd generate` shows a context-aware menu (workspace actions when inside a workspace, workspace creation otherwise).
+- Services, augments, and infra are managed via `csrd-compose.yaml` (the workspace spec).
+- `csrd generate rename-service` renames the service in the spec, renames `src/`, `tests/`, and `Dockerfile.*`, and rewrites Python imports and string references.
+- All yes/no prompts default to `No` (`y/N`).
+
+## Typical workflow
+
+```bash
+# 0) Create a workspace and add services
+csrd generate workspace --name local-dev
+cd local-dev
+csrd generate add-service --name inventory --features database --port 8081
+csrd generate add-service --name pricing --port 8082
+
+# 1) Verify service compatibility
+csrd doctor --service .
+
+# 1b) Audit for weak/insecure defaults
+csrd audit
+
+# 2) Inspect available bundled features
+csrd feature list
+
+# 3) Dry-run a feature
+csrd feature plan workers --service .
+
+# 4) Apply feature files/merges
+csrd feature add workers --service .
+
+# 5) Rename a service
+csrd generate rename-service --service-name pricing-service --new-name billing-service
+```
+
+## Bundled assets
+
+- `features/workers/` feature manifests and fragments
+- `templates/service/` template starter
+
+## Python API
+
+```python
+from pathlib import Path
+from csrd_utils import ServiceAugmentor
+from csrd_utils.resources import features_path
+
+with features_path() as feature_lib:
+    augmentor = ServiceAugmentor(Path("."), feature_lib)
+    ok, changes = augmentor.add_feature("workers", plan=True)
+```
+
+## Documentation
+
+- `docs/CLI_REFERENCE.md` - full command/flag reference
+- `docs/FEATURES.md` - bundled feature catalog and behavior
+- `docs/FUTURE_WORK.md` - remaining provider-specific CI wiring work (Phase 5B)
+- `docs/AGENT_SMOKE_TESTS.md` - copy/paste validation flow for clean workspaces
+- `docs/COMMAND_MATRIX.yaml` - machine-readable command matrix for automation
+- `AGENTS.md` - package-local rules for autonomous agents
+
+## CLI-only agent mode
+
+If an agent can only see the installed CLI (not source files), use this exploration sequence:
+
+```bash
+csrd --help
+csrd generate --help
+csrd feature --help
+csrd doctor --help
+csrd audit --help
+csrd completion --help
+csrd feature list
+csrd generate list-augments
+```
+
+Then run a clean smoke flow:
+
+```bash
+mkdir -p /tmp/csrd-smoke && cd /tmp/csrd-smoke
+csrd generate workspace --name ws
+cd ws
+csrd generate add-service --name demo-svc --port 8080
+csrd doctor --service .
+csrd audit
+csrd feature plan workers --service .
+csrd feature add workers --service .
+csrd generate rename-service --service-name demo-svc-service --new-name renamed-svc
+```

{csrd_utils-0.5.1 → csrd_utils-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "csrd-utils"
-version = "0.5.1"
+version = "0.5.2"
 description = "CLI utilities for csrd service generation and feature augmentation"
 license = { text = "MIT" }
 requires-python = ">=3.12"

{csrd_utils-0.5.1 → csrd_utils-0.5.2}/src/csrd_utils/compose/__init__.py

@@ -125,7 +125,6 @@ __all__ = [
     "remove_service_augment",
     "rename_service",
     "render_workspace",
-    "render_workspace",
     "save_spec",
     "save_yaml",
     "scaffold_augment",

{csrd_utils-0.5.1 → csrd_utils-0.5.2}/src/csrd_utils/compose/renderer.py

@@ -307,14 +307,29 @@ def _render_env_example(spec: ComposeSpec) -> str:
 def _render_readme(spec: ComposeSpec) -> str:
     """Build a starter ``README.md`` for the workspace."""
 
+    svc_lines = ""
+    if spec.services:
+        svc_list = ", ".join(f"`{s.name}` (:{s.port})" for s in spec.services)
+        svc_lines = f"\n## Services\n\n{svc_list}\n"
+
     return (
         f"# {spec.workspace.name}\n\n"
-        "Generated by csrd compose.\n\n"
-        "## Next steps\n\n"
+        "Generated by [csrd](https://github.com/csrd-api/fastapi-common).\n"
+        f"{svc_lines}\n"
+        "## Quick start\n\n"
+        "```bash\n"
+        "docker compose up --build\n"
+        "```\n\n"
+        "## Workspace commands\n\n"
         "```bash\n"
-        "csrd compose validate\n"
-        "csrd compose plan\n"
-        "```\n"
+        "csrd generate                # interactive menu\n"
+        "csrd generate add-service    # add a service\n"
+        "csrd generate rename-service # rename a service\n"
+        "csrd doctor                  # validate service layout\n"
+        "csrd audit                   # scan for insecure defaults\n"
+        "csrd compose validate        # validate csrd-compose.yaml\n"
+        "```\n\n"
+        "Edit `csrd-compose.yaml` then run `csrd compose apply` to re-render.\n"
     )
 
 
@@ -553,11 +568,20 @@ csrd compose apply
 
 # Or use the interactive menu:
 csrd generate
+
+# Rename a service (updates spec, directories, code references):
+csrd generate rename-service
+
+# Install tab completion (one-time):
+csrd completion install
 ```
 
 Rendered files are regenerated from the spec.  Scaffolded files (views,
 repositories, services, dependencies) are never overwritten — your
 custom code is safe.
+
+Set `CSRD_NO_TTY=1` to force numbered-fallback prompts instead of the
+arrow-key TUI (useful for scripting or CI).
 """
 
 

csrd_utils-0.5.1/PKG-INFO

@@ -1,178 +0,0 @@
-Metadata-Version: 2.4
-Name: csrd-utils
-Version: 0.5.1
-Summary: CLI utilities for csrd service generation and feature augmentation
-Project-URL: Repository, https://github.com/csrd-api/fastapi-common
-Project-URL: Documentation, https://github.com/csrd-api/fastapi-common/tree/main/packages/utils
-Project-URL: Changelog, https://github.com/csrd-api/fastapi-common/blob/main/CHANGELOG.md
-License: MIT
-Requires-Python: >=3.12
-Requires-Dist: cookiecutter<3,>=2.6
-Requires-Dist: pydantic<3,>=2.6
-Requires-Dist: pyyaml<7,>=6
-Requires-Dist: ruamel-yaml<1,>=0.18
-Description-Content-Type: text/markdown
-
-# csrd-utils
-
-CLI and runtime helpers for generating csrd services and augmenting existing services with optional features.
-
-## Install
-
-```bash
-pip install "csrd-utils @ git+https://github.com/csrd-api/fastapi-common.git#subdirectory=packages/utils"
-```
-
-## CLI
-
-```bash
-csrd --help
-csrd --version
-csrd new workspace                                # create workspace, then choose none/service/cluster
-csrd new service                                  # requires workspace; prompts to create one if missing
-csrd new service --interactive --name items       # pre-fills name prompt with 'items'
-csrd new service --name inventory --no-interactive --output ./my-workspace
-csrd new service --name pricing --output ./my-workspace --no-interactive
-csrd new cluster --spec ./cluster.yaml --output ./my-workspace
-csrd new cluster                                  # requires workspace; interactive mode can offer to create one
-csrd feature list
-csrd feature plan workers --service .
-csrd feature plan workers --service . --json
-csrd feature add workers --service .
-csrd doctor --service .
-csrd audit                                          # if cwd is workspace, audits all services
-csrd audit --service .                              # explicitly audit one service path
-csrd completion bash                                # print bash completion script
-```
-
-`feature plan --json` is useful for CI or tooling wrappers.
-
-### Bash tab completion
-
-Enable command/subcommand completion in bash:
-
-```bash
-source <(csrd completion bash)
-```
-
-Then examples like `csrd ne<TAB>` and `csrd new wor<TAB>` complete to `new` and `workspace`.
-
-### Workspace extraction command
-
-Service extraction into a sibling workspace is supported:
-
-```bash
-csrd workspace extract-service --service ./source-ws/src/pricing --target-workspace ../pricing-ws --mode copy
-csrd workspace extract-service --service ./source-ws/src/pricing --target-workspace ../pricing-ws --mode move
-csrd workspace extract-service --service ./source-ws/src/pricing --target-workspace ../pricing-ws --dry-run --json
-```
-
-Use extraction when service ownership diverges, release cadence becomes independent,
-or workspace orchestration starts coupling unrelated deployments.
-
-Manual fallback remains available if needed:
-
-```bash
-csrd new workspace --name pricing-ws --output .. --generate none
-cp -a ./source-ws/src/pricing ../pricing-ws/src/pricing
-cd ../pricing-ws
-csrd new cluster --spec ./.csrd/cluster.yaml --output . --force
-```
-
-### Interactive generation behavior
-
-- `csrd new service` and `csrd new cluster` are workspace-first commands.
-- If a workspace marker is missing in the selected output path, interactive flows ask to create one and continue.
-- Non-interactive generation errors when no workspace marker is present.
-- Workspace cluster source of truth is persisted at `.csrd/cluster.yaml`.
-- If `.csrd/cluster.yaml` already exists, `csrd new service` appends the generated service and refreshes scaffold files (`docker-compose.yml`, `.env.example`, `README.md`, `smoke.sh`). Service source directories and running containers are never touched.
-- If `.csrd/cluster.yaml` is missing, `csrd new service` bootstraps `.csrd/cluster.yaml` and writes initial cluster scaffold files.
-- `csrd new service` runs a compact interactive flow by default (core prompts 1-6), then asks whether to show advanced options.
-- `csrd new workspace` creates a workspace directory and prompts whether to generate `none`, `service`, or `cluster` immediately.
-- In compact mode, advanced options are hidden by default.
-- `csrd new service --interactive` runs the full verbose interactive flow.
-- Passing `--name <value>` in interactive mode uses that value as the name prompt default.
-- You can still overwrite the default by entering a different value at the prompt.
-- Use `--no-interactive` for fully flag-driven generation.
-- Database default is `none`.
-- All yes/no prompts default to `No` (`y/N`).
-
-## Typical workflow
-
-```bash
-# 0) Create a workspace and generate a service inside it
-csrd new workspace --name local-dev --output . --generate none
-csrd new service --name inventory --output ./local-dev --database postgres --workers
-
-# 1) Verify service compatibility
-csrd doctor --service ./local-dev/src/inventory
-
-# 1b) Audit for weak/insecure defaults
-csrd audit --service ./local-dev/src/inventory
-
-# 2) Inspect available bundled features
-csrd feature list
-
-# 3) Dry-run a feature
-csrd feature plan workers --service ./local-dev/src/inventory
-
-# 4) Apply feature files/merges
-csrd feature add workers --service ./local-dev/src/inventory
-
-# 5) Add a second service — workspace auto-upgrades to cluster
-csrd new service --name pricing --output ./local-dev --database postgres
-```
-
-## Bundled assets
-
-- `features/workers/` feature manifests and fragments
-- `templates/service/` template starter
-
-## Python API
-
-```python
-from pathlib import Path
-from csrd_utils import ServiceAugmentor
-from csrd_utils.resources import features_path
-
-with features_path() as feature_lib:
-    augmentor = ServiceAugmentor(Path("."), feature_lib)
-    ok, changes = augmentor.add_feature("workers", plan=True)
-```
-
-## Documentation
-
-- `docs/CLI_REFERENCE.md` - full command/flag reference
-- `docs/FEATURES.md` - bundled feature catalog and behavior
-- `docs/FUTURE_WORK.md` - remaining provider-specific CI wiring work (Phase 5B)
-- `docs/AGENT_SMOKE_TESTS.md` - copy/paste validation flow for clean workspaces
-- `docs/COMMAND_MATRIX.yaml` - machine-readable command matrix for automation
-- `AGENTS.md` - package-local rules for autonomous agents
-
-## CLI-only agent mode
-
-If an agent can only see the installed CLI (not source files), use this exploration sequence:
-
-```bash
-csrd --help
-csrd new --help
-csrd new workspace --help
-csrd new service --help
-csrd new cluster --help
-csrd feature --help
-csrd doctor --help
-csrd audit --help
-csrd feature list
-```
-
-Then run a clean smoke flow:
-
-```bash
-mkdir -p /tmp/csrd-smoke
-csrd new workspace --name ws --output /tmp/csrd-smoke --generate none
-csrd new service --name demo-svc --output /tmp/csrd-smoke/ws --no-interactive
-csrd doctor --service /tmp/csrd-smoke/ws/src/demo-svc
-csrd audit --service /tmp/csrd-smoke/ws/src/demo-svc
-csrd feature plan workers --service /tmp/csrd-smoke/ws/src/demo-svc
-csrd feature add workers --service /tmp/csrd-smoke/ws/src/demo-svc
-```

csrd_utils-0.5.1/README.md

@@ -1,163 +0,0 @@
-# csrd-utils
-
-CLI and runtime helpers for generating csrd services and augmenting existing services with optional features.
-
-## Install
-
-```bash
-pip install "csrd-utils @ git+https://github.com/csrd-api/fastapi-common.git#subdirectory=packages/utils"
-```
-
-## CLI
-
-```bash
-csrd --help
-csrd --version
-csrd new workspace                                # create workspace, then choose none/service/cluster
-csrd new service                                  # requires workspace; prompts to create one if missing
-csrd new service --interactive --name items       # pre-fills name prompt with 'items'
-csrd new service --name inventory --no-interactive --output ./my-workspace
-csrd new service --name pricing --output ./my-workspace --no-interactive
-csrd new cluster --spec ./cluster.yaml --output ./my-workspace
-csrd new cluster                                  # requires workspace; interactive mode can offer to create one
-csrd feature list
-csrd feature plan workers --service .
-csrd feature plan workers --service . --json
-csrd feature add workers --service .
-csrd doctor --service .
-csrd audit                                          # if cwd is workspace, audits all services
-csrd audit --service .                              # explicitly audit one service path
-csrd completion bash                                # print bash completion script
-```
-
-`feature plan --json` is useful for CI or tooling wrappers.
-
-### Bash tab completion
-
-Enable command/subcommand completion in bash:
-
-```bash
-source <(csrd completion bash)
-```
-
-Then examples like `csrd ne<TAB>` and `csrd new wor<TAB>` complete to `new` and `workspace`.
-
-### Workspace extraction command
-
-Service extraction into a sibling workspace is supported:
-
-```bash
-csrd workspace extract-service --service ./source-ws/src/pricing --target-workspace ../pricing-ws --mode copy
-csrd workspace extract-service --service ./source-ws/src/pricing --target-workspace ../pricing-ws --mode move
-csrd workspace extract-service --service ./source-ws/src/pricing --target-workspace ../pricing-ws --dry-run --json
-```
-
-Use extraction when service ownership diverges, release cadence becomes independent,
-or workspace orchestration starts coupling unrelated deployments.
-
-Manual fallback remains available if needed:
-
-```bash
-csrd new workspace --name pricing-ws --output .. --generate none
-cp -a ./source-ws/src/pricing ../pricing-ws/src/pricing
-cd ../pricing-ws
-csrd new cluster --spec ./.csrd/cluster.yaml --output . --force
-```
-
-### Interactive generation behavior
-
-- `csrd new service` and `csrd new cluster` are workspace-first commands.
-- If a workspace marker is missing in the selected output path, interactive flows ask to create one and continue.
-- Non-interactive generation errors when no workspace marker is present.
-- Workspace cluster source of truth is persisted at `.csrd/cluster.yaml`.
-- If `.csrd/cluster.yaml` already exists, `csrd new service` appends the generated service and refreshes scaffold files (`docker-compose.yml`, `.env.example`, `README.md`, `smoke.sh`). Service source directories and running containers are never touched.
-- If `.csrd/cluster.yaml` is missing, `csrd new service` bootstraps `.csrd/cluster.yaml` and writes initial cluster scaffold files.
-- `csrd new service` runs a compact interactive flow by default (core prompts 1-6), then asks whether to show advanced options.
-- `csrd new workspace` creates a workspace directory and prompts whether to generate `none`, `service`, or `cluster` immediately.
-- In compact mode, advanced options are hidden by default.
-- `csrd new service --interactive` runs the full verbose interactive flow.
-- Passing `--name <value>` in interactive mode uses that value as the name prompt default.
-- You can still overwrite the default by entering a different value at the prompt.
-- Use `--no-interactive` for fully flag-driven generation.
-- Database default is `none`.
-- All yes/no prompts default to `No` (`y/N`).
-
-## Typical workflow
-
-```bash
-# 0) Create a workspace and generate a service inside it
-csrd new workspace --name local-dev --output . --generate none
-csrd new service --name inventory --output ./local-dev --database postgres --workers
-
-# 1) Verify service compatibility
-csrd doctor --service ./local-dev/src/inventory
-
-# 1b) Audit for weak/insecure defaults
-csrd audit --service ./local-dev/src/inventory
-
-# 2) Inspect available bundled features
-csrd feature list
-
-# 3) Dry-run a feature
-csrd feature plan workers --service ./local-dev/src/inventory
-
-# 4) Apply feature files/merges
-csrd feature add workers --service ./local-dev/src/inventory
-
-# 5) Add a second service — workspace auto-upgrades to cluster
-csrd new service --name pricing --output ./local-dev --database postgres
-```
-
-## Bundled assets
-
-- `features/workers/` feature manifests and fragments
-- `templates/service/` template starter
-
-## Python API
-
-```python
-from pathlib import Path
-from csrd_utils import ServiceAugmentor
-from csrd_utils.resources import features_path
-
-with features_path() as feature_lib:
-    augmentor = ServiceAugmentor(Path("."), feature_lib)
-    ok, changes = augmentor.add_feature("workers", plan=True)
-```
-
-## Documentation
-
-- `docs/CLI_REFERENCE.md` - full command/flag reference
-- `docs/FEATURES.md` - bundled feature catalog and behavior
-- `docs/FUTURE_WORK.md` - remaining provider-specific CI wiring work (Phase 5B)
-- `docs/AGENT_SMOKE_TESTS.md` - copy/paste validation flow for clean workspaces
-- `docs/COMMAND_MATRIX.yaml` - machine-readable command matrix for automation
-- `AGENTS.md` - package-local rules for autonomous agents
-
-## CLI-only agent mode
-
-If an agent can only see the installed CLI (not source files), use this exploration sequence:
-
-```bash
-csrd --help
-csrd new --help
-csrd new workspace --help
-csrd new service --help
-csrd new cluster --help
-csrd feature --help
-csrd doctor --help
-csrd audit --help
-csrd feature list
-```
-
-Then run a clean smoke flow:
-
-```bash
-mkdir -p /tmp/csrd-smoke
-csrd new workspace --name ws --output /tmp/csrd-smoke --generate none
-csrd new service --name demo-svc --output /tmp/csrd-smoke/ws --no-interactive
-csrd doctor --service /tmp/csrd-smoke/ws/src/demo-svc
-csrd audit --service /tmp/csrd-smoke/ws/src/demo-svc
-csrd feature plan workers --service /tmp/csrd-smoke/ws/src/demo-svc
-csrd feature add workers --service /tmp/csrd-smoke/ws/src/demo-svc
-```