stackforge-cli 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

stackforge/engines/dotnet/__init__.py

@@ -3,6 +3,6 @@ from .csproj_generator import generate_csproj
 from .program_generator import generate_configure_services, generate_program_cs
 from .docker_generator import generate_dockerfile, generate_docker_compose
 from .config_generator import generate_env, generate_appsettings, generate_appsettings_development
-from .git_generator import generate_gitignore, git_init
+from .git_generator import generate_gitignore, generate_github_workflow, git_init
 from .api_generator import generate_api_structure
 from .layers_generator import generate_domain_layer, generate_application_layer, generate_infrastructure_layer, generate_persistence_layer

stackforge/engines/dotnet/api_generator.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+from stackforge import ui
 
 
 def generate_api_structure(base: Path, project: str):
@@ -28,7 +29,7 @@ def generate_api_structure(base: Path, project: str):
     _generate_login_dto(base, project)
     _generate_account_controller(base, project)
 
-    print("  [+] API/ structure and files")
+    ui.file_created("API/ structure and files")
 
 
 def _generate_base_controller(base: Path, project: str):

stackforge/engines/dotnet/config_generator.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+from stackforge import ui
 
 
 def generate_env(base: Path, project: str):
@@ -18,7 +19,7 @@ JWT_EXPIRY_MINUTES=60
 
     file_path = base / ".env"
     file_path.write_text(content)
-    print("  [+] .env")
+    ui.file_created(".env")
 
 
 def generate_appsettings(base: Path, project: str):
@@ -46,7 +47,7 @@ def generate_appsettings(base: Path, project: str):
 
     file_path = base / "API" / "appsettings.json"
     file_path.write_text(content)
-    print("  [+] API/appsettings.json")
+    ui.file_created("API/appsettings.json")
 
 
 def generate_appsettings_development(base: Path, project: str):
@@ -73,4 +74,4 @@ def generate_appsettings_development(base: Path, project: str):
 
     file_path = base / "API" / "appsettings.Development.json"
     file_path.write_text(content)
-    print("  [+] API/appsettings.Development.json")
+    ui.file_created("API/appsettings.Development.json")

