adde-acp 0.1.3

package/dist/shared/envelope.js

@@ -0,0 +1,91 @@
+/**
+ * v1 envelope 스키마·검증·직렬화.
+ * 소스 어댑터가 생성하고 큐에 저장하는 레인 메시지 단위.
+ */
+/** text 길이 상한(UTF-16 코드유닛) — 초과 시 거부(과대 입력 OOM 방어). */
+const MAX_TEXT_LEN = 256 * 1024;
+/** channel_msg_id 허용 문자셋 — 경로/제어문자 주입 방어. */
+const CHANNEL_MSG_ID_RE = /^[A-Za-z0-9_:-]+$/;
+export function parseEnvelope(json) {
+    let raw;
+    try {
+        raw = JSON.parse(json);
+    }
+    catch {
+        throw new Error("envelope: JSON parse failed");
+    }
+    if (typeof raw !== "object" || raw === null) {
+        throw new Error("envelope: not an object");
+    }
+    const obj = raw;
+    if (obj["v"] !== 1) {
+        throw new Error(`envelope: v must be 1, got ${String(obj["v"])}`);
+    }
+    const required = ["id", "lane", "source", "backend", "engine", "project", "ts", "text"];
+    for (const key of required) {
+        if (typeof obj[key] !== "string" || obj[key] === "") {
+            throw new Error(`envelope: required field "${key}" missing or empty`);
+        }
+    }
+    // 입력 검증·보안 표면(C): 과대 길이·형식·경로주입 거부(fail-closed).
+    if (obj["text"].length > MAX_TEXT_LEN) {
+        throw new Error(`envelope: text 길이 상한 초과 (${obj["text"].length} > ${MAX_TEXT_LEN})`);
+    }
+    const replyRef = obj["reply_ref"];
+    if (replyRef !== undefined) {
+        if (typeof replyRef !== "object" || replyRef === null) {
+            throw new Error("envelope: reply_ref must be an object");
+        }
+        const cmid = replyRef["channel_msg_id"];
+        if (typeof cmid !== "string" || !CHANNEL_MSG_ID_RE.test(cmid)) {
+            throw new Error("envelope: reply_ref.channel_msg_id 형식 위반");
+        }
+    }
+    const control = obj["control"];
+    if (control !== undefined) {
+        if (typeof control !== "object" || control === null) {
+            throw new Error("envelope: control must be an object");
+        }
+        const c = control;
+        if (c["kind"] !== "clear" &&
+            c["kind"] !== "compact" &&
+            c["kind"] !== "resume" &&
+            c["kind"] !== "sessions") {
+            throw new Error(`envelope: control.kind 위반 (${String(c["kind"])})`);
+        }
+        const sid = c["sessionId"];
+        if (sid !== undefined && (typeof sid !== "string" || !CHANNEL_MSG_ID_RE.test(sid))) {
+            // 세션 id 는 loadSession·세션 파일 탐색에 쓰인다 — 경로/제어문자 주입 방어(fail-closed).
+            throw new Error("envelope: control.sessionId 형식 위반");
+        }
+    }
+    const attachments = obj["attachments"];
+    if (attachments !== undefined) {
+        if (!Array.isArray(attachments)) {
+            throw new Error("envelope: attachments must be an array");
+        }
+        for (const a of attachments) {
+            if (typeof a !== "object" || a === null) {
+                throw new Error("envelope: attachment must be an object");
+            }
+            const at = a;
+            if (at["kind"] !== "image" && at["kind"] !== "file") {
+                throw new Error(`envelope: attachment.kind 위반 (${String(at["kind"])})`);
+            }
+            for (const f of ["path", "name", "mime"]) {
+                if (typeof at[f] !== "string" || at[f] === "") {
+                    throw new Error(`envelope: attachment.${f} missing or empty`);
+                }
+            }
+            const name = at["name"];
+            if (name.includes("/") || name.includes("\\") || name.includes("..")) {
+                throw new Error(`envelope: attachment.name 경로 traversal 금지 (${name})`);
+            }
+        }
+    }
+    return raw;
+}
+export function serializeEnvelope(e) {
+    return JSON.stringify(e);
+}
+//# sourceMappingURL=envelope.js.map

package/dist/shared/envelope.js.map

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

package/dist/shared/errors.d.ts

@@ -0,0 +1,8 @@
+/** unknown 오류 표시 공통 헬퍼 — 인라인 관용구의 단일화(표류 방지). */
+/**
+ * unknown 오류를 사람이 읽을 수 있는 문자열로.
+ * ACP 오류 등 Error 가 아닌 객체가 올 수 있어 객체는 JSON 으로 펼친다.
+ */
+export declare function errMsg(err: unknown): string;
+/** Node fs 오류 코드 추출(없으면 undefined). */
+export declare function errCode(err: unknown): string | undefined;

