Add browser Wiki viewer

Author: tae2089

.ccg.yaml

@@ -18,6 +18,8 @@ exclude:
   - ".*\\.pb\\.go$"
   - "bin/.*"
   - "docs/.*"
+  - "web/wiki/dist/.*"
+  - "web/wiki/node_modules/.*"
   - "testdata/.*"
   - ".*\\.gen\\.go$"
   - "scripts/.*"
@@ -48,6 +50,9 @@ rules:
   - pattern: "docs/.*"
     category: orphan
     action: ignore
+  - pattern: "web/wiki/dist/.*"
+    category: orphan
+    action: ignore
   - pattern: "testdata/.*"
     category: orphan
     action: ignore

.dockerignore

@@ -1,11 +1,14 @@
 .git
 *.db
 ccg
+ccg-server
 docs/
 workspaces/
 archive/
 superpowers/
 node_modules/
+**/node_modules/
+web/wiki/dist/
 *.md
 !go.mod
 !go.sum

.github/workflows/ci.yml

@@ -21,12 +21,21 @@ jobs:
         with:
           go-version: '1.25'
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+          cache-dependency-path: web/wiki/package-lock.json
+
       - name: Run go vet
         run: make vet
 
       - name: Build release binaries
         run: make build
 
+      - name: Build Wiki UI
+        run: make wiki-build
+
       - name: Capture go build JSON
         run: make build-json
 

.github/workflows/release.yml

@@ -103,8 +103,37 @@ jobs:
             *.tar.gz
             *.zip
 
+  wiki-dist:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+          cache-dependency-path: web/wiki/package-lock.json
+
+      - name: Build Wiki UI
+        working-directory: web/wiki
+        run: |
+          npm ci
+          npm run build
+
+      - name: Package Wiki UI
+        run: tar czf ccg-wiki-dist.tar.gz -C web/wiki/dist .
+
+      - name: Upload Wiki artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ccg-wiki-dist
+          path: ccg-wiki-dist.tar.gz
+
   release:
-    needs: build
+    needs:
+      - build
+      - wiki-dist
     runs-on: ubuntu-latest
 
     steps:

.gitignore

@@ -1,5 +1,6 @@
 # Binaries
 /ccg
+/ccg-server
 /dogfood
 *.exe
 
@@ -23,3 +24,5 @@ pyproject.toml
 /go-refactoring-design.md
 *.db-shm
 *.db-wal
+/web/wiki/dist/
+/web/wiki/node_modules/

Dockerfile

@@ -1,3 +1,12 @@
+# Wiki UI build stage
+FROM node:22-alpine AS wiki-builder
+
+WORKDIR /src/web/wiki
+COPY web/wiki/package.json web/wiki/package-lock.json ./
+RUN npm ci
+COPY web/wiki/ ./
+RUN npm run build
+
 # Build stage
 FROM golang:1.25-alpine AS builder
 
@@ -22,6 +31,7 @@ RUN apk add --no-cache ca-certificates git \
 
 COPY --from=builder /usr/local/bin/ccg /usr/local/bin/ccg
 COPY --from=builder /usr/local/bin/ccg-server /usr/local/bin/ccg-server
+COPY --from=wiki-builder /src/web/wiki/dist /usr/share/ccg/wiki
 
 WORKDIR /workspace
 USER ccg
@@ -31,4 +41,4 @@ ENV HOME=/home/ccg \
 EXPOSE 8080
 
 ENTRYPOINT ["ccg-server"]
-CMD ["--http-addr", ":8080"]
+CMD ["--http-addr", ":8080", "--wiki-dir", "/usr/share/ccg/wiki"]

Makefile

@@ -3,8 +3,11 @@ COMMIT   ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo unknown)
 DATE     ?= $(shell date -u +%Y-%m-%dT%H:%M:%SZ)
 BASE_LDFLAGS = -X main.version=$(VERSION) -X main.commit=$(COMMIT) -X main.date=$(DATE)
 LDFLAGS      = -s -w $(BASE_LDFLAGS)
+WIKI_ADDR   ?= 127.0.0.1:8080
+WIKI_DB     ?= ccg.db
+WIKI_TOKEN  ?=
 
-.PHONY: build release build-debug build-json install vet test test-integration-helpers clean
+.PHONY: build release build-debug build-json install vet test test-integration-helpers wiki-build wiki-run clean
 
 build: release
 
@@ -32,5 +35,12 @@ test: test-integration-helpers
 test-integration-helpers:
 	bash ./scripts/integration-test-helpers_test.sh
 
