Merge pull request #65 from AnExiledDev/staging

Release v2.1.0

Author: AnExiledDev

.github/workflows/ci.yml

@@ -3,10 +3,10 @@ name: CI
 on:
   push:
     branches: [main, staging]
-    paths: ['container/**', 'cli/**']
+    paths: ['container/**', 'cli/**', 'dashboard/**']
   pull_request:
     branches: [main, staging]
-    paths: ['container/**', 'cli/**']
+    paths: ['container/**', 'cli/**', 'dashboard/**']
 
 jobs:
   test:
@@ -52,3 +52,13 @@ jobs:
         working-directory: cli
       - run: bun test
         working-directory: cli
+
+  test-dashboard:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+        working-directory: dashboard
+      - run: bun test
+        working-directory: dashboard

.github/workflows/release-dashboard.yml

@@ -0,0 +1,75 @@
+name: Release Dashboard
+
+on:
+  push:
+    tags: ['dashboard-v*']
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.extract.outputs.version }}
+    steps:
+      - uses: actions/checkout@v6
+      - id: extract
+        name: Extract and validate version
+        run: |
+          TAG="${GITHUB_REF#refs/tags/dashboard-v}"
+          PKG=$(node -p "require('./dashboard/package.json').version")
+          echo "version=$TAG" >> "$GITHUB_OUTPUT"
+          if [ "$TAG" != "$PKG" ]; then
+            echo "::error::Tag dashboard-v${TAG} does not match dashboard/package.json version ${PKG}"
+            exit 1
+          fi
+
+  publish-and-release:
+    needs: validate
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+        working-directory: dashboard
+
+      - name: Run tests
+        run: bun test
+        working-directory: dashboard
+
+      - name: Build SPA
+        run: bun run build
+        working-directory: dashboard
+
+      - name: Verify package contents
+        run: npm pack --dry-run
+        working-directory: dashboard
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 18
+          registry-url: https://registry.npmjs.org
+
+      - name: Publish to npm
+        run: npm publish
+        working-directory: dashboard
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Extract changelog section
+        id: changelog
+        run: |
+          VERSION="${{ needs.validate.outputs.version }}"
+          NOTES=$(sed -n "/^## v${VERSION}/,/^## v/{ /^## v${VERSION}/d; /^## v/d; p; }" dashboard/CHANGELOG.md)
+          [ -z "$NOTES" ] && NOTES="Dashboard Release v${VERSION}"
+          echo "$NOTES" > /tmp/release-notes.md
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="dashboard-v${{ needs.validate.outputs.version }}"
+          gh release create "$VERSION" --title "$VERSION" --notes-file /tmp/release-notes.md

.gitignore

@@ -49,11 +49,22 @@ container/.devcontainer/**/*.codeforge-new
 container/.devcontainer/**/*.bak
 container/.devcontainer/.codeforge-preserve
 
+# Specs (local working directory)
+.specs/
+
+# Claude Code local state
+.claude/
+
 # CLI-specific
 cli/.pytest_cache/
 cli/.ruff_cache/
 .codeforge/data/
 
+# Dashboard-specific
+dashboard/.svelte-kit/
+dashboard/build/
+dashboard/mockups/
+
 # Docs-specific
 docs/.astro/
 

CLAUDE.md

@@ -1,6 +1,6 @@
 # CodeForge Monorepo
 
-This repository contains three packages. Each package manages its own dependencies independently.
+This repository contains four packages. Each package manages its own dependencies independently.
 
 ## Packages
 
@@ -9,6 +9,7 @@ This repository contains three packages. Each package manages its own dependenci
 | `container/` | Node.js | npm |
 | `cli/` | Bun | bun |
 | `docs/` | Node.js | npm |
+| `dashboard/` | Bun | npm (frontend) / bun (server) |
 
 ## Development Rules
 
@@ -26,6 +27,7 @@ Each package has its own `CLAUDE.md` with package-specific development rules:
 - [`container/CLAUDE.md`](container/CLAUDE.md) — changelog, documentation, and configuration rules for the devcontainer package
 - `cli/` — Bun/TypeScript CLI; run `bun test` for tests
 - `docs/` — Astro/Starlight site; run `npm run build` to verify
+- [`dashboard/CLAUDE.md`](dashboard/CLAUDE.md) | [`dashboard/README.md`](dashboard/README.md) — Svelte 5 SPA + Bun backend for session analytics
 
 ### Cross-Package Changes
 
@@ -39,3 +41,21 @@ Run tests for each affected package before committing:
 - **Container**: `cd container && npm test`
 - **CLI**: `cd cli && bun test`
 - **Docs**: `cd docs && npm run build`
