@productbrain/cli 0.1.0-beta.1440 → 0.1.0-beta.1463

package/dist/scoreboard/localDrift.test.js

@@ -0,0 +1,82 @@
+/**
+ * M5 local-pull drift unit tests (A5, DEC-1284).
+ *
+ * Exercises computeLocalDrift over a real temp `.productbrain/` so the stat path is genuinely
+ * driven (not mocked): a config-bearing root (so findProjectRoot resolves) + a projection file
+ * whose mtime is the local pull. Asserts the lag/age math, the clamp, and the fail-soft branches.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, mkdirSync, writeFileSync, utimesSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { resolve } from 'path';
+import { computeLocalDrift } from './localDrift.js';
+let root;
+function setMtime(path, ms) {
+    const secs = ms / 1000;
+    utimesSync(path, secs, secs);
+}
+beforeEach(() => {
+    root = mkdtempSync(resolve(tmpdir(), 'pb-m5-'));
+    const pb = resolve(root, '.productbrain');
+    mkdirSync(pb, { recursive: true });
+    // config.json makes this a CLI project root (findProjectRoot requires it).
+    writeFileSync(resolve(pb, 'config.json'), JSON.stringify({ siteUrl: 'https://example.test' }));
+});
+afterEach(() => {
+    rmSync(root, { recursive: true, force: true });
+});
+describe('computeLocalDrift', () => {
+    it('fails soft to unavailable when no projection files exist', () => {
+        const d = computeLocalDrift(5_000, 10_000, root);
+        expect(d.localProjectionMtime).toBeNull();
+        expect(d.localLagMs).toBeNull();
+        expect(d.localAgeMs).toBeNull();
+        expect(d.unavailableReason).toMatch(/projection files/);
+    });
+    it('computes lag (server − local) and age (now − local) from the newest projection mtime', () => {
+        const pb = resolve(root, '.productbrain');
+        const ctx = resolve(pb, 'context.md');
+        writeFileSync(ctx, '# context');
+        setMtime(ctx, 1_000);
+        // Also write a newer briefing — newest mtime should win.
+        const brief = resolve(pb, 'briefing.md');
+        writeFileSync(brief, '# briefing');
+        setMtime(brief, 3_000);
+        const d = computeLocalDrift(5_000 /* server */, 10_000 /* now */, root);
+        expect(d.localProjectionMtime).toBe(3_000);
+        expect(d.serverMaterializedAt).toBe(5_000);
+        expect(d.localLagMs).toBe(2_000); // 5000 − 3000
+        expect(d.localAgeMs).toBe(7_000); // 10000 − 3000
+        expect(d.unavailableReason).toBeUndefined();
+    });
+    it('clamps lag at 0 when the local pull is newer than the server materialization', () => {
+        const pb = resolve(root, '.productbrain');
+        const ctx = resolve(pb, 'context.md');
+        writeFileSync(ctx, '# context');
+        setMtime(ctx, 9_000);
+        const d = computeLocalDrift(5_000, 10_000, root);
+        expect(d.localLagMs).toBe(0); // max(0, 5000 − 9000)
+        expect(d.localAgeMs).toBe(1_000);
+    });
+    it('returns null lag when the server never materialized', () => {
+        const pb = resolve(root, '.productbrain');
+        const ctx = resolve(pb, 'context.md');
+        writeFileSync(ctx, '# context');
+        setMtime(ctx, 2_000);
+        const d = computeLocalDrift(null, 10_000, root);
+        expect(d.localLagMs).toBeNull();
+        expect(d.localAgeMs).toBe(8_000);
+    });
+    it('reports unavailable when no project root is found', () => {
+        const bare = mkdtempSync(resolve(tmpdir(), 'pb-noroot-'));
+        try {
+            const d = computeLocalDrift(5_000, 10_000, bare);
+            expect(d.localProjectionMtime).toBeNull();
+            expect(d.unavailableReason).toMatch(/project root|missing/i);
+        }
+        finally {
+            rmSync(bare, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=localDrift.test.js.map

package/dist/scoreboard/localDrift.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productbrain/cli",
-  "version": "0.1.0-beta.1440",
+  "version": "0.1.0-beta.1463",
   "description": "Product Brain — Chain knowledge and write-back CLI",
   "type": "module",
   "bin": {