chore: initial repo scaffolding

This commit is contained in:
root
2026-05-31 01:22:10 +10:00
commit 0ede9fead8
5 changed files with 57 additions and 0 deletions

5
.env.example Normal file
View File

@@ -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

5
.gitignore vendored Normal file
View File

@@ -0,0 +1,5 @@
node_modules/
.env
*.log
coverage/
.DS_Store

9
CHANGELOG.md Normal file
View File

@@ -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

18
README.md Normal file
View File

@@ -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`

20
docs/VERSION_HISTORY.md Normal file
View File

@@ -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.