teamshare-bridge 0.11.0 → 0.11.2

package/dist/lib/workspace/classify.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Command classification (IMP-950): decides how intrusive a shell command
+ * is before anyone runs it. One table feeds BOTH arbitration layers:
+ *   - bridge-owned spawns (orchestrator runner) arbitrate in-process;
+ *   - PATH shims consult this via the arbiter's acquire endpoint.
+ *
+ * Philosophy: known-mutating commands are exclusive; known-read-only are
+ * shared; long-lived dev servers take a shared hold for their lifetime so
+ * an exclusive seeker can SEE them (and ping) without being blocked forever;
+ * everything else passes through untouched - fail-open beats bricking.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyCommand = classifyCommand;
+const BUILD_SCRIPTS = new Set([
+    'build', 'compile', 'dist', 'package', 'generate', 'gen', 'prisma',
+    'migrate', 'seed', 'db:', 'prepare', 'prepack', 'postinstall', 'clean',
+]);
+const CHECK_SCRIPTS = new Set([
+    'test', 't', 'lint', 'typecheck', 'type-check', 'check', 'spec', 'cover',
+]);
+const SERVE_SCRIPTS = new Set(['dev', 'start', 'serve', 'preview', 'watch']);
+/** git subcommands that rewrite working tree / branch state. */
+const GIT_EXCLUSIVE = new Set([
+    'checkout', 'switch', 'reset', 'clean', 'rebase', 'merge', 'cherry-pick',
+    'revert', 'worktree', 'apply', 'restore', 'bisect', 'init', 'clone',
+    'am', 'gc', 'filter-branch', 'submodule',
+]);
+/** git subcommands safe to run concurrently (index.lock serializes writes). */
+const GIT_SHARED = new Set([
+    'status', 'diff', 'log', 'show', 'branch', 'add', 'commit', 'tag',
+    'notes', 'fetch', 'ls-files', 'rev-parse', 'describe', 'stash', 'push',
+]);
+function base(commandLine) {
+    const parts = commandLine.trim().split(/\s+/);
+    const rawBin = (parts.shift() ?? '').toLowerCase();
+    // Strip path prefixes and Windows extensions: C:\x\npm.CMD -> npm
+    const bin = rawBin.split(/[\\/]/).pop().replace(/\.(exe|cmd|bat|ps1)$/i, '');
+    return { bin, rest: parts.filter((p) => p !== '') };
+}
+function scriptName(rest) {
+    const flagSkip = /^(--|-)/;
+    for (const p of rest)
+        if (!flagSkip.test(p))
+            return p.toLowerCase();
+    return '';
+}
+/**
+ * Classify a full command line. Never throws - unknown input is
+ * passthrough.
+ */
+function classifyCommand(commandLine) {
+    try {
+        const { bin, rest } = base(commandLine);
+        switch (bin) {
+            case 'npm':
+            case 'pnpm':
+            case 'yarn':
+            case 'bun':
+            case 'bunx':
+                return classifyPackageManager(bin, rest);
+            case 'npx':
+                return classifyNpx(rest);
+            case 'prisma':
+                return classifyPrisma(rest);
+            case 'git':
+                return classifyGit(rest);
+            case 'tsc': {
+                const noEmit = rest.some((a) => a === '--noEmit' || a.startsWith('--noEmit'));
+                return noEmit
+                    ? { cls: 'shared', label: 'tsc --noEmit' }
+                    : { cls: 'exclusive', label: 'tsc (emit)' };
+            }
+            case 'eslint':
+            case 'prettier':
+            case 'biome':
+                return { cls: 'shared', label: bin };
+            case 'jest':
+            case 'vitest':
+            case 'mocha':
+            case 'pytest':
+                return { cls: 'shared', label: bin };
+            case 'pip':
+            case 'pip3': {
+                const sub = (rest[0] ?? '').toLowerCase();
+                if (sub === 'install' || sub === 'uninstall') {
+                    return { cls: 'exclusive', label: `${bin} ${sub}`, global: ['pip-install'] };
+                }
+                return { cls: 'passthrough', label: commandLine.slice(0, 60) };
+            }
+            default:
+                // node/python/echo/... : too broad to guard meaningfully - pass.
+                return { cls: 'passthrough', label: commandLine.slice(0, 60) };
+        }
+    }
+    catch {
+        return { cls: 'passthrough', label: String(commandLine).slice(0, 60) };
+    }
+}
+function classifyPackageManager(bin, rest) {
+    const sub = (rest[0] ?? '').toLowerCase().replace(/^:/, '');
+    const args = rest.slice(1);
+    switch (sub) {
+        case 'install':
+        case 'i':
+        case 'add':
+        case 'ci':
+        case 'update':
+        case 'upgrade':
+        case 'remove':
+        case 'uninstall':
+        case 'rm':
+        case 'dedupe':
+        case 'rebuild':
+        case 'link':
+        case 'unlink':
+        case 'pack':
+        case 'publish':
+            return { cls: 'exclusive', label: `${bin} ${rest[0]}` };
+        case 'run':
+        case 'run-script':
+        case 'exec':
+        case 'x': {
+            const name = scriptName(args);
+            if (!name)
+                return { cls: 'exclusive', label: `${bin} ${sub}` };
+            if (SERVE_SCRIPTS.has(name))
+                return { cls: 'long-shared', label: `${bin} run ${name}` };
+            if (CHECK_SCRIPTS.has(name) || name.startsWith('test')) {
+                return { cls: 'shared', label: `${bin} run ${name}` };
+            }
+            if (name.startsWith('db:') || name.includes('migrat') || name.includes('generat')) {
+                return { cls: 'exclusive', label: `${bin} run ${name}`, global: ['prisma-generate'] };
+            }
+            // Unknown/custom scripts may emit or mutate anything - be safe.
+            return { cls: 'exclusive', label: `${bin} run ${name}` };
+        }
+        case 'test':
+        case 'lint':
+            return { cls: 'shared', label: `${bin} ${sub}` };
+        case 'start':
+        case 'dev':
+            return { cls: 'long-shared', label: `${bin} ${sub}` };
+        case 'workspaces':
+        case 'ws':
+            return { cls: 'exclusive', label: `${bin} workspaces` };
+        default:
+            // init/cache/config/binary shortcuts etc. - assume mutation-capable.
+            return { cls: 'exclusive', label: `${bin} ${sub || '(default)'}`.trim() };
+    }
+}
+function classifyNpx(rest) {
+    const target = scriptName(rest);
+    if (target === 'prisma') {
+        const inner = classifyPrisma(rest.slice(rest.indexOf('prisma') + 1));
+        return { ...inner, global: inner.global ?? (inner.cls === 'exclusive' ? ['prisma-generate'] : undefined), label: `npx ${inner.label}` };
+    }
+    if (['tsc', 'eslint', 'jest', 'vitest', 'mocha'].includes(target)) {
+        return { cls: 'shared', label: `npx ${target}` };
+    }
+    // Unknown npx target may install + run anything.
+    return { cls: 'exclusive', label: `npx ${target || '(default)'}`.trim() };
+}
+function classifyPrisma(rest) {
+    const sub = (rest[0] ?? '').toLowerCase();
+    const mutating = sub === 'generate' ||
+        sub.startsWith('migrate') ||
+        sub === 'db' ||
+        sub === 'pull' ||
+        sub === 'push' ||
+        sub === 'studio' ||
+        sub === 'format';
+    if (!mutating)
+        return { cls: 'passthrough', label: `prisma ${sub}`.trim() };
+    // generate/migrate load the native query engine - serialize machine-wide
+    // (documented gotcha: two generates deadlock on the engine DLL).
+    const needsGlobal = sub === 'generate' || sub.startsWith('migrate');
+    return {
+        cls: 'exclusive',
+        label: `prisma ${sub}`,
+        ...(needsGlobal ? { global: ['prisma-generate'] } : {}),
+    };
+}
+function classifyGit(rest) {
+    const sub = (rest[0] ?? '').toLowerCase();
+    if (GIT_EXCLUSIVE.has(sub))
+        return { cls: 'exclusive', label: `git ${sub}` };
+    if (GIT_SHARED.has(sub)) {
+        // stash pop/apply mutates tree+index like checkout would.
+        if (sub === 'stash' && rest[1] && !['list', 'show'].includes((rest[1] ?? '').toLowerCase())) {
+            return { cls: 'exclusive', label: 'git stash pop' };
+        }
+        return { cls: 'shared', label: `git ${sub}` };
+    }
+    return { cls: 'passthrough', label: `git ${sub}`.trim() };
+}
+//# sourceMappingURL=classify.js.map

