From 0ede9fead805f4b72b59c039ecf0124cbe566a88 Mon Sep 17 00:00:00 2001
From: root <root@claude.hynesy.com>
Date: Sun, 31 May 2026 01:22:10 +1000
Subject: [PATCH] chore: initial repo scaffolding

---
 .env.example            |  5 +++++
 .gitignore              |  5 +++++
 CHANGELOG.md            |  9 +++++++++
 README.md               | 18 ++++++++++++++++++
 docs/VERSION_HISTORY.md | 20 ++++++++++++++++++++
 5 files changed, 57 insertions(+)
 create mode 100644 .env.example
 create mode 100644 .gitignore
 create mode 100644 CHANGELOG.md
 create mode 100644 README.md
 create mode 100644 docs/VERSION_HISTORY.md

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..45bd1d3
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,5 @@
+DATABASE_URL=postgres://void:CHANGE_ME@192.168.X.X:5432/void
+OWNER_TOKEN=CHANGE_ME_TO_LONG_RANDOM
+PORT=3000
+LOG_LEVEL=info
+NODE_ENV=development
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..dc8e789
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+node_modules/
+.env
+*.log
+coverage/
+.DS_Store
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..1414296
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to Void 2.0 are documented here.
+Format: [Keep a Changelog](https://keepachangelog.com).
+
+## [Unreleased]
+
+### Added
+- Initial repo scaffolding
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6ede8fb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Void 2.0
+
+Homelab orchestrator + canonical knowledge store. Cradle-themed.
+Successor to Void 1.x (CT 301). Spec at
+`/project/docs/superpowers/specs/2026-05-31-void-v2-design.md`.
+
+## Layout
+- `void-server` (this repo) — Node API, MCP, UI, cron, agent runtime
+- `void-workers` — Python ingest workers (separate repo, later plan)
+
+## Quick start (dev)
+1. Provision `void2-db` LXC (see `deploy/README.md`)
+2. Install Postgres + pgvector on `void2-db`
+3. `npm install`
+4. `cp .env.example .env` and edit
+5. `npm run migrate`
+6. `npm start`
+7. `curl -H "Authorization: Bearer $OWNER_TOKEN" http://localhost:3000/health`
diff --git a/docs/VERSION_HISTORY.md b/docs/VERSION_HISTORY.md
new file mode 100644
index 0000000..64ddbf1
--- /dev/null
+++ b/docs/VERSION_HISTORY.md
@@ -0,0 +1,20 @@
+# Version History
+
+Narrative history of major Void releases.
+
+## Void 2.0 (in development, started 2026-05-31)
+
+Complete remaster of Void 1.x. Foundation-first rebuild on Postgres + pgvector,
+two-LXC HA shape, expanded entity model (Spaces, Projects, Tasks, Pages,
+References, Source Docs, Resources, Conversations, Agents), unified MCP
+surface for AI agents with per-agent capability tiers.
+
+See spec: `/project/docs/superpowers/specs/2026-05-31-void-v2-design.md`.
+
+## Void 1.x (2026-04 — 2026-05, CT 301)
+
+Cradle-themed dashboard + 7 character agents (Dross, Orthos, Eithan, Mercy,
+Lindon, Yerin, Little Blue). Gridstack Sacred Valley layout. node:sqlite
+storage. Mastra+Ollama for Orthos; Claude binary subprocess for others.
+Path B rebuild (2026-05-13) added FTS5 search, NLP summaries, memory-update
+markers, BookStack page import.