adde-acp 0.1.3

package/dist/core/injector.js

@@ -0,0 +1,297 @@
+/**
+ * 직렬 idle 게이트·dedup·turn 라이프사이클 루프.
+ * state=idle|active. active 동안 다음 envelope 미주입.
+ * 크래시 재개: 기동 시 scanProcessing → 각 id 에 isDone? 스킵 : 재처리.
+ * 응답 캡처: backend.inject() resolve(=turn 종료) 시 누적 응답을 writeOut + 렌더 트리거 → 다음 큐 진행.
+ *   turn 종료 신호는 inject() resolve 로 감지한다(conn.prompt 가 turn 종료에 resolve) — 별도 idleCallback 배선 불요.
+ */
+import { t } from "../shared/i18n.js";
+import { readFile } from "node:fs/promises";
+import { appendTranscript } from "./transcript.js";
+import { recordSession, touchSession, readLedger, formatWhen } from "./session-ledger.js";
+import { errMsg } from "../shared/errors.js";
+import { claimNext, scanProcessing, isDone, writeOut, writeFailed, processingFilePath, markSent, isSent, findUnsent, quarantineCorrupt, } from "./queue.js";
+import { maskSecrets } from "../shared/mask.js";
+import { parseEnvelope } from "../shared/envelope.js";
+/** agent_message_chunk 이벤트 종류 판정(ACP sessionUpdate / 단순 type 양식 모두). */
+function isAgentMessageChunk(event) {
+    const kind = "sessionUpdate" in event && typeof event["sessionUpdate"] === "string"
+        ? event["sessionUpdate"]
+        : "type" in event && typeof event["type"] === "string"
+            ? event["type"]
+            : "";
+    return kind === "agent_message_chunk";
+}
+/** 질문 발췌(첫 줄 80자, 마스킹) — 채널 렌더 헤더의 맥락 표시용 보조 정보. */
+export function questionExcerpt(text) {
+    const firstLine = text.split("\n", 1)[0] ?? "";
+    const masked = maskSecrets(firstLine.trim());
+    return masked.length > 80 ? `${masked.slice(0, 79)}…` : masked;
+}
+/** agent_message_chunk content 에서 텍스트 추출(string | {type,text}). */
+function chunkText(event) {
+    const raw = event["content"];
+    if (typeof raw === "string")
+        return raw;
+    if (raw && typeof raw === "object") {
+        const c = raw;
+        return c.type === "text" ? (c.text ?? "") : "";
+    }
+    return "";
+}
+export function createInjector(paths, lane, backend, render, onFail, 
+/** 제어 결과 등 채널 대면 문구의 로케일(레인 lang). 미지정 시 전역 t. */
+laneT = t) {
+    let state = "idle";
+    let responseText = "";
+    // claim→처리 진입을 직렬화(E4): idle 체크와 processOne(state=active) 사이의 두 await(claimNext·isDone)
+    // 창에서 두 injectNext 가 각각 다른 메시지를 claim 해 동시 turn 이 뜨는 경합 방지(rename 은 동일
+    // 메시지 중복만 막음). advancing 은 injectNext 전 구간을 감싸 한 번에 하나만 진행하게 한다.
+    let advancing = false;
+    // 전송 중인 id — start() 의 flushUnsent 는 advancing 가드 밖이라, 기동 중 notify 발 injectNext 의
+    // flushUnsent 와 동시 진입할 수 있다. deliver 진입 가드(in-flight Set + isSent 재확인)로 같은 응답의
+    // 이중 전송(중복 render)을 차단한다.
+    const delivering = new Set();
+    function onSessionEvent(event) {
+        if (state !== "active")
+            return;
+        if (isAgentMessageChunk(event))
+            responseText += chunkText(event);
+    }
+    /** state/<lane>/session.id 읽기 — 장부 갱신용(부재 시 null, 보조 데이터). */
+    async function currentSessionId() {
+        try {
+            return (await readFile(paths.sessionIdFile, "utf8")).trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** 제어 요청 수행 — 채널 통지 문구를 반환(레인 로케일). 실패는 throw(처리부 공통 실패 경로). */
+    async function runControl(envelope) {
+        const control = envelope.control;
+        switch (control.kind) {
+            case "clear": {
+                if (!backend.reset)
+                    return laneT("injector.control.unsupported");
+                let sessionId;
+                try {
+                    ({ sessionId } = await backend.reset(lane));
+                }
+                catch (err) {
+                    // 재기동 실패 = 레인 엔진 사망 가능 — 일반 실패와 구분해 복구 절차를 명시 통지.
+                    console.error(t("log.injector.relaunchError", { lane, error: errMsg(err) }));
+                    return laneT("injector.control.relaunchFailed", { error: maskSecrets(errMsg(err)) });
+                }
+                await recordSession(paths, sessionId).catch(() => { });
+                return laneT("injector.control.cleared");
+            }
+            case "compact": {
+                // 엔진 위임 — 슬래시 텍스트를 그대로 주입하면 엔진이 compaction 수행.
+                // 어댑터가 커맨드 출력을 삼키므로(local-command-stdout) 완료 통지는 여기서 생성.
+                await backend.inject(lane, "/compact");
+                const sid = await currentSessionId();
+                if (sid)
+                    await touchSession(paths, sid).catch(() => { });
+                return laneT("injector.control.compacted");
+            }
+            case "resume": {
+                if (!backend.resumeSession)
+                    return laneT("injector.control.unsupported");
+                if (!control.sessionId)
+                    return laneT("injector.control.resumeMissing");
+                let r;
+                try {
+                    r = await backend.resumeSession(lane, control.sessionId);
+                }
+                catch (err) {
+                    console.error(t("log.injector.relaunchError", { lane, error: errMsg(err) }));
+                    return laneT("injector.control.relaunchFailed", { error: maskSecrets(errMsg(err)) });
+                }
+                await recordSession(paths, r.sessionId).catch(() => { });
+                return r.resumed
+                    ? laneT("injector.control.resumed", { id: r.sessionId })
+                    : laneT("injector.control.resumeFallback", { id: control.sessionId });
+            }
+            case "sessions": {
+                const entries = await readLedger(paths);
+                if (entries.length === 0)
+                    return laneT("injector.control.sessionsEmpty");
+                const current = await currentSessionId();
+                const lines = entries.map((e, i) => {
+                    const label = e.label ?? laneT("injector.control.sessionsNoLabel");
+                    const mark = e.id === current ? " ◀" : "";
+                    return (laneT("injector.control.sessionsItem", {
+                        n: i + 1,
+                        label,
+                        last: formatWhen(e.lastActivityAt),
+                        id: e.id,
+                    }) + mark);
+                });
+                return `${laneT("injector.control.sessionsHeader")}\n${lines.join("\n")}\n\n${laneT("injector.control.sessionsHint")}`;
+            }
+        }
+    }
+    /** 한 메시지의 turn 을 처리: inject → (turn 종료) 응답 기록 + 렌더. 제어 envelope 는 세션 제어로 분기. */
+    async function processOne(id, envelope) {
+        state = "active";
+        responseText = "";
+        try {
+            if (envelope.control) {
+                const message = await runControl(envelope);
+                await appendTranscript(paths, {
+                    sessionUpdate: "adde_control",
+                    message: `${envelope.control.kind}: ${message}`,
+                }).catch(() => { });
+                const sidecar = { ts: new Date().toISOString(), origin_ts: envelope.ts };
+                if (envelope.reply_ref?.channel_msg_id) {
+                    sidecar.reply_ref = { channel_msg_id: envelope.reply_ref.channel_msg_id };
+                }
+                await writeOut(paths, id, message, sidecar);
+                await deliver(id);
+                return;
+            }
+            await backend.inject(lane, envelope.text);
+            // inject resolve = turn 종료 — 누적 응답을 마스킹 후 out 기록 + 렌더.
+            const sidecar = { ts: new Date().toISOString(), origin_ts: envelope.ts };
+            if (envelope.reply_ref?.channel_msg_id) {
+                sidecar.reply_ref = { channel_msg_id: envelope.reply_ref.channel_msg_id };
+            }
+            const question = questionExcerpt(envelope.text);
+            if (question.length > 0)
+                sidecar.question = question;
+            await writeOut(paths, id, maskSecrets(responseText), sidecar);
+            await deliver(id);
+            // 세션 장부 갱신(보조): 마지막 대화 시각 + 미기재 시 첫 프롬프트 발췌를 라벨로.
+            const sid = await currentSessionId();
+            if (sid)
+                await touchSession(paths, sid, question || undefined).catch(() => { });
+        }
+        catch (err) {
+            const detail = errMsg(err);
+            console.error(t("log.injector.injectError", { lane, id, detail }));
+            // 실패를 .failed 사이드카로 보존(E1) — processing/<id>.msg 는 남아 재기동 시 재처리(at-least-once).
+            await writeFailed(paths, id, t("injector.injectFailed", { ts: new Date().toISOString(), detail })).catch((e) => console.error(t("log.injector.failedWriteFail", {
+                lane,
+                id,
+                error: errMsg(e),
+            })));
+            // 실패를 채널에도 표면화(보조) — 노트/메시지 없이 조용히 사라진 것처럼 보이는 것을 방지.
+            if (onFail) {
+                await onFail(id, detail).catch((e) => console.error(t("log.injector.failNotifyError", {
+                    lane,
+                    id,
+                    error: errMsg(e),
+                })));
+            }
+        }
+        finally {
+            state = "idle";
+            responseText = "";
+        }
+    }
+    /**
+     * 응답을 채널로 전송하고 성공 시 .sent 마커 기록.
+     * render 실패(부분 청크 실패 포함)는 .sent 미기록 → out/ 에 durable 하게 남아 재전송 대상(flushUnsent).
+     */
+    async function deliver(id) {
+        // 이중 전송 가드: in-flight 클레임은 await 이전에 동기적으로 잡아야 두 동시 호출이 모두 통과하는
+        // 창이 없다. add 후 .sent 재확인으로 직전(완료된) flush 가 이미 보낸 경우(stale 목록)도 건너뛴다.
+        if (delivering.has(id))
+            return;
+        delivering.add(id);
+        try {
+            if (await isSent(paths, id))
+                return;
+            if (!render) {
+                // 렌더 대상 없음(예: chat_id 미설정) — 전송 개념 부재로 즉시 종결 처리.
+                await markSent(paths, id);
+                return;
+            }
+            await render(id);
+            await markSent(paths, id);
+        }
+        catch (err) {
+            console.error(t("log.injector.renderError", {
+                lane,
+                id,
+                error: errMsg(err),
+            }));
+        }
+        finally {
+            delivering.delete(id);
+        }
+    }
+    /** out/ 에 응답은 있으나(.out) 미전송(.sent 부재)인 항목 재전송 — render 실패·크래시 복구. */
+    async function flushUnsent() {
+        const ids = await findUnsent(paths);
+        for (const id of ids)
+            await deliver(id);
+    }
+    /** 다음 injectNext 를 비동기 예약 — rejection(예: 일시적 fs 오류)은 로깅(unhandled 방지). */
+    function scheduleNext() {
+        setImmediate(() => {
+            void injectNext().catch((err) => {
+                console.error(t("log.injector.advanceError", {
+                    lane,
+                    error: errMsg(err),
+                }));
+            });
+        });
+    }
+    async function injectNext() {
+        if (state !== "idle" || advancing)
+            return;
+        advancing = true;
+        try {
+            // 미전송(.out 있고 .sent 부재) 응답을 먼저 재전송 — render 실패·크래시 복구.
+            await flushUnsent();
+            const claimed = await claimNext(paths);
+            if (!claimed)
+                return;
+            const { id, envelope } = claimed;
+            if (await isDone(paths, id)) {
+                // dedup: out 이미 존재 → prompt 미호출, 다음으로 진행.
+                scheduleNext();
+                return;
+            }
+            await processOne(id, envelope);
+            // turn 종료 후 다음 큐 메시지로 진행.
+            scheduleNext();
+        }
+        finally {
+            advancing = false;
+        }
+    }
+    async function start() {
+        // 크래시 재개: 응답은 기록됐으나 미전송된 항목 먼저 재전송.
+        await flushUnsent();
+        // processing 잔존 파일을 순차 재처리.
+        const pendingIds = await scanProcessing(paths);
+        for (const id of pendingIds) {
+            if (await isDone(paths, id))
+                continue; // dedup — 이미 out 있음
+            let envelope;
+            try {
+                const { readFile } = await import("node:fs/promises");
+                envelope = parseEnvelope(await readFile(processingFilePath(paths, id), "utf8"));
+            }
+            catch (err) {
+                // 손상 메시지 — 격리 후 다음으로(매 기동 동일 파싱오류 반복 차단).
+                await quarantineCorrupt(paths, id, err);
+                continue;
+            }
+            await processOne(id, envelope); // processOne 은 자체 try/catch(.failed)로 throw 하지 않음
+        }
+        await injectNext();
+    }
+    function notify() {
+        scheduleNext();
+    }
+    function getState() {
+        return state;
+    }
+    return { start, notify, onSessionEvent, getState };
+}
+export { writeOut };
+//# sourceMappingURL=injector.js.map

package/dist/core/injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../../src/core/injector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,cAAc,EACd,MAAM,EACN,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,MAAM,EACN,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAuBtD,wEAAwE;AACxE,SAAS,mBAAmB,CAAC,KAAmB;IAC9C,MAAM,IAAI,GACR,eAAe,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,eAAe,CAAC,KAAK,QAAQ;QACpE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;QACxB,CAAC,CAAC,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;YACpD,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YACf,CAAC,CAAC,EAAE,CAAC;IACX,OAAO,IAAI,KAAK,qBAAqB,CAAC;AACxC,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACjE,CAAC;AAED,mEAAmE;AACnE,SAAS,SAAS,CAAC,KAAmB;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,GAAuC,CAAC;QAClD,OAAO,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,IAAY,EACZ,OAAmB,EACnB,MAAuB,EACvB,MAA2B;AAC3B,kDAAkD;AAClD,QAAiB,CAAC;IAElB,IAAI,KAAK,GAAkB,MAAM,CAAC;IAClC,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,wFAAwF;IACxF,uEAAuE;IACvE,iEAAiE;IACjE,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,kFAAkF;IAClF,+EAA+E;IAC/E,0BAA0B;IAC1B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,SAAS,cAAc,CAAC,KAAmB;QACzC,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO;QAC/B,IAAI,mBAAmB,CAAC,KAAK,CAAC;YAAE,YAAY,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,8DAA8D;IAC9D,KAAK,UAAU,gBAAgB;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,UAAU,UAAU,CAAC,QAAkB;QAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAQ,CAAC;QAClC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,KAAK;oBAAE,OAAO,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBACjE,IAAI,SAAiB,CAAC;gBACtB,IAAI,CAAC;oBACH,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC9C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,kDAAkD;oBAClD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC7E,OAAO,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvF,CAAC;gBACD,MAAM,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACtD,OAAO,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC3C,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,+CAA+C;gBAC/C,yDAAyD;gBACzD,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACvC,MAAM,GAAG,GAAG,MAAM,gBAAgB,EAAE,CAAC;gBACrC,IAAI,GAAG;oBAAE,MAAM,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC7C,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,OAAO,CAAC,aAAa;oBAAE,OAAO,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBACzE,IAAI,CAAC,OAAO,CAAC,SAAS;oBAAE,OAAO,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBACvE,IAAI,CAA0C,CAAC;gBAC/C,IAAI,CAAC;oBACH,CAAC,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC3D,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC7E,OAAO,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvF,CAAC;gBACD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,CAAC,CAAC,OAAO;oBACd,CAAC,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;oBACxD,CAAC,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBACzE,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBACjC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;oBACnE,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1C,OAAO,CACL,KAAK,CAAC,+BAA+B,EAAE;wBACrC,CAAC,EAAE,CAAC,GAAG,CAAC;wBACR,KAAK;wBACL,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;wBAClC,EAAE,EAAE,CAAC,CAAC,EAAE;qBACT,CAAC,GAAG,IAAI,CACV,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,KAAK,CAAC,iCAAiC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,+BAA+B,CAAC,EAAE,CAAC;YACzH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK,UAAU,UAAU,CAAC,EAAU,EAAE,QAAkB;QACtD,KAAK,GAAG,QAAQ,CAAC;QACjB,YAAY,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC3C,MAAM,gBAAgB,CAAC,KAAK,EAAE;oBAC5B,aAAa,EAAE,cAAc;oBAC7B,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE;iBAChD,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnB,MAAM,OAAO,GAAe,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACrF,IAAI,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC;oBACvC,OAAO,CAAC,SAAS,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;gBAC5E,CAAC;gBACD,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5C,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1C,uDAAuD;YACvD,MAAM,OAAO,GAAe,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;YACrF,IAAI,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC;gBACvC,OAAO,CAAC,SAAS,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;YAC5E,CAAC;YACD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACrD,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;YAClB,kDAAkD;YAClD,MAAM,GAAG,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACrC,IAAI,GAAG;gBAAE,MAAM,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACnE,gFAAgF;YAChF,MAAM,WAAW,CACf,KAAK,EACL,EAAE,EACF,CAAC,CAAC,uBAAuB,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CACrE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CACrB,OAAO,CAAC,KAAK,CACX,CAAC,CAAC,8BAA8B,EAAE;gBAChC,IAAI;gBACJ,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;aACjB,CAAC,CACH,CACF,CAAC;YACF,sDAAsD;YACtD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAC5C,OAAO,CAAC,KAAK,CACX,CAAC,CAAC,8BAA8B,EAAE;oBAChC,IAAI;oBACJ,EAAE;oBACF,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;iBACjB,CAAC,CACH,CACF,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,KAAK,GAAG,MAAM,CAAC;YACf,YAAY,GAAG,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,UAAU,OAAO,CAAC,EAAU;QAC/B,gEAAgE;QAChE,qEAAqE;QACrE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QAC/B,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBAAE,OAAO;YACpC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,iDAAiD;gBACjD,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,MAAM,MAAM,CAAC,EAAE,CAAC,CAAC;YACjB,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,CAAC,CAAC,0BAA0B,EAAE;gBAC5B,IAAI;gBACJ,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;aACnB,CAAC,CACH,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,KAAK,UAAU,WAAW;QACxB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,0EAA0E;IAC1E,SAAS,YAAY;QACnB,YAAY,CAAC,GAAG,EAAE;YAChB,KAAK,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACvC,OAAO,CAAC,KAAK,CACX,CAAC,CAAC,2BAA2B,EAAE;oBAC7B,IAAI;oBACJ,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;iBACnB,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,UAAU,UAAU;QACvB,IAAI,KAAK,KAAK,MAAM,IAAI,SAAS;YAAE,OAAO;QAC1C,SAAS,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC;YACH,uDAAuD;YACvD,MAAM,WAAW,EAAE,CAAC;YAEpB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAErB,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;YAEjC,IAAI,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC5B,0CAA0C;gBAC1C,YAAY,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YAED,MAAM,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC/B,0BAA0B;YAC1B,YAAY,EAAE,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,UAAU,KAAK;QAClB,oCAAoC;QACpC,MAAM,WAAW,EAAE,CAAC;QACpB,4BAA4B;QAC5B,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBAAE,SAAS,CAAC,oBAAoB;YAC3D,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBACtD,QAAQ,GAAG,aAAa,CAAC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAClF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,0CAA0C;gBAC1C,MAAM,iBAAiB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;gBACxC,SAAS;YACX,CAAC;YACD,MAAM,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,kDAAkD;QACpF,CAAC;QACD,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IAED,SAAS,MAAM;QACb,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,SAAS,QAAQ;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/core/lane-config.d.ts

@@ -0,0 +1,80 @@
+import type { LaneConf } from "../shared/conf.js";
+/** 파일 권한 모드 허용값. 미지정 시 private(secure-by-default). */
+export declare const KNOWN_FILE_MODES: readonly ["private", "shared"];
+/** 구현된 perm_tier 값. 오타 시 acp 처럼 동작(안전 방향)하지만 의도와 다르므로 생성 시 경고. */
+export declare const KNOWN_PERM_TIERS: readonly ["acp", "autopass"];
+/** 검증 실패를 식별하기 위한 전용 에러(흡수 금지 — 호출자가 메시지를 사용자에게 전달). */
+export declare class LaneConfigError extends Error {
+    name: string;
+}
+export interface LaneCommandBaseOptions {
+    /** 설정 base 경로(테스트 override). 미지정 시 $ADDE_HOME 또는 ~/.config/adde. */
+    base?: string;
+}
+export interface LaneAddOptions extends LaneCommandBaseOptions {
+    source?: string;
+    backend?: string;
+    engine?: string;
+    channel?: string;
+    perm_tier?: string;
+    acp_version?: string;
+    allowlist?: string[];
+    denylist?: string[];
+    /** 방어심화 하드-거부 목록(티어 무관 즉시 거부). `Tool`/`Tool(글롭)` 형식. */
+    hard_deny?: string[];
+    /** true 면 hard_deny 에 내장 위험명령 기본 목록을 채운다(explicit hard_deny 와 합집합). */
+    safe_defaults?: boolean;
+    cwd?: string;
+    chat_id?: string;
+    root?: string;
+    inbox?: string;
+    approvals?: string;
+    outbox?: string;
+    /** 레인별 채널 메시지 로케일(en|ko). 미지정 시 전역 로케일. */
+    lang?: string;
+    /** telegram 인바운드 허용 발신자(CSV, 숫자 user/chat id). */
+    allow_from?: string;
+    /** 상태·출력·큐 디렉터리 권한(private|shared). 미지정 시 private. */
+    file_mode?: string;
+    /** 봇 토큰(telegram). 주어지면 state/<lane>/.env 에 0600 으로 기록. */
+    token?: string;
+    /** 기존 conf(및 token 지정 시 .env) 를 덮어쓴다. */
+    force?: boolean;
+}
+export interface LaneAddResult {
+    lane: string;
+    confPath: string;
+    conf: LaneConf;
+    /** token 을 .env 에 기록한 경우 그 경로. */
+    envPath?: string;
+    /** 생성을 막지 않는 사전 검증 경고(액션형). 기동 전 점검 항목. */
+    warnings: string[];
+}
+export interface LaneListResult {
+    lanes: string[];
+}
+export interface LaneShowResult {
+    lane: string;
+    confPath: string;
+    conf: LaneConf;
+    text: string;
+}
+export interface LaneRemoveResult {
+    lane: string;
+    confPath: string;
+}
+/** CSV 를 트림·빈값 제거해 항목 배열로. allow_from 등 목록 문자열 파싱 공용. */
+export declare function parseCsv(raw: string): string[];
+/** conf.file_mode → 정규화된 권한 모드. 미지정/미지값은 private(secure-by-default). */
+export declare function resolveFileMode(mode: string | undefined): "private" | "shared";
+/**
+ * `adde lane add` — 레인 conf 생성. 검증 통과 후 원자적 기록.
+ * 기존 conf 가 있으면 force 없이는 거부한다.
+ */
+export declare function laneAdd(proj: string, lane: string, opts?: LaneAddOptions): Promise<LaneAddResult>;
+/** `adde lane ls` — proj 의 레인 ID 목록(정렬). lanes.d 부재 시 빈 배열. */
+export declare function laneList(proj: string, opts?: LaneCommandBaseOptions): Promise<LaneListResult>;
+/** `adde lane show` — 레인 conf 의 파싱 결과와 원본 텍스트. */
+export declare function laneShow(proj: string, lane: string, opts?: LaneCommandBaseOptions): Promise<LaneShowResult>;
+/** `adde lane rm` — 레인 conf 삭제. 부재 시 에러. state/queue 등 부수 데이터는 보존. */
+export declare function laneRemove(proj: string, lane: string, opts?: LaneCommandBaseOptions): Promise<LaneRemoveResult>;