kith-coord 0.1.6 → 0.1.7

package/dist/command-worker.js

@@ -1,3 +1,5 @@
+import { createRequire as __kithRequire } from 'node:module'; const require = __kithRequire(import.meta.url);
+
 // src/core/command-worker.ts
 import os from "os";
 import { spawn } from "child_process";

package/dist/command-worker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/command-worker.ts"],"sourcesContent":["// A detached process-group leader. The command cannot start until its supervisor\n// has durably recorded this group and sent the start message over private IPC.\nimport os from 'node:os';\nimport { spawn } from 'node:child_process';\n\nlet started = false;\nprocess.on('disconnect', () => {\n  try { process.kill(-process.pid, 'SIGKILL'); } catch { process.exit(1); }\n});\nprocess.once('message', (message: { command: string | string[]; cwd: string; mutexName: string; env?: Record<string, string> }) => {\n  if (started) return;\n  started = true;\n  let finished = false;\n  const env = { ...process.env, ...message.env, ...(message.mutexName === 'package-install' ? { KITH_PACKAGE_INSTALL_GUARDED: '1' } : {}) };\n  const child = Array.isArray(message.command)\n    ? spawn(message.command[0], message.command.slice(1), { cwd: message.cwd, env, stdio: ['ignore', 'inherit', 'inherit'] })\n    : spawn(message.command, { cwd: message.cwd, env, stdio: ['ignore', 'inherit', 'inherit'], shell: true });\n  child.once('error', (err) => {\n    if (finished) return;\n    finished = true;\n    process.send?.({ error: err.message }, () => process.exit(1));\n  });\n  child.once('close', (code, signal) => {\n    if (finished) return;\n    finished = true;\n    if (process.connected) process.send?.({ exitCode: code ?? (signal ? 128 + (os.constants.signals[signal] ?? 1) : 1), signal }, () => process.exit(0));\n  });\n});\nprocess.send?.({ ready: true });\n"],"mappings":";AAEA,OAAO,QAAQ;AACf,SAAS,aAAa;AAEtB,IAAI,UAAU;AACd,QAAQ,GAAG,cAAc,MAAM;AAC7B,MAAI;AAAE,YAAQ,KAAK,CAAC,QAAQ,KAAK,SAAS;AAAA,EAAG,QAAQ;AAAE,YAAQ,KAAK,CAAC;AAAA,EAAG;AAC1E,CAAC;AACD,QAAQ,KAAK,WAAW,CAAC,YAA0G;AACjI,MAAI,QAAS;AACb,YAAU;AACV,MAAI,WAAW;AACf,QAAM,MAAM,EAAE,GAAG,QAAQ,KAAK,GAAG,QAAQ,KAAK,GAAI,QAAQ,cAAc,oBAAoB,EAAE,8BAA8B,IAAI,IAAI,CAAC,EAAG;AACxI,QAAM,QAAQ,MAAM,QAAQ,QAAQ,OAAO,IACvC,MAAM,QAAQ,QAAQ,CAAC,GAAG,QAAQ,QAAQ,MAAM,CAAC,GAAG,EAAE,KAAK,QAAQ,KAAK,KAAK,OAAO,CAAC,UAAU,WAAW,SAAS,EAAE,CAAC,IACtH,MAAM,QAAQ,SAAS,EAAE,KAAK,QAAQ,KAAK,KAAK,OAAO,CAAC,UAAU,WAAW,SAAS,GAAG,OAAO,KAAK,CAAC;AAC1G,QAAM,KAAK,SAAS,CAAC,QAAQ;AAC3B,QAAI,SAAU;AACd,eAAW;AACX,YAAQ,OAAO,EAAE,OAAO,IAAI,QAAQ,GAAG,MAAM,QAAQ,KAAK,CAAC,CAAC;AAAA,EAC9D,CAAC;AACD,QAAM,KAAK,SAAS,CAAC,MAAM,WAAW;AACpC,QAAI,SAAU;AACd,eAAW;AACX,QAAI,QAAQ,UAAW,SAAQ,OAAO,EAAE,UAAU,SAAS,SAAS,OAAO,GAAG,UAAU,QAAQ,MAAM,KAAK,KAAK,IAAI,OAAO,GAAG,MAAM,QAAQ,KAAK,CAAC,CAAC;AAAA,EACrJ,CAAC;AACH,CAAC;AACD,QAAQ,OAAO,EAAE,OAAO,KAAK,CAAC;","names":[]}
+{"version":3,"sources":["../src/core/command-worker.ts"],"sourcesContent":["// A detached process-group leader. The command cannot start until its supervisor\n// has durably recorded this group and sent the start message over private IPC.\nimport os from 'node:os';\nimport { spawn } from 'node:child_process';\n\nlet started = false;\nprocess.on('disconnect', () => {\n  try { process.kill(-process.pid, 'SIGKILL'); } catch { process.exit(1); }\n});\nprocess.once('message', (message: { command: string | string[]; cwd: string; mutexName: string; env?: Record<string, string> }) => {\n  if (started) return;\n  started = true;\n  let finished = false;\n  const env = { ...process.env, ...message.env, ...(message.mutexName === 'package-install' ? { KITH_PACKAGE_INSTALL_GUARDED: '1' } : {}) };\n  const child = Array.isArray(message.command)\n    ? spawn(message.command[0], message.command.slice(1), { cwd: message.cwd, env, stdio: ['ignore', 'inherit', 'inherit'] })\n    : spawn(message.command, { cwd: message.cwd, env, stdio: ['ignore', 'inherit', 'inherit'], shell: true });\n  child.once('error', (err) => {\n    if (finished) return;\n    finished = true;\n    process.send?.({ error: err.message }, () => process.exit(1));\n  });\n  child.once('close', (code, signal) => {\n    if (finished) return;\n    finished = true;\n    if (process.connected) process.send?.({ exitCode: code ?? (signal ? 128 + (os.constants.signals[signal] ?? 1) : 1), signal }, () => process.exit(0));\n  });\n});\nprocess.send?.({ ready: true });\n"],"mappings":";;;AAEA,OAAO,QAAQ;AACf,SAAS,aAAa;AAEtB,IAAI,UAAU;AACd,QAAQ,GAAG,cAAc,MAAM;AAC7B,MAAI;AAAE,YAAQ,KAAK,CAAC,QAAQ,KAAK,SAAS;AAAA,EAAG,QAAQ;AAAE,YAAQ,KAAK,CAAC;AAAA,EAAG;AAC1E,CAAC;AACD,QAAQ,KAAK,WAAW,CAAC,YAA0G;AACjI,MAAI,QAAS;AACb,YAAU;AACV,MAAI,WAAW;AACf,QAAM,MAAM,EAAE,GAAG,QAAQ,KAAK,GAAG,QAAQ,KAAK,GAAI,QAAQ,cAAc,oBAAoB,EAAE,8BAA8B,IAAI,IAAI,CAAC,EAAG;AACxI,QAAM,QAAQ,MAAM,QAAQ,QAAQ,OAAO,IACvC,MAAM,QAAQ,QAAQ,CAAC,GAAG,QAAQ,QAAQ,MAAM,CAAC,GAAG,EAAE,KAAK,QAAQ,KAAK,KAAK,OAAO,CAAC,UAAU,WAAW,SAAS,EAAE,CAAC,IACtH,MAAM,QAAQ,SAAS,EAAE,KAAK,QAAQ,KAAK,KAAK,OAAO,CAAC,UAAU,WAAW,SAAS,GAAG,OAAO,KAAK,CAAC;AAC1G,QAAM,KAAK,SAAS,CAAC,QAAQ;AAC3B,QAAI,SAAU;AACd,eAAW;AACX,YAAQ,OAAO,EAAE,OAAO,IAAI,QAAQ,GAAG,MAAM,QAAQ,KAAK,CAAC,CAAC;AAAA,EAC9D,CAAC;AACD,QAAM,KAAK,SAAS,CAAC,MAAM,WAAW;AACpC,QAAI,SAAU;AACd,eAAW;AACX,QAAI,QAAQ,UAAW,SAAQ,OAAO,EAAE,UAAU,SAAS,SAAS,OAAO,GAAG,UAAU,QAAQ,MAAM,KAAK,KAAK,IAAI,OAAO,GAAG,MAAM,QAAQ,KAAK,CAAC,CAAC;AAAA,EACrJ,CAAC;AACH,CAAC;AACD,QAAQ,OAAO,EAAE,OAAO,KAAK,CAAC;","names":[]}

