feat: add cross-harness memory vault (#2581)

Add a local-first, cross-harness memory vault with CLI and MCP surfaces, bounded search and storage, harness-scoped visibility, setup guidance, and comprehensive tests.

tests/ci/unified-memory-surface.test.js

@@ -0,0 +1,69 @@
+'use strict';
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+
+const REPO_ROOT = path.join(__dirname, '..', '..');
+const SKILL_PATHS = [
+  'skills/unified-memory/SKILL.md',
+  '.agents/skills/unified-memory/SKILL.md',
+  '.cursor/skills/unified-memory/SKILL.md',
+];
+const RUNTIME_DOC_PATHS = [
+  ...SKILL_PATHS,
+  'README.md',
+  'docs/HERMES-SETUP.md',
+  'README.zh-CN.md',
+  'docs/zh-CN/README.md',
+];
+
+let passed = 0;
+let failed = 0;
+
+function test(name, fn) {
+  try {
+    fn();
+    console.log(`  PASS ${name}`);
+    passed += 1;
+  } catch (error) {
+    console.log(`  FAIL ${name}`);
+    console.log(`    ${error.stack || error.message}`);
+    failed += 1;
+  }
+}
+
+function read(relativePath) {
+  return fs.readFileSync(path.join(REPO_ROOT, relativePath), 'utf8');
+}
+
+function stripFrontmatter(source) {
+  return source.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
+}
+
+console.log('\n=== Testing unified-memory install and adapter surfaces ===\n');
+
+test('documents the separately installed ECC runtime on every exposed surface', () => {
+  for (const relativePath of RUNTIME_DOC_PATHS) {
+    const source = read(relativePath);
+    assert.match(
+      source,
+      /npm install -g ecc-universal/i,
+      `${relativePath} must state how to install the required CLI runtime`
+    );
+    assert.match(
+      source,
+      /ecc-memory-mcp/,
+      `${relativePath} must identify the optional MCP binary`
+    );
+  }
+});
+
+test('keeps harness-specific unified-memory skill bodies in sync', () => {
+  const bodies = SKILL_PATHS.map(relativePath => stripFrontmatter(read(relativePath)));
+  assert.strictEqual(bodies[1], bodies[0], `${SKILL_PATHS[1]} body drifted`);
+  assert.strictEqual(bodies[2], bodies[0], `${SKILL_PATHS[2]} body drifted`);
+});
+
+console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);
+process.exit(failed > 0 ? 1 : 0);