@coreplane/switchboard 1.19.3 → 1.201.0

package/dist/assets/src/execution/residentStepPlan.ts

@@ -0,0 +1,128 @@
+/** The read-then-act plan for each engine step the resident Worker runs
+ *  (docs/reference/specs/resident-repos.md item 22), kept pure and
+ *  dependency-free so it is unit-testable from src/ and imported by the
+ *  resident Worker like residentRefresh — the tested code IS the shipped code.
+ *
+ *  Every step method on the resident (`fetchMirror`, `installDeps`, `runBuild`,
+ *  `snapshot`, `restoreCheckout`, and the wake path's dependency view) begins
+ *  by reading the facts it is about to change — a stored record, the disk
+ *  markers, the store — and asks one of these functions whether the work is
+ *  already done. A step that is done issues no command, so a second call with
+ *  the same inputs has no effect; that is what lets a caller retry a step it
+ *  cannot tell apart from one that was killed mid-way. The snapshot step adds
+ *  the compare-and-swap rule: its record is committed only over the record it
+ *  read at the start, and a stamp that moved meanwhile makes the step
+ *  `superseded`, never a throw. */
+
+import { planRefresh, type CleanScope, type RefreshDisk } from "./residentRefresh.js";
+
+/** Where `fetchMirror` records the fetch a cycle made. */
+export const LAST_FETCH_KEY = "resident:lastFetch";
+
+export interface FetchRecord {
+  /** The cycle that fetched (the alarm firing or the instance driving it). */
+  cycle: string;
+  ref: string;
+  /** The ref's tip in the mirror after that fetch. */
+  sha: string;
+  at: number;
+}
+
+export type FetchPlan = { action: "done"; why: string; sha: string } | { action: "run"; why: string };
+
+export function planFetchMirror(input: { ref: string; cycle: string; last: FetchRecord | undefined }): FetchPlan {
+  const { last } = input;
+  if (last && last.cycle === input.cycle && last.ref === input.ref) {
+    return { action: "done", why: `cycle ${input.cycle} already fetched ${input.ref}`, sha: last.sha };
+  }
+  return { action: "run", why: "no fetch recorded for this cycle" };
+}
+
+export type StepPlan = { action: "done"; why: string } | { action: "run"; why: string };
+
+export function planInstallDeps(input: { key: string; entryComplete: boolean }): StepPlan {
+  const short = input.key.slice(0, 8);
+  return input.entryComplete
+    ? { action: "done", why: `store entry ${short} is complete` }
+    : { action: "run", why: `no complete store entry for ${short}` };
+}
+
+export type BuildDisk = RefreshDisk;
+
+export type BuildPlan =
+  { action: "done"; why: string } | { action: "run"; why: string; install: boolean; clean: CleanScope };
+
+/** The build step over the refresh planner: the recorded facts already at the
+ *  target, or a checkout whose HEAD, deps and build markers all name it, is
+ *  done; anything else is the planner's rebuild, with its install gate and
+ *  clean scope. */
+export function planBuild(input: { sha: string; factsSha: string; lockfileKey: string; disk: BuildDisk }): BuildPlan {
+  const plan = planRefresh(input);
+  if (plan.action === "unchanged") return { action: "done", why: `facts already at ${input.sha.slice(0, 8)}` };
+  if (plan.action === "reuse") return { action: "done", why: plan.why };
+  return { action: "run", why: plan.why, install: plan.install, clean: plan.clean };
+}
+
+export interface SnapshotStamp {
+  ref: string;
+  sha: string;
+  lockfileHash: string;
+}
+
+/** What the stored snapshot record shows of itself: its stamp and when it was
+ *  written. Two records with equal fields are the same record. */
+export type StampedRecord = SnapshotStamp & { createdAt: string };
+
+const stampText = (s: SnapshotStamp) => `{${s.ref}, ${s.sha.slice(0, 8)}, ${s.lockfileHash.slice(0, 8)}}`;
+
+const sameStamp = (a: SnapshotStamp, b: SnapshotStamp) =>
+  a.ref === b.ref && a.sha === b.sha && a.lockfileHash === b.lockfileHash;
+
+export function planSnapshot(input: { stamp: SnapshotStamp; current: StampedRecord | undefined }): StepPlan {
+  if (!input.current) return { action: "run", why: "no snapshot recorded" };
+  return sameStamp(input.current, input.stamp)
+    ? { action: "done", why: `snapshot already at ${stampText(input.stamp)}` }
+    : { action: "run", why: `snapshot at ${stampText(input.current)}, the target is ${stampText(input.stamp)}` };
+}
+
+export type SnapshotCommit = { action: "commit" } | { action: "superseded"; by: StampedRecord | undefined };
+
+/** Commit only over the record read at the start; a record that appeared,
+ *  vanished or changed meanwhile was written by someone else and wins. */
+export function snapshotCommitDecision(input: {
+  readAtStart: StampedRecord | undefined;
+  current: StampedRecord | undefined;
+}): SnapshotCommit {
+  const { readAtStart, current } = input;
+  if (!readAtStart && !current) return { action: "commit" };
+  if (readAtStart && current && sameStamp(readAtStart, current) && readAtStart.createdAt === current.createdAt) {
+    return { action: "commit" };
+  }
+  return { action: "superseded", by: current };
+}
+
+/** The restore step: the ready marker (the sha the last materialized disk
+ *  was left at, present only when both trees exist) proves the disk. */
+export function planRestore(input: { sha: string; readyStamp: string | null }): StepPlan {
+  const target = input.sha.slice(0, 8);
+  if (input.readyStamp === input.sha) return { action: "done", why: `disk already holds ${target}` };
+  const holds = input.readyStamp === null ? "nothing" : input.readyStamp.slice(0, 8);
+  return { action: "run", why: `disk holds ${holds}, the stamp says ${target}` };
+}
+
+export type MaterializeDepsPlan = { action: "done"; why: string } | { action: "run"; why: string; needsEntry: boolean };
+
+/** The wake path's dependency view: the checkout holding its `node_modules`
+ *  is done; otherwise link the key's entry, producing it first when the store
+ *  has none. */
+export function planMaterializeDeps(input: {
+  key: string;
+  viewPresent: boolean;
+  entryComplete: boolean;
+}): MaterializeDepsPlan {
+  if (input.viewPresent) return { action: "done", why: "the checkout holds its dependency view" };
+  const short = input.key.slice(0, 8);
+  return input.entryComplete
+    ? { action: "run", why: `link the complete entry ${short}`, needsEntry: false }
+    : { action: "run", why: `materialize ${short} into the store, then link it`, needsEntry: true };
+}