package/dist/index.d.ts

@@ -685,10 +685,12 @@ declare class IntentAndTaskEngine {
      * Orchestrator Mode: Atomically claims the highest-priority unblocked task whose scope locks are available.
      */
     claimNextTask(agentId: string): {
+        ok: boolean;
         claimed: boolean;
         task: TaskRecord | null;
         fencingToken: number | null;
         locks: LockRecord[];
+        activeSiblingIntents: TaskRecord[];
         reason?: string;
     };
     completeTask(params: {
@@ -703,6 +705,51 @@ declare class IntentAndTaskEngine {
     }): TaskRecord[];
 }
 
+interface LinkedWorkspaceContract {
+    alias: string;
+    sourceRepo: string;
+    sourceRepoName: string;
+    filePath: string;
+    absolutePath: string;
+    symbols: Array<{
+        symbolName: string;
+        kind: ExtractedSymbol['kind'];
+        signature: string;
+        astHash: string;
+    }>;
+    dirtyInCheckout: boolean | null;
+    exportsComplete: boolean;
+    ownershipAvailable: boolean;
+    lockedByAgent: string | null;
+    activeWorktreeDrifts: Array<{
+        agentId: string;
+        worktreePath: string;
+        changedSymbols: string[];
+        removedSymbols: string[];
+    }>;
+}
+interface WorkspaceContractReport {
+    linkedContracts: LinkedWorkspaceContract[];
+    warnings: string[];
+    complete: boolean;
+}
+interface SwarmPrompts {
+    architect: string;
+    worker: string;
+}
+declare function buildSwarmPrompts(repoRoot: string): SwarmPrompts;
+/** Inspect explicit local TS/JS path aliases, never arbitrary directories or a global file crawl.
+ * Wildcards are resolved against concrete imports at edit time, not unioned across a folder.
+ * This is advisory static inspection, not a compiler or a cross-language compatibility verdict.
+ */
+declare function inspectWorkspaceContracts(repoRoot: string, worktreeDir?: string, imports?: string[]): WorkspaceContractReport;
+declare function verifyCrossRepoImportsForFile(params: {
+    repoRoot: string;
+    worktreeDir?: string;
+    filePath: string;
+    content: string;
+}): string[];
+
 interface AgentUnreadDelta {
     events: CoordEvent[];
     activeConflicts: ConflictRecord[];
@@ -760,6 +807,9 @@ declare class KithEngine {
         tasks: TaskRecord[];
         conflicts: ConflictRecord[];
         contracts: ContractRecord[];
+        linkedContracts: LinkedWorkspaceContract[];
+        crossRepoWarnings: string[];
+        crossRepoComplete: boolean;
         resources: ResourceRecord[];
         mergeQueue: MergeTrainEntry[];
         quarantined: QuarantineRecord[];
@@ -796,6 +846,9 @@ declare class KithEngine {
         isolateWorktree?: boolean;
     }): {
         worktree: SpawnedWorktree | null;
+        linkedContracts: LinkedWorkspaceContract[];
+        crossRepoWarnings: string[];
+        crossRepoComplete: boolean;
         ok: boolean;
         task: TaskRecord | null;
         fencingToken: number;
@@ -803,11 +856,54 @@ declare class KithEngine {
         lockConflicts: LockConflict[];
         activeSiblingIntents: TaskRecord[];
     };
+    claimNextTask(params: {
+        agentId: string;
+        isolateWorktree?: boolean;
+    }): {
+        worktree: SpawnedWorktree | null;
+        publishedContracts: ContractRecord[];
+        linkedContracts: LinkedWorkspaceContract[];
+        crossRepoWarnings: string[];
+        crossRepoComplete: boolean;
+        ok: boolean;
+        claimed: boolean;
+        task: TaskRecord | null;
+        fencingToken: number | null;
+        locks: LockRecord[];
+        activeSiblingIntents: TaskRecord[];
+        reason?: string;
+    };
+    private claimWorktree;
+    claimNextTaskWhenAvailable(params: {
+        agentId: string;
+        isolateWorktree?: boolean;
+        waitTimeoutMs: number;
+        signal?: AbortSignal;
+    }): Promise<{
+        worktree: SpawnedWorktree | null;
+        publishedContracts: ContractRecord[];
+        linkedContracts: LinkedWorkspaceContract[];
+        crossRepoWarnings: string[];
+        crossRepoComplete: boolean;
+        ok: boolean;
+        claimed: boolean;
+        task: TaskRecord | null;
+        fencingToken: number | null;
+        locks: LockRecord[];
+        activeSiblingIntents: TaskRecord[];
+        reason?: string;
+    } & {
+        waitedMs: number;
+        waitTimedOut: boolean;
+    }>;
     beginWorkWhenAvailable(params: Parameters<KithEngine['beginWork']>[0] & {
         waitTimeoutMs: number;
         signal?: AbortSignal;
     }): Promise<{
         worktree: SpawnedWorktree | null;
+        linkedContracts: LinkedWorkspaceContract[];
+        crossRepoWarnings: string[];
+        crossRepoComplete: boolean;
         ok: boolean;
         task: TaskRecord | null;
         fencingToken: number;
@@ -865,6 +961,7 @@ 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, options?: {
     ownersOnly?: boolean;
+    coordinationOnly?: boolean;
 }): {
     protocolVersion: string;
     observedAt: number;
@@ -878,6 +975,9 @@ declare function readCoordinationState(directory?: string, options?: {
     };
     state: "ready" | "missing" | "unavailable";
     error: string | undefined;
+    sessionEpochs: Record<string, number>;
+    truncated: boolean;
+    schemaVersion: number;
     fencingEpoch: number;
     agents: AgentRecord[];
     tasks: Record<string, unknown>[];
@@ -893,6 +993,7 @@ declare function readCoordinationState(directory?: string, options?: {
     workspaces: ReturnType<typeof observeWorkspaces>;
 } | {
     state: "ready";
+    schemaVersion: number;
     fencingEpoch: number;
     agents: AgentRecord[];
     tasks: {
@@ -926,6 +1027,42 @@ declare function readCoordinationState(directory?: string, options?: {
         node: string;
     };
     error: string | undefined;
+    sessionEpochs: Record<string, number>;
+    truncated: boolean;
+} | {
+    state: "ready";
+    schemaVersion: number;
+    agents: AgentRecord[];
+    sessionEpochs: {
+        [k: string]: number;
+    };
+    tasks: {
+        depends_on: any;
+        scope_globs: any;
+    }[];
+    locks: Record<string, unknown>[];
+    resources: Record<string, unknown>[];
+    mutexWaiters: Record<string, unknown>[];
+    commandGuards: Record<string, unknown>[];
+    mergeQueue: Record<string, unknown>[];
+    truncated: boolean;
+    protocolVersion: string;
+    observedAt: number;
+    repository: {
+        root: string;
+        commonGitDir: string | null;
+        coordDir: string;
+    };
+    runtime: {
+        node: string;
+    };
+    error: string | undefined;
+    fencingEpoch: number;
+    conflicts: Record<string, unknown>[];
+    contracts: Record<string, unknown>[];
+    quarantined: Record<string, unknown>[];
+    events: Record<string, unknown>[];
+    workspaces: ReturnType<typeof observeWorkspaces>;
 };
 /** Recovery is an inspection report: it never clears guards, expires claims, deletes worktrees or restores files. */
 declare function recoveryReport(directory?: string): {
@@ -956,6 +1093,9 @@ declare function recoveryReport(directory?: string): {
     };
     state: "ready" | "missing" | "unavailable";
     error: string | undefined;
+    sessionEpochs: Record<string, number>;
+    truncated: boolean;
+    schemaVersion: number;
     fencingEpoch: number;
     agents: AgentRecord[];
     tasks: Record<string, unknown>[];
@@ -986,6 +1126,7 @@ declare function recoveryReport(directory?: string): {
         present: boolean;
     };
     state: "ready";
+    schemaVersion: number;
     fencingEpoch: number;
     agents: AgentRecord[];
     tasks: {
@@ -1019,9 +1160,60 @@ declare function recoveryReport(directory?: string): {
         node: string;
     };
     error: string | undefined;
+    sessionEpochs: Record<string, number>;
+    truncated: boolean;
+} | {
+    retainedWorktrees: {
+        path: string;
+        symlink: boolean;
+        agentIds: string[];
+    }[];
+    expiredClaims: Record<string, unknown>[];
+    unfinishedIntegrations: Record<string, unknown>[];
+    setupLock: {
+        path: string;
+        present: boolean;
+    };
+    integrationLock: {
+        path: string;
+        present: boolean;
+    };
+    state: "ready";
+    schemaVersion: number;
+    agents: AgentRecord[];
+    sessionEpochs: {
+        [k: string]: number;
+    };
+    tasks: {
+        depends_on: any;
+        scope_globs: any;
+    }[];
+    locks: Record<string, unknown>[];
+    resources: Record<string, unknown>[];
+    mutexWaiters: Record<string, unknown>[];
+    commandGuards: Record<string, unknown>[];
+    mergeQueue: Record<string, unknown>[];
+    truncated: boolean;
+    protocolVersion: string;
+    observedAt: number;
+    repository: {
+        root: string;
+        commonGitDir: string | null;
+        coordDir: string;
+    };
+    runtime: {
+        node: string;
+    };
+    error: string | undefined;
+    fencingEpoch: number;
+    conflicts: Record<string, unknown>[];
+    contracts: Record<string, unknown>[];
+    quarantined: Record<string, unknown>[];
+    events: Record<string, unknown>[];
+    workspaces: ReturnType<typeof observeWorkspaces>;
 };
 
-declare const KITH_VERSION = "0.1.6";
-declare const KITH_PROTOCOL_VERSION = "1.4.0";
+declare const KITH_VERSION = "0.1.7";
+declare const KITH_PROTOCOL_VERSION = "1.5.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 };
+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 LinkedWorkspaceContract, 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 SwarmPrompts, type SymbolKind, type TaskRecord, type WorkspaceContractReport, type WorkspaceObservation, type WorktreeChange, buildSwarmPrompts, caseSensitivePaths, discoverRepository, inspectWorkspaceContracts, isWithin, observeWorkspaces, physicalPath, previewIntegration, readCoordinationState, recoveryReport, repositoryFile, verifyCrossRepoImportsForFile, worktreeChanges };