@protoboxai/codeloop 0.3.0

package/dist/lib/flow.js.map

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

package/dist/lib/glob.d.ts

@@ -0,0 +1,2 @@
+/** Path globs: `**` crosses directories, `*` stays inside one segment. Everything else is literal. */
+export declare function globMatches(glob: string, path: string): boolean;

package/dist/lib/glob.js

@@ -0,0 +1,10 @@
+/** Path globs: `**` crosses directories, `*` stays inside one segment. Everything else is literal. */
+export function globMatches(glob, path) {
+    const pattern = glob
+        .replace(/^\.\//, '')
+        .split(/(\*\*\/|\*\*|\*)/)
+        .map(part => (part === '**/' ? '(?:.*/)?' : part === '**' ? '.*' : part === '*' ? '[^/]*' : part.replace(/[.+?^${}()|[\]\\]/g, '\\$&')))
+        .join('');
+    return new RegExp(`^${pattern}$`).test(path.replace(/^\.\//, ''));
+}
+//# sourceMappingURL=glob.js.map

package/dist/lib/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/lib/glob.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,OAAO,GAAG,IAAI;SACjB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,KAAK,CAAC,kBAAkB,CAAC;SACzB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;SACvI,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/lib/import.d.ts

@@ -0,0 +1,13 @@
+import type { Card } from './cards.js';
+export interface ImportResult {
+    cards: Card[];
+    flagged: {
+        card: string;
+        file: string;
+        task: string;
+    }[];
+}
+/** Reads `specs/NNN*` in Spec Kit layout. Source files are only read; copies go under `specs/<card-id>-<slug>/`. */
+export declare function importSpecKit(projectDir: string, from: string, lane?: string): ImportResult;
+/** Reads BMAD `sprint-status.yaml` and the story files beside it. One card per story; epics and retrospectives are skipped. */
+export declare function importBmad(projectDir: string, from: string, lane?: string): ImportResult;

package/dist/lib/import.js

@@ -0,0 +1,127 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'fs';
+import { basename, dirname, join, resolve } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { loadConfig } from './config.js';
+import { importCards, RefusalError } from './engine.js';
+import { globMatches } from './glob.js';
+import { parseFrontmatter } from './skills.js';
+import { LAYERS, slugify } from './spec.js';
+const SPECKIT_TASK = /^- \[( |x|X)\] (T\d{3})((?: \[[^\]]+\])*) (.+)$/;
+function layerScopes(projectDir) {
+    const scopes = loadConfig(projectDir).scopes ?? {};
+    return LAYERS.filter(l => scopes[l]?.paths).map(l => ({ layer: l, globs: scopes[l].paths }));
+}
+// A scope counts only when it is named after a layer (api, sdk, ui, test, docs) in config.yaml.
+function inferLayer(text, scopes) {
+    const paths = text.split(/[\s,()`'"]+/).filter(t => t.includes('/') || /\.\w+$/.test(t));
+    for (const path of paths) {
+        const hit = scopes.find(s => s.globs.some(g => globMatches(g, path.replace(/[.:;]$/, ''))));
+        if (hit)
+            return hit.layer;
+    }
+    return null;
+}
+/** Reads `specs/NNN*` in Spec Kit layout. Source files are only read; copies go under `specs/<card-id>-<slug>/`. */
+export function importSpecKit(projectDir, from, lane = 'build') {
+    const root = join(resolve(projectDir, from), 'specs');
+    const features = existsSync(root)
+        ? readdirSync(root).filter(d => /^\d{3}/.test(d) && statSync(join(root, d)).isDirectory() && existsSync(join(root, d, 'tasks.md'))).sort()
+        : [];
+    if (features.length === 0)
+        throw new RefusalError(`no Spec Kit features (specs/NNN*/tasks.md) under ${from}`);
+    const titleOf = (dir) => {
+        const spec = join(root, dir, 'spec.md');
+        const h1 = existsSync(spec) ? /^#\s+(?:Feature Specification:\s*)?(.+?)\s*$/m.exec(readFileSync(spec, 'utf-8'))?.[1] : undefined;
+        return h1 ?? dir.replace(/^\d{3}-?/, '').replace(/-/g, ' ');
+    };
+    const cards = importCards(projectDir, features.map(dir => ({
+        lane,
+        title: titleOf(dir),
+        note: `speckit ${join(from, 'specs', dir)}`,
+        spec: id => `specs/${id}-${slugify(dir.replace(/^\d{3}-?/, '')) || 'feature'}`,
+    })));
+    const scopes = layerScopes(projectDir);
+    const flagged = [];
+    features.forEach((dir, i) => {
+        const card = cards[i];
+        const dest = join(projectDir, card.spec);
+        mkdirSync(dest, { recursive: true });
+        for (const name of ['research.md', 'plan.md']) {
+            if (existsSync(join(root, dir, name)))
+                copyFileSync(join(root, dir, name), join(dest, name));
+        }
+        // Spec Kit writes user stories as headings; codeloop traces `- USn` acceptance lines.
+        const spec = existsSync(join(root, dir, 'spec.md')) ? readFileSync(join(root, dir, 'spec.md'), 'utf-8') : `# ${card.title}\n`;
+        const stories = [...spec.matchAll(/^#{2,4}\s+User Story (\d+)\s*[-:]\s*(.+?)\s*$/gm)];
+        writeFileSync(join(dest, 'spec.md'), `${spec.trimEnd()}\n\nacceptance:\n${stories.map(m => `- US${m[1]} ${m[2]}`).join('\n')}\n`);
+        const tasks = readFileSync(join(root, dir, 'tasks.md'), 'utf-8').split('\n').map(line => {
+            const m = SPECKIT_TASK.exec(line);
+            if (!m)
+                return line;
+            const tags = m[3].split(' ').filter(t => t === '[P]' || /^\[US\d+\]$/.test(t)).sort();
+            const layer = inferLayer(m[4], scopes);
+            const rewritten = `- [${m[1] === ' ' ? ' ' : 'x'}] ${m[2]}${tags.map(t => ` ${t}`).join('')} [${layer ?? '?'}] ${m[4]}`;
+            if (!layer)
+                flagged.push({ card: card.id, file: `${card.spec}/tasks.md`, task: rewritten });
+            return rewritten;
+        });
+        writeFileSync(join(dest, 'tasks.md'), tasks.join('\n'));
+    });
+    return { cards, flagged };
+}
+const BMAD_STAGE = {
+    backlog: 'research',
+    drafted: 'spec',
+    'ready-for-dev': 'build',
+    'in-progress': 'build',
+    review: 'review',
+    done: 'done',
+};
+function findUp(dir, name, depth = 3) {
+    if (existsSync(join(dir, name)))
+        return join(dir, name);
+    if (depth === 0)
+        return null;
+    for (const sub of readdirSync(dir).filter(d => d !== 'node_modules' && d !== '.git' && statSync(join(dir, d)).isDirectory())) {
+        const hit = findUp(join(dir, sub), name, depth - 1);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+/** Reads BMAD `sprint-status.yaml` and the story files beside it. One card per story; epics and retrospectives are skipped. */
+export function importBmad(projectDir, from, lane = 'build') {
+    const base = resolve(projectDir, from);
+    const statusFile = existsSync(base) ? findUp(base, 'sprint-status.yaml') : null;
+    if (!statusFile)
+        throw new RefusalError(`no sprint-status.yaml under ${from}`);
+    const status = parseYaml(readFileSync(statusFile, 'utf-8'))?.development_status ?? {};
+    const stories = Object.entries(status).filter(([key]) => !key.startsWith('epic-'));
+    if (stories.length === 0)
+        throw new RefusalError(`${statusFile} lists no stories under development_status`);
+    const storyFile = (key) => [dirname(statusFile), join(dirname(statusFile), 'stories')].map(d => join(d, `${key}.md`)).find(existsSync);
+    const titleOf = (key) => {
+        const file = storyFile(key);
+        if (!file)
+            return key.replace(/-/g, ' ');
+        const { data, body } = parseFrontmatter(readFileSync(file, 'utf-8'));
+        return (typeof data.title === 'string' && data.title) || /^#\s+(.+?)\s*$/m.exec(body)?.[1] || key.replace(/-/g, ' ');
+    };
+    const cards = importCards(projectDir, stories.map(([key, state]) => ({
+        lane,
+        title: titleOf(key),
+        stage: BMAD_STAGE[state] ?? 'research',
+        note: `bmad ${basename(statusFile)} ${key}: ${state}`,
+        spec: id => `specs/${id}-${slugify(key)}`,
+    })));
+    stories.forEach(([key], i) => {
+        const file = storyFile(key);
+        if (!file)
+            return;
+        const dest = join(projectDir, cards[i].spec);
+        mkdirSync(dest, { recursive: true });
+        copyFileSync(file, join(dest, 'spec.md'));
+    });
+    return { cards, flagged: [] };
+}
+//# sourceMappingURL=import.js.map

package/dist/lib/import.js.map

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

package/dist/lib/inbox.d.ts

@@ -0,0 +1,42 @@
+import { type CardEvent } from './cards.js';
+export declare const INBOX_SEEN = ".codeloop/state/inbox-seen.json";
+export interface Inbox {
+    summary: string;
+    needs_you: {
+        id: string;
+        title: string;
+        lane: string;
+        stage: string;
+        gate: string;
+        awaiting?: string;
+        read?: string;
+        mock?: string;
+        source?: string;
+        last_check: string;
+        since: string;
+        last_event?: CardEvent;
+    }[];
+    /** Wiki pages changed here and in the cloud: merge the cloud version into the local page, then delete it. */
+    needs_merge: {
+        path: string;
+        cloud: string;
+    }[];
+    shipped: {
+        id: string;
+        title: string;
+        lane: string;
+        finishedAt: string;
+    }[];
+    numbers: {
+        lane: string;
+        metric?: string;
+        target?: string;
+        active: number;
+        parked: number;
+        done: number;
+        human_turns_per_card: number | null;
+        first_pass_rate: number | null;
+    }[];
+}
+export declare function buildInbox(projectDir: string, now?: Date): Inbox;
+export declare function markInboxSeen(projectDir: string, now?: Date): void;

package/dist/lib/inbox.js

@@ -0,0 +1,65 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { DONE, inLane, PROPOSED, readCards } from './cards.js';
+import { clock } from './clock.js';
+import { loadLanes, substitute } from './lane.js';
+import { findMock } from './mock.js';
+import { cloudCopies } from './wiki.js';
+export const INBOX_SEEN = '.codeloop/state/inbox-seen.json';
+const firstPass = (c) => !c.events.some(e => e.action === 'fail' || e.action === 'reject');
+export function buildInbox(projectDir, now = clock()) {
+    const { cards } = readCards(projectDir);
+    const seenFile = join(projectDir, INBOX_SEEN);
+    const seen = existsSync(seenFile) ? JSON.parse(readFileSync(seenFile, 'utf-8')).at : '';
+    const lanes = loadLanes(projectDir);
+    const laneIds = [...new Set([...lanes.map(l => l.id), ...cards.map(c => c.lane)])];
+    const waiting = cards.filter(c => c.gate).map(c => {
+        const stage = lanes.find(l => l.id === c.lane)?.stages.find(s => s.id === c.stage);
+        const parkedAt = c.events.filter(e => e.action === 'park' || e.action === 'stuck').at(-1);
+        const last_check = c.stage === PROPOSED
+            ? 'not started: a proposal'
+            : c.gate === 'stuck'
+                ? `failed: ${c.events.filter(e => e.action === 'stuck').at(-1)?.note?.split('\n').at(-1) ?? ''}`
+                : stage?.gate?.outward ? 'not run yet (public step, approve first)' : 'passed';
+        const mock = findMock(projectDir, c.id);
+        return {
+            id: c.id, title: c.title, lane: c.lane, stage: c.stage, gate: c.gate, awaiting: c.awaiting,
+            read: stage?.output ? substitute(stage.output, c) : undefined,
+            ...(mock ? { mock } : {}),
+            ...(c.source ? { source: c.source } : {}),
+            last_check, since: parkedAt?.at ?? c.updatedAt, last_event: c.events.at(-1),
+        };
+    });
+    const day = 86_400_000;
+    const week = cards.filter(c => c.stage === DONE && now.getTime() - new Date(c.updatedAt).getTime() < 7 * day).length;
+    const oldest = waiting.length ? Math.floor((now.getTime() - Math.min(...waiting.map(w => new Date(w.since).getTime()))) / day) : 0;
+    return {
+        summary: `${week} shipped this week, ${waiting.length} waiting on you${waiting.length ? `, oldest ${oldest === 0 ? 'today' : `${oldest} day${oldest === 1 ? '' : 's'}`}` : ''}`,
+        needs_you: waiting,
+        needs_merge: cloudCopies(projectDir),
+        shipped: cards
+            .filter(c => c.stage === DONE && c.updatedAt > seen)
+            .map(c => ({ id: c.id, title: c.title, lane: c.lane, finishedAt: c.updatedAt })),
+        numbers: laneIds.map(id => {
+            const mine = cards.filter(c => c.lane === id);
+            const done = mine.filter(c => c.stage === DONE);
+            const lane = lanes.find(l => l.id === id);
+            return {
+                lane: id,
+                metric: lane?.metric?.name,
+                target: lane?.metric?.target,
+                active: mine.filter(c => inLane(c) && !c.gate).length,
+                parked: mine.filter(c => c.gate).length,
+                done: done.length,
+                human_turns_per_card: mine.length ? mine.reduce((n, c) => n + c.events.filter(e => e.human).length, 0) / mine.length : null,
+                first_pass_rate: done.length ? done.filter(firstPass).length / done.length : null,
+            };
+        }),
+    };
+}
+export function markInboxSeen(projectDir, now = clock()) {
+    const file = join(projectDir, INBOX_SEEN);
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify({ at: now.toISOString() }, null, 2) + '\n');
+}
+//# sourceMappingURL=inbox.js.map

package/dist/lib/inbox.js.map

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

package/dist/lib/lane.d.ts

@@ -0,0 +1,71 @@
+export type Approver = 'owner' | 'reviewer';
+export interface Gate {
+    name: string;
+    approver: Approver;
+    outward?: boolean;
+}
+export interface Stage {
+    id: string;
+    skill?: string;
+    role?: string | string[];
+    output?: string;
+    done?: {
+        cmd?: string;
+        event?: string;
+    };
+    gate?: Gate;
+    notes?: string[];
+}
+export interface Lane {
+    id: string;
+    version: number;
+    metric: {
+        name: string;
+        source: string;
+        target?: string;
+    };
+    trigger?: {
+        on?: string;
+        lane?: string;
+        cron?: string;
+        manual?: boolean;
+    };
+    wip?: number;
+    retries: number;
+    stages: Stage[];
+    on_done?: {
+        start?: string;
+    };
+}
+export interface SkillEntry {
+    name: string;
+    source: string;
+    kind: 'skill' | 'command';
+    description: string;
+}
+export declare const LANES_DIR = ".codeloop/lanes";
+export declare const SKILLS_INDEX = ".codeloop/skills.index.yaml";
+export declare function lanePath(projectDir: string, id: string): string;
+export declare function parseLane(text: string): Lane;
+export declare function loadLane(projectDir: string, id: string): Lane;
+export declare function loadLanes(projectDir: string): Lane[];
+/** null when no index has been written yet, so lint can skip the skill check. */
+export declare function loadSkillsIndex(projectDir: string): SkillEntry[] | null;
+export declare function lintLane(lane: Lane, skills?: SkillEntry[] | null): string[];
+export declare function cardNumber(cardId: string): string;
+/**
+ * `{id}` is the card id; `{nnn}` is its digits zero-padded to 3 (c-7 → 007); `{spec}` is the
+ * card's spec folder, `specs/{nnn}` when the card has none recorded.
+ */
+export declare function substitute(template: string, card: string | {
+    id: string;
+    key?: string;
+    spec?: string;
+}, opts?: {
+    shell?: boolean;
+}): string;
+/**
+ * A value made only of path-safe characters is passed through, so `{spec}/research.md` still reads
+ * as one path. Anything else is single-quoted: it reaches the command as text and is never parsed.
+ */
+export declare function shellQuote(value: string): string;

package/dist/lib/lane.js

@@ -0,0 +1,105 @@
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { RefusalError, safeName } from './cards.js';
+import { cronError } from './cron.js';
+export const LANES_DIR = '.codeloop/lanes';
+export const SKILLS_INDEX = '.codeloop/skills.index.yaml';
+const DEFAULT_RETRIES = 3;
+const TRIGGER_EVENTS = ['lane.done', 'git.commit', 'git.tag'];
+export function lanePath(projectDir, id) {
+    return join(projectDir, LANES_DIR, `${safeName(id, 'lane id')}.yaml`);
+}
+export function parseLane(text) {
+    const raw = parseYaml(text) ?? {};
+    return { ...raw, retries: raw.retries ?? DEFAULT_RETRIES, stages: raw.stages ?? [] };
+}
+export function loadLane(projectDir, id) {
+    const file = lanePath(projectDir, id);
+    if (!existsSync(file))
+        throw new RefusalError(`lane "${id}" not found at ${LANES_DIR}/${id}.yaml`);
+    return parseLane(readFileSync(file, 'utf-8'));
+}
+export function loadLanes(projectDir) {
+    const dir = join(projectDir, LANES_DIR);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter(f => f.endsWith('.yaml'))
+        .sort()
+        .map(f => parseLane(readFileSync(join(dir, f), 'utf-8')));
+}
+/** null when no index has been written yet, so lint can skip the skill check. */
+export function loadSkillsIndex(projectDir) {
+    const file = join(projectDir, SKILLS_INDEX);
+    if (!existsSync(file))
+        return null;
+    return (parseYaml(readFileSync(file, 'utf-8')) ?? []);
+}
+export function lintLane(lane, skills = null) {
+    const errors = [];
+    const where = `lane ${lane.id ?? '(no id)'}`;
+    if (!lane.id)
+        errors.push(`${where}: missing id`);
+    if (!Number.isInteger(lane.version))
+        errors.push(`${where}: version must be an integer`);
+    if (!lane.metric?.name || !lane.metric?.source)
+        errors.push(`${where}: missing metric (name and source)`);
+    if (lane.trigger?.cron) {
+        const err = cronError(lane.trigger.cron);
+        if (err)
+            errors.push(`${where}: ${err}`);
+    }
+    const on = lane.trigger?.on;
+    if (on && !TRIGGER_EVENTS.includes(on))
+        errors.push(`${where}: trigger.on "${on}" never fires (use ${TRIGGER_EVENTS.join(', ')})`);
+    if (on === 'lane.done' && !lane.trigger?.lane)
+        errors.push(`${where}: trigger on lane.done needs \`lane:\` naming the lane it follows`);
+    if (lane.stages.length === 0)
+        errors.push(`${where}: no stages`);
+    const known = skills ? new Set(skills.map(s => s.name)) : null;
+    const seen = new Set();
+    for (const stage of lane.stages) {
+        const at = `${where} stage ${stage.id ?? '(no id)'}`;
+        if (!stage.id)
+            errors.push(`${at}: missing id`);
+        else if (seen.has(stage.id))
+            errors.push(`${at}: duplicate stage id`);
+        seen.add(stage.id);
+        if (!stage.done?.cmd && !stage.done?.event)
+            errors.push(`${at}: no done check (cmd or event)`);
+        if (stage.gate) {
+            if (!stage.gate.name)
+                errors.push(`${at}: gate has no name`);
+            if (stage.gate.approver !== 'owner' && stage.gate.approver !== 'reviewer') {
+                errors.push(`${at}: gate has no approver (owner or reviewer)`);
+            }
+        }
+        if (known && stage.skill && !known.has(stage.skill)) {
+            errors.push(`${at}: skill "${stage.skill}" is not in ${SKILLS_INDEX}`);
+        }
+    }
+    return errors;
+}
+export function cardNumber(cardId) {
+    return cardId.replace(/\D/g, '').padStart(3, '0');
+}
+/**
+ * `{id}` is the card id; `{nnn}` is its digits zero-padded to 3 (c-7 → 007); `{spec}` is the
+ * card's spec folder, `specs/{nnn}` when the card has none recorded.
+ */
+export function substitute(template, card, opts = {}) {
+    const { id, spec, key } = typeof card === 'string' ? { id: card, spec: undefined, key: undefined } : card;
+    // A card that shares its number with another one is keyed by its full id instead.
+    const nnn = key ?? cardNumber(id);
+    const value = opts.shell ? shellQuote : (v) => v;
+    return template.replaceAll('{id}', value(id)).replaceAll('{nnn}', value(nnn)).replaceAll('{spec}', value(spec ?? `specs/${nnn}`));
+}
+/**
+ * A value made only of path-safe characters is passed through, so `{spec}/research.md` still reads
+ * as one path. Anything else is single-quoted: it reaches the command as text and is never parsed.
+ */
+export function shellQuote(value) {
+    return /^[A-Za-z0-9_./-]+$/.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
+}
+//# sourceMappingURL=lane.js.map

package/dist/lib/lane.js.map

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

package/dist/lib/lock.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runs `fn` while holding `<path>.lock`, created exclusively so only one process can hold it.
+ * Everything that reads a file, decides, and writes it back goes through here; without it two
+ * processes can both pass the check and the later rename silently discards the earlier write.
+ */
+export declare function withLock<T>(path: string, fn: () => T): T;

package/dist/lib/lock.js

@@ -0,0 +1,64 @@
+import { closeSync, mkdirSync, openSync, readFileSync, rmSync, statSync, writeSync } from 'fs';
+import { dirname } from 'path';
+const WAIT_MS = 30_000;
+// A holder that died without releasing is detected by its pid. The age limit covers a pid that
+// was reused, and is longer than any write may take (a cloud write can wait on a rate limit).
+const STALE_MS = 5 * 60_000;
+function sleep(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function stale(lock) {
+    try {
+        const pid = parseInt(readFileSync(lock, 'utf-8'), 10);
+        if (Date.now() - statSync(lock).mtimeMs > STALE_MS)
+            return true;
+        if (!pid)
+            return false; // the holder has created the file and not written its pid yet
+        try {
+            process.kill(pid, 0);
+            return false;
+        }
+        catch (e) {
+            return e.code === 'ESRCH';
+        }
+    }
+    catch {
+        return false; // gone between the failed open and this look: retry the open
+    }
+}
+/**
+ * Runs `fn` while holding `<path>.lock`, created exclusively so only one process can hold it.
+ * Everything that reads a file, decides, and writes it back goes through here; without it two
+ * processes can both pass the check and the later rename silently discards the earlier write.
+ */
+export function withLock(path, fn) {
+    const lock = `${path}.lock`;
+    mkdirSync(dirname(lock), { recursive: true });
+    const deadline = Date.now() + WAIT_MS;
+    for (let wait = 2;; wait = Math.min(wait * 2, 50)) {
+        try {
+            const fd = openSync(lock, 'wx');
+            writeSync(fd, String(process.pid));
+            closeSync(fd);
+            break;
+        }
+        catch (e) {
+            if (e.code !== 'EEXIST')
+                throw e;
+            if (stale(lock)) {
+                rmSync(lock, { force: true });
+                continue;
+            }
+            if (Date.now() > deadline)
+                throw new Error(`could not lock ${path} within ${WAIT_MS / 1000}s; if no codeloop process is running, delete ${lock}`);
+            sleep(wait + Math.floor(Math.random() * wait));
+        }
+    }
+    try {
+        return fn();
+    }
+    finally {
+        rmSync(lock, { force: true });
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/lib/lock.js.map

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

package/dist/lib/mcp.d.ts

@@ -0,0 +1,2 @@
+/** Same engine as the CLI. The role comes from CODELOOP_ROLE in the server's environment, never from a tool argument. */
+export declare function serveMcp(projectDir: string): Promise<void>;