memnant 0.1.0 → 0.2.0

package/README.md

@@ -1,100 +1,170 @@
 # memnant
 
-Your agent forgets everything between sessions. memnant is the structured ledger that survives.
+Shared project memory for any MCP client.
 
-Context windows die. Conversations end. Three weeks later you're re-explaining decisions your agent already made with you. memnant gives your agent a typed, searchable, staleness-aware decision ledger — and it already knows how to use it.
+## The problem
 
-**[memnant.vercel.app](https://memnant.vercel.app)**
+Your AI agent forgets everything between sessions. The Next.js caching gotcha you solved last Tuesday? Gone. The architecture decision from three weeks ago? Not in the context window.
 
-## Get started
+But the real problem is bigger. Platform memory is locked to one client and one project. Claude Code's memory doesn't work in Cursor. Cursor's memory doesn't work in Windsurf. And none of them carry the framework fix you solved in project A into project B.
+
+memnant is locked to nothing. It works across any MCP-compatible agent, any project, any session. Your engineering knowledge compounds everywhere you build.
+
+## How it works
+
+**It remembers.** The agent silently logs decisions, framework fixes, and rejections during conversation. Every record gets a vector embedding for semantic search. Ask "auth approach" and find the record where you chose JWTs over sessions.
+
+**It compiles.** Sessions start and close automatically. At session start, memnant compiles context: last session's log, open TODOs, relevant decisions, framework fixes, staleness warnings. Three weeks away? One command. Full context. Under two minutes.
+
+**It flags.** Codebase snapshots track file hashes. When a file changes after a decision was logged about it, that record is flagged `[stale]` everywhere. Every other memory tool serves old decisions as current. memnant tracks validity.
+
+**It travels.** Export framework fixes from one project, import them into the next. The gotcha you solved once never bites you again — across any project, any codebase. No platform memory tool can do this because they're siloed by project. Your experience isn't.
+
+## Quick start
 
 ```bash
-cd your-project
 npx memnant
 ```
 
-That's it. First run walks you through setup — project name, agent config, starter specs. Every run after that starts a session and prints compiled context. Open your agent, start building.
+First run creates your config and ledger. After that, it starts a session with compiled context.
 
-## How it works
+Add memnant to your agent's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "memnant": {
+      "command": "memnant",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+Start building. The agent logs decisions automatically. Start your next session with full context.
+
+## What a session looks like
+
+```
+$ npx memnant
 
-1. **Run one command.** `npx memnant` in any project. It auto-detects what to do: first time → guided setup, no session → start one, in session → show status.
+▪ memnant · session start
+Compiled context: ~4,200 tokens
 
-2. **Open your agent.** memnant registers as an MCP server. Your agent gets 7 tools — recall, log, session context, session close, copy check, design check, status. It already knows when to call them.
+── Last Session (Feb 21) ──
+Shipped: snapshot-first analytics pipeline
+Decided: materialised views over live aggregation
+TODO: wire dashboard filters to snapshot queries
 
-3. **Build.** Your agent checks prior decisions before making new ones. Logs what it decides. Catches stale records when the codebase drifts. Closes the session with a summary when you're done — through conversation, not CLI.
+── Relevant Decisions (3) ──
+[a3f2] Chose snapshot-first analytics — live adds 200ms
+[b7e1] Dashboard uses server components, no client state
+[c4d9] [stale] Analytics schema — analytics.ts changed Feb 24
 
-## What the agent gets
+── Framework Fixes (1) ──
+[d2a8] Next.js 15: useSearchParams needs Suspense boundary
 
-### Decision Ledger
-Append-only records with vector embeddings. Decisions, framework fixes, spec snapshots — all semantically searchable. The agent calls `memnant_recall` and finds what it needs.
+Session e8f3 started. Good building.
+```
+
+## Fixes that travel
 
-### Session Lifecycle
-Compiled context at session start: last session's log, open TODOs, relevant decisions, framework fixes, spec constraints. Session close happens through the agent via `memnant_session_close`. No CLI needed.
+```bash
+# In project A — you solved a Next.js gotcha
+memnant export --type framework_fix --format portable
+
+# In project B — it's already there before you hit it
+memnant import .../framework-fixes.portable.json
+# → Imported 3 framework fixes (1 skipped as duplicate)
+```
 
-### Staleness Detection
-Codebase snapshots track file hashes. When a file changes after a decision was logged about it, that record is flagged `[stale]` in recall and session context.
+Framework fixes aren't project-specific. The caching bug you solved in your SaaS app applies to your next Next.js project. `memnant export` strips project-specific fields (embeddings, relationships, staleness). `memnant import` re-generates embeddings locally, deduplicates, and tags imports with their source.
 
-### Spec Governor
-Copy audits catch banned phrases. Design system checks catch banned components. The agent validates via MCP tools. Also runs in CI with `memnant lint`.
+Platform memory is siloed by project. Your experience isn't.
 
-### Model Orchestrator
-Three tiers: triage (Haiku), analysis (Sonnet), build (Opus). Each gets tier-appropriate context.
+## Under the hood
 
-## MCP Tools
+**Storage.** Single SQLite file at `.memnant/ledger.db`. Copy it to another machine and everything comes with you.
 
-memnant exposes 7 tools via MCP (stdio transport):
+**Search.** Local vector embeddings via all-MiniLM-L6-v2. Semantic search on CPU. No API calls. Works on a plane.
 
-| Tool | Description |
-|------|-------------|
-| `memnant_recall` | Semantic search across all records |
-| `memnant_log` | Log a decision, framework fix, or session log |
-| `memnant_session_context` | Get compiled session context |
-| `memnant_session_close` | Close the active session with a summary |
+**Integration.** MCP server over stdio. 10 tools. Plugs into Claude Code, Cursor, or any MCP-compatible agent.
+
+**Config.** `memnant.yaml` at your project root. Version-controlled. No dashboard, no account, no login.
+
+**Export.** Markdown or JSON. Every record, every decision, every session log. Your history is never locked in.
+
+## As your ledger grows
+
+The core loop is four things: remember, compile, flag, travel. As records accumulate, memnant has depth that earns its way in.
+
+| Capability | What it does | Requires |
+|---|---|---|
+| **Connection Graph** | Records auto-link, supersede, and contradict at write time | Records in the ledger |
+| **Relevance Scoring** | 4-signal composite: similarity, recency, freshness, frequency | Configurable in memnant.yaml |
+| **Synthesis** | Cross-record questions with citations | `ANTHROPIC_API_KEY` |
+| **Spec Governor** | Copy audits, design checks, persona tests, CI lint | Spec docs in `docs/` |
+| **Predictive Context** | File-aware search, branch detection, co-occurrence patterns | Builds over sessions |
+| **Model Routing** | Route tasks to Haiku/Sonnet/Opus with tier-appropriate context | API keys |
+| **Health Monitoring** | Staleness rate, contradictions, spec drift, status levels | — |
+| **Continuous Governance** | Pre-commit hooks, override tracking, governance feedback | Spec docs + git hooks |
+| **Telegram** | Triage from your phone | `MEMRANT_TELEGRAM_TOKEN` |
+
+Every capability is independent. Use what you need. Ignore the rest.
+
+## Core commands
+
+```bash
+npx memnant                     # auto-detect: init, start session, or status
+memnant log --type decision     # write a record
+memnant recall "auth approach"  # semantic search
+memnant session start           # compile context
+memnant session close           # capture what happened
+memnant snapshot                # codebase snapshot for staleness
+memnant export                  # full ledger to markdown/JSON
+memnant lint                    # validate against spec docs
+```
+
+25 commands total. Full reference in the [docs](docs/).
+
+## MCP tools
+
+| Tool | Purpose |
+|---|---|
+| `memnant_recall` | Semantic search over the ledger |
+| `memnant_log` | Write a record (auto-starts session) |
+| `memnant_session_context` | Compiled context for session start |
+| `memnant_session_close` | Close session with summary |
 | `memnant_status` | Project status |
 | `memnant_check_copy` | Copy audit against spec |
 | `memnant_check_design` | Design system validation |
+| `memnant_synthesise` | Cross-record questions with citations |
+| `memnant_context_for_file` | Records relevant to a specific file |
+| `memnant_project_brief` | Dynamic 500-token project summary |
 
-MCP is auto-configured by `npx memnant` on first run. Works with Claude Code, Codex, and any MCP-compatible agent.
+## What it's not
 
-## Advanced CLI
+**Not agent memory.** Agent memory stores preferences from conversations. memnant stores typed decisions with staleness tracking. It's a ledger, not a scratchpad.
 
-All commands are still available for scripts, CI, and power users:
+**Not a context window.** Context windows are session-scoped. memnant is cross-session. It selects the right subset and injects it.
 
-```
-memnant init              memnant session start     memnant check-copy
-memnant setup claude-code memnant session close     memnant check-design
-memnant setup codex       memnant session status    memnant test-persona
-memnant log               memnant snapshot          memnant lint
-memnant recall            memnant export            memnant serve
-memnant ask               memnant specs             memnant instructions
-```
+**Not CLAUDE.md.** Static instructions tell agents how to behave. memnant is dynamic institutional knowledge — what was decided, when, why, and whether it's still valid.
 
-## Stack
+**Not chat history.** Chat history is what was said. memnant is what was decided.
 
-- TypeScript, Node.js (ESM)
-- SQLite via node-sqlite3-wasm
-- Local vector embeddings via @xenova/transformers (all-MiniLM-L6-v2)
-- CLI via Commander.js
-- MCP server via @modelcontextprotocol/sdk
-- 192 tests via vitest
+## Who it's for
 
-## Development
+Solo builders shipping multiple products with AI agents. You work in sessions — days or weeks apart. You juggle 3-4 projects. You already have agents doing the work. You need your engineering knowledge to compound across everything you build, not reset every time you switch projects.
 
-```bash
-git clone https://github.com/peureka/memnant.git
-cd memnant
-npm install
-npm run build
-npm test
-```
+The test: three weeks away from a project, `npx memnant` gives full context in under two minutes. Switch to a new project, `memnant import` brings your framework fixes with you.
+
+## Dependencies
+
+**Required:** Node.js >= 20
 
-## Documentation
+**Bundled:** SQLite (WASM, no native deps), local embeddings, MCP SDK
 
-- [`docs/PRODUCT.md`](docs/PRODUCT.md) — What memnant is, what it isn't, why it's different
-- [`docs/SPEC.md`](docs/SPEC.md) — Data model and system behaviours
-- [`docs/PLAN.md`](docs/PLAN.md) — Build plan with epics, stories, and acceptance criteria
-- [`docs/PROJECT_INSTRUCTIONS.md`](docs/PROJECT_INSTRUCTIONS.md) — Decision framework
-- [`docs/PERSONA_KAI.md`](docs/PERSONA_KAI.md) — Primary persona
+**Optional:** `ANTHROPIC_API_KEY` for synthesis and routing. `MEMRANT_TELEGRAM_TOKEN` for Telegram. Core functionality — ledger, sessions, recall, staleness, export, lint — works fully offline with no API keys.
 
 ## License
 

package/dist/cli/archive.d.ts

@@ -0,0 +1,9 @@
+/**
+ * memnant archive / unarchive — Archive old or superseded records.
+ *
+ * Archived records are excluded from recall, context compilation, and export.
+ * They are not deleted — they can be unarchived later.
+ */
+import { Command } from 'commander';
+export declare function registerArchiveCommand(program: Command): void;
+//# sourceMappingURL=archive.d.ts.map

package/dist/cli/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/cli/archive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE7D"}

package/dist/cli/archive.js

@@ -0,0 +1,101 @@
+/**
+ * memnant archive / unarchive — Archive old or superseded records.
+ *
+ * Archived records are excluded from recall, context compilation, and export.
+ * They are not deleted — they can be unarchived later.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import yaml from 'js-yaml';
+import { openDatabase } from '../ledger/database.js';
+import { archiveRecord, unarchiveRecord, unarchiveAll, archiveSuperseded, archiveStaleOlderThan, } from '../ledger/admin.js';
+function loadDb() {
+    const cwd = process.cwd();
+    const configPath = join(cwd, 'memnant.yaml');
+    if (!existsSync(configPath)) {
+        console.error('No memnant project found. Run `memnant init` first.');
+        process.exit(1);
+    }
+    const config = yaml.load(readFileSync(configPath, 'utf-8'));
+    const dbPath = join(cwd, config.memory.db_path);
+    if (!existsSync(dbPath)) {
+        console.error(`Ledger database not found at ${config.memory.db_path}. Run \`memnant init\` to recreate.`);
+        process.exit(1);
+    }
+    return openDatabase(dbPath);
+}
+function parseDuration(duration) {
+    const match = duration.match(/^(\d+)d$/);
+    if (!match) {
+        console.error(`Invalid duration '${duration}'. Expected format: <number>d (e.g. 90d for 90 days).`);
+        process.exit(1);
+    }
+    return parseInt(match[1], 10);
+}
+export function registerArchiveCommand(program) {
+    program
+        .command('archive')
+        .description('Archive old or superseded records')
+        .option('--id <id>', 'Archive a single record')
+        .option('--superseded', 'Archive all superseded records')
+        .option('--stale-older-than <duration>', 'Archive stale records older than duration (e.g. 90d)')
+        .action((opts) => {
+        if (!opts.id && !opts.superseded && !opts.staleOlderThan) {
+            console.error('Specify at least one: --id <id>, --superseded, or --stale-older-than <duration>');
+            process.exit(1);
+        }
+        const db = loadDb();
+        try {
+            if (opts.id) {
+                archiveRecord(db, opts.id);
+                console.log(`Archived record ${opts.id.slice(0, 8)}.`);
+            }
+            if (opts.superseded) {
+                const count = archiveSuperseded(db);
+                console.log(`Archived ${count} superseded record(s).`);
+            }
+            if (opts.staleOlderThan) {
+                const days = parseDuration(opts.staleOlderThan);
+                const count = archiveStaleOlderThan(db, days);
+                console.log(`Archived ${count} stale record(s) older than ${days} days.`);
+            }
+        }
+        catch (err) {
+            console.error(err.message);
+            process.exit(1);
+        }
+        finally {
+            db.close();
+        }
+    });
+    program
+        .command('unarchive')
+        .description('Restore archived records')
+        .option('--id <id>', 'Unarchive a single record')
+        .option('--all', 'Unarchive all archived records')
+        .action((opts) => {
+        if (!opts.id && !opts.all) {
+            console.error('Specify at least one: --id <id> or --all');
+            process.exit(1);
+        }
+        const db = loadDb();
+        try {
+            if (opts.id) {
+                unarchiveRecord(db, opts.id);
+                console.log(`Unarchived record ${opts.id.slice(0, 8)}. It will appear in queries again.`);
+            }
+            if (opts.all) {
+                const count = unarchiveAll(db);
+                console.log(`Unarchived ${count} record(s).`);
+            }
+        }
+        catch (err) {
+            console.error(err.message);
+            process.exit(1);
+        }
+        finally {
+            db.close();
+        }
+    });
+}
+//# sourceMappingURL=archive.js.map

package/dist/cli/archive.js.map

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

package/dist/cli/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/cli/export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoE5D"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/cli/export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsF5D"}

package/dist/cli/export.js

@@ -9,6 +9,7 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync, rmSync } from 'fs';
 import { join } from 'path';
 import yaml from 'js-yaml';
 import { openDatabase } from '../ledger/database.js';
+import { RECORD_TYPES } from '../types.js';
 const TYPE_SUBDIRS = {
     decision: 'decisions',
     session_log: 'session_logs',
@@ -16,17 +17,25 @@ const TYPE_SUBDIRS = {
     spec_snapshot: 'spec_snapshots',
     codebase_snapshot: 'codebase_snapshots',
     orchestrator_task: 'orchestrator_tasks',
+    synthesis_cache: 'synthesis_cache',
+    governance_override: 'governance_overrides',
 };
 export function registerExportCommand(program) {
     program
         .command('export')
         .description('Export the ledger to markdown or JSON')
-        .option('--format <format>', 'Export format: markdown or json', 'markdown')
+        .option('--format <format>', 'Export format: markdown, json, portable, or notebooklm', 'markdown')
         .option('--since <date>', 'Export only records after YYYY-MM-DD')
+        .option('--type <type>', 'Export only records of this type')
         .action((opts) => {
         // Validate --format
-        if (opts.format !== 'markdown' && opts.format !== 'json') {
-            console.error(`Unknown export format '${opts.format}'. Valid formats: markdown, json`);
+        if (!['markdown', 'json', 'portable', 'notebooklm'].includes(opts.format)) {
+            console.error(`Unknown export format '${opts.format}'. Valid formats: markdown, json, portable, notebooklm`);
+            process.exit(1);
+        }
+        // Validate --type
+        if (opts.type && !RECORD_TYPES.includes(opts.type)) {
+            console.error(`Unknown record type '${opts.type}'. Valid types: ${RECORD_TYPES.join(', ')}`);
             process.exit(1);
         }
         // Validate --since
@@ -48,18 +57,28 @@ export function registerExportCommand(program) {
             process.exit(1);
         }
         const db = openDatabase(dbPath);
-        // Query records
-        let query = 'SELECT id, type, content_text, tags, related_records, created_at FROM record';
+        // Query records (exclude retracted and archived)
+        let query = 'SELECT id, type, content_text, tags, related_records, created_at FROM record WHERE retracted_at IS NULL AND archived_at IS NULL';
         const params = [];
         if (opts.since) {
-            query += ' WHERE created_at >= ?';
+            query += ' AND created_at >= ?';
             params.push(opts.since + 'T00:00:00.000Z');
         }
+        if (opts.type) {
+            query += ' AND type = ?';
+            params.push(opts.type);
+        }
         query += ' ORDER BY created_at ASC';
         const records = db.all(query, params);
         db.close();
         const exportPath = join(cwd, config.memory.export_path);
-        if (opts.format === 'json') {
+        if (opts.format === 'notebooklm') {
+            exportNotebookLM(records, exportPath, config.project.name);
+        }
+        else if (opts.format === 'portable') {
+            exportPortable(records, exportPath, config.project.name);
+        }
+        else if (opts.format === 'json') {
             exportJson(records, exportPath);
         }
         else {
@@ -93,6 +112,68 @@ function exportMarkdown(records, exportPath) {
         writeFileSync(join(exportPath, subdir, filename), content);
     }
 }
+function exportPortable(records, exportPath, projectName) {
+    mkdirSync(exportPath, { recursive: true });
+    const portablePath = join(exportPath, 'framework-fixes.portable.json');
+    const data = {
+        memnant_version: '0.1.0',
+        source_project: projectName,
+        exported_at: new Date().toISOString(),
+        record_count: records.length,
+        records: records.map((r) => ({
+            type: r.type,
+            content_text: r.content_text,
+            tags: JSON.parse(r.tags),
+            original_id: r.id,
+            created_at: r.created_at,
+        })),
+    };
+    writeFileSync(portablePath, JSON.stringify(data, null, 2) + '\n');
+}
+const TYPE_LABELS_PLURAL = {
+    decision: 'Decisions',
+    session_log: 'Session Logs',
+    framework_fix: 'Framework Fixes',
+    spec_snapshot: 'Spec Snapshots',
+    codebase_snapshot: 'Codebase Snapshots',
+    orchestrator_task: 'Orchestrator Tasks',
+    synthesis_cache: 'Synthesis Cache',
+    governance_override: 'Governance Overrides',
+};
+function exportNotebookLM(records, exportPath, projectName) {
+    mkdirSync(exportPath, { recursive: true });
+    const filePath = join(exportPath, 'notebooklm.md');
+    const lines = [];
+    lines.push(`# ${projectName} — Project Knowledge Ledger`);
+    lines.push('');
+    lines.push(`Exported from memnant on ${new Date().toISOString().slice(0, 10)}. ${records.length} records.`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    // Group by type
+    const byType = new Map();
+    for (const r of records) {
+        const group = byType.get(r.type) || [];
+        group.push(r);
+        byType.set(r.type, group);
+    }
+    for (const [type, group] of byType) {
+        lines.push(`## ${TYPE_LABELS_PLURAL[type]} (${group.length})`);
+        lines.push('');
+        for (const r of group) {
+            const date = r.created_at.slice(0, 10);
+            const tags = JSON.parse(r.tags);
+            const tagStr = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
+            lines.push(`### ${date} — ${r.id.slice(0, 8)}${tagStr}`);
+            lines.push('');
+            lines.push(r.content_text);
+            lines.push('');
+            lines.push('---');
+            lines.push('');
+        }
+    }
+    writeFileSync(filePath, lines.join('\n'));
+}
 function exportJson(records, exportPath) {
     mkdirSync(exportPath, { recursive: true });
     const jsonPath = join(exportPath, 'export.json');

package/dist/cli/export.js.map

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

package/dist/cli/graph.d.ts

@@ -0,0 +1,9 @@
+/**
+ * memnant graph — Connection graph visualization and management.
+ *
+ * Story 9.4: Text-based graph, with --json, --type, --contradictions options.
+ * Also: unsupersede and dismiss-contradiction commands.
+ */
+import { Command } from 'commander';
+export declare function registerGraphCommand(program: Command): void;
+//# sourceMappingURL=graph.d.ts.map

package/dist/cli/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/cli/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsG3D"}

package/dist/cli/graph.js

@@ -0,0 +1,108 @@
+/**
+ * memnant graph — Connection graph visualization and management.
+ *
+ * Story 9.4: Text-based graph, with --json, --type, --contradictions options.
+ * Also: unsupersede and dismiss-contradiction commands.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import yaml from 'js-yaml';
+import { openDatabase } from '../ledger/database.js';
+import { buildGraph, formatGraphAsText } from '../graph/queries.js';
+import { unsupersede, dismissContradiction } from '../graph/relationships.js';
+export function registerGraphCommand(program) {
+    program
+        .command('graph')
+        .description('Show the connection graph between records')
+        .argument('[record-id]', 'Show connections for a specific record')
+        .option('--json', 'Output as JSON')
+        .option('--type <type>', 'Filter by record type')
+        .option('--contradictions', 'Show only unresolved contradictions')
+        .action((recordId, opts) => {
+        const cwd = process.cwd();
+        const configPath = join(cwd, 'memnant.yaml');
+        if (!existsSync(configPath)) {
+            console.error('No memnant project found. Run `memnant init` first.');
+            process.exit(1);
+        }
+        const config = yaml.load(readFileSync(configPath, 'utf-8'));
+        const dbPath = join(cwd, config.memory.db_path);
+        if (!existsSync(dbPath)) {
+            console.error(`Ledger database not found at ${config.memory.db_path}. Run \`memnant init\` to recreate.`);
+            process.exit(1);
+        }
+        const db = openDatabase(dbPath);
+        try {
+            const nodes = buildGraph(db, {
+                recordId,
+                type: opts.type,
+                contradictionsOnly: opts.contradictions,
+            });
+            if (opts.json) {
+                console.log(JSON.stringify(nodes, null, 2));
+            }
+            else {
+                console.log(formatGraphAsText(nodes));
+            }
+        }
+        finally {
+            db.close();
+        }
+    });
+    program
+        .command('unsupersede')
+        .description('Remove a supersession relationship for a record')
+        .argument('<record-id>', 'Record ID to unsupersede')
+        .action((recordId) => {
+        const cwd = process.cwd();
+        const configPath = join(cwd, 'memnant.yaml');
+        if (!existsSync(configPath)) {
+            console.error('No memnant project found. Run `memnant init` first.');
+            process.exit(1);
+        }
+        const config = yaml.load(readFileSync(configPath, 'utf-8'));
+        const dbPath = join(cwd, config.memory.db_path);
+        const db = openDatabase(dbPath);
+        try {
+            const removed = unsupersede(db, recordId);
+            if (removed) {
+                console.log(`Removed supersession relationship for record ${recordId.slice(0, 8)}.`);
+            }
+            else {
+                console.log(`No supersession relationship found for record ${recordId.slice(0, 8)}.`);
+            }
+        }
+        finally {
+            db.close();
+        }
+    });
+    program
+        .command('dismiss-contradiction')
+        .description('Dismiss a contradiction between two records')
+        .argument('<id1>', 'First record ID')
+        .argument('<id2>', 'Second record ID')
+        .action((id1, id2) => {
+        const cwd = process.cwd();
+        const configPath = join(cwd, 'memnant.yaml');
+        if (!existsSync(configPath)) {
+            console.error('No memnant project found. Run `memnant init` first.');
+            process.exit(1);
+        }
+        const config = yaml.load(readFileSync(configPath, 'utf-8'));
+        const dbPath = join(cwd, config.memory.db_path);
+        const db = openDatabase(dbPath);
+        try {
+            const dismissed = dismissContradiction(db, id1, id2);
+            if (dismissed) {
+                console.log(`Dismissed contradiction between ${id1.slice(0, 8)} and ${id2.slice(0, 8)}.`);
+            }
+            else {
+                console.log(`No active contradiction found between ${id1.slice(0, 8)} and ${id2.slice(0, 8)}.`);
+            }
+        }
+        finally {
+            db.close();
+        }
+    });
+}
+//# sourceMappingURL=graph.js.map