feat: Add Docker support and GitHub Container Registry CI/CD

.dockerignore

@@ -0,0 +1,49 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build artifacts
+lib/
+*.tsbuildinfo
+
+# Tests
+tests/
+coverage/
+*.test.js
+*.test.ts
+
+# Documentation
+docs/
+*.md
+!README.md
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# CI/CD
+.github/
+.travis.yml
+.gitlab-ci.yml
+
+# Misc
+.DS_Store
+.env
+.env.*
+*.log
+tmp/
+temp/
+.cache/
+
+# Claude Code specific (not needed in container)
+.claude/

.github/workflows/docker-build-push.yml

@@ -0,0 +1,102 @@
+name: Build and Push Docker Image to GHCR
+
+on:
+  push:
+    branches:
+      - main
+      - master
+      - 'claude/**'
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            # Tag with version for release tags
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            # Tag with branch name
+            type=ref,event=branch
+            # Tag with PR number for pull requests
+            type=ref,event=pr
+            # Tag with 'latest' for main/master branch
+            type=raw,value=latest,enable={{is_default_branch}}
+            # Tag with git sha
+            type=sha,prefix={{branch}}-
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          build-args: |
+            BUILD_DATE=${{ github.event.head_commit.timestamp }}
+            VCS_REF=${{ github.sha }}
+            VERSION=${{ steps.meta.outputs.version }}
+
+      - name: Generate artifact attestation
+        if: github.event_name != 'pull_request'
+        uses: actions/attest-build-provenance@v1
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          subject-digest: ${{ steps.build.outputs.digest }}
+          push-to-registry: true
+
+      - name: Output image details
+        if: github.event_name != 'pull_request'
+        run: |
+          echo "### Docker Image Published :rocket:" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Registry:** \`${{ env.REGISTRY }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "**Image:** \`${{ env.IMAGE_NAME }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Tags:**" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+          echo "${{ steps.meta.outputs.tags }}" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Pull command:**" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "docker pull ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY

Dockerfile

@@ -0,0 +1,65 @@
+# Multi-stage build for flashbacker MCP server
+# Stage 1: Build
+FROM node:22-alpine AS builder
+
+# Install build dependencies
+RUN apk add --no-cache python3 make g++ git
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies (including dev dependencies for build)
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Build TypeScript and copy templates
+RUN npm run build
+
+# Stage 2: Runtime
+FROM node:22-alpine
+
+# Install runtime dependencies only
+RUN apk add --no-cache git
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install production dependencies only
+RUN npm ci --only=production
+
+# Copy built files from builder stage
+COPY --from=builder /app/lib ./lib
+COPY --from=builder /app/bin ./bin
+COPY --from=builder /app/templates ./templates
+COPY README.md ./
+
+# Create a non-root user
+RUN addgroup -g 1001 flashback && \
+    adduser -D -u 1001 -G flashback flashback && \
+    chown -R flashback:flashback /app
+
+# Switch to non-root user
+USER flashback
+
+# Make the CLI executable globally available
+ENV PATH="/app/bin:${PATH}"
+
+# Set up entrypoint
+ENTRYPOINT ["node", "/app/lib/cli.js"]
+
+# Default command (shows help)
+CMD ["--help"]
+
+# Labels for container metadata
+LABEL org.opencontainers.image.title="Flashbacker"
+LABEL org.opencontainers.image.description="Claude Code state management with session continuity and AI personas"
+LABEL org.opencontainers.image.source="https://github.com/agentsea/flashbacker"
+LABEL org.opencontainers.image.licenses="MIT"

docker-compose.yml

@@ -0,0 +1,59 @@
+version: '3.8'
+
+services:
+  flashbacker:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: ghcr.io/agentsea/flashbacker:latest
+    container_name: flashbacker-mcp
+    volumes:
+      # Mount your project directory to work with flashback commands
+      - ./:/workspace
+    working_dir: /workspace
+    # Override entrypoint to keep container running for interactive use
+    entrypoint: ["/bin/sh"]
+    stdin_open: true
+    tty: true
+    environment:
+      # Set any environment variables needed
+      - NODE_ENV=production
+    networks:
+      - flashback-network
+
+  # Example: Using flashbacker with an MCP server setup
+  flashbacker-mcp-server:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: ghcr.io/agentsea/flashbacker:latest
+    container_name: flashbacker-mcp-stdio
+    volumes:
+      - ./:/workspace
+    working_dir: /workspace
+    # For MCP server mode, you'd typically run a specific command
+    # This is a placeholder - adjust based on your MCP server implementation
+    command: ["--version"]
+    stdin_open: true
+    tty: true
+    networks:
+      - flashback-network
+
+networks:
+  flashback-network:
+    driver: bridge
+
+# Usage examples:
+#
+# 1. Build the image:
+#    docker-compose build
+#
+# 2. Run flashback commands:
+#    docker-compose run --rm flashbacker flashback --version
+#    docker-compose run --rm flashbacker flashback init --mcp
+#
+# 3. Interactive shell in container:
+#    docker-compose run --rm flashbacker /bin/sh
+#
+# 4. Start MCP server (adjust command as needed):
+#    docker-compose up flashbacker-mcp-server