@powerhousedao/ph-cli 6.0.0-dev.40 → 6.0.0-dev.41

package/dist/scripts/generate-commands-docs.ts

@@ -0,0 +1,45 @@
+import { writeCliDocsMarkdownFile } from "@powerhousedao/codegen/file-builders";
+import { accessToken } from "../src/commands/access-token.js";
+import { build, connect, preview, studio } from "../src/commands/connect.js";
+import { generate } from "../src/commands/generate.js";
+import { inspect } from "../src/commands/inspect.js";
+import { install } from "../src/commands/install.js";
+import { list } from "../src/commands/list.js";
+import { login } from "../src/commands/login.js";
+import { migrate } from "../src/commands/migrate.js";
+import { phCli } from "../src/commands/ph-cli.js";
+import { switchboard } from "../src/commands/switchboard.js";
+import { uninstall } from "../src/commands/uninstall.js";
+import { vetra } from "../src/commands/vetra.js";
+
+const commands = [
+  { name: "generate", command: generate },
+  { name: "vetra", command: vetra },
+  { name: "connect", command: connect },
+  { name: "connect studio", command: studio },
+  { name: "connect build", command: build },
+  { name: "connect preview", command: preview },
+  { name: "access token", command: accessToken },
+  { name: "inspect", command: inspect },
+  { name: "list", command: list },
+  { name: "migrate", command: migrate },
+  { name: "switchboard", command: switchboard },
+  { name: "login", command: login },
+  { name: "install", command: install },
+  { name: "uninstall", command: uninstall },
+];
+
+const cliDescription = phCli.description ?? "";
+
+async function main() {
+  await writeCliDocsMarkdownFile({
+    filePath: "COMMANDS.md",
+    docsTitle: `Powerhouse CLI Commands (${process.env.WORKSPACE_VERSION || process.env.npm_package_version})`,
+    docsIntroduction:
+      "This document provides detailed information about the available commands in the Powerhouse CLI.",
+    cliDescription,
+    entries: commands,
+  });
+}
+
+await main();

package/dist/scripts/generate-docs-legacy.ts

@@ -0,0 +1,84 @@
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+
+/**
+ * Generate COMMANDS.md file from the help texts in help.ts
+ */
+async function generateCommandsMd() {
+  try {
+    // Define paths for ES modules
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const rootDir = path.resolve(__dirname, "..");
+    const helpFilePath = path.join(rootDir, "src", "help.ts");
+    const outputPath = path.join(rootDir, "COMMANDS-LEGACY.md");
+
+    // Read the help.ts file
+    const helpFileContent = fs.readFileSync(helpFilePath, "utf8");
+
+    // Extract all help text constants using regex
+    const helpTextRegex = /export const (\w+)Help = `([\s\S]+?)`;/g;
+    const commands: { name: string; content: string }[] = [];
+
+    let match;
+    while ((match = helpTextRegex.exec(helpFileContent)) !== null) {
+      const commandName = match[1];
+      const helpContent = match[2];
+      commands.push({ name: commandName, content: helpContent });
+    }
+
+    // Sort commands alphabetically
+    commands.sort((a, b) => a.name.localeCompare(b.name));
+
+    // Generate the markdown content
+    let markdown = "# Powerhouse CLI Commands\n\n";
+    markdown +=
+      "This document provides detailed information about the available commands in the Powerhouse CLI.\n\n";
+    markdown += "## Table of Contents\n\n";
+
+    // Add table of contents
+    commands.forEach((command) => {
+      const displayName = formatCommandName(command.name);
+      const anchor = displayName.toLowerCase().replace(/\s+/g, "-");
+      markdown += `- [${displayName}](#${anchor})\n`;
+    });
+
+    markdown += "\n";
+
+    // Add command details
+    commands.forEach((command) => {
+      const displayName = formatCommandName(command.name);
+      markdown += `## ${displayName}\n\n`;
+      markdown += "```\n";
+      markdown += command.content.trim();
+      markdown += "\n```\n\n";
+    });
+
+    // Add footer
+    markdown += "---\n\n";
+    markdown +=
+      "*This document was automatically generated from the help text in the codebase.*\n";
+
+    // Write to COMMANDS.md
+    fs.writeFileSync(outputPath, markdown);
+
+    console.log(`✅ COMMANDS.md has been generated at ${outputPath}`);
+  } catch (error) {
+    console.error("Failed to generate COMMANDS.md:", error);
+    process.exit(1);
+  }
+}
+
+/**
+ * Format command name for display (e.g., "setupGlobals" -> "Setup Globals")
+ */
+function formatCommandName(commandName: string): string {
+  // Convert camelCase to separate words with spaces
+  const name = commandName.replace(/([A-Z])/g, " $1").trim();
+  // Capitalize first letter and convert the rest to lowercase
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+
+// Run the script
+generateCommandsMd();

package/dist/scripts/generate-version.ts

@@ -0,0 +1,22 @@
+import { readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { fileURLToPath } from "url";
+
+interface PackageJson {
+  version: string;
+}
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+
+// Read package.json
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, "../package.json"), "utf-8"),
+) as PackageJson;
+
+// Generate version.ts content
+const versionFileContent = `// This file is auto-generated. DO NOT EDIT.
+export const version = "${packageJson.version}";
+`;
+
+// Write version.ts
+writeFileSync(join(__dirname, "../src/version.ts"), versionFileContent);