stackforge/engines/dotnet/csproj_generator.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+from stackforge import ui
 
 
 LAYER_CONFIGS = {
@@ -79,4 +80,4 @@ def generate_csproj(layer: str, base: Path):
 
     csproj_path = base / layer / f"{layer}.csproj"
     csproj_path.write_text(content.strip())
-    print(f"  [+] {layer}/{layer}.csproj")
+    ui.file_created(f"{layer}/{layer}.csproj")

stackforge/engines/dotnet/docker_generator.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+from stackforge import ui
 
 
 def generate_dockerfile(base: Path):
@@ -14,7 +15,7 @@ ENTRYPOINT ["dotnet", "out/API.dll"]
 
     file_path = base / "Dockerfile"
     file_path.write_text(content)
-    print("  [+] Dockerfile")
+    ui.file_created("Dockerfile")
 
 
 def generate_docker_compose(base: Path, project: str):
@@ -60,4 +61,4 @@ volumes:
 
     file_path = base / "docker-compose.yml"
     file_path.write_text(content)
-    print("  [+] docker-compose.yml")
+    ui.file_created("docker-compose.yml")

stackforge/engines/dotnet/git_generator.py

@@ -1,5 +1,6 @@
 import subprocess
 from pathlib import Path
+from stackforge import ui
 
 def generate_sln(base: Path, project: str):
     layers = ["API", "Application", "Domain", "Infrastructure", "Persistence"]
@@ -18,7 +19,7 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 
     file_path = base / f"{project}.sln"
     file_path.write_text(content)
-    print(f"  [+] {project}.sln")
+    ui.file_created(f"{project}.sln")
 
     
 def generate_gitignore(base: Path):
@@ -41,16 +42,55 @@ out/
 
     file_path = base / ".gitignore"
     file_path.write_text(content)
-    print("  [+] .gitignore")
+    ui.file_created(".gitignore")
+
+
+def generate_github_workflow(base: Path):
+    workflow_dir = base / ".github" / "workflows"
+    workflow_dir.mkdir(parents=True, exist_ok=True)
+
+    content = """name: Sync Environment Branches
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  sync-branches:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create staging branch if missing
+        run: |
+          if ! git ls-remote --exit-code origin refs/heads/staging; then
+            git push origin HEAD:refs/heads/staging
+          fi
+
+      - name: Create development branch if missing
+        run: |
+          if ! git ls-remote --exit-code origin refs/heads/development; then
+            git push origin HEAD:refs/heads/development
+          fi
+"""
+    file_path = workflow_dir / "sync-branches.yml"
+    file_path.write_text(content.lstrip())
+    ui.file_created(".github/workflows/sync-branches.yml")
 
 
 def git_init(base: Path, project: str):
     try:
-        subprocess.run(["git", "init"], cwd=base, check=True, capture_output=True)
-        print("  [+] git init")
+        subprocess.run(["git", "init", "-b", "main"], cwd=base, check=True, capture_output=True)
+        ui.file_created("git init (main)")
 
         subprocess.run(["git", "add", "."], cwd=base, check=True, capture_output=True)
-        print("  [+] git add .")
+        ui.file_created("git add .")
 
         subprocess.run(
             ["git", "commit", "-m", f"initial: scaffold {project} with stackforge"],
@@ -58,10 +98,14 @@ def git_init(base: Path, project: str):
             check=True,
             capture_output=True
         )
-        print("  [+] initial commit")
+        ui.file_created("initial commit")
+
+        subprocess.run(["git", "branch", "staging"], cwd=base, check=True, capture_output=True)
+        subprocess.run(["git", "branch", "development"], cwd=base, check=True, capture_output=True)
+        ui.file_created("branches: main, staging, development")
 
     except subprocess.CalledProcessError as e:
-        print(f"  [!] Git error: {e}")
+        ui.error(f"Git error: {e}")
     except FileNotFoundError:
-        print("  [!] Git not found. Make sure Git is installed and in your PATH.")
+        ui.error("Git not found. Make sure Git is installed and in your PATH.")
 

stackforge/engines/dotnet/layers_generator.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+from stackforge import ui
 
 
 def generate_application_layer(base: Path, project: str):
@@ -27,7 +28,7 @@ def generate_application_layer(base: Path, project: str):
     _gen_paged_response(base, project)
     _gen_iso_datetime(base, project)
 
-    print("  [+] Application/ structure and files")
+    ui.file_created("Application/ structure and files")
 
 
 def generate_domain_layer(base: Path, project: str):
@@ -47,7 +48,7 @@ def generate_domain_layer(base: Path, project: str):
     _gen_user_role(base, project)
     _gen_global_usings(base, project)
 
-    print("  [+] Domain/ structure and files")
+    ui.file_created("Domain/ structure and files")
 
 
 def generate_infrastructure_layer(base: Path, project: str):
@@ -60,7 +61,7 @@ def generate_infrastructure_layer(base: Path, project: str):
     for folder in folders:
         (base / folder).mkdir(parents=True, exist_ok=True)
 
-    print("  [+] Infrastructure/ structure and files")
+    ui.file_created("Infrastructure/ structure and files")
 
 
 def generate_persistence_layer(base: Path, project: str):
@@ -78,7 +79,7 @@ def generate_persistence_layer(base: Path, project: str):
     _gen_user_seeder(base, project)
     _gen_user_role_configuration(base, project)
 
-    print("  [+] Persistence/ structure and files")
+    ui.file_created("Persistence/ structure and files")
 
 
 # ── Application files ──────────────────────────────────────────────────────────

stackforge/engines/dotnet/program_generator.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+from stackforge import ui
 
 
 def generate_configure_services(layer: str, base: Path, project: str):
@@ -67,7 +68,7 @@ namespace {project}.Persistence
 
     file_path = base / layer / "ConfigureServices.cs"
     file_path.write_text(templates[layer])
-    print(f"  [+] {layer}/ConfigureServices.cs")
+    ui.file_created(f"{layer}/ConfigureServices.cs")
 
 
 def generate_program_cs(base: Path, project: str):
@@ -191,4 +192,4 @@ app.Run();
 
     file_path = base / "API" / "Program.cs"
     file_path.write_text(content)
-    print("  [+] API/Program.cs")
+    ui.file_created("API/Program.cs")

stackforge/engines/dotnet/scaffolder.py

@@ -1,9 +1,10 @@
 from pathlib import Path
+from stackforge import ui
 from .csproj_generator import generate_csproj
 from .program_generator import generate_configure_services, generate_program_cs
 from .docker_generator import generate_dockerfile, generate_docker_compose
 from .config_generator import generate_env, generate_appsettings, generate_appsettings_development
-from .git_generator import generate_gitignore, generate_sln, git_init
+from .git_generator import generate_gitignore, generate_github_workflow, generate_sln, git_init
 from .api_generator import generate_api_structure
 from .layers_generator import (
     generate_application_layer,
@@ -21,51 +22,53 @@ def scaffold_folders(base: Path, project: str):
         "Persistence"
     ]
 
-    print(f"\nScaffolding folders for project '{project}'...")
+    ui.section(f"Scaffolding '{project}'")
 
+    ui.step("Creating folders")
     for layer in layers:
         folder = base / layer
         folder.mkdir(parents=True, exist_ok=True)
-        print(f"    [+] {layer}")
+        ui.file_created(layer)
 
-    print("\nFolder structure created.")
-
-    print("\nGenerating .csproj files...")
+    ui.section("Generating .csproj files")
     for layer in layers:
         generate_csproj(layer, base)
 
-    print("\nGenerating service registrations...")
+    ui.section("Generating service registrations")
     for layer in ["Application", "Infrastructure", "Persistence"]:
         generate_configure_services(layer, base, project)
 
-    print("\nGenerating Program.cs...")
+    ui.section("Generating Program.cs")
     generate_program_cs(base, project)
 
-    print("\nGenerating Docker files...")
+    ui.section("Generating Docker files")
     generate_dockerfile(base)
     generate_docker_compose(base, project)
 
-    print("\nGenerating config files...")
+    ui.section("Generating config files")
     generate_env(base, project)
     generate_appsettings(base, project)
     generate_appsettings_development(base, project)
 
-    print("\nGenerating API layer...")
+    ui.section("Generating API layer")
     generate_api_structure(base, project)
 
-    print("\nGenerating layer files...")
+    ui.section("Generating layer files")
     generate_application_layer(base, project)
     generate_domain_layer(base, project)
     generate_infrastructure_layer(base, project)
     generate_persistence_layer(base, project)
 
-    print("\nGenerating solution file...")
+    ui.section("Generating solution file")
     generate_sln(base, project)
 
-    print("\nGenerating .gitignore...")
+    ui.section("Generating .gitignore")
     generate_gitignore(base)
 
-    print("\nInitializing Git repository...")
+    ui.section("Generating GitHub workflow")
+    generate_github_workflow(base)
+
+    ui.section("Initializing Git repository")
     git_init(base, project)
 
-    print("\nDone.")
+    ui.done()

stackforge/project_name.py

@@ -0,0 +1,34 @@
+import re
+
+_CAMEL_PARTS = re.compile(r"[A-Z]?[a-z]+|[A-Z]+(?=[A-Z][a-z]|\b)|\d+")
+
+
+def is_valid_project_name(name: str) -> bool:
+    if not name or not name[0].isalpha():
+        return False
+    if not re.fullmatch(r"[A-Za-z0-9_-]+", name):
+        return False
+    if name.startswith(("-", "_")) or name.endswith(("-", "_")):
+        return False
+    if "__" in name or "--" in name:
+        return False
+    return True
+
+
+def _title_part(part: str) -> str:
+    if not part:
+        return ""
+    if part.isdigit():
+        return part
+    return part[0].upper() + part[1:]
+
+
+def to_pascal_case(name: str) -> str:
+    if "_" in name:
+        parts = name.split("_")
+    elif "-" in name:
+        parts = name.split("-")
+    else:
+        parts = _CAMEL_PARTS.findall(name) or [name]
+
+    return "".join(_title_part(part) for part in parts if part)

stackforge/scaffold.py

@@ -1,83 +1,80 @@
 from pathlib import Path
 from stackforge.engines.dotnet.scaffolder import scaffold_folders
-from colorama import init, Fore, Style
-import re
-
-init(autoreset=True)
-
-def is_valid_project_name(name: str) -> bool:
-    return bool(re.match(r'^[A-Za-z][A-Za-z0-9]*$', name))
+from stackforge.version import get_installed_version, notify_if_update_available
+from stackforge.project_name import is_valid_project_name, to_pascal_case
+from stackforge import ui
+import sys
 
 
 def select_framework() -> str:
-    print(f"  {Fore.CYAN}Select a framework:{Style.RESET_ALL}\n")
-    print(f"    {Fore.GREEN}1.{Style.RESET_ALL} .NET Clean Architecture (CQRS)")
-    print(f"    {Fore.YELLOW}2.{Style.RESET_ALL} Django                          [coming soon]")
-    print(f"    {Fore.YELLOW}3.{Style.RESET_ALL} FastAPI                         [coming soon]")
-    print(f"    {Fore.YELLOW}4.{Style.RESET_ALL} Flask                           [coming soon]")
-    print(f"    {Fore.RED}5.{Style.RESET_ALL} exit")
-
-    choice = input(f"\n  {Fore.CYAN}Choice [n]:{Style.RESET_ALL} ").strip() or "1"
+    ui.info("\n  Select a framework:\n")
+    ui.menu_option("1", ".NET Clean Architecture (CQRS)")
+    ui.menu_option("2", "Django                          [coming soon]", style=ui.Fore.YELLOW)
+    ui.menu_option("3", "FastAPI                         [coming soon]", style=ui.Fore.YELLOW)
+    ui.menu_option("4", "Flask                           [coming soon]", style=ui.Fore.YELLOW)
+    ui.menu_option("5", "exit", style=ui.Fore.RED)
+
+    choice = ui.prompt("\n  Choice [1]:") or "1"
     return choice
 
 
 def main():
-    print(Fore.CYAN + r"""
-  _____ _             _    ______
- / ____| |           | |  |  ____|
-| (___ | |_ __ _  ___| | _| |__ ___  _ __ __ _  ___
- \___ \| __/ _` |/ __| |/ /  __/ _ \| '__/ _` |/ _ \
- ____) | || (_| | (__|   <| | | (_) | | | (_| |  __/
-|_____/ \__\__,_|\___|_|\_\_|  \___/|_|  \__, |\___|
-                                           __/ |
-                                          |___/
-""" + Style.RESET_ALL + f"  {Fore.WHITE}.NET Clean Architecture Scaffolder{Style.RESET_ALL}\n")
+    if "--version" in sys.argv or "-V" in sys.argv:
+        print(get_installed_version())
+        return
+
+    notify_if_update_available()
+    ui.banner(".NET Clean Architecture Scaffolder", get_installed_version())
+    print()
 
     while True:
         framework = select_framework()
 
         if framework == "5":
-            print(f"\n  {Fore.YELLOW}Exiting...{Style.RESET_ALL}")
+            ui.warn("\n  Exiting...")
             break
 
         if framework != "1":
-            print(f"\n  {Fore.YELLOW}[!] This framework is under development. Stay tuned!{Style.RESET_ALL}\n")
+            ui.warn("\n  This framework is under development. Stay tuned!\n")
             continue
 
-        project_name = input(f"\n  {Fore.CYAN}Enter project name (PascalCase, no spaces):{Style.RESET_ALL} ").strip()
+        raw_name = ui.prompt(
+            "\n  Enter project name (PascalCase, camelCase, snake_case, or kebab-case):"
+        )
 
-        if not project_name:
-            print(f"  {Fore.RED}[!] Project name cannot be empty.{Style.RESET_ALL}\n")
+        if not raw_name:
+            ui.error("Project name cannot be empty.\n")
             continue
 
-        if not is_valid_project_name(project_name):
-            print(f"  {Fore.RED}[!] Project name must start with a letter and contain only letters and numbers.")
-            print(f"      Example: RaiderXpress, MyApi, StackForge{Style.RESET_ALL}\n")
+        if not is_valid_project_name(raw_name):
+            ui.error("Invalid project name. Use letters, numbers, hyphens, or underscores.")
+            ui.step("Examples: MyApi, myApi, my_api, my-api\n")
             continue
 
+        project_name = to_pascal_case(raw_name)
+        if project_name != raw_name:
+            ui.info(f"  Normalized to: {project_name}")
+
         base_path = Path.home() / "stackforge" / project_name
 
         if base_path.exists():
-            print(f"\n  {Fore.RED}[!] Project '{project_name}' already exists in the stackforge workspace.")
-            print(f"      Path: {base_path}{Style.RESET_ALL}")
-            print("      Choose a different project name or delete the existing one.\n")
+            ui.error(f"\n  Project '{project_name}' already exists in the stackforge workspace.")
+            ui.step(f"Path: {base_path}")
+            ui.step("Choose a different project name or delete the existing one.\n")
             continue
 
         base_path.mkdir(parents=True, exist_ok=True)
         scaffold_folders(base_path, project_name)
 
-        print(f"""
-  {Fore.GREEN}✔ Project '{project_name}' created successfully!
-  ✔ Location: {base_path}{Style.RESET_ALL}
-
-  {Fore.CYAN}Next steps:{Style.RESET_ALL}
-    1. Open the project in Visual Studio or VS Code
-    2. Run: docker-compose up --build
-    3. Visit: http://localhost:5000/swagger
-
-  Press Ctrl+C to exit or continue to scaffold another project.
-        """)
+        ui.section("Project ready")
+        ui.success(f"Created '{project_name}'")
+        ui.success(f"Location: {base_path}")
+        ui.info("\n  Next steps:")
+        ui.step("Open the project in Visual Studio or VS Code")
+        ui.step("Run: docker-compose up --build")
+        ui.step("Visit: http://localhost:5000/swagger")
+        ui.muted("\n  Press Ctrl+C to exit or continue to scaffold another project.\n")
 
 
 if __name__ == "__main__":
-    main()
+    main()

stackforge/ui.py

@@ -0,0 +1,72 @@
+from colorama import Fore, Style, init
+
+init(autoreset=True)
+
+__all__ = [
+    "BANNER", "banner", "section", "step", "file_created", "success",
+    "warn", "error", "info", "prompt", "menu_option", "done", "muted",
+    "Fore", "Style",
+]
+
+BANNER = r"""
+  _____ _             _    ______
+ / ____| |           | |  |  ____|
+| (___ | |_ __ _  ___| | _| |__ ___  _ __ __ _  ___
+ \___ \| __/ _` |/ __| |/ /  __/ _ \| '__/ _` |/ _ \
+ ____) | || (_| | (__|   <| | | (_) | | | (_| |  __/
+|_____/ \__\__,_|\___|_|\_\_|  \___/|_|  \__, |\___|
+                                           __/ |
+                                          |___/"""
+
+
+def banner(subtitle: str, version: str = "") -> None:
+    print(f"{Style.BRIGHT}{Fore.CYAN}{BANNER}{Style.RESET_ALL}")
+    print(f"  {Style.BRIGHT}{Fore.WHITE}{subtitle}{Style.RESET_ALL}", end="")
+    if version:
+        print(f"  {Fore.LIGHTBLACK_EX}v{version}{Style.RESET_ALL}")
+    else:
+        print()
+
+
+def section(title: str) -> None:
+    print(f"\n  {Style.BRIGHT}{Fore.CYAN}> {title}{Style.RESET_ALL}")
+
+
+def step(label: str) -> None:
+    print(f"  {Fore.BLUE}|{Style.RESET_ALL} {label}")
+
+
+def file_created(path: str) -> None:
+    print(f"    {Fore.GREEN}+{Style.RESET_ALL} {Fore.LIGHTWHITE_EX}{path}{Style.RESET_ALL}")
+
+
+def success(message: str) -> None:
+    print(f"  {Fore.GREEN}+{Style.RESET_ALL} {message}")
+
+
+def warn(message: str) -> None:
+    print(f"  {Fore.YELLOW}!{Style.RESET_ALL}  {message}")
+
+
+def error(message: str) -> None:
+    print(f"  {Fore.RED}x{Style.RESET_ALL}  {message}")
+
+
+def info(message: str) -> None:
+    print(f"  {Fore.CYAN}{message}{Style.RESET_ALL}")
+
+
+def prompt(label: str) -> str:
+    return input(f"  {Style.BRIGHT}{Fore.CYAN}{label}{Style.RESET_ALL} ").strip()
+
+
+def menu_option(number: str, label: str, *, style: str = Fore.GREEN) -> None:
+    print(f"    {style}{number}.{Style.RESET_ALL} {label}")
+
+
+def done() -> None:
+    print(f"\n  {Style.BRIGHT}{Fore.GREEN}+ Scaffold complete.{Style.RESET_ALL}")
+
+
+def muted(message: str) -> None:
+    print(f"  {Fore.LIGHTBLACK_EX}{message}{Style.RESET_ALL}")

stackforge/version.py

@@ -0,0 +1,48 @@
+import json
+import urllib.error
+import urllib.request
+from importlib.metadata import PackageNotFoundError, version
+
+PACKAGE_NAME = "stackforge-cli"
+PYPI_JSON_URL = f"https://pypi.org/pypi/{PACKAGE_NAME}/json"
+
+
+def get_installed_version() -> str:
+    try:
+        return version(PACKAGE_NAME)
+    except PackageNotFoundError:
+        return "0.0.0-dev"
+
+
+def _version_tuple(value: str) -> tuple[int, ...]:
+    parts: list[int] = []
+    for segment in value.split("."):
+        digits = "".join(c for c in segment if c.isdigit())
+        if digits:
+            parts.append(int(digits))
+    return tuple(parts)
+
+
+def fetch_latest_version(timeout: float = 2.0) -> str | None:
+    request = urllib.request.Request(
+        PYPI_JSON_URL,
+        headers={"Accept": "application/json"},
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=timeout) as response:
+            payload = json.load(response)
+        return payload["info"]["version"]
+    except (urllib.error.URLError, TimeoutError, KeyError, json.JSONDecodeError):
+        return None
+
+
+def notify_if_update_available() -> None:
+    from stackforge import ui
+
+    installed = get_installed_version()
+    latest = fetch_latest_version()
+    if not latest or _version_tuple(latest) <= _version_tuple(installed):
+        return
+
+    ui.warn(f"StackForge {latest} is available (you have {installed}).")
+    ui.step(f"Update: pip install --upgrade {PACKAGE_NAME}\n")

stackforge_cli-0.1.2.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: stackforge-cli
+Version: 0.1.2
+Summary: A CLI scaffolder for .NET Clean Architecture projects
+License: MIT
+Keywords: scaffolder,dotnet,clean-architecture,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: colorama>=0.4.6
+
+# StackForge
+
+A CLI scaffolder for .NET Clean Architecture (CQRS) projects.
+
+## Installation
+
+```bash
+pip install stackforge-cli
+```
+
+## Usage
+
+```bash
+stackforge
+```
+
+Then follow the prompts to scaffold a new project.
+
+## Version and updates
+
+Check the version you have installed:
+
+```bash
+stackforge --version
+```
+
+Update to the latest release:
+
+```bash
+pip install --upgrade stackforge-cli
+```
+
+When you run `stackforge`, it checks PyPI for a newer version and prints an upgrade notice if one is available (network required; fails silently if offline).
+
+## What it generates
+
+- .NET 10 Clean Architecture structure (API, Application, Domain, Infrastructure, Persistence)
+- JWT authentication with ASP.NET Identity
+- Swagger UI with Bearer token support
+- PostgreSQL with EF Core
+- Docker + docker-compose with healthchecks
+- Role and user seeders (SuperAdmin out of the box)
+- Git initialization on `main` with `staging` and `development` branches
+- GitHub Actions workflow to create `staging` and `development` on first push to `main`
+
+## Quickstart after scaffolding
+
+1. Open the project in VS Code or Visual Studio
+2. Run: `docker-compose up --build`
+3. Visit: `http://localhost:5000/swagger`
+
+## Git workflow
+
+Each scaffolded project is initialized with three local branches:
+
+| Branch        | Purpose                          |
+|---------------|----------------------------------|
+| `main`        | Production / default branch      |
+| `staging`     | Pre-production environment       |
+| `development` | Active development environment   |
+
+A GitHub Actions workflow (`.github/workflows/sync-branches.yml`) is also included as a fallback: if you only push `main` first, it creates remote `staging` and `development` on GitHub automatically.
+
+### Example: push to GitHub
+
+From your scaffolded project directory (e.g. `~/stackforge/MyApi`):
+
+```bash
+# 1. Create a new repo on GitHub (empty, no README), then add the remote
+git remote add origin https://github.com/<your-user>/MyApi.git
+
+# 2. Push all branches in one go
+git push -u origin --all
+```
+
+That publishes `main`, `staging`, and `development` in a single command and sets upstream tracking for each.
+
+### Day-to-day branching
+
+```bash
+# Work on a feature
+git checkout development
+git checkout -b feature/my-feature
+# ... commit changes ...
+git push -u origin feature/my-feature
+
+# Merge into development when ready (via PR or locally)
+git checkout development
+git merge feature/my-feature
+git push origin development
+```
+
+Promote changes up the chain (`development` → `staging` → `main`) using pull requests or merges as your team prefers.

stackforge_cli-0.1.2.dist-info/RECORD

@@ -0,0 +1,19 @@
+stackforge/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stackforge/project_name.py,sha256=opPJncCuWnysCpS9wLSk_uzC4BJ6ow2eG4sTr0AIdlc,885
+stackforge/scaffold.py,sha256=nKLkYUvSVY_W9w2VjJG3SWaFZFlEYUpUs4geQwi61Q4,2923
+stackforge/ui.py,sha256=K-47CSFIjYdT2oyjWWHdSc69SgfFGy0q69ksG6UVuRc,2160
+stackforge/version.py,sha256=bz93n0b69WPdYgJW5tCvL3fLU2E9RStCkJtgue7_7S0,1484
+stackforge/engines/dotnet/__init__.py,sha256=I6S1SzyFstXO182w9qnKzlGQF0ffOfrg5Tkt9QAHRLw,618
+stackforge/engines/dotnet/api_generator.py,sha256=gTXDiSNbeIL07KQahQ5BxrrqZhqqaSjGVffn0SISWa8,9814
+stackforge/engines/dotnet/config_generator.py,sha256=Pn9VcS18rgpuPWnCh4Lhi2X1rr3wmvlQhc892DmNQ-0,2069
+stackforge/engines/dotnet/csproj_generator.py,sha256=gVnWzduCPk5OOnTWz_5TvrOGhq4ms4PLL1lLGY-1_TI,2514
+stackforge/engines/dotnet/docker_generator.py,sha256=NBhx0aT0_0Zk3F5FOTrq4flKGFkUBVQF0tml1hVGIrQ,1659
+stackforge/engines/dotnet/git_generator.py,sha256=c7Q8y8PvZHR33_veAklv200tHw46Z3nIBjDAsYAyEgQ,3058
+stackforge/engines/dotnet/layers_generator.py,sha256=HoXztxUR4StmMktKzCmbJjj5MjuUvw3NNSQOjA3LulQ,18175
+stackforge/engines/dotnet/program_generator.py,sha256=kvKkaQTLtSu_SGV4lfkdo-mX3z-fLKwRWG8ZvhZ053Q,6072
+stackforge/engines/dotnet/scaffolder.py,sha256=eU02zDIQ5TSZaosQo15cIYmRMn2knzzNLRH5iG8OYRI,2387
+stackforge_cli-0.1.2.dist-info/METADATA,sha256=sYTVyqdndDXLCg98gKqaPfLagsH7rc3gStk4RMTWdns,3179
+stackforge_cli-0.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+stackforge_cli-0.1.2.dist-info/entry_points.txt,sha256=r6YqYMrqMdXBiKTqSNdbEjwuzhCSksAlAmdhnqIOvJE,56
+stackforge_cli-0.1.2.dist-info/top_level.txt,sha256=rLeEUKSWLyFKeW9uVuvTDIxq05hOic0cG7Xy3XlSYI8,11
+stackforge_cli-0.1.2.dist-info/RECORD,,

stackforge_cli-0.1.1.dist-info/METADATA

@@ -1,47 +0,0 @@
-Metadata-Version: 2.4
-Name: stackforge-cli
-Version: 0.1.1
-Summary: A CLI scaffolder for .NET Clean Architecture projects
-License: MIT
-Keywords: scaffolder,dotnet,clean-architecture,cli
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Environment :: Console
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: colorama>=0.4.6
-
-# StackForge
-
-A CLI scaffolder for .NET Clean Architecture (CQRS) projects.
-
-## Installation
-
-```bash
-pip install stackforge
-```
-
-## Usage
-
-```bash
-stackforge
-```
-
-Then follow the prompts to scaffold a new project.
-
-## What it generates
-
-- .NET 10 Clean Architecture structure (API, Application, Domain, Infrastructure, Persistence)
-- JWT authentication with ASP.NET Identity
-- Swagger UI with Bearer token support
-- PostgreSQL with EF Core
-- Docker + docker-compose with healthchecks
-- Role and user seeders (SuperAdmin out of the box)
-- Git initialization with initial commit
-
-## Quickstart after scaffolding
-
-1. Open the project in VS Code or Visual Studio
-2. Run: `docker-compose up --build`
-3. Visit: `http://localhost:5000/swagger`

stackforge_cli-0.1.1.dist-info/RECORD

@@ -1,16 +0,0 @@
-stackforge/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-stackforge/scaffold.py,sha256=M4NR0_-kN09AfAtiXiqnNCxFYfrpVeYGx7UzjAdce-g,3261
-stackforge/engines/dotnet/__init__.py,sha256=bxCYj7mEmcLZZ06vgUPe8l9_PAp_dTDYLbaVK7sotQM,592
-stackforge/engines/dotnet/api_generator.py,sha256=06dPkqhqadIV2xNrlrMzNNvf9n2iG2zro8lzZ6jk-uw,9783
-stackforge/engines/dotnet/config_generator.py,sha256=cEKpUJ9t6gRNk9TnWQ1LXrxUk1WYLxDw_DH8T-X7gvA,2030
-stackforge/engines/dotnet/csproj_generator.py,sha256=aGoqkJLIVggTxM_tlyMH_RESI4Qy0BY6Pdo3OJLF7ao,2483
-stackforge/engines/dotnet/docker_generator.py,sha256=V4r2UKcMAR92-3yJBXjVfo1u-_HOtw9Zf2mrAp7bjDM,1624
-stackforge/engines/dotnet/git_generator.py,sha256=_fRnGnMLitw5GPxt1yKVCwCDequpMF-XZe-qYzSn6Gs,1718
-stackforge/engines/dotnet/layers_generator.py,sha256=EM5agcRcZAL_9s980sEP1iECuE518O-L6NndFtH3U2o,18132
-stackforge/engines/dotnet/program_generator.py,sha256=bCjTI8-aY9kLOOVZASF9U8HIEkVgOhtAndkV0Sq8V10,6037
-stackforge/engines/dotnet/scaffolder.py,sha256=Tco9MnM-qEBkTps472inZ62rTAcnecwpUBvAofE56gY,2289
-stackforge_cli-0.1.1.dist-info/METADATA,sha256=epE-WLMVrdm6pe6wfW6DvjSYFLSQYYGbNEGv3P_sa6s,1247
-stackforge_cli-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-stackforge_cli-0.1.1.dist-info/entry_points.txt,sha256=r6YqYMrqMdXBiKTqSNdbEjwuzhCSksAlAmdhnqIOvJE,56
-stackforge_cli-0.1.1.dist-info/top_level.txt,sha256=rLeEUKSWLyFKeW9uVuvTDIxq05hOic0cG7Xy3XlSYI8,11
-stackforge_cli-0.1.1.dist-info/RECORD,,