alms-cli 0.1.7__tar.gz → 0.1.9__tar.gz

{alms_cli-0.1.7 → alms_cli-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alms-cli
-Version: 0.1.7
+Version: 0.1.9
 Summary: ALMS CLI - Beautiful project scaffolding tool for AI-first backends
 Project-URL: Homepage, https://github.com/KJ-AIML/alms
 Project-URL: Repository, https://github.com/KJ-AIML/alms

{alms_cli-0.1.7 → alms_cli-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "alms-cli"
-version = "0.1.7"
+version = "0.1.9"
 description = "ALMS CLI - Beautiful project scaffolding tool for AI-first backends"
 readme = "README.md"
 requires-python = ">=3.13"

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/__init__.py

@@ -1,3 +1,3 @@
 """ALMS CLI - Beautiful project scaffolding tool."""
 
-__version__ = "0.1.7"
+__version__ = "0.1.9"

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/.env.example.j2

@@ -7,6 +7,8 @@ SERVICE_NAME={{ project_name | lower | replace(' ', '-') }}
 # Server Configuration
 SERVER_PORT=3000
 SERVER_HOST=0.0.0.0
+# WARNING: ALLOWED_HOSTS=["*"] is for development only.
+# Production must use explicit origins, e.g. ALLOWED_HOSTS=["https://example.com"]
 ALLOWED_HOSTS=["*"]
 
 # Environment Configuration

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/pyproject.toml.j2

@@ -24,6 +24,9 @@ dev = [
     "ruff>=0.14.11",
 ]
 
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
 [tool.alms]
 profile = "{{ profile }}"
 capabilities = {{ capabilities_repr }}

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/api/endpoints/v1/dependencies.py.j2

@@ -18,8 +18,11 @@ def get_db_session():
     return get_db()
 {% else %}
 def get_db_session():
-    """Get database session."""
-    pass
+    """Get database session (stub for non-database profiles)."""
+    raise RuntimeError(
+        "Database is not enabled in this profile. "
+        "Regenerate with --profile db-agent or full to enable database support."
+    )
 {% endif %}{% if has_ai %}
 
 try:

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/api/endpoints/v1/health.py.j2

@@ -29,7 +29,11 @@ async def ready_check():
     try:
         from src.database.connection import check_database_connection
     except ImportError:
-        return AppResponse(success=False, data={"status": "degraded", "ready": False})
+        from fastapi.responses import JSONResponse
+        return JSONResponse(
+            status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
+            content=AppResponse(success=False, data={"status": "degraded", "ready": False}).model_dump(),
+        )
     db_ready = await check_database_connection()
     if db_ready:
         return AppResponse(success=True, data={"status": "ready", "ready": True, "dependencies": {"database": "healthy"}})

alms_cli-0.1.9/src/alms_cli/templates/files/src/api/endpoints/v1/sample_agent.py.j2

@@ -0,0 +1,15 @@
+"""Sample agent endpoint."""
+
+from fastapi import APIRouter, Depends
+from src.api.endpoints.v1.dependencies import get_sample_usecase
+from src.api.endpoints.v1.schemas.base import AppResponse
+from src.api.endpoints.v1.schemas.sample import SampleRequest
+
+router = APIRouter()
+
+
+@router.post("/sample")
+async def sample_agent(request: SampleRequest, usecase=Depends(get_sample_usecase)):
+    """Sample agent endpoint."""
+    result = await usecase.execute(query=request.query)
+    return AppResponse(success=True, data=result)

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/api/main.py.j2

@@ -38,22 +38,34 @@ def create_app() -> FastAPI:
         redoc_url=None,
     )
 
-    # Middleware registration order matters - added in reverse execution order
-    # LoggingMiddleware executes first on incoming requests
-    app.add_middleware(LoggingMiddleware)
-{% if has_obs %}    app.add_middleware(ObservabilityMiddleware)
-{% endif %}    app.add_middleware(SecurityHeadersMiddleware)
-    app.add_middleware(APIKeyMiddleware)
-    app.add_middleware(ErrorHandlerMiddleware)
+    # Middleware registration order matters: last added = outermost = executes first on incoming request.
+    # Intended request flow: Logging → APIKey → ErrorHandler → SecurityHeaders → Observability → CORS
     app.add_middleware(
         CORSMiddleware,
-        allow_origins=["*"],
+        allow_origins=settings.ALLOWED_HOSTS,
         allow_credentials=True,
         allow_methods=["*"],
         allow_headers=["*"],
     )
+    app.add_middleware(ErrorHandlerMiddleware)
+    app.add_middleware(APIKeyMiddleware)
+    app.add_middleware(SecurityHeadersMiddleware)
+{% if has_obs %}    app.add_middleware(ObservabilityMiddleware)
+{% endif %}    app.add_middleware(LoggingMiddleware)
 
     app.include_router(api_router, prefix=settings.API_PREFIX)
+{% if has_scalar %}
+
+    # Scalar API Documentation
+    try:
+        from scalar_fastapi import get_scalar_api_reference
+
+        @app.get("/docs", include_in_schema=False)
+        async def scalar_html():
+            return get_scalar_api_reference(openapi_url=app.openapi_url, title=app.title)
+    except ImportError:
+        pass
+{% endif %}
     return app
 
 
@@ -66,14 +78,4 @@ if __name__ == "__main__":
         host=settings.SERVER_HOST,
         port=settings.SERVER_PORT,
         reload=settings.DEBUG,
-    )
-{% if has_scalar %}
-
-    try:
-        from scalar_fastapi import get_scalar_api_reference
-        @app.get("/docs", include_in_schema=False)
-        async def scalar_html():
-            return get_scalar_api_reference(openapi_url=app.openapi_url, title=app.title)
-    except ImportError:
-        pass
-{% endif %}
+    )

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/config/settings.py.j2