package/dist/lib/workspace/classify.js.map

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

package/dist/lib/workspace/presence.d.ts

@@ -0,0 +1,26 @@
+/** A crashed session disappears from "who is here" after 10 minutes. */
+export declare const PRESENCE_TTL_MS: number;
+export interface PresenceEntry {
+    pid: number;
+    startedAt: string;
+    updatedAt?: string;
+    agentId?: string;
+    kind?: string;
+    taskId?: string;
+    projectId?: string;
+}
+/** Live occupants of `path`, oldest first. */
+export declare function listPresent(path: string): PresenceEntry[];
+/**
+ * Register (or heartbeat-refresh) THIS process in the folder. Deduped by
+ * pid - calling it again just refreshes timestamps.
+ */
+export declare function registerPresence(path: string, info?: Omit<PresenceEntry, 'pid' | 'startedAt' | 'updatedAt'>): void;
+/** Remove THIS process from the folder's registry. */
+export declare function unregisterPresence(path: string): void;
+/**
+ * True when at least one OTHER live process occupies the folder. Used by
+ * the daemon's auto-worktree escalation ("second agent showed up") and by
+ * status endpoints.
+ */
+export declare function hasOtherOccupants(path: string, excludePid?: number): boolean;

package/dist/lib/workspace/presence.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRESENCE_TTL_MS = void 0;
+exports.listPresent = listPresent;
+exports.registerPresence = registerPresence;
+exports.unregisterPresence = unregisterPresence;
+exports.hasOtherOccupants = hasOtherOccupants;
+/**
+ * Presence registry (IMP-950): who is working WHERE right now.
+ *
+ * Complements repo-lock: locks guard a single intrusive command; presence
+ * answers "is another agent occupying this folder at all" - which is what
+ * auto-worktree escalation and /arbitrate/status need.
+ *
+ * One JSON file per directory scope, array of entries. Each session
+ * registers on start, heartbeats are implicit (staleness = dead pid or
+ * older than PRESENCE_TTL_MS), and the entry is removed on exit via the
+ * same finally blocks that release the per-agent lock. Cross-process by
+ * design; every call is best-effort - presence must never break a session.
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const repo_lock_1 = require("./repo-lock");
+const PRESENCE_ROOT = process.env.TS_PRESENCE_ROOT && process.env.TS_PRESENCE_ROOT.trim()
+    ? process.env.TS_PRESENCE_ROOT
+    : (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'presence');
+/** A crashed session disappears from "who is here" after 10 minutes. */
+exports.PRESENCE_TTL_MS = 10 * 60_000;
+function presenceFile(path) {
+    return (0, node_path_1.join)(PRESENCE_ROOT, `${(0, repo_lock_1.scopeKey)({ kind: 'dir', path })}.json`);
+}
+function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+function readEntries(path) {
+    const file = presenceFile(path);
+    try {
+        const raw = JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+        if (!Array.isArray(raw))
+            return [];
+        return raw.filter((e) => e && typeof e.pid === 'number').map((e) => ({ ...e, file }));
+    }
+    catch {
+        return [];
+    }
+}
+function writeEntries(path, entries) {
+    (0, node_fs_1.mkdirSync)(PRESENCE_ROOT, { recursive: true });
+    if (entries.length === 0) {
+        try {
+            (0, node_fs_1.rmSync)(presenceFile(path), { force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+        return;
+    }
+    try {
+        (0, node_fs_1.writeFileSync)(presenceFile(path), JSON.stringify(entries, null, 2), 'utf8');
+    }
+    catch {
+        /* best-effort */
+    }
+}
+function isLive(entry) {
+    if (!pidAlive(entry.pid))
+        return false;
+    const ref = entry.updatedAt ?? entry.startedAt;
+    const age = Date.now() - new Date(ref).getTime();
+    return Number.isFinite(age) && age <= exports.PRESENCE_TTL_MS;
+}
+/** Live occupants of `path`, oldest first. */
+function listPresent(path) {
+    return readEntries(path)
+        .filter(isLive)
+        .map(({ file: _file, ...entry }) => entry);
+}
+/**
+ * Register (or heartbeat-refresh) THIS process in the folder. Deduped by
+ * pid - calling it again just refreshes timestamps.
+ */
+function registerPresence(path, info = {}) {
+    try {
+        const canonical = (0, repo_lock_1.canonicalDir)(path);
+        const others = readEntries(canonical).filter((e) => e.pid !== process.pid);
+        const mine = readEntries(canonical).find((e) => e.pid === process.pid);
+        const now = new Date().toISOString();
+        const entry = {
+            pid: process.pid,
+            startedAt: mine?.startedAt ?? now,
+            updatedAt: now,
+            ...info,
+        };
+        // Write against the canonical spelling so lookups agree regardless of
+        // how the caller spelled the path.
+        writeEntries(canonical, [...others, entry]);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/** Remove THIS process from the folder's registry. */
+function unregisterPresence(path) {
+    try {
+        const canonical = (0, repo_lock_1.canonicalDir)(path);
+        const remaining = readEntries(canonical).filter((e) => e.pid !== process.pid);
+        writeEntries(canonical, remaining.map(({ file: _f, ...e }) => e));
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/**
+ * True when at least one OTHER live process occupies the folder. Used by
+ * the daemon's auto-worktree escalation ("second agent showed up") and by
+ * status endpoints.
+ */
+function hasOtherOccupants(path, excludePid = process.pid) {
+    return readEntries(path).some((e) => e.pid !== excludePid && isLive(e));
+}
+//# sourceMappingURL=presence.js.map

package/dist/lib/workspace/presence.js.map

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

package/dist/lib/workspace/repo-lock.d.ts

@@ -0,0 +1,90 @@
+export type WsMode = 'shared' | 'exclusive';
+export type WsScope = {
+    kind: 'dir';
+    path: string;
+} | {
+    kind: 'global';
+    name: string;
+};
+export interface WsHolderInfo {
+    /** Agent id when known ("manual" for bare CLI use). */
+    agentId?: string;
+    kind?: string;
+    taskId?: string;
+    projectId?: string;
+    /** Free-text reason shown in pings ("npm install", "git finalize"). */
+    label?: string;
+}
+export interface WsHandle {
+    scope: WsScope;
+    mode: WsMode;
+    file: string;
+    pid: number;
+    startedAt: string;
+}
+export interface WsHolder {
+    pid: number;
+    mode: WsMode;
+    startedAt: string;
+    holder: WsHolderInfo;
+    /** Absolute path of the holder file (purge/release needs it). */
+    file: string;
+    stale: boolean;
+}
+/** Comfortably above any real build/install; crashed holders die by pid check anyway. */
+export declare const WS_MAX_HOLD_MS: number;
+export declare const ARBITRATION_LOG: string;
+/** Canonical, case-folded identity of a working directory (win32-safe). */
+export declare function canonicalDir(path: string): string;
+export declare function scopeKey(scope: WsScope): string;
+/** True when `file` lives inside the managed lock tree (release guard). */
+export declare function isInsideLockRoot(file: string): boolean;
+/** Live + stale holders for a scope (stale ones still listed for pings). */
+export declare function readWsHolders(scope: WsScope): WsHolder[];
+/** Holders by precomputed scope key (status endpoints scan the tree). */
+export declare function readWsHoldersByKey(key: string): WsHolder[];
+export type AcquireResult = {
+    ok: true;
+    handle: WsHandle;
+} | {
+    ok: false;
+    reason: 'busy';
+    holders: WsHolder[];
+} | {
+    ok: false;
+    reason: 'reentrant-conflict';
+    holders: WsHolder[];
+};
+/**
+ * One-shot acquire. Exclusive requires an EMPTY live-holder set; shared
+ * requires no live EXCLUSIVE holder. Same-pid same-mode is re-entrant
+ * (returns the registered handle); same-pid cross-mode refuses rather than
+ * corrupting state.
+ */
+export declare function tryAcquireWsLock(scope: WsScope, mode: WsMode, info?: WsHolderInfo): AcquireResult;
+/**
+ * Wait until the scope admits `mode`, then hold it. Returns null on
+ * deadline. `onWaiting` fires once per poll cycle while blocked (used to
+ * emit bus pings + console notes exactly like ../lock.ts).
+ */
+export declare function acquireWsLock(scope: WsScope, mode: WsMode, info?: WsHolderInfo, opts?: {
+    waitMs?: number;
+    pollMs?: number;
+    onWaiting?: (holders: WsHolder[]) => void;
+}): Promise<WsHandle | null>;
+/** Release a handle this process owns (no-op otherwise). */
+export declare function releaseWsLock(handle: WsHandle | null | undefined): void;
+/** Release every handle this process still holds (crash/exit safety net). */
+export declare function releaseAllWsLocks(): void;
+/** Run `fn` under the lock; always releases, even on throw. */
+export declare function withWsLock<T>(scope: WsScope, mode: WsMode, info: WsHolderInfo, fn: () => Promise<T>, opts?: {
+    waitMs?: number;
+    pollMs?: number;
+    onWaiting?: (h: WsHolder[]) => void;
+}): Promise<T | null>;
+/** Append-only human-readable trail (best-effort, size-capped). */
+export declare function logArbitration(line: string): void;
+/** Temp helper used by tests/E2E to fabricate a stale holder. */
+export declare function __writeForeignHolder(scope: WsScope, mode: WsMode, pid: number, ageMs?: number): string;
+/** Isolated root override for tests (never called in production paths). */
+export declare function __setLockRootForTests(dir?: string): void;