frizz 0.1.0 → 0.3.0

package/dist/frizz.js

@@ -12,8 +12,8 @@ var __export = (target2, all) => {
 
 // packages/server/src/frizz-paths.ts
 import { existsSync } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join2 } from "node:path";
+import { homedir as homedir2, tmpdir } from "node:os";
+import { dirname, join as join2 } from "node:path";
 function legacyFrizzRoot(home = homedir2()) {
   return join2(home, LEGACY_DIR_NAME);
 }
@@ -387,7 +387,7 @@ import {
   writeFileSync as writeFileSync2
 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname, join as join4, resolve } from "node:path";
+import { dirname as dirname2, join as join4, resolve } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
 function errorCode2(error) {
   return error && typeof error === "object" && "code" in error && typeof error.code === "string" ? error.code : void 0;
@@ -492,7 +492,7 @@ function quarantineLock(lockPath) {
   return true;
 }
 function tryAcquireLock(lockPath, adapter) {
-  mkdirSync2(dirname(lockPath), { recursive: true, mode: 448 });
+  mkdirSync2(dirname2(lockPath), { recursive: true, mode: 448 });
   let fd;
   try {
     fd = openSync2(lockPath, "wx", 384);
@@ -513,7 +513,7 @@ function tryAcquireLock(lockPath, adapter) {
 `, "utf8");
     fsyncSync(fd);
     closeSync(fd);
-    syncDirectory(dirname(lockPath));
+    syncDirectory(dirname2(lockPath));
   } catch (error) {
     try {
       closeSync(fd);
@@ -663,7 +663,7 @@ function syncGitConfigPath(path) {
   } finally {
     closeSync(fd);
   }
-  syncDirectory(dirname(path));
+  syncDirectory(dirname2(path));
 }
 function syncGitConfig(dir) {
   let raw;
@@ -744,6 +744,35 @@ function resolveGitProjectIdentity(dir, home = homedir4()) {
     release();
   }
 }
+function parseRepoLabel(remoteUrl) {
+  const url = remoteUrl.trim();
+  if (!url) return null;
+  const scp = url.match(/^[^/@]+@[^:/]+:(.+?)(?:\.git)?\/?$/);
+  if (scp) return normalizeOwnerRepo(scp[1]);
+  const m = url.match(/^[a-z][a-z0-9+.-]*:\/\/[^/]+\/(.+?)(?:\.git)?\/?$/i);
+  if (m) return normalizeOwnerRepo(m[1]);
+  return null;
+}
+function normalizeOwnerRepo(path) {
+  const parts = path.split("/").filter(Boolean);
+  if (parts.length < 2) return null;
+  return parts.slice(-2).join("/");
+}
+function originRemoteUrl(dir) {
+  try {
+    return execFileSync2("git", ["remote", "get-url", "origin"], {
+      cwd: dir,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim() || null;
+  } catch {
+    return null;
+  }
+}
+function resolveProjectLabel(dir) {
+  const url = originRemoteUrl(dir);
+  return url ? parseRepoLabel(url) : null;
+}
 var GLOBAL_LOCK_NAME, GLOBAL_LOCK_OWNER, PORT_LOCK_DIR, INCOMPLETE_LOCK_GRACE_MS, LOCK_POLL_MS, PROJECT_ID_RE, SYNC_WAIT2;
 var init_project_identity = __esm({
   "packages/server/src/project-identity.ts"() {
@@ -773,7 +802,7 @@ import {
   statSync as statSync3,
   writeFileSync as writeFileSync3
 } from "node:fs";
-import { basename as basename2, dirname as dirname2, isAbsolute, join as join5 } from "node:path";
+import { basename as basename2, dirname as dirname3, isAbsolute, join as join5 } from "node:path";
 function errorCode3(error) {
   return error && typeof error === "object" && "code" in error && typeof error.code === "string" ? error.code : void 0;
 }
@@ -796,8 +825,8 @@ function syncDirectory2(path) {
   }
 }
 function atomicJson(path, value) {
-  mkdirSync3(dirname2(path), { recursive: true, mode: 448 });
-  const temp = join5(dirname2(path), `.${basename2(path)}.${process.pid}.${randomUUID3()}.tmp`);
+  mkdirSync3(dirname3(path), { recursive: true, mode: 448 });
+  const temp = join5(dirname3(path), `.${basename2(path)}.${process.pid}.${randomUUID3()}.tmp`);
   let fd;
   try {
     fd = openSync3(temp, "wx", 384);
@@ -807,7 +836,7 @@ function atomicJson(path, value) {
     closeSync2(fd);
     fd = void 0;
     renameSync2(temp, path);
-    syncDirectory2(dirname2(path));
+    syncDirectory2(dirname3(path));
   } catch (error) {
     if (fd !== void 0) {
       try {
@@ -984,7 +1013,7 @@ function writeNewOwner(path, record) {
     fsyncSync2(fd);
     closeSync2(fd);
     fd = void 0;
-    syncDirectory2(dirname2(path));
+    syncDirectory2(dirname3(path));
   } catch (error) {
     if (fd !== void 0) {
       try {
@@ -1200,6 +1229,7 @@ var OWNER_NAME, MUTATION_GUARD_NAME, OWNER_VERSION, PARTIAL_GRACE_MS, GUARD_TIME
 var init_project_launch = __esm({
   "packages/server/src/project-launch.ts"() {
     "use strict";
+    init_project_identity();
     init_process_generation();
     init_process_generation();
     OWNER_NAME = "project-launch.owner";
@@ -1376,7 +1406,7 @@ var init_local_origin = __esm({
 
 // packages/server/src/boot-progress.ts
 import { mkdirSync as mkdirSync4, readFileSync as readFileSync4, renameSync as renameSync3, rmSync as rmSync4, writeFileSync as writeFileSync4 } from "node:fs";
-import { basename as basename3, dirname as dirname3, join as join6 } from "node:path";
+import { basename as basename3, dirname as dirname4, join as join6 } from "node:path";
 function bootProgressPath(stateDir) {
   return join6(stateDir, BOOT_PROGRESS_NAME);
 }
@@ -1397,409 +1427,157 @@ var init_boot_progress = __esm({
   }
 });
 
-// packages/server/src/sqlite-quiet.ts
-function isSqliteExperimentalNotice(warning, type) {
-  const name = typeof warning === "string" ? type : warning?.name;
-  if (name !== "ExperimentalWarning") return false;
-  const text = typeof warning === "string" ? warning : warning?.message ?? "";
-  return text.includes("SQLite");
-}
-var emitWarning;
-var init_sqlite_quiet = __esm({
-  "packages/server/src/sqlite-quiet.ts"() {
-    "use strict";
-    emitWarning = process.emitWarning.bind(process);
-    process.emitWarning = ((warning, ...rest) => {
-      const type = typeof rest[0] === "string" ? rest[0] : void 0;
-      if (isSqliteExperimentalNotice(warning, type)) return;
-      return emitWarning(warning, ...rest);
-    });
-  }
-});
-
-// packages/server/src/sqlite.ts
-import { createRequire } from "node:module";
-function namedParameters(sql) {
-  const found = /* @__PURE__ */ new Set();
-  for (let index = 0; index < sql.length; index++) {
-    const char = sql[index];
-    if (char === "'" || char === '"' || char === "`") {
-      const quote = char;
-      index++;
-      while (index < sql.length) {
-        if (sql[index] === quote) {
-          if (sql[index + 1] === quote) index++;
-          else break;
-        }
-        index++;
-      }
-      continue;
-    }
-    if (char === "[") {
-      while (index < sql.length && sql[index] !== "]") index++;
-      continue;
-    }
-    if (char === "-" && sql[index + 1] === "-") {
-      while (index < sql.length && sql[index] !== "\n") index++;
-      continue;
-    }
-    if (char === "/" && sql[index + 1] === "*") {
-      index += 2;
-      while (index < sql.length && !(sql[index] === "*" && sql[index + 1] === "/")) index++;
-      index++;
-      continue;
-    }
-    if (char === "@" || char === ":" || char === "$") {
-      let end = index + 1;
-      while (end < sql.length && /[A-Za-z0-9_]/.test(sql[end])) end++;
-      if (end > index + 1) found.add(sql.slice(index + 1, end));
-      index = end - 1;
-    }
-  }
-  return [...found];
-}
-function isNamedBagCandidate(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && !ArrayBuffer.isView(value) && !(value instanceof ArrayBuffer) && !(value instanceof Date);
-}
-function plainRow(row) {
-  return row === void 0 || row === null ? row : Object.assign({}, row);
-}
-function hasBinding(bag, name) {
-  return name in bag || `@${name}` in bag || `:${name}` in bag || `$${name}` in bag;
-}
-function transactionControl(sql) {
-  let last = null;
-  for (const statement of sql.split(";")) {
-    const text = statement.trim().toUpperCase();
-    if (/^BEGIN\b/.test(text)) last = "open";
-    else if (/^(COMMIT|END)\b/.test(text)) last = "close";
-    else if (/^ROLLBACK\b/.test(text) && !/^ROLLBACK\s+TO\b/.test(text)) last = "close";
-  }
-  return last;
-}
-var DatabaseSync, PreparedStatement, Database;
-var init_sqlite = __esm({
-  "packages/server/src/sqlite.ts"() {
-    "use strict";
-    init_sqlite_quiet();
-    ({ DatabaseSync } = createRequire(import.meta.url)("node:sqlite"));
-    PreparedStatement = class {
-      #statement;
-      #required;
-      #sql;
-      constructor(statement, sql) {
-        this.#statement = statement;
-        this.#sql = sql;
-        this.#required = namedParameters(sql);
-      }
-      /**
-       * Build exactly the bindings this statement asks for, and nothing else.
-       *
-       * Frizz hands whole row objects to statements that bind a subset of their fields, which raw
-       * node:sqlite rejects with "Unknown named parameter". The obvious fix is
-       * `setAllowUnknownNamedParameters(true)` — but that method only exists from Node 23.11, and using it
-       * would have raised Frizz's floor above the release that first shipped `node:sqlite` at all, for no
-       * reason. Selecting the required names from the bag needs no runtime API, and gets the same result.
-       *
-       * A name the caller never supplied throws, rather than binding NULL the way node:sqlite would.
-       * See the file header: silently writing NULL where a value was expected is the one difference that
-       * could quietly corrupt data instead of failing.
-       */
-      #bind(params) {
-        if (params.length === 1 && this.#required.length > 0 && isNamedBagCandidate(params[0])) {
-          const bag = params[0];
-          const bound = {};
-          for (const name of this.#required) {
-            if (!hasBinding(bag, name)) {
-              throw new RangeError(
-                `Missing named parameter "${name}" for statement: ${this.#sql.trim().slice(0, 120)}`
-              );
-            }
-            const value = name in bag ? bag[name] : bag[`@${name}`] ?? bag[`:${name}`] ?? bag[`$${name}`];
-            bound[name] = value === void 0 ? null : value;
-          }
-          return [bound];
-        }
-        return params.map((value) => value === void 0 ? null : value);
-      }
-      run(...params) {
-        const result = this.#statement.run(...this.#bind(params));
-        return { changes: Number(result.changes), lastInsertRowid: Number(result.lastInsertRowid) };
-      }
-      get(...params) {
-        return plainRow(this.#statement.get(...this.#bind(params)));
-      }
-      all(...params) {
-        return this.#statement.all(...this.#bind(params)).map(plainRow);
-      }
-    };
-    Database = class {
-      #db;
-      /** Transaction nesting depth, so a nested transaction becomes a SAVEPOINT rather than an error. */
-      #depth = 0;
-      /** Fallback transaction state for runtimes without `isTransaction` (added in Node 24). */
-      #openTransaction = false;
-      /** better-sqlite3 exposes the database file here; the scheduler tests reopen a store through it. */
-      name;
-      constructor(path, options2 = {}) {
-        this.name = path;
-        this.#db = new DatabaseSync(path, options2.readonly ? { readOnly: true } : {});
-      }
-      /** True while a transaction is open, however it was opened. */
-      get inTransaction() {
-        const native = this.#db.isTransaction;
-        return typeof native === "boolean" ? native : this.#openTransaction;
-      }
-      /**
-       * Type parameters are `<BindParameters, Row>`, matching better-sqlite3 — 53 call sites already
-       * spell them that way (`prepare<[string], SessionRow>`), and silently swapping the order would
-       * type every one of them as `any` rather than failing loudly.
-       */
-      prepare(sql) {
-        return new PreparedStatement(this.#db.prepare(sql), sql);
-      }
-      /** Returns the database, matching better-sqlite3, so existing `db.exec(a).exec(b)` chains hold. */
-      exec(sql) {
-        this.#db.exec(sql);
-        const control = transactionControl(sql);
-        if (control === "open") this.#openTransaction = true;
-        else if (control === "close") this.#openTransaction = false;
-        return this;
-      }
-      /**
-       * `PRAGMA` with better-sqlite3's calling convention. Frizz only ever SETS pragmas (`journal_mode`,
-       * `busy_timeout`, `foreign_keys`) and ignores the result, but returning the rows keeps the shape
-       * honest for a read like `pragma("journal_mode")`.
-       */
-      pragma(source) {
-        const sql = `PRAGMA ${source}`;
-        try {
-          return this.#db.prepare(sql).all();
-        } catch {
-          this.#db.exec(sql);
-          return void 0;
-        }
-      }
-      /**
-       * better-sqlite3's `transaction()`, including the part that is easy to miss: it is RE-ENTRANT.
-       * Calling one transaction-wrapped function from inside another must not throw "cannot start a
-       * transaction within a transaction" — better-sqlite3 quietly switches to a SAVEPOINT, and Frizz's
-       * storage layer composes these freely, so the nesting has to survive the port.
-       */
-      transaction(fn) {
-        const runWith = (mode) => (...args2) => {
-          const depth = this.#depth;
-          const savepoint = `frizz_txn_${depth}`;
-          this.#depth = depth + 1;
-          try {
-            this.exec(depth === 0 ? `BEGIN ${mode}` : `SAVEPOINT ${savepoint}`);
-            let result;
-            try {
-              result = fn(...args2);
-            } catch (error) {
-              this.exec(depth === 0 ? "ROLLBACK" : `ROLLBACK TO ${savepoint}`);
-              if (depth > 0) this.exec(`RELEASE ${savepoint}`);
-              throw error;
-            }
-            this.exec(depth === 0 ? "COMMIT" : `RELEASE ${savepoint}`);
-            return result;
-          } finally {
-            this.#depth = depth;
-          }
-        };
-        const wrapper = runWith("IMMEDIATE");
-        wrapper.default = wrapper;
-        wrapper.deferred = runWith("DEFERRED");
-        wrapper.immediate = runWith("IMMEDIATE");
-        wrapper.exclusive = runWith("EXCLUSIVE");
-        return wrapper;
-      }
-      close() {
-        this.#db.close();
-      }
-    };
-  }
-});
-
-// packages/server/src/migrate-fray.ts
-import { execFileSync as execFileSync3 } from "node:child_process";
-import { existsSync as existsSync2, lstatSync, readdirSync as readdirSync2, realpathSync as realpathSync2, renameSync as renameSync4, rmdirSync } from "node:fs";
+// packages/server/src/project-root.ts
+import { createHash as createHash3, randomUUID as randomUUID4 } from "node:crypto";
+import { closeSync as closeSync3, existsSync as existsSync2, fsyncSync as fsyncSync3, mkdirSync as mkdirSync5, openSync as openSync4, readFileSync as readFileSync5, realpathSync as realpathSync2, renameSync as renameSync4, rmSync as rmSync5, writeFileSync as writeFileSync5 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join7, resolve as resolve2 } from "node:path";
-function xdg2(env, name) {
-  const value = env[name];
-  return value && (value.startsWith("/") || /^[A-Za-z]:[\\/]/u.test(value)) ? value : void 0;
+import { dirname as dirname5, join as join7, parse, resolve as resolve2 } from "node:path";
+function projectIdPath(root) {
+  return join7(root, FRIZZ_DIR, ID_FILE);
 }
-function movesFor(env, platform, home) {
-  const moves = [{ from: join7(home, ".fray"), to: join7(home, ".frizz") }];
-  if (platform === "win32") {
-    const local = env.LOCALAPPDATA || join7(env.USERPROFILE || home, "AppData", "Local");
-    moves.push({ from: join7(local, "Fray"), to: join7(local, "Frizz") });
-  } else if (platform === "darwin") {
-    const support = join7(home, "Library", "Application Support");
-    moves.push({ from: join7(support, "Fray"), to: join7(support, "Frizz") });
-    moves.push({ from: join7(home, "Library", "Caches", "Fray"), to: join7(home, "Library", "Caches", "Frizz") });
-  } else {
-    moves.push({ from: join7(home, ".local", "share", "fray"), to: join7(home, ".local", "share", "frizz") });
-    moves.push({ from: join7(home, ".local", "state", "fray"), to: join7(home, ".local", "state", "frizz") });
-    moves.push({ from: join7(home, ".cache", "fray"), to: join7(home, ".cache", "frizz") });
+function readProjectIdFile(root) {
+  let raw;
+  try {
+    raw = readFileSync5(projectIdPath(root), "utf8");
+  } catch {
+    return void 0;
   }
-  for (const name of ["XDG_DATA_HOME", "XDG_STATE_HOME", "XDG_CACHE_HOME"]) {
-    const base = xdg2(env, name);
-    if (base) moves.push({ from: join7(base, "fray"), to: join7(base, "frizz") });
+  try {
+    return validateProjectId(raw.trim());
+  } catch {
+    throw new Error(`${projectIdPath(root)} is invalid; expected exactly one UUID`);
   }
-  return moves;
 }
-function migrateFrayGlobalRoots(options2 = {}) {
-  const env = options2.env ?? process.env;
-  const platform = options2.platform ?? process.platform;
-  const home = options2.home ?? homedir5();
-  const exists = options2.exists ?? existsSync2;
-  const rename = options2.rename ?? renameSync4;
-  const merge = options2.merge ?? mergeInto;
-  const moved = [];
-  for (const move of movesFor(env, platform, home)) {
-    if (!exists(move.from)) continue;
+function writeProjectIdFile(root, id) {
+  const dir = join7(root, FRIZZ_DIR);
+  mkdirSync5(dir, { recursive: true });
+  const ignore = join7(dir, SELF_IGNORE);
+  if (!existsSync2(ignore)) {
     try {
-      if (exists(move.to)) {
-        if (merge(move.from, move.to)) moved.push(move);
-        continue;
-      }
-      rename(move.from, move.to);
-      moved.push(move);
+      writeFileSync5(ignore, "*\n", { flag: "wx" });
     } catch {
     }
   }
-  return moved;
-}
-function mergeInto(from, to) {
-  let moved = false;
-  for (const entry of readdirSync2(from, { withFileTypes: true })) {
-    const src = join7(from, entry.name);
-    const dst = join7(to, entry.name);
-    if (!existsSync2(dst)) {
-      renameSync4(src, dst);
-      moved = true;
-      continue;
+  const path = projectIdPath(root);
+  const temp = join7(dir, `.${ID_FILE}.${process.pid}.${randomUUID4()}.tmp`);
+  let fd;
+  try {
+    fd = openSync4(temp, "wx", 384);
+    writeFileSync5(fd, `${id}
+`, "utf8");
+    fsyncSync3(fd);
+    closeSync3(fd);
+    fd = void 0;
+    renameSync4(temp, path);
+  } catch (error) {
+    if (fd !== void 0) {
+      try {
+        closeSync3(fd);
+      } catch {
+      }
     }
-    if (entry.isDirectory() && lstatSync(dst).isDirectory() && mergeInto(src, dst)) moved = true;
+    try {
+      rmSync5(temp, { force: true });
+    } catch {
+    }
+    throw error;
   }
+  return id;
+}
+function projectRootLockName(root) {
+  return `identity-path-${createHash3("sha256").update(root).digest("hex")}.lock`;
+}
+function ensureProjectIdFile(root, home = homedir5(), seed) {
+  const existing = readProjectIdFile(root);
+  if (existing) return existing;
+  const release = acquireNamedLaunchLockSync(home, projectRootLockName(root));
   try {
-    rmdirSync(from);
-  } catch {
+    const raced = readProjectIdFile(root);
+    if (raced) return raced;
+    return writeProjectIdFile(root, seed ? validateProjectId(seed) : randomUUID4());
+  } finally {
+    release();
   }
-  return moved;
 }
-function migrateFrayProjectDir(projectDir) {
-  const from = join7(projectDir, ".fray");
-  const to = join7(projectDir, ".frizz");
-  try {
-    if (!lstatSync(from).isDirectory()) return false;
-    if (!existsSync2(to)) {
-      renameSync4(from, to);
-      return true;
+function isNotAGitWorktree(error) {
+  const code = error?.code;
+  if (code === "ENOENT" || code === "EACCES") return true;
+  if (!error || typeof error !== "object" || !("stderr" in error)) return false;
+  const stderr = String(error.stderr);
+  return /not a git repository/iu.test(stderr) || /must be run in a work ?tree/iu.test(stderr);
+}
+function hasAny(dir, names) {
+  return names.some((name) => existsSync2(join7(dir, name)));
+}
+function isHomeDirectory(dir, home = homedir5()) {
+  const canonical = (value) => {
+    try {
+      return realpathSync2(resolve2(value));
+    } catch {
+      return resolve2(value);
     }
-    return lstatSync(to).isDirectory() ? mergeInto(from, to) : false;
+  };
+  try {
+    return canonical(dir) === canonical(home);
   } catch {
     return false;
   }
 }
-function readId(dir, scope, key) {
-  let output;
+function existingProjectId(dir) {
+  const fromFile = readProjectIdFile(dir);
+  if (fromFile) return fromFile;
   try {
-    output = execFileSync3("git", ["config", ...scope, "--get-all", key], {
-      cwd: dir,
-      encoding: "utf8",
-      env: { ...process.env, LC_ALL: "C" },
-      stdio: ["ignore", "pipe", "ignore"]
-    });
+    return readGitProjectId(dir);
   } catch {
     return void 0;
   }
-  const values = output.replace(/\r?\n$/u, "").split(/\r?\n/u).filter((value) => value.length > 0);
-  if (values.length !== 1) return void 0;
-  const id = (values[0] ?? "").trim();
-  return PROJECT_ID_RE2.test(id) ? id : void 0;
 }
-function writeId(dir, scope, id) {
-  try {
-    execFileSync3("git", ["config", ...scope, "--replace-all", CURRENT_KEY, id], {
-      cwd: dir,
-      stdio: ["ignore", "ignore", "ignore"]
-    });
-  } catch {
-    return false;
-  }
-  return readId(dir, scope, CURRENT_KEY) === id;
+function isExistingProjectRoot(dir) {
+  return existingProjectId(dir) !== void 0;
+}
+function hasProjectMarker(dir) {
+  return hasAny(dir, REPO_MARKERS) || hasAny(dir, PROJECT_MARKERS);
 }
-function hasBoard(id, home) {
-  const db = join7(projectStateDir(id, home), "ui.db");
-  if (!existsSync2(db)) return false;
-  let sql;
+function discoverProjectRoot(cwd = process.cwd(), home = homedir5()) {
+  let dir;
   try {
-    sql = new Database(db, { readonly: true });
-    const row = sql.prepare("select count(*) as n from session").get();
-    return Number(row?.n ?? 0) > 0;
+    dir = resolve2(cwd);
   } catch {
-    return true;
-  } finally {
-    try {
-      sql?.close();
-    } catch {
-    }
-  }
-}
-function linkedWorktreeScopes(dir) {
-  const gitPath = (flag) => {
-    try {
-      const raw = execFileSync3("git", ["rev-parse", flag], {
-        cwd: dir,
-        encoding: "utf8",
-        env: { ...process.env, LC_ALL: "C" },
-        stdio: ["ignore", "pipe", "ignore"]
-      }).trim();
-      return realpathSync2(resolve2(dir, raw));
-    } catch {
-      return void 0;
-    }
-  };
-  const gitDir = gitPath("--git-dir");
-  const commonGitDir = gitPath("--git-common-dir");
-  if (!gitDir || !commonGitDir || gitDir === commonGitDir) return void 0;
-  return {
-    legacy: ["--file", join7(gitDir, "fray.config")],
-    current: ["--file", join7(gitDir, "frizz.config")]
-  };
-}
-function adopt(dir, legacy, current, home) {
-  const legacyId = readId(dir, legacy, LEGACY_KEY);
-  if (!legacyId) return void 0;
-  const currentId = readId(dir, current, CURRENT_KEY);
-  if (currentId === legacyId) return void 0;
-  if (currentId && hasBoard(currentId, home)) return void 0;
-  if (!writeId(dir, current, legacyId)) return void 0;
-  return currentId ? { id: legacyId, replaced: currentId } : { id: legacyId };
-}
-function migrateFrayProjectId(projectDir, { home } = {}) {
-  const adopted = [];
-  const repository = adopt(projectDir, ["--local"], ["--local"], home);
-  if (repository) adopted.push(repository);
-  const worktree = linkedWorktreeScopes(projectDir);
-  if (worktree) {
-    const own = adopt(projectDir, worktree.legacy, worktree.current, home);
-    if (own) adopted.push({ ...own, worktree: true });
-  }
-  return adopted;
-}
-var PROJECT_ID_RE2, LEGACY_KEY, CURRENT_KEY;
-var init_migrate_fray = __esm({
-  "packages/server/src/migrate-fray.ts"() {
+    return resolve2(cwd);
+  }
+  const stop = resolve2(home);
+  const filesystemRoot = parse(dir).root;
+  for (let at = dir; ; at = dirname5(at)) {
+    if (at === stop || at === filesystemRoot) break;
+    if (existsSync2(projectIdPath(at))) return at;
+    if (hasAny(at, REPO_MARKERS)) return at;
+    if (hasAny(at, PROJECT_MARKERS)) return at;
+    if (dirname5(at) === at) break;
+  }
+  return dir;
+}
+var FRIZZ_DIR, ID_FILE, SELF_IGNORE, REPO_MARKERS, PROJECT_MARKERS;
+var init_project_root = __esm({
+  "packages/server/src/project-root.ts"() {
     "use strict";
-    init_frizz_paths();
-    init_sqlite();
-    PROJECT_ID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
-    LEGACY_KEY = "fray.id";
-    CURRENT_KEY = "frizz.id";
+    init_project_identity();
+    FRIZZ_DIR = ".frizz";
+    ID_FILE = ".id";
+    SELF_IGNORE = ".gitignore";
+    REPO_MARKERS = [".git", ".jj", ".hg", ".svn"];
+    PROJECT_MARKERS = [
+      "package.json",
+      "pyproject.toml",
+      "go.mod",
+      "Cargo.toml",
+      "deno.json",
+      "deno.jsonc",
+      "composer.json",
+      "Gemfile",
+      "pom.xml",
+      "build.gradle",
+      "Makefile"
+    ];
   }
 });
 
@@ -5910,6 +5688,10 @@ var init_zod = __esm({
 });
 
 // packages/shared/src/thread-slug.ts
+function slugify(title) {
+  const s = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return s.slice(0, THREAD_SLUG_MAX_CHARS).replace(/-+$/g, "") || "thread";
+}
 var THREAD_SLUG_MAX_CHARS, ThreadSlug;
 var init_thread_slug = __esm({
   "packages/shared/src/thread-slug.ts"() {
@@ -6470,7 +6252,10 @@ var init_receipt_bus = __esm({
 });
 
 // packages/shared/src/index.ts
-var ATTACHMENT_IMAGE_EXTENSIONS, ATTACHMENT_DOC_EXTENSIONS, ATTACHMENT_EXTENSIONS, ATTACHMENT_MAX_BASE64_CHARS, ATTACHMENT_MAX_BYTES, ATTACHMENT_EXT_SET, ATTACHMENT_ACCEPT, FrizzStatus, BlockMechanism, RuntimeState, Backend, CodexModel, ThreadProfileOption, ThreadAgent, SubAgentView, BgShellView, CompletionHoldOp, CompletionHold, AskOption, AskQuestion, PendingAsk, NativeInputRequired, AwaitingHint, SnoozeUntil, SNOOZE_PROMPT_MAX, SnoozePrompt, RECURRING_PROMPT_MAX, RECURRING_MIN_INTERVAL_SECONDS, RECURRING_MAX_INTERVAL_SECONDS, RecurringPromptText, RecurringIntervalSeconds, ThreadRecurringPrompt, ALLDONE_SENTINEL, OPT_OUT_NOTE, TIMER_PROMPT_MAX, TIMER_MAX_DELAY_SECONDS, TimerPromptText, ThreadTimerView, ThreadFence, PlanView, LimitWindow, LimitPause, ThreadView, BoardErrorItem, BoardSnapshot, QuotaWindow, ProviderQuota, QuotaSnapshot, ProviderAuth, AccountEmails, AuthSnapshot, AccountLogoutInput, AccountLogoutResult, AccountLoginStartInput, AccountLoginStartResult, AccountLoginStatusInput, AccountLoginStatusResult, PermissionMode, LocalFileOpener, Settings, DispatchProviderPreferences, DispatchPreferences, DispatchProfileSnapshot, SetDispatchPreferenceInput, DispatchInput, ADOPT_THREAD_MESSAGE_MAX_CHARS, AdoptThreadInput, AdoptThreadResult, FollowUpInput, UnqueueFollowUpInput, UnqueueFollowUpResult, DeliverQueuedNowInput, DeliverQueuedNowResult, SetThreadSnoozeInput, SetThreadRecurringPromptInput, SetOwnThreadRecurringPromptInput, SetOwnThreadTimerInput, CancelOwnThreadTimerInput, ListOwnThreadTimersInput, OwnThreadTimersResult, SetOwnThreadTimerResult, CancelOwnThreadTimerResult, SetOwnThreadStopHookInput, SetOwnThreadHeartbeatInput, ThreadPluginReloadResult, ConfirmAwaitingInput, RenameThreadInput, AiRenameThreadInput, AiRenameThreadResult, SetThreadPermissionInput, SetThreadPermissionResult, ThreadProfileOptionsInput, ThreadProfileOptionsResult, SetThreadProfileInput, SetThreadProfileResult, DISPATCH_TASK_BANNER, DISPATCH_TASK_BANNER_MARKER, GithubWakeItem, GithubWakeSteer, WAKE_SCOPE, WAKE_REF, WAKE_SINGLE, WAKE_MULTI_HEAD, GithubStatus, GithubItem, GithubListInput, GithubListResult, GithubBatchInput, GithubBatchResult, BoardMeta, ServerEvent, TranscriptEdit, TranscriptTodo, TranscriptToolCall, TranscriptPart, TranscriptMessage, TranscriptPageCursor, TranscriptPage, TranscriptEarlierInput, SocketTranscriptSlug, SocketClientMsg, DEFAULT_PORT;
+function fallbackPort(base) {
+  return base + 1e4;
+}
+var ATTACHMENT_IMAGE_EXTENSIONS, ATTACHMENT_DOC_EXTENSIONS, ATTACHMENT_EXTENSIONS, ATTACHMENT_MAX_BASE64_CHARS, ATTACHMENT_MAX_BYTES, ATTACHMENT_EXT_SET, ATTACHMENT_ACCEPT, FrizzStatus, BlockMechanism, RuntimeState, Backend, CodexModel, ThreadProfileOption, ThreadAgent, SubAgentView, BgShellView, CompletionHoldOp, CompletionHold, AskOption, AskQuestion, PendingAsk, NativeInputRequired, AwaitingHint, SnoozeUntil, SNOOZE_PROMPT_MAX, SnoozePrompt, RECURRING_PROMPT_MAX, RECURRING_MIN_INTERVAL_SECONDS, RECURRING_MAX_INTERVAL_SECONDS, RecurringPromptText, RecurringIntervalSeconds, ThreadRecurringPrompt, TIMER_PROMPT_MAX, TIMER_MAX_DELAY_SECONDS, TimerPromptText, SIGNOFF_NUDGE_MARKER, SIGNOFF_NUDGE_MESSAGE, ThreadWatchKind, RegisterableThreadWatchKind, ThreadWatchTarget, ThreadWatchView, ThreadTimerView, ThreadFence, PlanView, LimitWindow, LimitPause, ThreadView, BoardErrorItem, BoardSnapshot, QuotaWindow, ProviderQuota, QuotaSnapshot, ProviderAuth, AccountEmails, AuthSnapshot, AccountLogoutInput, AccountLogoutResult, AccountLoginStartInput, AccountLoginStartResult, AccountLoginStatusInput, AccountLoginStatusResult, PermissionMode, LocalFileOpener, Settings, DispatchProviderPreferences, DispatchPreferences, DispatchProfileSnapshot, SetDispatchPreferenceInput, DispatchInput, ADOPT_THREAD_MESSAGE_MAX_CHARS, AdoptThreadInput, AdoptThreadResult, FollowUpInput, UnqueueFollowUpInput, UnqueueFollowUpResult, DeliverQueuedNowInput, DeliverQueuedNowResult, SetThreadSnoozeInput, SetThreadRecurringPromptInput, SetOwnThreadRecurringPromptInput, SetOwnThreadRecurringPromptResult, GetOwnThreadRecurringPromptInput, OwnThreadRecurringPromptResult, SetOwnThreadTimerInput, CancelOwnThreadTimerInput, ListOwnThreadTimersInput, OwnThreadTimersResult, SetOwnThreadTimerResult, CancelOwnThreadTimerResult, AddOwnThreadWatchInput, PromoteOwnThreadWatchInput, PromoteOwnThreadWatchResult, DropOwnThreadWatchInput, ListOwnThreadWatchesInput, OwnThreadWatchesResult, AddOwnThreadWatchResult, DropOwnThreadWatchResult, SetOwnThreadStopHookInput, SetOwnThreadHeartbeatInput, ThreadPluginReloadResult, ConfirmAwaitingInput, RenameThreadInput, AiRenameThreadInput, AiRenameThreadResult, SetThreadPermissionInput, SetThreadPermissionResult, ThreadProfileOptionsInput, ThreadProfileOptionsResult, SetThreadProfileInput, SetThreadProfileResult, DISPATCH_TASK_BANNER, DISPATCH_TASK_BANNER_MARKER, GithubWakeItem, GithubWakeSteer, WAKE_SCOPE, WAKE_REF, WAKE_SINGLE, WAKE_MULTI_HEAD, GithubStatus, GithubItem, GithubListInput, GithubListResult, GithubBatchInput, GithubBatchResult, BoardMeta, ServerEvent, TranscriptEdit, TranscriptTodo, TranscriptToolCall, TranscriptPart, TranscriptMessage, TranscriptPageCursor, TranscriptPage, TranscriptEarlierInput, SocketTranscriptSlug, SocketClientMsg, ProjectCard, PROJECT_ICON_MAX_BASE64_CHARS, DirectoryPickResult, ThreadLocation, FRIZZ_ROUTE_PREFIX, DEFAULT_PORT;
 var init_src = __esm({
   "packages/shared/src/index.ts"() {
     "use strict";
@@ -6738,21 +6523,57 @@ var init_src = __esm({
     RecurringIntervalSeconds = external_exports.number().int().min(RECURRING_MIN_INTERVAL_SECONDS).max(RECURRING_MAX_INTERVAL_SECONDS);
     ThreadRecurringPrompt = external_exports.object({
       prompt: external_exports.string(),
-      /** The two mechanisms, named as the panel labels them. `stopHook` fires at every rest; `heartbeat`
-       *  fires on `intervalSeconds` and reaches the agent mid-turn. */
+      /** The three mechanisms, named as the panel labels them. `stopHook` fires at every rest; `heartbeat`
+       *  fires on `intervalSeconds`; `postCompaction` fires whenever the harness summarizes the thread's
+       *  context away. The latter two both reach the agent mid-turn. */
       stopHook: external_exports.boolean(),
       heartbeat: external_exports.boolean(),
+      postCompaction: external_exports.boolean(),
+      /** NOT a fourth trigger — a HOLD over all three. While it is on, nothing is sent for as long as the
+       *  thread is blocked on the human: an unanswered ```question fence, a native ask, or a permission
+       *  prompt. The footer panel seeds it ON for a fresh arming, with the stop hook, because they are one
+       *  intent — see scheduler.ts, "WHAT A PENDING QUESTION DOES TO ALL THREE TRIGGERS". The stored column
+       *  still defaults OFF, so an existing row and an older caller both keep the behaviour they had. */
+      pauseOnQuestions: external_exports.boolean(),
       intervalSeconds: external_exports.number().int().positive().optional(),
       armedAt: external_exports.string(),
-      /** Last delivery of the ON REST trigger; the two are stamped separately so each reads its own clock. */
+      /** Last delivery per trigger; stamped separately so each reads its own clock. */
       lastRestFiredAt: external_exports.string().optional(),
-      lastScheduleFiredAt: external_exports.string().optional()
+      lastScheduleFiredAt: external_exports.string().optional(),
+      lastCompactFiredAt: external_exports.string().optional()
     }).strict();
-    ALLDONE_SENTINEL = "ALLDONE";
-    OPT_OUT_NOTE = `If there is genuinely no further work, reply ${ALLDONE_SENTINEL} on its own line to stop these prompts \u2014 but be sure, because it permanently stalls this run.`;
     TIMER_PROMPT_MAX = SNOOZE_PROMPT_MAX;
     TIMER_MAX_DELAY_SECONDS = 30 * 24 * 60 * 60;
     TimerPromptText = external_exports.string().trim().min(1).max(TIMER_PROMPT_MAX);
+    SIGNOFF_NUDGE_MARKER = "**This message is from frizz, not from the human.**";
+    SIGNOFF_NUDGE_MESSAGE = [
+      `${SIGNOFF_NUDGE_MARKER} Nothing about your task has changed, and this is not a request to do more work.`,
+      "",
+      "You rested without a fence, so this thread cannot be triaged. Add one at the END of your next message:",
+      "",
+      "- `` ```question `` \u2014 you need the human. One question per fence, lettered options, one recommended.",
+      "- `` ```done `` \u2014 genuinely FINISHED. A DISMISSAL: the card is filed away and nobody looks again, so",
+      "  if anything is still owed, it is not done. Body: 1-3 sentences, then bullets, each opening with a",
+      "  **bolded verb phrase**.",
+      "- Blocked on a PR, CI, or your own background shell? Register it with `mcp__frizz__watch` and rest.",
+      "",
+      "**DO NOT REPEAT YOURSELF.** If the message you just wrote already stands on its own, reply with the",
+      "fence ALONE \u2014 the human reads both together, so restating it costs them the second read for nothing.",
+      "",
+      "Only if it does NOT stand alone, fix that first, briefly. It has to be readable cold: the human has",
+      "seen nothing since their own last message \u2014 the Goal, this reminder, a watcher wake all came from",
+      "frizz \u2014 so anything you assumed they had followed, they have not."
+    ].join("\n");
+    ThreadWatchKind = external_exports.enum(["shell", "github"]);
+    RegisterableThreadWatchKind = external_exports.enum(["shell"]);
+    ThreadWatchTarget = external_exports.string().trim().min(1).max(200);
+    ThreadWatchView = external_exports.object({
+      id: external_exports.string(),
+      kind: ThreadWatchKind,
+      target: external_exports.string(),
+      state: external_exports.enum(["armed", "fired", "dropped"]),
+      createdAt: external_exports.string()
+    }).strict();
     ThreadTimerView = external_exports.object({
       id: external_exports.string(),
       prompt: external_exports.string(),
@@ -6857,6 +6678,14 @@ var init_src = __esm({
       // Live background SHELLS the worker launched (tailer-derived). Same default-[] discipline. Rendered
       // in the anchored background-ops strip alongside sub-agents; ids make current rows drillable.
       bgShells: external_exports.array(BgShellView).default([]),
+      // The thread's ARMED WATCHERS — registry-derived, not folded from the transcript, which is what makes
+      // them survive the worker saying one more sentence. Same default-[] discipline as the two above.
+      //
+      // These NEVER park the thread: a row with an armed watcher stays a visible queue handoff, and Snooze
+      // remains the only way to hide one (maintainer 2026-08-12, choosing this over auto-Held for every
+      // kind). So this field is for the operator to SEE what a thread is waiting on — it deliberately feeds
+      // no queue-membership rule.
+      watches: external_exports.array(ThreadWatchView).default([]),
       // A pending native AskUserQuestion the session is frozen on (tailer-derived). Optional — absent
       // when there's no unanswered ask. Feeds needsAction + the read-only question render + "Answer in Terminal".
       pendingAsk: PendingAsk.optional(),
@@ -6943,9 +6772,6 @@ var init_src = __esm({
       // ISO8601 read/seen telemetry (threadSeen RPC — recorded when the human opens the thread). Kept for
       // compatibility and analytics only; viewing never acknowledges or removes a queue handoff.
       seenAt: external_exports.string().optional(),
-      // Project-relative scratchpad path (.frizz/threads/<session-id>/scratch.md) once provisioned — the worker's
-      // compaction-proof working memory, rendered as the thread's doc tab.
-      scratchpadPath: external_exports.string().optional(),
       // Project-relative plan artifact this thread was dispatched from (.frizz/plans/*.md), if any.
       planPath: external_exports.string().optional(),
       // Which agent backend runs this thread (Codex-support epic, Phase 3) — drives the subtle per-row
@@ -6962,13 +6788,13 @@ var init_src = __esm({
       // Raw durable barrier bit. Unlike permissionPending this remains true for a future/corrupt value,
       // so rolling clients fail closed instead of enabling another composer while ownership is unknown.
       permissionChangePending: external_exports.boolean().optional(),
-      // The last decision the worker's permission POLICY made for this thread (cc-worker/hooks/
-      // perm-policy.mjs), and how many times it has DENIED. A policy decision never blocks anyone, so it
-      // has no other way of being noticed — an allow is not written to the transcript at all. Surfacing it
-      // is what keeps "frizz silently approved something on your behalf" from being invisible.
-      // Deferred requests are deliberately absent: those already show as a permission prompt / Needs you.
+      // The last DENIAL the worker's permission POLICY made for this thread (cc-worker/hooks/
+      // perm-policy.mjs), and how many times it has denied. A refusal changes what the worker can do, so
+      // it earns a card. Approvals and deferrals are deliberately absent: a deferral already shows as a
+      // permission prompt / Needs you, and an approval blocks nobody — the quiet line that used to report
+      // one stuck to the bottom of the thread forever, describing a command the reader had long moved past.
       permPolicy: external_exports.object({
-        decision: external_exports.enum(["allow", "deny"]),
+        decision: external_exports.literal("deny"),
         rule: external_exports.string(),
         reason: external_exports.string(),
         tool: external_exports.string().nullable(),
@@ -7010,6 +6836,18 @@ var init_src = __esm({
       projectName: external_exports.string(),
       projectLabel: external_exports.string(),
       // "owner/repo" from the git origin remote; falls back to projectName
+      // "owner/repo" ONLY when that origin remote is github.com — the link target the rendered-markdown
+      // autolinker turns `#123` and a bare commit hash into. Deliberately NOT projectLabel, which is a
+      // host-agnostic DISPLAY name: a GitLab origin yields an owner/repo there too, and pointing its `#12`
+      // at github.com would be a wrong destination rather than a missing one. Absent means the
+      // augmentation stays off (no remote, another forge, or a pre-restart server).
+      githubRepo: external_exports.string().optional(),
+      // This project's URL slug — the `<slug>` in `/project/<slug>`. The client cannot derive it: a
+      // PREFIXED page reads it off its own path, but the LAUNCHING project is served unprefixed and so has
+      // nothing to read, which left `/` — the all-projects GRID — as the only URL its queue could name.
+      // Optional so a pre-restart server keeps working; absent means "fall back to `/`", i.e. the old
+      // behaviour. Registry-derived, so it is the same slug every other surface links to.
+      projectSlug: external_exports.string().optional(),
       // (No `.frizz/ exists` bit here on purpose. Threads are session-first — the ui.db registry IS the
       // board — so `.frizz/` presence says nothing about whether this project has one. Its only consumer
       // was a shell gate that dead-ended `.frizz`-less repos; the server still probes the directory
@@ -7098,6 +6936,17 @@ var init_src = __esm({
       // presents it; resolveClaudeEffort (server/backend/claude-effort.ts) translates it at the spawn edge.
       effort: external_exports.enum(["low", "medium", "high", "xhigh", "max", "ultra", "ultracode"]).optional(),
       notifications: external_exports.boolean(),
+      /**
+       * The permanent column of project icons. OFF by default, on purpose.
+       *
+       * A rail of every project on the machine is a standing invitation to leave the thread you are in —
+       * "just too tempting" (maintainer 2026-08-06). Frizz's home is one board; the grid is a page you go
+       * to, not furniture you sit beside. Hidden, the way back is a breadcrumb in the status bar, which
+       * costs a click exactly when you meant to switch and nothing when you did not.
+       *
+       * Machine-level, like the font: which chrome you want is a property of the person, not the repo.
+       */
+      projectRail: external_exports.boolean(),
       // UI type family. `mono` (default) is the mono-forward system; `sans` swaps prose/UI chrome to a
       // sans stack while code / tool lines / the terminal stay mono. Optional so an old settings blob
       // parses; defaultSettings pins "mono".
@@ -7236,6 +7085,13 @@ var init_src = __esm({
       prompt: RecurringPromptText.nullable(),
       stopHook: external_exports.boolean(),
       heartbeat: external_exports.boolean(),
+      // The POST-COMPACTION trigger (scheduler SOURCE 7, added 2026-08-06). Defaulted rather than required
+      // so a client that predates it — an older tab, an older MCP server — keeps writing the row correctly
+      // with the trigger off, which is the honest reading of a caller that has never heard of it.
+      postCompaction: external_exports.boolean().default(false),
+      // The QUESTION HOLD (2026-08-11). Defaulted for the same reason as the trigger above: a caller that
+      // has never heard of it means "don't hold", which is also this option's own default.
+      pauseOnQuestions: external_exports.boolean().default(false),
       intervalSeconds: RecurringIntervalSeconds.optional()
     }).strict();
     SetOwnThreadRecurringPromptInput = external_exports.object({
@@ -7243,8 +7099,23 @@ var init_src = __esm({
       prompt: RecurringPromptText.nullable(),
       stopHook: external_exports.boolean(),
       heartbeat: external_exports.boolean(),
+      // The POST-COMPACTION trigger (scheduler SOURCE 7, added 2026-08-06). Defaulted rather than required
+      // so a client that predates it — an older tab, an older MCP server — keeps writing the row correctly
+      // with the trigger off, which is the honest reading of a caller that has never heard of it.
+      postCompaction: external_exports.boolean().default(false),
+      // The QUESTION HOLD (2026-08-11), defaulted exactly as the trigger above and for the same reason.
+      pauseOnQuestions: external_exports.boolean().default(false),
       intervalSeconds: RecurringIntervalSeconds.optional()
     }).strict();
+    SetOwnThreadRecurringPromptResult = external_exports.object({
+      replaced: ThreadRecurringPrompt.nullable()
+    }).strict();
+    GetOwnThreadRecurringPromptInput = external_exports.object({
+      slug: ThreadSlug
+    }).strict();
+    OwnThreadRecurringPromptResult = external_exports.object({
+      recurringPrompt: ThreadRecurringPrompt.nullable()
+    }).strict();
     SetOwnThreadTimerInput = external_exports.object({
       slug: ThreadSlug,
       prompt: TimerPromptText,
@@ -7269,6 +7140,49 @@ var init_src = __esm({
       cancelled: external_exports.boolean(),
       timers: external_exports.array(ThreadTimerView)
     }).strict();
+    AddOwnThreadWatchInput = external_exports.object({
+      slug: ThreadSlug,
+      // REGISTERABLE kinds only, which is `shell` and nothing else — deliberately narrower than
+      // `ThreadWatchKind`, whose `github` member is a board-derived VIEW row with no registration behind it.
+      // The MCP tool already refuses a PR here in words ("a pr wait does not belong here — use an ```awaiting
+      // fence"); this is the same refusal at the wire, where it cannot be talked past.
+      kind: RegisterableThreadWatchKind,
+      target: ThreadWatchTarget,
+      /** The worker is BLOCKING on this one inside its tool call, so the scheduler settles it silently
+       *  instead of delivering a wake — see the column comment in storage.ts. Defaulted, so a caller that
+       *  has never heard of it registers an ordinary background watch. */
+      foreground: external_exports.boolean().default(false)
+    }).strict();
+    PromoteOwnThreadWatchInput = external_exports.object({
+      slug: ThreadSlug,
+      id: external_exports.string().min(1).max(64)
+    }).strict();
+    PromoteOwnThreadWatchResult = external_exports.object({
+      promoted: external_exports.boolean(),
+      watches: external_exports.array(ThreadWatchView)
+    }).strict();
+    DropOwnThreadWatchInput = external_exports.object({
+      slug: ThreadSlug,
+      id: external_exports.string().min(1).max(64)
+    }).strict();
+    ListOwnThreadWatchesInput = external_exports.object({
+      slug: ThreadSlug
+    }).strict();
+    OwnThreadWatchesResult = external_exports.object({
+      watches: external_exports.array(ThreadWatchView)
+    }).strict();
+    AddOwnThreadWatchResult = external_exports.object({
+      id: external_exports.string(),
+      /** True when this exact (kind, target) was ALREADY armed on the thread, so the call registered
+       *  nothing new. A worker re-registering after a compaction is the common case, and silently minting a
+       *  duplicate would mean two wakes for one event. */
+      alreadyArmed: external_exports.boolean(),
+      watches: external_exports.array(ThreadWatchView)
+    }).strict();
+    DropOwnThreadWatchResult = external_exports.object({
+      dropped: external_exports.boolean(),
+      watches: external_exports.array(ThreadWatchView)
+    }).strict();
     SetOwnThreadStopHookInput = external_exports.object({
       slug: ThreadSlug,
       prompt: RecurringPromptText.nullable(),
@@ -7309,6 +7223,11 @@ var init_src = __esm({
       // attempted a write after the flip to danger-full-access was still refused). So the change is real and
       // durable, yet it does not reach work already executing. Distinct from "next-resume", which means
       // nothing was applied to the live session at all.
+      //
+      // It is ALSO the Claude answer, arrived at from the opposite direction: a permission mode is a LAUNCH
+      // flag there, so frizz retires the idle worker process and the next turn cold-resumes under the new
+      // one (router `setThreadPermission`). Same promise to the operator — stored, and true from the next
+      // turn on — reached by restarting rather than by retuning.
       effect: external_exports.enum(["applied", "next-turn", "next-resume"])
     });
     ThreadProfileOptionsInput = external_exports.object({ slug: ThreadSlug }).strict();
@@ -7728,7 +7647,25 @@ ${DISPATCH_TASK_BANNER}
       // there and stores the DISPATCH id here. Additive + optional: absent when the ack was never seen (a
       // resumed session whose dispatch scrolled out), and the line then renders as plain text, not a dead link.
       peerFrom: external_exports.string().optional(),
-      peerDispatchId: external_exports.string().optional()
+      peerDispatchId: external_exports.string().optional(),
+      // …and the tell that `peerFrom` is ONLY that subagent_type — that the parser could not resolve the
+      // dispatch's own description for this sender. It matters because a profile cell is not a name: every
+      // child dispatched at `frizz:opus-high` reports under the identical string, so a divider reading
+      // «frizz:opus-high» names the MODEL, not the work, and two siblings are indistinguishable
+      // (maintainer 2026-08-06: "I'm also still occasionally seeing things like 'Agent <OPUS:HIGH>
+      // rested'"). The client renders an unnamed sender as "Sub-agent reported" and keeps the cell in the
+      // tooltip, rather than promoting a profile to a title.
+      //
+      // Resolution is genuinely late-arriving, not merely missing: the description comes from the DISPATCH
+      // record, so a report rendered while the window has not yet reached that record is unnamed and gains
+      // its title once it has. Set only on the Claude path — a codex peer names a real task.
+      peerUnnamed: external_exports.literal(true).optional(),
+      // The sender's own RUNTIME agent id (`origin.senderTaskId`) — kept so a LATER pass can finish the job
+      // the fold could not. The paged transcript RPC folds a bounded window, so a report whose dispatch
+      // scrolled above the page start has no description available at fold time; the tailer still holds the
+      // pairing, and `projectTranscriptPeerNames` uses this id to ask it. Never a drawer key on its own —
+      // that is `peerDispatchId`, which the same pass can also supply once this resolves.
+      peerSenderTaskId: external_exports.string().optional()
     });
     TranscriptPageCursor = external_exports.string().min(1).max(2048).regex(/^[A-Za-z0-9_-]+$/);
     TranscriptPage = external_exports.object({
@@ -7747,12 +7684,240 @@ ${DISPATCH_TASK_BANNER}
       external_exports.object({ t: external_exports.literal("sub"), topic: external_exports.literal("transcript"), slug: SocketTranscriptSlug }).strict(),
       external_exports.object({ t: external_exports.literal("unsub"), topic: external_exports.literal("transcript"), slug: SocketTranscriptSlug }).strict()
     ]);
-    DEFAULT_PORT = 4917;
+    ProjectCard = external_exports.object({
+      id: external_exports.string(),
+      slug: external_exports.string(),
+      name: external_exports.string(),
+      path: external_exports.string(),
+      lastOpenedAt: external_exports.string(),
+      /** The directory is gone — moved or deleted. The card stays so it can be reopened or forgotten. */
+      stale: external_exports.boolean(),
+      /**
+       * When this project's icon was last established, or absent if it never has been.
+       *
+       * Carried purely so the client can hang it off the `/_frizz/project-icon` URL: the icon bytes are
+       * cached hard (a rail of forty squares is forty requests, and none of them should recur), which
+       * means a newly uploaded icon would otherwise stay invisible behind the cached old one. A changed
+       * version is a changed URL, so the swap is immediate without weakening the caching for everyone.
+       *
+       * Deliberately NOT "does this project have an icon". Answering that for a project nobody has
+       * scanned yet would mean scanning it, and this list is one file read on purpose.
+       */
+      iconVersion: external_exports.string().optional(),
+      /**
+       * Whether this project HAS an icon — and crucially, whether we have even looked.
+       *
+       * Three states, not a boolean, because the two "no icon to draw right now" cases must behave
+       * differently and a boolean collapses them:
+       *   · `icon`    — one is stored; draw it.
+       *   · `none`    — scanned, nothing found. Draw the monogram and DO NOT request the icon route,
+       *                 which is what stops an iconless project flashing its initials and then swapping.
+       *   · `unknown` — never scanned. The monogram shows, but the request MUST still go out, because
+       *                 that request is what triggers the (lazy, cached) scan in the first place.
+       *
+       * Collapsing `unknown` into `none` deadlocks the whole feature: no image element is rendered, so
+       * the icon route is never called, so the scan never runs, so the project stays `unknown` forever.
+       * Measured 2026-08-06 — a rail of 29 projects had scanned exactly ONE, and only because a probe
+       * had fetched that one's URL by hand.
+       */
+      iconStatus: external_exports.enum(["icon", "none", "unknown"]),
+      /** An operator's uploaded icon, rather than one the scan found. Drives what the menu offers. */
+      iconIsCustom: external_exports.boolean().optional()
+    });
+    PROJECT_ICON_MAX_BASE64_CHARS = 4 * 1024 * 1024;
+    DirectoryPickResult = external_exports.discriminatedUnion("kind", [
+      external_exports.object({ kind: external_exports.literal("picked"), project: ProjectCard }),
+      external_exports.object({ kind: external_exports.literal("cancelled") }),
+      external_exports.object({ kind: external_exports.literal("unavailable"), reason: external_exports.string() })
+    ]);
+    ThreadLocation = external_exports.object({ projectSlug: external_exports.string(), projectName: external_exports.string() });
+    FRIZZ_ROUTE_PREFIX = "/_frizz";
+    DEFAULT_PORT = 9393;
+  }
+});
+
+// packages/server/src/project-registry.ts
+import { closeSync as closeSync4, existsSync as existsSync3, fsyncSync as fsyncSync4, mkdirSync as mkdirSync6, openSync as openSync5, readFileSync as readFileSync6, readdirSync as readdirSync2, realpathSync as realpathSync3, renameSync as renameSync5, rmSync as rmSync6, writeFileSync as writeFileSync6 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { basename as basename4, dirname as dirname6, join as join8 } from "node:path";
+function registryPath(home = homedir6()) {
+  return join8(frizzPaths({ home }).data, "registry.json");
+}
+function readRegistry(home = homedir6()) {
+  let raw;
+  try {
+    raw = readFileSync6(registryPath(home), "utf8");
+  } catch {
+    return { ...EMPTY, projects: [] };
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed?.version !== 1 || !Array.isArray(parsed.projects)) return { ...EMPTY, projects: [] };
+    return {
+      version: 1,
+      projects: parsed.projects.filter(
+        (p) => p && typeof p.id === "string" && typeof p.path === "string" && typeof p.slug === "string"
+      )
+    };
+  } catch {
+    return { ...EMPTY, projects: [] };
+  }
+}
+function writeRegistry(registry, home = homedir6()) {
+  const path = registryPath(home);
+  mkdirSync6(dirname6(path), { recursive: true });
+  const temp = `${path}.${process.pid}.tmp`;
+  let fd;
+  try {
+    fd = openSync5(temp, "w", 384);
+    writeFileSync6(fd, `${JSON.stringify(registry, null, 2)}
+`, "utf8");
+    fsyncSync4(fd);
+    closeSync4(fd);
+    fd = void 0;
+    renameSync5(temp, path);
+  } catch (error) {
+    if (fd !== void 0) {
+      try {
+        closeSync4(fd);
+      } catch {
+      }
+    }
+    try {
+      rmSync6(temp, { force: true });
+    } catch {
+    }
+    throw error;
+  }
+}
+function slugifyProject(value) {
+  const s = slugify(value);
+  return s === "thread" ? "project" : s;
+}
+function deriveSlug(dir, taken, options2 = {}) {
+  const base = slugifyProject(basename4(dir));
+  const parent = slugifyProject(basename4(dirname6(dir)));
+  const qualified = GENERIC.has(base) && parent ? `${parent}-${base}` : base;
+  const candidates = [
+    qualified,
+    ...options2.remoteOwner ? [`${slugifyProject(options2.remoteOwner)}-${base}`] : [],
+    ...parent && parent !== qualified ? [`${parent}-${base}`] : []
+  ];
+  for (const candidate of candidates) {
+    if (candidate && !taken.has(candidate) && !RESERVED.has(candidate)) return candidate;
+  }
+  const root = candidates[0] || "project";
+  for (let n = 2; ; n++) {
+    const candidate = `${root}-${n}`;
+    if (!taken.has(candidate) && !RESERVED.has(candidate)) return candidate;
+  }
+}
+function canonicalPath(dir) {
+  try {
+    return realpathSync3(dir);
+  } catch {
+    return dir;
+  }
+}
+function registerProject(input, home = homedir6()) {
+  input = { ...input, dir: canonicalPath(input.dir) };
+  const registry = readRegistry(home);
+  const at = (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+  const byId = registry.projects.find((p) => p.id === input.id);
+  if (byId) {
+    if (byId.path === input.dir) {
+      byId.lastOpenedAt = at;
+      writeRegistry(registry, home);
+      return { entry: byId, action: "reopened" };
+    }
+    if (existsSync3(join8(byId.path, ".frizz", ".id"))) return { action: "duplicate" };
+    byId.path = input.dir;
+    byId.lastOpenedAt = at;
+    writeRegistry(registry, home);
+    return { entry: byId, action: "moved" };
+  }
+  const byPath = registry.projects.find((p) => p.path === input.dir);
+  if (byPath) {
+    byPath.id = input.id;
+    byPath.lastOpenedAt = at;
+    writeRegistry(registry, home);
+    return { entry: byPath, action: "rekeyed" };
+  }
+  const taken = new Set(registry.projects.map((p) => p.slug));
+  const entry = {
+    id: input.id,
+    path: input.dir,
+    slug: deriveSlug(input.dir, taken, { remoteOwner: input.remoteOwner }),
+    lastOpenedAt: at
+  };
+  registry.projects.push(entry);
+  writeRegistry(registry, home);
+  return { entry, action: "created" };
+}
+function listProjects(home = homedir6()) {
+  const byRecency = (a, b) => a.lastOpenedAt < b.lastOpenedAt ? 1 : a.lastOpenedAt > b.lastOpenedAt ? -1 : 0;
+  return readRegistry(home).projects.map((p) => ({ ...p, stale: !existsSync3(p.path) })).sort((a, b) => {
+    if (a.order === void 0 && b.order === void 0) return byRecency(a, b);
+    if (a.order === void 0) return 1;
+    if (b.order === void 0) return -1;
+    return a.order - b.order;
+  });
+}
+function findByPath(path, home = homedir6()) {
+  const canonical = canonicalPath(path);
+  return readRegistry(home).projects.find((p) => p.path === canonical || p.path === path);
+}
+var EMPTY, GENERIC, RESERVED;
+var init_project_registry = __esm({
+  "packages/server/src/project-registry.ts"() {
+    "use strict";
+    init_src();
+    init_frizz_paths();
+    init_project_root();
+    EMPTY = { version: 1, projects: [] };
+    GENERIC = /* @__PURE__ */ new Set([
+      "app",
+      "src",
+      "web",
+      "www",
+      "main",
+      "repo",
+      "code",
+      "server",
+      "client",
+      "packages",
+      "site",
+      "scratch",
+      "tmp",
+      "test"
+    ]);
+    RESERVED = /* @__PURE__ */ new Set([
+      "_frizz",
+      "rpc",
+      "events",
+      "ws",
+      "term",
+      "attach",
+      "local-image",
+      "local-visualization",
+      // `control` answers `/control/stop` and `/control/status` — the supervisor channel the board polls
+      // every few seconds. It was missing from this list, so a directory called `control` could have taken
+      // the segment and routed the whole machine's supervisor polling into one project's app, which has no
+      // such route. Only newly minted slugs consult this, so adding it strands nothing already registered.
+      "control",
+      "project-icon",
+      "assets",
+      "favicon",
+      "manifest",
+      "index",
+      "api",
+      "health"
+    ]);
   }
 });
 
 // packages/server/src/local-image.ts
-import { readFileSync as readFileSync6, realpathSync as realpathSync4, statSync as statSync4 } from "node:fs";
+import { readFileSync as readFileSync8, realpathSync as realpathSync5, statSync as statSync4 } from "node:fs";
 import { extname, isAbsolute as isAbsolute2 } from "node:path";
 function resolveLocalImage(rawPath) {
   if (!rawPath || !isAbsolute2(rawPath)) return { status: 400 };
@@ -7760,13 +7925,13 @@ function resolveLocalImage(rawPath) {
   if (!contentType) return { status: 400 };
   let real;
   try {
-    real = realpathSync4(rawPath);
+    real = realpathSync5(rawPath);
   } catch {
     return { status: 404 };
   }
   try {
     if (!statSync4(real).isFile()) return { status: 404 };
-    return { status: 200, contentType, body: readFileSync6(real) };
+    return { status: 200, contentType, body: readFileSync8(real) };
   } catch {
     return { status: 404 };
   }
@@ -7786,10 +7951,10 @@ var init_local_image = __esm({
 });
 
 // src/production.ts
-import { readFileSync as readFileSync8 } from "node:fs";
-import { homedir as homedir7 } from "node:os";
+import { readFileSync as readFileSync10 } from "node:fs";
+import { homedir as homedir8 } from "node:os";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // src/browser.ts
 import { spawn, execFile } from "node:child_process";
@@ -8536,14 +8701,15 @@ init_project_launch();
 init_local_origin();
 init_boot_progress();
 init_frizz_paths();
-init_migrate_fray();
+init_project_root();
 init_logging();
 init_src();
-import { execFileSync as execFileSync4 } from "node:child_process";
+init_project_registry();
+import { execFileSync as execFileSync3 } from "node:child_process";
 import { createServer } from "node:net";
-import { mkdirSync as mkdirSync5, readFileSync as readFileSync5, realpathSync as realpathSync3, writeFileSync as writeFileSync5 } from "node:fs";
-import { homedir as homedir6, networkInterfaces } from "node:os";
-import { basename as basename4, join as join8, resolve as resolve3 } from "node:path";
+import { mkdirSync as mkdirSync7, readFileSync as readFileSync7, realpathSync as realpathSync4, writeFileSync as writeFileSync7 } from "node:fs";
+import { homedir as homedir7, networkInterfaces } from "node:os";
+import { basename as basename5, join as join9, resolve as resolve3 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 var PORT_SCAN_COUNT = 100;
 var LAUNCH_TIMEOUT_MS = 3e4;
@@ -8690,6 +8856,9 @@ function resolveBindSelection(options2, env = process.env) {
   const publicOrigin = publicOriginRaw ? normalizePublicOrigin(publicOriginRaw) : void 0;
   return { host, exposed: bindHostIsExposed(host), allowedHosts, ...publicOrigin ? { publicOrigin } : {} };
 }
+function boardAddress(url) {
+  return url.includes("?") || url.endsWith("/") ? url : `${url}/`;
+}
 function networkUrls(port, host, interfaces = networkInterfaces) {
   if (!bindHostIsExposed(host)) return [];
   const wildcard = host === ALL_INTERFACES_BIND_HOST || host === "::";
@@ -8711,40 +8880,58 @@ function networkUrls(port, host, interfaces = networkInterfaces) {
   }
   return urls;
 }
-function resolveWorkspace(cwd = process.cwd(), home = homedir6(), env = process.env, { migrate = false } = {}) {
+function resolveLaunchIntent(cwd = process.cwd(), home = homedir7(), env = process.env) {
+  const candidate = realpathSync4(discoverProjectRoot(cwd, home));
+  const known = isExistingProjectRoot(candidate) || findByPath(candidate, home) !== void 0;
+  if ((known || hasProjectMarker(candidate)) && !isHomeDirectory(candidate, home))
+    return { kind: "open", workspace: resolveWorkspace(cwd, home, env) };
+  const host = mostRecentProject(home, env);
+  const reason = isHomeDirectory(candidate, home) ? "home" : "unadopted";
+  if (!host) return { kind: "empty", directory: candidate, reason };
+  return reason === "home" ? { kind: "grid", workspace: host } : { kind: "offer", workspace: host, directory: candidate };
+}
+function mostRecentProject(home, env) {
+  for (const entry of listProjects(home)) {
+    if (entry.stale || isHomeDirectory(entry.path, home)) continue;
+    try {
+      return resolveWorkspace(entry.path, home, env);
+    } catch {
+    }
+  }
+  return void 0;
+}
+function resolveWorkspace(cwd = process.cwd(), home = homedir7(), env = process.env) {
   let gitRoot;
   try {
-    gitRoot = execFileSync4("git", ["rev-parse", "--show-toplevel"], {
+    gitRoot = execFileSync3("git", ["rev-parse", "--show-toplevel"], {
       cwd,
       encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
+      // stderr is CAPTURED, not ignored: it is the only thing that distinguishes "no worktree here"
+      // from "this repository is broken", and those two must not be handled the same way.
+      stdio: ["ignore", "pipe", "pipe"]
     }).trim();
-  } catch {
-    throw new Error(
-      `frizz-dev must be run inside a Git repository (cwd: ${cwd})`
-    );
+  } catch (error) {
+    if (!isNotAGitWorktree(error)) throw new Error("unable to resolve Git repository root");
+    gitRoot = void 0;
   }
-  if (migrate) migrateFrayGlobalRoots({ env, home });
-  const root0 = realpathSync3(gitRoot);
-  if (migrate) migrateFrayProjectId(root0, { home });
-  const identity = resolveGitProjectIdentity(root0, home);
-  const root = identity.root;
-  if (migrate) migrateFrayProjectDir(root);
-  const id = identity.id;
+  const root0 = realpathSync4(gitRoot ?? discoverProjectRoot(cwd, home));
+  const identity = gitRoot ? resolveGitProjectIdentity(root0, home) : void 0;
+  const root = identity?.root ?? root0;
+  const id = ensureProjectIdFile(root, home, identity?.id);
   const stateDir = projectStateDir(id, home);
-  mkdirSync5(stateDir, { recursive: true });
+  mkdirSync7(stateDir, { recursive: true });
   const target2 = {
     projectId: id,
     projectDir: root,
     stateDir,
-    ...identity.scope === "worktree" ? { identityScope: "worktree" } : {}
+    ...identity?.scope === "worktree" ? { identityScope: "worktree" } : {}
   };
   return {
     root,
     id,
     stateDir,
-    name: basename4(root),
-    identityScope: identity.scope
+    name: basename5(root),
+    identityScope: identity?.scope ?? "repository"
   };
 }
 function workspaceLaunchTarget(workspace2) {
@@ -8758,7 +8945,7 @@ function workspaceLaunchTarget(workspace2) {
 function workspaceFromLaunchTarget(target2, env = process.env) {
   let root;
   try {
-    root = realpathSync3(target2.projectDir);
+    root = realpathSync4(target2.projectDir);
   } catch {
     throw new Error("pinned Frizz workspace is no longer available");
   }
@@ -8768,14 +8955,14 @@ function workspaceFromLaunchTarget(target2, env = process.env) {
     root,
     id: target2.projectId,
     stateDir: target2.stateDir,
-    name: basename4(root),
+    name: basename5(root),
     identityScope: target2.identityScope === "worktree" ? "worktree" : "repository"
   };
 }
 function parseStatusFile(path, authoritative, expected2, adapter = defaultProcessPlatformAdapter) {
   try {
     const value = JSON.parse(
-      readFileSync5(path, "utf8")
+      readFileSync7(path, "utf8")
     );
     if (!Number.isInteger(value.pid) || value.pid <= 0 || !Number.isInteger(value.port) || value.port < 1 || value.port > 65535)
       return null;
@@ -8803,12 +8990,12 @@ function liveWorkspaceOwner(stateDir, expected2, adapter = defaultProcessPlatfor
   if (authoritative && processGenerationIsStale(authoritative, adapter))
     return null;
   return parseStatusFile(
-    join8(stateDir, "dev-supervisor.lock"),
+    join9(stateDir, "dev-supervisor.lock"),
     authoritative,
     expected2,
     adapter
   ) ?? parseStatusFile(
-    join8(stateDir, "server.lock"),
+    join9(stateDir, "server.lock"),
     authoritative,
     expected2,
     adapter
@@ -8817,19 +9004,21 @@ function liveWorkspaceOwner(stateDir, expected2, adapter = defaultProcessPlatfor
 function readPreferredPort(stateDir) {
   try {
     const value = JSON.parse(
-      readFileSync5(join8(stateDir, "launcher.json"), "utf8")
+      readFileSync7(join9(stateDir, "launcher.json"), "utf8")
     );
     return Number.isInteger(value.port) && value.port > 0 && value.port <= 65535 ? value.port : void 0;
   } catch {
     return void 0;
   }
 }
-async function probeFrizz(port, expected2, fetcher = fetch) {
+var HEALTH_PROBE_TIMEOUT_MS = 1e3;
+async function probeFrizz(port, expected2, fetcher = fetch, timeoutMs = HEALTH_PROBE_TIMEOUT_MS) {
   const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 1e3);
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
   timeout.unref?.();
   try {
-    const response = await fetcher(`http://127.0.0.1:${port}/health`, {
+    const scope = expected2.slug ? `${FRIZZ_ROUTE_PREFIX}/${expected2.slug}` : FRIZZ_ROUTE_PREFIX;
+    const response = await fetcher(`http://127.0.0.1:${port}${scope}/health`, {
       signal: controller.signal
     });
     if (!response.ok) return null;
@@ -8854,26 +9043,36 @@ function expectedOwnerHealth(target2, owner) {
     ...owner ? { ownerProof: projectLaunchTokenProof(target2, owner.token) } : {}
   };
 }
-async function canBindPort(port, host = LOOPBACK_BIND_HOST) {
-  const bind2 = (candidate) => new Promise((resolveBind) => {
+async function probeBindPort(port, host = LOOPBACK_BIND_HOST) {
+  return new Promise((resolveBind) => {
     const server = createServer();
     server.unref();
-    server.once("error", () => resolveBind(false));
-    server.listen(candidate, host, () => server.close(() => resolveBind(true)));
+    server.once(
+      "error",
+      (error) => resolveBind(error.code ?? "EADDRINUSE")
+    );
+    server.listen(port, host, () => server.close(() => resolveBind(void 0)));
   });
-  return bind2(port);
 }
-function portCandidates(preferred) {
+async function canBindPort(port, host = LOOPBACK_BIND_HOST) {
+  return await probeBindPort(port, host) === void 0;
+}
+function portUnavailableMessage(port, code) {
+  if (code === "EACCES" || code === "EPERM")
+    return `port ${port} is reserved by the system, not held by a process (bind returned ${code}); on Windows list the reservations with: netsh int ipv4 show excludedportrange protocol=tcp`;
+  return `port ${port} is already in use`;
+}
+function portCandidates(preferred, base = DEFAULT_PORT) {
+  const fallback = fallbackPort(base);
   return [
+    base,
     preferred,
-    ...Array.from(
-      { length: PORT_SCAN_COUNT },
-      (_, index) => DEFAULT_PORT + index
-    )
+    ...Array.from({ length: PORT_SCAN_COUNT }, (_, index) => fallback + index)
   ].filter((port) => !!port && port <= 65535);
 }
-function noFreePortMessage() {
-  return `no free Frizz development port found in ${DEFAULT_PORT}-${DEFAULT_PORT + PORT_SCAN_COUNT - 1}`;
+function noFreePortMessage(base = DEFAULT_PORT) {
+  const fallback = fallbackPort(base);
+  return `no free Frizz port: ${base} is taken, and so is every port in ${fallback}-${fallback + PORT_SCAN_COUNT - 1}`;
 }
 async function allocatePort(explicit, preferred, options2 = {}) {
   const host = options2.host ?? LOOPBACK_BIND_HOST;
@@ -8888,14 +9087,17 @@ async function allocatePort(explicit, preferred, options2 = {}) {
   };
   if (explicit !== void 0) {
     const allocated = await claim(explicit);
-    if (!allocated) throw new Error(`port ${explicit} is already in use`);
+    if (!allocated)
+      throw new Error(
+        portUnavailableMessage(explicit, await probeBindPort(explicit, host))
+      );
     return allocated;
   }
-  for (const port of portCandidates(preferred)) {
+  for (const port of portCandidates(preferred, options2.base)) {
     const allocated = await claim(port);
     if (allocated) return allocated;
   }
-  throw new Error(noFreePortMessage());
+  throw new Error(noFreePortMessage(options2.base));
 }
 async function waitForWorkspace(port, expected2, timeoutMs = LAUNCH_TIMEOUT_MS, options2 = {}) {
   const started = Date.now();
@@ -8931,16 +9133,17 @@ init_project_launch();
 // packages/server/src/dev-supervisor.ts
 init_project_launch();
 import { fork } from "node:child_process";
-import { randomUUID as randomUUID4 } from "node:crypto";
-import { existsSync as existsSync3, mkdirSync as mkdirSync6, readFileSync as readFileSync7 } from "node:fs";
+import { randomUUID as randomUUID5 } from "node:crypto";
+import { existsSync as existsSync4, mkdirSync as mkdirSync8, readFileSync as readFileSync9 } from "node:fs";
 import { createServer as createNetServer } from "node:net";
-import { basename as basename5, dirname as dirname4, extname as extname2, isAbsolute as isAbsolute3, relative, resolve as resolve4, sep as sep2 } from "node:path";
+import { basename as basename6, dirname as dirname7, extname as extname2, isAbsolute as isAbsolute3, relative, resolve as resolve4, sep as sep2 } from "node:path";
 import { fileURLToPath } from "node:url";
 import watcher from "@parcel/watcher";
 
 // packages/server/src/restart-supervisor.ts
 init_local_origin();
 init_local_image();
+init_src();
 import { request as requestHttp, createServer as createServer2 } from "node:http";
 import { connect } from "node:net";
 var SUPERVISOR_CONTROL_PREFIX = "/_frizz/control";
@@ -8970,8 +9173,11 @@ function isControlRequest(req) {
   return url.pathname === SUPERVISOR_RESTART_PATH || url.pathname === SUPERVISOR_UPDATE_RESTART_PATH || url.pathname === SUPERVISOR_STATUS_PATH;
 }
 function isLocalImageRequest(req) {
-  return (req.method === "GET" || req.method === "HEAD") && new URL(req.url ?? "/", "http://frizz.invalid").pathname === "/local-image";
+  if (req.method !== "GET" && req.method !== "HEAD") return false;
+  const { pathname } = new URL(req.url ?? "/", "http://frizz.invalid");
+  return LOCAL_IMAGE_PATH.test(pathname);
 }
+var LOCAL_IMAGE_PATH = new RegExp(`^${FRIZZ_ROUTE_PREFIX}(?:/[^/]+)?/local-image$`);
 var RestartSupervisorProxy = class {
   server = null;
   restartInFlight = null;
@@ -9329,7 +9535,7 @@ function classifyDevChange(path, roots = defaultDevWatchRoots()) {
   const root = roots.find((candidate) => isWithin(absolute, resolve4(candidate)));
   if (!root) return null;
   if (ignoredDevPath(absolute)) return null;
-  const name = basename5(absolute);
+  const name = basename6(absolute);
   const relToWorkspace = relative(resolve4(root), absolute);
   const parts = relToWorkspace.split(sep2);
   const packageName = parts[0] === "packages" ? parts[1] : void 0;
@@ -9351,12 +9557,12 @@ function classifyDevChange(path, roots = defaultDevWatchRoots()) {
   return null;
 }
 function devConfigSyntaxError(path) {
-  const name = basename5(path);
+  const name = basename6(path);
   const isTsconfig = /^tsconfig(?:\.[^.]+)?\.json$/.test(name);
   if (name !== "package.json" && !isTsconfig) return null;
   let text;
   try {
-    text = readFileSync7(path, "utf8");
+    text = readFileSync9(path, "utf8");
   } catch (err) {
     return `${name}: ${err instanceof Error ? err.message : err}`;
   }
@@ -9452,7 +9658,7 @@ var Supervisor = class {
   watchSubscribe;
   reexec;
   supervisorLock;
-  statusPublisherToken = randomUUID4();
+  statusPublisherToken = randomUUID5();
   processGeneration = currentProcessGeneration();
   ownerToken;
   launchTarget;
@@ -9523,14 +9729,14 @@ var Supervisor = class {
   }
   async start() {
     if (this.supervisorLock) {
-      mkdirSync6(dirname4(this.supervisorLock), { recursive: true });
+      mkdirSync8(dirname7(this.supervisorLock), { recursive: true });
       this.writeStatus("starting", "watcher initializing");
     }
     try {
       await this.publicProxy.listen();
       if (this.watchEnabled) {
         const settled = await Promise.allSettled(
-          this.roots.filter(existsSync3).map((root) => this.watchSubscribe(root, (err, events) => this.onWatch(err, events), {
+          this.roots.filter(existsSync4).map((root) => this.watchSubscribe(root, (err, events) => this.onWatch(err, events), {
             ignore: DEV_WATCH_IGNORE
           }))
         );
@@ -9948,13 +10154,13 @@ async function startDevSupervisor(opts) {
 import { execFile as execFile2, spawn as spawn2 } from "node:child_process";
 var PRODUCTION_REEXEC_FLAG = "--_frizz-production-reexec";
 function compareReleaseVersions(a, b) {
-  const parse = (value) => {
+  const parse2 = (value) => {
     const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/u.exec(value);
     if (!match) return null;
     return { numeric: [Number(match[1]), Number(match[2]), Number(match[3])], prerelease: match[4] };
   };
-  const left = parse(a);
-  const right = parse(b);
+  const left = parse2(a);
+  const right = parse2(b);
   if (!left || !right) return null;
   for (let index = 0; index < left.numeric.length; index++) {
     const delta = left.numeric[index] - right.numeric[index];
@@ -10018,8 +10224,8 @@ var npmRegistryReleaseAdapter = {
 // src/preflight.ts
 import { spawnSync } from "node:child_process";
 import { chmodSync, statSync as statSync5 } from "node:fs";
-import { createRequire as createRequire2 } from "node:module";
-import { dirname as dirname5, join as join9 } from "node:path";
+import { createRequire } from "node:module";
+import { dirname as dirname8, join as join10 } from "node:path";
 var SUPPORTED_NODE_LINES = [
   { major: 22, minor: 13 },
   { major: 23, minor: 4 }
@@ -10037,9 +10243,7 @@ function nodeVersionIsSupported(major, minor) {
   if (line) return minor >= line.minor;
   return major > SUPPORTED_NODE_LINES[SUPPORTED_NODE_LINES.length - 1].major;
 }
-var REQUIRED_EXECUTABLES = [
-  { name: "git", need: "Frizz identifies a project by its Git repository" }
-];
+var REQUIRED_EXECUTABLES = [];
 function assertRequiredExecutables(command = commandIsAvailable) {
   for (const { name, need } of REQUIRED_EXECUTABLES) {
     if (command(name)) continue;
@@ -10070,10 +10274,10 @@ function ensureNativeHelperPermissions(options2 = {}) {
   if (platform === "win32") return;
   const stat = options2.stat ?? ((path) => statSync5(path));
   const chmod = options2.chmod ?? ((path, mode) => chmodSync(path, mode));
-  const resolvePty = options2.resolvePty ?? (() => createRequire2(import.meta.url).resolve("node-pty/package.json"));
+  const resolvePty = options2.resolvePty ?? (() => createRequire(import.meta.url).resolve("node-pty/package.json"));
   try {
-    const helper = join9(
-      dirname5(resolvePty()),
+    const helper = join10(
+      dirname8(resolvePty()),
       "prebuilds",
       `${platform}-${options2.arch ?? process.arch}`,
       "spawn-helper"
@@ -10086,10 +10290,13 @@ function ensureNativeHelperPermissions(options2 = {}) {
 }
 
 // src/production.ts
+init_src();
+init_project_registry();
+init_project_identity();
 var PACKAGE_NAME = process.env.FRIZZ_REGISTRY_PACKAGE ?? "frizz";
 function resolvePackageVersion() {
   try {
-    const manifest = JSON.parse(readFileSync8(join10(import.meta.dirname, "..", "package.json"), "utf8"));
+    const manifest = JSON.parse(readFileSync10(join11(import.meta.dirname, "..", "package.json"), "utf8"));
     if (typeof manifest.version === "string" && manifest.version.trim()) return manifest.version.trim();
   } catch {
   }
@@ -10152,6 +10359,7 @@ var bind = (() => {
     return fail(error);
   }
 })();
+var launchIntent;
 var workspace = (() => {
   try {
     if (!reexec) {
@@ -10159,11 +10367,17 @@ var workspace = (() => {
       else assertLaunchPrerequisites();
     }
     const pinned = projectLaunchTargetFromEnvironment(process.env);
-    if (reexec) {
+    if (reexec || process.env.FRIZZ_PRODUCTION_SUPERVISOR === "1") {
       if (!pinned) throw new Error("registry successor is missing its pinned project identity");
       return workspaceFromLaunchTarget(pinned);
     }
-    return resolveWorkspace(options.repoPath);
+    const intent = resolveLaunchIntent(options.repoPath);
+    if (intent.kind === "empty")
+      throw new Error(
+        intent.reason === "home" ? "frizz cannot open your home directory as a project, and there is no other project to show yet. cd into a repository and run frizz there." : `${intent.directory} is not a Frizz project yet, and there is no other project to show. Run frizz inside a repository, or add this one from the projects page once a board is open.`
+      );
+    launchIntent = intent;
+    return intent.workspace;
   } catch (error) {
     return fail(error);
   }
@@ -10188,8 +10402,39 @@ async function existingPort() {
   for (const port of new Set(ports)) if (await probeFrizz(port, expected)) return port;
   return void 0;
 }
-async function openOrPrint(port, reused) {
-  const url = `http://127.0.0.1:${port}`;
+function ownSlug() {
+  try {
+    return registerProject(
+      { dir: workspace.root, id: target.projectId, remoteOwner: resolveProjectLabel(workspace.root)?.split("/")[0] },
+      homedir8()
+    ).entry?.slug;
+  } catch {
+    return void 0;
+  }
+}
+var cachedSlugPath;
+function slugPath() {
+  if (cachedSlugPath === void 0) {
+    if (launchIntent?.kind === "grid") cachedSlugPath = "/";
+    else if (launchIntent?.kind === "offer") cachedSlugPath = `/?add=${encodeURIComponent(launchIntent.directory)}`;
+    else {
+      const slug = ownSlug();
+      cachedSlugPath = slug ? `/project/${slug}` : "";
+    }
+  }
+  return cachedSlugPath;
+}
+async function joinRunningFrizz() {
+  const slug = ownSlug();
+  if (!slug) return void 0;
+  for (const port of /* @__PURE__ */ new Set([DEFAULT_PORT, fallbackPort(DEFAULT_PORT)])) {
+    if (await probeFrizz(port, { projectId: target.projectId, projectDir: target.projectDir, slug }))
+      return { port, slug };
+  }
+  return void 0;
+}
+async function openOrPrint(port, reused, path = "") {
+  const url = `http://127.0.0.1:${port}${path}`;
   logger.info("launcher", `${reused ? "reusing" : "started"} Frizz at ${url}`);
   readout?.settle("server", "done", reused ? `already running on port ${port}` : `port ${port}`);
   let browser;
@@ -10197,7 +10442,7 @@ async function openOrPrint(port, reused) {
     readout?.begin("browser", options.appMode ? "requesting app window" : "requesting default browser");
     try {
       if (options.appMode) {
-        await launchApp(url, { dataPath: join10(workspace.stateDir, "browser-profile") });
+        await launchApp(url, { dataPath: join11(workspace.stateDir, "browser-profile") });
         browser = reused ? "focused the Frizz app window" : "opened the Frizz app window";
       } else {
         await launchBrowserTab(url);
@@ -10226,10 +10471,10 @@ async function openOrPrint(port, reused) {
     for (const warning of warnings) console.log(warning);
     return;
   }
-  const home = homedir7();
+  const home = homedir8();
   readout.ready(
     [
-      { label: "Local", value: `${url}/`, accent: true },
+      { label: "Local", value: boardAddress(url), accent: true },
       ...network.map((address) => ({ label: "Network", value: `${address}/`, accent: true })),
       ...publicOrigin ? [{ label: "Public", value: `${publicOrigin}/`, accent: true }] : [],
       { label: "Project", value: `${workspace.name} \u2014 ${tildePath(workspace.root, home)}` },
@@ -10259,10 +10504,10 @@ async function runSupervisor(port, token) {
     target,
     owner.token
   );
-  const webDist = join10(import.meta.dirname, "..", "web-dist");
-  const runtimeDir = join10(import.meta.dirname, "..", "runtime");
-  const scriptsDir = join10(runtimeDir, "board");
-  const workerPluginDir = join10(runtimeDir, "cc-worker");
+  const webDist = join11(import.meta.dirname, "..", "web-dist");
+  const runtimeDir = join11(import.meta.dirname, "..", "runtime");
+  const scriptsDir = join11(runtimeDir, "board");
+  const workerPluginDir = join11(runtimeDir, "cc-worker");
   const childEntry = fileURLToPath2(new URL("./dev-child.js", import.meta.url));
   let plannedUpdate;
   let updateAvailable = true;
@@ -10316,10 +10561,10 @@ async function runSupervisor(port, token) {
     exit: (code) => {
       logger.info("launcher", `stopped with code ${code}`);
       const suffix = logger.file ? `
-  log: ${tildePath(logger.file, homedir7())}` : "";
+  log: ${tildePath(logger.file, homedir8())}` : "";
       process.stdout.write(
         code === 0 ? `
-  Frizz stopped. Agent sessions in tmux keep running.${suffix}
+  Frizz stopped. Running agents keep going \u2014 they are detached daemons.${suffix}
 
 ` : `
   Frizz stopped with errors (exit ${code}).${suffix}
@@ -10346,7 +10591,12 @@ try {
   }
   const existing = await existingPort();
   if (existing) {
-    await openOrPrint(existing, true);
+    await openOrPrint(existing, true, slugPath());
+    process.exit(0);
+  }
+  const joined = await joinRunningFrizz();
+  if (joined) {
+    await openOrPrint(joined.port, true, slugPath());
     process.exit(0);
   }
   const claim = tryAcquireProjectLaunchOwner(target, "launcher");
@@ -10371,7 +10621,7 @@ try {
     ]);
     portReservation();
     portReservation = void 0;
-    await openOrPrint(port, false);
+    await openOrPrint(port, false, slugPath());
     await running;
   } finally {
     release?.();