@@ -1,8 +1,10 @@
 """Application settings."""
 
-from pydantic_settings import BaseSettings
 from functools import lru_cache
 
+from pydantic import ConfigDict
+from pydantic_settings import BaseSettings
+
 
 class Settings(BaseSettings):
     APP_NAME: str = "ALMS Backend"
@@ -15,7 +17,8 @@ class Settings(BaseSettings):
 {% if has_ai %}    AI_ENABLED: bool = False
 {% endif %}{% if has_db %}    DATABASE_ENABLED: bool = True
 {% endif %}{% if has_redis %}    REDIS_ENABLED: bool = False
-{% endif %}{% if has_ai %}    OPENAI_API_KEY: str = ""
+{% endif %}{% if has_ai %}    MODEL_PROVIDER: str = "openai"  # reserved for future provider selection; only "openai" is supported
+    OPENAI_API_KEY: str = ""
     OPENAI_MODEL_BASIC: str = "gpt-4o-mini"
     OPENAI_MODEL_REASONING: str = "gpt-4o"
 {% endif %}{% if has_db %}    DATABASE_URL: str | None = None
@@ -43,9 +46,7 @@ class Settings(BaseSettings):
             if "*" in self.ALLOWED_HOSTS:
                 raise ValueError("ALLOWED_HOSTS must not contain * in production")
 
-    class Config:
-        env_file = ".env"
-        case_sensitive = True
+    model_config = ConfigDict(env_file=".env", case_sensitive=True)
 
 
 @lru_cache()

alms_cli-0.1.9/src/alms_cli/templates/files/src/providers/ai/factory.py.j2

@@ -0,0 +1,9 @@
+"""AI provider factory."""
+
+from src.providers.ai.base import AIModelProvider
+from src.providers.ai.langchain_model_loader import LangchainModelLoader
+
+
+def get_ai_provider() -> AIModelProvider:
+    """Return the configured AI provider."""
+    return LangchainModelLoader()

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/providers/ai/langchain_model_loader.py.j2

@@ -5,8 +5,8 @@ from src.config.settings import settings
 from src.providers.ai.base import AIModelProvider
 
 
-class LangChainModelProvider(AIModelProvider):
-    """LangChain AI model provider."""
+class LangchainModelLoader(AIModelProvider):
+    """LangChain AI model loader."""
 
     def get_chat_model(self, tier: str = "basic"):
         """Get LLM instance."""
@@ -24,4 +24,4 @@ class LangChainModelProvider(AIModelProvider):
 
 def get_llm(model: str = "basic"):
     """Get LLM instance."""
-    return LangChainModelProvider().get_chat_model(tier=model)
+    return LangchainModelLoader().get_chat_model(tier=model)

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/tests/integration/test_full_stack.py.j2

@@ -7,4 +7,5 @@ import pytest
 async def test_full_stack(client):
     """Test full stack integration."""
     response = await client.get("/api/v1/health")
-    assert response.status_code == 200
+    # Health returns 200 when all deps healthy, 503 when degraded (e.g., no DB)
+    assert response.status_code in (200, 503)

alms_cli-0.1.9/src/alms_cli/templates/files/src/tests/v1/test_agent.py.j2

@@ -0,0 +1,18 @@
+"""Agent endpoint tests."""
+
+import pytest
+
+
+@pytest.mark.asyncio
+async def test_sample_agent(client):
+    """Test sample agent endpoint."""
+    response = await client.post("/api/v1/agent/sample", json={"query": "test"})
+    # Endpoint returns 200 when AI deps are available, 503 when not installed
+    assert response.status_code in (200, 503)
+    data = response.json()
+    assert "success" in data
+    if response.status_code == 200:
+        assert data["success"] is True
+    else:
+        assert data["success"] is False
+        assert data["error"]["code"] == "AGENT_UNAVAILABLE"

alms_cli-0.1.9/src/alms_cli/templates/files/src/tests/v1/test_health.py.j2

@@ -0,0 +1,19 @@
+"""Health endpoint tests."""
+
+import pytest
+
+
+@pytest.mark.asyncio
+async def test_health_check(client):
+    """Test health check endpoint."""
+    response = await client.get("/api/v1/health")
+    # Health endpoint returns 200 when healthy, 503 when degraded (e.g., DB unavailable)
+    assert response.status_code in (200, 503)
+    data = response.json()
+    assert "success" in data
+    assert "data" in data
+    if response.status_code == 200:
+        assert data["success"] is True
+    else:
+        assert data["success"] is False
+        assert data["data"]["status"] == "degraded"

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/templates/files/src/tests/v1/test_observability_middleware.py.j2

