@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/counter-lock-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Cooperative counter-store ownership and explicit recovery diagnostics (DEC-092).
+ */
+export interface CounterLockOwner {
+    schema_version: 1;
+    token: string;
+    pid: number;
+    process_nonce: string;
+    hostname: string;
+    started_at: string;
+}
+export interface CounterLockOrphan {
+    path: string;
+    state: 'owned' | 'unsafe';
+    owner?: CounterLockOwner;
+    issues: string[];
+}
+export interface CounterLockStatus {
+    state: 'unlocked' | 'locked' | 'unsafe';
+    lockPath: string;
+    owner?: CounterLockOwner;
+    issues: string[];
+    orphans: CounterLockOrphan[];
+    orphansOmitted: number;
+    hint: string;
+}
+export type CounterLockErrorCode = 'COUNTER_LOCK_UNSAFE' | 'COUNTER_LOCK_TIMEOUT' | 'COUNTER_LOCK_IO' | 'COUNTER_LOCK_REENTRANT' | 'COUNTER_LOCK_RELEASE_FAILED' | 'COUNTER_LOCK_RECOVERY_REFUSED' | 'COUNTER_LOCK_RECOVERY_FAILED';
+export declare class CounterLockError extends Error {
+    readonly code: CounterLockErrorCode;
+    readonly lock: CounterLockStatus;
+    readonly hint: string;
+    /** False means unconfirmed, including a write whose outcome could not be checked. */
+    countersPersisted?: boolean;
+    constructor(code: CounterLockErrorCode, lock: CounterLockStatus, hint: string, cause?: unknown);
+}
+//# sourceMappingURL=counter-lock-types.d.ts.map

package/dist/core/counter-lock-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-lock-types.d.ts","sourceRoot":"","sources":["../../src/core/counter-lock-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,wBAAwB,GACxB,6BAA6B,GAC7B,+BAA+B,GAC/B,8BAA8B,CAAC;AAEnC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAM7F;CACF"}

package/dist/core/counter-lock-types.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Cooperative counter-store ownership and explicit recovery diagnostics (DEC-092).
+ */
+export class CounterLockError extends Error {
+    code;
+    lock;
+    hint;
+    /** False means unconfirmed, including a write whose outcome could not be checked. */
+    countersPersisted;
+    constructor(code, lock, hint, cause) {
+        super(`${code}: ${lock.issues.join('; ') || lock.lockPath}. ${hint}`, { cause });
+        this.name = 'CounterLockError';
+        this.code = code;
+        this.lock = lock;
+        this.hint = hint;
+    }
+}
+//# sourceMappingURL=counter-lock-types.js.map

package/dist/core/counter-lock-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-lock-types.js","sourceRoot":"","sources":["../../src/core/counter-lock-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkCH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,IAAI,CAAoB;IACxB,IAAI,CAAS;IACtB,qFAAqF;IACrF,iBAAiB,CAAW;IAC5B,YAAY,IAA0B,EAAE,IAAuB,EAAE,IAAY,EAAE,KAAe;QAC5F,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/core/counter-lock.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Nonempty directory ownership. No PID/age stealing, recursive removal or implicit recovery.
+ * Atomic rename protects process interruption; no power-loss durability is claimed (DEC-092).
+ */
+import { type CounterLockStatus } from './counter-lock-types.js';
+export type { CounterLockErrorCode, CounterLockOrphan, CounterLockOwner, CounterLockStatus, } from './counter-lock-types.js';
+export { CounterLockError } from './counter-lock-types.js';
+export declare const COUNTER_LOCK_WAIT_MS = 5000;
+/** Internal capability; validity is checked against a private live-context map. */
+export interface CounterLockContext {
+    readonly token: string;
+}
+/** Read-only, bounded status, including orphan candidates left by interrupted processes. */
+export declare function counterLockStatus(devstepsDir: string): CounterLockStatus;
+/** Internal synchronous ownership acquisition. Callers must not await while holding it. */
+export declare function acquireCounterLock(devstepsDir: string): CounterLockContext;
+/** Verify the active capability, physical store and complete ownership before each mutation. */
+export declare function assertCounterLockHeld(context: CounterLockContext, devstepsDir: string): void;
+/** Release ownership by directory rename; cleanup failure after relinquishing is a warning. */
+export declare function releaseCounterLock(context: CounterLockContext, devstepsDir: string): string[];
+/** Quiescent administrative recovery only. No counter or claimed item path is changed. */
+export declare function recoverCounterLock(devstepsDir: string, options: {
+    ownerToken: string;
+    writersStopped: boolean;
+}): {
+    recovered: true;
+    ownerToken: string;
+    lockPath: string;
+};
+//# sourceMappingURL=counter-lock.d.ts.map

