feat: Add browser-based VS Code extension preview environment

.dockerignore

@@ -0,0 +1,34 @@
+# Dockerfile.preview build context exclusions
+# Heroku builds from git, but these further reduce context size
+
+# Version control
+.git
+.github
+
+# Development environments
+.venv
+.pytest_cache
+.specify
+.claude
+.vscode
+
+# Local node_modules (rebuilt inside Docker)
+node_modules
+**/node_modules
+
+# Build artifacts (rebuilt inside Docker)
+**/dist
+**/*.vsix
+
+# Documentation not needed at runtime
+docs
+specs
+*.md
+!preview/workspace/WELCOME.md
+
+# Test files
+**/__tests__
+**/*.test.*
+**/*.spec.*
+**/playwright-report
+**/test-results

Dockerfile.preview

@@ -0,0 +1,90 @@
+# Browser-based VS Code Extension Preview
+# Runs code-server with the Debrief extension and sample data pre-installed.
+#
+# Build: docker build -t debrief-preview -f Dockerfile.preview .
+# Run:   docker run -p 8080:8080 -e PORT=8080 debrief-preview
+#
+# Heroku Review Apps: heroku.yml points here. Heroku sets $PORT automatically.
+
+# ---------------------------------------------------------------------------
+# Stage 1: Build the VS Code extension .vsix from source
+# ---------------------------------------------------------------------------
+FROM node:20-slim AS vsix-builder
+
+RUN npm install -g pnpm@9
+
+WORKDIR /build
+
+# Copy workspace config and all source upfront
+# (Heroku has no Docker layer cache, so separate COPY-for-cache is pointless)
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY shared/schemas/ ./shared/schemas/
+COPY shared/components/ ./shared/components/
+COPY shared/utils/ ./shared/utils/
+COPY shared/config-ts/package.json ./shared/config-ts/
+COPY services/session-state/ ./services/session-state/
+COPY apps/vscode/ ./apps/vscode/
+COPY apps/loader/package.json ./apps/loader/
+COPY apps/web-shell/package.json ./apps/web-shell/
+
+# Install, build, package, then delete node_modules — all in ONE layer.
+# Docker commits layer diffs: creating + deleting node_modules in the same
+# RUN means Docker never snapshots the ~500MB node_modules directory.
+# This prevents OOM on Heroku's constrained build dynos.
+RUN pnpm install --filter debrief-vscode... --no-frozen-lockfile && \
+    pnpm --filter debrief-vscode... build && \
+    cd apps/vscode && npx @vscode/vsce package --no-dependencies && \
+    cd /build && \
+    rm -rf node_modules
+
+# ---------------------------------------------------------------------------
+# Stage 2: Final image with code-server + Python services + extension
+# ---------------------------------------------------------------------------
+FROM codercom/code-server:latest
+
+USER root
+
+# Install Python 3.11 and system dependencies for Debrief services
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3.11 \
+    python3.11-venv \
+    python3-pip \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv for Python package management
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:$PATH"
+
+# Copy Python service sources
+COPY services/io /workspace/services/io
+COPY services/stac /workspace/services/stac
+COPY services/calc /workspace/services/calc
+COPY shared/schemas /workspace/shared/schemas
+
+# Install Python services in a virtual environment
+WORKDIR /workspace
+RUN uv venv /opt/debrief-venv && \
+    VIRTUAL_ENV=/opt/debrief-venv uv pip install \
+    ./shared/schemas \
+    ./services/io \
+    ./services/stac \
+    ./services/calc
+ENV PATH="/opt/debrief-venv/bin:$PATH"
+
+# Copy preview workspace with sample data
+COPY preview/workspace /workspace/preview
+COPY preview/entrypoint.sh /opt/entrypoint.sh
+RUN chmod +x /opt/entrypoint.sh
+
+# Keep the .vsix in the image — the entrypoint installs it at runtime.
+# code-server's --install-extension at build time writes to extensions.json,
+# but this manifest can be lost at runtime (known issue: coder/code-server#7326).
+# Installing at container startup guarantees the extensions.json is fresh.
+USER coder
+COPY --chown=coder:coder --from=vsix-builder /build/apps/vscode/*.vsix /opt/debrief.vsix
+
+ENV PORT=8080
+EXPOSE 8080
+
+ENTRYPOINT ["/opt/entrypoint.sh"]

Taskfile.yml

@@ -93,6 +93,28 @@ tasks:
       - task: lint
       - task: test
 
+  preview:build:
+    desc: "Build the preview container (code-server + Debrief extension)"
+    preconditions:
+      - sh: command -v docker
+        msg: "Docker not found. Install Docker to build the preview container."
+    cmds:
+      - docker build -t debrief-preview -f Dockerfile.preview .
+
+  preview:run:
+    desc: "Run the preview container locally (http://localhost:8080)"
+    preconditions:
+      - sh: docker image inspect debrief-preview >/dev/null 2>&1
+        msg: "Preview image not built. Run 'task preview:build' first."
+    cmds:
+      - docker run --rm -p 8080:8080 -e PORT=8080 debrief-preview
+
+  preview:package:
+    desc: "Package the VS Code extension as .vsix"
+    deps: [build]
+    cmds:
+      - cd apps/vscode && npx vsce package --no-dependencies
+
   clean:
     desc: "Remove build artifacts and caches"
     cmds:

app.json

@@ -0,0 +1,17 @@
+{
+  "name": "debrief-preview",
+  "description": "Browser-based VS Code extension preview for Debrief PRs",
+  "stack": "container",
+  "formation": {
+    "web": {
+      "quantity": 1,
+      "size": "basic"
+    }
+  },
+  "environments": {
+    "review": {
+      "scripts": {},
+      "addons": []
+    }
+  }
+}

apps/vscode/.vscodeignore

@@ -0,0 +1,12 @@
+.vscode/**
+src/**
+e2e/**
+**/*.test.ts
+**/*.spec.ts
+tsconfig.json
+vitest.config.ts
+playwright.config.ts
+.eslintrc.*
+.prettierrc*
+CHANGELOG.md
+node_modules/**

apps/vscode/package.json

@@ -24,6 +24,7 @@
     "directory": "apps/vscode"
   },
   "activationEvents": [
+    "onStartupFinished",
     "onFileSystem:stac",
     "onView:debrief.stacExplorer",
     "onCommand:debrief.openPlot"