agentlas 1.0.48 → 1.0.50

package/engine/core/store-schema.cjs

@@ -0,0 +1,119 @@
+"use strict";
+/*
+ * core/store-schema — 공유 저장소의 **스키마 버전 계약**. 터미널은 읽기만 한다.
+ *
+ * ★단일 마이그레이션 권위 (Phase 0, docs/DAEMON-ARCHITECTURE-DESIGN-2026-08-18.md §2/§6).
+ *
+ * `~/Library/Application Support/Agentlas/agentlas.sqlite` 는 락 없는 다중 쓰기 파일인데
+ * 마이그레이션 주인이 **둘**이었다:
+ *   1) 데스크탑의 사다리(electron/store/db.ts SCHEMA_VERSION),
+ *   2) 그 사다리를 그대로 다시 도는 터미널의 벤더 코어 경로(core/desktop-core.cjs initStore).
+ * 그리고 터미널의 가벼운 드라이버(core/db.cjs)는 user_version 을 **읽지도 않으면서** 쓰기
+ * 트랜잭션(seedBuiltins → BEGIN IMMEDIATE)을 열었다. 즉 "검사 없음 + 거절 없음 + 쓰기 있음".
+ *
+ * 이제 규칙은 하나다: **터미널은 절대 승급하지 않는다.** 파일이 이 배포가 아는 버전보다
+ * 낮으면 조용히 진행하지도, 몰래 마이그레이션하지도 않고 **정직하게 거절**한다.
+ *
+ * 왜 "없으면 터미널이 주인" 이 아닌가: 데스크탑의 부재는 경합 없이 관측할 수 없다 —
+ * 터미널이 사다리를 도는 도중에 데스크탑이 켜질 수 있다. 잘못 추측한 비용은 117MB 저장소
+ * 손상(db.ts 의 run_events 사고 주석)이고, 거절의 비용은 데스크탑 한 번 실행이다.
+ *
+ * 기대 버전의 출처: 이 패키지가 함께 배포하는 engine/bootstrap-schema.sql 의
+ * `PRAGMA user_version=` 이 곧 "이 배포가 아는 사다리 머리"다. 그 파일은 데스크탑 사다리를
+ * 빈 DB 에 끝까지 돌려 생성한 것이므로(scripts/gen-bootstrap-schema.cjs) 손으로 맞출 숫자가
+ * 따로 없다 — 재생성하면 자동으로 같이 움직인다.
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+
+const BOOTSTRAP_SCHEMA_FILE = path.join(path.dirname(__dirname), "bootstrap-schema.sql");
+
+let _expected;
+
+/** 이 배포가 아는 스키마 버전. 부트스트랩 SQL 헤더에서 읽는다(정본은 데스크탑 사다리). */
+function expectedStoreSchemaVersion() {
+  if (_expected !== undefined) return _expected;
+  let header = "";
+  try {
+    const fd = fs.openSync(BOOTSTRAP_SCHEMA_FILE, "r");
+    try {
+      const buf = Buffer.alloc(4096);
+      const read = fs.readSync(fd, buf, 0, buf.length, 0);
+      header = buf.slice(0, read).toString("utf8");
+    } finally {
+      fs.closeSync(fd);
+    }
+  } catch {
+    header = "";
+  }
+  const match = /PRAGMA\s+user_version\s*=\s*(\d+)/i.exec(header);
+  // 부트스트랩 SQL 을 못 읽으면 기대 버전을 **모른다**. 0 은 "검사 불가"를 뜻하고,
+  // 아래 단언은 그때 통과시킨다 — 모르는 것을 근거로 사용자를 막지 않는다.
+  _expected = match ? Number(match[1]) : 0;
+  return _expected;
+}
+
+/** 열린 커넥션의 user_version. 못 읽으면 null(모름). */
+function readStoreSchemaVersion(db) {
+  try {
+    if (typeof db.pragma === "function") {
+      const value = db.pragma("user_version", { simple: true });
+      return Number.isFinite(Number(value)) ? Number(value) : null;
+    }
+    const row = db.prepare("PRAGMA user_version").get();
+    if (!row) return null;
+    const value = row.user_version ?? Object.values(row)[0];
+    return Number.isFinite(Number(value)) ? Number(value) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 정직하고 실행 가능한 거절문. 두 가지 해결책을 모두 이름으로 말한다. */
+function storeSchemaRefusalMessage(found, expected, file) {
+  return [
+    `Agentlas store schema is v${found}, but this Agentlas CLI needs v${expected}.`,
+    `Store: ${file}`,
+    "The Agentlas CLI never migrates the shared database — the Desktop app owns the migration ladder,",
+    "and a second migrator on this lock-free file is how the store was corrupted before.",
+    "",
+    "Fix it once, either way:",
+    "  • Launch (or update) the Agentlas Desktop app once, then re-run this command.",
+    "  • No Desktop app on this machine? Close every Agentlas process, then run this command once with",
+    "    AGENTLAS_STORE_MIGRATION_ROLE=owner set, so the upgrade is a deliberate act rather than a race.",
+  ].join("\n");
+}
+
+class StoreSchemaTooOldError extends Error {
+  constructor(found, expected, file) {
+    super(storeSchemaRefusalMessage(found, expected, file));
+    this.name = "StoreSchemaTooOldError";
+    this.code = "AGENTLAS_STORE_SCHEMA_TOO_OLD";
+    this.found = found;
+    this.expected = expected;
+    this.file = file;
+  }
+}
+
+/**
+ * 공유 저장소를 이 프로세스가 써도 되는가.
+ * 낮으면 던진다. 같거나 높으면 통과 — 더 높은 것은 데스크탑이 앞서간 것이고, 터미널은
+ * columnExists 기반 방어적 읽기로 전진 호환한다(기존 계약 유지).
+ */
+function assertStoreSchemaCompatible(db, file) {
+  const expected = expectedStoreSchemaVersion();
+  if (!expected) return; // 기대 버전을 모르면 막지 않는다.
+  const found = readStoreSchemaVersion(db);
+  if (found === null) return; // 읽을 수 없으면 판단하지 않는다(가짜 거절 금지).
+  if (found >= expected) return;
+  throw new StoreSchemaTooOldError(found, expected, file);
+}
+
+module.exports = {
+  BOOTSTRAP_SCHEMA_FILE,
+  StoreSchemaTooOldError,
+  assertStoreSchemaCompatible,
+  expectedStoreSchemaVersion,
+  readStoreSchemaVersion,
+  storeSchemaRefusalMessage,
+};

package/engine/graph/interview.cjs

@@ -184,6 +184,20 @@ const RULES = [
   "    the fact (kind:\"code\" or a read step with uses) into its own produces, then set the",
   "    check's evidence:\"<that name>\". The check then compares result against evidence.",
   "    Only ask when the goal itself is too vague to know what the result even is.",
+  "  · MUTATION RESULT — verify it landed, not that the model said so (REQUIRED for every",
+  "    effect:\"mutation\" step that acts on the outside world — posting, sending, saving,",
+  "    updating). A run that writes \"posted 3 replies\" has not posted anything; only an",
+  "    INDEPENDENT observation of the outside world proves it. So the mutation step must",
+  "    produce the identifiers needed to observe its result (the posted URLs/ids, the file",
+  "    path, the updated row id) — put that in its produces. Then add, AFTER it, a read step",
+  "    (effect:\"read\") that RE-OBSERVES the result from the outside — a fresh look, not the",
+  "    mutation's own report: open each returned URL, re-read the saved file, re-fetch the",
+  "    updated row — into its own produces. Then add a check whose subject is the mutation's",
+  "    result and whose evidence is that observation, with must-items like 'each posted item",
+  "    exists at its URL with the expected author and text' / 'the file exists and contains",
+  "    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.",
   "  · 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.",
   "",
@@ -480,6 +494,57 @@ function validateBlueprint(bp, ctx = {}) {
     });
   }
 
+  /*
+   * ★바깥을 바꾼 mutation의 **결과**는 독립 재조회로 확인해야 한다(입력이 아니라 결과).
+   *
+   * 위 블록은 mutation이 **소비하는 입력값**을 검증하게 한다(게시할 목록이 채워졌나).
+   * 하지만 "게시가 실제로 됐나"는 그것으로 답이 안 된다 — 모델이 "게시 완료"라고 써도
+   * 바깥에는 아무것도 없을 수 있다(실측 2026-08-19: X 자동화가 두 런타임에서 4/4로 끝나며
+   * "3건 게시"라고 적었지만 X엔 0건). 결과가 실제로 반영됐는지는 **바깥을 다시 관측한
+   * 근거**로만 판정된다.
+   *
+   * 데스크탑 정본(shared/graph-blueprint.ts)과 같은 규칙 — 플러그인(hep-graph)으로 만든
+   * 자동화도 같은 보장을 받아야 한다. 두 입구가 다른 그래프를 만들면 안 된다.
+   */
+  {
+    const resultChecks = new Map();
+    for (const check of bp.checks || []) {
+      const subj = (check.subject || "").trim();
+      if (subj) resultChecks.set(subj, check);
+    }
+    steps.forEach((step, index) => {
+      if (step.effect !== "mutation") return;
+      const result = String(step.produces || "").trim();
+      if (!result) {
+        push(
+          `"${step.title || `${index + 1}번째 단계`}"는 바깥을 바꾸는데 결과값(produces)이 없습니다. `
+          + `무엇이 반영됐는지(게시된 URL·저장된 경로·갱신된 행 id 등)를 produces로 내보내야 `
+          + `그 결과가 실제로 일어났는지 확인할 수 있습니다.`,
+        );
+        return;
+      }
+      const check = resultChecks.get(result);
+      const hasEvidence = !!check && !!String((check && check.evidence) || "").trim();
+      if (!hasEvidence) {
+        const madeBy = steps.findIndex(
+          (s, i) => i > index && s.effect === "read"
+            && (Array.isArray(s.consumes) ? s.consumes : []).map((v) => String(v).trim()).includes(result),
+        );
+        const evName = `${result}_observed`;
+        push(
+          `"${step.title || `${index + 1}번째 단계`}"는 바깥을 바꿨지만, 그 결과가 실제로 반영됐는지 `
+          + `**독립적으로 다시 관측해** 확인하는 검증이 없습니다. 모델이 "완료"라고 써도 바깥은 그대로일 수 `
+          + `있습니다. 단계를 지우지 말고: (1) 이 단계 뒤에 결과를 바깥에서 다시 보는 read 단계`
+          + `(게시 URL 열기·파일 다시 읽기·행 재조회)를 두어 그 관측을 "${evName}"으로 내보내고, `
+          + `(2) top-level checks[]에 {"afterStep":${madeBy >= 0 ? madeBy : index + 1},"subject":"${result}",`
+          + `"criteria":"${result}이(가) 바깥에 실제로 반영됐다","evidence":"${evName}",`
+          + `"produces":"${result}_ok","items":[{"text":"관측된 결과가 반영하려던 것과 일치한다","kind":"must"},`
+          + `{"text":"관측되지 않았거나 지어낸 확인이 아니다","kind":"mustNot"}]} 를 추가하세요.`,
+        );
+      }
+    });
+  }
+
   // 반복이 있는데 검증이 없으면 "마음에 들 때까지"를 글자 찾기로 흉내 내게 된다(실측).
   for (const branch of bp.branches || []) {
     if (branch.repeatStep === undefined) continue;
@@ -634,7 +699,17 @@ function humanSchedule(schedule, locale) {
 
 function hhmm(hour, minute, locale) {
   if (locale !== "ko") return `${hour}:${minute}`;
-  return `${hour}:${minute}`;
+  /*
+   * ★한국어는 사람이 말하는 대로 — "오전 8시", "오후 6시 30분" (오너 결정 2026-08-19).
+   *   정본은 데스크탑 shared/schedule-describe.ts 의 koClock 이고, 이 파일은 그 손복사본이다
+   *   (test/graph-interview-parity.cjs 가 두 벌이 갈리는 순간 실패한다).
+   */
+  const h = Number(hour);
+  const m = Number(minute);
+  if (!Number.isFinite(h) || !Number.isFinite(m)) return `${hour}:${minute}`;
+  const half = h < 12 ? "오전" : "오후";
+  const display = h % 12 === 0 ? 12 : h % 12;
+  return m === 0 ? `${half} ${display}시` : `${half} ${display}시 ${m}분`;
 }
 
 const DOW_KO = { "0": "일", "1": "월", "2": "화", "3": "수", "4": "목", "5": "금", "6": "토", "7": "일" };

package/engine/graph/vocabulary.generated.cjs

@@ -7,7 +7,7 @@
 "use strict";
 
 const GRAPH_WIRE = "graph/1";
-const GRAPH_ERROR_CODES = ["APPROVAL_REQUIRED","APPROVAL_TIMED_OUT","ARCHITECT_NO_CHANGE","ARCHITECT_NO_REQUEST","ARCHITECT_OUTPUT_MALFORMED","ARCHITECT_OUTPUT_TOO_LARGE","ARCHITECT_OUTPUT_UNREADABLE","ARCHITECT_UNAVAILABLE","AUTOMATION_NOT_CONNECTED","BUDGET_EXHAUSTED","CODE_DEPENDENCY_MISSING","CODE_NODE_EMPTY","CODE_PRODUCED_NOTHING","CODE_STEP_FAILED","CREATE_INPUT_INVALID","EDGE_CONDITION_UNRESOLVED","EVAL_INCOMPLETE","EVAL_STUCK","EVAL_UNAVAILABLE","INTERVIEW_MODEL_UNAVAILABLE","INTERVIEW_OUTPUT_UNREADABLE","INTERVIEW_REPEATED_QUESTIONS","INTERVIEW_SELF_CORRECTION_EXHAUSTED","INTERVIEW_STATE_INVALID","LOOP_BOUND_INVALID","LOOP_BOUND_UNDECLARED","LOOP_LIMIT_REACHED","LOOP_WITHOUT_EXIT","MUTATION_UNVERIFIED","NODE_FAILED","NODE_INPUT_MISSING","NODE_NEVER_REACHED","NODE_NO_RESULT","NODE_TIMEOUT","NODE_TYPE_UNSUPPORTED","NO_MATCHING_EDGE","OUTPUT_NODE_EMPTY","PATCH_CODE_EMPTY","PATCH_EDGE_CONFLICT","PATCH_EDGE_DANGLING","PATCH_EDGE_HANDLE_MISSING","PATCH_EDGE_MISSING","PATCH_EMPTY","PATCH_LOOP_BOUND_MISSING","PATCH_NODE_CONFLICT","PATCH_NODE_MISSING","PATCH_NO_GRAPH","PATCH_OP_UNKNOWN","REDUCER_MERGE_CONFLICT","REDUCER_WRITE_CONFLICT","RESUME_CONFLICT","RUN_REQUEST_DISABLED","RUN_REQUEST_INPUT_REQUIRED","RUN_REQUEST_NOT_FOUND","RUN_REQUEST_QUEUE_UNAVAILABLE","RUN_REQUEST_REF_AMBIGUOUS","RUN_REQUEST_REF_MISSING","SUBGRAPH_DEPTH_EXCEEDED","SUBGRAPH_FAILED","SUBGRAPH_NOT_FOUND","SUBGRAPH_NO_RESULT","SUBGRAPH_SELF_CALL","SWAP_CAPABILITY_MISMATCH","SWAP_HUB_RELEASE_UNPINNED","SWAP_NODE_NOT_FOUND","SWAP_NOT_AGENT_NODE","SWAP_NO_MATCH","SWAP_UNKNOWN_PROVIDER","TOOL_BROKER_CALL_UNREADABLE","TOOL_BROKER_MUTATION_IN_SIMULATION","TOOL_BROKER_PLAN_UNREADABLE","TOOL_BROKER_TOOL_NOT_DECLARED","TOOL_NODE_UNATTACHED","TOOL_NODE_UNCONFIGURED","TRANSFORM_MODE_UNKNOWN","TRANSFORM_NODE_UNCONFIGURED"];
+const GRAPH_ERROR_CODES = ["APPROVAL_REQUIRED","APPROVAL_TIMED_OUT","ARCHITECT_NO_CHANGE","ARCHITECT_NO_REQUEST","ARCHITECT_OUTPUT_MALFORMED","ARCHITECT_OUTPUT_TOO_LARGE","ARCHITECT_OUTPUT_UNREADABLE","ARCHITECT_UNAVAILABLE","AUTOMATION_NOT_CONNECTED","BUDGET_EXHAUSTED","CODE_DEPENDENCY_MISSING","CODE_NODE_EMPTY","CODE_PRODUCED_NOTHING","CODE_STEP_FAILED","CREATE_INPUT_INVALID","EDGE_CONDITION_UNRESOLVED","EVAL_FAILED","EVAL_INCOMPLETE","EVAL_STUCK","EVAL_UNAVAILABLE","INTERVIEW_MODEL_UNAVAILABLE","INTERVIEW_OUTPUT_UNREADABLE","INTERVIEW_REPEATED_QUESTIONS","INTERVIEW_SELF_CORRECTION_EXHAUSTED","INTERVIEW_STATE_INVALID","LOOP_BOUND_INVALID","LOOP_BOUND_UNDECLARED","LOOP_LIMIT_REACHED","LOOP_WITHOUT_EXIT","MUTATION_UNVERIFIED","NODE_CLAIMED_WITHOUT_TOOLS","NODE_FAILED","NODE_INPUT_MISSING","NODE_NEVER_REACHED","NODE_NO_RESULT","NODE_TIMEOUT","NODE_TYPE_UNSUPPORTED","NO_MATCHING_EDGE","OUTPUT_NODE_EMPTY","PATCH_CODE_EMPTY","PATCH_EDGE_CONFLICT","PATCH_EDGE_DANGLING","PATCH_EDGE_HANDLE_MISSING","PATCH_EDGE_MISSING","PATCH_EMPTY","PATCH_LOOP_BOUND_MISSING","PATCH_NODE_CONFLICT","PATCH_NODE_MISSING","PATCH_NO_GRAPH","PATCH_OP_UNKNOWN","REDUCER_MERGE_CONFLICT","REDUCER_WRITE_CONFLICT","RESUME_CONFLICT","RUN_REQUEST_DISABLED","RUN_REQUEST_INPUT_REQUIRED","RUN_REQUEST_NOT_FOUND","RUN_REQUEST_QUEUE_UNAVAILABLE","RUN_REQUEST_REF_AMBIGUOUS","RUN_REQUEST_REF_MISSING","SUBGRAPH_DEPTH_EXCEEDED","SUBGRAPH_FAILED","SUBGRAPH_NOT_FOUND","SUBGRAPH_NO_RESULT","SUBGRAPH_SELF_CALL","SWAP_CAPABILITY_MISMATCH","SWAP_HUB_RELEASE_UNPINNED","SWAP_NODE_NOT_FOUND","SWAP_NOT_AGENT_NODE","SWAP_NO_MATCH","SWAP_UNKNOWN_PROVIDER","TOOL_BROKER_CALL_UNREADABLE","TOOL_BROKER_MUTATION_IN_SIMULATION","TOOL_BROKER_PLAN_UNREADABLE","TOOL_BROKER_TOOL_NOT_DECLARED","TOOL_NODE_UNATTACHED","TOOL_NODE_UNCONFIGURED","TRANSFORM_MODE_UNKNOWN","TRANSFORM_NODE_UNCONFIGURED"];
 const GRAPH_JOURNAL_KINDS = ["blob_externalized","node_failed","node_intent","node_reserved","node_retry","node_routed","node_settled","resumed","run_completed","run_created","run_failed","run_validated","suspended"];
 const GRAPH_NODE_KINDS = ["action","agent","code","condition","eval","output","subgraph","tool","transform","trigger"];
 const GRAPH_BLOCK_UI = {"trigger":{"section":"none","placeable":false,"placeReason":"그래프마다 하나뿐이고 처음 만들 때 함께 지어진다"},"agent":{"section":"inventory","placeable":true},"eval":{"section":"flow","placeable":true},"condition":{"section":"flow","placeable":true},"transform":{"section":"flow","placeable":true},"code":{"section":"flow","placeable":true},"tool":{"section":"inventory","placeable":true},"action":{"section":"actions","placeable":true},"output":{"section":"flow","placeable":true},"loop":{"section":"none","placeable":false,"placeReason":"노드가 아니라 되돌아가는 연결의 성질이다 — 엣지를 이어서 만든다"},"subgraph":{"section":"flow","placeable":true}};

package/engine/project/memory-context.cjs

@@ -123,6 +123,13 @@ function cliProjectContextSlice(projectPath, task) {
         "--task-stdin",
         "--no-refresh",
         "--render",
+        // Recall degrades to a labelled map, never to nothing. Core's passive
+        // freshness check walks the whole repository (measured 11.0s on the
+        // pilot) against this 4s timeout, and any non-zero exit is swallowed
+        // into "" below — so without a budget a large project silently lost
+        // its slice on every turn.
+        "--allow-stale",
+        "--freshness-budget", "0.4",
       ],
       {
         cwd: projectPath,

package/engine/runtimes/kinds.cjs

@@ -30,6 +30,43 @@ const RUNTIME_KIND_SPECS = [
 /** kind → 실행 파일 이름. CLI 런타임 전체(네이티브 + ACP). */
 const RUNTIME_BIN = Object.fromEntries(RUNTIME_KIND_SPECS.map((s) => [s.kind, s.bin]));
 
+/**
+ * 데스크탑이 **같은 DB 에 적어 둔 이름** → 이 저장소의 이름.
+ *
+ * ★터미널과 데스크탑은 하나의 SQLite 를 공유하는데 같은 런타임을 다르게 부른다:
+ *   데스크탑 `shared/runtime-kinds.ts` 는 `antigravity`, 여기는 `agy` 다. 그 차이는
+ *   주석에만 적혀 있었고 **읽는 자리에서 번역되지 않았다**.
+ *
+ *   결과(실측 2026-08-19): 사용자가 오케스트레이터를 Antigravity 로 골라 두면
+ *   `model_roles.kind = "antigravity"` 가 저장되는데, 터미널의 실행 가능 집합에는
+ *   그 이름이 없어 **"이 컴퓨터에서 실행 불가"로 걸러지고** 풀 3순위(codex)가 대신 돌았다.
+ *   `agentlas roles` 는 antigravity 라고 보여 주면서 그래프 빌더는 codex 로 지었다 —
+ *   고른 대로 안 도는데 화면은 고른 대로 보였다.
+ *
+ *   저장된 이름은 못 바꾼다(데스크탑이 계속 그렇게 쓴다). 그러니 **읽는 쪽이 번역한다**.
+ */
+const STORED_KIND_ALIASES = { antigravity: "agy" };
+
+/** 저장소에서 읽은 kind 를 이 저장소의 정본 이름으로. 모르는 값은 그대로 돌려준다. */
+function canonicalRuntimeKind(kind) {
+  const text = typeof kind === "string" ? kind.trim() : "";
+  if (!text) return text;
+  return STORED_KIND_ALIASES[text] ?? text;
+}
+
+/** 역방향 — 공유 DB 에 적을 이름. 어긋남은 **양쪽으로** 난다:
+ *  `agentlas roles set orchestrator agy` 가 `agy` 를 그대로 적으면, 이번에는
+ *  데스크탑이 그 이름을 모른다(shared/runtime-kinds.ts 에 `agy` 가 없다).
+ *  저장 어휘는 스키마 주인인 데스크탑 쪽으로 통일하고, 읽을 때 위에서 되돌린다. */
+const CANONICAL_TO_STORED = Object.fromEntries(
+  Object.entries(STORED_KIND_ALIASES).map(([stored, canonical]) => [canonical, stored]),
+);
+function storedRuntimeKind(kind) {
+  const text = typeof kind === "string" ? kind.trim() : "";
+  if (!text) return text;
+  return CANONICAL_TO_STORED[text] ?? text;
+}
+
 /** CLI 런타임 kind 전체(탐지 순서). */
 const CLI_KINDS = RUNTIME_KIND_SPECS.map((s) => s.kind);
 
@@ -71,6 +108,9 @@ const CONTRACT_RUNTIME_BACKENDS = [
 module.exports = {
   RUNTIME_KIND_SPECS,
   RUNTIME_BIN,
+  STORED_KIND_ALIASES,
+  canonicalRuntimeKind,
+  storedRuntimeKind,
   CLI_KINDS,
   NATIVE_CLI_KINDS,
   ACP_CLI_KINDS,

package/engine/runtimes/overrides.cjs

@@ -20,6 +20,7 @@ const {
   API_EXECUTABLE_KINDS,
 } = require("./resolve.cjs");
 const { pickRoleFromPool } = require("./roles.cjs");
+const { canonicalRuntimeKind } = require("./kinds.cjs");
 
 const OVERRIDE_TABLE = "agent_runtime_overrides";
 // 데스크탑 VALID_SCOPES 동형. v2 터미널 호출자는 주로 'agent'지만 firm/division도 읽을 수 있다.
@@ -38,7 +39,8 @@ function rowToOverride(row) {
     targetId: row.target_id,
     label: cleanText(row.label),
     selection: {
-      kind: String(row.kind),
+      // 저장된 이름(데스크탑 표기) → 이 저장소의 이름. kinds.cjs 참고.
+      kind: canonicalRuntimeKind(String(row.kind)),
       backend: cleanText(row.backend) || undefined,
       source: cleanText(row.source) || undefined,
       model: cleanText(row.model) || undefined,

package/engine/runtimes/roles.cjs

@@ -9,6 +9,7 @@
  * The worker may inherit upward for quality; the orchestrator never falls
  * downward to the worker row.
  */
+const { canonicalRuntimeKind } = require("./kinds.cjs");
 const { tableExists, columnExists } = require("../core/db.cjs");
 
 const MODEL_ROLE_TABLE = "model_roles";
@@ -49,7 +50,7 @@ function legacyOrchestrator(db) {
     }
     return {
       role: "orchestrator",
-      kind: cleanText(row.kind),
+      kind: canonicalRuntimeKind(cleanText(row.kind)),
       backend: cleanText(row.backend),
       source: cleanText(row.source),
       model: cleanText(row.model),
@@ -68,7 +69,8 @@ function normalizedRow(row, role) {
   if (!row || !cleanText(row.kind)) return null;
   return {
     role,
-    kind: cleanText(row.kind),
+    // 저장된 이름(데스크탑 표기)을 이 저장소의 이름으로 번역한다 — kinds.cjs 참고.
+    kind: canonicalRuntimeKind(cleanText(row.kind)),
     backend: cleanText(row.backend),
     source: cleanText(row.source),
     model: cleanText(row.model),

package/engine/workforce/capture.cjs

@@ -28,17 +28,10 @@ const { dbPath, userDataDir } = require("../core/paths.cjs");
 // 있지만 buildArgs/텍스트 추출 계약이 없으므로 캡처 검증 파생본만 쓴다 — 새 kind 를
 // 정본에 추가해도 capture:true 를 명시하기 전엔 여기 조용히 들어오지 않는다.
 const { CAPTURE_RUNTIME_BIN: RUNTIME_BIN } = require("../runtimes/kinds.cjs");
+const { readKeychainPassword } = require("../core/keychain-read.cjs");
 
 const SERVICE = "com.agentlas.desktop";
 
-function readKeytar() {
-  try {
-    return require("keytar");
-  } catch {
-    return null;
-  }
-}
-
 // v1 which 포팅: PATH + 알려진 설치 위치. detect.whichSync(spawn `which`)와 달리
 // 캡처 경로는 프로세스 spawn 없이 결정론적으로 실행 파일을 찾는다.
 function which(cmd) {
@@ -664,10 +657,11 @@ const ANTHROPIC_COMPAT_API = {
 const DEFAULT_CUSTOM_API_BASE_URL = "https://api.openai.com/v1";
 
 async function apiKey(backend) {
-  const keytar = readKeytar();
-  if (!keytar) return null;
-  // 키체인 접근 거부(서명 안 된 standalone Node)는 "키 없음"으로 조용히 처리.
-  return keytar.getPassword(SERVICE, "byok:" + backend).catch(() => null);
+  // ★거부가 아니라 **정지**가 실제 실패 모양이다. 예전에는 `.catch(() => null)` 하나로
+  //   "접근 거부는 키 없음" 이라 적어 두었는데, 화면 없는 호스트에서 keytar 는 거부하지 않고
+  //   영영 돌아오지 않는다(이벤트 루프째로). core/keychain-read 가 상한을 실제로 걸 수 있는
+  //   자식 프로세스에서 읽고, 못 읽으면 여기 계약대로 "키 없음"을 돌려준다.
+  return readKeychainPassword(SERVICE, "byok:" + backend);
 }
 
 // Custom BYOK 키가 전송될 origin 재검증: 공개 주소는 HTTPS만, HTTP는 localhost/LAN만.

package/engine/workforce/deps.cjs

@@ -523,6 +523,13 @@ function projectContextSlice(projectPath, task) {
         "--task-stdin",
         "--no-refresh",
         "--render",
+        // Recall degrades to a labelled map, never to nothing. Core's passive
+        // freshness check walks the whole repository (measured 11.0s on the
+        // pilot) against this 4s timeout, and any non-zero exit is swallowed
+        // into "" below — so without a budget a large project silently lost
+        // its slice on every turn.
+        "--allow-stale",
+        "--freshness-budget", "0.4",
       ],
       {
         cwd: projectPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.48",
+  "version": "1.0.50",
   "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"