rea/tests/acceptance/applications/adbPackageInventoryCoverage.test.ts

import { writeFile } from "node:fs/promises";
import { join } from "node:path";

import { expect } from "vitest";

import { toolContract } from "../../../src/contracts/toolContracts.js";
import { parseEvidence } from "../../../src/domain/evidence.js";
import { connectLocalToolsMcp } from "../../fixtures/localToolsMcp.js";
import { createTestTempDirectory } from "../../fixtures/temporaryDirectory.js";
import { cliTest, runFileCli } from "../../support/cli/cliFixture.js";

const PACKAGE_LINE = "package:/data/app/example/base.apk=com.example.app";
const unrecognized = (count: number) =>
  Array.from(
    { length: count },
    (_, index) => `unrecognized package row ${String(index + 1)}`,
  );

cliTest.skipIf(process.platform === "win32")(
  "reports unrecognized package rows through package search and listing via CLI and MCP",
  async ({ cli }) => {
    const root = await createTestTempDirectory("rea-adb-package-coverage-");
    const binary = join(root, "adb");
    const inventory = join(root, "packages.txt");
    await writeFile(
      binary,
      `#!${process.execPath}
const args = process.argv.slice(2);
if (args[0] === 'version') {
  console.log('Android Debug Bridge version 1.0.41\\nVersion 34.0.5-fixture\\nInstalled as ' + process.argv[1]);
  process.exit(0);
}
if (args.join(' ') === '-s emulator-5554 shell pm list packages -f') {
  process.stdout.write(require('node:fs').readFileSync(${JSON.stringify(inventory)}));
  process.exit(0);
}
process.exit(91);
`,
      { mode: 0o700 },
    );
    const environment = {
      HOME: root,
      USERPROFILE: root,
      REA_ADB_PATH: binary,
      REA_LOG_LEVEL: "silent",
    };
    const { call } = await connectLocalToolsMcp(environment);

    for (const count of [0, 1, 11]) {
      const rows = unrecognized(count);
      await writeFile(inventory, [PACKAGE_LINE, ...rows, ""].join("\n"));
      const expected = {
        unparsed_lines: rows.slice(0, 10),
        coverage: count === 0 ? "complete" : "partial",
      };
      const truncation =
        "unparsed_lines reports the first 10 of 11 unrecognized lines";

      for (const [command, operation, tail] of [
        ["resolve-adb-packages", "resolve_adb_packages", ["example"]],
        ["list-adb-packages", "list_adb_packages", []],
      ] as const) {
        const invocation = {
          arguments: [command, "emulator-5554", ...tail, "--json"],
          environment,
        };
        const output = await (count === 0
          ? cli.run(invocation)
          : runFileCli(cli, invocation));
        expect(output.exitCode, output.stderr).toBe(0);
        const evidence = parseEvidence(output.json);
        expect(
          evidence.normalized_result,
          `${command} ${String(count)}`,
        ).toMatchObject(expected);
        if (count === 11) expect(evidence.limitations).toContain(truncation);
        else
          expect(evidence.limitations).not.toContain(
            expect.stringContaining("unparsed_lines"),
          );

        const installedPackage = {
          package_name: "com.example.app",
          base_apk_device_path: "/data/app/example/base.apk",
        };
        expect(evidence.normalized_result).toMatchObject(
          operation === "resolve_adb_packages"
            ? { matches: [installedPackage], exact_match: false }
            : { packages: [installedPackage], scope: "all" },
        );
        const reply = await call(
          operation,
          operation === "resolve_adb_packages"
            ? { serial: "emulator-5554", query: "example" }
            : { serial: "emulator-5554" },
        );
        expect(reply.isError).not.toBe(true);
        const structured = toolContract(operation).outputSchema.parse(
          reply.structuredContent,
        );
        expect(structured.normalized_result).toEqual(
          evidence.normalized_result,
        );
        expect(structured.limitations).toEqual(evidence.limitations);
      }
    }
  },
);