adde-acp 0.1.3

package/dist/backend/acp/lifecycle.js

@@ -0,0 +1,56 @@
+/** Promise 를 시한부로 감싼다 — 초과 시 onTimeout() 으로 reject. settle 시 타이머 정리(누수 방지). */
+export function withTimeout(p, ms, onTimeout) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(onTimeout()), ms);
+    });
+    return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
+}
+/**
+ * 실패 경로용 즉시 강제 종료 — 핸드셰이크 실패 등에서 child 누수 방지.
+ * 종료 판정은 exitCode===null(생존)로만 한다 — child.killed 는 "신호를 보냈다"는 뜻이지
+ * "죽었다"가 아니므로 가드에 쓰면 SIGKILL 이 누락된다.
+ */
+export function killChild(child) {
+    // kill() 은 신호 전송 불가 상태(이미 종료·EPERM)에서 throw 할 수 있다 — 흡수한다.
+    // 생존 판정은 호출부가 exitCode 로 하므로 전송 실패가 곧 누수는 아니다.
+    if (child.exitCode === null) {
+        try {
+            child.kill("SIGKILL");
+        }
+        catch {
+            /* 신호 전송 실패 — noop(이미 종료 등) */
+        }
+    }
+}
+/** graceful 종료: SIGTERM → graceMs 유예 → 미종료 시 SIGKILL. child exit 시 조기 정리. */
+export async function closeChild(child, graceMs) {
+    if (child.exitCode !== null)
+        return;
+    await new Promise((resolve) => {
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            // SIGTERM 무응답 → 강제 종료. child.killed(신호 전송 여부) 가 아니라 생존 여부로 판정.
+            killChild(child);
+            finish();
+        }, graceMs);
+        child.once("exit", finish);
+        try {
+            child.kill("SIGTERM");
+        }
+        catch {
+            // SIGTERM 전송 실패(이미 종료·EPERM 등) — executor throw 는 Promise 를 reject 시켜 close 호출부의
+            // 셧다운을 중단시키므로 흡수한다. 즉시 강제 종료 시도 후 종결(무한 대기 방지).
+            killChild(child);
+            finish();
+        }
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/backend/acp/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/backend/acp/lifecycle.ts"],"names":[],"mappings":"AAMA,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAI,CAAa,EAAE,EAAU,EAAE,SAAsB;IAC9E,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAmB;IAC3C,2DAA2D;IAC3D,+CAA+C;IAC/C,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAmB,EAAE,OAAe;IACnE,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACpC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,+DAA+D;YAC/D,SAAS,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,EAAE,CAAC;QACX,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,iFAAiF;YACjF,gDAAgD;YAChD,SAAS,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/acp/perm-diff.d.ts

@@ -0,0 +1,37 @@
+import { t } from "../../shared/i18n.js";
+/** 로케일 고정 t (레인별 채널 로케일). 미지정 시 전역 로케일. */
+type Tl = typeof t;
+export interface AddePolicy {
+    perm_tier: string;
+    allowlist?: string[];
+    /** perm_tier=autopass 에서 채널 승인으로 폴백할 도구명 목록. */
+    denylist?: string[];
+    /** 방어심화 하드-거부 목록 — 매칭 도구는 티어 무관하게 즉시 거부(채널 프롬프트 없음). */
+    hard_deny?: string[];
+}
+export interface EngineEffective {
+    permissionMode?: string | undefined;
+    bypassPermissions?: boolean | undefined;
+}
+export interface PermDiffResult {
+    diff: boolean;
+    warn?: {
+        level: "WARN";
+        message: string;
+        adde: AddePolicy;
+        engine: EngineEffective | null;
+        reason: string;
+    };
+}
+/**
+ * ADDE 정책과 엔진 실효 설정을 비교한다.
+ * 동일 입력에서 단일 분기 블록으로 "차이 여부 + WARN 발화" 결정(research §E).
+ *
+ * engineEffective 가 null 이면 조회 실패로 간주 → 보수적 "확인불가=차이" WARN.
+ */
+export declare function comparePerm(addePolicy: AddePolicy, engineEffective: EngineEffective | null, tl?: Tl): PermDiffResult;
+/**
+ * WARN 메시지 포맷 — 마스킹 적용.
+ */
+export declare function formatWarn(adde: AddePolicy, engine: EngineEffective | null, reason: string, tl?: Tl): string;
+export {};

package/dist/backend/acp/perm-diff.js

@@ -0,0 +1,58 @@
+/**
+ * 설정 차이 비교·WARN.
+ * ADDE 정책 ↔ 엔진 실효 설정 비교.
+ * 안전망: 조회 실패 시 "확인불가=차이"로 보수적 WARN 발화.
+ */
+import { maskSecrets } from "../../shared/mask.js";
+import { t } from "../../shared/i18n.js";
+/**
+ * ADDE 정책과 엔진 실효 설정을 비교한다.
+ * 동일 입력에서 단일 분기 블록으로 "차이 여부 + WARN 발화" 결정(research §E).
+ *
+ * engineEffective 가 null 이면 조회 실패로 간주 → 보수적 "확인불가=차이" WARN.
+ */
+export function comparePerm(addePolicy, engineEffective, tl = t) {
+    if (engineEffective === null) {
+        const warn = {
+            level: "WARN",
+            message: formatWarn(addePolicy, null, tl("permDiff.queryFailedMsg"), tl),
+            adde: addePolicy,
+            engine: null,
+            reason: "조회실패",
+        };
+        return { diff: true, warn };
+    }
+    const engineIsBypass = engineEffective.bypassPermissions === true ||
+        engineEffective.permissionMode === "bypassPermissions";
+    if (addePolicy.perm_tier === "acp" && engineIsBypass) {
+        const warn = {
+            level: "WARN",
+            message: formatWarn(addePolicy, engineEffective, tl("permDiff.looseEngine"), tl),
+            adde: addePolicy,
+            engine: engineEffective,
+            reason: "정책차이",
+        };
+        return { diff: true, warn };
+    }
+    if (addePolicy.perm_tier === "autopass" && engineIsBypass) {
+        // 엔진 bypass 는 권한 요청 자체를 발화하지 않는다 — autopass 의 denylist 폴백·자동허용
+        // 기록이 전부 무력화되므로 acp 와 별도 사유로 표기한다.
+        const warn = {
+            level: "WARN",
+            message: formatWarn(addePolicy, engineEffective, tl("permDiff.bypassMsg"), tl),
+            adde: addePolicy,
+            engine: engineEffective,
+            reason: "정책차이",
+        };
+        return { diff: true, warn };
+    }
+    return { diff: false };
+}
+/**
+ * WARN 메시지 포맷 — 마스킹 적용.
+ */
+export function formatWarn(adde, engine, reason, tl = t) {
+    const engineStr = engine ? JSON.stringify(engine) : tl("permDiff.engineUnknown");
+    return maskSecrets(tl("permDiff.warnLine", { reason, tier: adde.perm_tier, engine: engineStr }));
+}
+//# sourceMappingURL=perm-diff.js.map

package/dist/backend/acp/perm-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perm-diff.js","sourceRoot":"","sources":["../../../src/backend/acp/perm-diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAC;AA8BzC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,UAAsB,EACtB,eAAuC,EACvC,KAAS,CAAC;IAEV,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,MAAe;YACtB,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,EAAE,EAAE,CAAC;YACxE,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,MAAM;SACf,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,cAAc,GAClB,eAAe,CAAC,iBAAiB,KAAK,IAAI;QAC1C,eAAe,CAAC,cAAc,KAAK,mBAAmB,CAAC;IAEzD,IAAI,UAAU,CAAC,SAAS,KAAK,KAAK,IAAI,cAAc,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,MAAe;YACtB,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,CAAC;YAChF,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,MAAM;SACf,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,UAAU,CAAC,SAAS,KAAK,UAAU,IAAI,cAAc,EAAE,CAAC;QAC1D,+DAA+D;QAC/D,mCAAmC;QACnC,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,MAAe;YACtB,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC;YAC9E,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,MAAM;SACf,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAgB,EAChB,MAA8B,EAC9B,MAAc,EACd,KAAS,CAAC;IAEV,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC;IACjF,OAAO,WAAW,CAAC,EAAE,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/dist/backend/acp/spawn.d.ts

@@ -0,0 +1,20 @@
+import type { ChildProcess } from "node:child_process";
+/**
+ * process.env 복사본에서 중첩 유발 키를 제거한 clean env 반환.
+ * 테스트 주입 가능하도록 분리 export.
+ */
+export declare function cleanEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** spawnEngine 옵션. */
+export interface SpawnEngineOptions {
+    /**
+     * 지정되면 엔진 stderr 를 이 경로로 append 캡처한다(디렉터리 자동 생성).
+     * 미지정 시 기존 동작(부모 stderr inherit)을 유지한다 — 테스트/레거시 호환.
+     */
+    stderrPath?: string;
+}
+/**
+ * ACP 엔진 바이너리를 clean env 로 spawn 한다.
+ * stdio는 pipe 모드: stdin/stdout 을 ACP JSON-RPC 채널로 사용.
+ * opts.stderrPath 지정 시 stderr 를 파일로 append 캡처(미지정 시 inherit).
+ */
+export declare function spawnEngine(bin: string, args: string[], opts?: SpawnEngineOptions): ChildProcess;

package/dist/backend/acp/spawn.js

@@ -0,0 +1,70 @@
+/**
+ * 엔진 서브프로세스 spawn — clean env 보장.
+ * CLAUDECODE·CLAUDE_CODE_ENTRYPOINT 삭제 후 spawn.
+ */
+import { spawn } from "node:child_process";
+import { createWriteStream, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { maskSecrets } from "../../shared/mask.js";
+/** CLAUDECODE 중첩 유발 환경변수 목록. */
+const NESTED_GUARD_KEYS = ["CLAUDECODE", "CLAUDE_CODE_ENTRYPOINT"];
+/**
+ * process.env 복사본에서 중첩 유발 키를 제거한 clean env 반환.
+ * 테스트 주입 가능하도록 분리 export.
+ */
+export function cleanEnv(env) {
+    const result = { ...env };
+    for (const key of NESTED_GUARD_KEYS) {
+        delete result[key];
+    }
+    return result;
+}
+/**
+ * ACP 엔진 바이너리를 clean env 로 spawn 한다.
+ * stdio는 pipe 모드: stdin/stdout 을 ACP JSON-RPC 채널로 사용.
+ * opts.stderrPath 지정 시 stderr 를 파일로 append 캡처(미지정 시 inherit).
+ */
+export function spawnEngine(bin, args, opts = {}) {
+    const captureStderr = opts.stderrPath !== undefined;
+    const child = spawn(bin, args, {
+        // stderr: 캡처 시 pipe(소비 필수 — 미소비 시 backpressure 로 child 가 막힘), 아니면 inherit.
+        stdio: ["pipe", "pipe", captureStderr ? "pipe" : "inherit"],
+        env: cleanEnv(process.env),
+    });
+    if (captureStderr && child.stderr) {
+        const path = opts.stderrPath;
+        mkdirSync(dirname(path), { recursive: true });
+        const ws = createWriteStream(path, { flags: "a" });
+        // 로그 스트림 오류는 흡수(진단 로그 — 엔진 동작 비차단, unhandled 'error' 방지).
+        ws.on("error", () => { });
+        // engine.log 는 마스킹되지 않는 side channel — 라인 단위로 maskSecrets 적용 후 기록
+        // (transcript 만 마스킹하면 엔진 stderr 로 토큰·민감경로가 평문 유출될 수 있음).
+        // pipe 대신 data 핸들러로 소비 — pipe 한 stream 미소비 시 backpressure 로 child 가 막힌다.
+        let buf = "";
+        // 개행 없는 초장문 방어 — 상한 초과 시 마스킹해 flush(메모리 무한 증가 방지).
+        const MAX_BUF = 1 << 20; // 1MB
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            buf += chunk;
+            let nl;
+            while ((nl = buf.indexOf("\n")) !== -1) {
+                const line = buf.slice(0, nl);
+                buf = buf.slice(nl + 1);
+                ws.write(maskSecrets(line) + "\n");
+            }
+            if (buf.length > MAX_BUF) {
+                ws.write(maskSecrets(buf));
+                buf = "";
+            }
+        });
+        // stderr EOF('end') 에서 잔여 부분 라인 flush 후 스트림 정리 — 'exit' 는 stderr 버퍼 배출을
+        // 보장하지 않아 write-after-end·꼬리 라인 마스킹 누락을 유발할 수 있다(EOF 는 데이터 완결 보장).
+        child.stderr.on("end", () => {
+            if (buf.length > 0)
+                ws.write(maskSecrets(buf));
+            ws.end();
+        });
+    }
+    return child;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/backend/acp/spawn.js.map

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

package/dist/cli/adde.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/adde.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { run } from "./run.js";
+void Promise.resolve(run(process.argv.slice(2)))
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    // 최후 방어선 — dispatch 에서 예기치 못한 예외가 전파되면 스택트레이스 대신 한 줄로 알리고
+    // 비정상 종료한다(unhandled rejection 으로 인한 프로세스 강제 종료 방지).
+    process.stderr.write(`adde: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=adde.js.map

package/dist/cli/adde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adde.js","sourceRoot":"","sources":["../../src/cli/adde.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7C,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,0DAA0D;IAC1D,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/alias.d.ts

@@ -0,0 +1,45 @@
+/** 설치 후보로 추천하는 짧은 별칭(순서 = 표시 순서). */
+export declare const RECOMMENDED_ALIASES: readonly ["ad", "add"];
+/** 별칭 설치에 필요한 주입 의존성(테스트 가능하게 분리). */
+export interface AliasDeps {
+    /** 별칭 심링크를 놓을 디렉터리(= adde 실행 파일이 있는 디렉터리). */
+    binDir: string;
+    /** 별칭이 가리킬 대상(adde 실행 파일 경로). */
+    addeTarget: string;
+    /** PATH 에 해당 이름의 실행 명령이 이미 존재하는지. */
+    commandExists: (name: string) => Promise<boolean>;
+}
+export type AliasSkipReason = "exists" | "occupied" | "error";
+export interface AliasSetupResult {
+    /** 새로 만든 별칭. */
+    created: string[];
+    /** 이미 adde 를 가리키고 있어 그대로 둔 별칭. */
+    alreadyLinked: string[];
+    /**
+     * 건너뛴 별칭 — exists(PATH 에 동명 명령 존재) / occupied(자리 점유) /
+     * error(심링크 생성 실패: EACCES 루트소유 bin·EEXIST 비심링크 파일 등). detail 은 실패 사유.
+     */
+    skipped: {
+        name: string;
+        reason: AliasSkipReason;
+        detail?: string;
+    }[];
+}
+/**
+ * PATH 를 스캔해 실행 가능한 파일 경로를 찾는다(첫 히트). 없으면 null.
+ * `command -v` 셸 빌트인 대신 직접 스캔 — 자식 셸 스폰 없이 결정적.
+ */
+export declare function findExecutableInPath(name: string, env?: NodeJS.ProcessEnv): Promise<string | null>;
+/**
+ * 별칭들을 설치한다. 각 이름에 대해:
+ * - 이미 adde 를 가리키는 우리 심링크면 alreadyLinked(멱등).
+ * - PATH 에 동명 명령이 있으면 skipped(exists) — 사용자 요구대로 실패 출력.
+ * - 자리에 우리 것이 아닌 무언가가 있으면 skipped(occupied).
+ * - 그 외엔 심링크 생성 → created.
+ */
+export declare function setupAliases(names: readonly string[], deps: AliasDeps): Promise<AliasSetupResult>;
+/**
+ * 실 환경 의존성 해석 — PATH 에서 `adde` 실행 파일을 찾아 그 디렉터리에 별칭을 놓는다.
+ * 전역 설치가 아니면(개발 tsx 등) adde 가 PATH 에 없어 null — 호출부가 안내 후 스킵.
+ */
+export declare function resolveAliasDeps(): Promise<AliasDeps | null>;

package/dist/cli/alias.js

@@ -0,0 +1,94 @@
+/**
+ * 짧은 별칭(`ad`·`add`) 설치 — 전역 설치된 `adde` 실행 파일 옆에 심볼릭 링크를 만든다.
+ * npm 은 `npm i -g` 도중 대화형 프롬프트를 띄울 수 없으므로 별칭을 bin 에 굽지 않고,
+ * 온보딩(`adde init`)·`adde alias` 에서 사용자가 옵트인으로 설치한다.
+ * PATH 에 동명 명령이 이미 있으면(우리 것이 아닌) 그 별칭은 실패로 건너뛴다(사용자 요구).
+ */
+import { symlink, readlink, stat } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+/** 설치 후보로 추천하는 짧은 별칭(순서 = 표시 순서). */
+export const RECOMMENDED_ALIASES = ["ad", "add"];
+/** 심링크면 대상 경로, 아니면(부재·일반 파일) null. */
+async function readlinkSafe(p) {
+    try {
+        return await readlink(p);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * PATH 를 스캔해 실행 가능한 파일 경로를 찾는다(첫 히트). 없으면 null.
+ * `command -v` 셸 빌트인 대신 직접 스캔 — 자식 셸 스폰 없이 결정적.
+ */
+export async function findExecutableInPath(name, env = process.env) {
+    const dirs = (env["PATH"] ?? "").split(":").filter((d) => d.length > 0);
+    for (const dir of dirs) {
+        const candidate = join(dir, name);
+        try {
+            const st = await stat(candidate);
+            if (st.isFile() && (st.mode & 0o111) !== 0)
+                return candidate;
+        }
+        catch {
+            // 이 디렉터리엔 없음 — 계속.
+        }
+    }
+    return null;
+}
+/**
+ * 별칭들을 설치한다. 각 이름에 대해:
+ * - 이미 adde 를 가리키는 우리 심링크면 alreadyLinked(멱등).
+ * - PATH 에 동명 명령이 있으면 skipped(exists) — 사용자 요구대로 실패 출력.
+ * - 자리에 우리 것이 아닌 무언가가 있으면 skipped(occupied).
+ * - 그 외엔 심링크 생성 → created.
+ */
+export async function setupAliases(names, deps) {
+    const result = { created: [], alreadyLinked: [], skipped: [] };
+    const target = resolve(deps.addeTarget);
+    for (const name of names) {
+        const linkPath = join(deps.binDir, name);
+        const existing = await readlinkSafe(linkPath);
+        if (existing !== null && resolve(dirname(linkPath), existing) === target) {
+            result.alreadyLinked.push(name);
+            continue;
+        }
+        if (await deps.commandExists(name)) {
+            result.skipped.push({ name, reason: "exists" });
+            continue;
+        }
+        if (existing !== null) {
+            result.skipped.push({ name, reason: "occupied" });
+            continue;
+        }
+        try {
+            await symlink(target, linkPath);
+            result.created.push(name);
+        }
+        catch (err) {
+            // 심링크 실패(EACCES 루트소유 bin·EEXIST 비심링크 파일 등)는 이 별칭만 건너뛴다 —
+            // 옵트인 편의 단계가 alias/init 전체 흐름을 중단시키지 않도록 흡수해 사유로 보고한다.
+            result.skipped.push({
+                name,
+                reason: "error",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return result;
+}
+/**
+ * 실 환경 의존성 해석 — PATH 에서 `adde` 실행 파일을 찾아 그 디렉터리에 별칭을 놓는다.
+ * 전역 설치가 아니면(개발 tsx 등) adde 가 PATH 에 없어 null — 호출부가 안내 후 스킵.
+ */
+export async function resolveAliasDeps() {
+    const addePath = await findExecutableInPath("adde");
+    if (!addePath)
+        return null;
+    return {
+        binDir: dirname(addePath),
+        addeTarget: addePath,
+        commandExists: (n) => findExecutableInPath(n).then((p) => p !== null),
+    };
+}
+//# sourceMappingURL=alias.js.map

package/dist/cli/alias.js.map

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

package/dist/cli/completion.d.ts

@@ -0,0 +1,4 @@
+export declare const SUPPORTED_SHELLS: readonly ["bash", "zsh"];
+export type CompletionShell = (typeof SUPPORTED_SHELLS)[number];
+/** 지정 셸의 자동완성 스크립트 텍스트. 미지원 셸은 null. */
+export declare function completionScript(shell: string): string | null;

package/dist/cli/completion.js

@@ -0,0 +1,209 @@
+/**
+ * 셸 자동완성 스크립트 생성 — `adde completion <bash|zsh>`.
+ * COMMAND_SPECS(SSOT)에서 명령·플래그·위치인자 종류를 파생하므로, 스펙에 추가하면
+ * 자동완성이 함께 갱신된다. bash·zsh(맥 기본) 지원. adde + 짧은 별칭(ad·add) 등록.
+ *
+ * 동적 완성(proj/lane 이름)은 node 스폰 없이 셸에서 설정 base(`${ADDE_HOME:-~/.config/adde}`)를
+ * 직접 스캔한다(즉응성). enum 플래그 값·디렉터리 플래그·zsh 명령 설명도 스펙에서 생성.
+ */
+import { visibleCommands, LANE_ADD_FLAGS, LANE_SUBS, FLAG_VALUES, DIR_FLAGS, GLOBAL_FLAGS, } from "./spec.js";
+import { RECOMMENDED_ALIASES } from "./alias.js";
+export const SUPPORTED_SHELLS = ["bash", "zsh"];
+/** adde + 짧은 별칭을 완성 대상으로 등록(공백 구분, 중복 제거). */
+const COMPLETION_TARGETS = [...new Set(["adde", ...RECOMMENDED_ALIASES])].join(" ");
+/** 최상위 명령 중 자동완성에서 특수 처리하는(제네릭 case 제외) 이름. */
+const SPECIAL = new Set(["lane", "completion", "alias"]);
+function commandNames() {
+    return visibleCommands()
+        .map((c) => c.name)
+        .join(" ");
+}
+/** 제네릭(위치인자 proj/lane) 명령 목록 — lane/completion/alias 제외. */
+function genericCommands() {
+    return visibleCommands().filter((c) => !SPECIAL.has(c.name));
+}
+// ── bash ────────────────────────────────────────────────────────────────
+/** 값 플래그(enum·디렉터리) 뒤 완성 case (bash). */
+function bashFlagValueCases() {
+    const lines = Object.entries(FLAG_VALUES).map(([flag, vals]) => `    ${flag}) COMPREPLY=( $(compgen -W "${vals.join(" ")}" -- "$cur") ); return;;`);
+    lines.push(`    ${DIR_FLAGS.join("|")}) COMPREPLY=( $(compgen -d -- "$cur") ); return;;`);
+    return lines.join("\n");
+}
+/** 제네릭 명령별 위치인자·플래그 완성 case (bash). */
+function bashCommandCases() {
+    return genericCommands()
+        .map((c) => {
+        const flags = c.flags.join(" ");
+        const withFlags = (base) => (flags ? `${base} ${flags}` : base);
+        const pos = c.positional ?? [];
+        if (pos[0] === "proj" && pos[1] === "lane") {
+            const tail = flags
+                ? `\n      COMPREPLY=( $(compgen -W "${flags}" -- "$cur") ); return;;`
+                : `\n      ;;`;
+            return `    ${c.name})
+      if [ "$cword" -eq 2 ]; then COMPREPLY=( $(compgen -W "$(_adde_projects)" -- "$cur") ); return; fi
+      if [ "$cword" -eq 3 ]; then COMPREPLY=( $(compgen -W "${withFlags('$(_adde_lanes "${COMP_WORDS[2]}")')}" -- "$cur") ); return; fi${tail}`;
+        }
+        if (pos[0] === "proj") {
+            const tail = flags
+                ? `\n      COMPREPLY=( $(compgen -W "${flags}" -- "$cur") ); return;;`
+                : `\n      ;;`;
+            return `    ${c.name})
+      if [ "$cword" -eq 2 ]; then COMPREPLY=( $(compgen -W "${withFlags("$(_adde_projects)")}" -- "$cur") ); return; fi${tail}`;
+        }
+        return null;
+    })
+        .filter((s) => s !== null)
+        .join("\n");
+}
+function bashScript() {
+    const commands = commandNames();
+    const globals = GLOBAL_FLAGS.join(" ");
+    const laneSubs = LANE_SUBS.join(" ");
+    const laneAddFlags = LANE_ADD_FLAGS.join(" ");
+    const aliasSuggest = RECOMMENDED_ALIASES.join(" ");
+    return `# adde bash completion — generated by \`adde completion bash\`
+# 설치: adde completion bash > /usr/local/etc/bash_completion.d/adde  (또는 ~/.bashrc 에서 source)
+# proj/lane 동적 완성은 \${ADDE_HOME:-~/.config/adde} 를 스캔한다.
+_adde_projects() {
+  local base="\${ADDE_HOME:-$HOME/.config/adde}" d
+  [ -d "$base" ] || return 0
+  for d in "$base"/*/; do [ -d "\${d}lanes.d" ] && basename "$d"; done 2>/dev/null
+}
+_adde_lanes() {
+  local base="\${ADDE_HOME:-$HOME/.config/adde}" f
+  [ -n "$1" ] || return 0
+  for f in "$base/$1/lanes.d"/*.conf; do [ -e "$f" ] && basename "$f" .conf; done 2>/dev/null
+}
+_adde() {
+  local cur prev cword
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  cword=\${COMP_CWORD}
+  case "$prev" in
+${bashFlagValueCases()}
+  esac
+  local commands="${commands}"
+  local cmd="\${COMP_WORDS[1]}"
+  if [ "$cword" -eq 1 ]; then
+    COMPREPLY=( $(compgen -W "\${commands} ${globals}" -- "$cur") )
+    return
+  fi
+  case "$cmd" in
+    lane)
+      if [ "$cword" -eq 2 ]; then COMPREPLY=( $(compgen -W "${laneSubs}" -- "$cur") ); return; fi
+      local sub="\${COMP_WORDS[2]}"
+      case "$sub" in
+        add)
+          if [ "$cword" -eq 3 ]; then COMPREPLY=( $(compgen -W "$(_adde_projects)" -- "$cur") ); return; fi
+          if [ "$cword" -ge 5 ] || [ "\${cur:0:1}" = "-" ]; then COMPREPLY=( $(compgen -W "${laneAddFlags}" -- "$cur") ); return; fi
+          ;;
+        ls)
+          if [ "$cword" -eq 3 ]; then COMPREPLY=( $(compgen -W "$(_adde_projects)" -- "$cur") ); return; fi ;;
+        show|rm)
+          if [ "$cword" -eq 3 ]; then COMPREPLY=( $(compgen -W "$(_adde_projects)" -- "$cur") ); return; fi
+          if [ "$cword" -eq 4 ]; then COMPREPLY=( $(compgen -W "$(_adde_lanes "\${COMP_WORDS[3]}")" -- "$cur") ); return; fi ;;
+      esac
+      return;;
+    completion) COMPREPLY=( $(compgen -W "${SUPPORTED_SHELLS.join(" ")}" -- "$cur") ); return;;
+    alias) COMPREPLY=( $(compgen -W "${aliasSuggest}" -- "$cur") ); return;;
+${bashCommandCases()}
+  esac
+}
+complete -F _adde ${COMPLETION_TARGETS}
+`;
+}
+// ── zsh ─────────────────────────────────────────────────────────────────
+/** 값 플래그(enum·디렉터리) 뒤 완성 case (zsh). */
+function zshFlagValueCases() {
+    const lines = Object.entries(FLAG_VALUES).map(([flag, vals]) => `    ${flag}) compadd ${vals.join(" ")}; return;;`);
+    lines.push(`    ${DIR_FLAGS.join("|")}) _files -/; return;;`);
+    return lines.join("\n");
+}
+/** 제네릭 명령별 위치인자·플래그 완성 case (zsh). */
+function zshCommandCases() {
+    return genericCommands()
+        .map((c) => {
+        const flagsVals = c.flags.length > 0 ? `; _values 'option' ${c.flags.join(" ")}` : "";
+        const pos = c.positional ?? [];
+        if (pos[0] === "proj" && pos[1] === "lane") {
+            return `    ${c.name})
+      if (( CURRENT == 3 )); then _adde_projects; return; fi
+      if (( CURRENT == 4 )); then _adde_lanes "\${words[3]}"${flagsVals}; return; fi${flagsVals ? `\n      _values 'option' ${c.flags.join(" ")} ;;` : "\n      ;;"}`;
+        }
+        if (pos[0] === "proj") {
+            return `    ${c.name})
+      if (( CURRENT == 3 )); then _adde_projects${flagsVals}; return; fi${flagsVals ? `\n      _values 'option' ${c.flags.join(" ")} ;;` : "\n      ;;"}`;
+        }
+        return null;
+    })
+        .filter((s) => s !== null)
+        .join("\n");
+}
+function zshScript() {
+    const commandDescribe = visibleCommands()
+        .map((c) => `'${c.name}:${c.desc ?? c.name}'`)
+        .join(" ");
+    const laneSubs = LANE_SUBS.join(" ");
+    const laneAddFlags = LANE_ADD_FLAGS.join(" ");
+    const aliasSuggest = RECOMMENDED_ALIASES.join(" ");
+    const targets = ["adde", ...RECOMMENDED_ALIASES].join(" ");
+    return `#compdef ${targets}
+# adde zsh completion — generated by \`adde completion zsh\`
+# 설치: adde completion zsh > "\${fpath[1]}/_adde"  (또는 compinit 후 이 스크립트를 source)
+# proj/lane 동적 완성은 \${ADDE_HOME:-~/.config/adde} 를 스캔한다.
+_adde_projects() {
+  local base="\${ADDE_HOME:-$HOME/.config/adde}" d
+  local -a p
+  for d in "$base"/*/lanes.d(/N); do p+=("\${\${d:h}:t}"); done
+  compadd -- $p
+}
+_adde_lanes() {
+  local base="\${ADDE_HOME:-$HOME/.config/adde}" f
+  local -a l
+  [ -n "$1" ] || return 0
+  for f in "$base/$1/lanes.d"/*.conf(N); do l+=("\${\${f:t}:r}"); done
+  compadd -- $l
+}
+_adde() {
+  local -a commands
+  commands=(${commandDescribe})
+  case "\${words[CURRENT-1]}" in
+${zshFlagValueCases()}
+  esac
+  if (( CURRENT == 2 )); then
+    _describe 'adde command' commands
+    return
+  fi
+  case "\${words[2]}" in
+    lane)
+      if (( CURRENT == 3 )); then _values 'lane subcommand' ${laneSubs}; return; fi
+      case "\${words[3]}" in
+        add)
+          if (( CURRENT == 4 )); then _adde_projects; return; fi
+          if (( CURRENT == 5 )) && [[ "\${words[5]}" != -* ]]; then return; fi
+          _values 'option' ${laneAddFlags} ;;
+        ls)
+          if (( CURRENT == 4 )); then _adde_projects; return; fi ;;
+        show|rm)
+          if (( CURRENT == 4 )); then _adde_projects; return; fi
+          if (( CURRENT == 5 )); then _adde_lanes "\${words[4]}"; return; fi ;;
+      esac
+      ;;
+    completion) _values 'shell' ${SUPPORTED_SHELLS.join(" ")} ;;
+    alias) compadd ${aliasSuggest} ;;
+${zshCommandCases()}
+  esac
+}
+compdef _adde ${targets}
+`;
+}
+/** 지정 셸의 자동완성 스크립트 텍스트. 미지원 셸은 null. */
+export function completionScript(shell) {
+    if (shell === "bash")
+        return bashScript();
+    if (shell === "zsh")
+        return zshScript();
+    return null;
+}
+//# sourceMappingURL=completion.js.map