tailii-host 0.1.0

package/dist/codexSessionStore.js

@@ -0,0 +1,274 @@
+// codexSessionStore.ts
+// tailii (TS host) — codex（OpenAI Codex CLI）のマシン内会話一覧の導出（agent-tag / codex-sessions）
+//
+// claude の ClaudeSessionStore に対応する codex 版。`ClaudeSessionStore` が
+// `~/.claude/projects/**.jsonl` を列挙するのに対し、codex は 2 ソースを突合する:
+//   1. `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` の先頭 `session_meta` 行 → { id, cwd, timestamp }
+//   2. `~/.codex/session_index.jsonl` の各行 → { id, thread_name(=タイトル), updated_at }
+// session UUID(id) をキーに結合し、`ClaudeSessionInfo`（agent:"codex"）へ落として updatedAt 降順で返す。
+//
+// タイトルは session_index の thread_name を優先。無ければ rollout 先頭付近の最初の実ユーザー
+// メッセージ（event_msg/user_message の message）から導出する（codex アプリのスレッドタイトルと
+// 同じ源。session_index は生成が遅延/欠落することがあり、id 先頭 8 字だとアプリと食い違うため）。
+// どちらも取れなければ id 先頭 8 字へフォールバックする。cwd は rollout 側にのみ在る。
+// 更新時刻は session_index の updated_at（無ければ rollout ファイル mtime）を Unix 秒で用いる。
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { isInsideBase } from "./paths.js";
+/** session_meta 先頭行を読む最大バイト数（先頭 1 行のみ使用。base_instructions を含み得るため広め）。 */
+const META_READ_LIMIT_BYTES = 512 * 1024;
+/** タイトルの最大長（claude と揃える）。 */
+const TITLE_MAX_LENGTH = 60;
+/** 走査する rollout の上限（mtime 新しい順）。大量セッション時の I/O 保護。 */
+const DEFAULT_MAX_SESSIONS = 200;
+/** 既定の codex ホーム（`~/.codex`）。 */
+export function defaultCodexHome() {
+    return path.join(os.homedir(), ".codex");
+}
+/** codex のマシン内会話一覧を導出する値型サービス（agent-tag）。 */
+export class CodexSessionStore {
+    sessionsRoot;
+    indexPath;
+    maxSessions;
+    /**
+     * @param home codex ホーム（既定 `~/.codex`）。テストは一時 dir を注入する。
+     * @param maxSessions 走査上限（既定 200、mtime 新しい順）。
+     */
+    constructor(home, maxSessions = DEFAULT_MAX_SESSIONS) {
+        const base = home ?? defaultCodexHome();
+        this.sessionsRoot = path.join(base, "sessions");
+        this.indexPath = path.join(base, "session_index.jsonl");
+        this.maxSessions = maxSessions;
+    }
+    /**
+     * codex 会話一覧を updatedAt 降順で返す（同値は sessionId 昇順で安定化）。
+     * `baseDir` 指定時は cwd が baseDir 自身/配下の会話のみに絞る（engine は無指定で呼ぶ）。
+     */
+    list(baseDir) {
+        const index = this.readIndex();
+        const files = this.listRollouts()
+            .sort((a, b) => b.mtimeMs - a.mtimeMs)
+            .slice(0, this.maxSessions);
+        let result = [];
+        const seen = new Set();
+        for (const file of files) {
+            const meta = readSessionMeta(file.path);
+            if (meta === null || meta.cwd === null)
+                continue;
+            const sessionId = meta.id ?? path.basename(file.path);
+            if (seen.has(sessionId))
+                continue;
+            seen.add(sessionId);
+            const idx = meta.id !== null ? index.get(meta.id) : undefined;
+            // thread_name が無ければ最初の実ユーザー発話からタイトルを作る（codex アプリ準拠）。
+            // それも取れなければ id 先頭 8 字。index にある会話は毎回のファイル走査を避けて thread_name を使う。
+            const title = idx?.title ?? readFirstUserMessage(file.path) ?? sessionId.slice(0, 8);
+            const updatedAt = idx?.updatedAt ?? (file.mtimeMs > 0 ? Math.floor(file.mtimeMs / 1000) : undefined);
+            const info = {
+                sessionId,
+                cwd: meta.cwd,
+                title,
+                agent: "codex",
+            };
+            if (updatedAt !== undefined)
+                info.updatedAt = updatedAt;
+            result.push(info);
+        }
+        if (baseDir) {
+            result = result.filter((info) => isInsideBase(info.cwd, baseDir));
+        }
+        return result.sort((lhs, rhs) => {
+            const l = lhs.updatedAt ?? Number.MIN_SAFE_INTEGER;
+            const r = rhs.updatedAt ?? Number.MIN_SAFE_INTEGER;
+            if (l !== r)
+                return r - l;
+            return lhs.sessionId < rhs.sessionId ? -1 : lhs.sessionId > rhs.sessionId ? 1 : 0;
+        });
+    }
+    /** `session_index.jsonl` を id → { title, updatedAt(秒) } に読む（無ければ空マップ）。 */
+    readIndex() {
+        const map = new Map();
+        let content;
+        try {
+            content = fs.readFileSync(this.indexPath, "utf8");
+        }
+        catch {
+            return map;
+        }
+        for (const line of content.split("\n")) {
+            if (!line)
+                continue;
+            let obj;
+            try {
+                obj = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (typeof obj !== "object" || obj === null)
+                continue;
+            const rec = obj;
+            const id = rec["id"];
+            if (typeof id !== "string" || id.length === 0)
+                continue;
+            let title = null;
+            if (typeof rec["thread_name"] === "string" && rec["thread_name"].length > 0) {
+                title = normalizeTitle(rec["thread_name"]);
+            }
+            let updatedAt = null;
+            if (typeof rec["updated_at"] === "string") {
+                const ms = Date.parse(rec["updated_at"]);
+                if (!Number.isNaN(ms))
+                    updatedAt = Math.floor(ms / 1000);
+            }
+            map.set(id, { title, updatedAt });
+        }
+        return map;
+    }
+    /** rollout ファイル（`rollout-*.jsonl`）を再帰列挙する（path + mtimeMs）。 */
+    listRollouts() {
+        const out = [];
+        const walk = (dir) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const p = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(p);
+                }
+                else if (entry.isFile() && entry.name.endsWith(".jsonl") && entry.name.startsWith("rollout-")) {
+                    let mtimeMs = 0;
+                    try {
+                        mtimeMs = fs.statSync(p).mtimeMs;
+                    }
+                    catch {
+                        mtimeMs = 0;
+                    }
+                    out.push({ path: p, mtimeMs });
+                }
+            }
+        };
+        walk(this.sessionsRoot);
+        return out;
+    }
+}
+/** rollout の先頭 `session_meta` 行から { id, cwd, timestamp } を読む。読めなければ null。 */
+function readSessionMeta(rolloutPath) {
+    let fd;
+    try {
+        fd = fs.openSync(rolloutPath, "r");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const buf = Buffer.alloc(META_READ_LIMIT_BYTES);
+        const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);
+        if (bytesRead === 0)
+            return null;
+        const slice = buf.subarray(0, bytesRead);
+        const nl = slice.indexOf(0x0a);
+        const firstLine = (nl >= 0 ? slice.subarray(0, nl) : slice).toString("utf8");
+        const parsed = JSON.parse(firstLine);
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            parsed.type !== "session_meta") {
+            return null;
+        }
+        const payload = parsed.payload;
+        if (typeof payload !== "object" || payload === null)
+            return null;
+        const p = payload;
+        const id = typeof p["id"] === "string" && p["id"].length > 0 ? p["id"] : null;
+        const cwd = typeof p["cwd"] === "string" && p["cwd"].length > 0 ? p["cwd"] : null;
+        const timestamp = typeof p["timestamp"] === "string" ? p["timestamp"] : null;
+        return { id, cwd, timestamp };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            fs.closeSync(fd);
+        }
+        catch {
+            // close 失敗は無視。
+        }
+    }
+}
+/**
+ * rollout 先頭付近から最初の `event_msg` / `user_message` の message を読み、タイトル整形して返す。
+ *
+ * codex アプリはスレッドタイトルを最初のユーザー発話から作る。`user_message` イベントは
+ * 環境コンテキスト/AGENTS.md 等の注入を含まない「素のユーザー入力」なので、これをそのまま使える
+ * （`response_item/message/user` は注入込みなので使わない）。先頭 512KB のみ走査し、見つからなければ null。
+ */
+function readFirstUserMessage(rolloutPath) {
+    let fd;
+    try {
+        fd = fs.openSync(rolloutPath, "r");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const buf = Buffer.alloc(META_READ_LIMIT_BYTES);
+        const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);
+        if (bytesRead === 0)
+            return null;
+        const text = buf.subarray(0, bytesRead).toString("utf8");
+        for (const line of text.split("\n")) {
+            // 早期スキップ（大半の行は user_message を含まない）。末尾行は途中で切れ得るが
+            // その場合 JSON.parse が失敗して安全にスキップされる。
+            if (!line || !line.includes("user_message"))
+                continue;
+            let obj;
+            try {
+                obj = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (typeof obj !== "object" || obj === null)
+                continue;
+            if (obj.type !== "event_msg")
+                continue;
+            const payload = obj.payload;
+            if (typeof payload !== "object" || payload === null)
+                continue;
+            const pl = payload;
+            if (pl["type"] !== "user_message")
+                continue;
+            const message = pl["message"];
+            if (typeof message === "string" && message.trim().length > 0) {
+                return normalizeTitle(message);
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            fs.closeSync(fd);
+        }
+        catch {
+            // close 失敗は無視。
+        }
+    }
+}
+/** タイトルを 1 行・先頭 ~60 字へ整形する。 */
+function normalizeTitle(raw) {
+    let text = raw.replaceAll("\n", " ").replaceAll("\r", " ").trim();
+    if (text.length > TITLE_MAX_LENGTH)
+        text = text.slice(0, TITLE_MAX_LENGTH);
+    return text;
+}
+//# sourceMappingURL=codexSessionStore.js.map

package/dist/codexSessionStore.js.map

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

package/dist/codexUsage.d.ts

@@ -0,0 +1,16 @@
+import { type UsageTotals } from "./usageAggregator.js";
+/** token_count から読める使用量 + レート制限（plan 相当）。 */
+export interface CodexUsage extends UsageTotals {
+    /** モデルのコンテキスト窓（token）。未取得は undefined。 */
+    contextWindow?: number;
+    fiveHourUtilization?: number;
+    /** リセット時刻（ISO8601 文字列。usage_response は string で運ぶ）。 */
+    fiveHourResetsAt?: string;
+    sevenDayUtilization?: number;
+    sevenDayResetsAt?: string;
+}
+/**
+ * rollout の末尾から直近の `token_count` を 1 件読み、使用量へ落とす。
+ * 読めない/未出現なら空集計（全 0）を返す。
+ */
+export declare function aggregateCodexUsage(rolloutPath: string): CodexUsage;

package/dist/codexUsage.js

@@ -0,0 +1,144 @@
+// codexUsage.ts
+// tailii (TS host) — codex rollout の使用量集計（agent-tag / codex-input）
+//
+// codex は claude の transcript usage パーサと非互換。rollout の `event_msg/token_count` に
+// 完全な使用量が載る（`info.total_token_usage`, `info.model_context_window`, `rate_limits`）。
+// 直近（末尾）の token_count を 1 件読み、usage_response 相当の集計へ落とす。
+//
+// マップ:
+//   - inputTokens        = total_token_usage.input_tokens
+//   - outputTokens       = total_token_usage.output_tokens
+//   - cacheReadTokens    = total_token_usage.cached_input_tokens
+//   - cacheCreationTokens= 0（codex は区別を持たない）
+//   - turns              = 0（codex は assistant ターン数を token_count に持たない）
+//   - fiveHour*(5h窓=primary) / sevenDay*(週窓=secondary) の used_percent(0–100)・resets_at(Unix秒)
+import * as fs from "node:fs";
+import { emptyUsageTotals } from "./usageAggregator.js";
+/** 末尾から読むバイト数上限（直近の token_count は末尾付近にある）。 */
+const TAIL_READ_BYTES = 512 * 1024;
+/**
+ * rollout の末尾から直近の `token_count` を 1 件読み、使用量へ落とす。
+ * 読めない/未出現なら空集計（全 0）を返す。
+ */
+export function aggregateCodexUsage(rolloutPath) {
+    const line = readLastTokenCountLine(rolloutPath);
+    if (line === null)
+        return { ...emptyUsageTotals() };
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch {
+        return { ...emptyUsageTotals() };
+    }
+    if (typeof obj !== "object" || obj === null)
+        return { ...emptyUsageTotals() };
+    const payload = obj.payload;
+    if (typeof payload !== "object" || payload === null)
+        return { ...emptyUsageTotals() };
+    const p = payload;
+    const result = { ...emptyUsageTotals() };
+    const info = p["info"];
+    if (typeof info === "object" && info !== null) {
+        const i = info;
+        const total = i["total_token_usage"];
+        if (typeof total === "object" && total !== null) {
+            const t = total;
+            result.inputTokens = numberOrZero(t["input_tokens"]);
+            result.outputTokens = numberOrZero(t["output_tokens"]);
+            result.cacheReadTokens = numberOrZero(t["cached_input_tokens"]);
+        }
+        const window = i["model_context_window"];
+        if (typeof window === "number" && window > 0)
+            result.contextWindow = window;
+    }
+    const rate = p["rate_limits"];
+    if (typeof rate === "object" && rate !== null) {
+        const r = rate;
+        applyWindow(r["primary"], (util, resets) => {
+            if (util !== undefined)
+                result.fiveHourUtilization = util;
+            if (resets !== undefined)
+                result.fiveHourResetsAt = resets;
+        });
+        applyWindow(r["secondary"], (util, resets) => {
+            if (util !== undefined)
+                result.sevenDayUtilization = util;
+            if (resets !== undefined)
+                result.sevenDayResetsAt = resets;
+        });
+    }
+    return result;
+}
+/** rate_limits の 1 窓（primary/secondary）から used_percent(丸め) と resets_at(ISO) を取り出す。 */
+function applyWindow(raw, set) {
+    if (typeof raw !== "object" || raw === null)
+        return;
+    const w = raw;
+    const used = w["used_percent"];
+    const resets = w["resets_at"];
+    set(typeof used === "number" ? Math.round(used) : undefined, 
+    // resets_at は Unix 秒。usage_response は ISO 文字列で運ぶため変換する。
+    typeof resets === "number" ? new Date(Math.floor(resets) * 1000).toISOString() : undefined);
+}
+/** ファイル末尾チャンクを読み、最後の `type=="event_msg"` かつ `payload.type=="token_count"` 行を返す。 */
+function readLastTokenCountLine(rolloutPath) {
+    let fd;
+    let size;
+    try {
+        size = fs.statSync(rolloutPath).size;
+        fd = fs.openSync(rolloutPath, "r");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const readLen = Math.min(size, TAIL_READ_BYTES);
+        const start = size - readLen;
+        const buf = Buffer.alloc(readLen);
+        const bytesRead = fs.readSync(fd, buf, 0, readLen, start);
+        const text = buf.subarray(0, bytesRead).toString("utf8");
+        const lines = text.split("\n");
+        for (let idx = lines.length - 1; idx >= 0; idx -= 1) {
+            const line = lines[idx];
+            if (line === undefined || line.length === 0)
+                continue;
+            // 末尾チャンクの先頭行は途中で切れ得るが、その行が token_count でパース可能なら採用、
+            // 不可なら次（より内側）へ進むため安全。
+            if (!line.includes("token_count"))
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                if (typeof obj === "object" &&
+                    obj !== null &&
+                    obj.type === "event_msg") {
+                    const payload = obj.payload;
+                    if (typeof payload === "object" &&
+                        payload !== null &&
+                        payload.type === "token_count") {
+                        return line;
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            fs.closeSync(fd);
+        }
+        catch {
+            // close 失敗は無視。
+        }
+    }
+}
+function numberOrZero(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+//# sourceMappingURL=codexUsage.js.map

package/dist/codexUsage.js.map

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

package/dist/deviceTokenStore.d.ts

@@ -0,0 +1,38 @@
+import { type ApnsHost } from "./pushTypes.js";
+/** 保存する device token レコード（device-token.json の中身）。 */
+export interface DeviceTokenRecord {
+    /** 宛先 device token（hex）。 */
+    token: string;
+    /** 登録環境（production / sandbox）。送信ホスト選択に使う。 */
+    environment: ApnsHost;
+    /** bundle id（`apns-topic`）。 */
+    bundleId: string;
+    /** 更新時刻（epoch 秒）。 */
+    updatedAt: number;
+}
+/**
+ * device token の永続化契約（load / save / delete）。
+ * APNs 送信側は load() で宛先を得て、`Unregistered` 受領時に delete() で宛先を除外する
+ * （3.3/3.4/3.5/6.3）。テストは実体を差し替え可能にするため interface 化。
+ */
+export interface DeviceTokenStoring {
+    load(): DeviceTokenRecord | null;
+    save(record: DeviceTokenRecord): void;
+    delete(): void;
+}
+/**
+ * `~/.tailii/apns/device-token.json` へ device token を保存するストア。
+ * ディレクトリは 0700、ファイルは 0600 で保存する（Requirement 6.5）。
+ * テスト容易性のため base を注入できる。
+ */
+export declare class DeviceTokenStore implements DeviceTokenStoring {
+    private readonly base;
+    constructor(base?: string);
+    private get fileURL();
+    /** 保存済み device token を読み込む。未保存・不正 JSON なら `null`（3.5）。 */
+    load(): DeviceTokenRecord | null;
+    /** device token を 0600 で保存する（同一パス上書き＝token 置換, 3.4）。 */
+    save(record: DeviceTokenRecord): void;
+    /** 保存済み device token を削除する（宛先除外, 6.3）。未保存でも成功（冪等）。 */
+    delete(): void;
+}

package/dist/deviceTokenStore.js

@@ -0,0 +1,73 @@
+// deviceTokenStore.ts
+// tailii (TS host) — device token の安全保存
+// Swift 版 DeviceTokenStore.swift の移植。
+//
+// `~/.tailii/apns/device-token.json` に device token を保存 / 読込 / 削除する。
+// token が変化したら上書き（3.4）、`Unregistered` 受領時は delete() で宛先を除外（6.3）。
+// 未保存なら load() は null（送信スキップ判別, 3.5）。ファイルは 0600、ディレクトリは 0700。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { defaultApnsBase, ensureApnsDirectory, isApnsHost } from "./pushTypes.js";
+/**
+ * `~/.tailii/apns/device-token.json` へ device token を保存するストア。
+ * ディレクトリは 0700、ファイルは 0600 で保存する（Requirement 6.5）。
+ * テスト容易性のため base を注入できる。
+ */
+export class DeviceTokenStore {
+    base;
+    constructor(base) {
+        this.base = base ?? defaultApnsBase();
+    }
+    get fileURL() {
+        return path.join(this.base, "device-token.json");
+    }
+    /** 保存済み device token を読み込む。未保存・不正 JSON なら `null`（3.5）。 */
+    load() {
+        let raw;
+        try {
+            raw = JSON.parse(fs.readFileSync(this.fileURL, "utf8"));
+        }
+        catch {
+            return null;
+        }
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+            return null;
+        const obj = raw;
+        if (typeof obj["token"] !== "string" ||
+            !isApnsHost(obj["environment"]) ||
+            typeof obj["bundleId"] !== "string" ||
+            typeof obj["updatedAt"] !== "number") {
+            return null;
+        }
+        return {
+            token: obj["token"],
+            environment: obj["environment"],
+            bundleId: obj["bundleId"],
+            updatedAt: obj["updatedAt"],
+        };
+    }
+    /** device token を 0600 で保存する（同一パス上書き＝token 置換, 3.4）。 */
+    save(record) {
+        ensureApnsDirectory(this.base);
+        // キー順の非決定性を避けるため辞書順で符号化（Swift 版 .sortedKeys と同一）。
+        const payload = JSON.stringify({
+            bundleId: record.bundleId,
+            environment: record.environment,
+            token: record.token,
+            updatedAt: record.updatedAt,
+        });
+        fs.writeFileSync(this.fileURL, payload, { mode: 0o600 });
+        // 既存ファイルは writeFileSync の mode が効かないため明示的に 0600 を保証する。
+        fs.chmodSync(this.fileURL, 0o600);
+    }
+    /** 保存済み device token を削除する（宛先除外, 6.3）。未保存でも成功（冪等）。 */
+    delete() {
+        try {
+            fs.rmSync(this.fileURL);
+        }
+        catch {
+            // 未保存 = 何もしない（冪等）。他の削除失敗も送信停止判断を阻害しない。
+        }
+    }
+}
+//# sourceMappingURL=deviceTokenStore.js.map

package/dist/deviceTokenStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceTokenStore.js","sourceRoot":"","sources":["../src/deviceTokenStore.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,wCAAwC;AACxC,sCAAsC;AACtC,EAAE;AACF,qEAAqE;AACrE,iEAAiE;AACjE,8DAA8D;AAE9D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAiB,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAyBjG;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACV,IAAI,CAAS;IAE9B,YAAY,IAAa;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACnD,CAAC;IAED,0DAA0D;IAC1D,IAAI;QACF,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/E,MAAM,GAAG,GAAG,GAA8B,CAAC;QAC3C,IACE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ;YAChC,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;YACnC,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ,EACpC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC;YAC/B,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;YACzB,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,MAAyB;QAC5B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,kDAAkD;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,uDAAuD;QACvD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,sDAAsD;IACtD,MAAM;QACJ,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/dirLister.d.ts

@@ -0,0 +1,9 @@
+/** `baseDir/<partial の親>` 直下のサブディレクトリ名を prefix 一致で返す（base 外・不正は空）。 */
+export declare function dirList(baseDir: string, partial: string): string[];
+/** `baseDir` 配下限定で `relative` ディレクトリを作成する（base 外・不正・失敗は ok=false）。 */
+export declare function dirCreate(baseDir: string, relative: string): {
+    path: string;
+    ok: boolean;
+};
+/** 絶対パス直下のサブディレクトリ名を非限定で列挙する（隠し dir とファイルは除外、ソート済み）。 */
+export declare function dirChildren(absolutePath: string): string[];