@nuucognition/flint-cli 0.6.0-dev.12 → 0.6.0-dev.13

package/dist/index.js

@@ -457,7 +457,7 @@ async function startLoginFlow(config) {
   const codeChallenge = createHash("sha256").update(codeVerifier).digest("base64url");
   const cliLabel = config.cliname ?? "nuu";
   step(`Logging in to ${import_picocolors.default.bold(config.accountUrl)}`);
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     let settled = false;
     const finish = (fn) => {
       if (settled) return;
@@ -504,7 +504,7 @@ async function startLoginFlow(config) {
         };
         res.writeHead(200, { "Content-Type": "text/html" });
         res.end(resultHtml(true, "Login successful", "You can close this tab and return to the terminal."));
-        void saveAuth(credentials, authEnv).then(() => finish(() => resolve23(credentials))).catch((cause) => {
+        void saveAuth(credentials, authEnv).then(() => finish(() => resolve24(credentials))).catch((cause) => {
           const message = cause instanceof Error ? cause.message : String(cause);
           finish(() => {
             stepFail(`Failed to save credentials: ${message}`);
@@ -542,7 +542,7 @@ async function startLoginFlow(config) {
       step("Exchanging authorization code for session token...");
       void exchangeCode(config.accountUrl, code, codeVerifier).then(async (credentials) => {
         await saveAuth(credentials, authEnv);
-        finish(() => resolve23(credentials));
+        finish(() => resolve24(credentials));
       }).catch((cause) => {
         const message = cause instanceof Error ? cause.message : String(cause);
         finish(() => {
@@ -67412,14 +67412,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
           };
         }
         function readAndResolve(iter) {
-          var resolve23 = iter[kLastResolve];
-          if (resolve23 !== null) {
+          var resolve24 = iter[kLastResolve];
+          if (resolve24 !== null) {
             var data = iter[kStream].read();
             if (data !== null) {
               iter[kLastPromise] = null;
               iter[kLastResolve] = null;
               iter[kLastReject] = null;
-              resolve23(createIterResult(data, false));
+              resolve24(createIterResult(data, false));
             }
           }
         }
@@ -67427,13 +67427,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
           process.nextTick(readAndResolve, iter);
         }
         function wrapForNext(lastPromise, iter) {
-          return function(resolve23, reject) {
+          return function(resolve24, reject) {
             lastPromise.then(function() {
               if (iter[kEnded]) {
-                resolve23(createIterResult(void 0, true));
+                resolve24(createIterResult(void 0, true));
                 return;
               }
-              iter[kHandlePromise](resolve23, reject);
+              iter[kHandlePromise](resolve24, reject);
             }, reject);
           };
         }
@@ -67453,12 +67453,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
               return Promise.resolve(createIterResult(void 0, true));
             }
             if (this[kStream].destroyed) {
-              return new Promise(function(resolve23, reject) {
+              return new Promise(function(resolve24, reject) {
                 process.nextTick(function() {
                   if (_this[kError]) {
                     reject(_this[kError]);
                   } else {
-                    resolve23(createIterResult(void 0, true));
+                    resolve24(createIterResult(void 0, true));
                   }
                 });
               });
@@ -67481,13 +67481,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
           return this;
         }), _defineProperty(_Object$setPrototypeO, "return", function _return() {
           var _this2 = this;
-          return new Promise(function(resolve23, reject) {
+          return new Promise(function(resolve24, reject) {
             _this2[kStream].destroy(null, function(err) {
               if (err) {
                 reject(err);
                 return;
               }
-              resolve23(createIterResult(void 0, true));
+              resolve24(createIterResult(void 0, true));
             });
           });
         }), _Object$setPrototypeO), AsyncIteratorPrototype);
@@ -67509,15 +67509,15 @@ Expecting one of '${allowedValues.join("', '")}'`);
             value: stream._readableState.endEmitted,
             writable: true
           }), _defineProperty(_Object$create, kHandlePromise, {
-            value: function value(resolve23, reject) {
+            value: function value(resolve24, reject) {
               var data = iterator[kStream].read();
               if (data) {
                 iterator[kLastPromise] = null;
                 iterator[kLastResolve] = null;
                 iterator[kLastReject] = null;
-                resolve23(createIterResult(data, false));
+                resolve24(createIterResult(data, false));
               } else {
-                iterator[kLastResolve] = resolve23;
+                iterator[kLastResolve] = resolve24;
                 iterator[kLastReject] = reject;
               }
             },
@@ -67536,12 +67536,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
               iterator[kError] = err;
               return;
             }
-            var resolve23 = iterator[kLastResolve];
-            if (resolve23 !== null) {
+            var resolve24 = iterator[kLastResolve];
+            if (resolve24 !== null) {
               iterator[kLastPromise] = null;
               iterator[kLastResolve] = null;
               iterator[kLastReject] = null;
-              resolve23(createIterResult(void 0, true));
+              resolve24(createIterResult(void 0, true));
             }
             iterator[kEnded] = true;
           });
@@ -67554,7 +67554,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
     require_from = __commonJS2({
       "../../node_modules/.pnpm/readable-stream@3.6.2/node_modules/readable-stream/lib/internal/streams/from.js"(exports, module) {
         "use strict";
-        function asyncGeneratorStep(gen, resolve23, reject, _next, _throw, key, arg) {
+        function asyncGeneratorStep(gen, resolve24, reject, _next, _throw, key, arg) {
           try {
             var info2 = gen[key](arg);
             var value = info2.value;
@@ -67563,7 +67563,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
             return;
           }
           if (info2.done) {
-            resolve23(value);
+            resolve24(value);
           } else {
             Promise.resolve(value).then(_next, _throw);
           }
@@ -67571,13 +67571,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
         function _asyncToGenerator(fn) {
           return function() {
             var self2 = this, args = arguments;
-            return new Promise(function(resolve23, reject) {
+            return new Promise(function(resolve24, reject) {
               var gen = fn.apply(self2, args);
               function _next(value) {
-                asyncGeneratorStep(gen, resolve23, reject, _next, _throw, "next", value);
+                asyncGeneratorStep(gen, resolve24, reject, _next, _throw, "next", value);
               }
               function _throw(err) {
-                asyncGeneratorStep(gen, resolve23, reject, _next, _throw, "throw", err);
+                asyncGeneratorStep(gen, resolve24, reject, _next, _throw, "throw", err);
               }
               _next(void 0);
             });
@@ -69553,14 +69553,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
       }
       const subprocess = childProcess.spawn(command, cliArguments, childProcessOptions);
       if (options22.wait) {
-        return new Promise((resolve23, reject) => {
+        return new Promise((resolve24, reject) => {
           subprocess.once("error", reject);
           subprocess.once("close", (exitCode) => {
             if (!options22.allowNonzeroExitCode && exitCode > 0) {
               reject(new Error(`Exited with code ${exitCode}`));
               return;
             }
-            resolve23(subprocess);
+            resolve24(subprocess);
           });
         });
       }
@@ -79066,7 +79066,7 @@ function createMigrationContext(flintPath, options3 = {}) {
   });
   const error3 = options3.error || (() => {
   });
-  const resolve23 = (p) => join12(flintPath, p);
+  const resolve24 = (p) => join12(flintPath, p);
   return {
     flintPath,
     log,
@@ -79074,34 +79074,34 @@ function createMigrationContext(flintPath, options3 = {}) {
     error: error3,
     async exists(path31) {
       try {
-        await access2(resolve23(path31));
+        await access2(resolve24(path31));
         return true;
       } catch {
         return false;
       }
     },
     async read(path31) {
-      return readFile6(resolve23(path31), "utf-8");
+      return readFile6(resolve24(path31), "utf-8");
     },
     async write(path31, content) {
-      const fullPath = resolve23(path31);
+      const fullPath = resolve24(path31);
       await mkdir6(dirname22(fullPath), { recursive: true });
       await writeFile5(fullPath, content, "utf-8");
     },
     async delete(path31) {
-      await unlink2(resolve23(path31));
+      await unlink2(resolve24(path31));
     },
     // ── Intent (flint.toml) ──────────────────────────────────────────────
     async readIntentText() {
       try {
-        return await readFile6(resolve23("flint.toml"), "utf-8");
+        return await readFile6(resolve24("flint.toml"), "utf-8");
       } catch (err) {
         if (err.code === "ENOENT") return null;
         throw err;
       }
     },
     async writeIntentText(text) {
-      await writeFile5(resolve23("flint.toml"), text, "utf-8");
+      await writeFile5(resolve24("flint.toml"), text, "utf-8");
     },
     async readIntent() {
       const text = await this.readIntentText();
@@ -79110,7 +79110,7 @@ function createMigrationContext(flintPath, options3 = {}) {
     // ── Lockfile (flint.json) ────────────────────────────────────────────
     async readLockfile() {
       try {
-        const text = await readFile6(resolve23("flint.json"), "utf-8");
+        const text = await readFile6(resolve24("flint.json"), "utf-8");
         return JSON.parse(text);
       } catch (err) {
         if (err.code === "ENOENT") return null;
@@ -79118,23 +79118,23 @@ function createMigrationContext(flintPath, options3 = {}) {
       }
     },
     async writeLockfile(next) {
-      await writeFile5(resolve23("flint.json"), JSON.stringify(next, null, 2) + "\n", "utf-8");
+      await writeFile5(resolve24("flint.json"), JSON.stringify(next, null, 2) + "\n", "utf-8");
     },
     // ── Filesystem ───────────────────────────────────────────────────────
     fs: {
       async mv(from, to) {
-        const dest = resolve23(to);
+        const dest = resolve24(to);
         await mkdir6(dirname22(dest), { recursive: true });
-        await rename6(resolve23(from), dest);
+        await rename6(resolve24(from), dest);
       },
       async rm(path31, options22) {
-        await fsRm(resolve23(path31), { recursive: options22?.recursive ?? false, force: true });
+        await fsRm(resolve24(path31), { recursive: options22?.recursive ?? false, force: true });
       },
       async mkdir(path31, options22) {
-        await mkdir6(resolve23(path31), { recursive: options22?.recursive ?? true });
+        await mkdir6(resolve24(path31), { recursive: options22?.recursive ?? true });
       },
       async readDir(path31) {
-        return readdir9(resolve23(path31));
+        return readdir9(resolve24(path31));
       }
     }
   };
@@ -86839,6 +86839,7 @@ import { existsSync as existsSync22 } from "fs";
 import { join as join142, resolve as resolve6 } from "path";
 import { homedir as homedir4 } from "os";
 import { request } from "http";
+import { existsSync as existsSync32 } from "fs";
 import { readdir as readdir82, readFile as readFile92, mkdir as mkdir12 } from "fs/promises";
 import { join as join152, dirname as dirname52, resolve as resolve7, sep as sep22 } from "path";
 import { randomUUID as randomUUID22 } from "crypto";
@@ -90174,6 +90175,7 @@ async function healTinderbox(root) {
   const check2 = await checkTinderbox(root);
   const addedDeclarations = [];
   const renamedDeclarations = [];
+  const warnings = [];
   let configChanged = false;
   for (const renameEntry of check2.reconciliation.renamed) {
     const target = config.flints.required.find((flint) => flint.name === renameEntry.declaration.name);
@@ -90185,6 +90187,22 @@ async function healTinderbox(root) {
     });
     configChanged = true;
   }
+  for (const undeclared of check2.reconciliation.undeclared) {
+    if (config.flints.required.some((entry) => entry.name === undeclared.name)) {
+      continue;
+    }
+    const remote = await readGitRemoteUrl(undeclared.path);
+    if (!remote) {
+      warnings.push({
+        scope: `flint:${undeclared.name}`,
+        message: `Cannot declare "${undeclared.name}" \u2014 no git remote configured. Add one with \`git remote add origin <url>\` inside ${undeclared.folderName}/ and re-run \`flint tinderbox heal\`.`
+      });
+      continue;
+    }
+    config.flints.required.push({ name: undeclared.name, source: remote, mode: "own" });
+    addedDeclarations.push(undeclared.name);
+    configChanged = true;
+  }
   if (configChanged) {
     await writeTinderboxToml(root, config);
   }
@@ -90194,6 +90212,7 @@ async function healTinderbox(root) {
     root,
     addedDeclarations,
     renamedDeclarations,
+    warnings,
     sync,
     finalCheck
   };
@@ -91365,9 +91384,9 @@ async function validateHeadlessInitContent(shardPath, shorthand) {
   const interfaceSection = findSection(sections, /\borbh interface schema\b/i);
   if (!interfaceSection) {
     results.push(createContentWarning(relativePath, "Headless init is missing an Orbh Interface Schema section"));
-  } else if (!/flint orbh session\s+\S+\s+set/.test(interfaceSection.body)) {
+  } else if (!/flint orbh session(?:\s+\S+)?\s+set/.test(interfaceSection.body)) {
     results.push(
-      createContentWarning(relativePath, "Orbh Interface Schema section should describe flint orbh session <id> set keys")
+      createContentWarning(relativePath, "Orbh Interface Schema section should describe flint orbh session set keys (id optional when ORBH_SESSION_ID env is set)")
     );
   }
   if (!findSection(sections, /\bphase values\b/i)) {
@@ -91376,9 +91395,9 @@ async function validateHeadlessInitContent(shardPath, shorthand) {
   const resultSection = findSection(sections, /\bresult delivery\b/i);
   if (!resultSection) {
     results.push(createContentWarning(relativePath, "Headless init is missing a Result Delivery section"));
-  } else if (!/flint orbh session\s+\S+\s+return/.test(resultSection.body)) {
+  } else if (!/flint orbh session(?:\s+\S+)?\s+return/.test(resultSection.body)) {
     results.push(
-      createContentWarning(relativePath, "Result Delivery section should instruct agents to call flint orbh session <id> return")
+      createContentWarning(relativePath, "Result Delivery section should instruct agents to call flint orbh session return (id optional when ORBH_SESSION_ID env is set)")
     );
   }
   return results;
@@ -91456,14 +91475,14 @@ async function validateWorkflowContent(shardPath) {
       results.push(createContentWarning(relativePath, "Workflow is missing an Output section"));
     }
     if (isHeadless) {
-      if (!/flint orbh session\s+\S+\s+set/.test(content)) {
+      if (!/flint orbh session(?:\s+\S+)?\s+set/.test(content)) {
         results.push(
-          createContentWarning(relativePath, "Headless workflows should update Orbh interface keys via flint orbh session <id> set")
+          createContentWarning(relativePath, "Headless workflows should update Orbh interface keys via flint orbh session set (id optional when ORBH_SESSION_ID env is set)")
         );
       }
-      if (!/flint orbh session\s+\S+\s+return/.test(content)) {
+      if (!/flint orbh session(?:\s+\S+)?\s+return/.test(content)) {
         results.push(
-          createContentWarning(relativePath, "Headless workflows should end by calling flint orbh session <id> return")
+          createContentWarning(relativePath, "Headless workflows should end by calling flint orbh session return (id optional when ORBH_SESSION_ID env is set)")
         );
       }
     } else if (!/^##+\s+Stage\b/m.test(content)) {
@@ -93007,7 +93026,13 @@ async function postOrbhLaunch(port, profile2, prompt6 = "", timeoutMs = 1e4) {
   });
 }
 function getBuiltinPresetsDir() {
-  return join152(__dirname2, "presets");
+  const bundled = join152(__dirname2, "presets");
+  const builtPackage = join152(__dirname2, "..", "presets");
+  const tsxSource = join152(__dirname2, "..", "..", "presets");
+  if (existsSync32(bundled)) return bundled;
+  if (existsSync32(builtPackage)) return builtPackage;
+  if (existsSync32(tsxSource)) return tsxSource;
+  return bundled;
 }
 function getUserPresetsDir() {
   return join152(getGlobalFlintDir(), "presets");
@@ -95821,7 +95846,7 @@ var init_dist5 = __esm({
 
 // ../../packages/orbh/dist/index.js
 import { existsSync as existsSync23, readFileSync as readFileSync22 } from "fs";
-import { existsSync as existsSync32, readdirSync as readdirSync2, readFileSync as readFileSync32, statSync } from "fs";
+import { existsSync as existsSync33, readdirSync as readdirSync2, readFileSync as readFileSync32, statSync } from "fs";
 import { dirname as dirname11, join as join210 } from "path";
 import { closeSync, existsSync as existsSync42, openSync, readSync, statSync as statSync2, unwatchFile, watch, watchFile } from "fs";
 import { existsSync as existsSync52, readFileSync as readFileSync42, unwatchFile as unwatchFile2, watch as watch2, watchFile as watchFile2 } from "fs";
@@ -97148,7 +97173,7 @@ function isRawStreamEvent(value) {
   return isRecord6(value) && typeof value.type === "string";
 }
 function loadMessageParts(partsDir) {
-  if (!existsSync32(partsDir)) {
+  if (!existsSync33(partsDir)) {
     return [];
   }
   return readdirSync2(partsDir).filter((entry) => entry.endsWith(".json")).sort((left, right) => {
@@ -97166,7 +97191,7 @@ function loadStateFromSessionPath(sessionPath, sessionInfo) {
   const messagesDir = join210(storageRoot, "message", sessionInfo.id);
   const state = createOpencodeTranscriptState();
   state.session = sessionInfo;
-  if (!existsSync32(messagesDir)) {
+  if (!existsSync33(messagesDir)) {
     return state;
   }
   const messages = readdirSync2(messagesDir).filter((entry) => entry.endsWith(".json")).map((entry) => loadJsonFile(join210(messagesDir, entry))).filter(isMessageInfo).map((info) => ({
@@ -97882,7 +97907,7 @@ function buildCodexAppServerArgs(options3 = {}) {
   return args;
 }
 async function bootstrapCodexSession(cwd2, initPrompt, options3 = {}) {
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const start = async () => {
       const executable = await getExecutable("codex");
       const spawnCmd = executable.resolvedCommand.cmd;
@@ -97928,7 +97953,7 @@ async function bootstrapCodexSession(cwd2, initPrompt, options3 = {}) {
           if (message.id === 3 && message.result) {
             cleanup();
             proc.kill();
-            resolve23(threadId);
+            resolve24(threadId);
             return;
           }
           if (message.error && (message.id ?? 0) <= 3) {
@@ -98352,7 +98377,7 @@ async function waitForGeminiNativeSession(cwd2, timeoutMs, pollMs, options3) {
     if (discovered) {
       return discovered;
     }
-    await new Promise((resolve23) => setTimeout(resolve23, pollMs));
+    await new Promise((resolve24) => setTimeout(resolve24, pollMs));
   }
   return null;
 }
@@ -98625,7 +98650,7 @@ async function bootstrapGrokSession(cwd2, initPrompt, options3 = {}) {
   if (options3.extraArgs) {
     args.push(...options3.extraArgs);
   }
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const proc = spawn23(executable.resolvedCommand.cmd, args, {
       stdio: ["ignore", "pipe", "pipe"],
       cwd: cwd2,
@@ -98660,7 +98685,7 @@ async function bootstrapGrokSession(cwd2, initPrompt, options3 = {}) {
         reject(new Error(`Grok bootstrap completed but no sessionId in output: ${stdout.slice(-400)}`));
         return;
       }
-      resolve23(sessionId);
+      resolve24(sessionId);
     });
   });
 }
@@ -99058,7 +99083,7 @@ async function waitForOpencodeNativeSessionByOrbhSessionId(cwd2, orbhSessionId,
     if (discovered) {
       return discovered;
     }
-    await new Promise((resolve23) => setTimeout(resolve23, pollMs));
+    await new Promise((resolve24) => setTimeout(resolve24, pollMs));
   }
   return null;
 }
@@ -100289,7 +100314,7 @@ async function waitForCodexNativeSession(cwd2, timeoutMs, pollMs, options3) {
     if (discovered) {
       return discovered;
     }
-    await new Promise((resolve23) => setTimeout(resolve23, pollMs));
+    await new Promise((resolve24) => setTimeout(resolve24, pollMs));
   }
   return null;
 }
@@ -100836,19 +100861,19 @@ async function startInputSocket(opts) {
     process.stderr.write(`orbh input socket error: ${err.message}
 `);
   });
-  await new Promise((resolve23, reject) => {
+  await new Promise((resolve24, reject) => {
     server.once("error", reject);
     server.listen(socketPath, () => {
       server.off("error", reject);
-      resolve23();
+      resolve24();
     });
   });
   let closed = false;
   const close = async () => {
     if (closed) return;
     closed = true;
-    await new Promise((resolve23) => {
-      server.close(() => resolve23());
+    await new Promise((resolve24) => {
+      server.close(() => resolve24());
     });
     safeUnlink(socketPath);
   };
@@ -100934,7 +100959,7 @@ async function spawnInteractiveChild(opts) {
   });
 }
 function sleep2(ms) {
-  return new Promise((resolve23) => setTimeout(resolve23, ms));
+  return new Promise((resolve24) => setTimeout(resolve24, ms));
 }
 async function waitForSession(sessionsDir, sessionId, predicate, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
@@ -101306,7 +101331,7 @@ async function waitForInteractiveResult(child, options3, session, runtime2, inpu
     }
     clearInputSocketField(options3.sessionsDir, session.id);
   };
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const onSigHup = () => {
       const latest = readSession(options3.sessionsDir, session.id) ?? session;
       const run2 = getCurrentRun(latest);
@@ -101335,7 +101360,7 @@ async function waitForInteractiveResult(child, options3, session, runtime2, inpu
       finalizeSessionRun(latest, exitCode ?? null, signal ?? null, stderr);
       writeSession(options3.sessionsDir, latest);
       cleanupSocket();
-      resolve23({ session: latest, exitCode: exitCode ?? 0 });
+      resolve24({ session: latest, exitCode: exitCode ?? 0 });
     });
   });
 }
@@ -165661,21 +165686,21 @@ var require_react_development = __commonJS({
         );
         actScopeDepth = prevActScopeDepth;
       }
-      function recursivelyFlushAsyncActWork(returnValue, resolve23, reject) {
+      function recursivelyFlushAsyncActWork(returnValue, resolve24, reject) {
         var queue = ReactSharedInternals.actQueue;
         if (null !== queue)
           if (0 !== queue.length)
             try {
               flushActQueue(queue);
               enqueueTask(function() {
-                return recursivelyFlushAsyncActWork(returnValue, resolve23, reject);
+                return recursivelyFlushAsyncActWork(returnValue, resolve24, reject);
               });
               return;
             } catch (error3) {
               ReactSharedInternals.thrownErrors.push(error3);
             }
           else ReactSharedInternals.actQueue = null;
-        0 < ReactSharedInternals.thrownErrors.length ? (queue = aggregateErrors(ReactSharedInternals.thrownErrors), ReactSharedInternals.thrownErrors.length = 0, reject(queue)) : resolve23(returnValue);
+        0 < ReactSharedInternals.thrownErrors.length ? (queue = aggregateErrors(ReactSharedInternals.thrownErrors), ReactSharedInternals.thrownErrors.length = 0, reject(queue)) : resolve24(returnValue);
       }
       function flushActQueue(queue) {
         if (!isFlushing) {
@@ -165862,7 +165887,7 @@ var require_react_development = __commonJS({
             ));
           });
           return {
-            then: function(resolve23, reject) {
+            then: function(resolve24, reject) {
               didAwaitActCall = true;
               thenable.then(
                 function(returnValue) {
@@ -165872,7 +165897,7 @@ var require_react_development = __commonJS({
                       flushActQueue(queue), enqueueTask(function() {
                         return recursivelyFlushAsyncActWork(
                           returnValue,
-                          resolve23,
+                          resolve24,
                           reject
                         );
                       });
@@ -165886,7 +165911,7 @@ var require_react_development = __commonJS({
                       ReactSharedInternals.thrownErrors.length = 0;
                       reject(_thrownError);
                     }
-                  } else resolve23(returnValue);
+                  } else resolve24(returnValue);
                 },
                 function(error3) {
                   popActScope(prevActQueue, prevActScopeDepth);
@@ -165908,15 +165933,15 @@ var require_react_development = __commonJS({
         if (0 < ReactSharedInternals.thrownErrors.length)
           throw callback = aggregateErrors(ReactSharedInternals.thrownErrors), ReactSharedInternals.thrownErrors.length = 0, callback;
         return {
-          then: function(resolve23, reject) {
+          then: function(resolve24, reject) {
             didAwaitActCall = true;
             0 === prevActScopeDepth ? (ReactSharedInternals.actQueue = queue, enqueueTask(function() {
               return recursivelyFlushAsyncActWork(
                 returnValue$jscomp$0,
-                resolve23,
+                resolve24,
                 reject
               );
-            })) : resolve23(returnValue$jscomp$0);
+            })) : resolve24(returnValue$jscomp$0);
           }
         };
       };
@@ -170726,8 +170751,8 @@ var require_react_reconciler_production = __commonJS({
           currentEntangledActionThenable = {
             status: "pending",
             value: void 0,
-            then: function(resolve23) {
-              entangledListeners.push(resolve23);
+            then: function(resolve24) {
+              entangledListeners.push(resolve24);
             }
           };
         }
@@ -170750,8 +170775,8 @@ var require_react_reconciler_production = __commonJS({
           status: "pending",
           value: null,
           reason: null,
-          then: function(resolve23) {
-            listeners.push(resolve23);
+          then: function(resolve24) {
+            listeners.push(resolve24);
           }
         };
         thenable.then(
@@ -180350,8 +180375,8 @@ var require_react_reconciler_development = __commonJS({
           currentEntangledActionThenable = {
             status: "pending",
             value: void 0,
-            then: function(resolve23) {
-              entangledListeners.push(resolve23);
+            then: function(resolve24) {
+              entangledListeners.push(resolve24);
             }
           };
         }
@@ -180374,8 +180399,8 @@ var require_react_reconciler_development = __commonJS({
           status: "pending",
           value: null,
           reason: null,
-          then: function(resolve23) {
-            listeners.push(resolve23);
+          then: function(resolve24) {
+            listeners.push(resolve24);
           }
         };
         thenable.then(
@@ -201271,8 +201296,8 @@ var init_ink = __esm({
         }
       }
       async waitUntilExit() {
-        this.exitPromise ||= new Promise((resolve23, reject) => {
-          this.resolveExitPromise = resolve23;
+        this.exitPromise ||= new Promise((resolve24, reject) => {
+          this.resolveExitPromise = resolve24;
           this.rejectExitPromise = reject;
         });
         if (!this.beforeExitHandler) {
@@ -202388,12 +202413,12 @@ async function pickSession(options3) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("orbh continue requires an interactive TTY.");
   }
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     let resolved = false;
     const handle = (session) => {
       if (resolved) return;
       resolved = true;
-      resolve23(session);
+      resolve24(session);
     };
     const instance = render_default(
       (0, import_react29.createElement)(SessionPicker, {
@@ -202794,10 +202819,10 @@ async function confirm(message) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     rl.question(`${message} (y/N) `, (answer) => {
       rl.close();
-      resolve23(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve24(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -203605,10 +203630,10 @@ async function prompt(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve23(answer.trim());
+      resolve24(answer.trim());
     });
   });
 }
@@ -203969,7 +203994,7 @@ var LiveRender = class {
 async function runStep(entry, step2, index, total, live) {
   const cols = Math.max(40, process.stdout.columns ?? 80);
   const tailMax = Math.max(20, cols - 6);
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     const child = spawn4(process.execPath, [entry, ...step2.args], {
       stdio: ["ignore", "pipe", "pipe"],
       windowsHide: true
@@ -204010,7 +204035,7 @@ async function runStep(entry, step2, index, total, live) {
     child.on("close", (code) => {
       done = true;
       clearInterval(ticker);
-      resolve23({ code: code ?? 1, tail: captured });
+      resolve24({ code: code ?? 1, tail: captured });
     });
   });
 }
@@ -204023,9 +204048,9 @@ Runs in order:
 
 If any step exits non-zero, Gigasync stops and exits with that code.
 `).action(async () => {
-  const entry = process.argv[1];
+  const entry = process.env.FLINT_CLI_LAUNCHER ?? process.argv[1];
   if (!entry) {
-    console.error(export_pc.red("Error: Could not resolve flint entry script (process.argv[1] missing)."));
+    console.error(export_pc.red("Error: Could not resolve flint entry script (FLINT_CLI_LAUNCHER and process.argv[1] missing)."));
     process.exit(1);
   }
   const flintPath = await findFlintRoot(process.cwd());
@@ -204225,14 +204250,14 @@ function readPkgVersion2() {
 }
 var PACKAGE_NAME = "@nuucognition/flint-cli";
 function fetchLatestVersion() {
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     https.get(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, (res) => {
       let data = "";
       res.on("data", (chunk) => data += chunk);
       res.on("end", () => {
         try {
           const json = JSON.parse(data);
-          resolve23(json.version);
+          resolve24(json.version);
         } catch {
           reject(new Error("Failed to parse registry response"));
         }
@@ -204300,10 +204325,10 @@ async function prompt2(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve23(answer.trim());
+      resolve24(answer.trim());
     });
   });
 }
@@ -204542,10 +204567,10 @@ async function prompt3(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve23(answer.trim());
+      resolve24(answer.trim());
     });
   });
 }
@@ -205152,7 +205177,7 @@ ${unfulfilled.length} unfulfilled codebase reference(s):
   console.log(export_pc.dim(`  \u2192 ${resolvedPath}`));
 }
 function prompt4(message) {
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     process.stdout.write(message);
     let data = "";
     process.stdin.setEncoding("utf-8");
@@ -205160,7 +205185,7 @@ function prompt4(message) {
     process.stdin.once("data", (chunk) => {
       data = chunk.toString().trim();
       process.stdin.pause();
-      resolve23(data);
+      resolve24(data);
     });
   });
 }
@@ -205595,10 +205620,10 @@ async function exists3(path31) {
 }
 function prompt5(question) {
   const rl = createInterface5({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve23(answer.trim());
+      resolve24(answer.trim());
     });
   });
 }
@@ -208221,7 +208246,7 @@ function getExpectedRepoUrl() {
   return platform5() === "win32" ? OBSIDIAN_WINDOWS_REPO_URL : OBSIDIAN_REPO_URL;
 }
 function postReload(port) {
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const req = httpRequest({
       hostname: "127.0.0.1",
       port,
@@ -208230,7 +208255,7 @@ function postReload(port) {
       timeout: 2e3
     }, (res) => {
       res.resume();
-      res.on("end", () => resolve23());
+      res.on("end", () => resolve24());
     });
     req.on("error", reject);
     req.on("timeout", () => req.destroy(new Error("timeout")));
@@ -209244,7 +209269,7 @@ var DEFAULT_EXTRA_ARGS_BY_RUNTIME = {
 };
 var INPUT_SOCKET_TIMEOUT_MS = 2e3;
 function sendToInputSocket(socketPath, payload) {
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const conn = createConnection(socketPath);
     let buffer2 = "";
     const timer = setTimeout(() => {
@@ -209268,7 +209293,7 @@ function sendToInputSocket(socketPath, payload) {
       cleanup();
       try {
         const ack = JSON.parse(line);
-        resolve23(ack);
+        resolve24(ack);
       } catch (err) {
         reject(new Error(`invalid ack: ${err.message}`));
       }
@@ -211162,6 +211187,27 @@ function indentBlock(text, indent = 2) {
 function resolveMessageSender() {
   return process.env.ORBH_SESSION_ID?.trim() || "human";
 }
+var SELF_TARGETING_SESSION_ACTIONS = /* @__PURE__ */ new Set([
+  "register",
+  "status",
+  "return",
+  "set",
+  "get",
+  "ask"
+]);
+function resolveSelfSessionId(arg) {
+  const trimmedArg = arg?.trim();
+  if (trimmedArg) return trimmedArg;
+  const env5 = process.env.ORBH_SESSION_ID?.trim();
+  return env5 ? env5 : void 0;
+}
+function shiftSessionPositionals(rawId, rawAction, rawValueParts, envSessionId) {
+  if (typeof rawId === "string" && SELF_TARGETING_SESSION_ACTIONS.has(rawId) && envSessionId) {
+    const valueParts = rawAction !== void 0 ? [rawAction, ...rawValueParts] : [...rawValueParts];
+    return { id: envSessionId, action: rawId, valueParts, shifted: true };
+  }
+  return { id: rawId, action: rawAction, valueParts: rawValueParts, shifted: false };
+}
 function formatPiggybackMessages(messages) {
   return `---orbh-messages---
 ${JSON.stringify(messages, null, 2)}`;
@@ -211261,7 +211307,7 @@ async function defaultResumeDeferredSession(resumeContext) {
 var REQUEST_SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 var REQUEST_LAUNCH_OPTION_KEYS = ["runtime", "stream", "continues", "maxTurns", "budget", "model", "title", "description", "timeout"];
 function sleep3(ms) {
-  return new Promise((resolve23) => setTimeout(resolve23, ms));
+  return new Promise((resolve24) => setTimeout(resolve24, ms));
 }
 function getStringOption(options3, key) {
   if (typeof options3 !== "object" || options3 === null || !(key in options3)) {
@@ -212117,7 +212163,7 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
       const deadline = Date.now() + 3e4;
       process.stdout.write(export_pc.dim("Waiting for transcript path resolution..."));
       while (Date.now() <= deadline) {
-        await new Promise((resolve23) => setTimeout(resolve23, 500));
+        await new Promise((resolve24) => setTimeout(resolve24, 500));
         const fresh = resolveSession(sessionsDir, id);
         if (!fresh) {
           break;
@@ -212211,7 +212257,7 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
     });
     watcher.start();
     if (isTerminalStatus(session.status)) {
-      await new Promise((resolve23) => setTimeout(resolve23, 500));
+      await new Promise((resolve24) => setTimeout(resolve24, 500));
       watcher.stop();
       if (entryCount > 0) {
         process.stdout.write("\r\x1B[2K");
@@ -212326,9 +212372,14 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
     console.log(`Focused ${binding.vault} \u2192 leaf ${binding.leafId.slice(0, 8)}`);
   });
   addOptionalPathOption(
-    command.command("close").description("Close this session's Obsidian terminal tab and flip the title prefix to [Closed] (kills the harness)").argument("<id>", "Session ID (full or partial)"),
+    command.command("close").description("Close this session's Obsidian terminal tab and flip the title prefix to [Closed] (kills the harness). Self-targets via ORBH_SESSION_ID when run from inside an Orbh harness.").argument("[id]", "Session ID (full or partial). Optional when ORBH_SESSION_ID is set."),
     options3
-  ).action(async (id, commandOptions) => {
+  ).action(async (idArg, commandOptions) => {
+    const id = resolveSelfSessionId(idArg);
+    if (!id) {
+      console.error(export_pc.red("Error: Session ID required. Pass it explicitly or run inside an Orbh harness (ORBH_SESSION_ID env var)."));
+      process.exit(1);
+    }
     const { sessionsDir } = await getResolvedContext(commandOptions, options3);
     const session = resolveSession(sessionsDir, id);
     if (!session) {
@@ -212357,9 +212408,14 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
     console.log(`Closed tab in ${binding.vault}`);
   });
   addOptionalPathOption(
-    command.command("park").description("Park this session \u2014 close the Obsidian tab, flip the title prefix to [Parked], and pin to the top of `orbh c`. `orbh resume` auto-unparks.").argument("<id>", "Session ID (full or partial)"),
+    command.command("park").description("Park this session \u2014 close the Obsidian tab, flip the title prefix to [Parked], and pin to the top of `orbh c`. `orbh resume` auto-unparks. Self-targets via ORBH_SESSION_ID when run from inside an Orbh harness.").argument("[id]", "Session ID (full or partial). Optional when ORBH_SESSION_ID is set."),
     options3
-  ).action(async (id, commandOptions) => {
+  ).action(async (idArg, commandOptions) => {
+    const id = resolveSelfSessionId(idArg);
+    if (!id) {
+      console.error(export_pc.red("Error: Session ID required. Pass it explicitly or run inside an Orbh harness (ORBH_SESSION_ID env var)."));
+      process.exit(1);
+    }
     const { sessionsDir } = await getResolvedContext(commandOptions, options3);
     const session = resolveSession(sessionsDir, id);
     if (!session) {
@@ -212384,6 +212440,34 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
     }
     console.log(`Parked session ${shortId(session.id)} (tab closed in ${binding.vault}). Resume with: orbh resume ${shortId(session.id)}`);
   });
+  addOptionalPathOption(
+    command.command("discard").description("Discard this session \u2014 close the Obsidian tab and hard-delete the session entry from .flint/sessions/. No confirmation. Self-targets via ORBH_SESSION_ID when run from inside an Orbh harness.").argument("[id]", "Session ID (full or partial). Optional when ORBH_SESSION_ID is set."),
+    options3
+  ).action(async (idArg, commandOptions) => {
+    const id = resolveSelfSessionId(idArg);
+    if (!id) {
+      console.error(export_pc.red("Error: Session ID required. Pass it explicitly or run inside an Orbh harness (ORBH_SESSION_ID env var)."));
+      process.exit(1);
+    }
+    const { sessionsDir } = await getResolvedContext(commandOptions, options3);
+    const session = resolveSession(sessionsDir, id);
+    if (!session) {
+      console.error(export_pc.red(`Error: Session not found: ${id}`));
+      process.exit(1);
+    }
+    const binding = await resolveLiveObsidianBinding(sessionsDir, session);
+    if (!binding) {
+      console.error(export_pc.red("No Obsidian binding on this session."));
+      process.exit(1);
+    }
+    const result = await closeLeaf(binding);
+    if (!result.ok) {
+      console.error(export_pc.red(`Discard failed: ${result.error}`));
+      process.exit(1);
+    }
+    deleteSession(sessionsDir, session.id);
+    console.log(`Discarded session ${shortId(session.id)} (tab closed in ${binding.vault}, entry deleted).`);
+  });
   const messageCommand = addOptionalPathOption(
     command.command("message").description("Send or inspect persisted inter-session messages"),
     options3
@@ -212435,10 +212519,17 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
     ));
   });
   const sessionCommand = addOptionalPathOption(
-    command.command("session").description("Agent-facing session lifecycle commands").argument("<id>", "Session ID (full or partial)").argument("[action]", 'Action: register, status, return, set, get, ask \u2014 or use "await" for event subscription').argument("[value...]", "Arguments for the selected action").option("--timeout <seconds>", "Timeout in seconds", "3600").option("-f, --filter <key=value>", "Filter payloads by field value (for await); repeat to add more", collectRepeatedOption, []).option("--list", "List available event types (for await)").option("--host <host>", "Server host override (for await)").option("--port <port>", "Server port override (for await)", Number).option("--sessions-dir <path>", "Override sessions directory (for await)").option("--config <path>", "Path to orbh.toml (for await)"),
+    command.command("session").description('Agent-facing session lifecycle commands. When ORBH_SESSION_ID is set, <id> may be omitted for self-targeting actions (register, status, return, set, get, ask) \u2014 e.g. `orbh session register "title" "desc"`.').argument("<id>", "Session ID (full or partial), or the action verb when ORBH_SESSION_ID is set").argument("[action]", 'Action: register, status, return, set, get, ask \u2014 or use "await" for event subscription').argument("[value...]", "Arguments for the selected action").option("--timeout <seconds>", "Timeout in seconds", "3600").option("-f, --filter <key=value>", "Filter payloads by field value (for await); repeat to add more", collectRepeatedOption, []).option("--list", "List available event types (for await)").option("--host <host>", "Server host override (for await)").option("--port <port>", "Server port override (for await)", Number).option("--sessions-dir <path>", "Override sessions directory (for await)").option("--config <path>", "Path to orbh.toml (for await)"),
     options3
   );
-  sessionCommand.action(async (id, action, valueParts, commandOptions) => {
+  sessionCommand.action(async (rawId, rawAction, rawValueParts, commandOptions) => {
+    const envSessionId = process.env.ORBH_SESSION_ID?.trim();
+    const shifted = shiftSessionPositionals(rawId, rawAction, rawValueParts, envSessionId);
+    let { id, action, valueParts } = shifted;
+    if (!shifted.shifted && typeof rawId === "string" && SELF_TARGETING_SESSION_ACTIONS.has(rawId) && !envSessionId) {
+      console.error(export_pc.red(`Error: '${rawId}' looks like a session action, but no session id was provided and ORBH_SESSION_ID is unset. Pass the id explicitly: orbh session <id> ${rawId} ...`));
+      process.exit(1);
+    }
     if (id === "await") {
       const AWAIT_EVENT_TYPES = [
         { type: "session.created", description: "A new session was created" },
@@ -212515,15 +212606,22 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
       }
       return;
     }
+    if (!id) {
+      console.error(export_pc.red("Error: Missing <id>. Pass it explicitly or run inside an Orbh harness (ORBH_SESSION_ID env var)."));
+      process.exit(1);
+      return;
+    }
     if (!action) {
       console.error(export_pc.red("Error: Missing <action>. Valid: register, status, return, set, get, ask."));
       process.exit(1);
+      return;
     }
     const { sessionsDir } = await getResolvedContext(commandOptions, options3);
     const session = resolveSession(sessionsDir, id);
     if (!session) {
       console.error(export_pc.red(`Error: Session not found: ${id}`));
       process.exit(1);
+      return;
     }
     switch (action) {
       case "register": {
@@ -212533,7 +212631,7 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
         }
         const [rawTitle, ...descriptionParts] = valueParts;
         const description = descriptionParts.join(" ");
-        const cleanTitle = rawTitle.replace(/^\(I\)\s*/i, "").trim();
+        const cleanTitle = (rawTitle ?? "").replace(/^\(I\)\s*/i, "").trim();
         const title = session.interactive ? `(I) ${cleanTitle}` : cleanTitle;
         updateSession(sessionsDir, session.id, { title, description, status: "in-progress" });
         try {
@@ -212597,6 +212695,11 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
           process.exit(1);
         }
         const [key, ...sessionValueParts] = valueParts;
+        if (!key) {
+          console.error(export_pc.red("Error: set requires <key> <value>."));
+          process.exit(1);
+          return;
+        }
         const value = sessionValueParts.join(" ");
         session.interface[key] = value;
         writeSession(sessionsDir, session);
@@ -212648,7 +212751,7 @@ ${export_pc.bold("Orbh Session Stats")} ${export_pc.dim("\xB7")} ${export_pc.cya
             deliverPendingMessagesToStdout(sessionsDir, session.id);
             return;
           }
-          await new Promise((resolve23) => setTimeout(resolve23, 2e3));
+          await new Promise((resolve24) => setTimeout(resolve24, 2e3));
         }
         updateSession(sessionsDir, session.id, { status: "in-progress" });
         console.error("Timeout: no response received");
@@ -213239,8 +213342,13 @@ function registerServerCommands(command) {
     }
     const daemonChild = process.env.ORBH_DAEMON_CHILD === "1";
     if (opts.daemon && !daemonChild) {
-      const childArgs = process.argv.slice(1).filter((arg) => arg !== "--daemon");
-      const child = spawn9(process.argv[0] ?? process.execPath, childArgs, {
+      const launcher = process.env.ORBH_CLI_LAUNCHER ?? process.argv[1];
+      if (!launcher) {
+        console.error(export_pc.red("Error: Could not resolve orbh entry script (ORBH_CLI_LAUNCHER and process.argv[1] missing)."));
+        process.exit(1);
+      }
+      const childArgs = [launcher, ...process.argv.slice(2).filter((arg) => arg !== "--daemon")];
+      const child = spawn9(process.execPath, childArgs, {
         cwd: process.cwd(),
         detached: true,
         stdio: "ignore",
@@ -214305,6 +214413,12 @@ var tinderboxCommand = new Command("tinderbox").description("Orchestrate operati
           console.log(`  ${export_pc.green("\u2713")} ${entry.from} -> ${entry.to}`);
         }
       }
+      if (result.warnings.length > 0) {
+        console.log(export_pc.bold("\nWarnings"));
+        for (const warning of result.warnings) {
+          console.log(`  ${export_pc.yellow("!")} ${warning.scope}: ${warning.message}`);
+        }
+      }
       printSummary(result.sync);
       printCheck(result.finalCheck);
       if (result.sync.errors.length > 0 || !result.finalCheck.ok) {
@@ -214935,12 +215049,12 @@ var FlintServerClient = class {
 
 // ../../packages/flint-sdk/src/discovery.ts
 async function loadNodeModules() {
-  const [{ readFile: readFile21 }, { homedir: homedir14 }, { join: join56, resolve: resolve23 }] = await Promise.all([
+  const [{ readFile: readFile21 }, { homedir: homedir14 }, { join: join56, resolve: resolve24 }] = await Promise.all([
     import("fs/promises"),
     import("os"),
     import("path")
   ]);
-  return { readFile: readFile21, homedir: homedir14, join: join56, resolve: resolve23 };
+  return { readFile: readFile21, homedir: homedir14, join: join56, resolve: resolve24 };
 }
 function normalizeRegistryFile(value) {
   if (!value || typeof value !== "object" || !("servers" in value) || !Array.isArray(value.servers)) {
@@ -214996,7 +215110,7 @@ init_dist5();
 import Fastify2 from "fastify";
 import fastifyCors from "@fastify/cors";
 import fastifyStatic from "@fastify/static";
-import { stat as stat53 } from "fs/promises";
+import { stat as stat63 } from "fs/promises";
 import path72 from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 import { join as join54 } from "path";
@@ -216548,7 +216662,7 @@ import { parse as parseYaml6 } from "yaml";
 import { existsSync as existsSync24, watch as watch4 } from "fs";
 import { stat as stat25 } from "fs/promises";
 import path27 from "path";
-import { mkdir as mkdir18, readFile as readFile27, writeFile as writeFile14 } from "fs/promises";
+import { mkdir as mkdir18, readFile as readFile27, stat as stat33, writeFile as writeFile14 } from "fs/promises";
 import { homedir as homedir12 } from "os";
 import { join as join47, resolve as resolve21 } from "path";
 init_dist5();
@@ -216557,17 +216671,17 @@ init_dist5();
 init_dist5();
 init_dist6();
 import { existsSync as existsSync25 } from "fs";
-import { stat as stat33, readFile as readFile37 } from "fs/promises";
+import { stat as stat43, readFile as readFile37 } from "fs/promises";
 import path33 from "path";
 import path43, { join as join211 } from "path";
-import { readdirSync as readdirSync9, readFileSync as readFileSync17, existsSync as existsSync33 } from "fs";
+import { readdirSync as readdirSync9, readFileSync as readFileSync17, existsSync as existsSync34 } from "fs";
 import { readdir as readdir15 } from "fs/promises";
 import path53 from "path";
 import { readdir as readdir25 } from "fs/promises";
 import { join as join310 } from "path";
 import { mkdir as mkdir25, readFile as readFile43, rename as rename10, writeFile as writeFile26, readdir as readdir33 } from "fs/promises";
 import path62 from "path";
-import { writeFile as writeFile35, mkdir as mkdir33, readdir as readdir43, readFile as readFile53, stat as stat43 } from "fs/promises";
+import { writeFile as writeFile35, mkdir as mkdir33, readdir as readdir43, readFile as readFile53, stat as stat53 } from "fs/promises";
 import { join as join48 } from "path";
 var DEFAULT_EVENT_LOG_SIZE = 200;
 function computeRuntimeId(flintPath) {
@@ -216959,7 +217073,7 @@ async function executeHook(options3) {
   const { hook, event, flintPath, logger } = options3;
   const command = resolveHookCommand(hook.command, flintPath);
   logger.debug?.("Running hook", hook.command);
-  await new Promise((resolve23, reject) => {
+  await new Promise((resolve24, reject) => {
     const envPathEntries = [
       path26.join(flintPath, "node_modules", ".bin"),
       path26.join(process.cwd(), "node_modules", ".bin"),
@@ -217005,7 +217119,7 @@ async function executeHook(options3) {
         if (stdout.trim()) {
           logger.info?.(`Hook output: ${stdout.trim()}`);
         }
-        resolve23();
+        resolve24();
         return;
       }
       if (code === 2) {
@@ -217013,7 +217127,7 @@ async function executeHook(options3) {
         if (stderr.trim()) {
           logger.warn?.(stderr.trim());
         }
-        resolve23();
+        resolve24();
         return;
       }
       const error3 = new Error(`Hook failed (${code ?? "unknown"}): ${hook.command}`);
@@ -217309,6 +217423,21 @@ async function readAndValidateRegistry() {
   }
   return valid;
 }
+async function readRegistryRaw() {
+  const entries = await readServerRegistry();
+  let registryMtime = null;
+  try {
+    const s = await stat33(REGISTRY_PATH);
+    registryMtime = s.mtime.toISOString();
+  } catch {
+    registryMtime = null;
+  }
+  return {
+    registryPath: REGISTRY_PATH,
+    registryMtime,
+    entries
+  };
+}
 function getServerRegistryPath() {
   return REGISTRY_PATH;
 }
@@ -217423,13 +217552,13 @@ function registerPlatesRoutes(app, ctx) {
     }
     const entryPath = path33.resolve(plate.path, plate.manifest.entry);
     const distRoot = path33.dirname(entryPath);
-    if (!await stat33(distRoot).catch(() => null)) {
+    if (!await stat43(distRoot).catch(() => null)) {
       return sendApiError(reply, 404, "plate_not_built", `Plate "${plate.manifest.name}" has not been built`, {
         plate: plate.manifest.name
       });
     }
     const targetPath = requestedPath && requestedPath.length > 0 ? path33.resolve(distRoot, requestedPath) : entryPath;
-    if (!targetPath.startsWith(distRoot) || !await stat33(targetPath).catch(() => null)) {
+    if (!targetPath.startsWith(distRoot) || !await stat43(targetPath).catch(() => null)) {
       return sendApiError(reply, 404, "not_found", `Asset "${requestedPath ?? "/"}" was not found`);
     }
     const content = await readFile37(targetPath);
@@ -217814,7 +217943,7 @@ async function buildFlintIdentity(ctx) {
   ]);
   let totalSessions = 0;
   let activeSessions = 0;
-  if (ctx.orbhSessionsDir && existsSync33(ctx.orbhSessionsDir)) {
+  if (ctx.orbhSessionsDir && existsSync34(ctx.orbhSessionsDir)) {
     const files = readdirSync9(ctx.orbhSessionsDir).filter((f) => f.endsWith(".json"));
     totalSessions = files.length;
     for (const file of files) {
@@ -218550,6 +218679,9 @@ function registerRegistryRoutes(app) {
       servers: servers.map(({ valid: _valid, url: _url, ...entry }) => entry)
     };
   });
+  app.get("/api/registry/raw", async () => {
+    return readRegistryRaw();
+  });
 }
 var FLUSH_INTERVAL_MS = 5e3;
 var RUNTIME_DIR_MAP = {
@@ -218663,7 +218795,7 @@ var LiveTranscriptWriter = class {
     }
     for (const dir of runtimeDirs) {
       const dirPath = join48(agentsDir, dir);
-      const dirStat = await stat43(dirPath).catch(() => null);
+      const dirStat = await stat53(dirPath).catch(() => null);
       if (!dirStat?.isDirectory()) continue;
       let files;
       try {
@@ -218793,11 +218925,11 @@ async function shutdownPairedSteelHost(steelUrl) {
 }
 async function isPortFree(port, host) {
   const { createServer: createServer4 } = await import("net");
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     const server = createServer4();
-    server.once("error", () => resolve23(false));
+    server.once("error", () => resolve24(false));
     server.once("listening", () => {
-      server.close(() => resolve23(true));
+      server.close(() => resolve24(true));
     });
     server.listen(port, host);
   });
@@ -218842,7 +218974,7 @@ async function waitForCliHostDeregister(flintPath, flintId, timeoutMs = 5e3) {
     if (!stillRunning) {
       return true;
     }
-    await new Promise((resolve23) => setTimeout(resolve23, 150));
+    await new Promise((resolve24) => setTimeout(resolve24, 150));
   }
   return false;
 }
@@ -218909,7 +219041,7 @@ async function startFlintServer(options3 = {}) {
   const __dirname7 = path72.dirname(fileURLToPath7(import.meta.url));
   const dashboardDist = path72.resolve(__dirname7, "..", "..", "..", "apps", "orbh-dashboard", "dist");
   try {
-    await stat53(dashboardDist);
+    await stat63(dashboardDist);
     await app.register(fastifyStatic, {
       root: dashboardDist,
       prefix: "/",
@@ -219080,7 +219212,7 @@ async function startFlintServer(options3 = {}) {
           console.log(`[flint-server] ${needsBuild.length} plate(s) need building...`);
           for (const plate of needsBuild) {
             try {
-              const nodeModulesExists = await stat53(join54(plate.path, "node_modules")).then(() => true, () => false);
+              const nodeModulesExists = await stat63(join54(plate.path, "node_modules")).then(() => true, () => false);
               if (!nodeModulesExists) {
                 console.log(`[flint-server]   installing deps for ${plate.manifest.title}...`);
                 const installResult = await installPlateDeps(flintPath, plate.manifest.name);
@@ -220150,30 +220282,48 @@ async function listFlints() {
     return a.name.localeCompare(b.name);
   });
 }
-function matchVault(records, name) {
-  const target = name.trim().toLowerCase();
-  const withPrefix2 = target.startsWith("(flint)") ? target : `(flint) ${target}`;
-  for (const r of records) {
-    const v = r.vault.toLowerCase();
-    if (v === target || v === withPrefix2) return r;
+async function liveServers() {
+  const all = await readAllServers();
+  return all.filter((s) => isProcessAlive2(s.pid));
+}
+function resolveLaunchTarget2(servers, selector) {
+  if (selector.flintId) {
+    const id = selector.flintId.trim();
+    const match2 = servers.find((s) => s.flintId === id);
+    if (match2) return match2;
+  }
+  if (selector.flintPath) {
+    const targetPath = path29.resolve(selector.flintPath.trim());
+    const match2 = servers.find((s) => path29.resolve(s.flintPath) === targetPath);
+    if (match2) return match2;
+  }
+  if (selector.flintName) {
+    const target = selector.flintName.trim().toLowerCase();
+    const withPrefix2 = target.startsWith("(flint)") ? target : `(flint) ${target}`;
+    const match2 = servers.find((s) => {
+      const n = s.name.toLowerCase();
+      const v = (s.vault ?? "").toLowerCase();
+      return n === target || n === withPrefix2 || v === target || v === withPrefix2;
+    });
+    if (match2) return match2;
   }
   return null;
 }
 function readBody(req) {
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     let data = "";
     req.on("data", (chunk) => data += chunk);
-    req.on("end", () => resolve23(data));
+    req.on("end", () => resolve24(data));
     req.on("error", reject);
   });
 }
-async function proxyLaunch(record, body) {
+async function proxyLaunch(targetPort, body) {
   const payload = JSON.stringify({ profile: body.profile, prompt: body.prompt });
-  return new Promise((resolve23, reject) => {
+  return new Promise((resolve24, reject) => {
     const req = http.request(
       {
         host: "127.0.0.1",
-        port: record.port,
+        port: targetPort,
         path: "/workspace/orbh/launch",
         method: "POST",
         headers: {
@@ -220184,7 +220334,7 @@ async function proxyLaunch(record, body) {
       (res) => {
         let data = "";
         res.on("data", (chunk) => data += chunk);
-        res.on("end", () => resolve23({ status: res.statusCode ?? 502, body: data }));
+        res.on("end", () => resolve24({ status: res.statusCode ?? 502, body: data }));
         res.on("error", reject);
       }
     );
@@ -220233,12 +220383,17 @@ async function handleRequest(req, res, port) {
       res.end(JSON.stringify({ ok: false, error: "invalid JSON body" }));
       return;
     }
-    const flintName = parsed.flintName;
+    const flintId = typeof parsed.flintId === "string" && parsed.flintId.trim() ? parsed.flintId : void 0;
+    const flintPath = typeof parsed.flintPath === "string" && parsed.flintPath.trim() ? parsed.flintPath : void 0;
+    const flintName = typeof parsed.flintName === "string" && parsed.flintName.trim() ? parsed.flintName : void 0;
     const profile2 = parsed.profile;
     const prompt6 = parsed.prompt;
-    if (typeof flintName !== "string" || !flintName.trim()) {
+    if (!flintId && !flintPath && !flintName) {
       res.statusCode = 400;
-      res.end(JSON.stringify({ ok: false, error: "flintName required (non-empty string)" }));
+      res.end(JSON.stringify({
+        ok: false,
+        error: "one of flintId, flintPath, or flintName required (non-empty string)"
+      }));
       return;
     }
     if (typeof profile2 !== "string" || !profile2.trim()) {
@@ -220246,24 +220401,25 @@ async function handleRequest(req, res, port) {
       res.end(JSON.stringify({ ok: false, error: "profile required (non-empty string)" }));
       return;
     }
-    if (typeof prompt6 !== "string" || !prompt6.trim()) {
-      res.statusCode = 400;
-      res.end(JSON.stringify({ ok: false, error: "prompt required (non-empty string)" }));
-      return;
-    }
-    const vaults = await liveVaults();
-    const match2 = matchVault(vaults, flintName);
+    const normalizedPrompt = typeof prompt6 === "string" ? prompt6 : "";
+    const servers = await liveServers();
+    const match2 = resolveLaunchTarget2(servers, { flintId, flintPath, flintName });
     if (!match2) {
+      const selector = flintId ?? flintPath ?? flintName;
       res.statusCode = 404;
       res.end(JSON.stringify({
         ok: false,
-        error: `no live vault matching "${flintName}"`,
-        available: vaults.map((v) => v.vault)
+        error: `no live flint matching "${selector}"`,
+        available: servers.map((s) => ({
+          flintId: s.flintId,
+          name: s.name,
+          flintPath: s.flintPath
+        }))
       }));
       return;
     }
     try {
-      const proxied = await proxyLaunch(match2, { profile: profile2, prompt: prompt6 });
+      const proxied = await proxyLaunch(match2.port, { profile: profile2, prompt: normalizedPrompt });
       res.statusCode = proxied.status;
       res.end(proxied.body);
     } catch (err) {
@@ -220302,7 +220458,7 @@ var routerCommand = new Command("router").description("Local HTTP broker that pr
       console.log(export_pc.dim("  GET  /health   \u2014 liveness check"));
       console.log(export_pc.dim("  GET  /vaults   \u2014 list live Obsidian vaults"));
       console.log(export_pc.dim("  GET  /flints   \u2014 list all registered flints with reachability"));
-      console.log(export_pc.dim("  POST /launch   \u2014 { flintName, profile, prompt } \u2192 proxies to vault"));
+      console.log(export_pc.dim("  POST /launch   \u2014 { flintId | flintPath | flintName, profile, prompt } \u2192 proxies to vault"));
       console.log(export_pc.dim("Ctrl-C to stop."));
     });
     const shutdown = () => {
@@ -220412,13 +220568,13 @@ async function copyToClipboard(text) {
     cmd = process.env.WAYLAND_DISPLAY ? "wl-copy" : "xclip";
     if (cmd === "xclip") args = ["-selection", "clipboard"];
   }
-  await new Promise((resolve23, reject) => {
+  await new Promise((resolve24, reject) => {
     const child = spawn12(cmd, args, { stdio: ["pipe", "ignore", "pipe"] });
     let stderr = "";
     child.stderr.on("data", (chunk) => stderr += chunk.toString());
     child.on("error", (err) => reject(new Error(`failed to launch ${cmd}: ${err.message}`)));
     child.on("close", (code) => {
-      if (code === 0) resolve23();
+      if (code === 0) resolve24();
       else reject(new Error(`${cmd} exited with code ${code}: ${stderr.trim()}`));
     });
     child.stdin.end(text, "utf8");