forge-dev 0.1.1__tar.gz → 0.1.3__tar.gz

forge_dev-0.1.3/.github/workflows/release-please.yml

@@ -0,0 +1,20 @@
+name: release-please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          config-file: .release-please-config.json
+          manifest-file: .release-please-manifest.json

{forge_dev-0.1.1 → forge_dev-0.1.3}/.gitignore

@@ -12,3 +12,4 @@ build/
 venv/
 .env
 *.log
+CLAUDE.md

forge_dev-0.1.3/.release-please-config.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "packages": {
+    ".": {
+      "release-type": "python",
+      "package-name": "forge-dev",
+      "changelog-path": "CHANGELOG.md",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "draft": false,
+      "prerelease": false,
+      "include-component-in-tag": false,
+      "tag-separator": "",
+      "changelog-sections": [
+        { "type": "feat", "section": "Features" },
+        { "type": "fix", "section": "Bug Fixes" },
+        { "type": "perf", "section": "Performance" },
+        { "type": "refactor", "section": "Refactoring" },
+        { "type": "docs", "section": "Documentation" },
+        { "type": "chore", "section": "Chores", "hidden": true },
+        { "type": "ci", "section": "CI", "hidden": true },
+        { "type": "test", "section": "Tests", "hidden": true },
+        { "type": "build", "section": "Build", "hidden": true },
+        { "type": "style", "section": "Style", "hidden": true }
+      ]
+    }
+  }
+}

forge_dev-0.1.3/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.3"
+}

