@factiii/stack 0.1.2

package/dist/plugins/pipelines/factiii/workflows/factiii-cicd-prod.yml

@@ -0,0 +1,112 @@
+name: Factiii CI/CD Prod
+
+# Generated by @factiii/stack v{VERSION}
+# CI/CD: Auto-deploy to prod on push to prod branch
+# This is the app's CI/CD pipeline, NOT infrastructure management.
+# For manual infrastructure operations, use factiii-deploy.yml
+
+on:
+  push:
+    branches:
+      - prod
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install yq
+        run: |
+          sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64
+          sudo chmod +x /usr/local/bin/yq
+
+      - name: Read config
+        id: config
+        run: |
+          if [ ! -f "factiii.yml" ]; then
+            echo "❌ factiii.yml not found"
+            exit 1
+          fi
+
+          REPO_NAME=$(yq eval '.name' factiii.yml)
+          HOST=$(yq eval '.prod.domain // ""' factiii.yml)
+          SSH_USER=$(yq eval '.prod.ssh_user // "ubuntu"' factiii.yml)
+
+          echo "repo_name=$REPO_NAME" >> $GITHUB_OUTPUT
+          echo "host=$HOST" >> $GITHUB_OUTPUT
+          echo "ssh_user=$SSH_USER" >> $GITHUB_OUTPUT
+
+      - name: Check if prod configured
+        id: check_prod
+        run: |
+          HAS_PROD=$(yq eval '.prod != null' factiii.yml)
+          echo "has_prod=$HAS_PROD" >> $GITHUB_OUTPUT
+
+          if [ "$HAS_PROD" != "true" ]; then
+            echo "⏭️  Prod environment not configured in factiii.yml - skipping deployment"
+            exit 0
+          fi
+
+      - name: Setup SSH
+        if: steps.check_prod.outputs.has_prod == 'true'
+        env:
+          SSH_KEY: ${{ secrets.PROD_SSH }}
+        run: |
+          if [ -z "$SSH_KEY" ]; then
+            echo "❌ Missing PROD_SSH secret"
+            exit 1
+          fi
+          
+          mkdir -p ~/.ssh
+          echo "$SSH_KEY" > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+
+      - name: Deploy via CLI
+        if: steps.check_prod.outputs.has_prod == 'true'
+        env:
+          HOST: ${{ steps.config.outputs.host }}
+          USER: ${{ steps.config.outputs.ssh_user }}
+          REPO_NAME: ${{ steps.config.outputs.repo_name }}
+          COMMIT_HASH: ${{ github.sha }}
+          BRANCH: ${{ github.ref_name }}
+          GITHUB_REPO: ${{ github.repository }}
+          PROD_ENVS: ${{ secrets.PROD_ENVS }}
+        run: |
+          if [ -z "$HOST" ]; then
+            echo "❌ Missing domain in factiii.yml: prod.domain"
+            exit 1
+          fi
+          
+          echo "🚀 Deploying to prod ($HOST)..."
+          
+          # Prepare environment variables for SSH (base64 encode to handle special characters)
+          ENV_VARS_EXPORT=""
+          if [ -n "$PROD_ENVS" ]; then
+            ENV_VARS_B64=$(echo -n "$PROD_ENVS" | base64 -w 0)
+            ENV_VARS_EXPORT="PROD_ENVS=\$(echo '$ENV_VARS_B64' | base64 -d) && export PROD_ENVS && "
+          fi
+          
+          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no "$USER@$HOST" \
+            "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\" && \
+             REPO_DIR=\"\$HOME/.factiii/$REPO_NAME\" && \
+             if [ -d \"\$REPO_DIR\" ]; then \
+               cd \"\$REPO_DIR\" && \
+               $ENV_VARS_EXPORT GITHUB_ACTIONS=true COMMIT_HASH=$COMMIT_HASH BRANCH=$BRANCH GITHUB_REPO=$GITHUB_REPO \
+               npx factiii deploy --prod --commit $COMMIT_HASH --branch $BRANCH; \
+             else \
+               echo \"❌ Repo directory not found at \$REPO_DIR\"; \
+               echo \"Run deployment first to clone the repository\"; \
+               exit 1; \
+             fi"
+          
+          DEPLOY_EXIT_CODE=$?
+          rm -f ~/.ssh/deploy_key
+          
+          if [ $DEPLOY_EXIT_CODE -eq 0 ]; then
+            echo "✅ Prod deployment complete!"
+          else
+            echo "❌ Prod deployment failed with exit code $DEPLOY_EXIT_CODE"
+            exit $DEPLOY_EXIT_CODE
+          fi

