@frankzhang2026/opencode-android-orchestrator 0.1.0 → 0.3.0

package/dist/installer/adaptive-templates.d.ts

@@ -0,0 +1,78 @@
+import { type AndroidModuleType, type AndroidProjectDetection, type GradleDsl } from "./android-project.js";
+export type AdaptiveProjectTemplateErrorCode = "INVALID_ANDROID_PROJECT" | "MODULE_SCOPE_INVALID" | "NESTED_GRADLE_ROOT_UNSUPPORTED" | "PRIMARY_MODULE_AMBIGUOUS" | "PRIMARY_MODULE_NOT_FOUND" | "PROJECT_PATH_OUTSIDE_GIT_ROOT" | "TEMPLATE_INVALID";
+export declare class AdaptiveProjectTemplateError extends Error {
+    readonly code: AdaptiveProjectTemplateErrorCode;
+    readonly details: readonly string[];
+    constructor(code: AdaptiveProjectTemplateErrorCode, message: string, details?: readonly string[]);
+}
+export interface AdaptiveProjectTemplateOptions {
+    /** Select whether generated task contracts can modify every detected module or one primary module. */
+    moduleScope?: ModuleScope;
+    /** Select the only editable module in primary scope or the focused-test default in all scope. */
+    primaryModule?: string;
+    /** Override the packaged Gradle quality-gate task matrix. */
+    gradleVerification?: GradleVerificationConfiguration;
+}
+export type ModuleScope = "all" | "primary";
+export declare const DEFAULT_MODULE_SCOPE: ModuleScope;
+export declare function isModuleScope(value: unknown): value is ModuleScope;
+export interface GradleVerificationConfiguration {
+    fullUnitTestTasks: readonly string[];
+    focusedTestTasks: readonly string[];
+    assembleTasks: readonly string[];
+    lintTasks: readonly string[];
+    deviceTestTasks: readonly string[];
+}
+export interface AdaptiveAndroidModuleConfiguration {
+    gradlePath: string;
+    directory: string;
+    buildFile: string;
+    dsl: "kotlin" | "groovy";
+    type: AndroidModuleType;
+    namespace: string | null;
+    applicationId: string | null;
+}
+export interface AdaptiveAndroidProjectConfiguration {
+    name: string;
+    gradleDsl: Exclude<GradleDsl, "unknown">;
+    settingsFile: string;
+    moduleScope: ModuleScope;
+    /** Default module for focused-test rendering; it does not narrow all-module scope. */
+    primaryModule: string;
+    modules: readonly AdaptiveAndroidModuleConfiguration[];
+    productionPaths: readonly string[];
+    testPaths: readonly string[];
+}
+export interface AdaptiveAutomationConfiguration {
+    readonly [key: string]: unknown;
+    schemaVersion: 3;
+    androidProject: AdaptiveAndroidProjectConfiguration;
+    gradleVerification: GradleVerificationConfiguration;
+    plugins: Readonly<{
+        superpowers: string;
+    }>;
+    protectedPaths: readonly string[];
+}
+export interface AdaptiveTargetTest {
+    gradleTask: string;
+    filter: string;
+}
+export interface AdaptiveTaskContractExample {
+    readonly [key: string]: unknown;
+    schemaVersion: 1;
+    allowedPaths: readonly string[];
+    forbiddenPaths: readonly string[];
+    targetTests: readonly AdaptiveTargetTest[];
+}
+export interface AdaptiveProjectTemplatePlan {
+    detection: AndroidProjectDetection;
+    projectRoot: string;
+    moduleScope: ModuleScope;
+    primaryModule: AdaptiveAndroidModuleConfiguration;
+    automationConfig: AdaptiveAutomationConfiguration;
+    automationConfigContent: string;
+    taskContractExample: AdaptiveTaskContractExample;
+    taskContractExampleContent: string;
+}
+export declare function planAdaptiveProjectTemplates(targetDirectory: string, options?: AdaptiveProjectTemplateOptions): AdaptiveProjectTemplatePlan;
+//# sourceMappingURL=adaptive-templates.d.ts.map

package/dist/installer/adaptive-templates.d.ts.map

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

package/dist/installer/adaptive-templates.js

