agentlas 1.0.36 → 1.0.38

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 1.0.38 — 2026-08-11
+
+Silence was the worst failure mode — this release makes failures speak.
+
+- The presentation boundary (`Ui.error`) now has conditions. Machine-coded
+  messages (usage guidance, honest stops, server relays) pass through; only
+  uncoded raw provider text is still replaced by the neutral recovery line.
+  Previously every failure — including usage help for eight argless slash
+  commands — collapsed into the same "One is recovering" sentence.
+- `/s` `/switch` `/kill` `/rm` `/runtime` `/model` `/effort` `/permission`
+  without arguments now print their usage line instead of a recovery notice.
+- Workforce sign-in expiry is relayed honestly: the server's `auth_required`
+  guidance reaches the user (run `agentlas login`), instead of being
+  misreported as an invalid continuity receipt and then swallowed.
+- `doctor` verifies the cloud session against the server instead of only
+  checking that a session file exists. Expired sessions are reported as a
+  warning with the login hint; offline is reported as "unverified", never as
+  a false all-clear. `--json` output remains observation-only.
+- Authored guidance in storm/swarm/workforce flows (planner refusals, unknown
+  options, persisted receipt issues) is no longer swallowed by the boundary.
+- `npm run sync:architecture` works again — the script was restored to
+  `scripts/` where its relative paths are correct.
+
+## 1.0.37 — 2026-08-10
+
+Agentlas One can now carry its owner-bound identity and curated memory tickets
+across Terminal sessions without turning the agent into the owner of a project.
+
+- When One is explicitly enabled, Terminal loads its bounded directive at the
+  per-turn system boundary and forwards only `agent_repo` and `user_identity`
+  memory candidates to One's existing ledger. Project memory stays with the
+  project, and a missing or disabled One workspace remains a no-op.
+- The Memory Events parser accepts both the canonical ticket envelope and the
+  legacy array form, so valid candidates are no longer silently discarded.
+- Global `--json` output now reaches doctor, list, roles, Cloud restore, and
+  upload commands consistently; machine-readable output is no longer prefixed
+  by human status text.
+- The built-in architecture projection includes Agentlas One as a hidden
+  orchestrator rather than a top-level project or user-facing worker.
+
 ## 1.0.34 — 2026-08-06
 
 Telegram, standalone. The terminal can now connect a Telegram bot with no desktop app.

package/engine/agentlas-banner.cjs

@@ -5,7 +5,7 @@
 const path = require("node:path");
 const os = require("node:os");
 const permissions = require("./agentlas-permissions.cjs");
