@aiwayds/dsh-tui-pi 2.12.0 → 2.13.0

package/lib/writer-lock.js

@@ -1,206 +0,0 @@
-/**
- * Single-writer guard — a vendored, zero-dependency per-session pid-file
- * lock, byte-for-byte the same contract the feishu plugin's guard uses so
- * both surfaces compete on one file.
- *
- * Why it exists: two dsh processes pointed at the same profile each keep
- * their own agent registry; `agents.get` cannot see the other process's
- * live agent. A cold resume there therefore forks the log: two agents
- * append to one jsonl and the interleaved seq numbers make the loader
- * reject the session ("corrupt session log"). The lock sits NEXT to the
- * log (`<sessionDir>/writer.lock`), derived with the exact path encoding
- * upstream's jsonl backend uses, so every process about to create or
- * cold-resume competes on the same file.
- *
- * Claiming protocol (concurrency-critical):
- * - The payload is written FULLY to `<lock>.tmp-<pid>-<uniq>` first, then
- *   claimed with `link(2)` — atomic at the kernel level, never writable
- *   half-way, so no observer can read an empty/partial lock file.
- * - Two processes that both judge the same residue dead cannot both win:
- *   they race ONE link(); the loser sees EEXIST and re-evaluates against
- *   the WINNER's fresh live pid, then refuses. Stealing (renaming the dead
- *   residue aside) is merely garbage collection of readable history — the
- *   exclusive right is granted by link(), not by who cleared what.
- * - PID reuse can misreport a dead lock as alive; removing such a residual
- *   stays an explicit manual act (delete the file), never automatic.
- */
-import { link, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
-import { randomBytes } from 'node:crypto';
-import { join, resolve } from 'node:path';
-/** Thrown when a cold arm refused to open a second writer for a session. */
-export class WriterLockedError extends Error {
-    holder;
-    constructor(holder) {
-        super(`session is locked by a live process (pid ${holder.pid}`
-            + `${holder.createdAt !== '' ? `, since ${holder.createdAt}` : ''})`
-            + ' — refusing to fork the log');
-        this.name = 'WriterLockedError';
-        this.holder = holder;
-    }
-}
-const LOCK_HOLDER = 'tui';
-/** Contention budget across residue-clearing rounds before giving up loudly. */
-const MAX_CLAIM_ROUNDS = 4;
-/**
- * Dirs where THIS process established (created or stole) the lock. Only an
- * establishing acquisition may release the file: a cooperative re-acquire
- * (same pid already recorded) inherits it without removal rights.
- */
-const established = new Set();
-export function writerLockPath(dir) {
-    return join(dir, 'writer.lock');
-}
-/**
- * Project-directory name under which the jsonl backend groups a cwd's
- * sessions — byte-identical port of upstream `projectKey()` in
- * @deepseek-ai/dsh-session-persistence-jsonl (also mirrored by the feishu
- * plugin's guard). The derived session dir additionally relies on upstream's
- * `encodeSegment(sessionId)` being the IDENTITY for dsh ids — true while ids
- * are UUIDs (safe charset ⊇ UUID charset). If upstream ever introduces
- * non-UUID ids, port encodeSegment too or locks land beside decoy paths;
- * update only in lockstep with upstream either way.
- */
-export function projectKeyFor(cwd) {
-    if (cwd.length === 0)
-        throw new Error('cannot encode an empty project path');
-    let readable = '';
-    let separatorRun = false;
-    for (let i = 0; i < cwd.length; i++) {
-        const code = cwd.charCodeAt(i);
-        const ch = String.fromCharCode(code);
-        if (ch === '/' || ch === '\\' || ch === ':') {
-            if (!separatorRun)
-                readable += '-';
-            separatorRun = true;
-        }
-        else if (ch !== '~' && /^[A-Za-z0-9._-]$/.test(ch)) {
-            readable += ch;
-            separatorRun = false;
-        }
-        else {
-            readable += `~${code.toString(16).toUpperCase().padStart(4, '0')}`;
-            separatorRun = false;
-        }
-    }
-    return `--${(readable.replace(/^-+/, '') || 'root').slice(0, 251)}--`;
-}
-function processAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        // EPERM means the process exists but belongs to another user — alive.
-        return error.code === 'EPERM';
-    }
-}
-async function readHolder(path) {
-    let raw;
-    try {
-        raw = await readFile(path, 'utf8');
-    }
-    catch {
-        return undefined;
-    }
-    try {
-        const parsed = JSON.parse(raw);
-        if (!Number.isInteger(parsed.pid) || parsed.pid <= 0)
-            return undefined;
-        return {
-            pid: parsed.pid,
-            createdAt: typeof parsed.createdAt === 'string' ? parsed.createdAt : '',
-            holder: typeof parsed.holder === 'string' ? parsed.holder : LOCK_HOLDER,
-        };
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Fully write the payload to a private temp file, then CLAIM the lock name
- * with link() — atomic: exactly one contender wins; everyone else gets
- * EEXIST and re-reads whoever actually holds the name. Returns true iff WE
- * claimed it (and thus own its release).
- */
-async function claimFresh(path) {
-    const tmp = `${path}.tmp-${process.pid}-${randomBytes(4).toString('hex')}`;
-    await writeFile(tmp, JSON.stringify({
-        pid: process.pid,
-        createdAt: new Date().toISOString(),
-        holder: LOCK_HOLDER,
-    }));
-    try {
-        try {
-            await link(tmp, path);
-            return true;
-        }
-        catch (error) {
-            if (error.code === 'EEXIST')
-                return false;
-            throw error;
-        }
-    }
-    finally {
-        await unlink(tmp).catch(() => { });
-    }
-}
-async function clearResidue(path) {
-    try {
-        await rename(path, `${path}.stale-${Date.now()}-${randomBytes(3).toString('hex')}`);
-    }
-    catch (error) {
-        // Another contender cleared (or replaced) it already — harmless; the
-        // caller simply loops and re-reads the CURRENT state of the name.
-        if (error.code !== 'ENOENT')
-            throw error;
-    }
-}
-/**
- * Acquire the single-writer lock for `dir`. Fresh creation or a cleared
- * residue establishes ownership (releasable later); a same-pid token is a
- * cooperative re-acquire — success WITHOUT rewriting the existing file and
- * without release rights. A lock held by another LIVE process refuses with
- * its holder info.
- */
-export async function acquireWriterLock(dir) {
-    await mkdir(dir, { recursive: true });
-    const path = writerLockPath(dir);
-    for (let round = 0; round < MAX_CLAIM_ROUNDS; round++) {
-        if (await claimFresh(path)) {
-            established.add(resolve(dir));
-            return { ok: true };
-        }
-        const holder = await readHolder(path);
-        if (holder !== undefined && holder.pid === process.pid) {
-            // Cooperative re-acquire: inherit, do not rewrite, never releasable.
-            return { ok: true };
-        }
-        if (holder !== undefined && processAlive(holder.pid)) {
-            return { ok: false, holder };
-        }
-        // Dead-or-corrupt-or-raced-away holder: collect the residue and re-try
-        // the atomic claim; any live winner introduced meanwhile is re-read and
-        // respected on the next round.
-        await clearResidue(path);
-    }
-    fail(`writer.lock contention did not settle after ${MAX_CLAIM_ROUNDS} rounds: ${path}`);
-}
-function fail(message) {
-    throw new Error(message);
-}
-/**
- * Release the lock on `dir`, but ONLY when this process established it.
- * A cooperative/inherited token — or a dir we never touched — is untouched.
- */
-export async function releaseOwnedWriterLock(dir) {
-    const key = resolve(dir);
-    if (!established.delete(key))
-        return;
-    try {
-        await unlink(writerLockPath(dir));
-    }
-    catch {
-        // Already gone (or raced away) — nothing left to clean.
-    }
-}
-//# sourceMappingURL=writer-lock.js.map

package/lib/writer-lock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"writer-lock.js","sourceRoot":"","sources":["../src/writer-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAezC,4EAA4E;AAC5E,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAkB;IAEjC,YAAY,MAAwB;QAClC,KAAK,CACH,4CAA4C,MAAM,CAAC,GAAG,EAAE;cACtD,GAAG,MAAM,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;cAClE,6BAA6B,CAChC,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,MAAM,WAAW,GAAG,KAAK,CAAA;AACzB,gFAAgF;AAChF,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAE1B;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;AAErC,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IAC5E,IAAI,QAAQ,GAAG,EAAE,CAAA;IACjB,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC5C,IAAI,CAAC,YAAY;gBAAE,QAAQ,IAAI,GAAG,CAAA;YAClC,YAAY,GAAG,IAAI,CAAA;QACrB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrD,QAAQ,IAAI,EAAE,CAAA;YACd,YAAY,GAAG,KAAK,CAAA;QACtB,CAAC;aAAM,CAAC;YACN,QAAQ,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;YAClE,YAAY,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAA;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sEAAsE;QACtE,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAA;IAC1D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,GAAW,CAAA;IACf,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA8B,CAAA;QAC3D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAK,MAAM,CAAC,GAAc,IAAI,CAAC;YAAE,OAAO,SAAS,CAAA;QAClF,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,GAAa;YACzB,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;YACvE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW;SACxE,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAA;IAC1E,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,WAAW;KACO,CAAC,CAAC,CAAA;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACrB,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAA;YACpE,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACnC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qEAAqE;QACrE,kEAAkE;QAClE,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAA;IACrE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,gBAAgB,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;YACvD,qEAAqE;YACrE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrB,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;QAC9B,CAAC;QACD,uEAAuE;QACvE,wEAAwE;QACxE,+BAA+B;QAC/B,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IACD,IAAI,CAAC,+CAA+C,gBAAgB,YAAY,IAAI,EAAE,CAAC,CAAA;AACzF,CAAC;AAED,SAAS,IAAI,CAAC,OAAe;IAC3B,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAW;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,OAAM;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;AACH,CAAC"}