nawabari 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yohn-jp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# Nawabari
+
+Nawabari is a standalone local Git/session ownership layer for parallel coding
+agents. It gives each active session one exclusively owned worktree and one
+mutable branch. It works without GitHub, `gh`, a network connection, Mottainai,
+or a particular agent runtime.
+
+Nawabari governs operations routed through Nawabari. It is an authorization and
+ownership boundary, not an operating-system or filesystem sandbox: a process
+that already has filesystem permissions can still edit another worktree
+directly.
+
+## Install
+
+```bash
+npm install -g nawabari
+```
+
+The package installs `nawabari` for direct use and `git-nawabari` for Git's
+`git nawabari` external subcommand. Both names use the same entry point.
+
+```bash
+git nawabari --help
+nawabari --version
+```
+
+## Session lifecycle
+
+Session IDs are generated automatically as UUIDv7 values. They are immutable
+machine identities; labels and branch names are separate display metadata.
+
+```bash
+git nawabari session create --branch feature/example --worktree ../example-worktree --json
+git nawabari session id --json
+git nawabari session show --json
+git nawabari session list --json
+git nawabari status --json
+git nawabari guard --json
+git nawabari session close --json
+git nawabari gc --dry-run --json
+git nawabari doctor --json
+```
+
+`session create` provisions a dedicated worktree and mutable branch atomically
+under the repository-scoped mutation lock. The default/integration worktree
+and its protected branch cannot be session resources. `session id` and the
+other current-session commands resolve ownership from the current worktree;
+callers do not need to repeat the session ID.
+
+Close is conservative. Dirty worktrees, ambiguous ownership, mismatched Git
+state, and commits not proven reachable from the integration branch block
+destructive cleanup. A clean close releases only the owned worktree and
+branch, and repeating close is idempotent. `gc` detects stale or interrupted
+sessions; `--apply` uses the same close safety checks and reports blocked
+sessions instead of guessing.
+
+## Ownership guard
+
+`git nawabari guard` is a cheap, side-effect-free authorization decision for a
+Nawabari-governed mutation. It reads the current repository/worktree/branch and
+the same authoritative session registry used by provisioning and lifecycle
+operations. An optional `--session` asserts the caller's session identity.
+
+```bash
+decision=$(git nawabari guard --session "$NAWABARI_SESSION_ID" --json) || {
+  printf '%s\n' "$decision" >&2
+  exit 1
+}
+```
+
+An allowed decision has `allowed: true` and `code: "ALLOWED"`. A denied
+decision has `allowed: false`, a stable code such as
+`WORKTREE_OWNED_BY_OTHER_SESSION`, `PROTECTED_WORKTREE`, or
+`OWNERSHIP_MISMATCH`, and a non-zero exit status. Detached, corrupt, missing,
+or conflicting state fails closed. The guard does not install hooks and does
+not prevent direct filesystem writes outside Nawabari.
+
+## Orchestrator integration
+
+An external orchestrator can create a session, capture the returned
+`session_id`, launch its worker with the returned `worktree` as `cwd`, and
+check the guard before each Nawabari-governed mutation:
+
+```bash
+created=$(git nawabari session create --branch feature/task --json)
+session_id=$(printf '%s' "$created" | jq -r .session_id)
+worktree=$(printf '%s' "$created" | jq -r .worktree)
+
+(cd "$worktree" && git nawabari guard --session "$session_id" --json)
+# run the worker in "$worktree"
+git nawabari session close --session "$session_id" --json
+```
+
+The orchestrator owns scheduling, prompts, and worker lifetime; Nawabari owns
+only local session identity, worktree/branch ownership, and safe cleanup. No
+Mottainai, GitHub, `gh`, network, or agent-runtime dependency is required.
+
+## Repository state and concurrency
+
+The authoritative registry is stored in the repository-common Git directory at
+`.git/nawabari/session-registry.json`; linked worktrees therefore share one
+registry. It records the schema version, repository identity, immutable session
+ID, canonical worktree and branch identities, lifecycle state, and timestamps.
+
+Ownership-changing writes use an exclusive repository-local lock and a synced
+temporary file followed by atomic replacement. Concurrent creation cannot
+silently duplicate an active worktree or branch. Lock recovery is conservative:
+the lock records a random token, PID, host, and process-start identity; an
+owner is reclaimed only when the same host proves that exact process identity
+is dead. Invalid, remote, or otherwise unverifiable lock metadata is never
+stolen and fails closed so an operator can inspect or remove it deliberately.
+
+## Development
+
+```bash
+pnpm install --frozen-lockfile
+pnpm run verify
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+import { type SessionBackend } from "./domain/session.js";
+import { type CliIO } from "./presentation.js";
+export type CliDependencies = {
+    backend?: SessionBackend;
+    cwd?: string;
+    io?: CliIO;
+    version?: string;
+};
+export declare function runCli(argv: string[], dependencies?: CliDependencies): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,298 @@
+import { createRequire } from "node:module";
+import { runDoctor } from "./domain/doctor.js";
+import { DomainError, EXIT_CODES, failure } from "./domain/errors.js";
+import { createLocalSessionBackend } from "./domain/session-backend.js";
+import { defaultCliIO, renderFailure, renderSuccess } from "./presentation.js";
+const CLI_NAME = "nawabari";
+const packageMetadata = createRequire(import.meta.url)("../package.json");
+const VERSION = packageMetadata.version;
+const HELP_TEXT = [
+    `Usage: ${CLI_NAME} <command> [options]`,
+    "",
+    "Commands:",
+    "  session create       Request a new Nawabari session",
+    "  session id           Resolve the current session identity",
+    "  session show         Show the current or selected session",
+    "  session list         List repository sessions",
+    "  session close        Close the current or selected session",
+    "  status               Show Nawabari session status",
+    "  guard [--session id] Authorize the current worktree for mutation",
+    "  gc                   Detect or clean eligible stale sessions",
+    "  doctor               Check local Nawabari prerequisites",
+    "  --help               Show this help",
+    "  --version            Print the installed version",
+    "",
+    "Global options:",
+    "  --json               Emit one stable JSON document on stdout",
+    "  -h, --help           Show this help",
+    "",
+    "Session options:",
+    "  session create --branch <name> --worktree <path> --base <ref> --label <text>",
+    "  session show|close --session <id>",
+    "  gc [--dry-run|--apply]",
+].join("\n");
+const HELP_DATA = {
+    usage: `Usage: ${CLI_NAME} <command> [options]`,
+    commands: [
+        "session create",
+        "session id",
+        "session show",
+        "session list",
+        "session close",
+        "status",
+        "guard",
+        "gc",
+        "doctor",
+    ],
+    options: ["--json", "--help", "--version"],
+    session_options: ["--branch", "--worktree", "--base", "--label", "--session"],
+    gc_options: ["--apply", "--dry-run"],
+};
+function usageError(code, message, details = null) {
+    return new DomainError(code, message, details);
+}
+function parseGlobalArguments(argv) {
+    let json = false;
+    let help = false;
+    let version = false;
+    const commandArguments = [];
+    for (const argument of argv) {
+        if (argument === "--json") {
+            json = true;
+        }
+        else if (argument === "-h" || argument === "--help") {
+            help = true;
+        }
+        else if (argument === "--version") {
+            version = true;
+        }
+        else {
+            commandArguments.push(argument);
+        }
+    }
+    if (help && version) {
+        return failure(usageError("INVALID_ARGUMENT", "--help and --version cannot be used together."));
+    }
+    if (version && commandArguments.length > 0) {
+        return failure(usageError("INVALID_ARGUMENT", "--version cannot be combined with a command."));
+    }
+    return { ok: true, value: { json, help, version, commandArguments } };
+}
+function optionParts(argument) {
+    const separator = argument.indexOf("=");
+    if (separator === -1)
+        return { name: argument, inlineValue: null };
+    return { name: argument.slice(0, separator), inlineValue: argument.slice(separator + 1) };
+}
+function parseOptions(arguments_, allowed) {
+    const options = {
+        session_id: null,
+        branch: null,
+        worktree: null,
+        base: null,
+        label: null,
+        apply: false,
+    };
+    let dryRun = false;
+    for (let index = 0; index < arguments_.length; index += 1) {
+        const { name, inlineValue } = optionParts(arguments_[index]);
+        if (!allowed.has(name)) {
+            return failure(usageError("INVALID_ARGUMENT", `Unknown option: ${name}.`, { option: name }));
+        }
+        if (name === "--apply" || name === "--dry-run") {
+            if (inlineValue !== null) {
+                return failure(usageError("INVALID_ARGUMENT", `${name} does not accept a value.`, { option: name }));
+            }
+            if (name === "--apply")
+                options.apply = true;
+            else
+                dryRun = true;
+            continue;
+        }
+        const value = inlineValue ?? arguments_[index + 1];
+        if (value === undefined || value === "" || (inlineValue === null && value.startsWith("-"))) {
+            return failure(usageError("MISSING_ARGUMENT", `${name} requires a value.`, { option: name }));
+        }
+        if (inlineValue === null)
+            index += 1;
+        if (name === "--session")
+            options.session_id = value;
+        else if (name === "--branch")
+            options.branch = value;
+        else if (name === "--worktree")
+            options.worktree = value;
+        else if (name === "--base")
+            options.base = value;
+        else if (name === "--label")
+            options.label = value;
+    }
+    if (options.apply && dryRun) {
+        return failure(usageError("INVALID_ARGUMENT", "--apply and --dry-run cannot be used together."));
+    }
+    return { ok: true, value: options };
+}
+function noOptions(arguments_) {
+    return parseOptions(arguments_, new Set());
+}
+function sessionContext(cwd) {
+    return { cwd };
+}
+async function resolveSelectedSession(backend, context, sessionId) {
+    return sessionId === null ? backend.resolveCurrentSession(context) : backend.getSession(context, sessionId);
+}
+async function executeCommand(commandArguments, dependencies) {
+    const [command, subcommand, ...rest] = commandArguments;
+    const context = sessionContext(dependencies.cwd);
+    if (command === "session") {
+        if (subcommand === undefined) {
+            return failure(usageError("MISSING_ARGUMENT", "session requires a subcommand."));
+        }
+        if (subcommand === "create") {
+            const parsed = parseOptions(rest, new Set(["--branch", "--worktree", "--base", "--label"]));
+            if (!parsed.ok)
+                return parsed;
+            const options = {
+                branch: parsed.value.branch,
+                worktree: parsed.value.worktree,
+                base: parsed.value.base,
+                label: parsed.value.label,
+            };
+            const result = await dependencies.backend.createSession(context, options);
+            return result.ok ? { ok: true, value: result.value } : result;
+        }
+        if (subcommand === "id" || subcommand === "show" || subcommand === "close") {
+            if (subcommand === "id") {
+                const parsed = noOptions(rest);
+                if (!parsed.ok)
+                    return parsed;
+                const selected = await dependencies.backend.resolveCurrentSession(context);
+                if (!selected.ok)
+                    return selected;
+                return { ok: true, value: { session_id: selected.value.session_id } };
+            }
+            const parsed = parseOptions(rest, new Set(["--session"]));
+            if (!parsed.ok)
+                return parsed;
+            if (subcommand === "close") {
+                const closeOptions = { session_id: parsed.value.session_id };
+                const selected = await dependencies.backend.closeSession(context, closeOptions);
+                return selected.ok ? { ok: true, value: selected.value } : selected;
+            }
+            const selected = await resolveSelectedSession(dependencies.backend, context, parsed.value.session_id);
+            return selected.ok ? { ok: true, value: selected.value } : selected;
+        }
+        if (subcommand === "list") {
+            const parsed = noOptions(rest);
+            if (!parsed.ok)
+                return parsed;
+            const result = await dependencies.backend.listSessions(context);
+            return result.ok ? { ok: true, value: result.value } : result;
+        }
+        return failure(new DomainError("UNKNOWN_COMMAND", `Unknown session subcommand: ${subcommand}.`, { subcommand }));
+    }
+    if (command === "status") {
+        const parsed = noOptions([subcommand, ...rest].filter((argument) => argument !== undefined));
+        if (!parsed.ok)
+            return parsed;
+        const result = await dependencies.backend.status(context);
+        return result.ok ? { ok: true, value: result.value } : result;
+    }
+    if (command === "guard") {
+        const parsed = parseOptions([subcommand, ...rest].filter((argument) => argument !== undefined), new Set(["--session"]));
+        if (!parsed.ok)
+            return parsed;
+        const result = await dependencies.backend.guard(context, { session_id: parsed.value.session_id });
+        if (!result.ok)
+            return result;
+        if (result.value.allowed)
+            return { ok: true, value: result.value };
+        const code = result.value.code === "ALLOWED" ? "OPERATION_REJECTED" : result.value.code;
+        return failure(new DomainError(code, `Guard denied the current worktree: ${code}.`, {
+            allowed: false,
+            repository: result.value.repository,
+            worktree: result.value.worktree,
+            branch: result.value.branch,
+            session_id: result.value.session_id,
+            owner_session_id: result.value.owner_session_id,
+            requested_session_id: result.value.requested_session_id,
+            state: result.value.state,
+            details: result.value.details,
+        }));
+    }
+    if (command === "gc") {
+        const parsed = parseOptions([subcommand, ...rest].filter((argument) => argument !== undefined), new Set(["--apply", "--dry-run"]));
+        if (!parsed.ok)
+            return parsed;
+        const options = { apply: parsed.value.apply };
+        const result = await dependencies.backend.garbageCollect(context, options);
+        return result.ok ? { ok: true, value: result.value } : result;
+    }
+    if (command === "doctor") {
+        const parsed = noOptions([subcommand, ...rest].filter((argument) => argument !== undefined));
+        if (!parsed.ok)
+            return parsed;
+        const report = await runDoctor(dependencies.cwd);
+        if (!report.ok)
+            return report;
+        if (report.value.ok)
+            return { ok: true, value: report.value };
+        return failure(new DomainError("DOCTOR_FAILED", "One or more local Nawabari checks failed.", {
+            checks: report.value.checks,
+            repository: report.value.repository,
+        }));
+    }
+    if (command === undefined)
+        return failure(new DomainError("NO_COMMAND", "A command is required."));
+    return failure(new DomainError("UNKNOWN_COMMAND", `Unknown command: ${command}.`, { command }));
+}
+function commandName(commandArguments) {
+    if (commandArguments[0] === "session")
+        return commandArguments.slice(0, 2).join(" ");
+    return commandArguments[0] ?? "cli";
+}
+function emitFailure(mode, command, error, io) {
+    io[mode === "json" ? "stdout" : "stderr"](renderFailure(mode, command, error));
+    return error.exitCode;
+}
+export async function runCli(argv, dependencies = {}) {
+    const io = dependencies.io ?? defaultCliIO();
+    const mode = argv.includes("--json") ? "json" : "human";
+    const parsed = parseGlobalArguments(argv);
+    if (!parsed.ok)
+        return emitFailure(mode, "cli", parsed.error, io);
+    if (parsed.value.help) {
+        if (mode === "json")
+            io.stdout(renderSuccess(mode, "help", HELP_DATA));
+        else
+            io.stdout(HELP_TEXT);
+        return EXIT_CODES.success;
+    }
+    if (parsed.value.version) {
+        const payload = { version: dependencies.version ?? VERSION };
+        if (mode === "json")
+            io.stdout(renderSuccess(mode, "version", payload));
+        else
+            io.stdout(String(payload.version));
+        return EXIT_CODES.success;
+    }
+    if (parsed.value.commandArguments.length === 0) {
+        if (mode === "json")
+            return emitFailure(mode, "cli", new DomainError("NO_COMMAND", "A command is required."), io);
+        io.stdout(HELP_TEXT);
+        return EXIT_CODES.usage;
+    }
+    const command = commandName(parsed.value.commandArguments);
+    const cwd = dependencies.cwd ?? process.cwd();
+    try {
+        const backend = dependencies.backend ?? createLocalSessionBackend();
+        const result = await executeCommand(parsed.value.commandArguments, { backend, cwd });
+        if (!result.ok)
+            return emitFailure(mode, command, result.error, io);
+        io.stdout(renderSuccess(mode, command, result.value));
+        return EXIT_CODES.success;
+    }
+    catch {
+        return emitFailure(mode, command, new DomainError("INTERNAL_ERROR", "An unexpected internal error occurred."), io);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/domain/doctor.d.ts

@@ -0,0 +1,20 @@
+import { type DomainResult, type ErrorCode, type JsonObject } from "./errors.js";
+export type DoctorCheckStatus = "ok" | "warning" | "error" | "not_configured" | "not_applicable";
+export type DoctorCheck = {
+    name: "git" | "repository" | "registry" | "runtime";
+    status: DoctorCheckStatus;
+    code: ErrorCode | null;
+    message: string;
+    details: JsonObject;
+};
+export type RepositoryInfo = {
+    top_level: string;
+    common_dir: string;
+    registry_path: string;
+};
+export type DoctorReport = {
+    ok: boolean;
+    checks: DoctorCheck[];
+    repository: RepositoryInfo | null;
+};
+export declare function runDoctor(cwd?: string): Promise<DomainResult<DoctorReport>>;

package/dist/domain/doctor.js

@@ -0,0 +1,167 @@
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import process from "node:process";
+import { SessionRegistry } from "../session-registry.js";
+import { isSessionRegistryError } from "../errors.js";
+import { success } from "./errors.js";
+function runGit(args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn("git", args, {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, GIT_TERMINAL_PROMPT: "0", GIT_OPTIONAL_LOCKS: "0" },
+        });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill("SIGKILL");
+            resolve({ exit_code: null, stdout, stderr, error: "git command timed out" });
+        }, 10_000);
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ exit_code: null, stdout, stderr, error: error.message });
+        });
+        child.on("close", (exitCode) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ exit_code: exitCode, stdout, stderr, error: null });
+        });
+    });
+}
+function supportsRuntime(version) {
+    const [majorText, minorText] = version.split(".");
+    const major = Number(majorText);
+    const minor = Number(minorText);
+    return Number.isFinite(major) && Number.isFinite(minor) && (major > 22 || (major === 22 && minor >= 13));
+}
+function check(name, status, code, message, details = {}) {
+    return { name, status, code, message, details };
+}
+function parseRepository(stdout, cwd) {
+    const lines = stdout
+        .trim()
+        .split(/\r?\n/u)
+        .map((line) => line.trim());
+    if (lines.length < 2 || lines[0] === "" || lines[1] === "")
+        return null;
+    const topLevel = path.resolve(cwd, lines[0]);
+    const commonDir = path.resolve(cwd, lines[1]);
+    return {
+        top_level: topLevel,
+        common_dir: commonDir,
+        registry_path: path.join(commonDir, "nawabari", "session-registry.json"),
+    };
+}
+async function inspectRegistry(repository) {
+    try {
+        const contents = await readFile(repository.registry_path, "utf8");
+        let parsed;
+        try {
+            parsed = JSON.parse(contents);
+        }
+        catch {
+            return check("registry", "error", "REGISTRY_CORRUPT", "The Nawabari registry is not valid JSON.", {
+                path: repository.registry_path,
+            });
+        }
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return check("registry", "error", "INVALID_REGISTRY", "The Nawabari registry must contain a JSON object.", {
+                path: repository.registry_path,
+            });
+        }
+        try {
+            const registry = new SessionRegistry({ cwd: repository.top_level });
+            const sessions = registry.list();
+            return check("registry", "ok", null, "The Nawabari registry is readable and valid.", {
+                path: repository.registry_path,
+                bytes: contents.length,
+                sessions: sessions.length,
+            });
+        }
+        catch (error) {
+            const code = isSessionRegistryError(error) && error.code === "UNSUPPORTED_SCHEMA_VERSION"
+                ? "REGISTRY_CORRUPT"
+                : isSessionRegistryError(error) && error.code === "REGISTRY_REPOSITORY_MISMATCH"
+                    ? "INVALID_REGISTRY"
+                    : "REGISTRY_UNREADABLE";
+            return check("registry", "error", code, "The Nawabari registry failed authoritative validation.", {
+                path: repository.registry_path,
+            });
+        }
+    }
+    catch (error) {
+        if (isFileNotFound(error)) {
+            return check("registry", "not_configured", null, "The Nawabari session registry is not initialized.", {
+                path: repository.registry_path,
+            });
+        }
+        return check("registry", "error", "REGISTRY_UNREADABLE", "The Nawabari registry cannot be read.", {
+            path: repository.registry_path,
+        });
+    }
+}
+function isFileNotFound(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+export async function runDoctor(cwd = process.cwd()) {
+    const checks = [];
+    const runtimeOk = supportsRuntime(process.versions.node);
+    checks.push(runtimeOk
+        ? check("runtime", "ok", null, "The Nawabari runtime meets the supported Node.js version.", {
+            node: process.versions.node,
+        })
+        : check("runtime", "error", "UNSUPPORTED_RUNTIME", "The Node.js runtime is below the supported version.", {
+            node: process.versions.node,
+        }));
+    const gitVersion = await runGit(["--version"], cwd);
+    if (gitVersion.exit_code !== 0) {
+        checks.push(check("git", "error", "GIT_UNAVAILABLE", "Git is not available to the local CLI.", {
+            command: "git --version",
+            reason: gitVersion.error ?? gitVersion.stderr.trim(),
+        }));
+        checks.push(check("repository", "not_applicable", null, "Repository resolution was skipped because Git is unavailable."));
+        checks.push(check("registry", "not_applicable", null, "Registry inspection was skipped because Git is unavailable."));
+    }
+    else {
+        checks.push(check("git", "ok", null, "Git is available.", { version: gitVersion.stdout.trim() }));
+        const repositoryResult = await runGit(["rev-parse", "--show-toplevel", "--git-common-dir"], cwd);
+        const repository = repositoryResult.exit_code === 0 ? parseRepository(repositoryResult.stdout, cwd) : null;
+        if (repository === null) {
+            checks.push(check("repository", "error", "NOT_GIT_REPOSITORY", "The current directory is not a Git repository.", {
+                command: "git rev-parse --show-toplevel --git-common-dir",
+                reason: repositoryResult.stderr.trim(),
+            }));
+            checks.push(check("registry", "not_applicable", null, "Registry inspection was skipped outside a Git repository."));
+        }
+        else {
+            checks.push(check("repository", "ok", null, "Repository and common Git directory resolved.", {
+                top_level: repository.top_level,
+                common_dir: repository.common_dir,
+            }));
+            checks.push(await inspectRegistry(repository));
+        }
+        const hasError = checks.some((item) => item.status === "error");
+        return success({ ok: !hasError, checks, repository });
+    }
+    const hasError = checks.some((item) => item.status === "error");
+    return success({ ok: !hasError, checks, repository: null });
+}
+//# sourceMappingURL=doctor.js.map