@@ -0,0 +1,233 @@
+import { readFileSync } from "node:fs";
+import { isAbsolute, relative, sep, } from "node:path";
+import { detectAndroidProject, } from "./android-project.js";
+export class AdaptiveProjectTemplateError extends Error {
+    code;
+    details;
+    constructor(code, message, details = []) {
+        super(message);
+        this.name = "AdaptiveProjectTemplateError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export const DEFAULT_MODULE_SCOPE = "all";
+export function isModuleScope(value) {
+    return value === "all" || value === "primary";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readObjectTemplate(relativePath) {
+    const templateUrl = new URL(`../../templates/${relativePath}`, import.meta.url);
+    let value;
+    try {
+        value = JSON.parse(readFileSync(templateUrl, "utf8"));
+    }
+    catch (error) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", `Unable to parse packaged template: ${relativePath}`, [error instanceof Error ? error.message : String(error)]);
+    }
+    if (!isRecord(value)) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", `Packaged template must contain a JSON object: ${relativePath}`);
+    }
+    return value;
+}
+function stringArrayProperty(value, propertyName, relativePath) {
+    const property = value[propertyName];
+    if (!Array.isArray(property) ||
+        property.length === 0 ||
+        property.some((entry) => typeof entry !== "string" || entry.length === 0)) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", `Packaged template property ${propertyName} must be a non-empty string array: ${relativePath}`);
+    }
+    return property;
+}
+function repositoryPath(gitRoot, absolutePath) {
+    const relativePath = relative(gitRoot, absolutePath);
+    if (isAbsolute(relativePath) ||
+        relativePath === ".." ||
+        relativePath.startsWith(`..${sep}`)) {
+        throw new AdaptiveProjectTemplateError("PROJECT_PATH_OUTSIDE_GIT_ROOT", "Detected Android project paths must remain inside the Git root.", [absolutePath]);
+    }
+    return relativePath.length === 0
+        ? "."
+        : relativePath.split(sep).join("/");
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+const GRADLE_TASK_PATTERN = /^(?:[A-Za-z][A-Za-z0-9_.-]*|(?::[A-Za-z0-9_.-]+)+)$/;
+const GRADLE_VERIFICATION_PROPERTIES = [
+    "fullUnitTestTasks",
+    "focusedTestTasks",
+    "assembleTasks",
+    "lintTasks",
+    "deviceTestTasks",
+];
+function gradleTaskList(value, propertyName, source) {
+    const property = value[propertyName];
+    if (!Array.isArray(property) ||
+        property.length === 0 ||
+        property.some((entry) => typeof entry !== "string" ||
+            !GRADLE_TASK_PATTERN.test(entry)) ||
+        new Set(property).size !== property.length) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", `Gradle verification property ${propertyName} must be a non-empty unique task array: ${source}`);
+    }
+    return property;
+}
+function gradleVerificationConfiguration(value, source) {
+    if (!isRecord(value)) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", `Gradle verification configuration must be an object: ${source}`);
+    }
+    const actualKeys = Object.keys(value).sort();
+    const expectedKeys = [...GRADLE_VERIFICATION_PROPERTIES].sort();
+    if (actualKeys.length !== expectedKeys.length ||
+        actualKeys.some((key, index) => key !== expectedKeys[index])) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", `Gradle verification configuration has unexpected or missing properties: ${source}`, actualKeys);
+    }
+    return {
+        fullUnitTestTasks: gradleTaskList(value, "fullUnitTestTasks", source),
+        focusedTestTasks: gradleTaskList(value, "focusedTestTasks", source),
+        assembleTasks: gradleTaskList(value, "assembleTasks", source),
+        lintTasks: gradleTaskList(value, "lintTasks", source),
+        deviceTestTasks: gradleTaskList(value, "deviceTestTasks", source),
+    };
+}
+function sourcePattern(directory, sourceSet) {
+    const prefix = directory === "." ? "" : `${directory}/`;
+    return `${prefix}src/${sourceSet}/**`;
+}
+function selectPrimaryModule(modules, requestedGradlePath, moduleScope) {
+    if (requestedGradlePath !== undefined) {
+        const selected = modules.find((module) => module.gradlePath === requestedGradlePath);
+        if (selected === undefined) {
+            throw new AdaptiveProjectTemplateError("PRIMARY_MODULE_NOT_FOUND", `Primary Android module was not detected: ${requestedGradlePath}`, modules.map((module) => module.gradlePath));
+        }
+        return selected;
+    }
+    const applications = modules.filter((module) => module.type === "application");
+    if (applications.length === 1) {
+        return applications[0];
+    }
+    if (applications.length === 0 && modules.length === 1) {
+        return modules[0];
+    }
+    const defaultModule = applications[0] ?? modules[0];
+    if (moduleScope === "all" && defaultModule !== undefined) {
+        return defaultModule;
+    }
+    throw new AdaptiveProjectTemplateError("PRIMARY_MODULE_AMBIGUOUS", "Primary-module scope requires an explicit Android module before rendering templates.", (applications.length > 1 ? applications : modules).map((module) => module.gradlePath));
+}
+function taskTestFilter(module) {
+    const packageName = [module.namespace, module.applicationId].find((candidate) => candidate !== null &&
+        /^[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)+$/.test(candidate));
+    return packageName !== undefined
+        ? `${packageName}.ReplaceWithFocusedTest`
+        : "*ReplaceWithFocusedTest";
+}
+function taskForbiddenPath(protectedPath) {
+    return protectedPath.endsWith("/")
+        ? `${protectedPath}**`
+        : protectedPath;
+}
+function serialize(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export function planAdaptiveProjectTemplates(targetDirectory, options = {}) {
+    const detection = detectAndroidProject(targetDirectory);
+    if (!detection.isAndroidProject ||
+        detection.gitRoot === null ||
+        detection.projectRoot === null ||
+        detection.projectName === null ||
+        detection.settingsFile === null ||
+        detection.dsl === "unknown") {
+        throw new AdaptiveProjectTemplateError("INVALID_ANDROID_PROJECT", "A Git-backed Android Gradle project is required to render templates.", [...detection.errors, ...detection.warnings]);
+    }
+    if (detection.projectRoot !== detection.gitRoot) {
+        throw new AdaptiveProjectTemplateError("NESTED_GRADLE_ROOT_UNSUPPORTED", "The Gradle settings root must currently match the Git root.", [detection.gitRoot, detection.projectRoot]);
+    }
+    const gitRoot = detection.gitRoot;
+    const moduleScope = options.moduleScope ?? DEFAULT_MODULE_SCOPE;
+    if (!isModuleScope(moduleScope)) {
+        throw new AdaptiveProjectTemplateError("MODULE_SCOPE_INVALID", `Unsupported Android module scope: ${String(moduleScope)}`, ["Expected one of: all, primary"]);
+    }
+    const selectedModule = selectPrimaryModule(detection.modules, options.primaryModule, moduleScope);
+    const modules = detection.modules.map((module) => ({
+        gradlePath: module.gradlePath,
+        directory: repositoryPath(gitRoot, module.directory),
+        buildFile: repositoryPath(gitRoot, module.buildFile),
+        dsl: module.dsl,
+        type: module.type,
+        namespace: module.namespace,
+        applicationId: module.applicationId,
+    }));
+    const primaryModule = modules.find((module) => module.gradlePath === selectedModule.gradlePath);
+    if (primaryModule === undefined) {
+        throw new AdaptiveProjectTemplateError("PRIMARY_MODULE_NOT_FOUND", `Primary Android module was not rendered: ${selectedModule.gradlePath}`);
+    }
+    const productionPaths = unique(modules.map((module) => sourcePattern(module.directory, "main")));
+    const testPaths = unique(modules.flatMap((module) => [
+        sourcePattern(module.directory, "test"),
+        sourcePattern(module.directory, "androidTest"),
+    ]));
+    const androidProject = {
+        name: detection.projectName,
+        gradleDsl: detection.dsl,
+        settingsFile: repositoryPath(gitRoot, detection.settingsFile),
+        moduleScope,
+        primaryModule: primaryModule.gradlePath,
+        modules,
+        productionPaths,
+        testPaths,
+    };
+    const configTemplatePath = "automation/config.json";
+    const configTemplate = readObjectTemplate(configTemplatePath);
+    const gradleVerification = gradleVerificationConfiguration(options.gradleVerification ?? configTemplate.gradleVerification, options.gradleVerification === undefined
+        ? configTemplatePath
+        : "AdaptiveProjectTemplateOptions.gradleVerification");
+    const baseProtectedPaths = stringArrayProperty(configTemplate, "protectedPaths", configTemplatePath);
+    const protectedPaths = unique([
+        ...baseProtectedPaths,
+        androidProject.settingsFile,
+        ...modules.map((module) => module.buildFile),
+    ]);
+    const automationConfig = {
+        ...configTemplate,
+        gradleVerification,
+        androidProject,
+        protectedPaths,
+    };
+    const taskTemplatePath = "automation/tasks/TASK-TEMPLATE.json.example";
+    const taskTemplate = readObjectTemplate(taskTemplatePath);
+    const defaultFocusedTestTask = gradleVerification.focusedTestTasks[0];
+    if (defaultFocusedTestTask === undefined) {
+        throw new AdaptiveProjectTemplateError("TEMPLATE_INVALID", "Gradle verification configuration has no focused test task.");
+    }
+    const taskContractExample = {
+        ...taskTemplate,
+        allowedPaths: moduleScope === "all"
+            ? [...productionPaths, ...testPaths]
+            : [
+                sourcePattern(primaryModule.directory, "main"),
+                sourcePattern(primaryModule.directory, "test"),
+                sourcePattern(primaryModule.directory, "androidTest"),
+            ],
+        forbiddenPaths: protectedPaths.map(taskForbiddenPath),
+        targetTests: [
+            {
+                gradleTask: defaultFocusedTestTask,
+                filter: taskTestFilter(primaryModule),
+            },
+        ],
+    };
+    return {
+        detection,
+        projectRoot: detection.projectRoot,
+        moduleScope,
+        primaryModule,
+        automationConfig,
+        automationConfigContent: serialize(automationConfig),
+        taskContractExample,
+        taskContractExampleContent: serialize(taskContractExample),
+    };
+}
+//# sourceMappingURL=adaptive-templates.js.map

package/dist/installer/adaptive-templates.js.map

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

package/dist/installer/agents-config.d.ts

@@ -0,0 +1,19 @@
+export declare const AGENTS_MANAGED_BLOCK_BEGIN = "<!-- opencode-android-orchestrator:begin -->";
+export declare const AGENTS_MANAGED_BLOCK_END = "<!-- opencode-android-orchestrator:end -->";
+export type AgentsConfigMergeErrorCode = "AGENTS_BLOCK_CONFLICT" | "AGENTS_MARKERS_INVALID" | "AGENTS_NOT_FILE" | "AGENTS_READ_FAILED" | "AGENTS_SYMLINK" | "TARGET_NOT_DIRECTORY" | "TEMPLATE_INVALID";
+export declare class AgentsConfigMergeError extends Error {
+    readonly code: AgentsConfigMergeErrorCode;
+    readonly details: readonly string[];
+    constructor(code: AgentsConfigMergeErrorCode, message: string, details?: readonly string[]);
+}
+export interface AgentsConfigMergePlan {
+    targetDirectory: string;
+    agentsPath: string;
+    existed: boolean;
+    originalContent: string;
+    content: string;
+    changed: boolean;
+}
+export declare function mergeAgentsConfigText(source: string): string;
+export declare function planAgentsConfigMerge(directory: string): AgentsConfigMergePlan;
+//# sourceMappingURL=agents-config.d.ts.map

package/dist/installer/agents-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-config.d.ts","sourceRoot":"","sources":["../../src/installer/agents-config.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,0BAA0B,iDACS,CAAC;AACjD,eAAO,MAAM,wBAAwB,+CACS,CAAC;AAE/C,MAAM,MAAM,0BAA0B,GAClC,uBAAuB,GACvB,wBAAwB,GACxB,iBAAiB,GACjB,oBAAoB,GACpB,gBAAgB,GAChB,sBAAsB,GACtB,kBAAkB,CAAC;AAEvB,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;gBAGlC,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,SAAS,MAAM,EAAO;CAOlC;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AA4HD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CA8DvB"}

package/dist/installer/agents-config.js

@@ -0,0 +1,147 @@
+import { lstatSync, readFileSync, } from "node:fs";
+import { join, resolve } from "node:path";
+export const AGENTS_MANAGED_BLOCK_BEGIN = "<!-- opencode-android-orchestrator:begin -->";
+export const AGENTS_MANAGED_BLOCK_END = "<!-- opencode-android-orchestrator:end -->";
+export class AgentsConfigMergeError extends Error {
+    code;
+    details;
+    constructor(code, message, details = []) {
+        super(message);
+        this.name = "AgentsConfigMergeError";
+        this.code = code;
+        this.details = details;
+    }
+}
+function filesystemErrorCode(error) {
+    if (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string") {
+        return error.code;
+    }
+    return null;
+}
+function markerCount(content, marker) {
+    let count = 0;
+    let offset = 0;
+    while (true) {
+        const index = content.indexOf(marker, offset);
+        if (index < 0) {
+            return count;
+        }
+        count += 1;
+        offset = index + marker.length;
+    }
+}
+function packagedFragment() {
+    const fragmentUrl = new URL("../../templates/AGENTS.md.fragment", import.meta.url);
+    let fragment;
+    try {
+        fragment = readFileSync(fragmentUrl, "utf8");
+    }
+    catch (error) {
+        throw new AgentsConfigMergeError("TEMPLATE_INVALID", "Unable to read the packaged AGENTS managed block.", [error instanceof Error ? error.message : String(error)]);
+    }
+    if (markerCount(fragment, AGENTS_MANAGED_BLOCK_BEGIN) !== 1 ||
+        markerCount(fragment, AGENTS_MANAGED_BLOCK_END) !== 1 ||
+        !fragment.startsWith(`${AGENTS_MANAGED_BLOCK_BEGIN}\n`) ||
+        !fragment.endsWith(`${AGENTS_MANAGED_BLOCK_END}\n`)) {
+        throw new AgentsConfigMergeError("TEMPLATE_INVALID", "The packaged AGENTS managed block markers are invalid.");
+    }
+    return fragment;
+}
+function lineEnding(content) {
+    const withoutCrLf = content.replaceAll("\r\n", "");
+    return content.includes("\r\n") && !withoutCrLf.includes("\n")
+        ? "\r\n"
+        : "\n";
+}
+function convertLineEndings(content, ending) {
+    return ending === "\n"
+        ? content
+        : content.replaceAll("\n", "\r\n");
+}
+function appendManagedBlock(original, fragment) {
+    if (original.length === 0) {
+        return fragment;
+    }
+    const ending = lineEnding(original);
+    const convertedFragment = convertLineEndings(fragment, ending);
+    const separator = original.endsWith(`${ending}${ending}`)
+        ? ""
+        : original.endsWith(ending)
+            ? ending
+            : `${ending}${ending}`;
+    return `${original}${separator}${convertedFragment}`;
+}
+function mergeAgentsContent(original, fragment) {
+    const beginCount = markerCount(original, AGENTS_MANAGED_BLOCK_BEGIN);
+    const endCount = markerCount(original, AGENTS_MANAGED_BLOCK_END);
+    if (beginCount === 0 && endCount === 0) {
+        return appendManagedBlock(original, fragment);
+    }
+    if (beginCount !== 1 || endCount !== 1) {
+        throw new AgentsConfigMergeError("AGENTS_MARKERS_INVALID", "AGENTS.md contains partial or duplicate orchestrator markers.");
+    }
+    const begin = original.indexOf(AGENTS_MANAGED_BLOCK_BEGIN);
+    const end = original.indexOf(AGENTS_MANAGED_BLOCK_END);
+    if (begin < 0 || end < begin) {
+        throw new AgentsConfigMergeError("AGENTS_MARKERS_INVALID", "AGENTS.md orchestrator markers are out of order.");
+    }
+    const existingBlock = original.slice(begin, end + AGENTS_MANAGED_BLOCK_END.length);
+    const expectedBlock = convertLineEndings(fragment.trimEnd(), lineEnding(original));
+    if (existingBlock !== expectedBlock) {
+        throw new AgentsConfigMergeError("AGENTS_BLOCK_CONFLICT", "The existing orchestrator block in AGENTS.md differs from this package.", ["Refusing to overwrite a modified managed block."]);
+    }
+    return original;
+}
+export function mergeAgentsConfigText(source) {
+    return mergeAgentsContent(source, packagedFragment());
+}
+export function planAgentsConfigMerge(directory) {
+    const targetDirectory = resolve(directory);
+    try {
+        const stats = lstatSync(targetDirectory);
+        if (stats.isSymbolicLink() || !stats.isDirectory()) {
+            throw new AgentsConfigMergeError("TARGET_NOT_DIRECTORY", `Target is not a regular directory: ${targetDirectory}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof AgentsConfigMergeError) {
+            throw error;
+        }
+        throw new AgentsConfigMergeError("TARGET_NOT_DIRECTORY", `Target directory does not exist or cannot be read: ${targetDirectory}`, [error instanceof Error ? error.message : String(error)]);
+    }
+    const agentsPath = join(targetDirectory, "AGENTS.md");
+    let existed = false;
+    let originalContent = "";
+    try {
+        const stats = lstatSync(agentsPath);
+        if (stats.isSymbolicLink()) {
+            throw new AgentsConfigMergeError("AGENTS_SYMLINK", `Refusing to merge a symbolic-link AGENTS.md: ${agentsPath}`);
+        }
+        if (!stats.isFile()) {
+            throw new AgentsConfigMergeError("AGENTS_NOT_FILE", `AGENTS.md is not a regular file: ${agentsPath}`);
+        }
+        existed = true;
+        originalContent = readFileSync(agentsPath, "utf8");
+    }
+    catch (error) {
+        if (error instanceof AgentsConfigMergeError) {
+            throw error;
+        }
+        if (filesystemErrorCode(error) !== "ENOENT") {
+            throw new AgentsConfigMergeError("AGENTS_READ_FAILED", `Unable to read AGENTS.md: ${agentsPath}`, [error instanceof Error ? error.message : String(error)]);
+        }
+    }
+    const content = mergeAgentsConfigText(originalContent);
+    return {
+        targetDirectory,
+        agentsPath,
+        existed,
+        originalContent,
+        content,
+        changed: content !== originalContent,
+    };
+}
+//# sourceMappingURL=agents-config.js.map

package/dist/installer/agents-config.js.map

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

package/dist/installer/android-project.d.ts

@@ -0,0 +1,36 @@
+export type GradleDsl = "kotlin" | "groovy" | "mixed" | "unknown";
+export type AndroidModuleType = "application" | "library" | "dynamic-feature" | "test" | "asset-pack";
+export interface AndroidModuleDetection {
+    gradlePath: string;
+    directory: string;
+    buildFile: string;
+    dsl: Exclude<GradleDsl, "mixed" | "unknown">;
+    type: AndroidModuleType;
+    pluginIds: readonly string[];
+    namespace: string | null;
+    applicationId: string | null;
+}
+export interface GradleWrapperDetection {
+    script: string;
+    properties: string;
+    scriptPresent: boolean;
+    propertiesPresent: boolean;
+    executable: boolean;
+    complete: boolean;
+}
+export interface AndroidProjectDetection {
+    requestedDirectory: string;
+    gitRoot: string | null;
+    projectRoot: string | null;
+    projectName: string | null;
+    settingsFile: string | null;
+    dsl: GradleDsl;
+    gradleWrapper: GradleWrapperDetection | null;
+    modules: readonly AndroidModuleDetection[];
+    isGitRepository: boolean;
+    isAndroidProject: boolean;
+    warnings: readonly string[];
+    errors: readonly string[];
+}
+export declare function detectAndroidProject(targetDirectory: string): AndroidProjectDetection;
+//# sourceMappingURL=android-project.d.ts.map

package/dist/installer/android-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-project.d.ts","sourceRoot":"","sources":["../../src/installer/android-project.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAClE,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,SAAS,GACT,iBAAiB,GACjB,MAAM,GACN,YAAY,CAAC;AAEjB,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;IAC7C,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC7C,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAsWD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,GACtB,uBAAuB,CAwKzB"}