forge_dev-0.1.3/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## [0.1.3](https://github.com/luiskcr/forge/compare/v0.1.2...v0.1.3) (2026-04-12)
+
+
+### Documentation
+
+* recommend uv as install method and document macOS Tahoe pyexpat issue ([292518a](https://github.com/luiskcr/forge/commit/292518a01ca7d546fa892a4618cced8033290524))
+
+## [0.1.2](https://github.com/luiskcr/forge/compare/v0.1.1...v0.1.2) (2026-04-12)
+
+
+### Features
+
+* discovery-driven context resolution with unspecified fields ([c5b2269](https://github.com/luiskcr/forge/commit/c5b22699105939be657692a9eb0bab96efbd279f))
+
+## Changelog
+
+All notable changes to this project are documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and uses [Conventional Commits](https://www.conventionalcommits.org/). The changelog below is maintained automatically by [release-please](https://github.com/googleapis/release-please) from commit messages on `main`.

{forge_dev-0.1.1 → forge_dev-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forge-dev
-Version: 0.1.1
+Version: 0.1.3
 Summary: AI-Native Development Workflow Engine
 Author: NaiaTech
 License-Expression: MIT
@@ -48,35 +48,73 @@ Forge encodes a complete development paradigm — from receiving a vague require
 
 ## Installation
 
+Forge is published on PyPI as `forge-dev`. The recommended way to install it is with [`uv`](https://github.com/astral-sh/uv), which manages its own Python and isolates CLI tools automatically:
+
+```bash
+# 1. Install uv (one-time, if you don't have it)
+curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS / Linux
+# Windows PowerShell:
+#   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# 2. Install forge-dev as a global tool
+uv tool install forge-dev
+
+# 3. Verify
+forge --version
+```
+
+<details>
+<summary>Alternative: <code>pipx</code></summary>
+
+```bash
+pipx install forge-dev
+forge --version
+```
+
+</details>
+
+<details>
+<summary>Alternative: plain <code>pip</code></summary>
+
 ```bash
 pip install forge-dev
 ```
 
-Or install from source:
+</details>
+
+<details>
+<summary>From source (for contributors)</summary>
 
 ```bash
 git clone https://github.com/luiskcr/forge.git
 cd forge
-pip install -e .
+pip install -e ".[dev]"
 ```
 
-Requires Python ≥ 3.11.
+</details>
+
+Requires Python ≥ 3.11. If you use `uv`, it will download a compatible Python automatically.
 
 ### Updating
 
+Use the same tool you installed with:
+
 ```bash
-pip install --upgrade forge-dev          # latest stable
-pip install --upgrade forge-dev==0.1.2   # pin a specific version
-forge --version                          # verify
+uv tool upgrade forge-dev        # if installed via uv (recommended)
+pipx upgrade forge-dev           # if installed via pipx
+pip install --upgrade forge-dev  # if installed via pip
+forge --version                  # verify the new version
 ```
 
-If you installed with `pipx`:
+To pin a specific version:
 
 ```bash
-pipx upgrade forge-dev
+uv tool install forge-dev==0.1.2 --force
 ```
 
-> Homebrew is not supported yet — Forge is distributed exclusively via PyPI.
+> **Homebrew is not supported.** Forge is distributed exclusively via PyPI.
+
+> **Note for macOS users on Tahoe (macOS 26):** the Homebrew bottles for `python@3.13` and `python@3.14` currently ship a broken `pyexpat` module (a `libexpat` symbol mismatch) that breaks `pip`, `pipx` and `venv`. If you hit `ImportError: Symbol not found: _XML_SetAllocTrackerActivationThreshold`, use `uv` instead — it bundles its own Python and avoids the issue entirely.
 
 ## How Forge Works
 

{forge_dev-0.1.1 → forge_dev-0.1.3}/README.md

@@ -19,35 +19,73 @@ Forge encodes a complete development paradigm — from receiving a vague require
 
 ## Installation
 
+Forge is published on PyPI as `forge-dev`. The recommended way to install it is with [`uv`](https://github.com/astral-sh/uv), which manages its own Python and isolates CLI tools automatically:
+
+```bash
+# 1. Install uv (one-time, if you don't have it)
+curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS / Linux
+# Windows PowerShell:
+#   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# 2. Install forge-dev as a global tool
+uv tool install forge-dev
+
+# 3. Verify
+forge --version
+```
+
+<details>
+<summary>Alternative: <code>pipx</code></summary>
+
+```bash
+pipx install forge-dev
+forge --version
+```
+
+</details>
+
+<details>
+<summary>Alternative: plain <code>pip</code></summary>
+
 ```bash
 pip install forge-dev
 ```
 
-Or install from source:
+</details>
+
+<details>
+<summary>From source (for contributors)</summary>
 
 ```bash
 git clone https://github.com/luiskcr/forge.git
 cd forge
-pip install -e .
+pip install -e ".[dev]"
 ```
 
-Requires Python ≥ 3.11.
+</details>
+
+Requires Python ≥ 3.11. If you use `uv`, it will download a compatible Python automatically.
 
 ### Updating
 
+Use the same tool you installed with:
+
 ```bash
-pip install --upgrade forge-dev          # latest stable
-pip install --upgrade forge-dev==0.1.2   # pin a specific version
-forge --version                          # verify
+uv tool upgrade forge-dev        # if installed via uv (recommended)
+pipx upgrade forge-dev           # if installed via pipx
+pip install --upgrade forge-dev  # if installed via pip
+forge --version                  # verify the new version
 ```
 
-If you installed with `pipx`:
+To pin a specific version:
 
 ```bash
-pipx upgrade forge-dev
+uv tool install forge-dev==0.1.2 --force
 ```
 
-> Homebrew is not supported yet — Forge is distributed exclusively via PyPI.
+> **Homebrew is not supported.** Forge is distributed exclusively via PyPI.
+
+> **Note for macOS users on Tahoe (macOS 26):** the Homebrew bottles for `python@3.13` and `python@3.14` currently ship a broken `pyexpat` module (a `libexpat` symbol mismatch) that breaks `pip`, `pipx` and `venv`. If you hit `ImportError: Symbol not found: _XML_SetAllocTrackerActivationThreshold`, use `uv` instead — it bundles its own Python and avoids the issue entirely.
 
 ## How Forge Works
 

forge_dev-0.1.3/forge_core/__init__.py

@@ -0,0 +1,8 @@
+"""Forge — AI-Native Development Workflow Engine."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("forge-dev")
+except PackageNotFoundError:  # pragma: no cover — running from source without install
+    __version__ = "0.0.0+unknown"

{forge_dev-0.1.1 → forge_dev-0.1.3}/forge_core/cli.py

@@ -163,6 +163,47 @@ def init(name: str | None, backend: str | None, no_interactive: bool) -> None:
             "## Entries\n\n"
         )
 
+    # Create overrides/ with a README so users know what goes there
+    overrides_dir = project_path / ".forge" / "overrides"
+    overrides_dir.mkdir(parents=True, exist_ok=True)
+    overrides_readme = overrides_dir / "README.md"
+    if not overrides_readme.exists():
+        overrides_readme.write_text(
+            "# Project Overrides\n\n"
+            "Drop YAML files here to override or extend Forge governance for "
+            "this project only:\n\n"
+            "- `standards/<name>.yaml` — add or override a standard\n"
+            "- `patterns/<name>.yaml` — project-specific approved patterns\n"
+            "- `anti-patterns/<name>.yaml` — project-specific anti-patterns\n\n"
+            "These are merged on top of global user overrides from "
+            "`~/.forge/user/` when generating `CLAUDE.md`. Run "
+            "`forge sync` after editing.\n"
+        )
+
+    # Generate editor instructions (CLAUDE.md), Claude Code skill, and —
+    # if the project has unresolved fields — the discovery prompt for the
+    # AI editor to fill in.
+    #
+    # CLAUDE.md is NOT overwritten if it already exists — user may have
+    # customized it. Skill and discovery files are Forge-owned and always
+    # regenerated.
+    from forge_core.editor_bridge import collect_unspecified_fields, write_editor_file
+
+    existing_claude = project_path / "CLAUDE.md"
+    if existing_claude.exists():
+        claude_md_path = existing_claude
+        claude_status = "[yellow]kept (already exists — run `forge sync` to overwrite)[/yellow]"
+    else:
+        claude_md_path = write_editor_file(project_path, context, "claude")
+        claude_status = "[green]generated[/green]"
+    skill_path = write_editor_file(project_path, context, "skill")
+
+    # Discovery prompt — only if there are unspecified fields
+    unspecified = collect_unspecified_fields(context)
+    discovery_path: Path | None = None
+    if unspecified:
+        discovery_path = write_editor_file(project_path, context, "discovery")
+
     # Record in global history
     from forge_core.registry import record_project
     record_project(
@@ -171,21 +212,45 @@ def init(name: str | None, backend: str | None, no_interactive: bool) -> None:
         {"type": context.type, "backend": context.backend, "cloud": context.cloud},
     )
 
+    # Build the summary panel
+    summary_lines = [
+        f"[green]✓ Forge initialized for [bold]{context.name}[/bold][/green]\n",
+        f"Context:   {context_path}",
+        f"Journal:   {journal_path}",
+        f"Overrides: {overrides_dir}",
+        f"CLAUDE:    {claude_md_path} — {claude_status}",
+        f"Skill:     {skill_path}",
+    ]
+    if discovery_path:
+        summary_lines.append(f"Discovery: {discovery_path} [yellow](fields need resolution)[/yellow]")
+    summary_lines += [
+        "",
+        f"Stack: {context.backend.value} + {context.frontend.value}",
+        f"Cloud: {context.cloud.value}",
+        f"Auth:  {context.auth.value}",
+        "",
+    ]
+    if unspecified:
+        fields = ", ".join(f"`{u['key']}`" for u in unspecified)
+        summary_lines.append(
+            f"[yellow]⚠ {len(unspecified)} field(s) unspecified:[/yellow] {fields}"
+        )
+        summary_lines.append(
+            "Read `.forge/discovery_prompt.md` in your AI editor — it will"
+        )
+        summary_lines.append(
+            "investigate the repo and fill these in automatically."
+        )
+    else:
+        summary_lines += [
+            "Next steps:",
+            "  forge intake <file>  — process a requirement document",
+            "  forge audit          — run audit agents",
+            "  forge sync           — regenerate editor files after changes",
+        ]
+
     console.print()
-    console.print(Panel(
-        f"[green]✓ Forge initialized for [bold]{context.name}[/bold][/green]\n\n"
-        f"Context: {context_path}\n"
-        f"Journal: {journal_path}\n\n"
-        f"Stack: {context.backend.value} + {context.frontend.value}\n"
-        f"Cloud: {context.cloud.value}\n"
-        f"Auth: {context.auth.value}\n\n"
-        "Next steps:\n"
-        "  forge intake <file>  — process a requirement document\n"
-        "  forge plan           — generate implementation plan\n"
-        "  forge audit          — run audit agents",
-        title="🔥 Ready",
-        border_style="green",
-    ))
+    console.print(Panel("\n".join(summary_lines), title="🔥 Ready", border_style="green"))
 
 
 @main.command()
@@ -455,14 +520,16 @@ def mcps() -> None:
 )
 def sync(format: str) -> None:
     """Generate editor instruction files from Forge governance.
-    
+
     Translates ALL Forge knowledge (standards, patterns, journal,
     context) into a CLAUDE.md, .cursorrules, or equivalent file
     that the AI editor reads and follows.
-    
+
     This is the core value of Forge — it bridges governance to the editor.
+    Also always refreshes the Claude Code skill and cleans up the discovery
+    prompt if every context field is resolved.
     """
-    from forge_core.editor_bridge import write_editor_file
+    from forge_core.editor_bridge import collect_unspecified_fields, write_editor_file
     from forge_core.phases.context import load_context
 
     project_path = Path.cwd()
@@ -481,8 +548,26 @@ def sync(format: str) -> None:
         path = write_editor_file(project_path, context, fmt)
         console.print(f"[green]✓ Generated: {path}[/green]")
 
+    # Always refresh the skill file (Forge-owned)
+    skill_path = write_editor_file(project_path, context, "skill")
+    console.print(f"[green]✓ Generated: {skill_path}[/green]")
+
+    # Discovery prompt: regenerate if there are still unspecified fields,
+    # delete it if everything is resolved.
+    remaining = collect_unspecified_fields(context)
+    discovery_file = project_path / ".forge" / "discovery_prompt.md"
+    if remaining:
+        write_editor_file(project_path, context, "discovery")
+        console.print(
+            f"[yellow]⚠ {len(remaining)} field(s) still unspecified — "
+            "discovery prompt refreshed.[/yellow]"
+        )
+    elif discovery_file.exists():
+        discovery_file.unlink()
+        console.print("[dim]Removed .forge/discovery_prompt.md (all fields resolved).[/dim]")
+
     console.print()
-    console.print("[dim]The editor will read this file automatically.[/dim]")
+    console.print("[dim]The editor will read these files automatically.[/dim]")
     console.print("[dim]Re-run `forge sync` after changing standards or context.[/dim]")
 
 
@@ -548,5 +633,118 @@ def audit(files: tuple[str, ...], full: bool) -> None:
         )
 
 
+@main.group()
+def context() -> None:
+    """Inspect or update the project context (.forge/context.yaml).
+
+    Used by AI editors during the discovery flow to fill in fields Forge
+    could not auto-detect.
+    """
+    pass
+
+
+@context.command("show")
+def context_show() -> None:
+    """Print the resolved project context as YAML."""
+    import yaml as _yaml
+
+    from forge_core.phases.context import load_context
+
+    project_path = Path.cwd()
+    ctx = load_context(project_path)
+    if not ctx:
+        console.print("[red]No Forge project found. Run `forge init` first.[/red]")
+        sys.exit(1)
+    console.print(_yaml.dump(ctx.model_dump(mode="json"), sort_keys=False))
+
+
+@context.command("set")
+@click.argument("assignments", nargs=-1, required=True)
+def context_set(assignments: tuple[str, ...]) -> None:
+    """Set one or more context fields: `forge context set cloud=azure iac=bicep`.
+
+    Supported keys: cloud, backend, frontend, database, auth, type, description,
+    cicd.iac, cicd.provider, ai.enabled. Nested keys use dot notation.
+    After updates, CLAUDE.md and the skill are auto-regenerated.
+    """
+    from forge_core.editor_bridge import collect_unspecified_fields, write_editor_file
+    from forge_core.phases.context import load_context, save_context
+
+    project_path = Path.cwd()
+    ctx = load_context(project_path)
+    if not ctx:
+        console.print("[red]No Forge project found. Run `forge init` first.[/red]")
+        sys.exit(1)
+
+    data = ctx.model_dump(mode="json")
+    updated: list[str] = []
+    errors: list[str] = []
+
+    for assignment in assignments:
+        if "=" not in assignment:
+            errors.append(f"'{assignment}' — expected key=value")
+            continue
+        key, raw_value = assignment.split("=", 1)
+        key = key.strip()
+        value: object = raw_value.strip()
+
+        # Booleans
+        if value in ("true", "True"):
+            value = True
+        elif value in ("false", "False"):
+            value = False
+
+        # Nested key (dot notation)
+        parts = key.split(".")
+        target = data
+        try:
+            for p in parts[:-1]:
+                target = target[p]
+            target[parts[-1]] = value
+            updated.append(f"{key}={raw_value}")
+        except (KeyError, TypeError):
+            errors.append(f"'{key}' — unknown field")
+
+    if errors:
+        for e in errors:
+            console.print(f"[red]✗ {e}[/red]")
+    if not updated:
+        sys.exit(1)
+
+    # Re-validate by round-tripping through the Pydantic model
+    from forge_core.models import ProjectContext
+    try:
+        new_ctx = ProjectContext(**data)
+    except Exception as exc:
+        console.print(f"[red]✗ Validation failed:[/red] {exc}")
+        sys.exit(1)
+
+    save_context(new_ctx, project_path)
+
+    # Regenerate editor files that exist and skill (skill is always owned by Forge)
+    from forge_core.editor_bridge import sync_editor_file
+    sync_editor_file(project_path, new_ctx)
+    write_editor_file(project_path, new_ctx, "skill")
+
+    # Clean up discovery prompt if nothing left unresolved
+    discovery_file = project_path / ".forge" / "discovery_prompt.md"
+    remaining = collect_unspecified_fields(new_ctx)
+    if not remaining and discovery_file.exists():
+        discovery_file.unlink()
+        console.print("[dim]Removed .forge/discovery_prompt.md (all fields resolved).[/dim]")
+    elif remaining:
+        # Refresh the discovery prompt with the remaining fields
+        write_editor_file(project_path, new_ctx, "discovery")
+
+    for u in updated:
+        console.print(f"[green]✓ {u}[/green]")
+
+    if remaining:
+        fields = ", ".join(r["key"] for r in remaining)
+        console.print(f"[yellow]Still unspecified:[/yellow] {fields}")
+    else:
+        console.print("[green]All context fields resolved.[/green]")
+
+
 if __name__ == "__main__":
     main()

{forge_dev-0.1.1 → forge_dev-0.1.3}/forge_core/detector.py

@@ -28,6 +28,10 @@ CONFIG_FILES = {
     "package.json", "pyproject.toml", "requirements.txt", "Cargo.toml",
     "go.mod", "pom.xml", "build.gradle", "Gemfile", "composer.json",
     "Makefile", "Dockerfile", "docker-compose.yml", "docker-compose.yaml",
+    # IaC
+    "main.bicep", "Pulumi.yaml", "main.tf", "terraform.tf", "azure.yaml",
+    # CI/CD
+    "azure-pipelines.yml", ".gitlab-ci.yml",
 }
 
 IGNORE_DIRS = {
@@ -157,14 +161,18 @@ def _scan_directory(
 
 
 def _detect_stack(path: Path, config_files: list[Path]) -> dict[str, str]:
-    """Detect the technology stack from config files."""
+    """Detect the technology stack from config files.
+
+    Only fills fields Forge can identify with high confidence from file
+    contents or presence. Anything uncertain is left out — the discovery
+    flow (via CLAUDE.md) asks the AI editor to resolve the gaps.
+    """
     stack: dict[str, str] = {}
     config_names = {f.name for f in config_files}
 
-    # Backend detection
+    # ── Backend / language ────────────────────────────────────────────────
     if "pyproject.toml" in config_names or "requirements.txt" in config_names:
         stack["language"] = "python"
-        # Try to detect framework
         for cfg in config_files:
             if cfg.name in ("pyproject.toml", "requirements.txt"):
                 try:
@@ -190,20 +198,87 @@ def _detect_stack(path: Path, config_files: list[Path]) -> dict[str, str]:
                         stack["backend"] = "node/fastify"
                     elif "nestjs" in content or "@nestjs" in content:
                         stack["backend"] = "node/nestjs"
-                    # Frontend detection
-                    if '"react"' in content or '"react-dom"' in content:
-                        stack["frontend"] = "react"
-                    elif '"next"' in content:
+                    # Frontend
+                    if '"next"' in content:
                         stack["frontend"] = "nextjs"
+                    elif '"react"' in content or '"react-dom"' in content:
+                        stack["frontend"] = "react"
                     elif '"vue"' in content:
                         stack["frontend"] = "vue"
                     elif '"svelte"' in content:
                         stack["frontend"] = "svelte"
+                    elif '"@angular/core"' in content:
+                        stack["frontend"] = "angular"
+                    # Auth (only strong signals)
+                    if "@azure/msal" in content:
+                        stack["auth"] = "azure-ad-b2c"
+                    elif '"next-auth"' in content or '"@auth/core"' in content:
+                        stack["auth"] = "custom-jwt"
+                    elif '"@clerk/' in content:
+                        stack["auth"] = "clerk"
+                    elif '"@supabase/supabase-js"' in content:
+                        stack["auth"] = "supabase-auth"
+                    elif '"auth0"' in content or '"@auth0/' in content:
+                        stack["auth"] = "auth0"
+                except Exception:
+                    pass
+
+    # ── IaC ───────────────────────────────────────────────────────────────
+    if any(f.suffix == ".bicep" for f in config_files) or "main.bicep" in config_names:
+        stack["iac"] = "bicep"
+        stack["cloud"] = "azure"
+    elif "Pulumi.yaml" in config_names:
+        stack["iac"] = "pulumi"
+    elif "main.tf" in config_names or "terraform.tf" in config_names:
+        stack["iac"] = "terraform"
+    elif "azure.yaml" in config_names:
+        stack["iac"] = "azd"
+        stack["cloud"] = "azure"
+
+    # Scan top-level for .bicep/.tf files even if not in CONFIG_FILES set
+    try:
+        for entry in path.iterdir():
+            if entry.is_file():
+                if entry.suffix == ".bicep":
+                    stack.setdefault("iac", "bicep")
+                    stack.setdefault("cloud", "azure")
+                elif entry.suffix == ".tf":
+                    stack.setdefault("iac", "terraform")
+    except Exception:
+        pass
+
+    # ── CI/CD ─────────────────────────────────────────────────────────────
+    if (path / ".github" / "workflows").exists():
+        stack["cicd"] = "github-actions"
+    elif "azure-pipelines.yml" in config_names:
+        stack["cicd"] = "azure-devops"
+    elif ".gitlab-ci.yml" in config_names:
+        stack["cicd"] = "gitlab-ci"
+
+    # ── Database (from docker-compose services) ──────────────────────────
+    compose_name = (
+        "docker-compose.yml" if "docker-compose.yml" in config_names
+        else "docker-compose.yaml" if "docker-compose.yaml" in config_names
+        else None
+    )
+    if compose_name:
+        for cfg in config_files:
+            if cfg.name == compose_name:
+                try:
+                    content = cfg.read_text(errors="ignore").lower()
+                    if "postgres" in content:
+                        stack["database"] = "postgresql"
+                    elif "mysql" in content or "mariadb" in content:
+                        stack["database"] = "mysql"
+                    elif "mongo" in content:
+                        stack["database"] = "mongodb"
+                    elif "mssql" in content or "sql-server" in content:
+                        stack["database"] = "sqlserver"
                 except Exception:
                     pass
 
-    # Docker detection
-    if "Dockerfile" in config_names or "docker-compose.yml" in config_names:
+    # ── Docker ────────────────────────────────────────────────────────────
+    if "Dockerfile" in config_names or compose_name:
         stack["containerized"] = "true"
 
     return stack