@dylanpiercey/work 0.2.3 → 0.2.4

package/lib/setup/untracked-cache.d.mts

@@ -0,0 +1,34 @@
+export interface UntrackedCacheProbe {
+  workRoot: string;
+  /** How many repo caches work keeps. */
+  caches: number;
+  /** How many have `core.untrackedCache` on. */
+  on: number;
+  /** The caches with it unset. */
+  off: string[];
+  /** Whether the work root's filesystem can keep the cache honest. */
+  filesystem: { ok: boolean; type?: string };
+  /** The user's own git config says false. */
+  declined: boolean;
+}
+export function repoCaches(workRoot: string): string[];
+export function untrackedCacheSetting(cache: string): boolean | undefined;
+export function filesystemVerdict(
+  dir: string,
+  platform?: NodeJS.Platform,
+): { ok: boolean; type?: string };
+export function mountOf(
+  at: string,
+  mountOutput: string,
+): { point: string; type: string; local: boolean } | null;
+export function gitCheckPasses(workRoot: string): Promise<boolean>;
+export function userSetting(): boolean | undefined;
+export function untrackedCacheProbe(opts?: {
+  workRoot?: string;
+}): UntrackedCacheProbe | null;
+export function enableUntrackedCache(caches: string[]): Promise<string[]>;
+export function untrackedCacheAllowed(workRoot: string): Promise<boolean>;
+export function unsetCaches(workRoot: string): string[];
+export function untrackedCacheLine(
+  p: UntrackedCacheProbe | null,
+): string | null;

package/lib/setup/untracked-cache.mjs

