From 3793889ce8662ca8e1e92af1bb5c6ee854848467 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Mon, 13 Jul 2026 15:13:45 +0800
Subject: [PATCH 1/4] feat(setup): make installation explicit and safe
---
install.sh | 243 ++++++++++++-----------------------
package-lock.json | 23 +++-
package.json | 5 +-
scripts/verify-package.mjs | 23 +++-
src/application/Doctor.ts | 8 +-
src/application/MacHopper.ts | 236 ++++++++++++++++++++++++++++++++++
src/application/Setup.ts | 196 +++++++++++++++++-----------
src/cli.ts | 49 ++++++-
src/domain/runtimeVersion.ts | 10 ++
tests/installScript.test.ts | 161 +++++++++--------------
tests/macHopper.test.ts | 110 ++++++++++++++++
tests/setup.test.ts | 226 +++++++++++++-------------------
12 files changed, 793 insertions(+), 497 deletions(-)
create mode 100644 src/application/MacHopper.ts
create mode 100644 src/domain/runtimeVersion.ts
create mode 100644 tests/macHopper.test.ts
diff --git a/install.sh b/install.sh
index e72608dd0..454f20266 100755
--- a/install.sh
+++ b/install.sh
@@ -3,196 +3,111 @@ set -euo pipefail
PACKAGE="rea-agents"
REPOSITORY="morluto/rea"
-NODE_FORMULA="node@24"
-NODE_VERSION="24.18.0"
-temporary_directory=""
-node_destination=""
-node_stage=""
-node_backup=""
-node_version=""
-
-cleanup() {
- if [[ -n "$temporary_directory" && -d "$temporary_directory" ]]; then
- rm -rf -- "$temporary_directory"
- fi
- if [[ -n "$node_stage" && -e "$node_stage" ]]; then
- rm -rf -- "$node_stage"
- fi
- if [[ -n "$node_backup" && -e "$node_backup" && ! -e "$node_destination" ]]; then
- mv -- "$node_backup" "$node_destination"
- fi
-}
-trap cleanup EXIT HUP INT TERM
+version="${REA_VERSION:-}"
+dry_run=false
+start_setup=true
+verbose=false
fail() {
printf 'REA installation failed: %s\n' "$1" >&2
exit 1
}
-version_at_least() {
- local actual="$1" required_major="$2" required_minor="$3"
- local major minor
- major="${actual%%.*}"
- minor="${actual#*.}"
- minor="${minor%%.*}"
- [[ "$major" =~ ^[0-9]+$ && "$minor" =~ ^[0-9]+$ ]] || return 1
- ((major > required_major || (major == required_major && minor >= required_minor)))
+usage() {
+ cat <<'EOF'
+Usage: install.sh [--version VERSION] [--dry-run] [--no-setup] [--no-prompt] [--verbose]
+
+Installs only the REA CLI. Run `rea setup` separately to configure Hopper and coding agents.
+EOF
}
-platform="$(uname -s)"
-if [[ "$platform" == "Darwin" ]]; then
- macos_version="$(sw_vers -productVersion 2>/dev/null)" || fail "could not determine the macOS version."
- macos_major="${macos_version%%.*}"
- [[ "$macos_major" =~ ^[0-9]+$ && "$macos_major" -ge 12 ]] || fail "macOS 12 or newer is required."
-elif [[ "$platform" == "Linux" ]]; then
- [[ "$(uname -m)" == "x86_64" || "$(uname -m)" == "aarch64" ]] || fail "64-bit x86 or ARM Linux is required."
- [[ -r /etc/os-release ]] || fail "could not identify the Linux distribution."
- linux_id="$(sed -n 's/^ID=//p' /etc/os-release | tr -d '"')"
- linux_version="$(sed -n 's/^VERSION_ID=//p' /etc/os-release | tr -d '"')"
- case "$linux_id" in
- ubuntu) [[ "${linux_version%%.*}" -ge 24 ]] || fail "Ubuntu 24.04 or newer is required." ;;
- fedora) [[ "${linux_version%%.*}" -ge 41 ]] || fail "Fedora 41 or newer is required." ;;
- arch) ;;
- *) fail "supported Linux distributions are Ubuntu 24.04+, Fedora 41+, and Arch Linux." ;;
+while (($# > 0)); do
+ case "$1" in
+ --version)
+ (($# >= 2)) || fail "--version requires a value."
+ version="$2"
+ shift 2
+ ;;
+ --dry-run)
+ dry_run=true
+ shift
+ ;;
+ --no-setup|--no-prompt)
+ start_setup=false
+ shift
+ ;;
+ --verbose)
+ verbose=true
+ shift
+ ;;
+ --help|-h)
+ usage
+ exit 0
+ ;;
+ *) fail "unknown option: $1" ;;
esac
-else
- fail "REA supports macOS and selected 64-bit Linux distributions."
+done
+
+if [[ "$verbose" == true ]]; then
+ set -x
fi
+
+platform="$(uname -s)"
+[[ "$platform" == "Darwin" || "$platform" == "Linux" ]] || fail "REA supports macOS and selected 64-bit Linux distributions."
command -v curl >/dev/null 2>&1 || fail "curl is required."
-command -v shasum >/dev/null 2>&1 || command -v sha256sum >/dev/null 2>&1 || fail "shasum or sha256sum is required."
+command -v node >/dev/null 2>&1 || fail "Node.js 22.19+ or 24.11+ is required; install it from https://nodejs.org and retry."
+command -v npm >/dev/null 2>&1 || fail "npm is required; install it with Node.js and retry."
-if [[ "$platform" == "Darwin" ]] && ! command -v brew >/dev/null 2>&1; then
- printf 'Installing Homebrew prerequisite...\n'
- NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" || fail "Homebrew installation did not complete."
- if [[ -x /opt/homebrew/bin/brew ]]; then
- PATH="/opt/homebrew/bin:$PATH"
- elif [[ -x /usr/local/bin/brew ]]; then
- PATH="/usr/local/bin:$PATH"
- fi
-fi
-if [[ "$platform" == "Darwin" ]]; then
- command -v brew >/dev/null 2>&1 || fail "Homebrew is not available after installation."
-fi
-
-node_compatible=false
-if command -v node >/dev/null 2>&1; then
- node_version="$(node -p 'process.versions.node' 2>/dev/null || true)"
-fi
-if version_at_least "$node_version" 24 18 && [[ "$node_version" =~ ^24\. ]]; then
- node_compatible=true
-fi
-if [[ "$node_compatible" != true ]]; then
- if [[ "$platform" == "Darwin" ]]; then
- brew install "$NODE_FORMULA" || fail "Node.js 24 installation failed."
- node_prefix="$(brew --prefix "$NODE_FORMULA")" || fail "could not locate Node.js 24."
- PATH="$node_prefix/bin:$PATH"
- else
- machine="$(uname -m)"
- node_arch="$([[ "$machine" == "x86_64" ]] && printf 'x64' || printf 'arm64')"
- node_archive="node-v${NODE_VERSION}-linux-${node_arch}.tar.xz"
- node_base="https://nodejs.org/dist/v${NODE_VERSION}"
- temporary_directory="$(mktemp -d "${TMPDIR:-/tmp}/rea-install.XXXXXX")" || fail "could not create a temporary directory."
- curl -fsSL "$node_base/$node_archive" -o "$temporary_directory/$node_archive" || fail "Node.js download failed."
- curl -fsSL "$node_base/SHASUMS256.txt" -o "$temporary_directory/SHASUMS256.txt" || fail "Node.js checksum download failed."
- expected_checksum="$(awk -v archive="$node_archive" '$2 == archive { print $1 }' "$temporary_directory/SHASUMS256.txt")"
- [[ "$expected_checksum" =~ ^[a-f0-9]{64}$ ]] || fail "Node.js checksum metadata was malformed."
- if command -v shasum >/dev/null 2>&1; then
- actual_checksum="$(shasum -a 256 "$temporary_directory/$node_archive" | awk '{ print $1 }')"
- else
- actual_checksum="$(sha256sum "$temporary_directory/$node_archive" | awk '{ print $1 }')"
- fi
- [[ "$actual_checksum" == "$expected_checksum" ]] || fail "Node.js checksum verification failed."
- node_destination="$HOME/.local/share/rea/node"
- node_stage="$HOME/.local/share/rea/node.new.$$"
- node_backup="$HOME/.local/share/rea/node.backup.$$"
- [[ ! -L "$node_destination" ]] || fail "refusing to replace a symlinked Node.js installation."
- mkdir -p "$HOME/.local/share/rea"
- rm -rf -- "$node_stage" "$node_backup"
- mkdir "$node_stage"
- tar -xJf "$temporary_directory/$node_archive" --strip-components=1 -C "$node_stage" || fail "Node.js extraction failed."
- if [[ -e "$node_destination" ]]; then
- mv -- "$node_destination" "$node_backup"
- fi
- if ! mv -- "$node_stage" "$node_destination"; then
- [[ ! -e "$node_backup" ]] || mv -- "$node_backup" "$node_destination"
- fail "Node.js installation replacement failed."
- fi
- node_stage=""
- rm -rf -- "$node_backup"
- node_backup=""
- PATH="$node_destination/bin:$PATH"
- fi
-fi
node_version="$(node -p 'process.versions.node' 2>/dev/null || true)"
-if ! command -v node >/dev/null 2>&1 || ! version_at_least "$node_version" 24 18 || [[ ! "$node_version" =~ ^24\. ]]; then
- fail "Node.js 24.18 or newer is not active on PATH."
+IFS=. read -r node_major node_minor _node_patch <<<"$node_version"
+[[ "$node_major" =~ ^[0-9]+$ && "$node_minor" =~ ^[0-9]+$ ]] || fail "could not determine the active Node.js version."
+if ! ((node_major == 22 && node_minor >= 19 || node_major >= 24)); then
+ fail "Node.js $node_version is unsupported; use Node.js 22.19+ or 24.11+."
fi
-command -v npm >/dev/null 2>&1 || fail "npm is missing from the Node.js installation."
-npm_version="$(npm --version)"
-if [[ ! "$npm_version" =~ ^11\. ]] || ! version_at_least "$npm_version" 11 16; then
- if [[ "$platform" == "Linux" ]]; then
- npm install --global --prefix "$HOME/.local" npm@11 || fail "npm 11 installation failed."
- else
- npm install --global npm@11 || fail "npm 11 installation failed."
- fi
-fi
-npm_version="$(npm --version)"
-if [[ ! "$npm_version" =~ ^11\. ]] || ! version_at_least "$npm_version" 11 16; then
- fail "npm 11.16 or newer is not active on PATH."
-fi
-if [[ -n "$temporary_directory" ]]; then
- rm -rf -- "$temporary_directory"
- temporary_directory=""
+if ((node_major == 24 && node_minor < 11)); then
+ fail "Node.js $node_version is unsupported; use Node.js 24.11 or newer."
fi
-if [[ -n "${REA_VERSION:-}" ]]; then
- version="$REA_VERSION"
- [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]] || fail "REA_VERSION must be an exact semantic version."
+if [[ -n "$version" ]]; then
+ [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]] || fail "version must be an exact semantic version."
else
- release_json="$(curl -fsSL -H 'Accept: application/vnd.github+json' "https://api.github.com/repos/$REPOSITORY/releases/latest")" || fail "could not resolve the latest GitHub release."
+ release_json="$(curl -fsSL --proto '=https' --tlsv1.2 --retry 3 -H 'Accept: application/vnd.github+json' "https://api.github.com/repos/$REPOSITORY/releases/latest")" || fail "could not resolve the latest GitHub release."
tag="$(printf '%s' "$release_json" | node -e 'let s="";process.stdin.on("data",c=>s+=c).on("end",()=>{const v=JSON.parse(s).tag_name;if(typeof v!=="string")process.exit(1);process.stdout.write(v)})')" || fail "GitHub returned malformed release metadata."
[[ "$tag" =~ ^rea-agents-([0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?)$ ]] || fail "latest release tag is not a valid rea-agents release."
version="${BASH_REMATCH[1]}"
fi
-printf 'Installing %s@%s...\n' "$PACKAGE" "$version"
+prefix_args=()
if [[ "$platform" == "Linux" ]]; then
- mkdir -p "$HOME/.local/bin"
- PATH="$HOME/.local/bin:$PATH"
- npm install --global --prefix "$HOME/.local" "$PACKAGE@$version" || fail "npm package installation failed."
+ prefix_args=(--prefix "$HOME/.local")
+ install_bin="$HOME/.local/bin/rea"
else
- npm install --global "$PACKAGE@$version" || fail "npm package installation failed."
+ npm_prefix="$(npm prefix --global)" || fail "could not determine the npm global prefix."
+ install_bin="$npm_prefix/bin/rea"
fi
-command -v rea >/dev/null 2>&1 || fail "the rea command is not available after installation."
-installed_version="$(rea --version 2>/dev/null | tr -d '[:space:]')" || fail "could not read the installed REA version."
+
+printf 'REA install plan\n'
+printf ' Version: %s\n' "$version"
+printf ' Runtime: Node.js %s\n' "$node_version"
+printf ' Command: npm install --global %s@%s\n' "$PACKAGE" "$version"
+printf ' Binary: %s\n' "$install_bin"
+printf ' Setup: %s\n' "$([[ "$start_setup" == true ]] && printf 'start when a terminal is available' || printf 'skipped')"
+
+if [[ "$dry_run" == true ]]; then
+ printf 'Dry run complete; no changes made.\n'
+ exit 0
+fi
+
+printf 'Installing %s@%s...\n' "$PACKAGE" "$version"
+npm install --global "${prefix_args[@]}" "$PACKAGE@$version" || fail "npm package installation failed."
+[[ -x "$install_bin" ]] || fail "the rea command was not installed at $install_bin."
+installed_version="$("$install_bin" --version 2>/dev/null | tr -d '[:space:]')" || fail "could not read the installed REA version."
[[ "$installed_version" == "$version" ]] || fail "installed version $installed_version does not match $version."
-temporary_directory="$(mktemp -d "${TMPDIR:-/tmp}/rea-install.XXXXXX")" || fail "could not create a temporary directory."
-setup_output="$temporary_directory/setup.json"
-doctor_output="$temporary_directory/doctor.json"
-rea setup --yes --json >"$setup_output" || fail "REA setup command failed."
-rea doctor --json >"$doctor_output" || fail "REA doctor command failed."
-result="$(node - "$setup_output" "$doctor_output" <<'NODE'
-const fs = require("node:fs");
-const [setupPath, doctorPath] = process.argv.slice(2);
-try {
- const setup = JSON.parse(fs.readFileSync(setupPath, "utf8"));
- const doctor = JSON.parse(fs.readFileSync(doctorPath, "utf8"));
- if (!Array.isArray(doctor.checks) || typeof doctor.healthy !== "boolean") process.exit(2);
- if (setup.status !== "ready" && setup.status !== "needs_human") process.exit(2);
- const activation = setup.actions.includes("installed_hopper");
- if (!doctor.healthy && !activation) process.exit(3);
- process.stdout.write(activation ? "activation" : "ready");
-} catch { process.exit(2); }
-NODE
-)" || fail "setup or doctor reported an unhealthy required component or malformed output."
-
-if [[ "$result" == "activation" ]]; then
- printf 'REA %s is installed and coding agents are configured.\n' "$version"
- printf 'One user action remains: open Hopper, complete its activation, then run: rea doctor --json\n'
+printf 'REA %s is installed.\n' "$version"
+if [[ "$start_setup" == true && -r /dev/tty && -w /dev/tty && -t 1 ]]; then
+ printf 'Starting REA setup...\n'
+ "$install_bin" setup /dev/tty
else
- printf 'REA %s is installed and ready. Run rea doctor --json at any time.\n' "$version"
-fi
-if [[ "$platform" == "Linux" ]]; then
- printf 'Add %s to PATH to run rea from future shells.\n' "$HOME/.local/bin"
+ printf 'Run %s setup to configure Hopper and coding agents.\n' "$install_bin"
fi
diff --git a/package-lock.json b/package-lock.json
index f7dc23bf2..a8c8717c3 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -25,7 +25,7 @@
"pino": "9.14.0",
"plist": "5.0.0",
"smol-toml": "^1.7.0",
- "write-file-atomic": "8.0.0",
+ "write-file-atomic": "7.0.0",
"ws": "8.21.0",
"zod": "4.4.3"
},
@@ -50,8 +50,7 @@
"vitest": "4.1.10"
},
"engines": {
- "node": ">=24.18.0 <25",
- "npm": ">=11.16.0 <12"
+ "node": "^22.19.0 || >=24.11.0"
}
},
"node_modules/@babel/helper-string-parser": {
@@ -2814,6 +2813,15 @@
"node": ">= 4"
}
},
+ "node_modules/imurmurhash": {
+ "version": "0.1.4",
+ "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
+ "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.8.19"
+ }
+ },
"node_modules/incur": {
"version": "0.4.13",
"resolved": "https://registry.npmjs.org/incur/-/incur-0.4.13.tgz",
@@ -5023,15 +5031,16 @@
"license": "ISC"
},
"node_modules/write-file-atomic": {
- "version": "8.0.0",
- "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-8.0.0.tgz",
- "integrity": "sha512-dYwyZredl67GyLLIHJnRM3h2PcOmN5SkcgC7eM5DPDEOEl6dLFqVrMg3F1Ea32usj4VSVZtd2H4MtKTNOf6nPg==",
+ "version": "7.0.0",
+ "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-7.0.0.tgz",
+ "integrity": "sha512-YnlPC6JqnZl6aO4uRc+dx5PHguiR9S6WeoLtpxNT9wIG+BDya7ZNE1q7KOjVgaA73hKhKLpVPgJ5QA9THQ5BRg==",
"license": "ISC",
"dependencies": {
+ "imurmurhash": "^0.1.4",
"signal-exit": "^4.0.1"
},
"engines": {
- "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+ "node": "^20.17.0 || >=22.9.0"
}
},
"node_modules/ws": {
diff --git a/package.json b/package.json
index fad7d5e5d..f5f9cd565 100644
--- a/package.json
+++ b/package.json
@@ -33,8 +33,7 @@
"rea": "scripts/rea.mjs"
},
"engines": {
- "node": ">=24.18.0 <25",
- "npm": ">=11.16.0 <12"
+ "node": "^22.19.0 || >=24.11.0"
},
"packageManager": "npm@11.16.0",
"files": [
@@ -99,7 +98,7 @@
"pino": "9.14.0",
"plist": "5.0.0",
"smol-toml": "^1.7.0",
- "write-file-atomic": "8.0.0",
+ "write-file-atomic": "7.0.0",
"ws": "8.21.0",
"zod": "4.4.3"
},
diff --git a/scripts/verify-package.mjs b/scripts/verify-package.mjs
index 78d718082..ef193b86f 100644
--- a/scripts/verify-package.mjs
+++ b/scripts/verify-package.mjs
@@ -324,15 +324,32 @@ try {
await writeFile(skillPath, "stale managed skill\n");
await writeFile(siblingSkillPath, "unrelated skill\n");
}
+ const planned = json(await run(cli, ["setup", "--json"], environment));
+ if (supportedSetupHost) {
+ if (
+ planned.status !== "needs_confirmation" ||
+ planned.appliedActions.length !== 0 ||
+ !planned.plannedActions.some(({ kind }) => kind === "configure_client") ||
+ !planned.plannedActions.some(({ kind }) => kind === "install_skill") ||
+ (await readFile(claudeConfig, "utf8")) !== '{"existing":true}\n' ||
+ (await readFile(cursorConfig, "utf8")) !== '{"existing":true}\n' ||
+ (await readFile(skillPath, "utf8")) !== "stale managed skill\n"
+ )
+ throw new Error("packaged setup plan mutated files before approval");
+ }
const first = json(await run(cli, ["setup", "--yes", "--json"], environment));
const second = json(
- await run(cli, ["setup", "--yes", "--json"], environment),
+ await run(
+ cli,
+ ["setup", "--yes", "--install-hopper", "--json"],
+ environment,
+ ),
);
if (supportedSetupHost) {
if (
first.status !== "ready" ||
second.status !== "ready" ||
- second.actions.length !== 0
+ second.appliedActions.length !== 0
)
throw new Error("packaged setup was not ready and idempotent");
for (const configPath of [claudeConfig, cursorConfig]) {
@@ -467,7 +484,7 @@ try {
}
process.stdout.write(
- `${JSON.stringify({ cli: true, analysisCli: true, artifactCli: true, evidenceCli: true, incurMcpCommand: "npx -y rea-agents mcp", doctor: "platform-appropriate", setup: supportedSetupHost ? "idempotent" : "unsupported-host-rejected", clients: supportedSetupHost ? 2 : 0, backupReadback: supportedSetupHost, failureRecovery: supportedSetupHost, skill: supportedSetupHost, mcpTools: expectedToolCount, evidenceMcp: true, targetFree: true, targetLifecycle: true })}\n`,
+ `${JSON.stringify({ cli: true, analysisCli: true, artifactCli: true, evidenceCli: true, incurMcpCommand: "npx -y rea-agents mcp", doctor: "platform-appropriate", setup: supportedSetupHost ? "planned-then-idempotent" : "unsupported-host-rejected", setupPlanReadOnly: supportedSetupHost, existingHopperPreserved: supportedSetupHost, clients: supportedSetupHost ? 2 : 0, backupReadback: supportedSetupHost, failureRecovery: supportedSetupHost, skill: supportedSetupHost, mcpTools: expectedToolCount, evidenceMcp: true, targetFree: true, targetLifecycle: true })}\n`,
);
} finally {
if (tarball) await rm(join(root, tarball), { force: true });
diff --git a/src/application/Doctor.ts b/src/application/Doctor.ts
index 7eff0f43a..3a737d85e 100644
--- a/src/application/Doctor.ts
+++ b/src/application/Doctor.ts
@@ -7,6 +7,7 @@ import { execFile } from "node:child_process";
import { promisify } from "node:util";
import { parseBinaryTarget } from "../domain/binaryTarget.js";
+import { supportsNodeVersion } from "../domain/runtimeVersion.js";
import { probeHomebrew } from "./homebrew.js";
import {
linuxHopperLauncherPath,
@@ -60,10 +61,9 @@ export const runDoctor = async (
readonly checks: readonly DoctorCheck[];
}> => {
const checks: DoctorCheck[] = [];
- const nodeMajor = parseMajor(host.nodeVersion);
checks.push(
- check("node", nodeMajor >= 24, host.nodeVersion, {
- remediation: "Install Node.js 24.18 or newer.",
+ check("node", supportsNodeVersion(host.nodeVersion), host.nodeVersion, {
+ remediation: "Install Node.js 22.19+ or 24.11+.",
classification: "missing_dependency",
}),
);
@@ -107,7 +107,7 @@ export const runDoctor = async (
checks.push(
check("hopper", hopperPath !== undefined, hopperPath, {
remediation:
- "Run rea setup --yes to install Hopper, or set HOPPER_LAUNCHER_PATH.",
+ "Run rea setup to install Hopper, or set HOPPER_LAUNCHER_PATH.",
classification: "missing_analysis_engine",
}),
);
diff --git a/src/application/MacHopper.ts b/src/application/MacHopper.ts
new file mode 100644
index 000000000..62e217719
--- /dev/null
+++ b/src/application/MacHopper.ts
@@ -0,0 +1,236 @@
+import { createHash } from "node:crypto";
+import { execFile } from "node:child_process";
+import {
+ access,
+ mkdir,
+ mkdtemp,
+ readdir,
+ rename,
+ rm,
+ writeFile,
+} from "node:fs/promises";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+
+import { z } from "zod";
+
+const execFileAsync = promisify(execFile);
+const RELEASES_URL =
+ "https://www.hopperapp.com/include/files-api.php?request=releases&public=true";
+const DOWNLOAD_PREFIX = "https://www.hopperapp.com:443/downloader/public/";
+const MAX_PACKAGE_BYTES = 100_000_000;
+const BUNDLE_IDENTIFIER = "com.cryptic-apps.hopper-web-4";
+
+/** Result of installing the official Hopper macOS application. */
+export type MacHopperInstallResult =
+ | { readonly status: "installed"; readonly launcherPath: string }
+ | {
+ readonly status: "failed";
+ readonly reason:
+ | "release_metadata"
+ | "download"
+ | "integrity"
+ | "mount"
+ | "bundle"
+ | "destination_exists"
+ | "copy"
+ | "launcher_missing";
+ };
+
+/** External effects used by the bounded macOS Hopper installer. */
+export interface MacHopperInstallHost {
+ download(
+ url: string,
+ ): Promise<{ readonly ok: boolean; readonly bytes: Uint8Array }>;
+ createTemporaryDirectory(): Promise;
+ createMountDirectory(path: string): Promise;
+ writePackage(path: string, bytes: Uint8Array): Promise;
+ mount(packagePath: string, mountPath: string): Promise;
+ unmount(mountPath: string): Promise;
+ appBundle(mountPath: string): Promise;
+ validBundle(appPath: string): Promise;
+ destinationExists(path: string): Promise;
+ installBundle(
+ source: string,
+ destination: string,
+ stage: string,
+ ): Promise;
+ launcherReady(path: string): Promise;
+ openApplication(path: string): Promise;
+ cleanup(path: string): Promise;
+ destination(): string;
+}
+
+/** Download, verify, and install Hopper into the current user's Applications directory. */
+export const installMacHopper = async (
+ host: MacHopperInstallHost = systemMacHopperInstallHost(),
+): Promise => {
+ let temporary: string | undefined;
+ let mounted = false;
+ try {
+ const metadata = await host.download(RELEASES_URL);
+ if (!metadata.ok) return { status: "failed", reason: "release_metadata" };
+ const parsed = releasesSchema.safeParse(parseJson(metadata.bytes));
+ if (!parsed.success)
+ return { status: "failed", reason: "release_metadata" };
+ const release = parsed.data["OS X"];
+ if (!release.filename.startsWith(DOWNLOAD_PREFIX))
+ return { status: "failed", reason: "release_metadata" };
+ const archive = await host.download(release.filename);
+ if (!archive.ok) return { status: "failed", reason: "download" };
+ if (!integrityMatches(archive.bytes, release))
+ return { status: "failed", reason: "integrity" };
+
+ const destination = host.destination();
+ if (await host.destinationExists(destination))
+ return { status: "failed", reason: "destination_exists" };
+ temporary = await host.createTemporaryDirectory();
+ const packagePath = join(temporary, "hopper.dmg");
+ const mountPath = join(temporary, "mounted");
+ await host.createMountDirectory(mountPath);
+ await host.writePackage(packagePath, archive.bytes);
+ if (!(await host.mount(packagePath, mountPath)))
+ return { status: "failed", reason: "mount" };
+ mounted = true;
+ const source = await host.appBundle(mountPath);
+ if (source === undefined || !(await host.validBundle(source)))
+ return { status: "failed", reason: "bundle" };
+ const stage = `${destination}.rea-stage`;
+ if (!(await host.installBundle(source, destination, stage)))
+ return { status: "failed", reason: "copy" };
+ const launcherPath = join(destination, "Contents/MacOS/hopper");
+ if (!(await host.launcherReady(launcherPath)))
+ return { status: "failed", reason: "launcher_missing" };
+ await host.openApplication(destination);
+ return { status: "installed", launcherPath };
+ } catch {
+ return { status: "failed", reason: "download" };
+ } finally {
+ if (temporary !== undefined) {
+ const mountPath = join(temporary, "mounted");
+ if (mounted) await host.unmount(mountPath);
+ await host.cleanup(temporary);
+ }
+ }
+};
+
+const systemMacHopperInstallHost = (): MacHopperInstallHost => ({
+ async download(url) {
+ const response = await fetch(url, {
+ headers: { accept: "application/json", "user-agent": "rea-installer" },
+ signal: AbortSignal.timeout(120_000),
+ });
+ const length = Number(response.headers.get("content-length") ?? "0");
+ if (length > MAX_PACKAGE_BYTES)
+ return { ok: false, bytes: new Uint8Array() };
+ const bytes = new Uint8Array(await response.arrayBuffer());
+ return { ok: response.ok && bytes.byteLength <= MAX_PACKAGE_BYTES, bytes };
+ },
+ createTemporaryDirectory: () => mkdtemp(join(tmpdir(), "rea-hopper-mac-")),
+ createMountDirectory: (path) => mkdir(path),
+ writePackage: (path, bytes) => writeFile(path, bytes, { mode: 0o600 }),
+ async mount(packagePath, mountPath) {
+ return commandSucceeds("hdiutil", [
+ "attach",
+ "-readonly",
+ "-nobrowse",
+ "-mountpoint",
+ mountPath,
+ packagePath,
+ ]);
+ },
+ async unmount(mountPath) {
+ await commandSucceeds("hdiutil", ["detach", mountPath, "-force"]);
+ },
+ async appBundle(mountPath) {
+ const entries = await readdir(mountPath, { withFileTypes: true });
+ const app = entries.find(
+ (entry) => entry.isDirectory() && /^Hopper.*\.app$/iu.test(entry.name),
+ );
+ return app === undefined ? undefined : join(mountPath, app.name);
+ },
+ async validBundle(appPath) {
+ if (
+ !(await commandSucceeds("codesign", [
+ "--verify",
+ "--deep",
+ "--strict",
+ appPath,
+ ]))
+ )
+ return false;
+ try {
+ const identifier = (
+ await execFileAsync("/usr/libexec/PlistBuddy", [
+ "-c",
+ "Print :CFBundleIdentifier",
+ join(appPath, "Contents/Info.plist"),
+ ])
+ ).stdout.trim();
+ return identifier === BUNDLE_IDENTIFIER;
+ } catch {
+ return false;
+ }
+ },
+ async destinationExists(path) {
+ try {
+ await access(path);
+ return true;
+ } catch {
+ return false;
+ }
+ },
+ async installBundle(source, destination, stage) {
+ try {
+ await mkdir(join(homedir(), "Applications"), { recursive: true });
+ await rm(stage, { recursive: true, force: true });
+ await execFileAsync("ditto", [source, stage]);
+ await rename(stage, destination);
+ return true;
+ } catch {
+ await rm(stage, { recursive: true, force: true });
+ return false;
+ }
+ },
+ async launcherReady(path) {
+ try {
+ await access(path);
+ return true;
+ } catch {
+ return false;
+ }
+ },
+ async openApplication(path) {
+ await execFileAsync("open", [path]);
+ },
+ cleanup: (path) => rm(path, { recursive: true, force: true }),
+ destination: () => join(homedir(), "Applications/Hopper Disassembler.app"),
+});
+
+const parseJson = (bytes: Uint8Array): unknown =>
+ JSON.parse(new TextDecoder().decode(bytes));
+const integrityMatches = (
+ bytes: Uint8Array,
+ release: z.infer,
+): boolean =>
+ bytes.byteLength === Number(release.file_length) &&
+ bytes.byteLength <= MAX_PACKAGE_BYTES &&
+ createHash("sha1").update(bytes).digest("hex") === release.file_hash;
+const commandSucceeds = async (
+ command: string,
+ args: readonly string[],
+): Promise => {
+ try {
+ await execFileAsync(command, args);
+ return true;
+ } catch {
+ return false;
+ }
+};
+const releaseSchema = z.object({
+ filename: z.string().url(),
+ file_length: z.string().regex(/^\d+$/u),
+ file_hash: z.string().regex(/^[a-f0-9]{40}$/u),
+});
+const releasesSchema = z.object({ "OS X": releaseSchema });
diff --git a/src/application/Setup.ts b/src/application/Setup.ts
index a408aee59..e60052b7b 100644
--- a/src/application/Setup.ts
+++ b/src/application/Setup.ts
@@ -9,22 +9,19 @@ import {
} from "node:fs/promises";
import { homedir } from "node:os";
import { dirname, join, resolve } from "node:path";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
import { z } from "zod";
import writeFileAtomic from "write-file-atomic";
import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
import { PRODUCT_IDENTITY } from "../identity.js";
+import { supportsNodeVersion } from "../domain/runtimeVersion.js";
import { runDoctor, systemDoctorHost } from "./Doctor.js";
-import { probeHomebrew } from "./homebrew.js";
import {
installLinuxHopper,
readLinuxDistribution,
type LinuxDistribution,
} from "./LinuxHopper.js";
-
-const execFileAsync = promisify(execFile);
+import { installMacHopper } from "./MacHopper.js";
const registrationCommand = (): readonly string[] =>
process.env.npm_command === "exec"
@@ -58,14 +55,12 @@ export interface SetupHost {
readonly nodeVersion: string;
macosVersion(): Promise;
linuxDistribution(): Promise;
- hasHomebrew(): Promise;
- installHomebrew(): Promise;
hopperPath(): Promise;
- installHopper(): Promise;
+ installHopper(): Promise;
detectedClients(): Promise;
configureClient(
client: SetupClient,
- hopperPath: string,
+ hopperPath: string | undefined,
command: readonly string[],
): Promise;
installSkill(): Promise<"installed" | "unchanged" | "failed">;
@@ -77,56 +72,126 @@ export interface SetupHost {
* prompt, avoiding deadlocks in stdio and other unattended environments.
*/
export interface SetupResult {
- readonly status: "ready" | "needs_human";
- readonly actions: readonly string[];
+ readonly status: "planned" | "needs_confirmation" | "ready" | "needs_human";
+ readonly plannedActions: readonly SetupAction[];
+ readonly appliedActions: readonly string[];
readonly clients: Readonly>;
readonly doctor: Awaited>;
readonly remediation?: string;
}
+/** One concrete setup mutation disclosed before approval. */
+export interface SetupAction {
+ readonly kind: "install_hopper" | "configure_client" | "install_skill";
+ readonly target: string;
+ readonly detail: string;
+ readonly external: boolean;
+}
+
+/** Explicit authorization supplied by an interactive or unattended CLI adapter. */
+export interface SetupOptions {
+ readonly approved: boolean;
+ readonly installHopper: boolean;
+ readonly structured: boolean;
+}
+
+/** Adapter-owned interactive confirmation for a fully discovered setup plan. */
+export type SetupConfirmation = (
+ actions: readonly SetupAction[],
+) => Promise;
+
/**
* Install prerequisites and configure detected clients idempotently.
- * With `yes` false, mutations requiring consent are reported as `needs_human`;
- * with `yes` true, external installers still fail closed if they require UI.
+ * Discovery always precedes mutation. Interactive confirmation or explicit
+ * unattended options authorize only the actions represented in the result.
*/
export const runSetup = async (
- yes: boolean,
+ options: SetupOptions,
host: SetupHost = systemSetupHost(),
+ confirm?: SetupConfirmation,
): Promise => {
- const actions: string[] = [];
+ const appliedActions: string[] = [];
+ let plannedActions: readonly SetupAction[] = [];
const clients: Record = {};
const fail = async (remediation: string): Promise => ({
status: "needs_human",
- actions,
+ plannedActions,
+ appliedActions,
clients,
doctor: await host.doctor(),
remediation,
});
const unsupported = await hostRemediation(host);
if (unsupported !== undefined) return fail(unsupported);
- if (host.platform === "darwin" && !(await host.hasHomebrew())) {
- if (!yes) return fail("Re-run with --yes to install Homebrew.");
- if (!(await host.installHomebrew()))
- return fail(
- "Homebrew installation was interrupted; resolve the installer prompt and re-run setup.",
- );
- actions.push("installed_homebrew");
- }
let hopperPath = await host.hopperPath();
- if (hopperPath === undefined) {
- if (!yes) return fail("Re-run with --yes to install Hopper.");
- if (!(await host.installHopper()))
- return fail(
- "Hopper installation was interrupted; resolve the system prompt and re-run setup.",
- );
- actions.push("installed_hopper");
- hopperPath = await host.hopperPath();
- if (hopperPath === undefined)
- return fail(
- "Hopper installation completed but its launcher was not found.",
- );
+ const detectedClients = await host.detectedClients();
+ plannedActions = [
+ ...(hopperPath === undefined
+ ? [
+ {
+ kind: "install_hopper" as const,
+ target:
+ host.platform === "darwin"
+ ? "~/Applications/Hopper Disassembler.app"
+ : "system package manager",
+ detail:
+ "Download the official Hopper package, verify it, install it, and open Hopper for activation.",
+ external: true,
+ },
+ ]
+ : []),
+ ...detectedClients
+ .filter(({ format }) => format !== "unsupported")
+ .map(
+ (client): SetupAction => ({
+ kind: "configure_client",
+ target: client.configPath,
+ detail: `Add the REA MCP registration for ${client.name}; preserve unrelated configuration.`,
+ external: false,
+ }),
+ ),
+ {
+ kind: "install_skill",
+ target: "~/.agents/skills/rea-analysis/SKILL.md",
+ detail: "Install or update the bundled REA analysis skill.",
+ external: false,
+ },
+ ];
+ let approved = options.approved;
+ let interactiveApproval = false;
+ if (!approved && confirm !== undefined && !options.structured) {
+ interactiveApproval = await confirm(plannedActions);
+ approved = interactiveApproval;
}
- for (const client of await host.detectedClients()) {
+ if (!approved)
+ return {
+ status: confirm === undefined ? "needs_confirmation" : "planned",
+ plannedActions,
+ appliedActions,
+ clients,
+ doctor: await host.doctor(),
+ remediation:
+ "Review the setup plan, then rerun interactively or with --yes.",
+ };
+
+ if (
+ hopperPath === undefined &&
+ (interactiveApproval || options.installHopper)
+ ) {
+ hopperPath = await host.installHopper();
+ if (hopperPath === undefined)
+ return {
+ status: "needs_human",
+ plannedActions,
+ appliedActions,
+ clients,
+ doctor: await host.doctor(),
+ remediation:
+ "Hopper installation failed; install Hopper manually or rerun setup after resolving the reported system error.",
+ };
+ appliedActions.push("installed_hopper");
+ }
+ for (const client of detectedClients) {
const result = await host.configureClient(
client,
hopperPath,
@@ -138,18 +203,19 @@ export const runSetup = async (
`${client.name} configuration ${result.reason} verification failed; no successful configuration was reported.`,
);
if (result.status === "configured")
- actions.push(`configured_${client.name}`);
+ appliedActions.push(`configured_${client.name}`);
}
const skill = await host.installSkill();
if (skill === "failed")
return fail("Agent skill installation or readback failed.");
- if (skill === "installed") actions.push("installed_skill");
+ if (skill === "installed") appliedActions.push("installed_skill");
const doctor = await host.doctor();
- const activationRequired = actions.includes("installed_hopper");
+ const activationRequired = appliedActions.includes("installed_hopper");
const ready = doctor.healthy && !activationRequired;
return {
status: ready ? "ready" : "needs_human",
- actions,
+ plannedActions,
+ appliedActions,
clients,
doctor,
...(ready
@@ -157,7 +223,9 @@ export const runSetup = async (
: {
remediation: activationRequired
? "Open Hopper, complete its one-time activation, then rerun rea doctor --json."
- : "Run rea doctor and apply each reported remediation.",
+ : hopperPath === undefined
+ ? "Hopper is optional for non-Hopper providers. Rerun with --yes --install-hopper for deep native analysis."
+ : "Run rea doctor and apply each reported remediation.",
}),
};
};
@@ -167,7 +235,8 @@ const hostRemediation = async (
): Promise => {
if (host.platform !== "darwin" && host.platform !== "linux")
return "REA supports Hopper on macOS and selected 64-bit Linux distributions.";
- if (major(host.nodeVersion) < 24) return "Install Node.js 24.18 or newer.";
+ if (!supportsNodeVersion(host.nodeVersion))
+ return "Install Node.js 22.19+ or 24.11+ and rerun setup.";
if (host.platform === "darwin") {
const version = await host.macosVersion();
return version === undefined || major(version) < 12
@@ -179,7 +248,7 @@ const hostRemediation = async (
: "REA supports Hopper on Ubuntu 24.04+, Fedora 41+, and 64-bit Arch Linux.";
};
-/** Production setup effects for macOS, Homebrew, JSON MCP clients, and the canonical skill directory. */
+/** Production setup effects for Hopper, agent configuration, and the canonical skill directory. */
const systemSetupHost = (): SetupHost => {
const doctorHost = systemDoctorHost();
return {
@@ -187,21 +256,14 @@ const systemSetupHost = (): SetupHost => {
nodeVersion: process.versions.node,
macosVersion: () => doctorHost.macosVersion(),
linuxDistribution: readLinuxDistribution,
- hasHomebrew: () => brewSucceeds(["--version"]),
- installHomebrew: () =>
- commandSucceeds(
- "/bin/bash",
- [
- "-c",
- "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)",
- ],
- { ...process.env, NONINTERACTIVE: "1" },
- ),
hopperPath: async () => (await runDoctor(undefined, doctorHost)).hopperPath,
- installHopper: () =>
- process.platform === "linux"
- ? installLinuxHopper().then(({ status }) => status === "installed")
- : brewSucceeds(["install", "--cask", "hopper-disassembler"]),
+ installHopper: async () => {
+ const result =
+ process.platform === "linux"
+ ? await installLinuxHopper()
+ : await installMacHopper();
+ return result.status === "installed" ? result.launcherPath : undefined;
+ },
detectedClients: () => detectClients(homedir()),
configureClient: (client, hopperPath, command) =>
client.format === "unsupported"
@@ -473,24 +535,6 @@ export const installCanonicalSkill = async (
}
};
-const commandSucceeds = async (
- command: string,
- args: readonly string[],
- env?: NodeJS.ProcessEnv,
-): Promise => {
- try {
- await execFileAsync(command, args, env === undefined ? {} : { env });
- return true;
- } catch {
- return false;
- }
-};
-const brewSucceeds = async (args: readonly string[]): Promise => {
- const result = await probeHomebrew(async (command) =>
- (await commandSucceeds(command, args)) ? true : undefined,
- );
- return result === true;
-};
const major = (version: string): number =>
Number.parseInt(version.split(".")[0] ?? "0", 10);
const exists = async (path: string): Promise => {
diff --git a/src/cli.ts b/src/cli.ts
index 49c8d84b0..ce07f8903 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -1,5 +1,6 @@
import { Cli, z } from "incur";
import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline/promises";
import { runDoctor } from "./application/Doctor.js";
import {
@@ -7,7 +8,7 @@ import {
runProviderAnalysis,
runSessionStatus,
} from "./application/DirectAnalysis.js";
-import { runSetup } from "./application/Setup.js";
+import { runSetup, type SetupAction } from "./application/Setup.js";
import { runUninstall } from "./application/Uninstall.js";
import { runUpgrade, systemUpgradeHost } from "./application/Upgrade.js";
import { PRODUCT_IDENTITY } from "./identity.js";
@@ -76,11 +77,27 @@ const registerCoreCommands = (
yes: z
.boolean()
.default(false)
- .describe("Approve prerequisite installation"),
+ .describe("Approve user-owned setup actions without prompting"),
+ installHopper: z
+ .boolean()
+ .default(false)
+ .describe("Also approve Hopper installation with --yes"),
}),
- alias: { yes: "y" },
- run: ({ options }) =>
- logCliCommand(logger, "setup", () => runSetup(options.yes)),
+ alias: { yes: "y", installHopper: "install-hopper" },
+ run: ({ options, formatExplicit }) =>
+ logCliCommand(logger, "setup", () =>
+ runSetup(
+ {
+ approved: options.yes,
+ installHopper: options.installHopper,
+ structured: formatExplicit,
+ },
+ undefined,
+ options.yes || formatExplicit || process.stdin.isTTY !== true
+ ? undefined
+ : confirmSetup,
+ ),
+ ),
});
cli.command("doctor", {
description: "Check whether REA is ready",
@@ -163,6 +180,28 @@ const registerCoreCommands = (
});
};
+const confirmSetup = async (
+ actions: readonly SetupAction[],
+): Promise => {
+ process.stdout.write("\nREA setup plan\n");
+ for (const action of actions)
+ process.stdout.write(
+ ` - ${action.detail}\n ${action.target}${action.external ? " (external software)" : ""}\n`,
+ );
+ const prompt = createInterface({
+ input: process.stdin,
+ output: process.stdout,
+ });
+ try {
+ const answer = (await prompt.question("Continue? [Y/n] "))
+ .trim()
+ .toLowerCase();
+ return answer === "" || answer === "y" || answer === "yes";
+ } finally {
+ prompt.close();
+ }
+};
+
const registerXrefsCommand = (
cli: ReturnType,
logger: Logger,
diff --git a/src/domain/runtimeVersion.ts b/src/domain/runtimeVersion.ts
new file mode 100644
index 000000000..0ab5647d7
--- /dev/null
+++ b/src/domain/runtimeVersion.ts
@@ -0,0 +1,10 @@
+/** Return whether a Node.js version satisfies REA's tested runtime families. */
+export const supportsNodeVersion = (version: string): boolean => {
+ const [majorText = "", minorText = ""] = version.split(".");
+ const major = Number.parseInt(majorText, 10);
+ const minor = Number.parseInt(minorText, 10);
+ return (
+ (major === 22 && minor >= 19) ||
+ (major >= 24 && (major !== 24 || minor >= 11))
+ );
+};
diff --git a/tests/installScript.test.ts b/tests/installScript.test.ts
index a1a918e00..156f2cb44 100644
--- a/tests/installScript.test.ts
+++ b/tests/installScript.test.ts
@@ -24,90 +24,54 @@ afterEach(async () => {
});
describe("curl installer scenarios", () => {
- it("installs a pinned release with closed stdin and cleans temporary files", async () => {
+ it("installs only a pinned REA CLI with closed stdin", async () => {
const fixture = await createFixture();
- const result = await runInstaller(fixture, { REA_VERSION: "0.3.0" });
- expect(result.stdout).toContain("REA 0.3.0 is installed and ready");
+ const result = await runInstaller(fixture, ["--version", "0.3.0"]);
+ expect(result.stdout).toContain("REA 0.3.0 is installed");
+ expect(result.stdout).toContain("Run ");
expect(await readFile(fixture.npmLog, "utf8")).toContain(
- "rea-agents@0.3.0",
+ "install --global --prefix",
);
+ expect(await readFile(fixture.reaLog, "utf8")).toBe("--version\n");
expect(await readdir(fixture.temporary)).toEqual([]);
});
- it("resolves and validates the latest rea-agents release tag", async () => {
+ it("accepts Node 25 without installing or replacing it", async () => {
+ const fixture = await createFixture();
+ const result = await runInstaller(fixture, ["--version", "0.3.0"], {
+ FAKE_NODE_VERSION: "25.1.0",
+ });
+ expect(result.stdout).toContain("Runtime: Node.js 25.1.0");
+ });
+
+ it("resolves and validates the latest REA release tag", async () => {
const fixture = await createFixture();
const result = await runInstaller(fixture);
- expect(result.stdout).toContain("Installing rea-agents@0.3.0");
+ expect(result.stdout).toContain("Version: 0.3.0");
});
- it("bootstraps checksum-verified Node 24 into the user prefix", async () => {
+ it("prints a dry run without invoking npm", async () => {
const fixture = await createFixture();
- const result = await runInstaller(fixture, {
- REA_VERSION: "0.3.0",
- FAKE_OLD_NODE: "1",
- FAKE_NODE_ARCHIVE: fixture.nodeArchive,
- FAKE_NODE_SUMS: fixture.nodeSums,
+ const result = await runInstaller(fixture, [
+ "--version",
+ "0.3.0",
+ "--dry-run",
+ ]);
+ expect(result.stdout).toContain("no changes made");
+ await expect(readFile(fixture.npmLog, "utf8")).rejects.toMatchObject({
+ code: "ENOENT",
});
- expect(result.stdout).toContain("REA 0.3.0 is installed and ready");
- expect(
- await readFile(
- join(fixture.home, ".local/share/rea/node/bin/node"),
- "utf8",
- ),
- ).toContain("24.18.0");
- });
-
- it("reports fresh Hopper activation as partial success", async () => {
- const fixture = await createFixture();
- const result = await runInstaller(fixture, {
- REA_VERSION: "0.3.0",
- FAKE_SETUP_ACTIONS: '["installed_hopper"]',
- });
- expect(result.stdout).toContain("One user action remains");
- expect(result.stdout).toContain("open Hopper");
});
it.each([
- [
- "injected version",
- { REA_VERSION: "0.3.0;touch /tmp/pwned" },
- "exact semantic version",
- ],
- [
- "npm failure",
- { REA_VERSION: "0.3.0", FAKE_NPM_FAIL: "1" },
- "npm package installation failed",
- ],
- [
- "version mismatch",
- { REA_VERSION: "0.3.0", FAKE_REA_VERSION: "9.9.9" },
- "does not match",
- ],
- [
- "malformed setup",
- { REA_VERSION: "0.3.0", FAKE_SETUP_JSON: "not-json" },
- "malformed output",
- ],
- [
- "unhealthy doctor",
- { REA_VERSION: "0.3.0", FAKE_DOCTOR_HEALTHY: "false" },
- "unhealthy required component",
- ],
+ ["unsupported Node", { FAKE_NODE_VERSION: "20.0.0" }, "unsupported"],
+ ["npm failure", { FAKE_NPM_FAIL: "1" }, "npm package installation failed"],
+ ["version mismatch", { FAKE_REA_VERSION: "9.9.9" }, "does not match"],
] as const)("fails closed on %s", async (_name, overrides, message) => {
const fixture = await createFixture();
- await expect(runInstaller(fixture, overrides)).rejects.toMatchObject({
- stderr: expect.stringContaining(message),
- });
- });
-
- it("is safe to rerun", async () => {
- const fixture = await createFixture();
- await runInstaller(fixture, { REA_VERSION: "0.3.0" });
- await runInstaller(fixture, { REA_VERSION: "0.3.0" });
- expect(
- (await readFile(fixture.npmLog, "utf8")).trim().split("\n"),
- ).toHaveLength(2);
- expect(await readdir(fixture.temporary)).toEqual([]);
+ await expect(
+ runInstaller(fixture, ["--version", "0.3.0"], overrides),
+ ).rejects.toMatchObject({ stderr: expect.stringContaining(message) });
});
});
@@ -116,8 +80,7 @@ interface InstallerFixture {
readonly bin: string;
readonly temporary: string;
readonly npmLog: string;
- readonly nodeArchive: string;
- readonly nodeSums: string;
+ readonly reaLog: string;
}
const createFixture = async (): Promise => {
@@ -127,52 +90,45 @@ const createFixture = async (): Promise => {
const bin = join(root, "bin");
const temporary = join(root, "tmp");
const npmLog = join(root, "npm.log");
- const nodeFixture = join(root, "node-v24.18.0-linux-x64");
- const nodeArchive = `${nodeFixture}.tar.xz`;
- const nodeSums = join(root, "SHASUMS256.txt");
+ const reaLog = join(root, "rea.log");
await Promise.all([mkdir(home), mkdir(bin), mkdir(temporary)]);
- const realNode = process.execPath;
- await mkdir(join(nodeFixture, "bin"), { recursive: true });
- await executable(
- join(nodeFixture, "bin/node"),
- `#!/bin/sh\nif [ "$1" = "-p" ]; then echo 24.18.0; else exec ${shellQuote(realNode)} "$@"; fi\n`,
- );
- await executable(
- join(nodeFixture, "bin/npm"),
- '#!/bin/sh\nif [ "$1" = "--version" ]; then echo 11.16.0; exit 0; fi\nprintf "%s\\n" "$*" >> "$FAKE_NPM_LOG"\nexit 0\n',
- );
- await execFileAsync("tar", [
- "-cJf",
- nodeArchive,
- "-C",
- root,
- "node-v24.18.0-linux-x64",
- ]);
- const checksum = (
- await execFileAsync("sha256sum", [nodeArchive])
- ).stdout.split(" ")[0];
- await writeFile(nodeSums, `${checksum} node-v24.18.0-linux-x64.tar.xz\n`);
await executable(
join(bin, "uname"),
'#!/bin/sh\n[ "$1" = "-m" ] && echo x86_64 || echo Linux\n',
);
await executable(
join(bin, "node"),
- `#!/bin/sh\nif [ "$1" = "-p" ]; then [ "\${FAKE_OLD_NODE:-}" = "1" ] && echo 20.0.0 || echo 24.18.0; else exec ${shellQuote(realNode)} "$@"; fi\n`,
+ `#!/bin/sh
+if [ "$1" = "-p" ]; then printf '%s\n' "\${FAKE_NODE_VERSION:-24.18.0}"; else exec ${shellQuote(process.execPath)} "$@"; fi
+`,
);
await executable(
join(bin, "npm"),
- '#!/bin/sh\nif [ "$1" = "--version" ]; then echo 11.16.0; exit 0; fi\nprintf "%s\\n" "$*" >> "$FAKE_NPM_LOG"\n[ "${FAKE_NPM_FAIL:-}" = "1" ] && exit 1\nexit 0\n',
+ `#!/bin/sh
+printf '%s\n' "$*" >> "$FAKE_NPM_LOG"
+[ "\${FAKE_NPM_FAIL:-}" = "1" ] && exit 1
+prefix="$HOME/.local"
+while [ "$#" -gt 0 ]; do
+ if [ "$1" = "--prefix" ]; then shift; prefix="$1"; fi
+ shift
+done
+mkdir -p "$prefix/bin"
+cp "$FAKE_REA_SOURCE" "$prefix/bin/rea"
+chmod +x "$prefix/bin/rea"
+`,
);
await executable(
join(bin, "curl"),
- '#!/bin/sh\nout=""\nurl=""\nwhile [ "$#" -gt 0 ]; do\n if [ "$1" = "-o" ]; then shift; out="$1"; else url="$1"; fi\n shift\ndone\ncase "$url" in\n *node-v24.18.0-linux-x64.tar.xz) cp "$FAKE_NODE_ARCHIVE" "$out" ;;\n *SHASUMS256.txt) cp "$FAKE_NODE_SUMS" "$out" ;;\n *) printf \'{"tag_name":"rea-agents-0.3.0"}\' ;;\nesac\n',
+ '#!/bin/sh\nprintf \'{"tag_name":"rea-agents-0.3.0"}\'\n',
);
await executable(
- join(bin, "rea"),
- '#!/bin/sh\ncase "$1" in\n--version) printf "%s\\n" "${FAKE_REA_VERSION:-0.3.0}" ;;\nsetup) if [ -n "${FAKE_SETUP_JSON:-}" ]; then printf "%s\\n" "$FAKE_SETUP_JSON"; else printf \'{"status":"ready","actions":%s}\\n\' "${FAKE_SETUP_ACTIONS:-[]}"; fi ;;\ndoctor) printf \'{"healthy":%s,"checks":[]}\\n\' "${FAKE_DOCTOR_HEALTHY:-true}" ;;\nesac\n',
+ join(bin, "rea-source"),
+ `#!/bin/sh
+printf '%s\n' "$*" >> "$FAKE_REA_LOG"
+[ "$1" = "--version" ] && printf '%s\n' "\${FAKE_REA_VERSION:-0.3.0}"
+`,
);
- return { home, bin, temporary, npmLog, nodeArchive, nodeSums };
+ return { home, bin, temporary, npmLog, reaLog };
};
const executable = async (path: string, source: string): Promise => {
@@ -182,15 +138,18 @@ const executable = async (path: string, source: string): Promise => {
const runInstaller = async (
fixture: InstallerFixture,
+ args: readonly string[] = [],
overrides: Readonly> = {},
): Promise<{ readonly stdout: string; readonly stderr: string }> =>
- execFileAsync("/bin/bash", [join(process.cwd(), "install.sh")], {
+ execFileAsync("/bin/bash", [join(process.cwd(), "install.sh"), ...args], {
env: {
...process.env,
HOME: fixture.home,
TMPDIR: fixture.temporary,
- PATH: `${fixture.bin}:${process.env.PATH ?? ""}`,
+ PATH: `${fixture.bin}:/usr/bin:/bin`,
FAKE_NPM_LOG: fixture.npmLog,
+ FAKE_REA_LOG: fixture.reaLog,
+ FAKE_REA_SOURCE: join(fixture.bin, "rea-source"),
...overrides,
},
});
diff --git a/tests/macHopper.test.ts b/tests/macHopper.test.ts
new file mode 100644
index 000000000..7647f274f
--- /dev/null
+++ b/tests/macHopper.test.ts
@@ -0,0 +1,110 @@
+import { createHash } from "node:crypto";
+
+import { describe, expect, it } from "vitest";
+
+import {
+ installMacHopper,
+ type MacHopperInstallHost,
+} from "../src/application/MacHopper.js";
+
+class FakeMacHopperHost implements MacHopperInstallHost {
+ readonly archive = new TextEncoder().encode("hopper-dmg");
+ archiveOk = true;
+ valid = true;
+ existing = false;
+ mountSucceeds = true;
+ copySucceeds = true;
+ launcherSucceeds = true;
+ badHash = false;
+ unmounts = 0;
+ cleanups = 0;
+ opens = 0;
+
+ download = (url: string) =>
+ Promise.resolve(
+ url.includes("files-api")
+ ? {
+ ok: true,
+ bytes: new TextEncoder().encode(
+ JSON.stringify({
+ "OS X": {
+ filename:
+ "https://www.hopperapp.com:443/downloader/public/Hopper-demo.dmg",
+ file_length: String(this.archive.byteLength),
+ file_hash: this.badHash
+ ? "0".repeat(40)
+ : createHash("sha1").update(this.archive).digest("hex"),
+ },
+ }),
+ ),
+ }
+ : { ok: this.archiveOk, bytes: this.archive },
+ );
+ createTemporaryDirectory = () => Promise.resolve("/tmp/rea-hopper-test");
+ createMountDirectory = () => Promise.resolve();
+ writePackage = () => Promise.resolve();
+ mount = () => Promise.resolve(this.mountSucceeds);
+ unmount = () => {
+ this.unmounts += 1;
+ return Promise.resolve();
+ };
+ appBundle = () => Promise.resolve("/mounted/Hopper Disassembler.app");
+ validBundle = () => Promise.resolve(this.valid);
+ destinationExists = () => Promise.resolve(this.existing);
+ installBundle = () => Promise.resolve(this.copySucceeds);
+ launcherReady = () => Promise.resolve(this.launcherSucceeds);
+ openApplication = () => {
+ this.opens += 1;
+ return Promise.resolve();
+ };
+ cleanup = () => {
+ this.cleanups += 1;
+ return Promise.resolve();
+ };
+ destination = () => "/home/user/Applications/Hopper Disassembler.app";
+}
+
+describe("macOS Hopper installation", () => {
+ it("installs, verifies, opens, and cleans the official package", async () => {
+ const host = new FakeMacHopperHost();
+ await expect(installMacHopper(host)).resolves.toEqual({
+ status: "installed",
+ launcherPath:
+ "/home/user/Applications/Hopper Disassembler.app/Contents/MacOS/hopper",
+ });
+ expect(host.opens).toBe(1);
+ expect(host.unmounts).toBe(1);
+ expect(host.cleanups).toBe(1);
+ });
+
+ it("rejects an integrity mismatch before mounting", async () => {
+ const host = new FakeMacHopperHost();
+ host.badHash = true;
+ await expect(installMacHopper(host)).resolves.toEqual({
+ status: "failed",
+ reason: "integrity",
+ });
+ expect(host.unmounts).toBe(0);
+ expect(host.cleanups).toBe(0);
+ });
+
+ it("refuses to overwrite an existing application", async () => {
+ const host = new FakeMacHopperHost();
+ host.existing = true;
+ await expect(installMacHopper(host)).resolves.toEqual({
+ status: "failed",
+ reason: "destination_exists",
+ });
+ });
+
+ it("cleans and detaches after bundle validation fails", async () => {
+ const host = new FakeMacHopperHost();
+ host.valid = false;
+ await expect(installMacHopper(host)).resolves.toEqual({
+ status: "failed",
+ reason: "bundle",
+ });
+ expect(host.unmounts).toBe(1);
+ expect(host.cleanups).toBe(1);
+ });
+});
diff --git a/tests/setup.test.ts b/tests/setup.test.ts
index 670b64e6a..f6c800367 100644
--- a/tests/setup.test.ts
+++ b/tests/setup.test.ts
@@ -5,26 +5,23 @@ import {
type ClientConfigurationResult,
type SetupClient,
type SetupHost,
+ type SetupOptions,
} from "../src/application/Setup.js";
import type { DoctorCheck } from "../src/application/Doctor.js";
import type { LinuxDistribution } from "../src/application/LinuxHopper.js";
class FakeSetupHost implements SetupHost {
readonly platform: NodeJS.Platform;
- readonly nodeVersion = "24.18.0";
+ readonly nodeVersion = "25.1.0";
version: string | undefined = "14.5";
- brew = false;
+ distribution: LinuxDistribution | undefined;
hopper: string | undefined;
- homebrewInstallSucceeds = true;
hopperInstallSucceeds = true;
skill: "installed" | "unchanged" | "failed" = "installed";
clients: readonly SetupClient[] = [];
clientResults = new Map();
- homebrewInstalls = 0;
hopperInstalls = 0;
configurations = 0;
- configuredHopperPaths: string[] = [];
- distribution: LinuxDistribution | undefined;
constructor(platform: NodeJS.Platform = "darwin") {
this.platform = platform;
@@ -34,31 +31,20 @@ class FakeSetupHost implements SetupHost {
Promise.resolve(this.version);
linuxDistribution = (): Promise =>
Promise.resolve(this.distribution);
- hasHomebrew = (): Promise => Promise.resolve(this.brew);
- installHomebrew = (): Promise => {
- this.homebrewInstalls += 1;
- if (this.homebrewInstallSucceeds) this.brew = true;
- return Promise.resolve(this.homebrewInstallSucceeds);
- };
hopperPath = (): Promise => Promise.resolve(this.hopper);
- installHopper = (): Promise => {
+ installHopper = (): Promise => {
this.hopperInstalls += 1;
if (this.hopperInstallSucceeds) this.hopper = "/manual/Hopper";
- return Promise.resolve(this.hopperInstallSucceeds);
+ return Promise.resolve(this.hopper);
};
detectedClients = (): Promise =>
Promise.resolve(this.clients);
configureClient = (
client: SetupClient,
- hopperPath: string,
): Promise => {
this.configurations += 1;
- this.configuredHopperPaths.push(hopperPath);
return Promise.resolve(
- this.clientResults.get(client.name) ?? {
- status: "configured",
- backupPath: `${client.configPath}.backup`,
- },
+ this.clientResults.get(client.name) ?? { status: "configured" },
);
};
installSkill = (): Promise<"installed" | "unchanged" | "failed"> =>
@@ -69,40 +55,107 @@ class FakeSetupHost implements SetupHost {
checks: readonly DoctorCheck[];
}> =>
Promise.resolve({
- healthy:
- (this.platform === "linux" || this.brew) && this.hopper !== undefined,
+ healthy: this.hopper !== undefined,
...(this.hopper === undefined ? {} : { hopperPath: this.hopper }),
checks: [],
});
}
+const options = (approved: boolean, installHopper = false): SetupOptions => ({
+ approved,
+ installHopper,
+ structured: true,
+});
+
describe("setup workflow", () => {
- it("installs Homebrew and Hopper on a clean approved machine", async () => {
+ it("returns a complete plan without mutation", async () => {
const host = new FakeSetupHost();
- const result = await runSetup(true, host);
+ host.clients = [{ name: "cursor", configPath: "/cursor.json" }];
+ const result = await runSetup(options(false), host);
+ expect(result.status).toBe("needs_confirmation");
+ expect(result.plannedActions.map(({ kind }) => kind)).toEqual([
+ "install_hopper",
+ "configure_client",
+ "install_skill",
+ ]);
+ expect(host.hopperInstalls).toBe(0);
+ expect(host.configurations).toBe(0);
+ });
+
+ it("applies an accepted interactive plan including Hopper", async () => {
+ const host = new FakeSetupHost();
+ const result = await runSetup(
+ { ...options(false), structured: false },
+ host,
+ () => Promise.resolve(true),
+ );
expect(result.status).toBe("needs_human");
- expect(result.actions).toEqual([
- "installed_homebrew",
+ expect(result.appliedActions).toEqual([
"installed_hopper",
"installed_skill",
]);
+ expect(host.hopperInstalls).toBe(1);
});
- it("installs Hopper without Homebrew on supported Linux", async () => {
- const host = new FakeSetupHost("linux");
- host.distribution = {
- id: "ubuntu",
- versionId: "24.04",
- packageFamily: "deb",
- supported: true,
- };
- const result = await runSetup(true, host);
+ it("declines an interactive plan without mutation", async () => {
+ const host = new FakeSetupHost();
+ const result = await runSetup(
+ { ...options(false), structured: false },
+ host,
+ () => Promise.resolve(false),
+ );
+ expect(result.status).toBe("planned");
+ expect(result.appliedActions).toEqual([]);
+ expect(host.hopperInstalls).toBe(0);
+ });
+
+ it("requires the Hopper flag for unattended setup", async () => {
+ const host = new FakeSetupHost();
+ const result = await runSetup(options(true), host);
expect(result.status).toBe("needs_human");
- expect(result.actions).toEqual(["installed_hopper", "installed_skill"]);
- expect(host.homebrewInstalls).toBe(0);
+ expect(host.hopperInstalls).toBe(0);
+ expect(result.appliedActions).toEqual(["installed_skill"]);
+ expect(result.remediation).toContain("--install-hopper");
});
- it("rejects unsupported Linux before mutation", async () => {
+ it("installs Hopper when unattended authorization is explicit", async () => {
+ const host = new FakeSetupHost();
+ const result = await runSetup(options(true, true), host);
+ expect(result.appliedActions).toEqual([
+ "installed_hopper",
+ "installed_skill",
+ ]);
+ expect(host.hopperInstalls).toBe(1);
+ });
+
+ it("reuses existing Hopper and configures detected clients", async () => {
+ const host = new FakeSetupHost();
+ host.hopper = "/Applications/Hopper";
+ host.clients = [
+ { name: "claude", configPath: "/claude.json" },
+ { name: "cursor", configPath: "/cursor.json" },
+ ];
+ const result = await runSetup(options(true), host);
+ expect(result.status).toBe("ready");
+ expect(result.appliedActions).toEqual([
+ "configured_claude",
+ "configured_cursor",
+ "installed_skill",
+ ]);
+ expect(host.hopperInstalls).toBe(0);
+ });
+
+ it("reports a failed Hopper installation without configuring clients", async () => {
+ const host = new FakeSetupHost();
+ host.hopperInstallSucceeds = false;
+ host.clients = [{ name: "cursor", configPath: "/cursor.json" }];
+ const result = await runSetup(options(true, true), host);
+ expect(result.status).toBe("needs_human");
+ expect(result.remediation).toContain("failed");
+ expect(host.configurations).toBe(0);
+ });
+
+ it("rejects unsupported hosts before mutation", async () => {
const host = new FakeSetupHost("linux");
host.distribution = {
id: "debian",
@@ -110,103 +163,8 @@ describe("setup workflow", () => {
packageFamily: "deb",
supported: false,
};
- const result = await runSetup(true, host);
+ const result = await runSetup(options(true, true), host);
expect(result.status).toBe("needs_human");
expect(host.hopperInstalls).toBe(0);
- expect(host.configurations).toBe(0);
});
-
- it("requires --yes before installing Homebrew", async () => {
- const host = new FakeSetupHost();
- const result = await runSetup(false, host);
- expect(result.status).toBe("needs_human");
- expect(host.homebrewInstalls).toBe(0);
- expect(result.remediation).toContain("--yes");
- });
-
- it("requires --yes before installing Hopper", async () => {
- const host = new FakeSetupHost();
- host.brew = true;
- const result = await runSetup(false, host);
- expect(result.status).toBe("needs_human");
- expect(host.hopperInstalls).toBe(0);
- expect(result.remediation).toContain("--yes");
- });
-
- it("accepts existing Homebrew and manually installed Hopper", async () => {
- const host = new FakeSetupHost();
- host.brew = true;
- host.hopper = "/Applications/Manual Hopper";
- expect((await runSetup(true, host)).actions).toEqual(["installed_skill"]);
- expect(host.hopperInstalls).toBe(0);
- expect(host.configuredHopperPaths).toEqual([]);
- });
-
- it.each(["homebrew", "hopper"] as const)(
- "returns needs_human when %s installation is interrupted",
- async (stage) => {
- const host = new FakeSetupHost();
- if (stage === "homebrew") host.homebrewInstallSucceeds = false;
- else {
- host.brew = true;
- host.hopperInstallSucceeds = false;
- }
- const result = await runSetup(true, host);
- expect(result.status).toBe("needs_human");
- expect(result.remediation).toContain("interrupted");
- },
- );
-
- it("configures every detected client and reports backup paths", async () => {
- const host = new FakeSetupHost();
- host.brew = true;
- host.hopper = "/Hopper";
- host.clients = [
- { name: "claude", configPath: "/claude.json" },
- { name: "cursor", configPath: "/cursor.json" },
- ];
- const result = await runSetup(true, host);
- expect(Object.keys(result.clients)).toEqual(["claude", "cursor"]);
- expect(host.configurations).toBe(2);
- expect(host.configuredHopperPaths).toEqual(["/Hopper", "/Hopper"]);
- });
-
- it.each(["backup", "write", "readback"] as const)(
- "stops with precise remediation after a %s failure",
- async (reason) => {
- const host = new FakeSetupHost();
- host.brew = true;
- host.hopper = "/Hopper";
- host.clients = [{ name: "cursor", configPath: "/cursor.json" }];
- host.clientResults.set("cursor", { status: "failed", reason });
- const result = await runSetup(true, host);
- expect(result.status).toBe("needs_human");
- expect(result.remediation).toContain(reason);
- },
- );
-
- it("is idempotent on repeated setup", async () => {
- const host = new FakeSetupHost();
- host.brew = true;
- host.hopper = "/Hopper";
- host.skill = "unchanged";
- host.clients = [{ name: "cursor", configPath: "/cursor.json" }];
- host.clientResults.set("cursor", { status: "unchanged" });
- const first = await runSetup(true, host);
- const second = await runSetup(true, host);
- expect(first.actions).toEqual([]);
- expect(second.actions).toEqual([]);
- expect(host.homebrewInstalls).toBe(0);
- expect(host.hopperInstalls).toBe(0);
- });
-
- it.each(["11.7", undefined])(
- "rejects unsupported macOS %s before mutation",
- async (version) => {
- const host = new FakeSetupHost();
- host.version = version;
- expect((await runSetup(true, host)).status).toBe("needs_human");
- expect(host.homebrewInstalls).toBe(0);
- },
- );
});
From 1c83263bbb79aa050d1e560d17da66557afdbad2 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Mon, 13 Jul 2026 15:14:04 +0800
Subject: [PATCH 2/4] docs: explain the installation workflow
---
README.md | 44 +++++++++++++++---------
README_ar.md | 10 +++---
README_ja.md | 10 +++---
README_ko.md | 10 +++---
README_zh.md | 10 +++---
docs/architecture.mermaid | 2 +-
docs/installation.md | 60 +++++++++++++++++++++++++++++++++
docs/roadmap.md | 16 +++++++++
tests/readmeConsistency.test.ts | 8 +++--
9 files changed, 130 insertions(+), 40 deletions(-)
create mode 100644 docs/installation.md
create mode 100644 docs/roadmap.md
diff --git a/README.md b/README.md
index 48ef8efca..dbe06018c 100644
--- a/README.md
+++ b/README.md
@@ -11,14 +11,14 @@
[](https://www.npmjs.com/package/rea-agents)
[](https://github.com/morluto/rea/actions/workflows/ci.yml)
[](#68-tools-for-investigation)
-[](https://nodejs.org/)
+[](https://nodejs.org/)
[](LICENSE)
[Quick start](#quick-start) · [Current status](#current-status) · [Investigation model](#the-investigation-model) · [68 tools](#68-tools-for-investigation) · [Roadmap](#roadmap) · [How it works](#how-it-works)
-curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
+npm install --global rea-agents && rea setup
@@ -81,15 +81,24 @@ REA shows how it reached its conclusions. It does not claim to recover original
## Quick start
-### One-command install — recommended
+### Install the CLI — recommended
+
+```bash
+npm install --global rea-agents
+rea setup
+```
+
+Installing the CLI does not update Homebrew, Node.js, npm, Hopper, or coding-agent configuration. `rea setup` detects what is already present, prints every proposed change, and asks before applying it.
+
+REA detects Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Windsurf, and Devin. Registrations are additive, backup-first, and read back after writing. You can safely rerun setup.
+
+An optional curl wrapper installs the same CLI package and starts setup only when a terminal is available:
```bash
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
```
-The installer supports macOS 12+, Ubuntu 24.04+, Fedora 41+, and 64-bit Arch Linux. It installs compatible Node.js 24/npm 11 prerequisites, the exact latest `rea-agents-*` release, the official Hopper package, detected client registrations, and the bundled skill, then verifies the result. macOS uses Homebrew; Linux uses the native package manager and may show a system authorization prompt. Pin a reproducible release with `REA_VERSION=0.3.0`; `REA_VERSION` is the only supported installer environment override.
-
-REA detects Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Windsurf, and Devin. It configures detected clients with documented local MCP files; Devin is reported as skipped because its public documentation does not define a local configuration file. You can safely rerun the installer or `rea setup --yes`. If REA's local analysis engine needs one-time activation, installation remains intact and setup reports the exact remaining action rather than claiming full readiness.
+Pass installer options after `bash -s --`, for example `--dry-run`, `--no-setup`, or `--version 1.0.0`. The curl wrapper never installs prerequisites or configures integrations itself. See [Installation and setup](docs/installation.md) for its exact mutation boundary.
### With a coding agent — recommended
@@ -99,23 +108,23 @@ npx skills add morluto/rea
Ask your agent to set up REA. It will check your Mac, explain anything it needs to install, ask for approval, and guide you through system prompts. After setup, restart the agent if it asks you to load the full REA toolset.
-Approve installation if needed, complete the one-time activation when prompted, then describe the app or feature you want to understand. REA handles the binary-analysis tools behind the scenes.
+Review the setup plan, approve it if appropriate, complete Hopper's one-time activation when prompted, then describe the app or feature you want to understand.
### From Terminal — no installation
```bash
-npx -y rea-agents setup --yes
+npx -y rea-agents setup
npx -y rea-agents doctor
npx -y rea-agents analyze /Applications/Notes.app
```
-If macOS or an installer asks for confirmation, complete the prompt and run the same command again. Restart a configured coding agent so it loads REA.
+Review the setup plan before confirming it. Restart a configured coding agent so it loads REA.
### From Terminal — install the `rea` command
```bash
npm install --global rea-agents
-rea setup --yes
+rea setup
rea doctor
rea analyze /Applications/Notes.app
```
@@ -137,9 +146,10 @@ Choose either the no-install commands or the global installation. You do not nee
- macOS 12 or newer
- Ubuntu 24.04+, Fedora 41+, or 64-bit Arch Linux
-- Node.js 24.18.x with npm 11.16.x
+- Node.js 22.19+ or 24.11+ (including newer releases)
+- npm; REA does not require or install a particular npm version
-You do not need to choose or install binary-analysis tools yourself. REA setup handles them when needed. Deep binary analysis currently uses [Hopper](https://www.hopperapp.com/), a separate desktop application with its own license. REA can install the official macOS or Linux package, but you must approve installation and complete its one-time activation.
+Deep binary analysis currently uses [Hopper](https://www.hopperapp.com/), a separate desktop application with its own license. Setup reuses an existing installation. If Hopper is missing, interactive setup proposes the official package and includes it in the confirmation plan. Unattended installation requires `rea setup --yes --install-hopper`.
If something is not working, run:
@@ -151,7 +161,9 @@ npx -y rea-agents doctor
### Linux installation and troubleshooting
-On Ubuntu 24.04+, Fedora 41+, and 64-bit Arch Linux, setup downloads the matching official Hopper package, restricts downloads to Hopper's public origin, verifies the published size and checksum, and invokes `apt-get`, `dnf`, or `pacman`. When REA is not already running as root, `pkexec` presents the system authorization prompt. REA never invokes `sudo`.
+On macOS, approved setup downloads Hopper's official DMG, verifies it, and installs the app into `~/Applications` without Homebrew or administrator privileges. It opens Hopper once for activation; no manual drag-and-drop is required.
+
+On Ubuntu 24.04+, Fedora 41+, and 64-bit Arch Linux, approved setup downloads the matching official Hopper package, restricts downloads to Hopper's public origin, verifies the published size and checksum, and invokes `apt-get`, `dnf`, or `pacman`. When REA is not already running as root, `pkexec` presents the system authorization prompt. REA never invokes `sudo`.
The normal Linux launcher is `/opt/hopper/bin/Hopper`. If Hopper was installed elsewhere:
@@ -166,7 +178,7 @@ If doctor reports a missing analysis engine even though the file exists, inspect
ldd /opt/hopper/bin/Hopper | grep 'not found'
```
-Install the missing distribution packages and rerun `rea setup --yes`. Hopper is a desktop application: real analysis requires an active `DISPLAY` or `WAYLAND_DISPLAY`, plus one-time license activation. The curl installer places the `rea` command in `~/.local/bin` on Linux; add that directory to future shell `PATH` values if it is not already present.
+Install the missing distribution packages and rerun `rea setup`. Hopper is a desktop application: real analysis requires an active `DISPLAY` or `WAYLAND_DISPLAY`, plus one-time license activation. The curl installer places the `rea` command in `~/.local/bin` on Linux; add that directory to future shell `PATH` values if it is not already present.
REA defaults `HOPPER_LAUNCHER_PATH` to `/Applications/Hopper Disassembler.app/Contents/MacOS/hopper` on macOS and `/opt/hopper/bin/Hopper` on Linux. Explicit configuration always takes precedence.
@@ -177,7 +189,7 @@ rea uninstall
rea uninstall --purge-data # also removes only ~/.rea/cache and ~/.rea/state
```
-Uninstall preserves Hopper, Homebrew, Node.js, evidence, captures, external evidence roots, unrelated skills, and other MCP servers. It refuses malformed client configuration and never follows purge-data symlinks.
+Uninstall preserves Hopper, Node.js, evidence, captures, external evidence roots, unrelated skills, and other MCP servers. It refuses malformed client configuration and never follows purge-data symlinks.
### CLI or coding agent?
@@ -286,7 +298,7 @@ REA is growing into a toolkit for understanding software across static artifacts
7. **More targets and platforms** — Windows-native providers and ConPTY verification, Linux parity, websites and APIs, mobile artifacts, firmware, document formats, and other software-defined systems.
8. **Differential reconstruction** — compare artifacts, functions, bundles, protocols, UIs, and process captures; track residual unknowns; verify a reconstruction against observed behavior.
-Roadmap items describe direction, not shipped support. New providers must produce the same evidence and safety metadata as existing capabilities before they become part of the public workflow.
+Roadmap items describe direction, not shipped support. New providers must produce the same evidence and safety metadata as existing capabilities before they become part of the public workflow. Once REA has multiple optional toolchains, setup can become capability-selective; the consent rules for that future work are recorded in the [installation roadmap](docs/roadmap.md).
See the [static-analysis provider evaluation](docs/provider-evaluation.md) for the current research matrix and admission gate.
diff --git a/README_ar.md b/README_ar.md
index 65b1e4dba..16187da35 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -11,7 +11,7 @@
[](https://www.npmjs.com/package/rea-agents)
[](https://github.com/morluto/rea/actions/workflows/ci.yml)
[](#منصة-من-68-أداة)
-[](https://nodejs.org/)
+[](https://nodejs.org/)
[](LICENSE)
[البدء السريع](#البدء-السريع) · [من الملف التنفيذي إلى السلوك](#من-الملف-التنفيذي-إلى-السلوك) · [68 أداة](#منصة-من-68-أداة) · [كيف يعمل](#كيف-يعمل) · [الأسئلة الشائعة](#الأسئلة-الشائعة)
@@ -74,21 +74,21 @@ npx skills add morluto/rea
- macOS 12 أو أحدث
- Ubuntu 24.04+ أو Fedora 41+ أو Arch Linux 64 بت
-- Node.js 24.18.x وnpm 11.16.x (شغّل `nvm use` لاختيار الإصدار المثبّت)
+- Node.js 22.19+ أو 24.11+ وnpm المرفق مع Node
-لا تحتاج إلى تثبيت أدوات الهندسة العكسية يدويًا. يثبت Setup برنامج Homebrew و[Hopper](https://www.hopperapp.com/) عند الحاجة، ثم يهيئ وكلاء البرمجة المدعومين. Hopper برنامج منفصل يحتاج إلى ترخيص خاص به؛ يثبته Setup لكنه لا يوفر الترخيص.
+يعرض `rea setup` خطة التغييرات كاملة ويطلب التأكيد قبل تطبيقها. لا يثبت أو يحدّث Homebrew أو Node.js أو npm. إذا كان [Hopper](https://www.hopperapp.com/) مفقودًا، يقترح Setup الحزمة الرسمية. Hopper برنامج منفصل يحتاج إلى ترخيص خاص به.
#### التثبيت على Linux واستكشاف الأخطاء
على Ubuntu 24.04+ وFedora 41+ وArch Linux 64 بت، ينزّل REA حزمة DEB أو RPM أو Arch الرسمية، ويتحقق من الحجم وقيمة التحقق المنشورين، ثم يستخدم `apt-get` أو `dnf` أو `pacman` لحل الاعتماديات. عند التشغيل دون root يعرض `pkexec` طلب تفويض النظام. لا يستدعي REA الأمر `sudo`.
-مسار المشغّل الافتراضي هو `/opt/hopper/bin/Hopper`. استخدم `HOPPER_LAUNCHER_PATH` للمسارات الأخرى. إذا أبلغ Doctor عن غياب محرك التحليل، شغّل `ldd /opt/hopper/bin/Hopper | grep 'not found'`، وثبّت المكتبات الناقصة ثم أعد `rea setup --yes`. يتطلب التحليل الحقيقي `DISPLAY` أو `WAYLAND_DISPLAY` وترخيص Hopper مفعّلًا. أضف `~/.local/bin` إلى `PATH` أيضًا.
+مسار المشغّل الافتراضي هو `/opt/hopper/bin/Hopper`. استخدم `HOPPER_LAUNCHER_PATH` للمسارات الأخرى. إذا أبلغ Doctor عن غياب محرك التحليل، شغّل `ldd /opt/hopper/bin/Hopper | grep 'not found'`، وثبّت المكتبات الناقصة ثم أعد `rea setup`. يتطلب التحليل الحقيقي `DISPLAY` أو `WAYLAND_DISPLAY` وترخيص Hopper مفعّلًا. أضف `~/.local/bin` إلى `PATH` أيضًا.
### 1. إعداد REA
```bash
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
-npx -y rea-agents setup --yes
+npx -y rea-agents setup
```
إذا طلب macOS أو برنامج التثبيت تأكيدًا، فأكمل الخطوة ثم شغّل الأمر نفسه مرة أخرى.
diff --git a/README_ja.md b/README_ja.md
index 7015ace7d..a6c99a25c 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -11,7 +11,7 @@
[](https://www.npmjs.com/package/rea-agents)
[](https://github.com/morluto/rea/actions/workflows/ci.yml)
[](#68-ツールのワークベンチ)
-[](https://nodejs.org/)
+[](https://nodejs.org/)
[](LICENSE)
[クイックスタート](#クイックスタート) · [バイナリから動作へ](#バイナリから動作へ) · [68 ツール](#68-ツールのワークベンチ) · [仕組み](#仕組み) · [FAQ](#faq)
@@ -76,20 +76,20 @@ npx skills add morluto/rea
- macOS 12 以降
- Ubuntu 24.04+、Fedora 41+、または 64 ビット Arch Linux
-- Node.js 24.18.x と npm 11.16.x(`nvm use` で固定バージョンを選択)
+- Node.js 22.19+ または 24.11+ と、Node に付属する npm
-リバースエンジニアリングツールを手動でインストールする必要はありません。Setup は必要に応じて Homebrew と [Hopper](https://www.hopperapp.com/) をインストールし、対応するコーディングエージェントを設定します。Hopper は別製品で、ライセンスは別途必要です。Setup はインストールしますが、ライセンスは提供しません。
+`rea setup` は変更計画を表示し、確認後に適用します。Homebrew、Node.js、npm をインストールまたは更新しません。[Hopper](https://www.hopperapp.com/) がない場合は公式パッケージを提案します。Hopper は別製品で、ライセンスは別途必要です。
#### Linux のインストールとトラブルシューティング
Ubuntu 24.04+、Fedora 41+、64 ビット Arch Linux では、REA が公式の DEB、RPM、または Arch パッケージを取得し、公開されたサイズとチェックサムを検証してから `apt-get`、`dnf`、または `pacman` で依存関係を解決します。root 以外では `pkexec` がシステム承認を表示します。REA は `sudo` を呼び出しません。
-既定のランチャーは `/opt/hopper/bin/Hopper` です。別の場所では `HOPPER_LAUNCHER_PATH` を設定してください。Doctor が解析エンジン不足を報告した場合は `ldd /opt/hopper/bin/Hopper | grep 'not found'` を実行し、不足ライブラリを入れて `rea setup --yes` を再実行します。実解析には `DISPLAY` または `WAYLAND_DISPLAY` と有効化済み Hopper ライセンスが必要です。`~/.local/bin` も `PATH` に追加してください。
+既定のランチャーは `/opt/hopper/bin/Hopper` です。別の場所では `HOPPER_LAUNCHER_PATH` を設定してください。Doctor が解析エンジン不足を報告した場合は `ldd /opt/hopper/bin/Hopper | grep 'not found'` を実行し、不足ライブラリを入れて `rea setup` を再実行します。実解析には `DISPLAY` または `WAYLAND_DISPLAY` と有効化済み Hopper ライセンスが必要です。`~/.local/bin` も `PATH` に追加してください。
```bash
# 1. REA をセットアップ
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
-npx -y rea-agents setup --yes
+npx -y rea-agents setup
```
macOS やインストーラーから確認を求められた場合は、その操作を完了してから同じコマンドをもう一度実行してください。
diff --git a/README_ko.md b/README_ko.md
index a2e29fd55..7e8f1ffd3 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -11,7 +11,7 @@
[](https://www.npmjs.com/package/rea-agents)
[](https://github.com/morluto/rea/actions/workflows/ci.yml)
[](#68개-도구로-구성된-워크벤치)
-[](https://nodejs.org/)
+[](https://nodejs.org/)
[](LICENSE)
[빠른 시작](#빠른-시작) · [바이너리에서 동작까지](#바이너리에서-동작까지) · [68개 도구](#68개-도구로-구성된-워크벤치) · [작동 방식](#작동-방식) · [FAQ](#faq)
@@ -76,20 +76,20 @@ npx skills add morluto/rea
- macOS 12 이상
- Ubuntu 24.04+, Fedora 41+ 또는 64비트 Arch Linux
-- Node.js 24.18.x 및 npm 11.16.x (`nvm use`로 고정 버전 선택)
+- Node.js 22.19+ 또는 24.11+ 및 Node와 함께 제공되는 npm
-리버스 엔지니어링 도구를 직접 설치할 필요는 없습니다. Setup은 필요할 때 Homebrew와 [Hopper](https://www.hopperapp.com/)를 설치하고 지원되는 코딩 에이전트를 구성합니다. Hopper는 별도 소프트웨어이며 별도 라이선스가 필요합니다. Setup은 Hopper를 설치하지만 라이선스를 제공하지 않습니다.
+`rea setup`은 전체 변경 계획을 표시하고 확인 후 적용합니다. Homebrew, Node.js 또는 npm을 설치하거나 업데이트하지 않습니다. [Hopper](https://www.hopperapp.com/)가 없으면 공식 패키지 설치를 제안합니다. Hopper는 별도 라이선스가 필요한 독립 소프트웨어입니다.
#### Linux 설치 및 문제 해결
Ubuntu 24.04+, Fedora 41+, 64비트 Arch Linux에서 REA는 공식 DEB, RPM 또는 Arch 패키지를 내려받아 게시된 크기와 체크섬을 검증한 뒤 `apt-get`, `dnf` 또는 `pacman`으로 의존성을 설치합니다. root가 아니면 `pkexec`가 시스템 승인 창을 표시합니다. REA는 `sudo`를 호출하지 않습니다.
-기본 실행 파일은 `/opt/hopper/bin/Hopper`입니다. 다른 위치에 설치했다면 `HOPPER_LAUNCHER_PATH`를 설정하세요. Doctor가 분석 엔진 누락을 보고하면 `ldd /opt/hopper/bin/Hopper | grep 'not found'`를 실행하고 누락된 라이브러리를 설치한 다음 `rea setup --yes`를 다시 실행하세요. 실제 분석에는 `DISPLAY` 또는 `WAYLAND_DISPLAY`와 활성화된 Hopper 라이선스가 필요합니다. `~/.local/bin`도 `PATH`에 추가해야 합니다.
+기본 실행 파일은 `/opt/hopper/bin/Hopper`입니다. 다른 위치에 설치했다면 `HOPPER_LAUNCHER_PATH`를 설정하세요. Doctor가 분석 엔진 누락을 보고하면 `ldd /opt/hopper/bin/Hopper | grep 'not found'`를 실행하고 누락된 라이브러리를 설치한 다음 `rea setup`을 다시 실행하세요. 실제 분석에는 `DISPLAY` 또는 `WAYLAND_DISPLAY`와 활성화된 Hopper 라이선스가 필요합니다. `~/.local/bin`도 `PATH`에 추가해야 합니다.
```bash
# 1. REA 설정
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
-npx -y rea-agents setup --yes
+npx -y rea-agents setup
```
macOS나 설치 프로그램이 확인을 요청하면 해당 절차를 완료하고 같은 명령을 다시 실행하세요.
diff --git a/README_zh.md b/README_zh.md
index 1ca391939..f89c64a3b 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -11,7 +11,7 @@
[](https://www.npmjs.com/package/rea-agents)
[](https://github.com/morluto/rea/actions/workflows/ci.yml)
[](#68-个工具组成的工作台)
-[](https://nodejs.org/)
+[](https://nodejs.org/)
[](LICENSE)
[快速开始](#快速开始) · [从二进制到行为](#从二进制到行为) · [68 个工具](#68-个工具组成的工作台) · [工作原理](#工作原理) · [常见问题](#常见问题)
@@ -76,20 +76,20 @@ npx skills add morluto/rea
- macOS 12 或更高版本
- Ubuntu 24.04+、Fedora 41+ 或 64 位 Arch Linux
-- Node.js 24.18.x 和 npm 11.16.x(运行 `nvm use` 选择固定版本)
+- Node.js 22.19+ 或 24.11+,以及随 Node 安装的 npm
-你不需要手动安装逆向工程工具。Setup 会在需要时安装 Homebrew 和 [Hopper](https://www.hopperapp.com/),然后配置支持的编程智能体。Hopper 是独立软件,需要单独授权;Setup 可以安装它,但不提供许可证。
+`rea setup` 会先显示完整变更计划并请求确认。它不会安装或更新 Homebrew、Node.js 或 npm。缺少 [Hopper](https://www.hopperapp.com/) 时,Setup 会提议安装官方软件包;Hopper 是需要单独许可证的独立软件。
#### Linux 安装与故障排除
在 Ubuntu 24.04+、Fedora 41+ 和 64 位 Arch Linux 上,REA 会下载 Hopper 官方的 DEB、RPM 或 Arch 软件包,验证发布方提供的大小和校验和,然后通过 `apt-get`、`dnf` 或 `pacman` 安装依赖。非 root 运行时,`pkexec` 会显示系统授权提示;REA 不调用 `sudo`。
-默认启动器是 `/opt/hopper/bin/Hopper`。自定义安装可设置 `HOPPER_LAUNCHER_PATH`。如果 Doctor 报告缺少分析引擎,请运行 `ldd /opt/hopper/bin/Hopper | grep 'not found'`,安装缺少的系统库后重新运行 `rea setup --yes`。真实分析需要 `DISPLAY` 或 `WAYLAND_DISPLAY` 以及已激活的 Hopper 许可证。Linux 上还应确保 `~/.local/bin` 位于 `PATH` 中。
+默认启动器是 `/opt/hopper/bin/Hopper`。自定义安装可设置 `HOPPER_LAUNCHER_PATH`。如果 Doctor 报告缺少分析引擎,请运行 `ldd /opt/hopper/bin/Hopper | grep 'not found'`,安装缺少的系统库后重新运行 `rea setup`。真实分析需要 `DISPLAY` 或 `WAYLAND_DISPLAY` 以及已激活的 Hopper 许可证。Linux 上还应确保 `~/.local/bin` 位于 `PATH` 中。
```bash
# 1. 安装和配置 REA
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
-npx -y rea-agents setup --yes
+npx -y rea-agents setup
```
如果 macOS 或安装程序要求确认,请完成提示,然后再次运行同一命令。
diff --git a/docs/architecture.mermaid b/docs/architecture.mermaid
index 73efdba04..b4232344c 100644
--- a/docs/architecture.mermaid
+++ b/docs/architecture.mermaid
@@ -8,7 +8,7 @@ graph TD
subgraph "Adapters"
SERVER["src/server/ MCP request translation createServer, tool registration, toolResult"]
BRIDGE["bridge/hopper_bridge.py Runs inside Hopper adapts operations to Hopper Python API"]
- INSTALL["Host installation adapters macOS: Homebrew cask Linux: verified vendor package + apt/dnf/pacman"]
+ INSTALL["Host installation adapters macOS: verified vendor DMG to ~/Applications Linux: verified vendor package + apt/dnf/pacman"]
end
subgraph "Application Layer"
diff --git a/docs/installation.md b/docs/installation.md
new file mode 100644
index 000000000..78bb66ec6
--- /dev/null
+++ b/docs/installation.md
@@ -0,0 +1,60 @@
+# Installation and setup
+
+REA separates installing its CLI from configuring external software and coding agents.
+
+## Install the CLI
+
+The recommended installation is:
+
+```bash
+npm install --global rea-agents
+rea setup
+```
+
+REA supports Node.js 22.19+ and 24.11+ (including newer releases). It uses the npm already paired with that runtime and never upgrades Node.js, npm, or Homebrew.
+
+The optional curl wrapper installs only the global npm package:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
+```
+
+It prints the version, runtime, npm command, and destination before installing. When a controlling terminal exists it starts `rea setup`; otherwise it prints the command to run later.
+
+Pass options with `bash -s --`:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh |
+ bash -s -- --dry-run
+```
+
+Supported options are `--version `, `--dry-run`, `--no-setup`, `--no-prompt`, and `--verbose`. Neither `--no-prompt` nor a non-interactive shell grants permission to install external dependencies.
+
+## Review setup changes
+
+`rea setup` discovers the current state, prints one plan, and asks `Continue? [Y/n]`. The plan identifies:
+
+- an existing Hopper installation or the official package it proposes to install;
+- each detected coding-agent configuration path;
+- the REA skill destination;
+- external software and package-manager effects.
+
+Declining makes no changes. Agent configuration writes preserve unrelated entries, create backups, use atomic replacement, and verify their result.
+
+For automation, `rea setup --json` reports the plan without applying it. `rea setup --yes` applies user-owned registrations and the skill. Installing missing Hopper non-interactively additionally requires `--install-hopper`:
+
+```bash
+rea setup --yes --install-hopper --json
+```
+
+## Hopper
+
+Hopper is separate commercial software with its own license. REA reuses any detected installation and preserves Hopper during uninstall.
+
+On macOS, approved setup downloads the official DMG, checks its published size and digest, validates the application bundle, and atomically installs it to `~/Applications/Hopper Disassembler.app`. REA then opens Hopper for its one-time activation. Homebrew and administrator access are not used.
+
+On supported Linux distributions, approved setup verifies Hopper's official `.deb`, `.rpm`, or Arch package before invoking the native package manager. Unattended package-manager access requires `--yes --install-hopper`.
+
+## Diagnose, update, and remove
+
+`rea doctor --json` is strictly read-only. `rea upgrade` updates only the npm installation that owns the running CLI. `rea uninstall` removes only REA-owned agent registrations and skill files; `--purge-data` additionally removes REA cache and state paths.
diff --git a/docs/roadmap.md b/docs/roadmap.md
new file mode 100644
index 000000000..588b382b8
--- /dev/null
+++ b/docs/roadmap.md
@@ -0,0 +1,16 @@
+# Installation roadmap
+
+REA setup currently configures the capabilities that exist today: its coding-agent integrations, bundled skill, and optional Hopper provider.
+
+When REA has at least two real optional toolchains, setup can evolve into a capability-oriented wizard. It may ask whether the operator wants to investigate native binaries, websites, mobile applications, firmware, or runtime protocols, then propose only the tools needed for the selected work.
+
+That future installer must preserve the current safety boundary:
+
+- detect and reuse existing tools;
+- disclose every source, destination, license, command, and system effect;
+- prefer user-local installation;
+- install only explicitly selected toolchains;
+- require tool-specific authorization for unattended system changes;
+- verify each installed tool before reporting readiness.
+
+No placeholder tool choices or speculative installer registry are implemented until another supported toolchain makes the abstraction concrete.
diff --git a/tests/readmeConsistency.test.ts b/tests/readmeConsistency.test.ts
index 332d1c5e4..1d57b0237 100644
--- a/tests/readmeConsistency.test.ts
+++ b/tests/readmeConsistency.test.ts
@@ -60,11 +60,11 @@ describe("localized README product facts", () => {
expect(content).toContain(
"curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash",
);
- expect(content).toContain("npx -y rea-agents setup --yes");
+ expect(content).toContain("npx -y rea-agents setup");
expect(content).toContain("npx -y rea-agents doctor");
expect(content).toContain("rea uninstall");
expect(content).toContain('"args": ["-y", "rea-agents", "mcp"]');
- expect(content).toContain("Node.js 24");
+ expect(content).toContain("Node.js 22");
expect(content).toContain("macOS 12");
expect(content).toContain("Ubuntu 24.04");
expect(content).toContain("Fedora 41");
@@ -80,7 +80,9 @@ describe("localized README product facts", () => {
const content = await readFile(resolve("README.md"), "utf8");
expect(content).toContain("npx -y rea-agents analyze");
expect(content).toContain("npm install --global rea-agents");
- expect(content).toContain("rea setup --yes");
+ expect(content).toContain("rea setup");
+ expect(content).toContain("--install-hopper");
+ expect(content).toContain("docs/installation.md");
expect(content).toContain("You do not need both");
});
});
From 5df4ef67a4676f46900aa6022c1af2224efa8761 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Mon, 13 Jul 2026 15:14:13 +0800
Subject: [PATCH 3/4] docs: define REA contributor priorities
---
AGENTS.md | 15 ++++++++++++++-
1 file changed, 14 insertions(+), 1 deletion(-)
diff --git a/AGENTS.md b/AGENTS.md
index 9b0011aab..039fbdf22 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,18 @@
# Repository Guidelines
+## Product Direction
+
+REA exposes reverse-engineering tools through a CLI and MCP server. Hopper is its current binary-analysis provider; keep provider-specific code out of the domain and application layers.
+
+Prioritize:
+
+- tool results that distinguish observations, inferences, and unknowns;
+- equivalent behavior through the CLI and MCP;
+- additive, idempotent configuration with backups;
+- end-to-end tests for packaged artifacts and real Hopper claims.
+
+Installers must not install or upgrade Homebrew, Node.js, npm, or other unrelated software. `rea setup` must print its planned changes and require approval before writing files or installing Hopper.
+
## Project Structure & Module Organization
REA is a layered ESM TypeScript application. Dependencies flow inward: `domain` ← `contracts` ← `hopper` ← `application` ← `server` ← adapters.
@@ -14,7 +27,7 @@ See [docs/architecture.mermaid](docs/architecture.mermaid) for a visual architec
- `src/contracts/`: caller-visible schemas for 33 direct, 10 enhanced, 5 native, 2 artifact, and 18 session tools; `enhancedInputs.ts` owns enhanced input parsing.
- `src/hopper/`: Hopper launch and Unix-socket protocol mechanics. `BridgeLauncher.ts` spawns the Hopper app with the in-process bridge, `HopperClient.ts` correlates request/response over the socket with timeouts and cancellation, `protocol.ts` frames bridge messages.
- `bridge/hopper_bridge.py`: runs inside Hopper and adapts declared operations to Hopper's public Python API. Hopper's bundled MCP server is not used.
-- `src/application/`: shared CLI/MCP session composition, setup and diagnostics, and the 8 enhanced workflows.
+- `src/application/`: shared CLI/MCP session composition, setup and diagnostics, and enhanced workflows.
- `src/server/`: MCP request translation. `createServer.ts` assembles the MCP server, `registerOfficialTools.ts`/`registerEnhancedTools.ts` register each tool set, `toolResult.ts` maps `Result` values to MCP content.
- `tests/`: Vitest suite. `tests/fixtures/` holds the fake launcher and fake Hopper bridge used as production seams.
- `scripts/verify-real-hopper.mjs`: real-Hopper end-to-end verifier.
From 0a66cae16ef8e2a243bbed502bbb7cdbd12a965f Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Mon, 13 Jul 2026 15:14:21 +0800
Subject: [PATCH 4/4] docs(api): regenerate TypeDoc reference
---
docs/api/assets/hierarchy.js | 2 +-
docs/api/assets/navigation.js | 2 +-
docs/api/assets/search.js | 2 +-
...plication_BinarySession.BinarySession.html | 264 +++++++++++++++--
...n_CompositeProvider.CompositeProvider.html | 128 ++++++++
...plication_EnhancedTools.EnhancedTools.html | 20 +-
...ication_EvidenceLedger.EvidenceLedger.html | 245 ++++++++++++++++
...on_ProcessHarness.ProcessCaptureError.html | 99 +++++++
...domain_errors.AnalysisCancelledError.html} | 48 +--
...rs.AnalysisCapabilityUnavailableError.html | 107 +++++++
.../classes/domain_errors.AnalysisError.html | 117 ++++++++
.../domain_errors.AnalysisInputError.html | 94 ++++++
.../domain_errors.AnalysisOutputError.html | 101 +++++++
.../domain_errors.AnalysisProtocolError.html | 99 +++++++
.../domain_errors.AnalysisTimeoutError.html | 100 +++++++
.../domain_errors.ArtifactOperationError.html | 100 +++++++
.../domain_errors.BinaryTargetError.html | 24 +-
.../domain_errors.ConfigurationError.html | 20 +-
.../domain_errors.EvidenceFileError.html | 101 +++++++
.../domain_errors.EvidenceIntegrityError.html | 99 +++++++
.../domain_errors.EvidenceLimitError.html | 100 +++++++
.../domain_errors.HopperCancelledError.html | 14 +-
.../classes/domain_errors.HopperError.html | 35 +--
.../domain_errors.HopperProcessError.html | 16 +-
.../domain_errors.HopperProtocolError.html | 12 +-
.../domain_errors.HopperRemoteError.html | 31 +-
.../domain_errors.HopperStartError.html | 14 +-
.../domain_errors.HopperTimeoutError.html | 16 +-
.../domain_errors.NoBinaryOpenError.html | 22 +-
.../domain_errors.ProviderAdapterError.html | 101 +++++++
.../domain_errors.ProviderSelectionError.html | 93 ++++++
.../domain_errors.UnknownRegistryError.html | 94 ++++++
...dgeLauncher.HopperApplicationLauncher.html | 19 +-
.../hopper_HopperClient.HopperClient.html | 18 +-
.../hopper_HopperProvider.HopperProvider.html | 115 ++++++++
...lysisProvider.createAnalysisExecution.html | 46 +++
...on_ArtifactExtraction.extractArtifact.html | 45 +++
...hConstruction.classifyArtifactContent.html | 45 +++
...raphConstruction.classifyArtifactPath.html | 42 +++
...GraphConstruction.createArtifactEdges.html | 44 +++
...tGraphConstruction.createArtifactNode.html | 42 +++
...actGraphConstruction.createOccurrence.html | 44 +++
...ifactGraphConstruction.createRootNode.html | 42 +++
...factGraphConstruction.digestCanonical.html | 42 +++
...onstruction.materializeDirectoryNodes.html | 43 +++
...tifactGraphConstruction.nearestParent.html | 43 +++
...tion_ArtifactGraphConstruction.pageOf.html | 48 +++
...actGraphConstruction.rekeyOccurrences.html | 43 +++
...ctGraphConstruction.rootOccurrenceFor.html | 43 +++
...ifactGraphConstruction.toOutputLimits.html | 42 +++
...n_ArtifactInventory.inventoryArtifact.html | 47 +++
...ctInventory.paginateArtifactInventory.html | 45 +++
...tifactInventory.scanArtifactInventory.html | 46 +++
...tion_DirectAnalysis.runDirectAnalysis.html | 15 +-
...on_DirectAnalysis.runProviderAnalysis.html | 47 +++
...ation_DirectAnalysis.runSessionStatus.html | 44 +++
.../application_Doctor.runDoctor.html | 8 +-
.../application_Doctor.systemDoctorHost.html | 8 +-
...ommands.compareEvidenceBundlesCommand.html | 44 +++
...eCommands.exportEvidenceBundleCommand.html | 47 +++
...eCommands.importEvidenceBundleCommand.html | 45 +++
...videnceBundleFiles.readEvidenceBundle.html | 45 +++
...idenceBundleFiles.writeEvidenceBundle.html | 47 +++
...tion_FilesystemSnapshot.snapshotRoots.html | 45 +++
...cation_LinuxHopper.installLinuxHopper.html | 45 +++
...n_LinuxHopper.linuxHopperLauncherPath.html | 44 +++
...inuxHopper.linuxPackageManagerCommand.html | 46 +++
...xHopper.linuxSharedLibrariesAvailable.html | 44 +++
...on_LinuxHopper.parseLinuxDistribution.html | 44 +++
...ion_LinuxHopper.readLinuxDistribution.html | 40 +++
...on_LoopbackReplay.startLoopbackReplay.html | 44 +++
...pplication_MacHopper.installMacHopper.html | 44 +++
...ProcessHarness.captureProcessScenario.html | 46 +++
...Harness.probeProcessCaptureCapability.html | 40 +++
...Normalization.normalizeProcessSamples.html | 44 +++
...essNormalization.normalizeProcessText.html | 47 +++
...essNormalization.redactProtocolEvents.html | 43 +++
...essOwnership.cleanupOwnedProcessGroup.html | 45 +++
...n_ProcessSampling.startProcessSampler.html | 47 +++
...opperAssertions.firstProcedureAddress.html | 44 +++
...lHopperAssertions.requireAddressArray.html | 45 +++
...ssertions.requireDistinctTargetHashes.html | 45 +++
...pperAssertions.requireFunctionDossier.html | 45 +++
...ealHopperAssertions.requirePseudocode.html | 45 +++
...nceSourceImport.importReferenceSource.html | 47 +++
...rtEntries.parseReferenceSourceEntries.html | 46 +++
...rtPolicy.prepareReferenceSourceImport.html | 44 +++
...urceVcsAdapter.readReferenceSourceVcs.html | 46 +++
...application_Setup.configureJsonClient.html | 13 +-
...application_Setup.configureTomlClient.html | 46 +++
.../application_Setup.detectClients.html | 44 +++
...plication_Setup.installCanonicalSkill.html | 44 +++
.../functions/application_Setup.runSetup.html | 19 +-
.../application_Setup.supportedClients.html | 44 +++
.../application_Uninstall.runUninstall.html | 45 +++
...cation_Uninstall.systemUninstallHost.html} | 33 +--
...ication_Upgrade.detectNpmInstallation.html | 45 +++
.../application_Upgrade.runUpgrade.html | 46 +++
...application_Upgrade.systemUpgradeHost.html | 40 +++
.../application_homebrew.probeHomebrew.html | 6 +-
...plication_runtime.createBinarySession.html | 13 +-
docs/api/functions/cli.createCli.html | 8 +-
docs/api/functions/config.parseConfig.html | 8 +-
...toolOutputSchemas.requireOutputSchema.html | 45 +++
...n_artifactComparison.compareArtifacts.html | 47 +++
...idence.parseArtifactInventoryEvidence.html | 44 +++
...domain_binaryTarget.parseBinaryTarget.html | 12 +-
...in_binaryTarget.parseExecutableHeader.html | 8 +-
...omain_bundleComparison.compareBundles.html | 44 +++
.../domain_callPath.buildCallPath.html | 44 +++
...n_changedBehavior.findChangedBehavior.html | 46 +++
.../domain_errors.projectAnalysisError.html | 44 +++
.../domain_evidence.createEvidence.html | 46 +++
.../domain_evidence.parseEvidence.html | 44 +++
...n_evidenceBundle.createEvidenceBundle.html | 45 +++
...in_evidenceBundle.parseEvidenceBundle.html | 44 +++
...videnceBundle.serializeEvidenceBundle.html | 44 +++
...n_functionComparison.compareFunctions.html | 47 +++
...mparisonNormalization.combineCoverage.html | 47 +++
...arisonNormalization.commentProjection.html | 42 +++
...ComparisonNormalization.functionMatch.html | 43 +++
...risonNormalization.identityProjection.html | 42 +++
...ionComparisonNormalization.isAutoName.html | 42 +++
...nComparisonNormalization.normalizeCfg.html | 42 +++
...nctionComparisonNormalization.project.html | 48 +++
...isonNormalization.referenceProjection.html | 42 +++
...unctionComparisonNormalization.sorted.html | 42 +++
...Normalization.stringAndNameProjection.html | 42 +++
...nctionComparisonResults.canonicalJson.html | 42 +++
...tionComparisonResults.dimensionResult.html | 42 +++
...nctionComparisonResults.overallStatus.html | 43 +++
...n_functionComparisonResults.summarize.html | 42 +++
...ComparisonResults.unresolvedDimension.html | 42 +++
...DossierEvidence.parseFunctionEvidence.html | 44 +++
.../domain_hopperValues.addressDistance.html | 45 +++
...omain_hopperValues.parseAddressedPage.html | 44 +++
.../domain_hopperValues.parseDocuments.html | 8 +-
...ain_hopperValues.parseFunctionDossier.html | 44 +++
.../domain_hopperValues.parseListCount.html | 8 +-
.../domain_hopperValues.parseNames.html | 8 +-
.../domain_hopperValues.parseProcedures.html | 8 +-
...in_hopperValues.parseRelatedAddresses.html | 12 +-
.../domain_hopperValues.parseSegments.html | 8 +-
...ocessCapture.authorizeProcessScenario.html | 45 +++
...n_processCapture.parseProcessScenario.html | 44 +++
...cessComparison.compareProcessCaptures.html | 45 +++
...nUnknowns.reconstructionClaimUnknowns.html | 46 +++
...tructionUnknowns.reconstructionProbes.html | 45 +++
...onUnknowns.reconstructionUnknownHeads.html | 44 +++
...tionVerification.verifyReconstruction.html | 47 +++
...ification.classifyReferenceSourcePath.html | 44 +++
...ication.detectReferenceSourceLanguage.html | 44 +++
...SourceClassification.isSecretLikePath.html | 44 +++
...ph.computeHistoricalSourceGraphSha256.html | 44 +++
...urceGraph.createHistoricalSourceGraph.html | 44 +++
...eGraph.createHistoricalSourceManifest.html | 44 +++
...ourceGraph.parseHistoricalSourceGraph.html | 44 +++
...ceGraph.parseHistoricalSourceManifest.html | 44 +++
...rtParsing.parseReferenceSourceImports.html | 46 +++
...residualUnknown.createResidualUnknown.html | 46 +++
...residualUnknown.updateResidualUnknown.html | 46 +++
docs/api/functions/domain_result.err.html | 6 +-
docs/api/functions/domain_result.ok.html | 6 +-
...in_runtimeVersion.supportsNodeVersion.html | 44 +++
...Correlation.correlateStaticAndRuntime.html | 44 +++
...n_symbolAnalysis.categorizeSwiftTypes.html | 6 +-
...in_symbolAnalysis.discoverObjcClasses.html | 6 +-
..._symbolAnalysis.discoverObjcProtocols.html | 6 +-
...n_symbolAnalysis.discoverSwiftClasses.html | 6 +-
.../hopper_protocol.parseResponseLine.html | 12 +-
.../hopper_protocol.responseResult.html | 12 +-
docs/api/functions/main.run.html | 8 +-
.../server_createServer.createServer.html | 15 +-
...DerivedEvidence.recordDerivedEvidence.html | 46 +++
...onTool.registerArtifactComparisonTool.html | 46 +++
...erArtifactTools.registerArtifactTools.html | 46 +++
...isonTool.registerBundleComparisonTool.html | 46 +++
...erEnhancedTools.registerEnhancedTools.html | 13 +-
...erEvidenceTools.registerEvidenceTools.html | 47 +++
...onTool.registerFunctionComparisonTool.html | 46 +++
...ationTools.registerInvestigationTools.html | 46 +++
...gisterNativeTools.registerNativeTools.html | 46 +++
...erOfficialTools.registerOfficialTools.html | 13 +-
...sonTool.registerProcessComparisonTool.html | 46 +++
...sterSessionTools.registerSessionTools.html | 16 +-
...ver_sessionEvidence.isSessionEvidence.html | 45 +++
...essionEvidence.resolveSessionEvidence.html | 45 +++
.../server_toolLogging.logToolExecution.html | 51 ++++
...rationOptions.toolRegistrationOptions.html | 44 +++
.../server_toolResult.toCallToolResult.html | 13 +-
docs/api/hierarchy.html | 62 ++--
docs/api/index.html | 12 +-
...ation_AnalysisProvider.AnalysisClient.html | 85 ++++++
...on_AnalysisProvider.AnalysisExecution.html | 88 ++++++
...nalysisProvider.AnalysisOperationPort.html | 75 +++++
...ion_AnalysisProvider.AnalysisProvider.html | 91 ++++++
...ion_AnalysisProvider.ProviderIdentity.html | 67 +++++
...actExtraction.ArtifactExtractionInput.html | 94 ++++++
...ctGraphConstruction.MutableOccurrence.html | 124 ++++++++
...ctInventory.ArtifactInventorySnapshot.html | 94 ++++++
...pplication_BinarySession.BinaryClient.html | 89 ------
...ation_BinarySession.BinarySessionPort.html | 275 ++++++++++++++++++
.../application_Doctor.DoctorCheck.html | 28 +-
.../application_Doctor.DoctorHost.html | 44 +--
...n_EvidenceLedger.EvidenceLedgerLimits.html | 61 ++++
...ion_FilesystemSnapshot.SnapshotResult.html | 61 ++++
...ication_HopperToolPort.HopperToolPort.html | 82 ------
...ication_LinuxHopper.LinuxDistribution.html | 76 +++++
...ation_LinuxHopper.LinuxHopperDownload.html | 64 ++++
...on_LinuxHopper.LinuxHopperInstallHost.html | 145 +++++++++
...ication_LoopbackReplay.LoopbackReplay.html | 94 ++++++
...cation_MacHopper.MacHopperInstallHost.html | 244 ++++++++++++++++
...on_ProcessOwnership.OwnedProcessGroup.html | 83 ++++++
...ProcessOwnership.ProcessOwnershipHost.html | 92 ++++++
...tEntries.ParsedReferenceSourceEntries.html | 73 +++++
...tPolicy.PreparedReferenceSourceImport.html | 76 +++++
...mportTypes.ReferenceSourceImportError.html | 70 +++++
...ortTypes.ReferenceSourceImportOptions.html | 100 +++++++
.../application_Setup.SetupAction.html | 76 +++++
.../application_Setup.SetupClient.html | 28 +-
.../application_Setup.SetupHost.html | 73 ++---
.../application_Setup.SetupOptions.html | 70 +++++
.../application_Setup.SetupResult.html | 36 ++-
.../application_Uninstall.UninstallHost.html | 96 ++++++
.../application_Uninstall.UninstallItem.html | 70 +++++
...application_Uninstall.UninstallResult.html | 64 ++++
.../application_Upgrade.NpmInstallation.html | 58 ++++
...plication_Upgrade.NpmInstallationHost.html | 86 ++++++
.../application_Upgrade.UpgradeHost.html | 87 ++++++
docs/api/interfaces/config.AppConfig.html | 46 ++-
...ntracts_toolContracts.ToolAnnotations.html | 73 +++++
.../contracts_toolContracts.ToolContract.html | 54 +++-
.../contracts_toolContracts.ToolExample.html | 61 ++++
...rtifactInventoryEvidence.InventorySet.html | 88 ++++++
.../domain_binaryTarget.BinaryTarget.html | 44 ++-
...domain_errors.AnalysisErrorProjection.html | 78 +++++
.../domain_evidence.EvidenceObservation.html | 115 ++++++++
.../domain_evidence.EvidenceProvider.html | 67 +++++
...domain_evidence.EvidenceSubjectTarget.html | 76 +++++
...ain_evidenceBundle.EvidenceFilePolicy.html | 79 +++++
...omparisonResults.DimensionResultInput.html | 109 +++++++
...ionDossierEvidence.FunctionCollection.html | 77 +++++
...ctionDossierEvidence.FunctionSnapshot.html | 100 +++++++
.../domain_hopperValues.AddressedName.html | 6 +-
.../domain_hopperValues.AddressedPage.html | 67 +++++
.../domain_hopperValues.SegmentSummary.html | 30 +-
.../domain_processCapture.FileState.html | 88 ++++++
.../domain_processCapture.ProcessCapture.html | 130 +++++++++
...processCapture.ProcessExecutionPolicy.html | 82 ++++++
.../domain_processCapture.ProcessSample.html | 76 +++++
.../domain_processCapture.ProtocolEvent.html | 100 +++++++
.../domain_processCapture.TerminalFrame.html | 70 +++++
...sing.ReferenceSourceImportParseResult.html | 61 ++++
...nceSourcePolicy.ReferenceSourcePolicy.html | 88 ++++++
.../hopper_BridgeLauncher.BridgeLaunch.html | 24 +-
.../hopper_BridgeLauncher.BridgeLauncher.html | 10 +-
.../hopper_BridgeLauncher.BridgeSession.html | 24 +-
...cher.HopperApplicationLauncherOptions.html | 18 +-
...pper_HopperClient.HopperClientOptions.html | 28 +-
.../hopper_HopperClient.HopperServerInfo.html | 12 +-
...rver_createServer.CreateServerOptions.html | 67 +++++
...nhancedTools.EnhancedToolRegistration.html | 76 +++++
...fficialTools.OfficialToolRegistration.html | 76 +++++
...gisterSessionTools.SessionToolOptions.html | 64 ++++
.../modules/application_AnalysisProvider.html | 44 +++
.../application_ArtifactExtraction.html | 40 +++
...application_ArtifactGraphConstruction.html | 40 +++
.../application_ArtifactInventory.html | 40 +++
.../modules/application_BinarySession.html | 14 +-
.../application_CompositeProvider.html | 36 +++
.../modules/application_DirectAnalysis.html | 10 +-
docs/api/modules/application_Doctor.html | 6 +-
.../modules/application_EnhancedTools.html | 6 +-
.../application_EvidenceBundleCommands.html | 36 +++
.../application_EvidenceBundleFiles.html | 36 +++
.../modules/application_EvidenceLedger.html | 40 +++
.../application_FilesystemSnapshot.html | 40 +++
docs/api/modules/application_LinuxHopper.html | 44 +++
.../modules/application_LoopbackReplay.html | 40 +++
docs/api/modules/application_MacHopper.html | 44 +++
.../modules/application_ProcessHarness.html | 44 +++
.../application_ProcessNormalization.html | 36 +++
.../modules/application_ProcessOwnership.html | 44 +++
.../modules/application_ProcessSampling.html | 36 +++
.../application_RealHopperAssertions.html | 36 +++
.../application_ReferenceSourceImport.html | 40 +++
...lication_ReferenceSourceImportEntries.html | 40 +++
...plication_ReferenceSourceImportPolicy.html | 40 +++
...pplication_ReferenceSourceImportTypes.html | 40 +++
...application_ReferenceSourceVcsAdapter.html | 40 +++
docs/api/modules/application_Setup.html | 18 +-
docs/api/modules/application_Uninstall.html | 40 +++
docs/api/modules/application_Upgrade.html | 44 +++
docs/api/modules/application_homebrew.html | 10 +-
docs/api/modules/application_runtime.html | 6 +-
docs/api/modules/cli.html | 6 +-
docs/api/modules/config.html | 6 +-
.../contracts_artifactComparisonExample.html | 36 +++
.../contracts_artifactToolContracts.html | 40 +++
.../api/modules/contracts_enhancedInputs.html | 6 +-
.../contracts_functionComparisonExample.html | 36 +++
.../contracts_investigationExamples.html | 36 +++
.../contracts_nativeToolContracts.html | 40 +++
.../contracts_processCaptureExample.html | 36 +++
.../contracts_toolContractExamples.html | 36 +++
docs/api/modules/contracts_toolContracts.html | 14 +-
.../modules/contracts_toolOutputSchemas.html | 40 +++
.../contracts_unknownContractExamples.html | 36 +++
.../modules/domain_artifactComparison.html | 44 +++
docs/api/modules/domain_artifactGraph.html | 40 +++
.../domain_artifactInventoryEvidence.html | 40 +++
docs/api/modules/domain_binaryTarget.html | 10 +-
docs/api/modules/domain_bundleComparison.html | 44 +++
docs/api/modules/domain_callPath.html | 44 +++
docs/api/modules/domain_changedBehavior.html | 44 +++
docs/api/modules/domain_errors.html | 26 +-
docs/api/modules/domain_evidence.html | 48 +++
docs/api/modules/domain_evidenceBundle.html | 48 +++
.../modules/domain_functionComparison.html | 40 +++
...omain_functionComparisonNormalization.html | 36 +++
.../domain_functionComparisonResults.html | 40 +++
.../domain_functionComparisonSchemas.html | 40 +++
.../domain_functionDossierEvidence.html | 40 +++
docs/api/modules/domain_hopperValues.html | 22 +-
docs/api/modules/domain_jsonValue.html | 40 +++
docs/api/modules/domain_nativeInspection.html | 40 +++
docs/api/modules/domain_processCapture.html | 52 ++++
.../api/modules/domain_processComparison.html | 40 +++
.../domain_reconstructionUnknowns.html | 36 +++
.../domain_reconstructionVerification.html | 40 +++
...ain_reconstructionVerificationSchemas.html | 40 +++
.../domain_referenceSourceClassification.html | 40 +++
.../modules/domain_referenceSourceGraph.html | 44 +++
.../domain_referenceSourceImportParsing.html | 40 +++
.../modules/domain_referenceSourcePolicy.html | 36 +++
docs/api/modules/domain_residualUnknown.html | 44 +++
docs/api/modules/domain_result.html | 6 +-
docs/api/modules/domain_runtimeVersion.html | 36 +++
.../domain_staticRuntimeCorrelation.html | 44 +++
docs/api/modules/domain_symbolAnalysis.html | 6 +-
docs/api/modules/hopper_BridgeLauncher.html | 6 +-
docs/api/modules/hopper_HopperClient.html | 14 +-
docs/api/modules/hopper_HopperProvider.html | 36 +++
docs/api/modules/hopper_protocol.html | 14 +-
docs/api/modules/main.html | 6 +-
docs/api/modules/server_createServer.html | 10 +-
.../modules/server_recordDerivedEvidence.html | 36 +++
...server_registerArtifactComparisonTool.html | 36 +++
.../modules/server_registerArtifactTools.html | 36 +++
.../server_registerBundleComparisonTool.html | 36 +++
.../modules/server_registerEnhancedTools.html | 10 +-
.../modules/server_registerEvidenceTools.html | 36 +++
...server_registerFunctionComparisonTool.html | 36 +++
.../server_registerInvestigationTools.html | 36 +++
...t.html => server_registerNativeTools.html} | 18 +-
.../modules/server_registerOfficialTools.html | 10 +-
.../server_registerProcessComparisonTool.html | 36 +++
.../modules/server_registerSessionTools.html | 10 +-
docs/api/modules/server_sessionEvidence.html | 36 +++
.../modules/server_sessionToolPolicies.html | 36 +++
docs/api/modules/server_toolLogging.html | 36 +++
.../server_toolRegistrationOptions.html | 36 +++
docs/api/modules/server_toolResult.html | 6 +-
...nalysisProvider.AnalysisClientFactory.html | 45 +++
...on_AnalysisProvider.AnalysisOperation.html | 35 +++
...AnalysisProvider.CapabilityDescriptor.html | 33 +++
..._LinuxHopper.LinuxHopperInstallResult.html | 35 +++
...ation_LinuxHopper.LinuxPackageFamily.html} | 18 +-
...tion_MacHopper.MacHopperInstallResult.html | 35 +++
...ocessHarness.ProcessCaptureCapability.html | 35 +++
...ProcessOwnership.ProcessCleanupResult.html | 33 +++
...urceVcsAdapter.ReferenceSourceVcsInfo.html | 33 +++
...ation_Setup.ClientConfigurationResult.html | 10 +-
.../application_Setup.SetupConfirmation.html | 47 +++
.../application_Upgrade.UpgradeOutput.html | 35 +++
.../application_Upgrade.UpgradeResult.html | 35 +++
...tifactToolContracts.ArtifactToolName.html} | 18 +-
...racts_enhancedInputs.EnhancedToolName.html | 8 +-
...ts_nativeToolContracts.NativeToolName.html | 33 +++
...tracts_toolContracts.OfficialToolName.html | 35 +++
...ctComparison.ArtifactComparisonResult.html | 33 +++
...domain_artifactGraph.ArtifactCommand.html} | 25 +-
.../domain_artifactGraph.ArtifactEdge.html | 35 +++
...rtifactGraph.ArtifactExtractionResult.html | 35 +++
...n_artifactGraph.ArtifactGraphManifest.html | 35 +++
...artifactGraph.ArtifactInventoryResult.html | 35 +++
.../domain_artifactGraph.ArtifactNode.html | 35 +++
...main_artifactGraph.ArtifactOccurrence.html | 35 +++
...ndleComparison.BundleComparisonResult.html | 33 +++
.../types/domain_callPath.CallPathInput.html | 33 +++
.../types/domain_callPath.CallPathResult.html | 33 +++
...changedBehavior.ChangedBehaviorResult.html | 33 +++
.../types/domain_errors.AnalysisErrorTag.html | 35 +++
.../domain_errors.HopperDiagnosticType.html | 33 +++
...ind.html => domain_evidence.Evidence.html} | 18 +-
.../domain_evidence.EvidenceLocation.html | 33 +++
.../domain_evidenceBundle.EvidenceBundle.html | 33 +++
...nctionComparisonSchemas.DimensionName.html | 33 +++
...risonSchemas.FunctionComparisonResult.html | 33 +++
...nComparisonSchemas.FunctionDimension.html} | 18 +-
.../domain_hopperValues.FunctionDossier.html | 35 +++
...e.html => domain_jsonValue.JsonValue.html} | 12 +-
...ain_nativeInspection.InspectSignature.html | 33 +++
...iveInspection.NativeCommandInvocation.html | 33 +++
..._processCapture.ProcessPolicyDecision.html | 35 +++
...domain_processCapture.ProcessScenario.html | 35 +++
...rificationSchemas.ReconstructionClaim.html | 33 +++
...tionSchemas.ReconstructionClaimResult.html | 33 +++
...nSchemas.ReconstructionObservedStatus.html | 33 +++
...emas.ReconstructionVerificationResult.html | 33 +++
...ication.ReferenceSourceClassification.html | 33 +++
...enceSourceGraph.HistoricalSourceGraph.html | 33 +++
...ourceGraph.HistoricalSourceGraphInput.html | 33 +++
...eSourceGraph.HistoricalSourceManifest.html | 33 +++
...in_residualUnknown.RecordUnknownInput.html | 33 +++
...omain_residualUnknown.ResidualUnknown.html | 33 +++
.../domain_residualUnknown.UnknownStatus.html | 33 +++
...in_residualUnknown.UpdateUnknownInput.html | 33 +++
docs/api/types/domain_result.Result.html | 6 +-
...lation.StaticRuntimeCorrelationResult.html | 33 +++
.../types/hopper_protocol.HopperResponse.html | 8 +-
...AULT_REFERENCE_SOURCE_IGNORE_PATTERNS.html | 33 +++
...Types.DEFAULT_REFERENCE_SOURCE_LIMITS.html | 33 +++
....PARSEABLE_REFERENCE_SOURCE_LANGUAGES.html | 33 +++
...onExample.ARTIFACT_COMPARISON_EXAMPLE.html | 42 +++
...ToolContracts.ARTIFACT_TOOL_CONTRACTS.html | 35 +++
...ntracts.artifactExtractionInputSchema.html | 35 +++
...ontracts.artifactInventoryInputSchema.html | 35 +++
...s_enhancedInputs.enhancedInputSchemas.html | 16 +-
...enhancedInputs.enhancedToolNameSchema.html | 10 +-
...onExample.FUNCTION_COMPARISON_EXAMPLE.html | 42 +++
...Examples.FUNCTION_COMPARISON_EVIDENCE.html | 66 +++++
...gationExamples.INVESTIGATION_EXAMPLES.html | 46 +++
...amples.PROCESS_CAPTURE_RECONSTRUCTION.html | 66 +++++
...ionExamples.PROCESS_CAPTURE_REFERENCE.html | 66 +++++
...nExamples.PROCESS_COMPARISON_EVIDENCE.html | 66 +++++
...veToolContracts.NATIVE_TOOL_CONTRACTS.html | 35 +++
...Example.EMPTY_PROCESS_CAPTURE_EXAMPLE.html | 64 ++++
...ntractExamples.TOOL_EXAMPLE_OVERRIDES.html | 35 +++
...toolContracts.ENHANCED_TOOL_CONTRACTS.html | 10 +-
...toolContracts.OFFICIAL_TOOL_CONTRACTS.html | 10 +-
..._toolContracts.SESSION_TOOL_CONTRACTS.html | 10 +-
...ontracts_toolContracts.TOOL_CONTRACTS.html | 12 +-
...olOutputSchemas.artifactOutputSchemas.html | 35 +++
...olOutputSchemas.enhancedOutputSchemas.html | 35 +++
...toolOutputSchemas.nativeOutputSchemas.html | 35 +++
...olOutputSchemas.officialOutputSchemas.html | 35 +++
...oolOutputSchemas.sessionOutputSchemas.html | 35 +++
...actExamples.UNKNOWN_CONTRACT_EXAMPLES.html | 46 +++
...parison.artifactComparisonInputSchema.html | 35 +++
...arison.artifactComparisonResultSchema.html | 35 +++
...tGraph.artifactExtractionResultSchema.html | 35 +++
...ctGraph.artifactInventoryResultSchema.html | 35 +++
...omparison.bundleComparisonInputSchema.html | 35 +++
...mparison.bundleComparisonResultSchema.html | 35 +++
.../domain_callPath.callPathInputSchema.html | 35 +++
.../domain_callPath.callPathResultSchema.html | 35 +++
...edBehavior.changedBehaviorInputSchema.html | 35 +++
...dBehavior.changedBehaviorResultSchema.html | 35 +++
.../domain_errors.ANALYSIS_ERROR_TAGS.html | 35 +++
.../domain_evidence.evidenceSchema.html | 35 +++
...n_evidenceBundle.evidenceBundleSchema.html | 33 +++
...Schemas.functionComparisonInputSchema.html | 35 +++
...chemas.functionComparisonResultSchema.html | 35 +++
...in_hopperValues.functionDossierSchema.html | 33 +++
... => domain_jsonValue.jsonValueSchema.html} | 14 +-
..._nativeInspection.demangleSwiftSchema.html | 33 +++
...n_nativeInspection.inspectMachoSchema.html | 33 +++
...n_nativeInspection.inspectPlistSchema.html | 33 +++
...tiveInspection.inspectSignatureSchema.html | 33 +++
...iveInspection.listArchitecturesSchema.html | 33 +++
...n_processCapture.processCaptureSchema.html | 35 +++
..._processCapture.processScenarioSchema.html | 35 +++
...cessComparison.comparisonStatusSchema.html | 35 +++
...arison.processCaptureComparisonSchema.html | 35 +++
...hemas.reconstructionClaimResultSchema.html | 33 +++
...mas.reconstructionSpecificationSchema.html | 35 +++
...reconstructionVerificationInputSchema.html | 35 +++
...econstructionVerificationResultSchema.html | 35 +++
...urceGraph.historicalSourceGraphSchema.html | 33 +++
...idualUnknown.recordUnknownInputSchema.html | 35 +++
...residualUnknown.residualUnknownSchema.html | 33 +++
...idualUnknown.updateUnknownInputSchema.html | 35 +++
...n.staticRuntimeCorrelationInputSchema.html | 35 +++
....staticRuntimeCorrelationResultSchema.html | 35 +++
...Policies.ARTIFACT_COMPARISON_PROVIDER.html | 44 +++
...olPolicies.BUNDLE_COMPARISON_PROVIDER.html | 44 +++
...essionToolPolicies.CALL_PATH_PROVIDER.html | 44 +++
...oolPolicies.CHANGED_BEHAVIOR_PROVIDER.html | 44 +++
...oolPolicies.DENY_EVIDENCE_FILE_POLICY.html | 35 +++
...ssionToolPolicies.DENY_PROCESS_POLICY.html | 35 +++
...Policies.FUNCTION_COMPARISON_PROVIDER.html | 44 +++
..._sessionToolPolicies.PROCESS_PROVIDER.html | 44 +++
...nToolPolicies.RECONSTRUCTION_PROVIDER.html | 44 +++
...nToolPolicies.STATIC_RUNTIME_PROVIDER.html | 44 +++
495 files changed, 20473 insertions(+), 982 deletions(-)
create mode 100644 docs/api/classes/application_CompositeProvider.CompositeProvider.html
create mode 100644 docs/api/classes/application_EvidenceLedger.EvidenceLedger.html
create mode 100644 docs/api/classes/application_ProcessHarness.ProcessCaptureError.html
rename docs/api/classes/{domain_errors.HopperUnavailableError.html => domain_errors.AnalysisCancelledError.html} (73%)
create mode 100644 docs/api/classes/domain_errors.AnalysisCapabilityUnavailableError.html
create mode 100644 docs/api/classes/domain_errors.AnalysisError.html
create mode 100644 docs/api/classes/domain_errors.AnalysisInputError.html
create mode 100644 docs/api/classes/domain_errors.AnalysisOutputError.html
create mode 100644 docs/api/classes/domain_errors.AnalysisProtocolError.html
create mode 100644 docs/api/classes/domain_errors.AnalysisTimeoutError.html
create mode 100644 docs/api/classes/domain_errors.ArtifactOperationError.html
create mode 100644 docs/api/classes/domain_errors.EvidenceFileError.html
create mode 100644 docs/api/classes/domain_errors.EvidenceIntegrityError.html
create mode 100644 docs/api/classes/domain_errors.EvidenceLimitError.html
create mode 100644 docs/api/classes/domain_errors.ProviderAdapterError.html
create mode 100644 docs/api/classes/domain_errors.ProviderSelectionError.html
create mode 100644 docs/api/classes/domain_errors.UnknownRegistryError.html
create mode 100644 docs/api/classes/hopper_HopperProvider.HopperProvider.html
create mode 100644 docs/api/functions/application_AnalysisProvider.createAnalysisExecution.html
create mode 100644 docs/api/functions/application_ArtifactExtraction.extractArtifact.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.classifyArtifactContent.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.classifyArtifactPath.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.createArtifactEdges.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.createArtifactNode.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.createOccurrence.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.createRootNode.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.digestCanonical.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.materializeDirectoryNodes.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.nearestParent.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.pageOf.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.rekeyOccurrences.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.rootOccurrenceFor.html
create mode 100644 docs/api/functions/application_ArtifactGraphConstruction.toOutputLimits.html
create mode 100644 docs/api/functions/application_ArtifactInventory.inventoryArtifact.html
create mode 100644 docs/api/functions/application_ArtifactInventory.paginateArtifactInventory.html
create mode 100644 docs/api/functions/application_ArtifactInventory.scanArtifactInventory.html
create mode 100644 docs/api/functions/application_DirectAnalysis.runProviderAnalysis.html
create mode 100644 docs/api/functions/application_DirectAnalysis.runSessionStatus.html
create mode 100644 docs/api/functions/application_EvidenceBundleCommands.compareEvidenceBundlesCommand.html
create mode 100644 docs/api/functions/application_EvidenceBundleCommands.exportEvidenceBundleCommand.html
create mode 100644 docs/api/functions/application_EvidenceBundleCommands.importEvidenceBundleCommand.html
create mode 100644 docs/api/functions/application_EvidenceBundleFiles.readEvidenceBundle.html
create mode 100644 docs/api/functions/application_EvidenceBundleFiles.writeEvidenceBundle.html
create mode 100644 docs/api/functions/application_FilesystemSnapshot.snapshotRoots.html
create mode 100644 docs/api/functions/application_LinuxHopper.installLinuxHopper.html
create mode 100644 docs/api/functions/application_LinuxHopper.linuxHopperLauncherPath.html
create mode 100644 docs/api/functions/application_LinuxHopper.linuxPackageManagerCommand.html
create mode 100644 docs/api/functions/application_LinuxHopper.linuxSharedLibrariesAvailable.html
create mode 100644 docs/api/functions/application_LinuxHopper.parseLinuxDistribution.html
create mode 100644 docs/api/functions/application_LinuxHopper.readLinuxDistribution.html
create mode 100644 docs/api/functions/application_LoopbackReplay.startLoopbackReplay.html
create mode 100644 docs/api/functions/application_MacHopper.installMacHopper.html
create mode 100644 docs/api/functions/application_ProcessHarness.captureProcessScenario.html
create mode 100644 docs/api/functions/application_ProcessHarness.probeProcessCaptureCapability.html
create mode 100644 docs/api/functions/application_ProcessNormalization.normalizeProcessSamples.html
create mode 100644 docs/api/functions/application_ProcessNormalization.normalizeProcessText.html
create mode 100644 docs/api/functions/application_ProcessNormalization.redactProtocolEvents.html
create mode 100644 docs/api/functions/application_ProcessOwnership.cleanupOwnedProcessGroup.html
create mode 100644 docs/api/functions/application_ProcessSampling.startProcessSampler.html
create mode 100644 docs/api/functions/application_RealHopperAssertions.firstProcedureAddress.html
create mode 100644 docs/api/functions/application_RealHopperAssertions.requireAddressArray.html
create mode 100644 docs/api/functions/application_RealHopperAssertions.requireDistinctTargetHashes.html
create mode 100644 docs/api/functions/application_RealHopperAssertions.requireFunctionDossier.html
create mode 100644 docs/api/functions/application_RealHopperAssertions.requirePseudocode.html
create mode 100644 docs/api/functions/application_ReferenceSourceImport.importReferenceSource.html
create mode 100644 docs/api/functions/application_ReferenceSourceImportEntries.parseReferenceSourceEntries.html
create mode 100644 docs/api/functions/application_ReferenceSourceImportPolicy.prepareReferenceSourceImport.html
create mode 100644 docs/api/functions/application_ReferenceSourceVcsAdapter.readReferenceSourceVcs.html
create mode 100644 docs/api/functions/application_Setup.configureTomlClient.html
create mode 100644 docs/api/functions/application_Setup.detectClients.html
create mode 100644 docs/api/functions/application_Setup.installCanonicalSkill.html
create mode 100644 docs/api/functions/application_Setup.supportedClients.html
create mode 100644 docs/api/functions/application_Uninstall.runUninstall.html
rename docs/api/{types/application_BinarySession.BinaryClientFactory.html => functions/application_Uninstall.systemUninstallHost.html} (67%)
create mode 100644 docs/api/functions/application_Upgrade.detectNpmInstallation.html
create mode 100644 docs/api/functions/application_Upgrade.runUpgrade.html
create mode 100644 docs/api/functions/application_Upgrade.systemUpgradeHost.html
create mode 100644 docs/api/functions/contracts_toolOutputSchemas.requireOutputSchema.html
create mode 100644 docs/api/functions/domain_artifactComparison.compareArtifacts.html
create mode 100644 docs/api/functions/domain_artifactInventoryEvidence.parseArtifactInventoryEvidence.html
create mode 100644 docs/api/functions/domain_bundleComparison.compareBundles.html
create mode 100644 docs/api/functions/domain_callPath.buildCallPath.html
create mode 100644 docs/api/functions/domain_changedBehavior.findChangedBehavior.html
create mode 100644 docs/api/functions/domain_errors.projectAnalysisError.html
create mode 100644 docs/api/functions/domain_evidence.createEvidence.html
create mode 100644 docs/api/functions/domain_evidence.parseEvidence.html
create mode 100644 docs/api/functions/domain_evidenceBundle.createEvidenceBundle.html
create mode 100644 docs/api/functions/domain_evidenceBundle.parseEvidenceBundle.html
create mode 100644 docs/api/functions/domain_evidenceBundle.serializeEvidenceBundle.html
create mode 100644 docs/api/functions/domain_functionComparison.compareFunctions.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.combineCoverage.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.commentProjection.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.functionMatch.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.identityProjection.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.isAutoName.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.normalizeCfg.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.project.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.referenceProjection.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.sorted.html
create mode 100644 docs/api/functions/domain_functionComparisonNormalization.stringAndNameProjection.html
create mode 100644 docs/api/functions/domain_functionComparisonResults.canonicalJson.html
create mode 100644 docs/api/functions/domain_functionComparisonResults.dimensionResult.html
create mode 100644 docs/api/functions/domain_functionComparisonResults.overallStatus.html
create mode 100644 docs/api/functions/domain_functionComparisonResults.summarize.html
create mode 100644 docs/api/functions/domain_functionComparisonResults.unresolvedDimension.html
create mode 100644 docs/api/functions/domain_functionDossierEvidence.parseFunctionEvidence.html
create mode 100644 docs/api/functions/domain_hopperValues.addressDistance.html
create mode 100644 docs/api/functions/domain_hopperValues.parseAddressedPage.html
create mode 100644 docs/api/functions/domain_hopperValues.parseFunctionDossier.html
create mode 100644 docs/api/functions/domain_processCapture.authorizeProcessScenario.html
create mode 100644 docs/api/functions/domain_processCapture.parseProcessScenario.html
create mode 100644 docs/api/functions/domain_processComparison.compareProcessCaptures.html
create mode 100644 docs/api/functions/domain_reconstructionUnknowns.reconstructionClaimUnknowns.html
create mode 100644 docs/api/functions/domain_reconstructionUnknowns.reconstructionProbes.html
create mode 100644 docs/api/functions/domain_reconstructionUnknowns.reconstructionUnknownHeads.html
create mode 100644 docs/api/functions/domain_reconstructionVerification.verifyReconstruction.html
create mode 100644 docs/api/functions/domain_referenceSourceClassification.classifyReferenceSourcePath.html
create mode 100644 docs/api/functions/domain_referenceSourceClassification.detectReferenceSourceLanguage.html
create mode 100644 docs/api/functions/domain_referenceSourceClassification.isSecretLikePath.html
create mode 100644 docs/api/functions/domain_referenceSourceGraph.computeHistoricalSourceGraphSha256.html
create mode 100644 docs/api/functions/domain_referenceSourceGraph.createHistoricalSourceGraph.html
create mode 100644 docs/api/functions/domain_referenceSourceGraph.createHistoricalSourceManifest.html
create mode 100644 docs/api/functions/domain_referenceSourceGraph.parseHistoricalSourceGraph.html
create mode 100644 docs/api/functions/domain_referenceSourceGraph.parseHistoricalSourceManifest.html
create mode 100644 docs/api/functions/domain_referenceSourceImportParsing.parseReferenceSourceImports.html
create mode 100644 docs/api/functions/domain_residualUnknown.createResidualUnknown.html
create mode 100644 docs/api/functions/domain_residualUnknown.updateResidualUnknown.html
create mode 100644 docs/api/functions/domain_runtimeVersion.supportsNodeVersion.html
create mode 100644 docs/api/functions/domain_staticRuntimeCorrelation.correlateStaticAndRuntime.html
create mode 100644 docs/api/functions/server_recordDerivedEvidence.recordDerivedEvidence.html
create mode 100644 docs/api/functions/server_registerArtifactComparisonTool.registerArtifactComparisonTool.html
create mode 100644 docs/api/functions/server_registerArtifactTools.registerArtifactTools.html
create mode 100644 docs/api/functions/server_registerBundleComparisonTool.registerBundleComparisonTool.html
create mode 100644 docs/api/functions/server_registerEvidenceTools.registerEvidenceTools.html
create mode 100644 docs/api/functions/server_registerFunctionComparisonTool.registerFunctionComparisonTool.html
create mode 100644 docs/api/functions/server_registerInvestigationTools.registerInvestigationTools.html
create mode 100644 docs/api/functions/server_registerNativeTools.registerNativeTools.html
create mode 100644 docs/api/functions/server_registerProcessComparisonTool.registerProcessComparisonTool.html
create mode 100644 docs/api/functions/server_sessionEvidence.isSessionEvidence.html
create mode 100644 docs/api/functions/server_sessionEvidence.resolveSessionEvidence.html
create mode 100644 docs/api/functions/server_toolLogging.logToolExecution.html
create mode 100644 docs/api/functions/server_toolRegistrationOptions.toolRegistrationOptions.html
create mode 100644 docs/api/interfaces/application_AnalysisProvider.AnalysisClient.html
create mode 100644 docs/api/interfaces/application_AnalysisProvider.AnalysisExecution.html
create mode 100644 docs/api/interfaces/application_AnalysisProvider.AnalysisOperationPort.html
create mode 100644 docs/api/interfaces/application_AnalysisProvider.AnalysisProvider.html
create mode 100644 docs/api/interfaces/application_AnalysisProvider.ProviderIdentity.html
create mode 100644 docs/api/interfaces/application_ArtifactExtraction.ArtifactExtractionInput.html
create mode 100644 docs/api/interfaces/application_ArtifactGraphConstruction.MutableOccurrence.html
create mode 100644 docs/api/interfaces/application_ArtifactInventory.ArtifactInventorySnapshot.html
delete mode 100644 docs/api/interfaces/application_BinarySession.BinaryClient.html
create mode 100644 docs/api/interfaces/application_BinarySession.BinarySessionPort.html
create mode 100644 docs/api/interfaces/application_EvidenceLedger.EvidenceLedgerLimits.html
create mode 100644 docs/api/interfaces/application_FilesystemSnapshot.SnapshotResult.html
delete mode 100644 docs/api/interfaces/application_HopperToolPort.HopperToolPort.html
create mode 100644 docs/api/interfaces/application_LinuxHopper.LinuxDistribution.html
create mode 100644 docs/api/interfaces/application_LinuxHopper.LinuxHopperDownload.html
create mode 100644 docs/api/interfaces/application_LinuxHopper.LinuxHopperInstallHost.html
create mode 100644 docs/api/interfaces/application_LoopbackReplay.LoopbackReplay.html
create mode 100644 docs/api/interfaces/application_MacHopper.MacHopperInstallHost.html
create mode 100644 docs/api/interfaces/application_ProcessOwnership.OwnedProcessGroup.html
create mode 100644 docs/api/interfaces/application_ProcessOwnership.ProcessOwnershipHost.html
create mode 100644 docs/api/interfaces/application_ReferenceSourceImportEntries.ParsedReferenceSourceEntries.html
create mode 100644 docs/api/interfaces/application_ReferenceSourceImportPolicy.PreparedReferenceSourceImport.html
create mode 100644 docs/api/interfaces/application_ReferenceSourceImportTypes.ReferenceSourceImportError.html
create mode 100644 docs/api/interfaces/application_ReferenceSourceImportTypes.ReferenceSourceImportOptions.html
create mode 100644 docs/api/interfaces/application_Setup.SetupAction.html
create mode 100644 docs/api/interfaces/application_Setup.SetupOptions.html
create mode 100644 docs/api/interfaces/application_Uninstall.UninstallHost.html
create mode 100644 docs/api/interfaces/application_Uninstall.UninstallItem.html
create mode 100644 docs/api/interfaces/application_Uninstall.UninstallResult.html
create mode 100644 docs/api/interfaces/application_Upgrade.NpmInstallation.html
create mode 100644 docs/api/interfaces/application_Upgrade.NpmInstallationHost.html
create mode 100644 docs/api/interfaces/application_Upgrade.UpgradeHost.html
create mode 100644 docs/api/interfaces/contracts_toolContracts.ToolAnnotations.html
create mode 100644 docs/api/interfaces/contracts_toolContracts.ToolExample.html
create mode 100644 docs/api/interfaces/domain_artifactInventoryEvidence.InventorySet.html
create mode 100644 docs/api/interfaces/domain_errors.AnalysisErrorProjection.html
create mode 100644 docs/api/interfaces/domain_evidence.EvidenceObservation.html
create mode 100644 docs/api/interfaces/domain_evidence.EvidenceProvider.html
create mode 100644 docs/api/interfaces/domain_evidence.EvidenceSubjectTarget.html
create mode 100644 docs/api/interfaces/domain_evidenceBundle.EvidenceFilePolicy.html
create mode 100644 docs/api/interfaces/domain_functionComparisonResults.DimensionResultInput.html
create mode 100644 docs/api/interfaces/domain_functionDossierEvidence.FunctionCollection.html
create mode 100644 docs/api/interfaces/domain_functionDossierEvidence.FunctionSnapshot.html
create mode 100644 docs/api/interfaces/domain_hopperValues.AddressedPage.html
create mode 100644 docs/api/interfaces/domain_processCapture.FileState.html
create mode 100644 docs/api/interfaces/domain_processCapture.ProcessCapture.html
create mode 100644 docs/api/interfaces/domain_processCapture.ProcessExecutionPolicy.html
create mode 100644 docs/api/interfaces/domain_processCapture.ProcessSample.html
create mode 100644 docs/api/interfaces/domain_processCapture.ProtocolEvent.html
create mode 100644 docs/api/interfaces/domain_processCapture.TerminalFrame.html
create mode 100644 docs/api/interfaces/domain_referenceSourceImportParsing.ReferenceSourceImportParseResult.html
create mode 100644 docs/api/interfaces/domain_referenceSourcePolicy.ReferenceSourcePolicy.html
create mode 100644 docs/api/interfaces/server_createServer.CreateServerOptions.html
create mode 100644 docs/api/interfaces/server_registerEnhancedTools.EnhancedToolRegistration.html
create mode 100644 docs/api/interfaces/server_registerOfficialTools.OfficialToolRegistration.html
create mode 100644 docs/api/interfaces/server_registerSessionTools.SessionToolOptions.html
create mode 100644 docs/api/modules/application_AnalysisProvider.html
create mode 100644 docs/api/modules/application_ArtifactExtraction.html
create mode 100644 docs/api/modules/application_ArtifactGraphConstruction.html
create mode 100644 docs/api/modules/application_ArtifactInventory.html
create mode 100644 docs/api/modules/application_CompositeProvider.html
create mode 100644 docs/api/modules/application_EvidenceBundleCommands.html
create mode 100644 docs/api/modules/application_EvidenceBundleFiles.html
create mode 100644 docs/api/modules/application_EvidenceLedger.html
create mode 100644 docs/api/modules/application_FilesystemSnapshot.html
create mode 100644 docs/api/modules/application_LinuxHopper.html
create mode 100644 docs/api/modules/application_LoopbackReplay.html
create mode 100644 docs/api/modules/application_MacHopper.html
create mode 100644 docs/api/modules/application_ProcessHarness.html
create mode 100644 docs/api/modules/application_ProcessNormalization.html
create mode 100644 docs/api/modules/application_ProcessOwnership.html
create mode 100644 docs/api/modules/application_ProcessSampling.html
create mode 100644 docs/api/modules/application_RealHopperAssertions.html
create mode 100644 docs/api/modules/application_ReferenceSourceImport.html
create mode 100644 docs/api/modules/application_ReferenceSourceImportEntries.html
create mode 100644 docs/api/modules/application_ReferenceSourceImportPolicy.html
create mode 100644 docs/api/modules/application_ReferenceSourceImportTypes.html
create mode 100644 docs/api/modules/application_ReferenceSourceVcsAdapter.html
create mode 100644 docs/api/modules/application_Uninstall.html
create mode 100644 docs/api/modules/application_Upgrade.html
create mode 100644 docs/api/modules/contracts_artifactComparisonExample.html
create mode 100644 docs/api/modules/contracts_artifactToolContracts.html
create mode 100644 docs/api/modules/contracts_functionComparisonExample.html
create mode 100644 docs/api/modules/contracts_investigationExamples.html
create mode 100644 docs/api/modules/contracts_nativeToolContracts.html
create mode 100644 docs/api/modules/contracts_processCaptureExample.html
create mode 100644 docs/api/modules/contracts_toolContractExamples.html
create mode 100644 docs/api/modules/contracts_toolOutputSchemas.html
create mode 100644 docs/api/modules/contracts_unknownContractExamples.html
create mode 100644 docs/api/modules/domain_artifactComparison.html
create mode 100644 docs/api/modules/domain_artifactGraph.html
create mode 100644 docs/api/modules/domain_artifactInventoryEvidence.html
create mode 100644 docs/api/modules/domain_bundleComparison.html
create mode 100644 docs/api/modules/domain_callPath.html
create mode 100644 docs/api/modules/domain_changedBehavior.html
create mode 100644 docs/api/modules/domain_evidence.html
create mode 100644 docs/api/modules/domain_evidenceBundle.html
create mode 100644 docs/api/modules/domain_functionComparison.html
create mode 100644 docs/api/modules/domain_functionComparisonNormalization.html
create mode 100644 docs/api/modules/domain_functionComparisonResults.html
create mode 100644 docs/api/modules/domain_functionComparisonSchemas.html
create mode 100644 docs/api/modules/domain_functionDossierEvidence.html
create mode 100644 docs/api/modules/domain_jsonValue.html
create mode 100644 docs/api/modules/domain_nativeInspection.html
create mode 100644 docs/api/modules/domain_processCapture.html
create mode 100644 docs/api/modules/domain_processComparison.html
create mode 100644 docs/api/modules/domain_reconstructionUnknowns.html
create mode 100644 docs/api/modules/domain_reconstructionVerification.html
create mode 100644 docs/api/modules/domain_reconstructionVerificationSchemas.html
create mode 100644 docs/api/modules/domain_referenceSourceClassification.html
create mode 100644 docs/api/modules/domain_referenceSourceGraph.html
create mode 100644 docs/api/modules/domain_referenceSourceImportParsing.html
create mode 100644 docs/api/modules/domain_referenceSourcePolicy.html
create mode 100644 docs/api/modules/domain_residualUnknown.html
create mode 100644 docs/api/modules/domain_runtimeVersion.html
create mode 100644 docs/api/modules/domain_staticRuntimeCorrelation.html
create mode 100644 docs/api/modules/hopper_HopperProvider.html
create mode 100644 docs/api/modules/server_recordDerivedEvidence.html
create mode 100644 docs/api/modules/server_registerArtifactComparisonTool.html
create mode 100644 docs/api/modules/server_registerArtifactTools.html
create mode 100644 docs/api/modules/server_registerBundleComparisonTool.html
create mode 100644 docs/api/modules/server_registerEvidenceTools.html
create mode 100644 docs/api/modules/server_registerFunctionComparisonTool.html
create mode 100644 docs/api/modules/server_registerInvestigationTools.html
rename docs/api/modules/{application_HopperToolPort.html => server_registerNativeTools.html} (71%)
create mode 100644 docs/api/modules/server_registerProcessComparisonTool.html
create mode 100644 docs/api/modules/server_sessionEvidence.html
create mode 100644 docs/api/modules/server_sessionToolPolicies.html
create mode 100644 docs/api/modules/server_toolLogging.html
create mode 100644 docs/api/modules/server_toolRegistrationOptions.html
create mode 100644 docs/api/types/application_AnalysisProvider.AnalysisClientFactory.html
create mode 100644 docs/api/types/application_AnalysisProvider.AnalysisOperation.html
create mode 100644 docs/api/types/application_AnalysisProvider.CapabilityDescriptor.html
create mode 100644 docs/api/types/application_LinuxHopper.LinuxHopperInstallResult.html
rename docs/api/types/{domain_binaryTarget.BinaryArchitecture.html => application_LinuxHopper.LinuxPackageFamily.html} (81%)
create mode 100644 docs/api/types/application_MacHopper.MacHopperInstallResult.html
create mode 100644 docs/api/types/application_ProcessHarness.ProcessCaptureCapability.html
create mode 100644 docs/api/types/application_ProcessOwnership.ProcessCleanupResult.html
create mode 100644 docs/api/types/application_ReferenceSourceVcsAdapter.ReferenceSourceVcsInfo.html
create mode 100644 docs/api/types/application_Setup.SetupConfirmation.html
create mode 100644 docs/api/types/application_Upgrade.UpgradeOutput.html
create mode 100644 docs/api/types/application_Upgrade.UpgradeResult.html
rename docs/api/types/{hopper_HopperClient.HopperDiagnostic.html => contracts_artifactToolContracts.ArtifactToolName.html} (72%)
create mode 100644 docs/api/types/contracts_nativeToolContracts.NativeToolName.html
create mode 100644 docs/api/types/contracts_toolContracts.OfficialToolName.html
create mode 100644 docs/api/types/domain_artifactComparison.ArtifactComparisonResult.html
rename docs/api/{functions/application_Setup.systemSetupHost.html => types/domain_artifactGraph.ArtifactCommand.html} (75%)
create mode 100644 docs/api/types/domain_artifactGraph.ArtifactEdge.html
create mode 100644 docs/api/types/domain_artifactGraph.ArtifactExtractionResult.html
create mode 100644 docs/api/types/domain_artifactGraph.ArtifactGraphManifest.html
create mode 100644 docs/api/types/domain_artifactGraph.ArtifactInventoryResult.html
create mode 100644 docs/api/types/domain_artifactGraph.ArtifactNode.html
create mode 100644 docs/api/types/domain_artifactGraph.ArtifactOccurrence.html
create mode 100644 docs/api/types/domain_bundleComparison.BundleComparisonResult.html
create mode 100644 docs/api/types/domain_callPath.CallPathInput.html
create mode 100644 docs/api/types/domain_callPath.CallPathResult.html
create mode 100644 docs/api/types/domain_changedBehavior.ChangedBehaviorResult.html
create mode 100644 docs/api/types/domain_errors.AnalysisErrorTag.html
create mode 100644 docs/api/types/domain_errors.HopperDiagnosticType.html
rename docs/api/types/{contracts_toolContracts.ToolKind.html => domain_evidence.Evidence.html} (82%)
create mode 100644 docs/api/types/domain_evidence.EvidenceLocation.html
create mode 100644 docs/api/types/domain_evidenceBundle.EvidenceBundle.html
create mode 100644 docs/api/types/domain_functionComparisonSchemas.DimensionName.html
create mode 100644 docs/api/types/domain_functionComparisonSchemas.FunctionComparisonResult.html
rename docs/api/{variables/application_homebrew.HOMEBREW_COMMANDS.html => types/domain_functionComparisonSchemas.FunctionDimension.html} (77%)
create mode 100644 docs/api/types/domain_hopperValues.FunctionDossier.html
rename docs/api/types/{hopper_protocol.JsonValue.html => domain_jsonValue.JsonValue.html} (90%)
create mode 100644 docs/api/types/domain_nativeInspection.InspectSignature.html
create mode 100644 docs/api/types/domain_nativeInspection.NativeCommandInvocation.html
create mode 100644 docs/api/types/domain_processCapture.ProcessPolicyDecision.html
create mode 100644 docs/api/types/domain_processCapture.ProcessScenario.html
create mode 100644 docs/api/types/domain_reconstructionVerificationSchemas.ReconstructionClaim.html
create mode 100644 docs/api/types/domain_reconstructionVerificationSchemas.ReconstructionClaimResult.html
create mode 100644 docs/api/types/domain_reconstructionVerificationSchemas.ReconstructionObservedStatus.html
create mode 100644 docs/api/types/domain_reconstructionVerificationSchemas.ReconstructionVerificationResult.html
create mode 100644 docs/api/types/domain_referenceSourceClassification.ReferenceSourceClassification.html
create mode 100644 docs/api/types/domain_referenceSourceGraph.HistoricalSourceGraph.html
create mode 100644 docs/api/types/domain_referenceSourceGraph.HistoricalSourceGraphInput.html
create mode 100644 docs/api/types/domain_referenceSourceGraph.HistoricalSourceManifest.html
create mode 100644 docs/api/types/domain_residualUnknown.RecordUnknownInput.html
create mode 100644 docs/api/types/domain_residualUnknown.ResidualUnknown.html
create mode 100644 docs/api/types/domain_residualUnknown.UnknownStatus.html
create mode 100644 docs/api/types/domain_residualUnknown.UpdateUnknownInput.html
create mode 100644 docs/api/types/domain_staticRuntimeCorrelation.StaticRuntimeCorrelationResult.html
create mode 100644 docs/api/variables/application_ReferenceSourceImportTypes.DEFAULT_REFERENCE_SOURCE_IGNORE_PATTERNS.html
create mode 100644 docs/api/variables/application_ReferenceSourceImportTypes.DEFAULT_REFERENCE_SOURCE_LIMITS.html
create mode 100644 docs/api/variables/application_ReferenceSourceImportTypes.PARSEABLE_REFERENCE_SOURCE_LANGUAGES.html
create mode 100644 docs/api/variables/contracts_artifactComparisonExample.ARTIFACT_COMPARISON_EXAMPLE.html
create mode 100644 docs/api/variables/contracts_artifactToolContracts.ARTIFACT_TOOL_CONTRACTS.html
create mode 100644 docs/api/variables/contracts_artifactToolContracts.artifactExtractionInputSchema.html
create mode 100644 docs/api/variables/contracts_artifactToolContracts.artifactInventoryInputSchema.html
create mode 100644 docs/api/variables/contracts_functionComparisonExample.FUNCTION_COMPARISON_EXAMPLE.html
create mode 100644 docs/api/variables/contracts_investigationExamples.FUNCTION_COMPARISON_EVIDENCE.html
create mode 100644 docs/api/variables/contracts_investigationExamples.INVESTIGATION_EXAMPLES.html
create mode 100644 docs/api/variables/contracts_investigationExamples.PROCESS_CAPTURE_RECONSTRUCTION.html
create mode 100644 docs/api/variables/contracts_investigationExamples.PROCESS_CAPTURE_REFERENCE.html
create mode 100644 docs/api/variables/contracts_investigationExamples.PROCESS_COMPARISON_EVIDENCE.html
create mode 100644 docs/api/variables/contracts_nativeToolContracts.NATIVE_TOOL_CONTRACTS.html
create mode 100644 docs/api/variables/contracts_processCaptureExample.EMPTY_PROCESS_CAPTURE_EXAMPLE.html
create mode 100644 docs/api/variables/contracts_toolContractExamples.TOOL_EXAMPLE_OVERRIDES.html
create mode 100644 docs/api/variables/contracts_toolOutputSchemas.artifactOutputSchemas.html
create mode 100644 docs/api/variables/contracts_toolOutputSchemas.enhancedOutputSchemas.html
create mode 100644 docs/api/variables/contracts_toolOutputSchemas.nativeOutputSchemas.html
create mode 100644 docs/api/variables/contracts_toolOutputSchemas.officialOutputSchemas.html
create mode 100644 docs/api/variables/contracts_toolOutputSchemas.sessionOutputSchemas.html
create mode 100644 docs/api/variables/contracts_unknownContractExamples.UNKNOWN_CONTRACT_EXAMPLES.html
create mode 100644 docs/api/variables/domain_artifactComparison.artifactComparisonInputSchema.html
create mode 100644 docs/api/variables/domain_artifactComparison.artifactComparisonResultSchema.html
create mode 100644 docs/api/variables/domain_artifactGraph.artifactExtractionResultSchema.html
create mode 100644 docs/api/variables/domain_artifactGraph.artifactInventoryResultSchema.html
create mode 100644 docs/api/variables/domain_bundleComparison.bundleComparisonInputSchema.html
create mode 100644 docs/api/variables/domain_bundleComparison.bundleComparisonResultSchema.html
create mode 100644 docs/api/variables/domain_callPath.callPathInputSchema.html
create mode 100644 docs/api/variables/domain_callPath.callPathResultSchema.html
create mode 100644 docs/api/variables/domain_changedBehavior.changedBehaviorInputSchema.html
create mode 100644 docs/api/variables/domain_changedBehavior.changedBehaviorResultSchema.html
create mode 100644 docs/api/variables/domain_errors.ANALYSIS_ERROR_TAGS.html
create mode 100644 docs/api/variables/domain_evidence.evidenceSchema.html
create mode 100644 docs/api/variables/domain_evidenceBundle.evidenceBundleSchema.html
create mode 100644 docs/api/variables/domain_functionComparisonSchemas.functionComparisonInputSchema.html
create mode 100644 docs/api/variables/domain_functionComparisonSchemas.functionComparisonResultSchema.html
create mode 100644 docs/api/variables/domain_hopperValues.functionDossierSchema.html
rename docs/api/variables/{hopper_protocol.jsonValueSchema.html => domain_jsonValue.jsonValueSchema.html} (90%)
create mode 100644 docs/api/variables/domain_nativeInspection.demangleSwiftSchema.html
create mode 100644 docs/api/variables/domain_nativeInspection.inspectMachoSchema.html
create mode 100644 docs/api/variables/domain_nativeInspection.inspectPlistSchema.html
create mode 100644 docs/api/variables/domain_nativeInspection.inspectSignatureSchema.html
create mode 100644 docs/api/variables/domain_nativeInspection.listArchitecturesSchema.html
create mode 100644 docs/api/variables/domain_processCapture.processCaptureSchema.html
create mode 100644 docs/api/variables/domain_processCapture.processScenarioSchema.html
create mode 100644 docs/api/variables/domain_processComparison.comparisonStatusSchema.html
create mode 100644 docs/api/variables/domain_processComparison.processCaptureComparisonSchema.html
create mode 100644 docs/api/variables/domain_reconstructionVerificationSchemas.reconstructionClaimResultSchema.html
create mode 100644 docs/api/variables/domain_reconstructionVerificationSchemas.reconstructionSpecificationSchema.html
create mode 100644 docs/api/variables/domain_reconstructionVerificationSchemas.reconstructionVerificationInputSchema.html
create mode 100644 docs/api/variables/domain_reconstructionVerificationSchemas.reconstructionVerificationResultSchema.html
create mode 100644 docs/api/variables/domain_referenceSourceGraph.historicalSourceGraphSchema.html
create mode 100644 docs/api/variables/domain_residualUnknown.recordUnknownInputSchema.html
create mode 100644 docs/api/variables/domain_residualUnknown.residualUnknownSchema.html
create mode 100644 docs/api/variables/domain_residualUnknown.updateUnknownInputSchema.html
create mode 100644 docs/api/variables/domain_staticRuntimeCorrelation.staticRuntimeCorrelationInputSchema.html
create mode 100644 docs/api/variables/domain_staticRuntimeCorrelation.staticRuntimeCorrelationResultSchema.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.ARTIFACT_COMPARISON_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.BUNDLE_COMPARISON_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.CALL_PATH_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.CHANGED_BEHAVIOR_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.DENY_EVIDENCE_FILE_POLICY.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.DENY_PROCESS_POLICY.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.FUNCTION_COMPARISON_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.PROCESS_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.RECONSTRUCTION_PROVIDER.html
create mode 100644 docs/api/variables/server_sessionToolPolicies.STATIC_RUNTIME_PROVIDER.html
diff --git a/docs/api/assets/hierarchy.js b/docs/api/assets/hierarchy.js
index 8908720e9..13221cf4a 100644
--- a/docs/api/assets/hierarchy.js
+++ b/docs/api/assets/hierarchy.js
@@ -1 +1 @@
-window.hierarchyData = "eJydlctu2zAQRf9l1owSiXpQ2jVGgC6K1mjSVWAYjDS2iVCkQNIFikD/XihuYslMqsdGAAXeOXcuXy9gtHYWiscoSgnNSBKyDQGDO4mlE1pZKF6AZt1X8RqhgK+6adDcGaMNEHgWqoIijBiBo5FQQCm5tWivK11zobbYzbNBTxQcXC2BnCZCAc5WV12Vq9MPAuVByMqgguIxTkgSkiQhKSVZSLKMsJCwlOQxydmmJRAnnrMHUaM+ukUG+9oRny2BJPTgK65KlBKrRfiheoIBv/u10U6XWi7iD8Tj+JR6+J9Ya4eL4D3pODrzo18bXaK1Sxt/106A+8fhl+K/uZD8SS5r/lI/boL5Cdw7bpbt+7NyAjjtgVda7cT+aHh3V8xE+9pxeB734N/1rVDc/PnR4Fy2J52AZj30Sf3AzR7nJu5Jx9FR1M/81ohqj9/4UZUHPIOjJH0DC+XQ7HiJ9vrwur7boSa4GH5m4L3O8FaOaN7dvRHNvS34pWmkKF9X1DP4QTIfu/u01HhSNLvxVmklBSo3khM/07Yn2T1aK7QK+kUmJNWZYLFn4l+1/4UxZuFtNOFdYv6rqLVcazMnhqEwuBjO3DOUxYRmN5u2bf8CwZ/ljg=="
\ No newline at end of file
+window.hierarchyData = "eJytmF1v2yAUhv8L1yw1/gAnd13UqZWqNerH1RRV1CYJqgMWJp2iqv99wmkbXMiMvd04deL3vA/nwDH0FSgpdQNmvxCOEkhQhiBBeQrxNM2WECi2qlihuRQNmL0C85D5FHTLwAycC1rtG95cKCUVgOCZixLMUJxDsFMVmIGiok3DmrNSbikXj8w810w6sslGbysAD4+CGdBN+c3E+Xb4AoJiw6tSMdEyIgQRRlOIcEwgwkkKEU4TiHDWXswP2PxAzG0eQ4SnkbnkEJEIQ0RQBhHBMUSEROaSQhTlebZ8g8BEtwZ3KeuaqYFDs0SDBkZigxQbzMT8lSKISNZeyDvb1JP4hZJaFrIaWYCOvIe3hYiJB+JK1Ds9kuCoDbFPUo/9zU6P97fEIQCpb/bPaU2feMX1/kHQF8or+lSxkTynY4XgZX48UbCqYuVoJFsfhOGbqvd8y+ToOtnqEARsT9SFki+8ZOqOvfeygRB+fQgGSTwY5yWt9eDO4lOHIOSxXQyl+YoW+qZmio7IhF8fgjGNLIwLMxJRsCuh2VpxvR+I4dcHYeQejGu+5UMnpqsNsCcR9tj/4IPbhSMNMUeZZf4gnoX8LW7ZmjdaDS2ATx2CEMfOC3ZcX3C1Qfa5Yz+2O/rUIQiJm4GRL3GPOAQgdfc4t2wr9dAp6EhDzDPXfKFkwZqhW0hXG2RPHPs7TdW4yXdUhlhju+5zKVZ8vRvVgl1tiD2x2+9P+Z0LqvY3NRvq7kiDzO1t20F/T9WaDc27I+03N8cY21zxcs2u6U4UG3Z0jjP84cyFZmpFC9acbdoyP3Y1ky+3pwg+43Q3+nia5cuWK3N70XldV7xoC+sgepLj5zsZqj9ZJMqwb322+44Akq5g8uW23x512sPnFv1jr7GQSveUjB6H/Wgdcg4A3oBDC0hQRiAhUbo8EPsORPOKM/FfUA+RAhhbmNx3PHLq9w84vbU8kbR8mhJoZlebNBK5/eCONc3wEne0EyfSYMwkahen+TxF+LdlEIjWvxJMvjqvi20tG65ZyFq0IRzhxP2mv3+b/490jzHmpTuntd6p/l2DzfMuvaRKsKY90nyN1Ifz9vYHu0FgFg=="
\ No newline at end of file
diff --git a/docs/api/assets/navigation.js b/docs/api/assets/navigation.js
index 09e8b1577..c245aac91 100644
--- a/docs/api/assets/navigation.js
+++ b/docs/api/assets/navigation.js
@@ -1 +1 @@
-window.navigationData = "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"
\ No newline at end of file
+window.navigationData = "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"
\ No newline at end of file
diff --git a/docs/api/assets/search.js b/docs/api/assets/search.js
index 3d82c3184..e13a2d4fc 100644
--- a/docs/api/assets/search.js
+++ b/docs/api/assets/search.js
@@ -1 +1 @@
-window.searchData = "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";
\ No newline at end of file
+window.searchData = "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";
\ No newline at end of file
diff --git a/docs/api/classes/application_BinarySession.BinarySession.html b/docs/api/classes/application_BinarySession.BinarySession.html
index a29d7fb60..b90fc6f4d 100644
--- a/docs/api/classes/application_BinarySession.BinarySession.html
+++ b/docs/api/classes/application_BinarySession.BinarySession.html
@@ -1,5 +1,5 @@
-BinarySession | rea-agents - v0.1.0
-rea-agents - v0.1.0
+
BinarySession | rea-agents - v1.0.0
+
Properties
+Defined in src/application/BinarySession.ts:115
Methods
+
+
+evidence By Id
+
+
+evidenceById ( evidenceId : string , ) : | { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } | undefined
+
+
+
+
Returns | { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } | undefined
+
-close
+export Evidence Bundle
-
+exportEvidenceBundle () : { artifacts : { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; } [] ; bundle_version : 2 ; captures : { evidence_id : string ; predicate_type : string } [] ; environments : { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } [] ; providers : { id : string ; name : string ; version : string | null } [] ; records : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } [] ; scenarios : { authority : "controlled-replay" ; evidence_id : string ; operation : string ; } [] ; unknowns : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } [] ; }
+
+has Evidence
+
+
+hasEvidence ( evidenceId : string ) : boolean
+
+
+
+list Unknowns
+
+
+listUnknowns ( filters ?: { domain ?: string ; severity ?: "low" | "medium" | "high" | "critical" ; status ?: | "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; } , ) : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } []
+
+
+
+
Parameters
+
+filters : { domain ?: string ; severity ?: "low" | "medium" | "high" | "critical" ; status ?: "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; } = {}
+
Returns { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } []
open
-
+open ( path : string , options ?: { signal ?: AbortSignal ; targetKind ?: "executable" | "database" | "archive" | "artifact" ; } , ) : Promise < Result < BinaryTarget , AnalysisError > >
-
+options : { signal ?: AbortSignal ; targetKind ?: "executable" | "database" | "archive" | "artifact" ; } = {}
+
+Defined in src/application/BinarySession.ts:257
+
+
+record Evidence
+
+
+recordEvidence ( evidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , ) : Result < "added" | "duplicate" , EvidenceIntegrityError | EvidenceLimitError , >
+
+
+
+
Parameters
+
+evidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+
+
+record Evidence With Unknown
+
+
+recordEvidenceWithUnknown ( evidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; } , ) : Result < | { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } | null , AnalysisError , >
+
+
+
+
Parameters
+
+evidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; }
+
Returns Result < | { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } | null , AnalysisError , >
+
+record Unknown
+
+
+recordUnknown ( input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; } , ) : Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , AnalysisError , >
+
+
+
+
Parameters
+
+input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; }
+
Returns Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , AnalysisError , >
status
@@ -128,8 +295,41 @@ Returns the switch failure even if best-effort restoration also fails.
Returns JSONType
+Defined in src/application/BinarySession.ts:312
+
+update Unknown
+
+
+updateUnknown ( input : { approved : true ; contradicting_evidence_ids : string [] ; expected_revision : number ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , ) : Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , AnalysisError , >
+
+
+
+
Parameters
+
+input : { approved : true ; contradicting_evidence_ids : string [] ; expected_revision : number ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; }
+
Returns Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , AnalysisError , >
+
+verify Unknown Resolution
+
+
+verifyUnknownResolution ( unknownId : string , ) : Result < { truthVerified : boolean ; unknown : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : | "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } ; valid : boolean ; } , UnknownRegistryError , >
+
+
+
+
Returns Result < { truthVerified : boolean ; unknown : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : | "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } ; valid : boolean ; } , UnknownRegistryError , >
diff --git a/docs/api/classes/application_CompositeProvider.CompositeProvider.html b/docs/api/classes/application_CompositeProvider.CompositeProvider.html
new file mode 100644
index 000000000..76c78f594
--- /dev/null
+++ b/docs/api/classes/application_CompositeProvider.CompositeProvider.html
@@ -0,0 +1,128 @@
+CompositeProvider | rea-agents - v1.0.0
+
+
+
+
+
Class CompositeProvider
+
+
+
+
+Constructors
+
+
+Properties
+
+
+Methods
+
+
+
diff --git a/docs/api/classes/application_EnhancedTools.EnhancedTools.html b/docs/api/classes/application_EnhancedTools.EnhancedTools.html
index 1ac69ab24..9d9ece430 100644
--- a/docs/api/classes/application_EnhancedTools.EnhancedTools.html
+++ b/docs/api/classes/application_EnhancedTools.EnhancedTools.html
@@ -1,5 +1,5 @@
-EnhancedTools | rea-agents - v0.1.0
-
Methods
@@ -54,19 +54,19 @@ validates them, allowing direct callers to use the same service safely.
execute
-execute ( name : | "binary_overview" | "swift_classes" | "get_objc_classes" | "get_objc_protocols" | "batch_decompile" | "get_call_graph" | "analyze_swift_types" | "find_xrefs_to_name" , input : unknown , signal ?: AbortSignal , ) : EnhancedResult
+execute ( name : | "swift_classes" | "get_objc_classes" | "get_objc_protocols" | "batch_decompile" | "get_call_graph" | "analyze_swift_types" | "find_xrefs_to_name" | "binary_overview" | "analyze_function" | "trace_feature" , input : unknown , signal ?: AbortSignal , ) : EnhancedResult
Parameters
-name : | "binary_overview" | "swift_classes" | "get_objc_classes" | "get_objc_protocols" | "batch_decompile" | "get_call_graph" | "analyze_swift_types" | "find_xrefs_to_name"
+name : | "swift_classes" | "get_objc_classes" | "get_objc_protocols" | "batch_decompile" | "get_call_graph" | "analyze_swift_types" | "find_xrefs_to_name" | "binary_overview" | "analyze_function" | "trace_feature"
input : unknown
Optionalsignal : AbortSignal
Returns EnhancedResult
+Defined in src/application/EnhancedTools.ts:49
diff --git a/docs/api/classes/application_EvidenceLedger.EvidenceLedger.html b/docs/api/classes/application_EvidenceLedger.EvidenceLedger.html
new file mode 100644
index 000000000..e3d3c46c7
--- /dev/null
+++ b/docs/api/classes/application_EvidenceLedger.EvidenceLedger.html
@@ -0,0 +1,245 @@
+EvidenceLedger | rea-agents - v1.0.0
+
+
+
+
+
+
+Constructors
+
+
+Methods
+
+
+
+export
+
+
+export () : { artifacts : { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; } [] ; bundle_version : 2 ; captures : { evidence_id : string ; predicate_type : string } [] ; environments : { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } [] ; providers : { id : string ; name : string ; version : string | null } [] ; records : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } [] ; scenarios : { authority : "controlled-replay" ; evidence_id : string ; operation : string ; } [] ; unknowns : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } [] ; }
+
+
+
Returns { artifacts : { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; } [] ; bundle_version : 2 ; captures : { evidence_id : string ; predicate_type : string } [] ; environments : { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } [] ; providers : { id : string ; name : string ; version : string | null } [] ; records : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } [] ; scenarios : { authority : "controlled-replay" ; evidence_id : string ; operation : string ; } [] ; unknowns : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } [] ; }
+
+get
+
+
+get ( evidenceId : string , ) : | { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } | undefined
+
+
+
+
Returns | { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } | undefined
+
+has
+
+
+has ( evidenceId : string ) : boolean
+
+
+import
+
+
+import ( input : unknown ) : ImportResult
+
+
+
+
Returns ImportResult
+
+list Unknowns
+
+
+listUnknowns ( filters ?: { domain ?: string ; severity ?: "low" | "medium" | "high" | "critical" ; status ?: | "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; } , ) : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } []
+
+
+
+
Parameters
+
+filters : { domain ?: string ; severity ?: "low" | "medium" | "high" | "critical" ; status ?: "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; } = {}
+
Returns { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } []
+
+record
+
+
+record ( input : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , ) : RecordResult
+
+
+
+
Parameters
+
+input : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+
Returns RecordResult
+
+record Unknown
+
+
+recordUnknown ( input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; } , mutationEvidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , ) : Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , EvidenceIntegrityError | EvidenceLimitError | UnknownRegistryError , >
+
+
+
+
Parameters
+
+input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; }
+mutationEvidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+
Returns Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , EvidenceIntegrityError | EvidenceLimitError | UnknownRegistryError , >
+
+record With Unknown
+
+
+recordWithUnknown ( evidenceInput : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; } , mutationInput : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , ) : Result < | { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } | null , EvidenceIntegrityError | EvidenceLimitError | UnknownRegistryError , >
+
+
+
+
Parameters
+
+evidenceInput : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+input : { approved : true ; contradicting_evidence_ids : string [] ; domain : string ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; severity : "low" | "medium" | "high" | "critical" ; supporting_evidence_ids : string [] ; }
+mutationInput : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+
Returns Result < | { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } | null , EvidenceIntegrityError | EvidenceLimitError | UnknownRegistryError , >
+
+update Unknown
+
+
+updateUnknown ( input : { approved : true ; contradicting_evidence_ids : string [] ; expected_revision : number ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , mutationEvidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : (
| { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )
[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; } , ) : Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , EvidenceIntegrityError | EvidenceLimitError | UnknownRegistryError , >
+
+
+
+
Parameters
+
+input : { approved : true ; contradicting_evidence_ids : string [] ; expected_revision : number ; recommended_probes : { operation : string ; rationale : string } [] ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; }
+mutationEvidence : { authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" ; confidence : "observed" | "derived" | "inferred" ; environment : | { architecture : string ; id : string ; isolation : "process" | "none" | "container" | "virtual-machine" ; platform : string ; } | null ; evidence_id : string ; evidence_links : string [] ; limitations : string [] ; locations : ( | { address : string ; kind : "address" } | { end : string ; kind : "address-range" ; start : string } | { kind : "artifact-path" ; path : string } | { kind : "file-offset" ; offset : number } | { end : number ; kind : "file-offset-range" ; start : number } )[] ; normalized_result : JSONType ; operation : string ; parameters : Record < string , JSONType > ; predicate_type : string ; provider : { id : string ; name : string ; version : string | null } ; raw_result : JSONType ; schema_version : 2 ; subject : | { architecture : "x86" | "x86_64" | "arm" | "arm64" | null ; digest : { sha256 : string } ; format : | "hopper" | "mach-o" | "elf" | "pe" | "zip" | "ipa" | "apk" | "asar" | "dmg" | "pkg" | "plist" | "javascript" | "source-map" | "unknown" | "file" | "directory" | "mach-o-universal" | "javascript-bundle" | "entitlements" ; local_path : string ; name : string ; } | null ; }
+
Returns Result < { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } , EvidenceIntegrityError | EvidenceLimitError | UnknownRegistryError , >
+
+verify Unknown Resolution
+
+
+verifyUnknownResolution ( unknownId : string , ) : Result < { truthVerified : boolean ; unknown : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : | "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } ; valid : boolean ; } , UnknownRegistryError , >
+
+
+
+
Returns Result < { truthVerified : boolean ; unknown : { contradicting_evidence_ids : string [] ; domain : string ; mutation_evidence_ids : string [] ; previous_revision_digest : string | null ; question : string ; recommended_probes : { operation : string ; rationale : string } [] ; registry_version : 1 ; relationships : { type : "depends-on" | "related-to" | "contradicts" ; unknown_id : string ; } [] ; required_authority : | "shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null ; required_confidence : "observed" | "derived" | "inferred" ; required_environment : | { architecture : string | null ; id : string | null ; isolation : "process" | "none" | "container" | "virtual-machine" | null ; platform : string | null ; } | null ; resolution : | { disposition : "verified" ; evidence_ids : string [] ; rationale : string ; } | { disposition : "withdrawn" | "out-of-scope" ; evidence_ids : string [] ; rationale : string ; } | null ; revision : number ; revision_digest : string ; scope_digest : string | null ; severity : "low" | "medium" | "high" | "critical" ; status : | "open" | "investigating" | "blocked" | "contradicted" | "resolved" ; supporting_evidence_ids : string [] ; unknown_id : string ; } ; valid : boolean ; } , UnknownRegistryError , >
+
+
diff --git a/docs/api/classes/application_ProcessHarness.ProcessCaptureError.html b/docs/api/classes/application_ProcessHarness.ProcessCaptureError.html
new file mode 100644
index 000000000..45363c552
--- /dev/null
+++ b/docs/api/classes/application_ProcessHarness.ProcessCaptureError.html
@@ -0,0 +1,99 @@
+ProcessCaptureError | rea-agents - v1.0.0
+
+
+
+
+
Class ProcessCaptureError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+
+
+
+
+
+
+
Parameters
+
+Optionalmessage : string
+Optionaloptions : ErrorOptions
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "ProcessCaptureError"
+
+
diff --git a/docs/api/classes/domain_errors.HopperUnavailableError.html b/docs/api/classes/domain_errors.AnalysisCancelledError.html
similarity index 73%
rename from docs/api/classes/domain_errors.HopperUnavailableError.html
rename to docs/api/classes/domain_errors.AnalysisCancelledError.html
index 7bda35d6d..d6a078cc8 100644
--- a/docs/api/classes/domain_errors.HopperUnavailableError.html
+++ b/docs/api/classes/domain_errors.AnalysisCancelledError.html
@@ -1,5 +1,5 @@
-HopperUnavailableError | rea-agents - v0.1.0
-rea-agents - v0.1.0
+
AnalysisCancelledError | rea-agents - v1.0.0
+
Properties
Readonly_ tag
-_tag : "HopperUnavailableError"
+Defined in src/domain/errors.ts:86
+
+Readonlyoperation
+operation : string
diff --git a/docs/api/classes/domain_errors.AnalysisCapabilityUnavailableError.html b/docs/api/classes/domain_errors.AnalysisCapabilityUnavailableError.html
new file mode 100644
index 000000000..67e160847
--- /dev/null
+++ b/docs/api/classes/domain_errors.AnalysisCapabilityUnavailableError.html
@@ -0,0 +1,107 @@
+AnalysisCapabilityUnavailableError | rea-agents - v1.0.0
+
+
+
+
+
Class AnalysisCapabilityUnavailableError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+
+
+
+
Parameters
+
+providerId : string
+operation : string
+reason : string
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "AnalysisCapabilityUnavailableError"
+
+Readonlyoperation
+operation : string
+
+Readonlyprovider Id
+providerId : string
+
+Readonlyreason
+reason : string
+
+
diff --git a/docs/api/classes/domain_errors.AnalysisError.html b/docs/api/classes/domain_errors.AnalysisError.html
new file mode 100644
index 000000000..c033e9f65
--- /dev/null
+++ b/docs/api/classes/domain_errors.AnalysisError.html
@@ -0,0 +1,117 @@
+AnalysisError | rea-agents - v1.0.0
+
+
+
+
+
Class AnalysisErrorAbstract
+
+
+
+
+Constructors
+
+
+constructor
+
+
+
+
+
+new AnalysisError ( message ?: string , options ?: ErrorOptions ) : AnalysisError
+
+
+
Parameters
+
+Optionalmessage : string
+Optionaloptions : ErrorOptions
+
+
+Properties
+
+
+Abstract Readonly_ tag
+_tag : | "AnalysisProtocolError" | "AnalysisInputError" | "AnalysisOutputError" | "AnalysisCapabilityUnavailableError" | "AnalysisCancelledError" | "AnalysisTimeoutError" | "ProviderSelectionError" | "ProviderAdapterError" | "ArtifactOperationError" | "ProcessCaptureError" | "EvidenceIntegrityError" | "EvidenceLimitError" | "EvidenceFileError" | "UnknownRegistryError" | "HopperTimeoutError" | "HopperCancelledError" | "HopperProtocolError" | "HopperRemoteError" | "HopperProcessError" | "HopperStartError" | "ConfigurationError" | "NoBinaryOpenError" | "BinaryTargetError"
+
+
diff --git a/docs/api/classes/domain_errors.AnalysisInputError.html b/docs/api/classes/domain_errors.AnalysisInputError.html
new file mode 100644
index 000000000..fd3990e2d
--- /dev/null
+++ b/docs/api/classes/domain_errors.AnalysisInputError.html
@@ -0,0 +1,94 @@
+AnalysisInputError | rea-agents - v1.0.0
+
+
+
+
+
Class AnalysisInputError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+
+
+
+
Parameters
+
+operation : string
+Optionaloptions : ErrorOptions
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "AnalysisInputError"
+
+Readonlyoperation
+operation : string
+
+
diff --git a/docs/api/classes/domain_errors.AnalysisOutputError.html b/docs/api/classes/domain_errors.AnalysisOutputError.html
new file mode 100644
index 000000000..286d29fbc
--- /dev/null
+++ b/docs/api/classes/domain_errors.AnalysisOutputError.html
@@ -0,0 +1,101 @@
+AnalysisOutputError | rea-agents - v1.0.0
+
+
+
+
+
Class AnalysisOutputError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+new AnalysisOutputError ( operation : string , reason : string , options ?: ErrorOptions , ) : AnalysisOutputError
+
+
+
Parameters
+
+operation : string
+reason : string
+Optionaloptions : ErrorOptions
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "AnalysisOutputError"
+
+Readonlyoperation
+operation : string
+
+Readonlyreason
+reason : string
+
+
diff --git a/docs/api/classes/domain_errors.AnalysisProtocolError.html b/docs/api/classes/domain_errors.AnalysisProtocolError.html
new file mode 100644
index 000000000..318d82eea
--- /dev/null
+++ b/docs/api/classes/domain_errors.AnalysisProtocolError.html
@@ -0,0 +1,99 @@
+AnalysisProtocolError | rea-agents - v1.0.0
+
+
+
+
+
Class AnalysisProtocolError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+
+
+
+
+
+
+
Parameters
+
+Optionalmessage : string
+Optionaloptions : ErrorOptions
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "AnalysisProtocolError"
+
+
diff --git a/docs/api/classes/domain_errors.AnalysisTimeoutError.html b/docs/api/classes/domain_errors.AnalysisTimeoutError.html
new file mode 100644
index 000000000..8b29d50a1
--- /dev/null
+++ b/docs/api/classes/domain_errors.AnalysisTimeoutError.html
@@ -0,0 +1,100 @@
+AnalysisTimeoutError | rea-agents - v1.0.0
+
+
+
+
+
Class AnalysisTimeoutError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+
+
+
+
Parameters
+
+operation : string
+timeoutMs : number
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "AnalysisTimeoutError"
+
+Readonlyoperation
+operation : string
+
+Readonlytimeout Ms
+timeoutMs : number
+
+
diff --git a/docs/api/classes/domain_errors.ArtifactOperationError.html b/docs/api/classes/domain_errors.ArtifactOperationError.html
new file mode 100644
index 000000000..30fe7ab98
--- /dev/null
+++ b/docs/api/classes/domain_errors.ArtifactOperationError.html
@@ -0,0 +1,100 @@
+ArtifactOperationError | rea-agents - v1.0.0
+
+
+
+
+
Class ArtifactOperationError
+
+
+
+
+Constructors
+
+
+constructor
+
+
+new ArtifactOperationError ( operation : "inventory_artifact" | "extract_artifact" , reason : | "cancelled" | "format" | "integrity" | "limit" | "path" | "unavailable" | "io" , ) : ArtifactOperationError
+
+
+
Parameters
+
+operation : "inventory_artifact" | "extract_artifact"
+reason : "cancelled" | "format" | "integrity" | "limit" | "path" | "unavailable" | "io"
+
+
+Properties
+
+
+Readonly_ tag
+_tag : "ArtifactOperationError"
+
+Readonlyoperation
+operation : "inventory_artifact" | "extract_artifact"
+
+Readonlyreason
+reason : | "cancelled" | "format" | "integrity" | "limit" | "path" | "unavailable" | "io"
+
+
diff --git a/docs/api/classes/domain_errors.BinaryTargetError.html b/docs/api/classes/domain_errors.BinaryTargetError.html
index a9ed43f84..70cfbe32e 100644
--- a/docs/api/classes/domain_errors.BinaryTargetError.html
+++ b/docs/api/classes/domain_errors.BinaryTargetError.html
@@ -1,5 +1,5 @@
-BinaryTargetError | rea-agents - v0.1.0
-
Properties
Readonlypath
path : string
+Defined in src/domain/errors.ts:282
diff --git a/docs/api/classes/domain_errors.ConfigurationError.html b/docs/api/classes/domain_errors.ConfigurationError.html
index f98f33698..2ea7fd1c9 100644
--- a/docs/api/classes/domain_errors.ConfigurationError.html
+++ b/docs/api/classes/domain_errors.ConfigurationError.html
@@ -1,5 +1,5 @@
-ConfigurationError | rea-agents - v0.1.0
Return the immutable artifact identity captured before Hopper launched.
+