+- **Dashboard**: `cd dashboard && bun test`
+
+### Dashboard vs CLI
+
+The `dashboard/` and `cli/` packages serve different audiences:
+
+- **CLI** (`codeforge` command) — terminal-first, text/JSON output, scriptable,
+  runs inside or outside the container. Features: session search, task search/list/show,
+  plan search, plugin management, index/config commands.
+- **Dashboard** (Svelte 5 SPA) — visual analytics, charts, expandable detail views,
+  real-time SSE updates. Features: session browsing with conversation replay,
+  task/plan/agent/memory views, project analytics, cost tracking.
+
+When adding a new data view:
+- If it's browsable/visual (tables, charts, detail drill-down) → dashboard
+- If it's scriptable/automatable (piped output, filters, JSON) → CLI
+- If it's both → implement in both, but don't import CLI as a dashboard dependency.
+  Fork patterns instead.

README.md

@@ -8,6 +8,7 @@ Monorepo for CodeForge — an AI-powered development environment for Claude Code
 |---------|-------------|---------|
 | [`container/`](container/) | CodeForge DevContainer (`codeforge-dev` on npm) | 2.0.0 |
 | [`cli/`](cli/) | CodeForge CLI (`codeforge-cli`) | 0.1.0 |
+| [`dashboard/`](dashboard/) | Session analytics dashboard (Svelte 5 SPA + Bun backend) | — |
 | [`docs/`](docs/) | Documentation site ([codeforge.core-directive.com](https://codeforge.core-directive.com)) | — |
 
 ## Quick Start
@@ -30,6 +31,9 @@ cd container && npm test
 # CLI (Bun)
 cd cli && bun test
 
+# Dashboard (Bun)
+cd dashboard && bun test
+
 # Docs (npm)
 cd docs && npm run build
 ```

cli/README.md

@@ -0,0 +1,99 @@
+# CodeForge CLI
+
+CLI for CodeForge development workflows. Manages sessions, plugins, configuration, codebase indexing, and devcontainers.
+
+> **Experimental** — v0.1.0. Ships with CodeForge v2.1.1.
+
+## Install
+
+```bash
+npm install -g codeforge-dev-cli
+```
+
+Requires [Bun](https://bun.sh) runtime.
+
+## Usage
+
+```bash
+codeforge <command> [options]
+```
+
+### Global Options
+
+| Flag | Description |
+|------|-------------|
+| `--local` | Run against the host filesystem (skip container proxy) |
+| `--container <name>` | Target a specific container by name |
+
+When run outside a devcontainer, commands auto-proxy into the running CodeForge container. Use `--local` to bypass.
+
+## Commands
+
+### `codeforge session` — Session History
+
+```bash
+codeforge session search "query"       # Search session history
+codeforge session list                  # List recent sessions
+codeforge session show <id>             # Show session details
+```
+
+### `codeforge task` — Task Management
+
+```bash
+codeforge task search "query"           # Search tasks across sessions
+codeforge task list                     # List tasks
+codeforge task show <id>                # Show task details
+```
+
+### `codeforge plan` — Plan Search
+
+```bash
+codeforge plan search "query"           # Search plans across sessions
+```
+
+### `codeforge plugin` — Plugin Management
+
+```bash
+codeforge plugin list                   # List installed plugins
+codeforge plugin show <name>            # Show plugin details
+codeforge plugin enable <name>          # Enable a plugin
+codeforge plugin disable <name>         # Disable a plugin
+codeforge plugin hooks [name]           # Show hooks (all or per-plugin)
+codeforge plugin agents [name]          # Show agents (all or per-plugin)
+codeforge plugin skills [name]          # Show skills (all or per-plugin)
+```
+
+### `codeforge config` — Configuration
+
+```bash
+codeforge config show                   # Show current configuration
+codeforge config apply                  # Deploy config files to ~/.claude/
+```
+
+### `codeforge index` — Codebase Index
+
+```bash
+codeforge index build                   # Build symbol index for current project
+codeforge index search "query"          # Search the symbol index
+codeforge index show <symbol>           # Show symbol details
+codeforge index stats                   # Index statistics
+codeforge index tree                    # Symbol tree view
+codeforge index clean                   # Remove index data
+```
+
+### `codeforge container` — Devcontainer Management
+
+These commands always run on the host (never proxied).
+
+```bash
+codeforge container up                  # Start the devcontainer
+codeforge container down                # Stop the devcontainer
+codeforge container rebuild             # Rebuild the devcontainer
+codeforge container exec <cmd>          # Execute a command in the container
+codeforge container ls                  # List running containers
+codeforge container shell               # Open a shell in the container
+```
+
+## License
+
+GPL-3.0 — see [LICENSE](../LICENSE.txt).

cli/bun.lock

@@ -47,7 +47,6 @@
 	"homepage": "https://github.com/AnExiledDev/CodeForge/tree/main/cli#readme",
 	"files": [
 		"dist/",
-		"prompts/",
 		"README.md"
 	],
 	"bugs": {