@flyingrobots/graft 0.5.0 → 0.6.0

package/src/mcp/monitor-persistence.ts

@@ -0,0 +1,54 @@
+import * as path from "node:path";
+import type { JsonCodec } from "../ports/codec.js";
+import type { FileSystem } from "../ports/filesystem.js";
+import {
+  persistedMonitorStateSchema,
+  type PersistedMonitorRecord,
+  type PersistedMonitorState,
+} from "./monitor-types.js";
+
+/**
+ * Clone a persisted monitor record (shallow copy — all fields are primitives).
+ */
+export function cloneRecord(record: PersistedMonitorRecord): PersistedMonitorRecord {
+  return { ...record };
+}
+
+/**
+ * Load monitor records from disk.
+ * Returns an empty array when the file does not exist yet.
+ */
+export async function loadMonitorRecords(
+  fs: FileSystem,
+  codec: JsonCodec,
+  statePath: string,
+): Promise<readonly PersistedMonitorRecord[]> {
+  const raw = await fs.readFile(statePath, "utf-8").catch((error: unknown) => {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  });
+  if (raw === null) return [];
+  const decoded = persistedMonitorStateSchema.parse(codec.decode(raw));
+  return decoded.monitors.map(cloneRecord);
+}
+
+/**
+ * Persist monitor records to disk, creating parent directories as needed.
+ */
+export async function persistMonitorRecords(
+  fs: FileSystem,
+  codec: JsonCodec,
+  statePath: string,
+  records: ReadonlyMap<string, PersistedMonitorRecord>,
+): Promise<void> {
+  const payload: PersistedMonitorState = {
+    version: 1,
+    monitors: [...records.values()]
+      .map(cloneRecord)
+      .sort((left, right) => left.gitCommonDir.localeCompare(right.gitCommonDir)),
+  };
+  await fs.mkdir(path.dirname(statePath), { recursive: true });
+  await fs.writeFile(statePath, codec.encode(payload), "utf-8");
+}

package/src/mcp/monitor-tick-job.ts

@@ -66,6 +66,9 @@ export async function runMonitorTickJob(job: MonitorTickWorkerJob): Promise<Moni
       ...(job.lastIndexedCommit !== null ? { from: job.lastIndexedCommit } : {}),
       ...(headAtStart !== null ? { to: headAtStart } : {}),
     });
+    if (!result.ok) {
+      throw new Error(result.error);
+    }
     const currentHead = await readHeadCommit(job.worktreeRoot);
     const lastIndexedCommit = headAtStart ?? job.lastIndexedCommit;
     const backlogCommits = await countPendingCommits(

package/src/mcp/monitor-types.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import type { JsonCodec } from "../ports/codec.js";
+import type { FileSystem } from "../ports/filesystem.js";
+import type { GitClient } from "../ports/git.js";
+import type { DaemonJobScheduler } from "./daemon-job-scheduler.js";
+import type { DaemonWorkerPool } from "./daemon-worker-pool.js";
+import type { DaemonControlPlane } from "./daemon-control-plane.js";
+import type { WorkspaceBindRequest } from "./workspace-router.js";
+
+// ── Constants ──────────────────────────────────────────────────────
+
+export const CONTROL_PLANE_DIR = "control-plane";
+export const MONITORS_FILE = "monitors.json";
+export const DEFAULT_POLL_INTERVAL_MS = 5_000;
+
+// ── Lifecycle and health unions ────────────────────────────────────
+
+export type MonitorLifecycleState = "running" | "paused" | "stopped";
+export type MonitorHealth = "ok" | "lagging" | "error" | "unauthorized" | "paused" | "stopped";
+export type MonitorWorkerKind = "git_poll_indexer";
+export type MonitorAction = "start" | "pause" | "resume" | "stop";
+
+// ── Persistence schemas ────────────────────────────────────────────
+
+export const persistedMonitorSchema = z.object({
+  repoId: z.string(),
+  gitCommonDir: z.string(),
+  anchorWorktreeRoot: z.string(),
+  workerKind: z.literal("git_poll_indexer"),
+  lifecycleState: z.enum(["running", "paused", "stopped"]),
+  health: z.enum(["ok", "lagging", "error", "unauthorized", "paused", "stopped"]),
+  pollIntervalMs: z.number().int().positive(),
+  lastStartedAt: z.string().nullable(),
+  lastTickAt: z.string().nullable(),
+  lastSuccessAt: z.string().nullable(),
+  lastError: z.string().nullable(),
+  lastIndexedCommit: z.string().nullable(),
+  lastHeadCommit: z.string().nullable(),
+  backlogCommits: z.number().int().nonnegative(),
+  lastRunCommitsIndexed: z.number().int().nonnegative(),
+  lastRunPatchesWritten: z.number().int().nonnegative(),
+}).strict();
+
+export const persistedMonitorStateSchema = z.object({
+  version: z.literal(1),
+  monitors: z.array(persistedMonitorSchema),
+}).strict();
+
+export type PersistedMonitorRecord = z.infer<typeof persistedMonitorSchema>;
+export type PersistedMonitorState = z.infer<typeof persistedMonitorStateSchema>;
+
+// ── Timer entry ────────────────────────────────────────────────────
+
+export interface MonitorTimerEntry {
+  readonly timeout: ReturnType<typeof setTimeout>;
+}
+
+// ── Public view and result types ───────────────────────────────────
+
+export interface MonitorStatusView {
+  readonly repoId: string;
+  readonly gitCommonDir: string;
+  readonly anchorWorktreeRoot: string;
+  readonly authorizedWorkspaces: number;
+  readonly workerKind: MonitorWorkerKind;
+  readonly lifecycleState: MonitorLifecycleState;
+  readonly health: MonitorHealth;
+  readonly pollIntervalMs: number;
+  readonly lastStartedAt: string | null;
+  readonly lastTickAt: string | null;
+  readonly lastSuccessAt: string | null;
+  readonly lastError: string | null;
+  readonly lastIndexedCommit: string | null;
+  readonly lastHeadCommit: string | null;
+  readonly backlogCommits: number;
+  readonly lastRunCommitsIndexed: number;
+  readonly lastRunPatchesWritten: number;
+}
+
+export interface MonitorActionResult {
+  readonly ok: boolean;
+  readonly action: MonitorAction;
+  readonly created: boolean;
+  readonly changed: boolean;
+  readonly status?: MonitorStatusView;
+  readonly errorCode?: string;
+  readonly error?: string;
+}
+
+export interface MonitorStartRequest extends WorkspaceBindRequest {
+  readonly pollIntervalMs?: number | undefined;
+}
+
+export interface PersistentMonitorRuntimeOptions {
+  readonly fs: FileSystem;
+  readonly codec: JsonCodec;
+  readonly git: GitClient;
+  readonly graftDir: string;
+  readonly controlPlane: DaemonControlPlane;
+  readonly scheduler: DaemonJobScheduler;
+  readonly workerPool: DaemonWorkerPool;
+  readonly defaultPollIntervalMs?: number | undefined;
+}