package/dist/scripts/manage-environment

@@ -0,0 +1,199 @@
+#!/usr/bin/env bash
+
+# =============================================================================
+# Configuration
+# =============================================================================
+PROJECT_NAME=${1:-"global"}
+ACTION=${2:-"status"}
+
+# Nginx config file name - remove leading dot to avoid hidden file issues
+# (nginx's include directive with * glob doesn't match hidden files)
+NGINX_CONFIG_NAME="${PROJECT_NAME#.}"
+if [ "$NGINX_CONFIG_NAME" = "" ]; then
+    NGINX_CONFIG_NAME="default-ph"
+fi
+
+# Get Switchboard port from .env or use default
+if [ -f ".env" ]; then
+    SWITCHBOARD_PORT=$(grep "SWITCHBOARD_PORT=" .env | cut -d'=' -f2)
+fi
+SWITCHBOARD_PORT=${SWITCHBOARD_PORT:-4001}
+
+# =============================================================================
+# OS Detection and Windows Handling
+# =============================================================================
+if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+    if [ -f "$0.ps1" ]; then
+        powershell -ExecutionPolicy Bypass -File "$0.ps1" -PROJECT_NAME "$PROJECT_NAME" -ACTION "$ACTION"
+    else
+        echo "Error: Windows management script (manage-environment.ps1) not found"
+        exit 1
+    fi
+else
+    # =============================================================================
+    # Service Management
+    # =============================================================================
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "  Managing project: $PROJECT_NAME"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    # Function to check if service is properly set up
+    check_setup() {
+        local project_name=$1
+        local error=0
+
+        # Check if .env file exists
+        if [ ! -f ".env" ]; then
+            echo "Error: .env file not found in project directory"
+            error=1
+        fi
+
+        # Check if Nginx configuration exists
+        if [ ! -f "/etc/nginx/sites-available/$NGINX_CONFIG_NAME" ]; then
+            echo "Error: Nginx configuration not found at /etc/nginx/sites-available/$NGINX_CONFIG_NAME"
+            error=1
+        fi
+
+        # Check if database is configured
+        if ! grep -q "DATABASE_URL" ".env"; then
+            echo "Error: Database configuration not found in .env file"
+            error=1
+        fi
+
+        if [ $error -eq 1 ]; then
+            echo "Please run 'ph setup-environment' first to set up the service"
+            exit 1
+        fi
+    }
+
+    # Function to enable/disable Nginx site
+    manage_nginx_site() {
+        local action=$1
+        local site_path="/etc/nginx/sites-available/$NGINX_CONFIG_NAME"
+        local enabled_path="/etc/nginx/sites-enabled/$NGINX_CONFIG_NAME"
+
+        if [ ! -f "$site_path" ]; then
+            echo "Error: Nginx site configuration for $NGINX_CONFIG_NAME not found"
+            return 1
+        fi
+        
+        case "$action" in
+            "enable")
+                if [ ! -L "$enabled_path" ]; then
+                    sudo ln -sf "$site_path" "$enabled_path"
+                    sudo nginx -t && sudo nginx -s reload
+                fi
+                ;;
+            "disable")
+                if [ -L "$enabled_path" ]; then
+                    sudo rm -f "$enabled_path"
+                    sudo nginx -t && sudo nginx -s reload
+                fi
+                ;;
+        esac
+    }
+
+    # Function to start services
+    start_services() {
+        check_setup "$PROJECT_NAME"
+        echo "Starting services..."
+        # Build Connect
+        echo "Building Connect..."
+        ph connect build
+        sudo rm -rf /var/www/html/${PROJECT_NAME}
+        sudo mkdir -p /var/www/html/${PROJECT_NAME}
+        sudo cp -r .ph/connect-build/dist/* /var/www/html/${PROJECT_NAME}/
+        
+        # Enable Nginx site
+        manage_nginx_site "enable"
+        
+        # Start Switchboard via PM2
+        if ! pm2 list | grep -q "switchboard_${PROJECT_NAME}"; then
+            cd $PROJECT_NAME
+            pm2 start "pnpm switchboard --port $SWITCHBOARD_PORT" --name "switchboard_${PROJECT_NAME}"
+            pm2 save
+        else
+            pm2 start "switchboard_${PROJECT_NAME}"
+        fi
+    }
+
+    # Function to stop services
+    stop_services() {
+        check_setup "$PROJECT_NAME"
+        echo "Stopping services..."
+        # Stop Switchboard via PM2
+        if pm2 list | grep -q "switchboard_${PROJECT_NAME}"; then
+            pm2 stop "switchboard_${PROJECT_NAME}"
+        fi
+        
+        # Disable Nginx site
+        manage_nginx_site "disable"
+    }
+
+    case "$ACTION" in
+        "start")
+            start_services
+            ;;
+            
+        "stop")
+            stop_services
+            ;;
+            
+        "restart")
+            echo "Restarting services..."
+            stop_services
+            start_services
+            ;;
+            
+        "status")
+            check_setup "$PROJECT_NAME"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo "  Service Status for $PROJECT_NAME"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            
+            # Create table header
+            printf "%-15s %-10s %-15s %-10s %-10s\n" "Service" "Status" "Memory" "Uptime" "Health"
+            echo "────────────────────────────────────────────────────────────────────"
+            
+            # Check Connect status
+            connect_status="Disabled"
+            connect_health="❌"
+            connect_memory="N/A"
+            connect_uptime="N/A"
+            if [ -L "/etc/nginx/sites-enabled/$NGINX_CONFIG_NAME" ]; then
+                connect_status="Enabled"
+                # Check if Connect is reachable
+                if curl -s -f "http://localhost/$PROJECT_NAME" > /dev/null; then
+                    connect_health="✅"
+                fi
+                # Get Nginx memory usage for the site
+                nginx_pid=$(pgrep -f "nginx.*$PROJECT_NAME" | head -n 1)
+                if [ -n "$nginx_pid" ]; then
+                    connect_memory=$(ps -o rss= -p "$nginx_pid" 2>/dev/null | awk '{printf "%.1fmb", $1/1024}')
+                    connect_uptime=$(ps -o etime= -p "$nginx_pid" 2>/dev/null)
+                fi
+            fi
+            printf "%-15s %-10s %-15s %-10s %-10s\n" "Connect" "$connect_status" "$connect_memory" "$connect_uptime" "$connect_health"
+            
+            # Check Switchboard status
+            switchboard_info=$(pm2 list | grep "switchboard_${PROJECT_NAME}")
+            if [ -n "$switchboard_info" ]; then
+                switchboard_status="Enabled"
+                switchboard_memory=$(echo "$switchboard_info" | awk '{print $12}')
+                switchboard_uptime=$(echo "$switchboard_info" | awk '{print $7}')
+                switchboard_health="✅"
+                printf "%-15s %-10s %-15s %-10s %-10s\n" "Switchboard" "$switchboard_status" "$switchboard_memory" "$switchboard_uptime" "$switchboard_health"
+            else
+                printf "%-15s %-10s %-15s %-10s %-10s\n" "Switchboard" "Disabled" "N/A" "N/A" "❌"
+            fi
+            echo "────────────────────────────────────────────────────────────────────"
+            ;;
+            
+        *)
+            echo "Usage: $0 [project_name] {start|stop|restart|status}"
+            echo "Default project_name: global"
+            echo "Default action: status"
+            exit 1
+            ;;
+    esac
+fi