package/dist/core/counter-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-lock.d.ts","sourceRoot":"","sources":["../../src/core/counter-lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAUzC,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAyCxE;AAwKD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAqB1E;AACD,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAa5F;AACD,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAwC7F;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAmC3D"}

package/dist/core/counter-lock.js

@@ -0,0 +1,295 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Nonempty directory ownership. No PID/age stealing, recursive removal or implicit recovery.
+ * Atomic rename protects process interruption; no power-loss durability is claimed (DEC-092).
+ */
+import { randomBytes } from 'node:crypto';
+import { mkdirSync, readdirSync, renameSync, rmdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import { hostname } from 'node:os';
+import { join, resolve } from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { assertStore, baseStatus, captureStore, errorText, inspectOwned, missing, OWNER_FILE, OwnershipTurnoverError, pathExists, plainDirectory, verifyOwned, } from './counter-lock-owner.js';
+import { CounterLockError, } from './counter-lock-types.js';
+export { CounterLockError } from './counter-lock-types.js';
+export const COUNTER_LOCK_WAIT_MS = 5000;
+const POLL_MS = 25;
+const MAX_ORPHANS = 10;
+const processNonce = randomBytes(32).toString('hex');
+const orphanName = /^\.counters-lock\.[0-9a-f]{64}\.(candidate|retired|quarantine)$/;
+const recoveryHint = 'Inspect devsteps counter-lock status --json. After all writers stop, recover only the exact observed owner token with devsteps counter-lock recover --owner-token TOKEN --writers-stopped --json. Never retry creation blindly.';
+const manualHint = 'Ownership is unsafe or unreadable. Inspect the named paths manually with all writers stopped; missing or malformed owner records cannot be recovered by token.';
+const held = new Map();
+const activeStores = new Set();
+/** Read-only, bounded status, including orphan candidates left by interrupted processes. */
+export function counterLockStatus(devstepsDir) {
+    const status = baseStatus(devstepsDir);
+    try {
+        plainDirectory(resolve(devstepsDir));
+        if (!pathExists(join(resolve(devstepsDir), 'index')))
+            return status;
+        const store = captureStore(devstepsDir);
+        if (pathExists(status.lockPath)) {
+            try {
+                status.owner = inspectOwned(store, status.lockPath).owner;
+                status.state = 'locked';
+                status.hint = recoveryHint;
+            }
+            catch (error) {
+                status.state = 'unsafe';
+                status.issues.push(errorText(error).slice(0, 500));
+                status.hint = manualHint;
+            }
+        }
+        const orphans = readdirSync(store.index)
+            .filter((name) => orphanName.test(name))
+            .sort();
+        status.orphansOmitted = Math.max(0, orphans.length - MAX_ORPHANS);
+        for (const name of orphans.slice(0, MAX_ORPHANS)) {
+            const path = join(store.index, name);
+            try {
+                status.orphans.push({
+                    path,
+                    state: 'owned',
+                    owner: inspectOwned(store, path).owner,
+                    issues: [],
+                });
+            }
+            catch (error) {
+                status.orphans.push({ path, state: 'unsafe', issues: [errorText(error).slice(0, 500)] });
+            }
+        }
+        assertStore(store);
+    }
+    catch (error) {
+        status.state = 'unsafe';
+        status.issues.push(errorText(error).slice(0, 500));
+        status.hint = manualHint;
+    }
+    return status;
+}
+function lockError(code, devstepsDir, issue, cause) {
+    const status = counterLockStatus(devstepsDir);
+    status.issues = [issue.slice(0, 500), ...status.issues].slice(0, 4);
+    return new CounterLockError(code, status, status.state === 'unsafe' ? manualHint : recoveryHint, cause);
+}
+function cleanOwned(store, path, expected) {
+    verifyOwned(store, path, expected);
+    unlinkSync(join(path, OWNER_FILE));
+    assertStore(store);
+    if (plainDirectory(path) !== expected.id || readdirSync(path).length !== 0)
+        throw new Error(`Retired ownership directory changed: ${path}`);
+    rmdirSync(path);
+}
+function sleepUntil(deadline) {
+    const remaining = deadline - performance.now();
+    if (remaining > 0)
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, Math.min(POLL_MS, remaining));
+}
+function renameOwned(store, from, to, expected, deadline) {
+    for (;;) {
+        verifyOwned(store, from, expected);
+        if (pathExists(to))
+            throw new Error(`Refusing to replace existing ownership path: ${to}`);
+        try {
+            renameSync(from, to);
+            return;
+        }
+        catch (error) {
+            if (!['EPERM', 'EBUSY', 'EACCES'].includes(error.code ?? '') ||
+                performance.now() >= deadline)
+                throw error;
+            sleepUntil(deadline);
+        }
+    }
+}
+function prepareCounterStore(devstepsDir) {
+    let store;
+    try {
+        const rootId = plainDirectory(resolve(devstepsDir));
+        const index = join(resolve(devstepsDir), 'index');
+        if (!pathExists(index)) {
+            try {
+                mkdirSync(index);
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST')
+                    throw error;
+            }
+        }
+        store = captureStore(devstepsDir);
+        if (store.rootId !== rootId)
+            throw new Error('Physical project identity changed during counter-store setup');
+    }
+    catch (error) {
+        throw lockError('COUNTER_LOCK_UNSAFE', devstepsDir, errorText(error), error);
+    }
+    if (activeStores.has(store.realIndex))
+        throw lockError('COUNTER_LOCK_REENTRANT', devstepsDir, 'This process already holds the counter store; nested acquisition is refused.');
+    return store;
+}
+function createOwnerCandidate(store, candidate, token) {
+    assertStore(store);
+    mkdirSync(candidate);
+    const owner = {
+        schema_version: 1,
+        token,
+        pid: process.pid,
+        process_nonce: processNonce,
+        hostname: hostname(),
+        started_at: new Date().toISOString(),
+    };
+    writeFileSync(join(candidate, OWNER_FILE), JSON.stringify(owner), { flag: 'wx' });
+    return inspectOwned(store, candidate);
+}
+function inspectContendingOwner(devstepsDir, store, canonical) {
+    try {
+        inspectOwned(store, canonical);
+    }
+    catch (error) {
+        if (!missing(error) && !(error instanceof OwnershipTurnoverError))
+            throw lockError('COUNTER_LOCK_UNSAFE', devstepsDir, errorText(error), error);
+        // Only missing paths or proven whole-directory turnover are retried by the caller.
+    }
+}
+function tryPublishCandidate(devstepsDir, store, candidate, canonical, owned, token) {
+    verifyOwned(store, candidate, owned);
+    let renamed = false;
+    try {
+        renameSync(candidate, canonical);
+        renamed = true;
+    }
+    catch (error) {
+        if (!['EEXIST', 'ENOTEMPTY', 'EPERM', 'EBUSY', 'EACCES', 'ENOENT'].includes(error.code ?? ''))
+            throw error;
+        if (pathExists(canonical))
+            inspectContendingOwner(devstepsDir, store, canonical);
+    }
+    if (renamed) {
+        // Once our candidate moved, losing its identity is unsafe, not ordinary contention.
+        try {
+            verifyOwned(store, canonical, owned);
+        }
+        catch (error) {
+            throw lockError('COUNTER_LOCK_UNSAFE', devstepsDir, errorText(error), error);
+        }
+        const context = { token };
+        held.set(context, { store, owned, path: canonical });
+        activeStores.add(store.realIndex);
+        return context;
+    }
+    return undefined;
+}
+function pollCounterOwnership(devstepsDir, store, candidate, canonical, owned, token, deadline) {
+    for (;;) {
+        assertStore(store);
+        // POSIX rename can replace an empty target directory. Inspect first and fail closed.
+        if (pathExists(canonical))
+            inspectContendingOwner(devstepsDir, store, canonical);
+        else {
+            const context = tryPublishCandidate(devstepsDir, store, candidate, canonical, owned, token);
+            if (context !== undefined)
+                return context;
+        }
+        if (performance.now() >= deadline)
+            throw lockError('COUNTER_LOCK_TIMEOUT', devstepsDir, `Counter ownership was not acquired within ${COUNTER_LOCK_WAIT_MS} ms.`);
+        sleepUntil(deadline);
+    }
+}
+/** Internal synchronous ownership acquisition. Callers must not await while holding it. */
+export function acquireCounterLock(devstepsDir) {
+    const store = prepareCounterStore(devstepsDir);
+    const token = randomBytes(32).toString('hex');
+    const candidate = join(store.index, `.counters-lock.${token}.candidate`);
+    const canonical = join(store.index, 'counters.lock');
+    let owned;
+    const deadline = performance.now() + COUNTER_LOCK_WAIT_MS;
+    try {
+        owned = createOwnerCandidate(store, candidate, token);
+        return pollCounterOwnership(devstepsDir, store, candidate, canonical, owned, token, deadline);
+    }
+    catch (error) {
+        if (owned) {
+            try {
+                if (pathExists(candidate))
+                    cleanOwned(store, candidate, owned);
+            }
+            catch {
+                /* Retain unsafe/changed orphan without masking the primary refusal. */
+            }
+        }
+        if (error instanceof CounterLockError)
+            throw error;
+        throw lockError('COUNTER_LOCK_IO', devstepsDir, errorText(error), error);
+    }
+}
+/** Verify the active capability, physical store and complete ownership before each mutation. */
+export function assertCounterLockHeld(context, devstepsDir) {
+    const record = held.get(context);
+    if (!record || resolve(devstepsDir) !== record.store.devstepsDir)
+        throw lockError('COUNTER_LOCK_UNSAFE', devstepsDir, 'Invalid or inactive counter ownership context.');
+    try {
+        verifyOwned(record.store, record.path, record.owned);
+    }
+    catch (error) {
+        throw lockError('COUNTER_LOCK_UNSAFE', devstepsDir, errorText(error), error);
+    }
+}
+/** Release ownership by directory rename; cleanup failure after relinquishing is a warning. */
+export function releaseCounterLock(context, devstepsDir) {
+    const record = held.get(context);
+    if (!record)
+        throw lockError('COUNTER_LOCK_RELEASE_FAILED', devstepsDir, 'Counter ownership context is no longer active.');
+    const retired = join(record.store.index, `.counters-lock.${randomBytes(32).toString('hex')}.retired`);
+    try {
+        assertCounterLockHeld(context, devstepsDir);
+        renameOwned(record.store, record.path, retired, record.owned, performance.now() + COUNTER_LOCK_WAIT_MS);
+        verifyOwned(record.store, retired, record.owned);
+    }
+    catch (error) {
+        held.delete(context);
+        activeStores.delete(record.store.realIndex);
+        throw lockError('COUNTER_LOCK_RELEASE_FAILED', devstepsDir, `Ownership release failed; inspect ${record.path} and ${retired}: ${errorText(error)}`, error);
+    }
+    held.delete(context);
+    activeStores.delete(record.store.realIndex);
+    try {
+        cleanOwned(record.store, retired, record.owned);
+        return [];
+    }
+    catch (error) {
+        return [`Counter ownership was released, but retained ${retired}: ${errorText(error)}`];
+    }
+}
+/** Quiescent administrative recovery only. No counter or claimed item path is changed. */
+export function recoverCounterLock(devstepsDir, options) {
+    if (options?.writersStopped !== true || !/^[0-9a-f]{64}$/.test(options.ownerToken))
+        throw lockError('COUNTER_LOCK_RECOVERY_REFUSED', devstepsDir, 'Recovery requires the exact 64-hex owner token and writersStopped: true.');
+    const lockPath = baseStatus(devstepsDir).lockPath;
+    let store;
+    let expected;
+    try {
+        store = captureStore(devstepsDir);
+        expected = inspectOwned(store, lockPath);
+        if (expected.owner.token !== options.ownerToken)
+            throw new Error('The observed safe owner does not match the supplied token.');
+    }
+    catch (error) {
+        throw lockError('COUNTER_LOCK_RECOVERY_REFUSED', devstepsDir, errorText(error), error);
+    }
+    let quarantine;
+    try {
+        if (expected.owner.token !== options.ownerToken)
+            throw new Error('Counter owner changed before recovery');
+        quarantine = join(store.index, `.counters-lock.${randomBytes(32).toString('hex')}.quarantine`);
+        renameOwned(store, lockPath, quarantine, expected, performance.now() + COUNTER_LOCK_WAIT_MS);
+        verifyOwned(store, quarantine, expected);
+        cleanOwned(store, quarantine, expected);
+        return { recovered: true, ownerToken: options.ownerToken, lockPath };
+    }
+    catch (error) {
+        throw lockError('COUNTER_LOCK_RECOVERY_FAILED', devstepsDir, `Recovery stopped without recursive cleanup; inspect ${quarantine ?? lockPath}: ${errorText(error)}`, error);
+    }
+}
+//# sourceMappingURL=counter-lock.js.map

