devlinker 1.3.0__tar.gz → 1.3.1__tar.gz

{devlinker-1.3.0 → devlinker-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.3.0
+Version: 1.3.1
 Summary: AI-powered linking and automation tool
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -18,20 +18,36 @@ Requires-Dist: websockets
 
 Dev Linker runs frontend and backend dev servers, proxies both through a single local port (8000), and creates a single public URL via Cloudflare or ngrok.
 
+
 ## Features
 
-- Launches frontend automatically (when frontend exists)
-- Auto-detects backend runtime (Docker Compose, Dockerfile, Node, or Python)
-- Auto-starts Python/Node backends; Docker is manual by default for reliability
-- Detects common frontend/backend ports
-- Detects Vite frontend across dynamic fallback ports (5173-5190, plus common alternatives)
-- Supports Docker backend port auto-detection
-- Works with dynamic container host ports
-- No config needed for standard FastAPI or Flask plus Docker flows
-- Serves both through one proxy at http://localhost:8000
-- Creates a public tunnel for sharing (Cloudflare first, ngrok fallback)
-- Terminal-first workflow
-- Supports CLI version output with --version
+- 🚀 **Unified Dev Proxy:** Combines frontend (Vite/React) and backend (FastAPI/Flask/Node/Docker) into a single local and public URL.
+- 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
+- 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
+- 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
+- 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
+- 🔄 **Dynamic Tunnel Control:** `devlinker unshare` disables public tunnel at runtime.
+- 📡 **WLAN Sharing:** Prints LAN URL for same-network device access.
+- 🧑‍💻 **Interactive CLI:** Modern, colorized, emoji-rich terminal UX for all commands.
+- 🧩 **Zero Config:** Works out-of-the-box for most FastAPI, Flask, Vite, and Docker projects.
+- 🧪 **Runtime Smoke Test:** Built-in test for end-to-end proxy validation.
+- 🛠️ **Extensible:** Modular architecture for future SaaS, dashboard, and team features.
+
+## CLI Commands & Options
+
+- `devlinker` — Start proxy (local only, fast)
+- `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
+- `devlinker share` — Enable public tunnel at runtime (no restart)
+- `devlinker unshare` — Disable public tunnel at runtime
+- `devlinker doctor` — Diagnose issues, see categorized problems and fixes
+- `devlinker fix` — Auto-fix common issues (env, API paths, config)
+- `devlinker --frontend 5173 --backend 5000` — Override detected ports
+- `devlinker --docker` — Auto-start Docker backend
+- `devlinker --no-tunnel` — Force local-only mode
+- `devlinker --no-lan` — Hide WLAN sharing URL
+- `devlinker --interactive-backend` — Prompt to choose backend if multiple found
+- `devlinker --proxy-port 18000` — Use custom proxy port
+- `devlinker --version` — Show version
 
 ## Project Structure
 
@@ -123,17 +139,71 @@ Enable Docker auto-start explicitly:
 devlinker --docker
 ```
 
-Run local-only mode without tunnel:
+
+## Tunnel and Sharing Modes
+
+By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
+
+
+```bash
+devlinker --url
+```
+
+In your terminal output, you'll see:
+
+
+URL, run:
+
+```bash
+devlinker --url
+```
+
+This will start the proxy and open a public tunnel (Cloudflare or ngrok). The output will show:
+
+```text
+🌍 Enabling public tunnel...
+[OK] Tunnel provider: Cloudflare
+[OK] Public URL:
+     https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
+[INFO] Share this link with collaborators.
+```
+
+To force tunnel off (even if --url is passed):
 
 ```bash
 devlinker --no-tunnel
 ```
 
+When running without `--url`, you’ll see:
+
+```text
+⚡ Skipping public tunnel (use --url to enable)
+
+💡 Need to share outside network?
+👉 Run: devlinker --url
+```
+
 Disable WLAN URL output:
 
 ```bash
 devlinker --no-lan
 ```
+## Smart Detection & Auto-Fix System
+
+DevLinker now includes an AI-powered detection and auto-fix engine:
+
+- **Request Inspector:** Real-time analysis of proxy traffic for common mistakes (missing `/api` prefix, 404s, CORS risks, upstream failures)
+- **Backend Intelligence:** Probes backend endpoints and type at startup for smarter routing and hints
+- **Log Analyzer:** Converts error messages (CORS, 404, connection refused) into human-readable explanations and actionable fixes
+- **Smart Warning Engine:** Prints clean CLI warnings and suggestions, e.g.:
+
+```text
+⚠️  Detected direct backend call (localhost:5000)
+👉 Use /api/* instead of direct URL
+```
+
+All detection and fixes are modular, async-compatible, and production-ready. See `devlinker/proxy.py`, `devlinker/detector_ai.py`, and `devlinker/logger.py` for implementation.
 
 Interactive backend selection (when local and Docker are both detected):
 

{devlinker-1.3.0 → devlinker-1.3.1}/README.md

@@ -2,20 +2,36 @@
 
 Dev Linker runs frontend and backend dev servers, proxies both through a single local port (8000), and creates a single public URL via Cloudflare or ngrok.
 
+
 ## Features
 
-- Launches frontend automatically (when frontend exists)
-- Auto-detects backend runtime (Docker Compose, Dockerfile, Node, or Python)
-- Auto-starts Python/Node backends; Docker is manual by default for reliability
-- Detects common frontend/backend ports
-- Detects Vite frontend across dynamic fallback ports (5173-5190, plus common alternatives)
-- Supports Docker backend port auto-detection
-- Works with dynamic container host ports
-- No config needed for standard FastAPI or Flask plus Docker flows
-- Serves both through one proxy at http://localhost:8000
-- Creates a public tunnel for sharing (Cloudflare first, ngrok fallback)
-- Terminal-first workflow
-- Supports CLI version output with --version
+- 🚀 **Unified Dev Proxy:** Combines frontend (Vite/React) and backend (FastAPI/Flask/Node/Docker) into a single local and public URL.
+- 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
+- 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
+- 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
+- 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
+- 🔄 **Dynamic Tunnel Control:** `devlinker unshare` disables public tunnel at runtime.
+- 📡 **WLAN Sharing:** Prints LAN URL for same-network device access.
+- 🧑‍💻 **Interactive CLI:** Modern, colorized, emoji-rich terminal UX for all commands.
+- 🧩 **Zero Config:** Works out-of-the-box for most FastAPI, Flask, Vite, and Docker projects.
+- 🧪 **Runtime Smoke Test:** Built-in test for end-to-end proxy validation.
+- 🛠️ **Extensible:** Modular architecture for future SaaS, dashboard, and team features.
+
+## CLI Commands & Options
+
+- `devlinker` — Start proxy (local only, fast)
+- `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
+- `devlinker share` — Enable public tunnel at runtime (no restart)
+- `devlinker unshare` — Disable public tunnel at runtime
+- `devlinker doctor` — Diagnose issues, see categorized problems and fixes
+- `devlinker fix` — Auto-fix common issues (env, API paths, config)
+- `devlinker --frontend 5173 --backend 5000` — Override detected ports
+- `devlinker --docker` — Auto-start Docker backend
+- `devlinker --no-tunnel` — Force local-only mode
+- `devlinker --no-lan` — Hide WLAN sharing URL
+- `devlinker --interactive-backend` — Prompt to choose backend if multiple found
+- `devlinker --proxy-port 18000` — Use custom proxy port
+- `devlinker --version` — Show version
 
 ## Project Structure
 
@@ -107,17 +123,71 @@ Enable Docker auto-start explicitly:
 devlinker --docker
 ```
 
-Run local-only mode without tunnel:
+
+## Tunnel and Sharing Modes
+
+By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
+
+
+```bash
+devlinker --url
+```
+
+In your terminal output, you'll see:
+
+
+URL, run:
+
+```bash
+devlinker --url
+```
+
+This will start the proxy and open a public tunnel (Cloudflare or ngrok). The output will show:
+
+```text
+🌍 Enabling public tunnel...
+[OK] Tunnel provider: Cloudflare
+[OK] Public URL:
+     https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
+[INFO] Share this link with collaborators.
+```
+
+To force tunnel off (even if --url is passed):
 
 ```bash
 devlinker --no-tunnel
 ```
 
+When running without `--url`, you’ll see:
+
+```text
+⚡ Skipping public tunnel (use --url to enable)
+
+💡 Need to share outside network?
+👉 Run: devlinker --url
+```
+
 Disable WLAN URL output:
 
 ```bash
 devlinker --no-lan
 ```
+## Smart Detection & Auto-Fix System
+
+DevLinker now includes an AI-powered detection and auto-fix engine:
+
+- **Request Inspector:** Real-time analysis of proxy traffic for common mistakes (missing `/api` prefix, 404s, CORS risks, upstream failures)
+- **Backend Intelligence:** Probes backend endpoints and type at startup for smarter routing and hints
+- **Log Analyzer:** Converts error messages (CORS, 404, connection refused) into human-readable explanations and actionable fixes
+- **Smart Warning Engine:** Prints clean CLI warnings and suggestions, e.g.:
+
+```text
+⚠️  Detected direct backend call (localhost:5000)
+👉 Use /api/* instead of direct URL
+```
+
+All detection and fixes are modular, async-compatible, and production-ready. See `devlinker/proxy.py`, `devlinker/detector_ai.py`, and `devlinker/logger.py` for implementation.
 
 Interactive backend selection (when local and Docker are both detected):
 

devlinker-1.3.1/devlinker/detection_state.py

@@ -0,0 +1,58 @@
+
+class DetectionState:
+    def __init__(self):
+        self.issues = []
+        self.counts = {}
+        self.levels = {}
+        self.categories = {}
+
+    def add(self, issue, level="MEDIUM", category="general"):
+        self.issues.append(issue)
+        self.counts[issue] = self.counts.get(issue, 0) + 1
+        self.levels[issue] = level
+        self.categories.setdefault(category, []).append(issue)
+
+    def should_print(self, issue):
+        return self.counts.get(issue, 0) == 1
+
+    def get_issues(self):
+        return [(issue, self.levels.get(issue, "MEDIUM"), self.counts[issue], self._get_category(issue)) for issue in self.issues]
+
+    def summary(self):
+        summary = {}
+        for issue in self.issues:
+            level = self.levels.get(issue, "MEDIUM")
+            summary.setdefault(level, set()).add(issue)
+        return summary
+
+    def _get_category(self, issue):
+        for cat, issues in self.categories.items():
+            if issue in issues:
+                return cat
+        return "general"
+
+    def report(self):
+        print("\n🩺 DevLinker Doctor Report\n────────────────────────")
+        # Group by category
+        for category, issues in self.categories.items():
+            if not issues:
+                continue
+            if category == "network":
+                print("\n🌐 Network Issues")
+            elif category == "routing":
+                print("\n🔀 Routing Issues")
+            elif category == "cors":
+                print("\n🔐 CORS Issues")
+            else:
+                print(f"\n{category.title()} Issues")
+            for issue in set(issues):
+                level = self.levels.get(issue, "MEDIUM")
+                if level == "HIGH":
+                    print(f"❌ {issue}")
+                elif level == "MEDIUM":
+                    print(f"⚠️  {issue}")
+                else:
+                    print(f"💡 {issue}")
+
+# Singleton instance
+state = DetectionState()

devlinker-1.3.1/devlinker/detector_ai.py

@@ -0,0 +1,18 @@
+class DevLinkerAI:
+    def analyze_failure(self, error_text):
+        if "CORS" in error_text:
+            return [
+                "Frontend is calling backend directly",
+                "Use /api/* instead of localhost:PORT"
+            ]
+        if "404" in error_text:
+            return [
+                "Route not found",
+                "Check if '/api' prefix is required"
+            ]
+        if "connection refused" in error_text.lower():
+            return [
+                "Backend not reachable",
+                "Ensure backend is running"
+            ]
+        return []

devlinker-1.3.1/devlinker/doctor.py

@@ -0,0 +1,16 @@
+import click
+from devlinker.detection_state import state
+from devlinker.detector_ai import DevLinkerAI
+from devlinker.logger import print_fix
+
+@click.command()
+def doctor():
+    """Run DevLinker diagnostics and print a doctor report."""
+    ai = DevLinkerAI()
+    # Doctor now uses real-time, categorized issues from the global state
+    state.report()
+    print("\nFix Suggestions:")
+    for issue, level, count, category in state.get_issues():
+        suggestions = ai.analyze_failure(issue)
+        for s in suggestions:
+            print_fix(s)

devlinker-1.3.1/devlinker/fix.py

@@ -0,0 +1,16 @@
+import click
+from devlinker.detection_state import state
+from devlinker.fixer import DevLinkerFixer
+
+@click.command()
+def fix():
+    """Apply auto-fixes for detected issues."""
+    issues = state.get_issues()
+    fixer = DevLinkerFixer()
+    print("\n🔧 Applying fixes...")
+    results = fixer.apply_fixes(issues)
+    print("\n🔧 Fix Results")
+    for r in results:
+        print(f"✔ {r}")
+    if not results:
+        print("No auto-fixes applied. All clear or manual review needed.")

devlinker-1.3.1/devlinker/fixer.py

@@ -0,0 +1,27 @@
+import os
+
+class DevLinkerFixer:
+    def apply_fixes(self, issues):
+        fixes = []
+        for issue in issues:
+            desc = issue[0] if isinstance(issue, (list, tuple)) else issue.get("issue", "")
+            if "CORS" in desc:
+                fixes.append(self.fix_env())
+            if "Missing /api" in desc or "missing '/api'" in desc:
+                fixes.append(self.suggest_api_fix())
+        return fixes
+
+    def fix_env(self):
+        env_path = os.path.join("frontend", ".env")
+        line = "VITE_API_URL=http://localhost:8001"
+        # Only add if not already present
+        if os.path.exists(env_path):
+            with open(env_path, "r") as f:
+                if line in f.read():
+                    return "VITE_API_URL already set in frontend/.env"
+        with open(env_path, "a") as f:
+            f.write(f"\n{line}\n")
+        return "Added VITE_API_URL to frontend/.env"
+
+    def suggest_api_fix(self):
+        return "Suggest: Replace hardcoded http://localhost:8000 with /api in frontend code (manual review)"

devlinker-1.3.1/devlinker/logger.py

@@ -0,0 +1,5 @@
+def print_warning(msg):
+    print(f"\n⚠️  {msg}")
+
+def print_fix(msg):
+    print(f"👉 {msg}")

{devlinker-1.3.0 → devlinker-1.3.1}/devlinker/main.py

@@ -11,6 +11,9 @@ from .detector import check_port, detect_ports, is_vite_port
 from .proxy import start_proxy
 from .runner import detect_backend_port, start_servers
 from .tunnel import start_tunnel
+from .doctor import doctor
+from .fix import fix
+from .share import share, unshare
 
 
 def _is_port_in_use(port: int) -> bool:
@@ -50,6 +53,7 @@ def _with_ngrok_skip_warning(url: str) -> str:
     return urlunsplit((parts.scheme, parts.netloc, parts.path, new_query, parts.fragment))
 
 
+
 def _print_summary(
     frontend_port: int,
     backend_port: int,
@@ -58,20 +62,23 @@ def _print_summary(
     wlan_url: str | None,
     startup_seconds: float,
 ) -> None:
-    print(f"\nDevLinker Ready (in {startup_seconds:.1f}s)")
-    print(f"Frontend: http://localhost:{frontend_port}")
-    print(f"Backend:  http://localhost:{backend_port}")
-    print("Access Links:")
-    print(f"Local:  http://localhost:{proxy_port}")
+    import click
+    banner = "\n" + ("═" * 36) + "\n🚀 DevLinker Ready\n" + ("═" * 36)
+    click.secho(f"{banner}", fg="green", bold=True)
+    click.secho(f"⏱️  Startup time: {startup_seconds:.1f}s\n", fg="yellow")
+    click.secho(f"Frontend: ", nl=False, fg="blue"); click.secho(f"http://localhost:{frontend_port}", fg="cyan", bold=True)
+    click.secho(f"Backend:  ", nl=False, fg="blue"); click.secho(f"http://localhost:{backend_port}", fg="cyan", bold=True)
+    click.secho("\nAccess Links:", fg="magenta", bold=True)
+    click.secho(f"  Local  → http://localhost:{proxy_port}", fg="white")
     if wlan_url:
-        print(f"WLAN:   {wlan_url}")
+        click.secho(f"  WLAN   → {wlan_url}", fg="white")
     else:
-        print("WLAN:   unavailable")
+        click.secho("  WLAN   → unavailable", fg="white")
     if public_url:
-        print(f"Public: {public_url}")
-        print("Tip: Press Ctrl+Click to open link")
+        click.secho(f"  Public → {public_url}", fg="cyan", bold=True)
+        click.secho("Tip: Press Ctrl+Click to open link", fg="magenta")
     else:
-        print("Public: unavailable (local proxy still active)")
+        click.secho("  Public → Disabled (use --url)", fg="yellow")
 
 
 def _get_local_ip() -> str | None:
@@ -124,6 +131,7 @@ def _wait_for_readiness(
     is_flag=True,
     help="Auto-start Docker backends (manual Docker is the default).",
 )
+@click.option("--url", is_flag=True, help="Enable public tunnel URL.")
 @click.option("--no-tunnel", is_flag=True, help="Skip public tunnel and run local proxy only.")
 @click.option(
     "--interactive-backend/--no-interactive-backend",
@@ -144,15 +152,18 @@ def cli(
     backend_port_override: int | None,
     proxy_port: int,
     auto_start_docker: bool,
+    url: bool,
     no_tunnel: bool,
     interactive_backend: bool,
     lan_enabled: bool,
     debug: bool,
 ) -> None:
+
     started = time.perf_counter()
-    print(f"\nDev Linker v{__version__}")
-    print("[INFO] Mode: Auto (FastAPI async proxy + Docker detection)")
-    print("[INFO] Booting local services...")
+    banner = "\n" + ("═" * 36) + f"\n⚡ Dev Linker v{__version__} ⚡\n" + ("═" * 36)
+    click.secho(banner, fg="green", bold=True)
+    click.secho("[INFO] Mode: Auto (FastAPI async proxy + Docker detection)", fg="blue")
+    click.secho("[INFO] Booting local services...", fg="blue")
 
     start_servers(auto_start_docker=auto_start_docker)
 
@@ -165,7 +176,7 @@ def cli(
     if backend_port is None:
         raise SystemExit(1)
 
-    print("[INFO] Detecting frontend/backend ports...")
+    click.secho("[INFO] Detecting frontend/backend ports...", fg="blue")
     frontend_port, backend_port = detect_ports(frontend=frontend, backend=backend_port)
 
     if frontend_port is None:
@@ -190,10 +201,10 @@ def cli(
 
     proxy_port = _select_proxy_port(proxy_port)
 
-    print(f"[OK] Frontend -> {frontend_port}")
-    print(f"[OK] Backend  -> {backend_port}\n")
+    click.secho(f"[OK] Frontend  → {frontend_port}", fg="green")
+    click.secho(f"[OK] Backend   → {backend_port}\n", fg="green")
 
-    print(f"[INFO] Starting proxy on :{proxy_port}...")
+    click.secho(f"[INFO] Starting proxy on :{proxy_port}...", fg="blue")
     start_proxy(frontend_port, backend_port, proxy_port=proxy_port)
 
     # Allow proxy thread to bind before opening tunnel.
@@ -204,32 +215,41 @@ def cli(
         local_ip = _get_local_ip()
         if local_ip:
             wlan_url = f"http://{local_ip}:{proxy_port}"
-            print(f"[OK] WLAN URL: {wlan_url}")
-            print("[INFO] Share WLAN link with teammates on same WiFi/LAN.")
+            click.secho(f"[OK] WLAN URL: {wlan_url}", fg="green")
+            click.secho("[INFO] Share WLAN link with teammates on same WiFi/LAN.", fg="blue")
         else:
-            print("[WARN] WLAN URL unavailable (no active LAN interface detected).")
-            print("[INFO] If LAN sharing fails, allow proxy port in firewall and use same network.")
+            click.secho("[WARN] WLAN URL unavailable (no active LAN interface detected).", fg="yellow")
+            click.secho("[INFO] If LAN sharing fails, allow proxy port in firewall and use same network.", fg="yellow")
+
+    click.secho(f"\n[OK] Proxy ready at http://localhost:{proxy_port}\n", fg="green", bold=True)
 
-    print(f"\n[OK] Proxy ready at http://localhost:{proxy_port}\n")
     warning_free_url: str | None = None
+    enable_tunnel = False
+    if url:
+        enable_tunnel = True
     if no_tunnel:
-        print("[INFO] Tunnel disabled by --no-tunnel; local proxy only.")
-    else:
+        enable_tunnel = False
+
+    if enable_tunnel:
         try:
-            print("[INFO] Opening public tunnel...")
+            click.secho("\n🌍 Enabling public tunnel...", fg="green", bold=True)
             provider, public_url = start_tunnel(proxy_port)
             warning_free_url = _with_ngrok_skip_warning(public_url)
             provider_label = "Cloudflare" if provider == "cloudflare" else "ngrok"
-            print(f"[OK] Tunnel provider: {provider_label}")
-            print("[OK] Public URL:")
-            print(f"     {warning_free_url}\n")
-            print("Tip: Press Ctrl+Click to open link")
-            print("[INFO] Share this link with collaborators.")
+            click.secho(f"[OK] Tunnel provider: {provider_label}", fg="blue")
+            click.secho(f"[OK] Public URL:", fg="blue")
+            click.secho(f"     {warning_free_url}\n", fg="cyan", bold=True)
+            click.secho("Tip: Press Ctrl+Click to open link", fg="magenta")
+            click.secho("[INFO] Share this link with collaborators.", fg="magenta")
         except RuntimeError as exc:
-            print(f"[WARN] Tunnel failed: {exc}")
-            print("[INFO] Next step: install cloudflared or configure ngrok auth.")
-            print("[INFO] Tip: run 'ngrok config add-authtoken <token>' for ngrok fallback.")
-            print(f"[OK] Continuing with local proxy at http://localhost:{proxy_port}")
+            click.secho(f"[WARN] Tunnel failed: {exc}", fg="red")
+            click.secho("[INFO] Next step: install cloudflared or configure ngrok auth.", fg="yellow")
+            click.secho("[INFO] Tip: run 'ngrok config add-authtoken <token>' for ngrok fallback.", fg="yellow")
+            click.secho(f"[OK] Continuing with local proxy at http://localhost:{proxy_port}", fg="green")
+    else:
+        click.secho("\n⚡ Skipping public tunnel (use --url to enable)", fg="yellow", bold=True)
+        click.secho("\n💡 Need to share outside network?", fg="magenta")
+        click.secho("👉 Run: devlinker --url", fg="magenta", bold=True)
 
     _print_summary(
         frontend_port,
@@ -244,8 +264,19 @@ def cli(
         while True:
             time.sleep(1)
     except KeyboardInterrupt:
-        print("\n[INFO] Dev Linker stopped.")
+        click.secho("\n[INFO] Dev Linker stopped.", fg="yellow")
+
+
+@click.group()
+def main():
+    pass
+
 
+main.add_command(cli)
+main.add_command(doctor)
+main.add_command(fix)
+main.add_command(share)
+main.add_command(unshare)
 
 if __name__ == "__main__":
-    cli()
+    main()

{devlinker-1.3.0 → devlinker-1.3.1}/devlinker/proxy.py

@@ -15,6 +15,28 @@ from websockets.exceptions import ConnectionClosed
 
 app = FastAPI()
 
+# --- RequestInspector: Real-time request analyzer ---
+from devlinker.detection_state import state
+class RequestInspector:
+    def analyze(self, path, status, target):
+        warnings = []
+        # 1. Missing /api prefix
+        if not path.startswith("/api") and target == "backend":
+            issue = "Possible missing '/api' prefix"
+            state.add(issue, level="MEDIUM", category="routing")
+            warnings.append(issue)
+        # 2. 404 detection
+        if status == 404:
+            issue = "Route not found → check backend route"
+            state.add(issue, level="HIGH", category="routing")
+            warnings.append(issue)
+        # 3. Upstream failure
+        if status == 502:
+            issue = "Backend unreachable"
+            state.add(issue, level="HIGH", category="network")
+            warnings.append(issue)
+        return warnings
+
 FRONTEND: Optional[int] = None
 BACKEND: Optional[int] = None
 HTTP_CLIENT: Optional[httpx.AsyncClient] = None
@@ -100,13 +122,28 @@ def _build_target_ws_url(port: int, path: str, query: str) -> str:
 
 
 async def _forward_http(request: Request) -> Response:
+    from devlinker.logger import print_warning, print_fix
+    from devlinker.detector_ai import DevLinkerAI
+
+    inspector = RequestInspector()
+    ai = DevLinkerAI()
+
     target_port = _target_port(request.url.path)
     if target_port is None:
         if request.url.path.startswith("/api"):
-            return PlainTextResponse("Backend is not configured.", status_code=503)
-        return PlainTextResponse("Frontend is not configured.", status_code=503)
+            status = 503
+            warnings = inspector.analyze(request.url.path, status, "backend")
+            for w in warnings:
+                print_warning(w)
+            return PlainTextResponse("Backend is not configured.", status_code=status)
+        status = 503
+        warnings = inspector.analyze(request.url.path, status, "frontend")
+        for w in warnings:
+            print_warning(w)
+        return PlainTextResponse("Frontend is not configured.", status_code=status)
 
     if HTTP_CLIENT is None:
+        print_warning("Proxy HTTP client is not ready.")
         return PlainTextResponse("Proxy HTTP client is not ready.", status_code=503)
 
     payload = await request.body()
@@ -121,7 +158,22 @@ async def _forward_http(request: Request) -> Response:
             headers=_filter_request_headers(dict(request.headers)),
         )
     except httpx.RequestError as exc:
-        return PlainTextResponse(f"Upstream unavailable: {exc}", status_code=502)
+        status = 502
+        warnings = inspector.analyze(request.url.path, status, "backend")
+        for w in warnings:
+            print_warning(w)
+        ai_suggestions = ai.analyze_failure(str(exc))
+        for s in ai_suggestions:
+            print_fix(s)
+        return PlainTextResponse(f"Upstream unavailable: {exc}", status_code=status)
+
+    # Analyze response for warnings and fixes
+    warnings = inspector.analyze(request.url.path, upstream.status_code, "backend")
+    for w in warnings:
+        print_warning(w)
+    ai_suggestions = ai.analyze_failure(str(upstream.text))
+    for s in ai_suggestions:
+        print_fix(s)
 
     return Response(
         content=upstream.content,

devlinker-1.3.1/devlinker/share.py

@@ -0,0 +1,54 @@
+import click
+from devlinker.tunnel import start_tunnel
+
+# Global tunnel state
+_tunnel_info = {
+    "provider": None,
+    "public_url": None,
+    "active": False,
+    "proxy_port": None,
+}
+
+@click.command()
+def share():
+    """Enable public tunnel at runtime (no restart)."""
+    from devlinker.main import _select_proxy_port
+    import sys
+    proxy_port = 8000
+    banner = "\n" + ("═" * 36) + "\n🌍 DevLinker Share Mode\n" + ("═" * 36)
+    if _tunnel_info["active"]:
+        click.secho(f"{banner}\n\n🔗 Tunnel already active:", fg="yellow", bold=True)
+        click.secho(f"   {_tunnel_info['public_url']}\n", fg="cyan", bold=True)
+        return
+    try:
+        click.secho(f"{banner}\n\n🌍 Enabling public tunnel...", fg="green", bold=True)
+        provider, public_url = start_tunnel(proxy_port)
+        _tunnel_info["provider"] = provider
+        _tunnel_info["public_url"] = public_url
+        _tunnel_info["active"] = True
+        _tunnel_info["proxy_port"] = proxy_port
+        click.secho(f"\n[OK] Tunnel provider: {provider}", fg="blue")
+        click.secho(f"[OK] Public URL:", fg="blue")
+        click.secho(f"   {public_url}\n", fg="cyan", bold=True)
+        click.secho("Tip: Press Ctrl+Click to open link", fg="magenta")
+        click.secho("[INFO] Share this link with collaborators.\n", fg="magenta")
+    except Exception as exc:
+        click.secho(f"[WARN] Tunnel failed: {exc}", fg="red")
+        click.secho("[INFO] Next step: install cloudflared or configure ngrok auth.", fg="yellow")
+        sys.exit(1)
+
+@click.command()
+def unshare():
+    """Disable public tunnel at runtime (no restart)."""
+    banner = "\n" + ("═" * 36) + "\n🛑 DevLinker Unshare Mode\n" + ("═" * 36)
+    if not _tunnel_info["active"]:
+        click.secho(f"{banner}\n\nNo tunnel is currently active.\n", fg="yellow", bold=True)
+        return
+    # In a real implementation, stop the tunnel process here
+    click.secho(f"{banner}\n\n🛑 Disabling tunnel:", fg="red", bold=True)
+    click.secho(f"   {_tunnel_info['public_url']}\n", fg="cyan", bold=True)
+    _tunnel_info["provider"] = None
+    _tunnel_info["public_url"] = None
+    _tunnel_info["active"] = False
+    _tunnel_info["proxy_port"] = None
+    click.secho("[OK] Tunnel disabled.\n", fg="green", bold=True)

{devlinker-1.3.0 → devlinker-1.3.1}/devlinker.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.3.0
+Version: 1.3.1
 Summary: AI-powered linking and automation tool
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -18,20 +18,36 @@ Requires-Dist: websockets
 
 Dev Linker runs frontend and backend dev servers, proxies both through a single local port (8000), and creates a single public URL via Cloudflare or ngrok.
 
+
 ## Features
 
-- Launches frontend automatically (when frontend exists)
-- Auto-detects backend runtime (Docker Compose, Dockerfile, Node, or Python)
-- Auto-starts Python/Node backends; Docker is manual by default for reliability
-- Detects common frontend/backend ports
-- Detects Vite frontend across dynamic fallback ports (5173-5190, plus common alternatives)
-- Supports Docker backend port auto-detection
-- Works with dynamic container host ports
-- No config needed for standard FastAPI or Flask plus Docker flows
-- Serves both through one proxy at http://localhost:8000
-- Creates a public tunnel for sharing (Cloudflare first, ngrok fallback)
-- Terminal-first workflow
-- Supports CLI version output with --version
+- 🚀 **Unified Dev Proxy:** Combines frontend (Vite/React) and backend (FastAPI/Flask/Node/Docker) into a single local and public URL.
+- 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
+- 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
+- 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
+- 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
+- 🔄 **Dynamic Tunnel Control:** `devlinker unshare` disables public tunnel at runtime.
+- 📡 **WLAN Sharing:** Prints LAN URL for same-network device access.
+- 🧑‍💻 **Interactive CLI:** Modern, colorized, emoji-rich terminal UX for all commands.
+- 🧩 **Zero Config:** Works out-of-the-box for most FastAPI, Flask, Vite, and Docker projects.
+- 🧪 **Runtime Smoke Test:** Built-in test for end-to-end proxy validation.
+- 🛠️ **Extensible:** Modular architecture for future SaaS, dashboard, and team features.
+
+## CLI Commands & Options
+
+- `devlinker` — Start proxy (local only, fast)
+- `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
+- `devlinker share` — Enable public tunnel at runtime (no restart)
+- `devlinker unshare` — Disable public tunnel at runtime
+- `devlinker doctor` — Diagnose issues, see categorized problems and fixes
+- `devlinker fix` — Auto-fix common issues (env, API paths, config)
+- `devlinker --frontend 5173 --backend 5000` — Override detected ports
+- `devlinker --docker` — Auto-start Docker backend
+- `devlinker --no-tunnel` — Force local-only mode
+- `devlinker --no-lan` — Hide WLAN sharing URL
+- `devlinker --interactive-backend` — Prompt to choose backend if multiple found
+- `devlinker --proxy-port 18000` — Use custom proxy port
+- `devlinker --version` — Show version
 
 ## Project Structure
 
@@ -123,17 +139,71 @@ Enable Docker auto-start explicitly:
 devlinker --docker
 ```
 
-Run local-only mode without tunnel:
+
+## Tunnel and Sharing Modes
+
+By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
+
+
+```bash
+devlinker --url
+```
+
+In your terminal output, you'll see:
+
+
+URL, run:
+
+```bash
+devlinker --url
+```
+
+This will start the proxy and open a public tunnel (Cloudflare or ngrok). The output will show:
+
+```text
+🌍 Enabling public tunnel...
+[OK] Tunnel provider: Cloudflare
+[OK] Public URL:
+     https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
+[INFO] Share this link with collaborators.
+```
+
+To force tunnel off (even if --url is passed):
 
 ```bash
 devlinker --no-tunnel
 ```
 
+When running without `--url`, you’ll see:
+
+```text
+⚡ Skipping public tunnel (use --url to enable)
+
+💡 Need to share outside network?
+👉 Run: devlinker --url
+```
+
 Disable WLAN URL output:
 
 ```bash
 devlinker --no-lan
 ```
+## Smart Detection & Auto-Fix System
+
+DevLinker now includes an AI-powered detection and auto-fix engine:
+
+- **Request Inspector:** Real-time analysis of proxy traffic for common mistakes (missing `/api` prefix, 404s, CORS risks, upstream failures)
+- **Backend Intelligence:** Probes backend endpoints and type at startup for smarter routing and hints
+- **Log Analyzer:** Converts error messages (CORS, 404, connection refused) into human-readable explanations and actionable fixes
+- **Smart Warning Engine:** Prints clean CLI warnings and suggestions, e.g.:
+
+```text
+⚠️  Detected direct backend call (localhost:5000)
+👉 Use /api/* instead of direct URL
+```
+
+All detection and fixes are modular, async-compatible, and production-ready. See `devlinker/proxy.py`, `devlinker/detector_ai.py`, and `devlinker/logger.py` for implementation.
 
 Interactive backend selection (when local and Docker are both detected):
 

{devlinker-1.3.0 → devlinker-1.3.1}/devlinker.egg-info/SOURCES.txt

@@ -2,10 +2,17 @@ README.md
 pyproject.toml
 setup.py
 devlinker/__init__.py
+devlinker/detection_state.py
 devlinker/detector.py
+devlinker/detector_ai.py
+devlinker/doctor.py
+devlinker/fix.py
+devlinker/fixer.py
+devlinker/logger.py
 devlinker/main.py
 devlinker/proxy.py
 devlinker/runner.py
+devlinker/share.py
 devlinker/tunnel.py
 devlinker.egg-info/PKG-INFO
 devlinker.egg-info/SOURCES.txt

{devlinker-1.3.0 → devlinker-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devlinker"
-version = "1.3.0"
+version = "1.3.1"
 description = "AI-powered linking and automation tool"
 authors = [
     { name = "Mani", email = "mani1028@users.noreply.github.com" }