package/dist/plugins/pipelines/factiii/workflows/factiii-cicd-staging.yml

@@ -0,0 +1,112 @@
+name: Factiii CI/CD Staging
+
+# Generated by @factiii/stack v{VERSION}
+# CI/CD: Auto-deploy to staging on push to main branch
+# This is the app's CI/CD pipeline, NOT infrastructure management.
+# For manual infrastructure operations, use factiii-deploy.yml
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install yq
+        run: |
+          sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64
+          sudo chmod +x /usr/local/bin/yq
+
+      - name: Read config
+        id: config
+        run: |
+          if [ ! -f "factiii.yml" ]; then
+            echo "❌ factiii.yml not found"
+            exit 1
+          fi
+
+          REPO_NAME=$(yq eval '.name' factiii.yml)
+          HOST=$(yq eval '.staging.domain // ""' factiii.yml)
+          SSH_USER=$(yq eval '.staging.ssh_user // "ubuntu"' factiii.yml)
+
+          echo "repo_name=$REPO_NAME" >> $GITHUB_OUTPUT
+          echo "host=$HOST" >> $GITHUB_OUTPUT
+          echo "ssh_user=$SSH_USER" >> $GITHUB_OUTPUT
+
+      - name: Check if staging configured
+        id: check_staging
+        run: |
+          HAS_STAGING=$(yq eval '.staging != null' factiii.yml)
+          echo "has_staging=$HAS_STAGING" >> $GITHUB_OUTPUT
+
+          if [ "$HAS_STAGING" != "true" ]; then
+            echo "⏭️  Staging environment not configured in factiii.yml - skipping deployment"
+            exit 0
+          fi
+
+      - name: Setup SSH
+        if: steps.check_staging.outputs.has_staging == 'true'
+        env:
+          SSH_KEY: ${{ secrets.STAGING_SSH }}
+        run: |
+          if [ -z "$SSH_KEY" ]; then
+            echo "❌ Missing STAGING_SSH secret"
+            exit 1
+          fi
+          
+          mkdir -p ~/.ssh
+          echo "$SSH_KEY" > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+
+      - name: Deploy via CLI
+        if: steps.check_staging.outputs.has_staging == 'true'
+        env:
+          HOST: ${{ steps.config.outputs.host }}
+          USER: ${{ steps.config.outputs.ssh_user }}
+          REPO_NAME: ${{ steps.config.outputs.repo_name }}
+          COMMIT_HASH: ${{ github.sha }}
+          BRANCH: ${{ github.ref_name }}
+          GITHUB_REPO: ${{ github.repository }}
+          STAGING_ENVS: ${{ secrets.STAGING_ENVS }}
+        run: |
+          if [ -z "$HOST" ]; then
+            echo "❌ Missing domain in factiii.yml: staging.domain"
+            exit 1
+          fi
+          
+          echo "🚀 Deploying to staging ($HOST)..."
+          
+          # Prepare environment variables for SSH (base64 encode to handle special characters)
+          ENV_VARS_EXPORT=""
+          if [ -n "$STAGING_ENVS" ]; then
+            ENV_VARS_B64=$(echo -n "$STAGING_ENVS" | base64 -w 0)
+            ENV_VARS_EXPORT="STAGING_ENVS=\$(echo '$ENV_VARS_B64' | base64 -d) && export STAGING_ENVS && "
+          fi
+          
+          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no "$USER@$HOST" \
+            "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\" && \
+             REPO_DIR=\"\$HOME/.factiii/$REPO_NAME\" && \
+             if [ -d \"\$REPO_DIR\" ]; then \
+               cd \"\$REPO_DIR\" && \
+               $ENV_VARS_EXPORT GITHUB_ACTIONS=true COMMIT_HASH=$COMMIT_HASH BRANCH=$BRANCH GITHUB_REPO=$GITHUB_REPO \
+               npx factiii deploy --staging --commit $COMMIT_HASH --branch $BRANCH; \
+             else \
+               echo \"❌ Repo directory not found at \$REPO_DIR\"; \
+               echo \"Run deployment first to clone the repository\"; \
+               exit 1; \
+             fi"
+          
+          DEPLOY_EXIT_CODE=$?
+          rm -f ~/.ssh/deploy_key
+          
+          if [ $DEPLOY_EXIT_CODE -eq 0 ]; then
+            echo "✅ Staging deployment complete!"
+          else
+            echo "❌ Staging deployment failed with exit code $DEPLOY_EXIT_CODE"
+            exit $DEPLOY_EXIT_CODE
+          fi

package/dist/plugins/pipelines/factiii/workflows/factiii-command.yml

