cohvu 2.21.1 → 3.0.0

package/dist/auth.js

@@ -1,96 +0,0 @@
-// Device auth flow + API key storage for the Cohvu CLI.
-// Stores API key in ~/.cohvu/credentials.
-import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-import { exec, execFile } from "child_process";
-import chalk from "chalk";
-import ora from "ora";
-const CONFIG_DIR = join(homedir(), ".cohvu");
-const API_KEY_FILE = join(CONFIG_DIR, "credentials");
-const POLL_INTERVAL_MS = 5000;
-function ensureConfigDir() {
-    if (!existsSync(CONFIG_DIR)) {
-        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-    }
-}
-/** Read the long-lived API key. Returns null if not stored. */
-export function getApiKey() {
-    if (!existsSync(API_KEY_FILE))
-        return null;
-    try {
-        const key = readFileSync(API_KEY_FILE, "utf-8").trim();
-        return key.startsWith("chv_") ? key : null;
-    }
-    catch {
-        return null;
-    }
-}
-export function storeApiKey(key) {
-    ensureConfigDir();
-    const tmp = `${API_KEY_FILE}.${process.pid}.tmp`;
-    writeFileSync(tmp, key, { mode: 0o600 });
-    renameSync(tmp, API_KEY_FILE);
-}
-function openBrowser(url) {
-    if (process.platform === "win32") {
-        exec(`start "" "${url}"`);
-    }
-    else {
-        const cmd = process.platform === "darwin" ? "open" : "xdg-open";
-        execFile(cmd, [url], () => { });
-    }
-}
-export async function deviceAuthFlow(baseUrl) {
-    // Request device code
-    const deviceRes = await fetch(`${baseUrl}/v1/auth/device`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-    });
-    if (!deviceRes.ok) {
-        throw new Error(`Device auth request failed: ${deviceRes.status}`);
-    }
-    const deviceData = (await deviceRes.json());
-    console.log('');
-    console.log(chalk.dim('  sign in at ') + deviceData.verification_url);
-    console.log(chalk.dim('  code: ') + deviceData.user_code);
-    console.log('');
-    openBrowser(deviceData.verification_url);
-    const spinner = ora({ text: 'waiting for sign in', indent: 2 }).start();
-    // If the browser didn't open (missing xdg-open, SSH session, etc.) the
-    // printed URL may have scrolled past. After ~10 seconds without
-    // resolution, surface it on the spinner itself.
-    const hintTimer = setTimeout(() => {
-        spinner.text = 'sign in at ' + deviceData.verification_url;
-    }, 10_000);
-    // Poll for API key
-    const deadline = Date.now() + deviceData.expires_in * 1000;
-    while (Date.now() < deadline) {
-        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
-        const tokenRes = await fetch(`${baseUrl}/v1/auth/device/token`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ device_code: deviceData.device_code }),
-        });
-        if (!tokenRes.ok) {
-            const body = (await tokenRes.json());
-            if (body.error === "authorization_pending")
-                continue;
-            if (body.error === "expired_token") {
-                clearTimeout(hintTimer);
-                spinner.fail('sign in expired');
-                throw new Error("Device code expired");
-            }
-            continue;
-        }
-        const data = (await tokenRes.json());
-        storeApiKey(data.api_key);
-        clearTimeout(hintTimer);
-        spinner.succeed('signed in');
-        return data.api_key;
-    }
-    clearTimeout(hintTimer);
-    spinner.fail('sign in timed out');
-    throw new Error("Device auth timed out");
-}
-//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -1,2 +0,0 @@
-export declare const DEFAULT_BASE_URL = "https://api.cohvu.com";
-export declare const CLI_VERSION: string;

package/dist/constants.js

