ccf
diff --git a/‎.github/workflows/website.yml‎
Lines changed: 52 additions & 0 deletions b/‎.github/workflows/website.yml‎
Lines changed: 52 additions & 0 deletions
diff --git a/‎alembic/versions/a1b2c3d4e5f6_add_agent_type_rename_claude_fields.py‎
Lines changed: 60 additions & 0 deletions b/‎alembic/versions/a1b2c3d4e5f6_add_agent_type_rename_claude_fields.py‎
Lines changed: 60 additions & 0 deletions
diff --git a/‎brand/tokens.css‎
Lines changed: 25 additions & 0 deletions b/‎brand/tokens.css‎
Lines changed: 25 additions & 0 deletions
diff --git a/‎docs/plans/installation-simplification.md‎
Lines changed: 169 additions & 0 deletions b/‎docs/plans/installation-simplification.md‎
Lines changed: 169 additions & 0 deletions
@@ -0,0 +1,52 @@
+name: Deploy Website
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "website/**"
+      - "brand/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: website/package-lock.json
+
+      - name: Install dependencies
+        run: cd website && npm ci
+
+      - name: Build website
+        run: cd website && npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: website/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
@@ -0,0 +1,60 @@
+"""add agent_type, rename claude_version and claude_helpfulness
+
+Revision ID: a1b2c3d4e5f6
+Revises: 7dda515efd1d
+Create Date: 2026-02-27 00:00:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "a1b2c3d4e5f6"
+down_revision: Union[str, None] = "7dda515efd1d"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # --- sessions table ---
+    with op.batch_alter_table("sessions") as batch_op:
+        batch_op.add_column(
+            sa.Column("agent_type", sa.String(30), nullable=False, server_default="claude_code")
+        )
+        batch_op.alter_column("claude_version", new_column_name="agent_version")
+        batch_op.create_index("ix_sessions_agent_type", ["agent_type"])
+
+    # --- session_facets table ---
+    with op.batch_alter_table("session_facets") as batch_op:
+        batch_op.alter_column("claude_helpfulness", new_column_name="agent_helpfulness")
+
+    # --- daily_stats table ---
+    with op.batch_alter_table("daily_stats") as batch_op:
+        batch_op.add_column(
+            sa.Column("agent_type", sa.String(30), nullable=False, server_default="claude_code")
+        )
+        batch_op.drop_constraint("uq_daily_stats_engineer_date")
+        batch_op.create_unique_constraint(
+            "uq_daily_stats_engineer_date", ["engineer_id", "date", "agent_type"]
+        )
+
+
+def downgrade() -> None:
+    # --- daily_stats table ---
+    with op.batch_alter_table("daily_stats") as batch_op:
+        batch_op.drop_constraint("uq_daily_stats_engineer_date")
+        batch_op.create_unique_constraint("uq_daily_stats_engineer_date", ["engineer_id", "date"])
+        batch_op.drop_column("agent_type")
+
+    # --- session_facets table ---
+    with op.batch_alter_table("session_facets") as batch_op:
+        batch_op.alter_column("agent_helpfulness", new_column_name="claude_helpfulness")
+
+    # --- sessions table ---
+    with op.batch_alter_table("sessions") as batch_op:
+        batch_op.drop_index("ix_sessions_agent_type")
+        batch_op.alter_column("agent_version", new_column_name="claude_version")
+        batch_op.drop_column("agent_type")
@@ -0,0 +1,25 @@
+/* Primer Design Tokens — shared across website/ and frontend/ */
+:root {
+  /* Brand */
+  --primer-brand: #6366F1;
+  --primer-foreground: #4338CA;
+  --primer-surface: #EEF2FF;
+  --primer-border: #C7D2FE;
+  --primer-dark: #0F0B2A;
+
+  /* Extended Palette */
+  --primer-50: #EEF2FF;
+  --primer-100: #E0E7FF;
+  --primer-200: #C7D2FE;
+  --primer-400: #818CF8;
+  --primer-500: #6366F1;
+  --primer-600: #4F46E5;
+  --primer-700: #4338CA;
+  --primer-900: #312E81;
+
+  /* Semantic */
+  --primer-success: #16A34A;
+  --primer-warning: #D97706;
+  --primer-critical: #DC2626;
+  --primer-info: #2563EB;
+}
@@ -0,0 +1,169 @@
+# Installation Simplification Plan
+
+## Context
+Primer currently requires ~8 manual steps across Python, Node.js, and shell. This plan introduces a `primer` CLI, a `curl | sh` installer for personal use, and enhanced Docker/Helm for enterprise.
+
+## Current Pain Points
+- No single entry point or CLI — everything is `python -m`, `python scripts/`, or raw curl
+- No `[project.scripts]` in pyproject.toml
+- No daemonization (server runs in foreground terminal)
+- Frontend requires Node.js + separate dev server
+- Docker Compose is minimal (no frontend, no health checks)
+- No Helm chart
+- MCP registration and API key distribution are manual
+
+## 1. Unified `primer` CLI
+
+### Entry Point
+```toml
+# pyproject.toml
+[project.scripts]
+primer = "primer.cli:main"
+```
+
+### Command Tree
+```
+primer init                    # Create ~/.primer/, run migrations, generate config
+primer setup                   # Create identity (name, email from git config)
+primer server start [--fg]     # Start server (background default, foreground for Docker)
+primer server stop             # Stop background server
+primer server status           # Show running state, port, uptime
+primer server logs             # Tail server logs
+primer hook install            # Install SessionEnd hook in Claude Code
+primer hook uninstall          # Remove hook
+primer hook status             # Check hook configuration
+primer mcp install             # Register MCP sidecar
+primer mcp uninstall           # Remove MCP registration
+primer mcp serve               # Run MCP server (used by the registration)
+primer sync                    # Sync local sessions to server
+primer doctor                  # Diagnose issues (connectivity, hook, MCP)
+primer version                 # Show version
+primer configure [set|get]     # View/edit config
+```
+
+### Config Precedence
+1. CLI flags → 2. Environment variables → 3. `~/.primer/config.toml` → 4. PrimerSettings defaults
+
+### Data Directory
+```
+~/.primer/
+  config.toml          # API keys, server URL, port
+  primer.db            # SQLite database
+  frontend-dist/       # Pre-built React app
+  logs/server.log      # Server output
+  server.pid           # PID file for background server
+```
+
+### Server Management
+- macOS: launchd plist at `~/Library/LaunchAgents/dev.primer.server.plist`
+- Linux: systemd user unit at `~/.config/systemd/user/primer.service`
+- Fallback: `nohup` + PID file
+
+## 2. Personal Use: `curl | sh` Installer
+
+```bash
+curl -fsSL https://primer.dev/install.sh | sh
+```
+
+### Steps
+1. **Detect environment**: OS, arch, Python 3.12+, pipx
+2. **Install package**: `pipx install primer` (or `pip install --user`)
+3. **Initialize**: `primer init` — creates ~/.primer/, runs Alembic, generates keys
+4. **Setup identity**: `primer setup --auto` — reads name/email from `git config`
+5. **Install hook**: `primer hook install` — writes to `~/.claude/settings.json`
+6. **Register MCP**: `primer mcp install` — adds MCP sidecar entry
+7. **Download frontend**: Pre-built tarball from GitHub release → `~/.primer/frontend-dist/`
+8. **Start server**: Create launchd plist or systemd unit, start service
+9. **Verify**: Health check + print summary with URLs and key location
+
+### Config File
+```toml
+[server]
+host = "127.0.0.1"
+port = 8000
+database_url = "sqlite:///~/.primer/primer.db"
+admin_api_key = "primer-admin-xxxxxxxx"
+
+[identity]
+api_key = "primer_xxxxxxxx"
+name = "Your Name"
+email = "you@example.com"
+```
+
+## 3. Enterprise: Docker Compose
+
+### New `Dockerfile.frontend`
+Multi-stage: `node:20-alpine` build → `nginx:alpine` serve
+
+### Enhanced `docker-compose.yml`
+- PostgreSQL with health check
+- Server with health check + required env var validation (`${VAR:?message}`)
+- Frontend container (nginx)
+- `.env.docker.example` template
+
+### Enterprise Setup Script
+```bash
+curl -fsSL https://primer.dev/enterprise-setup.sh | sh
+```
+Checks Docker, prompts for PostgreSQL, generates keys, writes .env, runs `docker compose up -d`.
+
+## 4. Enterprise: Kubernetes / Helm
+
+### Chart Structure
+```
+deploy/helm/primer/
+  Chart.yaml, values.yaml
+  templates/
+    deployment-server.yaml    # With HPA
+    deployment-frontend.yaml
+    service-*.yaml
+    ingress.yaml              # With TLS
+    configmap.yaml, secret.yaml
+    migration-job.yaml        # Helm pre-install/pre-upgrade hook
+    hpa.yaml, pdb.yaml
+```
+
+### Key values.yaml
+- Server: 2 replicas, autoscaling 2-10 at 70% CPU
+- External PostgreSQL recommended (with `existingSecret` support)
+- Ingress with TLS
+- Migration job runs before server starts
+
+## 5. Code Changes Required
+
+### `pyproject.toml`
+- Add `[project.scripts]` entry
+- Use `tomllib` (stdlib in 3.12+) for config parsing
+
+### `src/primer/common/config.py`
+- Read `~/.primer/config.toml` as fallback
+- Add `data_dir` property
+
+### `src/primer/server/app.py`
+- Check `~/.primer/frontend-dist/` as fallback for static files
+- Log configuration on startup
+
+### `scripts/install_hook.py`
+- Refactor core logic into `src/primer/hook/installer.py`
+- Script becomes thin wrapper
+
+### `Dockerfile.server`
+- Add `HEALTHCHECK`
+- Use `primer server start --fg` as entry point
+
+## Implementation Sequence
+
+| Phase | Work |
+|---|---|
+| **1** | `primer` CLI core — init, setup, server, hook, mcp, sync, doctor |
+| **2** | `install.sh` script — OS detection, pipx install, launchd/systemd |
+| **3** | Docker improvements — frontend Dockerfile, compose health checks, .env |
+| **4** | Helm chart — deployments, ingress, migration job, HPA |
+| **5** | Documentation — getting-started, deployment, CLI reference |
+
+## Risks
+- PyPI publication needed for `pipx install primer`
+- Pre-built frontend requires CI release pipeline
+- Port 8000 conflicts — auto-detect free port
+- Python 3.12+ requirement — document pyenv/brew install
+- Database migrations on upgrade — `primer server start` should auto-migrate