package/dist/shared/errors.js

@@ -0,0 +1,23 @@
+/** unknown 오류 표시 공통 헬퍼 — 인라인 관용구의 단일화(표류 방지). */
+/**
+ * unknown 오류를 사람이 읽을 수 있는 문자열로.
+ * ACP 오류 등 Error 가 아닌 객체가 올 수 있어 객체는 JSON 으로 펼친다.
+ */
+export function errMsg(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (err && typeof err === "object") {
+        try {
+            return JSON.stringify(err);
+        }
+        catch {
+            return String(err);
+        }
+    }
+    return String(err);
+}
+/** Node fs 오류 코드 추출(없으면 undefined). */
+export function errCode(err) {
+    return err?.code;
+}
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,GAAY;IACjC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAQ,GAAyC,EAAE,IAAI,CAAC;AAC1D,CAAC"}

package/dist/shared/fs-atomic.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 같은 디렉터리 tmp→rename 으로 원자 기록 — 부분 쓰기가 최종 경로에 노출되지 않는다.
+ * tmp 는 숨김(dot-prefix, 에디터/감시 노출 회피) + pid(프로세스 간 tmp 이름 충돌 회피) + `.tmp`
+ * 접미(`.msg`/`.out` 등 접미 필터에 걸리지 않음). 대상 디렉터리는 없으면 생성한다.
+ * 같은 프로세스에서 동일 filePath 로의 동시 호출은 tmp 가 겹치므로 호출자가 직렬화해야 한다
+ * (현 호출처는 모두 직렬 — 큐 상태 전이·markdown op 체인·단발 생성).
+ */
+export declare function atomicWrite(filePath: string, content: string, opts?: {
+    mode?: number;
+}): Promise<void>;
+/**
+ * 레인 상태·출력·큐 디렉터리를 권한 모드대로 잠근다.
+ * private=0700(소유자 전용 — 다중 사용자 호스트에서 타 로컬 유저의 대화/응답 열람 차단),
+ * shared=no-op(기존 기본 권한 유지 — 열람 허용을 옵트인한 경우). 부재 디렉터리는 먼저 생성한다.
+ * chmod 실패는 흡수하지 않고 전파한다(권한이 의도대로 적용됐는지는 보안 신호 — 호출부가 로그/판단).
+ */
+export declare function secureLaneDirs(dirs: string[], mode: "private" | "shared"): Promise<void>;

package/dist/shared/fs-atomic.js

