daily-focus 0.1.0

package/dist/audit-4AUZVELT.js

@@ -0,0 +1,215 @@
+import {
+  linkState
+} from "./chunk-QKT2FAB5.js";
+import {
+  Store,
+  fingerprintId,
+  parseBrief,
+  readArchiveIndex,
+  resolveItems,
+  runContractChecks
+} from "./chunk-2PLWVW5T.js";
+import {
+  BRIEF_REFRESH_GRACE_HOURS,
+  describeSchedule,
+  describeTime,
+  loadConfig,
+  nextRunDate,
+  resolveSchedule,
+  runsOn
+} from "./chunk-G4K24I4M.js";
+import {
+  command
+} from "./chunk-6VWWJZKJ.js";
+import {
+  workingMsBetween
+} from "./chunk-EXGTFXNV.js";
+
+// scripts/audit.ts
+import { readFile, readdir } from "node:fs/promises";
+import { resolve } from "node:path";
+var config = loadConfig();
+var store = new Store(config);
+var failures = 0;
+var warnings = 0;
+function pass(label, detail = "") {
+  console.log(`  \x1B[32m\u2713\x1B[0m ${label}${detail ? ` \u2014 ${detail}` : ""}`);
+}
+function fail(label, detail = "") {
+  failures++;
+  console.log(`  \x1B[31m\u2717\x1B[0m ${label}${detail ? ` \u2014 ${detail}` : ""}`);
+}
+function warn(label, detail = "") {
+  warnings++;
+  console.log(`  \x1B[33m!\x1B[0m ${label}${detail ? ` \u2014 ${detail}` : ""}`);
+}
+function section(title) {
+  console.log(`
+\x1B[1m${title}\x1B[0m`);
+}
+async function findPrevious(current) {
+  const flag = process.argv.indexOf("--against");
+  if (flag !== -1 && process.argv[flag + 1]) {
+    const path = resolve(process.argv[flag + 1].replace(/^~/, process.env.HOME ?? "~"));
+    return { brief: JSON.parse(await readFile(path, "utf8")), from: path };
+  }
+  let names;
+  try {
+    names = (await readdir(config.archiveDir)).filter((n) => /^items-\d{4}-\d{2}-\d{2}\.json$/.test(n));
+  } catch {
+    return null;
+  }
+  for (const name of names.sort().reverse()) {
+    const path = resolve(config.archiveDir, name);
+    try {
+      const brief2 = JSON.parse(await readFile(path, "utf8"));
+      if (brief2.generatedAt !== current.generatedAt) return { brief: brief2, from: path };
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+section("Store");
+var promptLink = await linkState(config.promptFile, config.promptSource);
+if (promptLink.state === "own") pass("prompt.md", "a real file, not linked to the repo");
+else if (promptLink.state === "linked") pass("prompt.md", `linked to the ${config.profile} prompt`);
+else if (promptLink.state === "elsewhere") warn("prompt.md", `linked to ${promptLink.target}, not the ${config.profile} prompt \u2014 restart the dashboard, or run \`${command("init")}\``);
+else if (promptLink.state === "dangling") fail("prompt.md", `links to ${promptLink.target}, which does not exist \u2014 restart the dashboard, or run \`${command("init")}\``);
+else fail("prompt.md", `missing \u2014 restart the dashboard, or run \`${command("init")}\``);
+var raw = await readFile(config.itemsFile, "utf8");
+var parsed = parseBrief(raw);
+section("Payload");
+if (!parsed.brief) {
+  fail("items.json parses", parsed.error ?? "unknown error");
+  process.exit(1);
+}
+var brief = parsed.brief;
+pass("items.json parses", `${brief.items.length} items, by ${brief.generatedBy ?? "unknown"}`);
+for (const warning of parsed.warnings) warn("parser warning", warning);
+if (parsed.warnings.length === 0) pass("no items were dropped or repaired");
+var auditedAt = /* @__PURE__ */ new Date();
+var schedule = resolveSchedule(config);
+var isRunDay = (d) => runsOn(schedule, d);
+var provenance = {
+  config: "from DAILY_FOCUS_AGENT_DAYS",
+  default: config.agent.at ? `the dashboard's own, at ${describeTime(config.agent.at)} \u2014 set DAILY_FOCUS_AGENT_DAYS to change the days` : "assumed \u2014 set DAILY_FOCUS_AGENT_DAYS to change the days"
+}[schedule.source];
+pass("agent schedule", `${describeSchedule(schedule)} (${provenance})`);
+var ranAt = new Date(brief.generatedAt);
+var ageHours = (auditedAt.getTime() - ranAt.getTime()) / 36e5;
+var scheduledAgeHours = workingMsBetween(ranAt, auditedAt, isRunDay) / 36e5;
+var age = `${Math.round(ageHours * 10) / 10}h old`;
+if (scheduledAgeHours >= config.staleAfterHours + BRIEF_REFRESH_GRACE_HOURS) fail("brief is fresh", `${Math.round(ageHours)}h old`);
+else {
+  const next = nextRunDate(schedule, auditedAt);
+  pass("brief is fresh", isRunDay(auditedAt) ? age : `${age}, and no run was due today (next: ${next})`);
+}
+section("Contract");
+var ids = brief.items.map((i) => i.id);
+var duplicates = ids.filter((id, i) => ids.indexOf(id) !== i);
+if (duplicates.length) fail("ids are unique", [...new Set(duplicates)].join(", "));
+else pass("ids are unique");
+var untyped = brief.items.filter((i) => !i.id || !i.title || !i.source || !i.kind);
+if (untyped.length) fail("every item has id/title/source/kind", `${untyped.length} missing`);
+else pass("every item has id/title/source/kind");
+var priorities = brief.items.filter((i) => i.priority !== void 0).map((i) => i.priority);
+var sortedPriorities = [...priorities].sort((a, b) => a - b);
+var gapless = sortedPriorities.every((p, i) => p === i + 1);
+if (priorities.length > 3) fail("at most three priorities", `${priorities.length} set`);
+else if (priorities.length && !gapless) warn("priorities are 1..n with no gaps", sortedPriorities.join(", "));
+else pass("priorities", priorities.length ? sortedPriorities.join(", ") : "none set");
+var badUrls = brief.items.filter((i) => i.url && !/^https?:\/\//.test(i.url));
+if (badUrls.length) fail("all urls are http(s)", `${badUrls.length} bad`);
+else pass("all urls are http(s)");
+var timedEvents = brief.items.filter((i) => i.kind === "event" && i.start && !/^\d{4}-\d{2}-\d{2}$/.test(i.start));
+var noOffset = timedEvents.filter((i) => !/(Z|[+-]\d{2}:?\d{2})$/.test(i.start));
+if (noOffset.length) fail("timed events carry a timezone offset", `${noOffset.length} without`);
+else pass("timed events carry a timezone offset", `${timedEvents.length} checked`);
+if (!config.freeWindows) {
+  pass("free windows off", brief.dayStart || brief.dayEnd ? "dayStart / dayEnd present but unused" : "no day bounds, none needed");
+} else if (brief.dayStart || brief.dayEnd) {
+  pass("working day set from the calendar", `${brief.dayStart ?? "default"} \u2192 ${brief.dayEnd ?? "default"}`);
+} else {
+  warn("working day not set", "falling back to config; fine only if today is standard");
+}
+section("Contract checks");
+var focus = await store.readFocus();
+var history = await readArchiveIndex(config);
+var issues = runContractChecks({
+  brief,
+  items: resolveItems(brief.items, await store.readActions(), /* @__PURE__ */ new Date()),
+  focus,
+  history
+});
+if (issues.length === 0) pass("no contract issues", focus?.objective ? `objective: ${focus.objective}` : "no objective set");
+for (const issue of issues) fail("contract", issue);
+var aligned = brief.items.filter((i) => i.advancesObjective);
+if (aligned.length) {
+  console.log(`  ${aligned.length} item(s) advance the objective:`);
+  for (const item of aligned) console.log(`      \xB7 ${item.priority ? `#${item.priority} ` : ""}${item.title}`);
+}
+section("Action log");
+var actions = await store.readActions();
+var generatedAt = new Date(brief.generatedAt);
+var priorActions = actions.filter((a) => new Date(a.at).getTime() < generatedAt.getTime());
+var asGenerated = resolveItems(brief.items, priorActions, generatedAt);
+var resurrected = asGenerated.filter((i) => i.status === "done" || i.status === "dismissed");
+var stillSnoozed = asGenerated.filter((i) => i.status === "snoozed");
+if (resurrected.length) {
+  fail("nothing already handled was re-raised", `${resurrected.length} item(s)`);
+  for (const item of resurrected) console.log(`      \xB7 ${item.status}: ${item.title}`);
+} else {
+  pass(
+    "nothing already handled was re-raised",
+    `${priorActions.length} of ${actions.length} action(s) predated this brief`
+  );
+}
+if (stillSnoozed.length) warn("snoozed items present", `${stillSnoozed.length} \u2014 fine only if their date has arrived`);
+section("Continuity");
+var previous = await findPrevious(brief);
+if (!previous) {
+  warn("no earlier brief to compare against", "id stability unverified");
+} else {
+  console.log(`  comparing against ${previous.from}`);
+  const previousIds = new Set(previous.brief.items.map((i) => i.id));
+  const currentIds = new Set(ids);
+  const reproduced = [...previousIds].filter((id) => currentIds.has(id));
+  const dropped = [...previousIds].filter((id) => !currentIds.has(id));
+  const added = [...currentIds].filter((id) => !previousIds.has(id));
+  const actedOn = new Set(actions.filter((a) => a.action !== "note").map((a) => a.id));
+  const addedFingerprints = new Map(added.map((id) => [fingerprintId(id), id]));
+  const handled = dropped.filter((id) => actedOn.has(id));
+  const drifted = dropped.filter((id) => !actedOn.has(id) && addedFingerprints.has(fingerprintId(id)));
+  const cut = dropped.filter((id) => !actedOn.has(id) && !addedFingerprints.has(fingerprintId(id)));
+  pass(`${reproduced.length} id(s) reproduced exactly`);
+  if (handled.length) pass(`${handled.length} id(s) gone because you actioned them`);
+  if (drifted.length) {
+    fail(`${drifted.length} id(s) changed shape`, "completed items under the old id will return");
+    for (const id of drifted) console.log(`      \xB7 ${id} \u2192 ${addedFingerprints.get(fingerprintId(id))}`);
+  } else {
+    pass("no id changed shape", `${added.length} new id(s) are genuinely new`);
+  }
+  if (cut.length) {
+    console.log(`  ${cut.length} id(s) dropped by editorial choice \u2014 expected when the agent cuts to fit:`);
+    for (const id of cut.slice(0, 10)) console.log(`      \xB7 ${id}`);
+  }
+  const previousFirstSeen = new Map(previous.brief.items.map((i) => [i.id, i.firstSeen]));
+  const lost = brief.items.filter(
+    (i) => previousFirstSeen.get(i.id) && previousFirstSeen.get(i.id) !== i.firstSeen
+  );
+  if (lost.length) {
+    fail("firstSeen carried forward", `${lost.length} id(s) changed`);
+    for (const item of lost.slice(0, 5)) {
+      console.log(`      \xB7 ${item.id}: ${previousFirstSeen.get(item.id)} \u2192 ${item.firstSeen}`);
+    }
+  } else {
+    pass("firstSeen carried forward", `${reproduced.length} id(s) checked`);
+  }
+}
+console.log(
+  `
+${failures === 0 ? "\x1B[32mPASS\x1B[0m" : "\x1B[31mFAIL\x1B[0m"} \u2014 ${failures} failure(s), ${warnings} warning(s)
+`
+);
+process.exit(failures === 0 ? 0 : 1);