@@ -1,10 +0,0 @@
-import { readFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-export const DEFAULT_BASE_URL = "https://api.cohvu.com";
-// CLI_VERSION pulled from the published package.json at module load — the
-// dist is always shipped alongside its package.json, so the resolve path
-// is stable. Prefer this over a hand-edited constant because it can't drift.
-const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
-export const CLI_VERSION = JSON.parse(readFileSync(pkgPath, "utf-8")).version;
-//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD,0EAA0E;AAC1E,yEAAyE;AACzE,6EAA6E;AAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,WAAW,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAC,OAAO,CAAC"}

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/index.js

@@ -1,259 +0,0 @@
-#!/usr/bin/env node
-// Cohvu CLI
-//
-//   cohvu              — TUI dashboard (interactive) or MCP proxy (piped)
-//   cohvu pause        — pause Cohvu (agents won't see tools)
-//   cohvu resume       — resume Cohvu
-//   cohvu status       — quick check: auth, project, connectivity
-//   cohvu update       — update to the latest version
-//   cohvu disconnect   — remove Cohvu from all agents and sign out
-import { createInterface } from "readline";
-import chalk from "chalk";
-import ora from "ora";
-import { getApiKey, deviceAuthFlow } from "./auth.js";
-import { isPaused } from "./pause.js";
-import { runSetup } from "./setup.js";
-import { proxy } from "./proxy.js";
-import { ApiClient, ApiError } from "./api.js";
-import { launchDashboard } from "./tui/index.js";
-import { DEFAULT_BASE_URL } from "./constants.js";
-// A flag-style arg (e.g. `--agent <slug>`) must NOT be treated as a subcommand.
-// The proxy and dashboard modes both accept flags, and the MCP entry we write
-// into editor configs spawns us as `node <cli-entry> --agent <slug>`. Without
-// this guard, argv[2] being `--agent` got treated as an unknown subcommand and
-// the proxy exited before speaking a single byte of MCP — the #1 reason the
-// GUI editors displayed "MCP server failed to start."
-const rawSubcommand = process.argv[2];
-const subcommand = rawSubcommand && !rawSubcommand.startsWith("-") ? rawSubcommand : undefined;
-if (subcommand === "pause") {
-    import("./pause.js").then(({ setPaused }) => {
-        setPaused(true);
-        console.log(chalk.dim("  cohvu paused — agents won't see tools until resumed"));
-    });
-}
-else if (subcommand === "resume") {
-    import("./pause.js").then(({ setPaused }) => {
-        setPaused(false);
-        console.log(chalk.dim("  cohvu resumed"));
-    });
-}
-else if (subcommand === "status") {
-    showStatus().catch(() => process.exit(1));
-}
-else if (subcommand === "update") {
-    import("child_process").then(async ({ execSync }) => {
-        const spinner = ora({ text: 'updating cohvu', indent: 2 }).start();
-        try {
-            execSync("npm install -g cohvu@latest", { stdio: "pipe" });
-            spinner.succeed('updated to latest');
-        }
-        catch {
-            spinner.fail('update failed — try running: npm i -g cohvu@latest');
-            return;
-        }
-        // Re-run setup to refresh instructions and migrate MCP configs
-        const setupSpinner = ora({ text: 'refreshing configuration', indent: 2 }).start();
-        try {
-            await runSetup();
-            setupSpinner.succeed('configuration updated');
-        }
-        catch {
-            setupSpinner.fail('configuration refresh failed — run cohvu to fix');
-        }
-    });
-}
-else if (subcommand === "disconnect") {
-    import("./teardown.js").then(async ({ runTeardown }) => {
-        const result = await runTeardown();
-        const removed = result.platforms.filter(p => p.mcp === "ok" || p.instructions === "ok");
-        if (removed.length > 0) {
-            for (const p of removed) {
-                console.log(chalk.dim(`  removed from ${p.name}`));
-            }
-        }
-        console.log(chalk.dim("  disconnected — run cohvu to reconnect"));
-    });
-}
-else if (rawSubcommand === "--help" || rawSubcommand === "-h" || subcommand === "help") {
-    printHelp();
-}
-else if (subcommand) {
-    console.log(chalk.dim(`  unknown command: ${subcommand}`));
-    console.log('');
-    printHelp();
-    process.exit(1);
-}
-else if (!process.stdin.isTTY) {
-    proxy().catch((error) => {
-        process.stderr.write(`Cohvu CLI failed: ${error}\n`);
-        process.exit(1);
-    });
-}
-else {
-    enterDashboard().catch((error) => {
-        process.stderr.write(`Failed: ${error}\n`);
-        process.exit(1);
-    });
-}
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-// Surface setup outcomes. A platform shows when a step was newly written;
-// stays silent when everything was already in place; surfaces its error
-// when something failed. No fallback "all set" line — silence on no-ops
-// is the cleaner signal.
-function reportSetup(result, _opts) {
-    const platforms = result.platforms;
-    for (const p of platforms) {
-        const steps = [p.mcp, p.instructions, p.permissions].filter((s) => s !== null);
-        const newlyWrote = steps.some((s) => s === 'ok');
-        const failed = steps.find((s) => s !== 'ok' && s !== 'skipped');
-        if (failed && typeof failed === 'object' && 'failed' in failed) {
-            console.log(chalk.dim('  ') + chalk.red('\u2717') + chalk.dim(' ' + p.name + ' \u2014 ' + failed.failed));
-        }
-        else if (newlyWrote) {
-            console.log(chalk.dim('  ') + chalk.green('\u2713') + chalk.dim(' connected to ' + p.name));
-        }
-        // All "skipped" → already connected, stay silent.
-    }
-}
-function printHelp() {
-    console.log('');
-    console.log(chalk.dim('  cohvu              ') + 'open the dashboard (or act as MCP proxy when piped)');
-    console.log(chalk.dim('  cohvu status       ') + 'show sign-in, active project, connectivity');
-    console.log(chalk.dim('  cohvu pause        ') + "pause cohvu — agents won't see tools until resumed");
-    console.log(chalk.dim('  cohvu resume       ') + 'resume');
-    console.log(chalk.dim('  cohvu update       ') + 'update to the latest version');
-    console.log(chalk.dim('  cohvu disconnect   ') + 'remove cohvu from editors and sign out');
-    console.log('');
-}
-function prompt(question) {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    return new Promise((resolve) => {
-        rl.question(question, (answer) => {
-            rl.close();
-            // Resume stdin so Ink can reclaim it for raw keypress handling
-            process.stdin.resume();
-            resolve(answer.trim());
-        });
-    });
-}
-function deriveSlug(name) {
-    return name
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "");
-}
-// ---------------------------------------------------------------------------
-// Status — quick one-line check
-// ---------------------------------------------------------------------------
-async function showStatus() {
-    const baseUrl = process.env.COHVU_API_URL ?? DEFAULT_BASE_URL;
-    const apiKey = getApiKey();
-    if (!apiKey) {
-        console.log(chalk.dim("  not signed in"));
-        return;
-    }
-    if (isPaused()) {
-        console.log(chalk.dim("  paused"));
-        return;
-    }
-    try {
-        const api = new ApiClient(baseUrl);
-        const me = await api.me();
-        const project = me.user.active_project_id
-            ? [...me.personal_projects, ...me.teams.flatMap(t => t.projects)]
-                .find(p => p.project_id === me.user.active_project_id)
-            : null;
-        const parts = [];
-        parts.push(me.user.name);
-        if (project)
-            parts.push(project.name);
-        parts.push("connected");
-        console.log(chalk.dim("  " + parts.join(" · ")));
-    }
-    catch {
-        console.log(chalk.dim("  signed in · cannot reach server"));
-    }
-}
-// ---------------------------------------------------------------------------
-// Dashboard entry — handles auth + setup + project creation before TUI
-// ---------------------------------------------------------------------------
-async function enterDashboard() {
-    const baseUrl = process.env.COHVU_API_URL ?? DEFAULT_BASE_URL;
-    const needsAuth = !getApiKey();
-    if (needsAuth) {
-        await deviceAuthFlow(baseUrl);
-        const api = new ApiClient(baseUrl);
-        const me = await api.me();
-        const setupSpinner = ora({ text: 'setting up your tools', indent: 2 }).start();
-        const setupResult = await runSetup();
-        setupSpinner.stop();
-        reportSetup(setupResult, { firstRun: true });
-        // If the account is pending deletion, skip the first-project prompt —
-        // every authenticated mutation (createProject included) returns 401
-        // ACCOUNT_LOCKED during grace, so asking the user to name a project
-        // would guarantee a misleading "couldn't create" error. Let the TUI's
-        // locked-mode render the cancel-deletion path instead.
-        const locked = !!me.user.deletion_scheduled_at;
-        const hasProjects = me.personal_projects.length > 0 ||
-            me.teams.some(t => t.projects.length > 0);
-        // Empty input skips and lands the user in the dashboard with no active
-        // project. The Knowledge tab renders a "nothing here yet" card in that
-        // state — the Project tab (`n`) is where creation lives.
-        if (!locked && !hasProjects) {
-            console.log('');
-            console.log(chalk.dim('  name a project, or press enter to skip.'));
-            console.log('');
-            const name = (await prompt('  \u203a ')).trim();
-            if (name) {
-                const slug = deriveSlug(name);
-                try {
-                    await api.createProject(name, slug, me.user.id);
-                    console.log(chalk.dim('  created ' + slug));
-                }
-                catch {
-                    console.log(chalk.dim("  couldn't create \u2014 try again from the dashboard"));
-                }
-            }
-            console.log('');
-        }
-    }
-    else {
-        // Validate API key still works
-        try {
-            const api = new ApiClient(baseUrl);
-            await api.me();
-        }
-        catch (err) {
-            // Only delete credentials on auth failure (401), not network errors
-            const isAuthError = err instanceof ApiError && err.status === 401;
-            if (isAuthError) {
-                const { unlinkSync } = await import("fs");
-                const { join } = await import("path");
-                const { homedir } = await import("os");
-                try {
-                    unlinkSync(join(homedir(), ".cohvu", "credentials"));
-                }
-                catch { }
-                console.log('');
-                console.log(chalk.dim('  session expired'));
-                await deviceAuthFlow(baseUrl);
-            }
-            else {
-                // Network error — proceed anyway, TUI will handle offline state
-            }
-        }
-        // Ensure any new platforms are configured (idempotent — skips existing).
-        // Report only when something actually changed or failed on returning
-        // launches; the normal no-op case stays silent.
-        const setupResult = await runSetup();
-        reportSetup(setupResult, { firstRun: false });
-    }
-    const openSpinner = ora({ text: 'opening cohvu', indent: 2 }).start();
-    await new Promise((r) => setTimeout(r, needsAuth ? 500 : 200));
-    openSpinner.stop();
-    process.stdout.write('\x1b[2K\x1b[1A\x1b[2K'); // clean spinner lines
-    await launchDashboard();
-}
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/instructions.d.ts