@@ -0,0 +1,31 @@
+import { chmod, mkdir, rename, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+/**
+ * 같은 디렉터리 tmp→rename 으로 원자 기록 — 부분 쓰기가 최종 경로에 노출되지 않는다.
+ * tmp 는 숨김(dot-prefix, 에디터/감시 노출 회피) + pid(프로세스 간 tmp 이름 충돌 회피) + `.tmp`
+ * 접미(`.msg`/`.out` 등 접미 필터에 걸리지 않음). 대상 디렉터리는 없으면 생성한다.
+ * 같은 프로세스에서 동일 filePath 로의 동시 호출은 tmp 가 겹치므로 호출자가 직렬화해야 한다
+ * (현 호출처는 모두 직렬 — 큐 상태 전이·markdown op 체인·단발 생성).
+ */
+export async function atomicWrite(filePath, content, opts) {
+    const dir = dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const tmp = join(dir, `.${basename(filePath)}.${process.pid}.tmp`);
+    await writeFile(tmp, content, opts?.mode === undefined ? "utf8" : { encoding: "utf8", mode: opts.mode });
+    await rename(tmp, filePath);
+}
+/**
+ * 레인 상태·출력·큐 디렉터리를 권한 모드대로 잠근다.
+ * private=0700(소유자 전용 — 다중 사용자 호스트에서 타 로컬 유저의 대화/응답 열람 차단),
+ * shared=no-op(기존 기본 권한 유지 — 열람 허용을 옵트인한 경우). 부재 디렉터리는 먼저 생성한다.
+ * chmod 실패는 흡수하지 않고 전파한다(권한이 의도대로 적용됐는지는 보안 신호 — 호출부가 로그/판단).
+ */
+export async function secureLaneDirs(dirs, mode) {
+    if (mode !== "private")
+        return;
+    for (const dir of dirs) {
+        await mkdir(dir, { recursive: true });
+        await chmod(dir, 0o700);
+    }
+}
+//# sourceMappingURL=fs-atomic.js.map

package/dist/shared/fs-atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.js","sourceRoot":"","sources":["../../src/shared/fs-atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,OAAe,EACf,IAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACnE,MAAM,SAAS,CACb,GAAG,EACH,OAAO,EACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAC1E,CAAC;IACF,MAAM,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,IAA0B;IAC7E,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/shared/i18n.d.ts

@@ -0,0 +1,23 @@
+import { en } from "./locales/en.js";
+declare module "i18next" {
+    interface CustomTypeOptions {
+        defaultNS: "translation";
+        resources: {
+            translation: typeof en;
+        };
+    }
+}
+export declare const SUPPORTED_LOCALES: readonly ["en", "ko"];
+export type Locale = (typeof SUPPORTED_LOCALES)[number];
+/** 환경변수에서 로케일 결정. 미지원 값(C·fr 등)은 건너뛰고 다음 후보로 진행한다. */
+export declare function resolveLocale(env?: NodeJS.ProcessEnv): Locale;
+/** 로케일 강제 전환 — 테스트·명시 재설정용. 인라인 리소스라 동기 반영된다. */
+export declare function setLocale(locale: Locale): void;
+export declare function getLocale(): Locale;
+/** 카탈로그 조회. 키·파라미터 타입은 en 리소스에서 유도된다. init 후 캡처 — changeLanguage 를 따라간다(실측 확인). */
+export declare const t: import("i18next").TFunction<["translation", ...never[]], undefined>;
+/**
+ * 로케일 고정 t — 레인별 채널 메시지용(LaneConf.lang). locale 미지정·미지원 값이면
+ * 전역 로케일 추종 t 를 반환한다(옵트인 기본 불변).
+ */
+export declare function tFor(locale?: string): typeof t;

package/dist/shared/i18n.js

@@ -0,0 +1,53 @@
+/**
+ * i18n 로케일 결정·조회 SoT — i18next 단일 인스턴스(인라인 en/ko 리소스).
+ * 로케일 우선순위: ADDE_LANG > LC_ALL > LC_MESSAGES > LANG > en (POSIX 관행).
+ * 모듈 로드 시 동기 초기화 — 진입점(CLI·데몬·테스트)의 명시 init 불요.
+ */
+import i18next from "i18next";
+import { en } from "./locales/en.js";
+import { ko } from "./locales/ko.js";
+export const SUPPORTED_LOCALES = ["en", "ko"];
+/** `ko_KR.UTF-8` 류 POSIX 값에서 언어 코드만 취한다. 미지원 언어는 undefined. */
+function parseLocale(raw) {
+    if (!raw)
+        return undefined;
+    const lang = raw.trim().toLowerCase().split(".")[0]?.split("_")[0];
+    return SUPPORTED_LOCALES.includes(lang ?? "")
+        ? lang
+        : undefined;
+}
+/** 환경변수에서 로케일 결정. 미지원 값(C·fr 등)은 건너뛰고 다음 후보로 진행한다. */
+export function resolveLocale(env = process.env) {
+    for (const raw of [env.ADDE_LANG, env.LC_ALL, env.LC_MESSAGES, env.LANG]) {
+        const locale = parseLocale(raw);
+        if (locale)
+            return locale;
+    }
+    return "en";
+}
+const instance = i18next.createInstance();
+void instance.init({
+    lng: resolveLocale(),
+    fallbackLng: "en",
+    initAsync: false,
+    resources: { en: { translation: en }, ko: { translation: ko } },
+    interpolation: { escapeValue: false },
+});
+/** 로케일 강제 전환 — 테스트·명시 재설정용. 인라인 리소스라 동기 반영된다. */
+export function setLocale(locale) {
+    void instance.changeLanguage(locale);
+}
+export function getLocale() {
+    return parseLocale(instance.language) ?? "en";
+}
+/** 카탈로그 조회. 키·파라미터 타입은 en 리소스에서 유도된다. init 후 캡처 — changeLanguage 를 따라간다(실측 확인). */
+export const t = instance.t;
+/**
+ * 로케일 고정 t — 레인별 채널 메시지용(LaneConf.lang). locale 미지정·미지원 값이면
+ * 전역 로케일 추종 t 를 반환한다(옵트인 기본 불변).
+ */
+export function tFor(locale) {
+    const parsed = parseLocale(locale);
+    return parsed ? instance.getFixedT(parsed) : t;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/shared/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/shared/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AASrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAGvD,+DAA+D;AAC/D,SAAS,WAAW,CAAC,GAAuB;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QAClE,CAAC,CAAE,IAAe;QAClB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;AAC1C,KAAK,QAAQ,CAAC,IAAI,CAAC;IACjB,GAAG,EAAE,aAAa,EAAE;IACpB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE;IAC/D,aAAa,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;CACtC,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,KAAK,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,MAAe;IAClC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/shared/locales/en.d.ts

@@ -0,0 +1,393 @@
+/**
+ * English message catalog. 키 구조의 SoT — 타 로케일은 `satisfies typeof en` 으로
+ * 키 패리티를 컴파일 타임 강제한다. 보간은 i18next `{{var}}` 문법.
+ */
+export declare const en: {
+    usage: {
+        main: string;
+        up: string;
+        down: string;
+        restart: string;
+        status: string;
+        doctor: string;
+        logs: string;
+        sessions: string;
+        completion: string;
+        init: string;
+        alias: string;
+        laneAdd: string;
+        laneLs: string;
+        laneShow: string;
+        laneRm: string;
+        daemon: string;
+        lane: string;
+    };
+    cli: {
+        cmdError: string;
+        laneError: string;
+        unknownSub: string;
+        unknownCmd: string;
+        didYouMean: string;
+    };
+    completion: {
+        unknownShell: string;
+    };
+    run: {
+        laneStartFailed: {
+            situation: string;
+            action: string;
+        };
+        unknownCause: string;
+        noLanes: {
+            situation: string;
+            action: string;
+        };
+        signalShutdown: string;
+        shutdownError: {
+            situation: string;
+            action: string;
+        };
+        upDone: string;
+        statusHint: string;
+        downDone: string;
+        restartDone: string;
+    };
+    ops: {
+        status: {
+            noLanesConf: string;
+            noLanesRegistered: string;
+            noRunning: string;
+            deadWarnAggregate: string;
+            staleWarnAggregate: string;
+            deadWarnSingle: string;
+            staleWarnSingle: string;
+        };
+        doctor: {
+            hint: string;
+            summary: string;
+        };
+        logs: {
+            whatEngine: string;
+            whatTranscript: string;
+            notFound: string;
+            empty: string;
+        };
+    };
+    lane: {
+        valueRequired: string;
+        sourceRetry: string;
+        retry: {
+            permTier: string;
+            fileMode: string;
+            lang: string;
+            chatId: string;
+            allowFrom: string;
+        };
+        prompt: {
+            source: string;
+            permTier: string;
+            allowlist: string;
+            denylist: string;
+            safeDefaults: string;
+            lang: string;
+            token: string;
+            cwd: string;
+            chatId: string;
+            allowFrom: string;
+            fileMode: string;
+            root: string;
+            inbox: string;
+            approvals: string;
+            outbox: string;
+        };
+        ttyOnly: {
+            situation: string;
+            action: string;
+        };
+        created: string;
+        noLanes: string;
+        removed: string;
+        tokenWritten: string;
+        tokenNext: string;
+        startHint: string;
+    };
+    doctor: {
+        node: {
+            name: string;
+            hint: string;
+        };
+        adapter: {
+            name: string;
+            missing: string;
+            hint: string;
+        };
+        daemonEntry: {
+            name: string;
+            missing: string;
+            hint: string;
+        };
+        base: {
+            name: string;
+            hint: string;
+        };
+        missingPath: string;
+        daemon: {
+            name: string;
+            registered: string;
+            notRunning: string;
+            plistOnly: string;
+            launchctlOnly: string;
+            mismatchHint: string;
+            queryFailed: string;
+            queryFailedHint: string;
+        };
+        lanes: {
+            name: string;
+            none: string;
+            addHint: string;
+        };
+        conf: {
+            readFailed: string;
+            readFailedHint: string;
+        };
+        source: {
+            unsupported: string;
+            hint: string;
+        };
+        cwd: {
+            hint: string;
+        };
+        token: {
+            name: string;
+            present: string;
+            missing: string;
+            hint: string;
+        };
+        perms: {
+            name: string;
+            ok: string;
+            envLoose: string;
+            envHint: string;
+            stateLoose: string;
+            stateHint: string;
+        };
+    };
+    update: {
+        available: string;
+    };
+    gate: {
+        hardDeny: string;
+    };
+    init: {
+        ttyOnly: {
+            situation: string;
+            action: string;
+        };
+        intro: string;
+        doctorWarn: string;
+        aliasPrompt: string;
+        aliasNoBin: string;
+        aliasCreated: string;
+        aliasAlready: string;
+        aliasSkipped: string;
+        aliasFailed: string;
+        projPrompt: string;
+        projRetry: string;
+        lanePrompt: string;
+        laneRetry: string;
+        done: string;
+    };
+    laneConfig: {
+        warn: {
+            cwdMissing: string;
+            mdRootMissingConf: string;
+            mdRootNotFound: string;
+            mdPathOverlap: string;
+            tokenFormat: string;
+            permTierUnknown: string;
+            autopassBanner: string;
+            autopassEmptyDeny: string;
+            allowDenyOverlap: string;
+            badLang: string;
+            telegramNoAuth: string;
+        };
+        err: {
+            emptyIdent: string;
+            badIdent: string;
+            badSource: string;
+            badChatId: string;
+            tokenOnlyTelegram: string;
+            allowFromOnlyTelegram: string;
+            badAllowFrom: string;
+            badFileMode: string;
+            badAllowTool: string;
+            badDenyEntry: string;
+            laneExists: string;
+            tokenEmpty: string;
+            envHasToken: string;
+            laneNotFound: string;
+        };
+    };
+    telegram: {
+        permPrompt: string;
+        enqueueFail: {
+            situation: string;
+            action: string;
+        };
+    };
+    markdown: {
+        enqueueFail: {
+            situation: string;
+            action: string;
+        };
+        confRootMissing: string;
+        confInboxMissing: string;
+        rootNotFound: string;
+        pathNotRelative: string;
+        controlNoteInCwd: string;
+        pathsOverlap: string;
+        inboxInsideDir: string;
+        badApprovalId: string;
+        outMeta: string;
+        approvalMeta: string;
+    };
+    supervisor: {
+        noLanesMsg: string;
+        alreadyRunning: string;
+        autopassDenySome: string;
+        autopassDenyEmpty: string;
+        autopassBanner: {
+            situation: string;
+            action: string;
+        };
+        upStarted: string;
+        upSkipped: string;
+        downStopped: string;
+    };
+    launchd: {
+        macOnly: {
+            situation: string;
+            action: string;
+        };
+        loadFail: {
+            situation: string;
+            action: string;
+        };
+        binMissing: {
+            situation: string;
+            action: string;
+        };
+    };
+    queue: {
+        claimFail: {
+            situation: string;
+            action: string;
+        };
+        quarantined: string;
+    };
+    injector: {
+        injectFailed: string;
+        control: {
+            cleared: string;
+            compacted: string;
+            resumed: string;
+            resumeFallback: string;
+            resumeMissing: string;
+            unsupported: string;
+            relaunchFailed: string;
+            sessionsHeader: string;
+            sessionsItem: string;
+            sessionsNoLabel: string;
+            sessionsEmpty: string;
+            sessionsHint: string;
+        };
+        failNote: {
+            situation: string;
+            action: string;
+        };
+    };
+    transcript: {
+        commandsUpdated: string;
+    };
+    acp: {
+        spawnFail: {
+            situation: string;
+            action: string;
+        };
+        handshakeTimeout: {
+            situation: string;
+            action: string;
+        };
+        subscriberError: string;
+        bypassAction: string;
+    };
+    permDiff: {
+        queryFailedMsg: string;
+        warnLine: string;
+        looseEngine: string;
+        bypassMsg: string;
+        engineUnknown: string;
+    };
+    log: {
+        supervisor: {
+            noConf: string;
+            heartbeatFail: string;
+            ledgerFail: string;
+            deadCleanupFail: string;
+            channelWarnFail: string;
+            injectorStartFail: string;
+            runtimeWriteFail: string;
+            runtimeRemoveFail: string;
+            securePermsFail: string;
+            laneStartFail: string;
+        };
+        queue: {
+            quarantineFail: string;
+            failedWriteFail: string;
+        };
+        injector: {
+            injectError: string;
+            failedWriteFail: string;
+            renderError: string;
+            advanceError: string;
+            failNotifyError: string;
+            relaunchError: string;
+        };
+        telegram: {
+            rateLimit: string;
+            enqueueError: string;
+            answerCallbackError: string;
+            unknownCallback: string;
+            unauthorizedMessage: string;
+            unauthorizedCallback: string;
+            noAuthConfigured: string;
+            pollError: string;
+            alertSendError: string;
+            pollLoopEnd: string;
+        };
+        markdown: {
+            quarantineFail: string;
+            enqueueError: string;
+            alertWriteError: string;
+            inboxError: string;
+            approvalsError: string;
+            pollError: string;
+        };
+        transcript: {
+            auditAppendFail: string;
+            appendFail: string;
+        };
+        acp: {
+            engineProcessError: string;
+            loadSessionFail: string;
+            subscriberError: string;
+            transcriptWriteFail: string;
+            permDiff: string;
+        };
+    };
+    notify: {
+        block: string;
+        exception: string;
+        warn: string;
+    };
+};