@memnexus-ai/mx-agent-cli 0.1.165 → 0.1.166

package/dist/__tests__/claude-md-compose.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLAUDE.md.template compose guard (Platform v2.35 Phase 2, #4017).
+ *
+ * The deployed artifact `mx-agent-system/agent-config/CLAUDE.md.template` is
+ * composed from a generic core (CLAUDE.core.md) + a MemNexus overlay
+ * (CLAUDE.overlay.memnexus.md) + variables (vars.memnexus.json). `deployClaudeMd`
+ * reads the composed artifact verbatim, so the artifact must stay byte-identical
+ * to compose(core + overlay + vars) or the source pieces silently drift from what
+ * actually ships. This test reproduces Phase 1's zero-behavior-change proof: it
+ * runs the real compose.mjs and asserts byte-equivalence with the checked-in
+ * template. compose.mjs lives next to the sources in agent-config (portable, no
+ * CLI dependency), so it is exercised via a Node subprocess rather than imported
+ * across the package boundary.
+ */
+export {};
+//# sourceMappingURL=claude-md-compose.test.d.ts.map

package/dist/__tests__/claude-md-compose.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-compose.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/claude-md-compose.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/__tests__/claude-md-compose.test.js

@@ -0,0 +1,116 @@
+/**
+ * CLAUDE.md.template compose guard (Platform v2.35 Phase 2, #4017).
+ *
+ * The deployed artifact `mx-agent-system/agent-config/CLAUDE.md.template` is
+ * composed from a generic core (CLAUDE.core.md) + a MemNexus overlay
+ * (CLAUDE.overlay.memnexus.md) + variables (vars.memnexus.json). `deployClaudeMd`
+ * reads the composed artifact verbatim, so the artifact must stay byte-identical
+ * to compose(core + overlay + vars) or the source pieces silently drift from what
+ * actually ships. This test reproduces Phase 1's zero-behavior-change proof: it
+ * runs the real compose.mjs and asserts byte-equivalence with the checked-in
+ * template. compose.mjs lives next to the sources in agent-config (portable, no
+ * CLI dependency), so it is exercised via a Node subprocess rather than imported
+ * across the package boundary.
+ */
+import { describe, it, expect } from 'vitest';
+import { readFileSync, existsSync } from 'fs';
+import { execFileSync } from 'child_process';
+import { dirname, join } from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function findRepoRoot(start) {
+    let dir = start;
+    for (let i = 0; i < 20; i++) {
+        if (existsSync(join(dir, 'mx-agent-system', 'agent-config')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`claude-md-compose: could not locate repo root from ${start}`);
+}
+const REPO_ROOT = findRepoRoot(__dirname);
+const CLAUDE_MD_DIR = join(REPO_ROOT, 'mx-agent-system', 'agent-config', 'claude-md');
+const COMPOSE = join(CLAUDE_MD_DIR, 'compose.mjs');
+const TEMPLATE_PATH = join(REPO_ROOT, 'mx-agent-system', 'agent-config', 'CLAUDE.md.template');
+/** Run `node -e <script>` and return { status, stderr }. Never throws. */
+function runNode(script) {
+    try {
+        execFileSync('node', ['--input-type=module', '-e', script], { encoding: 'utf-8', stdio: 'pipe' });
+        return { status: 0, stderr: '' };
+    }
+    catch (err) {
+        const e = err;
+        return { status: e.status ?? 1, stderr: e.stderr ?? '' };
+    }
+}
+const composeUrl = pathToFileURL(COMPOSE).href;
+describe('CLAUDE.md.template compose', () => {
+    it('source pieces exist alongside the artifact', () => {
+        expect(existsSync(join(CLAUDE_MD_DIR, 'CLAUDE.core.md'))).toBe(true);
+        expect(existsSync(join(CLAUDE_MD_DIR, 'CLAUDE.overlay.memnexus.md'))).toBe(true);
+        expect(existsSync(join(CLAUDE_MD_DIR, 'vars.memnexus.json'))).toBe(true);
+        expect(existsSync(COMPOSE)).toBe(true);
+    });
+    it('compose(core + overlay + vars) is byte-identical to the checked-in CLAUDE.md.template', () => {
+        const composed = execFileSync('node', [COMPOSE], { encoding: 'utf-8' });
+        const artifact = readFileSync(TEMPLATE_PATH, 'utf-8');
+        expect(composed).toBe(artifact);
+    });
+    it('compose --check reports in-sync (exit 0)', () => {
+        // Throws on non-zero exit; a passing call proves --check exits 0.
+        execFileSync('node', [COMPOSE, '--check'], { encoding: 'utf-8', stdio: 'pipe' });
+    });
+    it('the core is variable-free (all {{VAR}} tokens live in the overlay)', () => {
+        const coreText = readFileSync(join(CLAUDE_MD_DIR, 'CLAUDE.core.md'), 'utf-8');
+        // Strip all HTML comments (the banner + the core:NAME markers) so only the
+        // section body text remains, then assert it carries no template variables.
+        const body = coreText.replace(/<!--[\s\S]*?-->/g, '');
+        expect(body.match(/\{\{[^}]*\}\}/)).toBeNull();
+    });
+    it('compose throws on an unresolved variable', () => {
+        const r = runNode(`import { compose } from ${JSON.stringify(composeUrl)};` +
+            `compose({ coreText: '', overlayText: 'hi {{MISSING}}', vars: {} });`);
+        expect(r.status).not.toBe(0);
+        expect(r.stderr).toMatch(/unresolved template variable/);
+    });
+    it('compose throws on an unknown core include', () => {
+        const r = runNode(`import { compose } from ${JSON.stringify(composeUrl)};` +
+            `compose({ coreText: '', overlayText: '{{> core:nope}}', vars: {} });`);
+        expect(r.status).not.toBe(0);
+        expect(r.stderr).toMatch(/unknown core block/);
+    });
+    it('parseCore throws on a duplicate core block name', () => {
+        const dupCore = '<!-- core:dup -->\nfirst\n<!-- core:dup -->\nsecond\n';
+        const r = runNode(`import { parseCore } from ${JSON.stringify(composeUrl)};` +
+            `parseCore(${JSON.stringify(dupCore)});`);
+        expect(r.status).not.toBe(0);
+        expect(r.stderr).toMatch(/duplicate core block name "dup"/);
+    });
+    it('parseCore throws when a core block contains a template token', () => {
+        const leakyCore = '<!-- core:leaky -->\nhas a {{VAR}} in it\n';
+        const r = runNode(`import { parseCore } from ${JSON.stringify(composeUrl)};` +
+            `parseCore(${JSON.stringify(leakyCore)});`);
+        expect(r.status).not.toBe(0);
+        expect(r.stderr).toMatch(/must be variable-free/);
+    });
+    it('gives a purposeful error (no raw stack) for a missing vars file', () => {
+        const r = runNode(`import { loadVars } from ${JSON.stringify(composeUrl)};` +
+            `loadVars('/nonexistent/vars.json');`);
+        expect(r.status).not.toBe(0);
+        expect(r.stderr).toMatch(/cannot read vars file \/nonexistent\/vars\.json/);
+    });
+    it('gives a purposeful error for malformed vars JSON', () => {
+        const r = runNode(`import { loadVars } from ${JSON.stringify(composeUrl)};` +
+            `import { writeFileSync } from 'fs';` +
+            `import { tmpdir } from 'os';` +
+            `import { join } from 'path';` +
+            `const p = join(tmpdir(), 'bad-vars-' + process.pid + '.json');` +
+            `writeFileSync(p, '{ not json');` +
+            `loadVars(p);`);
+        expect(r.status).not.toBe(0);
+        expect(r.stderr).toMatch(/is not valid JSON/);
+    });
+});
+//# sourceMappingURL=claude-md-compose.test.js.map

package/dist/__tests__/claude-md-compose.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memnexus-ai/mx-agent-cli",
-  "version": "0.1.165",
+  "version": "0.1.166",
   "description": "CLI for creating and managing AI agent teams",
   "type": "module",
   "bin": {