package/dist/core/counter-lock.js.map

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

package/dist/core/counters.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * ID counters — the one file under `.devsteps/index/` that is a source of truth.
+ *
+ * Every other index is derived from the item files by the item store (STORY-426).
+ * The counters cannot be: an ID handed out for a purged item must never be reused,
+ * so the high-water mark per type prefix is persisted here and committed. What can
+ * be derived is a lower bound — the highest ID on disk — and `add` never allocates
+ * below it, so a counter that fell behind after a branch merge heals itself.
+ */
+import { ItemType } from '../schemas/index.js';
+import { type CounterLockStatus } from './counter-lock-types.js';
+import { claimItemFolder } from './item-paths.js';
+export declare function getCountersPath(devstepsDir: string): string;
+/** Load ID generation counters; an absent file is an empty set of counters. */
+export declare function loadCounters(devstepsDir: string): Record<string, number>;
+export interface CountersUpdateResult {
+    counters: Record<string, number>;
+    changed: boolean;
+    warnings: string[];
+}
+/** Serialize fresh max-merge and atomic replacement across every managed writer. */
+export declare function updateCounters(devstepsDir: string, counters: Record<string, number>): CountersUpdateResult;
+/** Initialization participates in the same monotonic protocol, including existing stores. */
+export declare function initializeCounters(devstepsDir: string, initial?: Record<string, number>): CountersUpdateResult;
+export interface ItemReservationRequest {
+    key: string;
+    type: ItemType;
+}
+export type ReservedItemFolder = ReturnType<typeof claimItemFolder>;
+export interface ItemReservationFailure {
+    phase: 'claim' | 'counters' | 'release' | 'metadata' | 'description';
+    keyToId: Record<string, string>;
+    reservedKeys: string[];
+    failedKey?: string;
+    countersPersisted: boolean;
+    lock?: CounterLockStatus;
+}
+export declare class ItemReservationError extends Error {
+    readonly code = "ITEM_RESERVATION_FAILED";
+    readonly reservation: ItemReservationFailure;
+    constructor(cause: unknown, reservation: ItemReservationFailure);
+}
+export interface ItemReservationResult {
+    claims: Map<string, ReservedItemFolder>;
+    keyToId: Record<string, string>;
+    countersRaised: boolean;
+    warnings: string[];
+}
+/** Fresh floors → actual claims → confirmed counter reservation, in one synchronous lease. */
+export declare function reserveItemFolders(devstepsDir: string, requests: readonly ItemReservationRequest[]): ItemReservationResult;
+/** Highest ID number of one type on disk — live items and archived ones. */
+export declare function highestIdOnDisk(devstepsDir: string, type: ItemType): number;
+/** The counters file as the items on disk imply it — per type prefix, types without items left out. */
+export declare function deriveCounters(devstepsDir: string): Record<string, number>;
+//# sourceMappingURL=counters.d.ts.map

package/dist/core/counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.d.ts","sourceRoot":"","sources":["../../src/core/counters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAU/C,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAEL,eAAe,EAGhB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAiDD,oFAAoF;AACpF,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,oBAAoB,CAyBtB;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,oBAAoB,CAEtB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;CAChB;AACD,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AACpE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AACD,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,YAAY,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAO9D;CACF;AACD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA4CD,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,SAAS,sBAAsB,EAAE,GAC1C,qBAAqB,CAuEvB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAS3E;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E"}