elepha 0.1.0

package/dist/hooks/user-prompt-submit.js

@@ -0,0 +1,248 @@
+// Fail-open UserPromptSubmit hook. Historical turns are rendered exclusively
+// by SessionReader; this hook never reads a transcript itself.
+import { existsSync } from 'node:fs';
+import { ELEPHA_LIST_DEFAULT_LIMIT, ELEPHA_LIST_MAX_LIMIT } from '../config/constants.js';
+import { getSetting } from '../config/settings.js';
+import { terminalHandoff } from '../markers.js';
+import { escapeShellSyntax } from '../security/sanitize.js';
+import { buildInjectionId, wrap } from '../security/sentinel.js';
+import { DISPLAY_VERBATIM_INSTRUCTIONS, HELP, REMEMBER_HERE_UNCONSENTED, REMEMBER_QUERY_REQUIRED, SELECT_HINT, servedContextInstructions, } from '../serving/instructions.js';
+import { lexicalRecall, tokenizeRecallQuery } from '../serving/lexical-recall.js';
+import { endedAt, SessionReader, surfaceLabel, titleOf } from '../serving/session-reader.js';
+import { ConsentStore } from '../storage/consent-store.js';
+import { defaultDbPath, openDb } from '../storage/db.js';
+import { MemoryStore } from '../storage/memory-store.js';
+import { ProjectResolver } from '../storage/project-resolver.js';
+import { relativeTime } from '../util/relative-time.js';
+import { consentedProject, parsePayload, readStdin } from './common.js';
+import { appendHookLog } from './hook-log.js';
+const ACTIONS = {
+    'elepha:update': { kind: 'action', command: 'self-update' },
+};
+function logLine(message) {
+    appendHookLog(message);
+}
+function promptLogLine(tool, payload, outcome) {
+    return `user-prompt-submit ${tool} session_id=${payload?.session_id ?? 'unknown'}: ${outcome}`;
+}
+function contributingSessionsStillConsented(db, reader, sessionIds) {
+    const consentedProjectIds = new Set(new ProjectResolver(db).listConsentedStored(new ConsentStore(db)).flatMap((project) => project.projectIds));
+    return sessionIds.every((sessionId) => {
+        const session = reader.sessionById(sessionId);
+        return session !== undefined && consentedProjectIds.has(session.project_id);
+    });
+}
+export function parseUserPromptCommand(prompt) {
+    const command = prompt.trim();
+    if (command === 'elepha:help') {
+        return { kind: 'help' };
+    }
+    if (command === 'elepha:last') {
+        return { kind: 'last' };
+    }
+    const queryHere = /^elepha:query:here(?:\s+([\s\S]*))?$/.exec(command);
+    if (queryHere) {
+        return { kind: 'query', query: queryHere[1] ?? '', scope: 'here' };
+    }
+    const queryGlobal = /^elepha:query(?:\s+([\s\S]*))?$/.exec(command);
+    if (queryGlobal) {
+        return { kind: 'query', query: queryGlobal[1] ?? '', scope: 'global' };
+    }
+    const select = /^elepha:select:([1-9]\d*)$/.exec(command);
+    if (select?.[1]) {
+        return { kind: 'select', index: Number(select[1]) };
+    }
+    const list = /^elepha:list(?::([1-9]\d*))?(?::(codex|claude))?$/.exec(command);
+    if (list) {
+        const count = list[1] === undefined ? ELEPHA_LIST_DEFAULT_LIMIT : Number(list[1]);
+        if (count >= 1 && count <= ELEPHA_LIST_MAX_LIMIT) {
+            return { kind: 'list', count, tool: list[2] === 'claude' ? 'claude-code' : list[2] };
+        }
+        return undefined;
+    }
+    return ACTIONS[command];
+}
+function envelope(body) {
+    return { continue: true, hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext: body } };
+}
+async function commandBody(command, reader, project, consentedProjects, storedSelectTarget = { hasStoredList: false }, now = Date.now()) {
+    if (!command || command.kind === 'help') {
+        return { body: `${DISPLAY_VERBATIM_INSTRUCTIONS}\n${HELP}` };
+    }
+    if (command.kind === 'action') {
+        return { body: terminalHandoff('self-update') };
+    }
+    if (command.kind === 'list') {
+        const sessions = reader.recentConsentedSessions(consentedProjects);
+        const rows = command.tool === undefined ? sessions : sessions.filter((session) => session.tool === command.tool);
+        if (rows.length === 0) {
+            return { body: 'No sessions found in consented projects.', shownSessionIds: [] };
+        }
+        const shown = rows.slice(0, command.count);
+        return {
+            body: [
+                DISPLAY_VERBATIM_INSTRUCTIONS,
+                `Recent sessions (${shown.length}):`,
+                ...shown.map((session, index) => `${index + 1}. [${relativeTime(endedAt(session), now)} | ${surfaceLabel(session.tool, session.surface)}] · ${titleOf(session)}`),
+                '',
+                SELECT_HINT,
+            ].join('\n'),
+            shownSessionIds: shown.map((session) => session.id),
+        };
+    }
+    const session = command.kind === 'select' && storedSelectTarget.hasStoredList
+        ? storedSelectTarget.session
+        : command.kind === 'last'
+            ? reader.recentConsentedSessions(consentedProjects)[0]
+            : project === undefined
+                ? undefined
+                : reader.sessionsFor(project)[command.index - 1];
+    if (!session) {
+        return { body: 'No session found at that position.' };
+    }
+    const rendered = await reader.render(session);
+    if (!rendered.episode) {
+        return { body: `Unable to render ${titleOf(session)}: ${rendered.reason ?? 'unknown error'}.`, shownSessionIds: [session.id] };
+    }
+    return {
+        body: `${servedContextInstructions(rendered.episode.nonce)}\n\n# ${titleOf(session)}\n\n${rendered.episode.text.trimEnd()}`,
+        shownSessionIds: [session.id],
+    };
+}
+/** Pure orchestration seam used by tests and the thin CLI adapter. */
+export async function runUserPromptSubmit(rawStdin, tool, dependencies = {}) {
+    const log = dependencies.log ?? logLine;
+    const payload = parsePayload(rawStdin, tool, 'UserPromptSubmit');
+    if (!payload) {
+        log(promptLogLine(tool, payload, 'failed reason=invalid_payload'));
+        return { reason: 'invalid_payload' };
+    }
+    const command = parseUserPromptCommand(payload.prompt);
+    if (!command && !payload.prompt.trim().startsWith('elepha:')) {
+        return { reason: 'not_command' };
+    }
+    let db;
+    try {
+        const dbPath = dependencies.dbPath ?? defaultDbPath();
+        if (!existsSync(dbPath)) {
+            log(promptLogLine(tool, payload, 'failed reason=database_unavailable'));
+            return { reason: 'database_unavailable' };
+        }
+        db = openDb(dbPath);
+    }
+    catch {
+        log(promptLogLine(tool, payload, 'failed reason=database_unavailable'));
+        return { reason: 'database_unavailable' };
+    }
+    try {
+        const reader = new SessionReader(db);
+        const store = new MemoryStore(db);
+        const projectResolver = dependencies.projectResolver ?? ((database) => new ProjectResolver(database));
+        const clock = dependencies.now ?? Date.now;
+        let commandOutput;
+        let shownSessionIds;
+        let storeShownSessionIds = false;
+        if (command?.kind === 'query') {
+            const query = tokenizeRecallQuery(command.query);
+            if (!query) {
+                commandOutput = `${DISPLAY_VERBATIM_INSTRUCTIONS}\n${REMEMBER_QUERY_REQUIRED}`;
+            }
+            else {
+                const projects = command.scope === 'global'
+                    ? projectResolver(db).listConsentedStored(new ConsentStore(db))
+                    : [consentedProject(db, payload.cwd)].filter((project) => project !== undefined);
+                if (command.scope === 'here' && projects.length === 0) {
+                    log(promptLogLine(tool, payload, 'served notice=project_unavailable_or_unconsented'));
+                    commandOutput = `${DISPLAY_VERBATIM_INSTRUCTIONS}\n${REMEMBER_HERE_UNCONSENTED}`;
+                }
+                else {
+                    const matchingMode = getSetting('query-matching', process.env, dependencies.configPath).value;
+                    const recall = await lexicalRecall(reader, projects, query, command.scope, Date.now, clock(), matchingMode);
+                    if (!contributingSessionsStillConsented(db, reader, recall.sessionIds)) {
+                        log(promptLogLine(tool, payload, 'discarded reason=project_unavailable_or_unconsented'));
+                        if (command.scope !== 'here') {
+                            return { reason: 'project_unavailable_or_unconsented' };
+                        }
+                        commandOutput = `${DISPLAY_VERBATIM_INSTRUCTIONS}\n${REMEMBER_HERE_UNCONSENTED}`;
+                    }
+                    else {
+                        commandOutput = recall.body;
+                        shownSessionIds = recall.sessionIds;
+                        storeShownSessionIds = true;
+                    }
+                }
+            }
+        }
+        else {
+            const project = consentedProject(db, payload.cwd);
+            let storedSelectTarget = { hasStoredList: false };
+            if (command?.kind === 'select') {
+                const storedSessionIds = store.shownSessionLists.forChat(tool, payload.session_id);
+                if (storedSessionIds !== undefined) {
+                    const sessionId = storedSessionIds[command.index - 1];
+                    const session = sessionId === undefined ? undefined : reader.sessionById(sessionId);
+                    if (session !== undefined) {
+                        const consentedProjects = projectResolver(db).listConsentedStored(store.consent);
+                        if (!consentedProjects.some((candidate) => candidate.projectIds.includes(session.project_id))) {
+                            log(promptLogLine(tool, payload, 'failed reason=project_unavailable_or_unconsented'));
+                            return { reason: 'project_unavailable_or_unconsented' };
+                        }
+                    }
+                    storedSelectTarget = { hasStoredList: true, session };
+                }
+            }
+            const consentedProjects = projectResolver(db).listConsentedStored(store.consent);
+            const commandNow = command?.kind === 'list' ? clock() : undefined;
+            const result = await commandBody(command, reader, project, consentedProjects, storedSelectTarget, commandNow);
+            if (result.shownSessionIds !== undefined && !contributingSessionsStillConsented(db, reader, result.shownSessionIds)) {
+                log(promptLogLine(tool, payload, 'discarded reason=project_unavailable_or_unconsented'));
+                return { reason: 'project_unavailable_or_unconsented' };
+            }
+            commandOutput = result.body;
+            shownSessionIds = result.shownSessionIds;
+            storeShownSessionIds = command?.kind === 'list';
+        }
+        const body = escapeShellSyntax(commandOutput);
+        const injectionId = buildInjectionId();
+        const output = wrap('brief', injectionId, body);
+        const now = clock();
+        const recorded = (dependencies.writeInjection ?? ((memoryStore, input) => memoryStore.recordInjection(input)))(store, {
+            tool,
+            nativeSessionId: payload.session_id,
+            injectedAt: new Date(now).toISOString(),
+            injectionId,
+            body,
+        });
+        if (!recorded) {
+            log(promptLogLine(tool, payload, 'failed reason=injection_record_failed'));
+            return { reason: 'injection_record_failed' };
+        }
+        if (storeShownSessionIds && shownSessionIds !== undefined) {
+            store.shownSessionLists.replace(tool, payload.session_id, shownSessionIds);
+        }
+        log(promptLogLine(tool, payload, command?.kind ?? 'help'));
+        return { output: envelope(output) };
+    }
+    catch {
+        log(promptLogLine(tool, payload, 'failed reason=hook_error'));
+        return { reason: 'hook_error' };
+    }
+    finally {
+        db.close();
+    }
+}
+/** CLI boundary: no diagnostics or partial JSON may reach stdout. */
+export async function runUserPromptSubmitCli(tool) {
+    try {
+        const input = await readStdin();
+        const result = await runUserPromptSubmit(input, tool);
+        if ('output' in result) {
+            process.stdout.write(JSON.stringify(result.output));
+        }
+    }
+    catch {
+        // Hooks are fail-open: stdout must stay empty on every failure path.
+    }
+}
+export { envelope, parsePayload };
+//# sourceMappingURL=user-prompt-submit.js.map

