ci: restructure pipeline into distinct stages, fix formatting and linting

Author: Dayclone

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,7 +1,7 @@
 ---
 name: Bug Report
 about: Report a bug to help us improve
-title: "[Bug] "
+title: '[Bug] '
 labels: bug
 assignees: ''
 ---

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,7 +1,7 @@
 ---
 name: Feature Request
 about: Suggest an idea for this project
-title: "[Feature] "
+title: '[Feature] '
 labels: enhancement
 assignees: ''
 ---

.github/ISSUE_TEMPLATE/question.md

@@ -1,7 +1,7 @@
 ---
 name: Question
 about: Ask a question about usage or behavior
-title: "[Question] "
+title: '[Question] '
 labels: question
 assignees: ''
 ---
@@ -24,6 +24,6 @@ Describe what you've already tried or looked at:
 
 ## Environment (if relevant)
 
-- **OS**: 
-- **Node.js version**: 
-- **remote-opencode version**: 
+- **OS**:
+- **Node.js version**:
+- **remote-opencode version**:

.github/PULL_REQUEST_TEMPLATE.md

@@ -21,9 +21,9 @@ Closes #
 
 <!-- List the specific changes made in this PR -->
 
-- 
-- 
-- 
+-
+-
+-
 
 ## Testing
 

.github/workflows/ci-cd.yml

@@ -13,22 +13,17 @@ env:
 
 jobs:
   # ============================================================
-  # Single Unified Workflow Job
+  # Stage 1: Validation & Code Quality
   # ============================================================
-  ci-cd:
-    name: 🚀 CI/CD & Standalone Release
-    runs-on: windows-latest # Windows is required for SEA .exe generation
-    timeout-minutes: 20
+  quality:
+    name: 🔬 Quality & Lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
     permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-
+      contents: read
     steps:
       - name: 🔍 Checkout code
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0 # Full history needed for changelog generation
 
       - name: 🟢 Setup Node.js
         uses: actions/setup-node@v4
@@ -39,55 +34,128 @@ jobs:
       - name: 📦 Install dependencies
         run: npm ci
 
-      - name: 🔬 Code Quality Check (Lint & Types)
-        run: |
-          npm run lint
-          npm run type-check
-          npm run format:check
+      - name: ✨ Prettier Format Check
+        run: npm run format:check
+
+      - name: 🧹 Lint Check
+        run: npm run lint
+
+      - name: 🛡️ TypeScript Type Check
+        run: npm run type-check
 
-      - name: 🧪 Unit Tests
+  # ============================================================
+  # Stage 2: Unit Testing
+  # ============================================================
+  test:
+    name: 🧪 Unit Tests
+    needs: quality
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: 🔍 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 🏃 Run Tests
         run: npm test
 
-      - name: 🏗️ Build Standalone EXE
+  # ============================================================
+  # Stage 3: Build Standalone EXE
+  # ============================================================
+  build:
+    name: 🏗️ Build Standalone EXE
+    needs: test
+    runs-on: windows-latest
+    timeout-minutes: 15
+    steps:
+      - name: 🔍 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 🔨 Build Standalone EXE
         run: npm run build:sea
 
-      - name: ⬆️ Upload Artifact (Internal)
+      - name: ⬆️ Upload Artifact
         uses: actions/upload-artifact@v4
         with:
           name: remote-opencode-windows
           path: dist/remote-opencode.exe
-          retention-days: 1
+          retention-days: 7
+
+  # ============================================================
+  # Stage 4: Release & Feedback
+  # ============================================================
+  release-and-feedback:
+    name: 🚀 Release & PR Summary
+    needs: build
+    runs-on: ubuntu-latest
+    if: always()
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+
+    steps:
+      - name: 🔍 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 📥 Download Artifact
+        if: needs.build.result == 'success'
+        uses: actions/download-artifact@v4
+        with:
+          name: remote-opencode-windows
+          path: .
 
-      # ============================================================
-      # Release Logic (Only on Version Tags)
-      # ============================================================
       - name: 🚀 Create GitHub Release
-        if: startsWith(github.ref, 'refs/tags/v')
+        if: startsWith(github.ref, 'refs/tags/v') && needs.build.result == 'success'
         uses: softprops/action-gh-release@v2
         with:
-          files: dist/remote-opencode.exe
+          files: remote-opencode.exe
           name: Release ${{ github.ref_name }}
           draft: false
           prerelease: false
-          generate_release_notes: true # Automatically generates changelog from commits
+          generate_release_notes: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      # ============================================================
-      # PR Feedback (Only on Pull Requests)
-      # ============================================================
       - name: 📊 Post PR Summary
-        if: github.event_name == 'pull_request' && always()
+        if: github.event_name == 'pull_request'
         uses: actions/github-script@v7
         with:
           script: |
-            const status = "${{ job.status }}";
-            const emoji = status === 'success' ? '✅' : '❌';
-            const body = `## ${emoji} CI/CD Pipeline ${status === 'success' ? 'Passed' : 'Failed'}
+            const qualityStatus = "${{ needs.quality.result }}";
+            const testStatus = "${{ needs.test.result }}";
+            const buildStatus = "${{ needs.build.result }}";
+
+            const check = (status) => status === 'success' ? '✅ Passed' : (status === 'skipped' ? '⏭️ Skipped' : '❌ Failed');
+
+            const body = `## CI/CD Pipeline Summary
 
