Skip to content

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

3.0 KB
Raw Blame
import path from 'node:path';
import { mkdir, readFile, writeFile, open, unlink, stat } from 'node:fs/promises';
/** Today's date in UTC, as YYYY-MM-DD — the daily-spend rollover boundary. */
export function todayUTC() {
    return new Date().toISOString().slice(0, 10);
}
function statePath(dir, pattern) {
    return path.join(dir, `daily-spend.${pattern}.json`);
}
function lockPath(dir, pattern) {
    return path.join(dir, `.daily-spend.${pattern}.lock`);
}
const LOCK_STALE_MS = 30000;
const LOCK_TIMEOUT_MS = 30000;
/**
 * Serializes read-modify-write access to one pattern's state file, the same
 * lock-file-plus-poll shape loop-worktree's manifest mutex uses. Without
 * this, two overlapping invocations (e.g. two scheduled loops hitting the
 * same pattern) both read the same stale total and the second write clobbers
 * the first, silently losing a delta from the daily-budget circuit breaker.
 */
async function withLock(dir, pattern, fn) {
    await mkdir(dir, { recursive: true });
    const lock = lockPath(dir, pattern);
    const deadline = Date.now() + LOCK_TIMEOUT_MS;
    for (;;) {
        try {
            const handle = await open(lock, 'wx');
            await handle.close();
            break;
        }
        catch (err) {
            if (err.code !== 'EEXIST')
                throw err;
            try {
                const st = await stat(lock);
                if (Date.now() - st.mtimeMs > LOCK_STALE_MS) {
                    await unlink(lock).catch(() => { });
                    continue;
                }
            }
            catch {
                continue;
            }
            if (Date.now() > deadline) {
                throw new Error(`Timed out waiting for daily-spend lock on "${pattern}". If no other loop-context process is running, delete ${lock} manually.`);
            }
            await new Promise((resolve) => setTimeout(resolve, 15 + Math.random() * 35));
        }
    }
    try {
        return await fn();
    }
    finally {
        await unlink(lock).catch(() => { });
    }
}
async function readState(dir, pattern) {
    try {
        const raw = await readFile(statePath(dir, pattern), 'utf8');
        return JSON.parse(raw);
    }
    catch {
        return null;
    }
}
/**
 * Add `tokensDelta` to a pattern's running daily total and persist it. Rolls
 * over to a fresh total when the stored date isn't today (UTC) — a stale
 * file from a previous day is treated as if it didn't exist.
 */
export async function recordDailySpend(dir, pattern, tokensDelta) {
    return withLock(dir, pattern, async () => {
        const today = todayUTC();
        const existing = await readState(dir, pattern);
        const carryOver = existing && existing.date === today ? existing.tokensUsedToday : 0;
        const state = { date: today, tokensUsedToday: carryOver + tokensDelta };
        await mkdir(dir, { recursive: true });
        await writeFile(statePath(dir, pattern), JSON.stringify(state, null, 2));
        return state;
    });
}