@mneme-ai/core 2.55.0 → 2.57.0

package/dist/xai_alignment/stargate.js

@@ -0,0 +1,131 @@
+/**
+ * v2.56.0 — STARGATE: open-source the augmented calibration corpus.
+ *
+ * Inspired by SpaceX's open-source philosophy ("the patents are stolen
+ * anyway; better to share") + xAI's Grok open-weight commitments.
+ *
+ * Premise: NEMESIS's calibration corpus (seed + augmenter) is the most
+ * valuable training-data artifact Mneme owns for AI agent identity
+ * verification. By publishing it MIT-licensed, Mneme becomes the
+ * "Switzerland of AI vendor fingerprinting" — every vendor (Anthropic /
+ * OpenAI / xAI / Google) can train classifiers against the same
+ * public ground truth. Result: cross-vendor accountability becomes a
+ * commodity that compounds Mneme's protocol position.
+ *
+ * `mneme stargate publish [--out path] [--format json|jsonl|md]`
+ *   - Builds the full augmented corpus (15 fixtures × 6 vendors × 6
+ *     augmentations = 540 fixtures via v2.53 augmenter)
+ *   - Emits a single bundle file with provenance + license + HMAC seal
+ *
+ * Pure deterministic + defensive; never throws.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createHmac, createHash } from "node:crypto";
+import { buildAugmentedCorpus } from "../nemesis/corpus_augmenter.js";
+const KEY_ENV = "MNEME_STARGATE_KEY";
+const DEFAULT_KEY = "mneme-stargate-v1";
+function keyOf() { return process.env[KEY_ENV] ?? DEFAULT_KEY; }
+export function buildStargateBundle(mnemeVersion) {
+    const corpus = buildAugmentedCorpus();
+    const vendors = Array.from(new Set(corpus.map((c) => c.vendor)));
+    const augmentationKinds = Array.from(new Set(corpus.map((c) => c.augmentationKind)));
+    const at = new Date().toISOString();
+    const bundleId = `STARGATE-${mnemeVersion}-${corpus.length}`;
+    const contentSha256 = createHash("sha256").update(JSON.stringify(corpus)).digest("hex");
+    const bodyForHmac = { bundleId, contentSha256, at, mnemeVersion };
+    const hmac = createHmac("sha256", keyOf()).update(JSON.stringify(bodyForHmac)).digest("hex");
+    const citation = `Mneme STARGATE corpus v${mnemeVersion} — ${corpus.length} fixtures across ${vendors.length} vendors and ${augmentationKinds.length} augmentation kinds (ORIGINAL + STRIP_DIFF_HEADER + NATURALISE_PR + SPARSE_COMMITS + DENSE_COMMITS + WHITESPACE_NOISE). MIT-licensed for unrestricted training + verification. SHA-256: ${contentSha256.slice(0, 16)}... HMAC seal: ${hmac.slice(0, 16)}...`;
+    return {
+        bundleId,
+        mnemeVersion,
+        fixtureCount: corpus.length,
+        vendors,
+        augmentationKinds,
+        at,
+        license: "MIT",
+        fixtures: corpus,
+        contentSha256,
+        hmac,
+        citation,
+    };
+}
+/** Verify a STARGATE bundle's integrity (offline). */
+export function verifyStargateBundle(bundle) {
+    if (!bundle || typeof bundle.hmac !== "string")
+        return { ok: false, reason: "missing bundle or hmac" };
+    // Re-derive contentSha256 from fixtures + compare
+    const expectedSha = createHash("sha256").update(JSON.stringify(bundle.fixtures)).digest("hex");
+    if (expectedSha !== bundle.contentSha256) {
+        return { ok: false, reason: "content SHA mismatch (fixtures edited after bundling)" };
+    }
+    const bodyForHmac = {
+        bundleId: bundle.bundleId,
+        contentSha256: bundle.contentSha256,
+        at: bundle.at,
+        mnemeVersion: bundle.mnemeVersion,
+    };
+    const expected = createHmac("sha256", keyOf()).update(JSON.stringify(bodyForHmac)).digest("hex");
+    if (expected !== bundle.hmac)
+        return { ok: false, reason: "hmac mismatch" };
+    return { ok: true, reason: "STARGATE bundle verified — content + seal intact" };
+}
+function renderMarkdown(bundle) {
+    const lines = [];
+    lines.push(`# Mneme STARGATE Corpus v${bundle.mnemeVersion}`);
+    lines.push("");
+    lines.push(`**License:** MIT — unrestricted training + verification use.`);
+    lines.push(`**Bundle ID:** \`${bundle.bundleId}\``);
+    lines.push(`**Built at:** ${bundle.at}`);
+    lines.push(`**Total fixtures:** ${bundle.fixtureCount}`);
+    lines.push(`**Vendors covered:** ${bundle.vendors.join(", ")}`);
+    lines.push(`**Augmentation kinds:** ${bundle.augmentationKinds.join(", ")}`);
+    lines.push("");
+    lines.push("## Provenance");
+    lines.push("");
+    lines.push(bundle.citation);
+    lines.push("");
+    lines.push("## Verification");
+    lines.push("");
+    lines.push("```");
+    lines.push(`SHA-256: ${bundle.contentSha256}`);
+    lines.push(`HMAC:    ${bundle.hmac}`);
+    lines.push("```");
+    lines.push("");
+    lines.push("## Fixtures");
+    lines.push("");
+    lines.push("```json");
+    lines.push(JSON.stringify(bundle.fixtures.slice(0, 3), null, 2));
+    lines.push("```");
+    lines.push("");
+    lines.push(`*(showing first 3 of ${bundle.fixtureCount} — full set in JSON / JSONL format)*`);
+    return lines.join("\n");
+}
+export function publishStargate(input = {}) {
+    try {
+        const mnemeVersion = input.mnemeVersion ?? "2.56.0";
+        const bundle = buildStargateBundle(mnemeVersion);
+        if (!input.outPath) {
+            return { ok: true, bundle, reason: "in-memory bundle built (no outPath supplied)" };
+        }
+        const format = input.format ?? "json";
+        const body = format === "md" ? renderMarkdown(bundle) :
+            format === "jsonl" ? bundle.fixtures.map((f) => JSON.stringify(f)).join("\n") + "\n" :
+                JSON.stringify(bundle, null, 2);
+        try {
+            const dir = dirname(input.outPath);
+            if (dir && !existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            writeFileSync(input.outPath, body, "utf8");
+        }
+        catch (e) {
+            return { ok: false, reason: `write failed: ${e.message}` };
+        }
+        return { ok: true, bundle, path: input.outPath, bytes: Buffer.byteLength(body), reason: `STARGATE bundle written to ${input.outPath} (${format}, ${Buffer.byteLength(body)} bytes)` };
+    }
+    catch (e) {
+        return { ok: false, reason: `STARGATE publish failed: ${e.message}` };
+    }
+}
+void join;
+//# sourceMappingURL=stargate.js.map

package/dist/xai_alignment/stargate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "2.55.0",
+  "version": "2.57.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",