@@ -0,0 +1,281 @@
+// git's untracked cache for the repos work keeps (`<work root>/.cache/
+// <host>/<owner>/<name>.git`, whose worktrees are every workspace's
+// checkouts and topic branches). `git status` lists untracked files by
+// reading every directory of the worktree; with `core.untrackedCache` on,
+// git keeps each directory's listing in the index with its mtime and reads
+// again only the directories whose mtime moved, which in a large repo is
+// most of a status's time. The listing is written by any git command that
+// writes the index (an agent's add, commit or status); work's own reads,
+// which never take the index lock, only use it.
+//
+// It is only as good as the filesystem's directory mtimes: one that does
+// not move a directory's mtime when an entry is added or removed (a
+// network or FUSE filesystem), or moves it only to the second, would leave
+// `git status` — the user's and agents' too, since the setting is the
+// repo's — missing a new file. So the server turns it on (as it starts, and
+// in each repo it adds) only where the filesystem is a local one with fine
+// mtimes and git's own check (`--test-untracked-cache`) passes there, and
+// never where the user said otherwise: a repo set false, or their global
+// git config.
+import { execFile, execFileSync, spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+/** Every repo cache under the work root. */
+export function repoCaches(workRoot) {
+  const root = path.join(workRoot, ".cache");
+  const out = [];
+  for (const host of subdirs(root))
+    for (const owner of subdirs(path.join(root, host)))
+      for (const name of subdirs(path.join(root, host, owner)))
+        if (name.endsWith(".git")) out.push(path.join(root, host, owner, name));
+  return out;
+}
+
+function subdirs(dir) {
+  try {
+    return fs
+      .readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isDirectory())
+      .map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+
+/** A cache's `core.untrackedCache`: true, false, or undefined (unset, or
+ * git's `keep`). Read from its config file rather than a git process per
+ * repo: the doctor asks on every Settings load. */
+export function untrackedCacheSetting(cache) {
+  let text;
+  try {
+    text = fs.readFileSync(path.join(cache, "config"), "utf8");
+  } catch {
+    return undefined;
+  }
+  let inCore = false;
+  let value;
+  for (const raw of text.split("\n")) {
+    const line = raw.replace(/[#;].*$/, "").trim();
+    const section = /^\[\s*([^\]\s"]+)/.exec(line);
+    if (section) {
+      inCore = section[1].toLowerCase() === "core";
+      continue;
+    }
+    const kv = inCore && /^untrackedcache\s*=\s*(.*)$/i.exec(line);
+    if (kv) value = kv[1].trim().toLowerCase();
+  }
+  if (["true", "yes", "on", "1"].includes(value)) return true;
+  if (["false", "no", "off", "0"].includes(value)) return false;
+  return undefined;
+}
+
+/** Filesystems whose directory mtimes the cache cannot trust. Linux's
+ * statfs magic numbers. */
+const LINUX_UNSAFE = new Map([
+  [0x6969, "NFS"],
+  [0x517b, "SMB"],
+  [0xfe534d42, "SMB2"],
+  [0xff534d42, "CIFS"],
+  [0x65735546, "FUSE"],
+  [0x01021997, "9p"],
+  [0x00c36400, "Ceph"],
+  [0x5346414f, "AFS"],
+  [0x4d44, "FAT"],
+  [0x2011bab0, "exFAT"],
+]);
+/** macOS's by `mount`'s type name: network, FUSE, and those with
+ * second-or-coarser mtimes (HFS+, FAT). */
+const MAC_UNSAFE =
+  /^(nfs|smbfs|afpfs|webdav|cifs|macfuse|osxfuse|fuse.*|hfs|msdos|exfat)$/;
+
+/**
+ * Whether the filesystem holding `dir` can keep the cache honest, from its
+ * type alone (cheap: the doctor's). `{ ok, type }`, `type` a name where
+ * one is known.
+ */
+export function filesystemVerdict(dir, platform = process.platform) {
+  if (platform === "linux") {
+    try {
+      const { type } = fs.statfsSync(dir);
+      const bad = LINUX_UNSAFE.get(type >>> 0);
+      return bad ? { ok: false, type: bad } : { ok: true };
+    } catch {
+      return { ok: false, type: "unknown" };
+    }
+  }
+  if (platform === "darwin") {
+    const mount = macMount(dir);
+    if (!mount) return { ok: false, type: "unknown" };
+    if (!mount.local) return { ok: false, type: `${mount.type} (not local)` };
+    return MAC_UNSAFE.test(mount.type)
+      ? { ok: false, type: mount.type }
+      : { ok: true, type: mount.type };
+  }
+  return { ok: false, type: platform };
+}
+
+/** The mount holding `dir` on macOS. */
+function macMount(dir) {
+  let out;
+  try {
+    out = execFileSync("/sbin/mount", { encoding: "utf8" });
+  } catch {
+    return null;
+  }
+  let at = dir;
+  try {
+    at = fs.realpathSync(dir);
+  } catch {}
+  return mountOf(at, out);
+}
+
+/** Of `mount`'s `<dev> on <path> (<type>, local, …)` lines, the one whose
+ * mount point holds `at` most closely: `{ point, type, local }`. */
+export function mountOf(at, mountOutput) {
+  let best = null;
+  for (const line of mountOutput.split("\n")) {
+    const m = / on (.+) \(([^,)]+)((?:,[^)]*)?)\)$/.exec(line);
+    if (!m) continue;
+    const point = m[1];
+    const inside =
+      at === point || at.startsWith(point.endsWith("/") ? point : point + "/");
+    if (inside && (!best || point.length > best.point.length))
+      best = { point, type: m[2].trim(), local: /\blocal\b/.test(m[3]) };
+  }
+  return best;
+}
+
+/**
+ * git's own check that directory mtimes behave, run in a throwaway repo
+ * made on the same filesystem as the workspaces (inside the work root),
+ * never in a checkout. It takes seconds, mostly waiting on the clock.
+ */
+export async function gitCheckPasses(workRoot) {
+  let dir;
+  try {
+    dir = fs.mkdtempSync(path.join(workRoot, ".untracked-cache-check-"));
+    const run = (args) =>
+      new Promise((resolve) =>
+        spawn("git", args, { cwd: dir, stdio: "ignore" })
+          .on("exit", (code) => resolve(code === 0))
+          .on("error", () => resolve(false)),
+      );
+    return (
+      (await run(["init", "--quiet"])) &&
+      (await run(["update-index", "--test-untracked-cache"]))
+    );
+  } catch {
+    return false;
+  } finally {
+    if (dir) fs.rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+/** The user's own `core.untrackedCache` (global or system): true, false,
+ * or undefined. False is their answer for every repo, work's included. */
+export function userSetting() {
+  try {
+    const out = execFileSync(
+      "git",
+      ["config", "--get", "--type=bool", "core.untrackedCache"],
+      {
+        cwd: os.tmpdir(),
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+      },
+    ).trim();
+    return out === "true" ? true : out === "false" ? false : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Where work's caches stand. Null with no caches yet. `off` are the caches
+ * with it unset (a `false` set by hand is left alone and not counted).
+ */
+export function untrackedCacheProbe({ workRoot } = {}) {
+  const root = workRoot || defaultWorkRoot();
+  const caches = repoCaches(root);
+  if (!caches.length) return null;
+  const off = caches.filter((c) => untrackedCacheSetting(c) === undefined);
+  const on = caches.filter((c) => untrackedCacheSetting(c) === true).length;
+  return {
+    workRoot: root,
+    caches: caches.length,
+    on,
+    off,
+    filesystem: filesystemVerdict(root),
+    declined: userSetting() === false,
+  };
+}
+
+/** Turn it on in each of `caches` (their worktrees share the setting).
+ * The caches it could not set. */
+export async function enableUntrackedCache(caches) {
+  const failed = [];
+  await Promise.all(
+    caches.map(
+      (cache) =>
+        new Promise((resolve) =>
+          execFile(
+            "git",
+            [
+              "config",
+              "--file",
+              path.join(cache, "config"),
+              "core.untrackedCache",
+              "true",
+            ],
+            (err) => {
+              if (err) failed.push(cache);
+              resolve();
+            },
+          ),
+        ),
+    ),
+  );
+  return failed;
+}
+
+/** Whether work may turn it on under `workRoot`: the user has not said
+ * no, the filesystem is one it suits, and git's own check passes there. */
+export async function untrackedCacheAllowed(workRoot) {
+  if (userSetting() === false) return false;
+  if (!filesystemVerdict(workRoot).ok) return false;
+  return gitCheckPasses(workRoot);
+}
+
+/** The caches with it unset (a false set by hand stays). */
+export function unsetCaches(workRoot) {
+  return repoCaches(workRoot).filter(
+    (c) => untrackedCacheSetting(c) === undefined,
+  );
+}
+
+/** `work doctor`'s line; null with no caches yet. */
+export function untrackedCacheLine(p) {
+  if (!p) return null;
+  const head = "git status".padEnd(11);
+  if (p.declined)
+    return `${head}– git's untracked cache is off by your git config (core.untrackedCache=false)`;
+  if (!p.filesystem.ok)
+    return `${head}– git's untracked cache is off: ${p.workRoot} is on ${p.filesystem.type || "a filesystem"}, whose directory times it cannot trust`;
+  if (!p.off.length)
+    return `${head}✓ git's untracked cache is on in ${onText(p)}`;
+  return `${head}– git's untracked cache is off in ${p.off.length} of work's ${p.caches} repos: the service turns it on as it starts, where git's check of this disk passes`;
+}
+
+/** "work's 3 repos", or "2 of work's 3 repos (1 set off by hand)". */
+function onText(p) {
+  const byHand = p.caches - p.on - p.off.length;
+  return byHand
+    ? `${p.on} of work's ${p.caches} repos (${byHand} set off by hand)`
+    : `work's ${p.caches} ${p.caches === 1 ? "repo" : "repos"}`;
+}
+
+function defaultWorkRoot() {
+  return process.env.WORK_ROOT || path.join(os.homedir(), "work");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dylanpiercey/work",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "description": "Web GUI for agentic dev workspaces",
   "license": "MIT",

package/dist/_ZwD1NY8D.js

@@ -1,2 +0,0 @@
-import { _ as notifySessionsChanged } from "./_KRMk2duX.js";
-export { notifySessionsChanged };

package/dist/public/assets/_4b6fTueA.js

@@ -1 +0,0 @@
-import{$input_findOpen as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_5UQYUstJ.js

@@ -1 +0,0 @@
-import{$input_active as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_B1nFcjBS.js

@@ -1 +0,0 @@
-import{$input_status as e}from"./_8r9L-9VY.js";export{e as _};

package/dist/public/assets/_B9crCH-D.js

@@ -1 +0,0 @@
-import{$input_goNonce as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_BIkBlb5V.js

@@ -1 +0,0 @@
-import{$input_fileChange as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_BIxxnn6B.js

@@ -1 +0,0 @@
-import{$input_workspace as e}from"./_8r9L-9VY.js";export{e as _};

package/dist/public/assets/_BMECr17a.js

@@ -1 +0,0 @@
-import{$input_sectionChange as e}from"./_C204QceO.js";export{e as _};

package/dist/public/assets/_BNztKl9G.js

@@ -1 +0,0 @@
-import{$input_active as e}from"./_8r9L-9VY.js";export{e as _};

package/dist/public/assets/_BQ9TQ0w9.js

@@ -1 +0,0 @@
-import{$input_file as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_BQzlfu_A.js

@@ -1 +0,0 @@
-import{$input_rev as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_BUrIkYGg.js

@@ -1 +0,0 @@
-import{$input_filesHref as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_BgDbcHZ4.js

@@ -1 +0,0 @@
-import{$input_agentsChange as e}from"./_C204QceO.js";export{e as _};

package/dist/public/assets/_BiS6HfVD.js

@@ -1 +0,0 @@
-import{$input_file as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_Bjy8hUtC.js

@@ -1 +0,0 @@
-import{$input_revealNonce as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_Bkr5fMX1.js

@@ -1 +0,0 @@
-import{$input_onOpenDiff as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_BtMM1k2B.js

@@ -1 +0,0 @@
-import{$input_onSent as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_C--8To02.js

@@ -1 +0,0 @@
-import{$input_focusFile as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_C2I5lOqp.js

@@ -1 +0,0 @@
-import{$input_onScopeChange as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_C3Dbi3Be.js

@@ -1 +0,0 @@
-import{$input_sessions as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_C4NRfzG7.js

@@ -1 +0,0 @@
-import{$input_setupChange as e}from"./_C204QceO.js";export{e as _};

package/dist/public/assets/_C6Nc97k4.js

@@ -1 +0,0 @@
-import{$input_scope as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_CArLoLBv.js

@@ -1 +0,0 @@
-import{$input_treeOpen as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CDSiKfUM.js

@@ -1 +0,0 @@
-import{$input_workspaceBranch as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_CGHQS5qu.js

@@ -1 +0,0 @@
-import{$input_focusFileNonce as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_CKQ_sRVP.js

@@ -1 +0,0 @@
-import{$input_workspaceBranch as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CPT5gcz6.js

@@ -1 +0,0 @@
-import{$input_changesHref as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CPdnD9rC.js

@@ -1 +0,0 @@
-import{$input_focusLine as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_CSaqUoH5.js

@@ -1 +0,0 @@
-import{$setup as e,$template as t,$walks as n}from"./_8r9L-9VY.js";var r=[t,n,e];export{r as _};

package/dist/public/assets/_CWlBstvf.js

@@ -1 +0,0 @@
-import{$input_findTick as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_CX-K_hge.js

@@ -1 +0,0 @@
-import{$input_findableChange as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CXsIXsHf.js

@@ -1 +0,0 @@
-import{$input_pageActive as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_CYK4NYKF.js

@@ -1 +0,0 @@
-import{$input_preferred as e}from"./_C204QceO.js";export{e as _};

package/dist/public/assets/_Caao6gnt.js

@@ -1 +0,0 @@
-import{$input_workspaceId as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_Cez5jeQ3.js

@@ -1 +0,0 @@
-import{$input_preferredChange as e}from"./_C204QceO.js";export{e as _};

package/dist/public/assets/_CfF6EpTr.js

@@ -1 +0,0 @@
-import{$input_filesHref as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CuvH34sA.js

@@ -1 +0,0 @@
-import{C as e,E as t,F as n,S as r,T as i,w as a}from"./_BkHM28NA.js";var o=i,s=(e=>`/${e}&`)(t);function c(t){e(t.a,n)}var l=(e,t)=>a(e.a,t),u=(e,t)=>r(e.a,t);export{s as a,o as i,l as n,c as r,u as t};

package/dist/public/assets/_Cw0WiTIy.js

@@ -1 +0,0 @@
-import{$input_onCreate as e}from"./_DZUNnITm.js";export{e as _};

package/dist/public/assets/_CwQnPuk6.js

@@ -1 +0,0 @@
-import{$input_lineChange as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CxhD0aWE.js

@@ -1 +0,0 @@
-import{$input_findable as e}from"./_CRiNy5d5.js";export{e as _};

package/dist/public/assets/_CzKTCTaq.js

@@ -1 +0,0 @@
-import{$setup as e,$template as t,$walks as n}from"./_CRiNy5d5.js";var r=[t,n,e];export{r as _};

package/dist/public/assets/_D33FOujy.js

@@ -1 +0,0 @@
-import{$input_changesHref as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_D51xAv9r.js

@@ -1 +0,0 @@
-import{$input_workspaceChange as e}from"./_8r9L-9VY.js";export{e as _};

package/dist/public/assets/_D5nZD7eD.js

@@ -1 +0,0 @@
-import{$input_onOpenFile as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_D9vVVOIn.js

@@ -1 +0,0 @@
-import{$input_onRevChange as e}from"./_C6N2Y-JE.js";export{e as _};

package/dist/public/assets/_DEXYHaYS.js

@@ -1 +0,0 @@
-import{$input_workspaceName as e}from"./_CRiNy5d5.js";export{e as _};