@@ -7,4 +7,5 @@ import pytest
 async def test_observability_middleware(client):
     """Test observability middleware."""
     response = await client.get("/api/v1/health")
-    assert response.status_code == 200
+    # Health returns 200 when all deps healthy, 503 when degraded (e.g., no DB)
+    assert response.status_code in (200, 503)

{alms_cli-0.1.7 → alms_cli-0.1.9}/src/alms_cli/ui/components.py

@@ -1,18 +1,38 @@
 """Rich UI components for beautiful terminal output."""
 
+import sys
+from pathlib import Path
+
+from rich import box
 from rich.console import Console
 from rich.panel import Panel
-from rich.tree import Tree
 from rich.progress import (
+    BarColumn,
     Progress,
     SpinnerColumn,
     TextColumn,
-    BarColumn,
     TimeElapsedColumn,
 )
 from rich.table import Table
-from rich import box
-from pathlib import Path
+from rich.tree import Tree
+
+
+def _stdout_supports_unicode() -> bool:
+    """Check whether stdout can encode Unicode symbols (e.g. not cp1252)."""
+    encoding = getattr(sys.stdout, "encoding", None) or ""
+    try:
+        "\u2139".encode(encoding)
+        return True
+    except (UnicodeEncodeError, LookupError):
+        return False
+
+
+# ponytail: ASCII fallbacks for Windows cp1252 terminals where Unicode glyphs crash stdout.
+_unicode_ok = _stdout_supports_unicode()
+SYM_OK = "\u2713" if _unicode_ok else "[OK]"
+SYM_ERR = "\u2717" if _unicode_ok else "[X]"
+SYM_INFO = "\u2139" if _unicode_ok else "[i]"
+SYM_WARN = "\u26a0" if _unicode_ok else "[!]"
 
 console = Console()
 
@@ -42,22 +62,22 @@ def print_step(step_num: int, total: int, message: str):
 
 def print_success(message: str):
     """Print a success message."""
-    console.print(f"[bold green]✓[/bold green] [green]{message}[/green]")
+    console.print(f"[bold green]{SYM_OK}[/bold green] [green]{message}[/green]")
 
 
 def print_error(message: str):
     """Print an error message."""
-    console.print(f"[bold red]✗[/bold red] [red]{message}[/red]")
+    console.print(f"[bold red]{SYM_ERR}[/bold red] [red]{message}[/red]")
 
 
 def print_info(message: str):
     """Print an info message."""
-    console.print(f"[bold blue]ℹ[/bold blue] [blue]{message}[/blue]")
+    console.print(f"[bold blue]{SYM_INFO}[/bold blue] [blue]{message}[/blue]")
 
 
 def print_warning(message: str):
     """Print a warning message."""
-    console.print(f"[bold yellow]⚠[/bold yellow] [yellow]{message}[/yellow]")
+    console.print(f"[bold yellow]{SYM_WARN}[/bold yellow] [yellow]{message}[/yellow]")
 
 
 def create_progress():

alms_cli-0.1.7/src/alms_cli/templates/files/src/api/endpoints/v1/sample_agent.py.j2

@@ -1,15 +0,0 @@
-"""Sample agent endpoint."""
-
-from fastapi import APIRouter
-from src.api.endpoints.v1.schemas.base import AppResponse
-from src.execution.usecases.sample_usecase import SampleUseCase
-
-router = APIRouter()
-
-
-@router.post("/sample")
-async def sample_agent(query: str):
-    """Sample agent endpoint."""
-    usecase = SampleUseCase()
-    result = await usecase.execute(query)
-    return AppResponse(success=True, data=result)

alms_cli-0.1.7/src/alms_cli/templates/files/src/providers/ai/factory.py.j2

@@ -1,10 +0,0 @@
-"""AI provider factory."""
-
-from functools import lru_cache
-from src.providers.ai.langchain_model_loader import LangChainModelProvider
-
-
-@lru_cache
-def get_ai_provider() -> LangChainModelProvider:
-    """Return the configured AI provider."""
-    return LangChainModelProvider()

alms_cli-0.1.7/src/alms_cli/templates/files/src/tests/v1/test_agent.py.j2

@@ -1,10 +0,0 @@
-"""Agent endpoint tests."""
-
-import pytest
-
-
-@pytest.mark.asyncio
-async def test_sample_agent(client):
-    """Test sample agent endpoint."""
-    response = await client.post("/api/v1/agent/sample", json={"query": "test"})
-    assert response.status_code == 200

alms_cli-0.1.7/src/alms_cli/templates/files/src/tests/v1/test_health.py.j2

@@ -1,12 +0,0 @@
-"""Health endpoint tests."""
-
-import pytest
-
-
-@pytest.mark.asyncio
-async def test_health_check(client):
-    """Test health check endpoint."""
-    response = await client.get("/api/v1/health")
-    assert response.status_code == 200
-    data = response.json()
-    assert data["success"] is True