@mestreyoda/fabrica 0.2.21 → 0.2.23

package/dist/index.js

@@ -26948,14 +26948,14 @@ var require_tls_helpers = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.CIPHER_SUITES = void 0;
     exports2.getDefaultRootsData = getDefaultRootsData;
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     exports2.CIPHER_SUITES = process.env.GRPC_SSL_CIPHER_SUITES;
     var DEFAULT_ROOTS_FILE_PATH = process.env.GRPC_DEFAULT_SSL_ROOTS_FILE_PATH;
     var defaultRootsData = null;
     function getDefaultRootsData() {
       if (DEFAULT_ROOTS_FILE_PATH) {
         if (defaultRootsData === null) {
-          defaultRootsData = fs45.readFileSync(DEFAULT_ROOTS_FILE_PATH);
+          defaultRootsData = fs46.readFileSync(DEFAULT_ROOTS_FILE_PATH);
         }
         return defaultRootsData;
       }
@@ -31086,7 +31086,7 @@ var require_fetch = __commonJS({
     module2.exports = fetch3;
     var asPromise = require_aspromise();
     var inquire2 = require_inquire();
-    var fs45 = inquire2("fs");
+    var fs46 = inquire2("fs");
     function fetch3(filename, options, callback) {
       if (typeof options === "function") {
         callback = options;
@@ -31095,8 +31095,8 @@ var require_fetch = __commonJS({
         options = {};
       if (!callback)
         return asPromise(fetch3, this, filename, options);
-      if (!options.xhr && fs45 && fs45.readFile)
-        return fs45.readFile(filename, function fetchReadFileCallback(err, contents) {
+      if (!options.xhr && fs46 && fs46.readFile)
+        return fs46.readFile(filename, function fetchReadFileCallback(err, contents) {
           return err && typeof XMLHttpRequest !== "undefined" ? fetch3.xhr(filename, options, callback) : err ? callback(err) : callback(null, options.binary ? contents : contents.toString("utf8"));
         });
       return fetch3.xhr(filename, options, callback);
@@ -37370,7 +37370,7 @@ var require_util3 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.addCommonProtos = exports2.loadProtosWithOptionsSync = exports2.loadProtosWithOptions = void 0;
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var path47 = __require("path");
     var Protobuf = require_protobufjs();
     function addIncludePathResolver(root, includePaths) {
@@ -37382,7 +37382,7 @@ var require_util3 = __commonJS({
         for (const directory of includePaths) {
           const fullPath = path47.join(directory, target);
           try {
-            fs45.accessSync(fullPath, fs45.constants.R_OK);
+            fs46.accessSync(fullPath, fs46.constants.R_OK);
             return fullPath;
           } catch (err) {
             continue;
@@ -47204,7 +47204,7 @@ var require_certificate_provider = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.FileWatcherCertificateProvider = void 0;
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var logging = require_logging();
     var constants_1 = require_constants2();
     var util_1 = __require("util");
@@ -47212,7 +47212,7 @@ var require_certificate_provider = __commonJS({
     function trace2(text) {
       logging.trace(constants_1.LogVerbosity.DEBUG, TRACER_NAME2, text);
     }
-    var readFilePromise = (0, util_1.promisify)(fs45.readFile);
+    var readFilePromise = (0, util_1.promisify)(fs46.readFile);
     var FileWatcherCertificateProvider = class {
       constructor(config2) {
         this.config = config2;
@@ -49124,7 +49124,7 @@ var require_otlp_grpc_env_configuration = __commonJS({
     var core_1 = require_src();
     var grpc_exporter_transport_1 = require_grpc_exporter_transport();
     var node_http_1 = (init_index_node_http(), __toCommonJS(index_node_http_exports));
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var path47 = __require("path");
     var api_1 = (init_esm(), __toCommonJS(esm_exports));
     function fallbackIfNullishOrBlank(signalSpecific, nonSignalSpecific) {
@@ -49174,7 +49174,7 @@ var require_otlp_grpc_env_configuration = __commonJS({
       const filePath = fallbackIfNullishOrBlank(signalSpecificPath, nonSignalSpecificPath);
       if (filePath != null) {
         try {
-          return fs45.readFileSync(path47.resolve(process.cwd(), filePath));
+          return fs46.readFileSync(path47.resolve(process.cwd(), filePath));
         } catch {
           api_1.diag.warn(warningMessage);
           return void 0;
@@ -59234,14 +59234,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs45 = this.flowScalar(this.type);
+              const fs46 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map2.items.push({ start, key: fs45, sep: [] });
+                map2.items.push({ start, key: fs46, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs45);
+                this.stack.push(fs46);
               } else {
-                Object.assign(it, { key: fs45, sep: [] });
+                Object.assign(it, { key: fs46, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -59369,13 +59369,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs45 = this.flowScalar(this.type);
+              const fs46 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs45, sep: [] });
+                fc.items.push({ start: [], key: fs46, sep: [] });
               else if (it.sep)
-                this.stack.push(fs45);
+                this.stack.push(fs46);
               else
-                Object.assign(it, { key: fs45, sep: [] });
+                Object.assign(it, { key: fs46, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -59691,7 +59691,7 @@ var require_FileConfigFactory = __commonJS({
     exports2.setLoggerProvider = exports2.getSeverity = exports2.setMeterProvider = exports2.getTemporalityPreference = exports2.setTracerProvider = exports2.setPropagator = exports2.setAttributeLimits = exports2.setResourceAttributes = exports2.parseConfigFile = exports2.hasValidConfigFile = exports2.FileConfigFactory = void 0;
     var core_1 = require_src();
     var configModel_1 = require_configModel();
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var yaml = require_dist();
     var utils_1 = require_utils10();
     var commonModel_1 = require_commonModel();
@@ -59713,7 +59713,7 @@ var require_FileConfigFactory = __commonJS({
     function hasValidConfigFile() {
       const configFile = (0, core_1.getStringFromEnv)("OTEL_EXPERIMENTAL_CONFIG_FILE");
       if (configFile) {
-        if (!(configFile.endsWith(".yaml") || configFile.endsWith(".yml")) || !fs45.existsSync(configFile)) {
+        if (!(configFile.endsWith(".yaml") || configFile.endsWith(".yml")) || !fs46.existsSync(configFile)) {
           api_1.diag.warn(`Config file ${configFile} set on OTEL_EXPERIMENTAL_CONFIG_FILE is not valid`);
           return false;
         }
@@ -59725,7 +59725,7 @@ var require_FileConfigFactory = __commonJS({
     function parseConfigFile(config2) {
       const supportedFileVersions = ["1.0-rc.3"];
       const configFile = (0, core_1.getStringFromEnv)("OTEL_EXPERIMENTAL_CONFIG_FILE") || "";
-      const file2 = fs45.readFileSync(configFile, "utf8");
+      const file2 = fs46.readFileSync(configFile, "utf8");
       const parsedContent = yaml.parse(file2);
       if (parsedContent["file_format"] && supportedFileVersions.includes(parsedContent["file_format"])) {
         const disabled = (0, utils_1.getBooleanFromConfigFile)(parsedContent["disabled"]);
@@ -61436,7 +61436,7 @@ var require_instrumentation3 = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.AwsLambdaInstrumentation = exports2.AWS_HANDLER_STREAMING_RESPONSE = exports2.AWS_HANDLER_STREAMING_SYMBOL = exports2.lambdaMaxInitInMilliseconds = void 0;
     var path47 = __require("path");
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var instrumentation_1 = require_src10();
     var api_1 = (init_esm(), __toCommonJS(esm_exports));
     var semantic_conventions_1 = (init_esm2(), __toCommonJS(esm_exports2));
@@ -61482,15 +61482,15 @@ var require_instrumentation3 = __commonJS({
         let filename = path47.resolve(taskRoot, moduleRoot, module3);
         if (!filename.endsWith(".js")) {
           try {
-            fs45.statSync(`${filename}.js`);
+            fs46.statSync(`${filename}.js`);
             filename += ".js";
           } catch (e2) {
             try {
-              fs45.statSync(`${filename}.mjs`);
+              fs46.statSync(`${filename}.mjs`);
               filename += ".mjs";
             } catch (e22) {
               try {
-                fs45.statSync(`${filename}.cjs`);
+                fs46.statSync(`${filename}.cjs`);
                 filename += ".cjs";
               } catch (e3) {
                 this._diag.warn("No handler file was able to resolved with one of the known extensions for the file", filename);
@@ -66162,19 +66162,19 @@ var require_utils17 = __commonJS({
       }
     }
     exports2.splitTwoLevels = splitTwoLevels;
-    function indexFs(fs45, member) {
+    function indexFs(fs46, member) {
       if (!member)
         throw new Error(JSON.stringify({ member }));
       const splitResult = splitTwoLevels(member);
       const [functionName1, functionName2] = splitResult;
       if (functionName2) {
         return {
-          objectToPatch: fs45[functionName1],
+          objectToPatch: fs46[functionName1],
           functionNameToPatch: functionName2
         };
       } else {
         return {
-          objectToPatch: fs45,
+          objectToPatch: fs46,
           functionNameToPatch: functionName1
         };
       }
@@ -66205,16 +66205,16 @@ var require_instrumentation12 = __commonJS({
       }
       init() {
         return [
-          new instrumentation_1.InstrumentationNodeModuleDefinition("fs", ["*"], (fs45) => {
+          new instrumentation_1.InstrumentationNodeModuleDefinition("fs", ["*"], (fs46) => {
             for (const fName of constants_1.SYNC_FUNCTIONS) {
-              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs45, fName);
+              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs46, fName);
               if ((0, instrumentation_1.isWrapped)(objectToPatch[functionNameToPatch])) {
                 this._unwrap(objectToPatch, functionNameToPatch);
               }
               this._wrap(objectToPatch, functionNameToPatch, this._patchSyncFunction.bind(this, fName));
             }
             for (const fName of constants_1.CALLBACK_FUNCTIONS) {
-              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs45, fName);
+              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs46, fName);
               if ((0, instrumentation_1.isWrapped)(objectToPatch[functionNameToPatch])) {
                 this._unwrap(objectToPatch, functionNameToPatch);
               }
@@ -66225,30 +66225,30 @@ var require_instrumentation12 = __commonJS({
               this._wrap(objectToPatch, functionNameToPatch, this._patchCallbackFunction.bind(this, fName));
             }
             for (const fName of constants_1.PROMISE_FUNCTIONS) {
-              if ((0, instrumentation_1.isWrapped)(fs45.promises[fName])) {
-                this._unwrap(fs45.promises, fName);
+              if ((0, instrumentation_1.isWrapped)(fs46.promises[fName])) {
+                this._unwrap(fs46.promises, fName);
               }
-              this._wrap(fs45.promises, fName, this._patchPromiseFunction.bind(this, fName));
+              this._wrap(fs46.promises, fName, this._patchPromiseFunction.bind(this, fName));
             }
-            return fs45;
-          }, (fs45) => {
-            if (fs45 === void 0)
+            return fs46;
+          }, (fs46) => {
+            if (fs46 === void 0)
               return;
             for (const fName of constants_1.SYNC_FUNCTIONS) {
-              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs45, fName);
+              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs46, fName);
               if ((0, instrumentation_1.isWrapped)(objectToPatch[functionNameToPatch])) {
                 this._unwrap(objectToPatch, functionNameToPatch);
               }
             }
             for (const fName of constants_1.CALLBACK_FUNCTIONS) {
-              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs45, fName);
+              const { objectToPatch, functionNameToPatch } = (0, utils_1.indexFs)(fs46, fName);
               if ((0, instrumentation_1.isWrapped)(objectToPatch[functionNameToPatch])) {
                 this._unwrap(objectToPatch, functionNameToPatch);
               }
             }
             for (const fName of constants_1.PROMISE_FUNCTIONS) {
-              if ((0, instrumentation_1.isWrapped)(fs45.promises[fName])) {
-                this._unwrap(fs45.promises, fName);
+              if ((0, instrumentation_1.isWrapped)(fs46.promises[fName])) {
+                this._unwrap(fs46.promises, fName);
               }
             }
           }),
@@ -79247,14 +79247,14 @@ var require_AwsBeanstalkDetector = __commonJS({
     var core_1 = require_src();
     var semantic_conventions_1 = (init_esm2(), __toCommonJS(esm_exports2));
     var semconv_1 = require_semconv30();
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var util = __require("util");
     var DEFAULT_BEANSTALK_CONF_PATH = "/var/elasticbeanstalk/xray/environment.conf";
     var WIN_OS_BEANSTALK_CONF_PATH = "C:\\Program Files\\Amazon\\XRay\\environment.conf";
     var AwsBeanstalkDetector = class _AwsBeanstalkDetector {
       BEANSTALK_CONF_PATH;
-      static readFileAsync = util.promisify(fs45.readFile);
-      static fileAccessAsync = util.promisify(fs45.access);
+      static readFileAsync = util.promisify(fs46.readFile);
+      static fileAccessAsync = util.promisify(fs46.access);
       constructor() {
         if (process.platform === "win32") {
           this.BEANSTALK_CONF_PATH = WIN_OS_BEANSTALK_CONF_PATH;
@@ -79283,7 +79283,7 @@ var require_AwsBeanstalkDetector = __commonJS({
        */
       async _gatherData() {
         try {
-          await _AwsBeanstalkDetector.fileAccessAsync(this.BEANSTALK_CONF_PATH, fs45.constants.R_OK);
+          await _AwsBeanstalkDetector.fileAccessAsync(this.BEANSTALK_CONF_PATH, fs46.constants.R_OK);
           const rawData = await _AwsBeanstalkDetector.readFileAsync(this.BEANSTALK_CONF_PATH, "utf8");
           const parsedData = JSON.parse(rawData);
           return {
@@ -79458,14 +79458,14 @@ var require_AwsEcsDetector = __commonJS({
     var semconv_1 = require_semconv30();
     var http3 = __require("http");
     var util = __require("util");
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var os5 = __require("os");
     var HTTP_TIMEOUT_IN_MS = 1e3;
     var AwsEcsDetector = class _AwsEcsDetector {
       static CONTAINER_ID_LENGTH = 64;
       static CONTAINER_ID_LENGTH_MIN = 32;
       static DEFAULT_CGROUP_PATH = "/proc/self/cgroup";
-      static readFileAsync = util.promisify(fs45.readFile);
+      static readFileAsync = util.promisify(fs46.readFile);
       detect() {
         const attributes = api_1.context.with((0, core_1.suppressTracing)(api_1.context.active()), () => this._getAttributes());
         return { attributes };
@@ -79669,7 +79669,7 @@ var require_AwsEksDetector = __commonJS({
     var core_1 = require_src();
     var semconv_1 = require_semconv30();
     var https2 = __require("https");
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var util = __require("util");
     var api_2 = (init_esm(), __toCommonJS(esm_exports));
     var AwsEksDetector = class _AwsEksDetector {
@@ -79682,8 +79682,8 @@ var require_AwsEksDetector = __commonJS({
       DEFAULT_CGROUP_PATH = "/proc/self/cgroup";
       TIMEOUT_MS = 2e3;
       UTF8_UNICODE = "utf8";
-      static readFileAsync = util.promisify(fs45.readFile);
-      static fileAccessAsync = util.promisify(fs45.access);
+      static readFileAsync = util.promisify(fs46.readFile);
+      static fileAccessAsync = util.promisify(fs46.access);
       detect() {
         const dataPromise = api_1.context.with((0, core_1.suppressTracing)(api_1.context.active()), () => this._gatherData());
         const attrNames = [
@@ -80015,7 +80015,7 @@ var require_ContainerDetector = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.containerDetector = exports2.ContainerDetector = void 0;
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var util = __require("util");
     var api_1 = (init_esm(), __toCommonJS(esm_exports));
     var core_1 = require_src();
@@ -80028,7 +80028,7 @@ var require_ContainerDetector = __commonJS({
       UTF8_UNICODE = "utf8";
       HOSTNAME = "hostname";
       MARKING_PREFIX = ["containers", "overlay-containers"];
-      static readFileAsync = util.promisify(fs45.readFile);
+      static readFileAsync = util.promisify(fs46.readFile);
       detect() {
         const attributes = {
           [semconv_1.ATTR_CONTAINER_ID]: this._getContainerIdWithSuppressedTracing()
@@ -91095,7 +91095,7 @@ var require_AzureAksDetector = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.azureAksDetector = void 0;
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var api_1 = (init_esm(), __toCommonJS(esm_exports));
     var semconv_1 = require_semconv33();
     var types_1 = require_types13();
@@ -91136,10 +91136,10 @@ var require_AzureAksDetector = __commonJS({
       }
       getAksMetadataFromFile() {
         try {
-          if (!fs45.existsSync(types_1.AKS_METADATA_FILE_PATH)) {
+          if (!fs46.existsSync(types_1.AKS_METADATA_FILE_PATH)) {
             return void 0;
           }
-          const content = fs45.readFileSync(types_1.AKS_METADATA_FILE_PATH, "utf8");
+          const content = fs46.readFileSync(types_1.AKS_METADATA_FILE_PATH, "utf8");
           const metadata = {};
           const lines = content.split("\n");
           for (const line of lines) {
@@ -92919,7 +92919,7 @@ var require_atomic_sleep = __commonJS({
 var require_sonic_boom = __commonJS({
   "node_modules/sonic-boom/index.js"(exports2, module2) {
     "use strict";
-    var fs45 = __require("fs");
+    var fs46 = __require("fs");
     var EventEmitter = __require("events");
     var inherits = __require("util").inherits;
     var path47 = __require("path");
@@ -92976,20 +92976,20 @@ var require_sonic_boom = __commonJS({
       const mode = sonic.mode;
       if (sonic.sync) {
         try {
-          if (sonic.mkdir) fs45.mkdirSync(path47.dirname(file2), { recursive: true });
-          const fd = fs45.openSync(file2, flags, mode);
+          if (sonic.mkdir) fs46.mkdirSync(path47.dirname(file2), { recursive: true });
+          const fd = fs46.openSync(file2, flags, mode);
           fileOpened(null, fd);
         } catch (err) {
           fileOpened(err);
           throw err;
         }
       } else if (sonic.mkdir) {
-        fs45.mkdir(path47.dirname(file2), { recursive: true }, (err) => {
+        fs46.mkdir(path47.dirname(file2), { recursive: true }, (err) => {
           if (err) return fileOpened(err);
-          fs45.open(file2, flags, mode, fileOpened);
+          fs46.open(file2, flags, mode, fileOpened);
         });
       } else {
-        fs45.open(file2, flags, mode, fileOpened);
+        fs46.open(file2, flags, mode, fileOpened);
       }
     }
     function SonicBoom(opts) {
@@ -93030,8 +93030,8 @@ var require_sonic_boom = __commonJS({
         this.flush = flushBuffer;
         this.flushSync = flushBufferSync;
         this._actualWrite = actualWriteBuffer;
-        fsWriteSync = () => fs45.writeSync(this.fd, this._writingBuf);
-        fsWrite = () => fs45.write(this.fd, this._writingBuf, this.release);
+        fsWriteSync = () => fs46.writeSync(this.fd, this._writingBuf);
+        fsWrite = () => fs46.write(this.fd, this._writingBuf, this.release);
       } else if (contentMode === void 0 || contentMode === kContentModeUtf8) {
         this._writingBuf = "";
         this.write = write2;
@@ -93040,15 +93040,15 @@ var require_sonic_boom = __commonJS({
         this._actualWrite = actualWrite;
         fsWriteSync = () => {
           if (Buffer.isBuffer(this._writingBuf)) {
-            return fs45.writeSync(this.fd, this._writingBuf);
+            return fs46.writeSync(this.fd, this._writingBuf);
           }
-          return fs45.writeSync(this.fd, this._writingBuf, "utf8");
+          return fs46.writeSync(this.fd, this._writingBuf, "utf8");
         };
         fsWrite = () => {
           if (Buffer.isBuffer(this._writingBuf)) {
-            return fs45.write(this.fd, this._writingBuf, this.release);
+            return fs46.write(this.fd, this._writingBuf, this.release);
           }
-          return fs45.write(this.fd, this._writingBuf, "utf8", this.release);
+          return fs46.write(this.fd, this._writingBuf, "utf8", this.release);
         };
       } else {
         throw new Error(`SonicBoom supports "${kContentModeUtf8}" and "${kContentModeBuffer}", but passed ${contentMode}`);
@@ -93105,7 +93105,7 @@ var require_sonic_boom = __commonJS({
           }
         }
         if (this._fsync) {
-          fs45.fsyncSync(this.fd);
+          fs46.fsyncSync(this.fd);
         }
         const len = this._len;
         if (this._reopening) {
@@ -93219,7 +93219,7 @@ var require_sonic_boom = __commonJS({
       const onDrain = () => {
         if (!this._fsync) {
           try {
-            fs45.fsync(this.fd, (err) => {
+            fs46.fsync(this.fd, (err) => {
               this._flushPending = false;
               cb(err);
             });
@@ -93321,7 +93321,7 @@ var require_sonic_boom = __commonJS({
       const fd = this.fd;
       this.once("ready", () => {
         if (fd !== this.fd) {
-          fs45.close(fd, (err) => {
+          fs46.close(fd, (err) => {
             if (err) {
               return this.emit("error", err);
             }
@@ -93370,7 +93370,7 @@ var require_sonic_boom = __commonJS({
           buf = this._bufs[0];
         }
         try {
-          const n = Buffer.isBuffer(buf) ? fs45.writeSync(this.fd, buf) : fs45.writeSync(this.fd, buf, "utf8");
+          const n = Buffer.isBuffer(buf) ? fs46.writeSync(this.fd, buf) : fs46.writeSync(this.fd, buf, "utf8");
           const releasedBufObj = releaseWritingBuf(buf, this._len, n);
           buf = releasedBufObj.writingBuf;
           this._len = releasedBufObj.len;
@@ -93386,7 +93386,7 @@ var require_sonic_boom = __commonJS({
         }
       }
       try {
-        fs45.fsyncSync(this.fd);
+        fs46.fsyncSync(this.fd);
       } catch {
       }
     }
@@ -93407,7 +93407,7 @@ var require_sonic_boom = __commonJS({
           buf = mergeBuf(this._bufs[0], this._lens[0]);
         }
         try {
-          const n = fs45.writeSync(this.fd, buf);
+          const n = fs46.writeSync(this.fd, buf);
           buf = buf.subarray(n);
           this._len = Math.max(this._len - n, 0);
           if (buf.length <= 0) {
@@ -93435,13 +93435,13 @@ var require_sonic_boom = __commonJS({
       this._writingBuf = this._writingBuf.length ? this._writingBuf : this._bufs.shift() || "";
       if (this.sync) {
         try {
-          const written = Buffer.isBuffer(this._writingBuf) ? fs45.writeSync(this.fd, this._writingBuf) : fs45.writeSync(this.fd, this._writingBuf, "utf8");
+          const written = Buffer.isBuffer(this._writingBuf) ? fs46.writeSync(this.fd, this._writingBuf) : fs46.writeSync(this.fd, this._writingBuf, "utf8");
           release(null, written);
         } catch (err) {
           release(err);
         }
       } else {
-        fs45.write(this.fd, this._writingBuf, release);
+        fs46.write(this.fd, this._writingBuf, release);
       }
     }
     function actualWriteBuffer() {
@@ -93450,7 +93450,7 @@ var require_sonic_boom = __commonJS({
       this._writingBuf = this._writingBuf.length ? this._writingBuf : mergeBuf(this._bufs.shift(), this._lens.shift());
       if (this.sync) {
         try {
-          const written = fs45.writeSync(this.fd, this._writingBuf);
+          const written = fs46.writeSync(this.fd, this._writingBuf);
           release(null, written);
         } catch (err) {
           release(err);
@@ -93459,7 +93459,7 @@ var require_sonic_boom = __commonJS({
         if (kCopyBuffer) {
           this._writingBuf = Buffer.from(this._writingBuf);
         }
-        fs45.write(this.fd, this._writingBuf, release);
+        fs46.write(this.fd, this._writingBuf, release);
       }
     }
     function actualClose(sonic) {
@@ -93475,12 +93475,12 @@ var require_sonic_boom = __commonJS({
       sonic._lens = [];
       assert2(typeof sonic.fd === "number", `sonic.fd must be a number, got ${typeof sonic.fd}`);
       try {
-        fs45.fsync(sonic.fd, closeWrapped);
+        fs46.fsync(sonic.fd, closeWrapped);
       } catch {
       }
       function closeWrapped() {
         if (sonic.fd !== 1 && sonic.fd !== 2) {
-          fs45.close(sonic.fd, done);
+          fs46.close(sonic.fd, done);
         } else {
           done();
         }
@@ -96472,9 +96472,9 @@ var require_pump = __commonJS({
   "node_modules/pump/index.js"(exports2, module2) {
     var once = require_once();
     var eos = require_end_of_stream();
-    var fs45;
+    var fs46;
     try {
-      fs45 = __require("fs");
+      fs46 = __require("fs");
     } catch (e2) {
     }
     var noop2 = function() {
@@ -96485,8 +96485,8 @@ var require_pump = __commonJS({
     };
     var isFS = function(stream) {
       if (!ancient) return false;
-      if (!fs45) return false;
-      return (stream instanceof (fs45.ReadStream || noop2) || stream instanceof (fs45.WriteStream || noop2)) && isFn(stream.close);
+      if (!fs46) return false;
+      return (stream instanceof (fs46.ReadStream || noop2) || stream instanceof (fs46.WriteStream || noop2)) && isFn(stream.close);
     };
     var isRequest2 = function(stream) {
       return stream.setHeader && isFn(stream.abort);
@@ -113905,8 +113905,8 @@ import fsSync from "node:fs";
 import path5 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function getCurrentVersion() {
-  if ("0.2.21") {
-    return "0.2.21";
+  if ("0.2.23") {
+    return "0.2.23";
   }
   try {
     const pkgPath = path5.join(THIS_DIR, "..", "..", "package.json");
@@ -115213,7 +115213,9 @@ var init_labels = __esm({
       { name: "type:research", color: "0075CA" },
       { name: "type:infra", color: "5319E7" },
       { name: "needs-human", color: "d73a4a" },
-      { name: "approved", color: "0e8a16" }
+      { name: "approved", color: "0e8a16" },
+      { name: "decomposition:parent", color: "1d76db" },
+      { name: "decomposition:child", color: "5319e7" }
     ];
     STEP_ROUTING_COLOR = "#d93f0b";
     NOTIFY_LABEL_PREFIX = "notify:";
@@ -117293,21 +117295,21 @@ var init_types4 = __esm({
 });
 
 // lib/github/file-event-store.ts
-import fs27 from "node:fs/promises";
+import fs28 from "node:fs/promises";
 import path27 from "node:path";
 function encodeId(id) {
   return Buffer.from(id, "utf-8").toString("base64url");
 }
 async function atomicWriteJson(filePath, value) {
-  await fs27.mkdir(path27.dirname(filePath), { recursive: true });
+  await fs28.mkdir(path27.dirname(filePath), { recursive: true });
   const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
-  await fs27.writeFile(tmpPath, JSON.stringify(value, null, 2) + "\n", "utf-8");
-  await fs27.rename(tmpPath, filePath);
+  await fs28.writeFile(tmpPath, JSON.stringify(value, null, 2) + "\n", "utf-8");
+  await fs28.rename(tmpPath, filePath);
 }
 async function writeNewJsonExclusive(filePath, value) {
-  await fs27.mkdir(path27.dirname(filePath), { recursive: true });
+  await fs28.mkdir(path27.dirname(filePath), { recursive: true });
   try {
-    await fs27.writeFile(filePath, JSON.stringify(value, null, 2) + "\n", {
+    await fs28.writeFile(filePath, JSON.stringify(value, null, 2) + "\n", {
       encoding: "utf-8",
       flag: "wx"
     });
@@ -117319,7 +117321,7 @@ async function writeNewJsonExclusive(filePath, value) {
 }
 async function readJsonFile(filePath) {
   try {
-    const raw = await fs27.readFile(filePath, "utf-8");
+    const raw = await fs28.readFile(filePath, "utf-8");
     return JSON.parse(raw);
   } catch (error48) {
     if (error48?.code === "ENOENT") return null;
@@ -117378,7 +117380,7 @@ var init_file_event_store = __esm({
         const dir = this.storeDir;
         let entries = [];
         try {
-          entries = await fs27.readdir(dir);
+          entries = await fs28.readdir(dir);
         } catch (error48) {
           if (error48?.code === "ENOENT") return [];
           throw error48;
@@ -117396,7 +117398,7 @@ var init_file_event_store = __esm({
         const dir = this.storeDir;
         let entries = [];
         try {
-          entries = await fs27.readdir(dir);
+          entries = await fs28.readdir(dir);
         } catch (error48) {
           if (error48?.code === "ENOENT") return [];
           throw error48;
@@ -117466,14 +117468,14 @@ var init_file_event_store = __esm({
       async save(run) {
         const validated = fabricaRunSchema.parse(run);
         try {
-          const entries = await fs27.readdir(this.storeDir);
+          const entries = await fs28.readdir(this.storeDir);
           for (const entry of entries) {
             const filePath = path27.join(this.storeDir, entry);
             const existing = await readJsonFile(filePath);
             if (!existing) continue;
             const parsed = fabricaRunSchema.parse(existing);
             if (parsed.runId !== validated.runId && parsed.installationId === validated.installationId && parsed.repositoryId === validated.repositoryId && parsed.prNumber === validated.prNumber) {
-              await fs27.rm(filePath, { force: true });
+              await fs28.rm(filePath, { force: true });
             }
           }
         } catch (error48) {
@@ -117489,7 +117491,7 @@ var init_file_event_store = __esm({
         const dir = this.storeDir;
         let entries = [];
         try {
-          entries = await fs27.readdir(dir);
+          entries = await fs28.readdir(dir);
         } catch (error48) {
           if (error48?.code === "ENOENT") return [];
           throw error48;
@@ -117510,7 +117512,7 @@ var init_file_event_store = __esm({
 });
 
 // lib/github/sqlite-event-store.ts
-import fs28 from "node:fs/promises";
+import fs29 from "node:fs/promises";
 import path28 from "node:path";
 function asNumber(value) {
   if (typeof value === "number" && Number.isFinite(value)) return value;
@@ -117569,7 +117571,7 @@ async function loadSqliteModule() {
   return loaded;
 }
 async function openDatabase(dbPath) {
-  await fs28.mkdir(path28.dirname(dbPath), { recursive: true });
+  await fs29.mkdir(path28.dirname(dbPath), { recursive: true });
   const sqlite = await loadSqliteModule();
   const db = new sqlite.DatabaseSync(dbPath);
   db.exec(`
@@ -118183,7 +118185,7 @@ var init_extract_json = __esm({
 });
 
 // lib/intake/lib/runtime-paths.ts
-import fs30 from "node:fs";
+import fs31 from "node:fs";
 import fsp from "node:fs/promises";
 import os4 from "node:os";
 import path30 from "node:path";
@@ -118191,7 +118193,7 @@ import { fileURLToPath as fileURLToPath4 } from "node:url";
 function isUsableFile(candidate) {
   if (!candidate) return false;
   try {
-    return fs30.existsSync(candidate) && fs30.statSync(candidate).isFile();
+    return fs31.existsSync(candidate) && fs31.statSync(candidate).isFile();
   } catch {
     return false;
   }
@@ -118199,7 +118201,7 @@ function isUsableFile(candidate) {
 function isUsableDir(candidate) {
   if (!candidate) return false;
   try {
-    return fs30.existsSync(candidate) && fs30.statSync(candidate).isDirectory();
+    return fs31.existsSync(candidate) && fs31.statSync(candidate).isDirectory();
   } catch {
     return false;
   }
@@ -118207,7 +118209,7 @@ function isUsableDir(candidate) {
 function findNewestNvmOpenClaw(homeDir, env) {
   const versionsDir = path30.join(homeDir, ".nvm", "versions", "node");
   try {
-    const versions = fs30.readdirSync(versionsDir).sort().reverse();
+    const versions = fs31.readdirSync(versionsDir).sort().reverse();
     for (const version2 of versions) {
       const candidate = path30.join(versionsDir, version2, "bin", "openclaw");
       if (isUsableFile(candidate)) return candidate;
@@ -118618,9 +118620,9 @@ function fallbackSpecData(type, rawIdea) {
     default:
       base.scope_v1 = deriveFeatureScopeFromRawIdea(rawIdea);
       base.acceptance_criteria = [
-        "The primary workflow works end to end as requested",
-        "Role, validation, or delivery constraints from the request are enforced",
-        "The asynchronous/background behavior works for the main operational path"
+        "Allows operators to complete the primary workflow end to end as requested",
+        "Validates and enforces the role, permission, or delivery constraints described in the request",
+        "Processes the asynchronous or background behavior required for the main operational path"
       ];
   }
   return base;
@@ -122062,6 +122064,37 @@ function getRoleWorker(project, role) {
 function getIssueRuntime(project, issueId) {
   return project.issueRuntime?.[String(issueId)];
 }
+function isParentIssue(project, issueId) {
+  const runtime = getIssueRuntime(project, issueId);
+  return !!(runtime && ((runtime.childIssueIds?.length ?? 0) > 0 || runtime.decompositionMode === "parent_child"));
+}
+function isChildIssue(project, issueId) {
+  const runtime = getIssueRuntime(project, issueId);
+  return runtime?.parentIssueId != null;
+}
+function getParentIssueRuntime(project, issueId) {
+  const runtime = getIssueRuntime(project, issueId);
+  if (!runtime?.parentIssueId) return void 0;
+  return getIssueRuntime(project, runtime.parentIssueId);
+}
+function getChildIssueRuntimes(project, issueId) {
+  const runtime = getIssueRuntime(project, issueId);
+  return (runtime?.childIssueIds ?? []).map((childIssueId) => ({
+    issueId: childIssueId,
+    runtime: getIssueRuntime(project, childIssueId)
+  }));
+}
+function getDependencyIssueRuntimes(project, issueId) {
+  const runtime = getIssueRuntime(project, issueId);
+  return (runtime?.dependencyIssueIds ?? []).map((dependencyIssueId) => ({
+    issueId: dependencyIssueId,
+    runtime: getIssueRuntime(project, dependencyIssueId)
+  }));
+}
+function isIssueExecutionComplete(project, issueId) {
+  const runtime = getIssueRuntime(project, issueId);
+  return !!(runtime?.decompositionStatus === "completed" || runtime?.artifactOfRecord?.mergedAt || runtime?.sessionCompletedAt);
+}
 async function updateSlot(workspaceDir, slugOrChannelId, role, level, slotIndex, updates) {
   const { data } = await withProjectsMutation(workspaceDir, (data2) => {
     const slug = resolveProjectSlug(data2, slugOrChannelId);
@@ -122226,7 +122259,22 @@ async function clearIssueRuntime(workspaceDir, slugOrChannelId, issueId) {
     }
     const project = data2.projects[slug];
     if (project.issueRuntime) {
-      delete project.issueRuntime[String(issueId)];
+      const key = String(issueId);
+      const existing = project.issueRuntime[key];
+      const preserved = existing ? {
+        parentIssueId: existing.parentIssueId ?? null,
+        childIssueIds: existing.childIssueIds,
+        dependencyIssueIds: existing.dependencyIssueIds,
+        decompositionMode: existing.decompositionMode ?? null,
+        decompositionStatus: existing.parentIssueId ? "completed" : existing.decompositionStatus ?? null,
+        sessionCompletedAt: existing.sessionCompletedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+        artifactOfRecord: existing.artifactOfRecord ?? null
+      } : null;
+      if (preserved && (preserved.parentIssueId != null || (preserved.childIssueIds?.length ?? 0) > 0 || (preserved.dependencyIssueIds?.length ?? 0) > 0 || preserved.decompositionMode != null)) {
+        project.issueRuntime[key] = preserved;
+      } else {
+        delete project.issueRuntime[key];
+      }
     }
   });
   return data;
@@ -123104,11 +123152,11 @@ var GitLabProvider = class {
       const token = tokenRaw.stdout.trim();
       if (!token) return null;
       const os5 = await import("node:os");
-      const fs45 = await import("node:fs/promises");
+      const fs46 = await import("node:fs/promises");
       const path47 = await import("node:path");
-      const tmpDir = await fs45.mkdtemp(path47.join(os5.tmpdir(), "fabrica-upload-"));
+      const tmpDir = await fs46.mkdtemp(path47.join(os5.tmpdir(), "fabrica-upload-"));
       const tmpFile = path47.join(tmpDir, file2.filename);
-      await fs45.writeFile(tmpFile, file2.buffer);
+      await fs46.writeFile(tmpFile, file2.buffer);
       try {
         const apiBase = webUrl.replace(/\/[^/]+\/[^/]+\/?$/, "");
         const result = await this.runCommand(
@@ -123130,9 +123178,9 @@ var GitLabProvider = class {
         if (parsed.url) return `${webUrl}${parsed.url}`;
         return null;
       } finally {
-        await fs45.unlink(tmpFile).catch(() => {
+        await fs46.unlink(tmpFile).catch(() => {
         });
-        await fs45.rmdir(tmpDir).catch(() => {
+        await fs46.rmdir(tmpDir).catch(() => {
         });
       }
     } catch {
@@ -125007,12 +125055,12 @@ function prLink(url2) {
 function buildMessage(event) {
   switch (event.type) {
     case "workerStart": {
-      const action = event.sessionAction === "spawn" ? "\u{1F680} Started" : "\u25B6\uFE0F Resumed";
+      const semanticAction = event.dispatchSemantic === "feedback_redispatch" ? "\u{1F501} Re-dispatched after feedback" : event.dispatchSemantic === "recovery_redispatch" ? "\u267B\uFE0F Re-dispatched after recovery" : event.dispatchSemantic === "bootstrap_initial_dispatch" ? "\u{1F9F1} Started from bootstrap" : event.sessionAction === "spawn" ? "\u{1F680} Started" : "\u25B6\uFE0F Resumed";
       const worker = formatWorkerString(event.role, {
         name: event.name,
         level: event.level
       });
-      let msg = `${action} ${worker} on #${event.issueId}: ${event.issueTitle}
+      let msg = `${semanticAction} ${worker} on #${event.issueId}: ${event.issueTitle}
 \u{1F517} [Issue #${event.issueId}](${event.issueUrl})`;
       if (event.modelDowngraded && event.originalModel && event.effectiveModel) {
         msg += `
@@ -125457,6 +125505,45 @@ init_audit();
 
 // lib/services/queue-scan.ts
 init_roles();
+
+// lib/services/family-scheduler.ts
+function countActiveSiblingChildren(project, parentIssueId, currentIssueId) {
+  const activeIssueIds = /* @__PURE__ */ new Set();
+  for (const roleWorker of Object.values(project.workers ?? {})) {
+    for (const slots of Object.values(roleWorker.levels ?? {})) {
+      for (const slot of slots) {
+        if (!slot.active || !slot.issueId) continue;
+        const activeIssueId = Number(slot.issueId);
+        if (!Number.isFinite(activeIssueId) || activeIssueId === currentIssueId) continue;
+        activeIssueIds.add(activeIssueId);
+      }
+    }
+  }
+  return [...activeIssueIds].filter((issueId) => getIssueRuntime(project, issueId)?.parentIssueId === parentIssueId).length;
+}
+function getFamilyDispatchBlockReason(project, issueId, role) {
+  const runtime = getIssueRuntime(project, issueId);
+  if (isParentIssue(project, issueId)) {
+    return role === "developer" ? "family_parent_coordinator_only" : "family_parent_not_executable";
+  }
+  if (isChildIssue(project, issueId)) {
+    const parentRuntime = getParentIssueRuntime(project, issueId);
+    if (parentRuntime?.decompositionStatus === "draft") return "family_parent_decomposition_draft";
+    if (parentRuntime?.decompositionStatus === "blocked") return "family_parent_blocked";
+    if (parentRuntime?.decompositionStatus === "completed") return "family_parent_completed";
+    if (!runtime?.parentIssueId) return "family_child_missing_parent_binding";
+    const maxParallelChildren = parentRuntime?.maxParallelChildren ?? null;
+    if (maxParallelChildren && maxParallelChildren > 0) {
+      const activeSiblingChildren = countActiveSiblingChildren(project, runtime.parentIssueId, issueId);
+      if (activeSiblingChildren >= maxParallelChildren) return `family_parallel_limit_reached:${maxParallelChildren}`;
+    }
+    const incompleteDependencies = getDependencyIssueRuntimes(project, issueId).filter((dependency) => !isIssueExecutionComplete(project, dependency.issueId)).map((dependency) => dependency.issueId);
+    if (incompleteDependencies.length > 0) return `family_child_dependencies_pending:${incompleteDependencies.join(",")}`;
+  }
+  return null;
+}
+
+// lib/services/queue-scan.ts
 init_workflow();
 function detectRoleLevelFromLabels(labels) {
   for (const label of labels) {
@@ -125476,19 +125563,144 @@ function detectStepRouting(labels, step) {
   const match = labels.find((l) => l.toLowerCase().startsWith(prefix));
   return match ? match.slice(prefix.length).toLowerCase() : null;
 }
-async function findNextIssueForRole(provider, role, workflow, instanceName) {
+async function findNextIssueForRole(provider, role, workflow, instanceName, project) {
   const labels = getQueueLabels(workflow, role);
   for (const label of labels) {
     try {
       const issues = await provider.listIssuesByLabel(label);
       const eligible = instanceName ? issues.filter((i2) => isOwnedByOrUnclaimed(i2.labels, instanceName)) : issues;
-      if (eligible.length > 0) return { issue: eligible[eligible.length - 1], label };
+      for (let index = eligible.length - 1; index >= 0; index -= 1) {
+        const issue2 = eligible[index];
+        const blockReason = project ? getFamilyDispatchBlockReason(project, issue2.iid, role) : null;
+        if (!blockReason) return { issue: issue2, label };
+      }
     } catch {
     }
   }
   return null;
 }
 
+// lib/services/parent-lifecycle.ts
+function getTerminalLabel(workflow) {
+  return Object.values(workflow.states).find((state) => state.type === "terminal")?.label ?? null;
+}
+function getCurrentWorkflowLabel(issueLabels, workflow) {
+  const labels = new Set(issueLabels);
+  return Object.values(workflow.states).find((state) => labels.has(state.label))?.label ?? null;
+}
+function sameIds(a, b) {
+  const left = [...a ?? []].sort((x2, y) => x2 - y);
+  const right = [...b ?? []].sort((x2, y) => x2 - y);
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function resolveChildRollupState(runtime) {
+  if (!runtime) return "pending_without_runtime";
+  if (runtime.decompositionStatus === "blocked") return "blocked";
+  if (runtime.artifactOfRecord?.mergedAt) return "completed_via_artifact";
+  if (runtime.sessionCompletedAt) return "completed_via_session";
+  if (runtime.currentPrUrl && runtime.currentPrState && runtime.currentPrState !== "merged" && runtime.currentPrState !== "closed") {
+    return "pending_with_open_pr";
+  }
+  if (runtime.currentPrUrl) return "pending_with_pr";
+  return "pending_without_pr";
+}
+function formatChildRollupLine(child) {
+  const runtime = child.runtime;
+  const state = resolveChildRollupState(runtime);
+  const prUrl = runtime?.artifactOfRecord?.url ?? runtime?.currentPrUrl ?? null;
+  const mergedAt = runtime?.artifactOfRecord?.mergedAt ?? null;
+  const headSha = runtime?.artifactOfRecord?.headSha ?? runtime?.lastHeadSha ?? null;
+  const extras = [
+    prUrl ? `PR: ${prUrl}` : null,
+    mergedAt ? `mergedAt: ${mergedAt}` : null,
+    headSha ? `headSha: ${headSha}` : null
+  ].filter(Boolean);
+  return `- #${child.issueId} \u2014 ${state}${extras.length > 0 ? ` \u2014 ${extras.join(" \u2014 ")}` : ""}`;
+}
+var PARENT_ROLLUP_START = "<!-- fabrica:parent-rollup:start -->";
+var PARENT_ROLLUP_END = "<!-- fabrica:parent-rollup:end -->";
+function buildParentRollupComment(status, completedChildIds, blockedChildIds, children) {
+  const allChildIds = children.map((child) => child.issueId);
+  const pendingChildIds = allChildIds.filter((id) => !completedChildIds.includes(id) && !blockedChildIds.includes(id));
+  return [
+    "## Parent Rollup",
+    `- Status: ${status}`,
+    `- Completed children (${completedChildIds.length}/${allChildIds.length}): ${completedChildIds.length > 0 ? completedChildIds.map((id) => `#${id}`).join(", ") : "none"}`,
+    `- Pending children: ${pendingChildIds.length > 0 ? pendingChildIds.map((id) => `#${id}`).join(", ") : "none"}`,
+    `- Blocked children: ${blockedChildIds.length > 0 ? blockedChildIds.map((id) => `#${id}`).join(", ") : "none"}`,
+    "",
+    "### Child Status",
+    ...children.map((child) => formatChildRollupLine(child))
+  ].join("\n");
+}
+function upsertParentRollupBlock(body, rollup) {
+  const current = body ?? "";
+  const block = `${PARENT_ROLLUP_START}
+${rollup}
+${PARENT_ROLLUP_END}`;
+  const pattern = new RegExp(`${PARENT_ROLLUP_START}[\\s\\S]*?${PARENT_ROLLUP_END}`, "m");
+  if (pattern.test(current)) {
+    return current.replace(pattern, block);
+  }
+  return `${current.trimEnd()}${current.trim().length > 0 ? "\n\n" : ""}${block}`;
+}
+async function reconcileParentLifecycleForIssue(opts) {
+  const project = await loadProjectBySlug(opts.workspaceDir, opts.projectSlug);
+  if (!project || !isChildIssue(project, opts.issueId)) return;
+  const childRuntime = getIssueRuntime(project, opts.issueId);
+  const parentRuntime = getParentIssueRuntime(project, opts.issueId);
+  const parentIssueId = childRuntime?.parentIssueId;
+  if (!parentIssueId || !parentRuntime) return;
+  const children = getChildIssueRuntimes(project, parentIssueId);
+  if (children.length === 0) return;
+  const completedChildIds = children.filter((child) => isIssueExecutionComplete(project, child.issueId)).map((child) => child.issueId);
+  const blockedChildIds = children.filter((child) => child.runtime?.decompositionStatus === "blocked").map((child) => child.issueId);
+  const hasBlockedChild = blockedChildIds.length > 0;
+  const allChildrenComplete = completedChildIds.length === children.length;
+  const targetStatus = allChildrenComplete ? "completed" : hasBlockedChild ? "blocked" : "active";
+  const statusChanged = parentRuntime.decompositionStatus !== targetStatus;
+  const completedChanged = !sameIds(parentRuntime.completedChildIssueIds, completedChildIds);
+  const blockedChanged = !sameIds(parentRuntime.blockedChildIssueIds, blockedChildIds);
+  const shouldUpdateRuntime = statusChanged || completedChanged || blockedChanged;
+  const shouldCommentRollup = statusChanged || blockedChanged;
+  if (shouldUpdateRuntime) {
+    await updateIssueRuntime(opts.workspaceDir, opts.projectSlug, parentIssueId, {
+      decompositionStatus: targetStatus,
+      completedChildIssueIds: completedChildIds,
+      blockedChildIssueIds: blockedChildIds,
+      lastParentRollupAt: (/* @__PURE__ */ new Date()).toISOString()
+    }).catch(() => {
+    });
+  }
+  const parentIssue = await opts.provider.getIssue(parentIssueId).catch(() => null);
+  if (!parentIssue) return;
+  const rollup = buildParentRollupComment(targetStatus, completedChildIds, blockedChildIds, children);
+  if (shouldUpdateRuntime) {
+    await opts.provider.editIssue(parentIssueId, {
+      body: upsertParentRollupBlock(parentIssue.description, rollup)
+    }).catch(() => {
+    });
+    if (shouldCommentRollup) {
+      await opts.provider.addComment(parentIssueId, rollup).catch(() => {
+      });
+    }
+  }
+  if (!allChildrenComplete) return;
+  const terminalLabel = getTerminalLabel(opts.workflow);
+  const currentLabel = getCurrentWorkflowLabel(parentIssue.labels, opts.workflow);
+  if (terminalLabel && currentLabel && currentLabel !== terminalLabel && !parentIssue.labels.includes(terminalLabel)) {
+    await opts.provider.transitionLabel(parentIssueId, currentLabel, terminalLabel).catch(() => {
+    });
+  }
+  await opts.provider.addComment(parentIssueId, [
+    "\u2705 Parent coordination complete.",
+    "",
+    "All child issues in this decomposition family have completed execution.",
+    ...children.map((child) => formatChildRollupLine(child))
+  ].join("\n")).catch(() => {
+  });
+}
+
 // lib/services/pipeline.ts
 init_workflow();
 init_context3();
@@ -125765,7 +125977,33 @@ async function executeCompletion(opts) {
         break;
     }
   }
+  if (issueRuntime?.parentIssueId) {
+    const childDecompositionStatus = effectiveResult === "blocked" || effectiveResult === "refine" || effectiveResult === "fail_infra" ? "blocked" : effectiveResult === "fail" || effectiveResult === "reject" ? "active" : issueRuntime.decompositionStatus;
+    if (childDecompositionStatus !== issueRuntime.decompositionStatus) {
+      await updateIssueRuntime(workspaceDir, projectSlug, issueId, {
+        decompositionStatus: childDecompositionStatus
+      }).catch(() => {
+      });
+    }
+  }
+  if (issueRuntime?.parentIssueId) {
+    const childDecompositionStatus = effectiveResult === "blocked" || effectiveResult === "refine" || effectiveResult === "fail_infra" ? "blocked" : effectiveResult === "fail" || effectiveResult === "reject" ? "active" : issueRuntime.decompositionStatus;
+    if (childDecompositionStatus !== issueRuntime.decompositionStatus) {
+      await updateIssueRuntime(workspaceDir, projectSlug, issueId, {
+        decompositionStatus: childDecompositionStatus
+      }).catch(() => {
+      });
+    }
+  }
   await deactivateWorker(workspaceDir, projectSlug, role, { level: opts.level, slotIndex: opts.slotIndex, issueId: String(issueId) });
+  await reconcileParentLifecycleForIssue({
+    workspaceDir,
+    projectSlug,
+    issueId,
+    provider,
+    workflow
+  }).catch(() => {
+  });
   notify(
     {
       type: "workerComplete",
@@ -126138,7 +126376,7 @@ function validateCanonicalQaEvidence(body) {
 }
 function formatQaEvidenceValidationFailure(validation, actor) {
   const intro = actor === "developer" ? "Cannot mark work_finish(done) with invalid QA Evidence in the PR body." : "Cannot approve review with invalid QA Evidence in the PR body.";
-  const guidance = actor === "developer" ? 'Replace the existing "## QA Evidence" section with fresh sanitized output from scripts/qa.sh (exactly one section, Exit code: 0), then call work_finish again.' : 'Reject the PR and instruct the developer to replace the existing "## QA Evidence" section in the PR body with fresh sanitized output from scripts/qa.sh (exactly one section, Exit code: 0).';
+  const guidance = actor === "developer" ? 'Replace the existing "## QA Evidence" section with fresh sanitized output from scripts/qa.sh (exactly one section, Exit code: 0), then call work_finish again. Do not rewrite or weaken scripts/qa.sh into ad-hoc scenario checks \u2014 preserve the canonical lint/types/security/tests/coverage gates and fix the underlying code or project setup instead.' : 'Reject the PR and instruct the developer to replace the existing "## QA Evidence" section in the PR body with fresh sanitized output from scripts/qa.sh (exactly one section, Exit code: 0). Do not accept ad-hoc scenario scripts or weakened QA gates in place of the canonical lint/types/security/tests/coverage contract.';
   const allIssues = [...validation.problems, ...validation.errors];
   return `${intro}
 
@@ -126826,13 +127064,17 @@ function createTaskCreateTool(ctx) {
       });
       if (parentIssueId) {
         await updateIssueRuntime(workspaceDir, project.slug, issue2.iid, {
-          parentIssueId
+          parentIssueId,
+          decompositionMode: "none",
+          decompositionStatus: null
         }).catch(() => {
         });
         const parentRuntime = project.issueRuntime?.[String(parentIssueId)] ?? {};
         const previousChildren = Array.isArray(parentRuntime.childIssueIds) ? parentRuntime.childIssueIds : [];
         await updateIssueRuntime(workspaceDir, project.slug, parentIssueId, {
-          childIssueIds: [.../* @__PURE__ */ new Set([...previousChildren, issue2.iid])]
+          childIssueIds: [.../* @__PURE__ */ new Set([...previousChildren, issue2.iid])],
+          decompositionMode: "parent_child",
+          decompositionStatus: "active"
         }).catch(() => {
         });
         provider.addComment(
@@ -127716,6 +127958,7 @@ function createTaskOwnerTool(ctx) {
 
 // lib/dispatch/index.ts
 init_audit();
+import fs22 from "node:fs/promises";
 import { randomUUID as randomUUID2 } from "node:crypto";
 init_roles();
 init_workflow();
@@ -128136,6 +128379,13 @@ init_roles();
 function toBranchSlug(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48) || "task";
 }
+function resolveExecutionSetup(opts) {
+  const branchName = opts.prBranchName?.trim() ? opts.prBranchName.trim() : `feature/${opts.issueId}-${toBranchSlug(opts.projectName)}`;
+  return {
+    branchName,
+    worktreePath: `${opts.repo}.worktrees/${branchName}`
+  };
+}
 function buildTaskMessage(opts) {
   const {
     projectName,
@@ -128150,8 +128400,12 @@ function buildTaskMessage(opts) {
   } = opts;
   const repoDisplay = repo;
   const isFeedbackCycle = !!opts.prFeedback;
-  const branchName = opts.prFeedback?.branchName?.trim() ? opts.prFeedback.branchName.trim() : `feature/${issueId}-${toBranchSlug(projectName)}`;
-  const worktreePath = `${repoDisplay}.worktrees/${branchName}`;
+  const { branchName, worktreePath } = resolveExecutionSetup({
+    projectName,
+    issueId,
+    repo: repoDisplay,
+    prBranchName: opts.prFeedback?.branchName
+  });
   const parts = [
     `${role.toUpperCase()} task for project "${projectName}" \u2014 Issue #${issueId}`,
     ``,
@@ -128172,10 +128426,11 @@ ${issueDescription}` : ""
     ``,
     `## Execution Setup (do this before editing files)`,
     `Repo: ${repoDisplay} | Base branch: ${baseBranch} | ${issueUrl}`,
-    `Execution path: ${repoDisplay}`,
+    `Execution path: ${worktreePath}`,
+    `Main checkout: ${repoDisplay}`,
     `Required branch: ${branchName}`,
     `Required worktree: ${worktreePath}`,
-    `Before editing any file, create or reuse the required worktree above and work only there.`,
+    `Before editing any file, change into the execution path above and work only there.`,
     `Do not re-initialize or replace the scaffold in the main checkout (for example: do not run npm init, cargo init, uv init, or create a second project skeleton) when the repo already contains scaffolded files. Modify the existing scaffold inside the worktree instead.`,
     `If the repo path is missing or inaccessible, return the canonical blocked result instead of improvising in ~/.openclaw/workspace.`
   );
@@ -128242,8 +128497,12 @@ function buildConflictFixMessage(opts) {
     prFeedback
   } = opts;
   const repoDisplay = repo;
-  const branchName = prFeedback.branchName?.trim() ? prFeedback.branchName.trim() : `feature/${issueId}-${toBranchSlug(projectName)}`;
-  const worktreePath = `${repoDisplay}.worktrees/${branchName}`;
+  const { branchName, worktreePath } = resolveExecutionSetup({
+    projectName,
+    issueId,
+    repo: repoDisplay,
+    prBranchName: prFeedback.branchName
+  });
   const parts = [
     `${role.toUpperCase()} task for project "${projectName}" \u2014 Issue #${issueId}`,
     ``,
@@ -128256,10 +128515,11 @@ function buildConflictFixMessage(opts) {
     ``,
     `Repo: ${repoDisplay} | Base branch: ${baseBranch} | ${issueUrl}`,
     `Project: ${projectName} | Channel: ${channelId}`,
-    `Execution path: ${repoDisplay}`,
+    `Execution path: ${worktreePath}`,
+    `Main checkout: ${repoDisplay}`,
     `Required branch: ${branchName}`,
     `Required worktree: ${worktreePath}`,
-    `Start by changing into the canonical repo path above before reusing the PR branch or creating its worktree. Reuse the exact PR branch named above; do not switch to a new canonical issue branch during a feedback cycle. Do not resolve the issue inside ~/.openclaw/workspace unless the repo path itself points there.`
+    `Start by changing into the execution path above before reusing the PR branch. Reuse the exact PR branch named above; do not switch to a new canonical issue branch during a feedback cycle. Do not resolve the issue inside ~/.openclaw/workspace unless the repo path itself points there.`
   );
   parts.push(...buildCompletionContract(role));
   return parts.join("\n");
@@ -128592,23 +128852,24 @@ ${roleInstructions}`;
   }
   return effortPrefix ?? roleInstructions ?? "";
 }
-function sendToAgent(sessionKey, taskMessage, opts) {
+async function sendToAgent(sessionKey, taskMessage, opts) {
   const epoch = opts.dispatchEpoch ?? (/* @__PURE__ */ new Date()).toISOString();
   const idempotencyKey = `fabrica-${opts.projectName}-${opts.issueId}-${opts.role}-${opts.level ?? "unknown"}-${opts.slotIndex ?? 0}-${opts.fromLabel ?? "unknown"}-${sessionKey}-${epoch}`;
   if (opts.runtime?.subagent?.run) {
-    opts.runtime.subagent.run({
-      sessionKey,
-      message: taskMessage,
-      idempotencyKey,
-      lane: "subagent",
-      deliver: false,
-      ...opts.extraSystemPrompt ? { extraSystemPrompt: opts.extraSystemPrompt } : {}
-    }).then((result) => {
+    try {
+      const result = await opts.runtime.subagent.run({
+        sessionKey,
+        message: taskMessage,
+        idempotencyKey,
+        lane: "subagent",
+        deliver: false,
+        ...opts.extraSystemPrompt ? { extraSystemPrompt: opts.extraSystemPrompt } : {}
+      });
       if (result?.runId) {
-        bindDispatchRunIdBySessionKey(opts.workspaceDir, sessionKey, result.runId).catch(() => {
+        await bindDispatchRunIdBySessionKey(opts.workspaceDir, sessionKey, result.runId).catch(() => {
         });
       }
-      log(opts.workspaceDir, "dispatch_agent_sent", {
+      await log(opts.workspaceDir, "dispatch_agent_sent", {
         step: "sendToAgent",
         sessionKey,
         issue: opts.issueId,
@@ -128617,7 +128878,7 @@ function sendToAgent(sessionKey, taskMessage, opts) {
         runId: result?.runId ?? null
       }).catch(() => {
       });
-      recordIssueLifecycle({
+      await recordIssueLifecycle({
         workspaceDir: opts.workspaceDir,
         slug: opts.projectSlug ?? opts.projectName,
         issueId: opts.issueId,
@@ -128626,18 +128887,23 @@ function sendToAgent(sessionKey, taskMessage, opts) {
         details: { method: "runtime.subagent.run" }
       }).catch(() => {
       });
-    }).catch((err) => {
+      return { method: "runtime.subagent.run", runId: result?.runId ?? null };
+    } catch (err) {
+      const errorMessage = err.message ?? String(err);
       log(opts.workspaceDir, "dispatch_warning", {
         step: "sendToAgent",
         sessionKey,
         issue: opts.issueId,
         role: opts.role,
         method: "runtime.subagent.run",
-        error: err.message ?? String(err)
+        error: errorMessage
       }).catch(() => {
       });
-    });
-    return;
+      if (/only available during a gateway request/i.test(errorMessage)) {
+      } else {
+        throw err;
+      }
+    }
   }
   const rc = opts.runCommand;
   const gatewayParams = JSON.stringify({
@@ -128650,11 +128916,45 @@ function sendToAgent(sessionKey, taskMessage, opts) {
     ...opts.orchestratorSessionKey ? { spawnedBy: opts.orchestratorSessionKey } : {},
     ...opts.extraSystemPrompt ? { extraSystemPrompt: opts.extraSystemPrompt } : {}
   });
-  rc(
-    ["openclaw", "gateway", "call", "agent", "--params", gatewayParams, "--expect-final", "--json"],
-    { timeoutMs: opts.dispatchTimeoutMs ?? 6e4 }
-  ).catch((err) => {
-    log(opts.workspaceDir, "dispatch_warning", {
+  try {
+    const response = await rc(
+      ["openclaw", "gateway", "call", "agent", "--params", gatewayParams, "--expect-final", "--json"],
+      { timeoutMs: opts.dispatchTimeoutMs ?? 6e4 }
+    );
+    const stdout = String(response.stdout ?? "").trim();
+    let runId = null;
+    if (stdout) {
+      try {
+        const parsed = JSON.parse(stdout);
+        runId = parsed.runId ?? parsed.result?.runId ?? null;
+      } catch {
+      }
+    }
+    if (runId) {
+      await bindDispatchRunIdBySessionKey(opts.workspaceDir, sessionKey, runId).catch(() => {
+      });
+    }
+    await log(opts.workspaceDir, "dispatch_agent_sent", {
+      step: "sendToAgent",
+      sessionKey,
+      issue: opts.issueId,
+      role: opts.role,
+      method: "subprocess_fallback",
+      runId
+    }).catch(() => {
+    });
+    await recordIssueLifecycle({
+      workspaceDir: opts.workspaceDir,
+      slug: opts.projectSlug ?? opts.projectName,
+      issueId: opts.issueId,
+      stage: "agent_accepted",
+      sessionKey,
+      details: { method: "subprocess_fallback", runId }
+    }).catch(() => {
+    });
+    return { method: "subprocess_fallback", runId };
+  } catch (err) {
+    await log(opts.workspaceDir, "dispatch_warning", {
       step: "sendToAgent",
       sessionKey,
       issue: opts.issueId,
@@ -128663,7 +128963,8 @@ function sendToAgent(sessionKey, taskMessage, opts) {
       error: err.message ?? String(err)
     }).catch(() => {
     });
-  });
+    throw err;
+  }
 }
 function normalizeGatewaySessionLabel(label, maxLength = GATEWAY_SESSION_LABEL_MAX) {
   if (!label) return { truncated: false };
@@ -128784,7 +129085,8 @@ async function dispatchTask(opts) {
       existingSessionKey = null;
     }
   }
-  if (existingSessionKey && role === "developer" && isFeedbackState(resolvedConfig.workflow, fromLabel)) {
+  const feedbackFreshSession = !!(existingSessionKey && role === "developer" && isFeedbackState(resolvedConfig.workflow, fromLabel));
+  if (feedbackFreshSession) {
     await rc(
       ["openclaw", "gateway", "call", "sessions.delete", "--params", JSON.stringify({ key: existingSessionKey })],
       { timeoutMs: 1e4 }
@@ -128818,8 +129120,10 @@ async function dispatchTask(opts) {
       existingSessionKey = null;
     }
   }
+  const dispatchCycleId = randomUUID2();
   const botName = slotName(project.name, role, level, slotIndex);
-  const sessionKey = `agent:${agentId ?? "unknown"}:subagent:${project.name}-${role}-${level}-${botName.toLowerCase()}`;
+  const deterministicSessionKey = `agent:${agentId ?? "unknown"}:subagent:${project.name}-${role}-${level}-${botName.toLowerCase()}`;
+  const sessionKey = feedbackFreshSession ? `${deterministicSessionKey}-retry-${dispatchCycleId.slice(0, 8)}` : deterministicSessionKey;
   if (existingSessionKey && existingSessionKey !== sessionKey) {
     const existingKeyIsForSameRole = existingSessionKey.includes(`:${project.name}-${role}-`);
     if (existingKeyIsForSameRole) {
@@ -128830,8 +129134,27 @@ async function dispatchTask(opts) {
       existingSessionKey = null;
     }
   }
+  if (!existingSessionKey) {
+    const gatewaySessions = await fetchGatewaySessions(void 0, rc).catch(() => null);
+    if (gatewaySessions && isSessionAlive(sessionKey, gatewaySessions)) {
+      await rc(
+        ["openclaw", "gateway", "call", "sessions.delete", "--params", JSON.stringify({ key: sessionKey })],
+        { timeoutMs: 1e4 }
+      ).catch((err) => console.error("[fabrica] silent-catch:", err.message));
+      await log(workspaceDir, "session_orphan_reset", {
+        project: project.name,
+        projectSlug: project.slug,
+        issue: issueId,
+        role,
+        level,
+        sessionKey,
+        reason: feedbackFreshSession ? "gateway_session_alive_without_local_slot_tracking_after_feedback_reset" : "gateway_session_alive_without_local_slot_tracking"
+      }).catch(() => {
+      });
+    }
+  }
   const sessionAction = existingSessionKey ? "send" : "spawn";
-  const dispatchCycleId = randomUUID2();
+  const dispatchSemantic = feedbackFreshSession ? "feedback_redispatch" : sessionAction === "send" ? "session_resume" : "fresh_dispatch";
   const allComments = await provider.listComments(issueId);
   const { workflow } = resolvedConfig;
   const prFeedback = isFeedbackState(workflow, fromLabel) ? await fetchPrFeedback(provider, issueId, prSelector) : void 0;
@@ -128850,6 +129173,60 @@ async function dispatchTask(opts) {
   const primaryChannelId = project.slug;
   const isConflictFix = prFeedback?.reason === "merge_conflict";
   const repoContext = project.repo ? resolveRepoPath(project.repo) : project.repoRemote?.replace(/\.git$/, "") || project.slug;
+  const executionSetup = resolveExecutionSetup({
+    projectName: project.name,
+    issueId,
+    repo: repoContext,
+    prBranchName: prFeedback?.branchName
+  });
+  const localRepoPath = project.repo ? resolveRepoPath(project.repo) : null;
+  if (localRepoPath) {
+    const remoteStartRef = prFeedback?.branchName?.trim() ? `origin/${executionSetup.branchName}` : `origin/${project.baseBranch}`;
+    await fs22.mkdir(`${localRepoPath}.worktrees`, { recursive: true }).catch(() => {
+    });
+    const worktreeExists = await fs22.stat(executionSetup.worktreePath).then(() => true).catch(() => false);
+    if (!worktreeExists) {
+      await rc(["git", "fetch", "origin", project.baseBranch], { timeoutMs: 3e4, cwd: localRepoPath }).catch(() => {
+      });
+      if (prFeedback?.branchName?.trim()) {
+        await rc(["git", "fetch", "origin", executionSetup.branchName], { timeoutMs: 3e4, cwd: localRepoPath }).catch(() => {
+        });
+      }
+      await rc(
+        ["git", "worktree", "add", executionSetup.worktreePath, "-B", executionSetup.branchName, remoteStartRef],
+        { timeoutMs: 6e4, cwd: localRepoPath }
+      );
+      await log(workspaceDir, "dispatch_worktree_prepared", {
+        project: project.name,
+        projectSlug: project.slug,
+        issue: issueId,
+        role,
+        level,
+        branchName: executionSetup.branchName,
+        worktreePath: executionSetup.worktreePath,
+        mode: "create"
+      }).catch(() => {
+      });
+    } else {
+      await rc(["git", "checkout", executionSetup.branchName], { timeoutMs: 3e4, cwd: executionSetup.worktreePath }).catch(() => {
+      });
+      await rc(["git", "reset", "--hard", remoteStartRef], { timeoutMs: 3e4, cwd: executionSetup.worktreePath }).catch(() => {
+      });
+      await rc(["git", "clean", "-fd"], { timeoutMs: 3e4, cwd: executionSetup.worktreePath }).catch(() => {
+      });
+      await log(workspaceDir, "dispatch_worktree_prepared", {
+        project: project.name,
+        projectSlug: project.slug,
+        issue: issueId,
+        role,
+        level,
+        branchName: executionSetup.branchName,
+        worktreePath: executionSetup.worktreePath,
+        mode: "reuse"
+      }).catch(() => {
+      });
+    }
+  }
   const taskMessage = isConflictFix && prFeedback ? buildConflictFixMessage({
     projectName: project.name,
     channelId: primaryChannelId,
@@ -128993,6 +129370,62 @@ async function dispatchTask(opts) {
     }
   } catch {
   }
+  const dispatchEpoch = (/* @__PURE__ */ new Date()).toISOString();
+  let sendResult;
+  try {
+    sendResult = await sendToAgent(sessionKey, taskMessage, {
+      agentId,
+      projectName: project.name,
+      projectSlug: project.slug,
+      issueId,
+      role,
+      level,
+      slotIndex,
+      fromLabel,
+      orchestratorSessionKey: opts.sessionKey,
+      workspaceDir,
+      dispatchTimeoutMs: timeouts.dispatchMs,
+      extraSystemPrompt: buildEffortPrompt(
+        resolvedRole?.effort?.[level],
+        roleInstructions.trim() || void 0
+      ) || void 0,
+      runCommand: rc,
+      runtime,
+      dispatchEpoch
+    });
+  } catch (err) {
+    try {
+      await resilientLabelTransition(
+        provider,
+        issueId,
+        toLabel,
+        fromLabel,
+        (msg) => log(workspaceDir, "dispatch_warning", { step: "send_rollback_label", issue: issueId, msg }).catch(() => {
+        })
+      );
+      await deactivateWorker(workspaceDir, project.slug, role, { level, slotIndex, issueId: String(issueId) });
+    } catch {
+    }
+    throw new Error(`Dispatch send failed for issue #${issueId}: ${err.message ?? String(err)}`);
+  }
+  await recordIssueLifecycle({
+    workspaceDir,
+    slug: project.slug,
+    issueId,
+    stage: "dispatch_requested",
+    sessionKey,
+    details: { role, level, slotIndex, sessionAction }
+  }).catch((err) => {
+    log(workspaceDir, "dispatch_warning", {
+      project: project.name,
+      issue: issueId,
+      role,
+      warning: "Lifecycle event failed after successful dispatch",
+      error: err.message,
+      sessionKey
+    }).catch(() => {
+    });
+  });
   const notifyConfig = getNotificationConfig(pluginConfig);
   const notifyTarget = resolveNotifyChannel(issue2?.labels ?? [], project.channels);
   notify(
@@ -129006,11 +129439,12 @@ async function dispatchTask(opts) {
       level,
       name: botName,
       sessionAction,
+      dispatchSemantic,
       modelDowngraded: effectiveModel.downgraded,
       originalModel: effectiveModel.downgraded ? resolvedModel : void 0,
       effectiveModel: effectiveModel.downgraded ? model : void 0,
       dispatchCycleId,
-      dispatchRunId: null
+      dispatchRunId: sendResult.runId
     },
     {
       workspaceDir,
@@ -129030,45 +129464,6 @@ async function dispatchTask(opts) {
       error: err.message ?? String(err)
     }).catch((auditErr) => console.error("[fabrica] silent-catch:", auditErr.message));
   });
-  const dispatchEpoch = (/* @__PURE__ */ new Date()).toISOString();
-  sendToAgent(sessionKey, taskMessage, {
-    agentId,
-    projectName: project.name,
-    projectSlug: project.slug,
-    issueId,
-    role,
-    level,
-    slotIndex,
-    fromLabel,
-    orchestratorSessionKey: opts.sessionKey,
-    workspaceDir,
-    dispatchTimeoutMs: timeouts.dispatchMs,
-    extraSystemPrompt: buildEffortPrompt(
-      resolvedRole?.effort?.[level],
-      roleInstructions.trim() || void 0
-    ) || void 0,
-    runCommand: rc,
-    runtime,
-    dispatchEpoch
-  });
-  await recordIssueLifecycle({
-    workspaceDir,
-    slug: project.slug,
-    issueId,
-    stage: "dispatch_requested",
-    sessionKey,
-    details: { role, level, slotIndex, sessionAction }
-  }).catch((err) => {
-    log(workspaceDir, "dispatch_warning", {
-      project: project.name,
-      issue: issueId,
-      role,
-      warning: "Lifecycle event failed after successful dispatch",
-      error: err.message,
-      sessionKey
-    }).catch(() => {
-    });
-  });
   await auditDispatch(workspaceDir, {
     project: project.name,
     issueId,
@@ -129786,7 +130181,7 @@ function createProjectStatusTool(ctx) {
 }
 
 // lib/tools/admin/project-register.ts
-import fs23 from "node:fs/promises";
+import fs24 from "node:fs/promises";
 import path24 from "node:path";
 init_audit();
 init_roles();
@@ -129794,7 +130189,7 @@ init_workflow();
 init_constants();
 
 // lib/telegram/topic-service.ts
-import fs22 from "node:fs/promises";
+import fs23 from "node:fs/promises";
 async function sleep2(ms) {
   await new Promise((resolve3) => setTimeout(resolve3, ms));
 }
@@ -129824,7 +130219,7 @@ async function tryReadTokenFile(filePath) {
   const resolvedPath = readString(filePath);
   if (!resolvedPath) return void 0;
   try {
-    const token = await fs22.readFile(resolvedPath, "utf-8");
+    const token = await fs23.readFile(resolvedPath, "utf-8");
     const trimmed = token.trim();
     return trimmed || void 0;
   } catch {
@@ -129985,14 +130380,14 @@ function buildForumTopicArtifactId(channelId, messageThreadId) {
 async function scaffoldPromptFiles(workspaceDir, projectName) {
   const projectDir = path24.join(workspaceDir, DATA_DIR, "projects", projectName);
   const promptsDir = path24.join(projectDir, "prompts");
-  await fs23.mkdir(promptsDir, { recursive: true });
+  await fs24.mkdir(promptsDir, { recursive: true });
   const readmePath = path24.join(projectDir, "README.md");
   try {
-    await fs23.access(readmePath);
+    await fs24.access(readmePath);
     return false;
   } catch {
     const roles = getAllRoleIds().join(", ");
-    await fs23.writeFile(readmePath, `# Project Overrides
+    await fs24.writeFile(readmePath, `# Project Overrides
 
 This directory holds project-specific configuration that overrides the workspace defaults.
 
@@ -130048,12 +130443,12 @@ function getProjectReadmePath(workspaceDir, projectName) {
 async function ensureAutonomousWorkflowOverride(workspaceDir, projectName, reviewPolicy = "agent") {
   const projectDir = getProjectDir(workspaceDir, projectName);
   const workflowPath = getProjectWorkflowPath(workspaceDir, projectName);
-  await fs23.mkdir(projectDir, { recursive: true });
+  await fs24.mkdir(projectDir, { recursive: true });
   try {
-    await fs23.access(workflowPath);
+    await fs24.access(workflowPath);
     return false;
   } catch {
-    await fs23.writeFile(workflowPath, `workflow:
+    await fs24.writeFile(workflowPath, `workflow:
   reviewPolicy: ${reviewPolicy}
 `, "utf-8");
     return true;
@@ -130062,7 +130457,7 @@ async function ensureAutonomousWorkflowOverride(workspaceDir, projectName, revie
 async function hasProjectWorkflowOverride(workspaceDir, projectName) {
   const workflowPath = getProjectWorkflowPath(workspaceDir, projectName);
   try {
-    await fs23.access(workflowPath);
+    await fs24.access(workflowPath);
     return true;
   } catch {
     return false;
@@ -130077,7 +130472,7 @@ async function pruneEmptyProjectDirs(workspaceDir, projectName) {
   for (const dir of candidateDirs2) {
     if (!dir.startsWith(stopDir)) continue;
     try {
-      await fs23.rmdir(dir);
+      await fs24.rmdir(dir);
     } catch (error48) {
       const code = error48.code;
       if (code !== "ENOENT" && code !== "ENOTEMPTY") {
@@ -130088,10 +130483,10 @@ async function pruneEmptyProjectDirs(workspaceDir, projectName) {
 }
 async function cleanupLocalRegisterResidue(workspaceDir, projectName, opts) {
   if (opts.removeWorkflowOverride) {
-    await fs23.rm(getProjectWorkflowPath(workspaceDir, projectName), { force: true });
+    await fs24.rm(getProjectWorkflowPath(workspaceDir, projectName), { force: true });
   }
   if (opts.removePromptReadme) {
-    await fs23.rm(getProjectReadmePath(workspaceDir, projectName), { force: true });
+    await fs24.rm(getProjectReadmePath(workspaceDir, projectName), { force: true });
   }
   await pruneEmptyProjectDirs(workspaceDir, projectName);
 }
@@ -130124,7 +130519,7 @@ var NODE_STACKS = /* @__PURE__ */ new Set(["nextjs", "node-cli", "express"]);
 var PYTHON_STACKS = /* @__PURE__ */ new Set(["fastapi", "flask", "django", "python-cli"]);
 async function pathExists(candidate) {
   try {
-    await fs23.access(candidate);
+    await fs24.access(candidate);
     return true;
   } catch {
     return false;
@@ -130549,7 +130944,7 @@ init_labels();
 
 // lib/services/worker-completion.ts
 init_audit();
-import fs24 from "node:fs/promises";
+import fs25 from "node:fs/promises";
 init_workflow();
 
 // lib/services/worker-result.ts
@@ -130688,7 +131083,7 @@ function parseSessionTranscript(raw) {
 async function readWorkerResultFromSessionFile(role, sessionFile) {
   if (!sessionFile) return null;
   try {
-    const raw = await fs24.readFile(sessionFile, "utf-8");
+    const raw = await fs25.readFile(sessionFile, "utf-8");
     const messages = parseSessionTranscript(raw);
     const result = extractWorkerResultFromMessages(role, messages);
     return result ? {
@@ -132778,7 +133173,7 @@ ${channelList}`;
 // lib/setup/index.ts
 var import_yaml3 = __toESM(require_dist(), 1);
 init_roles();
-import fs38 from "node:fs/promises";
+import fs39 from "node:fs/promises";
 import path39 from "node:path";
 
 // lib/setup/binding-manager.ts
@@ -132801,7 +133196,7 @@ async function migrateChannelBinding(api, channel, fromAgentId, toAgentId) {
 
 // lib/setup/agent.ts
 init_logger();
-import fs25 from "node:fs/promises";
+import fs26 from "node:fs/promises";
 import path25 from "node:path";
 async function createAgent(api, name, runCommand, channelBinding) {
   const rc = runCommand;
@@ -132830,11 +133225,11 @@ function resolveWorkspacePath(api, agentId) {
 }
 async function cleanupWorkspace(workspacePath) {
   try {
-    await fs25.rm(path25.join(workspacePath, ".git"), { recursive: true });
+    await fs26.rm(path25.join(workspacePath, ".git"), { recursive: true });
   } catch {
   }
   try {
-    await fs25.unlink(path25.join(workspacePath, "BOOTSTRAP.md"));
+    await fs26.unlink(path25.join(workspacePath, "BOOTSTRAP.md"));
   } catch {
   }
 }
@@ -132897,7 +133292,7 @@ init_workspace();
 
 // lib/services/heartbeat/agent-discovery.ts
 init_constants();
-import fs26 from "node:fs";
+import fs27 from "node:fs";
 import path26 from "node:path";
 function discoverAgents(config2) {
   const seen = /* @__PURE__ */ new Set();
@@ -132924,7 +133319,7 @@ function discoverAgents(config2) {
   return agents;
 }
 function hasProjects(workspace) {
-  return fs26.existsSync(path26.join(workspace, DATA_DIR, "projects.json")) || fs26.existsSync(path26.join(workspace, "projects.json")) || fs26.existsSync(path26.join(workspace, "projects", "projects.json"));
+  return fs27.existsSync(path26.join(workspace, DATA_DIR, "projects.json")) || fs27.existsSync(path26.join(workspace, "projects.json")) || fs27.existsSync(path26.join(workspace, "projects", "projects.json"));
 }
 
 // lib/services/heartbeat/config.ts
@@ -137273,7 +137668,7 @@ async function processPendingGitHubEventsForWorkspace(params) {
 }
 
 // lib/machines/lifecycle-service.ts
-import fs29 from "node:fs/promises";
+import fs30 from "node:fs/promises";
 import path29 from "node:path";
 init_constants();
 init_migrate_layout();
@@ -137366,9 +137761,9 @@ async function lifecycleSnapshotPath(workspaceDir) {
 }
 async function persistSnapshot(workspaceDir, actor) {
   const filePath = await lifecycleSnapshotPath(workspaceDir);
-  await fs29.mkdir(path29.dirname(filePath), { recursive: true });
+  await fs30.mkdir(path29.dirname(filePath), { recursive: true });
   const snapshot = actor.getSnapshot();
-  await fs29.writeFile(filePath, JSON.stringify({
+  await fs30.writeFile(filePath, JSON.stringify({
     value: snapshot.value,
     context: snapshot.context,
     updatedAt: snapshot.context.updatedAt
@@ -137461,7 +137856,7 @@ async function raceWithTimeout(fn, timeoutMs, onTimeout) {
 // lib/dispatch/telegram-bootstrap-hook.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
 import { homedir as homedir2 } from "node:os";
-import fs36 from "node:fs/promises";
+import fs37 from "node:fs/promises";
 import path37 from "node:path";
 
 // lib/dispatch/attachment-hook.ts
@@ -137908,7 +138303,7 @@ init_conduct_interview();
 init_generate_spec();
 
 // lib/intake/lib/project-map.ts
-import fs31 from "node:fs/promises";
+import fs32 from "node:fs/promises";
 import path31 from "node:path";
 var IGNORED_DIRS = /* @__PURE__ */ new Set([
   ".git",
@@ -138008,7 +138403,7 @@ function matchProjectByRef(projects, ref) {
 async function tryStatDir(candidate) {
   if (!candidate) return false;
   try {
-    return (await fs31.stat(candidate)).isDirectory();
+    return (await fs32.stat(candidate)).isDirectory();
   } catch {
     return false;
   }
@@ -138109,7 +138504,7 @@ async function resolveProjectTarget(payload, workspaceDir, homeDir) {
 async function collectFiles(root, relativeDir = "", files = [], limit = 800) {
   if (files.length >= limit) return files;
   const currentDir = path31.join(root, relativeDir);
-  const entries = await fs31.readdir(currentDir, { withFileTypes: true });
+  const entries = await fs32.readdir(currentDir, { withFileTypes: true });
   for (const entry of entries) {
     if (files.length >= limit) break;
     if (entry.name.startsWith(".") && entry.name !== ".env.example") {
@@ -138303,16 +138698,16 @@ var impactStep = {
       const modules = map2?.modules ?? [];
       const specText = `${spec.title} ${spec.objective} ${spec.scope_v1.join(" ")}`.toLowerCase();
       const affected = symbols.filter((s2) => specText.includes(s2.name.toLowerCase())).map((s2) => s2.file);
-      const unique = [...new Set(affected)];
+      const unique2 = [...new Set(affected)];
       const affectedModules = modules.filter((moduleName2) => specText.includes(moduleName2.toLowerCase()));
-      const confidence = map2?.confidence === "low" || !unique.length && !affectedModules.length ? "low" : "high";
+      const confidence = map2?.confidence === "low" || !unique2.length && !affectedModules.length ? "low" : "high";
       impact = {
         is_greenfield: false,
-        affected_files: unique,
+        affected_files: unique2,
         affected_modules: [...new Set(affectedModules)],
         new_files_needed: [],
         risk_areas: spec.risks,
-        estimated_files_changed: Math.max(1, unique.length || affectedModules.length),
+        estimated_files_changed: Math.max(1, unique2.length || affectedModules.length),
         confidence
       };
     }
@@ -138334,7 +138729,7 @@ init_runtime_paths();
 
 // lib/test-env/bootstrap.ts
 import { createHash as createHash3 } from "node:crypto";
-import fs32 from "node:fs/promises";
+import fs33 from "node:fs/promises";
 import path32 from "node:path";
 var NODE_STACKS2 = /* @__PURE__ */ new Set(["nextjs", "node-cli", "express"]);
 var PYTHON_STACKS2 = /* @__PURE__ */ new Set(["fastapi", "flask", "django", "python-cli"]);
@@ -138401,7 +138796,7 @@ var BOOTSTRAP_STATE_FILE = "test-env.sha256";
 var DEFAULT_TIMEOUT = 18e4;
 async function pathExists2(candidate) {
   try {
-    await fs32.access(candidate);
+    await fs33.access(candidate);
     return true;
   } catch {
     return false;
@@ -138409,7 +138804,7 @@ async function pathExists2(candidate) {
 }
 async function isValidBinary(filePath) {
   try {
-    const stat2 = await fs32.stat(filePath);
+    const stat2 = await fs33.stat(filePath);
     return stat2.size > 0;
   } catch {
     return false;
@@ -138577,7 +138972,7 @@ async function computeFingerprint(repoPath, files) {
   for (const file2 of existing.sort()) {
     hash2.update(`${file2}
 `);
-    hash2.update(await fs32.readFile(path32.join(repoPath, file2)));
+    hash2.update(await fs33.readFile(path32.join(repoPath, file2)));
     hash2.update("\n");
   }
   return hash2.digest("hex");
@@ -138585,15 +138980,15 @@ async function computeFingerprint(repoPath, files) {
 async function readBootstrapFingerprint(repoPath) {
   const stateFile = path32.join(repoPath, BOOTSTRAP_STATE_DIR, BOOTSTRAP_STATE_FILE);
   try {
-    return (await fs32.readFile(stateFile, "utf-8")).trim() || null;
+    return (await fs33.readFile(stateFile, "utf-8")).trim() || null;
   } catch {
     return null;
   }
 }
 async function writeBootstrapFingerprint(repoPath, fingerprint) {
   const stateDir = path32.join(repoPath, BOOTSTRAP_STATE_DIR);
-  await fs32.mkdir(stateDir, { recursive: true });
-  await fs32.writeFile(path32.join(stateDir, BOOTSTRAP_STATE_FILE), fingerprint, "utf-8");
+  await fs33.mkdir(stateDir, { recursive: true });
+  await fs33.writeFile(path32.join(stateDir, BOOTSTRAP_STATE_FILE), fingerprint, "utf-8");
 }
 async function toolExists(runCommand, cmd, args = ["--version"]) {
   try {
@@ -138652,7 +139047,7 @@ Details: ${(install.stderr || install.stdout || "unknown error").trim()}`
   const home = process.env.HOME ?? "";
   const fallbackPath = path32.join(home, ".local", "bin", "uv");
   try {
-    await fs32.access(fallbackPath);
+    await fs33.access(fallbackPath);
     emit2(`[test-env] uv installed at fallback path: ${fallbackPath}`);
     return fallbackPath;
   } catch {
@@ -138682,16 +139077,16 @@ async function ensurePythonToolchain(runCommand, homeDir) {
   const expectedFp = await toolchainFingerprint(runCommand);
   if (await isValidBinary(ruffPath)) {
     try {
-      const currentFp = (await fs32.readFile(fingerprintPath, "utf-8")).trim();
+      const currentFp = (await fs33.readFile(fingerprintPath, "utf-8")).trim();
       if (currentFp === expectedFp) {
         return toolchainPath;
       }
     } catch {
     }
-    await fs32.rm(toolchainPath, { recursive: true, force: true });
+    await fs33.rm(toolchainPath, { recursive: true, force: true });
   }
   const uvCmd = await ensureUv(runCommand);
-  await fs32.mkdir(path32.dirname(toolchainPath), { recursive: true });
+  await fs33.mkdir(path32.dirname(toolchainPath), { recursive: true });
   const venvResult = await runCommand(uvCmd, ["venv", toolchainPath], { timeout: 6e4 });
   if (venvResult.exitCode !== 0) {
     throw new Error(`Failed to create toolchain venv: ${venvResult.stderr}`);
@@ -138706,13 +139101,13 @@ async function ensurePythonToolchain(runCommand, homeDir) {
   if (installResult.exitCode !== 0) {
     throw new Error(`Failed to install toolchain packages: ${installResult.stderr}`);
   }
-  await fs32.writeFile(fingerprintPath, expectedFp, "utf-8");
+  await fs33.writeFile(fingerprintPath, expectedFp, "utf-8");
   return toolchainPath;
 }
 async function hasPyprojectDevExtra(repoPath) {
   const pyprojectPath = path32.join(repoPath, "pyproject.toml");
   if (!await pathExists2(pyprojectPath)) return false;
-  const content = await fs32.readFile(pyprojectPath, "utf-8");
+  const content = await fs33.readFile(pyprojectPath, "utf-8");
   const match = content.match(/\[project\.optional-dependencies\]([\s\S]*?)(?:\n\[|$)/);
   if (!match) return false;
   return /^\s*dev\s*=\s*\[/m.test(match[1] ?? "");
@@ -139352,7 +139747,7 @@ var scaffoldPassthroughStep = {
 };
 
 // lib/intake/lib/repository-provision-service.ts
-import fs33 from "node:fs/promises";
+import fs34 from "node:fs/promises";
 import path34 from "node:path";
 function normalizeText2(value) {
   if (typeof value !== "string") return null;
@@ -139393,7 +139788,7 @@ function adaptRunCommand(ctx) {
 async function pathExists3(candidate) {
   if (!candidate) return false;
   try {
-    await fs33.access(candidate);
+    await fs34.access(candidate);
     return true;
   } catch {
     return false;
@@ -139764,6 +140159,287 @@ var securityReviewStep = {
 
 // lib/intake/steps/create-task.ts
 init_workflow();
+
+// lib/dispatch/telegram-bootstrap-session.ts
+init_constants();
+import { createHash as createHash4, randomUUID as randomUUID4 } from "node:crypto";
+import fs35 from "node:fs/promises";
+import path35 from "node:path";
+var SESSION_TTL_MS = 10 * 6e4;
+var CLASSIFYING_TTL_MS = 15e3;
+var RELEASED_CLASSIFY_ERRORS = /* @__PURE__ */ new Set([
+  "classify_invalid_result",
+  "classify_low_confidence",
+  "classify_not_project",
+  "classify_result_expired"
+]);
+function toCanonicalTelegramBootstrapConversationId(conversationId) {
+  const trimmed = conversationId.trim();
+  if (!trimmed) return trimmed;
+  return trimmed.startsWith("telegram:") ? trimmed : `telegram:${trimmed}`;
+}
+function sessionsDir(workspaceDir) {
+  return path35.join(workspaceDir, DATA_DIR, "bootstrap-sessions");
+}
+function sessionPath(workspaceDir, conversationId) {
+  return path35.join(
+    sessionsDir(workspaceDir),
+    `${toCanonicalTelegramBootstrapConversationId(conversationId)}.json`
+  );
+}
+function alternateSessionPath(workspaceDir, conversationId) {
+  const canonical = toCanonicalTelegramBootstrapConversationId(conversationId);
+  const bare = canonical.startsWith("telegram:") ? canonical.slice("telegram:".length) : canonical;
+  if (!bare || bare === canonical) return null;
+  return path35.join(sessionsDir(workspaceDir), `${bare}.json`);
+}
+function normalizeStoredSession(session) {
+  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(session.conversationId);
+  if (canonicalConversationId === session.conversationId) {
+    return session;
+  }
+  return {
+    ...session,
+    id: buildBootstrapSessionId(canonicalConversationId, session.rawIdea),
+    conversationId: canonicalConversationId
+  };
+}
+function stableHash(input) {
+  return createHash4("sha256").update(input).digest("hex").slice(0, 16);
+}
+function buildBootstrapSessionId(conversationId, rawIdea) {
+  return `tgdm-${conversationId}-${stableHash(rawIdea.trim().toLowerCase())}`;
+}
+function buildBootstrapRequestFingerprint(input) {
+  return stableHash(JSON.stringify({
+    rawIdea: input.rawIdea.trim().toLowerCase(),
+    projectName: input.projectName?.trim().toLowerCase() || null,
+    stackHint: input.stackHint?.trim().toLowerCase() || null,
+    repoUrl: input.repoUrl?.trim().toLowerCase() || null,
+    repoPath: input.repoPath?.trim().toLowerCase() || null
+  }));
+}
+function buildBootstrapRequestHash(input) {
+  return buildBootstrapRequestFingerprint(input);
+}
+function nextSuppressUntil(status) {
+  const ttl = status === "classifying" || status === "pending_classify" ? CLASSIFYING_TTL_MS : SESSION_TTL_MS;
+  return new Date(Date.now() + ttl).toISOString();
+}
+function isReleasedClassifyFailure(error48) {
+  return Boolean(error48 && RELEASED_CLASSIFY_ERRORS.has(error48));
+}
+function resolveNullableField(inputValue, existingValue, fallback = null) {
+  return inputValue !== void 0 ? inputValue : existingValue ?? fallback;
+}
+function defaultNextRetryAtForStatus(status, existingValue) {
+  if (status === "bootstrapping" || status === "dispatching") {
+    return existingValue ?? null;
+  }
+  return null;
+}
+var MONOTONIC_BOOTSTRAP_FIELDS = [
+  "ackSentAt",
+  "projectRegisteredAt",
+  "topicKickoffSentAt",
+  "projectTickedAt",
+  "completionAckSentAt"
+];
+function shouldPersistBootstrapCheckpoint(current, next) {
+  if (!current) return { ok: true };
+  if (current.conversationId !== next.conversationId) return { ok: true };
+  const currentAttemptSeq = current.attemptSeq ?? null;
+  const nextAttemptSeq = next.attemptSeq ?? null;
+  if (currentAttemptSeq != null && nextAttemptSeq != null && nextAttemptSeq < currentAttemptSeq) {
+    return { ok: false, reason: "stale_regression" };
+  }
+  const sameAttempt = Boolean(
+    current.attemptId && next.attemptId && current.attemptSeq != null && next.attemptSeq != null && current.attemptId === next.attemptId && current.attemptSeq === next.attemptSeq
+  );
+  if (!sameAttempt) return { ok: true };
+  for (const field of MONOTONIC_BOOTSTRAP_FIELDS) {
+    if (current[field] && !next[field]) {
+      return { ok: false, reason: "stale_regression" };
+    }
+  }
+  return { ok: true };
+}
+async function readTelegramBootstrapSession(workspaceDir, conversationId) {
+  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(conversationId);
+  const paths = [
+    sessionPath(workspaceDir, canonicalConversationId),
+    alternateSessionPath(workspaceDir, conversationId)
+  ].filter((entry) => Boolean(entry));
+  try {
+    for (const candidatePath of paths) {
+      try {
+        const raw = await fs35.readFile(candidatePath, "utf-8");
+        const session = normalizeStoredSession(JSON.parse(raw));
+        if (session.status === "failed" && isReleasedClassifyFailure(session.error)) {
+          await deleteTelegramBootstrapSession(workspaceDir, canonicalConversationId);
+          return null;
+        }
+        return session;
+      } catch (error48) {
+        if (error48?.code === "ENOENT") continue;
+        throw error48;
+      }
+    }
+    return null;
+  } catch (error48) {
+    if (error48?.code === "ENOENT") return null;
+    throw error48;
+  }
+}
+async function deleteTelegramBootstrapSession(workspaceDir, conversationId) {
+  await fs35.unlink(sessionPath(workspaceDir, conversationId)).catch(() => {
+  });
+  const legacyPath = alternateSessionPath(workspaceDir, conversationId);
+  if (legacyPath) {
+    await fs35.unlink(legacyPath).catch(() => {
+    });
+  }
+}
+async function writeTelegramBootstrapSession(workspaceDir, session) {
+  const canonicalSession = normalizeStoredSession(session);
+  const dir = sessionsDir(workspaceDir);
+  await fs35.mkdir(dir, { recursive: true });
+  const file2 = sessionPath(workspaceDir, canonicalSession.conversationId);
+  const tmp = `${file2}.${randomUUID4()}.tmp`;
+  await fs35.writeFile(tmp, JSON.stringify(canonicalSession, null, 2) + "\n", "utf-8");
+  await fs35.rename(tmp, file2);
+  const legacyPath = alternateSessionPath(workspaceDir, session.conversationId);
+  if (legacyPath) {
+    await fs35.unlink(legacyPath).catch(() => {
+    });
+  }
+}
+async function upsertTelegramBootstrapSession(workspaceDir, input) {
+  const conversationId = toCanonicalTelegramBootstrapConversationId(input.conversationId);
+  const existing = await readTelegramBootstrapSession(workspaceDir, conversationId);
+  const resolvedSourceRoute = resolveNullableField(input.sourceRoute, existing?.sourceRoute);
+  const resolvedProjectRoute = resolveNullableField(input.projectRoute, existing?.projectRoute);
+  const resolvedProjectName = resolveNullableField(input.projectName, existing?.projectName);
+  const resolvedStackHint = resolveNullableField(input.stackHint, existing?.stackHint);
+  const resolvedRepoUrl = resolveNullableField(input.repoUrl, existing?.repoUrl);
+  const resolvedRepoPath = resolveNullableField(input.repoPath, existing?.repoPath);
+  const resolvedProjectSlug = resolveNullableField(input.projectSlug, existing?.projectSlug);
+  const resolvedIssueId = resolveNullableField(input.issueId, existing?.issueId);
+  const resolvedIssueUrl = resolveNullableField(input.issueUrl, existing?.issueUrl);
+  const resolvedTriageReadyForDispatch = resolveNullableField(input.triageReadyForDispatch, existing?.triageReadyForDispatch);
+  const resolvedTriageErrors = input.triageErrors !== void 0 ? input.triageErrors : existing?.triageErrors ?? null;
+  const resolvedMessageThreadId = resolveNullableField(input.messageThreadId, existing?.messageThreadId);
+  const resolvedProjectChannelId = resolveNullableField(input.projectChannelId, existing?.projectChannelId);
+  const resolvedAttemptCount = resolveNullableField(input.attemptCount, existing?.attemptCount, 0);
+  const resolvedAttemptId = resolveNullableField(input.attemptId, existing?.attemptId);
+  const resolvedAttemptSeq = resolveNullableField(input.attemptSeq, existing?.attemptSeq);
+  const resolvedClassifySessionKey = resolveNullableField(input.classifySessionKey, existing?.classifySessionKey);
+  const resolvedClassifyRunId = resolveNullableField(input.classifyRunId, existing?.classifyRunId);
+  const resolvedClassifyStartedAt = resolveNullableField(input.classifyStartedAt, existing?.classifyStartedAt);
+  const resolvedBootstrapStep = resolveNullableField(input.bootstrapStep, existing?.bootstrapStep);
+  const resolvedNextRetryAt = input.nextRetryAt !== void 0 ? input.nextRetryAt : defaultNextRetryAtForStatus(input.status, existing?.nextRetryAt);
+  const resolvedAckSentAt = resolveNullableField(input.ackSentAt, existing?.ackSentAt);
+  const resolvedProjectRegisteredAt = resolveNullableField(input.projectRegisteredAt, existing?.projectRegisteredAt);
+  const resolvedTopicKickoffSentAt = resolveNullableField(input.topicKickoffSentAt, existing?.topicKickoffSentAt);
+  const resolvedProjectTickedAt = resolveNullableField(input.projectTickedAt, existing?.projectTickedAt);
+  const resolvedCompletionAckSentAt = resolveNullableField(input.completionAckSentAt, existing?.completionAckSentAt);
+  const resolvedError = input.error !== void 0 ? input.error : input.lastError !== void 0 ? input.lastError : existing?.error ?? existing?.lastError ?? null;
+  const requestHash = buildBootstrapRequestHash({
+    rawIdea: input.rawIdea,
+    projectName: resolvedProjectName,
+    stackHint: resolvedStackHint,
+    repoUrl: resolvedRepoUrl,
+    repoPath: resolvedRepoPath
+  });
+  const now2 = (/* @__PURE__ */ new Date()).toISOString();
+  const session = {
+    id: existing?.id ?? buildBootstrapSessionId(conversationId, input.rawIdea),
+    conversationId,
+    sourceChannel: input.sourceChannel ?? input.sourceRoute?.channel ?? existing?.sourceChannel ?? "telegram",
+    sourceRoute: resolvedSourceRoute,
+    projectRoute: resolvedProjectRoute,
+    requestHash,
+    requestFingerprint: requestHash,
+    lastCompletedRequestHash: input.status === "completed" ? requestHash : existing?.lastCompletedRequestHash ?? null,
+    rawIdea: input.rawIdea,
+    projectName: resolvedProjectName,
+    stackHint: resolvedStackHint,
+    repoUrl: resolvedRepoUrl,
+    repoPath: resolvedRepoPath,
+    projectSlug: resolvedProjectSlug,
+    issueId: resolvedIssueId,
+    issueUrl: resolvedIssueUrl,
+    triageReadyForDispatch: resolvedTriageReadyForDispatch,
+    triageErrors: resolvedTriageErrors,
+    messageThreadId: resolvedMessageThreadId,
+    projectChannelId: resolvedProjectChannelId,
+    language: input.language ?? existing?.language,
+    status: input.status,
+    attemptId: resolvedAttemptId,
+    attemptSeq: resolvedAttemptSeq,
+    classifySessionKey: resolvedClassifySessionKey,
+    classifyRunId: resolvedClassifyRunId,
+    classifyStartedAt: resolvedClassifyStartedAt,
+    bootstrapStep: resolvedBootstrapStep,
+    attemptCount: resolvedAttemptCount,
+    lastError: resolvedError,
+    nextRetryAt: resolvedNextRetryAt,
+    ackSentAt: resolvedAckSentAt,
+    projectRegisteredAt: resolvedProjectRegisteredAt,
+    topicKickoffSentAt: resolvedTopicKickoffSentAt,
+    projectTickedAt: resolvedProjectTickedAt,
+    completionAckSentAt: resolvedCompletionAckSentAt,
+    pendingClarification: input.pendingClarification !== void 0 ? input.pendingClarification : existing?.pendingClarification ?? null,
+    orphanedArtifacts: input.orphanedArtifacts !== void 0 ? input.orphanedArtifacts : existing?.orphanedArtifacts ?? null,
+    createdAt: existing?.createdAt ?? now2,
+    updatedAt: now2,
+    suppressUntil: nextSuppressUntil(input.status),
+    error: resolvedError
+  };
+  const writeDecision = shouldPersistBootstrapCheckpoint(existing, session);
+  if (!writeDecision.ok && existing) {
+    return existing;
+  }
+  await writeTelegramBootstrapSession(workspaceDir, session);
+  return session;
+}
+function shouldSuppressTelegramBootstrapReply(session, request) {
+  if (!session) return false;
+  if (isTelegramBootstrapSessionExpired(session)) return false;
+  if (session.status === "completed" || session.status === "failed") {
+    if (session.status === "failed" && isReleasedClassifyFailure(session.error)) return false;
+    if (!request) return false;
+    return buildBootstrapRequestFingerprint(request) === session.requestHash;
+  }
+  if (!request) return true;
+  return buildBootstrapRequestFingerprint(request) === session.requestHash;
+}
+function isTelegramBootstrapSessionExpired(session, now2 = Date.now()) {
+  if (!session) return false;
+  const suppressUntil = Date.parse(session.suppressUntil);
+  return !Number.isNaN(suppressUntil) && suppressUntil < now2;
+}
+function isRecoverableTelegramBootstrapSession(session) {
+  return session?.status === "bootstrapping" || session?.status === "dispatching";
+}
+function isClaimableTelegramBootstrapSession(session, now2 = Date.now()) {
+  if (!isRecoverableTelegramBootstrapSession(session)) return false;
+  if (!session.nextRetryAt) return true;
+  const retryAt = Date.parse(session.nextRetryAt);
+  return Number.isNaN(retryAt) || retryAt <= now2;
+}
+function isSupersededTelegramBootstrapAttempt(current, candidate) {
+  if (!current || !candidate) return false;
+  if (current.conversationId !== candidate.conversationId) return true;
+  const currentHasAttempt = current.attemptId != null && current.attemptSeq != null;
+  const candidateHasAttempt = candidate.attemptId != null && candidate.attemptSeq != null;
+  if (currentHasAttempt || candidateHasAttempt) {
+    return current.attemptId !== candidate.attemptId || current.attemptSeq !== candidate.attemptSeq;
+  }
+  return current.requestHash !== candidate.requestHash || current.status !== candidate.status || current.updatedAt !== candidate.updatedAt;
+}
+
+// lib/intake/steps/create-task.ts
 function buildIssueBody(payload) {
   const spec = payload.spec;
   const sections = [];
@@ -139835,6 +140511,26 @@ var createTaskStep = {
         created_at: (/* @__PURE__ */ new Date()).toISOString()
       };
       ctx.log(`Issue created via provider: #${issue3.number} \u2014 ${issue3.url}`);
+      const bootstrapConversationId2 = payload.metadata?.source === "telegram-dm-bootstrap" ? payload.metadata?.channel_id : null;
+      if (bootstrapConversationId2) {
+        await upsertTelegramBootstrapSession(ctx.workspaceDir, {
+          conversationId: String(bootstrapConversationId2),
+          rawIdea: payload.raw_idea,
+          projectName: payload.metadata?.project_name ?? null,
+          stackHint: payload.metadata?.stack_hint ?? null,
+          repoUrl: repoUrl ?? null,
+          repoPath: repoPath ?? null,
+          status: "dispatching",
+          bootstrapStep: "project_registered",
+          projectSlug: projectSlug ?? null,
+          issueId: issue3.number,
+          issueUrl: issue3.url,
+          projectChannelId: payload.metadata?.channel_id ?? null,
+          messageThreadId: payload.metadata?.message_thread_id ?? null,
+          projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString()
+        }).catch(() => {
+        });
+      }
       return {
         ...payload,
         step: "create-task",
@@ -139870,6 +140566,26 @@ var createTaskStep = {
       created_at: (/* @__PURE__ */ new Date()).toISOString()
     };
     ctx.log(`Issue created via compatibility fallback: #${issueNumber} \u2014 ${issueUrl}`);
+    const bootstrapConversationId = payload.metadata?.source === "telegram-dm-bootstrap" ? payload.metadata?.channel_id : null;
+    if (bootstrapConversationId) {
+      await upsertTelegramBootstrapSession(ctx.workspaceDir, {
+        conversationId: String(bootstrapConversationId),
+        rawIdea: payload.raw_idea,
+        projectName: payload.metadata?.project_name ?? null,
+        stackHint: payload.metadata?.stack_hint ?? null,
+        repoUrl: repoUrl ?? null,
+        repoPath: repoPath ?? null,
+        status: "dispatching",
+        bootstrapStep: "project_registered",
+        projectSlug: projectSlug ?? null,
+        issueId: issue2.number,
+        issueUrl: issue2.url,
+        projectChannelId: payload.metadata?.channel_id ?? null,
+        messageThreadId: payload.metadata?.message_thread_id ?? null,
+        projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString()
+      }).catch(() => {
+      });
+    }
     return {
       ...payload,
       step: "create-task",
@@ -139982,9 +140698,66 @@ function determineLevel(effort, targetState) {
   if (targetState === "To Research" && level === "medior") level = "junior";
   return level;
 }
+function assessComplexity(input) {
+  const broadSignals = detectRawIdeaComplexity(input.rawIdea).signals.length;
+  if (input.filesChanged >= 18 || input.acCount >= 8 || broadSignals >= 4 || input.totalRisks >= 4) return "high";
+  if (input.filesChanged >= 8 || input.acCount >= 4 || broadSignals >= 2 || input.totalRisks >= 2) return "medium";
+  return "low";
+}
+function assessCoupling(input) {
+  const text = `${input.rawIdea} ${input.scopeText}`.toLowerCase();
+  const crossCuttingSignals = [
+    /\bauth\b|\bpermission\b|\brbac\b/,
+    /\bmigration\b|\bschema\b|\bdatabase\b/,
+    /\bbackground\b|\bworker\b|\bqueue\b|\bcron\b/,
+    /\bfrontend\b|\bdashboard\b|\bui\b/,
+    /\bintegration\b|\bwebhook\b|\bexternal\b/
+  ].filter((regex) => regex.test(text)).length;
+  if (crossCuttingSignals >= 4) return "high";
+  if (crossCuttingSignals >= 2) return "medium";
+  return "low";
+}
+function assessParallelizability(input, coupling) {
+  const text = `${input.rawIdea} ${input.scopeText}`.toLowerCase();
+  const capabilitySignals = [
+    /\bauth\b/,
+    /\bapi\b|\bendpoint\b|\broute\b/,
+    /\bfrontend\b|\bdashboard\b|\bui\b/,
+    /\bworker\b|\bqueue\b|\bbackground\b/,
+    /\bnotification\b|\bemail\b|\bsms\b|\balert\b/,
+    /\bdatabase\b|\bmigration\b|\bschema\b/
+  ].filter((regex) => regex.test(text)).length;
+  if (coupling === "high") return "low";
+  if (capabilitySignals >= 4) return "high";
+  if (capabilitySignals >= 2) return "medium";
+  return "low";
+}
+function assessQualityCriticality(input) {
+  const text = `${input.rawIdea} ${input.objective} ${input.scopeText}`.toLowerCase();
+  if (/\bauth\b|\boauth\b|\bjwt\b|\brbac\b|\bpayment\b|\bbilling\b|\bpii\b|\bsecure\b|\bsecurity\b/.test(text)) return "high";
+  if (/\bperformance\b|\bscalable\b|\bbackground\b|\bworker\b|\bintegration\b|\bwebhook\b/.test(text)) return "medium";
+  return "low";
+}
+function buildRiskProfile(input) {
+  const text = `${input.rawIdea} ${input.objective} ${input.scopeText}`.toLowerCase();
+  const risks = [
+    /\bauth\b|\boauth\b|\bjwt\b|\brbac\b/.test(text) ? "auth" : null,
+    /\bpayment\b|\bbilling\b|\bsubscription\b/.test(text) ? "payments" : null,
+    /\bdatabase\b|\bmigration\b|\bschema\b/.test(text) ? "data_model" : null,
+    /\bworker\b|\bqueue\b|\bbackground\b|\bcron\b/.test(text) ? "async_processing" : null,
+    /\bintegration\b|\bwebhook\b|\bexternal\b/.test(text) ? "external_integration" : null,
+    /\bperformance\b|\blatency\b|\bthroughput\b/.test(text) ? "performance" : null
+  ];
+  return Array.from(new Set(risks.filter((risk) => Boolean(risk))));
+}
 function runTriageLogic(input, matrix) {
   const effort = calculateEffort(input.filesChanged, input.acCount, input.rawIdea);
   const { priority, label: priorityLabel } = calculatePriority(input.type, effort, input.totalRisks, matrix);
+  const complexity = assessComplexity(input);
+  const coupling = assessCoupling(input);
+  const parallelizability = assessParallelizability(input, coupling);
+  const qualityCriticality = assessQualityCriticality(input);
+  const riskProfile = buildRiskProfile(input);
   const effortLabel = matrix.effort_rules[effort]?.label ?? `effort:${effort}`;
   const typeLabel = matrix.auto_labels[input.type] ?? "";
   const targetState = matrix.target_state_by_type[input.type] ?? matrix.target_state_by_type.default ?? "To Do";
@@ -139996,7 +140769,7 @@ function runTriageLogic(input, matrix) {
     objective: input.objective ?? input.rawIdea,
     scopeItems: (input.scopeText ?? "").split("\n").filter((l) => l.trim()),
     acceptanceCriteria: (input.acText ?? "").split("\n").filter((l) => l.trim()),
-    dod: input.scopeText ?? ""
+    dod: input.dodText ?? ""
   });
   const specQualityBlock = specQualityErrors.length > 0;
   return {
@@ -140004,6 +140777,11 @@ function runTriageLogic(input, matrix) {
     priorityLabel,
     effort,
     effortLabel,
+    complexity,
+    coupling,
+    parallelizability,
+    qualityCriticality,
+    riskProfile,
     typeLabel,
     targetState,
     dispatchLabel,
@@ -140038,47 +140816,333 @@ function validateSpecQuality(input) {
   return errors;
 }
 
+// lib/intake/lib/decomposition-planner.ts
+var CAPABILITY_PATTERNS = [
+  { area: "auth", label: "Authentication & Access", regex: /\b(auth|oauth|jwt|login|register|session|permission|rbac|role)\b/i },
+  { area: "worker", label: "Background Jobs & Automation", regex: /\b(worker|background|queue|job|scheduler|reminder|async|cron)\b/i },
+  { area: "notifications", label: "Notifications & Delivery", regex: /\b(notification|notify|email|sms|webhook|alert|message)\b/i },
+  { area: "frontend", label: "Frontend & UX", regex: /\b(ui|frontend|page|screen|dashboard|view|form)\b/i },
+  { area: "data", label: "Data Model & Persistence", regex: /\b(database|schema|model|migration|persist|storage|repository|crud)\b/i },
+  { area: "api", label: "API & Application Flow", regex: /\b(api|endpoint|route|http|rest|graphql|handler)\b/i },
+  { area: "integration", label: "Integrations & External Services", regex: /\b(integration|provider|third-party|external|sync|import|export)\b/i },
+  { area: "qa", label: "QA, Docs & Release Readiness", regex: /\b(test|qa|coverage|document|docs|guide|readme|validation)\b/i },
+  { area: "core", label: "Core Workflow", regex: /./i }
+];
+var AREA_LABEL = Object.fromEntries(
+  CAPABILITY_PATTERNS.map((entry) => [entry.area, entry.label])
+);
+function normalizeLines(items) {
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function detectCapabilityArea(text, deliveryTarget) {
+  const normalized = text.trim();
+  for (const entry of CAPABILITY_PATTERNS) {
+    if (entry.regex.test(normalized)) return entry.area;
+  }
+  if (deliveryTarget === "api") return "api";
+  if (deliveryTarget === "web-ui") return "frontend";
+  return "core";
+}
+function matchesArea(text, area) {
+  const entry = CAPABILITY_PATTERNS.find((candidate) => candidate.area === area);
+  return entry ? entry.regex.test(text) : false;
+}
+function estimateEffort(scopeItems, area) {
+  if (scopeItems.length >= 3 || ["auth", "worker", "integration"].includes(area)) return "large";
+  if (scopeItems.length === 2 || ["api", "data", "frontend", "notifications"].includes(area)) return "medium";
+  return "small";
+}
+function recommendedLevelFor(area, estimatedEffort) {
+  if (estimatedEffort === "large") return "senior";
+  if (["auth", "worker", "integration"].includes(area)) return "senior";
+  if (estimatedEffort === "medium") return "medior";
+  if (area === "qa") return "junior";
+  return "medior";
+}
+function isFoundationArea(area) {
+  return area === "auth" || area === "data" || area === "core";
+}
+function filterRelevantItems(items, scopeItems, area) {
+  const normalized = normalizeLines(items);
+  if (normalized.length === 0) return [];
+  const scopeText = scopeItems.join(" ");
+  const matches2 = normalized.filter((item) => matchesArea(item, area) || scopeItems.some((scopeItem) => item.includes(scopeItem)) || item.includes(scopeText));
+  if (matches2.length > 0) return matches2;
+  return normalized.slice(0, Math.min(normalized.length, Math.max(2, scopeItems.length)));
+}
+function buildObjective(parentObjective, area, scopeItems) {
+  const label = AREA_LABEL[area];
+  const primaryScope = scopeItems[0] ?? parentObjective;
+  return `Deliver the ${label.toLowerCase()} slice of the parent initiative by completing ${primaryScope.toLowerCase()}.`;
+}
+function buildDependencyIndexes(area, priorAreas) {
+  const indexes = [];
+  priorAreas.forEach((priorArea, index) => {
+    if (isFoundationArea(priorArea) && !isFoundationArea(area)) indexes.push(index);
+    if (area !== "auth" && priorArea === "auth") indexes.push(index);
+    if (["api", "frontend", "worker", "notifications"].includes(area) && priorArea === "data") indexes.push(index);
+    if (["worker", "notifications", "integration"].includes(area) && priorArea === "api") indexes.push(index);
+  });
+  return Array.from(new Set(indexes));
+}
+function buildDependencyHints(area, priorAreas, allAreas) {
+  const hints = [];
+  if (area !== "auth" && allAreas.includes("auth")) hints.push("Coordinate with the authentication/access child before changing protected flows.");
+  if (["worker", "notifications", "integration"].includes(area) && allAreas.includes("api")) {
+    hints.push("Align payload contracts and triggering conditions with the API/application-flow child.");
+  }
+  if (["api", "frontend", "worker", "notifications"].includes(area) && allAreas.includes("data")) {
+    hints.push("Reuse the canonical data model/migration decisions from the persistence child.");
+  }
+  if (priorAreas.some(isFoundationArea) && !isFoundationArea(area)) {
+    hints.push("Start after foundational contracts are stable, but keep implementation isolated enough for a separate PR.");
+  }
+  return Array.from(new Set(hints));
+}
+function buildPlannedChildren(spec, effort) {
+  const scopeItems = normalizeLines(spec.scope_v1);
+  const maxChildren = effort === "xlarge" ? 4 : 3;
+  const orderedAreas = [];
+  const areaToItems = /* @__PURE__ */ new Map();
+  for (const item of scopeItems) {
+    const area = detectCapabilityArea(item, spec.delivery_target);
+    if (!areaToItems.has(area)) {
+      areaToItems.set(area, []);
+      orderedAreas.push(area);
+    }
+    areaToItems.get(area).push(item);
+  }
+  let planned = orderedAreas.map((area) => ({ capabilityArea: area, scopeItems: areaToItems.get(area) ?? [] }));
+  if (planned.length > maxChildren) {
+    const kept = planned.slice(0, maxChildren - 1);
+    const merged = planned.slice(maxChildren - 1).flatMap((entry) => entry.scopeItems);
+    kept.push({ capabilityArea: planned[maxChildren - 1]?.capabilityArea ?? "core", scopeItems: merged });
+    planned = kept;
+  }
+  if (planned.length === 1 && scopeItems.length >= 4) {
+    const midpoint = Math.ceil(scopeItems.length / 2);
+    planned = [
+      { capabilityArea: planned[0]?.capabilityArea ?? "core", scopeItems: scopeItems.slice(0, midpoint) },
+      { capabilityArea: planned[0]?.capabilityArea ?? "core", scopeItems: scopeItems.slice(midpoint) }
+    ];
+  }
+  return planned.filter((entry) => entry.scopeItems.length > 0);
+}
+function buildDescription(opts) {
+  const { issueNumber, child, outOfScope, constraints, risks } = opts;
+  return [
+    "## Objective",
+    child.objective,
+    "",
+    "## Parent Issue",
+    `Parent issue: #${issueNumber}`,
+    "",
+    "## Capability Area",
+    `- ${AREA_LABEL[child.capabilityArea]}`,
+    "",
+    "## Execution Profile",
+    `- Recommended level: ${child.recommendedLevel}`,
+    `- Estimated effort: ${child.estimatedEffort}`,
+    `- Parallelizable: ${child.parallelizable ? "yes" : "no"}`,
+    ...child.dependencyHints.map((hint) => `- Dependency hint: ${hint}`),
+    "",
+    "## Scope",
+    ...child.scopeItems.map((item) => `- ${item}`),
+    "",
+    "## Acceptance Criteria",
+    ...child.acceptanceCriteria.map((item) => `- ${item}`),
+    "",
+    "## Definition of Done",
+    ...child.definitionOfDone.map((item) => `- ${item}`),
+    ...outOfScope.length > 0 ? ["", "## Out of Scope", ...outOfScope.map((item) => `- ${item}`)] : [],
+    ...constraints?.trim() ? ["", "## Constraints", constraints.trim()] : [],
+    ...risks.length > 0 ? ["", "## Risks / Coordination Notes", ...risks.map((item) => `- ${item}`)] : []
+  ].join("\n");
+}
+function buildDecompositionChildDrafts(spec, issueNumber, effort) {
+  const plannedChildren = buildPlannedChildren(spec, effort);
+  const allAreas = plannedChildren.map((entry) => entry.capabilityArea);
+  const areaCounts = /* @__PURE__ */ new Map();
+  return plannedChildren.map((plannedChild, index) => {
+    const estimatedEffort = estimateEffort(plannedChild.scopeItems, plannedChild.capabilityArea);
+    const recommendedLevel = recommendedLevelFor(plannedChild.capabilityArea, estimatedEffort);
+    const priorAreas = plannedChildren.slice(0, index).map((entry) => entry.capabilityArea);
+    const dependencyIndexes = buildDependencyIndexes(plannedChild.capabilityArea, priorAreas);
+    const dependencyHints = buildDependencyHints(plannedChild.capabilityArea, priorAreas, allAreas);
+    const parallelizable = dependencyIndexes.length === 0 && !isFoundationArea(plannedChild.capabilityArea);
+    const acceptanceCriteria = filterRelevantItems(spec.acceptance_criteria, plannedChild.scopeItems, plannedChild.capabilityArea);
+    const definitionOfDone = filterRelevantItems(spec.definition_of_done, plannedChild.scopeItems, plannedChild.capabilityArea);
+    const occurrence = (areaCounts.get(plannedChild.capabilityArea) ?? 0) + 1;
+    areaCounts.set(plannedChild.capabilityArea, occurrence);
+    const titleSuffix = occurrence > 1 ? ` ${occurrence}` : "";
+    const title = `${spec.title} \u2014 ${AREA_LABEL[plannedChild.capabilityArea]}${titleSuffix}`;
+    const child = {
+      title,
+      objective: buildObjective(spec.objective, plannedChild.capabilityArea, plannedChild.scopeItems),
+      scopeItems: plannedChild.scopeItems,
+      acceptanceCriteria,
+      definitionOfDone,
+      recommendedLevel,
+      estimatedEffort,
+      dependencyHints,
+      dependencyIndexes,
+      capabilityArea: plannedChild.capabilityArea,
+      parallelizable,
+      description: ""
+    };
+    child.description = buildDescription({
+      issueNumber,
+      parentObjective: spec.objective,
+      child,
+      outOfScope: normalizeLines(spec.out_of_scope),
+      constraints: spec.constraints,
+      risks: normalizeLines(spec.risks)
+    });
+    return child;
+  });
+}
+
+// lib/intake/lib/fidelity-brief.ts
+var HARD_CONSTRAINT_PATTERNS = [
+  { regex: /\bmust use ([a-z0-9.+#_-]+)/i, value: "explicit_stack_requirement" },
+  { regex: /\buse ([a-z0-9.+#_-]+)\b/i, value: "explicit_technology_requirement" },
+  { regex: /\bwithout ([a-z0-9.+#_-]+)/i, value: "explicit_technology_exclusion" },
+  { regex: /\bself-host(?:ed)?\b/i, value: "self_hosted" },
+  { regex: /\boffline\b/i, value: "offline_capable" },
+  { regex: /\bopen source\b/i, value: "open_source_only" }
+];
+var SOFT_PREFERENCE_PATTERNS = [
+  { regex: /\bprefer\b/i, value: "explicit_preference" },
+  { regex: /\bclean (?:architecture|code)\b/i, value: "clean_code_preference" },
+  { regex: /\bmodern\b/i, value: "modern_stack_preference" },
+  { regex: /\bsimple\b/i, value: "simplicity_preference" }
+];
+var QUALITY_EXPECTATION_PATTERNS = [
+  { regex: /\bproduction[- ]ready\b/i, value: "production_ready" },
+  { regex: /\bhigh[- ]performance\b|\bperformant\b/i, value: "performance" },
+  { regex: /\bsecure\b|\bsecurity\b/i, value: "security" },
+  { regex: /\bscalable\b|\bscale\b/i, value: "scalability" },
+  { regex: /\bmaintainable\b|\bclean code\b/i, value: "maintainability" },
+  { regex: /\bwell[- ]tested\b|\bhigh[- ]quality\b/i, value: "high_quality" }
+];
+var RISK_SIGNAL_PATTERNS = [
+  { regex: /\bauth\b|\blogin\b|\boauth\b|\bjwt\b|\brbac\b|\bpermission/i, value: "auth_security_sensitive" },
+  { regex: /\bpayment\b|\bbilling\b|\bsubscription/i, value: "payment_sensitive" },
+  { regex: /\bmigration\b|\bschema\b|\bdatabase\b/i, value: "data_model_change" },
+  { regex: /\bworker\b|\bqueue\b|\bcron\b|\bbackground job\b/i, value: "async_orchestration" },
+  { regex: /\bintegration\b|\bwebhook\b|\bthird-party\b|\bexternal service\b/i, value: "external_integration" },
+  { regex: /\bperformance\b|\bhigh traffic\b|\blow latency\b/i, value: "performance_sensitive" }
+];
+var EXPLICIT_NON_GOAL_PATTERNS = [
+  { regex: /\bdo not add ([^.\n]+)/i, value: "no_extra_features" },
+  { regex: /\bout of scope\b/i, value: "explicit_out_of_scope" },
+  { regex: /\bnot required\b/i, value: "explicit_not_required" }
+];
+function unique(values) {
+  return Array.from(new Set(values.filter((value) => Boolean(value && value.trim()))));
+}
+function normalizeText3(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+function inferDeliverable(rawIdea, spec, metadata) {
+  const target = spec?.delivery_target ?? metadata?.delivery_target;
+  if (target && target !== "unknown") return target;
+  const text = rawIdea.toLowerCase();
+  if (/\bcli\b|\bcommand line\b/.test(text)) return "cli";
+  if (/\bapi\b|\bendpoint\b|\brest\b|\bgraphql\b/.test(text)) return "api";
+  if (/\bweb app\b|\bfrontend\b|\bui\b|\bdashboard\b|\bpage\b/.test(text)) return "web-ui";
+  if (/\blibrary\b|\bsdk\b|\bpackage\b/.test(text)) return "library";
+  if (/\bautomation\b|\bworker\b|\bjob\b|\bbot\b/.test(text)) return "automation";
+  return "unknown";
+}
+function inferPrimaryObjective(rawIdea, spec) {
+  if (spec?.objective?.trim()) return normalizeText3(spec.objective);
+  const sentence = rawIdea.split(/(?<=[.!?])\s+/)[0] ?? rawIdea;
+  return normalizeText3(sentence);
+}
+function collectMatches(text, patterns) {
+  return unique(patterns.map((pattern) => pattern.regex.test(text) ? pattern.value : null));
+}
+function deriveAmbiguityFlags(rawIdea, deliverable, requestedStack, inferredStack, spec) {
+  const flags = [];
+  if (deliverable === "unknown") flags.push("ambiguous_deliverable");
+  if (!requestedStack && !inferredStack && /\bbuild|create|make\b/i.test(rawIdea) && deliverable !== "unknown") {
+    flags.push("missing_stack_preference");
+  }
+  if (!spec?.scope_v1?.length) flags.push("missing_structured_scope");
+  if (spec && spec.acceptance_criteria.length === 0) flags.push("missing_acceptance_criteria");
+  return unique(flags);
+}
+function deriveConfidence(ambiguityFlags, spec, metadata) {
+  if (metadata?.stack_confidence === "high" && ambiguityFlags.length === 0 && (spec?.acceptance_criteria.length ?? 0) >= 2) {
+    return "high";
+  }
+  if (ambiguityFlags.some((flag) => flag === "ambiguous_deliverable" || flag === "missing_structured_scope")) {
+    return "low";
+  }
+  return "medium";
+}
+function buildFidelityBrief(opts) {
+  const rawIdea = normalizeText3(opts.rawIdea);
+  const spec = opts.spec;
+  const metadata = opts.metadata;
+  const combinedText = [
+    rawIdea,
+    spec?.objective,
+    spec?.constraints,
+    ...spec?.scope_v1 ?? [],
+    ...spec?.out_of_scope ?? [],
+    ...spec?.acceptance_criteria ?? [],
+    ...spec?.definition_of_done ?? [],
+    ...spec?.risks ?? []
+  ].filter(Boolean).join("\n");
+  const requestedDeliverable = inferDeliverable(rawIdea, spec, metadata);
+  const requestedStack = metadata?.stack_hint ?? null;
+  const inferredStack = requestedStack ?? null;
+  const hardConstraints = collectMatches(combinedText, HARD_CONSTRAINT_PATTERNS);
+  const softPreferences = collectMatches(combinedText, SOFT_PREFERENCE_PATTERNS);
+  const explicitNonGoals = unique([
+    ...collectMatches(combinedText, EXPLICIT_NON_GOAL_PATTERNS),
+    ...(spec?.out_of_scope ?? []).map((item) => normalizeText3(item))
+  ]);
+  const qualityExpectations = collectMatches(combinedText, QUALITY_EXPECTATION_PATTERNS);
+  const riskSignals = collectMatches(combinedText, RISK_SIGNAL_PATTERNS);
+  const ambiguityFlags = deriveAmbiguityFlags(rawIdea, requestedDeliverable, requestedStack, inferredStack, spec);
+  const confidence = deriveConfidence(ambiguityFlags, spec, metadata);
+  return {
+    primary_objective: inferPrimaryObjective(rawIdea, spec),
+    requested_deliverable: requestedDeliverable,
+    requested_stack: requestedStack,
+    inferred_stack: inferredStack,
+    hard_constraints: hardConstraints,
+    soft_preferences: softPreferences,
+    explicit_non_goals: explicitNonGoals,
+    quality_expectations: qualityExpectations,
+    ambiguity_flags: ambiguityFlags,
+    risk_signals: riskSignals,
+    confidence
+  };
+}
+
 // lib/intake/steps/triage.ts
 import { createRequire as createRequire3 } from "node:module";
 var _require3 = createRequire3(import.meta.url);
 var cachedMatrix = null;
+function shouldAutoDecompose(decision) {
+  if (!decision.readyForDispatch || decision.specQualityBlock) return false;
+  if (decision.effort === "xlarge") return true;
+  if (decision.effort !== "large") return false;
+  return decision.parallelizability !== "low" && decision.coupling !== "high";
+}
+function computeMaxParallelChildren(drafts) {
+  const parallelizableCount = drafts.filter((draft) => draft.parallelizable).length;
+  return Math.min(4, Math.max(1, parallelizableCount || 1));
+}
 function loadMatrix() {
   if (cachedMatrix) return cachedMatrix;
   cachedMatrix = _require3("../configs/triage-matrix.json");
   return cachedMatrix;
 }
-function buildChildDrafts(payload, issueNumber, effort) {
-  const spec = payload.spec;
-  const scopeItems = spec.scope_v1.filter((item) => item.trim().length > 0);
-  const maxChildren = effort === "xlarge" ? 4 : 3;
-  const chunkSize = 2;
-  const drafts = [];
-  for (let i2 = 0; i2 < scopeItems.length && drafts.length < maxChildren; i2 += chunkSize) {
-    const slice = scopeItems.slice(i2, i2 + chunkSize);
-    if (slice.length === 0) continue;
-    const childIndex = drafts.length + 1;
-    drafts.push({
-      title: `${spec.title} \u2014 Part ${childIndex}`,
-      description: [
-        `## Objective`,
-        spec.objective,
-        "",
-        `## Parent Issue`,
-        `Parent issue: #${issueNumber}`,
-        "",
-        `## This Part`,
-        ...slice.map((item) => `- ${item}`),
-        "",
-        `## Acceptance Criteria`,
-        ...spec.acceptance_criteria.map((item) => `- ${item}`),
-        "",
-        `## Definition of Done`,
-        ...spec.definition_of_done.map((item) => `- ${item}`)
-      ].join("\n")
-    });
-  }
-  return drafts;
-}
 var triageStep = {
   name: "triage",
   shouldRun: (payload) => !!payload.issues?.length && !payload.dry_run,
@@ -140088,6 +141152,11 @@ var triageStep = {
     const impact = payload.impact;
     const issue2 = payload.issues[0];
     ctx.log(`Running triage for issue #${issue2.number}`);
+    const fidelityBrief = buildFidelityBrief({
+      rawIdea: payload.raw_idea,
+      spec,
+      metadata: payload.metadata
+    });
     const decision = runTriageLogic({
       type: spec.type,
       deliveryTarget: spec.delivery_target,
@@ -140100,8 +141169,9 @@ var triageStep = {
       rawIdea: payload.raw_idea,
       acText: spec.acceptance_criteria.join("\n"),
       scopeText: spec.scope_v1.join("\n"),
+      dodText: spec.definition_of_done.join("\n"),
       oosText: spec.out_of_scope.join("\n"),
-      authSignal: payload.metadata?.auth_gate?.signal ?? false
+      authSignal: /\b(login|register|jwt|oauth|auth|role-based access|rbac|permission)\b/i.test(`${payload.raw_idea} ${spec.objective}`)
     }, matrix);
     const repoUrl = payload.scaffold?.repo_url ?? payload.metadata?.repo_url ?? "";
     const repoPath = payload.provisioning?.repo_local ?? payload.scaffold?.repo_local ?? payload.metadata?.repo_path ?? payload.project_map?.root ?? void 0;
@@ -140112,8 +141182,9 @@ var triageStep = {
     if (decision.typeLabel) allLabels.push(decision.typeLabel);
     if (!decision.readyForDispatch || decision.specQualityBlock) allLabels.push("needs-human");
     const uniqueLabels = Array.from(new Set(allLabels.filter(Boolean)));
-    const shouldDecompose = decision.readyForDispatch && !decision.specQualityBlock && ["large", "xlarge"].includes(decision.effort);
-    const decompositionDrafts = shouldDecompose ? buildChildDrafts(payload, issue2.number, decision.effort) : [];
+    const decompositionRequested = decision.readyForDispatch && !decision.specQualityBlock && ["large", "xlarge"].includes(decision.effort);
+    const shouldDecompose = shouldAutoDecompose(decision);
+    const decompositionDrafts = shouldDecompose ? buildDecompositionChildDrafts(spec, issue2.number, decision.effort) : [];
     const canDecompose = decompositionDrafts.length >= 2;
     let createdChildIssueNumbers = [];
     if (ctx.createIssueProvider && repoPath) {
@@ -140134,25 +141205,55 @@ var triageStep = {
         } else if (canDecompose) {
           await provider.addLabel(issue2.number, "decomposition:parent");
           const childIssues = [];
+          const createdChildren = [];
           for (const draft of decompositionDrafts) {
             const child = await provider.createIssue(draft.title, draft.description, initialLabel);
             childIssues.push({ iid: child.iid, title: child.title, web_url: child.web_url });
+            createdChildren.push({ iid: child.iid, title: child.title, web_url: child.web_url, draft });
             createdChildIssueNumbers.push(child.iid);
             for (const label of uniqueLabels) {
               await provider.addLabel(child.iid, label);
             }
             await provider.addLabel(child.iid, "decomposition:child");
+            await provider.transitionLabel(child.iid, initialLabel, decision.targetState);
+            if (decision.targetState === "To Do" && decision.dispatchLabel) {
+              await provider.addLabel(child.iid, decision.dispatchLabel);
+            }
+            if (decision.targetState === "To Do") {
+              await provider.addLabel(child.iid, `developer:${draft.recommendedLevel}`);
+            }
+          }
+          if (projectSlug) {
+            for (const child of createdChildren) {
+              await updateIssueRuntime(ctx.workspaceDir, projectSlug, child.iid, {
+                parentIssueId: issue2.number,
+                dependencyIssueIds: child.draft.dependencyIndexes.map((index) => createdChildren[index]?.iid).filter((value) => Number.isFinite(value)),
+                childReadyForDispatch: decision.targetState === "To Do",
+                parallelizable: child.draft.parallelizable,
+                recommendedLevel: child.draft.recommendedLevel,
+                decompositionMode: "none",
+                decompositionStatus: null
+              }).catch(() => {
+              });
+            }
+            await updateIssueRuntime(ctx.workspaceDir, projectSlug, issue2.number, {
+              childIssueIds: createdChildIssueNumbers,
+              maxParallelChildren: computeMaxParallelChildren(decompositionDrafts),
+              decompositionMode: "parent_child",
+              decompositionStatus: "active"
+            }).catch(() => {
+            });
           }
           await provider.addComment(issue2.number, [
             "## Decomposition Plan",
             ...childIssues.map((child) => `- [ ] #${child.iid} ${child.title}`)
           ].join("\n"));
-        } else if (shouldDecompose) {
+        } else if (decompositionRequested && shouldDecompose) {
           await provider.addLabel(issue2.number, "needs-human");
           await provider.addComment(issue2.number, [
-            "\u26A0\uFE0F Automatic decomposition was requested, but the generated spec did not yield at least two independently scoped child tasks.",
+            shouldDecompose ? "\u26A0\uFE0F Automatic decomposition was requested, but the generated spec did not yield at least two independently scoped child tasks." : "\u26A0\uFE0F This request is large, but triage detected high coupling / low parallelizability. Fabrica will keep it as one executable issue unless a human explicitly splits it.",
             "",
-            "Refine the scope/acceptance criteria or split the plan manually before dispatch."
+            shouldDecompose ? "Refine the scope/acceptance criteria or split the plan manually before dispatch." : "If you still want multiple child issues, split the plan manually along stable boundaries before dispatch."
           ].join("\n"));
         } else if (decision.readyForDispatch) {
           await provider.transitionLabel(issue2.number, initialLabel, decision.targetState);
@@ -140214,6 +141315,11 @@ var triageStep = {
     const triage = {
       priority: decision.priority,
       effort: decision.effort,
+      complexity: decision.complexity,
+      coupling: decision.coupling,
+      parallelizability: decision.parallelizability,
+      quality_criticality: decision.qualityCriticality,
+      risk_profile: decision.riskProfile,
       target_state: decision.targetState,
       project_slug: payload.scaffold?.project_slug ?? null,
       project_channel_id: null,
@@ -140223,15 +141329,41 @@ var triageStep = {
       errors: [
         ...decision.errors,
         ...decision.specQualityBlock ? ["spec_quality_block"] : [],
-        ...shouldDecompose && !canDecompose ? ["decomposition_needs_human"] : []
+        ...decompositionRequested && shouldDecompose && !canDecompose ? ["decomposition_needs_human"] : []
       ],
       decomposition_mode: canDecompose ? "parent_child" : "none",
       child_issue_numbers: createdChildIssueNumbers
     };
     ctx.log(`Triage: ${triage.priority}, effort=${triage.effort}, ready=${triage.ready_for_dispatch}`);
+    const bootstrapConversationId = payload.metadata?.source === "telegram-dm-bootstrap" ? payload.metadata?.channel_id : null;
+    if (bootstrapConversationId) {
+      await upsertTelegramBootstrapSession(ctx.workspaceDir, {
+        conversationId: String(bootstrapConversationId),
+        rawIdea: payload.raw_idea,
+        projectName: payload.metadata?.project_name ?? null,
+        stackHint: payload.metadata?.stack_hint ?? null,
+        repoUrl: payload.provisioning?.repo_url ?? payload.scaffold?.repo_url ?? payload.metadata?.repo_url ?? null,
+        repoPath: payload.provisioning?.repo_local ?? payload.scaffold?.repo_local ?? payload.metadata?.repo_path ?? null,
+        status: triage.ready_for_dispatch ? "dispatching" : "completed",
+        bootstrapStep: triage.ready_for_dispatch ? "project_ticked" : "completed",
+        projectSlug: payload.metadata?.project_slug ?? payload.scaffold?.project_slug ?? null,
+        issueId: issue2.number,
+        issueUrl: issue2.url,
+        projectChannelId: triage.project_channel_id ?? payload.metadata?.channel_id ?? null,
+        messageThreadId: payload.metadata?.message_thread_id ?? null,
+        triageReadyForDispatch: triage.ready_for_dispatch,
+        triageErrors: triage.errors
+      }).catch(() => {
+      });
+    }
     return {
       ...payload,
       step: "triage",
+      fidelity_brief: fidelityBrief,
+      metadata: {
+        ...payload.metadata,
+        fidelity_brief: fidelityBrief
+      },
       triage
     };
   }
@@ -140359,6 +141491,43 @@ function mergeArtifacts(primary, secondary) {
   return merged;
 }
 
+// lib/intake/lib/clarification-policy.ts
+function detectScopeClarificationNeed(rawIdea, stackHint) {
+  const text = rawIdea.toLowerCase();
+  if (/\b(livre|free.?choice|your.?call|pode.?escolher|voc[eê].?decide|qualquer)\b/i.test(text)) {
+    return { ask: false };
+  }
+  const subsystems = [
+    /\bauth\b|\blogin\b|\bregister\b|\bjwt\b|\boauth\b/,
+    /\bpayment\b|\bbilling\b|\bsubscription\b/,
+    /\bemail\b|\bnotification\b|\balert\b|\bsms\b/,
+    /\badmin\b|\bdashboard\b|\breport\b/,
+    /\bqueue\b|\bworker\b|\bcron\b|\bjob\b/,
+    /\bdatabase\b|\bmigration\b|\bschema\b/,
+    /\bapi\b|\bwebhook\b|\bintegration\b|\bexternal service\b/
+  ].filter((regex) => regex.test(text)).length;
+  const missingKeyTechChoice = !stackHint || (!/postgres|mysql|sqlite|mongodb/i.test(text) || !/jwt|oauth|session|rbac/i.test(text));
+  if (subsystems >= 3 && missingKeyTechChoice) {
+    return { ask: true, kind: "scope", reason: "scope_ambiguity_across_multiple_subsystems" };
+  }
+  return { ask: false };
+}
+function decideBootstrapClarification(opts) {
+  if (opts.scopeAmbiguous) {
+    return { ask: true, kind: "scope", reason: "scope_ambiguity_requires_structuring" };
+  }
+  if (!opts.stackHint && !opts.projectName) {
+    return { ask: true, kind: "stack_and_name", reason: "missing_stack_and_name" };
+  }
+  if (!opts.stackHint) {
+    return { ask: true, kind: "stack", reason: "missing_stack" };
+  }
+  if (!opts.projectName) {
+    return { ask: true, kind: "name", reason: "missing_project_name" };
+  }
+  return { ask: false };
+}
+
 // lib/services/tick.ts
 init_audit();
 
@@ -140576,23 +141745,25 @@ init_workflow();
 
 // lib/dispatch/dispatch-dedup.ts
 init_constants();
-import fs34 from "node:fs/promises";
-import path35 from "node:path";
-import { createHash as createHash4 } from "node:crypto";
+import fs36 from "node:fs/promises";
+import path36 from "node:path";
+import { createHash as createHash5 } from "node:crypto";
 var DEDUP_FILE = "dispatch-dedup.ndjson";
 var BUCKET_MS = 5 * 6e4;
 var DEFAULT_TTL_MS2 = 30 * 6e4;
+var ACTIVE_CLAIM_TTL_MS = 10 * 6e4;
+var activeClaims = /* @__PURE__ */ new Map();
 function dedupPath(workspaceDir) {
-  return path35.join(workspaceDir, DATA_DIR, DEDUP_FILE);
+  return path36.join(workspaceDir, DATA_DIR, DEDUP_FILE);
 }
 function computeDispatchId(projectSlug, issueId, role, level, now2 = Date.now()) {
   const bucket = Math.floor(now2 / BUCKET_MS);
   const input = `${projectSlug}:${issueId}:${role}:${level}:${bucket}`;
-  return createHash4("sha256").update(input).digest("hex").slice(0, 16);
+  return createHash5("sha256").update(input).digest("hex").slice(0, 16);
 }
 async function readEntries2(filePath) {
   try {
-    const content = await fs34.readFile(filePath, "utf-8");
+    const content = await fs36.readFile(filePath, "utf-8");
     return content.split("\n").filter(Boolean).map((line) => {
       try {
         return JSON.parse(line);
@@ -140605,15 +141776,34 @@ async function readEntries2(filePath) {
     throw err;
   }
 }
+function sweepExpiredClaims(now2 = Date.now()) {
+  for (const [dispatchId, expiresAt] of activeClaims.entries()) {
+    if (expiresAt <= now2) activeClaims.delete(dispatchId);
+  }
+}
 async function isDuplicate(workspaceDir, dispatchId) {
+  sweepExpiredClaims();
+  if (activeClaims.has(dispatchId)) return true;
   const entries = await readEntries2(dedupPath(workspaceDir));
   return entries.some((e2) => e2.id === dispatchId);
 }
+async function claimDispatch(workspaceDir, dispatchId) {
+  sweepExpiredClaims();
+  if (activeClaims.has(dispatchId)) return false;
+  const entries = await readEntries2(dedupPath(workspaceDir));
+  if (entries.some((e2) => e2.id === dispatchId)) return false;
+  activeClaims.set(dispatchId, Date.now() + ACTIVE_CLAIM_TTL_MS);
+  return true;
+}
+function releaseDispatchClaim(dispatchId) {
+  activeClaims.delete(dispatchId);
+}
 async function recordDispatch(workspaceDir, dispatchId) {
   const filePath = dedupPath(workspaceDir);
-  await fs34.mkdir(path35.dirname(filePath), { recursive: true });
+  await fs36.mkdir(path36.dirname(filePath), { recursive: true });
   const entry = { id: dispatchId, ts: Date.now() };
-  await fs34.appendFile(filePath, JSON.stringify(entry) + "\n", "utf-8");
+  await fs36.appendFile(filePath, JSON.stringify(entry) + "\n", "utf-8");
+  activeClaims.delete(dispatchId);
 }
 async function cleanupExpired(workspaceDir, ttlMs = DEFAULT_TTL_MS2) {
   const filePath = dedupPath(workspaceDir);
@@ -140623,8 +141813,8 @@ async function cleanupExpired(workspaceDir, ttlMs = DEFAULT_TTL_MS2) {
   if (kept.length < entries.length) {
     const content = kept.map((e2) => JSON.stringify(e2)).join("\n") + (kept.length > 0 ? "\n" : "");
     const tmpPath = filePath + ".tmp";
-    await fs34.writeFile(tmpPath, content, "utf-8");
-    await fs34.rename(tmpPath, filePath);
+    await fs36.writeFile(tmpPath, content, "utf-8");
+    await fs36.rename(tmpPath, filePath);
   }
 }
 
@@ -140701,7 +141891,7 @@ async function projectTick(opts) {
         continue;
       }
     }
-    const next = await findNextIssueForRole(provider, role, workflow, instanceName);
+    const next = await findNextIssueForRole(provider, role, workflow, instanceName, fresh);
     if (!next) continue;
     const { issue: issue2, label: currentLabel } = next;
     const targetLabel = getActiveLabel(workflow, role);
@@ -140842,11 +142032,6 @@ async function projectTick(opts) {
       skipped.push({ role, reason: `${effectiveLevel} slots full` });
       continue;
     }
-    const dispatchId = computeDispatchId(projectSlug, issue2.iid, role, effectiveLevel);
-    if (await isDuplicate(workspaceDir, dispatchId)) {
-      skipped.push({ role, reason: `dispatch_dedup: ${dispatchId}` });
-      continue;
-    }
     if (role === "developer" || role === "tester") {
       const stack = fresh.stack;
       if (!stack) {
@@ -140893,6 +142078,17 @@ async function projectTick(opts) {
         continue;
       }
     }
+    const dispatchId = computeDispatchId(projectSlug, issue2.iid, role, effectiveLevel);
+    if (!dryRun) {
+      if (await isDuplicate(workspaceDir, dispatchId)) {
+        skipped.push({ role, reason: `dispatch_dedup: ${dispatchId}` });
+        continue;
+      }
+      if (!await claimDispatch(workspaceDir, dispatchId)) {
+        skipped.push({ role, reason: `dispatch_claimed: ${dispatchId}` });
+        continue;
+      }
+    }
     if (dryRun) {
       const existingSession = roleWorker.levels[effectiveLevel]?.[freeSlot]?.sessionKey;
       pickups.push({
@@ -140942,6 +142138,7 @@ async function projectTick(opts) {
         await recordDispatch(workspaceDir, dispatchId).catch(() => {
         });
       } catch (err) {
+        releaseDispatchClaim(dispatchId);
         skipped.push({ role, reason: `Dispatch failed: ${err.message}` });
         continue;
       }
@@ -140967,281 +142164,6 @@ function getFeedbackQueueLabel(workflow) {
 // lib/dispatch/telegram-bootstrap-hook.ts
 init_audit();
 init_zod();
-
-// lib/dispatch/telegram-bootstrap-session.ts
-init_constants();
-import { createHash as createHash5, randomUUID as randomUUID4 } from "node:crypto";
-import fs35 from "node:fs/promises";
-import path36 from "node:path";
-var SESSION_TTL_MS = 10 * 6e4;
-var CLASSIFYING_TTL_MS = 15e3;
-var RELEASED_CLASSIFY_ERRORS = /* @__PURE__ */ new Set([
-  "classify_invalid_result",
-  "classify_low_confidence",
-  "classify_not_project",
-  "classify_result_expired"
-]);
-function toCanonicalTelegramBootstrapConversationId(conversationId) {
-  const trimmed = conversationId.trim();
-  if (!trimmed) return trimmed;
-  return trimmed.startsWith("telegram:") ? trimmed : `telegram:${trimmed}`;
-}
-function sessionsDir(workspaceDir) {
-  return path36.join(workspaceDir, DATA_DIR, "bootstrap-sessions");
-}
-function sessionPath(workspaceDir, conversationId) {
-  return path36.join(
-    sessionsDir(workspaceDir),
-    `${toCanonicalTelegramBootstrapConversationId(conversationId)}.json`
-  );
-}
-function alternateSessionPath(workspaceDir, conversationId) {
-  const canonical = toCanonicalTelegramBootstrapConversationId(conversationId);
-  const bare = canonical.startsWith("telegram:") ? canonical.slice("telegram:".length) : canonical;
-  if (!bare || bare === canonical) return null;
-  return path36.join(sessionsDir(workspaceDir), `${bare}.json`);
-}
-function normalizeStoredSession(session) {
-  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(session.conversationId);
-  if (canonicalConversationId === session.conversationId) {
-    return session;
-  }
-  return {
-    ...session,
-    id: buildBootstrapSessionId(canonicalConversationId, session.rawIdea),
-    conversationId: canonicalConversationId
-  };
-}
-function stableHash(input) {
-  return createHash5("sha256").update(input).digest("hex").slice(0, 16);
-}
-function buildBootstrapSessionId(conversationId, rawIdea) {
-  return `tgdm-${conversationId}-${stableHash(rawIdea.trim().toLowerCase())}`;
-}
-function buildBootstrapRequestFingerprint(input) {
-  return stableHash(JSON.stringify({
-    rawIdea: input.rawIdea.trim().toLowerCase(),
-    projectName: input.projectName?.trim().toLowerCase() || null,
-    stackHint: input.stackHint?.trim().toLowerCase() || null,
-    repoUrl: input.repoUrl?.trim().toLowerCase() || null,
-    repoPath: input.repoPath?.trim().toLowerCase() || null
-  }));
-}
-function buildBootstrapRequestHash(input) {
-  return buildBootstrapRequestFingerprint(input);
-}
-function nextSuppressUntil(status) {
-  const ttl = status === "classifying" || status === "pending_classify" ? CLASSIFYING_TTL_MS : SESSION_TTL_MS;
-  return new Date(Date.now() + ttl).toISOString();
-}
-function isReleasedClassifyFailure(error48) {
-  return Boolean(error48 && RELEASED_CLASSIFY_ERRORS.has(error48));
-}
-function resolveNullableField(inputValue, existingValue, fallback = null) {
-  return inputValue !== void 0 ? inputValue : existingValue ?? fallback;
-}
-function defaultNextRetryAtForStatus(status, existingValue) {
-  if (status === "bootstrapping" || status === "dispatching") {
-    return existingValue ?? null;
-  }
-  return null;
-}
-var MONOTONIC_BOOTSTRAP_FIELDS = [
-  "ackSentAt",
-  "projectRegisteredAt",
-  "topicKickoffSentAt",
-  "projectTickedAt",
-  "completionAckSentAt"
-];
-function shouldPersistBootstrapCheckpoint(current, next) {
-  if (!current) return { ok: true };
-  if (current.conversationId !== next.conversationId) return { ok: true };
-  const currentAttemptSeq = current.attemptSeq ?? null;
-  const nextAttemptSeq = next.attemptSeq ?? null;
-  if (currentAttemptSeq != null && nextAttemptSeq != null && nextAttemptSeq < currentAttemptSeq) {
-    return { ok: false, reason: "stale_regression" };
-  }
-  const sameAttempt = Boolean(
-    current.attemptId && next.attemptId && current.attemptSeq != null && next.attemptSeq != null && current.attemptId === next.attemptId && current.attemptSeq === next.attemptSeq
-  );
-  if (!sameAttempt) return { ok: true };
-  for (const field of MONOTONIC_BOOTSTRAP_FIELDS) {
-    if (current[field] && !next[field]) {
-      return { ok: false, reason: "stale_regression" };
-    }
-  }
-  return { ok: true };
-}
-async function readTelegramBootstrapSession(workspaceDir, conversationId) {
-  const canonicalConversationId = toCanonicalTelegramBootstrapConversationId(conversationId);
-  const paths = [
-    sessionPath(workspaceDir, canonicalConversationId),
-    alternateSessionPath(workspaceDir, conversationId)
-  ].filter((entry) => Boolean(entry));
-  try {
-    for (const candidatePath of paths) {
-      try {
-        const raw = await fs35.readFile(candidatePath, "utf-8");
-        const session = normalizeStoredSession(JSON.parse(raw));
-        if (session.status === "failed" && isReleasedClassifyFailure(session.error)) {
-          await deleteTelegramBootstrapSession(workspaceDir, canonicalConversationId);
-          return null;
-        }
-        return session;
-      } catch (error48) {
-        if (error48?.code === "ENOENT") continue;
-        throw error48;
-      }
-    }
-    return null;
-  } catch (error48) {
-    if (error48?.code === "ENOENT") return null;
-    throw error48;
-  }
-}
-async function deleteTelegramBootstrapSession(workspaceDir, conversationId) {
-  await fs35.unlink(sessionPath(workspaceDir, conversationId)).catch(() => {
-  });
-  const legacyPath = alternateSessionPath(workspaceDir, conversationId);
-  if (legacyPath) {
-    await fs35.unlink(legacyPath).catch(() => {
-    });
-  }
-}
-async function writeTelegramBootstrapSession(workspaceDir, session) {
-  const canonicalSession = normalizeStoredSession(session);
-  const dir = sessionsDir(workspaceDir);
-  await fs35.mkdir(dir, { recursive: true });
-  const file2 = sessionPath(workspaceDir, canonicalSession.conversationId);
-  const tmp = `${file2}.${randomUUID4()}.tmp`;
-  await fs35.writeFile(tmp, JSON.stringify(canonicalSession, null, 2) + "\n", "utf-8");
-  await fs35.rename(tmp, file2);
-  const legacyPath = alternateSessionPath(workspaceDir, session.conversationId);
-  if (legacyPath) {
-    await fs35.unlink(legacyPath).catch(() => {
-    });
-  }
-}
-async function upsertTelegramBootstrapSession(workspaceDir, input) {
-  const conversationId = toCanonicalTelegramBootstrapConversationId(input.conversationId);
-  const existing = await readTelegramBootstrapSession(workspaceDir, conversationId);
-  const resolvedSourceRoute = resolveNullableField(input.sourceRoute, existing?.sourceRoute);
-  const resolvedProjectRoute = resolveNullableField(input.projectRoute, existing?.projectRoute);
-  const resolvedProjectName = resolveNullableField(input.projectName, existing?.projectName);
-  const resolvedStackHint = resolveNullableField(input.stackHint, existing?.stackHint);
-  const resolvedRepoUrl = resolveNullableField(input.repoUrl, existing?.repoUrl);
-  const resolvedRepoPath = resolveNullableField(input.repoPath, existing?.repoPath);
-  const resolvedProjectSlug = resolveNullableField(input.projectSlug, existing?.projectSlug);
-  const resolvedIssueId = resolveNullableField(input.issueId, existing?.issueId);
-  const resolvedMessageThreadId = resolveNullableField(input.messageThreadId, existing?.messageThreadId);
-  const resolvedProjectChannelId = resolveNullableField(input.projectChannelId, existing?.projectChannelId);
-  const resolvedAttemptCount = resolveNullableField(input.attemptCount, existing?.attemptCount, 0);
-  const resolvedAttemptId = resolveNullableField(input.attemptId, existing?.attemptId);
-  const resolvedAttemptSeq = resolveNullableField(input.attemptSeq, existing?.attemptSeq);
-  const resolvedClassifySessionKey = resolveNullableField(input.classifySessionKey, existing?.classifySessionKey);
-  const resolvedClassifyRunId = resolveNullableField(input.classifyRunId, existing?.classifyRunId);
-  const resolvedClassifyStartedAt = resolveNullableField(input.classifyStartedAt, existing?.classifyStartedAt);
-  const resolvedBootstrapStep = resolveNullableField(input.bootstrapStep, existing?.bootstrapStep);
-  const resolvedNextRetryAt = input.nextRetryAt !== void 0 ? input.nextRetryAt : defaultNextRetryAtForStatus(input.status, existing?.nextRetryAt);
-  const resolvedAckSentAt = resolveNullableField(input.ackSentAt, existing?.ackSentAt);
-  const resolvedProjectRegisteredAt = resolveNullableField(input.projectRegisteredAt, existing?.projectRegisteredAt);
-  const resolvedTopicKickoffSentAt = resolveNullableField(input.topicKickoffSentAt, existing?.topicKickoffSentAt);
-  const resolvedProjectTickedAt = resolveNullableField(input.projectTickedAt, existing?.projectTickedAt);
-  const resolvedCompletionAckSentAt = resolveNullableField(input.completionAckSentAt, existing?.completionAckSentAt);
-  const resolvedError = input.error !== void 0 ? input.error : input.lastError !== void 0 ? input.lastError : existing?.error ?? existing?.lastError ?? null;
-  const requestHash = buildBootstrapRequestHash({
-    rawIdea: input.rawIdea,
-    projectName: resolvedProjectName,
-    stackHint: resolvedStackHint,
-    repoUrl: resolvedRepoUrl,
-    repoPath: resolvedRepoPath
-  });
-  const now2 = (/* @__PURE__ */ new Date()).toISOString();
-  const session = {
-    id: existing?.id ?? buildBootstrapSessionId(conversationId, input.rawIdea),
-    conversationId,
-    sourceChannel: input.sourceChannel ?? input.sourceRoute?.channel ?? existing?.sourceChannel ?? "telegram",
-    sourceRoute: resolvedSourceRoute,
-    projectRoute: resolvedProjectRoute,
-    requestHash,
-    requestFingerprint: requestHash,
-    lastCompletedRequestHash: input.status === "completed" ? requestHash : existing?.lastCompletedRequestHash ?? null,
-    rawIdea: input.rawIdea,
-    projectName: resolvedProjectName,
-    stackHint: resolvedStackHint,
-    repoUrl: resolvedRepoUrl,
-    repoPath: resolvedRepoPath,
-    projectSlug: resolvedProjectSlug,
-    issueId: resolvedIssueId,
-    messageThreadId: resolvedMessageThreadId,
-    projectChannelId: resolvedProjectChannelId,
-    language: input.language ?? existing?.language,
-    status: input.status,
-    attemptId: resolvedAttemptId,
-    attemptSeq: resolvedAttemptSeq,
-    classifySessionKey: resolvedClassifySessionKey,
-    classifyRunId: resolvedClassifyRunId,
-    classifyStartedAt: resolvedClassifyStartedAt,
-    bootstrapStep: resolvedBootstrapStep,
-    attemptCount: resolvedAttemptCount,
-    lastError: resolvedError,
-    nextRetryAt: resolvedNextRetryAt,
-    ackSentAt: resolvedAckSentAt,
-    projectRegisteredAt: resolvedProjectRegisteredAt,
-    topicKickoffSentAt: resolvedTopicKickoffSentAt,
-    projectTickedAt: resolvedProjectTickedAt,
-    completionAckSentAt: resolvedCompletionAckSentAt,
-    pendingClarification: input.pendingClarification !== void 0 ? input.pendingClarification : existing?.pendingClarification ?? null,
-    orphanedArtifacts: input.orphanedArtifacts !== void 0 ? input.orphanedArtifacts : existing?.orphanedArtifacts ?? null,
-    createdAt: existing?.createdAt ?? now2,
-    updatedAt: now2,
-    suppressUntil: nextSuppressUntil(input.status),
-    error: resolvedError
-  };
-  const writeDecision = shouldPersistBootstrapCheckpoint(existing, session);
-  if (!writeDecision.ok && existing) {
-    return existing;
-  }
-  await writeTelegramBootstrapSession(workspaceDir, session);
-  return session;
-}
-function shouldSuppressTelegramBootstrapReply(session, request) {
-  if (!session) return false;
-  if (isTelegramBootstrapSessionExpired(session)) return false;
-  if (session.status === "completed" || session.status === "failed") {
-    if (session.status === "failed" && isReleasedClassifyFailure(session.error)) return false;
-    if (!request) return false;
-    return buildBootstrapRequestFingerprint(request) === session.requestHash;
-  }
-  if (!request) return true;
-  return buildBootstrapRequestFingerprint(request) === session.requestHash;
-}
-function isTelegramBootstrapSessionExpired(session, now2 = Date.now()) {
-  if (!session) return false;
-  const suppressUntil = Date.parse(session.suppressUntil);
-  return !Number.isNaN(suppressUntil) && suppressUntil < now2;
-}
-function isRecoverableTelegramBootstrapSession(session) {
-  return session?.status === "bootstrapping" || session?.status === "dispatching";
-}
-function isClaimableTelegramBootstrapSession(session, now2 = Date.now()) {
-  if (!isRecoverableTelegramBootstrapSession(session)) return false;
-  if (!session.nextRetryAt) return true;
-  const retryAt = Date.parse(session.nextRetryAt);
-  return Number.isNaN(retryAt) || retryAt <= now2;
-}
-function isSupersededTelegramBootstrapAttempt(current, candidate) {
-  if (!current || !candidate) return false;
-  if (current.conversationId !== candidate.conversationId) return true;
-  const currentHasAttempt = current.attemptId != null && current.attemptSeq != null;
-  const candidateHasAttempt = candidate.attemptId != null && candidate.attemptSeq != null;
-  if (currentHasAttempt || candidateHasAttempt) {
-    return current.attemptId !== candidate.attemptId || current.attemptSeq !== candidate.attemptSeq;
-  }
-  return current.requestHash !== candidate.requestHash || current.status !== candidate.status || current.updatedAt !== candidate.updatedAt;
-}
-
-// lib/dispatch/telegram-bootstrap-hook.ts
 init_constants();
 var BOOTSTRAP_RETRY_DELAY_MS = 15e3;
 var LAYER3_CONFIDENCE_THRESHOLD = 0.6;
@@ -141332,26 +142254,7 @@ I'll continue the flow at ${link}`
   }
 };
 function detectScopeAmbiguity(rawIdea, stackHint) {
-  const text = rawIdea.toLowerCase();
-  if (/\b(livre|free.?choice|your.?call|pode.?escolher|voc[eê].?decide|qualquer)\b/i.test(text)) {
-    return false;
-  }
-  const subsystems = [
-    /\b(worker|background.?job|queue|task.?runner|celery|bull)\b/i,
-    /\b(websocket|sse|real.?time|realtime|push.?notif)\b/i,
-    /\b(auth|oauth|jwt|login|register|signup|autenticac)\b/i,
-    /\b(notif|alert|assinatura|subscription|subscribe|email|sms)\b/i,
-    /\b(banco|database|db|postgres|mysql|mongodb|redis|sqlite)\b/i,
-    /\b(api\s+rest|rest\s+api|endpoint|graphql|grpc)\b/i,
-    /\b(dashboard|frontend|interface|ui|tela)\b/i
-  ];
-  const matchedSubsystems = subsystems.filter((r2) => r2.test(text)).length;
-  if (matchedSubsystems < 3) return false;
-  const hasExplicitDB = /\b(postgres(ql)?|mysql|mongodb|mongo|redis|sqlite|supabase|dynamodb|cockroach)\b/i.test(text);
-  const hasExplicitAuth = /\b(jwt|oauth2?|basic.?auth|api.?key|session.?based|cookie.?auth)\b/i.test(text);
-  const hasExplicitStack = !!stackHint && !["api", "rest-api", "backend"].includes(stackHint);
-  const unspecifiedDimensions = [!hasExplicitDB, !hasExplicitAuth, !hasExplicitStack].filter(Boolean).length;
-  return unspecifiedDimensions >= 2;
+  return detectScopeClarificationNeed(rawIdea, stackHint).ask;
 }
 function inferProjectSlug(text) {
   let cleaned = text.replace(/^(create|build|crie|cria|criar|fazer?|quero|i need|i want)\s+(uma|um|me\s+a?|an|a)?\s*/i, "").replace(/\s+(that|which|que|para|for|pra)\s+.*/i, "").trim();
@@ -141360,11 +142263,11 @@ function inferProjectSlug(text) {
   return slug || void 0;
 }
 function normalizeProjectNameCandidate(value) {
-  const normalized = normalizeText3(value);
+  const normalized = normalizeText4(value);
   if (!normalized) return void 0;
   return inferProjectSlug(normalized) ?? void 0;
 }
-function normalizeText3(value) {
+function normalizeText4(value) {
   const trimmed = value?.trim();
   return trimmed ? trimmed : void 0;
 }
@@ -141389,15 +142292,19 @@ function parseField(text, labels) {
   for (const label of labels) {
     const regex = new RegExp(`(?:^|[\\n.,;!?]\\s*)${label}\\s*:\\s*(.+)$`, "im");
     const match = text.match(regex);
-    if (match?.[1]) return normalizeText3(match[1]);
+    if (match?.[1]) return normalizeText4(match[1]);
   }
   return void 0;
 }
 function parseIdeaBlock(text) {
   const match = text.match(/^\s*(idea|ideia|objetivo)\s*:\s*([\s\S]+)$/im);
-  return normalizeText3(match?.[2]);
+  return normalizeText4(match?.[2]);
 }
 function parseExplicitProjectName(text) {
+  const naturalLanguageMatch = text.match(/\b(?:please\s+)?(?:use|set|keep)\s+(?:the\s+)?(?:project name|repo name|repository name|nome do projeto)\s+(?:as\s+)?[`"'“”‘’]?([a-z0-9][a-z0-9-]{1,63})[`"'“”‘’]?(?=$|[\s.,!?;:])/i);
+  if (naturalLanguageMatch?.[1]) {
+    return normalizeProjectNameCandidate(naturalLanguageMatch[1].toLowerCase());
+  }
   const match = text.match(/\b(?:called|named|chamado)\s+[`"'“”‘’]?([a-z0-9][a-z0-9-]{1,63})[`"'“”‘’]?(?=$|[\s.,!?;:])/i);
   return normalizeProjectNameCandidate(match?.[1]?.toLowerCase());
 }
@@ -141635,6 +142542,9 @@ function buildClarificationMessage(parsed, pendingClarification, language = "pt"
   if (pendingClarification === "name") {
     return BOOTSTRAP_MESSAGES.clarifyName[language];
   }
+  if (pendingClarification === "scope") {
+    return BOOTSTRAP_MESSAGES.clarifyScope[language](parsed.rawIdea);
+  }
   if (pendingClarification === "stack_and_name" || !parsed.stackHint && !parsed.projectName) {
     return BOOTSTRAP_MESSAGES.clarifyBoth[language];
   }
@@ -141835,12 +142745,12 @@ async function handleTelegramBootstrapDmMessage(ctx, rawConversationId, content)
         conversationId,
         rawIdea: content,
         stackHint: parsed.stackHint ?? void 0,
-        projectName: parsed.projectName ?? parsed.projectSlug ?? void 0,
+        projectName: parsed.projectName ?? inferProjectSlug(parsed.rawIdea) ?? void 0,
         status: "clarifying",
         pendingClarification: "scope",
         language
       });
-      const clarifyMsg = BOOTSTRAP_MESSAGES.clarifyScope[language](content);
+      const clarifyMsg = buildClarificationMessage(parsed, "scope", language);
       await sendTelegramText(ctx, rawConversationId, clarifyMsg);
       return;
     }
@@ -142026,6 +142936,9 @@ async function persistOwnedBootstrapCheckpoint(workspaceDir, owner, input) {
     bootstrapStep: input.bootstrapStep,
     projectSlug: input.projectSlug ?? void 0,
     issueId: input.issueId,
+    issueUrl: input.issueUrl,
+    triageReadyForDispatch: input.triageReadyForDispatch,
+    triageErrors: input.triageErrors,
     messageThreadId: input.messageThreadId,
     projectChannelId: input.projectChannelId,
     language: input.language,
@@ -142491,7 +143404,7 @@ async function recoverDueTelegramBootstrapSessions(ctx, workspaceDir) {
   const sessionsDir2 = path37.join(workspaceDir, DATA_DIR, "bootstrap-sessions");
   let files;
   try {
-    files = await fs36.readdir(sessionsDir2);
+    files = await fs37.readdir(sessionsDir2);
   } catch {
     return 0;
   }
@@ -142877,20 +143790,25 @@ async function continueBootstrap(ctx, conversationId, workspaceDir, request, sou
     return;
   }
   const telegramConfig = readFabricaTelegramConfig(ctx.pluginConfig);
-  const stackHint = request.stackHint;
-  if (!stackHint) {
-    const existingSession = await readTelegramBootstrapSession(workspaceDir, conversationId);
-    const lang = existingSession?.language ?? "pt";
+  const existingSession = await readTelegramBootstrapSession(workspaceDir, conversationId);
+  const lang = existingSession?.language ?? "pt";
+  const inferredProjectName = request.projectName ?? inferProjectSlug(request.rawIdea) ?? null;
+  const clarificationDecision = decideBootstrapClarification({
+    projectName: inferredProjectName,
+    stackHint: request.stackHint
+  });
+  if (clarificationDecision.ask && (clarificationDecision.kind === "stack" || clarificationDecision.kind === "stack_and_name")) {
+    const clarificationKind = clarificationDecision.kind;
     const owner = buildBootstrapAttemptOwner(existingSession);
     if (owner) {
       await persistOwnedBootstrapCheckpoint(workspaceDir, owner, {
         rawIdea: request.rawIdea,
-        projectName: request.projectName ?? void 0,
+        projectName: inferredProjectName ?? void 0,
         stackHint: request.stackHint ?? void 0,
         sourceRoute,
         status: "clarifying",
         bootstrapStep: existingSession?.bootstrapStep ?? "awaiting_pipeline",
-        pendingClarification: "stack",
+        pendingClarification: clarificationKind,
         language: lang,
         ackSentAt: existingSession?.ackSentAt ?? null,
         lastError: null,
@@ -142900,64 +143818,63 @@ async function continueBootstrap(ctx, conversationId, workspaceDir, request, sou
       await upsertTelegramBootstrapSession(workspaceDir, {
         conversationId,
         rawIdea: request.rawIdea,
-        projectName: request.projectName ?? void 0,
+        projectName: inferredProjectName ?? void 0,
         status: "clarifying",
-        pendingClarification: "stack",
+        pendingClarification: clarificationKind,
         language: lang
       });
     }
     await sendTelegramText(ctx, conversationId, buildClarificationMessage(
-      { rawIdea: request.rawIdea, projectName: request.projectName ?? void 0, stackHint: request.stackHint ?? void 0 },
-      "stack",
+      { rawIdea: request.rawIdea, projectName: inferredProjectName ?? void 0, stackHint: request.stackHint ?? void 0 },
+      clarificationKind,
       lang
     ));
     return;
   }
-  if (!request.projectName) {
+  if (inferredProjectName && !request.projectName) {
+    request.projectName = inferredProjectName;
+  }
+  if (clarificationDecision.ask && clarificationDecision.kind === "name") {
     const inferredSlug = inferProjectSlug(request.rawIdea);
     if (inferredSlug) {
       request.projectName = inferredSlug;
+    } else if (existingSession?.pendingClarification === "name") {
+      request.projectName = `project-${Date.now()}`;
     } else {
-      const existingSession = await readTelegramBootstrapSession(workspaceDir, conversationId);
-      if (existingSession?.pendingClarification === "name") {
-        request.projectName = `project-${Date.now()}`;
+      const owner = existingSession ? buildBootstrapAttemptOwner(existingSession) : null;
+      if (existingSession && owner) {
+        await persistOwnedBootstrapCheckpoint(workspaceDir, owner, {
+          rawIdea: request.rawIdea,
+          stackHint: request.stackHint ?? void 0,
+          sourceRoute,
+          status: "clarifying",
+          bootstrapStep: existingSession.bootstrapStep ?? "awaiting_pipeline",
+          pendingClarification: "name",
+          language: lang,
+          ackSentAt: existingSession.ackSentAt ?? null,
+          lastError: null,
+          nextRetryAt: null
+        });
       } else {
-        const lang = existingSession?.language ?? "pt";
-        const owner = existingSession ? buildBootstrapAttemptOwner(existingSession) : null;
-        if (existingSession && owner) {
-          await persistOwnedBootstrapCheckpoint(workspaceDir, owner, {
-            rawIdea: request.rawIdea,
-            stackHint: request.stackHint ?? void 0,
-            sourceRoute,
-            status: "clarifying",
-            bootstrapStep: existingSession.bootstrapStep ?? "awaiting_pipeline",
-            pendingClarification: "name",
-            language: lang,
-            ackSentAt: existingSession.ackSentAt ?? null,
-            lastError: null,
-            nextRetryAt: null
-          });
-        } else {
-          await upsertTelegramBootstrapSession(workspaceDir, {
-            conversationId,
-            rawIdea: request.rawIdea,
-            stackHint: request.stackHint ?? void 0,
-            status: "clarifying",
-            pendingClarification: "name",
-            language: lang
-          });
-        }
-        await sendTelegramText(
-          ctx,
+        await upsertTelegramBootstrapSession(workspaceDir, {
           conversationId,
-          buildClarificationMessage(
-            { rawIdea: request.rawIdea, projectName: void 0, stackHint: request.stackHint ?? void 0 },
-            "name",
-            lang
-          )
-        );
-        return;
+          rawIdea: request.rawIdea,
+          stackHint: request.stackHint ?? void 0,
+          status: "clarifying",
+          pendingClarification: "name",
+          language: lang
+        });
       }
+      await sendTelegramText(
+        ctx,
+        conversationId,
+        buildClarificationMessage(
+          { rawIdea: request.rawIdea, projectName: void 0, stackHint: request.stackHint ?? void 0 },
+          "name",
+          lang
+        )
+      );
+      return;
     }
   }
   const stepCtx = {
@@ -142988,10 +143905,11 @@ async function continueBootstrap(ctx, conversationId, workspaceDir, request, sou
     config: ctx.config,
     pluginConfig: ctx.pluginConfig
   };
+  const stackHint = request.stackHint ?? null;
   const payload = {
-    session_id: `telegram-bootstrap-${Date.now()}`,
+    session_id: randomUUID5(),
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    step: "init",
+    step: "telegram-bootstrap",
     raw_idea: request.rawIdea,
     answers: {},
     metadata: {
@@ -143089,6 +144007,8 @@ Erro: ${result.error ?? "erro desconhecido"}`
   const projectChannelId = result.payload.metadata.channel_id ?? telegramConfig.projectsForumChatId;
   const messageThreadId = result.payload.metadata.message_thread_id;
   const projectSlug = result.payload.metadata.project_slug ?? result.payload.scaffold?.project_slug ?? null;
+  const createdIssue = result.payload.issues?.[0] ?? null;
+  const triage = result.payload.triage ?? null;
   if (projectChannelId && messageThreadId) {
     const projectRoute = {
       channel: "telegram",
@@ -143103,6 +144023,10 @@ Erro: ${result.error ?? "erro desconhecido"}`
       bootstrapStep: "project_registered",
       projectName: resolvedProjectName,
       projectSlug: projectSlug ?? void 0,
+      issueId: createdIssue?.number ?? null,
+      issueUrl: createdIssue?.url ?? null,
+      triageReadyForDispatch: triage?.ready_for_dispatch ?? null,
+      triageErrors: triage?.errors ?? null,
       projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString(),
       projectChannelId: String(projectChannelId),
       messageThreadId,
@@ -143118,6 +144042,10 @@ Erro: ${result.error ?? "erro desconhecido"}`
       status: "dispatching",
       projectName: resolvedProjectName,
       projectSlug: projectSlug ?? void 0,
+      issueId: createdIssue?.number ?? null,
+      issueUrl: createdIssue?.url ?? null,
+      triageReadyForDispatch: triage?.ready_for_dispatch ?? null,
+      triageErrors: triage?.errors ?? null,
       projectRegisteredAt: (/* @__PURE__ */ new Date()).toISOString(),
       projectChannelId: String(projectChannelId),
       messageThreadId,
@@ -143133,6 +144061,10 @@ Erro: ${result.error ?? "erro desconhecido"}`
       ...registeredSession,
       projectName: resolvedProjectName,
       projectSlug: projectSlug ?? registeredSession.projectSlug ?? void 0,
+      issueId: createdIssue?.number ?? registeredSession.issueId ?? null,
+      issueUrl: createdIssue?.url ?? registeredSession.issueUrl ?? null,
+      triageReadyForDispatch: triage?.ready_for_dispatch ?? registeredSession.triageReadyForDispatch ?? null,
+      triageErrors: triage?.errors ?? registeredSession.triageErrors ?? null,
       projectRegisteredAt: registeredSession.projectRegisteredAt ?? (/* @__PURE__ */ new Date()).toISOString(),
       language: currentSession?.language ?? "pt"
     });
@@ -144727,7 +145659,7 @@ async function runPrDiscoveryPass(params) {
 // lib/services/heartbeat/genesis-health.ts
 init_logger();
 init_constants();
-import fs37 from "node:fs/promises";
+import fs38 from "node:fs/promises";
 import path38 from "node:path";
 var STALE_THRESHOLD_MS = 5 * 6e4;
 var STALE_STATUSES = /* @__PURE__ */ new Set(["pending_classify", "classifying"]);
@@ -144742,7 +145674,7 @@ async function checkGenesisHealth(workspaceDir) {
   const sessionsDir2 = path38.join(workspaceDir, DATA_DIR, "bootstrap-sessions");
   let files;
   try {
-    files = await fs37.readdir(sessionsDir2);
+    files = await fs38.readdir(sessionsDir2);
   } catch {
     return;
   }
@@ -144750,7 +145682,7 @@ async function checkGenesisHealth(workspaceDir) {
   for (const file2 of files) {
     if (!file2.endsWith(".json")) continue;
     try {
-      const raw = await fs37.readFile(path38.join(sessionsDir2, file2), "utf-8");
+      const raw = await fs38.readFile(path38.join(sessionsDir2, file2), "utf-8");
       const data = JSON.parse(raw);
       const id = data.conversationId ?? file2.replace(/\.json$/, "");
       const updatedAt = typeof data.updatedAt === "string" ? new Date(data.updatedAt).getTime() : Number(data.updatedAt ?? 0);
@@ -145374,7 +146306,7 @@ async function writeModelsToWorkflow(workspacePath, models) {
   const workflowPath = path39.join(workspacePath, DATA_DIR, "workflow.yaml");
   let content = "";
   try {
-    content = await fs38.readFile(workflowPath, "utf-8");
+    content = await fs39.readFile(workflowPath, "utf-8");
   } catch {
   }
   const doc = content ? import_yaml3.default.parseDocument(content) : new import_yaml3.default.Document({});
@@ -145390,7 +146322,7 @@ async function writeModelsToWorkflow(workspacePath, models) {
       roleNode.set("models", doc.createNode(levels));
     }
   }
-  await fs38.writeFile(workflowPath, doc.toString({ lineWidth: 120 }), "utf-8");
+  await fs39.writeFile(workflowPath, doc.toString({ lineWidth: 120 }), "utf-8");
 }
 
 // lib/tools/admin/setup.ts
@@ -145514,7 +146446,7 @@ ${written.map((f3) => `  ${f3}`).join("\n")}` : "All files already exist \u2014
 
 // lib/setup/onboarding.ts
 init_roles();
-import fs39 from "node:fs/promises";
+import fs40 from "node:fs/promises";
 import path40 from "node:path";
 function isPluginConfigured(pluginConfig) {
   return !!pluginConfig && Object.keys(pluginConfig).length > 0;
@@ -145522,7 +146454,7 @@ function isPluginConfigured(pluginConfig) {
 async function hasWorkspaceFiles(workspaceDir) {
   if (!workspaceDir) return false;
   try {
-    const content = await fs39.readFile(
+    const content = await fs40.readFile(
       path40.join(workspaceDir, "AGENTS.md"),
       "utf-8"
     );
@@ -146338,7 +147270,7 @@ These completely replace (not merge with) the workspace-level prompts for that r
 }
 
 // lib/tools/admin/config.ts
-import fs40 from "node:fs/promises";
+import fs41 from "node:fs/promises";
 import path41 from "node:path";
 init_workspace();
 init_templates();
@@ -146443,7 +147375,7 @@ async function handleDiff(workspacePath) {
       summary: "No workflow.yaml found in workspace \u2014 using package defaults."
     });
   }
-  const current = await fs40.readFile(workflowPath, "utf-8");
+  const current = await fs41.readFile(workflowPath, "utf-8");
   const template = WORKFLOW_YAML_TEMPLATE;
   if (current.trim() === template.trim()) {
     return jsonResult({
@@ -146603,6 +147535,8 @@ function extractExplicitProjectName(text) {
   if (!text) return null;
   const fieldMatch = text.match(/(?:^|[\n.,;!?]\s*)(?:project name|repo name|repository name|nome do projeto)\s*:\s*([a-z0-9][a-z0-9-]{1,63})\b/i);
   if (fieldMatch?.[1]) return fieldMatch[1].trim().toLowerCase();
+  const naturalLanguageMatch = text.match(/\b(?:please\s+)?(?:use|set|keep)\s+(?:the\s+)?(?:project name|repo name|repository name|nome do projeto)\s+(?:as\s+)?[`"'“”‘’]?([a-z0-9][a-z0-9-]{1,63})[`"'“”‘’]?(?=$|[\s.,!?;:])/i);
+  if (naturalLanguageMatch?.[1]) return naturalLanguageMatch[1].trim().toLowerCase();
   const inlineMatch = text.match(/\b(?:called|named|chamado)\s+[`"'“”‘’]?([a-z0-9][a-z0-9-]{1,63})[`"'“”‘’]?(?=$|[\s.,!?;:])/i);
   if (inlineMatch?.[1]) return inlineMatch[1].trim().toLowerCase();
   return null;
@@ -147117,7 +148051,7 @@ function getPendingQuestions(payload, answers = payload.answers ?? {}) {
 var import_yaml4 = __toESM(require_dist(), 1);
 init_constants();
 init_migrate_layout();
-import fs41 from "node:fs/promises";
+import fs42 from "node:fs/promises";
 import path42 from "node:path";
 init_roles();
 async function runDoctor(opts) {
@@ -147162,14 +148096,14 @@ async function runDoctor(opts) {
           if (check2.name.startsWith("file:")) {
             const recheckPath = check2.name.replace("file:", "");
             try {
-              await fs41.access(recheckPath);
+              await fs42.access(recheckPath);
               recheckOk = true;
             } catch {
             }
           } else if (check2.name.startsWith("dir:")) {
             const recheckPath = check2.name.replace("dir:", "");
             try {
-              const stat2 = await fs41.stat(recheckPath);
+              const stat2 = await fs42.stat(recheckPath);
               recheckOk = stat2.isDirectory();
             } catch {
             }
@@ -147198,7 +148132,7 @@ async function runDoctor(opts) {
 }
 async function checkDirExists(dirPath, label) {
   try {
-    const stat2 = await fs41.stat(dirPath);
+    const stat2 = await fs42.stat(dirPath);
     if (stat2.isDirectory()) {
       return { name: `dir:${dirPath}`, severity: "ok", message: `${label} exists` };
     }
@@ -147209,7 +148143,7 @@ async function checkDirExists(dirPath, label) {
 }
 async function checkFileExists(filePath, label) {
   try {
-    await fs41.access(filePath);
+    await fs42.access(filePath);
     return { name: `file:${filePath}`, severity: "ok", message: `${label} exists` };
   } catch {
     return { name: `file:${filePath}`, severity: "error", message: `${label} missing` };
@@ -147218,7 +148152,7 @@ async function checkFileExists(filePath, label) {
 async function checkWorkflowYaml(dataDir) {
   const filePath = path42.join(dataDir, "workflow.yaml");
   try {
-    const content = await fs41.readFile(filePath, "utf-8");
+    const content = await fs42.readFile(filePath, "utf-8");
     const parsed = import_yaml4.default.parse(content);
     if (!parsed || typeof parsed !== "object") {
       return { name: "yaml:workflow", severity: "error", message: "workflow.yaml is empty or not an object" };
@@ -147237,7 +148171,7 @@ async function checkWorkflowYaml(dataDir) {
 async function checkProjectsJson(dataDir) {
   const filePath = path42.join(dataDir, "projects.json");
   try {
-    const content = await fs41.readFile(filePath, "utf-8");
+    const content = await fs42.readFile(filePath, "utf-8");
     const parsed = JSON.parse(content);
     if (!parsed || typeof parsed !== "object") {
       return { name: "json:projects", severity: "error", message: "projects.json is not an object" };
@@ -147314,7 +148248,7 @@ async function checkProjects(dataDir) {
   const filePath = path42.join(dataDir, "projects.json");
   let data;
   try {
-    const content = await fs41.readFile(filePath, "utf-8");
+    const content = await fs42.readFile(filePath, "utf-8");
     data = JSON.parse(content);
   } catch {
     return results;
@@ -147354,7 +148288,7 @@ async function checkProjects(dataDir) {
     if (project.repo && path42.isAbsolute(project.repo)) {
       const qaPath = path42.join(project.repo, "scripts", "qa.sh");
       try {
-        await fs41.access(qaPath);
+        await fs42.access(qaPath);
       } catch {
         results.push({
           name: `project:${slug}:qa`,
@@ -147478,7 +148412,7 @@ function formatMetrics(metrics2) {
 
 // lib/setup/security-doctor.ts
 init_constants();
-import fs42 from "node:fs/promises";
+import fs43 from "node:fs/promises";
 import path43 from "node:path";
 var LEGACY_EXTENSION_PATH_PATTERNS = [
   "/extensions/secureclaw/",
@@ -147503,7 +148437,7 @@ async function runSecurityDoctor(openclawHome) {
   const checklistPath = path43.join(workspacePath, DATA_DIR, "prompts", "security-checklist.md");
   let config2 = null;
   try {
-    config2 = JSON.parse(await fs42.readFile(configPath, "utf-8"));
+    config2 = JSON.parse(await fs43.readFile(configPath, "utf-8"));
     checks.push({
       name: "config:openclaw-json",
       severity: "ok",
@@ -147570,7 +148504,7 @@ async function runSecurityDoctor(openclawHome) {
     message: genesisBinding ? "Genesis agent owns the channel-wide Telegram DM binding" : "Genesis agent does not own a channel-wide Telegram binding"
   });
   try {
-    await fs42.access(checklistPath);
+    await fs43.access(checklistPath);
     checks.push({
       name: "workspace:security-checklist",
       severity: "ok",
@@ -147584,7 +148518,7 @@ async function runSecurityDoctor(openclawHome) {
     });
   }
   try {
-    const jobsJson = JSON.parse(await fs42.readFile(jobsPath, "utf-8"));
+    const jobsJson = JSON.parse(await fs43.readFile(jobsPath, "utf-8"));
     const jobs = jobsJson.jobs ?? [];
     const legacyJobFindings = jobs.filter((job) => job.enabled !== false).flatMap((job) => {
       const text = `${job.payload?.text ?? ""} ${job.payload?.message ?? ""}`;
@@ -148724,7 +149658,7 @@ function registerGitHubWebhookRoute(api, ctx) {
 // lib/setup/gateway-lifecycle-hook.ts
 init_constants();
 init_audit();
-import * as fs43 from "node:fs/promises";
+import * as fs44 from "node:fs/promises";
 import * as path45 from "node:path";
 function registerGatewayLifecycleHook(api, ctx) {
   const workspaceDir = resolveWorkspaceDir(ctx.config);
@@ -148733,7 +149667,7 @@ function registerGatewayLifecycleHook(api, ctx) {
     const bootTime = Date.now();
     const dataPath = path45.join(workspaceDir, DATA_DIR);
     try {
-      await fs43.access(dataPath);
+      await fs44.access(dataPath);
     } catch {
       await log(workspaceDir, "gateway_start_warning", {
         message: `Workspace data directory missing: ${dataPath}`
@@ -148743,7 +149677,7 @@ function registerGatewayLifecycleHook(api, ctx) {
     }
     const projectsPath2 = path45.join(dataPath, "projects.json");
     try {
-      const raw = await fs43.readFile(projectsPath2, "utf-8");
+      const raw = await fs44.readFile(projectsPath2, "utf-8");
       JSON.parse(raw);
     } catch (err) {
       await log(workspaceDir, "gateway_start_warning", {
@@ -149025,7 +149959,7 @@ function registerSubagentLifecycleHook(api, ctx) {
 init_constants();
 init_registry();
 init_roles();
-import * as fs44 from "node:fs";
+import * as fs45 from "node:fs";
 import * as path46 from "node:path";
 var ESCALATION_MAP = {
   junior: "medior",
@@ -149052,7 +149986,7 @@ function registerModelResolveHook(api, ctx) {
     if (!level) return;
     try {
       const projectsPath2 = path46.join(workspaceDir, DATA_DIR, "projects.json");
-      const raw = await fs44.promises.readFile(projectsPath2, "utf-8");
+      const raw = await fs45.promises.readFile(projectsPath2, "utf-8");
       const projects = JSON.parse(raw);
       const project = Object.values(projects).find((p) => p.slug === projectName);
       if (!project?.workers?.[role]?.levels?.[level]) return;
@@ -149121,6 +150055,9 @@ Do not delegate implementation, testing, review, or planning to another coding a
 Do not use nested coding agents.
 Do not use planning or meta-skills such as brainstorming, writing-plans, or coding-agent.
 Do not spawn, supervise, or instruct another agent to do the work for you.
+Do not weaken, replace, or bypass the canonical scripts/qa.sh contract just to make the task pass.
+Preserve the canonical QA gates: lint, types, security, tests, and coverage.
+If QA fails, fix the product code or project setup instead of rewriting the QA contract into ad-hoc scenario checks.
 If you cannot proceed directly in the assigned worktree, end with your role's canonical blocked result line.
 `;
 var REVIEWER_EXECUTION_CONTRACT_CONTEXT = `## Execution Contract