adde-acp 0.1.3

package/dist/cli/spec.js

@@ -0,0 +1,98 @@
+/**
+ * CLI 명령·플래그 스펙(SSOT) — 셸 자동완성·서브커맨드 도움말·미지원 명령 힌트가 공유한다.
+ * 명령/플래그를 한 곳에서 선언해 자동완성·힌트가 함께 갱신되도록(확장성): 새 명령·플래그는
+ * 여기에 추가하면 completion·help·"did you mean" 힌트에 자동 반영된다. 문구 본문(설명)은
+ * i18n 카탈로그가 소유하고, 본 스펙은 이름·인자 형태·플래그 목록(구조)만 담는다.
+ */
+/** 값이 열거형인 플래그 — 자동완성이 플래그 뒤에서 이 값들을 완성한다. */
+export const FLAG_VALUES = {
+    "--source": ["telegram", "markdown"],
+    "--perm-tier": ["acp", "autopass"],
+    "--file-mode": ["private", "shared"],
+    "--lang": ["en", "ko"],
+};
+/** 디렉터리 경로를 받는 플래그 — 자동완성이 뒤에서 디렉터리를 완성한다. */
+export const DIR_FLAGS = ["--cwd", "--root"];
+/** 전역 옵션(모든 명령 위치에서 완성 후보). */
+export const GLOBAL_FLAGS = ["-h", "--help", "-v", "--version"];
+/** `lane add` 옵션 플래그(SSOT — lane.ts ADD_VALUE_KEYS 의 표면형 `--key`). */
+export const LANE_ADD_FLAGS = [
+    "--source",
+    "--engine",
+    "--backend",
+    "--channel",
+    "--perm-tier",
+    "--acp-version",
+    "--cwd",
+    "--allowlist",
+    "--denylist",
+    "--hard-deny",
+    "--safe-defaults",
+    "--lang",
+    "--chat-id",
+    "--allow-from",
+    "--file-mode",
+    "--token-stdin",
+    "--root",
+    "--inbox",
+    "--approvals",
+    "--outbox",
+    "--force",
+    "--interactive",
+    "--no-interactive",
+];
+/** lane 하위 명령(정식 이름 — list/remove 별칭은 자동완성 미노출, 디스패치만 허용). */
+export const LANE_SUBS = ["add", "ls", "show", "rm", "help"];
+/** 최상위 명령 SSOT. hidden 명령은 도움말·자동완성에서 제외. */
+export const COMMAND_SPECS = [
+    { name: "init", args: "[<proj>]", flags: [], positional: ["proj"], desc: "guided setup", usageKey: "usage.init" }, // prettier-ignore
+    { name: "up", args: "<proj>", flags: [], positional: ["proj"], desc: "start lanes (daemon)", usageKey: "usage.up" }, // prettier-ignore
+    { name: "down", args: "<proj>", flags: [], positional: ["proj"], desc: "stop the daemon", usageKey: "usage.down" }, // prettier-ignore
+    { name: "restart", args: "<proj>", flags: [], positional: ["proj"], desc: "restart the daemon", usageKey: "usage.restart" }, // prettier-ignore
+    { name: "status", args: "[<proj>]", flags: ["--all", "--json"], positional: ["proj"], desc: "lane status", usageKey: "usage.status" }, // prettier-ignore
+    { name: "doctor", args: "[<proj>]", flags: [], positional: ["proj"], desc: "environment checks", usageKey: "usage.doctor" }, // prettier-ignore
+    { name: "logs", args: "<proj> <lane> [N]", flags: ["--engine"], positional: ["proj", "lane"], desc: "lane logs", usageKey: "usage.logs" }, // prettier-ignore
+    { name: "sessions", args: "<proj> <lane>", flags: [], positional: ["proj", "lane"], desc: "engine sessions", usageKey: "usage.sessions" }, // prettier-ignore
+    { name: "lane", args: "<add|ls|show|rm>", flags: [], subs: LANE_SUBS, desc: "manage lane configs", usageKey: "usage.lane" }, // prettier-ignore
+    { name: "completion", args: "<bash|zsh>", flags: [], desc: "shell completion", usageKey: "usage.completion" }, // prettier-ignore
+    { name: "alias", args: "[names...]", flags: [], desc: "install short aliases", usageKey: "usage.alias" }, // prettier-ignore
+    { name: "__daemon", args: "<proj>", flags: [], usageKey: "usage.daemon", hidden: true },
+];
+/** 도움말·자동완성에 노출할 명령(hidden 제외). */
+export function visibleCommands() {
+    return COMMAND_SPECS.filter((c) => !c.hidden);
+}
+/** 이름으로 명령 스펙 조회(디스패치 힌트·help 라우팅). */
+export function findCommand(name) {
+    return COMMAND_SPECS.find((c) => c.name === name);
+}
+/**
+ * 오타 추정 — 후보 중 대상과 편집거리가 가장 가까운 이름들(임계 이하)을 반환.
+ * 미지원 명령 힌트("did you mean")용. 완전 일치는 호출 전 이미 걸러진 상태를 가정.
+ */
+export function suggestCommands(input, max = 2) {
+    const names = visibleCommands().map((c) => c.name);
+    const scored = names
+        .map((name) => ({ name, d: editDistance(input, name) }))
+        // 짧은 명령의 오타를 잡되 무관한 제안 남발 방지 — 거리 ≤ max(2, len/2).
+        .filter(({ name, d }) => d <= Math.max(2, Math.floor(name.length / 2)))
+        .sort((a, b) => a.d - b.d);
+    return scored.slice(0, max).map((s) => s.name);
+}
+/** Levenshtein 편집거리(오타 제안용, 소규모 문자열 전용). */
+function editDistance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: n + 1 }, (_, j) => j);
+    for (let i = 1; i <= m; i++) {
+        let prev = dp[0];
+        dp[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const tmp = dp[j];
+            dp[j] = a[i - 1] === b[j - 1] ? prev : 1 + Math.min(prev, dp[j], dp[j - 1]);
+            prev = tmp;
+        }
+    }
+    return dp[n];
+}
+//# sourceMappingURL=spec.js.map

