@excitedjs/dreamux 0.13.0 → 0.14.0

package/dist/server.js

@@ -12,9 +12,10 @@ import { BUILT_IN_DEFAULTS, } from './config/config.js';
 import { DispatcherStore, } from './state/dispatcher-store.js';
 import { adminSocketPath, setRuntimeConfig, } from './platform/paths.js';
 import { createLogger, } from './platform/logger.js';
-import { createAdminSocketServer } from './admin/socket.js';
+import { assertNoLegacyAdminServer, createAdminSocketServer, } from './admin/socket.js';
 import { RestartIntentConsumer } from './daemon/restart-intent.js';
 import { DispatcherService } from './dispatcher-service/service.js';
+import { ensureDispatcherWorkspace } from './dispatcher-service/dispatcher-workspace.js';
 export { IN_PROGRESS_REACTION_EMOJI, RECEIVED_REACTION_EMOJI, } from './channel/feishu/feishu-channel.js';
 export class Server {
     repos;
@@ -85,9 +86,32 @@ export class Server {
             now: Date.now(),
             warn: (message) => this.log.warn(message),
         }));
+        // Dispatcher workspace cwd contract (issue #182 PR-4): every enabled
+        // dispatcher must declare an explicit, usable `cwd` — there is no fallback
+        // to a Dreamux state dir. Pre-flight all of them before taking the admin
+        // lock or launching anything, and fail the whole start loud (aggregated) so
+        // a misconfigured deployment never comes up half-broken.
+        await this.assertDispatcherWorkspaces();
+        // Before taking the new run/ admin lock, fail loud if an OLD-version
+        // server still holds the pre-#182 state/ admin lock — the two locks are at
+        // different paths and would not otherwise see each other (issue #182 P1).
+        if (this.opts.legacyAdminLockPath != null) {
+            await assertNoLegacyAdminServer({
+                legacyLockPath: this.opts.legacyAdminLockPath,
+            });
+        }
         this.admin = createAdminSocketServer(this, this.opts.adminSocketPath ?? adminSocketPath());
         await this.admin.start();
         this.log.info({ admin_socket: this.admin.socketPath }, 'admin socket listening');
+        if (this.opts.runtimeSocketSweep !== undefined) {
+            try {
+                const swept = await this.opts.runtimeSocketSweep();
+                this.log.info({ dirs: swept }, 'swept volatile runtime-socket dirs');
+            }
+            catch (err) {
+                this.log.warn({ err: errInfo(err) }, 'runtime-socket sweep failed; continuing startup');
+            }
+        }
         const rows = this.repos.dispatchers.listEnabled();
         for (const row of rows) {
             try {
@@ -98,6 +122,28 @@ export class Server {
             }
         }
     }
