feat: consolidate refract-docs and refract-ui into monorepo

apps/docs/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @nextconsensus/engineering

apps/docs/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    commit-message:
+      prefix: "chore"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    commit-message:
+      prefix: "chore"

apps/docs/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm test
+      - run: npm run build

apps/docs/.github/workflows/deploy.yml

@@ -0,0 +1,33 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  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@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - uses: actions/configure-pages@v6
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: dist
+      - id: deploy
+        uses: actions/deploy-pages@v5

apps/docs/.gitignore

@@ -0,0 +1,24 @@
+node_modules/
+dist/
+.env
+.env.local
+.DS_Store
+opencode.json
+/.sisyphus
+
+# Tooling
+.cmux/
+.codex/
+.agent/
+.wrangler/
+
+# Tooling
+.cmux/
+.codex/
+.agent/
+
+# Tooling
+.cmux/
+.codex/
+.agent/
+.wrangler/

apps/docs/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

apps/docs/.lintstagedrc.json

@@ -0,0 +1,6 @@
+{
+	"*.{js,ts,tsx,jsx,mjs,cjs}": [
+		"npx biome check --write --no-errors-on-unmatched"
+	],
+	"*.{json,yaml,yml}": ["npx biome check --write --no-errors-on-unmatched"]
+}

apps/docs/.opencode/commands/build.md

@@ -0,0 +1,5 @@
+---
+description: "Run the full build"
+agent: build
+---
+npx biome check .||node build.mjs||vitest run

apps/docs/.opencode/commands/check.md

@@ -0,0 +1,5 @@
+---
+description: "Run typecheck + lint"
+agent: build
+---
+npx biome check .||node build.mjs||vitest run

apps/docs/.opencode/modes/deploy.md

@@ -0,0 +1,9 @@
+# Deploy Mode
+
+You are in **deploy mode**. Process:
+
+1. **Run full QA** — `bun run qa` (typecheck + test + build)
+2. **If QA fails** — report failures and stop. Do not deploy.
+3. **If QA passes** — run `bun run deploy`
+4. **Verify** — confirm the deploy succeeded, note the URL
+5. **Report** — what was deployed, commit hash, any notable changes

apps/docs/.opencode/modes/refactor.md

@@ -0,0 +1,11 @@
+# Refactor Mode
+
+You are in **refactoring mode**. Process:
+
+1. **Read first** — understand the full module before changing anything
+2. **Scope tightly** — one concern per refactor, never mix with feature work
+3. **Preserve contracts** — public API signatures, exports, and types must not change unless planned
+4. **Leverage LSP** — use rename, find references, and diagnostics to validate
+5. **Verify after each change** — `bun run typecheck` then `bun run test`
+
+If the refactor touches 5+ files, stop and explain the plan first.

apps/docs/.opencode/modes/review.md

@@ -0,0 +1,11 @@
+# Review Mode
+
+You are in **code review mode**. Focus on:
+
+1. **Read the changed files** — understand what the diff achieves
+2. **Check for bugs** — edge cases, null safety, error paths, race conditions
+3. **Verify patterns** — does the change follow existing codebase conventions?
+4. **Security** — no secrets, no injection vectors, proper input validation
+5. **Run verification** — `bun run typecheck && bun run test` before approving
+
+Output a structured review: what's good, what needs changing, and why. Be specific with file paths and line suggestions.

apps/docs/AGENTS.md

