@tdk-landscape/tdk-cli-core 1.3.14 → 1.3.22

package/ext/Tiltfile

@@ -0,0 +1,66 @@
+# =============================================================================
+# 🎯 TDK-EXT - Extensions and IDE Components
+# =============================================================================
+# This is the Tiltfile entry point for the tdk-ext repo.
+# It exports UI enhancements and IDE components.
+#
+# Usage:
+#   v1alpha1.extension_repo(name='tdk-ext', url='https://github.com/tdk-landscape/tdk-ext')
+#   load('ext://tdk-ext', 'get_ide_components_path', ...)
+# =============================================================================
+
+# =============================================================================
+# UI ENHANCEMENTS (simplified for repos-only)
+# =============================================================================
+def load_ui_enhancements(config):
+    """
+    Load UI enhancements configuration.
+    Simplified version for pure extension loading.
+    """
+    enable_tooltips = config.get('enable_tooltips', True)
+    enable_icons = config.get('enable_icons', True)
+    enable_help_panel = config.get('enable_help_panel', True)
+    enable_cron_jobs_tab = config.get('enable_cron_jobs_tab', True)
+    
+
+    print("   - Tooltips: " + ("enabled" if enable_tooltips else "disabled"))
+    print("   - Icons: " + ("enabled" if enable_icons else "disabled"))
+    print("   - Help Panel: " + ("enabled" if enable_help_panel else "disabled"))
+    print("   - Cron Jobs Tab: " + ("enabled" if enable_cron_jobs_tab else "disabled"))
+
+# =============================================================================
+# IDE COMPONENTS PATHS
+# =============================================================================
+
+def get_ide_components_path():
+    """Return the path to IDE components."""
+    return './ide-components'
+
+def get_file_browser_script():
+    """Return the path to file browser server script."""
+    return './ide-components/file_browser/server.py'
+
+def get_code_viewer_script():
+    """Return the path to code viewer server script."""
+    return './ide-components/code_viewer/server.py'
+
+def get_config_inspector_script():
+    """Return the path to config inspector server script."""
+    return './ide-components/config_inspector/server.py'
+
+def get_code_executor_script():
+    """Return the path to code executor server script."""
+    return './ide-components/code_executor/server.py'
+
+# =============================================================================
+# PORTS
+# =============================================================================
+
+IDE_PORTS = {
+    'file_browser': 9765,
+    'code_viewer': 9766,
+    'config_inspector': 9767,
+    'code_executor': 9768,
+}
+
+print("✅ TDK Extensions loaded: UI enhancements and IDE components")

package/ext/ide-components/README.md

