nawabari 0.1.0

package/dist/domain/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/domain/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAsD,MAAM,aAAa,CAAC;AA+B1F,SAAS,MAAM,CAAC,IAAc,EAAE,GAAW;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE;SAC3E,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC/E,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACjC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAuB,EAAE,EAAE;YAC5C,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,KAAK,CACZ,IAAyB,EACzB,MAAyB,EACzB,IAAsB,EACtB,OAAe,EACf,UAAsB,EAAE;IAExB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,GAAW;IAClD,MAAM,KAAK,GAAG,MAAM;SACjB,IAAI,EAAE;SACN,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO;QACL,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,uBAAuB,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,UAA0B;IACvD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAClE,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,0CAA0C,EAAE;gBAChG,IAAI,EAAE,UAAU,CAAC,aAAa;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,mDAAmD,EAAE;gBACzG,IAAI,EAAE,UAAU,CAAC,aAAa;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,8CAA8C,EAAE;gBACnF,IAAI,EAAE,UAAU,CAAC,aAAa;gBAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,QAAQ,EAAE,QAAQ,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,GACR,sBAAsB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,4BAA4B;gBAC1E,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,8BAA8B;oBAC9E,CAAC,CAAC,kBAAkB;oBACpB,CAAC,CAAC,qBAAqB,CAAC;YAC9B,OAAO,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,wDAAwD,EAAE;gBAChG,IAAI,EAAE,UAAU,CAAC,aAAa;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,mDAAmD,EAAE;gBACpG,IAAI,EAAE,UAAU,CAAC,aAAa;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,uCAAuC,EAAE;YAChG,IAAI,EAAE,UAAU,CAAC,aAAa;SAC/B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACjD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,IAAI,CACT,SAAS;QACP,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,2DAA2D,EAAE;YACxF,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;SAC5B,CAAC;QACJ,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,qBAAqB,EAAE,qDAAqD,EAAE;YACtG,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;SAC5B,CAAC,CACP,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,wCAAwC,EAAE;YACjF,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;SACrD,CAAC,CACH,CAAC;QACF,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,YAAY,EAAE,gBAAgB,EAAE,IAAI,EAAE,+DAA+D,CAAC,CAC7G,CAAC;QACF,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,6DAA6D,CAAC,CACzG,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAClG,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,EAAE,GAAG,CAAC,CAAC;QACjG,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3G,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,gDAAgD,EAAE;gBACnG,OAAO,EAAE,gDAAgD;gBACzD,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE;aACvC,CAAC,CACH,CAAC;YACF,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,2DAA2D,CAAC,CACvG,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,+CAA+C,EAAE;gBAC/E,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;aAClC,CAAC,CACH,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IAChE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/domain/errors.d.ts

@@ -0,0 +1,29 @@
+export type JsonPrimitive = null | boolean | number | string;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type ErrorCode = "BACKEND_UNAVAILABLE" | "BRANCH_OWNED_BY_OTHER_SESSION" | "BRANCH_ALREADY_EXISTS" | "DOCTOR_FAILED" | "DIRTY_WORKTREE" | "GIT_OPERATION_FAILED" | "GIT_UNAVAILABLE" | "INVALID_ARGUMENT" | "INVALID_BRANCH" | "INVALID_BASE_REF" | "INVALID_REGISTRY" | "INVALID_SESSION_ID" | "INVALID_WORKTREE" | "LOCK_CONTENTION" | "MISSING_ARGUMENT" | "NO_COMMAND" | "NO_CURRENT_SESSION" | "NOT_GIT_REPOSITORY" | "OPERATION_REJECTED" | "OWNERSHIP_MISMATCH" | "PROTECTED_BRANCH" | "PROTECTED_WORKTREE" | "RECOVERABLE_COMMITS" | "REGISTRY_CORRUPT" | "REGISTRY_UNREADABLE" | "SESSION_NOT_FOUND" | "STALE_SESSION" | "UNSUPPORTED_RUNTIME" | "UNKNOWN_COMMAND" | "WORKTREE_OWNED_BY_OTHER_SESSION" | "WORKTREE_ALREADY_EXISTS" | "INTERNAL_ERROR";
+export declare const EXIT_CODES: Readonly<{
+    success: 0;
+    usage: 2;
+    rejected: 3;
+    unavailable: 4;
+    doctor: 5;
+    internal: 70;
+}>;
+export declare class DomainError extends Error {
+    readonly code: ErrorCode;
+    readonly exitCode: number;
+    readonly details: JsonObject | null;
+    constructor(code: ErrorCode, message: string, details?: JsonObject | null, exitCode?: number, cause?: unknown);
+}
+export type DomainResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: DomainError;
+};
+export declare function success<T>(value: T): DomainResult<T>;
+export declare function failure<T = never>(error: DomainError): DomainResult<T>;

