adde-acp 0.1.3

package/dist/core/session-ledger.js

@@ -0,0 +1,89 @@
+/**
+ * 세션 장부(state/<lane>/sessions.json) — /resume 목록·마지막 대화 시각의 SSOT.
+ * ACP session/list 는 어댑터 구현이 미확인이고 엔진 무관성이 필요해 ADDE 가 자체 관리한다.
+ * 갱신 주체는 직렬(injector·기동 시 supervisor)이라 파일 락 없이 atomic rewrite 로 충분.
+ */
+import { readFile } from "node:fs/promises";
+import { atomicWrite } from "../shared/fs-atomic.js";
+/** 장부 보존 상한 — 초과 시 마지막 대화가 오래된 항목부터 회전 제거. */
+const MAX_ENTRIES = 20;
+/** 장부 읽기 — 부재·파손은 빈 장부(보조 데이터, fail-open). */
+export async function readLedger(paths) {
+    try {
+        const raw = JSON.parse(await readFile(paths.sessionsFile, "utf8"));
+        if (!Array.isArray(raw))
+            return [];
+        return raw.filter((e) => typeof e === "object" &&
+            e !== null &&
+            typeof e.id === "string" &&
+            typeof e.createdAt === "string" &&
+            typeof e.lastActivityAt === "string");
+    }
+    catch {
+        return [];
+    }
+}
+async function writeLedger(paths, entries) {
+    const sorted = [...entries]
+        .sort((a, b) => b.lastActivityAt.localeCompare(a.lastActivityAt))
+        .slice(0, MAX_ENTRIES);
+    await atomicWrite(paths.sessionsFile, JSON.stringify(sorted, null, 2) + "\n");
+}
+/** 세션 목록의 시각 표기 — 로컬 `MM-DD HH:mm`(목록 가독 우선, 정밀 시각은 장부 파일에 보존). */
+export function formatWhen(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    const p = (n) => String(n).padStart(2, "0");
+    return `${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+/** 세션 id 허용 문자셋 — envelope 검증(CHANNEL_MSG_ID_RE)과 동일 계약(주입 방어). */
+const SESSION_ID_RE = /^[A-Za-z0-9_:-]+$/;
+/**
+ * resume 인자 → ControlRequest 해석(채널 공통). 무인자=목록(sessions), 숫자=장부 최신순
+ * 번호, 그 외=세션 id 직접 지정(문자셋 위반·번호 범위 밖은 sessionId 미지정 — 수신측이
+ * "재개할 세션 없음" 통지, fail-closed).
+ */
+export function resolveResumeControl(arg, entries) {
+    if (!arg)
+        return { kind: "sessions" };
+    if (/^\d+$/.test(arg)) {
+        const entry = entries[parseInt(arg, 10) - 1];
+        return entry ? { kind: "resume", sessionId: entry.id } : { kind: "resume" };
+    }
+    return SESSION_ID_RE.test(arg) ? { kind: "resume", sessionId: arg } : { kind: "resume" };
+}
+/** 세션 생성/복귀 시 upsert — 기존 항목이면 lastActivityAt 만 갱신. */
+export async function recordSession(paths, id) {
+    const now = new Date().toISOString();
+    const entries = await readLedger(paths);
+    const existing = entries.find((e) => e.id === id);
+    if (existing) {
+        existing.lastActivityAt = now;
+    }
+    else {
+        entries.push({ id, createdAt: now, lastActivityAt: now });
+    }
+    await writeLedger(paths, entries);
+}
+/** 턴 종료 시 마지막 대화 시각 갱신(+미기재 label 이면 발췌 기록). 항목 부재 시 생성. */
+export async function touchSession(paths, id, labelIfEmpty) {
+    const now = new Date().toISOString();
+    const entries = await readLedger(paths);
+    const existing = entries.find((e) => e.id === id);
+    if (existing) {
+        existing.lastActivityAt = now;
+        if (labelIfEmpty && !existing.label)
+            existing.label = labelIfEmpty;
+    }
+    else {
+        entries.push({
+            id,
+            createdAt: now,
+            lastActivityAt: now,
+            ...(labelIfEmpty ? { label: labelIfEmpty } : {}),
+        });
+    }
+    await writeLedger(paths, entries);
+}
+//# sourceMappingURL=session-ledger.js.map

package/dist/core/session-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-ledger.js","sourceRoot":"","sources":["../../src/core/session-ledger.ts"],"names":[],"mappings":"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"}

package/dist/core/supervisor.d.ts

@@ -0,0 +1,41 @@
+import type { AcpBackend } from "../backend/acp/client.js";
+/** 런타임 ACP 어댑터 바이너리 경로. package.json 의 bin 항목을 SoT 로 해석. */
+export declare function resolveAdapterBin(): string;
+/** 레인 기동 상태 결과. */
+export interface LaneStatus {
+    lane: string;
+    status: "running" | "error" | "stopped";
+    /** status==="error" 일 때 실패 사유(사용자 안내·doctor 유도용). */
+    error?: string;
+}
+/** supervisorUp 반환값. */
+export interface SupervisorUpResult {
+    lanes: LaneStatus[];
+    message: string;
+}
+/** supervisorDown 반환값. */
+export interface SupervisorDownResult {
+    lanes: LaneStatus[];
+    message: string;
+}
+/**
+ * ACP 백엔드 팩토리 — 테스트에서 주입 가능하도록 의존을 분리.
+ * (lane: string, adapterBin: string) → AcpBackend.
+ * 기본값: new AcpBackendImpl(adapterBin).
+ */
+export type AcpFactory = (lane: string, adapterBin: string) => AcpBackend;
+export interface SupervisorUpOptions {
+    base?: string;
+    acpFactory?: AcpFactory;
+}
+export interface SupervisorDownOptions {
+    base?: string;
+}
+/**
+ * `adde up <proj>` — lanes.d 의 conf 파일 스캔 → 레인별 기동.
+ */
+export declare function supervisorUp(proj: string, opts?: SupervisorUpOptions): Promise<SupervisorUpResult>;
+/**
+ * `adde down <proj>` — 프로젝트의 모든 레인 종료.
+ */
+export declare function supervisorDown(proj: string, _opts?: SupervisorDownOptions): Promise<SupervisorDownResult>;

package/dist/core/supervisor.js

@@ -0,0 +1,315 @@
+/**
+ * 레인 라이프사이클 수퍼바이저.
+ * lanes.d conf 스캔 → 레인별 기동·헬스.
+ * adde up → source/injector/backend/gate 인스턴스화 + 기동.
+ * adde down → 레인 프로세스 종료.
+ */
+import { readdir, readFile, mkdir } from "node:fs/promises";
+import { errMsg } from "../shared/errors.js";
+import { join, resolve } from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { parseLaneConf } from "../shared/conf.js";
+import { lanePaths, defaultBase, expandTilde } from "../shared/paths.js";
+import { secureLaneDirs } from "../shared/fs-atomic.js";
+import { parseCsv, resolveFileMode } from "./lane-config.js";
+import { AcpBackendImpl } from "../backend/acp/client.js";
+import { createInjector } from "./injector.js";
+import { recordSession } from "./session-ledger.js";
+import { createTelegramSource, createMarkdownSource } from "../src-adapters/index.js";
+import { selfAuthorizedChatId } from "../src-adapters/telegram.js";
+import { gateRequestDecision } from "../gate/gate.js";
+import { formatWarnNote, formatException } from "../shared/notify.js";
+import { maskSecrets } from "../shared/mask.js";
+import { t, tFor } from "../shared/i18n.js";
+import { writeRuntime, removeRuntime, touchRuntime, readRuntime, isPidAlive, HEARTBEAT_INTERVAL_MS, } from "./runtime-state.js";
+/** 런타임 ACP 어댑터 바이너리 경로. package.json 의 bin 항목을 SoT 로 해석. */
+export function resolveAdapterBin() {
+    const require = createRequire(import.meta.url);
+    try {
+        const pkgPath = require.resolve("@zed-industries/claude-code-acp/package.json");
+        const dir = pkgPath.slice(0, pkgPath.lastIndexOf("/package.json"));
+        const pkg = require(pkgPath);
+        const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.["claude-code-acp"];
+        if (binRel)
+            return resolve(dir, binRel);
+    }
+    catch {
+        // 폴백(.bin shim)으로 진행
+    }
+    const thisDir = fileURLToPath(new URL(".", import.meta.url));
+    return resolve(thisDir, "../../../node_modules/.bin/claude-code-acp");
+}
+const activeLanes = new Map();
+/** proj 별 하트비트 타이머 — up 이 등록, down 이 정리. */
+const heartbeats = new Map();
+/**
+ * proj 의 하트비트 타이머를 (재)설정한다. 기존 타이머는 먼저 정리(re-up 대비).
+ * 각 틱에 running 레인의 runtime.json mtime 만 touch(메타데이터 쓰기). `.unref()` 로
+ * 타이머 단독으로 프로세스를 살려두지 않는다(상주는 호출부 never-resolve promise 담당).
+ */
+function armHeartbeat(proj, handles) {
+    const existing = heartbeats.get(proj);
+    if (existing)
+        clearInterval(existing);
+    if (handles.length === 0) {
+        heartbeats.delete(proj);
+        return;
+    }
+    const timer = setInterval(() => {
+        for (const h of handles) {
+            // 하트비트는 보조 신호 — touch 실패는 warn 후 흡수(레인 동작에 영향 없음).
+            void touchRuntime(h.paths).catch((err) => console.warn(t("log.supervisor.heartbeatFail", { lane: h.lane, error: errMsg(err) })));
+        }
+    }, HEARTBEAT_INTERVAL_MS);
+    timer.unref();
+    heartbeats.set(proj, timer);
+}
+/** proj 하트비트 타이머 정리(down·셧다운). */
+function disarmHeartbeat(proj) {
+    const timer = heartbeats.get(proj);
+    if (timer)
+        clearInterval(timer);
+    heartbeats.delete(proj);
+}
+/**
+ * `adde up <proj>` — lanes.d 의 conf 파일 스캔 → 레인별 기동.
+ */
+export async function supervisorUp(proj, opts) {
+    const baseDir = opts?.base ?? defaultBase();
+    const projDir = join(baseDir, proj);
+    const lanesDir = join(projDir, "lanes.d");
+    await mkdir(lanesDir, { recursive: true });
+    let confFiles;
+    try {
+        confFiles = (await readdir(lanesDir)).filter((f) => f.endsWith(".conf"));
+    }
+    catch {
+        confFiles = [];
+    }
+    if (confFiles.length === 0) {
+        console.log(t("log.supervisor.noConf", { proj }));
+        return { lanes: [], message: t("supervisor.noLanesMsg", { proj }) };
+    }
+    const adapterBin = resolveAdapterBin();
+    const handles = [];
+    const results = [];
+    for (const confFile of confFiles) {
+        const lane = confFile.replace(/\.conf$/, "");
+        const confPath = join(lanesDir, confFile);
+        const confText = await readFile(confPath, "utf8");
+        const conf = parseLaneConf(confText);
+        // 사용자 입력 경로의 ~ 확장 (Node 는 자동 확장 안 함).
+        if (conf.cwd)
+            conf.cwd = expandTilde(conf.cwd);
+        if (conf.root)
+            conf.root = expandTilde(conf.root);
+        const paths = lanePaths(baseDir, proj, lane);
+        // 상태·출력·큐 디렉터리 권한 잠금(private=0700 / shared=no-op). chmod 실패는 보조
+        // 하드닝 신호 — warn 후 흡수(기동 자체는 진행, 권한 미적용은 로그로 가시화).
+        await secureLaneDirs([paths.stateDir, paths.outDir, paths.queueDir, paths.processingDir, paths.lanesDir], resolveFileMode(conf.file_mode)).catch((err) => console.warn(t("log.supervisor.securePermsFail", { lane, error: errMsg(err) })));
+        // 중복 기동 가드 — backend 생성 전 runtime.json + pid 생존 확인.
+        const existingRuntime = await readRuntime(paths);
+        if (existingRuntime !== null) {
+            if (isPidAlive(existingRuntime.pid)) {
+                // 이미 running — 경고+스킵.
+                process.stderr.write(t("supervisor.alreadyRunning", { lane, pid: existingRuntime.pid, proj }) + "\n");
+                results.push({ lane, status: "running" });
+                continue;
+            }
+            else {
+                // dead 레인 — 크래시 잔존 runtime.json 정리 후 정상 기동.
+                // 자식 pid 는 runtime.json 에 미기록(스키마 한계) — removeRuntime 으로 파일만 정리.
+                await removeRuntime(paths).catch((err) => console.warn(t("log.supervisor.deadCleanupFail", { lane, error: errMsg(err) })));
+            }
+        }
+        const channel = conf.source === "markdown" ? "markdown" : "telegram";
+        // 권한 경고(perm-diff 등)를 채널로도 표면화 — source 는 아래에서 생성되므로 지연 참조.
+        // 알림은 보조 신호: 전송 실패는 warn 후 흡수(레인 동작에 영향 없음).
+        const channelWarn = (msg) => {
+            void source
+                .notify(msg)
+                .catch((err) => console.warn(t("log.supervisor.channelWarnFail", { lane, error: errMsg(err) })));
+        };
+        let backend;
+        if (opts?.acpFactory) {
+            backend = opts.acpFactory(lane, adapterBin);
+        }
+        else {
+            const impl = new AcpBackendImpl(adapterBin);
+            impl.configureLane(lane, {
+                paths,
+                addePolicy: {
+                    perm_tier: conf.perm_tier,
+                    allowlist: conf.allowlist,
+                    denylist: conf.denylist,
+                    hard_deny: conf.hard_deny,
+                },
+                cwd: conf.cwd,
+                channel,
+                channelWarn,
+                lang: conf.lang,
+            });
+            backend = impl;
+        }
+        const pendingDecisions = new Map();
+        const engine = conf.engine || "claude";
+        let source;
+        // injector 를 source 보다 먼저 생성 — render 는 source 를 지연 참조(closure, turn 종료 시 호출).
+        // in-process 배선: source.onInbound → injector.notify, injector.render → source.renderOut.
+        // 주입 실패도 채널로 표면화(onFail → source.notify) — 채널 언어(레인 로케일)로 렌더.
+        const laneT = tFor(conf.lang);
+        const injector = createInjector(paths, lane, backend, (id) => source.renderOut(id), (id, detail) => 
+        // 채널 egress 는 마스킹 일관 적용 — 엔진 예외 메시지에 시크릿이 섞일 수 있다
+        // (.failed/콘솔 등 로컬 경로는 기존대로 원문 유지).
+        source.notify(formatException({
+            situation: laneT("injector.failNote.situation", { id, detail: maskSecrets(detail) }),
+            action: laneT("injector.failNote.action"),
+        }, laneT)), laneT);
+        const onInbound = () => injector.notify();
+        if (conf.source === "markdown") {
+            source = createMarkdownSource({ lane, proj, engine, paths, conf, onInbound });
+        }
+        else {
+            const chatId = conf.chat_id && !Number.isNaN(Number(conf.chat_id)) ? Number(conf.chat_id) : undefined;
+            // 인바운드/콜백 허용 발신자 = allow_from ∪ (개인 chat 인 chatId). 비면 어댑터가 fail-closed.
+            // 음수 chatId(그룹)는 인증 앵커 아님 — 멤버는 allow_from 으로만 인증(어댑터 병합 규칙과 동일).
+            const authorizedIds = [];
+            const selfAuth = selfAuthorizedChatId(chatId);
+            if (selfAuth !== undefined)
+                authorizedIds.push(selfAuth);
+            for (const raw of conf.allow_from ? parseCsv(conf.allow_from) : []) {
+                const n = Number(raw);
+                if (!Number.isNaN(n))
+                    authorizedIds.push(n);
+            }
+            source = createTelegramSource({
+                lane,
+                proj,
+                engine,
+                paths,
+                chatId,
+                authorizedIds,
+                onInbound,
+                lang: conf.lang,
+            });
+        }
+        source.onDecision((reqId, decision) => {
+            const resolve = pendingDecisions.get(reqId);
+            if (resolve) {
+                pendingDecisions.delete(reqId);
+                resolve(decision);
+            }
+        });
+        try {
+            // launch 가 레인 state 를 생성한다 — 구독·권한 핸들러 등록은 launch 이후라야 한다.
+            const { sessionId } = await backend.launch(lane);
+            // 세션 장부 기록(보조 — /resume 목록·마지막 대화 시각). 실패는 로그 후 흡수.
+            await recordSession(paths, sessionId).catch((err) => console.warn(t("log.supervisor.ledgerFail", { lane, error: errMsg(err) })));
+            // 엔진 세션 이벤트 → injector(응답 누적). injector 가 turn 종료에 writeOut + renderOut(B).
+            backend.subscribe(lane, (e) => injector.onSessionEvent(e));
+            backend.onPermissionRequest(lane, async (req) => {
+                const waitForDecision = () => new Promise((resolveFn) => {
+                    pendingDecisions.set(req.id, resolveFn);
+                });
+                const sendPermPrompt = async () => {
+                    await source.requestPermission(req);
+                };
+                try {
+                    return await gateRequestDecision(req, { sendPermPrompt, waitForDecision });
+                }
+                finally {
+                    // 모든 종결 경로(timeout·전송오류·정상결정)에서 대기자 정리 — timeout 시 영구 잔존 누수 제거.
+                    // 늦게 도착한 콜백은 빈 맵에서 no-op(무해).
+                    pendingDecisions.delete(req.id);
+                }
+            });
+            // 인젝터 기동은 비차단(첫 inject 가 turn 종료까지 블록될 수 있어 await 하지 않음).
+            // fire-and-forget 이므로 rejection 은 unhandled 가 되지 않도록 로깅한다.
+            void injector.start().catch((err) => {
+                console.error(t("log.supervisor.injectorStartFail", {
+                    lane,
+                    error: errMsg(err),
+                }));
+            });
+            source.start();
+            // autopass 레인 기동 배너 — 자동 허용 모드임을 채널에 명시(no-silent).
+            if (conf.perm_tier === "autopass") {
+                const tl = tFor(conf.lang);
+                const denyDesc = conf.denylist.length > 0
+                    ? tl("supervisor.autopassDenySome", { tools: conf.denylist.join(", ") })
+                    : tl("supervisor.autopassDenyEmpty");
+                const banner = formatWarnNote({
+                    situation: tl("supervisor.autopassBanner.situation", { denyDesc }),
+                    action: tl("supervisor.autopassBanner.action", { lane, proj }),
+                }, tl);
+                console.warn(`[supervisor] lane=${lane} ${banner}`);
+                channelWarn(banner);
+            }
+            // 라이브니스 상태 파일 — status 가 교차 프로세스로 읽는다. 기동 성공 후 기록.
+            // 기록 실패는 보조(가시성 저하일 뿐 기동 자체는 성공) → warn 후 흡수.
+            await writeRuntime(paths, {
+                v: 1,
+                pid: process.pid,
+                lane,
+                sessionId,
+                startedAt: new Date().toISOString(),
+                source: conf.source || channel,
+                backend: conf.backend || "acp",
+                engine,
+            }).catch((err) => console.warn(t("log.supervisor.runtimeWriteFail", { lane, error: errMsg(err) })));
+            console.log(`[supervisor] lane=${lane} running`);
+            handles.push({
+                lane,
+                paths,
+                // 정지 순서: 소스 먼저(신규 인바운드·turn 차단) → 백엔드 child 정리 → 상태 파일 제거.
+                async stop() {
+                    await source.stop();
+                    await backend.close(lane);
+                    await removeRuntime(paths).catch((err) => console.warn(t("log.supervisor.runtimeRemoveFail", { lane, error: errMsg(err) })));
+                },
+            });
+            results.push({ lane, status: "running" });
+        }
+        catch (err) {
+            const reason = errMsg(err);
+            console.error(t("log.supervisor.laneStartFail", { lane, reason }));
+            results.push({ lane, status: "error", error: reason });
+        }
+    }
+    const existing = activeLanes.get(proj) ?? [];
+    const merged = [...existing, ...handles];
+    activeLanes.set(proj, merged);
+    // 하트비트는 기동된 레인이 있을 때만(merged 전체 대상 — re-up 시 기존+신규 함께 touch).
+    armHeartbeat(proj, merged);
+    const runningCount = results.filter((r) => r.status === "running").length;
+    const newlyStarted = handles.length;
+    const skipped = runningCount - newlyStarted;
+    const messageParts = [t("supervisor.upStarted", { proj, count: newlyStarted })];
+    if (skipped > 0)
+        messageParts.push(t("supervisor.upSkipped", { count: skipped }));
+    return {
+        lanes: results,
+        message: messageParts.join(", "),
+    };
+}
+/**
+ * `adde down <proj>` — 프로젝트의 모든 레인 종료.
+ */
+export async function supervisorDown(proj, _opts) {
+    const handles = activeLanes.get(proj) ?? [];
+    const results = [];
+    // 하트비트 먼저 정지 — 종료 중 runtime.json touch/제거 레이스 방지.
+    disarmHeartbeat(proj);
+    for (const handle of handles) {
+        await handle.stop();
+        console.log(`[supervisor] lane=${handle.lane} stopped`);
+        results.push({ lane: handle.lane, status: "stopped" });
+    }
+    activeLanes.delete(proj);
+    return {
+        lanes: results,
+        message: t("supervisor.downStopped", { proj, count: results.length }),
+    };
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/core/supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/core/supervisor.ts"],"names":[],"mappings":"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"}

package/dist/core/transcript.d.ts

@@ -0,0 +1,22 @@
+import type { LanePaths } from "../shared/paths.js";
+/**
+ * session 이벤트 — ACP SDK sessionUpdate 형식 또는 단순 type/content 형식 모두 수용.
+ * ACP SDK: { sessionUpdate: string; ... }
+ * Telegram adapter / 간단한 이벤트: { type: string; ... }
+ */
+export type SessionEvent = {
+    [key: string]: unknown;
+} & ({
+    sessionUpdate: string;
+} | {
+    type: string;
+});
+/**
+ * session/update 이벤트를 사람이 읽을 텍스트 줄로 렌더.
+ */
+export declare function renderEvent(event: SessionEvent): string;
+/**
+ * transcript.log 에 이벤트를 append.
+ * 보조 실패(파일 append 오류)는 warn↑ 로그 후 흡수.
+ */
+export declare function appendTranscript(paths: LanePaths, event: SessionEvent): Promise<void>;

package/dist/core/transcript.js

@@ -0,0 +1,93 @@
+/**
+ * transcript 렌더·append·마스킹.
+ * session/update 이벤트를 사람이 읽을 텍스트로 렌더 → mask → append.
+ * append 실패는 보조(warn↑ 로그 후 흡수) — error-handling.md 보조 분류.
+ */
+import { t } from "../shared/i18n.js";
+import { errMsg } from "../shared/errors.js";
+import { appendFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { maskSecrets } from "../shared/mask.js";
+/** sessionUpdate 키 추출 — 두 형식 모두 지원. */
+function getEventKind(event) {
+    if ("sessionUpdate" in event && typeof event["sessionUpdate"] === "string") {
+        return event["sessionUpdate"];
+    }
+    if ("type" in event && typeof event["type"] === "string") {
+        return event["type"];
+    }
+    return "unknown";
+}
+/**
+ * session/update 이벤트를 사람이 읽을 텍스트 줄로 렌더.
+ */
+export function renderEvent(event) {
+    const ts = new Date().toISOString();
+    const kind = getEventKind(event);
+    switch (kind) {
+        case "agent_message_chunk": {
+            // ACP SDK 형식: content 가 { type, text } 객체
+            // 단순 형식: content 가 string
+            const rawContent = event["content"];
+            let text;
+            if (typeof rawContent === "string") {
+                text = rawContent;
+            }
+            else if (rawContent && typeof rawContent === "object") {
+                const c = rawContent;
+                text = c.type === "text" ? (c.text ?? "") : "";
+            }
+            else {
+                text = "";
+            }
+            return `[${ts}] agent: ${text}`;
+        }
+        case "available_commands_update":
+            return t("transcript.commandsUpdated", { ts });
+        case "current_mode_update": {
+            const mode = event["mode"];
+            return `[${ts}] mode_update: ${JSON.stringify(mode)}`;
+        }
+        case "usage_update": {
+            const usage = event["usage"];
+            return `[${ts}] usage: ${JSON.stringify(usage)}`;
+        }
+        case "tool_call": {
+            const toolCall = event["toolCall"];
+            return `[${ts}] tool_call: ${JSON.stringify(toolCall)}`;
+        }
+        case "session_info_update": {
+            const info = event["sessionInfo"];
+            return `[${ts}] session_info: ${JSON.stringify(info)}`;
+        }
+        default:
+            return `[${ts}] ${kind}: ${JSON.stringify(event)}`;
+    }
+}
+/**
+ * transcript.log 에 이벤트를 append.
+ * 보조 실패(파일 append 오류)는 warn↑ 로그 후 흡수.
+ */
+export async function appendTranscript(paths, event) {
+    const rendered = renderEvent(event);
+    const masked = maskSecrets(rendered);
+    const line = `${masked}\n`;
+    try {
+        await mkdir(dirname(paths.transcriptLog), { recursive: true });
+        await appendFile(paths.transcriptLog, line, "utf8");
+    }
+    catch (err) {
+        // 감사 이벤트(차단 경고·자동허용)는 소실 시 감사 추적이 불완전해진다 → error 로 승격(E2).
+        // 일반 이벤트는 보조 분류로 warn 후 흡수.
+        const kind = getEventKind(event);
+        const isAudit = kind === "adde_warn" || kind === "adde_auto_allow";
+        const detail = errMsg(err);
+        if (isAudit) {
+            console.error(t("log.transcript.auditAppendFail", { kind, detail }));
+        }
+        else {
+            console.warn(t("log.transcript.appendFail", { detail }));
+        }
+    }
+}
+//# sourceMappingURL=transcript.js.map

package/dist/core/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/core/transcript.ts"],"names":[],"mappings":"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"}

package/dist/core/update-check.d.ts

@@ -0,0 +1,25 @@
+export interface UpdateCheckOptions {
+    base?: string;
+    currentVersion?: string;
+    /** 네트워크 조회 허용(대화형에서만 true 권장). false 면 캐시만 사용해 지연 0. */
+    allowNetwork?: boolean;
+    now?: number;
+    ttlMs?: number;
+    /** 테스트 주입용 fetch. 미지정 시 global fetch. */
+    fetchImpl?: typeof fetch;
+    /** 환경 opt-out(테스트 주입). 미지정 시 process.env.ADDE_NO_UPDATE_CHECK. */
+    optOut?: string | undefined;
+}
+/** a<b → -1, a>b → 1, 같음/비교불가 → 0. 프리릴리스는 동일 core 의 정식 릴리스보다 낮다. */
+export declare function compareSemver(a: string, b: string): number;
+export interface UpdateNotice {
+    current: string;
+    latest: string;
+}
+/**
+ * 업데이트 여부 판정 — 새 버전이 있으면 {current, latest}, 없으면 null.
+ * 캐시가 신선하면 캐시만 사용, 오래됐고 allowNetwork 면 레지스트리 조회 후 캐시 갱신.
+ */
+export declare function checkForUpdate(opts?: UpdateCheckOptions): Promise<UpdateNotice | null>;
+/** 업데이트 안내 문구. 표면 계층이 stdout 에 덧붙인다. */
+export declare function formatUpdateNotice(notice: UpdateNotice): string;