csrd-utils 0.3.24__tar.gz → 0.3.26__tar.gz

{csrd_utils-0.3.24 → csrd_utils-0.3.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csrd-utils
-Version: 0.3.24
+Version: 0.3.26
 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
@@ -40,10 +40,21 @@ 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:
@@ -54,6 +65,18 @@ csrd workspace extract-service --service ./source-ws/src/pricing --target-worksp
 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.
@@ -119,10 +142,10 @@ with features_path() as feature_lib:
 
 - `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
-- `../../docs/SERVICE_EXTRACTION_PLAYBOOK.md` - workspace service extraction workflow and status
 
 ## CLI-only agent mode
 

{csrd_utils-0.3.24 → csrd_utils-0.3.26}/README.md

@@ -27,10 +27,21 @@ 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:
@@ -41,6 +52,18 @@ csrd workspace extract-service --service ./source-ws/src/pricing --target-worksp
 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.
@@ -106,10 +129,10 @@ with features_path() as feature_lib:
 
 - `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
-- `../../docs/SERVICE_EXTRACTION_PLAYBOOK.md` - workspace service extraction workflow and status
 
 ## CLI-only agent mode
 

{csrd_utils-0.3.24 → csrd_utils-0.3.26}/pyproject.toml

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

{csrd_utils-0.3.24 → csrd_utils-0.3.26}/src/csrd_utils/__main__.py

@@ -71,6 +71,75 @@ WORKSPACE_MARKER = ".csrd-workspace"
 WORKSPACE_CLUSTER_SPEC = Path(".csrd") / "cluster.yaml"
 
 
+def _parser_shape(
+    parser: argparse.ArgumentParser,
+    chain: tuple[str, ...] = (),
+) -> tuple[dict[tuple[str, ...], list[str]], dict[tuple[str, ...], list[str]]]:
+    commands: dict[tuple[str, ...], list[str]] = {}
+    options: dict[tuple[str, ...], list[str]] = {}
+
+    subcommands: list[str] = []
+    flags: list[str] = []
+    for action in parser._actions:
+        if isinstance(action, argparse._SubParsersAction):
+            subcommands.extend(sorted(action.choices.keys()))
+            for name, subparser in action.choices.items():
+                child_chain = (*chain, name)
+                child_commands, child_options = _parser_shape(subparser, child_chain)
+                commands.update(child_commands)
+                options.update(child_options)
+        else:
+            flags.extend([item for item in action.option_strings if item.startswith("-")])
+
+    commands[chain] = sorted(dict.fromkeys(subcommands))
+    options[chain] = sorted(dict.fromkeys(flags))
+    return commands, options
+
+
+def _render_bash_completion(parser: argparse.ArgumentParser) -> str:
+    commands, options = _parser_shape(parser)
+
+    lines = [
+        "# bash completion for csrd",
+        "_csrd_completion() {",
+        "  local cur key token",
+        '  cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  key=""',
+        "",
+        '  for token in "${COMP_WORDS[@]:1:COMP_CWORD-1}"; do',
+        '    case "$token" in',
+        "      -*) continue ;;",
+        "    esac",
+        '    if [[ -n "$key" ]]; then',
+        '      key="$key $token"',
+        "    else",
+        '      key="$token"',
+        "    fi",
+        "  done",
+        "",
+        '  case "$key" in',
+    ]
+
+    for chain in sorted(commands.keys()):
+        key = " ".join(chain)
+        command_candidates = commands.get(chain, [])
+        option_candidates = options.get(chain, [])
+        candidates = " ".join(command_candidates + option_candidates).strip()
+        if not candidates:
+            continue
+        lines.append(f'    "{key}") COMPREPLY=( $(compgen -W "{candidates}" -- "$cur") ) ;;')
+
+    lines.extend(
+        [
+            "    *) COMPREPLY=() ;;",
+            "  esac",
+            "}",
+            "complete -F _csrd_completion csrd csrd-utils csrt",
+        ]
+    )
+    return "\n".join(lines) + "\n"
+
+
 def _workspace_services_dir(workspace_root: Path) -> Path:
     return workspace_root / "src"
 
@@ -947,6 +1016,10 @@ def _build_parser() -> argparse.ArgumentParser:
     extract.add_argument("--json", action="store_true", help="Print extraction result as JSON")
     extract.add_argument("--force", action="store_true", help="Overwrite target service path")
 
+    completion = sub.add_parser("completion", help="Shell completion helpers")
+    completion_sub = completion.add_subparsers(dest="completion_shell", required=True)
+    completion_sub.add_parser("bash", help="Print bash completion script")
+
     return parser
 
 
@@ -1180,6 +1253,10 @@ def main() -> int:
             print(f"Refreshed source cluster scaffold at: {result['source_cluster']}")
         return 0
 
+    if args.command == "completion" and args.completion_shell == "bash":
+        print(_render_bash_completion(parser), end="")
+        return 0
+
     if args.command == "doctor":
         return _run_doctor(args.service, args.json)
 

{csrd_utils-0.3.24 → csrd_utils-0.3.26}/src/csrd_utils/templates/cookiecutter-service/README.md

@@ -25,7 +25,7 @@ Key prompts:
 - Adapter imports remain explicit via `from csrd.repository import ...`.
 - Feature-specific files are conditionally included using template sections.
 - `hooks/post_gen_project.py` validates incompatible feature combinations.
-- This template is the Phase 1 baseline for `docs/TEMPLATING_COMPREHENSIVE_PLAN.md`.
+- This template is the baseline generation scaffold for `csrd-utils`.
 
 ## Example combinations
 
@@ -50,4 +50,4 @@ uvx cookiecutter . --directory packages/utils/src/csrd_utils/templates/cookiecut
 ## Next phase
 
 - Phase 2 introduces standalone feature augmentation via `csrd feature`.
-- See `docs/TEMPLATING_COMPREHENSIVE_PLAN.md` for the Phase 2 roadmap and constraints.
+- See `packages/utils/docs/FUTURE_WORK.md` for remaining provider-specific CI future work.