refactor(examples): CLI interface improvements

changes:
  - file: auto_loop.py
    area: cli
    modified: [auto_loop]
  - file: commands.py
    area: cli
    added: [generate_strategy_cli]
  - file: 02_mcp_integration.py
    area: core
    added: [simulate_planfile_apply, run_mcp_tool, simulate_planfile_review, simulate_planfile_generate, create_mcp_tool_definitions, example_mcp_session]
  - file: 03_proxy_routing.py
    area: core
    added: [__init__, example_budget_tracking, get_usage_stats, ProxyClient, get_routing_decision, example_strategy_generation_with_proxy, +2 more]
  - file: 04_llx_integration.py
    area: core
    added: [__init__, select_model, _calculate_complexity_score, analyze_project, example_metric_driven_planning, ProjectMetrics, +5 more]
  - file: test_interactive_mode.py
    area: test
    added: [run_interactive_planfile, main]
    new_tests: 2
  - file: llx_validator.py
    area: core
    added: [__init__, _is_llx_available, validate_strategy, _parse_llx_analysis, create_validation_script, analyze_generated_code, +2 more]
  - file: summary.py
    area: core
    added: [create_summary]
  - file: test_all_examples.py
    area: test
    added: [__init__, _validate_strategy_with_llm, _test_shell_example, ExampleTester, main, _validate_yaml, +7 more]
    new_tests: 1
  - file: github.py
    area: core
    modified: [GitHubBackend, __init__]
  - file: gitlab.py
    area: core
    modified: [__init__, GitLabBackend]
  - file: jira.py
    area: core
    modified: [__init__, JiraBackend]
  - file: client.py
    area: cli
    added: [call_llm]
  - file: generator.py
    area: core
    added: [_parse_strategy_response, generate_strategy, _auto_select_model, _basic_metrics, _collect_metrics]
  - file: prompts.py
    area: core
    added: [build_strategy_prompt]

testing:
  new_tests: 3
  scenarios:
    - interactive_mode
    - expect_script
    - all_examples

dependencies:
  flow: "commands→auto_loop"
  - commands.py -> auto_loop.py

stats:
  lines: "+4589/-54 (net +4535)"
  files: 32
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.12] - 2026-03-26
+
+### Docs
+- Update docs/CLI.md
+- Update docs/README.md
+- Update planfile/examples/README.md
+
+### Other
+- Update planfile/cli/auto_loop.py
+- Update planfile/cli/commands.py
+- Update planfile/examples/bash-generation/test_planfile_generation.sh
+- Update planfile/examples/bash-generation/verify_planfile.sh
+- Update planfile/examples/ecosystem/01_full_workflow.sh
+- Update planfile/examples/ecosystem/02_mcp_integration.py
+- Update planfile/examples/ecosystem/03_proxy_routing.py
+- Update planfile/examples/ecosystem/04_llx_integration.py
+- Update planfile/examples/interactive-tests/test_interactive_expect.sh
+- Update planfile/examples/interactive-tests/test_interactive_mode.py
+- ... and 19 more files
+
 ## [0.1.11] - 2026-03-26
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.1.11
+0.1.12

docs/CLI.md

@@ -47,7 +47,7 @@ Options:
 Examples:
 ```bash
 # Basic auto-loop
-planfile auto loop --strategy strategy.yaml
+planfile auto loop --strategy planfile.yaml
 
 # With multiple backends
 planfile auto loop --strategy strategy.yaml --backend github --backend jira

docs/README.md

@@ -1,4 +1,4 @@
-<!-- code2docs:start --># planfile
+<!-- code2docs:start --># strategy
 
 ![version](https://img.shields.io/badge/version-0.1.0-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.10-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-90-green)
 > **90** functions | **19** classes | **22** files | CC̄ = 5.4
@@ -7,32 +7,32 @@
 
 **Author:** Tom Sapletta  
 **License:** Apache-2.0[(LICENSE)](./LICENSE)  
-**Repository:** [https://github.com/semcod/planfile](https://github.com/semcod/planfile)
+**Repository:** [https://github.com/semcod/strategy](https://github.com/semcod/strategy)
 
 ## Installation
 
 ### From PyPI
 
 ```bash
-pip install planfile
+pip install strategy
 ```
 
 ### From Source
 
 ```bash
-git clone https://github.com/semcod/planfile
-cd planfile
+git clone https://github.com/semcod/strategy
+cd strategy
 pip install -e .
 ```
 
 ### Optional Extras
 
 ```bash
-pip install planfile[github]    # github features
-pip install planfile[jira]    # jira features
-pip install planfile[gitlab]    # gitlab features
-pip install planfile[all]    # all optional features
-pip install planfile[dev]    # development tools
+pip install strategy[github]    # github features
+pip install strategy[jira]    # jira features
+pip install strategy[gitlab]    # gitlab features
+pip install strategy[all]    # all optional features
+pip install strategy[dev]    # development tools
 ```
 
 ## Quick Start
@@ -41,25 +41,25 @@ pip install planfile[dev]    # development tools
 
 ```bash
 # Generate full documentation for your project
