elepha 0.1.0

package/dist/config/settings.js

@@ -0,0 +1,132 @@
+import { chmodSync, existsSync, readFileSync } from 'node:fs';
+import { writeJson } from '../util/fs.js';
+import { PRIVATE_FILE_MODE } from './constants.js';
+import { elephaConfigPath } from './paths.js';
+const UPDATE_CHECK_KEY = 'update-check';
+const BOOLEAN_SETTING_VALUES = ['true', 'false', '1', '0', 'on', 'off'];
+export const SETTING_KEYS = [UPDATE_CHECK_KEY, 'capture-claude-code', 'capture-codex', 'query-matching'];
+export const SETTING_SCHEMA = {
+    'update-check': { kind: 'boolean', values: BOOLEAN_SETTING_VALUES, default: true },
+    'capture-claude-code': { kind: 'boolean', values: BOOLEAN_SETTING_VALUES, default: true },
+    'capture-codex': { kind: 'boolean', values: BOOLEAN_SETTING_VALUES, default: true },
+    'query-matching': { kind: 'enum', values: ['strict', 'lax'], default: 'strict' },
+};
+function validKey(key) {
+    return SETTING_KEYS.includes(key);
+}
+function unknownKeyError(key) {
+    return new Error(`unknown setting "${key}"; valid keys: ${SETTING_KEYS.join(', ')}`);
+}
+function readConfig(filePath) {
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return { config: {}, exists: false };
+        }
+        return { config: {}, exists: true, error: 'cannot read config' };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return { config: {}, exists: true, error: 'config must be a JSON object' };
+        }
+        return { config: parsed, exists: true };
+    }
+    catch {
+        return { config: {}, exists: true, error: 'config is invalid JSON' };
+    }
+}
+function readConfigForMutation(filePath) {
+    const result = readConfig(filePath);
+    if (result.error) {
+        throw new Error(result.error);
+    }
+    return result;
+}
+function acceptedValues(values) {
+    if (values.length === 2) {
+        return `${values[0]} or ${values[1]}`;
+    }
+    return `${values.slice(0, -1).join(', ')}, or ${values.at(-1)}`;
+}
+function parseSetting(key, value) {
+    const schema = SETTING_SCHEMA[key];
+    const normalized = value.toLowerCase();
+    if (schema.kind === 'boolean') {
+        if (normalized === 'true' || normalized === '1' || normalized === 'on') {
+            return true;
+        }
+        if (normalized === 'false' || normalized === '0' || normalized === 'off') {
+            return false;
+        }
+    }
+    else if (schema.values.includes(normalized)) {
+        return normalized;
+    }
+    throw new Error(`${key} must be ${acceptedValues(schema.values)}`);
+}
+function configuredSetting(key, value) {
+    const schema = SETTING_SCHEMA[key];
+    if (schema.kind === 'boolean') {
+        return (typeof value === 'boolean' ? value : undefined);
+    }
+    return (typeof value === 'string' && schema.values.includes(value) ? value : undefined);
+}
+function captureEnabled(config, key) {
+    return configuredSetting(key, config[key]) ?? SETTING_SCHEMA[key].default;
+}
+function writeConfig(filePath, config) {
+    writeJson(filePath, config, PRIVATE_FILE_MODE);
+    chmodSync(filePath, PRIVATE_FILE_MODE);
+}
+export function getSetting(key, environment = process.env, filePath = elephaConfigPath()) {
+    if (!validKey(key)) {
+        throw unknownKeyError(key);
+    }
+    if (key === UPDATE_CHECK_KEY && environment.ELEPHA_NO_UPDATE_CHECK !== undefined) {
+        return { key, value: false, source: 'env' };
+    }
+    const configValue = readConfig(filePath).config[key];
+    const configured = configuredSetting(key, configValue);
+    if (configured !== undefined) {
+        return { key, value: configured, source: 'config' };
+    }
+    return { key, value: SETTING_SCHEMA[key].default, source: 'default' };
+}
+export function listSettings(environment = process.env, filePath = elephaConfigPath()) {
+    return SETTING_KEYS.map((key) => getSetting(key, environment, filePath));
+}
+export function setSetting(key, value, filePath = elephaConfigPath()) {
+    if (!validKey(key)) {
+        throw unknownKeyError(key);
+    }
+    const config = readConfigForMutation(filePath).config;
+    const parsedValue = parseSetting(key, value);
+    if (!parsedValue && key === 'capture-claude-code' && !captureEnabled(config, 'capture-codex')) {
+        throw new Error('at least one capture tool must remain enabled');
+    }
+    if (!parsedValue && key === 'capture-codex' && !captureEnabled(config, 'capture-claude-code')) {
+        throw new Error('at least one capture tool must remain enabled');
+    }
+    config[key] = parsedValue;
+    writeConfig(filePath, config);
+    return getSetting(key, {}, filePath);
+}
+export function unsetSetting(key, filePath = elephaConfigPath()) {
+    if (!validKey(key)) {
+        throw unknownKeyError(key);
+    }
+    if (!existsSync(filePath)) {
+        return getSetting(key, {}, filePath);
+    }
+    const config = readConfigForMutation(filePath).config;
+    if (key in config) {
+        delete config[key];
+        writeConfig(filePath, config);
+    }
+    return getSetting(key, {}, filePath);
+}
+//# sourceMappingURL=settings.js.map

package/dist/config/settings.js.map

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

package/dist/config/version.js

