devctl 1.2.2__py3-none-any.whl → 1.2.4__py3-none-any.whl

devctl/commands/init.py

@@ -6,6 +6,7 @@ Django, Svelte, and Go.
 
 import typer
 
+from devctl.generators.agent import generate_agent_context
 from devctl.generators.angular import generate_angular_boilerplate
 from devctl.generators.django import generate_django_boilerplate
 from devctl.generators.fastapi import generate_fastapi_boilerplate
@@ -46,6 +47,7 @@ def init_spring(
 
     if success_download:
         generate_config(name, db_type=db, custom_port=port)
+        generate_agent_context()
         typer.secho("\nSpring project ready!", fg=typer.colors.GREEN)
 
 
@@ -61,6 +63,7 @@ def init_angular(name: str):
     success = generate_angular_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nAngular project ready!", fg=typer.colors.GREEN)
 
 
@@ -75,6 +78,7 @@ def init_vue(name: str):
     success = generate_vue_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nVue.js project ready!", fg=typer.colors.GREEN)
 
 
@@ -89,6 +93,7 @@ def init_nest(name: str):
     success = generate_nest_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nNestJS project ready!", fg=typer.colors.GREEN)
 
 
@@ -103,6 +108,7 @@ def init_nodejs(name: str):
     success = generate_nodejs_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nNodeJS project ready!", fg=typer.colors.GREEN)
 
 
@@ -117,6 +123,7 @@ def init_react(name: str):
     success = generate_react_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nReactJS project ready!", fg=typer.colors.GREEN)
 
 
@@ -131,6 +138,7 @@ def init_nextjs(name: str):
     success = generate_nextjs_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nNextJS project ready!", fg=typer.colors.GREEN)
 
 
@@ -145,6 +153,7 @@ def init_fastapi(name: str):
     success = generate_fastapi_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nFastAPI project ready!", fg=typer.colors.GREEN)
 
 
@@ -159,6 +168,7 @@ def init_django(name: str):
     success = generate_django_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nDjango project ready!", fg=typer.colors.GREEN)
 
 
@@ -173,6 +183,7 @@ def init_svelte(name: str):
     success = generate_svelte_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nSvelte project ready!", fg=typer.colors.GREEN)
 
 
@@ -187,4 +198,18 @@ def init_go(name: str):
     success = generate_go_boilerplate(name)
 
     if success:
+        generate_agent_context()
         typer.secho("\nGo project ready!", fg=typer.colors.GREEN)
+
+
+@app.command("agent")
+def init_agent():
+    """
+    Generates or refreshes AGENTS.md, CLAUDE.md, and .cursorrules for the current project.
+    """
+    success = generate_agent_context()
+    if success:
+        typer.secho("\nAgent context ready!", fg=typer.colors.GREEN)
+    else:
+        typer.secho("\nFailed to generate agent context.", fg=typer.colors.RED)
+        raise typer.Exit(code=1)

devctl/generators/agent/__init__.py

@@ -0,0 +1,7 @@
+"""
+Agent context generator package.
+"""
+
+from devctl.generators.agent.generator import generate_agent_context
+
+__all__ = ["generate_agent_context"]

devctl/generators/agent/generator.py

@@ -0,0 +1,269 @@
+"""
+Agent context generator.
+Produces AGENTS.md, CLAUDE.md, and .cursorrules for AI coding assistants.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+from pathlib import Path
+from typing import Any, Dict, List, Union
+
+import typer
+import yaml
+from jinja2 import Environment, FileSystemLoader
+
+from devctl.generators.docker.scaffolder import IGNORED_DIRECTORIES, discover_docker_projects
+
+FRAMEWORK_METADATA: Dict[str, Dict[str, Any]] = {
+    "spring": {
+        "framework": "Spring Boot",
+        "category": "backend",
+        "default_port": 8080,
+        "run_cmd": "./mvnw spring-boot:run",
+        "test_cmd": "./mvnw test",
+    },
+    "fastapi": {
+        "framework": "FastAPI",
+        "category": "backend",
+        "default_port": 8000,
+        "run_cmd": "uvicorn main:app --reload",
+        "test_cmd": "pytest",
+    },
+    "django": {
+        "framework": "Django",
+        "category": "backend",
+        "default_port": 8000,
+        "run_cmd": "python manage.py runserver",
+        "test_cmd": "python manage.py test",
+    },
+    "nest": {
+        "framework": "NestJS",
+        "category": "backend",
+        "default_port": 3000,
+        "run_cmd": "npm run start:dev",
+        "test_cmd": "npm test",
+    },
+    "nodejs": {
+        "framework": "NodeJS / Express",
+        "category": "backend",
+        "default_port": 3000,
+        "run_cmd": "npm run dev",
+        "test_cmd": "npm test",
+    },
+    "go": {
+        "framework": "Go (Fiber)",
+        "category": "backend",
+        "default_port": 3000,
+        "run_cmd": "go run .",
+        "test_cmd": "go test ./...",
+    },
+    "angular": {
+        "framework": "Angular",
+        "category": "frontend",
+        "default_port": 4200,
+        "run_cmd": "npx ng serve",
+        "test_cmd": "npm test",
+    },
+    "vue": {
+        "framework": "Vue 3",
+        "category": "frontend",
+        "default_port": 5173,
+        "run_cmd": "npm run dev",
+        "test_cmd": "npm test",
+    },
+    "react": {
+        "framework": "React",
+        "category": "frontend",
+        "default_port": 5173,
+        "run_cmd": "npm run dev",
+        "test_cmd": "npm test",
+    },
+    "nextjs": {
+        "framework": "Next.js",
+        "category": "frontend",
+        "default_port": 3000,
+        "run_cmd": "npm run dev",
+        "test_cmd": "npm test",
+    },
+    "svelte": {
+        "framework": "Svelte",
+        "category": "frontend",
+        "default_port": 5173,
+        "run_cmd": "npm run dev",
+        "test_cmd": "npm test",
+    },
+}
+
+
+def _detect_service_port(project_path: Path, kind: str, default_port: int) -> int:
+    """Extract configured service port or fallback to default."""
+    if kind == "spring":
+        props_path = project_path / "src" / "main" / "resources" / "application.properties"
+        if props_path.exists():
+            try:
+                content = props_path.read_text(encoding="utf-8")
+                match = re.search(r"^server\.port\s*=\s*(\d+)", content, re.MULTILINE)
+                if match:
+                    return int(match.group(1))
+            except Exception:
+                pass
+    return default_port
+
+
+def _discover_databases(root: Path) -> List[Dict[str, Any]]:
+    """Scan for docker-compose-db.yml files and extract service configuration."""
+    databases: List[Dict[str, Any]] = []
+
+    for dirpath, dirnames, filenames in os.walk(root):
+        dirnames[:] = [d for d in dirnames if d not in IGNORED_DIRECTORIES]
+        if "docker-compose-db.yml" in filenames:
+            compose_path = Path(dirpath) / "docker-compose-db.yml"
+            try:
+                content = yaml.safe_load(compose_path.read_text(encoding="utf-8")) or {}
+                services = content.get("services", {})
+                for s_name, s_conf in services.items():
+                    image = str(s_conf.get("image", "unknown"))
+                    ports = s_conf.get("ports", [])
+                    host_port = "unknown"
+                    if ports:
+                        raw_port = str(ports[0])
+                        host_port = raw_port.split(":")[0] if ":" in raw_port else raw_port
+
+                    env_vars = s_conf.get("environment", {})
+                    if isinstance(env_vars, list):
+                        parsed_env = {}
+                        for item in env_vars:
+                            if isinstance(item, str) and "=" in item:
+                                k, v = item.split("=", 1)
+                                parsed_env[k.strip()] = v.strip()
+                        env_vars = parsed_env
+
+                    db_user = (
+                        env_vars.get("POSTGRES_USER")
+                        or env_vars.get("MYSQL_USER")
+                        or env_vars.get("MONGO_INITDB_ROOT_USERNAME")
+                        or "admin"
+                    )
+                    db_password = (
+                        env_vars.get("POSTGRES_PASSWORD")
+                        or env_vars.get("MYSQL_PASSWORD")
+                        or env_vars.get("MONGO_INITDB_ROOT_PASSWORD")
+                        or "password"
+                    )
+                    db_name = (
+                        env_vars.get("POSTGRES_DB")
+                        or env_vars.get("MYSQL_DATABASE")
+                        or env_vars.get("MONGO_INITDB_DATABASE")
+                        or "default_db"
+                    )
+
+                    image_lower = image.lower()
+                    if "postgres" in image_lower:
+                        db_type = "PostgreSQL"
+                    elif "mysql" in image_lower:
+                        db_type = "MySQL"
+                    elif "mongo" in image_lower:
+                        db_type = "MongoDB"
+                    else:
+                        db_type = "Database"
+
+                    rel_compose = compose_path.relative_to(root).as_posix()
+                    databases.append(
+                        {
+                            "service_name": s_name,
+                            "db_type": db_type,
+                            "image": image,
+                            "port": host_port,
+                            "db_name": db_name,
+                            "db_user": db_user,
+                            "db_password": db_password,
+                            "compose_file": f"./{rel_compose}",
+                        }
+                    )
+            except Exception:
+                pass
+
+    return databases
+
+
+def generate_agent_context(root_path: Union[str, Path] = ".") -> bool:
+    """
+    Scans the repository and generates AGENTS.md, CLAUDE.md, and .cursorrules.
+    """
+    root = Path(root_path).resolve()
+    if not root.exists() or not root.is_dir():
+        return False
+
+    try:
+        discovered = discover_docker_projects(root)
+    except Exception:
+        discovered = []
+
+    services: List[Dict[str, Any]] = []
+    backends: List[Dict[str, Any]] = []
+    frontends: List[Dict[str, Any]] = []
+
+    for p in discovered:
+        meta = FRAMEWORK_METADATA.get(
+            p.kind,
+            {
+                "framework": p.kind.capitalize(),
+                "category": "backend",
+                "default_port": 8080,
+                "run_cmd": "devctl run",
+                "test_cmd": "npm test",
+            },
+        )
+        port = _detect_service_port(p.path, p.kind, meta["default_port"])
+        try:
+            rel_path = f"./{p.path.relative_to(root).as_posix()}"
+        except ValueError:
+            rel_path = f"./{p.name}"
+
+        service_data = {
+            "name": p.name,
+            "kind": p.kind,
+            "framework": meta["framework"],
+            "category": meta["category"],
+            "relative_path": rel_path,
+            "port": port,
+            "run_cmd": meta["run_cmd"],
+            "test_cmd": meta["test_cmd"],
+        }
+        services.append(service_data)
+        if meta["category"] == "backend":
+            backends.append(service_data)
+        else:
+            frontends.append(service_data)
+
+    databases = _discover_databases(root)
+
+    template_dir = Path(__file__).parent / "templates"
+    env = Environment(loader=FileSystemLoader(str(template_dir)), autoescape=False)
+
+    context = {
+        "services": services,
+        "backends": backends,
+        "frontends": frontends,
+        "databases": databases,
+    }
+
+    try:
+        agents_tpl = env.get_template("AGENTS.md.j2")
+        claude_tpl = env.get_template("CLAUDE.md.j2")
+        cursor_tpl = env.get_template(".cursorrules.j2")
+
+        (root / "AGENTS.md").write_text(agents_tpl.render(context), encoding="utf-8")
+        (root / "CLAUDE.md").write_text(claude_tpl.render(context), encoding="utf-8")
+        (root / ".cursorrules").write_text(cursor_tpl.render(context), encoding="utf-8")
+
+        typer.secho(
+            "Agent context generated (AGENTS.md, CLAUDE.md, .cursorrules).",
+            fg=typer.colors.CYAN,
+        )
+        return True
+    except Exception as e:
+        typer.secho(f"Warning: Failed to generate agent context: {e}", fg=typer.colors.YELLOW)
+        return False

devctl/generators/agent/templates/AGENTS.md.j2

@@ -0,0 +1,87 @@
+# Project Development Guide for AI Agents
+
+> This project is orchestrated using `devctl`. All commands, multi-tier processes,
+> and scaffolding workflows must adhere to the boundaries documented below.
+
+## 1. Project Architecture & Active Topology
+{% if backends %}
+### Backend Services
+{% for b in backends %}
+- **{{ b.name }}** ({{ b.framework }})
+  - Path: `{{ b.relative_path }}`
+  - Local Port: `{{ b.port }}`
+  - Run Command: `{{ b.run_cmd }}`
+  - Test Suite: `{{ b.test_cmd }}`
+{% endfor %}
+{% endif %}
+{% if frontends %}
+### Frontend Services
+{% for f in frontends %}
+- **{{ f.name }}** ({{ f.framework }})
+  - Path: `{{ f.relative_path }}`
+  - Local Dev Port: `{{ f.port }}`
+  - Run Command: `{{ f.run_cmd }}`
+  - Test Suite: `{{ f.test_cmd }}`
+{% endfor %}
+{% endif %}
+{% if databases %}
+### Databases & Infrastructure
+{% for db in databases %}
+- **Service**: `{{ db.service_name }}`
+  - Type: `{{ db.db_type }}`
+  - Image: `{{ db.image }}`
+  - Host Port: `{{ db.port }}`
+  - Database Name: `{{ db.db_name }}`
+  - Credentials: User=`{{ db.db_user }}`, Password=`{{ db.db_password }}`
+  - Compose File: `{{ db.compose_file }}`
+{% endfor %}
+{% endif %}
+{% if not backends and not frontends and not databases %}
+- Topology: No active microservices detected yet. Run `devctl init <framework> <name>` to add services.
+{% endif %}
+
+## 2. Devctl Orchestration & Lifecycle Commands
+
+Always use `devctl` to orchestrate services. Do NOT start background daemons, manually detached docker processes, or raw ad-hoc runners unless debugging an isolated failure.
+
+- **Start entire stack** (Databases + Backends + Frontends in parallel with unified log streaming):
+  ```bash
+  devctl run
+  ```
+- **Interactive TUI Dashboard** (System metrics, real-time log inspection, process management):
+  ```bash
+  devctl tui
+  ```
+- **Vertical Full-Stack Scaffolding** (Generates Entity, DTOs, Repository, Service, Controller, and Frontend client):
+  ```bash
+  devctl add resource <ResourceName> -f "<field1>:<type>,<field2>:<type>"
+  ```
+- **Containerization & Deployment Scaffolding**:
+  ```bash
+  devctl docker scaffold
+  devctl docker generate
+  ```
+
+## 3. Full-Stack Contract & Coding Conventions
+
+When adding or modifying API endpoints or data models:
+- **API Endpoints**: Use standard RESTful patterns with `/api/v1` prefixes.
+- **DTOs / Contracts**:
+  - Request payloads must be modeled with `<Entity>Request` DTOs.
+  - Response payloads must be modeled with `<Entity>Response` DTOs.
+- **Type Compatibility**:
+  - Backend numeric IDs / Long / Integer -> Frontend TypeScript `number`
+  - Backend UUID / String -> Frontend TypeScript `string`
+  - Backend Instant / LocalDateTime / DateTime -> Frontend TypeScript `string` (ISO 8601 formatted)
+  - Backend Boolean -> Frontend TypeScript `boolean`
+- **Synchronization**: Any change to backend DTO fields or endpoints MUST be immediately reflected in the corresponding frontend API client, models, and interfaces.
+
+## 4. Agent Operational Guardrails
+
+- **Process Management**: Do NOT run detached background processes (`nohup`, `&`, `screen`, `tmux`) that outlive the session. Use `devctl run` for execution.
+- **Testing Before Completion**: Always run the respective test suite for modified services before concluding any task:
+{% for s in services %}
+  - `{{ s.name }}`: `{{ s.test_cmd }}`
+{% endfor %}
+- **Docker Compose Boundaries**: Do NOT alter database port mappings in `docker-compose-db.yml` without updating application configuration files in lockstep.
+- **Dependency Checks**: Ensure required tools are available using `devctl` verification conventions before executing framework-specific build scripts.

devctl/generators/agent/templates/CLAUDE.md.j2

@@ -0,0 +1,8 @@
+# Claude Code Guidelines
+
+This project is managed and orchestrated by `devctl`.
+
+- Review [AGENTS.md](AGENTS.md) for complete architecture topology, active services, port allocations, and devctl lifecycle commands.
+- Use `devctl run` to boot services and `devctl add resource` for full-stack CRUD scaffolding.
+- Ensure backend DTOs and frontend TypeScript interfaces remain strictly synchronized.
+- Execute unit and integration tests before finishing tasks.

devctl/generators/angular/templates/config/proxy.conf.json.j2

@@ -0,0 +1,6 @@
+{
+  "/api": {
+    "target": "http://localhost:8080",
+    "secure": false
+  }
+}

devctl/generators/nodejs/generator.py

@@ -75,6 +75,18 @@ def generate_nodejs_boilerplate(project_name: str) -> bool:
             shell=platform.shell_required,
         )
 
+        # Patch tsconfig.json to disable verbatimModuleSyntax for ES module compatibility
+        tsconfig_path = os.path.join(project_path, "tsconfig.json")
+        if os.path.exists(tsconfig_path):
+            with open(tsconfig_path, "r", encoding="utf-8") as f:
+                content = f.read()
+            # Replace verbatimModuleSyntax if present or add option
+            content = content.replace(
+                '"verbatimModuleSyntax": true', '"verbatimModuleSyntax": false'
+            )
+            with open(tsconfig_path, "w", encoding="utf-8") as f:
+                f.write(content)
+
         # 4. Create folder structure
         os.makedirs(os.path.join(project_path, "src"), exist_ok=True)
 

devctl/generators/nodejs/templates/config/index.ts.j2

@@ -1,4 +1,5 @@
-import express, { Request, Response } from 'express';
+import express from 'express';
+import type { Request, Response } from 'express';
 import dotenv from 'dotenv';
 
 dotenv.config();

devctl/generators/nodejs/templates/resource/controller.ts.j2

@@ -1,4 +1,4 @@
-import { Request, Response } from 'express';
+import type { Request, Response } from 'express';
 
 export const get{{ entity_name }}s = (req: Request, res: Response) => {
   res.json({ message: 'Get all {{ resource_lower }}s' });

devctl/generators/react/generator.py

@@ -22,7 +22,16 @@ def generate_react_boilerplate(project_name: str) -> bool:
         platform = get_platform()
         typer.secho("Scaffolding React project...", fg=typer.colors.CYAN)
         subprocess.run(
-            ["npm", "create", "vite@latest", safe_name, "--", "--template", "react-ts"],
+            [
+                "npm",
+                "create",
+                "vite@latest",
+                safe_name,
+                "--",
+                "--template",
+                "react-ts",
+                "--no-interactive",
+            ],
             check=True,
             shell=platform.shell_required,
         )

devctl/generators/svelte/generator.py

@@ -30,11 +30,11 @@ def generate_svelte_boilerplate(project_name: str) -> bool:
                 "create",
                 safe_name,
                 "--template",
-                "skeleton",
+                "minimal",
                 "--types",
-                "typescript",
+                "ts",
+                "--no-add-ons",
                 "--no-install",
-                "--no-git",
             ],
             check=True,
             shell=platform.shell_required,

devctl/generators/vue/generator.py

@@ -56,7 +56,7 @@ def setup_vue_router(project_path: str):
         os.makedirs(router_dir, exist_ok=True)
 
         # 3. Jinja2 template rendering
-        templates_dir = os.path.join(os.path.dirname(__file__), "..", "templates", "vue", "config")
+        templates_dir = os.path.join(os.path.dirname(__file__), "templates", "config")
         env = Environment(loader=FileSystemLoader(templates_dir))
 
         files_to_generate = {
@@ -89,7 +89,16 @@ def generate_vue_boilerplate(project_name: str) -> bool:
     try:
         typer.secho("Scaffolding Vite project...", fg=typer.colors.CYAN)
         subprocess.run(
-            ["npm", "create", "vite@latest", safe_name, "--", "--template", "vue-ts"],
+            [
+                "npm",
+                "create",
+                "vite@latest",
+                safe_name,
+                "--",
+                "--template",
+                "vue-ts",
+                "--no-interactive",
+            ],
             check=True,
             shell=platform.shell_required,
         )

devctl/orchestrator/config_builder.py

@@ -13,7 +13,9 @@ def generate_config(project_name: str, db_type: str = "postgres", custom_port: i
     """
     Generates the initial configuration (Docker and Spring properties) for a new project.
     """
-    template_dir = os.path.join(os.path.dirname(__file__), "..", "templates", "spring")
+    template_dir = os.path.join(
+        os.path.dirname(__file__), "..", "generators", "spring", "templates"
+    )
     env = Environment(loader=FileSystemLoader(template_dir))
 
     # Intelligent default port resolution

devctl/tui/app.py

@@ -55,6 +55,7 @@ from devctl.commands.init import (
     generate_svelte_boilerplate,
     generate_vue_boilerplate,
 )
+from devctl.generators.agent import generate_agent_context
 from devctl.generators.docker import discover_docker_projects, scaffold_docker_assets
 from devctl.orchestrator.config_builder import generate_config
 from devctl.orchestrator.process_manager import ProcessManager
@@ -347,6 +348,7 @@ class DevctlTUI(App):
                         ]
                         yield Select(
                             frameworks,
+                            value="spring",
                             prompt="Choose target framework",
                             id="init-project-framework",
                         )
@@ -456,8 +458,10 @@ class DevctlTUI(App):
         if not self.single_panel:
             try:
                 select_add = self.query_one("#add-resource-target", Select)
-                options = [(f"{p.name} ({p.kind})", p.name) for p in self.projects]
-                select_add.options = options
+                options = [(f"{p.name} ({p.kind.upper()})", p.name) for p in self.projects]
+                select_add.set_options(options)
+                if options and (select_add.value == Select.BLANK or select_add.value is None):
+                    select_add.value = options[0][1]
             except Exception:
                 pass
 
@@ -786,6 +790,7 @@ class DevctlTUI(App):
                     generate_go_boilerplate(name)
                 else:
                     print(f"Error: Unknown framework boilerplate '{framework}'")
+                generate_agent_context(".")
                 print("\nProject initialized successfully!")
         except Exception as e:
             print(f"Error during initialization: {e}", file=f)
@@ -797,11 +802,20 @@ class DevctlTUI(App):
         self.trigger_rescan_and_refresh()
 
     def trigger_rescan_and_refresh(self) -> None:
-        """Helper to safely perform rescan and trigger UI updates."""
-        self.perform_rescan()
-        self.refresh_ui_elements()
+        """Helper to safely perform rescan and trigger UI updates from background threads."""
+
+        def _refresh():
+            self.perform_rescan()
+            self.refresh_ui_elements()
+
+        self.call_from_thread(_refresh)
 
     def on_unmount(self) -> None:
+        """Stops all running background services and containers when quitting TUI."""
+        try:
+            self.action_stop_all()
+        except Exception:
+            pass
         self.manager.cleanup_all()
 
 

devctl/tui/app.tcss

@@ -0,0 +1,353 @@
+Screen {
+    background: $background;
+    color: $text;
+}
+
+Header {
+    background: $surface;
+    color: $primary;
+    text-align: center;
+    text-style: bold;
+    height: 1;
+}
+
+Footer {
+    background: $background;
+    color: $text-muted;
+}
+
+TabbedContent {
+    height: 1fr;
+}
+
+/* Custom Textual Tabs Styling (htop style) */
+ContentTabs {
+    height: 1;
+    background: $background;
+    border-bottom: solid $border;
+}
+
+ContentTabs Tab {
+    height: 1;
+    padding: 0 2;
+    background: $background;
+    color: $text-muted;
+}
+
+ContentTabs Tab:hover {
+    background: $surface;
+    color: $text;
+}
+
+ContentTabs Tab.--active {
+    background: $primary;
+    color: $background;
+    text-style: bold;
+}
+
+/* TabPane and container rules */
+TabPane {
+    padding: 0;
+}
+
+.dashboard-container {
+    padding: 0 2;
+    layout: vertical;
+    overflow-y: auto;
+}
+
+.dashboard-title {
+    text-style: bold;
+    color: $primary;
+    margin-top: 1;
+    margin-bottom: 0;
+}
+
+.dashboard-card {
+    background: $background;
+    border: solid $border;
+    margin-bottom: 1;
+    padding: 0 2;
+    layout: vertical;
+}
+
+.framework-item {
+    margin-bottom: 0;
+    padding: 0 1;
+    border-left: solid $success;
+    background: $background;
+}
+
+/* Services Control Tab Layout */
+.services-container {
+    height: 1fr;
+    width: 100%;
+}
+
+.services-list-panel {
+    background: $background;
+    border-right: solid $border;
+    padding: 0 1;
+    width: 7fr;
+    height: 100%;
+}
+
+#services-list {
+    height: 1fr;
+    border: solid $border;
+    margin-top: 1;
+    margin-bottom: 1;
+}
+
+.logs-panel {
+    background: $background;
+    padding: 0 1;
+    layout: vertical;
+    width: 9fr;
+    height: 100%;
+}
+
+.logs-title-bar {
+    text-style: bold;
+    color: $text-muted;
+    border-bottom: solid $border;
+    padding-bottom: 0;
+    margin-bottom: 1;
+    height: 1;
+}
+
+.logs-view {
+    background: $background;
+    color: $text;
+    height: 1fr;
+    border: solid $border;
+}
+
+.service-item-row {
+    padding: 0 1;
+    margin-bottom: 0;
+    background: $background;
+    border: none;
+    layout: horizontal;
+    height: 1;
+}
+
+.service-item-row:hover {
+    background: $surface;
+    color: $text;
+}
+
+.service-item-row.selected {
+    background: $accent;
+    color: $background;
+    text-style: bold;
+}
+
+.service-item-row .status-label {
+    text-style: bold;
+    margin-left: 2;
+}
+
+.service-item-row .metric-label {
+    margin-left: 2;
+    color: $text-muted;
+}
+
+/* Docker and Scaffolding Forms */
+.form-container {
+    padding: 0 2;
+    layout: vertical;
+    overflow-y: auto;
+}
+
+.form-group {
+    margin-top: 1;
+    margin-bottom: 1;
+    layout: vertical;
+}
+
+.form-label {
+    text-style: bold;
+    color: $text-muted;
+    margin-bottom: 0;
+}
+
+/* CLI style Inputs: 1 cell tall, no border, colored bg */
+.form-input {
+    background: $surface;
+    color: $text;
+    height: 1;
+    border: none;
+    padding: 0 1;
+    width: 60;
+}
+
+.form-input:focus {
+    background: $accent;
+    color: $background;
+}
+
+/* Select Dropdown: 1 cell tall, no border */
+Select {
+    border: none;
+    width: 60;
+}
+
+SelectCurrent {
+    height: 1;
+    border: none;
+    background: $surface;
+    padding: 0 1;
+}
+
+SelectCurrent:focus {
+    background: $accent;
+    color: $background;
+}
+
+.form-checkbox {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+/* CLI style Buttons: 1 cell tall, highlighted bg, no border */
+Button {
+    background: $surface;
+    color: $text;
+    height: 1;
+    border: none;
+    padding: 0 2;
+    min-width: 8;
+}
+
+Button:hover {
+    background: $accent;
+    color: $background;
+}
+
+/* Submit Button Specifics */
+.submit-button {
+    background: $primary;
+    color: $background;
+    text-style: bold;
+    margin-top: 1;
+    margin-bottom: 1;
+    width: 30;
+}
+
+.submit-button:hover {
+    background: $success;
+    color: $background;
+}
+
+.form-container Horizontal {
+    height: 1;
+    margin-top: 1;
+    margin-bottom: 1;
+}
+
+.form-container Horizontal Button {
+    width: 30;
+    margin-right: 2;
+}
+
+.form-output-panel {
+    background: $background;
+    border: solid $border;
+    padding: 1;
+    height: 15;
+    color: $success;
+    overflow-y: scroll;
+}
+
+/* Toolbars inside Services and Single Panel */
+#service-control-toolbar, #service-control-bulk-toolbar {
+    height: 1;
+    margin-top: 1;
+    margin-bottom: 1;
+}
+
+#service-control-toolbar Button, #service-control-bulk-toolbar Button {
+    width: 1fr;
+    min-width: 0;
+    margin-right: 1;
+    height: 1;
+}
+
+#lbl-srv-controls {
+    margin-top: 1;
+}
+
+#spring-db-group {
+    margin-top: 1;
+}
+
+/* Single Panel Layout Styles */
+#single-container {
+    height: 1fr;
+    width: 100%;
+    layout: vertical;
+}
+
+#single-top-row {
+    height: 7;
+    width: 100%;
+    border-bottom: solid $border;
+}
+
+#single-system-info {
+    width: 6fr;
+    height: 100%;
+    border-right: solid $border;
+    padding: 0 2;
+}
+
+#single-db-summary {
+    width: 4fr;
+    height: 100%;
+    padding: 0 2;
+}
+
+#single-bottom-row {
+    height: 1fr;
+    width: 100%;
+}
+
+#single-services-panel {
+    width: 7fr;
+    height: 100%;
+    border-right: solid $border;
+    padding: 0 1;
+}
+
+#single-logs-panel {
+    width: 9fr;
+    height: 100%;
+    padding: 0 1;
+}
+
+.section-title {
+    text-style: bold;
+    color: $primary;
+    margin-bottom: 0;
+}
+
+/* Navigation Helper Bar Styles */
+#top-nav-helper {
+    height: 1;
+    background: $surface;
+    layout: horizontal;
+    align: center middle;
+    width: 100%;
+    margin-bottom: 0;
+}
+
+.nav-arrow {
+    text-style: bold;
+    color: $primary;
+    padding: 0 2;
+}
+
+#nav-hint-text {
+    color: $text;
+}

{devctl-1.2.2.dist-info → devctl-1.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devctl
-Version: 1.2.2
+Version: 1.2.4
 Summary: Local development orchestrator for Spring Boot, Angular, and Vue.js
 Author: Youssef Fellah
 License: MIT License
@@ -29,7 +29,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typer>=0.12.3
@@ -64,6 +64,9 @@ containerization across Linux, macOS, and Windows.
 -   **Interactive Dashboard**: Real-time system monitoring (CPU/RAM/Disk) and service orchestration with side-by-side log streaming (`devctl tui`).
 -   **Security by Default**: Inject standardized JWT authentication and security
     configurations into new projects.
+-   **AI Agent Context Generation**: Automatically creates and updates `AGENTS.md`,
+    `CLAUDE.md`, and `.cursorrules` on project initialization, aligning coding agents
+    (Claude Code, Cursor, Copilot) with active ports, commands, and contract conventions.
 
 ## Interactive Dashboard (TUI)
 
@@ -153,5 +156,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 for details.
 
 ---
-Authored by Youssef Fellah.
-Professional Development Orchestrator.
+
+## Author
+
+- **Author:** Youssef Fellah ([ind4x_](https://github.com/ind4x))

{devctl-1.2.2.dist-info → devctl-1.2.4.dist-info}/RECORD

@@ -4,16 +4,20 @@ devctl/commands/__init__.py,sha256=EZuqGRLRdPpMri5WHmiyhmz8aLs08R1tDQ4FtwMLqMQ,4
 devctl/commands/add.py,sha256=Xre6E3jOxdTwGf3OiMwFIc-o-IjyWk5n4f2BYNMVQC8,6753
 devctl/commands/deploy.py,sha256=lzpk1ZcCMxLiMisg9E43B1G9Fhjbklxlbnk3vegm8Us,1688
 devctl/commands/docker.py,sha256=J9Y7Wxnqc_I2EPf-0BMnJngWUJgKJ3BCbNolvGCGASQ,1813
-devctl/commands/init.py,sha256=SSkJDytouuY8ri7WuxOr4SuXca-dRRxa6qPKIEuEwj8,5981
+devctl/commands/init.py,sha256=w4ZpUy05Mcu60qfb9P5YdZI-DU-KmjhN9eCkVyy-_QY,6799
 devctl/commands/run.py,sha256=BHqMV0G1AKgwxErVFxcG5QALn-zkQJUT2sozqPA_Cbo,2250
 devctl/commands/tui.py,sha256=HONll0HbHAvP1cdqcceRSUneHjCZj06Jhht5LUMP414,829
 devctl/generators/__init__.py,sha256=Wj-CryHTG5PyR8PEv-Z02wvX_qW2n7GVaE1rfwWSFmo,68
+devctl/generators/agent/__init__.py,sha256=zu5vLCMWMWSfqcAD52MHe4i_ZxtKhhwIbTZZbfxLjIE,149
+devctl/generators/agent/generator.py,sha256=S0KcCi1w-0YYFJtcx_7QmswD1upLuKqB_t5cmpDHiS8,9079
+devctl/generators/agent/templates/AGENTS.md.j2,sha256=oRElhsnsdipkocwI5hZSE30AL_mL_P6Qv0BoCL7DlRI,3651
+devctl/generators/agent/templates/CLAUDE.md.j2,sha256=dEAI8AY7M4CN72e3w0gTQ_DhgC5YNbgjrGa39tlTpok,458
 devctl/generators/angular/__init__.py,sha256=R-ive4k2bf5Z0cWNNa00e5OQJlgNAK4fqDC9vylTfXs,278
 devctl/generators/angular/generator.py,sha256=deo257s_PoJ4jc7WHIX3VPqjiIoAMuW9DSGJjTovdP0,4290
 devctl/generators/angular/scaffolder.py,sha256=IszCxMHUDeJysMbwUAGMkBhhh0MPsQap6hOQYWLwchg,5446
 devctl/generators/angular/templates/config/environment.development.ts.j2,sha256=VoL0vYnyp8c0k9t20ThdW8mZhCq0KdCLP8_onyLjeRc,69
 devctl/generators/angular/templates/config/environment.ts.j2,sha256=rnLcMCwm5FOE5GEIAQmyZyvt9xOrekXGsRzgfCJOPhY,155
-devctl/generators/angular/templates/config/proxy.conf.json.j2,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devctl/generators/angular/templates/config/proxy.conf.json.j2,sha256=AoFocoSyxVa2jI0p7DG4Z461nMdI9w0HFmIH9ADThV8,78
 devctl/generators/angular/templates/feature/routes.ts.j2,sha256=Kyk-pbDaYsx_bg-asK8dZxfbqpHV0ss7P35u8VbiQSM,545
 devctl/generators/angular/templates/feature/models/request.model.ts.j2,sha256=3DAAgyb3MLQekqDNVIs3CVgj5nXiS0hneQSvHeuwmHU,125
 devctl/generators/angular/templates/feature/models/response.model.ts.j2,sha256=mhAHeUS9CwOs7fLFJ7OOVByPGgyAvWKeDUdNeVlm9qs,140
@@ -65,13 +69,13 @@ devctl/generators/nextjs/scaffolder.py,sha256=KdUkr95bscInOaRHp8rZAadmzKmZf3Q5hD
 devctl/generators/nextjs/templates/resource/component.tsx.j2,sha256=-uYdBZI56SXmLbdncqgcLZFJ7iBNmo9vOTENDIPZWMk,394
 devctl/generators/nextjs/templates/resource/page.tsx.j2,sha256=6c8fg7NeYulwBQfYQdyhSNoag7JMCO8m-E6RNuRT16Y,323
 devctl/generators/nodejs/__init__.py,sha256=jpvFJZ_VGWp9GjfCNMZbnaXNe7abEchAVIAq8DE9f-A,271
-devctl/generators/nodejs/generator.py,sha256=JHqW2k0i1RTwQkU6DAP01g32XimCuaO1sHRBOEGsCvk,3426
+devctl/generators/nodejs/generator.py,sha256=GEDGzkGO5SWM84h37dmClKbhoehiv4g7hWd7WNM8FPU,4028
 devctl/generators/nodejs/scaffolder.py,sha256=cfRHwnSxxy59EuOFMksSJ5RkF9JrbPj_x2Fgu8iTWuk,2117
-devctl/generators/nodejs/templates/config/index.ts.j2,sha256=_toUlhEFj38qme-J44CDthErSO6oI-dPbCmX0uh86JI,396
-devctl/generators/nodejs/templates/resource/controller.ts.j2,sha256=MY6UopaFJ4QknZWTtKmWwMcx-Hq7vubf94Yzz0H5GR4,539
+devctl/generators/nodejs/templates/config/index.ts.j2,sha256=WIQ300m9sFHSDv4q28lYbX_EQ0n5Lq-RHqehiZOY6MM,423
+devctl/generators/nodejs/templates/resource/controller.ts.j2,sha256=TJBlTNOXti7IQmv5JshXo6KEgZRXdAEwi-wCdNsSel0,544
 devctl/generators/nodejs/templates/resource/routes.ts.j2,sha256=0YslAicDqu2pHBqYLWUZGOEXQg3iO4Udy5JTJowaYM4,405
 devctl/generators/react/__init__.py,sha256=MlTLvYrmO-v7_7ITsS8hX5Et7dGvLcwxarGbXcM2OA8,264
-devctl/generators/react/generator.py,sha256=InH0T5o71CNYdQGR5-xV21N8qzlkEFEIAs-8pGgOke4,1582
+devctl/generators/react/generator.py,sha256=eujNdgjrXW8KBngvZyJNDWweH7-fqLP6hTYf4L6R1c0,1745
 devctl/generators/react/scaffolder.py,sha256=lA0FGhj1LTOj0SfdWwlqXWppx5N2H4aXeMlX8a6tYZQ,2164
 devctl/generators/react/templates/resource/component.tsx.j2,sha256=7AYliBowiB4A-erHV56cDVXX2SeMRBJ3uCQGxktFPVY,375
 devctl/generators/react/templates/resource/service.ts.j2,sha256=yDCLVM-AGf0sbYsMxSOuS_Yw0dWigCTFzdJPgLrsWHo,409
@@ -93,12 +97,12 @@ devctl/generators/spring/templates/dto/Request.java.j2,sha256=EoVg3dHqE63prHr_3D
 devctl/generators/spring/templates/dto/Response.java.j2,sha256=k1FrU9yqGxlyhvU0slBe53lg-kMor1OxeB713L_8PVg,448
 devctl/generators/spring/templates/mapper/Mapper.java.j2,sha256=1P-J3QkbBfy4i7YEIkWe3e_OrxMQj3gL3qSqqbgqCJo,1116
 devctl/generators/svelte/__init__.py,sha256=zfmH5awxXGqZnnHgjdCE95wwws4TrTl3hZQw3ZwjJpY,271
-devctl/generators/svelte/generator.py,sha256=SKNffNlncADcKsY38pn1MUV-kZ8YMhsdgAda3IZ-XXY,1847
+devctl/generators/svelte/generator.py,sha256=AU67y9LpayqnKTXT6WhHucK61ACjws-UQ8H_WYZo-so,1842
 devctl/generators/svelte/scaffolder.py,sha256=90YeH_Wzi9LVX_UvS2n-8Vyz97zGB_RZrJIFnTUJ0io,2111
 devctl/generators/svelte/templates/resource/component.svelte.j2,sha256=38bZSc_AJS-8mYyLavC9psxGBWg8AHvp6BvVoee4FVs,263
 devctl/generators/svelte/templates/resource/page.svelte.j2,sha256=I-9V33ZvAEX1KZw1_Ppka9M1yVzLlRUEJCgGMrQZXeg,179
 devctl/generators/vue/__init__.py,sha256=GDbArDE1XEWsf2RTcm5QPjlccSCcOFAwAHmx6cGN1VU,253
-devctl/generators/vue/generator.py,sha256=slTIQonj_hj9ibNcsQVXFrSw7PsRJTci6UOIq180n_0,4066
+devctl/generators/vue/generator.py,sha256=BOnSgnSUZHXIvFHIIZG0anZL0w09SNkyigWlwiZ2Sf4,4216
 devctl/generators/vue/scaffolder.py,sha256=BLTBDrCBMsA4y2lJKHi-8rLrgTrhu1doWUs5iuYLXwk,3497
 devctl/generators/vue/templates/config/App.vue.j2,sha256=019FJ-P2cPAFEO99NtqpYcCpE25mEBapdnW8yB-OmzA,542
 devctl/generators/vue/templates/config/main.ts.j2,sha256=edNelsh0qYHybZZ5UWxKEg24n3PYYR8L3heD4iwUP-E,173
@@ -110,18 +114,19 @@ devctl/generators/vue/templates/feature/models.ts.j2,sha256=am0no09-huAe9woUbMwH
 devctl/generators/vue/templates/feature/routes.ts.j2,sha256=ooUpJZa3E8WsF0ykvAo0KLYdBWFha6uv9z3b4sVKjFY,607
 devctl/generators/vue/templates/feature/service.ts.j2,sha256=jzvkxao3LtaEWI2P_H_I59gUuylVIAyQ-tvEjQHAu8I,1616
 devctl/orchestrator/__init__.py,sha256=guj85FATiYbeQ8K7QnaE09YV_VSVWuwEAie1lLQpgKE,87
-devctl/orchestrator/config_builder.py,sha256=VZzF7vIBCxDIKhOg2QZ3gqUebsND2f3J2EHvYa96J0E,2099
+devctl/orchestrator/config_builder.py,sha256=z8dOCUDBjzbYvEgDCS7ZcROXwpbQHuJQXvntM3gbodQ,2127
 devctl/orchestrator/process_manager.py,sha256=ac6M91W4F_PWFVe4lQhnXIiQBTasJOVA0o5AKpyt8DQ,9868
 devctl/orchestrator/runner.py,sha256=VC4AyfqHd7TNN3PN-lUXP56_tIjrqya-WUje_Qry7e4,7893
 devctl/orchestrator/scanner.py,sha256=b8JtnK0OhZitKzajlIjJJhUsrf5jXVuVW_j08ZOESfo,5677
-devctl/tui/app.py,sha256=BtkqseoFGBcRaFiuSVXWU-VUD5W6kJ7CUkce4HSpjOE,33876
+devctl/tui/app.py,sha256=0XzhT4sVMdWxN3Qe4hyGuUQLjGAoZHJLsf1URXHroAQ,34457
+devctl/tui/app.tcss,sha256=IQOMHHME3dEHhcbBm47uAWsZWz-N7hhNDWJt-QEwfRc,5535
 devctl/utils/__init__.py,sha256=M57MX2uzHxehKbh21XrYLoSVP8XxiU5B5JbM3cIpE9k,111
 devctl/utils/dependencies.py,sha256=6aCy0JU5T1VXe8eCtA9K7HcReU3CtduwgY_OLpTf1Cg,1493
 devctl/utils/env_loader.py,sha256=Q_n4Iv3hhK9whuayp0SpwDMyzH2eliIjtC3g3l6YvJ0,1700
 devctl/utils/platform.py,sha256=FUGP3rBoYhcsdh74IBk-lh8Ho12bOqmvveDAjjV71PI,3435
-devctl-1.2.2.dist-info/licenses/LICENSE,sha256=ejuOzK7v5suPzolNB0qJJZ78UNEG17KV-5vVQR-yMQI,1071
-devctl-1.2.2.dist-info/METADATA,sha256=aa-RSVcgNFvDs3NiC6ph6lxMpopxDvL0_MS4eeCNd3M,5392
-devctl-1.2.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-devctl-1.2.2.dist-info/entry_points.txt,sha256=kbeKCy-Jwx7EaubbhJg0ni5f_8VFdrtR1ACnp4QtEWg,44
-devctl-1.2.2.dist-info/top_level.txt,sha256=NrzcRKPiNVlovhxKHBn0ttiP9NWL9obUn9vRxBItB5I,7
-devctl-1.2.2.dist-info/RECORD,,
+devctl-1.2.4.dist-info/licenses/LICENSE,sha256=ejuOzK7v5suPzolNB0qJJZ78UNEG17KV-5vVQR-yMQI,1071
+devctl-1.2.4.dist-info/METADATA,sha256=duKZooBYIpFfvaMT2FfQ-T6h2DnLOSzcXNa7KvzFS3w,5664
+devctl-1.2.4.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+devctl-1.2.4.dist-info/entry_points.txt,sha256=kbeKCy-Jwx7EaubbhJg0ni5f_8VFdrtR1ACnp4QtEWg,44
+devctl-1.2.4.dist-info/top_level.txt,sha256=NrzcRKPiNVlovhxKHBn0ttiP9NWL9obUn9vRxBItB5I,7
+devctl-1.2.4.dist-info/RECORD,,

{devctl-1.2.2.dist-info → devctl-1.2.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any