518b8eca85
md-first memory extraction framework for AI agents. Markdown is the single source of truth; SQLite holds state and LanceDB provides the rebuildable vector + BM25 + scalar index. The codebase follows a single-direction DDD layering (entrypoints -> service -> memory -> infra, with component / core / config cross-cutting) enforced by import-linter. Engineering surface: - Coding conventions in .claude/rules/ (path-scoped) and workflows in .claude/skills/ (/commit, /new-branch, /pr). - GitHub Actions CI runs make lint + test + integration; pre-commit mirrors the gates locally (ruff, hygiene hooks, gitlint commit-msg). - Commit messages follow Conventional Commits, enforced by gitlint. - make lint also enforces datetime two-zone discipline and OpenAPI drift.
61 lines
1.5 KiB
JavaScript
61 lines
1.5 KiB
JavaScript
/**
|
|
* Shared debug utility for EverMem hooks
|
|
*
|
|
* Usage:
|
|
* import { debug, setDebugPrefix } from './utils/debug.js';
|
|
* setDebugPrefix('inject'); // Optional: add prefix to log lines
|
|
* debug('hookInput:', data);
|
|
*
|
|
* Enable by setting EVERMEM_DEBUG=1 in .env file or environment
|
|
* Logs are written to /tmp/evermem-debug.log
|
|
*/
|
|
|
|
import { appendFileSync } from 'fs';
|
|
import { isConfigured } from './config.js'; // This loads .env
|
|
|
|
const DEBUG_LOG_PATH = '/tmp/evermem-debug.log';
|
|
|
|
// Check debug flag (after config.js loads .env)
|
|
const DEBUG = process.env.EVERMEM_DEBUG === '1';
|
|
|
|
// Optional prefix for log lines (e.g., 'inject' or 'store')
|
|
let debugPrefix = '';
|
|
|
|
/**
|
|
* Set a prefix for debug log lines
|
|
* @param {string} prefix - Prefix to add (e.g., 'inject', 'store')
|
|
*/
|
|
export function setDebugPrefix(prefix) {
|
|
debugPrefix = prefix ? `[${prefix}] ` : '';
|
|
}
|
|
|
|
/**
|
|
* Write debug message to log file
|
|
* Only writes when EVERMEM_DEBUG=1
|
|
*
|
|
* @param {...any} args - Arguments to log (objects are JSON stringified)
|
|
*/
|
|
export function debug(...args) {
|
|
if (!DEBUG) return;
|
|
|
|
const msg = args.map(a =>
|
|
typeof a === 'object' ? JSON.stringify(a, null, 2) : a
|
|
).join(' ');
|
|
|
|
const timestamp = new Date().toISOString();
|
|
const line = `[${timestamp}] ${debugPrefix}${msg}\n`;
|
|
|
|
try {
|
|
appendFileSync(DEBUG_LOG_PATH, line);
|
|
} catch (e) {
|
|
// Silent on write errors
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check if debug mode is enabled
|
|
* @returns {boolean}
|
|
*/
|
|
export function isDebugEnabled() {
|
|
return DEBUG;
|
|
} |