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

{scaffold_ca_python-0.1.2 → scaffold_ca_python-0.1.4}/.github/agents/copilot-instructions.md

@@ -7,7 +7,7 @@ Auto-generated from all feature plans. Last updated: 2026-04-20
 - N/A — file I/O only via `FileWriter` / `TemplateRenderer` (008-fastapi-entrypoint-baseline)
 - Python 3.13 + FastAPI ≥ 0.135.2, uvicorn[standard] ≥ 0.20, dependency-injector ≥ 4.49.0, pydantic-settings ≥ 2.13.1, Jinja2 ≥ 3.1, pydantic ≥ 2.0, typer ≥ 0.16, rich ≥ 14.1 (009-app-factory-split)
 - N/A (code-generation tool; no database) (009-app-factory-split)
-- Python 3.13 + yper, Rich (CLI); tomllib + tomli_w (TOML read/write); pytest + pytest-cov (testing); ruff (lint/format); mypy strict (types) (011-fix-restapi-cleanup)
+- Python 3.13 + Typer, Rich (CLI); tomllib + tomli_w (TOML read/write); pytest + pytest-cov (testing); ruff (lint/format); mypy strict (types) (011-fix-restapi-cleanup)
 - Local filesystem — `pyproject.toml` (TOML), `main.py` (plain file delete) (011-fix-restapi-cleanup)
 - Python 3.13 + Jinja2 (template rendering), Pydantic v2 (generated schema model), FastAPI + Starlette (generated test client), pytest + pytest-cov (testing), ruff (lint/format), mypy strict (types), uv (package management) (012-fix-restapi-test-templates)
 - Local filesystem — Jinja2 `.jinja2` template files (012-fix-restapi-test-templates)
@@ -15,9 +15,9 @@ Auto-generated from all feature plans. Last updated: 2026-04-20
 - Local filesystem — Path operations only (014-tests-in-src)
 - Python 3.13 + Typer ≥ 0.16, Rich ≥ 14.1, Jinja2 ≥ 3.1, Pydantic v2, uv (015-factory-builder-refactor)
 - File system only (pyproject.toml + generated project files) (015-factory-builder-refactor)
-- Python 3.13+ + yper>=0.16.0, rich>=14.1.0; ruff (linter/formatter), mypy strict (type checker) (016-dedup-command-aliases)
+- Python 3.13+ + Typer>=0.16.0, rich>=14.1.0; ruff (linter/formatter), mypy strict (type checker) (016-dedup-command-aliases)
 - N/A — CLI tool, no database (016-dedup-command-aliases)
-- Python 3.13+ + yper ≥ 0.16, pydantic ≥ 2.0, rich ≥ 14.1, jinja2 ≥ 3.1 (017-pep8-naming-validation)
+- Python 3.13+ + Typer ≥ 0.16, pydantic ≥ 2.0, rich ≥ 14.1, jinja2 ≥ 3.1 (017-pep8-naming-validation)
 - N/A (file generation only) (017-pep8-naming-validation)
 - Python 3.13+ + Typer (CLI), Rich (output), Jinja2 (templates), Pydantic v2 (context models), `mcp>=1.0` (generated project dep), `starlette` (generated project dep), `uvicorn` (generated project dep), `dependency-injector` (generated project dep) (019-mcp-entry-point-restructure)
 - N/A — file system writes only (019-mcp-entry-point-restructure)
@@ -35,7 +35,9 @@ tests/
 
 ## Commands
 
-cd src [ONLY COMMANDS FOR ACTIVE TECHNOLOGIES][ONLY COMMANDS FOR ACTIVE TECHNOLOGIES] pytest [ONLY COMMANDS FOR ACTIVE TECHNOLOGIES][ONLY COMMANDS FOR ACTIVE TECHNOLOGIES] ruff check .
+uv run pytest
+uv run ruff check src tests
+uv run mypy src
 
 ## Code Style
 
@@ -44,7 +46,7 @@ Python 3.13: Follow standard conventions
 ## Recent Changes
 - 020-pypi-publish-readme: Added Python 3.13+ + hatchling (build backend), uv-dynamic-versioning (git-tag versioning, PEP 440), uv (build + publish)
 - 019-mcp-entry-point-restructure: Added Python 3.13+ + Typer (CLI), Rich (output), Jinja2 (templates), Pydantic v2 (context models), `mcp>=1.0` (generated project dep), `starlette` (generated project dep), `uvicorn` (generated project dep), `dependency-injector` (generated project dep)