-planfile ./my-project
+strategy ./my-project
 
 # Only regenerate README
-planfile ./my-project --readme-only
+strategy ./my-project --readme-only
 
 # Preview what would be generated (no file writes)
-planfile ./my-project --dry-run
+strategy ./my-project --dry-run
 
 # Check documentation health
-planfile check ./my-project
+strategy check ./my-project
 
 # Sync — regenerate only changed modules
-planfile sync ./my-project
+strategy sync ./my-project
 ```
 
 ### Python API
 
 ```python
-from planfile import generate_readme, generate_docs, Code2DocsConfig
+from strategy import generate_readme, generate_docs, Code2DocsConfig
 
 # Quick: generate README
 generate_readme("./my-project")
@@ -71,7 +71,7 @@ docs = generate_docs("./my-project", config=config)
 
 ## Generated Output
 
-When you run `planfile`, the following files are produced:
+When you run `strategy`, the following files are produced:
 
 ```
 <project>/
@@ -94,7 +94,7 @@ When you run `planfile`, the following files are produced:
 
 ## Configuration
 
-Create `planfile.yaml` in your project root (or run `planfile init`):
+Create `strategy.yaml` in your project root (or run `strategy init`):
 
 ```yaml
 project:
@@ -126,7 +126,7 @@ examples:
   from_entry_points: true
 
 sync:
-  planfile: markers    # markers | full | git-diff
+  strategy: markers    # markers | full | git-diff
   watch: false
   ignore:
     - "tests/"
@@ -135,22 +135,22 @@ sync:
 
 ## Sync Markers
 
