ralph-cli-sandboxed 0.2.9 → 0.4.0

package/dist/templates/macos-scripts.js

@@ -0,0 +1,448 @@
+/**
+ * macOS/Swift development script templates
+ * These scripts are generated when Swift + SwiftUI is selected during ralph init
+ */
+/**
+ * Generate gen_xcode.sh script content
+ * This script generates an Xcode project from a Swift package, supporting SwiftUI apps
+ *
+ * Usage: ./scripts/gen_xcode.sh [project_name]
+ *
+ * @param projectName - Default project name (can be overridden by script argument)
+ */
+export function generateGenXcodeScript(projectName = "App") {
+    return `#!/bin/bash
+#
+# gen_xcode.sh - Generate Xcode project from Swift package
+#
+# This script generates an Xcode project from a Swift package, with support
+# for SwiftUI macOS applications including proper Info.plist and entitlements.
+#
+# USAGE:
+#   ./scripts/gen_xcode.sh [project_name]
+#
+# ARGUMENTS:
+#   project_name  - Name of the project/app (default: ${projectName})
+#
+# EXAMPLES:
+#   ./scripts/gen_xcode.sh                  # Uses default project name
+#   ./scripts/gen_xcode.sh MyAwesomeApp     # Creates MyAwesomeApp.xcodeproj
+#
+# REQUIREMENTS:
+#   - Swift toolchain installed
+#   - Xcode command line tools
+#   - For SwiftUI apps: xcodegen (brew install xcodegen) OR swift package generate-xcodeproj
+#
+# OUTPUT:
+#   - Creates <project_name>.xcodeproj in the project root
+#   - Generates Info.plist if not present
+#   - Generates entitlements file if not present
+#
+# This script is designed to be run on the host macOS system (not in Docker)
+# since Xcode and macOS-specific tooling is required.
+#
+
+set -e
+
+PROJECT_NAME="\${1:-${projectName}}"
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+echo "Generating Xcode project: \$PROJECT_NAME"
+echo "Project root: \$PROJECT_ROOT"
+echo ""
+
+cd "$PROJECT_ROOT"
+
+# Check if Package.swift exists
+if [ ! -f "Package.swift" ]; then
+  echo "Error: Package.swift not found in project root"
+  echo "This script requires a Swift Package Manager project"
+  exit 1
+fi
+
+# Create Supporting Files directory for Info.plist and entitlements
+SUPPORT_DIR="$PROJECT_ROOT/Sources/\$PROJECT_NAME/Supporting Files"
+mkdir -p "$SUPPORT_DIR"
+
+# Generate Info.plist if it doesn't exist
+INFO_PLIST="$SUPPORT_DIR/Info.plist"
+if [ ! -f "$INFO_PLIST" ]; then
+  echo "Creating Info.plist..."
+  cat > "$INFO_PLIST" << 'PLIST_EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>$(DEVELOPMENT_LANGUAGE)</string>
+    <key>CFBundleExecutable</key>
+    <string>$(EXECUTABLE_NAME)</string>
+    <key>CFBundleIdentifier</key>
+    <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>$(PRODUCT_NAME)</string>
+    <key>CFBundlePackageType</key>
+    <string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+    <key>CFBundleShortVersionString</key>
+    <string>1.0</string>
+    <key>CFBundleVersion</key>
+    <string>1</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>$(MACOSX_DEPLOYMENT_TARGET)</string>
+    <key>NSHumanReadableCopyright</key>
+    <string>Copyright © 2024. All rights reserved.</string>
+    <key>NSMainStoryboardFile</key>
+    <string></string>
+    <key>NSPrincipalClass</key>
+    <string>NSApplication</string>
+</dict>
+</plist>
+PLIST_EOF
+  echo "Created: $INFO_PLIST"
+fi
+
+# Generate entitlements file if it doesn't exist
+ENTITLEMENTS="$SUPPORT_DIR/\$PROJECT_NAME.entitlements"
+if [ ! -f "$ENTITLEMENTS" ]; then
+  echo "Creating entitlements file..."
+  cat > "$ENTITLEMENTS" << 'ENTITLEMENTS_EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.security.app-sandbox</key>
+    <true/>
+    <key>com.apple.security.network.client</key>
+    <true/>
+    <key>com.apple.security.files.user-selected.read-write</key>
+    <true/>
+</dict>
+</plist>
+ENTITLEMENTS_EOF
+  echo "Created: $ENTITLEMENTS"
+fi
+
+# Try xcodegen first (recommended for SwiftUI apps)
+if command -v xcodegen &> /dev/null; then
+  echo ""
+  echo "Using xcodegen to generate Xcode project..."
+
+  # Create project.yml if it doesn't exist
+  PROJECT_YML="$PROJECT_ROOT/project.yml"
+  if [ ! -f "$PROJECT_YML" ]; then
+    echo "Creating project.yml for xcodegen..."
+    cat > "$PROJECT_YML" << YAML_EOF
+name: \$PROJECT_NAME
+options:
+  bundleIdPrefix: com.example
+  deploymentTarget:
+    macOS: "13.0"
+  xcodeVersion: "15.0"
+  generateEmptyDirectories: true
+
+targets:
+  \$PROJECT_NAME:
+    type: application
+    platform: macOS
+    sources:
+      - path: Sources/\$PROJECT_NAME
+        excludes:
+          - "**/*.entitlements"
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: com.example.\$PROJECT_NAME
+        INFOPLIST_FILE: Sources/\$PROJECT_NAME/Supporting Files/Info.plist
+        CODE_SIGN_ENTITLEMENTS: Sources/\$PROJECT_NAME/Supporting Files/\$PROJECT_NAME.entitlements
+        MACOSX_DEPLOYMENT_TARGET: "13.0"
+        SWIFT_VERSION: "5.9"
+        DEVELOPMENT_TEAM: ""
+        CODE_SIGN_STYLE: Automatic
+        COMBINE_HIDPI_IMAGES: true
+        ASSETCATALOG_COMPILER_APPICON_NAME: AppIcon
+    dependencies: []
+YAML_EOF
+    echo "Created: $PROJECT_YML"
+  fi
+
+  xcodegen generate
+  echo ""
+  echo "Xcode project generated successfully!"
+
+else
+  # Fall back to swift package generate-xcodeproj (deprecated but still works)
+  echo ""
+  echo "xcodegen not found, using 'swift package generate-xcodeproj'..."
+  echo "Note: For better SwiftUI support, consider installing xcodegen:"
+  echo "  brew install xcodegen"
+  echo ""
+
+  swift package generate-xcodeproj
+  echo ""
+  echo "Xcode project generated successfully!"
+  echo ""
+  echo "Note: You may need to manually configure SwiftUI app settings in Xcode:"
+  echo "  1. Set the app target type to 'Application'"
+  echo "  2. Add Info.plist to the target"
+  echo "  3. Configure signing and capabilities"
+fi
+
+echo ""
+echo "Next steps:"
+echo "  1. Open \$PROJECT_NAME.xcodeproj in Xcode"
+echo "  2. Configure your Team ID for code signing"
+echo "  3. Build and run (Cmd+R)"
+echo ""
+echo "If using xcodegen, you can regenerate the project anytime with:"
+echo "  ./scripts/gen_xcode.sh"
+`;
+}
+/**
+ * Check if the selected technologies include SwiftUI
+ */
+export function hasSwiftUI(technologies) {
+    return technologies.some(tech => tech.toLowerCase().includes('swiftui') ||
+        tech.toLowerCase() === 'swiftui');
+}
+/**
+ * Check if the selected technologies include Fastlane
+ */
+export function hasFastlane(technologies) {
+    return technologies.some(tech => tech.toLowerCase().includes('fastlane') ||
+        tech.toLowerCase() === 'fastlane');
+}
+/**
+ * Generate Fastfile template for macOS/iOS deployment
+ * This creates a standard Fastfile with beta and release lanes
+ *
+ * @param projectName - Name of the Xcode project/app
+ */
+export function generateFastfile(projectName = "App") {
+    return `# Fastfile - Fastlane configuration for ${projectName}
+#
+# This file contains lanes for automating builds and deployments.
+# Run lanes from the scripts/ directory: cd scripts && fastlane <lane>
+#
+# SETUP:
+#   1. Run 'fastlane init' in this directory to configure credentials
+#   2. Update the Appfile with your Apple Developer account details
+#   3. Configure signing in Xcode or via match
+#
+# AVAILABLE LANES:
+#   fastlane beta    - Build and upload to TestFlight
+#   fastlane release - Build and submit to App Store
+#   fastlane tests   - Run all tests
+#
+# For more information: https://docs.fastlane.tools
+#
+
+default_platform(:mac)
+
+platform :mac do
+  desc "Run all tests"
+  lane :tests do
+    run_tests(
+      project: "../${projectName}.xcodeproj",
+      scheme: "${projectName}",
+      clean: true,
+      code_coverage: true
+    )
+  end
+
+  desc "Build and upload to TestFlight for beta testing"
+  lane :beta do
+    # Ensure we're on a clean git state
+    ensure_git_status_clean
+
+    # Increment build number
+    increment_build_number(
+      xcodeproj: "../${projectName}.xcodeproj"
+    )
+
+    # Build the app
+    build_mac_app(
+      project: "../${projectName}.xcodeproj",
+      scheme: "${projectName}",
+      configuration: "Release",
+      export_method: "app-store",
+      output_directory: "../build",
+      output_name: "${projectName}.app"
+    )
+
+    # Upload to TestFlight
+    upload_to_testflight(
+      skip_waiting_for_build_processing: true
+    )
+
+    # Commit version bump
+    commit_version_bump(
+      xcodeproj: "../${projectName}.xcodeproj",
+      message: "chore: Bump build number for beta release"
+    )
+
+    # Tag the release
+    add_git_tag(
+      tag: "beta/#{get_version_number(xcodeproj: '../${projectName}.xcodeproj')}-#{get_build_number(xcodeproj: '../${projectName}.xcodeproj')}"
+    )
+
+    # Push to remote
+    push_to_git_remote
+  end
+
+  desc "Build and submit to the App Store"
+  lane :release do
+    # Ensure we're on a clean git state
+    ensure_git_status_clean
+
+    # Run tests first
+    tests
+
+    # Increment version number (patch)
+    increment_version_number(
+      xcodeproj: "../${projectName}.xcodeproj",
+      bump_type: "patch"
+    )
+
+    # Reset build number for new version
+    increment_build_number(
+      xcodeproj: "../${projectName}.xcodeproj",
+      build_number: "1"
+    )
+
+    # Build the app
+    build_mac_app(
+      project: "../${projectName}.xcodeproj",
+      scheme: "${projectName}",
+      configuration: "Release",
+      export_method: "app-store",
+      output_directory: "../build",
+      output_name: "${projectName}.app"
+    )
+
+    # Upload to App Store Connect
+    upload_to_app_store(
+      submit_for_review: false,
+      automatic_release: false,
+      skip_metadata: true,
+      skip_screenshots: true
+    )
+
+    # Commit version bump
+    commit_version_bump(
+      xcodeproj: "../${projectName}.xcodeproj",
+      message: "chore: Bump version for App Store release"
+    )
+
+    # Tag the release
+    add_git_tag(
+      tag: "v#{get_version_number(xcodeproj: '../${projectName}.xcodeproj')}"
+    )
+
+    # Push to remote
+    push_to_git_remote(tags: true)
+  end
+
+  # Error handling
+  error do |lane, exception|
+    # You can add error notifications here (e.g., Slack, email)
+    UI.error("Lane #{lane} failed with error: #{exception.message}")
+  end
+end
+`;
+}
+/**
+ * Generate Appfile template for Fastlane
+ * This contains app-specific configuration like bundle ID and Apple ID
+ *
+ * @param projectName - Name of the Xcode project/app
+ */
+export function generateAppfile(projectName = "App") {
+    const bundleId = `com.example.${projectName.toLowerCase().replace(/[^a-z0-9]/g, "")}`;
+    return `# Appfile - Fastlane app configuration
+#
+# This file contains your app's bundle identifier and Apple Developer account info.
+# Update the values below with your actual credentials.
+#
+# For more information: https://docs.fastlane.tools/advanced/Appfile/
+#
+
+# Your app's bundle identifier (must match Xcode project)
+app_identifier "${bundleId}"
+
+# Your Apple Developer email address
+# apple_id "your-email@example.com"
+
+# Your App Store Connect team ID (if you're on multiple teams)
+# itc_team_id "123456789"
+
+# Your Apple Developer Portal team ID (if you're on multiple teams)
+# team_id "XXXXXXXXXX"
+
+# For more information about the Appfile, see:
+# https://docs.fastlane.tools/advanced/Appfile/
+`;
+}
+/**
+ * Generate README section for Fastlane setup
+ * This provides documentation on how to use Fastlane with the project
+ *
+ * @param projectName - Name of the Xcode project/app
+ */
+export function generateFastlaneReadmeSection(projectName = "App") {
+    return `## Fastlane Deployment
+
+This project includes [Fastlane](https://fastlane.tools/) configuration for automated builds and deployments.
+
+### Setup
+
+1. **Install Fastlane** (if not already installed):
+   \`\`\`bash
+   # Using Homebrew
+   brew install fastlane
+
+   # Or using RubyGems
+   gem install fastlane
+   \`\`\`
+
+2. **Configure credentials**:
+   - Edit \`scripts/fastlane/Appfile\` with your Apple Developer account details
+   - Run \`cd scripts && fastlane init\` to set up App Store Connect credentials
+
+3. **Configure code signing** (choose one):
+   - **Xcode automatic signing**: Enable "Automatically manage signing" in Xcode
+   - **Fastlane match**: Run \`fastlane match init\` to set up certificate/profile management
+
+### Available Lanes
+
+Run Fastlane commands from the \`scripts/\` directory:
+
+| Lane | Description |
+|------|-------------|
+| \`fastlane tests\` | Run all unit and UI tests |
+| \`fastlane beta\` | Build and upload to TestFlight |
+| \`fastlane release\` | Build and submit to App Store |
+
+### Using with Ralph
+
+Ralph can trigger Fastlane lanes via daemon actions:
+
+\`\`\`bash
+# From inside the sandbox (via ralph action)
+ralph action fastlane_beta
+ralph action fastlane_release
+
+# From Telegram chat
+/notify fastlane_beta
+/notify fastlane_release
+\`\`\`
+
+### Customization
+
+- **Fastfile** (\`scripts/fastlane/Fastfile\`): Add custom lanes for your workflow
+- **Appfile** (\`scripts/fastlane/Appfile\`): Configure app bundle ID and team settings
+
+For more information, see the [Fastlane documentation](https://docs.fastlane.tools/).
+`;
+}

package/dist/tui/ConfigEditor.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+/**
+ * ConfigEditor is the main TUI application component.
+ * It provides a two-panel layout with section navigation and field editing.
+ */
+export declare function ConfigEditor(): React.ReactElement;
+export default ConfigEditor;