@@ -0,0 +1,219 @@
+# Tilt IDE Components
+
+Web-based IDE features integrated into the TDK Landscape Tilt development environment.
+
+## Overview
+
+The Tilt IDE provides browser-based tools for browsing, viewing, and executing code without leaving the Tilt UI.
+
+| Component | Port | Traefik URL | Direct URL |
+|-----------|------|-------------|------------|
+| **File Browser** | 9765 | http://files.localhost | http://localhost:9765 |
+| **Code Viewer** | 9766 | http://viewer.localhost | http://localhost:9766 |
+| **Config Inspector** | 9767 | http://configs.localhost | http://localhost:9767 |
+| **Code Executor** | 9768 | http://terminal.localhost | http://localhost:9768 |
+
+## Quick Start
+
+All components start automatically when you run `tilt up`:
+
+```bash
+# Start Tilt (IDE components auto-start)
+tilt up
+
+# Or start with focus
+tilt up --focus staff
+
+# IDE components are always available regardless of focus mode
+```
+
+Then open in your browser:
+- 📁 **File Browser**: http://files.localhost (or http://localhost:9765)
+- 👁️ **Code Viewer**: http://viewer.localhost (or http://localhost:9766)
+- ⚙️ **Config Inspector**: http://configs.localhost (or http://localhost:9767)
+- 💻 **Terminal**: http://terminal.localhost (or http://localhost:9768)
+
+## Components
+
+### File Browser (Port 9765)
+
+Browse the entire monorepo filesystem from your browser.
+
+**Features:**
+- Directory tree navigation
+- File metadata (size, modified time)
+- File type icons
+- Search across all files
+- Click any file to open in Code Viewer
+
+**Usage:**
+1. Navigate to http://files.localhost
+2. Click directories to navigate deeper
+3. Use breadcrumb to go back up
+4. Click files to view in Code Viewer (new tab)
+5. Use search box to find files by name
+
+### Code Viewer (Port 9766)
+
+View source files with syntax highlighting.
+
+**Features:**
+- Syntax highlighting for TypeScript, Starlark, JSON, YAML, Prisma, and more
+- Line numbers
+- Read-only indicator
+- File size and modification info
+
+**Usage:**
+1. Open directly: http://viewer.localhost?file=services/product/staff/staff-management-backend/src/index.ts
+2. Or click files from File Browser
+3. Supports files up to 1MB
+
+### Config Inspector (Port 9767)
+
+Compare master Tilt configurations (.star files) with their auto-generated outputs.
+
+**Features:**
+- Browse all .star config files organized by category
+- Side-by-side comparison of master vs generated
+- One-click "Regenerate" action (coming soon)
+
+**Usage:**
+1. Navigate to http://configs.localhost
+2. Select a .star file from the sidebar
+3. View master config on left, generated outputs on right
+4. Click "Regenerate" to trigger config regeneration
+
+### Code Executor (Port 9768)
+
+Execute bun commands from the browser.
+
+**Features:**
+- Terminal interface in browser
+- Command history (up/down arrows)
+- Real-time output with color coding
+- Safety restrictions (no rm -rf /)
+- Supports: bun, npm, git, and safe shell commands
+
+**Usage:**
+1. Navigate to http://terminal.localhost
+2. Type commands like `bun test`, `ls -la`, `git status`
+3. Press Enter to execute
+4. Use Up/Down arrows to recall previous commands
+
+## Architecture
+
+Each component is a Python HTTP server:
+
+```
+.tilt-engine/extensions/ide-components/
+├── file_browser/
+│   └── server.py          # Port 9765
+├── code_viewer/
+│   └── server.py          # Port 9766
+├── config_inspector/
+│   └── server.py          # Port 9767
+├── code_executor/
+│   └── server.py          # Port 9768
+└── shared/
+    ├── file_utils.py      # Safe file operations
+    ├── templates/
+    │   └── base.html      # Common HTML template
+    └── static/
+        └── styles.css     # Shared CSS styles
+```
+
+### Key Design Decisions
+
+1. **Python (not Bun/Node)**: Avoids circular dependency - IDE works even if Bun has issues
+2. **Separate servers**: Each component is independent, can restart individually
+3. **Read-only viewer**: Safety first - editing happens in proper IDEs
+4. **localhost only**: Security - not exposed to network
+
+## Safety
+
+### File Access
+- ✅ Only reads within project root
+- ✅ Blocks path traversal attacks (../etc/passwd)
+- ✅ 1MB file size limit
+- ✅ Hidden files excluded from browser
+
+### Command Execution
+- ✅ Only bun, npm, git, and safe shell commands allowed
+- ✅ Blocks: rm -rf /, sudo, su, passwd, etc.
+- ✅ 60-second timeout on commands
+- ✅ Commands run in project directory only
+
+## Troubleshooting
+
+### Port Already in Use
+
+If you see "Address already in use":
+
+```bash
+# Find what's using the port
+lsof -i :9765  # or 9766, 9767, 9768
+
+# Kill the process
+kill -9 <PID>
+```
+
+### Components Not Starting
+
+Check the Tilt logs:
+
+```bash
+# View specific component logs
+tilt logs tilt-file-browser
+tilt logs tilt-code-viewer
+tilt logs tilt-config-inspector
+tilt logs tilt-code-executor
+```
+
+### Python Not Found
+
+Ensure Python 3 is installed:
+
+```bash
+python3 --version
+
+# On macOS (if needed)
+brew install python3
+```
+
+## Future Enhancements
+
+- [ ] Service context actions (View Source, Run Tests) in Tilt UI
+- [ ] Regenerate button that actually triggers `tilt trigger`
+- [ ] Dark/light theme toggle
+- [ ] Keyboard shortcuts (Ctrl+K for search)
+- [ ] File type icons (font-based)
+- [ ] Mobile responsiveness
+- [ ] VS Code extension integration
+
+## Development
+
+To work on IDE components:
+
+```bash
+# Test file browser standalone
+cd .tilt-engine/extensions/ide-components/file_browser
+python3 server.py
+
+# Test code viewer standalone
+cd .tilt-engine/extensions/ide-components/code_viewer
+python3 server.py
+```
+
+Then open http://localhost:9765 (or 9766, etc.) in your browser.
+
+## Integration with Alpha Health Dashboard
+
+The IDE components work alongside the alpha health dashboard:
+
+- **Health Dashboard**: http://localhost:8765/alpha-health-dashboard.html
+- **File Browser**: http://files.localhost
+- **Code Viewer**: http://viewer.localhost
+- **Config Inspector**: http://configs.localhost
+- **Terminal**: http://terminal.localhost
+
+All components run independently and can be used simultaneously.

