@frankzhang2026/opencode-android-orchestrator 0.1.0 → 0.2.0

package/dist/cli.js

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 import process from "node:process";
 import { INSTALLER_COMMANDS } from "./commands/index.js";
+import { formatDoctorReport, runDoctor } from "./doctor/index.js";
+import { formatProjectInitializationResult, runProjectInitialization, } from "./installer/init.js";
+import { formatProjectUpgradeResult, runProjectUpgrade, } from "./installer/upgrade.js";
+import { formatProjectUninstallResult, runProjectUninstall, } from "./installer/uninstall.js";
 function printHelp() {
     process.stdout.write(`OpenCode Android Orchestrator\n\n`);
     process.stdout.write(`Usage:\n`);
@@ -11,10 +15,248 @@ function printHelp() {
     process.stdout.write(`  upgrade    Upgrade unchanged managed resources\n`);
     process.stdout.write(`  uninstall  Remove unchanged managed resources\n`);
 }
-const [command] = process.argv.slice(2);
+function printInitHelp() {
+    process.stdout.write(`OpenCode Android Orchestrator init\n\n`);
+    process.stdout.write(`Usage:\n`);
+    process.stdout.write(`  opencode-android-orchestrator init [directory] [--primary-module <gradle-path>] [--json]\n`);
+}
+function printDoctorHelp() {
+    process.stdout.write(`OpenCode Android Orchestrator doctor\n\n`);
+    process.stdout.write(`Usage:\n`);
+    process.stdout.write(`  opencode-android-orchestrator doctor [directory] [--json]\n`);
+}
+function printUpgradeHelp() {
+    process.stdout.write(`OpenCode Android Orchestrator upgrade\n\n`);
+    process.stdout.write(`Usage:\n`);
+    process.stdout.write(`  opencode-android-orchestrator upgrade [directory] [--primary-module <gradle-path>] [--json]\n`);
+}
+function printUninstallHelp() {
+    process.stdout.write(`OpenCode Android Orchestrator uninstall\n\n`);
+    process.stdout.write(`Usage:\n`);
+    process.stdout.write(`  opencode-android-orchestrator uninstall [directory] [--json]\n`);
+}
+function errorDetails(error) {
+    if (typeof error === "object" &&
+        error !== null &&
+        "details" in error &&
+        Array.isArray(error.details) &&
+        error.details.every((detail) => typeof detail === "string")) {
+        return error.details;
+    }
+    return [];
+}
+function printCommandError(error) {
+    const code = typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? ` [${error.code}]`
+        : "";
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Error${code}: ${message}\n`);
+    for (const detail of errorDetails(error)) {
+        process.stderr.write(`  ${detail}\n`);
+    }
+}
+const [command, ...commandArguments] = process.argv.slice(2);
 if (command === undefined || command === "--help" || command === "-h") {
     printHelp();
 }
+else if (command === "init") {
+    if (commandArguments.includes("--help") || commandArguments.includes("-h")) {
+        printInitHelp();
+        process.exitCode = 0;
+    }
+    else {
+        let targetDirectory;
+        let primaryModule;
+        let json = false;
+        const unexpected = [];
+        for (let index = 0; index < commandArguments.length; index += 1) {
+            const argument = commandArguments[index] ?? "";
+            if (argument === "--json") {
+                json = true;
+            }
+            else if (argument === "--primary-module") {
+                const value = commandArguments[index + 1];
+                if (value === undefined || value.startsWith("-")) {
+                    unexpected.push(argument);
+                }
+                else {
+                    primaryModule = value;
+                    index += 1;
+                }
+            }
+            else if (argument.startsWith("--primary-module=")) {
+                const value = argument.slice("--primary-module=".length);
+                if (value.length === 0) {
+                    unexpected.push(argument);
+                }
+                else {
+                    primaryModule = value;
+                }
+            }
+            else if (argument.startsWith("-")) {
+                unexpected.push(argument);
+            }
+            else if (targetDirectory === undefined) {
+                targetDirectory = argument;
+            }
+            else {
+                unexpected.push(argument);
+            }
+        }
+        if (unexpected.length > 0) {
+            process.stderr.write(`Unexpected init argument(s): ${unexpected.join(", ")}\n`);
+            process.exitCode = 2;
+        }
+        else {
+            const options = {};
+            if (primaryModule !== undefined) {
+                options.primaryModule = primaryModule;
+            }
+            try {
+                const result = runProjectInitialization(targetDirectory ?? process.cwd(), options);
+                process.stdout.write(json
+                    ? `${JSON.stringify(result, null, 2)}\n`
+                    : formatProjectInitializationResult(result));
+                process.exitCode = 0;
+            }
+            catch (error) {
+                printCommandError(error);
+                process.exitCode = 1;
+            }
+        }
+    }
+}
+else if (command === "upgrade") {
+    if (commandArguments.includes("--help") || commandArguments.includes("-h")) {
+        printUpgradeHelp();
+        process.exitCode = 0;
+    }
+    else {
+        let targetDirectory;
+        let primaryModule;
+        let json = false;
+        const unexpected = [];
+        for (let index = 0; index < commandArguments.length; index += 1) {
+            const argument = commandArguments[index] ?? "";
+            if (argument === "--json") {
+                json = true;
+            }
+            else if (argument === "--primary-module") {
+                const value = commandArguments[index + 1];
+                if (value === undefined || value.startsWith("-")) {
+                    unexpected.push(argument);
+                }
+                else {
+                    primaryModule = value;
+                    index += 1;
+                }
+            }
+            else if (argument.startsWith("--primary-module=")) {
+                const value = argument.slice("--primary-module=".length);
+                if (value.length === 0) {
+                    unexpected.push(argument);
+                }
+                else {
+                    primaryModule = value;
+                }
+            }
+            else if (argument.startsWith("-")) {
+                unexpected.push(argument);
+            }
+            else if (targetDirectory === undefined) {
+                targetDirectory = argument;
+            }
+            else {
+                unexpected.push(argument);
+            }
+        }
+        if (unexpected.length > 0) {
+            process.stderr.write(`Unexpected upgrade argument(s): ${unexpected.join(", ")}\n`);
+            process.exitCode = 2;
+        }
+        else {
+            const options = {};
+            if (primaryModule !== undefined) {
+                options.primaryModule = primaryModule;
+            }
+            try {
+                const result = runProjectUpgrade(targetDirectory ?? process.cwd(), options);
+                process.stdout.write(json
+                    ? `${JSON.stringify(result, null, 2)}\n`
+                    : formatProjectUpgradeResult(result));
+                process.exitCode = 0;
+            }
+            catch (error) {
+                printCommandError(error);
+                process.exitCode = 1;
+            }
+        }
+    }
+}
+else if (command === "uninstall") {
+    if (commandArguments.includes("--help") || commandArguments.includes("-h")) {
+        printUninstallHelp();
+        process.exitCode = 0;
+    }
+    else {
+        const unknownOptions = commandArguments.filter((argument) => argument.startsWith("-") && argument !== "--json");
+        const targetDirectories = commandArguments.filter((argument) => !argument.startsWith("-"));
+        if (unknownOptions.length > 0 || targetDirectories.length > 1) {
+            process.stderr.write(`Unexpected uninstall argument(s): ${[
+                ...unknownOptions,
+                ...targetDirectories.slice(1),
+            ].join(", ")}\n`);
+            process.exitCode = 2;
+        }
+        else {
+            try {
+                const result = runProjectUninstall(targetDirectories[0] ?? process.cwd());
+                process.stdout.write(commandArguments.includes("--json")
+                    ? `${JSON.stringify(result, null, 2)}\n`
+                    : formatProjectUninstallResult(result));
+                process.exitCode = 0;
+            }
+            catch (error) {
+                printCommandError(error);
+                process.exitCode = 1;
+            }
+        }
+    }
+}
+else if (command === "doctor") {
+    if (commandArguments.includes("--help") || commandArguments.includes("-h")) {
+        printDoctorHelp();
+        process.exitCode = 0;
+    }
+    else {
+        const unknownOptions = commandArguments.filter((argument) => argument.startsWith("-") && argument !== "--json");
+        const targetDirectories = commandArguments.filter((argument) => !argument.startsWith("-"));
+        if (unknownOptions.length > 0 || targetDirectories.length > 1) {
+            process.stderr.write(`Unexpected doctor argument(s): ${[
+                ...unknownOptions,
+                ...targetDirectories.slice(1),
+            ].join(", ")}\n`);
+            process.exitCode = 2;
+        }
+        else {
+            const report = runDoctor({
+                checkDependencies: true,
+                checkInstallation: true,
+                targetDirectory: targetDirectories[0] ?? process.cwd(),
+            });
+            if (commandArguments.includes("--json")) {
+                process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+            }
+            else {
+                process.stdout.write(formatDoctorReport(report));
+            }
+            process.exitCode = report.ok ? 0 : 1;
+        }
+    }
+}
 else if (INSTALLER_COMMANDS.includes(command)) {
     process.stderr.write(`Command "${command}" is scaffolded but not implemented yet.\n`);
     process.exitCode = 1;

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAExC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACtE,SAAS,EAAE,CAAC;AACd,CAAC;KAAM,IAAK,kBAAwC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,OAAO,4CAA4C,CAChE,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,MAAM,CAAC,CAAC;IACxD,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/compatibility/hooks.d.ts

@@ -0,0 +1,23 @@
+import type { Hooks, PluginInput, PluginOptions } from "@opencode-ai/plugin";
+/**
+ * Plugin input fields that are present in both certified OpenCode versions.
+ * Keeping the runtime implementation behind this narrower view prevents an
+ * accidental dependency on version-specific workspace or server APIs.
+ */
+export declare const COMMON_PLUGIN_INPUT_KEYS: readonly ["directory", "worktree", "client", "$"];
+export type CommonPluginInputKey = (typeof COMMON_PLUGIN_INPUT_KEYS)[number];
+export type CompatiblePluginInput = Pick<PluginInput, CommonPluginInputKey>;
+/** Hooks verified to exist in both OpenCode 1.14.22 and 1.15.13. */
+export declare const COMMON_HOOK_NAMES: readonly ["config", "tool", "command.execute.before", "permission.ask", "shell.env", "tool.execute.before", "tool.execute.after"];
+export type CommonHookName = (typeof COMMON_HOOK_NAMES)[number];
+export type CompatibleHooks = Pick<Hooks, CommonHookName>;
+export type CompatiblePlugin = (input: CompatiblePluginInput, options?: PluginOptions) => Promise<CompatibleHooks>;
+/**
+ * Adds a runtime guard to the compile-time hook allowlist. This catches hooks
+ * introduced through object spreading or untyped JavaScript before OpenCode
+ * attempts to register them.
+ */
+export declare function defineCompatibleHooks(hooks: CompatibleHooks): CompatibleHooks;
+/** Remove all input fields that are not part of the certified common API. */
+export declare function toCompatiblePluginInput(input: PluginInput): CompatiblePluginInput;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/compatibility/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/compatibility/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mDAKc,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5C,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;AAE5E,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,mIAQe,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,eAAe,CAAC,CAAC;AAI9B;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,GACrB,eAAe,CAYjB;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,GACjB,qBAAqB,CAOvB"}

package/dist/compatibility/hooks.js

@@ -0,0 +1,44 @@
+/**
+ * Plugin input fields that are present in both certified OpenCode versions.
+ * Keeping the runtime implementation behind this narrower view prevents an
+ * accidental dependency on version-specific workspace or server APIs.
+ */
+export const COMMON_PLUGIN_INPUT_KEYS = [
+    "directory",
+    "worktree",
+    "client",
+    "$",
+];
+/** Hooks verified to exist in both OpenCode 1.14.22 and 1.15.13. */
+export const COMMON_HOOK_NAMES = [
+    "config",
+    "tool",
+    "command.execute.before",
+    "permission.ask",
+    "shell.env",
+    "tool.execute.before",
+    "tool.execute.after",
+];
+const commonHookNames = new Set(COMMON_HOOK_NAMES);
+/**
+ * Adds a runtime guard to the compile-time hook allowlist. This catches hooks
+ * introduced through object spreading or untyped JavaScript before OpenCode
+ * attempts to register them.
+ */
+export function defineCompatibleHooks(hooks) {
+    const unsupportedHooks = Object.keys(hooks).filter((hookName) => !commonHookNames.has(hookName));
+    if (unsupportedHooks.length > 0) {
+        throw new Error(`Unsupported OpenCode hook(s): ${unsupportedHooks.join(", ")}`);
+    }
+    return hooks;
+}
+/** Remove all input fields that are not part of the certified common API. */
+export function toCompatiblePluginInput(input) {
+    return {
+        directory: input.directory,
+        worktree: input.worktree,
+        client: input.client,
+        $: input.$,
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/compatibility/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/compatibility/hooks.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW;IACX,UAAU;IACV,QAAQ;IACR,GAAG;CAC8C,CAAC;AAMpD,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,MAAM;IACN,wBAAwB;IACxB,gBAAgB;IAChB,WAAW;IACX,qBAAqB;IACrB,oBAAoB;CACuB,CAAC;AAS9C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,iBAAiB,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAsB;IAEtB,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAChD,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAC7C,CAAC;IAEF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,iCAAiC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CACrC,KAAkB;IAElB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,CAAC,EAAE,KAAK,CAAC,CAAC;KACX,CAAC;AACJ,CAAC"}

package/dist/compatibility/versions.d.ts

@@ -1,4 +1,23 @@
 export declare const MINIMUM_OPENCODE_VERSION = "1.14.22";
 export declare const MAXIMUM_OPENCODE_VERSION = "1.16.0";
 export declare const CERTIFIED_OPENCODE_VERSIONS: readonly ["1.14.22", "1.15.13"];
+export interface ParsedSemanticVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: readonly string[];
+    normalized: string;
+}
+export type OpenCodeVersionSupport = "certified" | "supported-uncertified" | "unsupported" | "invalid";
+export interface OpenCodeVersionCheck {
+    input: string;
+    installedVersion: string | null;
+    support: OpenCodeVersionSupport;
+    compatible: boolean;
+    certified: boolean;
+    message: string;
+}
+export declare function parseOpenCodeVersion(value: string): ParsedSemanticVersion | null;
+export declare function compareSemanticVersions(left: ParsedSemanticVersion, right: ParsedSemanticVersion): number;
+export declare function checkOpenCodeVersion(input: string): OpenCodeVersionCheck;
 //# sourceMappingURL=versions.d.ts.map

package/dist/compatibility/versions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/compatibility/versions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAClD,eAAO,MAAM,wBAAwB,WAAW,CAAC;AACjD,eAAO,MAAM,2BAA2B,iCAAkC,CAAC"}
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/compatibility/versions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAClD,eAAO,MAAM,wBAAwB,WAAW,CAAC;AACjD,eAAO,MAAM,2BAA2B,iCAAkC,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,uBAAuB,GACvB,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,sBAAsB,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GACZ,qBAAqB,GAAG,IAAI,CA0B9B;AAoBD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,qBAAqB,GAC3B,MAAM,CA0CR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAqDxE"}

package/dist/compatibility/versions.js

@@ -1,4 +1,120 @@
 export const MINIMUM_OPENCODE_VERSION = "1.14.22";
 export const MAXIMUM_OPENCODE_VERSION = "1.16.0";
 export const CERTIFIED_OPENCODE_VERSIONS = ["1.14.22", "1.15.13"];
+const semanticVersionPattern = /(?:^|[^0-9])v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?(?=$|[^0-9A-Za-z])/;
+export function parseOpenCodeVersion(value) {
+    const match = semanticVersionPattern.exec(value.trim());
+    if (match === null) {
+        return null;
+    }
+    const majorText = match[1];
+    const minorText = match[2];
+    const patchText = match[3];
+    if (majorText === undefined ||
+        minorText === undefined ||
+        patchText === undefined) {
+        return null;
+    }
+    const major = Number.parseInt(majorText, 10);
+    const minor = Number.parseInt(minorText, 10);
+    const patch = Number.parseInt(patchText, 10);
+    const prerelease = match[4]?.split(".") ?? [];
+    const normalized = `${major}.${minor}.${patch}${prerelease.length === 0 ? "" : `-${prerelease.join(".")}`}`;
+    return { major, minor, patch, prerelease, normalized };
+}
+function comparePrereleaseIdentifiers(left, right) {
+    const leftNumber = /^[0-9]+$/.test(left) ? Number.parseInt(left, 10) : null;
+    const rightNumber = /^[0-9]+$/.test(right)
+        ? Number.parseInt(right, 10)
+        : null;
+    if (leftNumber !== null && rightNumber !== null) {
+        return Math.sign(leftNumber - rightNumber);
+    }
+    if (leftNumber !== null) {
+        return -1;
+    }
+    if (rightNumber !== null) {
+        return 1;
+    }
+    return left.localeCompare(right);
+}
+export function compareSemanticVersions(left, right) {
+    for (const key of ["major", "minor", "patch"]) {
+        const difference = left[key] - right[key];
+        if (difference !== 0) {
+            return Math.sign(difference);
+        }
+    }
+    if (left.prerelease.length === 0 && right.prerelease.length === 0) {
+        return 0;
+    }
+    if (left.prerelease.length === 0) {
+        return 1;
+    }
+    if (right.prerelease.length === 0) {
+        return -1;
+    }
+    const identifierCount = Math.max(left.prerelease.length, right.prerelease.length);
+    for (let index = 0; index < identifierCount; index += 1) {
+        const leftIdentifier = left.prerelease[index];
+        const rightIdentifier = right.prerelease[index];
+        if (leftIdentifier === undefined) {
+            return -1;
+        }
+        if (rightIdentifier === undefined) {
+            return 1;
+        }
+        const comparison = comparePrereleaseIdentifiers(leftIdentifier, rightIdentifier);
+        if (comparison !== 0) {
+            return comparison;
+        }
+    }
+    return 0;
+}
+export function checkOpenCodeVersion(input) {
+    const installed = parseOpenCodeVersion(input);
+    const minimum = parseOpenCodeVersion(MINIMUM_OPENCODE_VERSION);
+    const maximum = parseOpenCodeVersion(MAXIMUM_OPENCODE_VERSION);
+    if (installed === null || minimum === null || maximum === null) {
+        return {
+            input,
+            installedVersion: null,
+            support: "invalid",
+            compatible: false,
+            certified: false,
+            message: `Unable to parse an OpenCode version from: ${input.trim() || "<empty>"}`,
+        };
+    }
+    const compatible = compareSemanticVersions(installed, minimum) >= 0 &&
+        compareSemanticVersions(installed, maximum) < 0;
+    const certified = CERTIFIED_OPENCODE_VERSIONS.some((version) => version === installed.normalized);
+    if (!compatible) {
+        return {
+            input,
+            installedVersion: installed.normalized,
+            support: "unsupported",
+            compatible: false,
+            certified: false,
+            message: `OpenCode ${installed.normalized} is outside the supported range >=${MINIMUM_OPENCODE_VERSION} <${MAXIMUM_OPENCODE_VERSION}.`,
+        };
+    }
+    if (!certified) {
+        return {
+            input,
+            installedVersion: installed.normalized,
+            support: "supported-uncertified",
+            compatible: true,
+            certified: false,
+            message: `OpenCode ${installed.normalized} is in the supported range but has not been certified.`,
+        };
+    }
+    return {
+        input,
+        installedVersion: installed.normalized,
+        support: "certified",
+        compatible: true,
+        certified: true,
+        message: `OpenCode ${installed.normalized} is certified.`,
+    };
+}
 //# sourceMappingURL=versions.js.map

package/dist/compatibility/versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/compatibility/versions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AACjD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAS,EAAE,SAAS,CAAU,CAAC"}
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/compatibility/versions.ts"],"names":[],"mappings":"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"}

package/dist/doctor/index.d.ts

@@ -0,0 +1,36 @@
+export { EXPECTED_MANAGED_FILE_COUNT, installationDoctorChecks, } from "./installation.js";
+export type DoctorCheckStatus = "pass" | "warn" | "fail";
+export interface DoctorCheck {
+    id: string;
+    label: string;
+    status: DoctorCheckStatus;
+    summary: string;
+    details: readonly string[];
+}
+export interface DoctorReport {
+    ok: boolean;
+    checks: readonly DoctorCheck[];
+}
+export interface CommandResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error: string | null;
+}
+export type CommandRunner = (executable: string, args: readonly string[]) => CommandResult;
+export interface DoctorOptions {
+    androidSdkDirectory?: string;
+    checkDependencies?: boolean;
+    checkInstallation?: boolean;
+    environment?: Readonly<Record<string, string | undefined>>;
+    opencodeExecutable?: string;
+    runCommand?: CommandRunner;
+    targetDirectory?: string;
+}
+export declare const runCommand: CommandRunner;
+export declare function inspectRequiredCommands(options?: DoctorOptions): readonly DoctorCheck[];
+export declare function inspectAndroidSdk(targetDirectory: string, options?: DoctorOptions): DoctorCheck;
+export declare function inspectOpenCode(options?: DoctorOptions): DoctorCheck;
+export declare function runDoctor(options?: DoctorOptions): DoctorReport;
+export declare function formatDoctorReport(report: DoctorReport): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/doctor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doctor/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,KACpB,aAAa,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,UAAU,EAAE,aAaxB,CAAC;AAuBF,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,aAAkB,GAC1B,SAAS,WAAW,EAAE,CAoCxB;AAuED,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,aAAkB,GAC1B,WAAW,CAwCb;AAED,wBAAgB,eAAe,CAC7B,OAAO,GAAE,aAAkB,GAC1B,WAAW,CAuCb;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CA0BnE;AA4ED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAc/D"}