adde-acp 0.1.3

package/dist/cli/ops.js

@@ -0,0 +1,230 @@
+/**
+ * `adde status|doctor|logs` — 운영 가시성 명령의 CLI 표면.
+ * core/diagnostics 의 읽기 전용 로직을 호출하고 표/JSON/텍스트로 표면화한다.
+ */
+import { collectStatus, collectAllStatus, runDoctor, readLogs } from "../core/diagnostics.js";
+import { checkForUpdate, formatUpdateNotice } from "../core/update-check.js";
+import { errMsg } from "../shared/errors.js";
+import { USAGE } from "../core/messages.js";
+import { t } from "../shared/i18n.js";
+import { readLedger, formatWhen } from "../core/session-ledger.js";
+import { lanePaths, defaultBase } from "../shared/paths.js";
+import { readFile } from "node:fs/promises";
+/** ms → 사람용 경과시간(예: 1h2m, 3m4s, 12s). */
+function formatUptime(ms) {
+    if (ms === null)
+        return "-";
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m${s % 60}s`;
+    const h = Math.floor(m / 60);
+    return `${h}h${m % 60}m`;
+}
+/** ISO 시각 → 현재 기준 경과(예: 12s, 3m4s). null 이면 "-". */
+function formatAge(iso) {
+    if (iso === null)
+        return "-";
+    const ms = Date.now() - Date.parse(iso);
+    return formatUptime(Number.isFinite(ms) ? Math.max(0, ms) : null);
+}
+function statusTable(rows) {
+    if (rows.length === 0)
+        return t("ops.status.noLanesConf");
+    const header = ["LANE", "STATUS", "PID", "UPTIME", "SEEN", "SOURCE"];
+    const body = rows.map((r) => [
+        r.lane,
+        r.status,
+        r.pid === null ? "-" : String(r.pid),
+        formatUptime(r.uptimeMs),
+        formatAge(r.lastSeenAt),
+        r.source ?? "-",
+    ]);
+    const widths = header.map((h, i) => Math.max(h.length, ...body.map((row) => (row[i] ?? "").length)));
+    const fmt = (cols) => cols.map((c, i) => c.padEnd(widths[i] ?? 0)).join("  ");
+    return [fmt(header), ...body.map(fmt)].join("\n");
+}
+/**
+ * 집계 status 표 — PROJECT 컬럼을 앞에 둔다(다중 프로젝트 뷰).
+ * 단일 프로젝트 표(statusTable)와 분리 — 기존 `status <proj>` 출력은 불변.
+ */
+function statusTableAggregate(rows, all) {
+    if (rows.length === 0) {
+        return all ? t("ops.status.noLanesRegistered") : t("ops.status.noRunning");
+    }
+    const header = ["PROJECT", "LANE", "STATUS", "PID", "UPTIME", "SEEN", "SOURCE"];
+    const body = rows.map((r) => [
+        r.proj,
+        r.lane,
+        r.status,
+        r.pid === null ? "-" : String(r.pid),
+        formatUptime(r.uptimeMs),
+        formatAge(r.lastSeenAt),
+        r.source ?? "-",
+    ]);
+    const widths = header.map((h, i) => Math.max(h.length, ...body.map((row) => (row[i] ?? "").length)));
+    const fmt = (cols) => cols.map((c, i) => c.padEnd(widths[i] ?? 0)).join("  ");
+    return [fmt(header), ...body.map(fmt)].join("\n");
+}
+/**
+ * 새 npm 버전이 있으면 안내 한 줄을 stdout 에 덧붙인다(보조 — 조회 실패는 무시).
+ * 네트워크 조회는 대화형(TTY)에서만 허용해 파이프·스크립트에는 지연·잡음을 주지 않는다.
+ */
+async function printUpdateNoticeIfAny() {
+    try {
+        const notice = await checkForUpdate({ allowNetwork: process.stdout.isTTY === true });
+        if (notice)
+            process.stdout.write("\n" + formatUpdateNotice(notice) + "\n");
+    }
+    catch {
+        // 보조 기능 — 조회 실패는 흡수.
+    }
+}
+export async function runStatus(rest) {
+    const json = rest.includes("--json");
+    const all = rest.includes("--all");
+    const proj = rest.find((a) => !a.startsWith("--"));
+    // 인자 없음 → 전 프로젝트 집계(CCTG parity). 기본은 실행 중(정지 제외), --all 은 정지 포함 전체.
+    if (!proj) {
+        const allRows = await collectAllStatus();
+        const rows = all ? allRows : allRows.filter((r) => r.status !== "stopped");
+        if (json) {
+            process.stdout.write(JSON.stringify(rows, null, 2) + "\n");
+        }
+        else {
+            process.stdout.write(statusTableAggregate(rows, all) + "\n");
+            const dead = rows.filter((r) => r.status === "dead");
+            if (dead.length > 0) {
+                process.stdout.write("\n" +
+                    t("ops.status.deadWarnAggregate", {
+                        lanes: dead.map((r) => `${r.proj}/${r.lane}`).join(", "),
+                    }) +
+                    "\n");
+            }
+            const stale = rows.filter((r) => r.status === "stale");
+            if (stale.length > 0) {
+                process.stdout.write("\n" +
+                    t("ops.status.staleWarnAggregate", {
+                        lanes: stale.map((r) => `${r.proj}/${r.lane}`).join(", "),
+                    }) +
+                    "\n");
+            }
+            await printUpdateNoticeIfAny();
+        }
+        return rows.some((r) => r.status === "dead" || r.status === "stale") ? 1 : 0;
+    }
+    const rows = await collectStatus(proj);
+    if (json) {
+        process.stdout.write(JSON.stringify(rows, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write(statusTable(rows) + "\n");
+        const dead = rows.filter((r) => r.status === "dead");
+        if (dead.length > 0) {
+            process.stdout.write("\n" +
+                t("ops.status.deadWarnSingle", { lanes: dead.map((r) => r.lane).join(", "), proj }) +
+                "\n");
+        }
+        const stale = rows.filter((r) => r.status === "stale");
+        if (stale.length > 0) {
+            process.stdout.write("\n" +
+                t("ops.status.staleWarnSingle", { lanes: stale.map((r) => r.lane).join(", "), proj }) +
+                "\n");
+        }
+        await printUpdateNoticeIfAny();
+    }
+    // 비정상(dead 크래시·stale 행) 잔존을 종료 코드로 신호 — 모니터링 친화.
+    return rows.some((r) => r.status === "dead" || r.status === "stale") ? 1 : 0;
+}
+function checkSymbol(level) {
+    return level === "PASS" ? "✔" : level === "WARN" ? "▲" : "✘";
+}
+export async function runDoctorCli(rest) {
+    const proj = rest.find((a) => !a.startsWith("--"));
+    const checks = await runDoctor(proj);
+    for (const c of checks) {
+        process.stdout.write(`${checkSymbol(c.level)} [${c.level}] ${c.name}: ${c.detail}\n`);
+        if (c.hint)
+            process.stdout.write(t("ops.doctor.hint", { hint: c.hint }) + "\n");
+    }
+    const fails = checks.filter((c) => c.level === "FAIL").length;
+    const warns = checks.filter((c) => c.level === "WARN").length;
+    process.stdout.write("\n" +
+        t("ops.doctor.summary", { pass: checks.length - fails - warns, warn: warns, fail: fails }) +
+        "\n");
+    await printUpdateNoticeIfAny();
+    return fails > 0 ? 1 : 0;
+}
+/** `adde sessions <proj> <lane>` — 세션 장부 목록(read-only). 재개는 채널 명령으로 수행. */
+export async function runSessions(rest) {
+    const [proj, lane] = rest;
+    if (!proj || !lane) {
+        process.stderr.write(USAGE.sessions + "\n");
+        return 1;
+    }
+    let paths;
+    try {
+        paths = lanePaths(defaultBase(), proj, lane);
+    }
+    catch (err) {
+        process.stderr.write(errMsg(err) + "\n");
+        return 1;
+    }
+    const entries = await readLedger(paths);
+    if (entries.length === 0) {
+        process.stdout.write(t("injector.control.sessionsEmpty") + "\n");
+        return 0;
+    }
+    let current = null;
+    try {
+        current = (await readFile(paths.sessionIdFile, "utf8")).trim() || null;
+    }
+    catch {
+        // 세션 파일 부재 — 현재 표시 생략
+    }
+    const lines = entries.map((e, i) => {
+        const label = e.label ?? t("injector.control.sessionsNoLabel");
+        const mark = e.id === current ? " ◀" : "";
+        return (t("injector.control.sessionsItem", {
+            n: i + 1,
+            label,
+            last: formatWhen(e.lastActivityAt),
+            id: e.id,
+        }) + mark);
+    });
+    process.stdout.write(`${t("injector.control.sessionsHeader")}\n${lines.join("\n")}\n\n${t("injector.control.sessionsHint")}\n`);
+    return 0;
+}
+export async function runLogs(rest) {
+    const engine = rest.includes("--engine");
+    const positional = rest.filter((a) => !a.startsWith("--"));
+    const [proj, lane, nRaw] = positional;
+    if (!proj || !lane) {
+        process.stderr.write(USAGE.logs + "\n");
+        return 1;
+    }
+    const n = nRaw !== undefined && /^\d+$/.test(nRaw) ? Number(nRaw) : 50;
+    let result;
+    try {
+        result = await readLogs(proj, lane, n, { engine });
+    }
+    catch (err) {
+        // proj/lane 검증 실패(경로 탈출 차단 등) — 친절한 메시지 후 비정상 종료코드.
+        process.stderr.write(errMsg(err) + "\n");
+        return 1;
+    }
+    if (!result.exists) {
+        const what = engine ? t("ops.logs.whatEngine") : t("ops.logs.whatTranscript");
+        process.stdout.write(t("ops.logs.notFound", { what, path: result.path, proj }) + "\n");
+        return 0;
+    }
+    if (result.lines.length === 0) {
+        process.stdout.write(t("ops.logs.empty", { path: result.path }) + "\n");
+        return 0;
+    }
+    process.stdout.write(result.lines.join("\n") + "\n");
+    return 0;
+}
+//# sourceMappingURL=ops.js.map

package/dist/cli/ops.js.map

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

package/dist/cli/prompt.d.ts

@@ -0,0 +1,15 @@
+/** 한 줄 질의 함수 — (질문, 기본값) → 응답. */
+export type Ask = (question: string, def?: string) => Promise<string>;
+export interface Prompter {
+    ask: Ask;
+    /** 가려진 입력(에코 억제) — 봇 토큰 등 시크릿 수집용. 기본값 없음. */
+    askSecret: (question: string) => Promise<string>;
+    close: () => void;
+}
+/** 주입 가능한 입출력(테스트용). 미지정 시 process.stdin/stdout. */
+export interface PrompterDeps {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+/** process.stdin/stdout 에 붙는 대화형 프롬프터를 만든다(TTY 에서 사용). */
+export declare function createPrompter(deps?: PrompterDeps): Prompter;

package/dist/cli/prompt.js

@@ -0,0 +1,41 @@
+/**
+ * 대화형 프롬프트 — readline 기반 질의(ask)와 가려진 입력(askSecret).
+ * askSecret 은 출력 스트림을 일시 뮤트해 봇 토큰 등 시크릿이 화면에 에코되지 않게 한다
+ * (시크릿 비노출 원칙 — transcript·화면 평문 노출 금지).
+ */
+import * as readline from "node:readline/promises";
+import { Writable } from "node:stream";
+/** process.stdin/stdout 에 붙는 대화형 프롬프터를 만든다(TTY 에서 사용). */
+export function createPrompter(deps = {}) {
+    const input = deps.input ?? process.stdin;
+    const sink = deps.output ?? process.stdout;
+    let muted = false;
+    // 뮤트 가능 출력 — askSecret 동안 readline 의 키 에코를 삼킨다.
+    const out = new Writable({
+        write(chunk, _enc, cb) {
+            if (!muted)
+                sink.write(chunk);
+            cb();
+        },
+    });
+    const rl = readline.createInterface({ input, output: out, terminal: true });
+    const ask = async (question, def) => {
+        const a = (await rl.question(`${question}${def ? ` [${def}]` : ""}: `)).trim();
+        return a || (def ?? "");
+    };
+    const askSecret = async (question) => {
+        // 프롬프트는 뮤트 전에 출력하고, 입력 구간만 뮤트해 에코를 억제.
+        sink.write(`${question}: `);
+        muted = true;
+        try {
+            const a = await rl.question("");
+            return a.trim();
+        }
+        finally {
+            muted = false;
+            sink.write("\n");
+        }
+    };
+    return { ask, askSecret, close: () => rl.close() };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAkBvC,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,OAAqB,EAAE;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,gDAAgD;IAChD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC;QACvB,KAAK,CAAC,KAAa,EAAE,IAAI,EAAE,EAAE;YAC3B,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC9B,EAAE,EAAE,CAAC;QACP,CAAC;KACF,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAQ,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE;QACvC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;QAC5D,uCAAuC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;QAC5B,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,KAAK,GAAG,KAAK,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;AACrD,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI 진입 로직. adde / add 양쪽 진입점이 공유한다.
+ * @returns 프로세스 종료 코드.
+ */
+export declare function run(argv: readonly string[]): Promise<number>;

package/dist/cli/run.js

@@ -0,0 +1,216 @@
+import { readVersion } from "../core/version.js";
+import { errMsg } from "../shared/errors.js";
+import { COMMANDS, buildUsage, USAGE, cmdError } from "../core/messages.js";
+import { formatException } from "../shared/notify.js";
+import { t } from "../shared/i18n.js";
+import { findCommand, suggestCommands } from "./spec.js";
+import { completionScript, SUPPORTED_SHELLS } from "./completion.js";
+/** -h/--help 플래그가 인자에 있는지. */
+function wantsHelp(argv) {
+    return argv.includes("--help") || argv.includes("-h");
+}
+/**
+ * 포그라운드 데몬 워커 로직 — `adde __daemon <proj>` 가 호출한다.
+ * supervisorUp 후 SIGTERM/SIGINT graceful shutdown 까지 포그라운드 상주.
+ * launchd KeepAlive 재기동 시에도 이 경로로 진입한다.
+ */
+async function runDaemonForeground(proj) {
+    const { supervisorUp, supervisorDown } = await import("../core/supervisor.js");
+    const result = await supervisorUp(proj);
+    process.stdout.write(`${result.message}\n`);
+    // 기동 실패 레인은 원인 + 조치(doctor/logs)를 인라인 표면화.
+    const errorLanes = result.lanes.filter((l) => l.status === "error");
+    for (const l of errorLanes) {
+        process.stderr.write(formatException({
+            situation: t("run.laneStartFailed.situation", {
+                lane: l.lane,
+                error: l.error ?? t("run.unknownCause"),
+            }),
+            action: t("run.laneStartFailed.action", { proj, lane: l.lane }),
+        }) + "\n");
+    }
+    const running = result.lanes.filter((l) => l.status === "running");
+    if (running.length === 0) {
+        // 레인 conf 자체가 없으면 생성 단계를 안내한다.
+        if (result.lanes.length === 0) {
+            process.stderr.write(formatException({
+                situation: t("run.noLanes.situation", { proj }),
+                action: t("run.noLanes.action", { proj }),
+            }) + "\n");
+        }
+        // 기동된 레인이 없으면 상주할 이유가 없다 — 오류 레인이 있으면 1.
+        return errorLanes.length > 0 ? 1 : 0;
+    }
+    // 종료 신호 시 graceful shutdown — supervisorDown 으로 엔진 child·소스를 정리한 뒤 종료.
+    // await 완료 후에만 exit(typescript 규칙: 비동기 작업이 끝나기 전에 process.exit 금지).
+    let shuttingDown = false;
+    const shutdown = (sig) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        process.stderr.write(`\n${t("run.signalShutdown", { sig })}\n`);
+        void supervisorDown(proj)
+            .then((r) => {
+            process.stdout.write(`${r.message}\n`);
+            process.exit(0);
+        })
+            .catch((err) => {
+            process.stderr.write(formatException({
+                situation: t("run.shutdownError.situation", {
+                    error: errMsg(err),
+                }),
+                action: t("run.shutdownError.action"),
+            }) + "\n");
+            process.exit(1);
+        });
+    };
+    process.once("SIGINT", () => shutdown("SIGINT"));
+    process.once("SIGTERM", () => shutdown("SIGTERM"));
+    // 레인 기동 성공 → 소스 루프가 이벤트 루프를 유지하는 동안 포그라운드 상주.
+    // 종료(SIGTERM/SIGINT) 까지 resolve 하지 않아 진입점의 process.exit 를 막는다.
+    await new Promise(() => { });
+    return 0; // 도달하지 않음
+}
+/**
+ * CLI 진입 로직. adde / add 양쪽 진입점이 공유한다.
+ * @returns 프로세스 종료 코드.
+ */
+export async function run(argv) {
+    const [first, second] = argv;
+    if (first === "--version" || first === "-v") {
+        process.stdout.write(`${COMMANDS.primary} ${readVersion()}\n`);
+        return 0;
+    }
+    // 서브커맨드별 도움말 — `adde <cmd> --help`. lane 은 runLane 가 자체 처리(하위 명령 도움말).
+    if (first !== undefined && first !== "lane" && wantsHelp(argv.slice(1))) {
+        const spec = findCommand(first);
+        if (spec?.usageKey && !spec.hidden) {
+            process.stdout.write(t(spec.usageKey) + "\n");
+            return 0;
+        }
+    }
+    if (first === "completion") {
+        const shell = second;
+        if (!shell) {
+            process.stderr.write(USAGE.completion + "\n");
+            return 1;
+        }
+        const script = completionScript(shell);
+        if (script === null) {
+            process.stderr.write(cmdError("completion", t("completion.unknownShell", { shell, supported: SUPPORTED_SHELLS.join("|") })) + "\n");
+            return 1;
+        }
+        process.stdout.write(script);
+        return 0;
+    }
+    if (first === "init") {
+        const { runInit } = await import("./init.js");
+        return runInit(argv.slice(1));
+    }
+    if (first === "alias") {
+        const { runAlias } = await import("./init.js");
+        return runAlias(argv.slice(1));
+    }
+    if (first === "lane") {
+        const { runLane } = await import("./lane.js");
+        return runLane(argv.slice(1));
+    }
+    if (first === "status") {
+        const { runStatus } = await import("./ops.js");
+        return runStatus(argv.slice(1));
+    }
+    if (first === "doctor") {
+        const { runDoctorCli } = await import("./ops.js");
+        return runDoctorCli(argv.slice(1));
+    }
+    if (first === "logs") {
+        const { runLogs } = await import("./ops.js");
+        return runLogs(argv.slice(1));
+    }
+    if (first === "sessions") {
+        const { runSessions } = await import("./ops.js");
+        return runSessions(argv.slice(1));
+    }
+    // 내부 서브커맨드 — launchd 가 데몬 워커로 기동하는 포그라운드 상주 진입점.
+    // 도움말 미노출(최소 표면). 사용자가 직접 부르지 않는 내부 명령.
+    if (first === "__daemon") {
+        const proj = second;
+        if (!proj) {
+            process.stderr.write(t("usage.daemon") + "\n");
+            return 1;
+        }
+        try {
+            return await runDaemonForeground(proj);
+        }
+        catch (err) {
+            process.stderr.write(cmdError("__daemon", errMsg(err)) + "\n");
+            return 1;
+        }
+    }
+    if (first === "up") {
+        const proj = second;
+        if (!proj) {
+            process.stderr.write(USAGE.up + "\n");
+            return 1;
+        }
+        try {
+            const { loadDaemon } = await import("../core/launchd.js");
+            await loadDaemon(proj);
+            process.stdout.write(t("run.upDone", { proj }) + "\n");
+            process.stdout.write(t("run.statusHint", { proj }) + "\n");
+            return 0;
+        }
+        catch (err) {
+            process.stderr.write(cmdError("up", errMsg(err)) + "\n");
+            return 1;
+        }
+    }
+    if (first === "down") {
+        const proj = second;
+        if (!proj) {
+            process.stderr.write(USAGE.down + "\n");
+            return 1;
+        }
+        try {
+            const { unloadDaemon } = await import("../core/launchd.js");
+            await unloadDaemon(proj);
+            process.stdout.write(t("run.downDone", { proj }) + "\n");
+            return 0;
+        }
+        catch (err) {
+            process.stderr.write(cmdError("down", errMsg(err)) + "\n");
+            return 1;
+        }
+    }
+    if (first === "restart") {
+        const proj = second;
+        if (!proj) {
+            process.stderr.write(USAGE.restart + "\n");
+            return 1;
+        }
+        try {
+            const { unloadDaemon, loadDaemon } = await import("../core/launchd.js");
+            // down 완료 await 후 up — 부분 실패 시 up 오류 표면화.
+            await unloadDaemon(proj);
+            await loadDaemon(proj);
+            process.stdout.write(t("run.restartDone", { proj }) + "\n");
+            process.stdout.write(t("run.statusHint", { proj }) + "\n");
+            return 0;
+        }
+        catch (err) {
+            process.stderr.write(cmdError("restart", errMsg(err)) + "\n");
+            return 1;
+        }
+    }
+    // 인자 없음·명시적 도움말 → 사용법(정상 종료).
+    if (first === undefined || first === "-h" || first === "--help" || first === "help") {
+        process.stdout.write(`${buildUsage()}\n`);
+        return 0;
+    }
+    // 미지원 명령 → stderr 로 오류(+오타 추정 힌트) + 사용법, 비정상 종료(스크립트 오류 은폐 방지).
+    const suggestions = suggestCommands(first);
+    const hint = suggestions.length > 0 ? " " + t("cli.didYouMean", { cmds: suggestions.join(", ") }) : "";
+    process.stderr.write(`${t("cli.unknownCmd", { cmd: first })}${hint}\n\n${buildUsage()}\n`);
+    return 1;
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/spec.d.ts

@@ -0,0 +1,48 @@
+/**
+ * CLI 명령·플래그 스펙(SSOT) — 셸 자동완성·서브커맨드 도움말·미지원 명령 힌트가 공유한다.
+ * 명령/플래그를 한 곳에서 선언해 자동완성·힌트가 함께 갱신되도록(확장성): 새 명령·플래그는
+ * 여기에 추가하면 completion·help·"did you mean" 힌트에 자동 반영된다. 문구 본문(설명)은
+ * i18n 카탈로그가 소유하고, 본 스펙은 이름·인자 형태·플래그 목록(구조)만 담는다.
+ */
+/** 위치 인자 종류 — 자동완성 동적 후보(proj/lane 이름 스캔)를 결정한다. */
+export type ArgKind = "proj" | "lane";
+/** 최상위 명령 스펙. usageKey 는 `adde <cmd> --help` 및 인자 누락 시 출력할 i18n usage 키. */
+export interface CommandSpec {
+    /** 명령 이름(디스패치·자동완성 후보). */
+    name: string;
+    /** 위치 인자 형태 힌트(예: `<proj>`, `[<proj>]`). */
+    args: string;
+    /** 이 명령이 받는 옵션 플래그(자동완성·힌트용). */
+    flags: readonly string[];
+    /** 위치 인자 종류(순서대로) — 자동완성이 해당 위치에서 proj/lane 이름을 완성한다. */
+    positional?: readonly ArgKind[];
+    /** zsh 자동완성에서 명령 옆에 표시할 짧은 설명(영문). */
+    desc?: string;
+    /** i18n usage 키(있으면 `--help`·인자누락 시 출력). */
+    usageKey?: string;
+    /** 하위 명령 이름(예: lane 의 add/ls/show/rm). */
+    subs?: readonly string[];
+    /** 도움말·자동완성 노출 제외(내부 명령). */
+    hidden?: boolean;
+}
+/** 값이 열거형인 플래그 — 자동완성이 플래그 뒤에서 이 값들을 완성한다. */
+export declare const FLAG_VALUES: Record<string, readonly string[]>;
+/** 디렉터리 경로를 받는 플래그 — 자동완성이 뒤에서 디렉터리를 완성한다. */
+export declare const DIR_FLAGS: readonly ["--cwd", "--root"];
+/** 전역 옵션(모든 명령 위치에서 완성 후보). */
+export declare const GLOBAL_FLAGS: readonly ["-h", "--help", "-v", "--version"];
+/** `lane add` 옵션 플래그(SSOT — lane.ts ADD_VALUE_KEYS 의 표면형 `--key`). */
+export declare const LANE_ADD_FLAGS: readonly ["--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 declare const LANE_SUBS: readonly ["add", "ls", "show", "rm", "help"];
+/** 최상위 명령 SSOT. hidden 명령은 도움말·자동완성에서 제외. */
+export declare const COMMAND_SPECS: readonly CommandSpec[];
+/** 도움말·자동완성에 노출할 명령(hidden 제외). */
+export declare function visibleCommands(): CommandSpec[];
+/** 이름으로 명령 스펙 조회(디스패치 힌트·help 라우팅). */
+export declare function findCommand(name: string): CommandSpec | undefined;
+/**
+ * 오타 추정 — 후보 중 대상과 편집거리가 가장 가까운 이름들(임계 이하)을 반환.
+ * 미지원 명령 힌트("did you mean")용. 완전 일치는 호출 전 이미 걸러진 상태를 가정.
+ */
+export declare function suggestCommands(input: string, max?: number): string[];