elepha 0.1.0

package/dist/discovery/session-projects.js

@@ -0,0 +1,242 @@
+// Metadata-only project discovery for `elepha init`. This deliberately does
+// not use an adapter: adapters assemble turns and therefore read transcript
+// content, which is forbidden before a root has been approved.
+import { lstat, open, readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { MAX_METADATA_SCAN_BYTES, MAX_METADATA_SCAN_LINES, READABILITY_READ_CHUNK_BYTES } from '../config/constants.js';
+import { claudeProjectsRoot, codexSessionsRoot, isRefusedProjectRoot, normalizeForCompare } from '../config/paths.js';
+const MAX_DEPTH = 6;
+const NEWLINE_BYTE = 0x0a;
+function discoveryStores(paths) {
+    return [
+        { root: paths.claudeProjects ?? claudeProjectsRoot(), tool: 'claude-code', matches: isClaudeSession },
+        { root: paths.codexSessions ?? codexSessionsRoot(), tool: 'codex', matches: isCodexSession },
+    ];
+}
+function isClaudeSession(relativePath) {
+    return relativePath.endsWith('.jsonl');
+}
+function isCodexSession(relativePath) {
+    return path.basename(relativePath).startsWith('rollout-') && relativePath.endsWith('.jsonl');
+}
+async function directoryExists(directory) {
+    return (await stat(directory).catch(() => undefined))?.isDirectory() ?? false;
+}
+/**
+ * Reads only enough JSONL metadata to find the session cwd and its timestamp.
+ * The parsed `message`/turn payload, if present on that same line, is never
+ * examined or retained. The reader stops at the first cwd line.
+ */
+export async function readSessionMetadata(filePath) {
+    const handle = await open(filePath, 'r');
+    let fileSize;
+    try {
+        fileSize = (await handle.stat()).size;
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+    let offset = 0;
+    let scannedLines = 0;
+    let pendingChunks = [];
+    let pendingBytes = 0;
+    const metadataFrom = (record) => {
+        let line;
+        try {
+            line = JSON.parse(record.toString('utf8'));
+        }
+        catch {
+            return undefined;
+        }
+        const cwd = typeof line.cwd === 'string' ? line.cwd : typeof line.payload?.cwd === 'string' ? line.payload.cwd : undefined;
+        return cwd ? { cwd: path.resolve(cwd), timestamp: typeof line.timestamp === 'string' ? line.timestamp : '' } : undefined;
+    };
+    try {
+        while (offset < fileSize && offset < MAX_METADATA_SCAN_BYTES && scannedLines < MAX_METADATA_SCAN_LINES) {
+            const buffer = Buffer.alloc(Math.min(READABILITY_READ_CHUNK_BYTES, fileSize - offset, MAX_METADATA_SCAN_BYTES - offset));
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, offset);
+            if (bytesRead === 0) {
+                break;
+            }
+            offset += bytesRead;
+            const data = buffer.subarray(0, bytesRead);
+            let lineStart = 0;
+            for (;;) {
+                const newline = data.indexOf(NEWLINE_BYTE, lineStart);
+                if (newline === -1) {
+                    const tail = data.subarray(lineStart);
+                    if (pendingBytes + tail.length > MAX_METADATA_SCAN_BYTES) {
+                        return undefined;
+                    }
+                    if (tail.length > 0) {
+                        pendingChunks.push(tail);
+                        pendingBytes += tail.length;
+                    }
+                    break;
+                }
+                const lineTail = data.subarray(lineStart, newline);
+                const recordBytes = pendingBytes + lineTail.length;
+                if (recordBytes > MAX_METADATA_SCAN_BYTES) {
+                    return undefined;
+                }
+                const record = pendingChunks.length === 0
+                    ? data.subarray(lineStart, newline)
+                    : Buffer.concat(lineTail.length === 0 ? pendingChunks : [...pendingChunks, lineTail], recordBytes);
+                scannedLines++;
+                const metadata = metadataFrom(record);
+                if (metadata) {
+                    return metadata;
+                }
+                if (scannedLines >= MAX_METADATA_SCAN_LINES) {
+                    return undefined;
+                }
+                pendingChunks = [];
+                pendingBytes = 0;
+                lineStart = newline + 1;
+            }
+        }
+        if (offset >= fileSize && pendingBytes > 0 && scannedLines < MAX_METADATA_SCAN_LINES) {
+            return metadataFrom(Buffer.concat(pendingChunks, pendingBytes));
+        }
+    }
+    finally {
+        await handle.close();
+    }
+    return undefined;
+}
+/**
+ * Resolves a git worktree by metadata only. A `.git` directory or file is a
+ * sufficient root marker; no git subprocess, config, or file contents are
+ * read because the cwd originated in an unapproved transcript.
+ */
+async function gitRootFor(cwd) {
+    let current = path.resolve(cwd);
+    for (;;) {
+        if (await lstat(path.join(current, '.git')).catch(() => undefined)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+function safeTimestamp(value) {
+    return Number.isNaN(new Date(value).getTime()) ? '' : new Date(value).toISOString();
+}
+/** Presence is based on a local transcript store, never on an interactive tool picker. */
+export async function detectSessionTools(paths = {}) {
+    const detected = [];
+    for (const store of discoveryStores(paths)) {
+        if (await directoryExists(store.root)) {
+            detected.push(store.tool);
+        }
+    }
+    return detected;
+}
+function accumulate(candidates, root, tool, timestamp) {
+    const key = normalizeForCompare(root);
+    const current = candidates.get(key);
+    if (current) {
+        current.tools.add(tool);
+        current.sessionCount++;
+        if (timestamp && (!current.earliestSessionAt || timestamp < current.earliestSessionAt)) {
+            current.earliestSessionAt = timestamp;
+        }
+        if (timestamp && (!current.latestSessionAt || timestamp > current.latestSessionAt)) {
+            current.latestSessionAt = timestamp;
+        }
+        return;
+    }
+    candidates.set(key, {
+        root,
+        tools: new Set([tool]),
+        sessionCount: 1,
+        earliestSessionAt: timestamp,
+        latestSessionAt: timestamp,
+    });
+}
+/** Metadata-only, like the rest of this module: checks directory structure and never opens transcript content. */
+export async function discoverFolderRepos(roots, alreadyDiscovered, isRefusedRoot = isRefusedProjectRoot) {
+    const discovered = new Set(alreadyDiscovered.map((project) => normalizeForCompare(project.root)));
+    const seen = new Set();
+    const projects = [];
+    const scan = async (dir, depth) => {
+        if (depth > MAX_DEPTH) {
+            return;
+        }
+        const entries = await readdir(dir, { withFileTypes: true }).catch(() => undefined);
+        if (entries === undefined) {
+            return;
+        }
+        if (entries.some((entry) => entry.name === '.git')) {
+            const key = normalizeForCompare(dir);
+            if (!isRefusedRoot(dir) && !discovered.has(key) && !seen.has(key)) {
+                projects.push({
+                    root: dir,
+                    displayName: path.basename(dir),
+                    tools: [],
+                    sessionCount: 0,
+                    earliestSessionAt: '',
+                    latestSessionAt: '',
+                });
+                seen.add(key);
+            }
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith('.') || entry.name === 'node_modules') {
+                continue;
+            }
+            await scan(path.join(dir, entry.name), depth + 1);
+        }
+    };
+    for (const root of roots) {
+        await scan(root, 0);
+    }
+    return projects;
+}
+/** Scans transcript metadata only; it never calls a turn parser or reads a turn's content. */
+export async function discoverSessionProjects(paths = {}) {
+    const stores = discoveryStores(paths);
+    const detectedTools = await detectSessionTools(paths);
+    const candidates = new Map();
+    for (const store of stores) {
+        if (!(await directoryExists(store.root))) {
+            continue;
+        }
+        const files = await readdir(store.root, { recursive: true }).catch(() => []);
+        for (const relativePath of files.sort()) {
+            if (!store.matches(relativePath)) {
+                continue;
+            }
+            const metadata = await readSessionMetadata(path.join(store.root, relativePath));
+            if (!metadata) {
+                continue;
+            }
+            const gitRoot = await gitRootFor(metadata.cwd);
+            const root = gitRoot ?? metadata.cwd;
+            if ((paths.isRefusedRoot ?? isRefusedProjectRoot)(root)) {
+                continue;
+            }
+            if (!(await directoryExists(root))) {
+                continue;
+            }
+            accumulate(candidates, root, store.tool, safeTimestamp(metadata.timestamp));
+        }
+    }
+    const projects = [...candidates.values()]
+        .map((candidate) => ({
+        root: candidate.root,
+        displayName: path.basename(candidate.root),
+        tools: [...candidate.tools].sort(),
+        sessionCount: candidate.sessionCount,
+        earliestSessionAt: candidate.earliestSessionAt,
+        latestSessionAt: candidate.latestSessionAt,
+    }))
+        .sort((a, b) => a.displayName.localeCompare(b.displayName) || a.root.localeCompare(b.root));
+    return { detectedTools, projects };
+}
+//# sourceMappingURL=session-projects.js.map

package/dist/discovery/session-projects.js.map

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

package/dist/hooks/codex-trust.js

@@ -0,0 +1,80 @@
+import { createHash } from 'node:crypto';
+import { parse } from 'smol-toml';
+function snakeEventName(event) {
+    return event === 'SessionStart' ? 'session_start' : 'user_prompt_submit';
+}
+function sort(value) {
+    if (Array.isArray(value)) {
+        return value.map(sort);
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => [k, sort(v)]));
+    }
+    return value;
+}
+/** Matches Codex's normalized command-hook fingerprint. */
+export function codexTrustHash(handler, event = 'SessionStart') {
+    const timeout = Math.max(1, handler.timeout ?? 600);
+    const command = { type: 'command', command: handler.command, timeout, async: handler.async ?? false };
+    if (handler.statusMessage !== undefined) {
+        command.statusMessage = handler.statusMessage;
+    }
+    if (handler.additionalContextLimit !== undefined && handler.additionalContextLimit !== 2500) {
+        command.additionalContextLimit = handler.additionalContextLimit;
+    }
+    const identity = { event_name: snakeEventName(event), hooks: [command] };
+    if (handler.matcher !== undefined) {
+        identity.matcher = handler.matcher;
+    }
+    return `sha256:${createHash('sha256')
+        .update(JSON.stringify(sort(identity)))
+        .digest('hex')}`;
+}
+export function codexTrustStatus(definitionText, definitionPath, stateText = definitionText, command = 'elepha hook session-start --tool codex', event = 'SessionStart') {
+    let config;
+    try {
+        config = parse(definitionText);
+    }
+    catch {
+        return 'malformed';
+    }
+    let stateConfig;
+    try {
+        stateConfig = parse(stateText);
+    }
+    catch {
+        return 'malformed';
+    }
+    const hooks = config.hooks;
+    const groups = hooks?.[event];
+    if (!Array.isArray(groups)) {
+        return 'not configured';
+    }
+    for (let groupIndex = 0; groupIndex < groups.length; groupIndex++) {
+        const group = groups[groupIndex];
+        const handlers = group.hooks;
+        if (!Array.isArray(handlers)) {
+            continue;
+        }
+        for (let handlerIndex = 0; handlerIndex < handlers.length; handlerIndex++) {
+            const handler = handlers[handlerIndex];
+            if (handler.command !== command) {
+                continue;
+            }
+            const key = `${definitionPath}:${snakeEventName(event)}:${groupIndex}:${handlerIndex}`;
+            const state = stateConfig.hooks?.state?.[key];
+            const hash = codexTrustHash({
+                matcher: typeof group.matcher === 'string' ? group.matcher : undefined,
+                ...handler,
+            }, event);
+            if (state?.enabled === false || (typeof state?.trusted_hash === 'string' && state.trusted_hash !== hash)) {
+                return 'hash invalidated';
+            }
+            return typeof state?.trusted_hash === 'string' ? 'active' : 'awaiting approval';
+        }
+    }
+    return 'not configured';
+}
+//# sourceMappingURL=codex-trust.js.map

package/dist/hooks/codex-trust.js.map

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

package/dist/hooks/common.js

@@ -0,0 +1,81 @@
+// Shared fail-open hook boundary helpers. They preserve each hook's payload
+// contract while sharing stdin handling and consent resolution: under
+// raw ambiguity it may select the sole consented project, but never an
+// unconsented project and never one of multiple consented candidates.
+import { realpathSync } from 'node:fs';
+import { HOOK_PAYLOAD_MAX_CHARS } from '../config/constants.js';
+import { ConsentStore } from '../storage/consent-store.js';
+import { ProjectResolver } from '../storage/project-resolver.js';
+export function parsePayload(raw, tool, event) {
+    if (raw.length > HOOK_PAYLOAD_MAX_CHARS) {
+        return undefined;
+    }
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    const payload = value;
+    if (typeof payload.session_id !== 'string' ||
+        payload.session_id.length === 0 ||
+        typeof payload.cwd !== 'string' ||
+        payload.cwd.length === 0 ||
+        (payload.hook_event_name !== 'SessionStart' && payload.hook_event_name !== 'UserPromptSubmit') ||
+        (event !== undefined && payload.hook_event_name !== event)) {
+        return undefined;
+    }
+    // Codex explicitly allows a null transcript path. Neither tool's path is
+    // used beyond validation; it cannot become a reader or subprocess input.
+    if (payload.transcript_path !== undefined && payload.transcript_path !== null && typeof payload.transcript_path !== 'string') {
+        return undefined;
+    }
+    if (tool === 'codex' &&
+        (typeof payload.model !== 'string' ||
+            !['default', 'acceptEdits', 'plan', 'dontAsk', 'bypassPermissions'].includes(payload.permission_mode))) {
+        return undefined;
+    }
+    const common = {
+        session_id: payload.session_id,
+        cwd: payload.cwd,
+        model: payload.model,
+        permission_mode: payload.permission_mode,
+        transcript_path: payload.transcript_path,
+    };
+    if (payload.hook_event_name === 'SessionStart') {
+        if (!['startup', 'clear', 'resume', 'compact'].includes(payload.source)) {
+            return undefined;
+        }
+        return { ...common, hook_event_name: 'SessionStart', source: payload.source };
+    }
+    if (typeof payload.prompt !== 'string') {
+        return undefined;
+    }
+    return { ...common, hook_event_name: 'UserPromptSubmit', prompt: payload.prompt };
+}
+export function consentedProject(db, cwd) {
+    let canonical;
+    try {
+        canonical = realpathSync(cwd);
+    }
+    catch {
+        return undefined;
+    }
+    const resolved = new ProjectResolver(db).resolveConsented(canonical, new ConsentStore(db));
+    return 'project' in resolved && resolved.project !== null ? resolved.project : undefined;
+}
+export async function readStdin() {
+    let input = '';
+    for await (const chunk of process.stdin) {
+        input += String(chunk);
+        if (input.length > HOOK_PAYLOAD_MAX_CHARS) {
+            break;
+        }
+    }
+    return input;
+}
+//# sourceMappingURL=common.js.map

package/dist/hooks/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/hooks/common.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sEAAsE;AACtE,uEAAuE;AACvE,sEAAsE;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAmB,MAAM,gCAAgC,CAAC;AA6BlF,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,IAAc,EAAE,KAAsC;IAC5F,IAAI,GAAG,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACD,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,OAAO,GAAG,KAAgC,CAAC;IACjD,IACI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;QACtC,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAC/B,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;QAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,OAAO,CAAC,eAAe,KAAK,cAAc,IAAI,OAAO,CAAC,eAAe,KAAK,kBAAkB,CAAC;QAC9F,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,EAC5D,CAAC;QACC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC3H,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IACI,IAAI,KAAK,OAAO;QAChB,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAC9B,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAyB,CAAC,CAAC,EACtH,CAAC;QACC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAsB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAA2B;QAC1C,eAAe,EAAE,OAAO,CAAC,eAAuD;QAChF,eAAe,EAAE,OAAO,CAAC,eAA4C;KACxE,CAAC;IACF,IAAI,OAAO,CAAC,eAAe,KAAK,cAAc,EAAE,CAAC;QAC7C,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAgB,CAAC,EAAE,CAAC;YAChF,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,MAAoB,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAqB,EAAE,GAAW;IAC/D,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACD,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3F,OAAO,SAAS,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC3B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,KAAK,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;YACxC,MAAM;QACV,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/hooks/hook-log.js

@@ -0,0 +1,38 @@
+import { appendFileSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { HOOK_LOG_LINE_MAX_CHARS, HOOK_LOG_MAX_BYTES, PRIVATE_FILE_MODE } from '../config/constants.js';
+import { hookLogPath } from '../config/paths.js';
+const DEFAULT_DEPENDENCIES = {
+    replaceFile: (file, content) => writeFileSync(file, content, { mode: PRIVATE_FILE_MODE }),
+};
+function trimHookLog(file, dependencies) {
+    if (statSync(file).size <= HOOK_LOG_MAX_BYTES) {
+        return;
+    }
+    const content = readFileSync(file);
+    const start = content.length - HOOK_LOG_MAX_BYTES;
+    let retained = content.subarray(start);
+    if (content[start - 1] !== 0x0a) {
+        const firstCompleteLine = retained.indexOf(0x0a);
+        if (firstCompleteLine >= 0 && firstCompleteLine < retained.length - 1) {
+            retained = retained.subarray(firstCompleteLine + 1);
+        }
+    }
+    dependencies.replaceFile(file, retained);
+}
+/** Best-effort hook diagnostics must never affect hook delivery. */
+export function appendHookLog(message, dependencyOverrides = {}) {
+    try {
+        const dependencies = { ...DEFAULT_DEPENDENCIES, ...dependencyOverrides };
+        const file = hookLogPath();
+        mkdirSync(path.dirname(file), { recursive: true });
+        appendFileSync(file, `${new Date().toISOString()} ${message.replace(/[\r\n]+/g, ' ').slice(0, HOOK_LOG_LINE_MAX_CHARS)}\n`, {
+            mode: PRIVATE_FILE_MODE,
+        });
+        trimHookLog(file, dependencies);
+    }
+    catch {
+        // A memory aid never turns a tool startup into a failed session.
+    }
+}
+//# sourceMappingURL=hook-log.js.map

package/dist/hooks/hook-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-log.js","sourceRoot":"","sources":["../../src/hooks/hook-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,MAAM,oBAAoB,GAAwB;IAC9C,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC5F,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY,EAAE,YAAiC;IAChE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC5C,OAAO;IACX,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,kBAAkB,CAAC;IAClD,IAAI,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,iBAAiB,IAAI,CAAC,IAAI,iBAAiB,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;IACD,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,mBAAmB,GAAiC,EAAE;IACjG,IAAI,CAAC;QACD,MAAM,YAAY,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,mBAAmB,EAAE,CAAC;QACzE,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,IAAI,EAAE;YACxH,IAAI,EAAE,iBAAiB;SAC1B,CAAC,CAAC;QACH,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACL,iEAAiE;IACrE,CAAC;AACL,CAAC"}