+wiki-build:
+	cd web/wiki && npm ci && npm run build
+
+wiki-run: wiki-build
+	CGO_ENABLED=1 go run -tags "fts5" ./cmd/ccg --db-driver sqlite --db-dsn '$(WIKI_DB)' migrate
+	CGO_ENABLED=1 go run -tags "fts5" ./cmd/ccg-server --db-driver sqlite --db-dsn '$(WIKI_DB)' --http-addr '$(WIKI_ADDR)' --http-bearer-token '$(WIKI_TOKEN)' --wiki-dir web/wiki/dist
+
 clean:
 	rm -f ccg ccg-server

README.md

@@ -13,6 +13,7 @@ Inspired by [code-review-graph](https://github.com/tirth8205/code-review-graph)
 - **12 languages**: Go, Python, TypeScript, Java, Ruby, JavaScript, C, C++, Rust, Kotlin, PHP, Lua/Luau
 - **35 MCP tools**: parse, search, impact analysis, flow tracing, dead code detection, postprocess operations, namespace file management, and more
 - **RAG-first code exploration**: generated docs + community structure let LLM agents answer natural-language questions before drilling into exact graph nodes
+- **Browser Wiki UI**: `ccg-server` can serve generated docs, tree search, PageIndex-style retrieval, Context Tray copying, and an Obsidian-style graph viewer
 - **Custom annotations**: `@intent`, `@domainRule`, `@sideEffect`, `@mutates`, `@index` — search code by business context ([details](guide/annotations.md))
 - **Webhook sync**: GitHub / Gitea push events → auto clone + build with per-repo branch filtering and `.ccg.yaml` `include_paths` auto-loading ([details](guide/webhook.md))
 - **Eval**: Golden corpus-based parser accuracy (P/R/F1) and search quality (P@K, MRR, nDCG) evaluation ([details](guide/eval.md))
@@ -68,6 +69,9 @@ ccg search "payment"    # finds functions with @intent/@domainRule about payment
 # Build docs and the default vectorless RAG index for agent-oriented exploration
 ccg docs --out docs
 
+# Serve the browser Wiki UI from built assets
+make wiki-run
+
 # Graph statistics
 ccg status
 
@@ -85,10 +89,12 @@ ccg eval --suite parser
 ccg eval --suite parser --update
 ```
 
-`ccg docs` refreshes community structure and writes `.ccg/doc-index.json` by
-default. Use `--rag=false` when you only want Markdown, or
-`--rag-refresh=false` when you want to rebuild the index from existing community
-rows without recalculating communities.
+`ccg docs` writes generated Markdown plus `.ccg/wiki-index.json` for the browser
+Wiki. By default it also refreshes community structure and writes
+`.ccg/doc-index.json` for vectorless RAG retrieval. Use `--rag=false` when you
+only want Markdown and the Wiki index, or `--rag-refresh=false` when you want to
+rebuild the RAG index from existing community rows without recalculating
+communities.
 
 For LLM agents, treat generated docs and the RAG index as the primary entrypoint
 for natural-language questions such as "how does webhook sync work?" or "where
@@ -103,6 +109,37 @@ also applies when upgrading CCG against an existing default `ccg.db` created by
 an older version. See the [CLI Reference](guide/cli-reference.md) for the full
 migration contract.
 
+## Browser Wiki
+
+`ccg-server` can serve a React-based Wiki UI at `/wiki` when `--wiki-dir` points
+at a built `web/wiki/dist` directory. Docker images include that built UI at
+`/usr/share/ccg/wiki`; standalone binaries keep the assets separate so binary
+size stays small.
+
+The Wiki is meant for developers and agents inspecting a generated codebase:
+
+- Tree navigation over folders, packages, files, and annotated symbols
+- Keyword search and PageIndex-style `retrieve_docs` over `doc-index.json`
+- Rich symbol detail cards from CCG annotations even when a symbol has no
+  generated Markdown file
+- Context Tray for collecting files and doc-less symbols into one Markdown
+  bundle that can be copied into another LLM tool
+- Graph tab backed by `/wiki/api/graph`, showing namespace nodes and edges with
+  filters for structure, calls, imports, types, and symbols
+
+Local development shortcut:
+
+```bash
+ccg build .
+ccg docs --out docs
+make wiki-run
+```
+
+For self-hosted deployments, run `ccg-server --wiki-dir <dist-dir>` and protect
+`/wiki/api/*` with the same bearer token policy used for `/mcp`. See
+[Docker](guide/docker.md#wiki-ui) and [Runtime Layout](guide/runtime-layout.md)
+for deployment details.
+
 ## Demo
 
 Actual output from CCG parsing its own codebase.
@@ -201,7 +238,8 @@ Add `.mcp.json` to your project:
 
 For remote HTTP mode:
 
-Run the self-hosted server with `ccg-server` and connect to `/mcp`:
+Run the self-hosted server with `ccg-server` and connect to `/mcp`. The same
+server can also expose `/wiki` when `--wiki-dir` is configured:
 
 ```json
 {
@@ -226,11 +264,11 @@ Source Code → Tree-sitter Parser → Nodes + Edges + Annotations
                                         ↓
                                    FTS Search
                                         ↓
-                         ccg serve          ccg-server
-                         stdio MCP       Streamable HTTP
-                            ↓             ↓          ↑
-                     Coding Agents   Remote Clients  GitHub / Gitea Webhook
-                                             push → clone → build → DB
+                         ccg serve                ccg-server
+                         stdio MCP        Streamable HTTP + Wiki UI
+                            ↓              ↓          ↓          ↑
+                     Coding Agents   Remote Clients  Browser   GitHub / Gitea Webhook
+                                                       Wiki      push → clone → build → DB
 ```
 
 See [Architecture Details](guide/architecture.md) for component breakdown and DB schema.
@@ -246,10 +284,10 @@ See [Architecture Details](guide/architecture.md) for component breakdown and DB
 | [MCP Tools](guide/mcp-tools.md) | 35 MCP tools, agent skills, AI-Driven Annotation |
 | [Annotations](guide/annotations.md) | Annotation system — tags, examples, search |
 | [Webhook](guide/webhook.md) | Webhook sync, branch filtering, HMAC, graceful shutdown |
-| [Docker](guide/docker.md) | Docker build, MCP server, PostgreSQL deployment |
+| [Docker](guide/docker.md) | Docker build, MCP server, Wiki UI, PostgreSQL deployment |
 | [Operations](guide/operations.md) | Deployment profiles, database choice, readiness, webhook operations |
 | [Postprocess Failure Policy](guide/postprocess-failure-policy.md) | Status rules, failure causes, and automatic degraded/fail_closed policy for build and postprocess tools |
-| [Runtime Layout](guide/runtime-layout.md) | `ccg`, `ccg-server`, and shared `ccg-core` ownership boundaries |
+| [Runtime Layout](guide/runtime-layout.md) | `ccg`, `ccg-server`, Wiki serving, and shared `ccg-core` ownership boundaries |
 | [Development](guide/development.md) | Dev guide, integration test, project structure |
 | [Namespace Migration](guide/namespace-migration.md) | Default namespace change and migration guide |
 | [Architecture](guide/architecture.md) | Data flow, components, DB schema |

cmd/ccg-server/main.go

@@ -133,6 +133,7 @@ func newRootCmd(rt *core.Runtime, serviceVersion string) *cobra.Command {
 	cmd.Flags().StringVar(&cfg.OTELEndpoint, "otel-endpoint", cfg.OTELEndpoint, "OTLP HTTP trace endpoint (optional; enables span export when set)")
 	cmd.Flags().BoolVar(&cfg.InsecureHTTP, "insecure-http", false, "Allow externally bound HTTP transport without bearer token (unsafe; testing only)")
 	cmd.Flags().BoolVar(&cfg.Stateless, "stateless", false, "Stateless session management (for multi-instance deployments)")
+	cmd.Flags().StringVar(&cfg.WikiDir, "wiki-dir", cfg.WikiDir, "Directory containing built Wiki UI assets; enables /wiki when set")
 	cmd.Flags().StringVar(&cfg.NamespaceRoot, "namespace-root", cfg.NamespaceRoot, "Root directory for file namespaces")
 	cmd.Flags().StringVar(&cfg.WorkspaceRoot, "workspace-root", "", "Deprecated alias for --namespace-root")
 

docker-compose.integration.yml

@@ -60,6 +60,7 @@ services:
       - CCG_LOG_FORMAT=text
     command:
       - --http-addr=:8080
+      - --wiki-dir=/usr/share/ccg/wiki
       - --http-bearer-token=test-mcp-token
       - --db-driver=postgres
       - --db-dsn=host=postgres user=ccg password=ccg dbname=ccg_integration port=5432 sslmode=disable