@@ -0,0 +1,12 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+function readPackageVersion() {
+    const packageRoot = path.resolve(import.meta.dirname, '..', '..');
+    const manifest = JSON.parse(readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+    if (typeof manifest.version !== 'string') {
+        throw new Error('elepha package.json has an invalid version');
+    }
+    return manifest.version;
+}
+export const PACKAGE_VERSION = readPackageVersion();
+//# sourceMappingURL=version.js.map

package/dist/config/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/config/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,kBAAkB;IACvB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA0B,CAAC;IACnH,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/daemon/failure-window.js

@@ -0,0 +1,38 @@
+import { FAILURE_RATE_THRESHOLD, FAILURE_WINDOW_MIN_SAMPLES, FAILURE_WINDOW_SIZE } from '../config/constants.js';
+// Sustained-failure detection: a run like the 38-minute, 6,592-call
+// unconfigured-API-key episode from the dogfooding period must surface as a
+// warning, not scroll past as thousands of individually-unremarkable log
+// lines. Edge-triggered (warns once on crossing into failure, once again on
+// recovery) so it doesn't spam once already in the bad state.
+export class FailureWindow {
+    log;
+    logError;
+    recentOutcomes = []; // true = failed (parse_error/api_error); empty_turn is excluded, it made no call
+    sustainedFailureActive = false;
+    constructor(log, logError = log) {
+        this.log = log;
+        this.logError = logError;
+    }
+    trackOutcome(status) {
+        if (status === 'empty_turn') {
+            return; // no API call was made, not a signal either way
+        }
+        this.recentOutcomes.push(status !== 'ok');
+        if (this.recentOutcomes.length > FAILURE_WINDOW_SIZE) {
+            this.recentOutcomes.shift();
+        }
+        if (this.recentOutcomes.length < FAILURE_WINDOW_MIN_SAMPLES) {
+            return;
+        }
+        const failureRate = this.recentOutcomes.filter(Boolean).length / this.recentOutcomes.length;
+        if (failureRate >= FAILURE_RATE_THRESHOLD && !this.sustainedFailureActive) {
+            this.sustainedFailureActive = true;
+            this.logError(`[elepha] WARNING: summarizer failure rate ${(failureRate * 100).toFixed(0)}% over last ${this.recentOutcomes.length} calls - check API key / network / rate limits`);
+        }
+        else if (failureRate < FAILURE_RATE_THRESHOLD && this.sustainedFailureActive) {
+            this.sustainedFailureActive = false;
+            this.log(`[elepha] summarizer failure rate recovered to ${(failureRate * 100).toFixed(0)}%`);
+        }
+    }
+}
+//# sourceMappingURL=failure-window.js.map

package/dist/daemon/failure-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-window.js","sourceRoot":"","sources":["../../src/daemon/failure-window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGjH,oEAAoE;AACpE,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,OAAO,aAAa;IAKD,GAAG;IACH,QAAQ;IALZ,cAAc,GAAc,EAAE,CAAC,CAAC,iFAAiF;IAC1H,sBAAsB,GAAG,KAAK,CAAC;IAEvC,YACqB,GAA8B,EAC9B,QAAQ,GAA8B,GAAG;mBADzC,GAAG;wBACH,QAAQ;IAC1B,CAAC;IAEJ,YAAY,CAAC,MAAwB;QACjC,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC1B,OAAO,CAAC,gDAAgD;QAC5D,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;YACnD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,0BAA0B,EAAE,CAAC;YAC1D,OAAO;QACX,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QAC5F,IAAI,WAAW,IAAI,sBAAsB,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACxE,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;YACnC,IAAI,CAAC,QAAQ,CACT,6CAA6C,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,cAAc,CAAC,MAAM,gDAAgD,CACvK,CAAC;QACN,CAAC;aAAM,IAAI,WAAW,GAAG,sBAAsB,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC7E,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjG,CAAC;IACL,CAAC;CACJ"}

package/dist/daemon/heartbeat.js

@@ -0,0 +1,40 @@
+// Liveness signal for `elepha status`. A process existing in the process
+// table is not proof it's doing anything - a deadlocked event loop or a
+// chokidar watcher stuck on a filesystem error still shows up in `ps aux`.
+// The daemon writes this file on start and on an interval while running;
+// `elepha status` treats a stale file (pid alive, heartbeat old) as "stuck",
+// distinct from "not running" (no file, or pid gone).
+import { unlinkSync } from 'node:fs';
+import { PRIVATE_FILE_MODE } from '../config/constants.js';
+import { daemonHeartbeatPath } from '../config/paths.js';
+import { atomicWrite, readJson } from '../util/fs.js';
+export { HEARTBEAT_INTERVAL_MS, HEARTBEAT_STALE_MS } from '../config/constants.js';
+export function defaultHeartbeatPath() {
+    return daemonHeartbeatPath();
+}
+export function writeHeartbeat(filePath, startedAt) {
+    const heartbeat = { pid: process.pid, startedAt, updatedAt: new Date().toISOString() };
+    atomicWrite(filePath, JSON.stringify(heartbeat), PRIVATE_FILE_MODE);
+}
+export function readHeartbeat(filePath) {
+    return readJson(filePath);
+}
+export function clearHeartbeat(filePath) {
+    try {
+        unlinkSync(filePath);
+    }
+    catch {
+        // already gone, or never existed - fine either way
+    }
+}
+/** True if a process with this pid exists, regardless of who owns it. */
+export function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/daemon/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/daemon/heartbeat.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAQnF,MAAM,UAAU,oBAAoB;IAChC,OAAO,mBAAmB,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,SAAiB;IAC9D,MAAM,SAAS,GAAc,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAClG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAY,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACD,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACL,mDAAmD;IACvD,CAAC;AACL,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,IAAI,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACL,CAAC"}