package/dist/hooks/user-prompt-submit.js.map

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

package/dist/install/binary.js

@@ -0,0 +1,72 @@
+import { accessSync, lstatSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+function quotePosix(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function hookCommand(bin, tool, hook = 'session-start') {
+    return `${quotePosix(bin)} hook ${hook} --tool ${tool}`;
+}
+function packageRootFor(target) {
+    let cursor = path.dirname(target);
+    while (true) {
+        if (path.basename(cursor) === 'elepha' && path.basename(path.dirname(cursor)) === 'node_modules') {
+            return cursor;
+        }
+        const parent = path.dirname(cursor);
+        if (parent === cursor) {
+            return undefined;
+        }
+        cursor = parent;
+    }
+}
+/**
+ * Validate an executable without spawning it. This deliberately accepts an npm
+ * shim path while checking its resolved target belongs to the installed package.
+ */
+function resolveCandidate(candidate) {
+    try {
+        lstatSync(candidate);
+        accessSync(candidate, 1);
+        const target = realpathSync(candidate);
+        if (!statSync(target).isFile()) {
+            return undefined;
+        }
+        const packageRoot = packageRootFor(target);
+        if (!packageRoot) {
+            return undefined;
+        }
+        const manifest = JSON.parse(readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+        if (manifest.name !== 'elepha' || !manifest.bin || typeof manifest.bin !== 'object' || Array.isArray(manifest.bin)) {
+            return undefined;
+        }
+        const declared = manifest.bin.elepha;
+        if (typeof declared !== 'string' || realpathSync(path.join(packageRoot, declared)) !== target) {
+            return undefined;
+        }
+        return { bin: path.resolve(candidate), packageRoot };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolveInstalledElephaBin(options = {}) {
+    if ((options.platform ?? process.platform) === 'win32') {
+        throw new Error('elepha install is not supported on win32 yet.');
+    }
+    const pathValue = options.pathValue ?? process.env.PATH ?? '';
+    for (const directory of pathValue.split(path.delimiter).filter(Boolean)) {
+        const resolved = resolveCandidate(path.join(directory, 'elepha'));
+        if (resolved) {
+            return resolved;
+        }
+    }
+    const fallback = options.argvEntrypoint ?? process.argv[1];
+    if (fallback) {
+        const resolved = resolveCandidate(path.resolve(fallback));
+        if (resolved) {
+            return resolved;
+        }
+    }
+    throw new Error('elepha install must be run from an npm-installed elepha binary; no valid elepha npm bin was found.');
+}
+//# sourceMappingURL=binary.js.map

package/dist/install/binary.js.map

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

package/dist/install/config-file.js

@@ -0,0 +1,119 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync, unlinkSync } from 'node:fs';
+import path from 'node:path';
+import { PRIVATE_FILE_MODE } from '../config/constants.js';
+import { elephaHome } from '../config/paths.js';
+import { atomicWrite } from '../util/fs.js';
+function snapshotDirectory() {
+    return path.join(elephaHome(), 'install-snapshots');
+}
+function snapshotPath(file, directory = snapshotDirectory()) {
+    const key = createHash('sha256').update(file).digest('hex');
+    return path.join(directory, `${key}.json`);
+}
+export function hasInstallSnapshot(file, directory) {
+    return existsSync(snapshotPath(file, directory));
+}
+/** Retain the pre-install bytes so a clean install/uninstall cycle is exactly reversible. */
+export function rememberInstallSnapshots(changes, originals, directory) {
+    for (const change of changes) {
+        if (change.kind !== 'write') {
+            continue;
+        }
+        const original = originals.find((item) => item.file === change.file);
+        if (!original) {
+            continue;
+        }
+        const file = snapshotPath(change.file, directory);
+        atomicWrite(file, `${JSON.stringify({ original, installed: change.text })}\n`, PRIVATE_FILE_MODE);
+    }
+}
+export function deleteInstallSnapshots(files, directory) {
+    for (const file of files) {
+        const snapshot = snapshotPath(file, directory);
+        if (existsSync(snapshot)) {
+            unlinkSync(snapshot);
+        }
+    }
+}
+/** Prefer the exact original only if no one changed the managed document since install. */
+export function restoreInstallSnapshot(file, current, directory) {
+    const snapshotFile = snapshotPath(file, directory);
+    if (!existsSync(snapshotFile)) {
+        return undefined;
+    }
+    try {
+        const snapshot = JSON.parse(readFileSync(snapshotFile, 'utf8'));
+        if (snapshot.original.file !== file || snapshot.installed !== current) {
+            return undefined;
+        }
+        return snapshot.original.exists ? { kind: 'text', text: snapshot.original.text } : { kind: 'delete' };
+    }
+    catch {
+        throw new Error(`elepha install snapshot is malformed: ${snapshotFile}`);
+    }
+}
+/** Apply a logical multi-file config change or restore every original on failure. */
+export function applyConfigTransaction(changes) {
+    const changed = changes.filter((change) => change.kind === 'delete'
+        ? existsSync(change.file)
+        : existsSync(change.file)
+            ? readFileSync(change.file, 'utf8') !== change.text
+            : change.text.length > 0);
+    if (changed.length === 0) {
+        return false;
+    }
+    const originals = changed.map((change) => {
+        const exists = existsSync(change.file);
+        return {
+            file: change.file,
+            exists,
+            text: exists ? readFileSync(change.file, 'utf8') : '',
+            mode: exists ? statSync(change.file).mode & 0o777 : undefined,
+        };
+    });
+    try {
+        for (const change of changed) {
+            const original = originals.find((item) => item.file === change.file);
+            if (!original) {
+                // noinspection ExceptionCaughtLocallyJS
+                throw new Error(`missing transaction original for ${change.file}`);
+            }
+            if (change.kind === 'write') {
+                atomicWrite(change.file, change.text, original.mode ?? PRIVATE_FILE_MODE);
+            }
+            else {
+                unlinkSync(change.file);
+            }
+        }
+        for (const change of changed) {
+            if (change.kind !== 'write') {
+                continue;
+            }
+            const reread = readFileSync(change.file, 'utf8');
+            change.validate(reread);
+            if (reread !== change.text) {
+                // noinspection ExceptionCaughtLocallyJS
+                throw new Error(`read-back verification failed for ${change.file}`);
+            }
+        }
+        return { originals };
+    }
+    catch (error) {
+        try {
+            for (const original of originals) {
+                if (original.exists) {
+                    atomicWrite(original.file, original.text, original.mode ?? PRIVATE_FILE_MODE);
+                }
+                else if (existsSync(original.file)) {
+                    unlinkSync(original.file);
+                }
+            }
+        }
+        catch (rollbackError) {
+            throw new Error(`configuration write failed and rollback failed: ${String(rollbackError)}`, { cause: error });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=config-file.js.map

package/dist/install/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../src/install/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAwB5C,SAAS,iBAAiB;IACtB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,mBAAmB,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,SAAS,GAAG,iBAAiB,EAAE;IAC/D,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAAkB;IAC/D,OAAO,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB,CAAC,OAAuB,EAAE,SAA2B,EAAE,SAAkB;IAC7G,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,SAAS;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClD,WAAW,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACtG,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAe,EAAE,SAAkB;IACtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,OAAe,EAAE,SAAkB;IACpF,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAoB,CAAC;QACnF,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;YACpE,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1G,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,yCAAyC,YAAY,EAAE,CAAC,CAAC;IAC7E,CAAC;AACL,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACtC,MAAM,CAAC,IAAI,KAAK,QAAQ;QACpB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,IAAI;YACnD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CACjC,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,SAAS,GAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO;YACH,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM;YACN,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;YACrD,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS;SAChE,CAAC;IACN,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;YACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,wCAAwC;gBACxC,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1B,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,iBAAiB,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACJ,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACL,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1B,SAAS;YACb,CAAC;YACD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;gBACzB,wCAAwC;gBACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACxE,CAAC;QACL,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,CAAC;YACD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBAC/B,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAClB,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,iBAAiB,CAAC,CAAC;gBAClF,CAAC;qBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,aAAa,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClH,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/install/daemon-health.js

@@ -0,0 +1,48 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { DAEMON_HEALTH_CHECK_DEADLINE_MS, DAEMON_HEALTH_CHECK_POLL_MS, DAEMON_OUTPUT_MAX_CHARS, DAEMON_STDERR_TAIL_CHARS, } from '../config/constants.js';
+import { HEARTBEAT_STALE_MS, isPidAlive, readHeartbeat } from '../daemon/heartbeat.js';
+export const defaultDaemonHealthCheckRuntime = {
+    now: () => Date.now(),
+    sleep(milliseconds) {
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, milliseconds);
+    },
+};
+export function boundedDaemonOutput(output) {
+    const sanitized = output.replace(/\p{Cc}/gu, ' ').trim();
+    if (sanitized.length <= DAEMON_OUTPUT_MAX_CHARS) {
+        return sanitized;
+    }
+    return `[${sanitized.length - DAEMON_OUTPUT_MAX_CHARS} older characters omitted] ${sanitized.slice(-DAEMON_OUTPUT_MAX_CHARS)}`;
+}
+export function healthyHeartbeat(heartbeatPath, now) {
+    const heartbeat = readHeartbeat(heartbeatPath);
+    return !!heartbeat && isPidAlive(heartbeat.pid) && now - new Date(heartbeat.updatedAt).getTime() < HEARTBEAT_STALE_MS;
+}
+export function waitForHealthyHeartbeat(isHealthy, runtime) {
+    const deadline = runtime.now() + DAEMON_HEALTH_CHECK_DEADLINE_MS;
+    while (true) {
+        if (isHealthy()) {
+            return true;
+        }
+        const remaining = deadline - runtime.now();
+        if (remaining <= 0) {
+            return false;
+        }
+        runtime.sleep(Math.min(DAEMON_HEALTH_CHECK_POLL_MS, remaining));
+    }
+}
+export function daemonHealthFailure(stderrPath, details = []) {
+    let stderrTail = 'no daemon stderr log';
+    if (existsSync(stderrPath)) {
+        try {
+            const stderr = readFileSync(stderrPath, 'utf8');
+            stderrTail = boundedDaemonOutput(stderr.slice(-DAEMON_STDERR_TAIL_CHARS)) || 'empty daemon stderr log';
+        }
+        catch (error) {
+            stderrTail = `unreadable daemon stderr log: ${boundedDaemonOutput(String(error)) || 'unknown error'}`;
+        }
+    }
+    const detailText = details.length > 0 ? `${details.join('; ')}; ` : '';
+    return new Error(`capture service did not produce a healthy heartbeat within ${DAEMON_HEALTH_CHECK_DEADLINE_MS / 1000}s; ${detailText}daemon stderr log tail: ${stderrTail}`);
+}
+//# sourceMappingURL=daemon-health.js.map

package/dist/install/daemon-health.js.map

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