package/dist/domain/errors.js

@@ -0,0 +1,42 @@
+export const EXIT_CODES = Object.freeze({
+    success: 0,
+    usage: 2,
+    rejected: 3,
+    unavailable: 4,
+    doctor: 5,
+    internal: 70,
+});
+function defaultExitCode(code) {
+    if (code === "BACKEND_UNAVAILABLE")
+        return EXIT_CODES.unavailable;
+    if (code === "DOCTOR_FAILED")
+        return EXIT_CODES.doctor;
+    if (code === "UNKNOWN_COMMAND" ||
+        code === "NO_COMMAND" ||
+        code === "INVALID_ARGUMENT" ||
+        code === "MISSING_ARGUMENT") {
+        return EXIT_CODES.usage;
+    }
+    if (code === "INTERNAL_ERROR")
+        return EXIT_CODES.internal;
+    return EXIT_CODES.rejected;
+}
+export class DomainError extends Error {
+    code;
+    exitCode;
+    details;
+    constructor(code, message, details = null, exitCode = defaultExitCode(code), cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = "DomainError";
+        this.code = code;
+        this.exitCode = exitCode;
+        this.details = details;
+    }
+}
+export function success(value) {
+    return { ok: true, value };
+}
+export function failure(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=errors.js.map

package/dist/domain/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/domain/errors.ts"],"names":[],"mappings":"AA0CA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC;AAEH,SAAS,eAAe,CAAC,IAAe;IACtC,IAAI,IAAI,KAAK,qBAAqB;QAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IAClE,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC;IACvD,IACE,IAAI,KAAK,iBAAiB;QAC1B,IAAI,KAAK,YAAY;QACrB,IAAI,KAAK,kBAAkB;QAC3B,IAAI,KAAK,kBAAkB,EAC3B,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC;IAC1B,CAAC;IACD,IAAI,IAAI,KAAK,gBAAgB;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC;AAC7B,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAY;IAChB,QAAQ,CAAS;IACjB,OAAO,CAAoB;IAEpC,YACE,IAAe,EACf,OAAe,EACf,UAA6B,IAAI,EACjC,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,EAChC,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAID,MAAM,UAAU,OAAO,CAAI,KAAQ;IACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,OAAO,CAAY,KAAkB;IACnD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/domain/session-backend.d.ts

@@ -0,0 +1,24 @@
+import { type SessionRegistryOptions } from "../session-registry.js";
+import { type DomainResult } from "./errors.js";
+import { type BackendCapabilities, type GarbageCollectOptions, type GarbageCollectResult, type GuardDecision, type GuardOptions, type SessionBackend, type SessionCloseOptions, type SessionCloseResult, type SessionContext, type SessionCreateOptions, type SessionListResult, type SessionRecord, type StatusResult } from "./session.js";
+export interface LocalSessionBackendOptions {
+    readonly git?: SessionRegistryOptions["git"];
+    readonly registry?: Omit<SessionRegistryOptions, "cwd" | "git">;
+}
+export declare const LOCAL_SESSION_CAPABILITIES: BackendCapabilities;
+/** SessionBackend implementation backed only by the local Git repository. */
+export declare class LocalSessionBackend implements SessionBackend {
+    private readonly git;
+    private readonly registryOptions;
+    constructor(options?: LocalSessionBackendOptions);
+    createSession(context: SessionContext, options: SessionCreateOptions): Promise<DomainResult<SessionRecord>>;
+    resolveCurrentSession(context: SessionContext): Promise<DomainResult<SessionRecord>>;
+    getSession(context: SessionContext, sessionId: string): Promise<DomainResult<SessionRecord>>;
+    guard(context: SessionContext, options: GuardOptions): Promise<DomainResult<GuardDecision>>;
+    listSessions(context: SessionContext): Promise<DomainResult<SessionListResult>>;
+    status(context: SessionContext): Promise<DomainResult<StatusResult>>;
+    closeSession(context: SessionContext, options: SessionCloseOptions): Promise<DomainResult<SessionCloseResult>>;
+    garbageCollect(context: SessionContext, options: GarbageCollectOptions): Promise<DomainResult<GarbageCollectResult>>;
+    private registryFor;
+}
+export declare function createLocalSessionBackend(options?: LocalSessionBackendOptions): SessionBackend;

package/dist/domain/session-backend.js

@@ -0,0 +1,206 @@
+import { SessionRegistry, } from "../session-registry.js";
+import { isSessionRegistryError } from "../errors.js";
+import { DomainError, failure, success } from "./errors.js";
+export const LOCAL_SESSION_CAPABILITIES = Object.freeze({
+    session_registry: true,
+    provisioning: true,
+    lifecycle: true,
+    garbage_collection: true,
+    current_session_resolution: true,
+});
+const REGISTRY_ERROR_CODE_MAP = Object.freeze({
+    GIT_COMMAND_FAILED: "GIT_OPERATION_FAILED",
+    NOT_A_GIT_REPOSITORY: "NOT_GIT_REPOSITORY",
+    REPOSITORY_IDENTITY_AMBIGUOUS: "NOT_GIT_REPOSITORY",
+    WORKTREE_IDENTITY_AMBIGUOUS: "INVALID_WORKTREE",
+    INVALID_SESSION_ID: "INVALID_SESSION_ID",
+    INVALID_SESSION_RECORD: "INVALID_REGISTRY",
+    INVALID_BRANCH_ID: "INVALID_BRANCH",
+    INVALID_WORKTREE_PATH: "INVALID_WORKTREE",
+    INVALID_BASE_REF: "INVALID_BASE_REF",
+    REGISTRY_CORRUPT: "REGISTRY_CORRUPT",
+    UNSUPPORTED_SCHEMA_VERSION: "REGISTRY_CORRUPT",
+    REGISTRY_REPOSITORY_MISMATCH: "INVALID_REGISTRY",
+    DUPLICATE_SESSION_ID: "OPERATION_REJECTED",
+    DUPLICATE_WORKTREE_OWNERSHIP: "WORKTREE_OWNED_BY_OTHER_SESSION",
+    DUPLICATE_BRANCH_OWNERSHIP: "BRANCH_OWNED_BY_OTHER_SESSION",
+    WORKTREE_ALREADY_EXISTS: "WORKTREE_ALREADY_EXISTS",
+    BRANCH_ALREADY_EXISTS: "BRANCH_ALREADY_EXISTS",
+    PROTECTED_WORKTREE: "PROTECTED_WORKTREE",
+    PROTECTED_BRANCH: "PROTECTED_BRANCH",
+    SESSION_ID_COLLISION: "OPERATION_REJECTED",
+    SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
+    DIRTY_WORKTREE: "DIRTY_WORKTREE",
+    OWNERSHIP_MISMATCH: "OWNERSHIP_MISMATCH",
+    RECOVERABLE_COMMITS: "RECOVERABLE_COMMITS",
+    REGISTRY_LOCK_TIMEOUT: "LOCK_CONTENTION",
+    REGISTRY_IO_FAILURE: "REGISTRY_UNREADABLE",
+});
+/** SessionBackend implementation backed only by the local Git repository. */
+export class LocalSessionBackend {
+    git;
+    registryOptions;
+    constructor(options = {}) {
+        this.git = options.git;
+        this.registryOptions = options.registry ?? {};
+    }
+    async createSession(context, options) {
+        try {
+            const registry = this.registryFor(context);
+            const record = registry.provision({
+                branchName: options.branch ?? undefined,
+                worktreePath: options.worktree ?? undefined,
+                label: options.label ?? undefined,
+                baseRef: options.base ?? undefined,
+            });
+            return success(toDomainRecord(record));
+        }
+        catch (error) {
+            return failure(toDomainError(error));
+        }
+    }
+    async resolveCurrentSession(context) {
+        try {
+            return success(toDomainRecord(this.registryFor(context).resolveCurrentSession()));
+        }
+        catch (error) {
+            return failure(toDomainError(error, "NO_CURRENT_SESSION"));
+        }
+    }
+    async getSession(context, sessionId) {
+        try {
+            const record = this.registryFor(context).get(sessionId);
+            if (record === undefined) {
+                return failure(new DomainError("SESSION_NOT_FOUND", `Session was not found: ${sessionId}`, { session_id: sessionId }));
+            }
+            return success(toDomainRecord(record));
+        }
+        catch (error) {
+            return failure(toDomainError(error));
+        }
+    }
+    async guard(context, options) {
+        try {
+            return success(toDomainGuardDecision(this.registryFor(context).guard({ sessionId: options.session_id })));
+        }
+        catch (error) {
+            return failure(toDomainError(error));
+        }
+    }
+    async listSessions(context) {
+        try {
+            return success({ sessions: this.registryFor(context).list().map(toDomainRecord) });
+        }
+        catch (error) {
+            return failure(toDomainError(error));
+        }
+    }
+    async status(context) {
+        try {
+            const registry = this.registryFor(context);
+            let currentSession = null;
+            try {
+                currentSession = toDomainRecord(registry.resolveCurrentSession());
+            }
+            catch (error) {
+                if (!isSessionRegistryError(error) || error.code !== "SESSION_NOT_FOUND")
+                    throw error;
+            }
+            return success({
+                repository: registry.repository.repositoryId,
+                current_session: currentSession,
+                sessions: registry.list().map(toDomainRecord),
+                capabilities: { ...LOCAL_SESSION_CAPABILITIES },
+            });
+        }
+        catch (error) {
+            return failure(toDomainError(error));
+        }
+    }
+    closeSession(context, options) {
+        try {
+            const registry = this.registryFor(context);
+            const sessionId = options.session_id ?? registry.resolveCurrentSession().sessionId;
+            const result = registry.close(sessionId);
+            return Promise.resolve(success({
+                session: toDomainRecord(result.session),
+                worktree_removed: result.worktreeRemoved,
+                branch_removed: result.branchRemoved,
+                idempotent: result.idempotent,
+            }));
+        }
+        catch (error) {
+            return Promise.resolve(failure(toDomainError(error, "NO_CURRENT_SESSION")));
+        }
+    }
+    garbageCollect(context, options) {
+        try {
+            const result = this.registryFor(context).garbageCollect({ apply: options.apply });
+            return Promise.resolve(success(toDomainGarbageCollectResult(result)));
+        }
+        catch (error) {
+            return Promise.resolve(failure(toDomainError(error)));
+        }
+    }
+    registryFor(context) {
+        return new SessionRegistry({ ...this.registryOptions, cwd: context.cwd, git: this.git });
+    }
+}
+export function createLocalSessionBackend(options = {}) {
+    return new LocalSessionBackend(options);
+}
+function toDomainRecord(record) {
+    return {
+        schema_version: record.schemaVersion,
+        session_id: record.sessionId,
+        repository: record.repositoryId,
+        worktree: record.worktreePath,
+        branch: record.branchName,
+        state: record.state,
+        created_at: record.createdAt,
+        updated_at: record.updatedAt,
+        ...(record.label === undefined ? {} : { label: record.label }),
+    };
+}
+function toDomainGuardDecision(decision) {
+    return {
+        allowed: decision.allowed,
+        code: decision.code === "ALLOWED" ? "ALLOWED" : REGISTRY_ERROR_CODE_MAP[decision.code],
+        repository: decision.repositoryId,
+        worktree: decision.worktreePath,
+        branch: decision.branchName,
+        session_id: decision.sessionId,
+        owner_session_id: decision.ownerSessionId,
+        requested_session_id: decision.requestedSessionId,
+        state: decision.state,
+        details: { ...decision.details },
+    };
+}
+function toDomainGarbageCollectResult(result) {
+    return {
+        apply: result.apply,
+        candidates: result.candidates.map(toDomainRecord),
+        cleaned: result.cleaned.map(toDomainRecord),
+        blocked: result.blocked.map((blocked) => ({
+            session_id: blocked.sessionId,
+            code: REGISTRY_ERROR_CODE_MAP[blocked.code],
+            message: blocked.message,
+            details: { ...blocked.details },
+        })),
+    };
+}
+function toDomainError(error, fallbackCode) {
+    if (!isSessionRegistryError(error)) {
+        const cause = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+        return new DomainError("INTERNAL_ERROR", "An unexpected local session operation error occurred.", { cause }, undefined, error);
+    }
+    const details = { ...error.details };
+    const code = domainErrorCode(error, fallbackCode);
+    return new DomainError(code, error.message, details);
+}
+function domainErrorCode(error, fallbackCode) {
+    if (error.code === "SESSION_NOT_FOUND" && fallbackCode !== undefined)
+        return fallbackCode;
+    return REGISTRY_ERROR_CODE_MAP[error.code];
+}
+//# sourceMappingURL=session-backend.js.map

package/dist/domain/session-backend.js.map

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

package/dist/domain/session.d.ts

@@ -0,0 +1,89 @@
+import { type DomainResult, type ErrorCode, type JsonObject } from "./errors.js";
+export type SessionState = "new" | "active" | "closing" | "closed" | "stale";
+export type SessionRecord = {
+    schema_version: number;
+    session_id: string;
+    repository: string;
+    worktree: string;
+    branch: string;
+    state: SessionState;
+    created_at: string;
+    updated_at: string;
+    label?: string;
+};
+export type SessionContext = {
+    cwd: string;
+};
+export type SessionCreateOptions = {
+    branch: string | null;
+    worktree: string | null;
+    label: string | null;
+    base?: string | null;
+};
+export type SessionCloseOptions = {
+    session_id: string | null;
+};
+export type GuardOptions = {
+    session_id: string | null;
+};
+export type GuardDecision = {
+    allowed: boolean;
+    code: ErrorCode | "ALLOWED";
+    repository: string;
+    worktree: string;
+    branch: string | null;
+    session_id: string | null;
+    owner_session_id: string | null;
+    requested_session_id: string | null;
+    state: SessionState | null;
+    details: JsonObject;
+};
+export type GarbageCollectOptions = {
+    apply: boolean;
+};
+export type BackendCapabilities = {
+    session_registry: boolean;
+    provisioning: boolean;
+    lifecycle: boolean;
+    garbage_collection: boolean;
+    current_session_resolution: boolean;
+};
+export type SessionListResult = {
+    sessions: SessionRecord[];
+};
+export type StatusResult = {
+    repository: string | null;
+    current_session: SessionRecord | null;
+    sessions: SessionRecord[];
+    capabilities: BackendCapabilities;
+};
+export type SessionCloseResult = {
+    session: SessionRecord;
+    worktree_removed: boolean;
+    branch_removed: boolean;
+    idempotent?: boolean;
+};
+export type GarbageCollectBlocked = {
+    session_id: string;
+    code: ErrorCode;
+    message: string;
+    details: JsonObject;
+};
+export type GarbageCollectResult = {
+    apply: boolean;
+    candidates: SessionRecord[];
+    cleaned: SessionRecord[];
+    blocked?: GarbageCollectBlocked[];
+};
+export interface SessionBackend {
+    createSession(context: SessionContext, options: SessionCreateOptions): Promise<DomainResult<SessionRecord>>;
+    resolveCurrentSession(context: SessionContext): Promise<DomainResult<SessionRecord>>;
+    getSession(context: SessionContext, sessionId: string): Promise<DomainResult<SessionRecord>>;
+    guard(context: SessionContext, options: GuardOptions): Promise<DomainResult<GuardDecision>>;
+    listSessions(context: SessionContext): Promise<DomainResult<SessionListResult>>;
+    status(context: SessionContext): Promise<DomainResult<StatusResult>>;
+    closeSession(context: SessionContext, options: SessionCloseOptions): Promise<DomainResult<SessionCloseResult>>;
+    garbageCollect(context: SessionContext, options: GarbageCollectOptions): Promise<DomainResult<GarbageCollectResult>>;
+}
+export declare function unavailableCapabilities(): BackendCapabilities;
+export declare function createUnavailableSessionBackend(): SessionBackend;

package/dist/domain/session.js

@@ -0,0 +1,47 @@
+import { DomainError, failure } from "./errors.js";
+const UNAVAILABLE_CAPABILITIES = {
+    session_registry: false,
+    provisioning: false,
+    lifecycle: false,
+    garbage_collection: false,
+    current_session_resolution: false,
+};
+export function unavailableCapabilities() {
+    return { ...UNAVAILABLE_CAPABILITIES };
+}
+class UnavailableSessionBackend {
+    unavailable(operation) {
+        return Promise.resolve(failure(new DomainError("BACKEND_UNAVAILABLE", "The requested Nawabari session capability is not available.", {
+            operation,
+            capabilities: unavailableCapabilities(),
+        })));
+    }
+    createSession(_context, _options) {
+        return this.unavailable("session.create");
+    }
+    resolveCurrentSession(_context) {
+        return this.unavailable("session.resolve_current");
+    }
+    guard(_context, _options) {
+        return this.unavailable("guard");
+    }
+    getSession(_context, _sessionId) {
+        return this.unavailable("session.show");
+    }
+    listSessions(_context) {
+        return this.unavailable("session.list");
+    }
+    status(_context) {
+        return this.unavailable("status");
+    }
+    closeSession(_context, _options) {
+        return this.unavailable("session.close");
+    }
+    garbageCollect(_context, _options) {
+        return this.unavailable("gc");
+    }
+}
+export function createUnavailableSessionBackend() {
+    return new UnavailableSessionBackend();
+}
+//# sourceMappingURL=session.js.map

package/dist/domain/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/domain/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,OAAO,EAAmC,MAAM,aAAa,CAAC;AAuGvG,MAAM,wBAAwB,GAAwB;IACpD,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,KAAK;IAChB,kBAAkB,EAAE,KAAK;IACzB,0BAA0B,EAAE,KAAK;CAClC,CAAC;AAEF,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,GAAG,wBAAwB,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,yBAAyB;IACrB,WAAW,CAAI,SAAiB;QACtC,OAAO,OAAO,CAAC,OAAO,CACpB,OAAO,CACL,IAAI,WAAW,CAAC,qBAAqB,EAAE,6DAA6D,EAAE;YACpG,SAAS;YACT,YAAY,EAAE,uBAAuB,EAAE;SACxC,CAAC,CACH,CACF,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,QAAwB,EAAE,QAA8B;QACpE,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAED,qBAAqB,CAAC,QAAwB;QAC5C,OAAO,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,QAAwB,EAAE,QAAsB;QACpD,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,QAAwB,EAAE,UAAkB;QACrD,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,YAAY,CAAC,QAAwB;QACnC,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,QAAwB;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,YAAY,CAAC,QAAwB,EAAE,QAA6B;QAClE,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;IAED,cAAc,CACZ,QAAwB,EACxB,QAA+B;QAE/B,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,IAAI,yBAAyB,EAAE,CAAC;AACzC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export type RegistryErrorCode = "GIT_COMMAND_FAILED" | "NOT_A_GIT_REPOSITORY" | "REPOSITORY_IDENTITY_AMBIGUOUS" | "WORKTREE_IDENTITY_AMBIGUOUS" | "INVALID_SESSION_ID" | "INVALID_SESSION_RECORD" | "INVALID_BRANCH_ID" | "INVALID_WORKTREE_PATH" | "INVALID_BASE_REF" | "REGISTRY_CORRUPT" | "UNSUPPORTED_SCHEMA_VERSION" | "REGISTRY_REPOSITORY_MISMATCH" | "DUPLICATE_SESSION_ID" | "DUPLICATE_WORKTREE_OWNERSHIP" | "DUPLICATE_BRANCH_OWNERSHIP" | "WORKTREE_ALREADY_EXISTS" | "BRANCH_ALREADY_EXISTS" | "PROTECTED_WORKTREE" | "PROTECTED_BRANCH" | "SESSION_ID_COLLISION" | "SESSION_NOT_FOUND" | "DIRTY_WORKTREE" | "OWNERSHIP_MISMATCH" | "RECOVERABLE_COMMITS" | "REGISTRY_LOCK_TIMEOUT" | "REGISTRY_IO_FAILURE";
+export type RegistryErrorDetails = Readonly<Record<string, boolean | number | string>>;
+export declare class SessionRegistryError extends Error {
+    readonly code: RegistryErrorCode;
+    readonly details: RegistryErrorDetails;
+    constructor(code: RegistryErrorCode, message: string, details?: RegistryErrorDetails, cause?: unknown);
+}
+export declare function isSessionRegistryError(error: unknown): error is SessionRegistryError;

package/dist/errors.js

@@ -0,0 +1,14 @@
+export class SessionRegistryError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}, cause) {
+        super(message, { cause });
+        this.name = "SessionRegistryError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function isSessionRegistryError(error) {
+    return error instanceof SessionRegistryError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA8BA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAAoB;IACxB,OAAO,CAAuB;IAEvC,YAAY,IAAuB,EAAE,OAAe,EAAE,UAAgC,EAAE,EAAE,KAAe;QACvG,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,oBAAoB,CAAC;AAC/C,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,33 @@
+export interface GitCommandRunner {
+    run(args: readonly string[], cwd: string): string;
+}
+export interface RepositoryContext {
+    readonly repositoryId: string;
+    readonly commonGitDirectory: string;
+    readonly worktreePath: string;
+}
+export interface WorktreeIdentity {
+    readonly worktreeId: string;
+    readonly worktreePath: string;
+    readonly branchId: string;
+    readonly branchName: string;
+}
+export interface GitWorktreeInfo {
+    readonly worktreePath: string;
+    readonly branchName: string | null;
+}
+export interface ResolveRepositoryOptions {
+    readonly cwd?: string;
+    readonly git?: GitCommandRunner;
+}
+export interface ResolveWorktreeOptions extends ResolveRepositoryOptions {
+    readonly repository?: RepositoryContext;
+    readonly branchName?: string;
+}
+export declare const defaultGit: GitCommandRunner;
+export declare function resolveRepositoryContext(options?: ResolveRepositoryOptions): RepositoryContext;
+export declare function resolveWorktreeIdentity(options?: ResolveWorktreeOptions): WorktreeIdentity;
+/** Read the repository's local worktree inventory without consulting a remote. */
+export declare function listGitWorktrees(git: GitCommandRunner, cwd: string): readonly GitWorktreeInfo[];
+export declare function normalizeBranchId(branchName: string): string;
+export declare function readCurrentBranch(git: GitCommandRunner, cwd: string): string;