adde-acp 0.1.3

package/dist/shared/paths.js

@@ -0,0 +1,83 @@
+/**
+ * 레인별 경로 동적 구성. 레인 ID 하드코딩 금지 — 전부 파라미터.
+ * 레인 A 가 레인 B 의 경로에 접근하지 않도록 파라미터 기반 격리.
+ */
+import { join, relative, isAbsolute } from "node:path";
+import { homedir } from "node:os";
+/** 기본 base 경로. 테스트 환경 override 용으로 분리 주입 가능. */
+function defaultBase() {
+    const override = process.env["ADDE_HOME"];
+    if (override)
+        return override;
+    return join(homedir(), ".config", "adde");
+}
+/**
+ * 선행 `~`/`~/` 를 홈 디렉터리로 확장. (Node 는 셸과 달리 ~ 를 자동 확장하지 않음)
+ * conf 의 cwd/root 같은 사용자 입력 경로에 적용한다. ~user 형태는 미지원.
+ */
+export function expandTilde(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/"))
+        return join(homedir(), p.slice(2));
+    return p;
+}
+/** proj/lane 식별자 허용 문자셋 — 경로 세그먼트로 안전(`..`·`/`·구분자 차단). lane-config 의 NAME_RE 와 동일 규약. */
+const SAFE_SEGMENT_RE = /^[A-Za-z0-9_-]+$/;
+/**
+ * proj/lane 이 경로 세그먼트로 안전한지 검증 — 위반 시 throw.
+ * lanePaths 가 경로 구성의 SSOT 이므로 여기서 막으면 모든 호출부(진단·수퍼바이저 등)가 일괄 보호된다(디렉터리 탈출·레인 격리 위반 차단).
+ */
+export function assertSafeSegment(kind, value) {
+    if (!SAFE_SEGMENT_RE.test(value)) {
+        throw new Error(`잘못된 ${kind} 이름 "${value}" — 영숫자·_·- 만 허용됩니다(경로 탈출 차단).`);
+    }
+}
+/** proj/lane 세그먼트 안전성 여부(throw 없이). 디렉터리 열거 등에서 비안전 이름을 걸러낼 때 사용. */
+export function isSafeSegment(value) {
+    return SAFE_SEGMENT_RE.test(value);
+}
+// --- 경로 포함/중첩 판정 ------------------------------------------------------
+// markdown 어댑터의 기동 fail-closed 가드와 lane-config 의 생성 시 사전 경고가
+// 반드시 같은 규칙으로 판정해야 하므로(어긋나면 경고 없이 기동만 거부되는 갈림),
+// 판정 로직의 SSOT 를 여기 둔다.
+/** child 가 parent 와 같거나 그 내부인지(대소문자 정규화 없음 — 필요 시 normCasePath 로 감싼다). */
+export function isPathInside(child, parent) {
+    const rel = relative(parent, child);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+/**
+ * 대소문자 정규화 — macOS 기본 FS 는 대소문자 무시라 Shared/shared 가 같은 물리 디렉터리.
+ * darwin 은 소문자 정규화 후 비교한다(대소문자 구분 볼륨에선 과차단이나 fail-closed 방향이라 수용).
+ */
+export function normCasePath(p) {
+    return process.platform === "darwin" ? p.toLowerCase() : p;
+}
+/** 두 경로가 같거나 포함 관계인지(대소문자 정규화 적용). */
+export function pathsOverlap(a, b) {
+    const na = normCasePath(a);
+    const nb = normCasePath(b);
+    return isPathInside(na, nb) || isPathInside(nb, na);
+}
+export function lanePaths(base, proj, lane) {
+    assertSafeSegment("proj", proj);
+    assertSafeSegment("lane", lane);
+    const root = join(base, proj);
+    const stateDir = join(root, "state", lane);
+    return {
+        lanesDir: join(root, "lanes.d"),
+        queueDir: join(root, "queue", lane),
+        processingDir: join(root, "processing", lane),
+        outDir: join(root, "out", lane),
+        stateDir,
+        envFile: join(stateDir, ".env"),
+        sessionIdFile: join(stateDir, "session.id"),
+        sessionsFile: join(stateDir, "sessions.json"),
+        transcriptLog: join(stateDir, "transcript.log"),
+        engineLog: join(stateDir, "engine.log"),
+        runtimeJson: join(stateDir, "runtime.json"),
+        confFile: join(root, "lanes.d", `${lane}.conf`),
+    };
+}
+export { defaultBase };
+//# sourceMappingURL=paths.js.map

package/dist/shared/paths.js.map

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

package/dist/src-adapters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 소스 어댑터 — telegram(long-poll)·markdown(fs watch, 예: Obsidian). discord(Gateway WS)는 보류.
+ */
+export { createTelegramSource } from "./telegram.js";
+export type { TelegramSource, TelegramConfig, GateDecisionCallback } from "./telegram.js";
+export { createMarkdownSource } from "./markdown.js";
+export type { MarkdownConfig } from "./markdown.js";
+export type { Source, Decision, DecisionCallback } from "./source.js";

package/dist/src-adapters/index.js

@@ -0,0 +1,6 @@
+/**
+ * 소스 어댑터 — telegram(long-poll)·markdown(fs watch, 예: Obsidian). discord(Gateway WS)는 보류.
+ */
+export { createTelegramSource } from "./telegram.js";
+export { createMarkdownSource } from "./markdown.js";
+//# sourceMappingURL=index.js.map

package/dist/src-adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/src-adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/src-adapters/markdown.d.ts

@@ -0,0 +1,80 @@
+import type { LanePaths } from "../shared/paths.js";
+import type { LaneConf } from "../shared/conf.js";
+import type { PermRequest } from "../gate/gate.js";
+import type { Source, Decision } from "./source.js";
+import type { NotifyT } from "../shared/notify.js";
+export interface MarkdownConfig {
+    lane: string;
+    proj: string;
+    engine: string;
+    paths: LanePaths;
+    conf: LaneConf;
+    /** 인바운드 enqueue 직후 호출(injector 깨우기). in-process 신호 — watch 불요. */
+    onInbound?: (() => void) | undefined;
+}
+/** 동기 충돌 파일 판별 — 파싱·실행 금지 대상(Obsidian Sync/Syncthing 등). */
+export declare function isConflictFile(filename: string): boolean;
+/** 전송 스탬프 표기 — 로컬 시각 `YYYYMMDD-HHmmss`. */
+export declare function formatStamp(d: Date): string;
+/** ISO 타임스탬프(envelope.ts/sidecar)로부터 스탬프 도출. */
+export declare function stampFromIso(iso: string): string;
+/** out 응답 노트 basename(확장자 제외) — sent 위키링크 텍스트와 동일해야 한다. */
+export declare function outNoteBase(stamp: string, id: string): string;
+/**
+ * 스탬프를 로컬 시각으로 되돌려 ISO 로 복원 — 재개(re-enqueue) 시 envelope.ts 가
+ * sending 라인의 스탬프와 같은 값을 재현해야 sent 위키링크와 노트 파일명이 일치한다.
+ * 형식 불일치(구버전 라인 등)면 null.
+ */
+export declare function isoFromStamp(stamp: string): string | null;
+/** 인박스 액션 — main 이 id 부여·enqueue·종단 마킹을 수행. */
+export interface InboxAction {
+    /** fresh=신규 트리거 · resume=`sending <id>` 재개 · empty=빈 트리거 · control=세션 제어 라벨. */
+    kind: "fresh" | "resume" | "empty" | "control";
+    lineIndex: number;
+    text: string;
+    /** resume 시 기존 id. */
+    id?: string;
+    /** resume 시 sending 라인에 기록된 전송 스탬프(구버전 라인엔 없음). */
+    stamp?: string;
+    /** control 시 제어 종류·인자(resume 의 번호/세션 id). */
+    controlKind?: "clear" | "compact" | "resume" | "sessions";
+    controlArg?: string;
+}
+export interface InboxParse {
+    actions: InboxAction[];
+    lines: string[];
+    trailingNewline: boolean;
+}
+/** send 트리거 라인을 단계별 마커로 재작성하는 헬퍼(2단계 내구 마킹). */
+export declare function sendingLine(id: string, stamp: string): string;
+export declare function sentLine(id: string, stamp: string): string;
+export declare function emptyLine(): string;
+/**
+ * 인박스 본문을 파싱해 액션 목록을 만든다(파일은 쓰지 않음, id 부여도 main 책임).
+ * - 경계 라인: send 트리거(라벨=send)·`sending <id>`·종단(`sent`/`empty`) 체크박스.
+ * - 그 외 체크박스(사용자 todo 등)는 메시지 본문으로 취급(경계 아님).
+ * - 체크된 send 트리거 직전 세그먼트가 메시지(빈 세그먼트는 empty 액션).
+ * - `sending <id>` 는 크래시 재개 후보(resume) — main 이 hasId 로 존재검사 후 보정.
+ */
+export declare function parseInbox(content: string): InboxParse;
+/** 권한 요청 1건을 approvals 노트 블록 문자열로 렌더(append 용, 말미 개행 포함). */
+export declare function renderApprovalBlock(req: PermRequest, tl?: NotifyT, now?: Date): string;
+export interface ApprovalDecision {
+    reqId: string;
+    decision: Decision;
+}
+export interface ApprovalsParse {
+    decisions: ApprovalDecision[];
+    newContent: string;
+    changed: boolean;
+}
+/**
+ * approvals 노트에서 결정된 권한 블록을 추출하고 종단 재작성한다.
+ * - status=pending 블록에서 allow/deny 중 정확히 하나 체크 → 결정.
+ * - 0개/2개 체크 = 모호 → pending 유지.
+ * - 결정 블록은 marker status 와 헤딩을 종단 상태로 재작성(멱등 가드).
+ */
+export declare function parseApprovals(content: string): ApprovalsParse;
+/** 타임아웃·강제 종단 시 pending 블록을 deny 로 재작성. 변경 없으면 changed=false. */
+export declare function finalizeApprovalDeny(content: string, reqId: string, reason: string): ApprovalsParse;
+export declare function createMarkdownSource(cfg: MarkdownConfig): Source;