import { describe, test } from "node:test"; import assert from "node:assert/strict"; import { spawnSync } from "node:child_process"; import { fileURLToPath } from "node:url"; import { mkdtempSync, rmSync, readFileSync, existsSync, writeFileSync } from "node:fs"; import { join } from "node:path"; import { tmpdir } from "node:os"; import { SCHEMA_VERSION } from "../src/types.js"; // Resolve the package root (scripts/trends) so the subprocess `src/cli.ts` path + the // `tsx` loader resolve regardless of the runner's cwd. const trendsDir = fileURLToPath(new URL("..", import.meta.url)); function run(args: string[], input: string): { status: number | null; stdout: string } { const res = spawnSync("node", ["--import", "tsx", "src/cli.ts", ...args], { input, encoding: "utf8", cwd: trendsDir, }); return { status: res.status, stdout: res.stdout }; } describe("trends CLI — normalize/score subcommands (RE-R1 / Step 4)", () => { describe("normalize (stdin JSON in, JSON out)", () => { test("happy path: a JSON batch on stdin -> exit 0 + {items,errors} JSON", () => { const batch = JSON.stringify([ { source: "tavily", title: "Good", url: "https://example.com/a", topics: ["AI", "ai"] }, { source: "tavily", title: "", url: "https://example.com/b", topics: ["x"] }, // bad: empty title ]); const { status, stdout } = run(["normalize"], batch); assert.equal(status, 0); const out = JSON.parse(stdout); assert.equal(out.items.length, 1); assert.deepEqual(out.items[0].topics, ["ai"]); // deduped + lowercased assert.equal(out.errors.length, 1); assert.equal(out.errors[0].index, 1); }); test("bad invocation: unparseable stdin -> exit 2", () => { const { status } = run(["normalize"], "not json at all"); assert.equal(status, 2); }); }); describe("score (stdin JSON in, JSON out)", () => { test("happy path: scored candidates on stdin -> exit 0 + {kept,dropped} JSON", () => { const candidates = JSON.stringify([ { id: "high", scores: { pillar: 8, audience: 8, timing: 8, angle: 8, authority: 8 } }, // 8.0 { id: "low", scores: { pillar: 2, audience: 2, timing: 2, angle: 2, authority: 2 } }, // 2.0 ]); const { status, stdout } = run(["score", "--mode", "kortform", "--threshold", "4.0"], candidates); assert.equal(status, 0); const out = JSON.parse(stdout); assert.deepEqual( out.kept.map((k: { id: string }) => k.id), ["high"], ); assert.equal(out.kept[0].composite, 8.0); assert.equal(out.kept[0].band.priority, "Immediate"); assert.deepEqual( out.dropped.map((d: { id: string }) => d.id), ["low"], ); }); test("bad invocation: an unknown --mode -> exit 2", () => { const candidates = JSON.stringify([ { id: "x", scores: { pillar: 5, audience: 5, timing: 5, angle: 5, authority: 5 } }, ]); const { status } = run(["score", "--mode", "bogus"], candidates); assert.equal(status, 2); }); }); describe("capture (stdin raw item|batch -> folds into the store) (RE-R2a / Step 4)", () => { const tmpStore = () => join(mkdtempSync(join(tmpdir(), "trends-capture-")), "trends.json"); test("happy path: a valid item piped in -> folded into the store, added:1, publishedAt persisted", () => { const store = tmpStore(); try { const batch = JSON.stringify([ { source: "tavily", title: "Captured", url: "https://example.com/c", topics: ["ai"], publishedAt: "2026-06-20", }, ]); const { status, stdout } = run(["capture", "--store", store, "--json"], batch); assert.equal(status, 0); const summary = JSON.parse(stdout); assert.equal(summary.added, 1); assert.equal(summary.errors.length, 0); assert.equal( summary.added + summary.merged + summary.duplicates + summary.errors.length, 1, "tally must sum to the input size", ); const persisted = JSON.parse(readFileSync(store, "utf8")); assert.equal(persisted.schemaVersion, SCHEMA_VERSION); assert.equal(persisted.trends.length, 1); assert.equal(persisted.trends[0].publishedAt, "2026-06-20"); assert.match(persisted.trends[0].capturedAt, /^\d{4}-\d{2}-\d{2}$/); assert.notEqual( persisted.trends[0].capturedAt, persisted.trends[0].publishedAt, "capturedAt (when WE saw it) must be distinct from publishedAt (source date)", ); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); } }); test("a batch with one content-invalid item -> valid added, invalid in errors[], exit 0", () => { const store = tmpStore(); try { const batch = JSON.stringify([ { source: "tavily", title: "Valid", url: "https://example.com/v", topics: ["x"] }, { title: "no source or url" }, ]); const { status, stdout } = run(["capture", "--store", store, "--json"], batch); assert.equal(status, 0); const summary = JSON.parse(stdout); assert.equal(summary.added, 1); assert.equal(summary.errors.length, 1); assert.equal( summary.added + summary.merged + summary.duplicates + summary.errors.length, 2, ); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); } }); test("re-capturing the same trend with a new topic -> merged:1, tally still sums", () => { const store = tmpStore(); try { const item = (topics: string[]) => JSON.stringify([{ source: "tavily", title: "Dup", url: "https://example.com/d", topics }]); run(["capture", "--store", store, "--json"], item(["a"])); const { status, stdout } = run(["capture", "--store", store, "--json"], item(["a", "b"])); assert.equal(status, 0); const summary = JSON.parse(stdout); assert.equal(summary.added, 0); assert.equal(summary.merged, 1); assert.equal(summary.duplicates, 0); assert.equal( summary.added + summary.merged + summary.duplicates + summary.errors.length, 1, ); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); } }); test("bad invocation: empty stdin -> exit 2", () => { const { status } = run(["capture"], ""); assert.equal(status, 2); }); // ── RE-R3a: capture persists the computed relevance score (SC7) ── test("a valid per-item score -> record carries the computed composite/priority (read back via list --json)", () => { const store = tmpStore(); try { const batch = JSON.stringify([ { source: "tavily", title: "Scored capture", url: "https://example.com/sc", topics: ["ai"], score: { mode: "kortform", dimensions: { pillar: 9, audience: 8, timing: 9, angle: 7, authority: 6 } }, }, ]); const cap = run(["capture", "--store", store, "--json"], batch); assert.equal(cap.status, 0); const summary = JSON.parse(cap.stdout); assert.equal(summary.added, 1); assert.equal(summary.errors.length, 0); const ls = run(["list", "--store", store, "--json"], ""); assert.equal(ls.status, 0); const rows = JSON.parse(ls.stdout); assert.equal(rows.length, 1); // 9*.30 + 8*.25 + 9*.20 + 7*.15 + 6*.10 = 8.15 -> round1 8.1 (8.15*10 = 81.4999… in IEEE-754) -> Immediate assert.equal(rows[0].score.composite, 8.1); assert.equal(rows[0].score.priority, "Immediate"); assert.equal(rows[0].score.mode, "kortform"); assert.deepEqual(rows[0].score.dimensions, { pillar: 9, audience: 8, timing: 9, angle: 7, authority: 6 }); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); } }); test("a batch with one bad score (timing:99) -> that item in errors[], the valid one added, exit 0", () => { const store = tmpStore(); try { const batch = JSON.stringify([ { source: "tavily", title: "Good scored", url: "https://example.com/good", topics: ["ai"], score: { mode: "kortform", dimensions: { pillar: 8, audience: 7, timing: 9, angle: 6, authority: 5 } }, }, { source: "tavily", title: "Bad scored", url: "https://example.com/bad", topics: ["ai"], score: { mode: "kortform", dimensions: { pillar: 8, audience: 7, timing: 99, angle: 6, authority: 5 } }, }, ]); const { status, stdout } = run(["capture", "--store", store, "--json"], batch); assert.equal(status, 0, "a bad score must not fail the run"); const summary = JSON.parse(stdout); assert.equal(summary.added, 1, "the valid scored item is added"); assert.equal(summary.errors.length, 1, "the bad-score item lands in errors[]"); assert.equal( summary.added + summary.merged + summary.duplicates + summary.errors.length, 2, "tally must sum to the input size", ); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); } }); }); }); describe("trends CLI — brief subcommand (RE-R2b / Step 3)", () => { // brief is flag-driven (reads the store, not stdin). spawn with an env-overridable // LINKEDIN_STUDIO_DATA so defaultBriefDir() resolves into a temp root (never the real HOME). function runBrief(args: string[], env: Record = {}): { status: number | null; stdout: string } { const res = spawnSync("node", ["--import", "tsx", "src/cli.ts", "brief", ...args], { input: "", encoding: "utf8", cwd: trendsDir, env: { ...process.env, ...env }, }); return { status: res.status, stdout: res.stdout }; } const freshIso = new Date(Date.now() - 2 * 86400000).toISOString().slice(0, 10); function seedStore(trends: unknown[]): string { const store = join(mkdtempSync(join(tmpdir(), "trends-brief-")), "trends.json"); writeFileSync(store, JSON.stringify({ schemaVersion: 2, trends })); return store; } test("happy: writes a dated brief, --json carries path/date/totals/summary", () => { const store = seedStore([ { id: "a", title: "Fresh Match", url: "https://e/a", source: "tavily", capturedAt: freshIso, publishedAt: freshIso, topics: ["ai", "gov"] }, ]); const out = mkdtempSync(join(tmpdir(), "brief-out-")); try { const { status, stdout } = runBrief(["--pillars", "ai,gov", "--store", store, "--out", out, "--json"]); assert.equal(status, 0); const summary = JSON.parse(stdout); assert.match(summary.path, /\d{4}-\d{2}-\d{2}\.md$/); assert.match(summary.date, /^\d{4}-\d{2}-\d{2}$/); assert.equal(summary.totals.trends, 1); assert.equal(summary.totals.fresh, 1); assert.ok(existsSync(summary.path), "the dated brief file is written"); const md = readFileSync(summary.path, "utf8"); const m = md.match(/^summary: (.*)$/m); assert.ok(m, "the brief frontmatter has a summary line"); assert.equal(m![1], summary.summary, "--json summary equals the file frontmatter summary (one source)"); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); rmSync(out, { recursive: true, force: true }); } }); test("bad invocation: --fresh-days non-numeric -> exit 2", () => { const store = seedStore([]); try { const { status } = runBrief(["--pillars", "ai", "--store", store, "--fresh-days", "xyz"]); assert.equal(status, 2); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); } }); test("empty --pillars -> exit 0 + a no-match brief is still written", () => { const store = seedStore([ { id: "a", title: "X", url: "https://e/x", source: "tavily", capturedAt: freshIso, publishedAt: freshIso, topics: ["ai"] }, ]); const out = mkdtempSync(join(tmpdir(), "brief-out-")); try { const { status, stdout } = runBrief(["--store", store, "--out", out, "--json"]); assert.equal(status, 0); const summary = JSON.parse(stdout); assert.equal(summary.totals.matched, 0, "no pillars -> nothing matched"); assert.ok(existsSync(summary.path), "a dated no-match brief is still written"); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); rmSync(out, { recursive: true, force: true }); } }); test("bare --out (no value) -> falls back to defaultBriefDir, never ./true", () => { const store = seedStore([]); const dataRoot = mkdtempSync(join(tmpdir(), "brief-data-")); try { // bare --out --json: parseFlags yields out:"true"; the !== "true" guard must // fall back to defaultBriefDir() = /trends/morning-brief. const { status, stdout } = runBrief(["--pillars", "ai", "--store", store, "--json", "--out"], { LINKEDIN_STUDIO_DATA: dataRoot }); assert.equal(status, 0); const summary = JSON.parse(stdout); assert.ok( summary.path.startsWith(join(dataRoot, "trends", "morning-brief")), "bare --out must fall back to defaultBriefDir under LINKEDIN_STUDIO_DATA, not ./true", ); assert.ok(!existsSync(join(trendsDir, "true")), "no ./true dir was created"); } finally { rmSync(join(store, ".."), { recursive: true, force: true }); rmSync(dataRoot, { recursive: true, force: true }); } }); }); describe("trends CLI — lifecycle: act/skip/reset + brief surfacing (RE-R3b)", () => { // One temp dir per fixture holds both the store file and the brief out dir, so the // real per-user data dir (defaultBriefDir) is never touched. const fixture = () => { const dir = mkdtempSync(join(tmpdir(), "trends-r3b-")); return { dir, store: join(dir, "trends.json"), out: join(dir, "briefs") }; }; const listJson = (store: string): Array> => JSON.parse(run(["list", "--store", store, "--json"], "").stdout); const seedScored = (store: string, title: string, url: string, timing = 9): void => { const batch = JSON.stringify([ { source: "tavily", title, url, topics: ["ai", "gov"], publishedAt: "2026-06-23", score: { mode: "kortform", dimensions: { pillar: 9, audience: 8, timing, angle: 7, authority: 6 } }, }, ]); run(["capture", "--store", store], batch); }; test("RED: act --id → acted; skip → skipped; reset → new (read back via list --json)", () => { const { dir, store } = fixture(); try { seedScored(store, "Lifecycle", "https://e/lc"); const id = listJson(store)[0].id; assert.equal(run(["act", "--id", id, "--store", store], "").status, 0); assert.equal(listJson(store)[0].status, "acted"); run(["skip", "--id", id, "--store", store], ""); assert.equal(listJson(store)[0].status, "skipped"); run(["reset", "--id", id, "--store", store], ""); assert.equal(listJson(store)[0].status, "new"); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("RED: an unknown id → exit 2 + store unchanged; a missing --id → exit 2", () => { const { dir, store } = fixture(); try { seedScored(store, "X", "https://e/x"); const before = readFileSync(store, "utf8"); assert.equal(run(["act", "--id", "nope", "--store", store], "").status, 2); assert.equal(readFileSync(store, "utf8"), before, "store untouched on a not-found id"); assert.equal(run(["skip", "--store", store], "").status, 2, "missing --id → exit 2"); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("RED: brief records surfacing (surfacedCount + lastSurfacedAt + marked); a second same-day run is idempotent", () => { const { dir, store, out } = fixture(); try { seedScored(store, "Surf", "https://e/surf"); const o1 = JSON.parse(run(["brief", "--pillars", "ai,gov", "--out", out, "--store", store, "--json"], "").stdout); assert.equal(o1.marked, 1, "first brief marks 1"); const rec = listJson(store)[0]; assert.equal(rec.surfacedCount, 1); assert.match(rec.lastSurfacedAt, /^\d{4}-\d{2}-\d{2}$/); const o2 = JSON.parse(run(["brief", "--pillars", "ai,gov", "--out", out, "--store", store, "--json"], "").stdout); assert.equal(o2.marked, 0, "second same-day brief is idempotent"); assert.equal(listJson(store)[0].surfacedCount, 1, "count unchanged on the second same-day run"); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("RED: brief --no-mark writes no surfacedCount", () => { const { dir, store, out } = fixture(); try { seedScored(store, "Dry", "https://e/dry"); const o = JSON.parse(run(["brief", "--pillars", "ai,gov", "--no-mark", "--out", out, "--store", store, "--json"], "").stdout); assert.equal(o.marked, 0); assert.equal("surfacedCount" in listJson(store)[0], false, "--no-mark must not write surfacedCount"); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("RED: the brief .md omits an acted record", () => { const { dir, store, out } = fixture(); try { seedScored(store, "Handled", "https://e/handled"); const id = listJson(store)[0].id; run(["act", "--id", id, "--store", store], ""); const o = JSON.parse(run(["brief", "--pillars", "ai,gov", "--out", out, "--store", store, "--json"], "").stdout); const md = readFileSync(o.path, "utf8"); assert.ok(!md.includes("Handled"), "an acted record must not appear in the brief"); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("RED: a re-capture with a changed score reports merged:1 + refreshes the composite", () => { const { dir, store } = fixture(); try { seedScored(store, "Re", "https://e/re", 9); const c1 = listJson(store)[0].score.composite; const batch = JSON.stringify([ { source: "tavily", title: "Re", url: "https://e/re", topics: ["ai", "gov"], publishedAt: "2026-06-23", score: { mode: "kortform", dimensions: { pillar: 9, audience: 8, timing: 2, angle: 7, authority: 6 } }, }, ]); const o = JSON.parse(run(["capture", "--store", store, "--json"], batch).stdout); assert.equal(o.merged, 1, "a changed score on a duplicate → merged"); const c2 = listJson(store)[0].score.composite; assert.ok(c2 < c1, "a lower timing → lower composite (re-score last-wins)"); } finally { rmSync(dir, { recursive: true, force: true }); } }); });