adde-acp 0.1.3

package/dist/core/messages.d.ts

@@ -0,0 +1,31 @@
+/** CLI 명령 표면. 최소 표면 원칙. */
+export declare const COMMANDS: {
+    /** 주 진입점. */
+    readonly primary: "adde";
+    /** 단축 별칭. */
+    readonly short: "add";
+};
+/** 최상위 도움말(인자 없음·미지원 명령 시). */
+export declare function buildUsage(): string;
+/** 명령별 사용법 한 줄(인자 누락 시 안내). 끝에 \n 없음 — 호출부가 개행 부여. getter 로 현재 로케일 반영. */
+export declare const USAGE: {
+    readonly up: string;
+    readonly down: string;
+    readonly restart: string;
+    readonly status: string;
+    readonly logs: string;
+    readonly sessions: string;
+    readonly laneAdd: string;
+    readonly laneLs: string;
+    readonly laneShow: string;
+    readonly laneRm: string;
+    readonly completion: string;
+};
+/** `adde lane` 그룹 도움말. */
+export declare function buildLaneUsage(): string;
+/** 최상위 명령 오류 — `[adde <cmd>] 오류: <detail>`. */
+export declare function cmdError(cmd: string, detail: string): string;
+/** `adde lane` 하위 오류 — `[adde lane] <detail>`. */
+export declare function laneError(detail: string): string;
+/** 알 수 없는 lane 서브커맨드 안내(+ 사용법). */
+export declare function unknownLaneSub(sub: string): string;

package/dist/core/messages.js

@@ -0,0 +1,71 @@
+/**
+ * CLI 사용자 노출 문자열의 단일 표면 — 사용법·명령 오류 안내·도움말.
+ * 문구 본문은 i18n 카탈로그(`shared/locales/`)가 소유하고, 본 모듈은 CLI API 를 유지한다.
+ * presentation 계층(cli/run·lane·ops) 전용. 내부 라이브러리 throw Error(개발자 대상)는 여기서 다루지 않는다.
+ * 런타임 차단·예외 포맷은 `shared/notify.ts`(formatBlock/formatException) 담당 — 역할 분리.
+ */
+import { t } from "../shared/i18n.js";
+/** CLI 명령 표면. 최소 표면 원칙. */
+export const COMMANDS = {
+    /** 주 진입점. */
+    primary: "adde",
+    /** 단축 별칭. */
+    short: "add",
+};
+/** 최상위 도움말(인자 없음·미지원 명령 시). */
+export function buildUsage() {
+    return t("usage.main", { primary: COMMANDS.primary, short: COMMANDS.short });
+}
+/** 명령별 사용법 한 줄(인자 누락 시 안내). 끝에 \n 없음 — 호출부가 개행 부여. getter 로 현재 로케일 반영. */
+export const USAGE = {
+    get up() {
+        return t("usage.up");
+    },
+    get down() {
+        return t("usage.down");
+    },
+    get restart() {
+        return t("usage.restart");
+    },
+    get status() {
+        return t("usage.status");
+    },
+    get logs() {
+        return t("usage.logs");
+    },
+    get sessions() {
+        return t("usage.sessions");
+    },
+    get laneAdd() {
+        return t("usage.laneAdd");
+    },
+    get laneLs() {
+        return t("usage.laneLs");
+    },
+    get laneShow() {
+        return t("usage.laneShow");
+    },
+    get laneRm() {
+        return t("usage.laneRm");
+    },
+    get completion() {
+        return t("usage.completion");
+    },
+};
+/** `adde lane` 그룹 도움말. */
+export function buildLaneUsage() {
+    return t("usage.lane");
+}
+/** 최상위 명령 오류 — `[adde <cmd>] 오류: <detail>`. */
+export function cmdError(cmd, detail) {
+    return t("cli.cmdError", { cmd, detail });
+}
+/** `adde lane` 하위 오류 — `[adde lane] <detail>`. */
+export function laneError(detail) {
+    return t("cli.laneError", { detail });
+}
+/** 알 수 없는 lane 서브커맨드 안내(+ 사용법). */
+export function unknownLaneSub(sub) {
+    return `${t("cli.unknownSub", { sub })}\n\n${buildLaneUsage()}`;
+}
+//# sourceMappingURL=messages.js.map