-            All checks (Lint, Types, Format, Tests, and Windows Build) have been executed in a unified environment.
+            | Stage | Status |
+            |-------|--------|
+            | 🔬 Code Quality | ${check(qualityStatus)} |
+            | 🧪 Unit Tests | ${check(testStatus)} |
+            | 🏗️ Build EXE | ${check(buildStatus)} |
 
-            ${status === 'success' ? 'The standalone EXE was built successfully and is ready for release! 🎉' : 'Please check the logs to resolve issues before merging.'}`;
+            ${buildStatus === 'success' ? 'Ready for merge and release! 🎉' : 'Please resolve the issues above.'}`;
 
             github.rest.issues.createComment({
               issue_number: context.issue.number,

CHANGELOG.md

@@ -5,32 +5,38 @@ All notable changes to this project will be documented in this file.
 ## [1.2.0] - 2026-02-05
 
 ### Added
+
 - **Standalone Executable**: Added support for building a single, standalone `.exe` (for Windows) or binary (for Linux/macOS) using Node.js SEA (Single Executable Applications). Users can now run the bot without having Node.js installed.
 - **New `/diff` Command**: Added a slash command to view current git changes in the project or active worktree directly from Discord. Supports optional `--staged` flag.
 - **Build System**: Added `scripts/build-sea.js` to automate the process of bundling, SEA blob generation, and binary injection.
 - **Node 24 Support**: Verified compatibility and optimized the codebase for Node.js 24.
 
 ### Changed
+
 - **Modernized Dependencies**: Upgraded `discord.js` to `v14.25.1`, `commander` to `v14.0.3`, and `open` to `v11.0.0`.
 - **Improved SEA Compatibility**: Added runtime shims for `import.meta.url` and `require` to support modern ESM packages in a bundled environment.
 - **Noise Reduction**: Implemented custom warning suppression to silence Node.js SEA-specific native warnings on startup.
 
 ### Fixed
+
 - **Security Hardening**: Fixed a moderate security vulnerability in `undici` (resource exhaustion) by forcing version `^6.23.0` via dependency overrides.
 - **Cleaned Dependencies**: Removed unused `node-pty` dependency to simplify the build process and reduce binary size.
 
 ## [1.1.1] - 2026-02-05
 
 ### Added
+
 - Documentation for `/model` and `/setports` slash commands in README.
 
 ### Security
+
 - **Hardened Server Binding**: All OpenCode server instances are now strictly bound to `127.0.0.1` to prevent unauthorized remote access.
 - **Improved Testing**: Added regression tests for server lifecycle and port management.
 
 ## [1.1.0] - 2026-02-05
 
 ### Added
+
 - **Automated Message Queuing**: Added a new system to queue multiple prompts in a thread. If the bot is busy, new messages are automatically queued and processed sequentially.
 - **Fresh Context Mode**: Each queued job can optionally start with a fresh AI conversation context (new session) while maintaining the same code state.
 - **Queue Management**: New `/queue` slash command suite to list, clear, pause, resume, and configure queue settings.
@@ -40,15 +46,18 @@ All notable changes to this project will be documented in this file.
 - **Visual Feedback**: The bot now reacts with `📥` when a message is successfully queued via chat.
 
 ### Changed
+
 - **Refactored Execution Logic**: Moved core prompt execution to a dedicated `executionService` for better reliability and code reuse.
 
 ## [1.0.11] - 2026-02-04
 
 ### Added
+
 - Model confirmation in Discord messages: The bot now displays which model is being used when starting a session.
 - Real-time logging: Added always-on logging for `opencode serve` startup commands, working directories, and process output (stdout/stderr) for easier debugging.
 
 ### Fixed
+
 - Fixed `opencode serve` startup failures: The bot now correctly detects when the server fails to start immediately and reports the actual error message to Discord instead of timing out after 30 seconds.
 - Resolved `--model` flag error: Moved model selection from the `opencode serve` command (where it was unsupported) to the prompt API.
 - Fixed Model API format: Correctly formatted model identifiers as objects (`{ providerID, modelID }`) as required by the OpenCode API.
@@ -59,9 +68,11 @@ All notable changes to this project will be documented in this file.
 ## [1.0.10] - 2026-02-04
 
 ### Added
+
 - New `/setports` slash command to configure the port range for OpenCode server instances.
 
 ### Fixed
+
 - Fixed Windows-specific spawning issue where the bot failed to find the `opencode` command (now targeting `opencode.cmd`).
 - Resolved `spawn EINVAL` errors on Windows by correctly configuring shell execution.
 - Fixed a crash where the bot would attempt to pass an unsupported `--model` flag to `opencode serve`.
@@ -72,11 +83,13 @@ All notable changes to this project will be documented in this file.
 ## [1.0.9] - 2026-02-04
 
 ### Added
+
 - New `/model` slash command to list and set AI models per channel.
 - Support for `--model` flag in OpenCode server instances.
 - Persistent storage for channel-specific model preferences.
 
 ### Fixed
+
 - Fixed a connection timeout issue where the bot failed to connect to the internal `opencode serve` process.
 - Added `--hostname 0.0.0.0` to the `opencode serve` command to ensure the service is reachable.
 - Standardized internal communication to use `127.0.0.1` instead of `localhost` to avoid IPv6 resolution conflicts on some systems.