agentlas 1.0.11 → 1.0.14

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## 1.0.14 — 2026-07-29
+
+- **Write-capable commands now prepare every project automatically.** The first
+  `run`, `storm`, `swarm`, or workforce execution in any folder installs the
+  same private, merge-only Agentlas project infrastructure through Core. This
+  is based on the folder the user opened, not on the Agentlas source checkout.
+  Read-only commands remain passive and do not create files.
+- **Per-command help works before database startup.** Commands such as
+  `agentlas run --help` and `agentlas workforce --help` no longer require an
+  SQLite driver or open the project database just to print usage.
+
+## 1.0.13 — 2026-07-28
+
+- **MCP servers reach the chat again.** `runNativeTurn` only injects them at
+  `full` permission and that gate was right, but `sessions/session.cjs` never
+  put `mcpServers` in the request — zero callers — so no CLI ever received a
+  server. `agentlas mcp probe` printed "connected" while the turn that followed
+  could not use it. Turns now carry servers the user already consented to;
+  nothing new is asked mid-turn, because a turn is not a place a user can answer.
+- **The shared database stops taking a write lock every turn.** Four
+  `CREATE TABLE IF NOT EXISTS`, five indexes and an `ALTER TABLE` ran on every
+  single turn against the file Desktop also uses. All idempotent, all taking the
+  lock; during a Desktop migration that burns the 15s busy timeout and every
+  call site swallowed the failure. Schema repair is once per connection now, and
+  the three copies of `ensureMemoryContextColumn` are one function.
+- **Rows written here are checked for referential integrity.** `foreign_keys` is
+  a connection property, not a file property — Desktop opened with it ON and the
+  terminal did not, so terminal writes skipped the check on shared tables.
+- **A zero-byte database file no longer blocks first run forever.** One stray
+  `sqlite3 <missing-path>` left an empty file, and every run after that read
+  "already exists" and died on `no such table` with nothing visible to explain it.
+- **Bootstrap schema is current again** (v81; it was a v45 snapshot from
+  2026-07-07), and a mismatch with Desktop's migration target now fails a gate.
+- **An engine update landing mid-run cannot mix two releases.** Core roots
+  resolve to their real path, so a long run keeps the modules it started with.
+  The next call still picks up the new release.
+- `/ontology` says what it manages — this project's knowledge sources, not the
+  engine's knowledge runtime. The command itself is unchanged.
+
+## 1.0.12 — 2026-07-28
+
+- **Orchestrator/worker model roles now resolve from ordered candidate
+  pools.** The shared `model_role_members` table (Desktop schema v80) holds
+  n candidates per role in priority order; the terminal picks the first
+  member that is actually executable here, records every skipped member
+  with its reason, and never silently substitutes a lower-priority runtime
+  when all members are unavailable — the head member is used and the skip
+  list is preserved. An empty worker pool inherits the orchestrator pool,
+  matching the single-row inherit contract, and databases without pools
+  keep resolving through the v79 single-row and legacy `active_runtime`
+  ladders unchanged.
+- **Workforce escalation is bounded and receipted end to end.** A worker
+  that violates the handoff output contract twice — or is named in two
+  consecutive verifier failures — gets exactly one orchestrator-role
+  retry, stamped with `escalated-after-failure`, the failure count, and
+  the attempt number; a failing escalation stops honestly instead of
+  looping or downgrading.
+- **BYOK Anthropic calls mark the system prefix as a prompt-cache
+  breakpoint.** Real Anthropic endpoints receive the system prompt as one
+  `cache_control: ephemeral` block (~90% cheaper cached input on hits;
+  a silent no-op below the per-model minimum). Anthropic-compatible
+  endpoints (GLM/Kimi/DeepSeek) keep the plain string form they expect.
+- Model-allocation receipts split "no allocation was provided"
+  (`allocation_not_provided`) from "the allocation was malformed"
+  (`invalid_ai_allocation`), and real invocations now retain the
+  provider-reported token usage per role instead of discarding it.
+
 ## 1.0.11 — 2026-07-27
 
 - **The slash palette repaints in place instead of stacking copies of

package/README.md