package/dist/core/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,aAAa;IACb,OAAO,EAAE,MAAM;IACf,aAAa;IACb,KAAK,EAAE,KAAK;CACJ,CAAC;AAEX,+BAA+B;AAC/B,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE;QACJ,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,IAAI;QACN,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO;QACT,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI;QACN,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,UAAU;QACZ,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC;AAEF,0BAA0B;AAC1B,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;AACzB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAc;IAClD,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,CAAC,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,CAAC,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,cAAc,EAAE,EAAE,CAAC;AAClE,CAAC"}

package/dist/core/queue.d.ts

@@ -0,0 +1,74 @@
+import { basename } from "node:path";
+import type { LanePaths } from "../shared/paths.js";
+import type { Envelope } from "../shared/envelope.js";
+/**
+ * envelope 을 queue 디렉토리에 atomic rename 으로 저장.
+ * tmp 작성 완료 후 rename → 부분 쓰기가 queue 에 노출되지 않는다.
+ */
+export declare function enqueue(paths: LanePaths, envelope: Envelope): Promise<void>;
+/**
+ * queue 에서 다음 envelope 을 꺼내 processing 으로 이동.
+ * 큐가 비어 있으면 null 반환.
+ */
+export declare function claimNext(paths: LanePaths): Promise<{
+    id: string;
+    envelope: Envelope;
+} | null>;
+/**
+ * 손상된 processing 메시지를 격리한다(poison message 차단).
+ * processing/<id>.msg → processing/<id>.msg.corrupt (scanProcessing 의 `.msg` 필터에서 제외돼
+ * 재기동 시 재처리되지 않는다) + out/<id>.failed 가시성 기록.
+ */
+export declare function quarantineCorrupt(paths: LanePaths, id: string, reason: unknown): Promise<void>;
+/**
+ * processing 디렉토리 스캔 — 크래시 재개 대상 id 목록.
+ */
+export declare function scanProcessing(paths: LanePaths): Promise<string[]>;
+/**
+ * out/<id>.out 존재 여부 검사 — dedup 판정.
+ */
+export declare function isDone(paths: LanePaths, id: string): Promise<boolean>;
+/**
+ * 해당 id 가 큐/처리/출력 어디든 이미 존재하는지 검사 — 크래시 재개 시 중복 enqueue 방지.
+ * queue/<ts>-<id>.msg · processing/<id>.msg · out/<id>.out 중 하나라도 있으면 true.
+ */
+export declare function hasId(paths: LanePaths, id: string): Promise<boolean>;
+export interface OutSidecar {
+    reply_ref?: {
+        channel_msg_id: string;
+        thread?: string;
+    };
+    /** turn 완료 시각(ISO). */
+    ts?: string;
+    /** 원본 메시지 전송(enqueue) 시각(envelope.ts) — 채널 렌더의 스탬프 SoT. */
+    origin_ts?: string;
+    /** 원본 질문 발췌(첫 줄, 마스킹) — 채널 렌더 헤더의 맥락 표시용. */
+    question?: string;
+}
+/**
+ * 처리 결과를 out 디렉토리에 atomic rename 으로 기록.
+ * <id>.out (텍스트) + <id>.out.json (sidecar).
+ */
+export declare function writeOut(paths: LanePaths, id: string, text: string, sidecar: OutSidecar): Promise<void>;
+/**
+ * 채널 전송 성공 마커 out/<id>.sent 기록(atomic). `.out`(응답 영속·dedup)과 분리해
+ * "응답은 기록됐으나 채널 미전송" 상태를 표현 — render 실패 시 재전송 대상 판별에 쓰인다.
+ */
+export declare function markSent(paths: LanePaths, id: string): Promise<void>;
+/** out/<id>.sent 존재 여부 — 채널 전송 완료 판정. */
+export declare function isSent(paths: LanePaths, id: string): Promise<boolean>;
+/**
+ * 응답은 기록됐으나(out/<id>.out) 채널 전송이 안 된(out/<id>.sent 부재) id 목록.
+ * render 실패·크래시로 미전달된 응답의 재전송 대상.
+ */
+export declare function findUnsent(paths: LanePaths): Promise<string[]>;
+/**
+ * inject 실패 등 처리 실패를 out/<id>.failed 로 기록(E1, 가시성).
+ * dedup 마커(.out)가 아니므로 processing/<id>.msg 는 남아 재기동 시 재처리된다(at-least-once 유지).
+ */
+export declare function writeFailed(paths: LanePaths, id: string, reason: string): Promise<void>;
+/** processing/<id>.msg 경로를 직접 반환 (재처리 복원 등에 사용). */
+export declare function processingFilePath(paths: LanePaths, id: string): string;
+/** out/<id>.out.json sidecar 읽기. */
+export declare function readSidecar(paths: LanePaths, id: string): Promise<OutSidecar | null>;
+export { basename };