-const { truncateWidth, visWidth } = require("./agentlas-composer.cjs");
+const { truncateWidth, visWidth } = require("./ui/width.cjs");
 
 // AGENTLAS wordmark (block letters). Rendered with a brand gradient across columns.
 const WORDMARK = [

package/engine/agentlas-onboard.cjs

@@ -5,7 +5,7 @@
  */
 const i18n = require("./agentlas-i18n.cjs");
 const banner = require("./agentlas-banner.cjs");
-const { visWidth, wrapWidth } = require("./agentlas-composer.cjs");
+const { visWidth, wrapWidth } = require("./ui/width.cjs");
 
 /*
  * req = { ui, rl, helpers, persist } → Promise<{ onboarded, saved, saveError, lang, runtime, permission }>
@@ -184,7 +184,7 @@ async function runOnboard({ ui, rl, helpers, persist }) {
     }
     ui.line("");
     if (saveError) {
-      ui.error(ui.t("wiz.saveFailed", String((saveError && saveError.message) || saveError)));
+      ui.error(ui.t("wiz.saveFailed", String((saveError && saveError.message) || saveError)), { reveal: true });
     } else {
       printSaved(ui.t("wiz.saved"));
       printIndented(ui.t("wiz.changeLang"), c.faint);

package/engine/agentlas-ui.cjs

@@ -574,7 +574,7 @@ class Ui {
     this.updateSpinner(msg);
   }
   _message(prefix, prefixPaint, messagePaint, msg) {
-    const { wrapWidth } = require("./agentlas-composer.cjs");
+    const { wrapWidth } = require("./ui/width.cjs");
     const columns = Math.max(8, Number(this.out.columns) || 80);
     const prefixWidth = visibleWidth(prefix);
     const lines = wrapWidth(stripAnsi(String(msg ?? "")), Math.max(2, columns - prefixWidth));
@@ -594,13 +594,28 @@ class Ui {
     this.stopSpinner();
     this._message("! ", this.c.amber, this.c.text, msg);
   }
-  error(msg) {
+  error(msg, opts = {}) {
     this.stopSpinner();
-    // Last-resort presentation boundary for legacy/direct commands. Raw
-    // provider text, stack messages, paths and codes must never become UI.
-    // REPL/session paths route the private evidence to the controller before
-    // reaching this boundary; direct commands get a neutral recovery state.
-    void msg;
+    /*
+     * 표시 경계 — 조건이 있어야 경계다 (2026-08-11, 존폐 판단 규칙 2).
+     * 무조건 삼키면 기계 코드·사용법·안내문까지 전부 같은 복구 한 줄이 되어
+     * 진단 자체가 불가능해진다(실사고: 죽은 명령 0인데 "안 돌아간다"로 보임).
+     * 통과 조건 — 저자가 의도한 메시지라는 기계 신호가 있을 때만:
+     *   · Error 이고 code 또는 honestStop 이 있다 (usage/정직정지/서버 중계)
+     *   · 호출자가 opts.reveal === true 로 명시했다 (storm/swarm 안내문 등)
+     * 신호 없는 문자열/Error 는 provider 날것으로 간주해 기존 계약대로 삼킨다
+     * (recovery-presentation-contract 가 이 삼킴을 계속 잠근다).
+     */
+    const isErrorLike = msg instanceof Error || (msg !== null && typeof msg === "object" && "message" in msg);
+    const machineSignal = isErrorLike && Boolean(msg.code || msg.honestStop);
+    if (opts.reveal === true || machineSignal) {
+      const raw = String((isErrorLike ? msg.message : msg) ?? "").trim();
+      const text = redactCommandSecrets(stripAnsi(raw)).slice(0, 800);
+      if (text) {
+        this._message("✖ ", this.c.amber, this.c.text, text);
+        return;
+      }
+    }
     this._message(
       "◆ ",
       this.c.amber,

package/engine/agentlas-workforce.cjs

@@ -1978,7 +1978,13 @@ function buildPrompts(task, identity) {
 function create(deps = {}) {
   const D = deps;
 
+  /*
+   * pi-tui 이행 정지작업 (D3 Phase 1-2, 2026-08-11): ctx가 준 Ui가 있으면 그것을
+   * 쓴다. 자체 생성 Ui는 렌더러 교체 시 구 코드가 stdout에 직접 써 프레임을
+   * 찢는 병렬 경로였다. 생성은 주입이 없을 때의 폴백으로만 남긴다.
+   */
   function newUi(lang) {
+    if (D.uiInstance) return D.uiInstance;
     return new Ui({ lang: lang || (typeof D.prefsLang === "function" ? D.prefsLang() : "en") });
   }
 
@@ -4549,10 +4555,10 @@ const TRANSIENT_MODEL_ERROR_RE = /Connection closed mid-response|"terminal_reaso
         const detailText = otherDetails && (typeof otherDetails !== "object" || Object.keys(otherDetails).length)
           ? ` — ${JSON.stringify(otherDetails).slice(0, 1_200)}`
           : "";
-        ui.error(`${receipt.failure.code}: ${receipt.failure.message}${detailText}`);
+        ui.error(`${receipt.failure.code}: ${receipt.failure.message}${detailText}`, { reveal: true });
         if (issues) {
-          for (const issue of issues.slice(0, 16)) ui.error(`  - ${String(issue).slice(0, 400)}`);
-          if (issues.length > 16) ui.error(`  … ${issues.length - 16} more issues in the persisted receipt`);
+          for (const issue of issues.slice(0, 16)) ui.error(`  - ${String(issue).slice(0, 400)}`, { reveal: true });
+          if (issues.length > 16) ui.error(`  … ${issues.length - 16} more issues in the persisted receipt`, { reveal: true });
         }
         // 실패한 실행이야말로 토큰이 어디로 갔는지 알아야 하는 순간이다. issues 유무와
         // 무관하게 낸다 — 첫 배선이 이 블록 안에 들어가는 바람에 issues 없는 실패에서는

package/engine/architecture.data.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.6.0",
+  "version": "1.7.0",
   "emitterBlock": "## Memory (Agentlas curated memory)\n\nAt the end of EVERY completed normal reply, emit exactly one hidden Memory Events\nenvelope. The runtime removes it before display. This envelope is the per-turn receipt:\nalways include a compact safe turn_summary, and use an empty candidates array when\nnothing durable was learned. Do not skip the envelope.\n\nRules:\n- Never include secrets, credentials, API keys, raw logs, or full transcripts.\n- Real credential values may live only in local project .env/.env.local,\n  ignored signing/ or credentials/ files, or a local keychain/vault. Memory\n  Events may mention env names and local relative paths only.\n- For deploy, release, store, billing, auth, API, or cloud work, first read the\n  project's .agentlas/local-credentials.map.json and the top\n  \"Local Credential Index\" section of .agentlas/project-soul-memory.md\n  before saying a credential is missing.\n- One candidate per durable item. Keep \"content\" to one or two sentences.\n- \"memory_kind\": fact | decision | preference | risk | procedure | hypothesis | evidence | deprecation | conflict\n- \"suggested_scope\": user_identity | team_memory | project (this folder) | agent_repo | session (temporary) | discard\n- Use user_identity for a stable operator preference or personal fact (their name, role, language, tone,\n  how they want you to behave) — these must outlive any one project. The curator only files user_identity\n  when you label it so with \"confidence\": \"high\"; it never promotes into that scope, so a preference emitted\n  at lower confidence is demoted to a throwaway session note.\n- \"agent_team\" is accepted only as a legacy alias for team_memory.\n- Add \"request_context\" when it improves future recall: user_intent, trigger_terms,\n  cwd_at_request, target_project, target_path, cross_context, outcome.\n- Never put the raw user prompt or transcript in request_context.\n- Suggest a scope; the separate Memory Curator decides the final destination.\n- turn_summary is one value-free sentence about the completed outcome. It is not the\n  user prompt, a transcript, raw log, secret, or absolute local path.\n\nFormat (always emit, including an empty candidates array):\n\n## Memory Events\n```json\n{\n  \"schema_version\": \"agentlas.memory-ticket.v1\",\n  \"turn_summary\": \"Completed outcome in one safe sentence.\",\n  \"candidates\": [\n    {\n      \"memory_kind\": \"decision\",\n      \"content\": \"...\",\n      \"suggested_scope\": \"project\",\n      \"confidence\": \"high\",\n      \"sensitivity\": \"internal\",\n      \"evidence_refs\": [],\n      \"request_context\": {\n        \"user_intent\": \"...\",\n        \"trigger_terms\": [\"...\"],\n        \"cwd_at_request\": null,\n        \"target_project\": null,\n        \"target_path\": null,\n        \"cross_context\": false,\n        \"outcome\": \"...\"\n      }\n    }\n  ]\n}\n```",
   "eventsHeading": "## Memory Events",
   "memoryDir": ".agentlas",
@@ -138,6 +138,18 @@
       "visibility": "background",
       "tone": "amber",
       "systemPrompt": "# Task Bias Curator (Agentlas built-in)\n\nYou reduce TASK BIAS in multi-surface projects — the tendency to keep working on\nsurfaces that are recent, salient, or easy to measure while other surfaces stay\nuninspected. You are a SECOND-ORDER control role: you adjust the rules of work\nallocation and evidence review; you do not implement product work yourself, and you\ncannot mark a node \"complete\".\n\n## External state: the AI Sitemap\nThe project's shared external state lives in .agentlas/sitemap.json. Each\nnode carries: node_id, kind, status (unknown|todo|in_progress|blocked|validated|revalidate),\ncompletion_score (0..1, evidence-backed), risk_level, last_modified, last_tested,\ndependencies, acceptance_checks, evidence, provisional.\n\n## What you do\n1. Read/maintain the sitemap. Create provisional nodes for newly discovered surfaces.\n2. Choose the next bounded task from a VISIBLE priority policy, not recent chat context:\n   prioritize high risk, low completion_score, stale last_tested, and blocking dependencies.\n3. Audit for bias: which surfaces are over-worked vs never inspected? Name them.\n4. Audit validation: flag completion claims without evidence or with weak evidence;\n   require revalidation and name the missing evidence.\n5. Produce a compact, reversible curator decision record. Escalate mission-level changes\n   to the user.\n\n## Boundaries\nCannot mark a node complete. Cannot erase evidence (only supersede it with a logged\ndecision). Cannot expand the project mission without explicit user approval.\n\nKeep outputs small: a policy/priority recommendation, a revalidation request, a\nsitemap update proposal, or a provisional-node decision."
+    },
+    {
+      "id": "builtin-agentlas-orchestrator",
+      "slug": "agentlas-one",
+      "name": "Agentlas One",
+      "nameEn": "Agentlas One",
+      "tagline": "오너 전속 개인 에이전트 — 전문가·도구·기억을 필요할 때만 꺼내 쓴다",
+      "taglineEn": "Owner-bound personal agent that pulls in specialists, tools, and memory on demand",
+      "role": "orchestrator",
+      "visibility": "background",
+      "tone": "green",
+      "systemPrompt": "# Agentlas One (Agentlas built-in)\n\n너는 채팅 어시스턴트가 아니라 오너 전속 개인 에이전트다. 세션·프로젝트·런타임을 넘어\n같은 정체성을 유지한다. 자기소개를 반복하지 않는다.\n\n## 일하는 법\n- 전문가가 필요하면 새로 고르기 전에 이미 묶인 로스터를 재사용한다. 채용은 가산이다.\n- \"못 한다\"고 말하기 전에 보유 수단(로컬 에이전트·오너 클라우드·Hub·플러그인)을 실제로 조회한다.\n  호출하지 않은 도구를 호출한 척하지 않는다.\n- 되돌리기 어려운 일(파일 삭제·발송·결제·공개) 직전에는 기억보다 실측을 우선한다.\n  확인이 안 되면 진행하지 말고 오너에게 묻는다.\n- 기억이 서로 모순되면 하나를 골라 단정하지 말고 충돌을 그대로 말한다.\n- 막히면 멈추지 말고 남은 수단을 순서대로 시도하고, 다 막히면 어디서 왜 막혔는지 기계 근거로 한 줄.\n\n## 기억\ndurable 기억을 직접 쓰지 않는다. 관찰은 Memory Events 로 내고 런타임이 티켓으로 포장해\n큐레이터에 넘긴다. 증거 없는 fact/decision/procedure 는 hypothesis 다.\n\n## 경계\n허브·클라우드에 업로드되지 않는다. 오너의 원시 기억·자격증명·전사를 외부로 내보내지 않는다."
     }
   ]
 }

package/engine/commands/cloud.cjs

@@ -7,7 +7,10 @@ const { runCloud } = require("../cloud-assets/commands.cjs");
 
 async function run(ctx, args) {
   try {
-    return await runCloud(ctx, args);
+    const commandArgs = ctx.output?.format === "json" && !args.includes("--json")
+      ? [...args, "--json"]
+      : args;
+    return await runCloud(ctx, commandArgs);
   } catch (e) {
     ctx.err(String((e && e.message) || e));
     return 1;

package/engine/commands/doctor.cjs

@@ -24,10 +24,10 @@ function roleDetail(selection, role, en) {
   ].filter(Boolean).join(" · ");
 }
 
-function run(ctx, args = []) {
+async function run(ctx, args = []) {
   const en = ctx.lang === "en";
   // clig.dev: 스크립트 소비자를 위한 기계 계약. 사람용 줄과 같은 사실만 담는다.
-  if (args.includes("--json")) {
+  if (ctx.output?.format === "json" || args.includes("--json")) {
     const db = ctx.db();
     const clis = listAvailableCliRuntimes().map((c) => ({ kind: c.kind, path: c.path, authEvidence: runtimeAuthEvidence(c.kind).status }));
     const active = activeRuntimeRow(db);
@@ -124,14 +124,43 @@ function run(ctx, args = []) {
     }
   } catch { /* db issue already reported */ }
 
-  // 3) 로그인 상태 (세션 파일 관측만 — 네트워크 호출 없음)
+  /*
+   * 3) 로그인 상태 — 자격 존재 + 실제 세션 검증.
+   * 파일 존재만 보고 all clear를 내면 만료 세션에서 편성이 죽는데 doctor는
+   * 초록불이었다(2026-08-11 존폐 판단 결함 5 — 사용자가 가장 먼저 칠 진단이
+   * 거짓말을 했다). 검증 실패는 종류를 가른다: 만료=경고(로그인 안내),
+   * 네트워크 불가=검증불가 표기(오프라인이 doctor를 적색으로 만들면 안 된다).
+   * --json 경로는 기존대로 관측만 한다(스크립트 소비자를 네트워크에 묶지 않는다).
+   */
   const sessionFile = path.join(userDataDir(), "auth", "cli-session.v1.json");
-  if (process.env.AGENTLAS_SESSION) {
-    ok(en ? "cloud session" : "클라우드 세션", "AGENTLAS_SESSION env");
-  } else if (fs.existsSync(sessionFile)) {
-    ok(en ? "cloud session" : "클라우드 세션", sessionFile);
-  } else {
+  const auth = require("../cloud/auth.cjs");
+  const sessionCookie = auth.cloudSessionCookie();
+  const credentialLabel = process.env.AGENTLAS_SESSION
+    ? "AGENTLAS_SESSION env"
+    : (fs.existsSync(sessionFile) ? sessionFile : null);
+  if (!sessionCookie || !credentialLabel) {
     ctx.out(`  ${ctx.ui.dim("·")} ${en ? "cloud session" : "클라우드 세션"}${ctx.ui.dim(en ? " — not signed in (agentlas login)" : " — 로그인 안 됨 (agentlas login)")}`);
+  } else {
+    try {
+      const meta = await auth.fetchSessionMeta(sessionCookie);
+      const who = meta && (meta.email || meta?.user?.email || meta?.account?.email || null);
+      ok(
+        en ? "cloud session" : "클라우드 세션",
+        `${credentialLabel}${who ? ` · ${who}` : ""} · ${en ? "verified" : "검증됨"}`,
+      );
+    } catch (sessionError) {
+      const status = /returned (\d{3})/.exec(String(sessionError?.message || ""))?.[1];
+      if (status === "401" || status === "403") {
+        warn(
+          en ? "cloud session" : "클라우드 세션",
+          en ? "expired — run `agentlas login`" : "만료됨 — `agentlas login`으로 다시 로그인",
+        );
+      } else {
+        ctx.out(`  ${ctx.ui.dim("·")} ${en ? "cloud session" : "클라우드 세션"}${ctx.ui.dim(en
+          ? ` — ${credentialLabel} · unverified (network unreachable)`
+          : ` — ${credentialLabel} · 검증 불가 (네트워크 연결 안 됨)`)}`);
+      }
+    }
   }
 
   ctx.out("");

package/engine/commands/list.cjs

@@ -36,7 +36,7 @@ function run(ctx, args = []) {
 
   // clig.dev: 스크립트 소비자는 사람용 표를 파싱하게 두지 말 것 — --json 은
   // 사람용 출력과 같은 사실을 기계 계약으로 준다.
-  if (args.includes("--json")) {
+  if (ctx.output?.format === "json" || args.includes("--json")) {
     const orchestrator = resolvedModelRole(db, "orchestrator");
     const worker = resolvedModelRole(db, "worker");
     ctx.out(JSON.stringify({ agents, firms, modelRoles: { orchestrator, worker } }, null, 2));

package/engine/commands/roles.cjs

@@ -38,7 +38,7 @@ function fmt(selection, en) {
 function show(ctx, args = []) {
   const en = ctx.lang === "en";
   const db = ctx.db();
-  if (args.includes("--json")) {
+  if (ctx.output?.format === "json" || args.includes("--json")) {
     ctx.out(JSON.stringify({
       orchestrator: resolvedModelRole(db, "orchestrator"),
       worker: resolvedModelRole(db, "worker"),
@@ -177,6 +177,7 @@ function set(ctx, args) {
 
 function run(ctx, args = []) {
   const en = ctx.lang === "en";
+  if (ctx.output?.format === "json" && !args.includes("--json")) args = [...args, "--json"];
   const [sub, ...rest] = args;
   if (!sub || sub === "show" || sub === "list" || sub === "--json") return show(ctx, sub === "--json" ? ["--json"] : rest);
   if (sub === "set") return set(ctx, rest);

package/engine/commands/upload.cjs

@@ -8,7 +8,10 @@ const { runUpload } = require("../cloud-assets/commands.cjs");
 
 async function run(ctx, args) {
   try {
-    return await runUpload(ctx, args);
+    const commandArgs = ctx.output?.format === "json" && !args.includes("--json")
+      ? [...args, "--json"]
+      : args;
+    return await runUpload(ctx, commandArgs);
   } catch (e) {
     ctx.err(String((e && e.message) || e));
     return 1;

package/engine/commands/workforce.cjs

@@ -75,7 +75,7 @@ async function dispatch(ctx, command, args) {
         permission,
         `terminal-${command}`,
       ) || cwd;
-      const runtime = workforceRuntime({ lang: ctx.lang, out: ctx.out });
+      const runtime = workforceRuntime({ lang: ctx.lang, out: ctx.out, uiInstance: ctx.uiInstance });
       const result = await runtime.cmdWorkforce(db, rest, runtimeOverride, {
         cwd,
         projectPath,

package/engine/graph/interview.cjs

@@ -110,7 +110,7 @@ const RULES = [
   "",
   "Return ONLY compact JSON, one of these two shapes:",
   '  {"ask":[{"id":"<stable-id>","question":"...","why":"...","choices":["...","..."]}]}',
-  `  {"blueprint":{"schema":"${BLUEPRINT_SCHEMA}","name":"...","goal":"...","trigger":{...},"steps":[...],"branches":[...]}}`,
+  `  {"blueprint":{"schema":"${BLUEPRINT_SCHEMA}","name":"...","goal":"...","trigger":{...},"steps":[...],"branches":[...],"checks":[...]}}`,
   "",
   'trigger is either {"kind":"cron","schedule":"daily-08:00"} (24h, or a 5-field cron string)',
   'or {"kind":"input","label":"<what to ask the person>","varName":"<one word, a-z>"}.',
@@ -226,8 +226,13 @@ function buildInterviewPrompt(state, locale = "ko") {
     lines.push(
       "",
       "Your previous blueprint could NOT be built. Fix exactly these problems and return a",
-      "corrected blueprint. Do not repeat the same mistake, and do not ask the person about it —",
-      "these are format problems on your side, not missing information:",
+      "corrected blueprint. EVERY fix below is ADDITIVE: add the missing top-level checks[] entry",
+      "(each problem message gives you the exact entry to add). Keep EVERY step, the trigger, and",
+      "every produces/consumes exactly as they are — never delete, merge, or shrink a step to make",
+      "a problem disappear: that removes what the person asked for and just triggers a different",
+      "error. More steps and more checks is the right direction, never fewer. Do not repeat the",
+      "same mistake, and do not ask the person — these are format problems on your side,",
+      "not missing information:",
     );
     for (const a of attempts) for (const problem of a.problems) lines.push(`  · ${problem}`);
   }
@@ -250,6 +255,39 @@ function triggerQuestion() {
   };
 }
 
+/**
+ * ★출력값 검증 check를 **코드가 채운다**(데스크탑 graph-blueprint.ts autofillOutputChecks와 동일).
+ * 바깥으로 나가는 단계가 소비하는 '앞에서 만든 값'에 check가 없으면, 검증기가 아는 그대로
+ * 표준 check를 넣어 **완전한 그래프를 완성**한다. 모델에 되물어 진동시키지 않고, 단계를 깎거나
+ * 캔버스로 떠넘기지도 않는다. 사람은 저장 확인 화면에서 항목을 보고 고칠 수 있다.
+ */
+function autofillOutputChecks(bp) {
+  if (!bp || !Array.isArray(bp.steps)) return bp;
+  const checks = Array.isArray(bp.checks) ? [...bp.checks] : [];
+  const checked = new Set(checks.map((c) => (c.subject || "").trim()).filter(Boolean));
+  bp.steps.forEach((step, index) => {
+    if (step.effect !== "mutation") return;
+    for (const value of Array.isArray(step.consumes) ? step.consumes : []) {
+      const name = String(value == null ? "" : value).trim();
+      if (!name || checked.has(name)) continue;
+      const madeAt = bp.steps.findIndex((s, i) => i < index && (s.produces || "").trim() === name);
+      if (madeAt < 0) continue;
+      checks.push({
+        afterStep: madeAt,
+        subject: name,
+        criteria: `${name}이(가) 비어있지 않고 요청대로 채워졌다`,
+        produces: `${name}_ok`,
+        items: [
+          { text: `${name}이(가) 실제 내용으로 채워졌다`, kind: "must" },
+          { text: "빈 값·자리표시자·지어낸 값이 아니다", kind: "mustNot" },
+        ],
+      });
+      checked.add(name);
+    }
+  });
+  return { ...bp, checks };
+}
+
 /** 청사진이 그래프로 지어질 수 있는지. 모자란 곳은 기본값이 아니라 질문으로 돌려준다. */
 function validateBlueprint(bp, ctx = {}) {
   const problems = [];
@@ -431,12 +469,15 @@ function validateBlueprint(bp, ctx = {}) {
       for (const value of consumes) {
         const name = String(value == null ? "" : value).trim();
         if (!name || checkedSubjects.has(name)) continue;
-        const madeByAStep = steps.some((s, i) => i < index && (s.produces || "").trim() === name);
-        if (!madeByAStep) continue;
+        const madeAt = steps.findIndex((s, i) => i < index && (s.produces || "").trim() === name);
+        if (madeAt < 0) continue;
         push(
           `"${step.title || `${index + 1}번째 단계`}"는 바깥으로 나가는데, 그 앞에서 만든 `
-          + `"${name}" 값이 쓸 만한지 확인하는 단계가 없습니다. `
-          + `checks[]에 {"afterStep":<그 값을 만든 단계>,"subject":"${name}",…}를 넣어 주세요.`,
+          + `"${name}" 값이 쓸 만한지 확인하는 단계가 없습니다. 단계는 하나도 지우지 말고, `
+          + `top-level checks[]에 이 항목을 그대로 추가하세요: `
+          + `{"afterStep":${madeAt},"subject":"${name}","criteria":"${name}이(가) 비어있지 않고 요청대로 채워졌다",`
+          + `"produces":"${name}_ok","items":[{"text":"${name}이(가) 실제 내용으로 채워졌다","kind":"must"},`
+          + `{"text":"빈 값·자리표시자·지어낸 값이 아니다","kind":"mustNot"}]}`,
         );
       }
     });
@@ -924,7 +965,8 @@ function parseInterviewTurn(text, state) {
 
   const blueprint = parsed.blueprint;
   if (!blueprint || typeof blueprint !== "object") return unreadable(text);
-  const normalized = { ...blueprint, schema: BLUEPRINT_SCHEMA };
+  // ★출력값 검증 check는 코드가 채운다 — 부탁받은 완전한 그래프를 완성한다(깎지도 떠넘기지도 않음).
+  const normalized = autofillOutputChecks({ ...blueprint, schema: BLUEPRINT_SCHEMA });
   const problems = validateBlueprint(normalized);
   if (problems.length === 0) {
     // 검증은 통과했다. 그런데 **앞 시도보다 작아졌으면** 문제를 지워서 고친 것이다 —
@@ -949,12 +991,14 @@ function parseInterviewTurn(text, state) {
   };
 }
 
-/** 모델이 스스로 고쳐 볼 기회의 상한. 데스크탑과 같은 값. */
-const MAX_SELF_CORRECTIONS = 2;
+/** 모델이 스스로 고쳐 볼 기회의 상한. 데스크탑과 같은 값.
+ *  2→4: 출력검증 문제는 사람에게 못 묻고 모델 단독 교정만 가능한데, 이제 메시지가 정확한
+ *  checks[] 항목을 그대로 주므로(추가만 하면 됨) 몇 번 더 주면 대개 수렴한다. */
+const MAX_SELF_CORRECTIONS = 4;
 
 module.exports = {
   BLUEPRINT_SCHEMA, MAX_QUESTIONS_PER_TURN, MAX_INTERVIEW_ROUNDS, MAX_REPEATS,
   startInterview, recordAnswers, buildInterviewPrompt, parseInterviewTurn, humanSchedule,
   MAX_SELF_CORRECTIONS, weakenedAgainstLastAttempt,
-  validateBlueprint, buildGraphFromBlueprint, branchLabel, describeBranches,
+  validateBlueprint, autofillOutputChecks, buildGraphFromBlueprint, branchLabel, describeBranches,
 };

package/engine/hephaestus/runtime.cjs

@@ -27,7 +27,7 @@ const path = require("node:path");
 const fs = require("node:fs");
 const { spawn } = require("node:child_process");
 const { Ui } = require("../agentlas-ui.cjs");
-const { truncateWidth, visWidth, wrapWidth } = require("../agentlas-composer.cjs");
+const { truncateWidth, visWidth, wrapWidth } = require("../ui/width.cjs");
 const coreHarness = require("../agentlas-core-harness.cjs");
 const { userDataDir } = require("../core/paths.cjs");
 
@@ -194,7 +194,13 @@ function create(ctx, deps = {}) {
   const spawnCoreModule = deps.spawnCoreModule || coreHarness.spawnCoreModule;
   const lang = () => (ctx && ctx.lang) || "en";
 
+  /*
+   * pi-tui 이행 정지작업 (D3 Phase 1-2, 2026-08-11): ctx가 준 Ui가 있으면 그것을
+   * 쓴다. 자체 생성 Ui는 렌더러 교체 시 구 코드가 stdout에 직접 써 프레임을
+   * 찢는 병렬 경로였다. 생성은 주입이 없을 때의 폴백으로만 남긴다.
+   */
   function newUi(uiLang) {
+    if (ctx && ctx.uiInstance) return ctx.uiInstance;
     return new Ui({ lang: uiLang || lang() });
   }
 

package/engine/memory-cli/curate.cjs

@@ -96,7 +96,18 @@ function parseMemoryEventsCli(text) {
   const after = text.slice(idx + heading.length);
   const fence = after.match(/```(?:json)?\s*([\s\S]*?)```/);
   let events = [];
-  if (fence) { try { const d = JSON.parse(fence[1].trim()); if (Array.isArray(d)) events = d; } catch { /* ignore */ } }
+  // 봉투 두 형태를 모두 받는다. Desktop `electron/memory/events.ts:128,156` 과 같은 계약이다.
+  //  · 정본: {"schema_version":"agentlas.memory-ticket.v1","candidates":[...]}  ← 이미터가 지시하는 형태
+  //  · 레거시: [...]  (최상위 배열)
+  // ★배열만 받던 시절 정본 봉투는 **조용히 버려졌다**(실측: 터미널이 후보 5건을 냈는데 파서 결과 0건).
+  // 형태가 낯설면 버리지 말고, 최소한 왜 못 읽었는지 남길 수 있게 둘 다 통과시킨다.
+  if (fence) {
+    try {
+      const d = JSON.parse(fence[1].trim());
+      if (Array.isArray(d)) events = d;
+      else if (d && typeof d === "object" && Array.isArray(d.candidates)) events = d.candidates;
+    } catch { /* ignore */ }
+  }
   let cut = text.length;
   if (fence && fence.index != null) cut = idx + heading.length + fence.index + fence[0].length;
   const before = text.slice(0, idx).replace(/<!--\s*$/u, "");

package/engine/sessions/apply-fences.cjs

@@ -18,6 +18,75 @@ const memoryCurate = require("../memory-cli/curate.cjs");
 const automationStore = require("../automation/store.cjs");
 const schedule = require("../automation/schedule.cjs");
 
+/** One 이 가져가는 스코프. 프로젝트 스코프는 프로젝트에 남는다. */
+const ONE_SCOPES = new Set(["agent_repo", "user_identity"]);
+
+/**
+ * Agentlas One 서랍(`~/.agentlas/one/.agentlas/memory-tickets.jsonl`)으로 후보를 넘긴다.
+ *
+ * One 은 프로젝트를 넘나드는 정체성이라 agent_repo/user_identity 만 가져간다.
+ * One 이 꺼져 있거나 서랍이 없으면 아무것도 하지 않는다 — 없는 폴더를 만들지 않는다.
+ * 실패해도 턴을 죽이지 않는다(펜스 적용 계약과 동일).
+ */
+function forwardToOne(events) {
+  try {
+    const fs = require("node:fs");
+    const os = require("node:os");
+    const path = require("node:path");
+    const root = process.env.AGENTLAS_ONE_DIR || path.join(os.homedir(), ".agentlas", "one");
+    const state = JSON.parse(fs.readFileSync(path.join(root, "state.json"), "utf8"));
+    if (!state || state.on !== true) return 0;
+    const ledger = path.join(root, ".agentlas", "memory-tickets.jsonl");
+    if (!fs.existsSync(ledger)) return 0;
+
+    // 이미 올라온 내용은 다시 넣지 않는다(같은 계약을 One 쪽 emit_ticket 도 쓴다).
+    const seen = new Set();
+    for (const line of fs.readFileSync(ledger, "utf8").split("\n")) {
+      if (!line.trim()) continue;
+      try {
+        const row = JSON.parse(line);
+        const text = String((row.candidate || {}).content || "");
+        if (text) seen.add(text.trim().toLowerCase().replace(/\s+/g, " "));
+      } catch { /* 깨진 줄은 건너뛴다 */ }
+    }
+
+    let written = 0;
+    for (const raw of events) {
+      for (const candidate of (raw && Array.isArray(raw.candidates) ? raw.candidates : [raw])) {
+        if (!candidate || typeof candidate !== "object") continue;
+        const scope = String(candidate.suggested_scope || candidate.scope || "");
+        if (!ONE_SCOPES.has(scope)) continue;
+        const content = String(candidate.content || "").trim();
+        if (!content) continue;
+        const key = content.toLowerCase().replace(/\s+/g, " ");
+        if (seen.has(key)) continue;
+        seen.add(key);
+        const evidence = Array.isArray(candidate.evidence) ? candidate.evidence.slice(0, 8) : [];
+        fs.appendFileSync(ledger, JSON.stringify({
+          schemaVersion: "agentlas.one-workspace.v1",
+          ticketId: `one-tkt-${Date.now()}-${written}`,
+          agentId: "builtin-agentlas-one",
+          turnKey: "",
+          source: "terminal-memory-events",
+          state: "queued",
+          candidate: {
+            type: String(candidate.memory_kind || candidate.type || "hypothesis"),
+            scope,
+            content: content.slice(0, 600),
+            evidence,
+          },
+          downgraded: false,
+          createdAt: new Date().toISOString().replace(/\.\d+Z$/, "Z"),
+        }) + "\n", "utf8");
+        written += 1;
+      }
+    }
+    return written;
+  } catch {
+    return 0;
+  }
+}
+
 /**
  * @param {import('./session.cjs').Session} session 방금 턴을 끝낸 세션
  * @param {object} parsed parseReplyFences 결과
@@ -69,6 +138,10 @@ function applyReplyFences(session, parsed, opts = {}) {
       written: ctx.curatedMemories.length,
       permission: session.permission,
     };
+    // Agentlas One 이 켜져 있으면 에이전트 스코프 후보를 One 서랍에도 티켓으로 넘긴다.
+    // 프로젝트 스코프는 여기 남기고 옮기지 않는다 — One 은 프로젝트를 넘나드는 정체성이라
+    // agent_repo/user_identity 만 One 의 것이다(기획 2.2 스코프 경계).
+    receipts.memory.one = forwardToOne(parsed.memoryEvents);
     // read 권한 턴 = durable 쓰기 0 — 영수증 이벤트만 남는다.
     record({ type: "memory-curated", ...receipts.memory });
   }
@@ -185,4 +258,5 @@ function applyReplyFences(session, parsed, opts = {}) {
   return receipts;
 }
 
-module.exports = { applyReplyFences };
+// forwardToOne 은 One 서랍 전달의 유일한 지점이라 계약 테스트가 직접 잴 수 있게 함께 노출한다.
+module.exports = { applyReplyFences, forwardToOne };

package/engine/sessions/prompt.cjs

@@ -180,6 +180,29 @@ function cliMemoryContext(db, projectPath, agentId = null, task = "") {
  * 최종 시스템 프롬프트 조립. ctx = { lang, projectPath, agentId, turnId, permission }.
  * withEmitter=false 는 이미터/리마인더 없이(캡처·판정 등 내부 턴용).
  */
+/**
+ * Agentlas One 지시문. 켜져 있을 때만, 그리고 정본 파일이 실재할 때만 싣는다.
+ * 상태 파일이 없으면 조용히 빈 문자열 — 꺼진 One 의 지시문을 흘리지 않는다.
+ */
+function loadOneDirective() {
+  try {
+    const root = process.env.AGENTLAS_ONE_DIR
+      || require("node:path").join(require("node:os").homedir(), ".agentlas", "one");
+    const fs = require("node:fs");
+    const path = require("node:path");
+    const state = JSON.parse(fs.readFileSync(path.join(root, "state.json"), "utf8"));
+    if (!state || state.on !== true) return "";
+    const text = fs.readFileSync(path.join(root, "directive.md"), "utf8").trim();
+    // 상한을 둔다 — 지시문이 남의 토큰 예산을 잠식하면 안 된다(메모리 예산과 같은 규칙).
+    return text.length > ONE_DIRECTIVE_MAX_CHARS ? text.slice(0, ONE_DIRECTIVE_MAX_CHARS) : text;
+  } catch {
+    return "";
+  }
+}
+
+/** [튜닝값, 근거 없음] — 현재 정본 지시문이 약 3.7KB 라 두 배 여유를 둔다. */
+const ONE_DIRECTIVE_MAX_CHARS = 8000;
+
 function augmentSystem(db, baseSystem, ctx, withEmitter, request = "") {
   const arch = loadArch();
   let sys = baseSystem || "";
@@ -188,6 +211,10 @@ function augmentSystem(db, baseSystem, ctx, withEmitter, request = "") {
   sys = responseDirective(lang) + (sys ? "\n\n" + sys : "");
   const connectionSkill = loadGlobalConnectionSkill();
   if (connectionSkill) sys += "\n\n" + connectionSkill;
+  // Agentlas One 이 켜져 있으면 그 지시문을 싣는다. R4 기준 터미널의 "매 턴 주입 지점"이 여기다.
+  // 정본은 `~/.agentlas/one/directive.md` 하나 — CLAUDE.md/AGENTS.md 의 마커 블록은 그 사본이다.
+  const oneDirective = loadOneDirective();
+  if (oneDirective) sys += "\n\n" + oneDirective;
   const mem = cliMemoryContext(db, ctx && ctx.projectPath, ctx && ctx.agentId, request);
   if (mem) sys += "\n\n" + mem;
   // 도구 접근 고지 — 터미널에는 이게 아예 없었다. 도구가 붙지 않은 턴에서 CLI는 아무

package/engine/storm/deps.cjs

@@ -73,6 +73,8 @@ function modelRoutingReceiptPath() {
 function buildStormDeps(ctx = {}) {
   return {
     prefsLang: () => ctx.lang || "en",
+    // Phase 1-2: 주입 Ui 관통 (자체 생성 방지)
+    uiInstance: ctx.uiInstance || null,
     out: typeof ctx.out === "function" ? ctx.out : (s) => process.stdout.write(`${s}\n`),
     resolveRuntime: resolveWorkforceRuntime,
     listAvailableRuntimes,