-planfile can update only specific sections of an existing README using HTML comment markers:
+strategy can update only specific sections of an existing README using HTML comment markers:
 
 ```markdown
-<!-- planfile:start -->
+<!-- strategy:start -->
 # Project Title
 ... auto-generated content ...
-<!-- planfile:end -->
+<!-- strategy:end -->
 ```
 
 Content outside the markers is preserved when regenerating. Enable this with `sync_markers: true` in your configuration.
 
 ## Architecture
 
 ```
-planfile/
-├── planfile/    ├── runner        ├── yaml_loader    ├── loaders/        ├── cli_loader        ├── auto_loop    ├── cli/        ├── __main__        ├── priorities    ├── utils/        ├── metrics        ├── commands    ├── integrations/        ├── gitlab        ├── jira        ├── github        ├── generic├── docker-entrypoint├── project    ├── ci_runner    ├── models        ├── base```
+strategy/
+├── planfile/        ├── yaml_loader        ├── cli_loader    ├── loaders/    ├── runner        ├── auto_loop    ├── cli/        ├── __main__        ├── priorities    ├── utils/        ├── commands        ├── metrics    ├── integrations/        ├── gitlab        ├── jira        ├── github        ├── generic├── docker-entrypoint├── project    ├── ci_runner    ├── models        ├── base```
 
 ## API Overview
 
@@ -178,8 +178,6 @@ planfile/
 
 ### Functions
 
-- `apply_strategy(strategy, project_path, backends, backend_name)` — Apply a strategy to create/update tickets.
-- `review_strategy(strategy, project_path, backends, backend_name)` — Review strategy execution by checking ticket statuses.
 - `load_yaml(file_path)` — Load YAML file and return as dictionary.
 - `save_yaml(data, file_path)` — Save dictionary to YAML file.
 - `load_strategy_yaml(file_path)` — Load strategy from YAML file.
@@ -192,19 +190,21 @@ planfile/
 - `load_strategy_from_json(file_path)` — Load strategy from JSON file.
 - `save_strategy_to_json(strategy, file_path)` — Save strategy to JSON file.
 - `export_results_to_markdown(results, file_path)` — Export strategy results to Markdown file.
+- `apply_strategy(strategy, project_path, backends, backend_name)` — Apply a strategy to create/update tickets.
+- `review_strategy(strategy, project_path, backends, backend_name)` — Review strategy execution by checking ticket statuses.
 - `get_backend(backend_type)` — Get backend instance by type.
 - `auto_loop(strategy, project_path, backend, max_iterations)` — Run automated CI/CD loop: test → ticket → fix → retest.
 - `ci_status(project_path)` — Check current CI status without running tests.
 - `calculate_task_priority(base_priority, task_type, sprint_id, weight_factors)` — Calculate task priority based on type, sprint, and base priority.
 - `map_priority_to_system(priority, system)` — Map generic priority to system-specific priority.
 - `get_priority_color(priority)` — Get color code for priority (for UI display).
-- `analyze_project_metrics(project_path)` — Analyze project metrics for strategy review.
-- `calculate_strategy_health(strategy_results)` — Calculate health metrics for a strategy execution.
 - `get_backend(backend_type, config)` — Get backend instance by type and config.
 - `apply_strategy_cli(strategy_path, project_path, backend, config_file)` — Apply a strategy to create tickets.
 - `review_strategy_cli(strategy_path, project_path, backend, config_file)` — Review strategy execution and progress.
 - `validate_strategy_cli(strategy_path, verbose)` — Validate a strategy YAML file.
 - `main()` — Main CLI entry point.
+- `analyze_project_metrics(project_path)` — Analyze project metrics for strategy review.
+- `calculate_strategy_health(strategy_results)` — Calculate health metrics for a strategy execution.
 - `check_env()` — —
 - `validate_config()` — —
 - `setup_workspace()` — —

planfile/__init__.py

@@ -7,7 +7,7 @@
 - CLI and API for applying and reviewing strategies
 """
 
-__version__ = "0.1.11"
+__version__ = "0.1.12"
 __author__ = "Tom Sapletta"
 __email__ = "tom@sapletta.com"
 

planfile/cli/auto_loop.py

@@ -3,7 +3,7 @@
 """
 import typer
 from pathlib import Path
-from typing import Optional, List
+from typing import Optional, List, Any
 from rich.console import Console
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from rich.table import Table
@@ -15,6 +15,7 @@
 import os
 
 console = Console()
+app = typer.Typer(help="Automated CI/CD commands")
 
 
 def get_backend(backend_type: str) -> Any:
@@ -77,7 +78,7 @@ def auto_loop(
     console.print()
 
     # Validate strategy exists
-    if not planfile.exists():
+    if not strategy.exists():
         console.print(f"[red]✗ Strategy file not found: {strategy}[/red]")
         raise typer.Exit(1)
 
@@ -150,7 +151,7 @@ def auto_loop(
     # Final status
     if results["success"]:
         console.print("\n[green]✅ Loop completed successfully![/green]")
-        console.print(f"Strategy '{runner.planfile.name}' is complete!")
+        console.print(f"Strategy '{strategy.name}' is complete!")
     else:
         console.print(f"\n[red]❌ Loop failed: {results['final_status']}[/red]")
         console.print(f"Total iterations: {results['total_iterations']}")
@@ -212,6 +213,4 @@ def ci_status(
             console.print(f"  • {f}")
 
 
-# Add to main CLI
-from .commands import app
-app.add_typer(typer.Typer(name="auto", help="Automated CI/CD commands"), name="auto")
+# Note: This module is imported by commands.py to add the auto subcommand

planfile/cli/commands.py

@@ -16,11 +16,15 @@
 from ..integrations.jira import JiraBackend
 from ..integrations.gitlab import GitLabBackend
 from ..integrations.generic import GenericBackend
+from . import auto_loop
 
 app = typer.Typer(help="Strategy CLI - Manage strategies and sprints")
 console = Console()
 logger = logging.getLogger(__name__)
 
+# Add auto subcommand
+app.add_typer(auto_loop.app, name="auto", help="Automated CI/CD commands")
+
 
 def get_backend(backend_type: str, config: dict):
     """Get backend instance by type and config."""
@@ -323,6 +327,47 @@ def validate_strategy_cli(
         raise typer.Exit(1)
 
 
+@app.command("generate")
+def generate_strategy_cli(
+    project_path: str = typer.Argument(".", help="Project path to analyze"),
+    output: str = typer.Option("strategy.yaml", help="Output file path"),
+    model: Optional[str] = typer.Option(None, help="LiteLLM model ID"),
+    sprints: int = typer.Option(3, help="Number of sprints to generate"),
+    focus: Optional[str] = typer.Option(None, help="Focus area: complexity, duplication, tests, docs"),
+    toon_dir: Optional[str] = typer.Option(None, help="Pre-existing .toon analysis directory"),
+    dry_run: bool = typer.Option(False, help="Show prompt but don't call LLM"),
+):
+    """Generate strategy.yaml from project analysis + LLM."""
+    from ..llm.generator import generate_strategy
+    from ..loaders.yaml_loader import save_strategy_yaml
+
+    try:
+        console.print(f"[bold]Analyzing project:[/bold] {project_path}")
+        
+        strategy = generate_strategy(
+            project_path,
+            model=model,
+            sprints=sprints,
+            focus=focus,
+            toon_dir=toon_dir,
+            dry_run=dry_run,
+        )
+
+        if not dry_run:
+            save_strategy_yaml(strategy, output)
+            console.print(f"[green]✓[/green] Strategy saved to: {output}")
+            console.print(f"  Sprints: {len(strategy.sprints)}")
+            total_tasks = sum(len(s.task_patterns) for s in strategy.sprints)
+            console.print(f"  Tasks: {total_tasks}")
+            
+            if strategy.quality_gates:
+                console.print(f"  Quality Gates: {len(strategy.quality_gates)}")
+    
+    except Exception as e:
+        console.print(f"[red]✗[/red] Generation failed: {e}")
+        raise typer.Exit(1)
+
+
 def main():
     """Main CLI entry point."""
     app()