nawabari 0.1.0

package/dist/git.js

@@ -0,0 +1,157 @@
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { SessionRegistryError } from "./errors.js";
+export const defaultGit = {
+    run(args, cwd) {
+        try {
+            return execFileSync("git", [...args], {
+                cwd,
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "pipe"],
+                timeout: 10_000,
+                env: {
+                    ...process.env,
+                    GIT_TERMINAL_PROMPT: "0",
+                    GIT_OPTIONAL_LOCKS: "0",
+                },
+            }).trim();
+        }
+        catch (error) {
+            throw new SessionRegistryError("GIT_COMMAND_FAILED", `git ${args.join(" ")} failed in ${cwd}`, { command: args.join(" "), cwd }, error);
+        }
+    },
+};
+export function resolveRepositoryContext(options = {}) {
+    const cwd = canonicalDirectory(options.cwd ?? process.cwd(), "REPOSITORY_IDENTITY_AMBIGUOUS");
+    const git = options.git ?? defaultGit;
+    let worktreePath;
+    let commonGitDirectory;
+    try {
+        worktreePath = canonicalDirectory(git.run(["rev-parse", "--show-toplevel"], cwd), "REPOSITORY_IDENTITY_AMBIGUOUS");
+        const commonGitDirectoryOutput = git.run(["rev-parse", "--git-common-dir"], cwd);
+        const commonGitDirectoryPath = path.isAbsolute(commonGitDirectoryOutput)
+            ? commonGitDirectoryOutput
+            : path.resolve(cwd, commonGitDirectoryOutput);
+        commonGitDirectory = canonicalDirectory(commonGitDirectoryPath, "REPOSITORY_IDENTITY_AMBIGUOUS");
+    }
+    catch (error) {
+        if (error instanceof SessionRegistryError && error.code === "REPOSITORY_IDENTITY_AMBIGUOUS") {
+            throw error;
+        }
+        throw new SessionRegistryError("NOT_A_GIT_REPOSITORY", `Could not resolve a repository from ${cwd}`, { cwd }, error);
+    }
+    return Object.freeze({
+        repositoryId: commonGitDirectory,
+        commonGitDirectory,
+        worktreePath,
+    });
+}
+export function resolveWorktreeIdentity(options = {}) {
+    const repository = options.repository ?? resolveRepositoryContext(options);
+    const git = options.git ?? defaultGit;
+    const branchName = options.branchName ?? readCurrentBranch(git, repository.worktreePath);
+    const branchId = normalizeBranchId(branchName);
+    return Object.freeze({
+        worktreeId: repository.worktreePath,
+        worktreePath: repository.worktreePath,
+        branchId,
+        branchName: branchId.slice("refs/heads/".length),
+    });
+}
+/** Read the repository's local worktree inventory without consulting a remote. */
+export function listGitWorktrees(git, cwd) {
+    const output = git.run(["worktree", "list", "--porcelain"], cwd);
+    const entries = [];
+    let currentPath;
+    let currentBranch = null;
+    const flush = () => {
+        if (currentPath === undefined)
+            return;
+        entries.push(Object.freeze({ worktreePath: canonicalListedPath(currentPath), branchName: currentBranch }));
+        currentPath = undefined;
+        currentBranch = null;
+    };
+    for (const line of output.split(/\r?\n/u)) {
+        if (line.startsWith("worktree ")) {
+            flush();
+            currentPath = line.slice("worktree ".length);
+            continue;
+        }
+        if (line.startsWith("branch ")) {
+            const branchId = line.slice("branch ".length);
+            if (branchId.startsWith("refs/heads/")) {
+                currentBranch = branchId.slice("refs/heads/".length);
+            }
+        }
+    }
+    flush();
+    return entries;
+}
+export function normalizeBranchId(branchName) {
+    const trimmed = branchName.trim();
+    if (trimmed !== branchName) {
+        throw new SessionRegistryError("INVALID_BRANCH_ID", `Invalid branch identity: ${branchName}`, { branchName });
+    }
+    if (trimmed.startsWith("refs/") && !trimmed.startsWith("refs/heads/")) {
+        throw new SessionRegistryError("INVALID_BRANCH_ID", `Invalid local branch identity: ${branchName}`, { branchName });
+    }
+    const normalized = trimmed.startsWith("refs/heads/") ? trimmed : `refs/heads/${trimmed}`;
+    const shortName = normalized.slice("refs/heads/".length);
+    const components = shortName.split("/");
+    if (shortName.length === 0 ||
+        shortName.startsWith("/") ||
+        shortName.endsWith("/") ||
+        shortName.includes("..") ||
+        shortName === "@" ||
+        shortName.includes("@{") ||
+        shortName.endsWith(".") ||
+        shortName.endsWith(".lock") ||
+        components.some((component) => component.startsWith(".") || component.endsWith(".") || component.endsWith(".lock")) ||
+        shortName.includes("//") ||
+        /[\u0000-\u0020~^:?*[\\]/u.test(shortName)) {
+        throw new SessionRegistryError("INVALID_BRANCH_ID", `Invalid branch identity: ${branchName}`, { branchName });
+    }
+    return normalized;
+}
+function canonicalListedPath(candidate) {
+    const resolved = path.resolve(candidate);
+    try {
+        return fs.realpathSync.native(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+export function readCurrentBranch(git, cwd) {
+    try {
+        const branchName = git.run(["symbolic-ref", "--quiet", "--short", "HEAD"], cwd);
+        if (branchName.length === 0) {
+            throw new SessionRegistryError("WORKTREE_IDENTITY_AMBIGUOUS", `The worktree at ${cwd} has no branch`, { cwd });
+        }
+        return branchName;
+    }
+    catch (error) {
+        if (error instanceof SessionRegistryError && error.code === "WORKTREE_IDENTITY_AMBIGUOUS") {
+            throw error;
+        }
+        throw new SessionRegistryError("WORKTREE_IDENTITY_AMBIGUOUS", `Could not resolve the current branch for ${cwd}`, { cwd }, error);
+    }
+}
+function canonicalDirectory(candidate, errorCode) {
+    if (candidate.trim().length === 0) {
+        throw new SessionRegistryError(errorCode, "Git returned an empty directory identity");
+    }
+    const resolved = path.resolve(candidate);
+    try {
+        const stat = fs.statSync(resolved);
+        if (!stat.isDirectory()) {
+            throw new Error("path is not a directory");
+        }
+        return fs.realpathSync.native(resolved);
+    }
+    catch (error) {
+        throw new SessionRegistryError(errorCode, `Could not resolve directory identity: ${resolved}`, { path: resolved }, error);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { runCli } from "./cli.js";
+runCli(process.argv.slice(2)).then((exitCode) => {
+    process.exitCode = exitCode;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;IAC9C,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/presentation.d.ts

@@ -0,0 +1,9 @@
+import { DomainError, type JsonObject } from "./domain/errors.js";
+export type CliMode = "human" | "json";
+export type CliIO = {
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+};
+export declare function defaultCliIO(): CliIO;
+export declare function renderSuccess(mode: CliMode, command: string, payload: JsonObject): string;
+export declare function renderFailure(mode: CliMode, command: string, error: DomainError): string;

package/dist/presentation.js

@@ -0,0 +1,61 @@
+export function defaultCliIO() {
+    return {
+        stdout: (line) => console.log(line),
+        stderr: (line) => console.error(line),
+    };
+}
+function jsonSuccess(command, payload) {
+    return JSON.stringify({ ok: true, command, ...payload });
+}
+function jsonFailure(command, error) {
+    const response = {
+        ok: false,
+        command,
+        code: error.code,
+        message: error.message,
+    };
+    if (error.details !== null) {
+        if (typeof error.details.allowed === "boolean")
+            response.allowed = error.details.allowed;
+        response.details = error.details;
+    }
+    return JSON.stringify(response);
+}
+function formatValue(value) {
+    if (typeof value === "string")
+        return value;
+    return JSON.stringify(value);
+}
+function humanSuccess(command, payload) {
+    if (Object.keys(payload).length === 0)
+        return `${command}: ok`;
+    const lines = [`${command}: ok`];
+    for (const [key, value] of Object.entries(payload)) {
+        if (key === "checks" && Array.isArray(value)) {
+            for (const item of value) {
+                if (typeof item === "object" && item !== null && !Array.isArray(item) && "name" in item && "status" in item) {
+                    const name = item.name;
+                    const status = item.status;
+                    if (typeof name === "string" && typeof status === "string")
+                        lines.push(`  ${name}: ${status}`);
+                }
+            }
+            continue;
+        }
+        lines.push(`  ${key}: ${formatValue(value)}`);
+    }
+    return lines.join("\n");
+}
+function humanFailure(command, error) {
+    const lines = [`${command}: rejected`, `  code: ${error.code}`, `  message: ${error.message}`];
+    if (error.details !== null)
+        lines.push(`  details: ${JSON.stringify(error.details)}`);
+    return lines.join("\n");
+}
+export function renderSuccess(mode, command, payload) {
+    return mode === "json" ? jsonSuccess(command, payload) : humanSuccess(command, payload);
+}
+export function renderFailure(mode, command, error) {
+    return mode === "json" ? jsonFailure(command, error) : humanFailure(command, error);
+}
+//# sourceMappingURL=presentation.js.map

package/dist/presentation.js.map

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

package/dist/registry/atomic.d.ts

@@ -0,0 +1,20 @@
+export interface AtomicWritePaths {
+    temporaryPath: string;
+    targetPath: string;
+}
+export interface AtomicWriteHooks {
+    beforeRename?: (paths: AtomicWritePaths) => void | Promise<void>;
+    afterRename?: (paths: AtomicWritePaths) => void | Promise<void>;
+}
+export interface AtomicWriteOptions {
+    ensureParent?: boolean;
+    hooks?: AtomicWriteHooks;
+}
+/**
+ * Persist JSON by writing and syncing a same-directory temporary file, then
+ * replacing the target with rename. Readers therefore observe either the
+ * previous complete document or the next complete document.
+ */
+export declare function writeJsonAtomically(targetPath: string, value: unknown, options?: AtomicWriteOptions): Promise<void>;
+/** Synchronous counterpart used by the legacy synchronous registry boundary. */
+export declare function writeJsonAtomicallySync(targetPath: string, value: unknown, options?: Pick<AtomicWriteOptions, "ensureParent">): void;

package/dist/registry/atomic.js

@@ -0,0 +1,128 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import { open, mkdir, rename, rm } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { RegistryError } from "./errors.js";
+function errorCode(error) {
+    if (!(error instanceof Error) || !("code" in error)) {
+        return undefined;
+    }
+    const code = error.code;
+    return typeof code === "string" ? code : undefined;
+}
+function isUnsupportedDirectorySync(error) {
+    const code = errorCode(error);
+    return code === "EINVAL" || code === "ENOTSUP" || code === "EISDIR";
+}
+async function syncDirectory(directory) {
+    let handle;
+    try {
+        handle = await open(directory, "r");
+        await handle.sync();
+    }
+    catch (error) {
+        if (!isUnsupportedDirectorySync(error)) {
+            throw error;
+        }
+    }
+    finally {
+        if (handle !== undefined) {
+            await handle.close();
+        }
+    }
+}
+function syncDirectorySync(directory) {
+    let descriptor;
+    try {
+        descriptor = fs.openSync(directory, "r");
+        fs.fsyncSync(descriptor);
+    }
+    catch (error) {
+        if (!isUnsupportedDirectorySync(error)) {
+            throw error;
+        }
+    }
+    finally {
+        if (descriptor !== undefined) {
+            fs.closeSync(descriptor);
+        }
+    }
+}
+/**
+ * Persist JSON by writing and syncing a same-directory temporary file, then
+ * replacing the target with rename. Readers therefore observe either the
+ * previous complete document or the next complete document.
+ */
+export async function writeJsonAtomically(targetPath, value, options = {}) {
+    const directory = dirname(targetPath);
+    if (options.ensureParent !== false) {
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+    }
+    const temporaryPath = join(directory, `.${basename(targetPath)}.${process.pid}.${randomUUID()}.tmp`);
+    const serialized = JSON.stringify(value, null, 2);
+    if (serialized === undefined) {
+        throw new RegistryError("REGISTRY_IO_ERROR", "Cannot serialize registry state", {
+            targetPath,
+        });
+    }
+    let handle;
+    let renamed = false;
+    try {
+        handle = await open(temporaryPath, "wx", 0o600);
+        await handle.writeFile(`${serialized}\n`, "utf8");
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        const paths = { temporaryPath, targetPath };
+        await options.hooks?.beforeRename?.(paths);
+        await rename(temporaryPath, targetPath);
+        renamed = true;
+        await syncDirectory(directory);
+        await options.hooks?.afterRename?.(paths);
+    }
+    catch (error) {
+        if (handle !== undefined) {
+            await handle.close();
+        }
+        if (!renamed) {
+            await rm(temporaryPath, { force: true });
+        }
+        throw error;
+    }
+}
+/** Synchronous counterpart used by the legacy synchronous registry boundary. */
+export function writeJsonAtomicallySync(targetPath, value, options = {}) {
+    const directory = dirname(targetPath);
+    if (options.ensureParent !== false) {
+        fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    }
+    const temporaryPath = join(directory, `.${basename(targetPath)}.${process.pid}.${randomUUID()}.tmp`);
+    const serialized = JSON.stringify(value, null, 2);
+    if (serialized === undefined) {
+        throw new RegistryError("REGISTRY_IO_ERROR", "Cannot serialize registry state", {
+            targetPath,
+        });
+    }
+    let descriptor;
+    let renamed = false;
+    try {
+        descriptor = fs.openSync(temporaryPath, "wx", 0o600);
+        fs.writeFileSync(descriptor, `${serialized}\n`, "utf8");
+        fs.fsyncSync(descriptor);
+        fs.closeSync(descriptor);
+        descriptor = undefined;
+        fs.renameSync(temporaryPath, targetPath);
+        renamed = true;
+        syncDirectorySync(directory);
+    }
+    catch (error) {
+        if (descriptor !== undefined) {
+            fs.closeSync(descriptor);
+        }
+        if (!renamed) {
+            fs.rmSync(temporaryPath, { force: true });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/registry/atomic.js.map

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

package/dist/registry/errors.d.ts

@@ -0,0 +1,8 @@
+export declare const REGISTRY_ERROR_CODES: readonly ["REGISTRY_NOT_FOUND", "REGISTRY_CORRUPT", "REGISTRY_UNSUPPORTED_SCHEMA", "REGISTRY_REPOSITORY_MISMATCH", "REGISTRY_DUPLICATE_SESSION", "REGISTRY_DUPLICATE_WORKTREE", "REGISTRY_DUPLICATE_BRANCH", "REGISTRY_IO_ERROR", "REGISTRY_MUTATION_FAILED", "LOCK_BUSY", "LOCK_STALE", "LOCK_INVALID", "LOCK_IO_ERROR", "LOCK_RELEASE_FAILED"];
+export type RegistryErrorCode = (typeof REGISTRY_ERROR_CODES)[number];
+export declare class RegistryError extends Error {
+    readonly code: RegistryErrorCode;
+    readonly details: Readonly<Record<string, unknown>>;
+    constructor(code: RegistryErrorCode, message: string, details?: Readonly<Record<string, unknown>>, options?: ErrorOptions);
+}
+export declare function isRegistryError(error: unknown): error is RegistryError;

package/dist/registry/errors.js

@@ -0,0 +1,30 @@
+export const REGISTRY_ERROR_CODES = [
+    "REGISTRY_NOT_FOUND",
+    "REGISTRY_CORRUPT",
+    "REGISTRY_UNSUPPORTED_SCHEMA",
+    "REGISTRY_REPOSITORY_MISMATCH",
+    "REGISTRY_DUPLICATE_SESSION",
+    "REGISTRY_DUPLICATE_WORKTREE",
+    "REGISTRY_DUPLICATE_BRANCH",
+    "REGISTRY_IO_ERROR",
+    "REGISTRY_MUTATION_FAILED",
+    "LOCK_BUSY",
+    "LOCK_STALE",
+    "LOCK_INVALID",
+    "LOCK_IO_ERROR",
+    "LOCK_RELEASE_FAILED",
+];
+export class RegistryError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}, options) {
+        super(message, options);
+        this.name = "RegistryError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function isRegistryError(error) {
+    return error instanceof RegistryError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/registry/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/registry/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oBAAoB;IACpB,kBAAkB;IAClB,6BAA6B;IAC7B,8BAA8B;IAC9B,4BAA4B;IAC5B,6BAA6B;IAC7B,2BAA2B;IAC3B,mBAAmB;IACnB,0BAA0B;IAC1B,WAAW;IACX,YAAY;IACZ,cAAc;IACd,eAAe;IACf,qBAAqB;CACb,CAAC;AAIX,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtB,IAAI,CAAoB;IACxB,OAAO,CAAoC;IAE3D,YACE,IAAuB,EACvB,OAAe,EACf,UAA6C,EAAE,EAC/C,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC"}

package/dist/registry/lock.d.ts

@@ -0,0 +1,60 @@
+import { RegistryError } from "./errors.js";
+import { type LockOwnerRecord } from "./types.js";
+export type LockFailureCode = "LOCK_BUSY" | "LOCK_STALE" | "LOCK_INVALID" | "LOCK_IO_ERROR" | "LOCK_RELEASE_FAILED";
+export declare class RegistryLockError extends RegistryError {
+    readonly lockPath: string;
+    readonly owner?: LockOwnerRecord;
+    constructor(code: LockFailureCode, message: string, lockPath: string, details?: Readonly<Record<string, unknown>>, owner?: LockOwnerRecord);
+}
+export interface RepositoryLockOptions {
+    lockPath: string;
+    staleAfterMs?: number;
+    acquireTimeoutMs?: number;
+    retryDelayMs?: number;
+    metadataGraceMs?: number;
+    hostname?: string;
+    processStartTime?: string | null;
+    clock?: () => number;
+    /** Test seam used to exercise the reclaim/create race deterministically. */
+    beforeReclaimRemove?: () => void | Promise<void>;
+    /** Test seam used to confirm a contender observed an active reclaim marker. */
+    onReclaimMarkerObserved?: () => void;
+}
+export interface LockLease {
+    readonly token: string;
+    readonly owner: LockOwnerRecord;
+    release(): Promise<void>;
+}
+export interface SyncLockLease {
+    readonly token: string;
+    readonly owner: LockOwnerRecord;
+    release(): void;
+}
+/**
+ * Read Linux's process start token. A PID alone is not sufficient for safe
+ * stale-lock recovery because the operating system can reuse a PID.
+ */
+export declare function readProcessStartTime(pid: number): Promise<string | null>;
+export declare class RepositoryLock {
+    private readonly options;
+    private readonly reclaimPath;
+    constructor(options: RepositoryLockOptions);
+    get lockPath(): string;
+    acquire(): Promise<LockLease>;
+    /** Synchronous adapter for the legacy synchronous SessionRegistry API. */
+    acquireSync(): SyncLockLease;
+    private tryCreate;
+    private tryCreateSync;
+    private inspectExisting;
+    private inspectExistingSync;
+    private tryReclaim;
+    private tryReclaimSync;
+    private handleExistingReclaimer;
+    private handleExistingReclaimerSync;
+    private removeCreatedLock;
+    private removeCreatedLockSync;
+    private release;
+    private releaseSync;
+    private reclaimMarkerExists;
+    private reclaimMarkerExistsSync;
+}