agentlas 1.0.28 → 1.0.35

package/engine/commands/doctor.cjs

@@ -9,6 +9,7 @@ const fs = require("node:fs");
 const path = require("node:path");
 const { dbPath, userDataDir } = require("../core/paths.cjs");
 const { listAvailableCliRuntimes, activeRuntimeRow } = require("../runtimes/detect.cjs");
+const { runtimeAuthEvidence } = require("../runtimes/auth-evidence.cjs");
 const { resolvedModelRole } = require("../runtimes/roles.cjs");
 
 function roleDetail(selection, role, en) {
@@ -23,11 +24,32 @@ function roleDetail(selection, role, en) {
   ].filter(Boolean).join(" · ");
 }
 
-function run(ctx) {
+function run(ctx, args = []) {
   const en = ctx.lang === "en";
+  // clig.dev: 스크립트 소비자를 위한 기계 계약. 사람용 줄과 같은 사실만 담는다.
+  if (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);
+    return (() => {
+      ctx.out(JSON.stringify({
+        database: { path: dbPath(), exists: fs.existsSync(dbPath()) },
+        runtimes: clis,
+        activeRuntime: active ? { ...active, authEvidence: runtimeAuthEvidence(active.kind).status } : null,
+        modelRoles: {
+          orchestrator: resolvedModelRole(db, "orchestrator"),
+          worker: resolvedModelRole(db, "worker"),
+        },
+        cloudSession: Boolean(process.env.AGENTLAS_SESSION) || fs.existsSync(path.join(userDataDir(), "auth", "cli-session.v1.json")),
+      }, null, 2));
+      return 0;
+    })();
+  }
   let failures = 0;
+  let warnings = 0;
   const ok = (label, detail) => ctx.out(`  ${ctx.ui.green("✓")} ${label}${detail ? ctx.ui.dim(" — " + detail) : ""}`);
   const bad = (label, detail) => { failures += 1; ctx.out(`  ${ctx.ui.red("✗")} ${label}${detail ? ctx.ui.dim(" — " + detail) : ""}`); };
+  const warn = (label, detail) => { warnings += 1; ctx.out(`  ${ctx.ui.yellow ? ctx.ui.yellow("!") : "!"} ${label}${detail ? ctx.ui.dim(" — " + detail) : ""}`); };
 
   // 1) 데이터
   const p = dbPath();
@@ -43,10 +65,28 @@ function run(ctx) {
     bad(en ? "database" : "데이터베이스", (en ? "missing: " : "없음: ") + p);
   }
 
-  // 2) 런타임
+  // 2) 런타임 — 설치 여부와 인증 흔적은 다른 축이다. which()만 보면 로그아웃
+  // 상태에서도 all clear가 나간다(2026-08-05 실측). 각 CLI가 로그인 시 남기는
+  // 로컬 산출물을 증거로 관측하고, 증거≠증명이므로 문구도 단정하지 않는다.
   const clis = listAvailableCliRuntimes();
   if (clis.length) {
-    ok(en ? "runtimes" : "런타임", clis.map((c) => `${c.kind}`).join(", "));
+    const evidences = clis.map((c) => ({ kind: c.kind, evidence: runtimeAuthEvidence(c.kind) }));
+    const annotated = evidences.map(({ kind, evidence }) => {
+      if (evidence.status === "none") return `${kind}(${en ? "no sign-in evidence" : "로그인 흔적 없음"})`;
+      return kind; // evidence 또는 unknown — 검사법이 없는 런타임을 미로그인으로 표시하지 않는다
+    });
+    ok(en ? "runtimes" : "런타임", annotated.join(", "));
+    // 신규 설치 상태: 검사 가능한 런타임 전부가 흔적 없음이면 첫 실행이 거의
+    // 확실히 실패한다 — 활성 런타임 행이 아직 없어도 여기서 경고한다.
+    const checkable = evidences.filter(({ evidence }) => evidence.status !== "unknown");
+    if (checkable.length && checkable.every(({ evidence }) => evidence.status === "none")) {
+      warn(
+        en ? "runtime sign-in" : "런타임 로그인",
+        en
+          ? "no detected runtime has local sign-in evidence — sign in to one before running (e.g. claude / codex login / gemini)"
+          : "감지된 어떤 런타임에도 로그인 흔적이 없습니다 — 실행 전에 하나는 로그인하세요 (예: claude / codex login / gemini)",
+      );
+    }
   } else {
     bad(en ? "runtimes" : "런타임", en
       ? "no agent CLI on PATH (claude / codex / gemini / kimi / grok / cursor-agent)"
@@ -57,7 +97,23 @@ function run(ctx) {
   try {
     const db = ctx.db();
     const active = activeRuntimeRow(db);
-    if (active) ok(en ? "active runtime" : "활성 런타임", `${active.kind}${active.model ? ` (${active.model})` : ""}`);
+    if (active) {
+      const detail = `${active.kind}${active.model ? ` (${active.model})` : ""}`;
+      // 활성 런타임은 모든 실행이 지나는 문이다 — 로그인 흔적이 없으면 all clear
+      // 가 아니라 경고다. 흔적 없음 = 미로그인 "가능성"이므로 단정하지 않는다.
+      const evidence = runtimeAuthEvidence(active.kind);
+      if (evidence.status === "none") {
+        const bin = { "claude-code": "claude", codex: "codex", gemini: "gemini" }[active.kind] || active.kind;
+        warn(
+          en ? "active runtime" : "활성 런타임",
+          en
+            ? `${detail} — no local sign-in evidence; runs may fail until you sign in (try: ${bin} login)`
+            : `${detail} — 로그인 흔적이 없습니다. 로그인 전에는 실행이 실패할 수 있습니다 (시도: ${bin} login)`,
+        );
+      } else {
+        ok(en ? "active runtime" : "활성 런타임", detail);
+      }
+    }
     const orchestrator = resolvedModelRole(db, "orchestrator");
     const worker = resolvedModelRole(db, "worker");
     if (orchestrator && worker) {
@@ -83,6 +139,12 @@ function run(ctx) {
     ctx.out(en ? `doctor: ${failures} problem(s) found` : `doctor: 문제 ${failures}건`);
     return 1;
   }
+  if (warnings) {
+    // 경고가 있으면 "이상 없음"이라고 말하지 않는다 — 그 문구가 첫 실행 실패를
+    // 배신으로 만든다. 경고는 실행을 막지 않으므로 exit 0.
+    ctx.out(en ? `doctor: ${warnings} warning(s) — runnable, but check the lines above` : `doctor: 경고 ${warnings}건 — 실행은 가능하나 위 항목을 확인하세요`);
+    return 0;
+  }
   ctx.out(en ? "doctor: all clear" : "doctor: 이상 없음");
   return 0;
 }

package/engine/commands/document.cjs

@@ -0,0 +1,79 @@
+"use strict";
+/*
+ * document — 문서 산출(2026-08-06). 지금은 PDF 내보내기.
+ *
+ * 오너 원칙("터미널인데 모든 기능이 다 돼야"): 데스크탑 document/export-pdf.ts 는 offscreen
+ * BrowserWindow.printToPDF 로 HTML/URL 을 PDF 로 굽는다. 터미널은 같은 메커니즘을 CDP
+ * Page.printToPDF(engine/browser/cdp.cjs)로 한다 — GUI 창 없이 Agentlas 전용 Chrome 에서.
+ *
+ *   document pdf <html-file|url> [-o out.pdf] [--landscape]
+ *
+ * 로컬 HTML 파일은 file:// 로, http(s) 는 그대로 연다. 브라우저(CDP)가 없으면 정직하게
+ * 멈추고 먼저 띄우도록 안내한다(조용히 안 되는 척하지 않는다).
+ */
+const path = require("node:path");
+const fs = require("node:fs");
+const cdp = require("../browser/cdp.cjs");
+
+function usage(ko) {
+  return ko
+    ? "사용법: agentlas document pdf <html파일|url> [-o 출력.pdf] [--landscape]"
+    : "Usage: agentlas document pdf <html-file|url> [-o out.pdf] [--landscape]";
+}
+
+function toUrl(src) {
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(src)) return src;           // http(s):// · file:// · data:
+  return "file://" + path.resolve(src);                            // 로컬 파일
+}
+
+async function toPdf(ctx, args) {
+  const ko = ctx.lang === "ko";
+  const flags = { landscape: args.includes("--landscape") };
+  const oi = args.indexOf("-o");
+  const out = oi >= 0 && args[oi + 1] ? args[oi + 1] : null;
+  const src = args.find((a, i) => a && !String(a).startsWith("-") && (oi < 0 || i !== oi + 1));
+  if (!src) { ctx.err(usage(ko)); return 1; }
+
+  // 로컬 파일이면 존재 확인(없는 걸 조용히 빈 PDF 로 굽지 않는다).
+  if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(src) && !fs.existsSync(path.resolve(src))) {
+    ctx.err((ko ? "파일이 없습니다: " : "no such file: ") + src);
+    return 1;
+  }
+  const url = toUrl(src);
+  const outPath = path.resolve(out || (src.replace(/^https?:\/\//, "").replace(/[^\w.-]+/g, "_").replace(/\.(html?|md)$/i, "") || "document") + ".pdf");
+
+  if (!(await cdp.cdpReady())) {
+    ctx.err(ko
+      ? `Agentlas 브라우저가 실행 중이 아닙니다. 먼저 띄우세요: agentlas browser ${url}`
+      : `The Agentlas browser is not running. Start it first: agentlas browser ${url}`);
+    return 1;
+  }
+  let page;
+  try {
+    if (typeof ctx.ui.startSpinner === "function") ctx.ui.startSpinner(ko ? "PDF 굽는 중…" : "Rendering PDF…");
+    page = await cdp.attachPage();
+    await page.navigate(url, { waitMs: 1800 });
+    await page.waitFor("document.readyState === 'complete'", { timeoutMs: 8000 });
+    const r = await page.printPdf(outPath, { landscape: flags.landscape });
+    if (typeof ctx.ui.stopSpinner === "function") ctx.ui.stopSpinner();
+    ctx.out(`${ctx.ui.green("✓")} ${ko ? "PDF 를 만들었습니다" : "wrote PDF"}: ${r.path} ${ctx.ui.dim(`(${Math.round(r.bytes / 1024)} KB)`)}`);
+    return 0;
+  } catch (e) {
+    if (typeof ctx.ui.stopSpinner === "function") ctx.ui.stopSpinner();
+    ctx.err(`${ctx.ui.red("✖")} ${String((e && e.message) || e)}`);
+    return 1;
+  } finally {
+    if (page) page.close();
+  }
+}
+
+async function run(ctx, args) {
+  const ko = ctx.lang === "ko";
+  const sub = String(args[0] || "").toLowerCase();
+  if (!sub || sub === "help" || sub === "-h" || sub === "--help") { ctx.out(usage(ko)); return 0; }
+  if (sub === "pdf") return toPdf(ctx, args.slice(1));
+  ctx.err(usage(ko));
+  return 1;
+}
+
+module.exports = { run };