package/dist/cli/spec.js.map

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

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,73 @@
+import type { Liveness } from "./runtime-state.js";
+import type { LaunchctlExec } from "./launchd.js";
+export interface DiagBaseOptions {
+    /** 설정 base 경로(테스트 override). 미지정 시 $ADDE_HOME 또는 ~/.config/adde. */
+    base?: string;
+    /**
+     * launchctl 실행자 주입(테스트용 fake). 미주입 시 실 launchctl 호출.
+     * doctor daemon 점검이 CI에서 실 launchctl 을 때리지 않도록 주입 가능 구조로.
+     */
+    launchctlExec?: LaunchctlExec;
+}
+/** 레인 1개의 상태 행. */
+export interface LaneStatusRow {
+    lane: string;
+    status: Liveness;
+    pid: number | null;
+    sessionId: string | null;
+    source: string | null;
+    backend: string | null;
+    engine: string | null;
+    startedAt: string | null;
+    /** running 일 때 startedAt 기준 경과 ms(그 외 null). */
+    uptimeMs: number | null;
+    /** 마지막 하트비트 시각(runtime.json mtime) ISO. 파일 없거나 stat 실패 시 null. */
+    lastSeenAt: string | null;
+}
+/**
+ * proj 의 lanes.d 를 스캔해 각 레인의 라이브니스를 수집한다.
+ * running(파일 있고 pid 생존)·dead(파일 있으나 pid 없음=크래시)·stopped(파일 없음).
+ */
+export declare function collectStatus(proj: string, opts?: DiagBaseOptions): Promise<LaneStatusRow[]>;
+/** 집계 status 행 — 레인 상태에 소속 프로젝트를 부기(다중 프로젝트 뷰). */
+export type AggregatedLaneStatusRow = LaneStatusRow & {
+    proj: string;
+};
+/**
+ * base 하위에서 lanes.d 를 가진 프로젝트 디렉터리를 열거한다(정렬).
+ * 안전 세그먼트(경로 위생) 통과분만 — 비안전 이름은 조용히 제외(열거는 진단성 조회라 흡수).
+ * base 부재 시 빈 배열.
+ */
+export declare function listRegisteredProjects(opts?: DiagBaseOptions): Promise<string[]>;
+/**
+ * 전 프로젝트의 레인 상태를 집계한다(각 행에 proj 부기).
+ * 인자 없는 `adde status` 의 다중 프로젝트 뷰용. 실행 중/전체 필터는 표면 계층(cli/ops)이 결정한다.
+ */
+export declare function collectAllStatus(opts?: DiagBaseOptions): Promise<AggregatedLaneStatusRow[]>;
+export type CheckLevel = "PASS" | "WARN" | "FAIL";
+export interface DoctorCheck {
+    name: string;
+    level: CheckLevel;
+    detail: string;
+    /** 실패·경고 시 조치 힌트(액션형). PASS 에는 없음. */
+    hint?: string;
+}
+/**
+ * 상태 비의존 정적 점검. proj 미지정 시 전역 점검만, 지정 시 레인별 점검 추가.
+ * 각 항목 PASS/WARN/FAIL + 실패·경고에 조치 힌트.
+ */
+export declare function runDoctor(proj?: string, opts?: DiagBaseOptions): Promise<DoctorCheck[]>;
+export interface LogsResult {
+    /** 읽은 로그 파일 경로. */
+    path: string;
+    /** 파일이 존재했는가. false 면 lines 는 빈 배열. */
+    exists: boolean;
+    /** 최근 N줄(파일 끝 기준). */
+    lines: string[];
+}
+export interface ReadLogsOptions extends DiagBaseOptions {
+    /** true 면 transcript.log 대신 engine.log(엔진 stderr 캡처)를 읽는다. */
+    engine?: boolean;
+}
+/** 레인 로그(transcript.log 기본, engine 옵션 시 engine.log)의 최근 n줄을 반환한다. 파일 없으면 exists=false. */
+export declare function readLogs(proj: string, lane: string, n?: number, opts?: ReadLogsOptions): Promise<LogsResult>;

