From 13d04d0767427b17e0b94e651506466f513ca607 Mon Sep 17 00:00:00 2001
From: johndoe6345789 <john.doe6345789@gmail.com>
Date: Wed, 18 Mar 2026 10:49:25 +0000
Subject: [PATCH] fix(deployment): resolve run() shadowing in stack.py and
 disable broken storybook build

stack.py line 130 `run = run_cmd` shadowed the imported `run` helper from
cli.helpers, causing a recursive TypeError on `stack up`. Renamed import to
`run_shell` to avoid the collision. Moved storybook behind a profile since
its Docker build fails due to @storybook/addon-docs version mismatch.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 deployment/cli/stack.py             | 17 +++++++++--------
 deployment/docker-compose.stack.yml |  1 +
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/deployment/cli/stack.py b/deployment/cli/stack.py
index 5ffbaf233..8aa9d6829 100644
--- a/deployment/cli/stack.py
+++ b/deployment/cli/stack.py
@@ -6,7 +6,8 @@ import sys
 import time
 from cli.helpers import (
     GREEN, YELLOW, BLUE, RED, NC,
-    docker_compose, log_info, log_ok, log_warn, log_err, pull_with_retry, run,
+    docker_compose, log_info, log_ok, log_warn, log_err, pull_with_retry,
+    run as run_shell,
 )
 
 
@@ -84,41 +85,41 @@ def run_cmd(args: argparse.Namespace, config: dict) -> int:
 
     if command in ("down", "stop"):
         log_info("Stopping MetaBuilder stack...")
-        run(docker_compose(*profiles, "down"))
+        run_shell(docker_compose(*profiles, "down"))
         log_ok("Stack stopped")
         return 0
 
     if command == "restart":
-        run(docker_compose(*profiles, "restart"))
+        run_shell(docker_compose(*profiles, "restart"))
         log_ok("Stack restarted")
         return 0
 
     if command == "logs":
-        run(docker_compose(*profiles, "logs", "-f"))
+        run_shell(docker_compose(*profiles, "logs", "-f"))
         return 0
 
     if command in ("ps", "status"):
-        run(docker_compose(*profiles, "ps"))
+        run_shell(docker_compose(*profiles, "ps"))
         return 0
 
     if command == "clean":
         answer = input(f"{RED}This will remove all containers and volumes! Are you sure? (yes/no): {NC}")
         if answer.strip() == "yes":
-            run(docker_compose(*profiles, "down", "-v"))
+            run_shell(docker_compose(*profiles, "down", "-v"))
             log_ok("Stack cleaned")
         return 0
 
     if command == "build":
         log_info("Building MetaBuilder stack...")
         _pull_external_images(profiles, config)
-        run(docker_compose(*profiles, "up", "-d", "--build"))
+        run_shell(docker_compose(*profiles, "up", "-d", "--build"))
         log_ok("Stack built and started")
         return 0
 
     if command in ("up", "start"):
         log_info("Starting MetaBuilder stack...")
         _pull_external_images(profiles, config)
-        run(docker_compose(*profiles, "up", "-d"))
+        run_shell(docker_compose(*profiles, "up", "-d"))
         print(f"\n{GREEN}Stack started!{NC}\n")
         _wait_for_healthy(profiles, args)
         return 0
diff --git a/deployment/docker-compose.stack.yml b/deployment/docker-compose.stack.yml
index b4c0ce931..1ea2caaef 100644
--- a/deployment/docker-compose.stack.yml
+++ b/deployment/docker-compose.stack.yml
@@ -692,6 +692,7 @@ services:
 
   # Storybook - Component library
   storybook:
+    profiles: ["storybook"]
     build:
       context: ..
       dockerfile: storybook/Dockerfile