agentlas 1.0.51 → 1.0.53

package/engine/commands/graph.cjs

@@ -547,7 +547,29 @@ async function runGraph(ctx, needle, flags) {
     }
   }
 
-  const core = ctx.desktopCore || desktopCore.loadDesktopCore();
+  /*
+   * ★엔진이 아직 없으면 **받아 온다**. npm 패키지는 실행 엔진을 담지 않고
+   *   매니페스트가 가리키는 자산에서 내려받는데(desktop-core-fetch), 그 길을
+   *   부르는 곳이 **한 군데도 없었다**. 만들어만 두고 배선하지 않은 것이다.
+   *
+   *   실측 2026-08-19: 갓 `npm i -g agentlas` 한 상태에서 `graph run` 이
+   *   "vendored Desktop Core is unavailable" 로 즉시 죽었다. 새로 설치한 사람은
+   *   자동화를 한 번도 못 돌린다 — 캐시가 비어 있고, 채울 길을 아무도 안 밟는다.
+   *
+   *   받는 동안은 조용하지 않다(onNotice) — 12MB 를 말없이 끌어오지 않는다.
+   */
+  let core = ctx.desktopCore || desktopCore.loadDesktopCore();
+  if (!core || core.error || typeof core.runGraph !== "function") {
+    try {
+      core = await desktopCore.loadDesktopCoreAsync({ onNotice: (message) => ctx.err(message) });
+    } catch (fetchError) {
+      ctx.err(JSON.stringify({
+        ok: false,
+        error: `graph-execution engine could not be fetched: ${fetchError instanceof Error ? fetchError.message : String(fetchError)}`,
+      }, null, 2));
+      return 1;
+    }
+  }
   if (!core || core.error || typeof core.runGraph !== "function") {
     const cause = core?.error instanceof Error ? core.error.message : "vendored Desktop Core is unavailable";
     ctx.err(JSON.stringify({ ok: false, error: cause }, null, 2));

package/engine/core/desktop-core.cjs

@@ -129,7 +129,16 @@ function installNativeModuleHook() {
   const Module = require("node:module");
   const terminalBetterSqlite3 = require("better-sqlite3"); // 터미널 ABI 로 빌드된 것
   let terminalKeytar = null;
-  try { terminalKeytar = require("keytar"); } catch { /* optionalDependency — 없을 수 있다 */ }
+  try {
+    terminalKeytar = require("keytar");
+    // ★훅은 require 를 가로채지만 resolve 는 못 가로챈다. 코어의 키체인 호스트는 자식
+    //   프로세스를 띄우려고 **경로**가 필요한데, 벤더 트리에는 keytar 가 일부러 없다
+    //   (아래 skip 목록). 그래서 우리 것의 실물 경로를 봉투에 담아 넘긴다.
+    //   실측 2026-08-20: 이게 없으면 `Cannot find module 'keytar'` 로 노드가 죽었다.
+    if (!process.env.AGENTLAS_KEYTAR_PATH) {
+      process.env.AGENTLAS_KEYTAR_PATH = require.resolve("keytar");
+    }
+  } catch { /* optionalDependency — 없을 수 있다 */ }
   const electronShim = makeElectronShim();                 // electron 없이 코어를 돌리는 셰임
   const orig = Module._load;
   Module._load = function (request, parent, isMain) {

package/engine/graph/interview.cjs

@@ -198,6 +198,12 @@ const RULES = [
   "    the expected fields' / 'the row was appended with the submitted values'. If the outside",
   "    result genuinely cannot be re-observed, say so in the step instruction rather than",
   "    skipping the check.",
+  "  · A value a branch tests for emptiness (op truthy/falsy) MUST NOT also carry a check",
+  "    that demands it be non-empty. Threshold watchers are the common case: on a day the",
+  "    threshold is not crossed the value is correctly empty, and a check demanding content",
+  "    fails the run on exactly the days nothing was supposed to happen. Put that check",
+  "    INSIDE the branch that has the value, or check the comparison step's own report",
+  "    (both rates read, threshold applied) instead of the alert text.",
   "  · repeatOn says which side loops. Write the condition the way the person said it and",
   "    put the loop on the side they meant — do not flip either one to make it fit.",
   "",
@@ -557,6 +563,42 @@ function validateBlueprint(bp, ctx = {}) {
     }
   }
 
+  /*
+   * ★"비어 있을 수 있다"고 갈림길이 말한 값에 "비어 있으면 안 된다" 검증을 걸면 평상시마다
+   *   실패한다(실측 2026-08-19: 임계값 미달인 날 alertline 이 정당하게 비어 NODE_INPUT_MISSING).
+   *   정본은 데스크탑 shared/graph-blueprint.ts — 이 파일은 손복사본이고 패리티 게이트가 지킨다.
+   */
+  const emptinessTestedVars = new Set(
+    (bp.branches || [])
+      .filter((branch) => branch.op === "truthy" || branch.op === "falsy")
+      .map((branch) => String(branch.var || "").trim())
+      .filter(Boolean),
+  );
+  for (const check of bp.checks || []) {
+    const subject = String(check.subject || "").trim();
+    if (!subject || !emptinessTestedVars.has(subject)) continue;
+    const branch = (bp.branches || []).find((b) => String(b.var || "").trim() === subject);
+    if (!branch) continue;
+    // 위치를 본다 — 갈림길 뒤 값-있는 쪽의 검증은 비는 날 아예 안 돌므로 문제가 아니다.
+    const at = typeof check.afterStep === "number" ? check.afterStep : -1;
+    const runsBeforeTheBranchDecides = at <= (branch.afterStep ?? 0);
+    const sitsOnTheEmptySide = typeof branch.noStep === "number" && at === branch.noStep;
+    if (!runsBeforeTheBranchDecides && !sitsOnTheEmptySide) continue;
+    const yesStep = typeof branch.yesStep === "number" ? branch.yesStep : null;
+    // 사람에게 묻지 않는다 — 모양이 틀린 것이고 고치는 법이 하나로 정해진다.
+    push(
+      `"${subject}"은(는) 갈림길이 비어 있을 수 있다고 말하는 값인데, 그 앞의 검증이 비어 있지 않기를 요구합니다. `
+      + "임계값 감시처럼 '알릴 것이 없는 날'이 정상인 자동화는 그 날마다 실패합니다. "
+      + `검증을 지우지 말고 **값이 있는 쪽에서만 돌게** 옮기세요: 이 검증의 afterStep 을 `
+      + (yesStep !== null
+        ? `갈림길의 yes 쪽 단계(${yesStep})나 그 뒤 단계로 바꾸면 됩니다.`
+        : "갈림길의 yes 쪽 단계나 그 뒤 단계로 바꾸면 됩니다.")
+      + ` 값이 비었는지 자체를 확인하고 싶다면, "${subject}"을(를) 만든 비교 단계가 `
+      + "무엇을 읽고 어떤 임계값을 적용했는지 보고하게 하고 그 보고를 subject 로 삼으세요 "
+      + "— 그 보고는 알릴 것이 없는 날에도 비지 않습니다.",
+    );
+  }
+
   for (const branch of bp.branches || []) {
     const at = `${(branch.afterStep ?? 0) + 1}번째 단계 뒤의 갈림길`;
     if (!steps[branch.afterStep]) { push(`${at}가 없는 단계를 가리킵니다.`); continue; }

package/engine/vendor/desktop-core.manifest.json

@@ -1,7 +1,7 @@
 {
-  "version": "4",
-  "url": "https://github.com/agentlas-ai/agentlas-terminal/releases/download/desktop-core-v4/desktop-core.tar.gz",
-  "sha256": "105efb6c3daea6f40f5d4719533c8fd2fc75a1e151fbe524041e0edeb3f77458",
-  "sizeBytes": 12530059,
-  "writtenAt": "2026-08-19T13:04:26.175Z"
+  "version": "6",
+  "url": "https://github.com/agentlas-ai/agentlas-terminal/releases/download/desktop-core-v6/desktop-core.tar.gz",
+  "sha256": "e93020895d21a7c3484ee22fb7008b7ffcad65ff7c276de7f531c3dd016c7f0c",
+  "sizeBytes": 12534557,
+  "writtenAt": "2026-08-19T16:22:09.603Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.51",
+  "version": "1.0.53",
   "description": "Agentlas project terminal — run project controllers and task-scoped agent teams from the terminal. Standalone: no desktop app process required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"
@@ -11,7 +11,9 @@
     "test:release-contracts": "npm run smoke",
     "sync:architecture": "node scripts/sync-architecture-from-desktop.cjs",
     "vendor:core": "node scripts/vendor-desktop-core.cjs",
-    "test:tool-access-notice-parity": "node test/tool-access-notice-parity.cjs"
+    "test:tool-access-notice-parity": "node test/tool-access-notice-parity.cjs",
+    "verify:engine-reachable": "node scripts/verify-engine-reachable.cjs",
+    "prepublishOnly": "npm run verify:engine-reachable"
   },
   "engines": {
     "node": ">=20.19"