scaffold-ca-python 0.1.3__tar.gz → 0.1.4__tar.gz

scaffold_ca_python-0.1.4/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.4"
+}

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.1.4](https://github.com/bancolombia/scaffold-clean-architecture-py/compare/v0.1.3...v0.1.4) (2026-09-21)
+
+
+### Bug Fixes
+
+* **scaffold:** resolve template generation bugs ([8cd012a](https://github.com/bancolombia/scaffold-clean-architecture-py/commit/8cd012a18eeb2b472875e545dbdbd42b087b13b1))
+
 ## [0.1.3](https://github.com/bancolombia/scaffold-clean-architecture-py/compare/v0.1.2...v0.1.3) (2026-09-17)
 
 

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scaffold-ca-python
-Version: 0.1.3
+Version: 0.1.4
 Summary: Scaffolder to generate Clean Architecture apps
 Project-URL: Homepage, https://github.com/bancolombia/scaffold-clean-architecture-py
 Project-URL: Repository, https://github.com/bancolombia/scaffold-clean-architecture-py
@@ -22,11 +22,11 @@ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Typing :: Typed
 Requires-Python: >=3.13
 Requires-Dist: jinja2~=3.1.6
-Requires-Dist: pydantic~=2.13.3
+Requires-Dist: pydantic~=2.13.5
 Requires-Dist: pyyaml~=6.0.3
 Requires-Dist: rich~=15.0.0
 Requires-Dist: tomli-w~=1.2.0
-Requires-Dist: typer~=0.25.1
+Requires-Dist: typer~=0.27.2
 Description-Content-Type: text/markdown
 
 # scaffold-ca-python
@@ -80,7 +80,7 @@ cd my-app
 3. Generate a domain model.
 
 ```bash
-scaffold gm --name Order
+scaffold gm --name order
 ```
 
 4. Validate the project structure.
@@ -108,11 +108,11 @@ scaffold ca --name my-project --dry-run
 Scaffold a Pydantic v2 domain model and its test stub.
 
 ```bash
-scaffold gm --name Order
+scaffold gm --name order
 ```
 
 ```bash
-scaffold gm --name Order --dry-run
+scaffold gm --name order --dry-run
 ```
 
 ### scaffold guc
@@ -120,11 +120,11 @@ scaffold gm --name Order --dry-run
 Scaffold a use case in `domain/usecase/`.
 
 ```bash
-scaffold guc --name CreateOrder
+scaffold guc --name create_order
 ```
 
 ```bash
-scaffold guc --name CreateOrder --dry-run
+scaffold guc --name create_order --dry-run
 ```
 
 ### scaffold gda
@@ -136,7 +136,7 @@ scaffold gda --type rest-consumer
 ```
 
 ```bash
-scaffold gda --type generic --name MyAdapter --dry-run
+scaffold gda --type generic --name my_adapter --dry-run
 ```
 
 ### scaffold gep
@@ -156,11 +156,11 @@ scaffold gep --type mcp --with-resources --with-prompts --dry-run
 Scaffold a helper utility module and its test stub.
 
 ```bash
-scaffold gh --name JsonParser
+scaffold gh --name json_parser
 ```
 
 ```bash
-scaffold gh --name JsonParser --dry-run
+scaffold gh --name json_parser --dry-run
 ```
 
 ### scaffold gpipe
@@ -192,11 +192,11 @@ scaffold vs --dry-run
 Delete a previously generated module and its mirrored test file.
 
 ```bash
-scaffold dm --name Order
+scaffold dm --name order
 ```
 
 ```bash
-scaffold dm --name Order --dry-run
+scaffold dm --name order --dry-run
 ```
 
 ### scaffold up
@@ -217,7 +217,7 @@ scaffold update-project --dry-run
 |----------------|---------|------|
 | Python | >=3.13 | Runtime |
 | uv | latest | Dependency management, build, and publish |
-| Typer | >=0.25.1 | CLI framework |
+| Typer | >=0.27.2 | CLI framework |
 | Rich | >=15.0.0 | Terminal output formatting |
 | Jinja2 | >=3.1 | Template engine for code generation |
 | Pydantic v2 | >=2.0 | Runtime validation of template context |

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/README.md

@@ -49,7 +49,7 @@ cd my-app
 3. Generate a domain model.
 
 ```bash
-scaffold gm --name Order
+scaffold gm --name order
 ```
 
 4. Validate the project structure.
@@ -77,11 +77,11 @@ scaffold ca --name my-project --dry-run
 Scaffold a Pydantic v2 domain model and its test stub.
 
 ```bash
-scaffold gm --name Order
+scaffold gm --name order
 ```
 
 ```bash
-scaffold gm --name Order --dry-run
+scaffold gm --name order --dry-run
 ```
 
 ### scaffold guc
@@ -89,11 +89,11 @@ scaffold gm --name Order --dry-run
 Scaffold a use case in `domain/usecase/`.
 
 ```bash
-scaffold guc --name CreateOrder
+scaffold guc --name create_order
 ```
 
 ```bash
-scaffold guc --name CreateOrder --dry-run
+scaffold guc --name create_order --dry-run
 ```
 
 ### scaffold gda
@@ -105,7 +105,7 @@ scaffold gda --type rest-consumer
 ```
 
 ```bash
-scaffold gda --type generic --name MyAdapter --dry-run
+scaffold gda --type generic --name my_adapter --dry-run
 ```
 
 ### scaffold gep
@@ -125,11 +125,11 @@ scaffold gep --type mcp --with-resources --with-prompts --dry-run
 Scaffold a helper utility module and its test stub.
 
 ```bash
-scaffold gh --name JsonParser
+scaffold gh --name json_parser
 ```
 
 ```bash
-scaffold gh --name JsonParser --dry-run
+scaffold gh --name json_parser --dry-run
 ```
 
 ### scaffold gpipe
@@ -161,11 +161,11 @@ scaffold vs --dry-run
 Delete a previously generated module and its mirrored test file.
 
 ```bash
-scaffold dm --name Order
+scaffold dm --name order
 ```
 
 ```bash
-scaffold dm --name Order --dry-run
+scaffold dm --name order --dry-run
 ```
 
 ### scaffold up
@@ -186,7 +186,7 @@ scaffold update-project --dry-run
 |----------------|---------|------|
 | Python | >=3.13 | Runtime |
 | uv | latest | Dependency management, build, and publish |
-| Typer | >=0.25.1 | CLI framework |
+| Typer | >=0.27.2 | CLI framework |
 | Rich | >=15.0.0 | Terminal output formatting |
 | Jinja2 | >=3.1 | Template engine for code generation |
 | Pydantic v2 | >=2.0 | Runtime validation of template context |

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/pyproject.toml

@@ -24,25 +24,25 @@ classifiers = [
 ]
 dependencies = [
     "jinja2~=3.1.6",
-    "pydantic~=2.13.3",
+    "pydantic~=2.13.5",
     "pyyaml~=6.0.3",
     "tomli-w~=1.2.0",
-    "typer~=0.25.1",
+    "typer~=0.27.2",
     "rich~=15.0.0",
 ]
 
 [dependency-groups]
 dev = [
     { include-group = "tests" },
-    "prek>=0.3.2",
-    "types-pyyaml>=6.0.12.20250915",
+    "prek>=0.5.3",
+    "types-pyyaml>=6.0.12.20260906",
 ]
 
 tests = [
-    "ruff>=0.15.8",
-    "mypy>=1.19.1",
-    "pytest>=9.0.2",
-    "pytest-benchmark>=5.2.3",
+    "ruff>=0.16.8",
+    "mypy>=2.3.1",
+    "pytest>=9.1.1",
+    "pytest-benchmark>=5.3.0",
     "pytest-cov>=7.1.0",
 ]
 

scaffold_ca_python-0.1.4/specs/017-pep8-naming-validation/contracts/name-validation.md

@@ -0,0 +1,103 @@
+# Contract: `--name` Argument Validation
+
+**Type**: CLI input validation contract  
+**Applies to**: Scaffold commands accepting `--name`
+
+The naming policy is split by command family (`gep` takes `--type`, not `--name`):
+
+| Command family | Commands | Accepted input |
+|----------------|----------|----------------|
+| Project | `ca` | `kebab-case` **or** `snake_case` |
+| Module/class | `gm`, `guc`, `gh`, `gda --type generic`, `dm` | `snake_case` only |
+
+Rationale: `ca` names a project directory and PyPI distribution, where `kebab-case` is
+idiomatic. `gm`/`guc`/`gh`/`gda`/`dm` generate a Python module (`snake_case` file) plus a
+`PascalCase` class; accepting `kebab-case` there is ambiguous noise, so only `snake_case`
+(the PEP8 module form) is allowed.
+
+---
+
+## Accepted Values — `ca` (kebab-case or snake_case)
+
+A valid `ca --name` value MUST match:
+
+```
+^[a-z][a-z0-9]*([_-][a-z0-9]+)*$
+```
+
+| Format | Example | Accepted |
+|--------|---------|----------|
+| Single lowercase word | `order` | ✅ |
+| `snake_case` | `my_project` | ✅ |
+| `kebab-case` | `my-project` | ✅ |
+| Alphanumeric (no separator) | `project2025` | ✅ |
+| `PascalCase` | `MyProject` | ❌ |
+| `camelCase` | `myProject` | ❌ |
+| Consecutive separators | `my--project` | ❌ |
+| Leading/trailing separator | `-my`, `my_` | ❌ |
+| Starts with digit | `1project` | ❌ |
+| Special characters | `my@project` | ❌ |
+| Empty string | `` | ❌ |
+
+## Accepted Values — module/class commands (snake_case only)
+
+A valid `--name` value for `gm`/`guc`/`gh`/`gda --type generic`/`dm` MUST match:
+
+```
+^[a-z][a-z0-9]*(_[a-z0-9]+)*$
+```
+
+| Format | Example | Accepted |
+|--------|---------|----------|
+| Single lowercase word | `order` | ✅ |
+| `snake_case` | `create_order` | ✅ |
+| `kebab-case` | `create-order` | ❌ |
+| `PascalCase` | `CreateOrder` | ❌ |
+| `camelCase` | `createOrder` | ❌ |
+
+The error message for these commands MUST mention `snake_case` (e.g.,
+`Invalid name 'create-order'. Use snake_case (e.g., 'create_order').`).
+
+---
+
+## Error Response (invalid name)
+
+When validation fails, the tool MUST exit with code **1** and print to stdout:
+
+- For `ca`: a message containing both `kebab-case` and `snake_case`.
+  ```
+  Error: Invalid name 'MyProject'. Use kebab-case (e.g., 'my-project') or snake_case (e.g., 'my_project').
+  ```
+- For module/class commands: a message containing `snake_case`.
+  ```
+  Error: Invalid name 'create-order'. Use snake_case (e.g., 'create_order').
+  ```
+
+---
+
+## Internal Normalisation
+
+For `ca`, `kebab-case` input is silently normalised to `snake_case` for the Python package
+(`to_snake_case`) and kept as `kebab-case` for the distribution script (`to_kebab_case`); no
+warning is printed. Module/class commands only accept `snake_case`, so their input needs no
+kebab normalisation; the `PascalCase` class name is still derived via `to_pascal_case`.
+
+The normalisation helpers themselves remain kebab-tolerant (they are also fed `ProjectContext`/
+`ModuleContext` values built directly in tests):
+
+| Input | Module name | Class name |
+|-------|-------------|------------|
+| `create_order` | `create_order` | `CreateOrder` |
+| `order` | `order` | `Order` |
+| `my_order_service` | `my_order_service` | `MyOrderService` |
+
+---
+
+## Invariants
+
+1. **Generated `.py` file names**: always `snake_case` — `[a-z][a-z0-9_]*\.py`
+2. **Generated `class` names**: always `PascalCase` — `[A-Z][a-zA-Z0-9]*`
+3. **Validation applies regardless of `--dry-run`**
+4. **Validation policy is split by command family** — `ca` accepts `kebab-case`/`snake_case`;
+   `gm`/`guc`/`gh`/`gda --type generic`/`dm` accept `snake_case` only; `gep` takes `--type`,
+   not `--name`. No command bypasses its family's rule.

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/specs/020-pypi-publish-readme/data-model.md

@@ -107,14 +107,14 @@ Commands covered (10 total):
 | Command | Alias | Example invocation |
 |---------|-------|--------------------|
 | `clean-architecture` | `ca` | `scaffold ca --name my-project` |
-| `generate-model` | `gm` | `scaffold gm --name Order` |
-| `generate-use-case` | `guc` | `scaffold guc --name CreateOrder` |
+| `generate-model` | `gm` | `scaffold gm --name order` |
+| `generate-use-case` | `guc` | `scaffold guc --name create_order` |
 | `generate-driven-adapter` | `gda` | `scaffold gda --type rest-consumer` |
 | `generate-entry-point` | `gep` | `scaffold gep --type restapi` / `--type mcp` |
-| `generate-helper` | `gh` | `scaffold gh --name LoggingHelper` |
+| `generate-helper` | `gh` | `scaffold gh --name logging_helper` |
 | `generate-pipeline` | `gpipe` | `scaffold gpipe --provider github` |
 | `validate-structure` | `vs` | `scaffold vs` |
-| `delete-module` | `dm` | `scaffold dm --name Order` |
+| `delete-module` | `dm` | `scaffold dm --name order` |
 | `update-project` | `up` | `scaffold up` |
 
 ### Technologies table schema

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/specs/020-pypi-publish-readme/tasks.md

@@ -55,7 +55,7 @@
 - [X] T009 [US2] Write Section 1 (title + badges) in `README.md` — H1 heading + PyPI version badge + Python badge + MIT license badge (absolute Shields.io URLs)
 - [X] T010 [US2] Write Section 2 ("What is this?") in `README.md` — 2–4 sentences covering Clean Architecture, Python, CLI code scaffolding (no framework names)
 - [X] T011 [US2] Write Section 3 ("Installation") in `README.md` — `pip install scaffold-ca-python` and `uv add scaffold-ca-python` fenced blocks + Python ≥3.13 note
-- [X] T012 [US2] Write Section 4 ("Quick Start") in `README.md` — numbered 4-step walkthrough: install → `scaffold ca --name my-app` → `scaffold gm --name Order` → `scaffold vs`
+- [X] T012 [US2] Write Section 4 ("Quick Start") in `README.md` — numbered 4-step walkthrough: install → `scaffold ca --name my-app` → `scaffold gm --name order` → `scaffold vs`
 - [X] T013 [US2] Write Section 5 ("Commands & Examples") in `README.md` — 10 `###` sub-sections (ca, gm, guc, gda, gep, gh, gpipe, vs, dm, up) each with description + fenced `bash` example per contracts/readme-outline.md
 - [X] T014 [P] [US2] Write Section 6 ("Technologies") in `README.md` — Markdown table (Tool/Library | Version | Role) with all 11 entries from data-model.md §3
 - [X] T015 [P] [US2] Write Section 7 ("Current Features") in `README.md` — bullet list covering all 10 commands, `--dry-run`, Jinja2 templates, Pydantic v2, Rich output, mypy strict, ruff, 80%+ coverage gate

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/delete_module.py

@@ -10,7 +10,7 @@ import typer
 from rich.console import Console
 
 from scaffold_ca_python.core.module_builder import ModuleBuilder
-from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_name
+from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_module_name
 from scaffold_ca_python.core.project_detector import find_project_root, resolve_tests_root
 from scaffold_ca_python.factory import ModuleFactory
 from scaffold_ca_python.factory.simple.delete_module_factory import DeleteModuleFactory
@@ -24,7 +24,7 @@ _REGISTRY: dict[str, type[ModuleFactory]] = {
 }
 
 _DM_HELP = "Delete a previously generated module and its test mirror. Alias 'dm'."
-_DM_EPILOG = "Examples:\n\n  * scaffold dm --name Order\n\n  * scaffold delete-module --name MyAdapter\n\n"
+_DM_EPILOG = "Examples:\n\n  * scaffold dm --name order\n\n  * scaffold delete-module --name my_adapter\n\n"
 
 
 # ---------------------------------------------------------------------------
@@ -32,7 +32,7 @@ _DM_EPILOG = "Examples:\n\n  * scaffold dm --name Order\n\n  * scaffold delete-m
 # ---------------------------------------------------------------------------
 
 
-def _find_module_targets(project_root: Path, snake: str) -> list[tuple[Path, Path | None]]:
+def _find_module_targets(pkg: str, project_root: Path, snake: str) -> list[tuple[Path, Path | None]]:
     """Return a list of (target_path, test_path_or_None) for all matches of *snake*.
 
     Searches across:
@@ -42,7 +42,6 @@ def _find_module_targets(project_root: Path, snake: str) -> list[tuple[Path, Pat
       4. infrastructure/entry_points/<snake>/
       5. infrastructure/helpers/<snake>/
     """
-    pkg = _get_python_package(project_root)
     src_root = project_root / "src" / pkg
     tests_root = resolve_tests_root(project_root)
 
@@ -77,20 +76,6 @@ def _find_module_targets(project_root: Path, snake: str) -> list[tuple[Path, Pat
     return candidates
 
 
-def _get_python_package(root: Path) -> str:
-    pyproject = root / "pyproject.toml"
-    with pyproject.open("rb") as fh:
-        data = tomllib.load(fh)
-    section = data.get("tool", {}).get("scaffold-ca-python", {})
-    name = section.get("name", root.name)
-    import re
-
-    s = name.replace("-", "_")
-    s = re.sub(r"([A-Z]+)([A-Z][a-z])", r"\1_\2", s)
-    s = re.sub(r"([a-z0-9])([A-Z])", r"\1_\2", s)
-    return s.lower()
-
-
 # ---------------------------------------------------------------------------
 # Implementation
 # ---------------------------------------------------------------------------
@@ -99,7 +84,7 @@ def _get_python_package(root: Path) -> str:
 def _delete_module_impl(name: str, confirm: bool, dry_run: bool) -> None:
     # Validate name
     try:
-        validate_name(name)
+        validate_module_name(name)
     except ScaffoldError as exc:
         console.print(f"[red]Error:[/red] {exc}")
         raise typer.Exit(code=1) from None
@@ -118,7 +103,7 @@ def _delete_module_impl(name: str, confirm: bool, dry_run: bool) -> None:
 
     # Find targets
     snake = to_snake_case(name)
-    targets = _find_module_targets(project_root, snake)
+    targets = _find_module_targets(project_ctx.python_package, project_root, snake)
 
     if not targets:
         console.print(
@@ -174,7 +159,7 @@ def register(app: typer.Typer) -> None:
     def delete_module(
         ctx: typer.Context,
         name: Annotated[
-            str | None, typer.Option("--name", help="Module name (PascalCase).", rich_help_panel="Required")
+            str | None, typer.Option("--name", help="Module name (snake_case).", rich_help_panel="Required")
         ] = None,
         confirm: Annotated[
             bool,

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/generate_driven_adapter.py

@@ -8,10 +8,11 @@ from typing import Annotated
 
 import typer
 from rich.console import Console
+from rich.markup import escape
 from rich.tree import Tree
 
 from scaffold_ca_python.core.module_builder import ModuleBuilder
-from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_name
+from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_module_name
 from scaffold_ca_python.core.project_detector import find_project_root
 from scaffold_ca_python.factory import ModuleFactory
 from scaffold_ca_python.factory.driven_adapters.da_generic import DrivenAdapterGeneric
@@ -37,7 +38,7 @@ _GDA_EPILOG = (
     " ==================================================\n\n"
     "Examples:\n\n"
     "  * scaffold gda --type rest-consumer\n\n"
-    "  * scaffold generate-driven-adapter --type generic --name MyAdapter\n\n"
+    "  * scaffold generate-driven-adapter --type generic --name my_adapter\n\n"
 )
 
 
@@ -55,7 +56,7 @@ def _generate_driven_adapter_impl(type_: str, name: str | None, dry_run: bool) -
     # --- Validate name if provided ---
     if name:
         try:
-            validate_name(name)
+            validate_module_name(name)
         except ScaffoldError as exc:
             console.print(f"[red]Error:[/red] {exc}")
             raise typer.Exit(code=1) from None
@@ -116,8 +117,12 @@ def _generate_driven_adapter_impl(type_: str, name: str | None, dry_run: bool) -
         for p in sorted(created):
             tree.add(str(p.relative_to(project_root)))
         console.print(tree)
-        if builder._dependencies:
-            console.print(f"[dim]Would add to [project.dependencies]: {', '.join(builder._dependencies)}[/dim]")
+        if builder.pending_dependencies:
+            target = escape("[project.dependencies]")
+            console.print(f"[dim]Would add to {target}: {', '.join(builder.pending_dependencies)}[/dim]")
+        for grp, pkgs in builder.pending_group_dependencies.items():
+            target = escape(f"[dependency-groups.{grp}]")
+            console.print(f"[dim]Would add to {target}: {', '.join(pkgs)}[/dim]")
         return
 
     console.print(f"[green]✓[/green] Driven adapter [bold]{subdir}[/bold] created. Created {len(created)} file(s).")
@@ -146,7 +151,7 @@ def register(app: typer.Typer) -> None:
             str | None,
             typer.Option(
                 "--name",
-                help="Adapter name (required for --type generic).",
+                help="Adapter name in snake_case, e.g. my_adapter (required for --type generic).",
                 rich_help_panel="Options",
             ),
         ] = None,

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/generate_entry_point.py

@@ -10,10 +10,11 @@ from typing import Annotated
 import typer
 import yaml
 from rich.console import Console
+from rich.markup import escape
 from rich.tree import Tree
 
 from scaffold_ca_python.core.module_builder import ModuleBuilder
-from scaffold_ca_python.core.name_utils import ScaffoldError
+from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case
 from scaffold_ca_python.core.project_detector import find_project_root
 from scaffold_ca_python.factory import ModuleFactory
 from scaffold_ca_python.factory.entry_points.ep_agent import EntryPointAgent
@@ -59,7 +60,7 @@ def _load_project_context(project_root: Path) -> ProjectContext:
     pyproject_path = project_root / "pyproject.toml"
     with open(pyproject_path, "rb") as f:
         data = tomllib.load(f)
-    project_name = data.get("project", {}).get("name", "project").replace("-", "_")
+    project_name = to_snake_case(data.get("project", {}).get("name", "project"))
     return ProjectContext(name=project_name)
 
 
@@ -190,9 +191,10 @@ def _generate_entry_point_impl(
             tree.add(str(p.relative_to(project_root)))
         console.print(tree)
 
-        # Check if dependencies were collected by looking at builder internals
-        if builder._dependencies:
-            console.print(f"[dim]Would add to [project.dependencies]: {', '.join(builder._dependencies)}[/dim]")
+        # Report any runtime dependencies queued for injection
+        if builder.pending_dependencies:
+            target = escape("[project.dependencies]")
+            console.print(f"[dim]Would add to {target}: {', '.join(builder.pending_dependencies)}[/dim]")
 
         if type_ == "restapi":
             main_py = project_root / "src" / pkg / "main.py"

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/generate_helper.py

@@ -11,7 +11,7 @@ from rich.console import Console
 from rich.tree import Tree
 
 from scaffold_ca_python.core.module_builder import ModuleBuilder
-from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_name
+from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_module_name
 from scaffold_ca_python.core.project_detector import find_project_root
 from scaffold_ca_python.factory import ModuleFactory
 from scaffold_ca_python.factory.simple.helper_factory import HelperFactory
@@ -25,13 +25,13 @@ _REGISTRY: dict[str, type[ModuleFactory]] = {
 }
 
 _GH_HELP = "Scaffold a helper utility module and test stub. Alias 'gh'."
-_GH_EPILOG = "Example:\n\n  * scaffold gh --name JsonParser\n\n  * scaffold generate-helper --name JsonParser\n\n"
+_GH_EPILOG = "Example:\n\n  * scaffold gh --name json_parser\n\n  * scaffold generate-helper --name json_parser\n\n"
 
 
 def _generate_helper_impl(name: str, dry_run: bool) -> None:
     # --- Validate name ---
     try:
-        validate_name(name)
+        validate_module_name(name)
     except ScaffoldError as exc:
         console.print(f"[red]Error:[/red] {exc}")
         raise typer.Exit(code=1) from None
@@ -100,7 +100,7 @@ def register(app: typer.Typer) -> None:
     def generate_helper(
         ctx: typer.Context,
         name: Annotated[
-            str | None, typer.Option("--name", help="Helper name (PascalCase).", rich_help_panel="Required")
+            str | None, typer.Option("--name", help="Helper name (snake_case).", rich_help_panel="Required")
         ] = None,
         dry_run: Annotated[
             bool,

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/generate_model.py

@@ -11,7 +11,7 @@ from rich.console import Console
 from rich.tree import Tree
 
 from scaffold_ca_python.core.module_builder import ModuleBuilder
-from scaffold_ca_python.core.name_utils import ScaffoldError, validate_name
+from scaffold_ca_python.core.name_utils import ScaffoldError, validate_module_name
 from scaffold_ca_python.core.project_detector import find_project_root
 from scaffold_ca_python.factory import ModuleFactory
 from scaffold_ca_python.factory.simple.model_factory import ModelFactory
@@ -24,13 +24,13 @@ _REGISTRY: dict[str, type[ModuleFactory]] = {
     "model": ModelFactory,
 }
 _GM_HELP = "Scaffold a Pydantic v2 domain model and test stub. Alias 'gm'."
-_GM_EPILOG = "Example:\n\n  * scaffold gm --name Order\n\n  * scaffold generate-model --name Order\n\n"
+_GM_EPILOG = "Example:\n\n  * scaffold gm --name order\n\n  * scaffold generate-model --name order\n\n"
 
 
 def _generate_model_impl(name: str, dry_run: bool) -> None:
     # --- Validate name ---
     try:
-        validate_name(name)
+        validate_module_name(name)
     except ScaffoldError as exc:
         console.print(f"[red]Error:[/red] {exc}")
         raise typer.Exit(code=1) from None
@@ -100,7 +100,7 @@ def register(app: typer.Typer) -> None:
     def generate_model(
         ctx: typer.Context,
         name: Annotated[
-            str | None, typer.Option("--name", help="Model name (PascalCase).", rich_help_panel="Required")
+            str | None, typer.Option("--name", help="Model name (snake_case).", rich_help_panel="Required")
         ] = None,
         dry_run: Annotated[
             bool,

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/generate_project.py

@@ -151,7 +151,7 @@ def register(app: typer.Typer) -> None:
             str,
             typer.Option(
                 "--name",
-                help="Project name (PascalCase or snake_case).",
+                help="Project name (kebab-case or snake_case).",
                 rich_help_panel="Required",
             ),
         ] = None,  # type: ignore[assignment]

{scaffold_ca_python-0.1.3 → scaffold_ca_python-0.1.4}/src/scaffold_ca_python/commands/generate_use_case.py

@@ -11,7 +11,7 @@ from rich.console import Console
 from rich.tree import Tree
 
 from scaffold_ca_python.core.module_builder import ModuleBuilder
-from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_name
+from scaffold_ca_python.core.name_utils import ScaffoldError, to_snake_case, validate_module_name
 from scaffold_ca_python.core.project_detector import find_project_root
 from scaffold_ca_python.factory import ModuleFactory
 from scaffold_ca_python.factory.simple.use_case_factory import UseCaseFactory
@@ -24,13 +24,15 @@ _REGISTRY: dict[str, type[ModuleFactory]] = {
     "use_case": UseCaseFactory,
 }
 _GUC_HELP = "Scaffold a use case in domain/usecase/. Alias 'guc'."
-_GUC_EPILOG = "Example:\n\n  * scaffold guc --name CreateOrder\n\n  * scaffold generate-use-case --name CreateOrder\n\n"
+_GUC_EPILOG = (
+    "Example:\n\n  * scaffold guc --name create_order\n\n  * scaffold generate-use-case --name create_order\n\n"
+)
 
 
 def _generate_use_case_impl(name: str, dry_run: bool) -> None:
     # --- Validate name ---
     try:
-        validate_name(name)
+        validate_module_name(name)
     except ScaffoldError as exc:
         console.print(f"[red]Error:[/red] {exc}")
         raise typer.Exit(code=1) from None
@@ -102,7 +104,7 @@ def register(app: typer.Typer) -> None:
     def generate_use_case(
         ctx: typer.Context,
         name: Annotated[
-            str | None, typer.Option("--name", help="Use case name (PascalCase).", rich_help_panel="Required")
+            str | None, typer.Option("--name", help="Use case name (snake_case).", rich_help_panel="Required")
         ] = None,
         dry_run: Annotated[
             bool,