package/ext/ide-components/code_executor/server.py

@@ -0,0 +1,268 @@
+#!/usr/bin/env python3
+"""
+Tilt IDE Code Executor
+Execute commands from web UI at http://localhost:9768
+"""
+
+import json
+import os
+import subprocess
+import sys
+import urllib.parse
+from pathlib import Path
+
+# Add shared modules
+sys.path.insert(0, str(Path(__file__).parent.parent / 'shared'))
+from file_utils import PROJECT_ROOT
+from http_utils import BaseIDEHandler, run_server
+
+PORT = 9768
+
+
+class CodeExecutorHandler(BaseIDEHandler):
+    """HTTP request handler for code executor"""
+    
+    # Command validation constants
+    DANGEROUS_COMMANDS = [
+        'rm -rf /', 'rm -rf /*', ':(){ :|:& };:', '> /dev/sda',
+        'mv / /dev/null', 'dd if=/dev/zero', 'mkfs.', 'chmod -R 777 /',
+        'sudo', 'su -', 'passwd', 'deluser', 'userdel'
+    ]
+    
+    ALLOWED_PREFIXES = [
+        'bun ', 'ls ', 'pwd', 'echo ', 'cat ', 'head ', 'tail ', 
+        'grep ', 'find ', 'cd ', 'mkdir ', 'touch ', 'clear', 'exit',
+        'npm ', 'yarn ', 'npx ', 'pnpm ', 'git ', 'curl ', 'wget '
+    ]
+    
+    def validate_command(self, cmd: str) -> tuple:
+        """
+        Validate command for safety.
+        Returns (is_valid, error_message)
+        """
+        # Block dangerous commands
+        for dangerous in self.DANGEROUS_COMMANDS:
+            if dangerous in cmd.lower():
+                return False, f"Command blocked for safety: {dangerous}"
+        
+        # Only allow bun commands and safe system commands
+        cmd_stripped = cmd.strip()
+        is_allowed = any(cmd_stripped.startswith(prefix) for prefix in self.ALLOWED_PREFIXES)
+        
+        if not is_allowed:
+            return False, "Only bun, npm, git, and safe system commands are allowed"
+        
+        return True, None
+    
+    def execute_command(self, cmd: str, cwd: str = None) -> dict:
+        """Execute command and return result"""
+        # Validate
+        is_valid, error = self.validate_command(cmd)
+        if not is_valid:
+            return {'success': False, 'stdout': '', 'stderr': error, 'exit_code': 1}
+        
+        # Determine working directory
+        work_dir = cwd or str(PROJECT_ROOT)
+        
+        try:
+            # Execute with timeout
+            result = subprocess.run(
+                cmd,
+                shell=True,
+                cwd=work_dir,
+                capture_output=True,
+                text=True,
+                timeout=60,  # 60 second timeout
+                env={**os.environ, 'TERM': 'xterm-color'}
+            )
+            
+            return {
+                'success': result.returncode == 0,
+                'stdout': result.stdout,
+                'stderr': result.stderr,
+                'exit_code': result.returncode
+            }
+        except subprocess.TimeoutExpired:
+            return {'success': False, 'stdout': '', 'stderr': 'Command timed out (60s limit)', 'exit_code': -1}
+        except Exception as e:
+            return {'success': False, 'stdout': '', 'stderr': str(e), 'exit_code': -1}
+    
+    def _get_template_path(self) -> Path:
+        """Override to use shared template"""
+        return Path(__file__).parent.parent / 'shared' / 'templates' / 'base.html'
+    
+    def do_GET(self):
+        """Handle GET requests"""
+        parsed = urllib.parse.urlparse(self.path)
+        path = parsed.path
+        query = urllib.parse.parse_qs(parsed.query)
+        
+        # Health check
+        if path == '/health':
+            self.handle_health_check('code-executor')
+            return
+        
+        # Static files
+        if path.startswith('/static/'):
+            static_path = Path(__file__).parent.parent / 'shared' / path[1:]
+            if static_path.exists():
+                with open(static_path, 'r') as f:
+                    content = f.read()
+                self.send_css_response(content)
+            else:
+                self.send_error_response(404, 'Not found')
+            return
+        
+        if path in ('/', '/terminal'):
+            cwd = query.get('cwd', [str(PROJECT_ROOT)])[0]
+            cwd_display = self.escape_html(cwd.replace(str(PROJECT_ROOT), '~'))
+            
+            content = f'''
+                <div class="terminal" style="height: calc(100vh - 200px);">
+                    <div class="terminal-header">
+                        <div>
+                            <span class="panel-title">💻 Terminal</span>
+                            <span class="text-muted" style="margin-left: 1rem; font-size: 0.85rem;">Working directory: {cwd_display}</span>
+                        </div>
+                        <div>
+                            <span class="text-muted" style="font-size: 0.8rem;">Supports: bun, npm, git, basic shell</span>
+                        </div>
+                    </div>
+                    <div class="terminal-content" id="terminal-output" style="white-space: pre-wrap; font-family: var(--font-mono);">
+                        <div class="text-muted">TDK Landscape Tilt IDE Terminal</div>
+                        <div class="text-muted">Type a command and press Enter to execute</div>
+                        <div class="text-muted">─────────────────────────────────────────</div>
+                    </div>
+                    <div class="terminal-input-line">
+                        <span class="terminal-prompt">$</span>
+                        <input type="text" id="terminal-input" class="terminal-input" 
+                               placeholder="Enter command (e.g., bun test, ls -la)..." 
+                               autocomplete="off" spellcheck="false">
+                    </div>
+                </div>
+                
+                <script>
+                    const terminalOutput = document.getElementById('terminal-output');
+                    const terminalInput = document.getElementById('terminal-input');
+                    const cwd = {json.dumps(cwd)};
+                    let commandHistory = [];
+                    let historyIndex = -1;
+                    
+                    terminalInput.addEventListener('keydown', async function(e) {{
+                        if (e.key === 'Enter') {{
+                            const cmd = this.value.trim();
+                            if (!cmd) return;
+                            
+                            // Add to history
+                            commandHistory.push(cmd);
+                            historyIndex = commandHistory.length;
+                            
+                            // Display command
+                            terminalOutput.innerHTML += `<div><span style="color: var(--accent-primary);">$</span> ${{self.escape_html(cmd)}}</div>`;
+                            terminalInput.value = '';
+                            
+                            // Execute
+                            try {{
+                                const response = await fetch('/execute', {{
+                                    method: 'POST',
+                                    headers: {{'Content-Type': 'application/json'}},
+                                    body: JSON.stringify({{command: cmd, cwd: cwd}})
+                                }});
+                                const result = await response.json();
+                                
+                                // Display output
+                                if (result.stdout) {{
+                                    terminalOutput.innerHTML += `<div style="color: var(--text-primary);">${{self.escape_html(result.stdout)}}</div>`;
+                                }}
+                                if (result.stderr) {{
+                                    terminalOutput.innerHTML += `<div style="color: var(--error);">${{self.escape_html(result.stderr)}}</div>`;
+                                }}
+                                
+                                // Status
+                                const statusColor = result.success ? 'var(--success)' : 'var(--error)';
+                                terminalOutput.innerHTML += `<div style="color: ${{statusColor}}; font-size: 0.8rem;">Exit code: ${{result.exit_code}}</div>`;
+                                
+                            }} catch (err) {{
+                                terminalOutput.innerHTML += `<div style="color: var(--error);">Error: ${{err.message}}</div>`;
+                            }}
+                            
+                            // Scroll to bottom
+                            terminalOutput.scrollTop = terminalOutput.scrollHeight;
+                        }}
+                        
+                        // History navigation
+                        if (e.key === 'ArrowUp') {{
+                            e.preventDefault();
+                            if (historyIndex > 0) {{
+                                historyIndex--;
+                                terminalInput.value = commandHistory[historyIndex];
+                            }}
+                        }}
+                        if (e.key === 'ArrowDown') {{
+                            e.preventDefault();
+                            if (historyIndex < commandHistory.length - 1) {{
+                                historyIndex++;
+                                terminalInput.value = commandHistory[historyIndex];
+                            }} else {{
+                                historyIndex = commandHistory.length;
+                                terminalInput.value = '';
+                            }}
+                        }}
+                    }});
+                    
+                    terminalInput.focus();
+                </script>
+            '''
+            
+            self.send_html_response(self.render_page('Terminal', content, icon='💻'))
+            return
+        
+        # 404
+        self.send_html_response(self.render_page(
+            'Not Found',
+            '<div class="empty-state"><div class="empty-state-icon">❓</div>Page not found</div>',
+            icon='❓'
+        ), 404)
+    
+    def do_POST(self):
+        """Handle POST requests"""
+        parsed = urllib.parse.urlparse(self.path)
+        
+        if parsed.path == '/execute':
+            # Read request body
+            content_length = int(self.headers.get('Content-Length', 0))
+            body = self.rfile.read(content_length).decode()
+            
+            try:
+                data = json.loads(body)
+                cmd = data.get('command', '').strip()
+                cwd = data.get('cwd', str(PROJECT_ROOT))
+                
+                if not cmd:
+                    self.send_json_response({'success': False, 'error': 'No command provided'}, 400)
+                    return
+                
+                result = self.execute_command(cmd, cwd)
+                self.send_json_response(result)
+                
+            except json.JSONDecodeError:
+                self.send_json_response({'success': False, 'error': 'Invalid JSON'}, 400)
+            except Exception as e:
+                self.send_json_response({'success': False, 'error': str(e)}, 500)
+            return
+        
+        self.send_json_response({'error': 'Not found'}, 404)
+
+
+def main():
+    """Run the code executor server"""
+    run_server(
+        CodeExecutorHandler,
+        PORT,
+        '💻 Tilt IDE Code Executor',
+        '🚀 Execute bun commands from the browser\n   ⚠️  Safety: Only bun, npm, git, and safe system commands allowed'
+    )
+
+
+if __name__ == '__main__':
+    main()