+    /**
+     * Validate the workspace cwd of every enabled dispatcher (issue #182 PR-4).
+     * Aggregates all failures into one loud error so the operator sees every
+     * misconfigured dispatcher at once, rather than fixing them one boot at a
+     * time. A throw here aborts `start()` before any socket or dispatcher.
+     */
+    async assertDispatcherWorkspaces() {
+        const config = this.opts.config ?? BUILT_IN_DEFAULTS;
+        const failures = [];
+        for (const row of this.repos.dispatchers.listEnabled()) {
+            try {
+                await ensureDispatcherWorkspace(config, row.dispatcher_id);
+            }
+            catch (err) {
+                failures.push(err instanceof Error ? err.message : String(err));
+            }
+        }
+        if (failures.length > 0) {
+            throw new Error(`dreamux serve cannot start — dispatcher workspace cwd contract failed:\n` +
+                failures.map((message) => `  - ${message}`).join('\n'));
+        }
+    }
     summarize() {
         return this.dispatcherService.summarize();
     }

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,wCAAwC,GAEzC,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,GAEhB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,GAEb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAA0B,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAsD5C,MAAM,OAAO,MAAM;IACR,KAAK,CAAQ;IACb,iBAAiB,CAAoB;IACtC,KAAK,GAA6B,IAAI,CAAC;IACvC,YAAY,GAAG,KAAK,CAAC;IACZ,IAAI,CAAgB;IACpB,GAAG,CAAgB;IACnB,gBAAgB,CAAmB;IACnC,qBAAqB,CAA8B;IAEpE,YAAY,OAAsB,EAAE;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,gBAAgB;YACnB,IAAI,CAAC,gBAAgB,IAAI,6BAA6B,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC;QAChD,IACE,IAAI,CAAC,gBAAgB,KAAK,SAAS;YACnC,IAAI,CAAC,2BAA2B,KAAK,SAAS,EAC9C,CAAC;YACD,4CAA4C,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,MAAM,oBAAoB,GACxB,IAAI,CAAC,oBAAoB;YACzB,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,oBAAoB,GAAG;YAC3B,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,kBAAkB,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,yBAAyB,KAAK,SAAS;gBAC9C,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,yBAAyB,EAAE;gBAC1D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,wBAAwB,KAAK,SAAS;gBAC7C,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,wBAAwB,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,IAAI,CAAC,qBAAqB;YACxB,IAAI,CAAC,2BAA2B;gBAChC,wCAAwC,CAAC;oBACvC,QAAQ,EAAE,IAAI,CAAC,gBAAgB;oBAC/B,KAAK,EAAE,oBAAoB;oBAC3B,GAAG,CAAC,IAAI,CAAC,8BAA8B,KAAK,SAAS;wBACnD,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,8BAA8B,EAAE,EAAE;wBACzE,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;QACL,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC;SACzC,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;YAC7C,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;YACnC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,eAAe,EAAE;YAC1D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,oBAAoB;YACpB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CACrC,MAAM,qBAAqB,CAAC,IAAI,CAAC;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;YACf,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;SAC1C,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,uBAAuB,CAClC,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,eAAe,EAAE,CAC/C,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EACvC,wBAAwB,CACzB,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EACvD,4BAA4B,CAC7B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;CACF;AAED,SAAS,4CAA4C,CAAC,MAAqB;IACzE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,KAAK,CACnE,CAAC;IACF,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO;IACrC,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,EAAE,wCAAwC;QAClE,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB;QACrE,gEAAgE,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;YAC5C,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,wCAAwC,GAEzC,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,GAEhB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,GAEb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAuE5C,MAAM,OAAO,MAAM;IACR,KAAK,CAAQ;IACb,iBAAiB,CAAoB;IACtC,KAAK,GAA6B,IAAI,CAAC;IACvC,YAAY,GAAG,KAAK,CAAC;IACZ,IAAI,CAAgB;IACpB,GAAG,CAAgB;IACnB,gBAAgB,CAAmB;IACnC,qBAAqB,CAA8B;IAEpE,YAAY,OAAsB,EAAE;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,gBAAgB;YACnB,IAAI,CAAC,gBAAgB,IAAI,6BAA6B,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC;QAChD,IACE,IAAI,CAAC,gBAAgB,KAAK,SAAS;YACnC,IAAI,CAAC,2BAA2B,KAAK,SAAS,EAC9C,CAAC;YACD,4CAA4C,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,MAAM,oBAAoB,GACxB,IAAI,CAAC,oBAAoB;YACzB,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,oBAAoB,GAAG;YAC3B,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,kBAAkB,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,yBAAyB,KAAK,SAAS;gBAC9C,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,yBAAyB,EAAE;gBAC1D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,wBAAwB,KAAK,SAAS;gBAC7C,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,wBAAwB,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,IAAI,CAAC,qBAAqB;YACxB,IAAI,CAAC,2BAA2B;gBAChC,wCAAwC,CAAC;oBACvC,QAAQ,EAAE,IAAI,CAAC,gBAAgB;oBAC/B,KAAK,EAAE,oBAAoB;oBAC3B,GAAG,CAAC,IAAI,CAAC,8BAA8B,KAAK,SAAS;wBACnD,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,8BAA8B,EAAE,EAAE;wBACzE,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;QACL,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC;SACzC,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;YAC7C,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;YACnC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,eAAe,EAAE;YAC1D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,oBAAoB;YACpB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CACrC,MAAM,qBAAqB,CAAC,IAAI,CAAC;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;YACf,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;SAC1C,CAAC,CACH,CAAC;QAEF,qEAAqE;QACrE,2EAA2E;QAC3E,yEAAyE;QACzE,4EAA4E;QAC5E,yDAAyD;QACzD,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAExC,qEAAqE;QACrE,2EAA2E;QAC3E,0EAA0E;QAC1E,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;YAC1C,MAAM,yBAAyB,CAAC;gBAC9B,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,uBAAuB,CAClC,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,eAAe,EAAE,CAC/C,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EACvC,wBAAwB,CACzB,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACnD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,oCAAoC,CAAC,CAAC;YACvE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EACrB,iDAAiD,CAClD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EACvD,4BAA4B,CAC7B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,0BAA0B;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC;QACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,0EAA0E;gBACxE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;CACF;AAED,SAAS,4CAA4C,CAAC,MAAqB;IACzE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,KAAK,CACnE,CAAC;IACF,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO;IACrC,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,EAAE,wCAAwC;QAClE,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB;QACrE,gEAAgE,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;YAC5C,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excitedjs/dreamux",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Codex-host server — single-session MVP. One node process hosts N dispatchers, each binding 1 Feishu bot + 1 Codex thread.",
   "license": "MIT",
   "repository": {

package/skills/dispatcher/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dispatcher
-description: Use from a Dreamux dispatcher thread when bounded repository work should be delegated to a TeamMate. The server-hosted TeamMate MCP is the default interface; spawn creates a named semi-resident TeamMate, send submits follow-up turns and reopens a closed TeamMate from its checkpoint, close stops one, history lists session ledger rows, history_events reads a raw timeline, and list/status/last/ctx/get_capabilities inspect state. The tm CLI is the explicit fallback for legacy diagnostics. Applies to spawning, tracking, retrieving, sending, closing, inspecting, reopening, recovering, or summarizing teammate work.
+description: Use from a Dreamux dispatcher thread when bounded repository work should be delegated to a TeamMate. The server-hosted TeamMate MCP is the default interface; spawn creates a semi-resident TeamMate and RETURNS its concrete name (use that name for every later call), send submits follow-up turns and reopens a closed TeamMate from its checkpoint, close stops one, history searches the durable session ledger, and list/status/last/get_capabilities inspect state. The tm CLI is the explicit fallback for legacy diagnostics. Applies to spawning, tracking, retrieving, sending, closing, inspecting, reopening, recovering, or summarizing teammate work.
 ---
 
 # Dispatcher
@@ -25,51 +25,74 @@ session or polling a process.
 
 **Lifecycle.**
 
-- `spawn` — create a named TeamMate and submit the first turn. Use a stable name
-  for work you may resume later. When selecting a runtime, pass one of
-  `get_capabilities.agent_runtimes[].id` as `agent_runtime`; do not pass
-  provider refs such as `builtin:*`.
-- `send` — submit a turn to a TeamMate. If the named TeamMate is not live —
+- `spawn` — create a TeamMate and submit the first turn. The `name` you pass is
+  a requested label / base slug, **not** the final address: the service
+  allocates a concrete, never-reused name and returns it as `teammate.name`.
+  **Use that returned concrete name for every later `send`/`status`/`last`/
+  `close`.** Your requested label is preserved as `display_name` for display.
+  `intent` is **required**: a short recovery subject for the session ledger
+  (what this TeamMate is for). When selecting a runtime, pass one of
+  `get_capabilities.agent_runtimes[].id` as `agent_runtime`; do not pass provider
+  refs such as `builtin:*`.
+- `send` — submit a turn to a TeamMate by its concrete name. If it is not live —
   including one previously `close`d — send first reopens it from its persisted
   checkpoint, then submits. There is no separate `resume` verb; send covers
-  reattach.
-- `close` — stop the named TeamMate and mark it closed. It stays reopenable: a
-  later `send` revives it from its checkpoint.
+  reattach. Pass `intent` (optional) to update the recorded recovery subject
+  when the work shifts.
+- `close` — stop the TeamMate (by concrete name) and mark it closed. `note` is
+  **required**: why you are stopping a recoverable session. It stays reopenable:
+  a later `send` revives it from its checkpoint.
 
 **Watch and collect — no polling.**
 
-- `list` — this dispatcher's TeamMates and their statuses.
-- `status` — one TeamMate status, agent runtime id, checkpoint, and close metadata.
-- `history` — bounded session ledger rows for this dispatcher, with filters for
-  recovery across TeamMates.
-- `history_events` — raw forward-only event history for one named TeamMate.
-- `last` — the runtime's latest assistant-visible result when supported.
-- `ctx` — the runtime context snapshot when supported.
+- `list` — this dispatcher's TeamMates: concrete name, display name, status, and
+  repo/cwd/session essentials.
+- `status` — one TeamMate's current state by concrete name: display name, agent
+  runtime id, session, cwd/repo, checkpoint, and close metadata.
+- `history` — the durable session-ledger search surface for this dispatcher,
+  with recovery filters across TeamMates (name/state/repo/grep/cursor).
+- `last` — a TeamMate's most recent settled turn(s), read from the durable
+  session ledger by concrete name. It accepts `turns` (1..5, default 1; newest
+  last) and returns the final assistant output as completely as it was durably
+  captured (with a truncation flag). It does **not** start or resume a runtime,
+  so it works for a closed or stopped TeamMate — this is your fallback when a
+  completion was never delivered.
 
 These serve status / history / last directly, so you do not need `tm` to check
 on a running TeamMate. Do not wait or poll for completion: submit the turn, let
-the dispatcher turn end, then recover through `history`, `last`, and `ctx`.
+the dispatcher turn end, then recover through `history` and `last`. (The former
+`ctx` and `history_events` verbs were removed; use `last` and `history`.)
 
 **Team lifecycle.**
 
 Dreamux also injects a dispatcher-scoped `team` MCP server for Team Mode
-lifecycle. Use it to create a TeamLeader, inspect Team status/ledger, and
-dissolve a Team. Team work still runs through agents; do not inspect the target
-repo directly from the dispatcher.
-
-- `create` — create a Team and TeamLeader. Requires `repo_cwd` and
-  `leader_agent_runtime`; no default leader runtime is inferred.
-- `create_group` — from a P2P control channel, create a Team, create a Feishu
-  group, invite the requester/peers when Feishu permissions allow it, and bind
-  the new group to the TeamLeader. The source P2P remains with the dispatcher.
-- `list`, `status`, `ledger` — read dispatcher-owned Team records and lifecycle
-  ledger rows.
-- `bind_channel` — bind a Feishu group chat to a TeamLeader. P2P binding is
-  rejected.
-- `transfer_channel_back` — return a bound Feishu group chat to the dispatcher.
-- `dissolve` — close the TeamLeader and team-owned members, then conservatively
-  clean up the shared managed worktree. Active channel bindings are transferred
-  back first.
+lifecycle. It is addressed by **Team name** (the same value you create with),
+mirroring the TeamMate read-surface model. Team work still runs through agents;
+do not inspect the target repo directly from the dispatcher.
+
+- `create` — create a Team and TeamLeader. Requires `repo_cwd`,
+  `leader_agent_runtime`, and `intent` (the Team's recovery subject); no default
+  leader runtime is inferred. Optionally pass `bind_group: { chat_id }` to bind
+  an EXISTING Feishu group chat to the new Team at create time. (The former
+  `create_group` tool — create a brand-new Feishu group and invite users — was
+  retired; bind an existing group instead.)
+- `list` — compact scan rows for current Teams (name, status, intent, repo
+  signal, leader name/state, member count, bound group marker, timestamps). Keep
+  it cheap and scannable; reach for `status` for detail.
+- `status` — one Team's detailed current state by name: the Team record, the
+  TeamLeader status/session, member count, and the active bound group.
+- `history` — the durable Team recovery search (closed Teams included): filter by
+  `name`, `status`, `close_status`, `repo`, `intent` text (`grep`), and time
+  range (`since`/`until`), with `limit`/`cursor`. This is the recovery interface;
+  the raw per-Team lifecycle event timeline stays internal.
+- `bind_group` — bind an existing Feishu group chat to a Team by name and
+  `chat_id` (group chats only; no `chat_type`).
+- `transfer_channel_back` — return a bound Feishu group chat (`chat_id`) to the
+  dispatcher.
+- `dissolve` — close the TeamLeader and team-owned members by Team name, then
+  conservatively clean up the shared managed worktree. `note` is **required**:
+  why the Team is being dissolved. Active channel bindings are transferred back
+  first.
 
 **Control and inspect.**
 
@@ -161,7 +184,7 @@ on a flag -- do not infer one verb's flags from another.
 
 These references cover the `tm` fallback path. For ordinary delegation —
 spawning a TeamMate, sending follow-up turns (which also reopens a closed one
-from its checkpoint), checking status, or reading history/last/context — use the
+from its checkpoint), checking status, or reading history/last — use the
 `teammate` MCP tools above and you do not need a reference.
 Read the matching reference when you have dropped to `tm`:
 
@@ -195,9 +218,10 @@ turn's tool calls.
 Two state owners, kept distinct:
 
 - The Dreamux server owns the TeamMate **agent state** behind the `teammate`
-  MCP — named identities, runtime checkpoints, status, history, last result,
-  and context snapshots. Read and control it with `list`, `status`, `history`,
-  `last`, `ctx`, `send`, and `close`.
+  MCP — concrete identities (with their display labels), runtime checkpoints,
+  status, and the durable session ledger (prompts and captured assistant
+  output). Read and control it with `list`, `status`, `history`, `last`,
+  `send`, and `close`.
 - `tm` owns live tm **session** state — teammate liveness, worktrees, and
   resumable session history (see `references/inspect-and-resume.md`).
 

package/skills/dispatcher/references/dispatch-task.md

@@ -1,9 +1,9 @@
 # Dispatch A Task
 
 > This is the `tm` fallback path. Default to the `teammate` MCP —
-> `spawn` / `send` / `close` (send also reopens a closed TeamMate), then
-> inspect with `history` / `last` / `ctx` (see the dispatcher skill; do not
-> poll). Use the
+> `spawn` (which returns the concrete name to use thereafter) / `send` / `close`
+> (send also reopens a closed TeamMate), then inspect with `history` / `last`
+> (see the dispatcher skill; do not poll). Use the
 > `tm spawn` / `tm send` flow below only when you need an isolated managed
 > worktree or legacy tm diagnostics.
 

package/skills/dispatcher/references/inspect-and-resume.md

@@ -1,9 +1,11 @@
 # Inspect And Resume
 
 > Default to the `teammate` MCP for inspection: `list`, `status`, `history`,
-> `last`, and `ctx` cover server-owned TeamMate state without `tm`; do not poll.
-> This `tm` fallback owns what the MCP does not: legacy tm sessions, worktrees,
-> and tm history.
+> and `last` cover server-owned TeamMate state without `tm`; do not poll. `last`
+> reads the most recent settled turn(s) (turns 1..5) from the durable session
+> ledger by the concrete name `spawn` returned, even for a closed TeamMate. This
+> `tm` fallback owns what the MCP does not: legacy tm sessions, worktrees, and tm
+> history.
 
 ## Trigger
 

package/skills/dreamux-maintenance/SKILL.md

@@ -71,6 +71,27 @@ dreamux config show
 | Skill path is a real file or directory | Dreamux leaves it untouched. If this is an intentional override, keep it; otherwise rename or remove it and restart the dispatcher. |
 | Skill symlink is broken after an upgrade | Restart the dispatcher or rerun `dreamux onboard`; startup recreates stale or broken bundled skill symlinks. |
 
+## Log Maintenance
+
+Dreamux does not auto-prune logs (no automatic retention in 0.x). Pruning is a
+deliberate operator action:
+
+- A **7-day retention** is acceptable; delete logs older than that when disk
+  matters. Logs hold only diagnostics, never durable state.
+- **Zero-byte log files are always safe to delete.** Empty runtime child
+  stdout/stderr logs are now removed automatically when the child shuts down
+  cleanly, so they no longer accumulate one-per-start; what remains under
+  `~/.dreamux/logs/` are files that actually captured startup/crash output.
+- The whole `~/.dreamux/logs/` tree is rebuildable: it is safe to clear while no
+  `dreamux serve` is running; it is recreated on the next start.
+
+Prune manually, e.g. (run only while the server is stopped):
+
+```bash
+find ~/.dreamux/logs -type f -mtime +7 -delete   # drop logs older than 7 days
+find ~/.dreamux/logs -type f -empty -delete       # drop any leftover empties
+```
+
 ## Turn Mechanics
 
 For questions about active turns, steering, background commands, and repeated