landsraad 2026.5.2 → 2026.5.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Currier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# Landsraad
+
+A local-first AI council chamber. Configure councillors, give them jobs, watch the council work.
+
+> Status: **v1 — single-council, cwd-rooted.** See [`SPECIFICATION.md`](./SPECIFICATION.md) for the full scope and what's deliberately out of scope.
+
+## What's here
+
+- A SvelteKit + TypeScript app you run locally.
+- **One council per directory.** When you run `npx landsraad`, the current working directory **is** the council — `council.json`, `councillors/`, `memory/`, `jobs/`, `.index/` all sit at cwd.
+- No accounts, no cloud, no telemetry. You are the only user. You are also the secretary.
+
+## Quickstart
+
+Requires Node.js 20+.
+
+```bash
+mkdir my-council && cd my-council
+npx landsraad
+```
+
+Open the URL it prints. The setup form creates `council.json` in the current directory.
+
+### From the repo (development)
+
+```bash
+npm install
+npm run dev   # runs against repo cwd; council files are gitignored
+```
+
+To target a specific directory:
+
+```bash
+LANDSRAAD_COUNCIL_ROOT=/path/to/council npm run dev
+```
+
+### Seed a dogfood council
+
+```bash
+npm run dogfood:init        # creates ./dogfood
+cd dogfood && npx landsraad # or LANDSRAAD_COUNCIL_ROOT=./dogfood npm run dev
+```
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `LANDSRAAD_COUNCIL_ROOT` | `process.cwd()` | The directory Landsraad treats as the council root. |
+
+## Tests
+
+```bash
+npm test
+```
+
+Vitest covers the filesystem layer (`src/lib/server/`).
+
+## Project layout
+
+```
+bin/landsraad.js           # npx entry (runs the built server in cwd)
+src/
+  lib/
+    server/                # filesystem-backed council layer (paths, councils, councillors, memory, jobs, runner, indexer)
+    types.ts               # shared types
+  routes/                  # SvelteKit pages — flat: /, /edit, /councillors/*, /memory/*, /jobs/*
+scripts/
+  dogfood-init.ts          # seed a council into ./dogfood (or a custom path)
+  reindex.ts               # rebuild the semantic index for a council root
+SPECIFICATION.md           # what the product is supposed to be
+docs/                      # architecture + data model + embeddings notes
+```
+
+## License
+
+See [`LICENSE`](./LICENSE).

package/bin/landsraad.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// Entry point for `npx landsraad`.
+//   landsraad                    -> start production SvelteKit server
+//   landsraad init <source> ...  -> install a council template
+//   landsraad export <out> ...   -> export the current council to a template
+
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(here, '..');
+
+const [, , sub, ...rest] = process.argv;
+
+function runBundled(relPath) {
+  const entry = resolve(repoRoot, relPath);
+  if (!existsSync(entry)) {
+    console.error(
+      `Landsraad has not been built yet (missing ${relPath}).\n` +
+        'From the repo root, run:\n' +
+        '  npm install\n' +
+        '  npm run build'
+    );
+    process.exit(1);
+  }
+  const child = spawn(process.execPath, [entry, ...rest], {
+    stdio: 'inherit',
+    env: process.env,
+    cwd: process.cwd()
+  });
+  child.on('exit', (code) => process.exit(code ?? 0));
+}
+
+if (sub === 'init') {
+  runBundled('build/cli/template-install.mjs');
+} else if (sub === 'export') {
+  runBundled('build/cli/template-export.mjs');
+} else {
+  runBundled('build/index.js');
+}