kith-coord 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -863,7 +863,9 @@ declare function discoverRepository(input: string): RepositoryLayout;
 declare function caseSensitivePaths(root: string): boolean;
 
 /** Copies a consistent stopped-state set before opening SQLite, so even SHM reconstruction cannot touch original recovery files. */
-declare function readCoordinationState(directory?: string): {
+declare function readCoordinationState(directory?: string, options?: {
+    ownersOnly?: boolean;
+}): {
     protocolVersion: string;
     observedAt: number;
     repository: {
@@ -1019,7 +1021,7 @@ declare function recoveryReport(directory?: string): {
     error: string | undefined;
 };
 
-declare const KITH_VERSION = "0.1.4";
-declare const KITH_PROTOCOL_VERSION = "1.3.0";
+declare const KITH_VERSION = "0.1.6";
+declare const KITH_PROTOCOL_VERSION = "1.4.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 SupervisedCommandOptions, type SymbolKind, type TaskRecord, type WorkspaceObservation, type WorktreeChange, caseSensitivePaths, discoverRepository, isWithin, observeWorkspaces, physicalPath, previewIntegration, readCoordinationState, recoveryReport, repositoryFile, worktreeChanges };

package/dist/index.js

@@ -30,8 +30,8 @@ async function waitForClaim(params) {
 }
 
 // src/version.ts
-var KITH_VERSION = "0.1.4";
-var KITH_PROTOCOL_VERSION = "1.3.0";
+var KITH_VERSION = "0.1.6";
+var KITH_PROTOCOL_VERSION = "1.4.0";
 
 // src/core/workspace-observation.ts
 import { execFileSync as execFileSync2, spawnSync } from "child_process";
@@ -1725,7 +1725,7 @@ var ResourceBroker = class _ResourceBroker {
           worker.once("error", reject);
         }), stopped]);
         if (params.signal?.aborted) failure ??= abortError();
-        if (failure) throw failure;
+        if (failure) throw Object.assign(failure, { stdout: Buffer.concat(stdout).toString(), stderr: Buffer.concat(stderr).toString() });
         if (!outcome) throw new Error("Command worker exited without a result");
         if (outcome.error) throw new Error(outcome.error);
         return { stdout: Buffer.concat(stdout).toString(), stderr: Buffer.concat(stderr).toString(), exitCode: outcome.exitCode, waitedMs };
@@ -1941,7 +1941,7 @@ var CoordDatabase = class _CoordDatabase {
     }
     if (!tables.some((table) => table.name === "meta")) throw new Error("Missing coordination schema metadata. Preserve the database before repair.");
     const row = db.prepare("SELECT value FROM meta WHERE key='schema_version'").get();