package/dist/core/queue.js

@@ -0,0 +1,227 @@
+/**
+ * atomic 저장·상태 전이·dedup.
+ * tmp→rename 으로 부분 쓰기 미노출.
+ * queue→processing→out 상태 전이는 원자적 rename.
+ */
+import { t } from "../shared/i18n.js";
+import { mkdir, rename, readdir, access, readFile } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { atomicWrite } from "../shared/fs-atomic.js";
+import { errMsg, errCode } from "../shared/errors.js";
+import { serializeEnvelope, parseEnvelope } from "../shared/envelope.js";
+import { formatException } from "../shared/notify.js";
+/** queue 파일명 형식: <ts_ms>-<id>.msg */
+function queueFileName(envelope) {
+    const ts = Date.now();
+    return `${ts}-${envelope.id}.msg`;
+}
+/** processing 파일명: <id>.msg */
+function processingFileName(id) {
+    return `${id}.msg`;
+}
+/** id 를 queue 파일명에서 추출. */
+function idFromQueueFile(filename) {
+    const base = filename.replace(/\.msg$/, "");
+    const dashIdx = base.indexOf("-");
+    return dashIdx === -1 ? base : base.slice(dashIdx + 1);
+}
+/** id 를 processing 파일명에서 추출. */
+function idFromProcessingFile(filename) {
+    return filename.replace(/\.msg$/, "");
+}
+/**
+ * envelope 을 queue 디렉토리에 atomic rename 으로 저장.
+ * tmp 작성 완료 후 rename → 부분 쓰기가 queue 에 노출되지 않는다.
+ */
+export async function enqueue(paths, envelope) {
+    await atomicWrite(join(paths.queueDir, queueFileName(envelope)), serializeEnvelope(envelope));
+}
+/**
+ * queue 에서 다음 envelope 을 꺼내 processing 으로 이동.
+ * 큐가 비어 있으면 null 반환.
+ */
+export async function claimNext(paths) {
+    await mkdir(paths.queueDir, { recursive: true });
+    await mkdir(paths.processingDir, { recursive: true });
+    let files;
+    try {
+        files = await readdir(paths.queueDir);
+    }
+    catch (err) {
+        // ENOENT(디렉터리 부재)는 빈 큐와 동치 — 정상. 그 외 FS 오류는 무음 흡수 금지(전파).
+        if (errCode(err) === "ENOENT")
+            return null;
+        throw err;
+    }
+    const msgFiles = files.filter((f) => f.endsWith(".msg")).sort();
+    // 정렬 순서대로 claim 시도 — 경합(ENOENT)·손상(parse 실패)은 건너뛰고 다음 메시지로.
+    for (const next of msgFiles) {
+        const id = idFromQueueFile(next);
+        const src = join(paths.queueDir, next);
+        const dst = join(paths.processingDir, processingFileName(id));
+        try {
+            await rename(src, dst);
+        }
+        catch (err) {
+            // ENOENT = 경합(다른 워커가 먼저 claim) 또는 파일 소멸 → 다음 후보로.
+            // 그 외(EBUSY/EACCES/EXDEV/ENOSPC/NFS 등)는 일시·구조적 FS 오류 → 액션형 로그 후 전파.
+            // 흡수해 null 을 돌리면 큐가 안 비었는데 idle 로 빠져 메시지가 무음 방치된다.
+            if (errCode(err) === "ENOENT")
+                continue;
+            console.error(formatException({
+                situation: t("queue.claimFail.situation", { code: errCode(err) ?? "unknown", path: src }),
+                action: t("queue.claimFail.action"),
+            }));
+            throw err;
+        }
+        let envelope;
+        try {
+            envelope = parseEnvelope(await readFile(dst, "utf8"));
+        }
+        catch (parseErr) {
+            // 손상 메시지(스키마/JSON 깨짐) — 격리 후 다음 후보로. 매 기동 동일 파싱오류 반복 차단.
+            await quarantineCorrupt(paths, id, parseErr);
+            continue;
+        }
+        return { id, envelope };
+    }
+    return null;
+}
+/**
+ * 손상된 processing 메시지를 격리한다(poison message 차단).
+ * processing/<id>.msg → processing/<id>.msg.corrupt (scanProcessing 의 `.msg` 필터에서 제외돼
+ * 재기동 시 재처리되지 않는다) + out/<id>.failed 가시성 기록.
+ */
+export async function quarantineCorrupt(paths, id, reason) {
+    const detail = errMsg(reason);
+    const src = join(paths.processingDir, processingFileName(id));
+    const corrupt = `${src}.corrupt`;
+    try {
+        await rename(src, corrupt);
+    }
+    catch (err) {
+        // 이미 격리됐거나(ENOENT) 다른 워커가 처리 — 격리 자체 실패는 로그만(가시성 .failed 는 계속 기록).
+        if (errCode(err) !== "ENOENT") {
+            console.error(t("log.queue.quarantineFail", { id, code: errCode(err) ?? "unknown" }));
+        }
+    }
+    await writeFailed(paths, id, t("queue.quarantined", { ts: new Date().toISOString(), detail })).catch((e) => console.error(t("log.queue.failedWriteFail", { id, error: errMsg(e) })));
+}
+/**
+ * processing 디렉토리 스캔 — 크래시 재개 대상 id 목록.
+ */
+export async function scanProcessing(paths) {
+    let files;
+    try {
+        files = await readdir(paths.processingDir);
+    }
+    catch {
+        return [];
+    }
+    return files.filter((f) => f.endsWith(".msg")).map(idFromProcessingFile);
+}
+/**
+ * out/<id>.out 존재 여부 검사 — dedup 판정.
+ */
+export async function isDone(paths, id) {
+    const outPath = join(paths.outDir, `${id}.out`);
+    try {
+        await access(outPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 해당 id 가 큐/처리/출력 어디든 이미 존재하는지 검사 — 크래시 재개 시 중복 enqueue 방지.
+ * queue/<ts>-<id>.msg · processing/<id>.msg · out/<id>.out 중 하나라도 있으면 true.
+ */
+export async function hasId(paths, id) {
+    if (await isDone(paths, id))
+        return true;
+    try {
+        await access(join(paths.processingDir, processingFileName(id)));
+        return true;
+    }
+    catch {
+        // processing 에 없음 — 큐 검사로 진행
+    }
+    try {
+        const files = await readdir(paths.queueDir);
+        return files.some((f) => f.endsWith(`-${id}.msg`));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 처리 결과를 out 디렉토리에 atomic rename 으로 기록.
+ * <id>.out (텍스트) + <id>.out.json (sidecar).
+ */
+export async function writeOut(paths, id, text, sidecar) {
+    // sidecar 를 먼저 확정한다 — `.out` 이 dedup/done 마커(isDone)이므로 본문을 마지막에 rename 하면
+    // "`.out` 존재 ⇒ sidecar 존재" 가 성립한다. 두 rename 사이 크래시에도 done 메시지가 reply_ref 를
+    // 잃지 않고, reader 가 `.out` 만 보고 sidecar 부재 창을 만나지 않는다.
+    await atomicWrite(join(paths.outDir, `${id}.out.json`), JSON.stringify(sidecar));
+    await atomicWrite(join(paths.outDir, `${id}.out`), text);
+}
+/**
+ * 채널 전송 성공 마커 out/<id>.sent 기록(atomic). `.out`(응답 영속·dedup)과 분리해
+ * "응답은 기록됐으나 채널 미전송" 상태를 표현 — render 실패 시 재전송 대상 판별에 쓰인다.
+ */
+export async function markSent(paths, id) {
+    await atomicWrite(join(paths.outDir, `${id}.sent`), new Date().toISOString());
+}
+/** out/<id>.sent 존재 여부 — 채널 전송 완료 판정. */
+export async function isSent(paths, id) {
+    try {
+        await access(join(paths.outDir, `${id}.sent`));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 응답은 기록됐으나(out/<id>.out) 채널 전송이 안 된(out/<id>.sent 부재) id 목록.
+ * render 실패·크래시로 미전달된 응답의 재전송 대상.
+ */
+export async function findUnsent(paths) {
+    let files;
+    try {
+        files = await readdir(paths.outDir);
+    }
+    catch {
+        return [];
+    }
+    const sent = new Set(files.filter((f) => f.endsWith(".sent")).map((f) => f.replace(/\.sent$/, "")));
+    return files
+        .filter((f) => f.endsWith(".out"))
+        .map((f) => f.replace(/\.out$/, ""))
+        .filter((id) => !sent.has(id));
+}
+/**
+ * inject 실패 등 처리 실패를 out/<id>.failed 로 기록(E1, 가시성).
+ * dedup 마커(.out)가 아니므로 processing/<id>.msg 는 남아 재기동 시 재처리된다(at-least-once 유지).
+ */
+export async function writeFailed(paths, id, reason) {
+    await atomicWrite(join(paths.outDir, `${id}.failed`), reason);
+}
+/** processing/<id>.msg 경로를 직접 반환 (재처리 복원 등에 사용). */
+export function processingFilePath(paths, id) {
+    return join(paths.processingDir, processingFileName(id));
+}
+/** out/<id>.out.json sidecar 읽기. */
+export async function readSidecar(paths, id) {
+    const sidecarPath = join(paths.outDir, `${id}.out.json`);
+    try {
+        const json = await readFile(sidecarPath, "utf8");
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+export { basename };
+//# sourceMappingURL=queue.js.map

package/dist/core/queue.js.map

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

package/dist/core/runtime-state.d.ts

@@ -0,0 +1,52 @@
+import type { LanePaths } from "../shared/paths.js";
+/** 하트비트 touch 주기 — up 이 이 간격으로 runtime.json mtime 을 갱신(긴 인터벌, 보조 신호). */
+export declare const HEARTBEAT_INTERVAL_MS = 60000;
+/** stale 판정 임계 — mtime 이 이보다 오래되면 행(hung)으로 본다(인터벌의 3배 여유). */
+export declare const HEARTBEAT_STALE_MS = 180000;
+/** runtime.json 에 기록되는 레인 런타임 정보. */
+export interface RuntimeInfo {
+    /** 스키마 버전 — 향후 형식 변경 시 forward-compat 판별. */
+    v: 1;
+    /** 레인을 기동한 up 프로세스의 pid. 생존 판정 대상. */
+    pid: number;
+    lane: string;
+    sessionId: string;
+    /** ISO8601 기동 시각. */
+    startedAt: string;
+    source: string;
+    backend: string;
+    engine: string;
+}
+/** 레인 라이브니스 — 파일/pid/하트비트 조합으로 판정. stale=pid 는 살아있으나 하트비트가 끊긴 행 상태. */
+export type Liveness = "running" | "stale" | "dead" | "stopped";
+/** runtime.json 을 원자적으로(tmp→rename) 기록. stateDir 부재 시 생성. */
+export declare function writeRuntime(paths: LanePaths, info: RuntimeInfo): Promise<void>;
+/**
+ * 하트비트 — runtime.json 의 mtime 만 현재시각으로 갱신(utimes, 내용 재작성 없음).
+ * 파일 부재(종료 레이스 등 ENOENT)는 무시 — 멱등. 그 외 오류는 호출부가 흡수(보조 신호).
+ */
+export declare function touchRuntime(paths: LanePaths): Promise<void>;
+/** runtime.json 제거(graceful 종료). 부재(ENOENT)는 무시 — 멱등. */
+export declare function removeRuntime(paths: LanePaths): Promise<void>;
+/** runtime.json 읽기. 부재·파싱불가·스키마 불일치 시 null(=stopped 로 취급). */
+export declare function readRuntime(paths: LanePaths): Promise<RuntimeInfo | null>;
+/**
+ * pid 생존 판정. `process.kill(pid, 0)` 은 신호를 보내지 않고 존재만 확인한다.
+ * - 성공: 프로세스 존재 → running.
+ * - EPERM: 존재하나 시그널 권한 없음(다른 소유자) → 존재하므로 running.
+ * - ESRCH(그 외): 프로세스 없음 → dead(크래시 잔존).
+ */
+export declare function isPidAlive(pid: number): boolean;
+/** livenessOf 판정 입력 — 하트비트(mtime) 신선도까지 보려면 mtimeMs 주입. */
+export interface LivenessOptions {
+    /** runtime.json 의 mtime(ms). 주입 시 stale 판정에 사용. 미주입이면 pid-only(running/dead). */
+    mtimeMs?: number | undefined;
+    /** 현재시각(ms). 테스트 주입용. 기본 Date.now(). */
+    now?: number | undefined;
+}
+/**
+ * runtime.json + pid 생존 + 하트비트(mtime)로 라이브니스 판정.
+ * - 파일 없음 → stopped, pid 없음 → dead.
+ * - pid 생존 + mtime 임계 초과 → stale(행). mtime 미주입이면 running(pid-only).
+ */
+export declare function livenessOf(info: RuntimeInfo | null, opts?: LivenessOptions): Liveness;

package/dist/core/runtime-state.js

@@ -0,0 +1,90 @@
+/**
+ * 레인 라이브니스 상태 파일(runtime.json) 입출력 + pid 생존 판정.
+ * `adde up` 이 레인 기동 시 기록하고 graceful 종료(down·시그널)에서 제거한다.
+ * `adde status` 는 별도 프로세스라 up 의 in-memory 상태를 못 본다 → 이 파일이 유일한 교차 프로세스 신호.
+ */
+import { unlink, readFile, utimes } from "node:fs/promises";
+import { atomicWrite } from "../shared/fs-atomic.js";
+/** 하트비트 touch 주기 — up 이 이 간격으로 runtime.json mtime 을 갱신(긴 인터벌, 보조 신호). */
+export const HEARTBEAT_INTERVAL_MS = 60_000;
+/** stale 판정 임계 — mtime 이 이보다 오래되면 행(hung)으로 본다(인터벌의 3배 여유). */
+export const HEARTBEAT_STALE_MS = 180_000;
+/** runtime.json 을 원자적으로(tmp→rename) 기록. stateDir 부재 시 생성. */
+export async function writeRuntime(paths, info) {
+    await atomicWrite(paths.runtimeJson, JSON.stringify(info, null, 2) + "\n");
+}
+/**
+ * 하트비트 — runtime.json 의 mtime 만 현재시각으로 갱신(utimes, 내용 재작성 없음).
+ * 파일 부재(종료 레이스 등 ENOENT)는 무시 — 멱등. 그 외 오류는 호출부가 흡수(보조 신호).
+ */
+export async function touchRuntime(paths) {
+    const now = new Date();
+    try {
+        await utimes(paths.runtimeJson, now, now);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+}
+/** runtime.json 제거(graceful 종료). 부재(ENOENT)는 무시 — 멱등. */
+export async function removeRuntime(paths) {
+    try {
+        await unlink(paths.runtimeJson);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+}
+/** runtime.json 읽기. 부재·파싱불가·스키마 불일치 시 null(=stopped 로 취급). */
+export async function readRuntime(paths) {
+    let text;
+    try {
+        text = await readFile(paths.runtimeJson, "utf8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed.pid === "number" && typeof parsed.sessionId === "string") {
+            return parsed;
+        }
+    }
+    catch {
+        // 손상된 파일 — null 로 취급(stopped). 진단은 status 가 별도 표면화하지 않는다.
+    }
+    return null;
+}
+/**
+ * pid 생존 판정. `process.kill(pid, 0)` 은 신호를 보내지 않고 존재만 확인한다.
+ * - 성공: 프로세스 존재 → running.
+ * - EPERM: 존재하나 시그널 권한 없음(다른 소유자) → 존재하므로 running.
+ * - ESRCH(그 외): 프로세스 없음 → dead(크래시 잔존).
+ */
+export function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+/**
+ * runtime.json + pid 생존 + 하트비트(mtime)로 라이브니스 판정.
+ * - 파일 없음 → stopped, pid 없음 → dead.
+ * - pid 생존 + mtime 임계 초과 → stale(행). mtime 미주입이면 running(pid-only).
+ */
+export function livenessOf(info, opts = {}) {
+    if (!info)
+        return "stopped";
+    if (!isPidAlive(info.pid))
+        return "dead";
+    const { mtimeMs, now = Date.now() } = opts;
+    if (mtimeMs !== undefined && now - mtimeMs > HEARTBEAT_STALE_MS)
+        return "stale";
+    return "running";
+}
+//# sourceMappingURL=runtime-state.js.map

package/dist/core/runtime-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.js","sourceRoot":"","sources":["../../src/core/runtime-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAoB1C,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAgB,EAAE,IAAiB;IACpE,MAAM,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAgB;IACjD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAgB;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB;IAChD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;QACxD,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3E,OAAO,MAAqB,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAwB,EAAE,OAAwB,EAAE;IAC7E,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAC3C,IAAI,OAAO,KAAK,SAAS,IAAI,GAAG,GAAG,OAAO,GAAG,kBAAkB;QAAE,OAAO,OAAO,CAAC;IAChF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/session-ledger.d.ts

@@ -0,0 +1,25 @@
+import type { LanePaths } from "../shared/paths.js";
+import type { ControlRequest } from "../shared/envelope.js";
+export interface SessionEntry {
+    id: string;
+    /** ISO — 세션 생성 시각. */
+    createdAt: string;
+    /** ISO — 마지막 대화(턴 종료) 시각. 목록 표기·회전 기준. */
+    lastActivityAt: string;
+    /** 첫 프롬프트 발췌(마스킹) — 목록에서 세션 식별용. 첫 턴에서 1회 채움. */
+    label?: string;
+}
+/** 장부 읽기 — 부재·파손은 빈 장부(보조 데이터, fail-open). */
+export declare function readLedger(paths: LanePaths): Promise<SessionEntry[]>;
+/** 세션 목록의 시각 표기 — 로컬 `MM-DD HH:mm`(목록 가독 우선, 정밀 시각은 장부 파일에 보존). */
+export declare function formatWhen(iso: string): string;
+/**
+ * resume 인자 → ControlRequest 해석(채널 공통). 무인자=목록(sessions), 숫자=장부 최신순
+ * 번호, 그 외=세션 id 직접 지정(문자셋 위반·번호 범위 밖은 sessionId 미지정 — 수신측이
+ * "재개할 세션 없음" 통지, fail-closed).
+ */
+export declare function resolveResumeControl(arg: string | undefined, entries: SessionEntry[]): ControlRequest;
+/** 세션 생성/복귀 시 upsert — 기존 항목이면 lastActivityAt 만 갱신. */
+export declare function recordSession(paths: LanePaths, id: string): Promise<void>;
+/** 턴 종료 시 마지막 대화 시각 갱신(+미기재 label 이면 발췌 기록). 항목 부재 시 생성. */
+export declare function touchSession(paths: LanePaths, id: string, labelIfEmpty?: string): Promise<void>;