@@ -0,0 +1,130 @@
+name: Factiii Command
+
+# Generated by @factiii/stack v{VERSION}
+# INFRASTRUCTURE: Run plugin commands on remote servers
+# Run: npx factiii db seed --staging (triggers this workflow)
+
+on:
+  workflow_dispatch:
+    inputs:
+      category:
+        description: 'Command category (db, ops, backup)'
+        required: true
+        type: string
+      command:
+        description: 'Command to run (e.g., seed, migrate, logs)'
+        required: true
+        type: string
+      stage:
+        description: 'Target environment'
+        required: true
+        type: choice
+        options:
+          - staging
+          - prod
+      options:
+        description: 'Command options (JSON)'
+        required: false
+        default: '{}'
+
+jobs:
+  run-command:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install yq
+        run: |
+          sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64
+          sudo chmod +x /usr/local/bin/yq
+
+      - name: Read config
+        id: config
+        env:
+          STAGE: ${{ inputs.stage }}
+        run: |
+          if [ ! -f "factiii.yml" ]; then
+            echo "factiii.yml not found"
+            exit 1
+          fi
+
+          REPO_NAME=$(yq eval '.name' factiii.yml)
+          HOST=$(yq eval ".$STAGE.domain // \"\"" factiii.yml)
+          SSH_USER=$(yq eval ".$STAGE.ssh_user // \"ubuntu\"" factiii.yml)
+
+          echo "repo_name=$REPO_NAME" >> $GITHUB_OUTPUT
+          echo "host=$HOST" >> $GITHUB_OUTPUT
+          echo "ssh_user=$SSH_USER" >> $GITHUB_OUTPUT
+
+      - name: Check environment configured
+        env:
+          STAGE: ${{ inputs.stage }}
+        run: |
+          HAS_ENV=$(yq eval ".$STAGE != null" factiii.yml)
+          if [ "$HAS_ENV" != "true" ]; then
+            echo "$STAGE environment not configured in factiii.yml"
+            exit 1
+          fi
+
+      - name: Check SSH secret
+        env:
+          STAGE: ${{ inputs.stage }}
+          SSH_KEY: ${{ inputs.stage == 'staging' && secrets.STAGING_SSH || secrets.PROD_SSH }}
+        run: |
+          if [ -z "$SSH_KEY" ]; then
+            SECRET_NAME="${STAGE^^}_SSH"
+            echo "${SECRET_NAME} secret not found"
+            echo "Add it at: https://github.com/${{ github.repository }}/settings/secrets/actions"
+            exit 1
+          fi
+
+      - name: Setup SSH
+        env:
+          SSH_KEY: ${{ inputs.stage == 'staging' && secrets.STAGING_SSH || secrets.PROD_SSH }}
+        run: |
+          mkdir -p ~/.ssh
+          echo "$SSH_KEY" > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+
+      - name: Run command via SSH
+        env:
+          HOST: ${{ steps.config.outputs.host }}
+          USER: ${{ steps.config.outputs.ssh_user }}
+          REPO_NAME: ${{ steps.config.outputs.repo_name }}
+          CATEGORY: ${{ inputs.category }}
+          COMMAND: ${{ inputs.command }}
+          STAGE: ${{ inputs.stage }}
+        run: |
+          if [ -z "$HOST" ]; then
+            echo "Missing domain in factiii.yml: $STAGE.domain"
+            exit 1
+          fi
+
+          echo "Running: factiii $CATEGORY $COMMAND --$STAGE"
+          echo "Server: $USER@$HOST"
+          echo ""
+
+          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no -o ConnectTimeout=10 -o ServerAliveInterval=60 -o ServerAliveCountMax=5 "$USER@$HOST" \
+            "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\" && \
+             REPO_DIR=\"\$HOME/.factiii/$REPO_NAME\" && \
+             if [ -d \"\$REPO_DIR\" ]; then \
+               cd \"\$REPO_DIR\" && \
+               GITHUB_ACTIONS=true npx factiii $CATEGORY $COMMAND --$STAGE; \
+             else \
+               echo \"Repo directory not found at \$REPO_DIR\"; \
+               echo \"Run deployment first to clone the repository\"; \
+               exit 1; \
+             fi"
+
+          EXIT_CODE=$?
+          rm -f ~/.ssh/deploy_key
+
+          if [ $EXIT_CODE -eq 0 ]; then
+            echo ""
+            echo "Command completed successfully"
+          else
+            echo ""
+            echo "Command failed with exit code $EXIT_CODE"
+            exit $EXIT_CODE
+          fi

package/dist/plugins/pipelines/factiii/workflows/factiii-deploy.yml

