@tidegap/cli 0.0.0-stage → 0.19.0

package/dist/ui/summary.js

@@ -0,0 +1,120 @@
+/**
+ * `GET /api/summary` (native clients KTD5): the one answer a compact client
+ * renders. Queue counts, unread count, the next run, the next clean grid
+ * window and, with `since`, the tasks finished after that cursor. The clean
+ * window rule lives here once, so the extension badge and the Mac menu bar
+ * show the same numbers.
+ */
+import { taskSummary } from "../commands/queue.js";
+const HOUR_MS = 3_600_000;
+const CLEAN_BANDS = new Set(["very_clean", "clean"]);
+/** Most finished tasks one summary lists. */
+export const SUMMARY_FINISHED_MAX = 20;
+export const ACTIVE_STATUSES = ["queued", "scheduled", "running", "submitted"];
+/**
+ * The first run of consecutive clean or very clean hours that ends after
+ * `now`. Without one, the cleanest hour that ends after `now`, flagged
+ * `fallback`. `null` when the forecast has no hour after `now`.
+ */
+export function nextCleanWindow(points, now) {
+    const t = now.getTime();
+    const hours = points
+        .map((p) => ({ ...p, start: Date.parse(p.t) }))
+        .filter((p) => Number.isFinite(p.start))
+        .sort((a, b) => a.start - b.start);
+    const window = (run, fallback) => {
+        const start = run[0].start;
+        const end = run[run.length - 1].start + HOUR_MS;
+        return {
+            start: new Date(start).toISOString(),
+            end: new Date(end).toISOString(),
+            band: fallback ? run[0].band : run.every((h) => h.band === "very_clean") ? "very_clean" : "clean",
+            g: Math.min(...run.map((h) => h.g)),
+            now: start <= t && t < end,
+            fallback,
+        };
+    };
+    // Runs of consecutive clean hours; the first one that ends after now wins,
+    // with the hours of it that already passed (so "now" shows the whole run).
+    let run = [];
+    for (const h of hours) {
+        const prev = run[run.length - 1];
+        if (CLEAN_BANDS.has(h.band) && (!prev || h.start === prev.start + HOUR_MS)) {
+            run.push(h);
+        }
+        else {
+            if (run.length > 0 && run[run.length - 1].start + HOUR_MS > t)
+                return window(run, false);
+            run = CLEAN_BANDS.has(h.band) ? [h] : [];
+        }
+    }
+    if (run.length > 0 && run[run.length - 1].start + HOUR_MS > t)
+        return window(run, false);
+    const ahead = hours.filter((h) => h.start + HOUR_MS > t);
+    if (ahead.length === 0)
+        return null;
+    const cleanest = ahead.reduce((best, h) => (h.g < best.g ? h : best));
+    return window([cleanest], true);
+}
+function brief(r) {
+    return { task_id: r.taskId, title: String(taskSummary(r).display_title) };
+}
+/**
+ * How many of `times` (ascending) one summary lists: at most
+ * SUMMARY_FINISHED_MAX, cut so that tasks sharing a `completed_at` are never
+ * split across two polls (the next `since` is that instant, and `>` would
+ * skip the rest). Only when more than the cap share the first instant does
+ * the cut grow past the cap to take all of them.
+ */
+function capCut(times) {
+    if (times.length <= SUMMARY_FINISHED_MAX)
+        return times.length;
+    let cut = SUMMARY_FINISHED_MAX;
+    while (cut > 0 && times[cut] === times[cut - 1])
+        cut--;
+    if (cut > 0)
+        return cut;
+    cut = SUMMARY_FINISHED_MAX;
+    while (cut < times.length && times[cut] === times[cut - 1])
+        cut++;
+    return cut;
+}
+/** Assemble the summary body (KTD5). */
+export function buildSummary(input) {
+    const { store, now } = input;
+    const generatedAt = now.toISOString();
+    const counts = Object.fromEntries(ACTIVE_STATUSES.map((s) => [s, store.list({ status: s }).length]));
+    const active = ACTIVE_STATUSES.reduce((n, s) => n + counts[s], 0);
+    const upcoming = [...store.list({ status: "scheduled" }), ...store.list({ status: "queued" })]
+        .filter((r) => r.scheduledFor && Number.isFinite(Date.parse(r.scheduledFor)))
+        .sort((a, b) => Date.parse(a.scheduledFor) - Date.parse(b.scheduledFor));
+    const next = upcoming[0];
+    const body = {
+        generated_at: generatedAt,
+        region: input.region,
+        counts,
+        active,
+        unread: store.list({ unread: true }).length,
+        next_run: next ? { ...brief(next), scheduled_for: next.scheduledFor } : null,
+        clean_window: input.points ? nextCleanWindow(input.points, now) : null,
+        forecast_ok: input.points !== null,
+    };
+    if (input.since === undefined)
+        return { ...body, cursor: generatedAt };
+    const since = input.since.getTime();
+    // Over the cap, take the oldest after `since`: the cursor stops at the
+    // newest of those, so the next poll lists the rest and none is skipped.
+    const after = [...store.list({ status: "completed" }), ...store.list({ status: "failed" })]
+        .filter((r) => r.completedAt && Date.parse(r.completedAt) > since)
+        .sort((a, b) => Date.parse(a.completedAt) - Date.parse(b.completedAt));
+    const finished = after.slice(0, capCut(after.map((r) => Date.parse(r.completedAt)))).reverse();
+    return {
+        ...body,
+        finished: finished.map((r) => ({ ...brief(r), status: r.status, completed_at: r.completedAt })),
+        // The server's own clock: clients never compare their clock with ours.
+        // With nothing new, keep the caller's cursor so a task stamped just
+        // before `generated_at` but written after it is still reported.
+        cursor: finished[0]?.completedAt ?? input.since.toISOString(),
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/ui/summary.js.map

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

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@tidegap/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.19.0",
+  "description": "The tidegap command: runs queued Tidegap LLM tasks at the cleanest grid hour before their deadline.",
+  "license": "Apache-2.0",
+  "author": "Vitalii Borovyk",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "bin": {
+    "tidegap": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "ui",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "@tidegap/core": "0.19.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.32.0",
+    "openai": ">=4.70.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.11",
+    "@types/node": "^22.20.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tidegap/tidegap.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
 }

package/ui/agenda.js

@@ -0,0 +1,256 @@
+// Agenda: the default view. Pending tasks grouped by local day (Today,
+// Tomorrow, weekday + date, Later), with overdue tasks and unread failures
+// in "Needs attention" on top, and projected rows for upcoming occurrences
+// of repeating series. Day headers are drop targets (dnd.js).
+
+import {
+  by,
+  bandChip,
+  dayLabel,
+  dayStart,
+  daysFromToday,
+  h,
+  hm,
+  nextDayStart,
+  parse,
+  relDay,
+  when,
+} from "./dom.js";
+import { projectedRow, shortDay, statusTag, taskRow } from "./row.js";
+import { finishedTasks, pendingTasks, state } from "./state.js";
+import { emptyState, errorCard, skeletonRows } from "./views.js";
+
+const PROJECT_DAYS = 14;
+const LATER = "later";
+
+/** Ids the user sent "Run now" from this page; they read "runs on the next tick". */
+export const ranNow = new Set();
+
+/** Seconds between dispatcher ticks, from /api/status. */
+function tickInterval() {
+  return state.status?.dispatcher?.interval_s ?? 300;
+}
+
+function dispatcherRunning() {
+  return state.status?.dispatcher?.state === "running";
+}
+
+/** When a task runs, in ms: its scheduled hour, else its deadline. */
+export function runAt(t) {
+  const at = parse(t.scheduled_for);
+  return Number.isFinite(at) ? at : parse(t.deadline);
+}
+
+/** Pending, due, but no tick picked it up in two intervals (or none runs). */
+function isOverdue(t, now = Date.now()) {
+  if (t.status !== "queued" && t.status !== "scheduled") return false;
+  if (t._op || ranNow.has(t.task_id)) return false;
+  const at = runAt(t);
+  if (!Number.isFinite(at) || at > now) return false;
+  return !dispatcherRunning() || now - at > 2 * tickInterval() * 1000;
+}
+
+function isDue(t, now) {
+  const at = runAt(t);
+  return (t.status === "queued" || t.status === "scheduled") && Number.isFinite(at) && at <= now;
+}
+
+/** Region whose forecast colours the day headers: the most common pending one. */
+function primaryRegion(tasks) {
+  const counts = new Map();
+  for (const t of tasks) counts.set(t.region, (counts.get(t.region) || 0) + 1);
+  let best = state.status?.default_region;
+  let n = 0;
+  for (const [r, c] of counts) if (c > n) [best, n] = [r, c];
+  return best;
+}
+
+/** Cleanest forecast hour in [from, to) for `region`, or null. */
+export function cleanest(region, from, to) {
+  const f = state.forecasts.get(region);
+  if (!f || f.points.length === 0) return null;
+  let best = null;
+  for (const p of f.points) {
+    const t = Date.parse(p.t);
+    if (t + 3_600_000 <= from || t >= to) continue;
+    if (!best || p.g < best.g) best = { ...p, ms: t };
+  }
+  return best;
+}
+
+function dayHeader(key, label, sub, count, region, now) {
+  const isDay = key !== LATER;
+  const start = isDay ? Number(key) : NaN;
+  const attrs = { class: "day-head" };
+  if (isDay) {
+    attrs["data-drop-day"] = String(start);
+    const rel = relDay(start, now);
+    // Weekday names already are the date ("Sat 17 Oct"); only Today and
+    // Tomorrow need it added.
+    attrs["data-drop-label"] = rel === dayLabel(start) ? rel : `${rel} · ${dayLabel(start)}`;
+  }
+  const head = h("div", attrs,
+    h("h2", { class: "day-title" }, label, sub ? h("span", { class: "day-sub" }, ` · ${sub}`) : null),
+    count ? h("span", { class: "day-count", "aria-label": `${count} tasks` }, String(count)) : null);
+  if (isDay) {
+    const best = cleanest(region, Math.max(start, now), nextDayStart(start));
+    const forecastLoaded = state.forecasts.has(region);
+    head.append(
+      best
+        ? h("span", { class: "day-clean" }, "cleanest ", h("span", { class: "num" }, hm(best.ms)), " ", bandChip(best.band))
+        : forecastLoaded
+          ? h("span", { class: "day-clean muted" }, "forecast not available yet")
+          : null,
+    );
+  }
+  head.append(h("span", { class: "drop-hint", "aria-hidden": "true" }, isDay ? `Move to ${relDay(start, now)}` : ""));
+  return head;
+}
+
+function agendaMeta(t, now) {
+  const dl = parse(t.deadline);
+  const parts = [];
+  if (t.status === "running" || t.status === "submitted") parts.push(statusTag(t));
+  if (ranNow.has(t.task_id) && isDue(t, now)) parts.push(h("span", { class: "tag tag-accent" }, "runs on the next tick"));
+  else if (isOverdue(t, now)) parts.push(h("span", { class: "tag tag-warn" }, `overdue since ${when(runAt(t), now)}`));
+  else if (isDue(t, now)) parts.push(h("span", { class: "tag tag-accent" }, "due · runs on the next tick"));
+  if (Number.isFinite(dl)) parts.push(by(dl, now));
+  if (t.origin_host) parts.push(t.origin_host);
+  return parts;
+}
+
+function timeLabel(t, key, now) {
+  if (isDue(t, now) || t.status === "running") return "now";
+  if (t.status === "submitted") return "batch";
+  const at = runAt(t);
+  if (key === LATER) return shortDay(at);
+  return hm(at);
+}
+
+export function renderAgenda(root, { selectedId } = {}) {
+  const now = Date.now();
+  const header = h("div", { class: "view-head" }, h("h1", { class: "view-title" }, "Agenda"));
+  root.append(header);
+
+  if (!state.loaded) {
+    root.append(state.error ? errorCard("Could not load tasks.") : skeletonGroups());
+    return;
+  }
+  if (state.error) root.append(errorCard("Could not refresh tasks. Showing the last data."));
+
+  const pend = pendingTasks();
+  const attention = [];
+  const upcoming = [];
+  for (const t of pend) (isOverdue(t, now) ? attention : upcoming).push(t);
+  const failed = finishedTasks()
+    .filter((t) => t.status === "failed" && !t.read_at)
+    .sort((a, b) => parse(b.completed_at) - parse(a.completed_at));
+
+  const nextRun = upcoming.map(runAt).filter((x) => Number.isFinite(x) && x > now).sort((a, b) => a - b)[0];
+  header.append(
+    h("p", { class: "view-sub" },
+      upcoming.length === 0
+        ? "Nothing scheduled"
+        : `${upcoming.length} scheduled${nextRun ? ` · next run ${when(nextRun, now)}` : ""}`),
+  );
+
+  if (attention.length || failed.length) {
+    const section = h("section", { class: "group group-attention", "aria-label": "Needs attention" },
+      h("div", { class: "day-head day-head-attention" },
+        h("h2", { class: "day-title" }, "Needs attention"),
+        h("span", { class: "day-count" }, String(attention.length + failed.length))));
+    const list = h("ul", { class: "rows" });
+    for (const t of attention.sort((a, b) => runAt(a) - runAt(b))) {
+      list.append(taskRow(t, {
+        ctx: "attention",
+        time: "▲ " + hm(runAt(t)),
+        meta: agendaMeta(t, now),
+        selected: t.task_id === selectedId,
+      }));
+    }
+    for (const t of failed) {
+      list.append(taskRow(t, {
+        ctx: "attention",
+        time: "✕ failed",
+        band: null,
+        meta: [`failed ${when(parse(t.completed_at), now)}`, t.origin_host].filter(Boolean),
+        selected: t.task_id === selectedId,
+      }));
+    }
+    section.append(list);
+    root.append(section);
+  }
+
+  // Group upcoming tasks and projected series occurrences by local day.
+  const groups = new Map();
+  const put = (key, item) => {
+    if (!groups.has(key)) groups.set(key, []);
+    groups.get(key).push(item);
+  };
+  const keyOf = (ms) => {
+    const at = Number.isFinite(ms) ? Math.max(ms, now) : now;
+    return daysFromToday(at, now) > 6 ? LATER : String(dayStart(at));
+  };
+  for (const t of upcoming) put(keyOf(runAt(t)), { at: Math.max(runAt(t) || now, 0), task: t });
+  for (const s of state.series.values()) {
+    if (s.ended || !s.next_deadlines) continue;
+    const head = s.occurrences?.[s.occurrences.length - 1];
+    if (!head || !pend.some((t) => t.series_id === s.series_id)) continue;
+    for (const iso of s.next_deadlines) {
+      const ms = parse(iso);
+      if (!Number.isFinite(ms) || ms - now > PROJECT_DAYS * 86_400_000) break;
+      put(keyOf(ms - 3_600_000), { at: ms - 3_600_000, projected: { ...s, head }, deadline: ms });
+    }
+  }
+
+  if (upcoming.length === 0) {
+    const journalCount = finishedTasks().length;
+    root.append(
+      emptyState({
+        title: "Nothing scheduled.",
+        body: [
+          "Defer work from Claude Code with ",
+          h("code", {}, "/tidegap:defer <task> --by 6h"),
+          ", or from any MCP client with ",
+          h("code", {}, "schedule_task"),
+          ". It shows up here with the hour tidegap picked.",
+        ],
+        link: journalCount ? { href: "#/journal", text: `${journalCount} finished in the Journal →` } : null,
+      }),
+    );
+    if (groups.size === 0) return;
+  }
+
+  const region = primaryRegion(pend);
+  const keys = [...groups.keys()].sort((a, b) => (a === LATER ? 1 : b === LATER ? -1 : Number(a) - Number(b)));
+  for (const key of keys) {
+    const items = groups.get(key).sort((a, b) => a.at - b.at);
+    const start = key === LATER ? NaN : Number(key);
+    const label = key === LATER ? "Later" : relDay(start, now);
+    const sub = key === LATER ? "" : daysFromToday(start, now) < 2 ? dayLabel(start) : "";
+    const section = h("section", { class: "group", "aria-label": key === LATER ? "Later" : `${label} ${dayLabel(start)}` });
+    section.append(dayHeader(key, key === LATER ? label : daysFromToday(start, now) < 2 ? label : dayLabel(start), sub, items.filter((i) => i.task).length, region, now));
+    const list = h("ul", { class: "rows" });
+    for (const item of items) {
+      if (item.task) {
+        list.append(taskRow(item.task, {
+          time: timeLabel(item.task, key, now),
+          meta: agendaMeta(item.task, now),
+          selected: item.task.task_id === selectedId,
+        }));
+      } else {
+        list.append(projectedRow(item.projected, item.deadline, key === LATER));
+      }
+    }
+    section.append(list);
+    root.append(section);
+  }
+}
+
+function skeletonGroups() {
+  const wrap = h("div", { class: "skeleton-wrap", "aria-busy": "true", "aria-label": "Loading tasks" });
+  for (let g = 0; g < 3; g++) {
+    wrap.append(h("div", { class: "day-head skeleton-head" }, h("span", { class: "sk sk-title" })), skeletonRows(2));
+  }
+  return wrap;
+}

package/ui/api.js

@@ -0,0 +1,114 @@
+// API client. The token lives in this module's memory only: it is read once
+// from the URL fragment (never sent to the server by the browser) and every
+// request carries it in the Authorization header. No cookie, no storage.
+
+let token = null;
+
+export class SessionExpired extends Error {
+  constructor() {
+    super("This link expired. Run tidegap ui again.");
+  }
+}
+
+/** A non-2xx answer. `message` is the server's one-line error. */
+export class ApiError extends Error {
+  constructor(status, message) {
+    super(message || `HTTP ${status}`);
+    this.status = status;
+  }
+}
+
+export function setToken(t) {
+  token = t;
+}
+
+export function hasToken() {
+  return !!token;
+}
+
+function headers(json) {
+  const out = { authorization: `Bearer ${token}` };
+  if (json) out["content-type"] = "application/json";
+  return out;
+}
+
+/** Raw fetch with the bearer header; 401 becomes SessionExpired. */
+export async function request(path, init = {}) {
+  if (!token) throw new SessionExpired();
+  const res = await fetch(path, { ...init, headers: { ...headers(init.json), ...(init.headers || {}) } });
+  if (res.status === 401) throw new SessionExpired();
+  return res;
+}
+
+async function errorOf(res) {
+  let msg = "";
+  try {
+    const body = await res.json();
+    if (body && typeof body.error === "string") msg = body.error;
+  } catch {
+    // no JSON body
+  }
+  return new ApiError(res.status, msg);
+}
+
+export async function get(path) {
+  const res = await request(path);
+  if (!res.ok) throw await errorOf(res);
+  return res.json();
+}
+
+/**
+ * POST a write. `body` undefined sends no body and no content type (the
+ * body-less routes refuse one); an object is sent as JSON.
+ */
+async function post(path, body) {
+  const init = { method: "POST" };
+  if (body !== undefined) {
+    init.json = true;
+    init.body = JSON.stringify(body);
+  }
+  const res = await request(path, init);
+  if (!res.ok) throw await errorOf(res);
+  if (res.status === 204) return null;
+  return res.json();
+}
+
+/**
+ * Fire-and-forget POST that survives page unload (pending cancels on
+ * pagehide). keepalive keeps the request alive after the page is gone.
+ */
+export function postKeepalive(path, body) {
+  if (!token) return;
+  try {
+    fetch(path, {
+      method: "POST",
+      keepalive: true,
+      headers: headers(body !== undefined),
+      body: body === undefined ? undefined : JSON.stringify(body),
+    });
+  } catch {
+    // the page is going away; nothing to report to
+  }
+}
+
+const enc = encodeURIComponent;
+
+export const tasksPath = (id, action) => `/api/tasks/${enc(id)}${action ? `/${action}` : ""}`;
+
+export const api = {
+  list: (query) => get(`/api/tasks${query ? `?${query}` : ""}`),
+  task: (id) => get(tasksPath(id)),
+  series: (id) => get(`/api/series/${enc(id)}`),
+  status: () => get("/api/status"),
+  forecast: (region, hours) => get(`/api/forecast?region=${enc(region)}&hours=${hours}`),
+  cancel: (id, series = false) => post(tasksPath(id, "cancel"), series ? { series: true } : {}),
+  reschedule: (id, target) => post(tasksPath(id, "reschedule"), target),
+  runNow: (id) => post(tasksPath(id, "run-now")),
+  reply: (id, text) => post(tasksPath(id, "reply"), { text }),
+  read: (id) => post(tasksPath(id, "read")),
+  unread: (id) => post(tasksPath(id, "unread")),
+  startDispatcher: () => post("/api/dispatcher/start"),
+  clients: () => get("/api/clients"),
+  addClient: (client) => post("/api/clients", client),
+  revokeClient: (id) => post(`/api/clients/${enc(id)}/revoke`),
+};