Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

1.5 KB
Raw Blame
import { satisfies, valid } from "semver";
import { WAKARU_ACCEPTED_RANGE, WAKARU_RELEASE } from "./WakaruRelease.js";

/** Admission of one observed `wakaru --version` banner. */
export type WakaruVersionAdmission =
  | { readonly status: "verified"; readonly version: string }
  | {
      readonly status: "compatible";
      readonly version: string;
      readonly limitation: string;
    }
  | { readonly status: "unsupported"; readonly message: string };

/** Caller-facing accepted releases, naming the verified build. */
export const wakaruReleaseLine = (): string =>
  `Wakaru ${WAKARU_ACCEPTED_RANGE} (verified with ${WAKARU_RELEASE.version})`;

/** Classify a `wakaru <version>` banner against the accepted release range. */
export const admitWakaruVersion = (banner: string): WakaruVersionAdmission => {
  const token = banner.startsWith("wakaru ")
    ? banner.slice("wakaru ".length)
    : undefined;
  if (
    token === undefined ||
    valid(token) !== token ||
    !satisfies(token, WAKARU_ACCEPTED_RANGE)
  )
    return {
      status: "unsupported",
      message: `Unsupported Wakaru version ${banner.length === 0 ? "missing" : banner}; accepted releases are ${wakaruReleaseLine()}`,
    };
  if (token === WAKARU_RELEASE.version)
    return { status: "verified", version: token };
  return {
    status: "compatible",
    version: token,
    limitation: `This session uses Wakaru ${token}. The report parser is verified against ${WAKARU_RELEASE.version}; other ${WAKARU_ACCEPTED_RANGE} releases are accepted and the observed version is reported.`,
  };
};