kith-coord 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -73,6 +73,7 @@ declare class FencingAndAgentManager {
     private readonly coordDb;
     static readonly DEFAULT_LEASE_MS: number;
     private readonly capabilities;
+    private static ownWindowsStart;
     constructor(coordDb: CoordDatabase);
     static validateLease(duration: number): number;
     /** A real kernel process identity; tests must not supply liveness sentinels. */
@@ -977,7 +978,7 @@ declare function recoveryReport(directory?: string): {
     error: string | undefined;
 };
 
-declare const KITH_VERSION = "0.1.0";
-declare const KITH_PROTOCOL_VERSION = "1.0.0";
+declare const KITH_VERSION = "0.1.2";
+declare const KITH_PROTOCOL_VERSION = "1.1.0";
 
 export { type AcquireLockResult, type AgentRecord, type AgentUnreadDelta, AstAnalyzer, type BashGuardPostReport, BashMerkleGuard, type BlastRadiusAlert, CoWWorktreeManager, type ConflictRecord, type ContractRecord, CoordDatabase, type CoordEvent, type DeclareIntentResult, DependencyAndContractEngine, type DirtyMergeProbeResult, type ExtractedImport, type ExtractedSymbol, FencingAndAgentManager, type FileAstAnalysis, type FileModificationReport, type FileSnapshotEntry, IntentAndTaskEngine, KITH_PROTOCOL_VERSION, KITH_VERSION, KithEngine, type LockConflict, LockEngine, type LockRecord, type MergeTrainEntry, type PostFileEditHookResult, type QuarantineRecord, type RepositoryLayout, ResourceBroker, type ResourceRecord, SessionOwnershipError, type SessionRegistration, ShadowGitEngine, type SpawnedWorktree, type SpeculativeMergeResult, SpeculativeMergeTrain, StaleFencingTokenError, type SymbolKind, type TaskRecord, type WorkspaceObservation, type WorktreeChange, caseSensitivePaths, discoverRepository, isWithin, observeWorkspaces, physicalPath, previewIntegration, readCoordinationState, recoveryReport, repositoryFile, worktreeChanges };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/version.ts
-var KITH_VERSION = "0.1.0";
-var KITH_PROTOCOL_VERSION = "1.0.0";
+var KITH_VERSION = "0.1.2";
+var KITH_PROTOCOL_VERSION = "1.1.0";
 
 // src/core/workspace-observation.ts
 import { execFileSync as execFileSync2, spawnSync } from "child_process";
@@ -10,6 +10,7 @@ import { execFileSync } from "child_process";
 import fs from "fs";
 import path from "path";
 function physicalPath(input) {
+  if (process.platform === "win32") input = input.replaceAll("/", path.sep);
   const absolute = path.isAbsolute(input) ? input : process.cwd() + path.sep + input;
   let current = path.parse(absolute).root;
   for (const component of absolute.slice(current.length).split(path.sep)) {
@@ -40,7 +41,7 @@ function isWithin(root, target) {
   return relative !== ".." && !relative.startsWith(".." + path.sep) && !path.isAbsolute(relative);
 }
 function repositoryFile(root, file) {
-  if (!file || /[\\\x00-\x1f\x7f]/u.test(file)) throw new Error(`Invalid file path: ${file}`);
+  if (!file || /[\x00-\x1f\x7f]/u.test(file) || process.platform !== "win32" && file.includes("\\")) throw new Error(`Invalid file path: ${file}`);
   const canonicalRoot = physicalPath(root);
   const target = physicalPath(path.isAbsolute(file) ? file : canonicalRoot + path.sep + file);
   if (!isWithin(canonicalRoot, target) || target === canonicalRoot) {
@@ -230,7 +231,7 @@ function previewIntegration(repoRoot, agent) {
 
 // src/core/engine.ts
 import fs12 from "fs";
-import path10 from "path";
+import path11 from "path";
 
 // src/core/ast-analyzer.ts
 import crypto from "crypto";
@@ -511,12 +512,12 @@ var AstAnalyzer = class _AstAnalyzer {
 // src/core/bash-guard.ts
 import crypto4 from "crypto";
 import fs5 from "fs";
-import path4 from "path";
+import path5 from "path";
 
 // src/core/locks.ts
 import crypto3 from "crypto";
 import fs4 from "fs";
-import path3 from "path";
+import path4 from "path";
 
 // src/core/glob.ts
 function scopeSegments(pattern, literal = false) {
@@ -587,6 +588,7 @@ function scopesOverlap(a, b, literalA = false, literalB = false) {
 import { execFileSync as execFileSync3 } from "child_process";
 import crypto2 from "crypto";
 import fs3 from "fs";
+import path3 from "path";
 var SessionOwnershipError = class extends Error {
   constructor(agentId) {
     super(`No valid active session capability for '${agentId}'. Start a session, or resume it with its session token.`);
@@ -612,6 +614,7 @@ var FencingAndAgentManager = class _FencingAndAgentManager {
   coordDb;
   static DEFAULT_LEASE_MS = 5 * 60 * 1e3;
   capabilities = /* @__PURE__ */ new Map();
+  static ownWindowsStart = null;
   static validateLease(duration) {
     if (!Number.isSafeInteger(duration) || duration < 100 || duration > 864e5) {
       throw new Error("Lease duration must be an integer between 100 and 86400000 milliseconds");
@@ -626,6 +629,24 @@ var FencingAndAgentManager = class _FencingAndAgentManager {
         const stat = fs3.readFileSync(`/proc/${pid}/stat`, "utf8");
         return `linux:${stat.slice(stat.lastIndexOf(")") + 2).split(" ")[19]}`;
       }
+      if (process.platform === "win32") {
+        if (pid === process.pid && this.ownWindowsStart) return this.ownWindowsStart;
+        const powershell = path3.join(process.env.SystemRoot ?? "C:\\Windows", "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+        const ticks = execFileSync3(
+          powershell,
+          [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToUniversalTime().Ticks.ToString([System.Globalization.CultureInfo]::InvariantCulture)`
+          ],
+          { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 5e3, windowsHide: true }
+        ).trim();
+        if (!/^\d+$/.test(ticks)) return null;
+        const identity = `windows:${ticks}`;
+        if (pid === process.pid) this.ownWindowsStart = identity;
+        return identity;
+      }
       const out = execFileSync3("ps", ["-o", "lstart=", "-p", String(pid)], {
         encoding: "utf8",
         stdio: ["ignore", "pipe", "ignore"],
@@ -815,9 +836,9 @@ var LockEngine = class _LockEngine {
     const parts = rawPattern.split("/");
     const magic = parts.findIndex((p) => /[?*]/u.test(p));
     const prefix = magic < 0 ? rawPattern : parts.slice(0, magic).join("/") || ".";
-    const absolute = physicalPath(path3.isAbsolute(prefix) ? prefix : root + "/" + prefix);
+    const absolute = physicalPath(path4.isAbsolute(prefix) ? prefix : root + "/" + prefix);
     if (!isWithin(root, absolute)) throw new Error(`Scope is outside repository: ${rawPattern}`);
-    const relative = path3.relative(root, absolute).split(path3.sep).join("/");
+    const relative = path4.relative(root, absolute).split(path4.sep).join("/");
     const suffix = magic < 0 ? "" : parts.slice(magic).join("/");
     const normalized = [relative, suffix].filter(Boolean).join("/");
     scopeSegments(normalized);
@@ -852,7 +873,7 @@ var LockEngine = class _LockEngine {
     let budget = 1e4;
     while (pending.length) {
       const { root, relative } = pending.pop();
-      const dir = path3.join(root, relative);
+      const dir = path4.join(root, relative);
       let entries;
       try {
         entries = fs4.readdirSync(dir, { withFileTypes: true });
@@ -1111,7 +1132,7 @@ var BashMerkleGuard = class {
   getSnapshotFilePath(agentId) {
     const epoch = this.fencing.assertSession(agentId);
     const safeId = crypto4.createHash("sha256").update(`${agentId}:${epoch}`).digest("hex");
-    return path4.join(this.coordDb.coordDir, "snapshots", `${safeId}.json`);
+    return path5.join(this.coordDb.coordDir, "snapshots", `${safeId}.json`);
   }
   /**
    * Captures a Merkle snapshot of workspace files before a Bash tool execution.
@@ -1123,7 +1144,7 @@ var BashMerkleGuard = class {
     const entries = {};
     const files = this.walkWorkspaceFiles(rootDir);
     for (const absPath of files) {
-      const relPath = path4.relative(rootDir, absPath).replace(/\\/g, "/");
+      const relPath = path5.relative(rootDir, absPath).replace(/\\/g, "/");
       const stat = fs5.statSync(absPath);
       if (stat.size > 5 * 1024 * 1024) continue;
       const buf = fs5.readFileSync(absPath);
@@ -1166,7 +1187,7 @@ var BashMerkleGuard = class {
     const authorizedModifiedFiles = [];
     const quarantinedViolations = [];
     for (const absPath of currentFiles) {
-      const relPath = path4.relative(rootDir, absPath).replace(/\\/g, "/");
+      const relPath = path5.relative(rootDir, absPath).replace(/\\/g, "/");
       seenCurrentRelPaths.add(relPath);
       const stat = fs5.statSync(absPath);
       if (stat.size > 5 * 1024 * 1024) continue;
@@ -1228,7 +1249,7 @@ var BashMerkleGuard = class {
     }
     if (authorizedModifiedFiles.length > 0) {
       for (const relFile of authorizedModifiedFiles) {
-        const absFile = path4.join(rootDir, relFile);
+        const absFile = path5.join(rootDir, relFile);
         if (fs5.existsSync(absFile) && /\.(ts|tsx|js|jsx|mjs|py)$/.test(relFile)) {
           this.depGraph.recordFileModification(params.agentId, relFile, fs5.readFileSync(absFile, "utf8"));
         }
@@ -1249,7 +1270,7 @@ var BashMerkleGuard = class {
     const id = `quar_${crypto4.randomBytes(6).toString("hex")}`;
     const now = Date.now();
     const safeName = params.relPath.replace(/[^a-zA-Z0-9._-]/g, "_");
-    const patchPath = path4.join(
+    const patchPath = path5.join(
       this.coordDb.coordDir,
       "quarantine",
       `${id}_${safeName}.quarantine`
@@ -1263,13 +1284,13 @@ var BashMerkleGuard = class {
     if (params.prevEntry?.backupContentBase64 !== void 0) {
       fs5.writeFileSync(patchPath + ".before", Buffer.from(params.prevEntry.backupContentBase64, "base64"), { mode: 384 });
     }
-    const absTarget = path4.join(params.rootDir, params.relPath);
+    const absTarget = path5.join(params.rootDir, params.relPath);
     if (params.restoreLockedFiles && params.prevEntry === null) {
       if (fs5.existsSync(absTarget)) {
         fs5.unlinkSync(absTarget);
       }
     } else if (params.restoreLockedFiles && params.prevEntry?.backupContentBase64 !== void 0) {
-      fs5.mkdirSync(path4.dirname(absTarget), { recursive: true });
+      fs5.mkdirSync(path5.dirname(absTarget), { recursive: true });
       fs5.writeFileSync(
         absTarget,
         Buffer.from(params.prevEntry.backupContentBase64, "base64")
@@ -1313,7 +1334,7 @@ var BashMerkleGuard = class {
       if (entry.name === ".git" || entry.name === ".coord" || entry.name === "node_modules" || entry.name === "dist" || entry.name === "coverage" || entry.name === ".next" || entry.name === "target") {
         continue;
       }
-      const fullPath = path4.join(dir, entry.name);
+      const fullPath = path5.join(dir, entry.name);
       if (entry.isDirectory()) {
         this.walkWorkspaceFiles(fullPath, acc);
       } else if (entry.isFile()) {
@@ -1750,7 +1771,7 @@ function delay(ms) {
 // src/core/db.ts
 import { createRequire } from "module";
 import fs7 from "fs";
-import path5 from "path";
+import path6 from "path";
 var require2 = createRequire(import.meta.url);
 var { DatabaseSync } = require2("node:sqlite");
 var CoordDatabase = class _CoordDatabase {
@@ -1766,19 +1787,19 @@ var CoordDatabase = class _CoordDatabase {
     this.repoRoot = layout.checkoutRoot;
     this.commonGitDir = layout.commonGitDir;
     this.isLinkedWorktree = layout.isLinkedWorktree;
-    for (let current = fs7.realpathSync.native(repoRoot); isWithin(this.repoRoot, current); current = path5.dirname(current)) {
-      const local = path5.join(current, ".coord");
-      if (local !== layout.coordDir && fs7.existsSync(path5.join(local, "state.db"))) {
+    for (let current = fs7.realpathSync.native(repoRoot); isWithin(this.repoRoot, current); current = path6.dirname(current)) {
+      const local = path6.join(current, ".coord");
+      if (local !== layout.coordDir && fs7.existsSync(path6.join(local, "state.db"))) {
         throw new Error(`Legacy checkout-local coordination state found at ${local}. Stop clients and preserve that directory before consolidating shared state.`);
       }
       if (current === this.repoRoot) break;
     }
     this.coordDir = layout.coordDir;
     if (physicalPath(this.coordDir) !== this.coordDir) throw new Error("Coordination directory must not be a symlink");
-    this.dbPath = customDbPath ?? path5.join(this.coordDir, "state.db");
+    this.dbPath = customDbPath ?? path6.join(this.coordDir, "state.db");
     if (!customDbPath && physicalPath(this.dbPath) !== this.dbPath) throw new Error("Coordination database must not be a symlink");
-    const recoveryFiles = !customDbPath && (fs7.existsSync(path5.join(this.coordDir, "merge-train.lock")) || fs7.existsSync(path5.join(this.coordDir, "setup.lock")) || ["shadow-index", "quarantine", "snapshots", "worktrees", "setup"].some((name) => {
-      const dir = path5.join(this.coordDir, name);
+    const recoveryFiles = !customDbPath && (fs7.existsSync(path6.join(this.coordDir, "merge-train.lock")) || fs7.existsSync(path6.join(this.coordDir, "setup.lock")) || ["shadow-index", "quarantine", "snapshots", "worktrees", "setup"].some((name) => {
+      const dir = path6.join(this.coordDir, name);
       return fs7.existsSync(dir) && (!fs7.lstatSync(dir).isDirectory() || fs7.readdirSync(dir).length > 0);
     }));
     const sidecars = ["-wal", "-shm", "-journal"].some((suffix) => fs7.existsSync(this.dbPath + suffix));
@@ -1798,7 +1819,7 @@ var CoordDatabase = class _CoordDatabase {
     }
     fs7.mkdirSync(this.coordDir, { recursive: true, mode: 448 });
     for (const name of ["shadow-index", "quarantine", "snapshots", "worktrees"]) {
-      const target = path5.join(this.coordDir, name);
+      const target = path6.join(this.coordDir, name);
       if (!isWithin(this.coordDir, physicalPath(target)) || physicalPath(target) !== target) {
         throw new Error(`Coordination subdirectory must not be a symlink: ${name}`);
       }
@@ -2159,7 +2180,7 @@ var CoordDatabase = class _CoordDatabase {
 // src/core/dep-graph.ts
 import crypto6 from "crypto";
 import fs8 from "fs";
-import path6 from "path";
+import path7 from "path";
 var DependencyAndContractEngine = class {
   constructor(coordDb, lockEngine, fencing) {
     this.coordDb = coordDb;
@@ -2182,13 +2203,13 @@ var DependencyAndContractEngine = class {
     return indexedCount;
   }
   walkSourceFiles(dir, acc = []) {
-    if (!fs8.existsSync(dir) || dir !== this.coordDb.repoRoot && fs8.existsSync(path6.join(dir, ".git"))) return acc;
+    if (!fs8.existsSync(dir) || dir !== this.coordDb.repoRoot && fs8.existsSync(path7.join(dir, ".git"))) return acc;
     const entries = fs8.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.name === "dist" || entry.name === "build" || entry.name === "target" || entry.name === "coverage") {
         continue;
       }
-      const fullPath = path6.join(dir, entry.name);
+      const fullPath = path7.join(dir, entry.name);
       if (entry.isDirectory()) {
         this.walkSourceFiles(fullPath, acc);
       } else if (entry.isFile() && /\.(ts|tsx|js|jsx|mjs|py)$/.test(entry.name) && !entry.name.endsWith(".d.ts")) {
@@ -2249,6 +2270,7 @@ var DependencyAndContractEngine = class {
       }
       for (const exp of analysis.exports) {
         const prev = existingBySymbol.get(exp.symbolName);
+        if (prev && prev.kind === exp.kind && prev.signature === exp.signature && prev.ast_hash === exp.astHash && prev.params_fingerprint === exp.paramsFingerprint && prev.doc_comment === exp.docComment) continue;
         const isBreaking = prev !== void 0 && prev.ast_hash !== exp.astHash;
         if (isBreaking && prev) {
           changedSymbols.push({
@@ -2720,7 +2742,7 @@ var IntentAndTaskEngine = class {
 import { execFileSync as execFileSync4, execSync } from "child_process";
 import crypto8 from "crypto";
 import fs9 from "fs";
-import path7 from "path";
+import path8 from "path";
 var SpeculativeMergeTrain = class {
   constructor(coordDb, fencing) {
     this.coordDb = coordDb;
@@ -2759,8 +2781,8 @@ var SpeculativeMergeTrain = class {
         now
       );
     });
-    const stageDir = path7.join(this.coordDb.coordDir, "worktrees", `_merge_train_${id}`);
-    const lockPath = path7.join(this.coordDb.coordDir, "merge-train.lock");
+    const stageDir = path8.join(this.coordDb.coordDir, "worktrees", `_merge_train_${id}`);
+    const lockPath = path8.join(this.coordDb.coordDir, "merge-train.lock");
     let lockFd;
     try {
       try {
@@ -2811,8 +2833,8 @@ var SpeculativeMergeTrain = class {
         cwd: this.coordDb.repoRoot,
         stdio: "ignore"
       });
-      const rootNodeModules = path7.join(this.coordDb.repoRoot, "node_modules");
-      const stageNodeModules = path7.join(stageDir, "node_modules");
+      const rootNodeModules = path8.join(this.coordDb.repoRoot, "node_modules");
+      const stageNodeModules = path8.join(stageDir, "node_modules");
       const hydratedNodeModules = fs9.existsSync(rootNodeModules) && !fs9.existsSync(stageNodeModules);
       if (hydratedNodeModules) {
         fs9.symlinkSync(rootNodeModules, stageNodeModules, "dir");
@@ -2977,7 +2999,7 @@ ${combined}`
 import { execFileSync as execFileSync5 } from "child_process";
 import crypto9 from "crypto";
 import fs10 from "fs";
-import path8 from "path";
+import path9 from "path";
 var ShadowGitEngine = class {
   constructor(coordDb, fencing) {
     this.coordDb = coordDb;
@@ -3010,7 +3032,7 @@ var ShadowGitEngine = class {
   getShadowIndexPath(agentId) {
     const safeId = agentId.replace(/[^a-zA-Z0-9_-]/g, "_");
     const epoch = this.fencing.assertSession(agentId);
-    return path8.join(this.coordDb.coordDir, "shadow-index", `${safeId}-${epoch}.index`);
+    return path9.join(this.coordDb.coordDir, "shadow-index", `${safeId}-${epoch}.index`);
   }
   /**
    * Updates an agent's ephemeral shadow Git index (`.coord/shadow-index/<agent-id>.index`)
@@ -3047,7 +3069,7 @@ var ShadowGitEngine = class {
     } else if (params.modifiedFiles && params.modifiedFiles.length > 0) {
       for (const mod of params.modifiedFiles) {
         const relPath = LockEngine.normalizeFile(targetDir, mod.filePath);
-        const absPath = path8.join(targetDir, relPath);
+        const absPath = path9.join(targetDir, relPath);
         const content = mod.content ?? (fs10.existsSync(absPath) ? fs10.readFileSync(absPath, "utf8") : null);
         if (content === null) {
           {
@@ -3248,7 +3270,7 @@ var ShadowGitEngine = class {
 // src/core/worktree-cow.ts
 import { execFileSync as execFileSync6 } from "child_process";
 import fs11 from "fs";
-import path9 from "path";
+import path10 from "path";
 var CoWWorktreeManager = class _CoWWorktreeManager {
   constructor(coordDb, fencing) {
     this.coordDb = coordDb;
@@ -3268,13 +3290,13 @@ var CoWWorktreeManager = class _CoWWorktreeManager {
     const safeId = params.agentId.replace(/[^a-zA-Z0-9_-]/g, "-");
     const branch = params.branch ?? `kith/${safeId}`;
     const baseRef = params.baseRef ?? "HEAD";
-    const worktreePath = path9.join(this.coordDb.coordDir, "worktrees", safeId);
+    const worktreePath = path10.join(this.coordDb.coordDir, "worktrees", safeId);
     if (!this.fencing.getAgent(params.agentId)) throw new Error(`Unknown agent: ${params.agentId}`);
     if (!safeId || safeId === "." || safeId === "..") throw new Error("Invalid agent ID");
     if (fs11.existsSync(worktreePath)) {
       throw new Error(`Worktree already exists: ${worktreePath}. Commit or preserve its work before removing it.`);
     }
-    fs11.mkdirSync(path9.dirname(worktreePath), { recursive: true });
+    fs11.mkdirSync(path10.dirname(worktreePath), { recursive: true });
     execFileSync6("git", ["worktree", "add", "-b", branch, worktreePath, baseRef], {
       cwd: this.coordDb.repoRoot,
       stdio: "ignore"
@@ -3282,16 +3304,16 @@ var CoWWorktreeManager = class _CoWWorktreeManager {
     const hydratedDirs = [];
     let hydrationMethod = "none";
     for (const dirName of _CoWWorktreeManager.HYDRATABLE_DIRS) {
-      const srcDir = path9.join(this.coordDb.repoRoot, dirName);
-      const destDir = path9.join(worktreePath, dirName);
+      const srcDir = path10.join(this.coordDb.repoRoot, dirName);
+      const destDir = path10.join(worktreePath, dirName);
       if (!fs11.existsSync(srcDir) || fs11.existsSync(destDir)) continue;
       const method = this.cloneDirectoryCoW(srcDir, destDir);
       hydrationMethod = method;
       hydratedDirs.push(dirName);
     }
     for (const envName of _CoWWorktreeManager.ENV_FILES) {
-      const srcEnv = path9.join(this.coordDb.repoRoot, envName);
-      const destEnv = path9.join(worktreePath, envName);
+      const srcEnv = path10.join(this.coordDb.repoRoot, envName);
+      const destEnv = path10.join(worktreePath, envName);
       if (fs11.existsSync(srcEnv) && !fs11.existsSync(destEnv)) {
         fs11.copyFileSync(srcEnv, destEnv);
       }
@@ -3342,7 +3364,7 @@ var CoWWorktreeManager = class _CoWWorktreeManager {
   removeWorktree(agentId) {
     this.fencing.assertSession(agentId);
     const safeId = agentId.replace(/[^a-zA-Z0-9_-]/g, "-");
-    const worktreePath = path9.join(this.coordDb.coordDir, "worktrees", safeId);
+    const worktreePath = path10.join(this.coordDb.coordDir, "worktrees", safeId);
     if (!fs11.existsSync(worktreePath)) return false;
     const registered = this.fencing.getAgent(agentId)?.worktree_path;
     if (!registered || physicalPath(registered) !== physicalPath(worktreePath) || this.fencing.listAgents(true).some((agent) => agent.id !== agentId && agent.worktree_path && physicalPath(agent.worktree_path) === physicalPath(worktreePath))) {
@@ -3433,7 +3455,7 @@ var KithEngine = class {
     const file = LockEngine.normalizeFile(targetRoot, params.filePath);
     const access = this.locks.checkFileWriteAccess({ agentId: params.agentId, filePath: file });
     if (!access.allowed) throw new Error(access.reason);
-    const content = params.content ?? (fs12.existsSync(path10.join(targetRoot, file)) ? fs12.readFileSync(path10.join(targetRoot, file), "utf8") : "");
+    const content = params.content ?? (fs12.existsSync(path11.join(targetRoot, file)) ? fs12.readFileSync(path11.join(targetRoot, file), "utf8") : "");
     const contractReport = this.depGraph.recordFileModification(
       params.agentId,
       file,
@@ -3573,7 +3595,7 @@ ${lines.join("\n")}` : "";
 // src/core/observation.ts
 import fs13 from "fs";
 import os from "os";
-import path11 from "path";
+import path12 from "path";
 import { createRequire as createRequire2 } from "module";
 var { DatabaseSync: DatabaseSync2 } = createRequire2(import.meta.url)("node:sqlite");
 function readCoordinationState(directory = process.cwd()) {
@@ -3601,16 +3623,16 @@ function readCoordinationState(directory = process.cwd()) {
   };
   let scratch, db;
   try {
-    const file = path11.join(layout.coordDir, "state.db");
+    const file = path12.join(layout.coordDir, "state.db");
     if (physicalPath(layout.coordDir) !== layout.coordDir || physicalPath(file) !== file) throw new Error("Coordination state must not be a symlink");
-    for (let current = fs13.realpathSync.native(directory); isWithin(layout.checkoutRoot, current); current = path11.dirname(current)) {
-      const local = path11.join(current, ".coord");
-      if (local !== layout.coordDir && fs13.existsSync(path11.join(local, "state.db"))) throw new Error(`Legacy independent state at ${local}; preserve it before consolidation`);
+    for (let current = fs13.realpathSync.native(directory); isWithin(layout.checkoutRoot, current); current = path12.dirname(current)) {
+      const local = path12.join(current, ".coord");
+      if (local !== layout.coordDir && fs13.existsSync(path12.join(local, "state.db"))) throw new Error(`Legacy independent state at ${local}; preserve it before consolidation`);
       if (current === layout.checkoutRoot) break;
     }
     if (!fs13.existsSync(file)) {
-      if (["setup.lock", "merge-train.lock"].some((name) => fs13.existsSync(path11.join(layout.coordDir, name))) || ["-wal", "-shm", "-journal"].some((s) => fs13.existsSync(file + s)) || ["worktrees", "quarantine", "snapshots", "shadow-index", "setup"].some((name) => {
-        const p = path11.join(layout.coordDir, name);
+      if (["setup.lock", "merge-train.lock"].some((name) => fs13.existsSync(path12.join(layout.coordDir, name))) || ["-wal", "-shm", "-journal"].some((s) => fs13.existsSync(file + s)) || ["worktrees", "quarantine", "snapshots", "shadow-index", "setup"].some((name) => {
+        const p = path12.join(layout.coordDir, name);
         return fs13.existsSync(p) && (!fs13.lstatSync(p).isDirectory() || fs13.readdirSync(p).length > 0);
       })) throw new Error("Missing database with retained sidecars; preserve the recovery set");
       return empty;
@@ -3623,14 +3645,14 @@ function readCoordinationState(directory = process.cwd()) {
       return [s.dev, s.ino, s.size, s.mtimeNs, s.ctimeNs].join(":");
     };
     const before = files.map(identity);
-    scratch = fs13.mkdtempSync(path11.join(os.tmpdir(), "kith-observe-"));
+    scratch = fs13.mkdtempSync(path12.join(os.tmpdir(), "kith-observe-"));
     for (let i = 0; i < files.length; i++) if (before[i]) {
-      const target = path11.join(scratch, path11.basename(files[i]));
+      const target = path12.join(scratch, path12.basename(files[i]));
       fs13.copyFileSync(files[i], target);
       fs13.chmodSync(target, 384);
     }
     if (JSON.stringify(before) !== JSON.stringify(files.map(identity))) throw new Error("Coordination state changed during snapshot; stop writers or retry");
-    db = new DatabaseSync2(path11.join(scratch, "state.db"), { readOnly: true });
+    db = new DatabaseSync2(path12.join(scratch, "state.db"), { readOnly: true });
     db.exec("PRAGMA query_only=ON; PRAGMA busy_timeout=1000; BEGIN");
     if (CoordDatabase.inspectSchema(db) !== 2) throw new Error("Offline observation requires schema 2; preserve state and upgrade with clients stopped");
     const all = (sql) => db.prepare(sql).all();
@@ -3662,19 +3684,19 @@ function readCoordinationState(directory = process.cwd()) {
   }
 }
 function recoveryReport(directory = process.cwd()) {
-  const state = readCoordinationState(directory), retainedRoot = path11.join(state.repository.coordDir, "worktrees");
+  const state = readCoordinationState(directory), retainedRoot = path12.join(state.repository.coordDir, "worktrees");
   const retained = physicalPath(retainedRoot) === retainedRoot && fs13.existsSync(retainedRoot) && fs13.lstatSync(retainedRoot).isDirectory() && !fs13.lstatSync(retainedRoot).isSymbolicLink() ? fs13.readdirSync(retainedRoot, { withFileTypes: true }).map((entry) => ({
-    path: path11.join(retainedRoot, entry.name),
+    path: path12.join(retainedRoot, entry.name),
     symlink: entry.isSymbolicLink(),
-    agentIds: state.agents.filter((a) => a.worktree_path === path11.join(retainedRoot, entry.name)).map((a) => a.id)
+    agentIds: state.agents.filter((a) => a.worktree_path === path12.join(retainedRoot, entry.name)).map((a) => a.id)
   })) : [];
   return {
     ...state,
     retainedWorktrees: retained,
     expiredClaims: state.locks.filter((lock) => Number(lock.expires_at) <= state.observedAt),
     unfinishedIntegrations: state.mergeQueue.filter((entry) => entry.status !== "merged"),
-    setupLock: { path: path11.join(state.repository.coordDir, "setup.lock"), present: fs13.existsSync(path11.join(state.repository.coordDir, "setup.lock")) },
-    integrationLock: { path: path11.join(state.repository.coordDir, "merge-train.lock"), present: fs13.existsSync(path11.join(state.repository.coordDir, "merge-train.lock")) }
+    setupLock: { path: path12.join(state.repository.coordDir, "setup.lock"), present: fs13.existsSync(path12.join(state.repository.coordDir, "setup.lock")) },
+    integrationLock: { path: path12.join(state.repository.coordDir, "merge-train.lock"), present: fs13.existsSync(path12.join(state.repository.coordDir, "merge-train.lock")) }
   };
 }
 export {