agentlas 1.0.28 → 1.0.35

package/engine/agentlas-workforce.cjs

@@ -1097,10 +1097,15 @@ function validateWorkOrder(value) {
 function validateCandidateSet(value, workOrder, now = new Date(), options = {}) {
   const set = assertObject(value, "candidateSet");
   assertNoForbiddenFitSignals(set);
-  assertExactKeys(set, [
+  // projection은 로컬 Core(연합) 응답에만 있는 메뉴 투영 메타데이터다(실측
+  // 2026-08-05, reference-first: fullDossier=false). 원격 서버는 보내지 않는다.
+  // 없애고 되돌려 보내면 Core 쪽 다이제스트 대조가 위험하므로 선택 키로 허용한다.
+  const exactKeys = [
     "schemaVersion", "selectionSessionId", "workOrderId", "ontologyVersion",
     "candidateSetDigest", "decisionOwner", "historyInfluence", "slots", "issuedAt", "expiresAt",
-  ], "candidateSet", "candidate_set_invalid");
+  ];
+  if (Object.prototype.hasOwnProperty.call(set, "projection")) exactKeys.push("projection");
+  assertExactKeys(set, exactKeys, "candidateSet", "candidate_set_invalid");
   if (set.schemaVersion !== "agentlas.workforce-candidate-set.v1") fail("candidate_set_invalid", "unsupported candidate set schema");
   assertId(set.selectionSessionId, "candidateSet.selectionSessionId");
   if (set.workOrderId !== workOrder.workOrderId) fail("candidate_set_invalid", "candidate set workOrderId mismatch");
@@ -1126,11 +1131,15 @@ function validateCandidateSet(value, workOrder, now = new Date(), options = {})
     const releases = new Set();
     for (const candidate of assertArray(slotResult.candidates, `candidateSet.${slotId}.candidates`, 100)) {
       assertObject(candidate, "candidate");
-      assertExactKeys(candidate, [
+      // missingMandatory는 로컬 Core(연합) 응답에만 있는 미충족 필수 표식이다
+      // (실측 2026-08-05, fullDossier=true에도 동봉). 원격 서버는 보내지 않는다.
+      const candidateKeys = [
         "agentDefinitionId", "agentReleaseId", "releaseVersion", "packageHash", "contentDigest",
         "entityKind", "name", "communities", "fitEvidence", "qualificationEvidence", "optionalGaps",
         "semanticSnapshot", "operational",
-      ], "candidate", "candidate_set_invalid");
+      ];
+      if (Object.prototype.hasOwnProperty.call(candidate, "missingMandatory")) candidateKeys.push("missingMandatory");
+      assertExactKeys(candidate, candidateKeys, "candidate", "candidate_set_invalid");
       assertId(candidate.agentDefinitionId, "candidate.agentDefinitionId");
       const releaseId = assertId(candidate.agentReleaseId, "candidate.agentReleaseId");
       if (releases.has(releaseId)) fail("candidate_set_invalid", `duplicate release ${releaseId} in ${slotId}`);
@@ -1151,10 +1160,19 @@ function validateCandidateSet(value, workOrder, now = new Date(), options = {})
       if (typeof operational.callable !== "boolean" || typeof operational.installable !== "boolean") fail("candidate_set_invalid", "candidate operational flags are invalid");
       assertIds(operational.unavailableReasons || [], "candidate.operational.unavailableReasons");
       const semantic = assertObject(candidate.semanticSnapshot, "candidate.semanticSnapshot");
-      assertExactKeys(semantic, [
+      // knowledge·modalities는 로컬 Core 스냅샷에만 있는 확장 어휘다(실측 2026-08-05).
+      // 원격 서버는 보내지 않는다 — missingMandatory·projection과 같은 규칙으로
+      // "있으면 검증하고 허용", 원격 계약의 exact-keys는 그대로 둔다.
+      const semanticKeys = [
         "summaries", "roles", "skills", "toolCapabilities", "consumes", "produces",
         "authorities", "runtimes", "languages",
-      ], "candidate.semanticSnapshot", "candidate_set_invalid");
+      ];
+      for (const optional of ["knowledge", "modalities"]) {
+        if (Object.prototype.hasOwnProperty.call(semantic, optional)) semanticKeys.push(optional);
+      }
+      assertExactKeys(semantic, semanticKeys, "candidate.semanticSnapshot", "candidate_set_invalid");
+      if (semantic.knowledge !== undefined) assertIds(semantic.knowledge, "candidate.semanticSnapshot.knowledge");
+      if (semantic.modalities !== undefined) assertStrings(semantic.modalities, "candidate.semanticSnapshot.modalities");
       assertStrings(semantic.summaries, "candidate.semanticSnapshot.summaries");
       assertIds(semantic.roles, "candidate.semanticSnapshot.roles");
       assertLeveledConcepts(semantic.skills, "candidate.semanticSnapshot.skills");
@@ -2102,6 +2120,28 @@ function create(deps = {}) {
     tokenLedger.push({ role: role || "stage", runtime: runtimeKind || "?", model: modelPin || null, input, output, cached });
   }
 
+  /*
+   * 일시 API 오류 1회 재시도 (실측 2026-08-05: 4슬롯·2.1M 토큰 편성이 마지막
+   * 재검증 호출의 "Connection closed mid-response" 하나로 전멸).
+   * 재시도의 근거는 부수효과 부재가 아니라 **일시 오류의 기계 표식**이고,
+   * 부수효과가 가능한 write 권한 단계는 표식이 있어도 재시도하지 않는다
+   * (자동화 스케줄러와 같은 원칙). D.runModel 주입·CLI 캡처·API 백엔드
+   * 세 경로 모두 이 관문을 지난다 — 하니스가 단위로 검증할 수 있는 이유.
+   */
+  // 한도·429는 재시도 분류에 들어가야 한다 — 빠져 있으면 같은 막힌 런타임에 즉시 재도전만 한다.
+const TRANSIENT_MODEL_ERROR_RE = /Connection closed mid-response|"terminal_reason":"api_error"|ECONNRESET|ETIMEDOUT|socket hang up|overloaded_error|rate.?limit|quota|\b429\b|usage limit|weekly limit/i;
+  async function withTransientModelRetry(authorityMode, invoke) {
+    try {
+      return await invoke();
+    } catch (error) {
+      const replaySafeAuthority = authorityMode === "no-authority" || authorityMode === "read-only";
+      const transient = TRANSIENT_MODEL_ERROR_RE.test(String((error && error.message) || error));
+      if (!replaySafeAuthority || !transient) throw error;
+      process.stderr.write(`workforce: transient api error on a ${authorityMode} stage — retrying once\n`);
+      return invoke();
+    }
+  }
+
   async function runModel(runtime, system, prompt, context) {
     const invocation = stageInvocation(runtime, context);
     const executionRuntime = invocation.executionRuntime;
@@ -2116,7 +2156,7 @@ function create(deps = {}) {
       ? `${system}\n\n${localContextSlice}`
       : system;
     if (typeof D.runModel === "function") {
-      return normalizeModelResult(await D.runModel({
+      return withTransientModelRetry(context.authorityMode || "no-authority", async () => normalizeModelResult(await D.runModel({
         runtime: executionRuntime,
         system: effectiveSystem,
         prompt,
@@ -2127,7 +2167,7 @@ function create(deps = {}) {
           modelPin: invocation.modelPin,
           effortPin: invocation.effort,
         },
-      }));
+      })));
     }
     if (executionRuntime.mode === "cli") {
       const authorityMode = context.authorityMode || "no-authority";
@@ -2156,7 +2196,7 @@ function create(deps = {}) {
         }
         noteIsolationWeakness(executionRuntime.kind, invocation.role);
       }
-      const captured = normalizeModelResult(await D.captureRuntime(executionRuntime.kind, effectiveSystem, prompt, {
+      const captureOnce = async () => normalizeModelResult(await D.captureRuntime(executionRuntime.kind, effectiveSystem, prompt, {
         cwd: context.cwd,
         env: context.env,
         permission: context.permission,
@@ -2169,16 +2209,17 @@ function create(deps = {}) {
         outputLimitBytes: authorityMode === "read-only" ? 24 * 1024 * 1024 : undefined,
         envelope: true,
       }));
+      const captured = await withTransientModelRetry(authorityMode, captureOnce);
       recordStageTokens(invocation.role, executionRuntime.kind, invocation.modelPin, captured.usage);
       return captured;
     }
-    const viaApi = normalizeModelResult(await D.runApi(
+    const viaApi = await withTransientModelRetry(context.authorityMode || "no-authority", async () => normalizeModelResult(await D.runApi(
       executionRuntime.backend,
       invocation.modelPin,
       effectiveSystem,
       prompt,
       { effort: invocation.effort, envelope: true },
-    ));
+    )));
     recordStageTokens(invocation.role, executionRuntime.backend, invocation.modelPin, viaApi.usage);
     return viaApi;
   }
@@ -2393,6 +2434,16 @@ function create(deps = {}) {
 
   async function workforceRun(db, rawTask, ctx = {}) {
     const task = assertString(rawTask, "task", 20_000);
+    // 이 표면이 보는 후보 메뉴의 소스 스코프. 원격 MCP 경로의 정직한 기본은 "hub"
+    // (터미널 workforce = 공개 Hub 메뉴 스태핑). 다른 값은 로컬 Core 전송을 가진
+    // 호출자만 넘길 수 있다 — 여기서 조용히 넓히지 않는다.
+    const sourceScope = (() => {
+      const value = ctx.sourceScope === undefined ? "hub" : ctx.sourceScope;
+      if (!["network", "local", "cloud", "hub"].includes(value)) {
+        fail("source_scope_invalid", `sourceScope must be network|local|cloud|hub, got: ${String(value)}`);
+      }
+      return value;
+    })();
     const ui = ctx.ui || newUi();
     const runtime = ctx.runtime || D.resolveRuntime(db, ctx.runtimeOverride);
     const cwd = ctx.cwd || (typeof D.projectCwd === "function" ? D.projectCwd() : process.cwd());
@@ -2744,7 +2795,9 @@ function create(deps = {}) {
     };
 
     const supersedeCandidateSearch = (workOrder, refinementNumber, triggerKind) => {
-      const requestDigest = sha256({ workOrder });
+      // hubStage가 저장한 requestDigest와 같은 인자 모양이어야 행을 찾는다 —
+      // search 인자에 sourceScope가 실리므로(2026-08-05) 여기서도 함께 계산한다.
+      const requestDigest = sha256({ workOrder, sourceScope });
       for (const row of receipt.hubTools) {
         if (row.tool !== "workforce.search_candidates" || row.requestDigest !== requestDigest || row.authoritativeChain !== true) continue;
         row.authoritativeChain = false;
@@ -3065,7 +3118,10 @@ function create(deps = {}) {
 
       let refinementsUsed = 0;
       const searchCurrentWorkOrder = async () => {
-        const candidateRaw = await hubStage("workforce.search_candidates", { workOrder });
+        // sourceScope는 MCP 스키마상 required다. 예전에는 싣지 않아 서버 기본값
+        // ("hub")에 의존했다 — 기본값이 바뀌면 이 표면의 실제 스코프가 조용히
+        // 넓어지거나 좁아진다. 이 표면이 보는 메뉴를 스스로 선언한다.
+        const candidateRaw = await hubStage("workforce.search_candidates", { workOrder, sourceScope });
         candidateSet = validateCandidateSet(
           candidateRaw,
           workOrder,

package/engine/agentlas.cjs

@@ -14,10 +14,51 @@
  *   ctx.out/err       stdout/stderr 한 줄 출력
  *   ctx.tableExists / ctx.columnExists
  */
+/*
+ * EPIPE 방어 — 발행본 1.0.29 실설치 검증에서 발견(2026-08-06):
+ * `agentlas version | head -1` 처럼 파이프 소비자가 먼저 닫히면 stdout write가
+ * EPIPE를 던져 스택트레이스로 크래시했다(실측: version.cjs → ctx.out → EPIPE).
+ * `| head` `| less` `| grep -m1` 은 CLI의 일상 사용 패턴이고, 파이프 단절은
+ * 오류가 아니라 "그만 읽겠다"는 신호다 — 조용히 성공 종료한다. 런처(bin)는
+ * 엔진을 stdio:"inherit" 로 spawn 하므로 이 방어는 엔진 프로세스에 있어야 한다.
+ */
+for (const stream of [process.stdout, process.stderr]) {
+  stream.on("error", (error) => {
+    if (error && error.code === "EPIPE") process.exit(0);
+    throw error;
+  });
+}
+
+/*
+ * 예상 못 한 크래시의 마지막 예의 (clig.dev: unexpected error에는 디버그 정보와
+ * 버그 리포트 경로를, 리포트는 미리 채워진 URL로 손쉽게).
+ * 예전에는 Node 기본 동작(원시 스택트레이스)이 그대로 사용자에게 쏟아졌다 —
+ * EPIPE 크래시(1.0.29 실측)가 정확히 그 모습이었다. 스택은 진단에 필요하므로
+ * 숨기지 않되, 한 줄 요약과 이슈 URL(제목 미리 채움)을 함께 준다.
+ * 종료 코드는 관례대로 1. 여기서 복구를 시도하지 않는다(crash-only).
+ */
+function reportCrash(kind, error) {
+  const message = String((error && error.stack) || error);
+  const title = encodeURIComponent(`crash: ${String((error && error.message) || error).slice(0, 100)}`);
+  process.stderr.write([
+    "",
+    `agentlas hit an unexpected error (${kind}).`,
+    message,
+    "",
+    `Report it (pre-filled): https://github.com/agentlas-ai/agentlas-terminal/issues/new?title=${title}`,
+    `Include: your command, agentlas ${(() => { try { return require("./agentlas-banner.cjs").readVersion(); } catch { return "?"; } })()}, node ${process.version}, ${process.platform}.`,
+    "",
+  ].join("\n"));
+  process.exit(1);
+}
+process.on("uncaughtException", (error) => reportCrash("uncaughtException", error));
+process.on("unhandledRejection", (error) => reportCrash("unhandledRejection", error));
+
 const { openDb, seedBuiltins, tableExists, columnExists } = require("./core/db.cjs");
 const { userDataDir } = require("./core/paths.cjs");
 const { loadPrefs } = require("./agentlas-config.cjs");
 const { Ui } = require("./agentlas-ui.cjs");
+const { parseOutputFlags, render, renderError, isRichUi } = require("./cli-output.cjs");
 const commands = require("./commands/index.cjs");
 
 const SUPPORTED_LANGS = new Set(["ko", "en"]);
@@ -61,6 +102,22 @@ function buildCtx() {
     },
     out: (s = "") => process.stdout.write(s + "\n"),
     err: (s = "") => process.stderr.write(s + "\n"),
+    /*
+     * 출력 계약 — 명령은 문자열이 아니라 {데이터+스키마}를 준다(cli-output.cjs).
+     * 형식(--json/--yaml/--quiet/--no-headers/--no-color) 해석은 여기 한 곳이라,
+     * 명령마다 --json 유무가 갈리거나 에러 형식이 달라지는 일이 없다.
+     */
+    output: { ...require("./cli-output.cjs").DEFAULT_OPTIONS },
+    emit(result) {
+      const text = render(result, this.output);
+      if (text) process.stdout.write(text + "\n");
+    },
+    fail(error) {
+      process.stderr.write(renderError(error, this.output) + "\n");
+    },
+    get richUi() {
+      return isRichUi(this.output);
+    },
     db: () => {
       if (_db) return _db;
       _db = openDb();
@@ -107,7 +164,13 @@ function main() {
   if (helpRequested && helpCommand) {
     const ctx = buildCtx();
     const command = commands.resolveCommandName(helpCommand);
-    const code = require("./commands/help.cjs").runForCommand(ctx, command);
+    // ★명령이 자기 도움말을 갖고 있으면 그것을 보여준다.
+    //   예전에는 무조건 표 한 줄을 긁어(`runForCommand`) "Usage: agentlas graph [options]"
+    //   두 줄만 나왔다 — `graph help`에는 8줄짜리 제대로 된 안내가 있는데도 `--help`로는
+    //   영원히 닿지 못했다(사용자가 가장 먼저 치는 것이 `--help`다).
+    const code = commands.SELF_HELP_COMMANDS.has(command)
+      ? commands.dispatch(ctx, [command, "help"])
+      : require("./commands/help.cjs").runForCommand(ctx, command);
     process.exit(typeof code === "number" ? code : 0);
   }
   // 옵션 정규화: -h/--help/-V/--version 은 하위 명령으로 변환
@@ -117,12 +180,17 @@ function main() {
     return a;
   });
 
+  // 전역 출력 플래그는 명령에 닿기 전에 한 곳에서 뜯어낸다 —
+  // 명령마다 --json 유무가 갈리던 것을 구조로 막는다.
+  const { options: outputOptions, rest: commandArgv } = parseOutputFlags(normalized);
   const ctx = buildCtx();
+  ctx.output = outputOptions;
   let code;
   try {
-    code = commands.dispatch(ctx, normalized);
+    code = commands.dispatch(ctx, commandArgv);
   } catch (e) {
-    ctx.err(String((e && e.message) || e));
+    // 에러도 같은 형식 규율을 따른다: --json 이면 {"error":{code,message}}.
+    ctx.fail(e);
     process.exit(1);
   }
 

package/engine/agents/builder.cjs

@@ -0,0 +1,84 @@
+"use strict";
+/*
+ * agents/builder — 터미널 소유 로컬 에이전트 빌더 (독립).
+ *
+ * 배경(2026-08-06 오너 원칙): 데스크탑/플러그인은 산출물·설정을 공유할 뿐 선행
+ * 전제가 아니다. 그런데 `agentlas build "<req>"`는 Hephaestus 네이티브
+ * 패스스루라 "Open Claude Code or Codex with the plugin, then /hep-build"라는
+ * 스텁만 냈다 — 플러그인 강제. 터미널은 자체 런타임(claude-code/codex/gemini)이
+ * 있으므로 빌더를 로컬로 돌린다.
+ *
+ * 계약: 빌더 에이전트를 멱등 시드(installed_agents)하고, `run`과 같은 실행
+ * 인프라(Orchestrator 세션)로 돌린다. 산출물은 `import`가 읽는 로컬 폴더 형식
+ * (AGENTS.md=시스템 프롬프트, manifest.md=이름/태그라인). 빌더가 마지막 줄에
+ * `BUILT: <folder>`를 찍으면 그 폴더를 자동 import 한다. 실패해도 폴더는 남아
+ * `agentlas import <folder>`로 언제든 설치할 수 있다.
+ */
+const crypto = require("node:crypto");
+const { runWriteTransaction } = require("../agentlas-sqlite-policy.cjs");
+const { columnExists } = require("../core/db.cjs");
+
+const BUILDER_SLUG = "agentlas-builder";
+const BUILDER_ID = "builtin-agentlas-builder";
+
+const BUILDER_SYSTEM_PROMPT = [
+  "You are the Agentlas local agent builder, running inside the Agentlas terminal.",
+  "Your job: turn the user's request into an installable Agentlas agent, entirely on this machine — no external plugin, no desktop app.",
+  "",
+  "Produce a folder the terminal can import. In the current working directory create a folder named after the agent (kebab-case slug), containing exactly:",
+  "  - AGENTS.md — the agent's full system prompt / soul: who it is, what it does, how it behaves, its guardrails. Write it as the instructions the agent itself will run under. Be specific and production-ready, not a description of the agent.",
+  "  - manifest.md — first line `# <Agent Name>`, second line a one-sentence tagline.",
+  "  - README.md — a short human-facing summary of what the agent does and how to use it.",
+  "",
+  "Rules:",
+  "  - Decide the agent's scope from the request; if the request is thin, choose sensible, specific defaults and state them in README.md rather than asking endless questions.",
+  "  - Do not invent credentials, API keys, or secrets. If the agent needs an env var, name it in README.md as something the user provides later.",
+  "  - Keep everything inside the new folder. Do not modify files outside it.",
+  "  - When finished, print exactly one final line: `BUILT: <relative-folder-path>` so the terminal can install it.",
+].join("\n");
+
+/** 빌더 에이전트를 멱등 보장한다(installed_agents). 반환: 에이전트 행 형태. */
+function ensureBuilderAgent(db) {
+  const now = new Date().toISOString();
+  const hasVisibility = columnExists(db, "installed_agents", "visibility");
+  runWriteTransaction(db, () => {
+    const existing = db.prepare("SELECT id FROM installed_agents WHERE id=? OR slug=?").get(BUILDER_ID, BUILDER_SLUG);
+    if (existing) {
+      db.prepare("UPDATE installed_agents SET system_prompt=?, name=?, name_en=?, tagline=?, tagline_en=? WHERE id=?")
+        .run(BUILDER_SYSTEM_PROMPT, "Agent Builder", "Agent Builder", "Builds Agentlas agents locally", "Builds Agentlas agents locally", existing.id);
+      return;
+    }
+    if (hasVisibility) {
+      db.prepare(
+        "INSERT INTO installed_agents (id, slug, name, name_en, tagline, tagline_en, system_prompt, mcp_servers_json, env_requirements_json, preferred_backend, trust_grade, installed_at, tone, builtin, role, visibility) " +
+        "VALUES (?,?,?,?,?,?,?,'[]','[]',NULL,'A',?,?,1,?,?)",
+      ).run(BUILDER_ID, BUILDER_SLUG, "Agent Builder", "Agent Builder", "Builds Agentlas agents locally", "Builds Agentlas agents locally", BUILDER_SYSTEM_PROMPT, now, "blue", "orchestrator", "visible");
+    } else {
+      db.prepare(
+        "INSERT INTO installed_agents (id, slug, name, name_en, tagline, tagline_en, system_prompt, mcp_servers_json, env_requirements_json, preferred_backend, trust_grade, installed_at, tone, builtin, role) " +
+        "VALUES (?,?,?,?,?,?,?,'[]','[]',NULL,'A',?,?,1,?)",
+      ).run(BUILDER_ID, BUILDER_SLUG, "Agent Builder", "Agent Builder", "Builds Agentlas agents locally", "Builds Agentlas agents locally", BUILDER_SYSTEM_PROMPT, now, "blue", "orchestrator");
+    }
+  });
+  return {
+    id: BUILDER_ID,
+    slug: BUILDER_SLUG,
+    name: "Agent Builder",
+    nameEn: "Agent Builder",
+    systemPrompt: BUILDER_SYSTEM_PROMPT,
+    builtin: true,
+    role: "orchestrator",
+  };
+}
+
+/** 빌더 산출물 마지막 줄에서 `BUILT: <folder>`를 뽑는다. */
+function parseBuiltFolder(finalText) {
+  const lines = String(finalText || "").split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    const m = lines[i].match(/^BUILT:\s*(.+)$/);
+    if (m) return m[1].trim();
+  }
+  return null;
+}
+
+module.exports = { ensureBuilderAgent, parseBuiltFolder, BUILDER_SLUG, BUILDER_ID, BUILDER_SYSTEM_PROMPT };

package/engine/agents/router.cjs

@@ -49,8 +49,14 @@ function ensureJudgeRunner(db, runtime) {
           model: resolved.model || undefined,
           signal,
         });
-      } catch {
-        return "";
+      } catch (error) {
+        /*
+         * ★사유를 ""로 지우지 않는다 — 여기서 지우면 판정 서비스는 "no connected model
+         * reached a valid judgment"라는 거짓 문장만 남긴다(모델은 닿았고, 한도라고
+         * 말했다). 러너 계약은 문자열이므로 예외를 그대로 올려 judgeLabels가 사유를
+         * 싣게 한다.
+         */
+        throw error;
       }
     });
     return judgment;

package/engine/automation/launchd.cjs

@@ -0,0 +1,131 @@
+"use strict";
+/*
+ * automation/launchd — 앱/창이 꺼져 있어도 자동화를 돌리는 macOS 영속성 (2026-08-06).
+ *
+ * 배경(오너: "터미널인데 모든 기능이 다 돼야"): 터미널 automation daemon 은 포그라운드
+ * setInterval 이라 셸 창을 닫으면 멈춘다 — "데스크탑 없이 자동화가 발동"이 실제론 안 됐다.
+ * 데스크탑 electron/launchd/agent.ts 와 같은 방식으로 ~/Library/LaunchAgents 에 plist 를 써서
+ * launchctl 로 로드한다. plist 는 coarse StartInterval(기본 300s)마다 `agentlas automation tick`
+ * (1회 due 스윕 후 종료)을 poke 한다. DB 가 스케줄 권위이고 plist 는 poke 만 하므로 자동화별
+ * plist 동기화가 필요 없다 — 데스크탑과 정확히 같은 계약.
+ *
+ * ★Label 은 데스크탑("ai.agentlas.automations")과 다르게 둔다("ai.agentlas.cli.automations").
+ *   둘 다 설치돼 있어도 공유 DB 의 lease(claimDue)가 이중 실행을 막으므로 공존은 안전하고,
+ *   서로의 plist 를 install/uninstall 로 덮지 않게 하려는 것.
+ *
+ * macOS 전용(launchd). 다른 OS 는 supported:false 로 정직하게 알린다(자동화는 포그라운드
+ * `automation daemon` 으로만 — 조용히 안 되는 척하지 않는다).
+ */
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { userDataDir } = require("../core/paths.cjs");
+
+const LABEL = "ai.agentlas.cli.automations";
+
+function isSupported() { return process.platform === "darwin"; }
+function plistPath() { return path.join(os.homedir(), "Library", "LaunchAgents", `${LABEL}.plist`); }
+function domainTarget() { return `gui/${os.userInfo().uid}`; }
+
+/** launchd 가 poke 할 CLI 진입점(절대경로). 전역 설치본이든 체크아웃이든 이 파일 기준으로 해석. */
+function cliEntry() { return path.resolve(__dirname, "..", "..", "bin", "agentlas.cjs"); }
+
+function logPath() {
+  const dir = path.join(userDataDir(), "logs");
+  try { fs.mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
+  return path.join(dir, "launchd-automations.log");
+}
+
+function plistXml(intervalSec = 300) {
+  const node = process.execPath;
+  const entry = cliEntry();
+  const log = logPath();
+  const esc = (s) => String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  return [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+    '<plist version="1.0">',
+    "<dict>",
+    "  <key>Label</key>",
+    `  <string>${LABEL}</string>`,
+    "  <key>ProgramArguments</key>",
+    "  <array>",
+    `    <string>${esc(node)}</string>`,
+    `    <string>${esc(entry)}</string>`,
+    "    <string>automation</string>",
+    "    <string>tick</string>",
+    "  </array>",
+    "  <key>StartInterval</key>",
+    `  <integer>${Math.max(30, Math.floor(intervalSec))}</integer>`,
+    "  <key>RunAtLoad</key>",
+    "  <true/>",
+    "  <key>ProcessType</key>",
+    "  <string>Background</string>",
+    "  <key>LowPriorityIO</key>",
+    "  <true/>",
+    "  <key>StandardOutPath</key>",
+    `  <string>${esc(log)}</string>`,
+    "  <key>StandardErrorPath</key>",
+    `  <string>${esc(log)}</string>`,
+    "</dict>",
+    "</plist>",
+    "",
+  ].join("\n");
+}
+
+/** launchctl 실행 — throw 하지 않고 {code, stderr} 반환(상태 함수가 판정). */
+function launchctl(args) {
+  const res = spawnSync("launchctl", args, { encoding: "utf8" });
+  return { code: res.status ?? -1, stderr: (res.stderr || "").trim() };
+}
+
+function isLoaded() {
+  if (!isSupported()) return false;
+  return launchctl(["print", `${domainTarget()}/${LABEL}`]).code === 0;
+}
+
+function launchdStatus() {
+  const supported = isSupported();
+  return {
+    supported,
+    installed: supported && fs.existsSync(plistPath()),
+    loaded: supported && isLoaded(),
+    plistPath: plistPath(),
+    label: LABEL,
+    entry: cliEntry(),
+  };
+}
+
+/** plist 작성 + launchctl bootstrap 로드(멱등 — 이미 로드면 bootout 후 재로드). */
+function enableLaunchd({ intervalSec = 300 } = {}) {
+  if (!isSupported()) return { ...launchdStatus(), error: "launchd persistence is macOS-only." };
+  const p = plistPath();
+  try {
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, plistXml(intervalSec), "utf8");
+  } catch (err) {
+    return { ...launchdStatus(), error: `failed to write plist: ${String(err)}` };
+  }
+  if (isLoaded()) launchctl(["bootout", `${domainTarget()}/${LABEL}`]);
+  const res = launchctl(["bootstrap", domainTarget(), p]);
+  if (res.code !== 0 && !isLoaded()) {
+    return { ...launchdStatus(), error: res.stderr || "launchctl bootstrap failed." };
+  }
+  return launchdStatus();
+}
+
+/** launchctl bootout + plist 삭제. */
+function disableLaunchd() {
+  if (!isSupported()) return launchdStatus();
+  if (isLoaded()) launchctl(["bootout", `${domainTarget()}/${LABEL}`]);
+  const p = plistPath();
+  try { if (fs.existsSync(p)) fs.rmSync(p); }
+  catch (err) { return { ...launchdStatus(), error: `failed to remove plist: ${String(err)}` }; }
+  return launchdStatus();
+}
+
+module.exports = {
+  LABEL, plistPath, plistXml, cliEntry, isSupported,
+  launchdStatus, enableLaunchd, disableLaunchd,
+};

package/engine/bootstrap-schema.sql

@@ -412,50 +412,12 @@ CREATE TABLE automation_runs (
       , last_activity_at TEXT, occurrence_id TEXT, graph_digest TEXT, checkpoint_json TEXT, resume_of_run_id TEXT);
 CREATE INDEX idx_automation_runs_auto
         ON automation_runs(automation_id, started_at);
-CREATE TRIGGER agentlas_auto_cua_social_insert
-AFTER INSERT ON automations
-WHEN NEW.tool_mode = 'auto' AND (
-  lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%reddit%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%instagram%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%threads%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%twitter%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%x.com%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%linkedin%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%facebook%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%tiktok%'
-  OR (lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%browser%' AND lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%post%')
-  OR (lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%web%' AND lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%login%')
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%레딧%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%인스타%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%댓글%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%게시%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%로그인%'
-)
-BEGIN
-  UPDATE automations SET tool_mode = 'computer-use' WHERE id = NEW.id;
-END;
-CREATE TRIGGER agentlas_auto_cua_social_update
-AFTER UPDATE OF name, prompt_template, tool_mode ON automations
-WHEN NEW.tool_mode = 'auto' AND (
-  lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%reddit%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%instagram%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%threads%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%twitter%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%x.com%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%linkedin%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%facebook%'
-  OR lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%tiktok%'
-  OR (lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%browser%' AND lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%post%')
-  OR (lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%web%' AND lower(coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'')) LIKE '%login%')
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%레딧%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%인스타%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%댓글%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%게시%'
-  OR coalesce(NEW.name,'') || ' ' || coalesce(NEW.prompt_template,'') LIKE '%로그인%'
-)
-BEGIN
-  UPDATE automations SET tool_mode = 'computer-use' WHERE id = NEW.id;
-END;
+-- (제거됨 2026-08-06) agentlas_auto_cua_social_insert/update 트리거가 여기 있었다.
+-- 소셜 키워드 목록("twitter/인스타/댓글/게시/로그인"…)으로 tool_mode를 computer-use로
+-- 강제 되돌리던 DB 차원 단어목록 판정 — 코드의 단어목록을 LLM 판정으로 대체할 때
+-- 이 트리거만 살아남아, 코드 리뷰가 볼 수 없는 곳에서 toolMode 도출 규칙을 무효화했다
+-- (실측: UPDATE tool_mode='auto'가 같은 연결에서 즉시 되돌아왔다). 판정을 DB 트리거로
+-- 만들지 않는다 — 판정은 코드·게이트가 보는 곳에만 산다.
 CREATE TABLE agent_evolution_proposals (
         id TEXT PRIMARY KEY,
         agent_id TEXT NOT NULL,