@cleocode/core 2026.9.10 → 2026.9.12

package/dist/docs/export-document.js

@@ -18297,6 +18297,9 @@ var init_project_scope = __esm({
 });
 
 // packages/core/src/teardown-signal.ts
+function isShuttingDown() {
+  return _shuttingDown;
+}
 function registerTeardownAbort(controller) {
   if (_shuttingDown) {
     try {
@@ -18322,6 +18325,9 @@ var init_teardown_signal = __esm({
 // packages/core/src/store/background-ops.ts
 import { AsyncLocalStorage as AsyncLocalStorage2 } from "node:async_hooks";
 import { isAbsolute } from "node:path";
+function recordProducerOutcome(disposition) {
+  producerLedger[disposition] += 1;
+}
 async function withBackgroundOpCommitBoundary(native, commit, execution, schedule) {
   const inherited = backgroundCommitBoundary.getStore();
   const parent = inherited?.active && inherited.native === native ? inherited : void 0;
@@ -18356,8 +18362,14 @@ function trackBackgroundOp(op, execution) {
   void tracked.then(() => inFlight.delete(tracked));
   const settle = (work) => {
     void work.then(
-      () => completion.resolve({ status: "fulfilled", value: void 0 }),
-      (reason) => completion.resolve({ status: "rejected", reason })
+      () => {
+        recordProducerOutcome("fulfilled");
+        completion.resolve({ status: "fulfilled", value: void 0 });
+      },
+      (reason) => {
+        recordProducerOutcome(isExpectedTeardownRejection(reason) ? "cancelled" : "failed");
+        completion.resolve({ status: "rejected", reason });
+      }
     );
   };
   if (typeof op !== "function") {
@@ -18389,6 +18401,7 @@ function trackBackgroundOp(op, execution) {
     discard(error) {
       if (started) return;
       started = true;
+      recordProducerOutcome("discarded");
       completion.resolve({ status: "rejected", reason: error });
     }
   };
@@ -18404,6 +18417,9 @@ function trackBackgroundOp(op, execution) {
   else operation.start();
   return tracked;
 }
+function isExpectedTeardownRejection(reason) {
+  return reason instanceof OperationExecutionError && (reason.code === "E_OPERATION_CANCELLED" || reason.code === "E_OPERATION_CLOSED" || reason.code === "E_OPERATION_DEADLINE");
+}
 function createOperationExecutionContext(identity, options = {}) {
   for (const key of ["projectId", "projectRoot", "actor", "operation", "idempotencyKey"]) {
     const value = identity[key];
@@ -18543,12 +18559,18 @@ function observeOperation(context, work) {
     if (context.signal.aborted) abort();
   });
 }
-var inFlight, backgroundCommitBoundary, OperationExecutionError;
+var inFlight, producerLedger, backgroundCommitBoundary, OperationExecutionError;
 var init_background_ops = __esm({
   "packages/core/src/store/background-ops.ts"() {
     "use strict";
     init_teardown_signal();
     inFlight = /* @__PURE__ */ new Set();
+    producerLedger = {
+      fulfilled: 0,
+      failed: 0,
+      cancelled: 0,
+      discarded: 0
+    };
     backgroundCommitBoundary = new AsyncLocalStorage2();
     OperationExecutionError = class extends Error {
       /** Machine-readable reason that a new stage was refused. */
@@ -32173,13 +32195,7 @@ function getCleoDirAbsolute(cwd, opts) {
   const project = _pathsResolveProjectByCwd(cwd);
   if (project !== null) {
     if (process.env["CLEO_DISABLE_PROJECT_AUTOREGISTER"] !== "1") {
-      registerProjectOnEncounter(
-        project.projectRoot,
-        project.legacyUUID ?? project.projectId
-      ).catch((error) => {
-        process.stderr.write(`[cleo] Project encounter registration failed: ${error.message}
-`);
-      });
+      scheduleProjectEncounter(project.projectRoot, project.legacyUUID ?? project.projectId);
     }
     try {
       const projectRoot = getProjectRoot(cwd);
@@ -32353,6 +32369,26 @@ function _readProjectNameFromInfo(projectRoot) {
   const data = JSON.parse(raw);
   return typeof data.name === "string" && data.name.length > 0 ? data.name : void 0;
 }
+function scheduleProjectEncounter(projectRoot, infoProjectId) {
+  if (isShuttingDown()) return;
+  const key = `${getCleoHome()}\0${infoProjectId}\0${projectRoot}`;
+  const previous = _encountersScheduled.get(key);
+  const now = Date.now();
+  if (previous !== void 0 && now - previous < PROJECT_ENCOUNTER_REFRESH_MS) return;
+  _encountersScheduled.set(key, now);
+  registerProjectOnEncounter(projectRoot, infoProjectId).catch((error) => {
+    if (isExpectedTeardownRejection(error)) {
+      if (process.env["CLEO_DEBUG"])
+        process.stderr.write(
+          `[cleo][debug] Project encounter abandoned by teardown: ${error.message}
+`
+        );
+      return;
+    }
+    process.stderr.write(`[cleo] Project encounter registration failed: ${error.message}
+`);
+  });
+}
 async function registerProjectOnEncounter(projectRoot, infoProjectId) {
   const scope = captureProjectScope(projectRoot, worktreeScope.getStore());
   const capturedHome = getCleoHome();
@@ -32458,7 +32494,7 @@ async function registerProjectOnEncounter(projectRoot, infoProjectId) {
     if (ownedExecution) execution.close();
   }
 }
-var _getCleoDirAbsoluteDeprecatedWarned;
+var _getCleoDirAbsoluteDeprecatedWarned, PROJECT_ENCOUNTER_REFRESH_MS, _encountersScheduled;
 var init_paths = __esm({
   "packages/core/src/paths.ts"() {
     "use strict";
@@ -32468,7 +32504,10 @@ var init_paths = __esm({
     init_project_scope();
     init_background_ops();
     init_platform_paths();
+    init_teardown_signal();
     _getCleoDirAbsoluteDeprecatedWarned = false;
+    PROJECT_ENCOUNTER_REFRESH_MS = 5 * 6e4;
+    _encountersScheduled = /* @__PURE__ */ new Map();
   }
 });