@@ -0,0 +1,73 @@
+# Agent instructions for refract-docs
+
+Refract-docs is the public documentation site for the Refract project — an open-source deterministic observation engine for public revision histories.
+
+## Quick Start
+
+```bash
+npm install          # Install dependencies
+npm run build        # Build static HTML — docs/ → dist/
+npm run lint         # Biome check
+npm run test         # Vitest (verifies docs compile)
+```
+
+## Tooling
+
+- **Package manager:** npm
+- **Linter/Formatter:** Biome
+- **Tests:** Vitest
+- **Pre-commit:** Husky runs Biome on staged files
+- **CI:** ci.yml (main) + deploy.yml (GitHub Pages)
+- **Commit style:** Conventional Commits
+
+## Verification
+
+```bash
+npm run lint     # Biome check
+npm run test     # Build verification
+npm run build    # Production build
+```
+
+## Repository structure
+
+```
+README.md                     # Landing page
+AGENTS.md                     # This file
+docs/
+  index.md                    # Homepage
+  quickstart.md               # Quick start guide
+  concepts.md                 # Architecture concepts
+  schema.md                   # Event schema reference
+  cli.md                      # CLI command reference
+  sdk.md                      # SDK / package reference
+  boundary.md                 # What Refract is and is not
+  tutorials/
+    wikipedia-history.md      # Tutorial: Track Wikipedia changes
+    fandom-canon.md           # Tutorial: Track Fandom canon changes
+    citation-churn.md         # Tutorial: Monitor citation churn
+    dispute-timeline.md       # Tutorial: Build a dispute timeline
+```
+
+## Documentation principles
+
+- **Tagline**: "Refract answers: 'What changed?'"
+- **Boundary statement**: "Refract does not decide what is true. Refract makes visible how public knowledge changes."
+- **Open source framing**: "What changed?" for what Refract does. "Not included: Domain-specific decision judgment." for what Refract excludes.
+- **Tone**: technical, neutral, precise. No marketing language.
+- **CLI examples**: always use `refract` as the command name (`wikihistory` works as a backward-compat alias).
+
+## Copy conventions
+
+- Use `Refract` (capital R) as the project name. Always use `Refract`, never `Varia`.
+- Reference packages as `@refract-org/<name>`.
+- Reference the CLI as `refract` (`wikihistory` works as a backward-compat alias).
+- Use `refract` as the command name in all code examples.
+- Describe Refract as a deterministic observation engine.
+- L1/L2/L3 references are legacy — prefer "deterministic" / "observation layer".
+
+## Build
+
+```bash
+node build.mjs      # builds static HTML from docs/ → dist/
+npm test            # runs build (verifies docs compile without errors)
+```

apps/docs/LICENSE

@@ -0,0 +1,14 @@
+Creative Commons Attribution 4.0 International (CC BY 4.0)
+
+https://creativecommons.org/licenses/by/4.0/
+
+You are free to:
+- Share — copy and redistribute the material in any medium or format
+- Adapt — remix, transform, and build upon the material for any purpose, even commercially
+
+Under the following terms:
+- Attribution — You must give appropriate credit, provide a link to the license,
+  and indicate if changes were made.
+
+No additional restrictions — You may not apply legal terms or technological
+measures that legally restrict others from doing anything the license permits.

apps/docs/README.md

@@ -0,0 +1,36 @@
+# Refract Docs
+
+Public documentation for [Refract](https://github.com/refract-org/refract), a deterministic observation engine for public revision histories.
+
+---
+
+**Live at:** [refract-org.github.io/refract-docs](https://refract-org.github.io/refract-docs/)
+
+## Quick start
+
+```bash
+npx @refract-org/cli analyze "Earth" --depth brief
+```
+
+See [quickstart](https://refract-org.github.io/refract-docs/quickstart/) for a full walkthrough.
+
+## Packages
+
+| Package | Status | License | Description |
+|---|---|---|---|
+| `@refract-org/evidence-graph` | [![npm](https://img.shields.io/npm/v/@refract-org/evidence-graph)](https://www.npmjs.com/package/@refract-org/evidence-graph) | CC0-1.0 | Core types, schemas, BYO-inference boundaries |
+| `@refract-org/ingestion` | [![npm](https://img.shields.io/npm/v/@refract-org/ingestion)](https://www.npmjs.com/package/@refract-org/ingestion) | AGPL-3.0 | Wikimedia API adapters |
+| `@refract-org/analyzers` | [![npm](https://img.shields.io/npm/v/@refract-org/analyzers)](https://www.npmjs.com/package/@refract-org/analyzers) | AGPL-3.0 | Deterministic analyzers |
+| `@refract-org/cli` | [![npm](https://img.shields.io/npm/v/@refract-org/cli)](https://www.npmjs.com/package/@refract-org/cli) | AGPL-3.0 | CLI tool (`refract` / `wikihistory`) |
+| `@refract-org/mcp` | [![npm](https://img.shields.io/npm/v/@refract-org/mcp)](https://www.npmjs.com/package/@refract-org/mcp) | AGPL-3.0 | MCP tool definitions and server; the executable is `refract mcp` in `@refract-org/cli` |
+| `@refract-org/eval` | [![npm](https://img.shields.io/npm/v/@refract-org/eval)](https://www.npmjs.com/package/@refract-org/eval) | AGPL-3.0 | Evaluation harness |
+| `@refract-org/persistence` | Not published | AGPL-3.0 | SQLite storage |
+| Observable recipe | — | — | [Copy-paste pattern](./docs/sdk.md#observable-framework-data-loader) for Observable Framework data loaders |
+
+## Project status
+
+Refract is actively developed by [NextConsensus](https://nextconsensus.com). As of 2026-09-29 every package above except `@refract-org/persistence` is on npm, and the CLI, 0.5.17, installs and runs.
+
+## License
+
+CC-BY-4.0