alms-cli 0.1.4__tar.gz → 0.1.6__tar.gz

{alms_cli-0.1.4 → alms_cli-0.1.6}/.gitignore

@@ -1,35 +1,41 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv/
-env/
-venv/
-ENV/
-
-# Configuration
-.env
-.python-version
-
-# Logs
-logs/
-*.log
-src/logs/
-
-# Pytest
-.pytest_cache/
-.coverage
-htmlcov/
-
-# IDEs
-.vscode/
-.idea/
-.trae/
-
-# Docker
-.docker/
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+
+# Configuration
+.env
+.python-version
+
+# Logs
+logs/
+*.log
+src/logs/
+
+# Pytest
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDEs
+.vscode/
+.idea/
+.trae/
+
+# Docker
+.docker/
+# Internal phase reports (not for release)
+PHASE_*_REPORT.md
+RC_GATE_REPORT.md
+
+# Test cache
+.pytest_cache/

{alms_cli-0.1.4 → alms_cli-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alms-cli
-Version: 0.1.4
+Version: 0.1.6
 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
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Python: >=3.13
+Requires-Dist: jinja2>=3.1.0
 Requires-Dist: questionary>=2.0.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: typer>=0.12.0

alms_cli-0.1.6/pyproject.toml

@@ -0,0 +1,63 @@
+[project]
+name = "alms-cli"
+version = "0.1.6"
+description = "ALMS CLI - Beautiful project scaffolding tool for AI-first backends"
+readme = "README.md"
+requires-python = ">=3.13"
+license = { text = "MIT" }
+authors = [{ name = "Your Name", email = "your.email@example.com" }]
+keywords = [
+  "cli",
+  "scaffolding",
+  "fastapi",
+  "ai",
+  "backend",
+  "starter-kit",
+  "alms",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Code Generators",
+  "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+  "typer>=0.12.0",
+  "rich>=13.7.0",
+  "questionary>=2.0.0",
+  "jinja2>=3.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/KJ-AIML/alms"
+Repository = "https://github.com/KJ-AIML/alms"
+Documentation = "https://github.com/KJ-AIML/alms#readme"
+"Bug Tracker" = "https://github.com/KJ-AIML/alms/issues"
+
+[project.scripts]
+alms = "alms_cli.main:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/alms_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/README.md", "/LICENSE"]
+
+[dependency-groups]
+dev = [
+  "pytest>=9.0.2",
+  "fastapi[standard]>=0.122.0",
+  "pydantic>=2.12.5",
+  "pydantic-settings>=2.12.0",
+  "uvicorn>=0.38.0",
+  "prometheus-client>=0.23.1",
+  "sqlalchemy>=2.0.0",
+  "asyncpg>=0.29.0",
+]

{alms_cli-0.1.4 → alms_cli-0.1.6}/src/alms_cli/__init__.py

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

{alms_cli-0.1.4 → alms_cli-0.1.6}/src/alms_cli/commands/info.py

@@ -23,9 +23,9 @@ console = Console()
 @info_app.command()
 def project():
     """Show information about the current ALMS project."""
-    
+
     project_root = Path.cwd()
-    
+
     pyproject = project_root / "pyproject.toml"
     if not pyproject.exists():
         print_error("Not an ALMS project (pyproject.toml not found)")
@@ -33,7 +33,7 @@ def project():
         print_info("Run 'alms init <name>' to create a new project")
         console.print()
         raise typer.Exit(1)
-    
+
     console.print()
     console.print(
         Panel(
@@ -44,30 +44,37 @@ def project():
         )
     )
     console.print()
-    
+
     table = Table(
         box=box.ROUNDED,
         border_style="blue",
         title="[bold]Project Details[/bold]",
     )
-    
+
     table.add_column("Property", style="bold blue")
     table.add_column("Value", style="white")
-    
+
     table.add_row("Name", project_root.name)
     table.add_row("Location", str(project_root))
     table.add_row("Has pyproject.toml", "Yes")
     table.add_row("Has src/", str((project_root / "src").exists()))
     table.add_row("Has tests/", str((project_root / "src" / "tests").exists()))
     table.add_row("Has alembic/", str((project_root / "alembic").exists()))
-    
+
     console.print(table)
     console.print()
-    
+
     console.print("[bold]Project Structure:[/bold]")
     console.print()
-    
+
     if (project_root / "src").exists():
         print_tree(project_root / "src")
-    
+
     console.print()
+
+
+@info_app.callback(invoke_without_command=True)
+def info(ctx: typer.Context):
+    """Show information about the current ALMS project."""
+    if ctx.invoked_subcommand is None:
+        project()

{alms_cli-0.1.4 → alms_cli-0.1.6}/src/alms_cli/commands/init.py

@@ -18,35 +18,47 @@ from alms_cli.ui.components import (
     create_progress,
     print_project_summary,
 )
-from alms_cli.templates import TemplateGenerator
+from alms_cli.templates import (
+    TemplateGenerator,
+    PROFILE_CAPABILITIES,
+    resolve_capabilities,
+)
 
 console = Console()
 
 custom_style = Style([
     ("qmark", "fg:#FFFFFF"),
-    ("question", "fg:#FFFFFF"),
+    ("question", "fg:#FFFFFF nobold"),
     ("answer", "fg:#FFFFFF"),
-    ("pointer", "fg:#FFFFFF"),
-    ("highlighted", "fg:#FFFFFF"),
-    ("selected", "fg:#FFFFFF"),
+    ("pointer", "fg:#22C55E nobold"),
+    ("highlighted", "fg:#FFFFFF nobold"),
+    ("selected", "fg:#FFFFFF nobold"),
     ("separator", "fg:#666666"),
     ("instruction", "fg:#888888"),
-    ("text", "fg:#FFFFFF"),
+    ("text", "fg:#FFFFFF nobold"),
     ("disabled", "fg:#666666 italic"),
-    ("checkbox", "fg:#FFFFFF"),
-    ("checkbox.selected", "fg:#FFFFFF"),
+    ("checkbox", "fg:#666666 nobold"),
+    ("checkbox.selected", "fg:#22C55E nobold"),
 ])
 
+VALID_PROFILES = list(PROFILE_CAPABILITIES.keys())
+
 
 def init_command(
     name: str = typer.Argument(None, help="Project name"),
     path: str = typer.Option(None, "--path", "-p", help="Path to create project"),
-    interactive: bool = typer.Option(True, "--interactive/--no-interactive", "-i", help="Interactive mode"),
+    profile: str = typer.Option(
+        "core-api",
+        "--profile",
+        help=f"Project profile: {', '.join(VALID_PROFILES)}",
+    ),
+    interactive: bool = typer.Option(
+        True, "--interactive/--no-interactive", "-i", help="Interactive mode"
+    ),
 ):
     """Create a new ALMS project with beautiful scaffolding."""
-    
     print_header("ALMS Project Generator", "AI-First Backend Starter Kit")
-    
+
     if not name:
         if interactive:
             name = questionary.text(
@@ -55,16 +67,16 @@ def init_command(
                 style=custom_style,
                 validate=lambda x: len(x) > 0 and x.replace("-", "").replace("_", "").isalnum(),
             ).ask()
-            
+
             if not name:
                 print_error("Project name is required")
                 raise typer.Exit(1)
         else:
             print_error("Project name is required")
             raise typer.Exit(1)
-    
+
     project_path = Path(path) / name if path else Path(name)
-    
+
     if project_path.exists():
         if interactive:
             overwrite = questionary.confirm(
@@ -72,71 +84,96 @@ def init_command(
                 default=False,
                 style=custom_style,
             ).ask()
-            
+
             if not overwrite:
                 print_warning("Project creation cancelled")
                 raise typer.Exit(0)
         else:
             print_error(f"Directory '{name}' already exists")
             raise typer.Exit(1)
-    
-    features = []
-    
-    if interactive:
-        print_info("Select features to include:")
-        console.print()
-        
-        answers = questionary.checkbox(
-            "Features:",
+
+    # Resolve profile
+    if profile not in PROFILE_CAPABILITIES:
+        print_error(f"Unknown profile: {profile}. Valid: {', '.join(VALID_PROFILES)}")
+        raise typer.Exit(1)
+
+    capabilities = resolve_capabilities(profile=profile)
+
+    # Interactive feature selection (only when no profile or "core-api" selected)
+    features: list[str] = []
+    if interactive and profile == "core-api":
+        feature_choices = [
+            ("Database (PostgreSQL)", False),
+            ("Redis Cache", False),
+            ("AI Agents (LangChain)", False),
+            ("Observability (OpenTelemetry)", False),
+            ("Docker Support", False),
+            ("CI/CD (GitHub Actions)", False),
+        ]
+
+        selected = questionary.checkbox(
+            "Add capabilities to core-api:",
             choices=[
-                questionary.Choice("Database (PostgreSQL)", checked=True),
-                questionary.Choice("Redis Cache", checked=True),
-                questionary.Choice("AI Agents (LangChain)", checked=True),
-                questionary.Choice("Observability (OpenTelemetry)", checked=True),
-                questionary.Choice("Docker Support", checked=True),
-                questionary.Choice("CI/CD (GitHub Actions)", checked=True),
+                questionary.Choice(title=fn, checked=de)
+                for fn, de in feature_choices
             ],
             style=custom_style,
+            instruction="(Use arrow keys to move, <space> to select)",
         ).ask()
-        
-        features = [a for a in (answers or [])]
-    
+
+        if selected:
+            features = selected
+            # Merge feature selections into capabilities
+            capabilities = resolve_capabilities(profile="core-api", features=features)
+
+    display_profile = profile if not features else f"{profile}+custom"
+
     console.print()
     print_step(1, 4, f"Creating project structure in {project_path}")
-    
+    print_info(f"Profile: {display_profile}")
+
     with create_progress() as progress:
         task = progress.add_task("Generating files...", total=100)
-        
+
         generator = TemplateGenerator(name, project_path)
-        files_created = generator.generate(features)
-        
+        files_created = generator.generate(capabilities)
+
         progress.update(task, completed=100)
-    
+
     print_success(f"Created {files_created} files")
     console.print()
-    
+
     print_step(2, 4, "Setting up configuration")
     print_success("Environment template created (.env.example)")
     print_success("Git ignore created (.gitignore)")
-    print_success("Docker configuration created")
+    if "docker" in capabilities:
+        print_success("Docker configuration created")
     console.print()
-    
+
     print_step(3, 4, "Initializing project structure")
     print_success("API layer created")
     print_success("Execution layer created")
-    print_success("Agent layer created")
-    print_success("Database layer created")
-    print_success("Observability layer created")
+    if "llm" in capabilities:
+        print_success("Agent layer created")
+    if "database" in capabilities:
+        print_success("Database layer created")
+    if "observability" in capabilities:
+        print_success("Observability layer created")
     console.print()
-    
+
     print_step(4, 4, "Finalizing setup")
     print_success("Tests scaffolded")
     print_success("Documentation created")
-    print_success("GitHub workflows configured")
+    if "ci" in capabilities:
+        print_success("GitHub workflows configured")
     console.print()
-    
-    print_project_summary(project_path, files_created, features or ["All features"])
-    
+
+    print_project_summary(
+        project_path,
+        files_created,
+        sorted(capabilities),
+    )
+
     console.print(
         Panel(
             "[bold green]Your ALMS project is ready![/bold green]\n\n"
@@ -145,4 +182,4 @@ def init_command(
             border_style="green",
         )
     )
-    console.print()
+    console.print()

alms_cli-0.1.6/src/alms_cli/templates/__init__.py

@@ -0,0 +1,32 @@
+"""Project template generator -- capability-aware edition."""
+
+from .profiles import (
+    ALL_CAPABILITIES,
+    CAPABILITY_TO_EXTRA,
+    FEATURE_LABEL_TO_CAPABILITY,
+    NO_EXTRA_CAPABILITIES,
+    PROFILE_CAPABILITIES,
+    resolve_capabilities,
+    resolve_extras,
+)
+
+__all__ = [
+    "ALL_CAPABILITIES",
+    "CAPABILITY_TO_EXTRA",
+    "FEATURE_LABEL_TO_CAPABILITY",
+    "NO_EXTRA_CAPABILITIES",
+    "PROFILE_CAPABILITIES",
+    "TemplateGenerator",
+    "resolve_capabilities",
+    "resolve_extras",
+]
+
+
+def __getattr__(name: str):
+    if name == "TemplateGenerator":
+        generator_module = __import__(
+            "alms_cli.templates.generator",
+            fromlist=["TemplateGenerator"],
+        )
+        return generator_module.TemplateGenerator
+    raise AttributeError(name)

alms_cli-0.1.6/src/alms_cli/templates/files/.env.example.j2

@@ -0,0 +1,51 @@
+# Application identity
+APP_NAME={{ project_name }}
+APP_DESCRIPTION=Backend API for {{ project_name }}
+APP_VERSION=0.1.0
+SERVICE_NAME={{ project_name | lower | replace(' ', '-') }}
+
+# Server Configuration
+SERVER_PORT=3000
+SERVER_HOST=0.0.0.0
+ALLOWED_HOSTS=["*"]
+
+# Environment Configuration
+DEBUG=True
+SECRET_KEY=generate-a-secure-key-here
+
+# Security Configuration
+X_API_KEY=
+
+# API Configuration
+API_PREFIX=/api
+
+# Logging Configuration
+LOG_LEVEL=info
+LOG_SAVE_TO_FILE=false
+LOG_FILE=src/logs/app.log
+LOG_AUTO_SETUP=true
+{% if has_ai %}
+# OpenAI Configuration
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL_BASIC=gpt-4o-mini
+OPENAI_MODEL_REASONING=gpt-4o
+{% endif %}{% if has_db %}
+# Database Configuration (PostgreSQL)
+DATABASE_URL=
+DATABASE_HOST=localhost
+DATABASE_PORT=5432
+DATABASE_NAME=db
+DATABASE_USER=postgres
+DATABASE_PASSWORD=postgres
+{% endif %}{% if has_redis %}
+# Redis Configuration
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_DB=0
+{% endif %}{% if has_obs %}
+# Observability
+METRICS_ENABLED=true
+TRACING_ENABLED=true
+OTLP_ENDPOINT=http://localhost:4317
+{% endif %}

alms_cli-0.1.6/src/alms_cli/templates/files/.github/ISSUE_TEMPLATE/bug_report.yml.j2

@@ -0,0 +1,8 @@
+name: Bug Report
+description: Create a report to help us improve
+body:
+  - type: textarea
+    attributes:
+      label: Describe the bug
+    validations:
+      required: true

alms_cli-0.1.6/src/alms_cli/templates/files/.github/ISSUE_TEMPLATE/feature_request.yml.j2

@@ -0,0 +1,8 @@
+name: Feature Request
+description: Suggest an idea for this project
+body:
+  - type: textarea
+    attributes:
+      label: Describe the feature
+    validations:
+      required: true

alms_cli-0.1.6/src/alms_cli/templates/files/.github/dependabot.yml.j2

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"

alms_cli-0.1.6/src/alms_cli/templates/files/.github/pull_request_template.md.j2

@@ -0,0 +1,9 @@
+## Description
+
+Please include a summary of the changes.
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change

alms_cli-0.1.6/src/alms_cli/templates/files/.github/workflows/ci.yml.j2

@@ -0,0 +1,17 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+      - run: uv sync{{ extra_flag }}
+      - run: uv run pytest src/tests
+      - run: uv run ruff check src/

alms_cli-0.1.6/src/alms_cli/templates/files/.gitignore.j2

@@ -0,0 +1,36 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Environment
+.env
+.env.local
+
+# Logs
+*.log
+logs/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/

alms_cli-0.1.6/src/alms_cli/templates/files/Dockerfile.j2

@@ -0,0 +1,14 @@
+FROM python:3.13-slim
+
+WORKDIR /app
+
+RUN pip install uv
+
+COPY pyproject.toml uv.lock ./
+RUN uv sync --frozen --no-dev{{ extra_flag }}
+
+COPY . .
+
+EXPOSE 3000
+
+CMD ["uv", "run", "-m", "src.api.main", "--host", "0.0.0.0"]

alms_cli-0.1.6/src/alms_cli/templates/files/README.md.j2

@@ -0,0 +1,31 @@
+# {{ project_name }}
+
+> **The AI-First Backend for Scalable, Intelligent Applications.**
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.13+
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) installed
+
+### 1. Setup
+
+```bash
+cp .env.example .env
+```
+
+### 2. Install Dependencies
+
+```bash
+uv sync
+```
+
+### 3. Start the Application
+
+```bash
+uv run -m src.api.main
+```
+
+The API will be available at:
+- API: http://localhost:3000

alms_cli-0.1.6/src/alms_cli/templates/files/alembic/README.j2

@@ -0,0 +1 @@
+Alembic migrations