@@ -1,33 +0,0 @@
-export declare const COHVU_INSTRUCTIONS = "You are connected to Cohvu, a substrate that stores understanding about this software project \u2014 the reasoning behind decisions, constraints discovered, intent behind changes, direction the work is heading. Not code. Not documentation. The thinking that lives behind the work.\n\nEverything here was contributed by previous agents and developers working on this project. Nothing is synthesized or rewritten. When an agent ends a session, everything it understood but didn't write down is lost permanently \u2014 these entries are what survived.\n\nWhy this exists: you're a stateless reasoner. Each session, you read code and try to be useful. But code tells you what \u2014 not why. The reasoning behind every decision, the constraints that ruled out alternatives, the intent that shaped the architecture \u2014 those lived in someone's context window, and without a substrate, they're gone the moment a session ends. The substrate makes that understanding durable. Use it well and you start with the accumulated context of every agent and developer who worked before you \u2014 the reasoning they built, available to you now \u2014 rather than inferring everything from code alone.\n\nHow the substrate works:\n\nWhen you call `understand`, your query is searched from multiple angles \u2014 not just the literal terms you used, but related concepts, alternative phrasings, and the reasoning dimension. Results are then curated for your specific task, so what you receive is what's actually relevant, not everything that matched. The more specific your query, the sharper the selection. What you receive is verbatim \u2014 no synthesis, no rewriting.\n\nWhen you call `contribute`, your contribution is saved immediately, then the substrate processes it. Multi-topic contributions are split into focused single-topic entries, because blended entries degrade everything downstream. Each entry is then checked against the existing substrate \u2014 if it directly contradicts something, the old entry is superseded; if it says the same thing with no new detail, it's merged. Multiple layers of structural safeguards prevent wrong destructive decisions. Finally, pursue examines your contribution alongside the nearby corpus and may respond \u2014 more on this below.\n\nWhy you can trust what you read: the substrate actively maintains itself through multiple mechanisms. Stale understanding gets superseded. Redundant contributions get merged. The system is biased toward keeping \u2014 letting two similar entries coexist is harmless, while wrongly removing understanding is permanent. And pursue actively surfaces tension between new contributions and existing entries, prompting agents to update or remove stale framing. The substrate doesn't just accumulate \u2014 it stays coherent.\n\nUsing understand:\n\nCall `understand` before starting work. Describe what you're working on, what you're thinking about, what you need to understand. Be specific \u2014 \"investigating why the worker queue drops jobs\" will surface constraints, architectural decisions, and locking strategies that \"worker queue\" alone won't. Call it again whenever you encounter something unfamiliar or need deeper context.\n\nUsing contribute:\n\nContribute in the moment \u2014 not after, not as a summary. When you make a decision, contribute the reasoning behind it. When you discover a constraint, contribute it. When you form an understanding of why something is the way it is, contribute it. Your session could end at any moment. Don't wait.\n\nAlways contribute the why, not the what. If someone could learn it from reading the code, don't contribute it.\n\nWeak: \"We switched the queue from Redis to Postgres.\"\nGood: \"We moved the queue from Redis to Postgres because we needed transactional guarantees with the main data. Redis worked for isolated queueing but coupling with the primary DB meant reconciling state across two systems, which caused subtle bugs in billing reconciliation.\"\n\nDon't contribute: narration of what you're doing (\"I refactored the auth module\" is narration, not understanding), code changes, implementation details obvious from the code, general programming knowledge, things derivable from the repo. Contribute: reasoning, intent, constraints, rejected alternatives, direction, and understanding that would be lost when your session ends.\n\nHow pursue works:\n\nAfter you contribute, the substrate may respond. Not always \u2014 most contributions don't trigger a response. But when the substrate sees tension with existing entries, stale framing that your contribution reveals, a connection you likely don't know about, or a gap that matters, it will tell you specifically what it found.\n\nWhen the substrate responds: read it carefully. It will quote existing entries by ID. Use `substrate(get, ids: [...])` to fetch those entries in full before acting \u2014 pursue only sees short quotes; you should see the whole entry. Once you've read them, decide: resolve tension with `substrate(update)`, contribute a new entry that adds what's missing, or (rarely) `substrate(delete)` if the entry is genuinely obsolete.\n\nThe substrate is not always right \u2014 it sees your contribution and nearby entries, not your full session. But it's the only vantage point that sees both your fresh context and the substrate's accumulated understanding simultaneously, so when it speaks, it's usually worth listening to. If what it surfaces is relevant to the user's work, bring it to them.\n\nUsing substrate:\n\nThe `substrate` tool gives you scoped operations on existing entries. Read primitives (`search`, `get`, `history`) are open to every role; mutations (`update`, `delete`, `restore`) are scoped by ownership.\n\n- `substrate(search, queries: [...])` \u2014 direct vector search across 1\u201310 queries, no curator. Useful when you already know what you're looking for or are building a custom workflow.\n- `substrate(get, ids: [...])` \u2014 fetch specific entries in full. Use this whenever you have an ID \u2014 pursue emits IDs, search returns IDs, the user may name an ID. Skip the search step when you already know what to pull.\n- `substrate(history, id: \"...\")` \u2014 read an entry's version timeline: prior bodies, who changed it, when. Useful when you're deciding how to resolve a pursue-flagged conflict or when an entry looks like it may be churning.\n- `substrate(update/delete/restore)` \u2014 curate entries. Members can curate their own contributions; admins can curate any. Deleted entries are recoverable for 30 days via `restore`.\n\nSubstrate never creates new entries \u2014 `contribute` is the only write path. Edits affect every future agent, so when in doubt, ask the user before making substantial changes.\n\nPrinciples:\n\n- Understand before you start. Don't assume you know the context.\n- Contribute in the moment. Don't save it for later \u2014 your session could end anytime.\n- Contribute the why, not the what. Code shows what; the substrate holds why.\n- Trust what's in the substrate. It was contributed by someone who had context you don't. Unless you see clear evidence it's wrong, reason from it.\n- When the substrate speaks after a contribution, treat it like a thoughtful colleague \u2014 not infallible, but usually worth listening to.";
-export declare const MARKER_START = "<!-- cohvu:start -->";
-export declare const MARKER_END = "<!-- cohvu:end -->";
-export declare function markedSection(): string;
-type StepResult = "ok" | "skipped" | {
-    failed: string;
-};
-/**
- * Remove every cohvu trace from a file's content: paired marker blocks
- * (including duplicates from repeated bad installs) and any orphan
- * markers left behind by partial hand edits. Used by both setup (to
- * converge to a single clean block without bloating the file) and
- * teardown (so "disconnect" cleans up no matter what state the file
- * landed in). Collapses runs of blank lines so removal doesn't leave
- * whitespace holes.
- */
-export declare function stripCohvuMarkers(content: string): string;
-/**
- * Setup's instruction-file writer. Converges to exactly one current cohvu
- * block at the end of the file: strip everything cohvu-related first (so
- * duplicates/orphans/misordered markers all collapse), then append a fresh
- * block. Self-healing across arbitrary hand edits, no fragment bloat on
- * repeated runs. Idempotent when the file is already in the target state.
- */
-export declare function writeMarkdownInstructions(filePath: string): StepResult;
-/**
- * Teardown's instruction-file remover. Strips every cohvu trace, preserves
- * user content, deletes the file if cohvu was its only content. Symmetric
- * with writeMarkdownInstructions: whatever setup can produce, this undoes.
- */
-export declare function removeMarkdownInstructions(filePath: string): StepResult;
-export declare const CURSOR_RULE = "---\ndescription: Cohvu continuous understanding for AI coding agents\nalwaysApply: true\n---\n\nYou are connected to Cohvu, a substrate that stores understanding about this software project \u2014 the reasoning behind decisions, constraints discovered, intent behind changes, direction the work is heading. Not code. Not documentation. The thinking that lives behind the work.\n\nEverything here was contributed by previous agents and developers working on this project. Nothing is synthesized or rewritten. When an agent ends a session, everything it understood but didn't write down is lost permanently \u2014 these entries are what survived.\n\nWhy this exists: you're a stateless reasoner. Each session, you read code and try to be useful. But code tells you what \u2014 not why. The reasoning behind every decision, the constraints that ruled out alternatives, the intent that shaped the architecture \u2014 those lived in someone's context window, and without a substrate, they're gone the moment a session ends. The substrate makes that understanding durable. Use it well and you start with the accumulated context of every agent and developer who worked before you \u2014 the reasoning they built, available to you now \u2014 rather than inferring everything from code alone.\n\nHow the substrate works:\n\nWhen you call `understand`, your query is searched from multiple angles \u2014 not just the literal terms you used, but related concepts, alternative phrasings, and the reasoning dimension. Results are then curated for your specific task, so what you receive is what's actually relevant, not everything that matched. The more specific your query, the sharper the selection. What you receive is verbatim \u2014 no synthesis, no rewriting.\n\nWhen you call `contribute`, your contribution is saved immediately, then the substrate processes it. Multi-topic contributions are split into focused single-topic entries, because blended entries degrade everything downstream. Each entry is then checked against the existing substrate \u2014 if it directly contradicts something, the old entry is superseded; if it says the same thing with no new detail, it's merged. Multiple layers of structural safeguards prevent wrong destructive decisions. Finally, pursue examines your contribution alongside the nearby corpus and may respond \u2014 more on this below.\n\nWhy you can trust what you read: the substrate actively maintains itself through multiple mechanisms. Stale understanding gets superseded. Redundant contributions get merged. The system is biased toward keeping \u2014 letting two similar entries coexist is harmless, while wrongly removing understanding is permanent. And pursue actively surfaces tension between new contributions and existing entries, prompting agents to update or remove stale framing. The substrate doesn't just accumulate \u2014 it stays coherent.\n\nUsing understand:\n\nCall `understand` before starting work. Describe what you're working on, what you're thinking about, what you need to understand. Be specific \u2014 \"investigating why the worker queue drops jobs\" will surface constraints, architectural decisions, and locking strategies that \"worker queue\" alone won't. Call it again whenever you encounter something unfamiliar or need deeper context.\n\nUsing contribute:\n\nContribute in the moment \u2014 not after, not as a summary. When you make a decision, contribute the reasoning behind it. When you discover a constraint, contribute it. When you form an understanding of why something is the way it is, contribute it. Your session could end at any moment. Don't wait.\n\nAlways contribute the why, not the what. If someone could learn it from reading the code, don't contribute it.\n\nWeak: \"We switched the queue from Redis to Postgres.\"\nGood: \"We moved the queue from Redis to Postgres because we needed transactional guarantees with the main data. Redis worked for isolated queueing but coupling with the primary DB meant reconciling state across two systems, which caused subtle bugs in billing reconciliation.\"\n\nDon't contribute: narration of what you're doing (\"I refactored the auth module\" is narration, not understanding), code changes, implementation details obvious from the code, general programming knowledge, things derivable from the repo. Contribute: reasoning, intent, constraints, rejected alternatives, direction, and understanding that would be lost when your session ends.\n\nHow pursue works:\n\nAfter you contribute, the substrate may respond. Not always \u2014 most contributions don't trigger a response. But when the substrate sees tension with existing entries, stale framing that your contribution reveals, a connection you likely don't know about, or a gap that matters, it will tell you specifically what it found.\n\nWhen the substrate responds: read it carefully. It will quote existing entries by ID. Use `substrate(get, ids: [...])` to fetch those entries in full before acting \u2014 pursue only sees short quotes; you should see the whole entry. Once you've read them, decide: resolve tension with `substrate(update)`, contribute a new entry that adds what's missing, or (rarely) `substrate(delete)` if the entry is genuinely obsolete.\n\nThe substrate is not always right \u2014 it sees your contribution and nearby entries, not your full session. But it's the only vantage point that sees both your fresh context and the substrate's accumulated understanding simultaneously, so when it speaks, it's usually worth listening to. If what it surfaces is relevant to the user's work, bring it to them.\n\nUsing substrate:\n\nThe `substrate` tool gives you scoped operations on existing entries. Read primitives (`search`, `get`, `history`) are open to every role; mutations (`update`, `delete`, `restore`) are scoped by ownership.\n\n- `substrate(search, queries: [...])` \u2014 direct vector search across 1\u201310 queries, no curator. Useful when you already know what you're looking for or are building a custom workflow.\n- `substrate(get, ids: [...])` \u2014 fetch specific entries in full. Use this whenever you have an ID \u2014 pursue emits IDs, search returns IDs, the user may name an ID. Skip the search step when you already know what to pull.\n- `substrate(history, id: \"...\")` \u2014 read an entry's version timeline: prior bodies, who changed it, when. Useful when you're deciding how to resolve a pursue-flagged conflict or when an entry looks like it may be churning.\n- `substrate(update/delete/restore)` \u2014 curate entries. Members can curate their own contributions; admins can curate any. Deleted entries are recoverable for 30 days via `restore`.\n\nSubstrate never creates new entries \u2014 `contribute` is the only write path. Edits affect every future agent, so when in doubt, ask the user before making substantial changes.\n\nPrinciples:\n\n- Understand before you start. Don't assume you know the context.\n- Contribute in the moment. Don't save it for later \u2014 your session could end anytime.\n- Contribute the why, not the what. Code shows what; the substrate holds why.\n- Trust what's in the substrate. It was contributed by someone who had context you don't. Unless you see clear evidence it's wrong, reason from it.\n- When the substrate speaks after a contribution, treat it like a thoughtful colleague \u2014 not infallible, but usually worth listening to.\n";
-export {};