aegis-stack 0.7.0__tar.gz → 0.8.0__tar.gz

{aegis_stack-0.7.0 → aegis_stack-0.8.0}/.gitignore

@@ -144,3 +144,7 @@ my-app/
 
 # Translation review artifacts
 aegis_*_review.csv
+demo-*/
+
+# Generated-project artifact if aegis init ever runs at repo root
+/.copier-answers.yml

{aegis_stack-0.7.0 → aegis_stack-0.8.0}/CHANGELOG.md

@@ -5,6 +5,91 @@
   The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
   and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] - 2026-06-15
+
+### Added
+
+- **Guided `aegis init`**: a full-screen, interactive setup is now the default
+  for `aegis init`, walking through components and services with a live review
+  screen before generating. `--quick` keeps the classic one-line prompts, and
+  tiny terminals fall back to quick mode automatically. `--no-interactive` is
+  unchanged.
+- **`tasks statistics` CLI command**: report overall scheduler statistics
+  (total, active, and paused tasks) straight from the project CLI, mirroring the
+  data behind the admin-gated `/scheduler/statistics` endpoint.
+- **Authenticated load testing**: `api-load-test run` now authenticates by
+  default so auth-gated routes work without manual login. `--as-admin` mints a
+  bearer token for an `ADMIN_USER_EMAILS` address, `--as-user` for a regular
+  account, and `--anon` opts out.
+- **`HF_TOKEN` setting**: authenticates the RAG embedding-model download from the
+  Hugging Face Hub, silencing the unauthenticated-request warning and raising
+  rate limits. Optional; public models still download without it.
+
+### Changed
+
+- **CLI brand pass**: warnings are now amber (`#F5A623`, matching the frontend)
+  instead of violet; status icons are monochrome text glyphs (`✓ ⚠ ✗ ℹ`) colored
+  by state instead of emoji, so they align to the terminal grid and render
+  consistently everywhere; the load-test report is themed (teal progress bar,
+  dim labels).
+- **Quiet RAG model load**: the embedding model now loads without progress bars
+  or log noise in CLI output.
+
+### Fixed
+
+- **gpt-5 family and o-series models in AI chat**: these reject any non-default
+  `temperature` and returned a 400; temperature is now omitted for them so the
+  streaming chat works.
+- **`llm` CLI commands now run**: `list`, `current`, `use`, and `info` were
+  declared `async def`, which Typer never awaits, so they exited without doing
+  anything; they now execute correctly.
+- **Deprecation warning** in the AI chat streaming path (`result.usage()` is a
+  property in pydantic-ai 1.x, no longer a method).
+
+### Documentation
+
+- **Installation guide clarity**: explain what `uvx` is and that it ships with
+  uv, distinguish `uvx` (ephemeral run) from `uv tool install` (persistent
+  install), and correct the uvx version note (latest on first run, cached
+  thereafter; `uvx aegis-stack@latest` to refresh). The CLI language section now
+  lists all 9 supported locales (`en`, `de`, `es`, `fr`, `ja`, `ko`, `ru`, `zh`,
+  `zh_Hant`) in a table instead of only Simplified Chinese.
+
+## [0.7.0] - 2026-06-08
+
+### Added
+
+- **Rolling deploys**: zero-downtime, code-only `aegis deploy --rolling`. The
+  webserver rolls over while still serving traffic and the worker queue is
+  paused so in-flight jobs drain cleanly before workers restart.
+- **Free-port auto-discovery for `make serve`**: picks an open host port instead
+  of failing with "address already in use" when the default is taken.
+- **CI/CD scaffolding in generated projects**: a GitHub Actions deploy workflow
+  generated out of the box.
+- **Scheduler**: run a scheduled job on demand from the project CLI, plus
+  scheduler fixes.
+- **Payment service**: Stripe-backed payment capability, with end-to-end tests.
+- **Performance middleware** in generated projects.
+
+### Changed
+
+- **`aegis update` is now idempotent**: after a clean update it advances the
+  copier baseline (`_commit` / `_template_version`) so a re-run is a no-op and
+  future updates don't re-apply changes that are already present.
+- `aegis update --to-version` accepts both PEP 440 (`0.7.0`) and tag (`v0.7.0`)
+  forms.
+- Dependency: typer bumped to 0.26.7.
+
+### Fixed
+
+- Rolling deploy no longer rolls back a slow-but-healthy webserver: the
+  docker-rollout wait is sized to the container's own healthcheck budget
+  (`-t`), not a fixed 60s wall clock.
+- `make serve` port detection no longer reports a busy port as free under load
+  (a timed-out probe is treated as in-use, not free).
+
+---
+
 ## [0.4.0] - 2025-12-07
 
 ### Added

