claude-code-generator 0.2.0__tar.gz → 0.2.1__tar.gz

{claude_code_generator-0.2.0/src/claude_code_generator.egg-info → claude_code_generator-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-generator
-Version: 0.2.0
+Version: 0.2.1
 Summary: Orchestrator CLI that drives Claude Code end-to-end to generate whole projects from a requirements.md file.
 Author: Silvio Baratto
 License: MIT
@@ -31,7 +31,7 @@ Dynamic: license-file
 
 # code-generator
 
-A Python CLI that orchestrates Claude Code end-to-end to generate a whole project from a `requirements.md` file. Three commands — `init`, `generate`, `review` — plus `status`. Works for any project type: Python CLI, FastAPI, Angular, NestJS, full-stack, finance, BAML/LLM.
+A Python CLI that orchestrates Claude Code end-to-end to generate a whole project from a `requirements.md` file. Five commands — `init`, `optimize`, `generate`, `review`, `status`. Works for any project type: Python CLI, FastAPI, Angular, NestJS, full-stack, finance, BAML/LLM.
 
 > **Max subscription only.** This tool uses **exclusively** the Claude Max subscription. It strips every environment variable that could route a call through the API and aborts on startup if any are still present. There is no path to API credit billing — see [Safety constraints](#safety-constraints) below.
 
@@ -68,6 +68,20 @@ code-generator init --template fastapi
 $EDITOR .code-generator/requirements.md
 ```
 
+### `code-generator optimize [--dry-run] [--force]`
+
+Pre-flight rewrite of `.code-generator/requirements.md` into the canonical structure the orchestrator expects: `# Title` → `## Description` → `## Tech Stack` → `## Goals` → `## Scope` (numbered `### N.` subsections with per-section `Acceptance criteria` checklists) → `## Non-goals` → `## Constraints` → `## Global acceptance criteria`.
+
+Runs a single Opus 4.6 session with a dedicated prompt, preserves the original intent verbatim when ambiguous (never invents new scope), and writes the rewrite back to disk atomically. The pre-optimize original is saved to `.code-generator/requirements.backup-<UTC-timestamp>.md` so you can always `diff` and recover. The command is stateless — it never reads or writes `state.json` and never calls `gh`.
+
+Short-circuits and exits 0 if the file is already canonical. Use `--force` to re-optimize anyway. Use `--dry-run` to print the proposed rewrite to stdout without touching the file or creating a backup.
+
+```bash
+code-generator optimize --dry-run    # preview
+code-generator optimize              # commit the rewrite
+code-generator generate              # then run the pipeline
+```
+
 ### `code-generator generate [flags]`
 
 Read `.code-generator/requirements.md` and orchestrate Claude Code through the 0→7 phase pipeline:
@@ -155,7 +169,7 @@ src/code_generator/
 │   ├── phase6_test.py        # test runner, max 3 retries
 │   ├── phase7_commit.py      # Opus commit message + push with rebase retry
 │   └── cycle_loop.py         # multi-cycle driver
-└── commands/             # init, status, generate, review (Typer commands)
+└── commands/             # init, optimize, status, generate, review (Typer commands)
 ```
 
 ## Development

{claude_code_generator-0.2.0 → claude_code_generator-0.2.1}/README.md

@@ -1,6 +1,6 @@
 # code-generator
 
-A Python CLI that orchestrates Claude Code end-to-end to generate a whole project from a `requirements.md` file. Three commands — `init`, `generate`, `review` — plus `status`. Works for any project type: Python CLI, FastAPI, Angular, NestJS, full-stack, finance, BAML/LLM.
+A Python CLI that orchestrates Claude Code end-to-end to generate a whole project from a `requirements.md` file. Five commands — `init`, `optimize`, `generate`, `review`, `status`. Works for any project type: Python CLI, FastAPI, Angular, NestJS, full-stack, finance, BAML/LLM.
 
 > **Max subscription only.** This tool uses **exclusively** the Claude Max subscription. It strips every environment variable that could route a call through the API and aborts on startup if any are still present. There is no path to API credit billing — see [Safety constraints](#safety-constraints) below.
 
@@ -37,6 +37,20 @@ code-generator init --template fastapi
 $EDITOR .code-generator/requirements.md
 ```
 
+### `code-generator optimize [--dry-run] [--force]`
+
+Pre-flight rewrite of `.code-generator/requirements.md` into the canonical structure the orchestrator expects: `# Title` → `## Description` → `## Tech Stack` → `## Goals` → `## Scope` (numbered `### N.` subsections with per-section `Acceptance criteria` checklists) → `## Non-goals` → `## Constraints` → `## Global acceptance criteria`.
+
+Runs a single Opus 4.6 session with a dedicated prompt, preserves the original intent verbatim when ambiguous (never invents new scope), and writes the rewrite back to disk atomically. The pre-optimize original is saved to `.code-generator/requirements.backup-<UTC-timestamp>.md` so you can always `diff` and recover. The command is stateless — it never reads or writes `state.json` and never calls `gh`.
+
+Short-circuits and exits 0 if the file is already canonical. Use `--force` to re-optimize anyway. Use `--dry-run` to print the proposed rewrite to stdout without touching the file or creating a backup.
+
+```bash
+code-generator optimize --dry-run    # preview
+code-generator optimize              # commit the rewrite
+code-generator generate              # then run the pipeline
+```
+
 ### `code-generator generate [flags]`
 
 Read `.code-generator/requirements.md` and orchestrate Claude Code through the 0→7 phase pipeline:
@@ -124,7 +138,7 @@ src/code_generator/
 │   ├── phase6_test.py        # test runner, max 3 retries
 │   ├── phase7_commit.py      # Opus commit message + push with rebase retry
 │   └── cycle_loop.py         # multi-cycle driver
-└── commands/             # init, status, generate, review (Typer commands)
+└── commands/             # init, optimize, status, generate, review (Typer commands)
 ```
 
 ## Development

{claude_code_generator-0.2.0 → claude_code_generator-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-code-generator"
-version = "0.2.0"
+version = "0.2.1"
 description = "Orchestrator CLI that drives Claude Code end-to-end to generate whole projects from a requirements.md file."
 readme = "README.md"
 license = { text = "MIT" }

{claude_code_generator-0.2.0 → claude_code_generator-0.2.1/src/claude_code_generator.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-generator
-Version: 0.2.0
+Version: 0.2.1
 Summary: Orchestrator CLI that drives Claude Code end-to-end to generate whole projects from a requirements.md file.
 Author: Silvio Baratto
 License: MIT
@@ -31,7 +31,7 @@ Dynamic: license-file
 
 # code-generator
 
-A Python CLI that orchestrates Claude Code end-to-end to generate a whole project from a `requirements.md` file. Three commands — `init`, `generate`, `review` — plus `status`. Works for any project type: Python CLI, FastAPI, Angular, NestJS, full-stack, finance, BAML/LLM.
+A Python CLI that orchestrates Claude Code end-to-end to generate a whole project from a `requirements.md` file. Five commands — `init`, `optimize`, `generate`, `review`, `status`. Works for any project type: Python CLI, FastAPI, Angular, NestJS, full-stack, finance, BAML/LLM.
 
 > **Max subscription only.** This tool uses **exclusively** the Claude Max subscription. It strips every environment variable that could route a call through the API and aborts on startup if any are still present. There is no path to API credit billing — see [Safety constraints](#safety-constraints) below.
 
@@ -68,6 +68,20 @@ code-generator init --template fastapi
 $EDITOR .code-generator/requirements.md
 ```
 
+### `code-generator optimize [--dry-run] [--force]`
+
+Pre-flight rewrite of `.code-generator/requirements.md` into the canonical structure the orchestrator expects: `# Title` → `## Description` → `## Tech Stack` → `## Goals` → `## Scope` (numbered `### N.` subsections with per-section `Acceptance criteria` checklists) → `## Non-goals` → `## Constraints` → `## Global acceptance criteria`.
+
+Runs a single Opus 4.6 session with a dedicated prompt, preserves the original intent verbatim when ambiguous (never invents new scope), and writes the rewrite back to disk atomically. The pre-optimize original is saved to `.code-generator/requirements.backup-<UTC-timestamp>.md` so you can always `diff` and recover. The command is stateless — it never reads or writes `state.json` and never calls `gh`.
+
+Short-circuits and exits 0 if the file is already canonical. Use `--force` to re-optimize anyway. Use `--dry-run` to print the proposed rewrite to stdout without touching the file or creating a backup.
+
+```bash
+code-generator optimize --dry-run    # preview
+code-generator optimize              # commit the rewrite
+code-generator generate              # then run the pipeline
+```
+
 ### `code-generator generate [flags]`
 
 Read `.code-generator/requirements.md` and orchestrate Claude Code through the 0→7 phase pipeline:
@@ -155,7 +169,7 @@ src/code_generator/
 │   ├── phase6_test.py        # test runner, max 3 retries
 │   ├── phase7_commit.py      # Opus commit message + push with rebase retry
 │   └── cycle_loop.py         # multi-cycle driver
-└── commands/             # init, status, generate, review (Typer commands)
+└── commands/             # init, optimize, status, generate, review (Typer commands)
 ```
 
 ## Development

{claude_code_generator-0.2.0 → claude_code_generator-0.2.1}/src/code_generator/__init__.py

@@ -1,3 +1,3 @@
 """code-generator: orchestrator CLI for end-to-end project generation."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{claude_code_generator-0.2.0 → claude_code_generator-0.2.1}/src/code_generator/orchestrator/phase2_review.py

@@ -18,7 +18,7 @@ from code_generator.orchestrator._comments import fetch_formatted_comments
 from code_generator.prompts import load_prompt
 from code_generator.runner import rate_limit, retry
 from code_generator.runner.options import make_agent_options
-from code_generator.runner.types import TokenUsage
+from code_generator.runner.types import MaxTurnsExceeded, TokenUsage
 from code_generator.state import get_issues, save_state
 
 if TYPE_CHECKING:
@@ -84,7 +84,7 @@ async def run(
             effort=effort_level,
             allowed_tools=["Read", "Bash", "Glob", "Grep"],
             cwd=str(project_dir),
-            max_turns=15,
+            max_turns=40,
         )
 
         breaker = retry.CircuitBreaker(max_failures=3)
@@ -103,6 +103,21 @@ async def run(
                 breaker=breaker,
             )
             issue_usage = result.usage if result is not None else TokenUsage()
+        except MaxTurnsExceeded:
+            reviewed = False
+            logger.error(
+                "Phase 2: issue #%d hit max_turns ceiling"
+                " — no retry (deterministic failure), tagging for manual review.",
+                issue.number,
+            )
+            try:
+                gh.add_label(issue.number, "needs-manual-review")
+            except gh.GhError as exc:
+                logger.warning(
+                    "Could not add needs-manual-review label to #%d: %s",
+                    issue.number,
+                    exc,
+                )
         except retry.CircuitOpen:
             reviewed = False
             logger.error(