mneme-ai 2.196.0 → 2.197.0

package/dist/commands/geo.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `mneme geo` (v2.197.0) — GEOLOGICAL MEMORY: the compliant, self-cleaning ledger.
+ *   geo add <text>        — seed a raw entry
+ *   geo metamorphose      — run a geological cycle: old+idle raw → abstract (purged+signed) → axiom
+ *   geo forget <needle>   — right-to-be-forgotten: purge matching raw NOW + signed tombstone
+ *   geo verify            — verify every purge proof + the audit chain OFFLINE
+ *   geo status            — tiers + raw bytes reclaimed + compliance
+ *
+ * Memory does not pile up forever — it metamorphoses: the WISDOM is kept, the RAW is
+ * destroyed, provably. Right-to-be-forgotten by construction; no database bloat.
+ */
+import type { Command } from "commander";
+export declare function registerGeoCommands(program: Command): void;
+//# sourceMappingURL=geo.d.ts.map

package/dist/commands/geo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../../src/commands/geo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC1D"}

package/dist/commands/geo.js

@@ -0,0 +1,62 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { geo } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+const statePath = (cwd) => join(cwd, ".mneme", "geo", "state.json");
+function load(cwd) { const p = statePath(cwd); if (!existsSync(p))
+    return geo.emptyGeo(); try {
+    return JSON.parse(readFileSync(p, "utf8"));
+}
+catch {
+    return geo.emptyGeo();
+} }
+function save(cwd, s) { mkdirSync(join(cwd, ".mneme", "geo"), { recursive: true }); writeFileSync(statePath(cwd), JSON.stringify(s), "utf8"); }
+export function registerGeoCommands(program) {
+    const g = program.command("geo").description("🌋 GEOLOGICAL MEMORY — the compliant, self-cleaning ledger. Raw dissolves to abstract→axiom over time; the wisdom is kept, the raw is destroyed (provably). Right-to-be-forgotten by construction.");
+    g.command("add <text...>").description("Seed a raw memory entry.").action((text) => {
+        const cwd = process.cwd();
+        const raw = text.join(" ");
+        const id = "r:" + createHash("sha256").update(raw + Date.now()).digest("hex").slice(0, 12);
+        save(cwd, geo.seedRaw(load(cwd), { id, raw, ts: Date.now() }));
+        out(`✓ seeded raw entry ${id} (${Buffer.byteLength(raw, "utf8")}b). It will metamorphose with age.`);
+    });
+    g.command("metamorphose").description("Run a geological cycle: old+idle raw → abstract (purged + signed) → axiom. Idempotent; safe to run on the daemon's idle tick.")
+        .option("--decay-days <n>", "age past which raw decays", "90").option("--idle-days <n>", "no-access window required", "30")
+        .action((opts) => {
+        const cwd = process.cwd();
+        const before = geo.geoStats(load(cwd));
+        const after = geo.metamorphose(cwd, load(cwd), Date.now(), { decayDays: parseInt(opts.decayDays ?? "90", 10), idleDays: parseInt(opts.idleDays ?? "30", 10) });
+        save(cwd, after);
+        const st = geo.geoStats(after);
+        out(`🌋 metamorphosed · raw ${before.raw}→${st.raw} · abstract ${st.abstract} · axiom ${st.axiom} · ${st.rawBytesReclaimed}b raw reclaimed (destroyed + signed-purged).`);
+    });
+    g.command("forget <needle>").description("Right-to-be-forgotten: purge any raw matching <needle> NOW + emit a signed tombstone (no content survives).")
+        .action((needle) => {
+        const cwd = process.cwd();
+        const after = geo.forget(cwd, load(cwd), needle, Date.now());
+        save(cwd, after);
+        const gone = !geo.containsRaw(after, needle);
+        out(`${gone ? "✓" : "✗"} forget "${needle}" — ${gone ? "purged + signed tombstone (verifiable)" : "nothing matched"}.`);
+    });
+    g.command("verify").description("Verify every purge proof (Ed25519, offline) + the metamorphosis audit chain. Exit 2 on failure.")
+        .action(() => {
+        const v = geo.verifyGeo(load(process.cwd()));
+        out(`🌋 purge proofs ${v.proofsValid}/${v.proofsTotal} valid · audit chain ${v.chainIntact ? "intact ✓" : `BROKEN at ${v.brokenAt} ✗`} — ${v.ok ? "compliant: raw was provably destroyed, wisdom + proof remain." : "issues found"}`);
+        if (!v.ok)
+            process.exitCode = 2;
+    });
+    g.command("status", { isDefault: true }).description("Tiers + reclaimed bytes + compliance.").action(() => {
+        const cwd = process.cwd();
+        const s = load(cwd);
+        const st = geo.geoStats(s);
+        const v = geo.verifyGeo(s);
+        if (!s.cells.length) {
+            out("geo memory empty — `mneme geo add <text>` to seed, then `mneme geo metamorphose`.");
+            return;
+        }
+        out(`🌋 Geological memory: raw ${st.raw} · abstract ${st.abstract} · axiom ${st.axiom} · purged ${st.purged} (${st.rawBytesReclaimed}b reclaimed)`);
+        out(`   compliance: ${v.proofsValid}/${v.proofsTotal} purge proofs valid · chain ${v.chainIntact ? "intact ✓" : "BROKEN ✗"} — the wisdom stays, the raw is provably gone.`);
+    });
+}
+//# sourceMappingURL=geo.js.map

package/dist/commands/geo.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqLA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqlNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsLA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAslNvD"}

package/dist/index.js

@@ -99,6 +99,7 @@ import { registerXrayCommands } from "./commands/xray.js";
 import { registerAttestCommands } from "./commands/attest.js";
 import { registerAccountabilityCommands } from "./commands/accountability.js";
 import { registerWarmCommands } from "./commands/warm.js";
+import { registerGeoCommands } from "./commands/geo.js";
 import { registerAdamasCommands } from "./commands/adamas.js";
 import { registerPrismCommands } from "./commands/prism.js";
 import { registerGoldilocksCommands } from "./commands/goldilocks.js";
@@ -4765,6 +4766,7 @@ export async function run(argv) {
     registerAttestCommands(program);
     registerAccountabilityCommands(program);
     registerWarmCommands(program);
+    registerGeoCommands(program);
     registerAdamasCommands(program);
     registerPrismCommands(program);
     registerGoldilocksCommands(program);