@@ -0,0 +1,198 @@
+name: Factiii Deploy
+
+# Generated by @factiii/stack v{VERSION}
+# INFRASTRUCTURE: Manual deployment triggered via CLI
+# Run: npx factiii deploy --staging or npx factiii deploy --prod
+# For auto-deploy on push, see factiii-cicd-staging.yml / factiii-cicd-prod.yml
+
+on:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Environment to deploy'
+        required: true
+        type: choice
+        options:
+          - staging
+          - prod
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install yq
+        run: |
+          sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64
+          sudo chmod +x /usr/local/bin/yq
+
+      - name: Read config
+        id: config
+        run: |
+          if [ ! -f "factiii.yml" ]; then
+            echo "❌ factiii.yml not found"
+            exit 1
+          fi
+
+          REPO_NAME=$(yq eval '.name' factiii.yml)
+
+          if [ "${{ inputs.environment }}" == "staging" ]; then
+            HOST=$(yq eval '.staging.domain // ""' factiii.yml)
+            SSH_USER=$(yq eval '.staging.ssh_user // "ubuntu"' factiii.yml)
+          else
+            HOST=$(yq eval '.prod.domain // ""' factiii.yml)
+            SSH_USER=$(yq eval '.prod.ssh_user // "ubuntu"' factiii.yml)
+          fi
+
+          echo "repo_name=$REPO_NAME" >> $GITHUB_OUTPUT
+          echo "host=$HOST" >> $GITHUB_OUTPUT
+          echo "ssh_user=$SSH_USER" >> $GITHUB_OUTPUT
+
+      - name: Check if environment configured
+        id: check_env
+        run: |
+          if [ "${{ inputs.environment }}" == "staging" ]; then
+            HAS_ENV=$(yq eval '.staging != null' factiii.yml)
+          else
+            HAS_ENV=$(yq eval '.prod != null' factiii.yml)
+          fi
+
+          echo "has_env=$HAS_ENV" >> $GITHUB_OUTPUT
+
+          if [ "$HAS_ENV" != "true" ]; then
+            echo "⏭️  ${{ inputs.environment }} environment not configured in factiii.yml"
+            exit 1
+          fi
+
+      - name: Read staging config (for prod builds)
+        if: steps.check_env.outputs.has_env == 'true' && inputs.environment == 'prod'
+        id: staging_config
+        run: |
+          STAGING_HOST=$(yq eval '.staging.domain // ""' factiii.yml)
+          STAGING_SSH_USER=$(yq eval '.staging.ssh_user // "ubuntu"' factiii.yml)
+
+          echo "staging_host=$STAGING_HOST" >> $GITHUB_OUTPUT
+          echo "staging_ssh_user=$STAGING_SSH_USER" >> $GITHUB_OUTPUT
+
+      - name: Setup Node.js
+        if: steps.check_env.outputs.has_env == 'true'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Load SSH keys from Ansible Vault
+        if: steps.check_env.outputs.has_env == 'true'
+        env:
+          ANSIBLE_VAULT_PASSWORD: ${{ secrets.ANSIBLE_VAULT_PASSWORD }}
+        run: |
+          if [ -z "$ANSIBLE_VAULT_PASSWORD" ]; then
+            echo "❌ Missing ANSIBLE_VAULT_PASSWORD secret (vault password)"
+            exit 1
+          fi
+          
+          npx factiii secrets write-ssh-keys
+          
+          # Create deploy_key symlink for current environment
+          if [ "${{ inputs.environment }}" == "staging" ]; then
+            ln -sf ~/.ssh/staging_deploy_key ~/.ssh/deploy_key
+          else
+            ln -sf ~/.ssh/prod_deploy_key ~/.ssh/deploy_key
+          fi
+
+      - name: Build production image on staging (prod only)
+        if: steps.check_env.outputs.has_env == 'true' && inputs.environment == 'prod'
+        env:
+          STAGING_HOST: ${{ steps.staging_config.outputs.staging_host }}
+          STAGING_USER: ${{ steps.staging_config.outputs.staging_ssh_user }}
+          REPO_NAME: ${{ steps.config.outputs.repo_name }}
+          COMMIT_HASH: ${{ github.sha }}
+          BRANCH: ${{ github.ref_name }}
+          GITHUB_REPO: ${{ github.repository }}
+        run: |
+          if [ -z "$STAGING_HOST" ]; then
+            echo "⚠️  Staging host not configured, skipping build step"
+            exit 0
+          fi
+          
+          echo "🔨 Building production image on staging server ($STAGING_HOST)..."
+          
+          ssh -i ~/.ssh/staging_deploy_key -o StrictHostKeyChecking=no "$STAGING_USER@$STAGING_HOST" \
+            "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\" && \
+             REPO_DIR=\"\$HOME/.factiii/$REPO_NAME\" && \
+             if [ -d \"\$REPO_DIR\" ]; then \
+               cd \"\$REPO_DIR\" && \
+               GITHUB_ACTIONS=true COMMIT_HASH=$COMMIT_HASH BRANCH=$BRANCH GITHUB_REPO=$GITHUB_REPO \
+               npx factiii deploy --prod --commit $COMMIT_HASH --branch $BRANCH; \
+             else \
+               echo \"❌ Repo directory not found at \$REPO_DIR\"; \
+               exit 1; \
+             fi"
+          
+          BUILD_EXIT_CODE=$?
+          if [ $BUILD_EXIT_CODE -ne 0 ]; then
+            echo "❌ Build step failed with exit code $BUILD_EXIT_CODE"
+            exit $BUILD_EXIT_CODE
+          fi
+          
+          echo "✅ Production image built and pushed to ECR"
+
+      - name: Deploy via CLI
+        if: steps.check_env.outputs.has_env == 'true'
+        env:
+          HOST: ${{ steps.config.outputs.host }}
+          USER: ${{ steps.config.outputs.ssh_user }}
+          REPO_NAME: ${{ steps.config.outputs.repo_name }}
+          ENVIRONMENT: ${{ inputs.environment }}
+          COMMIT_HASH: ${{ github.sha }}
+          BRANCH: ${{ github.ref_name }}
+          GITHUB_REPO: ${{ github.repository }}
+          STAGING_ENVS: ${{ inputs.environment == 'staging' && secrets.STAGING_ENVS || '' }}
+          PROD_ENVS: ${{ inputs.environment == 'prod' && secrets.PROD_ENVS || '' }}
+        run: |
+          if [ -z "$HOST" ]; then
+            echo "❌ Missing domain in factiii.yml: $ENVIRONMENT.domain"
+            exit 1
+          fi
+          
+          echo "🚀 Deploying to $ENVIRONMENT ($HOST)..."
+          
+          # For prod, skip build step (already done in previous step)
+          SKIP_BUILD_FLAG=""
+          if [ "$ENVIRONMENT" == "prod" ]; then
+            SKIP_BUILD_FLAG="SKIP_BUILD=true"
+          fi
+          
+          # Prepare environment variables for SSH (base64 encode to handle special characters)
+          ENV_VARS_EXPORT=""
+          if [ "$ENVIRONMENT" == "staging" ] && [ -n "$STAGING_ENVS" ]; then
+            ENV_VARS_B64=$(echo -n "$STAGING_ENVS" | base64 -w 0)
+            ENV_VARS_EXPORT="STAGING_ENVS=\$(echo '$ENV_VARS_B64' | base64 -d) && export STAGING_ENVS && "
+          elif [ "$ENVIRONMENT" == "prod" ] && [ -n "$PROD_ENVS" ]; then
+            ENV_VARS_B64=$(echo -n "$PROD_ENVS" | base64 -w 0)
+            ENV_VARS_EXPORT="PROD_ENVS=\$(echo '$ENV_VARS_B64' | base64 -d) && export PROD_ENVS && "
+          fi
+          
+          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no "$USER@$HOST" \
+            "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\" && \
+             REPO_DIR=\"\$HOME/.factiii/$REPO_NAME\" && \
+             if [ -d \"\$REPO_DIR\" ]; then \
+               cd \"\$REPO_DIR\" && \
+               $ENV_VARS_EXPORT$SKIP_BUILD_FLAG GITHUB_ACTIONS=true COMMIT_HASH=$COMMIT_HASH BRANCH=$BRANCH GITHUB_REPO=$GITHUB_REPO \
+               npx factiii deploy --$ENVIRONMENT --commit $COMMIT_HASH --branch $BRANCH; \
+             else \
+               echo \"❌ Repo directory not found at \$REPO_DIR\"; \
+               echo \"Run deployment first to clone the repository\"; \
+               exit 1; \
+             fi"
+          
+          DEPLOY_EXIT_CODE=$?
+          rm -f ~/.ssh/deploy_key ~/.ssh/staging_deploy_key ~/.ssh/prod_deploy_key
+          
+          if [ $DEPLOY_EXIT_CODE -eq 0 ]; then
+            echo "✅ Deployment complete!"
+          else
+            echo "❌ Deployment failed with exit code $DEPLOY_EXIT_CODE"
+            exit $DEPLOY_EXIT_CODE
+          fi