-    if (row?.value !== "1" && row?.value !== "2") {
+    if (row?.value !== "1" && row?.value !== "2" && row?.value !== "3") {
       throw new Error(`Unsupported coordination schema version: ${String(row?.value)}. Preserve the database before upgrading or repairing it.`);
     }
     const version = Number(row.value);
@@ -1956,7 +1956,8 @@ var CoordDatabase = class _CoordDatabase {
       "resources",
       "quarantine",
       "events",
-      ...version === 2 ? ["agent_sessions", "mutex_waiters", "mutex_runs"] : []
+      ...version >= 2 ? ["agent_sessions", "mutex_waiters", "mutex_runs"] : [],
+      ...version >= 3 ? ["mcp_operations"] : []
     ];
     if (required.some((name) => !tables.some((table) => table.name === name))) {
       throw new Error("Incomplete coordination schema. Preserve the database before repair.");
@@ -1966,11 +1967,12 @@ var CoordDatabase = class _CoordDatabase {
       tasks: "status,owner_agent_id,fencing_token,scope_globs_json,depends_on_json",
       locks: "owner_agent_id,pattern,mode,fencing_token,expires_at",
       resources: "type,name,owner_agent_id,fencing_token,expires_at",
-      ...version === 2 ? {
+      ...version >= 2 ? {
         agent_sessions: "agent_id,token_hash,epoch",
         mutex_waiters: "ticket,mutex_name,request_id,owner_agent_id,session_epoch,waiter_pid,waiter_start,expires_at",
         mutex_runs: "mutex_name,run_id,owner_agent_id,session_epoch,fencing_token,supervisor_pid,supervisor_start,worker_pid,worker_start"
-      } : {}
+      } : {},
+      ...version >= 3 ? { mcp_operations: "operation_key,request_hash,agent_id,session_epoch,capability_hash,owner_pid,owner_start,result_json,created_at" } : {}
     };
     for (const [table, fields] of Object.entries(columns)) {
       try {
@@ -1985,7 +1987,8 @@ var CoordDatabase = class _CoordDatabase {
       "SELECT fencing_token FROM tasks",
       "SELECT fencing_token FROM resources",
       "SELECT fencing_token FROM merge_queue",
-      ...version === 2 ? ["SELECT epoch FROM agent_sessions", "SELECT session_epoch FROM mutex_waiters", "SELECT fencing_token FROM mutex_runs"] : []
+      ...version >= 2 ? ["SELECT epoch FROM agent_sessions", "SELECT session_epoch FROM mutex_waiters", "SELECT fencing_token FROM mutex_runs"] : [],
+      ...version >= 3 ? ["SELECT session_epoch FROM mcp_operations"] : []
     ];
     if (db.prepare(`SELECT 1 FROM (${tokens.join(" UNION ALL ")}) WHERE token IS NOT NULL AND (typeof(token)!='integer' OR token<0 OR token>?) LIMIT 1`).get(epoch)) {
       throw new Error("Invalid or regressed fencing counter. Preserve the database before repair.");
@@ -2163,6 +2166,14 @@ var CoordDatabase = class _CoordDatabase {
           worker_pid INTEGER, worker_start TEXT
         );
       `);
+      this.db.exec(`
+        CREATE TABLE IF NOT EXISTS mcp_operations (
+          operation_key TEXT PRIMARY KEY, request_hash TEXT NOT NULL,
+          agent_id TEXT NOT NULL, session_epoch INTEGER NOT NULL, capability_hash TEXT NOT NULL,
+          owner_pid INTEGER NOT NULL, owner_start TEXT NOT NULL,
+          result_json TEXT, created_at INTEGER NOT NULL
+        );
+      `);
       if (version < 2) {
         this.db.exec(`
           UPDATE tasks SET status='queued', owner_agent_id=NULL, fencing_token=NULL
@@ -2174,6 +2185,7 @@ var CoordDatabase = class _CoordDatabase {
           UPDATE meta SET value='2' WHERE key='schema_version';
         `);
       }
+      this.db.exec("UPDATE meta SET value='3' WHERE key='schema_version'");
     });
   }
   /**
@@ -3699,7 +3711,7 @@ import os from "os";
 import path12 from "path";
 import { createRequire as createRequire2 } from "module";
 var { DatabaseSync: DatabaseSync2 } = createRequire2(import.meta.url)("node:sqlite");
-function readCoordinationState(directory = process.cwd()) {
+function readCoordinationState(directory = process.cwd(), options = {}) {
   const layout = discoverRepository(directory), observedAt = Date.now();
   const empty = {
     protocolVersion: KITH_PROTOCOL_VERSION,
@@ -3755,9 +3767,13 @@ function readCoordinationState(directory = process.cwd()) {
     if (JSON.stringify(before) !== JSON.stringify(files.map(identity))) throw new Error("Coordination state changed during snapshot; stop writers or retry");
     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");
+    if (CoordDatabase.inspectSchema(db) < 2) throw new Error("Offline observation requires schema 2 or newer; preserve state and upgrade with clients stopped");
     const all = (sql) => db.prepare(sql).all();
     const agents = all("SELECT * FROM agents ORDER BY registered_at DESC");
+    if (options.ownersOnly) {
+      db.exec("COMMIT");
+      return { ...empty, state: "ready", agents };
+    }
     const state = {
       ...empty,
       state: "ready",