package/dist/assets/web/dist/.vite/manifest.json

@@ -1,51 +1,79 @@
 {
-  "_AppShell-Bk2gbvet.js": {
-    "file": "assets/AppShell-Bk2gbvet.js",
+  "../node_modules/@fontsource-variable/instrument-sans/files/instrument-sans-latin-ext-wght-normal.woff2": {
+    "file": "assets/instrument-sans-latin-ext-wght-normal-B5bTHO_g.woff2",
+    "src": "../node_modules/@fontsource-variable/instrument-sans/files/instrument-sans-latin-ext-wght-normal.woff2"
+  },
+  "../node_modules/@fontsource-variable/instrument-sans/files/instrument-sans-latin-wght-normal.woff2": {
+    "file": "assets/instrument-sans-latin-wght-normal-BbzFLZTg.woff2",
+    "src": "../node_modules/@fontsource-variable/instrument-sans/files/instrument-sans-latin-wght-normal.woff2"
+  },
+  "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-cyrillic-wght-normal.woff2": {
+    "file": "assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2",
+    "src": "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-cyrillic-wght-normal.woff2"
+  },
+  "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-greek-wght-normal.woff2": {
+    "file": "assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2",
+    "src": "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-greek-wght-normal.woff2"
+  },
+  "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-latin-ext-wght-normal.woff2": {
+    "file": "assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2",
+    "src": "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-latin-ext-wght-normal.woff2"
+  },
+  "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-latin-wght-normal.woff2": {
+    "file": "assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2",
+    "src": "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-latin-wght-normal.woff2"
+  },
+  "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-vietnamese-wght-normal.woff2": {
+    "file": "assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2",
+    "src": "../node_modules/@fontsource-variable/jetbrains-mono/files/jetbrains-mono-vietnamese-wght-normal.woff2"
+  },
+  "_AppShell-CjDyTiip.js": {
+    "file": "assets/AppShell-CjDyTiip.js",
     "name": "AppShell",
     "imports": [
-      "_seed-BglCRKLA.js"
+      "_seed-B8mQEhhw.js"
     ]
   },
-  "_NotFoundPage-C-BuaSm8.js": {
-    "file": "assets/NotFoundPage-C-BuaSm8.js",
+  "_NotFoundPage-CbEKm0tY.js": {
+    "file": "assets/NotFoundPage-CbEKm0tY.js",
     "name": "NotFoundPage",
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
-      "_RunsTabs-C4krAL9o.js"
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
+      "_RunsTabs-rEjVQG6H.js"
     ]
   },
-  "_RunsTabs-C4krAL9o.js": {
-    "file": "assets/RunsTabs-C4krAL9o.js",
+  "_RunsTabs-rEjVQG6H.js": {
+    "file": "assets/RunsTabs-rEjVQG6H.js",
     "name": "RunsTabs",
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js"
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js"
     ]
   },
-  "_StatusDot-DuoQnQeU.js": {
-    "file": "assets/StatusDot-DuoQnQeU.js",
+  "_StatusDot-D_IPK3WP.js": {
+    "file": "assets/StatusDot-D_IPK3WP.js",
     "name": "StatusDot",
     "imports": [
-      "_seed-BglCRKLA.js",
-      "_Tooltip-BfLPyxQy.js"
+      "_seed-B8mQEhhw.js",
+      "_Tooltip-JlZp3OVC.js"
     ]
   },
-  "_Tooltip-BfLPyxQy.js": {
-    "file": "assets/Tooltip-BfLPyxQy.js",
+  "_Tooltip-JlZp3OVC.js": {
+    "file": "assets/Tooltip-JlZp3OVC.js",
     "name": "Tooltip",
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
       "src/main.ts"
     ]
   },
-  "_favicon-DL1rdWJt.js": {
-    "file": "assets/favicon-DL1rdWJt.js",
+  "_favicon-DZDjc8ab.js": {
+    "file": "assets/favicon-DZDjc8ab.js",
     "name": "favicon",
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
       "_localIso-L06jV29p.js"
     ]
   },
@@ -57,24 +85,24 @@
     "file": "assets/residentDiskBudget-BMBKlYRH.js",
     "name": "residentDiskBudget"
   },
-  "_seed-BglCRKLA.js": {
-    "file": "assets/seed-BglCRKLA.js",
+  "_seed-B8mQEhhw.js": {
+    "file": "assets/seed-B8mQEhhw.js",
     "name": "seed"
   },
-  "_wallClock-Ckv3sKoR.js": {
-    "file": "assets/wallClock-Ckv3sKoR.js",
+  "_wallClock-DI4HIEN5.js": {
+    "file": "assets/wallClock-DI4HIEN5.js",
     "name": "wallClock",
     "imports": [
-      "_seed-BglCRKLA.js"
+      "_seed-B8mQEhhw.js"
     ]
   },
   "src/main.ts": {
-    "file": "assets/main-Bnbk_Rsg.js",
+    "file": "assets/main-BKKzFAnK.js",
     "name": "main",
     "src": "src/main.ts",
     "isEntry": true,
     "imports": [
-      "_seed-BglCRKLA.js"
+      "_seed-B8mQEhhw.js"
     ],
     "dynamicImports": [
       "src/pages/RunsIndexPage.vue",
@@ -83,93 +111,102 @@
       "src/pages/ResidentsIndexPage.vue",
       "src/pages/ResidentDetailPage.vue",
       "src/pages/CostsPage.vue",
-      "_NotFoundPage-C-BuaSm8.js"
+      "_NotFoundPage-CbEKm0tY.js"
     ],
     "css": [
-      "assets/main-BsBGUyMH.css"
+      "assets/main-DoTjwE-G.css"
+    ],
+    "assets": [
+      "assets/instrument-sans-latin-ext-wght-normal-B5bTHO_g.woff2",
+      "assets/instrument-sans-latin-wght-normal-BbzFLZTg.woff2",
+      "assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2",
+      "assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2",
+      "assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2",
+      "assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2",
+      "assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2"
     ]
   },
   "src/pages/CostsPage.vue": {
-    "file": "assets/CostsPage-CTZcMYYx.js",
+    "file": "assets/CostsPage-CMAh3G74.js",
     "name": "CostsPage",
     "src": "src/pages/CostsPage.vue",
     "isDynamicEntry": true,
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js"
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js"
     ]
   },
   "src/pages/ResidentDetailPage.vue": {
-    "file": "assets/ResidentDetailPage-DvQ05AGa.js",
+    "file": "assets/ResidentDetailPage-CcfmOAIP.js",
     "name": "ResidentDetailPage",
     "src": "src/pages/ResidentDetailPage.vue",
     "isDynamicEntry": true,
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
-      "_StatusDot-DuoQnQeU.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
+      "_StatusDot-D_IPK3WP.js",
       "_residentDiskBudget-BMBKlYRH.js"
     ]
   },
   "src/pages/ResidentsIndexPage.vue": {
-    "file": "assets/ResidentsIndexPage-B3uxKUne.js",
+    "file": "assets/ResidentsIndexPage-9Z5jcteM.js",
     "name": "ResidentsIndexPage",
     "src": "src/pages/ResidentsIndexPage.vue",
     "isDynamicEntry": true,
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
-      "_StatusDot-DuoQnQeU.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
+      "_StatusDot-D_IPK3WP.js",
       "_residentDiskBudget-BMBKlYRH.js",
-      "_wallClock-Ckv3sKoR.js"
+      "_wallClock-DI4HIEN5.js"
     ]
   },
   "src/pages/RunRoutePage.vue": {
-    "file": "assets/RunRoutePage-ty94olNM.js",
+    "file": "assets/RunRoutePage-Cdimh4e0.js",
     "name": "RunRoutePage",
     "src": "src/pages/RunRoutePage.vue",
     "isDynamicEntry": true,
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
-      "_Tooltip-BfLPyxQy.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
+      "_Tooltip-JlZp3OVC.js",
       "src/main.ts",
-      "_NotFoundPage-C-BuaSm8.js",
-      "_wallClock-Ckv3sKoR.js",
-      "_favicon-DL1rdWJt.js",
+      "_NotFoundPage-CbEKm0tY.js",
+      "_wallClock-DI4HIEN5.js",
+      "_favicon-DZDjc8ab.js",
       "_localIso-L06jV29p.js"
     ],
     "css": [
-      "assets/RunRoutePage-XVFj0XDc.css"
+      "assets/RunRoutePage-CdbrbqU2.css"
     ]
   },
   "src/pages/RunsIndexPage.vue": {
-    "file": "assets/RunsIndexPage-CM-qxyQm.js",
+    "file": "assets/RunsIndexPage-CvgDXrO4.js",
     "name": "RunsIndexPage",
     "src": "src/pages/RunsIndexPage.vue",
     "isDynamicEntry": true,
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
-      "_Tooltip-BfLPyxQy.js",
-      "_RunsTabs-C4krAL9o.js",
-      "_StatusDot-DuoQnQeU.js",
-      "_wallClock-Ckv3sKoR.js",
-      "_favicon-DL1rdWJt.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
+      "_Tooltip-JlZp3OVC.js",
+      "_RunsTabs-rEjVQG6H.js",
+      "_StatusDot-D_IPK3WP.js",
+      "_wallClock-DI4HIEN5.js",
+      "_favicon-DZDjc8ab.js",
       "_localIso-L06jV29p.js"
     ]
   },
   "src/pages/ScheduledPage.vue": {
-    "file": "assets/ScheduledPage-C1psvLD4.js",
+    "file": "assets/ScheduledPage-C5bG9qvd.js",
     "name": "ScheduledPage",
     "src": "src/pages/ScheduledPage.vue",
     "isDynamicEntry": true,
     "imports": [
-      "_AppShell-Bk2gbvet.js",
-      "_seed-BglCRKLA.js",
-      "_Tooltip-BfLPyxQy.js",
-      "_RunsTabs-C4krAL9o.js",
-      "_wallClock-Ckv3sKoR.js",
+      "_AppShell-CjDyTiip.js",
+      "_seed-B8mQEhhw.js",
+      "_Tooltip-JlZp3OVC.js",
+      "_RunsTabs-rEjVQG6H.js",
+      "_wallClock-DI4HIEN5.js",
       "_localIso-L06jV29p.js"
     ]
   }