-- 017-pep8-naming-validation: Added Python 3.13+ + yper ≥ 0.16, pydantic ≥ 2.0, rich ≥ 14.1, jinja2 ≥ 3.1
+- 017-pep8-naming-validation: Added Python 3.13+ + Typer ≥ 0.16, pydantic ≥ 2.0, rich ≥ 14.1, jinja2 ≥ 3.1
 
 
 <!-- MANUAL ADDITIONS START -->

{scaffold_ca_python-0.1.2 → scaffold_ca_python-0.1.4}/.pre-commit-config.yaml

@@ -1,5 +1,10 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
+
+# SDD documentation and Spec-Kit tooling are authored artifacts, not source code:
+# keep the fixer/formatter hooks out of them so runs stay scoped to code changes.
+exclude: '^(\.specify/|specs/|\.github/agents/)'
+
 repos:
 -   repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0

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

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

{scaffold_ca_python-0.1.2 → scaffold_ca_python-0.1.4}/.specify/memory/constitution.md

@@ -258,4 +258,4 @@ dependencies listed in Principle III, installed via `uv` at generation time.
 - Compliance reviews MUST occur at the start of each new feature branch and before
   merging to `main`.
 
-**Version**: 1.0.0 | **Ratified**: 2026-03-25 | **Last Amended**: 2026-03-25
+**Version**: 2.0.3 | **Ratified**: 2026-03-25 | **Last Amended**: 2026-04-10

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

@@ -1,5 +1,19 @@
 # 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)
