@wrongstack/core 0.305.0 → 0.306.0

package/dist/chronicle/project-server.js

@@ -2,10 +2,10 @@
 
 // src/chronicle/project-server.ts
 import { randomBytes } from "node:crypto";
-import * as fs10 from "node:fs";
 import * as fsp4 from "node:fs/promises";
 import * as net from "node:net";
 import * as path15 from "node:path";
+import { bindProjectEndpoint } from "@wrongstack/persistence";
 
 // src/utils/atomic-write.ts
 import {
@@ -2923,13 +2923,6 @@ import * as fs7 from "node:fs";
 import { createRequire } from "node:module";
 import * as path12 from "node:path";
 
-// src/utils/socket-path.ts
-import {
-  assertUnixSocketPathWithinLimit,
-  checkUnixSocketPath,
-  unixSocketPathLimit
-} from "@wrongstack/persistence";
-
 // src/chronicle/sqlite-query.ts
 var MAX_LIMIT = 1e4;
 function encodeCursor2(cursor) {
@@ -4766,7 +4759,6 @@ function normalizePathKey(value) {
 
 // src/chronicle/project-server-endpoint.ts
 import { createHash as createHash5 } from "node:crypto";
-import * as fs9 from "node:fs";
 import * as os3 from "node:os";
 import * as path14 from "node:path";
 
@@ -4802,12 +4794,6 @@ function chronicleProjectServerEndpoint(projectDir) {
 function chronicleProjectServerMetadataPath(projectDir) {
   return path14.join(projectDir, "chronicle", CHRONICLE_PROJECT_SERVER_METADATA_FILE);
 }
-function ensureChronicleProjectServerSocketDirectory(endpoint2) {
-  if (process.platform !== "win32") {
-    assertUnixSocketPathWithinLimit(endpoint2, "chronicle");
-    fs9.mkdirSync(path14.dirname(endpoint2), { recursive: true, mode: 448 });
-  }
-}
 
 // src/chronicle/project-server.ts
 var DEFAULT_IDLE_MS = 5 * 6e4;
@@ -5264,7 +5250,6 @@ async function stop(_reason) {
   });
   await stopMemoryWatchdog();
 }
-ensureChronicleProjectServerSocketDirectory(endpoint);
 var server = net.createServer((socket) => {
   if (stopping) {
     socket.destroy();
@@ -5284,42 +5269,28 @@ var server = net.createServer((socket) => {
     scheduleIdleStop();
   });
 });
-var probingExistingEndpoint = false;
-function listenForOwnership() {
-  server.listen(endpoint);
-}
-server.on("error", (error) => {
-  if (error.code === "EADDRINUSE" && process.platform === "win32") {
+void (async () => {
+  const bind = await bindProjectEndpoint({ server, endpoint, service: "chronicle" });
+  if (bind.outcome === "already-owned") {
     process.exitCode = 0;
     return;
   }
-  if (error.code === "EADDRINUSE" && !probingExistingEndpoint) {
-    probingExistingEndpoint = true;
-    const probe = net.createConnection(endpoint);
-    probe.once("connect", () => {
-      probe.destroy();
-      process.exitCode = 0;
-    });
-    probe.once("error", () => {
-      probe.destroy();
-      try {
-        fs10.rmSync(endpoint, { force: true });
-      } catch {
-      }
-      probingExistingEndpoint = false;
-      listenForOwnership();
-    });
+  if (bind.outcome === "failed") {
+    process.stderr.write(`chronicle project server failed: ${bind.error.message}
+`);
+    process.exitCode = 1;
     return;
   }
-  process.exitCode = 1;
-});
-server.on("listening", () => {
-  if (process.platform !== "win32") {
-    try {
-      fs10.chmodSync(endpoint, 384);
-    } catch {
-    }
+  if (bind.reclaimedStaleEndpoint) {
+    process.stderr.write(`chronicle project server reclaimed stale endpoint ${endpoint}
+`);
   }
+  server.on("error", (error) => {
+    if (stopping) return;
+    process.stderr.write(`chronicle project server error: ${error.message}
+`);
+    process.exitCode = 1;
+  });
   void writeMetadata().then(() => markMetadataWritten?.());
   void startChronicleFileObserver({
     projectRoot: parsed.projectRoot,
@@ -5337,8 +5308,7 @@ server.on("listening", () => {
     watcherLastError = error instanceof Error ? error.message : String(error);
   });
   scheduleIdleStop();
-});
+})();
 process.once("SIGINT", () => void stop("SIGINT"));
 process.once("SIGTERM", () => void stop("SIGTERM"));
-listenForOwnership();
 //# sourceMappingURL=project-server.js.map

package/dist/coordination/agents/index.js

@@ -3650,6 +3650,7 @@ var TOOLS = {
     "glob",
     "search",
     "tree",
+    "diff",
     "write",
     "edit",
     "replace",
@@ -4681,7 +4682,7 @@ var VERIFY_AGENTS = [
       id: "e2e",
       name: "E2E",
       role: "e2e",
-      tools: [...TOOLS.build, "fetch", ...SPECIALIST_TOOLS.browser],
+      tools: [...TOOLS.build, "fetch", "e2e_plan", ...SPECIALIST_TOOLS.browser],
       prompt: agentPrompt("e2e")
     },
     budget: HEAVY_BUDGET,
@@ -5194,7 +5195,7 @@ var DOMAIN_AGENTS = [
       id: "designer",
       name: "Designer",
       role: "designer",
-      tools: [...TOOLS.docs],
+      tools: [...TOOLS.docs, "design"],
       prompt: agentPrompt("designer")
     },
     budget: MEDIUM_BUDGET,

package/dist/coordination/agents/types.d.ts

@@ -90,7 +90,7 @@ export declare const TOOLS: {
     /** Read + edit (no shell). For agents that write code/docs but don't run it. */
     readonly write: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "replace", "patch", "mailbox"];
     /** Full build loop: edit + run (lint/format/typecheck/test/bash). */
-    readonly build: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "replace", "patch", "bash", "exec", "lint", "format", "typecheck", "test", "mailbox"];
+    readonly build: readonly ["read", "grep", "glob", "search", "tree", "diff", "write", "edit", "replace", "patch", "bash", "exec", "lint", "format", "typecheck", "test", "mailbox"];
     /**
      * Version control.
      *

package/dist/coordination/index.d.ts

@@ -34,6 +34,7 @@ export type { MailboxCredentialVerifier, RedactedMailboxCredential, } from './ma
 export { redactMailboxCredential } from './mailbox-credential-store.js';
 export { CREDENTIAL_VERIFY_COOLDOWN_MS, CREDENTIAL_VERIFY_MAX_FAILURES, CREDENTIAL_VERIFY_WINDOW_MS, CredentialVerifyThrottle, credentialVerifyThrottle, } from './mailbox-credential-throttle.js';
 export { MailboxEventEmitter } from './mailbox-events.js';
+export { mailboxProjectServerEndpoint, mailboxProjectServerMetadataPath, } from './mailbox-project-server-endpoint.js';
 export { buildDownAlert, buildRecoveryAlert, type DownAlertInput, MAILBOX_HEALTH_DEFAULT_FAILURE_THRESHOLD, MAILBOX_HEALTH_DEFAULT_FROM, MAILBOX_HEALTH_DEFAULT_INTERVAL_MS, MAILBOX_HEALTH_DEFAULT_TIMEOUT_MS, type MailboxHealthEvent, MailboxHealthWatchdog, type MailboxHealthWatchdogOptions, type RecoveryAlertInput, validateWatchdogOptions, type WatchdogConfig, } from './mailbox-health.js';
 export { createMailboxHooks, type MailboxHooksOptions, } from './mailbox-hooks.js';
 export { authorizeMailboxBearerToken, authorizePersistedMailboxCredential, createMailboxHttpRouter, MAILBOX_HTTP_DEFAULT_MAX_AGE_MS, MAILBOX_HTTP_MAX_AGE_CEILING_MS, MAILBOX_HTTP_MAX_BODY_BYTES, MAILBOX_HTTP_RATE_LIMIT_PER_MINUTE, MAILBOX_HTTP_RATE_LIMIT_WINDOW_MS, type MailboxHttpAccessDecision, MailboxHttpRateLimiter, type MailboxHttpRouter, type MailboxHttpRouterOptions, } from './mailbox-http-router.js';

package/dist/coordination/index.js

@@ -4748,6 +4748,7 @@ var TOOLS = {
     "glob",
     "search",
     "tree",
+    "diff",
     "write",
     "edit",
     "replace",
@@ -5779,7 +5780,7 @@ var VERIFY_AGENTS = [
       id: "e2e",
       name: "E2E",
       role: "e2e",
-      tools: [...TOOLS.build, "fetch", ...SPECIALIST_TOOLS.browser],
+      tools: [...TOOLS.build, "fetch", "e2e_plan", ...SPECIALIST_TOOLS.browser],
       prompt: agentPrompt("e2e")
     },
     budget: HEAVY_BUDGET,
@@ -6292,7 +6293,7 @@ var DOMAIN_AGENTS = [
       id: "designer",
       name: "Designer",
       role: "designer",
-      tools: [...TOOLS.docs],
+      tools: [...TOOLS.docs, "design"],
       prompt: agentPrompt("designer")
     },
     budget: MEDIUM_BUDGET,
@@ -31042,6 +31043,8 @@ export {
   loadRoleKnowledgeManifest,
   loadSkillAffinity,
   mailboxIdentityBase,
+  mailboxProjectServerEndpoint,
+  mailboxProjectServerMetadataPath,
   mailboxSessionTag,
   makeAgentSubagentRunner,
   makeAskResultTool,

package/dist/coordination/mailbox-project-server.js

@@ -2,10 +2,10 @@
 
 // src/coordination/mailbox-project-server.ts
 import { randomBytes as randomBytes2 } from "node:crypto";
-import * as fs5 from "node:fs";
 import * as fsPromises from "node:fs/promises";
 import * as net from "node:net";
 import * as path7 from "node:path";
+import { bindProjectEndpoint } from "@wrongstack/persistence";
 
 // src/kernel/events.ts
 var MAX_WILDCARDS = 500;
@@ -1173,17 +1173,9 @@ var MailboxEventEmitter = class {
 
 // src/coordination/mailbox-project-server-endpoint.ts
 import { createHash as createHash2 } from "node:crypto";
-import * as fs2 from "node:fs";
 import * as os2 from "node:os";
 import * as path4 from "node:path";
 
-// src/utils/socket-path.ts
-import {
-  assertUnixSocketPathWithinLimit,
-  checkUnixSocketPath,
-  unixSocketPathLimit
-} from "@wrongstack/persistence";
-
 // src/coordination/mailbox-project-server-protocol.ts
 var MAILBOX_PROJECT_SERVER_PROTOCOL_VERSION = 4;
 var MAILBOX_PROJECT_SERVER_MAX_FRAME_CHARS = 16 * 1024 * 1024;
@@ -1317,16 +1309,10 @@ function mailboxProjectServerEndpoint(projectDir2) {
 function mailboxProjectServerMetadataPath(projectDir2) {
   return path4.join(path4.resolve(projectDir2), MAILBOX_PROJECT_SERVER_METADATA_FILE);
 }
-function ensureMailboxProjectServerSocketDirectory(endpoint2) {
-  if (process.platform !== "win32") {
-    assertUnixSocketPathWithinLimit(endpoint2, "mailbox");
-    fs2.mkdirSync(path4.dirname(endpoint2), { recursive: true, mode: 448 });
-  }
-}
 
 // src/coordination/sqlite-mailbox.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import * as fs4 from "node:fs";
+import * as fs3 from "node:fs";
 import * as path6 from "node:path";
 
 // src/coordination/global-mailbox-completion.ts
@@ -2218,7 +2204,7 @@ function credentialRotate(db, transaction, credentialId, options) {
 }
 
 // src/coordination/sqlite-mailbox-schema.ts
-import * as fs3 from "node:fs";
+import * as fs2 from "node:fs";
 import { createRequire } from "node:module";
 import * as path5 from "node:path";
 
@@ -2473,7 +2459,7 @@ function migrateLegacyCredentials(ctx) {
   const legacyPath = path5.join(ctx.projectDir, CREDENTIAL_STORE_FILE);
   const credentials = [];
   try {
-    for (const line of fs3.readFileSync(legacyPath, "utf8").split(/\r?\n/u)) {
+    for (const line of fs2.readFileSync(legacyPath, "utf8").split(/\r?\n/u)) {
       if (!line.trim()) continue;
       try {
         const credential = JSON.parse(line);
@@ -2526,7 +2512,7 @@ function migrateLegacyFiles(ctx) {
 function readLegacyMessages(projectDir2) {
   try {
     return parseMailboxFile(
-      fs3.readFileSync(path5.join(projectDir2, GLOBAL_MAILBOX_FILE), "utf8")
+      fs2.readFileSync(path5.join(projectDir2, GLOBAL_MAILBOX_FILE), "utf8")
     );
   } catch (error) {
     if (error.code === "ENOENT") return [];
@@ -2535,7 +2521,7 @@ function readLegacyMessages(projectDir2) {
 }
 function readLegacyRegistry(filePath, parseEntry) {
   try {
-    const raw = JSON.parse(fs3.readFileSync(filePath, "utf8"));
+    const raw = JSON.parse(fs2.readFileSync(filePath, "utf8"));
     const result = /* @__PURE__ */ new Map();
     for (const [id, value] of Object.entries(raw)) {
       const parsed = parseEntry(value);
@@ -2555,7 +2541,7 @@ var HEARTBEAT_TRACKING_TTL_MS = 30 * 6e4;
 var SqliteMailbox = class {
   constructor(projectDir2, events2, eventEmitter2) {
     this.projectDir = projectDir2;
-    fs4.mkdirSync(projectDir2, { recursive: true });
+    fs3.mkdirSync(projectDir2, { recursive: true });
     this.databasePath = path6.join(projectDir2, SQLITE_MAILBOX_FILE);
     this.messagePath = this.databasePath;
     this.events = events2;
@@ -3451,7 +3437,6 @@ async function stop(_reason) {
   }
   await stopMemoryWatchdog();
 }
-ensureMailboxProjectServerSocketDirectory(endpoint);
 var server = net.createServer((socket) => {
   if (stopping) {
     socket.destroy();
@@ -3481,42 +3466,28 @@ var leaseSweep = setInterval(() => {
   scheduleIdleStop();
 }, leaseSweepMs);
 leaseSweep.unref?.();
-var probingExistingEndpoint = false;
-function listenForOwnership() {
-  server.listen(endpoint);
-}
-server.on("error", (error) => {
-  if (error.code === "EADDRINUSE" && process.platform === "win32") {
+void (async () => {
+  const bind = await bindProjectEndpoint({ server, endpoint, service: "mailbox" });
+  if (bind.outcome === "already-owned") {
     process.exitCode = 0;
     return;
   }
-  if (error.code === "EADDRINUSE" && !probingExistingEndpoint) {
-    probingExistingEndpoint = true;
-    const probe = net.createConnection(endpoint);
-    probe.once("connect", () => {
-      probe.destroy();
-      process.exitCode = 0;
-    });
-    probe.once("error", () => {
-      probe.destroy();
-      try {
-        fs5.rmSync(endpoint, { force: true });
-      } catch {
-      }
-      probingExistingEndpoint = false;
-      listenForOwnership();
-    });
+  if (bind.outcome === "failed") {
+    process.stderr.write(`mailbox project server failed: ${bind.error.message}
+`);
+    process.exitCode = 1;
     return;
   }
-  process.exitCode = 1;
-});
-server.on("listening", () => {
-  if (process.platform !== "win32") {
-    try {
-      fs5.chmodSync(endpoint, 384);
-    } catch {
-    }
+  if (bind.reclaimedStaleEndpoint) {
+    process.stderr.write(`mailbox project server reclaimed stale endpoint ${endpoint}
+`);
   }
+  server.on("error", (error) => {
+    if (stopping) return;
+    process.stderr.write(`mailbox project server error: ${error.message}
+`);
+    process.exitCode = 1;
+  });
   try {
     mailbox = new SqliteMailbox(projectDir, events, eventEmitter);
   } catch {
@@ -3526,16 +3497,16 @@ server.on("listening", () => {
     return;
   }
   stopAutoCompact = mailbox.startAutoCompactTimer();
-  void writeMetadata().then(() => {
+  try {
+    await writeMetadata();
     markMetadataWritten?.();
     scheduleIdleStop();
-  }).catch(() => {
+  } catch {
     void stop("metadata-write-failed").finally(() => {
       process.exitCode = 1;
     });
-  });
-});
-listenForOwnership();
+  }
+})();
 for (const signal of ["SIGINT", "SIGTERM"]) {
   process.once(signal, () => {
     void stop(signal).finally(() => {

package/dist/core/index.d.ts

@@ -13,5 +13,6 @@ export { formatModelRef, type ModelRef, normalizeModelRef, parseModelRef, } from
 export { clearPendingNextSteps, hasNextStepsTag, MAX_PENDING_NEXT_STEPS, maybeAppendPendingNextSteps, type PendingNextStep, readPendingNextSteps, renderNextStepsBlock, writePendingNextSteps, } from './next-steps-slot.js';
 export { runProviderWithRetry } from './provider-runner.js';
 export { setQueuedMessagesSnapshot } from './queued-messages.js';
-export { DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, type SystemBlockSource, } from './system-prompt-builder.js';
+export { buildIdentityLayer, DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, type SystemBlockSource, } from './system-prompt-builder.js';
+export { type DomainGlossaryOptions, renderDomainGlossary, } from './system-prompt-glossary.js';
 //# sourceMappingURL=index.d.ts.map