package/dist/core/diagnostics.js

@@ -0,0 +1,333 @@
+/**
+ * 운영 가시성 — status / doctor / logs 의 코어 로직(읽기 전용, 부수효과 없음).
+ * CLI 계층(cli/ops.ts)이 결과를 표/JSON/텍스트로 표면화한다.
+ */
+import { t } from "../shared/i18n.js";
+import { readFile, stat, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { laneList, resolveFileMode } from "./lane-config.js";
+import { resolveAdapterBin } from "./supervisor.js";
+import { readRuntime, livenessOf } from "./runtime-state.js";
+import { lanePaths, defaultBase, expandTilde, isSafeSegment } from "../shared/paths.js";
+import { parseLaneConf } from "../shared/conf.js";
+import { daemonRegState, daemonEntryPath } from "./launchd.js";
+/**
+ * proj 의 lanes.d 를 스캔해 각 레인의 라이브니스를 수집한다.
+ * running(파일 있고 pid 생존)·dead(파일 있으나 pid 없음=크래시)·stopped(파일 없음).
+ */
+export async function collectStatus(proj, opts = {}) {
+    const base = opts.base ?? defaultBase();
+    const { lanes } = await laneList(proj, { base });
+    const rows = [];
+    for (const lane of lanes) {
+        const paths = lanePaths(base, proj, lane);
+        const info = await readRuntime(paths);
+        // 하트비트 신선도 — runtime.json mtime 을 stat. 실패(부재 등)면 미주입(pid-only 판정).
+        let mtimeMs;
+        if (info) {
+            try {
+                mtimeMs = (await stat(paths.runtimeJson)).mtimeMs;
+            }
+            catch {
+                mtimeMs = undefined;
+            }
+        }
+        const status = livenessOf(info, { mtimeMs });
+        rows.push({
+            lane,
+            status,
+            pid: info?.pid ?? null,
+            sessionId: info?.sessionId ?? null,
+            source: info?.source ?? null,
+            backend: info?.backend ?? null,
+            engine: info?.engine ?? null,
+            startedAt: info?.startedAt ?? null,
+            uptimeMs: status === "running" && info?.startedAt
+                ? Math.max(0, Date.now() - Date.parse(info.startedAt))
+                : null,
+            lastSeenAt: mtimeMs !== undefined ? new Date(mtimeMs).toISOString() : null,
+        });
+    }
+    return rows;
+}
+/**
+ * base 하위에서 lanes.d 를 가진 프로젝트 디렉터리를 열거한다(정렬).
+ * 안전 세그먼트(경로 위생) 통과분만 — 비안전 이름은 조용히 제외(열거는 진단성 조회라 흡수).
+ * base 부재 시 빈 배열.
+ */
+export async function listRegisteredProjects(opts = {}) {
+    const base = opts.base ?? defaultBase();
+    let names;
+    try {
+        const entries = await readdir(base, { withFileTypes: true });
+        names = entries.filter((e) => e.isDirectory() && isSafeSegment(e.name)).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    const projs = [];
+    for (const name of names) {
+        // lanes.d 를 가진 디렉터리만 프로젝트로 간주(state·queue 등 부속 디렉터리 제외).
+        if (await pathExists(join(base, name, "lanes.d")))
+            projs.push(name);
+    }
+    return projs.sort();
+}
+/**
+ * 전 프로젝트의 레인 상태를 집계한다(각 행에 proj 부기).
+ * 인자 없는 `adde status` 의 다중 프로젝트 뷰용. 실행 중/전체 필터는 표면 계층(cli/ops)이 결정한다.
+ */
+export async function collectAllStatus(opts = {}) {
+    const base = opts.base ?? defaultBase();
+    const projs = await listRegisteredProjects({ ...opts, base });
+    const rows = [];
+    for (const proj of projs) {
+        const projRows = await collectStatus(proj, { ...opts, base });
+        for (const r of projRows)
+            rows.push({ ...r, proj });
+    }
+    return rows;
+}
+async function pathExists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 파일/디렉터리 권한 비트(mode & 0o777). 부재·stat 실패 시 null. */
+async function modeOf(p) {
+    try {
+        return (await stat(p)).mode & 0o777;
+    }
+    catch {
+        return null;
+    }
+}
+/** 권한 비트 → 3자리 8진 문자열(예: 0o640 → "640"). */
+function octal(mode) {
+    return (mode & 0o777).toString(8).padStart(3, "0");
+}
+/**
+ * 상태 비의존 정적 점검. proj 미지정 시 전역 점검만, 지정 시 레인별 점검 추가.
+ * 각 항목 PASS/WARN/FAIL + 실패·경고에 조치 힌트.
+ */
+export async function runDoctor(proj, opts = {}) {
+    const checks = [];
+    const base = opts.base ?? defaultBase();
+    // Node 버전 ≥ 22
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    checks.push(nodeMajor >= 22
+        ? { name: t("doctor.node.name"), level: "PASS", detail: `v${process.versions.node} (≥22)` }
+        : {
+            name: t("doctor.node.name"),
+            level: "FAIL",
+            detail: `v${process.versions.node} (<22)`,
+            hint: t("doctor.node.hint"),
+        });
+    // 어댑터 바이너리 해석
+    const adapterBin = resolveAdapterBin();
+    checks.push((await pathExists(adapterBin))
+        ? { name: t("doctor.adapter.name"), level: "PASS", detail: adapterBin }
+        : {
+            name: t("doctor.adapter.name"),
+            level: "FAIL",
+            detail: t("doctor.adapter.missing", { path: adapterBin }),
+            hint: t("doctor.adapter.hint"),
+        });
+    // base 디렉터리 가독
+    checks.push((await pathExists(base))
+        ? { name: t("doctor.base.name"), level: "PASS", detail: base }
+        : {
+            name: t("doctor.base.name"),
+            level: "WARN",
+            detail: t("doctor.missingPath", { path: base }),
+            hint: t("doctor.base.hint"),
+        });
+    // 데몬 진입 파일 — launchd 워커가 실행할 실재 .js. tsx dev(빌드 전)면 부재라 데몬 기동 불가.
+    // 데몬은 macOS 전용(비-darwin 은 loadDaemon 이 assertMacOS 로 거부)이므로 darwin 에서만 점검.
+    if (process.platform === "darwin") {
+        const daemonEntry = daemonEntryPath();
+        checks.push((await pathExists(daemonEntry))
+            ? { name: t("doctor.daemonEntry.name"), level: "PASS", detail: daemonEntry }
+            : {
+                name: t("doctor.daemonEntry.name"),
+                level: "WARN",
+                detail: t("doctor.daemonEntry.missing", { path: daemonEntry }),
+                hint: t("doctor.daemonEntry.hint"),
+            });
+    }
+    if (proj === undefined)
+        return checks;
+    // daemon 등록 상태 점검 (macOS 전용 — 비-darwin 은 항목 스킵).
+    if (process.platform === "darwin") {
+        try {
+            const launchdDeps = opts.launchctlExec ? { exec: opts.launchctlExec } : undefined;
+            const regState = await daemonRegState(proj, launchdDeps);
+            const { plistExists, launchctlRegistered } = regState;
+            if (plistExists && launchctlRegistered) {
+                // 둘 다 true — 정상 등록.
+                checks.push({
+                    name: t("doctor.daemon.name", { proj }),
+                    level: "PASS",
+                    detail: t("doctor.daemon.registered"),
+                });
+            }
+            else if (!plistExists && !launchctlRegistered) {
+                // 둘 다 false — 데몬 미기동 상태(정상 — 기동 전 또는 down 후).
+                checks.push({
+                    name: t("doctor.daemon.name", { proj }),
+                    level: "PASS",
+                    detail: t("doctor.daemon.notRunning", { proj }),
+                });
+            }
+            else {
+                // 불일치(plist XOR launchctl) — 복구 가능 경고.
+                const mismatch = plistExists
+                    ? t("doctor.daemon.plistOnly")
+                    : t("doctor.daemon.launchctlOnly");
+                checks.push({
+                    name: t("doctor.daemon.name", { proj }),
+                    level: "WARN",
+                    detail: mismatch,
+                    hint: t("doctor.daemon.mismatchHint", { proj }),
+                });
+            }
+        }
+        catch {
+            // daemonRegState 오류 — 정보 부재로 WARN 처리(진단이므로 throw 대신 흡수).
+            checks.push({
+                name: t("doctor.daemon.name", { proj }),
+                level: "WARN",
+                detail: t("doctor.daemon.queryFailed"),
+                hint: t("doctor.daemon.queryFailedHint", { proj }),
+            });
+        }
+    }
+    // 레인별 점검
+    const { lanes } = await laneList(proj, { base });
+    if (lanes.length === 0) {
+        checks.push({
+            name: t("doctor.lanes.name", { proj }),
+            level: "WARN",
+            detail: t("doctor.lanes.none"),
+            hint: t("doctor.lanes.addHint", { proj }),
+        });
+        return checks;
+    }
+    for (const lane of lanes) {
+        const paths = lanePaths(base, proj, lane);
+        let confText;
+        try {
+            confText = await readFile(paths.confFile, "utf8");
+        }
+        catch {
+            checks.push({
+                name: `${lane}: conf`,
+                level: "FAIL",
+                detail: t("doctor.conf.readFailed", { path: paths.confFile }),
+                hint: t("doctor.conf.readFailedHint"),
+            });
+            continue;
+        }
+        const conf = parseLaneConf(confText);
+        // source 유효성
+        if (conf.source === "telegram" || conf.source === "markdown") {
+            checks.push({ name: `${lane}: source`, level: "PASS", detail: conf.source });
+        }
+        else {
+            checks.push({
+                name: `${lane}: source`,
+                level: "FAIL",
+                detail: t("doctor.source.unsupported", { source: conf.source }),
+                hint: t("doctor.source.hint"),
+            });
+        }
+        // cwd 존재(지정된 경우)
+        if (conf.cwd) {
+            const cwd = expandTilde(conf.cwd);
+            checks.push((await pathExists(cwd))
+                ? { name: `${lane}: cwd`, level: "PASS", detail: cwd }
+                : {
+                    name: `${lane}: cwd`,
+                    level: "FAIL",
+                    detail: t("doctor.missingPath", { path: cwd }),
+                    hint: t("doctor.cwd.hint"),
+                });
+        }
+        // 토큰(telegram 한정)
+        if (conf.source === "telegram") {
+            let hasToken = false;
+            try {
+                hasToken = (await readFile(paths.envFile, "utf8")).includes("TELEGRAM_BOT_TOKEN=");
+            }
+            catch {
+                // env 파일 부재/읽기 실패 = 토큰 없음(초기값 유지)
+            }
+            checks.push(hasToken
+                ? {
+                    name: t("doctor.token.name", { lane }),
+                    level: "PASS",
+                    detail: t("doctor.token.present"),
+                }
+                : {
+                    name: t("doctor.token.name", { lane }),
+                    level: "FAIL",
+                    detail: t("doctor.token.missing", { path: paths.envFile }),
+                    hint: t("doctor.token.hint", { path: paths.envFile }),
+                });
+        }
+        // 파일 권한 감사 — 시크릿(.env)·private 모드 상태 디렉터리가 그룹/기타에 노출됐는지.
+        // .env 는 토큰을 담으므로 모드와 무관하게 그룹/기타 접근을 경고한다. state 디렉터리는
+        // file_mode=private 일 때만 0700 을 기대(shared 는 느슨한 권한이 의도된 선택이라 통과).
+        const envMode = await modeOf(paths.envFile);
+        const stateMode = await modeOf(paths.stateDir);
+        const looseEnv = envMode !== null && (envMode & 0o077) !== 0;
+        const looseState = stateMode !== null &&
+            resolveFileMode(conf.file_mode) === "private" &&
+            (stateMode & 0o077) !== 0;
+        // env·state 는 독립 관심사 — 둘 다 느슨하면 둘 다 경고한다(하나가 다른 하나를 가리지 않도록).
+        if (looseEnv) {
+            checks.push({
+                name: t("doctor.perms.name", { lane }),
+                level: "WARN",
+                detail: t("doctor.perms.envLoose", { mode: octal(envMode) }),
+                hint: t("doctor.perms.envHint", { path: paths.envFile }),
+            });
+        }
+        if (looseState) {
+            checks.push({
+                name: t("doctor.perms.name", { lane }),
+                level: "WARN",
+                detail: t("doctor.perms.stateLoose", { mode: octal(stateMode) }),
+                hint: t("doctor.perms.stateHint", { path: paths.stateDir, proj }),
+            });
+        }
+        if (!looseEnv && !looseState && (envMode !== null || stateMode !== null)) {
+            checks.push({
+                name: t("doctor.perms.name", { lane }),
+                level: "PASS",
+                detail: t("doctor.perms.ok"),
+            });
+        }
+    }
+    return checks;
+}
+/** 레인 로그(transcript.log 기본, engine 옵션 시 engine.log)의 최근 n줄을 반환한다. 파일 없으면 exists=false. */
+export async function readLogs(proj, lane, n = 50, opts = {}) {
+    const base = opts.base ?? defaultBase();
+    const paths = lanePaths(base, proj, lane);
+    const target = opts.engine ? paths.engineLog : paths.transcriptLog;
+    let text;
+    try {
+        text = await readFile(target, "utf8");
+    }
+    catch {
+        return { path: target, exists: false, lines: [] };
+    }
+    const all = text.split("\n").filter((l) => l.length > 0);
+    return { path: target, exists: true, lines: all.slice(-Math.max(1, n)) };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/core/diagnostics.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 코어 — 슈퍼바이저·레인 lifecycle·큐·직렬 인젝터·transcript logger·헬스.
+ */
+export { readVersion } from "./version.js";
+export { supervisorUp, supervisorDown } from "./supervisor.js";
+export type { LaneStatus, SupervisorUpResult, SupervisorDownResult, AcpFactory, SupervisorUpOptions, SupervisorDownOptions, } from "./supervisor.js";
+export { enqueue, claimNext, scanProcessing, isDone, writeOut } from "./queue.js";
+export type { OutSidecar } from "./queue.js";
+export { createInjector } from "./injector.js";
+export { appendTranscript, renderEvent } from "./transcript.js";
+export type { SessionEvent } from "./transcript.js";

package/dist/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * 코어 — 슈퍼바이저·레인 lifecycle·큐·직렬 인젝터·transcript logger·헬스.
+ */
+export { readVersion } from "./version.js";
+export { supervisorUp, supervisorDown } from "./supervisor.js";
+export { enqueue, claimNext, scanProcessing, isDone, writeOut } from "./queue.js";
+export { createInjector } from "./injector.js";
+export { appendTranscript, renderEvent } from "./transcript.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAS/D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/injector.d.ts

@@ -0,0 +1,27 @@
+import type { NotifyT } from "../shared/notify.js";
+import { writeOut } from "./queue.js";
+import type { LanePaths } from "../shared/paths.js";
+import type { AcpBackend } from "../backend/acp/client.js";
+import type { SessionEvent } from "./transcript.js";
+export type InjectorState = "idle" | "active";
+/** 처리 결과를 채널로 렌더하는 in-process 콜백(소스 renderOut 주입). 실패는 흡수(durable out/ 유지). */
+export type RenderCallback = (id: string) => Promise<void>;
+/**
+ * 주입 실패를 채널로 표면화하는 콜백(supervisor 가 Source.notify 로 배선).
+ * 보조 신호 — 알림 실패는 로그 후 흡수하고 .failed 사이드카·재처리 경로는 그대로 유지.
+ */
+export type FailNotifyCallback = (id: string, detail: string) => Promise<void>;
+export interface Injector {
+    start(): Promise<void>;
+    /** enqueue 등 외부 신호로 idle 레인을 깨워 다음 메시지를 처리한다(in-process, watch 불요). */
+    notify(): void;
+    /** backend 세션 이벤트 수신 — active turn 의 agent_message_chunk 텍스트를 누적. */
+    onSessionEvent(event: SessionEvent): void;
+    getState(): InjectorState;
+}
+/** 질문 발췌(첫 줄 80자, 마스킹) — 채널 렌더 헤더의 맥락 표시용 보조 정보. */
+export declare function questionExcerpt(text: string): string;
+export declare function createInjector(paths: LanePaths, lane: string, backend: AcpBackend, render?: RenderCallback, onFail?: FailNotifyCallback, 
+/** 제어 결과 등 채널 대면 문구의 로케일(레인 lang). 미지정 시 전역 t. */
+laneT?: NotifyT): Injector;
+export { writeOut };