+
+
+### Documentation
+
+* clean up SDD specification audit artifacts ([1a0374e](https://github.com/bancolombia/scaffold-clean-architecture-py/commit/1a0374e5895864718b9c6ee7b0990023942441fa))
+
 ## [0.1.2](https://github.com/bancolombia/scaffold-clean-architecture-py/compare/v0.1.1...v0.1.2) (2026-09-16)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scaffold-ca-python
-Version: 0.1.2
+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,8 +217,8 @@ scaffold update-project --dry-run
 |----------------|---------|------|
 | Python | >=3.13 | Runtime |
 | uv | latest | Dependency management, build, and publish |
-| Typer | >=0.16.0 | CLI framework |
-| Rich | >=14.1.0 | Terminal output formatting |
+| 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 |
 | hatchling | latest | Build backend |
@@ -248,12 +248,12 @@ scaffold update-project --dry-run
 
 ## Contributing
 
-1. Fork the upstream repository on GitHub: https://github.com/santicalleg/scaffold-ca-python
+1. Fork the upstream repository on GitHub: https://github.com/bancolombia/scaffold-clean-architecture-py
 2. Clone your fork.
 
 ```bash
-git clone https://github.com/YOUR-USER/scaffold-ca-python.git
-cd scaffold-ca-python
+git clone https://github.com/YOUR-USER/scaffold-clean-architecture-py.git
+cd scaffold-clean-architecture-py
 ```
 
 3. Set up the development environment.

{scaffold_ca_python-0.1.2 → 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,8 +186,8 @@ scaffold update-project --dry-run
 |----------------|---------|------|
 | Python | >=3.13 | Runtime |
 | uv | latest | Dependency management, build, and publish |
-| Typer | >=0.16.0 | CLI framework |
-| Rich | >=14.1.0 | Terminal output formatting |
+| 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 |
 | hatchling | latest | Build backend |
@@ -217,12 +217,12 @@ scaffold update-project --dry-run
 
 ## Contributing
 
-1. Fork the upstream repository on GitHub: https://github.com/santicalleg/scaffold-ca-python
+1. Fork the upstream repository on GitHub: https://github.com/bancolombia/scaffold-clean-architecture-py
 2. Clone your fork.
 
 ```bash
-git clone https://github.com/YOUR-USER/scaffold-ca-python.git
-cd scaffold-ca-python
+git clone https://github.com/YOUR-USER/scaffold-clean-architecture-py.git
+cd scaffold-clean-architecture-py
 ```
 
 3. Set up the development environment.

{scaffold_ca_python-0.1.2 → 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.2 → scaffold_ca_python-0.1.4}/specs/015-factory-builder-refactor/tasks.md

@@ -78,8 +78,8 @@ command tests pass with no modifications.
  [x] T027 [P] [US2] Implement `DrivenAdapterSecrets` in `src/scaffold_ca_python/factory/driven_adapters/da_secrets.py`
  [x] T028 [P] [US2] Write failing tests for `DrivenAdapterGeneric.build()` in `tests/factory/driven_adapters/test_da_generic.py`
  [x] T029 [P] [US2] Implement `DrivenAdapterGeneric` in `src/scaffold_ca_python/factory/driven_adapters/da_generic.py`
-- [ ] T030 [US2] Refactor `src/scaffold_ca_python/commands/generate_driven_adapter.py` to thin + `_REGISTRY`; remove FileWriter/TemplateRenderer/pyproject_writer imports
-- [ ] T031 [US2] Run `uv run pytest tests/commands/ --no-cov -q` and confirm zero regressions (no test file modified)
+- [x] T030 [US2] Refactor `src/scaffold_ca_python/commands/generate_driven_adapter.py` to thin + `_REGISTRY`; remove FileWriter/TemplateRenderer/pyproject_writer imports
+- [x] T031 [US2] Run `uv run pytest tests/commands/ --no-cov -q` and confirm zero regressions (no test file modified)
 
 ---
 
@@ -111,20 +111,20 @@ command in scope uses only `ModuleBuilder`. After this phase, no command file im
 
 **Independent test**: `uv run pytest tests/factory/test_registry.py tests/factory/test_dry_run_parity.py --no-cov -q`
 
-- [ ] T042 [US4] Write `tests/factory/test_registry.py` — assert `_REGISTRY` for `gep` contains exactly {restapi, agent, mcp, generic}; assert `_REGISTRY` for `gda` contains exactly {rest-consumer, secrets, generic}; assert all 6 simple commands have `_REGISTRY` with their respective types; assert unknown type lookup produces error listing valid keys
-- [ ] T043 [US4] Write `tests/factory/test_dry_run_parity.py` — for each type in both commands, compare dry-run preview path set against a captured pre-refactor baseline fixture
-- [ ] T044 [US4] Write SC-002 extensibility proof test in `tests/factory/test_extensibility.py` — define a stub factory inline, register it under a new key in a patched `_REGISTRY`, invoke the command with the stub type, assert factory was called; zero existing command files modified
+- [x] T042 [US4] Write `tests/factory/test_registry.py` — assert `_REGISTRY` for `gep` contains exactly {restapi, agent, mcp, generic}; assert `_REGISTRY` for `gda` contains exactly {rest-consumer, secrets, generic}; assert all 6 simple commands have `_REGISTRY` with their respective types; assert unknown type lookup produces error listing valid keys
+- [x] T043 [US4] Write `tests/factory/test_dry_run_parity.py` — for each type in both commands, compare dry-run preview path set against a captured pre-refactor baseline fixture
+- [x] T044 [US4] Write SC-002 extensibility proof test in `tests/factory/test_extensibility.py` — define a stub factory inline, register it under a new key in a patched `_REGISTRY`, invoke the command with the stub type, assert factory was called; zero existing command files modified
 
 ---
 
 ## Phase 7 — Polish & Quality Gates
 
-- [ ] T045 Run `uv run pytest` and confirm all tests pass with ≥ 95% coverage
-- [ ] T045b Assert template immutability: `git diff HEAD -- src/scaffold_ca_python/templates/` must be empty — no template file modified during implementation (FR-009)
-- [ ] T045c Assert model immutability: confirm no new files exist under `src/scaffold_ca_python/models/` beyond the pre-refactor baseline (FR-010)
-- [ ] T046 [P] Run `uv run ruff check src/ tests/` and fix any violations
-- [ ] T047 [P] Run `uv run ruff format src/ tests/` to normalise formatting
-- [ ] T048 [P] Run `uv run mypy src/` and confirm 0 new errors under strict mode
+- [x] T045 Run `uv run pytest` and confirm all tests pass with ≥ 95% coverage
+- [x] T045b Assert template immutability: `git diff HEAD -- src/scaffold_ca_python/templates/` must be empty — no template file modified during implementation (FR-009)
+- [x] T045c Assert model immutability: confirm no new files exist under `src/scaffold_ca_python/models/` beyond the pre-refactor baseline (FR-010)
+- [x] T046 [P] Run `uv run ruff check src/ tests/` and fix any violations
+- [x] T047 [P] Run `uv run ruff format src/ tests/` to normalise formatting
+- [x] T048 [P] Run `uv run mypy src/` and confirm 0 new errors under strict mode
 
 ---
 

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.2 → scaffold_ca_python-0.1.4}/specs/019-mcp-entry-point-restructure/plan.md

@@ -1,7 +1,7 @@
 # Implementation Plan: MCP Entry Point Restructure
 
-**Branch**: `019-mcp-entry-point-restructure` | **Date**: 2026-04-16 | **Spec**: [spec.md](../018-mcp-entry-point-restructure/spec.md)  
-**Input**: Feature specification from `/specs/018-mcp-entry-point-restructure/spec.md`
+**Branch**: `019-mcp-entry-point-restructure` | **Date**: 2026-04-16 | **Spec**: [spec.md](spec.md)  
+**Input**: Feature specification from `/specs/019-mcp-entry-point-restructure/spec.md`
 
 ## Summary
 

{scaffold_ca_python-0.1.2 → 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.2 → 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.2 → 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,