{aegis_stack-0.7.0 → aegis_stack-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aegis-stack
-Version: 0.7.0
+Version: 0.8.0
 Summary: A production-ready FastAPI platform with modular components and a built-in control plane. Try: uvx aegis-stack init my-project
 Project-URL: Homepage, https://docs.aegis-stack.io/
 Project-URL: Documentation, https://docs.aegis-stack.io/
@@ -26,7 +26,7 @@ Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Typing :: Typed
 Requires-Python: <3.15,>=3.11
-Requires-Dist: copier>=9.11.2
+Requires-Dist: copier<9.15,>=9.11.2
 Requires-Dist: filelock>=3.20.1
 Requires-Dist: packaging>=24.0
 Requires-Dist: pillow>=12.2.0
@@ -88,6 +88,8 @@ Aegis Stack scaffolds complete FastAPI applications with auth, payments, workers
 uvx aegis-stack init my-api && cd my-api && make serve
 ```
 
+`init` opens a full-screen guided setup that walks through every component and service with explanations. Prefer the classic one-line prompts? Pass `--quick`.
+
 <details>
 <summary><strong>More examples</strong></summary>
 
@@ -110,6 +112,8 @@ uvx aegis-stack init full-app --services auth,payment,comms --components worker,
 
 ## Customizing Your Stack
 
+![Aegis Stack spinning up a new project](docs/images/aegis-spinup-demo.gif)
+
 **Components** are infrastructure pieces (database, workers, scheduler, cache). **Services** are business capabilities (auth, AI, payments, comms).
 
 **Don't worry about what you pick today.** Add anything later with a single command, remove what you outgrow, no rework required.
@@ -210,20 +214,6 @@ Every generated project ships with GitHub Actions and developer tooling pre-wire
 
 [Deployment Docs →](https://docs.aegis-stack.io/deployment/)
 
-Components compose into capabilities you didn't have to build:
-
-```mermaid
-graph LR
-    Auth[Auth] --> A[User-specific AI conversations]
-    AI[AI] --> A
-    AI --> B[Persistent history &<br/>token analytics]
-    DB[(Database)] --> B
-    AI --> C[Background AI pipelines]
-    Worker[Worker] --> C
-    Scheduler[Scheduler] --> D[Persistent job scheduling]
-    DB --> D
-```
-
 ## Your Stack Grows With You
 
 **Your choices aren't permanent.** Start with what you need today, add when requirements change, remove what you outgrow.

{aegis_stack-0.7.0 → aegis_stack-0.8.0}/README.md

@@ -30,6 +30,8 @@ Aegis Stack scaffolds complete FastAPI applications with auth, payments, workers
 uvx aegis-stack init my-api && cd my-api && make serve
 ```
 
+`init` opens a full-screen guided setup that walks through every component and service with explanations. Prefer the classic one-line prompts? Pass `--quick`.
+
 <details>
 <summary><strong>More examples</strong></summary>
 
@@ -52,6 +54,8 @@ uvx aegis-stack init full-app --services auth,payment,comms --components worker,
 
 ## Customizing Your Stack
 
+![Aegis Stack spinning up a new project](docs/images/aegis-spinup-demo.gif)
+
 **Components** are infrastructure pieces (database, workers, scheduler, cache). **Services** are business capabilities (auth, AI, payments, comms).
 
 **Don't worry about what you pick today.** Add anything later with a single command, remove what you outgrow, no rework required.
@@ -152,20 +156,6 @@ Every generated project ships with GitHub Actions and developer tooling pre-wire
 
 [Deployment Docs →](https://docs.aegis-stack.io/deployment/)
 
-Components compose into capabilities you didn't have to build:
-
-```mermaid
-graph LR
-    Auth[Auth] --> A[User-specific AI conversations]
-    AI[AI] --> A
-    AI --> B[Persistent history &<br/>token analytics]
-    DB[(Database)] --> B
-    AI --> C[Background AI pipelines]
-    Worker[Worker] --> C
-    Scheduler[Scheduler] --> D[Persistent job scheduling]
-    DB --> D
-```
-
 ## Your Stack Grows With You
 
 **Your choices aren't permanent.** Start with what you need today, add when requirements change, remove what you outgrow.

{aegis_stack-0.7.0 → aegis_stack-0.8.0}/aegis/__init__.py

@@ -2,4 +2,4 @@
 Aegis Stack CLI - Component generation and project management tools.
 """
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{aegis_stack-0.7.0 → aegis_stack-0.8.0}/aegis/__main__.py

@@ -10,6 +10,7 @@ Usage:
 
 import typer
 
+from .cli import brand
 from .commands.add import add_command
 from .commands.add_service import add_service_command
 from .commands.components import components_command
@@ -59,10 +60,9 @@ def _resolve_locale_callback(value: str | None) -> str | None:
         # so check if the input actually maps to a real locale.
         base = value.lower().replace("-", "_").split(".")[0].split("@")[0]
         if resolved == "en" and not base.startswith("en"):
-            typer.secho(
+            brand.error(
                 f"Unsupported language '{value}'. Available: "
                 f"{', '.join(sorted(AVAILABLE_LOCALES))}",
-                fg="red",
                 err=True,
             )
             raise typer.Exit(1)
@@ -70,6 +70,11 @@ def _resolve_locale_callback(value: str | None) -> str | None:
     return value
 
 
+# Brand the rich ``--help`` output (teal = typeable tokens, neutral = prose,
+# dim = annotations/chrome). Single source in brand.py; must run before the
+# Typer app is built so its help panels pick up the styling.
+brand.apply_help_theme()
+
 # Create the main Typer application
 app = typer.Typer(
     name="aegis",

aegis_stack-0.8.0/aegis/cli/brand.py

@@ -0,0 +1,143 @@
+"""Aegis brand palette and semantic rendering helpers for CLI output.
+
+Single source for the colors used by aegis CLI surfaces. The hex values
+mirror the generated frontend theme
+(``app/components/frontend/theme.py`` in the template) so the CLI and the
+product it generates share one visual identity.
+
+Call sites express intent, never colors: import this module and use the
+semantic helpers (``brand.success(...)``, ``brand.warn(...)``,
+``brand.error(...)``, ``brand.accent(...)``, ``brand.muted(...)``). The
+palette is defined here exactly once; no per-command color constants.
+"""
+
+from typing import Any
+
+import typer
+
+AEGIS_TEAL = "#17CCBF"
+"""Primary teal/cyan — the brand standard accent (and success state)."""
+
+AEGIS_TEAL_DARK = "#248F87"
+"""Darker teal — secondary accent."""
+
+AEGIS_WARNING = "#F5A623"
+"""Warning amber — matches the frontend theme's ``ACCENT_WARNING``."""
+
+AEGIS_ERROR = "#E23E3E"
+"""Error red — mirrors the theme's ``ACCENT_STOP``."""
+
+
+def _rgb(hex_color: str) -> tuple[int, int, int]:
+    """Hex color to the (r, g, b) tuple click/typer expects."""
+    value = hex_color.lstrip("#")
+    return int(value[0:2], 16), int(value[2:4], 16), int(value[4:6], 16)
+
+
+_TEAL = _rgb(AEGIS_TEAL)
+_WARNING = _rgb(AEGIS_WARNING)
+_ERROR = _rgb(AEGIS_ERROR)
+
+
+def success(
+    message: str = "", *, bold: bool = False, nl: bool = True, err: bool = False
+) -> None:
+    """Echo a success line in the brand teal."""
+    typer.secho(message, fg=_TEAL, bold=bold or None, nl=nl, err=err)
+
+
+def accent(
+    message: str = "", *, bold: bool = False, nl: bool = True, err: bool = False
+) -> None:
+    """Echo an accented line (headings, highlights) in the brand teal."""
+    typer.secho(message, fg=_TEAL, bold=bold or None, nl=nl, err=err)
+
+
+def warn(
+    message: str = "", *, bold: bool = False, nl: bool = True, err: bool = False
+) -> None:
+    """Echo a warning line in the brand amber."""
+    typer.secho(message, fg=_WARNING, bold=bold or None, nl=nl, err=err)
+
+
+def error(
+    message: str = "", *, bold: bool = False, nl: bool = True, err: bool = False
+) -> None:
+    """Echo an error line in the brand red."""
+    typer.secho(message, fg=_ERROR, bold=bold or None, nl=nl, err=err)
+
+
+def muted(
+    message: str = "", *, bold: bool = False, nl: bool = True, err: bool = False
+) -> None:
+    """Echo a secondary/de-emphasized line (terminal dim)."""
+    typer.secho(message, dim=True, bold=bold or None, nl=nl, err=err)
+
+
+def accent_text(text: str, *, bold: bool = False) -> str:
+    """Style ``text`` in the brand teal for inline composition."""
+    return typer.style(text, fg=_TEAL, bold=bold or None)
+
+
+def warn_text(text: str, *, bold: bool = False) -> str:
+    """Style ``text`` in the brand amber for inline composition."""
+    return typer.style(text, fg=_WARNING, bold=bold or None)
+
+
+def muted_text(text: str, *, bold: bool = False) -> str:
+    """Style ``text`` de-emphasized (terminal dim) for inline composition."""
+    return typer.style(text, dim=True, bold=bold or None)
+
+
+def questionary_style() -> Any:
+    """Brand style for questionary prompts.
+
+    Replaces questionary's default orange (``#FF9D00``) answer/pointer/
+    highlight tokens with the brand teal. Imported lazily so plain
+    ``typer``-only surfaces don't pay for questionary at import time.
+    """
+    import questionary
+
+    return questionary.Style(
+        [
+            ("qmark", f"fg:{AEGIS_TEAL} bold"),
+            ("question", "bold"),
+            ("answer", f"fg:{AEGIS_TEAL} bold"),
+            ("pointer", f"fg:{AEGIS_TEAL} bold"),
+            ("highlighted", f"fg:{AEGIS_TEAL} bold"),
+            ("selected", f"fg:{AEGIS_TEAL}"),
+            ("instruction", "fg:#7E8A9A"),
+            ("disabled", "fg:#7E8A9A italic"),
+        ]
+    )
+
+
+def apply_help_theme() -> None:
+    """Theme Typer's rich ``--help`` output to the brand palette.
+
+    One accent (teal) encodes exactly one meaning — "a token you can type":
+    command names and flags. Prose (usage, descriptions, titles) stays
+    neutral foreground; annotations and chrome (metavars, defaults, env-var
+    hints, panel borders) go dim. Two colors, three brightnesses — color is
+    wayfinding, not decoration. Call once before building the Typer app;
+    ``rich_utils`` constants are global, so every help panel inherits it.
+    """
+    from typer import rich_utils
+
+    typeable = f"bold {AEGIS_TEAL}"  # commands + flags: the tokens you run
+    # setattr (not direct assignment) so the type checker doesn't narrow each
+    # rich_utils.STYLE_* to the Literal of its packaged default and reject the
+    # override. Values: teal = typeable, dim = annotations, "" = neutral prose.
+    overrides = {
+        "STYLE_COMMANDS_TABLE_FIRST_COLUMN": typeable,  # command names
+        "STYLE_OPTION": typeable,  # --flags
+        "STYLE_SWITCH": typeable,  # -h style switches
+        "STYLE_NEGATIVE_OPTION": typeable,
+        "STYLE_NEGATIVE_SWITCH": typeable,
+        "STYLE_METAVAR": "dim",  # TEXT/INTEGER metavars are annotations
+        "STYLE_OPTION_ENVVAR": "dim",  # [env var: ...] — drop the yellow
+        "STYLE_USAGE": "",  # "Usage:" header — neutral prose, not yellow
+        "STYLE_HELPTEXT": "",  # help body — neutral foreground, not dimmed
+    }
+    for _name, _value in overrides.items():
+        setattr(rich_utils, _name, _value)

aegis_stack-0.8.0/aegis/cli/build_plan.py

@@ -0,0 +1,145 @@
+"""Resolved build plan shared by quick and guided init flows.
+
+``resolve_build_plan`` runs the full selection-to-plan pipeline (component
+dependency resolution, service-required component merge, auto-add
+accounting, template previews) as a pure computation. Quick mode prints the
+plan as today's terminal dump; the guided setup renders it as the REVIEW
+screen. One resolution path, two presentations.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from ..core.component_utils import (
+    clean_component_names,
+    extract_base_component_name,
+    restore_engine_info,
+)
+from ..core.components import COMPONENTS, CORE_COMPONENTS, ComponentType
+from ..core.dependency_resolver import DependencyResolver
+from ..core.service_resolver import ServiceResolver
+from ..core.template_generator import TemplateGenerator
+
+
+@dataclass
+class BuildPlan:
+    """Everything both init flows need to preview and confirm a build."""
+
+    project_name: str
+    components: list[str]
+    """Final component list (bracket syntax preserved, CORE included)."""
+
+    services: list[str]
+    """Final service list (bracket syntax preserved)."""
+
+    scheduler_backend: str
+    auto_added_components: list[str] = field(default_factory=list)
+    """Components pulled in by component dependency resolution."""
+
+    service_component_map: dict[str, list[str]] = field(default_factory=dict)
+    """Component -> the services that required it (service auto-adds)."""
+
+    template_gen: TemplateGenerator | None = None
+    template_files: list[str] = field(default_factory=list)
+    entrypoints: list[str] = field(default_factory=list)
+    worker_queues: list[str] = field(default_factory=list)
+    dependencies: list[str] = field(default_factory=list)
+
+    @property
+    def infrastructure(self) -> list[str]:
+        """Non-CORE components for display, selection order preserved."""
+        out = []
+        for name in self.components:
+            base = extract_base_component_name(name)
+            if (
+                base in COMPONENTS
+                and COMPONENTS[base].type == ComponentType.INFRASTRUCTURE
+            ):
+                out.append(name)
+        return out
+
+
+def resolve_build_plan(
+    project_name: str,
+    selected_components: list[str],
+    scheduler_backend: str,
+    selected_services: list[str],
+    python_version: str,
+) -> BuildPlan:
+    """Resolve a raw interactive selection into a confirmed-ready plan.
+
+    Mirrors the long-standing init pipeline: resolve component
+    dependencies on clean names, restore engine brackets, merge
+    service-required components (base-name de-duplicated, first occurrence
+    wins so an explicit ``database[postgres]`` beats the resolver's plain
+    ``database``), then build the template previews.
+    """
+    components = list(selected_components)
+    auto_added: list[str] = []
+
+    if components:
+        original = list(components)
+        # Auto-adds are judged against the PRE-resolution selection; judging
+        # the resolved set against itself always yields "nothing missing".
+        auto_added = DependencyResolver.get_missing_dependencies(
+            clean_component_names([c for c in original if c not in CORE_COMPONENTS])
+        )
+        resolved_clean = DependencyResolver.resolve_dependencies(
+            clean_component_names(components)
+        )
+        components = restore_engine_info(resolved_clean, original)
+
+    services = list(selected_services)
+    service_component_map: dict[str, list[str]] = {}
+    if services:
+        # Base-name comparison throughout: a service's plain requirement
+        # (database) must neither duplicate nor claim credit for an explicit
+        # bracketed selection (database[postgres]).
+        before_merge_bases = {extract_base_component_name(c) for c in components}
+        service_components, _ = ServiceResolver.resolve_service_dependencies(services)
+
+        merged = list(components)
+        merged_bases = set(before_merge_bases)
+        for comp in service_components:
+            base = extract_base_component_name(comp)
+            if base not in merged_bases:
+                merged.append(comp)
+                merged_bases.add(base)
+        components = merged
+
+        service_added = [
+            comp
+            for comp in service_components
+            if extract_base_component_name(comp) not in before_merge_bases
+            and comp not in CORE_COMPONENTS
+        ]
+        for service_name in services:
+            service_deps = ServiceResolver.resolve_service_dependencies([service_name])[
+                0
+            ]
+            for comp in service_deps:
+                if comp in service_added:
+                    service_component_map.setdefault(comp, []).append(service_name)
+
+    template_gen = TemplateGenerator(
+        project_name,
+        list(components),
+        scheduler_backend,
+        services,
+        python_version,
+    )
+
+    return BuildPlan(
+        project_name=project_name,
+        components=components,
+        services=services,
+        scheduler_backend=scheduler_backend,
+        auto_added_components=auto_added,
+        service_component_map=service_component_map,
+        template_gen=template_gen,
+        template_files=template_gen.get_template_files(),
+        entrypoints=template_gen.get_entrypoints(),
+        worker_queues=template_gen.get_worker_queues(),
+        dependencies=template_gen._get_pyproject_deps(),
+    )