@@ -110,9 +110,11 @@ agentlas connect <sub>           # Telegram 등 플랫폼 연결 (무인자는 u
 agentlas import <폴더>            # 로컬 에이전트/팀 임포트
 agentlas native prepare <agent>  # 네이티브 CLI 문맥 파일 생성
 agentlas list                    # 설치 에이전트/회사 + 활성 런타임
-agentlas uninstall <agent>       # 설치 에이전트 제거 (빌트인 거부)
+agentlas uninstall <agent> [--yes]  # 설치 에이전트 제거 (빌트인 거부).
+                                 # 대화 이력이 있으면 건수를 보여주고 --yes 없이는 거절한다
+                                 # (챗/메시지가 CASCADE로 함께 영구 삭제되기 때문).
 agentlas experience <sub>        # list|inspect|validate|save|publish|status|export|unpublish|withdraw
-agentlas variant resolve         # 로컬 variant 호환성 프리뷰 (권위 없음)
+agentlas variant resolve --base-release <id>   # 로컬 variant 호환성 프리뷰 (권위 없음, `agentlas variant help`)
 ```
 
 ### EXECUTE

package/bin/agentlas.cjs

@@ -117,9 +117,23 @@ function bootstrapDbIfMissing() {
   const dir = path.dirname(p);
   fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
   securePrivateMode(dir, 0o700);
+  // 존재 여부만 보면 **0바이트 파일이 부트스트랩을 영구히 막는다.** 실측 2026-07-28:
+  // `sqlite3 <없는경로> 'PRAGMA user_version;'` 같은 무해한 명령 하나가 빈 파일을 남기고,
+  // 그 뒤 모든 실행이 "이미 있음"으로 판단해 스키마 없이 진행하다 `no such table` 로
+  // 죽는다. 사용자에게는 원인이 전혀 안 보이는 상태다.
+  //
+  // SQLite 파일은 최소 한 페이지(512바이트)를 갖는다. 0바이트는 DB 가 아니라 자리만
+  // 잡힌 파일이므로 없는 것으로 취급해 정상 부트스트랩 경로를 태운다. 내용이 있는데
+  // 손상된 경우는 여기서 판단하지 않는다 — 그건 복구지 부트스트랩이 아니고, 멀쩡한
+  // DB 를 빈 것으로 오판해 덮어쓰는 위험이 훨씬 크다.
   if (exists(p)) {
-    securePrivateMode(p, 0o600);
-    return { created: false, path: p };
+    let empty = false;
+    try { empty = fs.statSync(p).size === 0; } catch { empty = false; }
+    if (!empty) {
+      securePrivateMode(p, 0o600);
+      return { created: false, path: p };
+    }
+    try { fs.rmSync(p, { force: true }); } catch { /* 지울 수 없으면 아래 link 가 EEXIST 로 알려준다 */ }
   }
   const schemaFile = path.join(PKG_ROOT, "engine", "bootstrap-schema.sql");
   if (!exists(schemaFile)) {
@@ -172,7 +186,7 @@ function main() {
   let error = null;
   if (!engineFound) {
     error = "Engine not found (engine/agentlas.cjs). Reinstall with: npm i -g agentlas";
-  } else if (!sqliteDriver) {
+  } else if (!sqliteDriver && !metadataOnly) {
     error = `Node ${process.version} — no SQLite driver. Upgrade to Node 22.5+ or reinstall with 'npm i -g agentlas' to build better-sqlite3.`;
   }
 

package/engine/agentlas-config.cjs

@@ -100,28 +100,35 @@ function mergePrefs(base, patch) {
   return next;
 }
 
+/*
+ * Throws on failure (lock timeout, read-only data dir, ENOSPC …) — it used to
+ * swallow every error and return null, so `agentlas setup` announced "All set."
+ * and exited 0 while the user's language/runtime/permission were never written.
+ * A caller that cannot persist must be able to say so; use savePrefs for the
+ * best-effort boolean contract.
+ */
 function updatePrefs(userDataDir, patch) {
-  try {
-    fs.mkdirSync(userDataDir, { recursive: true });
-    return withPrefsLock(userDataDir, () => {
-      const file = prefsPath(userDataDir);
-      const currentWasValid = Boolean(readPrefsFile(file));
-      const current = loadPrefs(userDataDir);
-      if (fs.existsSync(file) && !currentWasValid) {
-        try { fs.renameSync(file, `${file}.corrupt-${Date.now()}-${process.pid}`); } catch { /* recover from backup */ }
-      }
-      const next = mergePrefs(current, patch);
-      if (currentWasValid) atomicWrite(backupPath(userDataDir), current);
-      atomicWrite(file, next);
-      return next;
-    });
-  } catch {
-    return null;
-  }
+  fs.mkdirSync(userDataDir, { recursive: true });
+  return withPrefsLock(userDataDir, () => {
+    const file = prefsPath(userDataDir);
+    const currentWasValid = Boolean(readPrefsFile(file));
+    const current = loadPrefs(userDataDir);
+    if (fs.existsSync(file) && !currentWasValid) {
+      try { fs.renameSync(file, `${file}.corrupt-${Date.now()}-${process.pid}`); } catch { /* recover from backup */ }
+    }
+    const next = mergePrefs(current, patch);
+    if (currentWasValid) atomicWrite(backupPath(userDataDir), current);
+    atomicWrite(file, next);
+    return next;
+  });
 }
 
 function savePrefs(userDataDir, prefs) {
-  return Boolean(updatePrefs(userDataDir, prefs));
+  try {
+    return Boolean(updatePrefs(userDataDir, prefs));
+  } catch {
+    return false;
+  }
 }
 
 module.exports = { prefsPath, loadPrefs, savePrefs, updatePrefs, mergePrefs };

package/engine/agentlas-core-harness.cjs

@@ -84,7 +84,20 @@ function resolveCoreRuntimeRootFromCandidates(candidateRoots, requiredMarkers =
         const version = readCoreRuntimeVersion(root);
         if (!version || compareSemVer(version, minVersion) < 0) continue;
       }
-      return root;
+      // `~/.agentlas/runtime/current` 는 업데이터가 원자적으로 갈아 끼우는 심볼릭
+      // 링크다. 그 경로를 그대로 넘기면 Python 이 import 를 늦게 해석하는 특성상,
+      // 긴 실행 도중 업데이트가 일어나면 **옛 버전 모듈과 새 버전 모듈이 한 프로세스에
+      // 섞여 로드된다** — 어떤 버전에서도 시험된 적 없는 조합이고 버전 번호로는
+      // 재현조차 못 한다(감사 D3).
+      //
+      // 실경로로 고정해도 라이브 버전 선택은 그대로다: **다음** 호출이 다시 해석해
+      // 새 릴리스를 집는다. 없어지는 것은 실행 중 교체뿐이다.
+      try {
+        return fs.realpathSync(root);
+      } catch {
+        // 링크를 읽을 수 없다고 실행을 거부할 이유는 없다 — 이전 동작대로 경로를 쓴다.
+        return root;
+      }
     } catch {
       // Continue to the next installed/bundled root.
     }

package/engine/agentlas-i18n.cjs

@@ -260,6 +260,7 @@ const STRINGS = {
     "wiz.default": "(Enter default)",
     "wiz.invalid": "Choose 1–%s.",
     "wiz.saved": "All set. You can change any of this later with /runtime, /permission.",
+    "wiz.saveFailed": "Could not save your choices (%s) — they apply to this session only, and setup will ask again next launch.",
     "wiz.changeLang": "Tip: re-run setup anytime with  agentlas setup",
   },
   ko: {
@@ -505,6 +506,7 @@ const STRINGS = {
     "wiz.default": "(Enter 기본값)",
     "wiz.invalid": "1–%s 중 고르세요.",
     "wiz.saved": "완료. 나중에 /runtime, /permission으로 언제든 바꿀 수 있어요.",
+    "wiz.saveFailed": "선택을 저장하지 못했습니다 (%s) — 이번 세션에만 적용되고, 다음 실행 때 다시 물어봅니다.",
     "wiz.changeLang": "팁: 언제든  agentlas setup  으로 다시 설정",
   },
 };

package/engine/agentlas-input.cjs

@@ -298,7 +298,7 @@ const SLASH_COMMAND_META = [
   { command: "/route", description: "Preview which agent/pipeline would take a request", category: "Engine", usage: "/route <request>", detail: "Runs the Hephaestus router without executing — shows the selected agent, candidates, and reasons." },
   { command: "/research", description: "Run the Hephaestus Research Engine", category: "Engine", usage: "/research search \"query\"", detail: "status|gather|search|read|plan — evidence-grade web research from the terminal." },
   { command: "/search", description: "Discover agents in the Hub", category: "Hub", usage: "/search <what you need>", detail: "Search the Agentlas Hub + local for an agent that fits the task (hep-search)." },
-  { command: "/install", description: "Install an agent from the Hub by slug", category: "Hub", usage: "/install <slug>", detail: "Install a marketplace agent into this terminal (hep-cloud)." },
+  { command: "/install", description: "Install an agent from the Hub by slug", category: "Hub", usage: "/install <slug>", detail: "Install a marketplace agent into this terminal." },
   { command: "/network", description: "Staff and execute an ontology-grounded task force", category: "Engine", usage: "/network <request> [--benchmark]", detail: "The active top host LLM creates the work order, searches the Hub workforce ontology, selects exact releases, and executes a receipt-backed task force.", aliases: ["/taskforce", "/workforce"] },
   { command: "/legacy-network", description: "Run the compatibility Hephaestus network route", category: "Engine", usage: "/legacy-network <request>", detail: "Explicit compatibility escape hatch; never used as a fallback by /network." },
   { command: "/browser", description: "Real browser execution hardpoint", category: "Engine", usage: "/browser [sub]", detail: "Runs the Agentlas browser hardpoint (hep-browser)." },
@@ -582,6 +582,7 @@ function attachSlashPalette(rl, opts = {}) {
     selected: 0,
     selectedCommand: null,
     visible: false,
+    navigated: false,
     dismissedForLine: null,
   };
 
@@ -596,8 +597,23 @@ function attachSlashPalette(rl, opts = {}) {
     return rows().length > 0 && state.dismissedForLine !== (rl.line || "");
   }
   function replaceLine(value) {
+    const next = String(value || "");
+    /*
+     * keypress 리스너 안에서 rl.write(Ctrl-U) → rl.write(text)를 재진입시키면
+     * Node readline의 원래 Tab/Enter 핸들러가 아직 같은 키를 처리하는 중이라
+     * 기존 `/s` 뒤에 선택값을 붙였다(`/s/team`, `/s/skills` 실측). line/cursor는
+     * readline의 공개 관측 상태이고 `_refreshLine`은 그 상태를 그리는 유일한
+     * 부수효과라, 한 번에 교체해 재진입을 피한다. 구형 Node만 기존 키 시퀀스로
+     * 폴백한다.
+     */
+    if (typeof rl._refreshLine === "function") {
+      rl.line = next;
+      rl.cursor = next.length;
+      rl._refreshLine();
+      return;
+    }
     rl.write(null, { ctrl: true, name: "u" });
-    rl.write(value);
+    rl.write(next);
   }
   /*
    * 커서 복원은 상대 이동으로만 한다.
@@ -644,8 +660,19 @@ function attachSlashPalette(rl, opts = {}) {
     });
     if (!body) { clear(); return; }
     const lines = body.split("\n");
-    // 첫 줄바꿈은 프롬프트 아래로 내려가며, 자리가 없으면 여기서 화면이 한 번 밀린다.
-    // 그린 만큼 그대로 되올라오므로 이후 갱신은 제자리에서 일어난다.
+    /*
+     * 첫 줄바꿈은 프롬프트 아래로 내려가며, 자리가 없으면 여기서 화면이 한 번 밀린다.
+     * 그린 만큼 그대로 되올라오므로 이후 갱신은 제자리에서 일어난다.
+     *
+     * 복귀 후에는 커서 열만 맞춘다. readline 의 prompt(true) 로 프롬프트 줄을 다시
+     * 그리면 refreshLine 이 커서 아래를 지워 방금 그린 프레임까지 함께 날아간다
+     * (실측: 리사이즈 없이도 팔레트가 통째로 사라짐). 프롬프트 줄 자체는 지운 적이
+     * 없으므로 평상시에는 화면에 그대로 남아 있다.
+     *
+     * 남은 한계: 창 크기를 줄이면 터미널이 프롬프트 줄을 리플로우하며 지울 수 있고,
+     * 그때는 다음 입력 전까지 프롬프트가 보이지 않는다(40행→18행 축소에서 실측).
+     * 팔레트는 리사이즈를 구독하지 않는다.
+     */
     stream.write(`\r\n\x1b[0J${lines.join("\r\n")}\x1b[${lines.length}A\x1b[${promptColumn()}G`);
     state.visible = true;
   }
@@ -667,6 +694,7 @@ function attachSlashPalette(rl, opts = {}) {
     if (!list.length) return false;
     state.selected = (state.selected + delta + list.length) % list.length;
     state.selectedCommand = list[state.selected].command;
+    state.navigated = true;
     const query = rl.line || "";
     setImmediate(() => {
       if ((rl.line || "") !== query) replaceLine(query);
@@ -695,12 +723,38 @@ function attachSlashPalette(rl, opts = {}) {
       move(name === "down" ? 1 : -1);
       return;
     }
-    // Shift-Tab 은 팔레트 확정 키가 아니다 — 호출자(REPL)의 권한 순환 단축키다.
-    // 여기서 select() 하면 한 번의 Shift-Tab 이 줄 내용까지 바꿔 버린다.
-    if (active() && ((name === "tab" && !key.shift) || name === "return")) {
-      select();
+    // Tab 은 완성이다 — 강조된 항목으로 줄을 채운다.
+    // Shift-Tab 은 팔레트 확정 키가 아니다(호출자 REPL 의 권한 순환 단축키다).
+    if (active() && name === "tab" && !key.shift) {
+      if (select()) {
+        /*
+         * prependListener는 readline 자체 Tab 처리를 중단시키지 못한다. 선택을 먼저
+         * 반영한 뒤, 기본 완성기가 같은 키로 줄을 다시 바꿔도 다음 tick에 exact
+         * 선택을 한 번 재적용한다.
+         */
+        const selected = state.selectedCommand;
+        setImmediate(() => {
+          if (selected) replaceLine(selected);
+        });
+      }
+      return;
+    }
+    /*
+     * Enter 는 사용자가 실제로 목록을 훑었을 때만 강조 항목을 확정한다.
+     *
+     * 예전에는 팔레트가 떠 있기만 하면 Enter 가 무조건 select() 를 불렀고,
+     * 훑은 적이 없으면 state.selected 는 0이라 "목록 첫 줄"이 대신 실행됐다.
+     * `/s`(활성 세션 전환)를 치고 Enter 하면 `/sessions` 가 돌아간다 — 친 것과
+     * 다른 명령이 실행되는 것이다(pty 실측). 게다가 피해 대상은 팔레트 정렬의
+     * 함수라, 명령 목록을 손볼 때마다 어떤 명령이 가로채이는지가 조용히 바뀐다.
+     */
+    if (active() && name === "return") {
+      if (state.navigated) select();
+      else clear();
       return;
     }
+    // 타이핑이 이어지면 "훑었다"는 사실은 무효가 된다 — 질의가 달라졌기 때문.
+    state.navigated = false;
     state.dismissedForLine = null;
     setImmediate(render);
   }

package/engine/agentlas-memory-governance.cjs

@@ -163,7 +163,17 @@ function tableExists(db, name) {
   }
 }
 
+// 커넥션당 1회. 이전에는 `beginTurn`/`listScopedTimeline` 이 부를 때마다, 즉 **매 턴**
+// 공유 DB 에 테이블 4개 + 인덱스 5개 DDL 과 `UPDATE … stale` 을 날렸다. 전부
+// IF NOT EXISTS 라 결과는 멱등이지만 쓰기 락을 잡는 것은 매번이었고, 데스크탑
+// 마이그레이션과 겹치면 15초 busy_timeout 을 소진했다(2026-07-28).
+const { ensureOnce } = require("./core/schema-ensure.cjs");
+
 function ensureGovernanceSchema(db) {
+  return ensureOnce(db, "terminal_memory.schema", (conn) => ensureGovernanceSchemaOnce(conn));
+}
+
+function ensureGovernanceSchemaOnce(db) {
   db.exec(`
     CREATE TABLE IF NOT EXISTS terminal_memory_turn_intents (
       turn_id TEXT PRIMARY KEY,

package/engine/agentlas-onboard.cjs

@@ -7,8 +7,13 @@ const i18n = require("./agentlas-i18n.cjs");
 const banner = require("./agentlas-banner.cjs");
 const { visWidth, wrapWidth } = require("./agentlas-composer.cjs");
 
-// req = { ui, rl, helpers }  → Promise<{ onboarded, lang, runtime, permission }>
-async function runOnboard({ ui, rl, helpers }) {
+/*
+ * req = { ui, rl, helpers, persist } → Promise<{ onboarded, saved, saveError, lang, runtime, permission }>
+ * `persist` writes the answers and must throw when it cannot. The wizard calls it
+ * itself, before announcing "All set." — the caller used to save afterwards, so a
+ * failed write (locked/read-only data dir) was announced as success and dropped.
+ */
+async function runOnboard({ ui, rl, helpers, persist }) {
   const H = helpers;
   const c = ui.c;
   const contentWidth = () => Math.max(20, (ui.out.columns || 80) - 5);
@@ -149,10 +154,22 @@ async function runOnboard({ ui, rl, helpers }) {
   const pi = await pickNum(permOpts.length);
   const permission = permOpts[pi - 1].v;
 
+    // Save first, then report what actually happened — never the other way round.
+    let saveError = null;
+    try {
+      if (typeof persist !== "function") throw new Error("no persistence handler");
+      await persist({ lang, runtime, permission });
+    } catch (error) {
+      saveError = error;
+    }
     ui.line("");
-    printSaved(ui.t("wiz.saved"));
-    printIndented(ui.t("wiz.changeLang"), c.faint);
-    return { onboarded: true, lang, runtime, permission };
+    if (saveError) {
+      ui.error(ui.t("wiz.saveFailed", String((saveError && saveError.message) || saveError)));
+    } else {
+      printSaved(ui.t("wiz.saved"));
+      printIndented(ui.t("wiz.changeLang"), c.faint);
+    }
+    return { onboarded: true, saved: !saveError, saveError, lang, runtime, permission };
   } finally {
     rl.removeListener("line", onLine);
     if (ownsSigint) rl.removeListener("SIGINT", onSigint);

package/engine/agentlas-sqlite-policy.cjs

@@ -6,15 +6,26 @@
 // fail immediately with SQLITE_BUSY even when busy_timeout is configured.
 const SQLITE_BUSY_TIMEOUT_MS = 15_000;
 
+// `foreign_keys` 는 파일이 아니라 **커넥션** 속성이다. 데스크탑은
+// `electron/store/db.ts` 에서 `foreign_keys = ON` 으로 열고, 터미널은 켜지 않아
+// **같은 테이블인데 터미널이 쓰는 행만 참조 무결성 검사를 건너뛰고 있었다**
+// (2026-07-28 확인). journal_mode 처럼 파일에 박히는 값이 아니라서 한쪽이 켠 것이
+// 다른 쪽에 전파되지 않는다. 스키마 소유는 데스크탑이므로 그 규칙을 그대로 따른다.
+const SQLITE_CONNECTION_PRAGMAS = [
+  `busy_timeout = ${SQLITE_BUSY_TIMEOUT_MS}`,
+  "foreign_keys = ON",
+];
+
 function configureSqliteConnection(db) {
   if (!db) throw new TypeError("SQLite connection is required");
-  if (typeof db.pragma === "function") {
-    db.pragma(`busy_timeout = ${SQLITE_BUSY_TIMEOUT_MS}`);
-  } else if (typeof db.exec === "function") {
-    db.exec(`PRAGMA busy_timeout = ${SQLITE_BUSY_TIMEOUT_MS}`);
-  } else {
-    throw new TypeError("SQLite connection must expose pragma() or exec()");
-  }
+  const applyPragma =
+    typeof db.pragma === "function"
+      ? (statement) => db.pragma(statement)
+      : typeof db.exec === "function"
+        ? (statement) => db.exec(`PRAGMA ${statement}`)
+        : null;
+  if (!applyPragma) throw new TypeError("SQLite connection must expose pragma() or exec()");
+  for (const statement of SQLITE_CONNECTION_PRAGMAS) applyPragma(statement);
   return db;
 }