Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.
JavaScript agent-skillsai-agentsbrowser-agentbrowser-automationdecision-modeldeep-researchinstagramjevlinkedinlocal-firstopen-sourceosintresearch-agentsocaisocial-listeningsocial-mediasocial-media-researchsocmintsystem-onetiktok
import assert from "node:assert/strict";
import { mkdtemp, rm } from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import test from "node:test";
import { listRuns, markInterruptedRuns, readRun, saveRun } from "../src/runs.js";
test("startup recovery marks stale running checkpoints as interrupted", async () => {
const directory = await mkdtemp(path.join(os.tmpdir(), "jev-social-runs-"));
const env = { ...process.env, JEV_SOCIAL_HOME: directory };
try {
await saveRun({
id: "stale-run",
createdAt: "2026-09-22T00:00:00.000Z",
status: "running",
stopReason: "Research is still in progress.",
result: { ok: false, items: [{ url: "https://example.com/post" }] },
report: "# Captured evidence\n\nThe run is partial.",
}, env);
assert.equal(await markInterruptedRuns(env), 1);
const recovered = await readRun("stale-run", env);
assert.equal(recovered.status, "interrupted");
assert.equal(recovered.result.ok, false);
assert.match(recovered.stopReason, /process stopped/i);
assert.equal(await markInterruptedRuns(env), 0);
} finally { await rm(directory, { recursive: true, force: true }); }
});
test("startup recovery closes a report checkpoint left generating after collection completed", async () => {
const directory = await mkdtemp(path.join(os.tmpdir(), "jev-social-runs-"));
const env = { ...process.env, JEV_SOCIAL_HOME: directory };
try {
await saveRun({
id: "stale-report",
createdAt: "2026-09-22T00:00:00.000Z",
request: "compare two posts",
platform: "instagram",
status: "completed",
reportStatus: "generating",
stopReason: "Jev chose to finish with the evidence captured so far.",
result: { ok: true, items: [{ url: "https://www.instagram.com/p/example/", caption: "Example" }] },
report: "# stale prefix",
}, env);
assert.equal(await markInterruptedRuns(env), 1);
const recovered = await readRun("stale-report", env);
assert.equal(recovered.status, "interrupted");
assert.equal(recovered.reportStatus, "interrupted");
assert.equal(recovered.reportKind, "fallback");
assert.equal(recovered.result.ok, false);
assert.match(recovered.report, /## Executive summary/);
assert.match(recovered.report, /This is a partial report/);
assert.equal(await markInterruptedRuns(env), 0);
} finally { await rm(directory, { recursive: true, force: true }); }
});
test("concurrent checkpoints for one run remain valid JSON", async () => {
const directory = await mkdtemp(path.join(os.tmpdir(), "jev-social-runs-"));
const env = { ...process.env, JEV_SOCIAL_HOME: directory };
try {
await Promise.all(Array.from({ length: 20 }, (_, sequence) => saveRun({
id: "shared-run",
createdAt: "2026-09-22T00:00:00.000Z",
status: "running",
sequence,
result: { items: Array.from({ length: sequence }, (__, index) => ({ id: index })) },
}, env)));
const recovered = await readRun("shared-run", env);
assert.equal(recovered.sequence, 19);
assert.equal(recovered.result.items.length, 19);
assert.equal((await listRuns(env)).length, 1);
} finally { await rm(directory, { recursive: true, force: true }); }
});
test("saveRun rejects ids that could escape the runs directory", async () => {
const directory = await mkdtemp(path.join(os.tmpdir(), "jev-social-runs-"));
const env = { ...process.env, JEV_SOCIAL_HOME: directory };
try {
await assert.rejects(saveRun({ id: "../outside", result: {} }, env), /invalid characters/i);
} finally { await rm(directory, { recursive: true, force: true }); }
});