feat: complete REA remediation program

This commit is contained in:
N0zoM1z0
2026-07-22 22:09:12 +09:00
committed by N0zoM1z0
parent 737940c90c
commit d25e98c3f9
460 changed files with 13985 additions and 1877 deletions
+127 -40
View File
@@ -1,7 +1,15 @@
import { z } from "incur";
import { runDoctor } from "../application/Doctor.js";
import { runSetup, systemSetupHost } from "../application/Setup.js";
import {
DOCTOR_PROVIDER_IDS,
runDoctor,
type DoctorScope,
} from "../application/Doctor.js";
import {
runSetup,
systemSetupHost,
type SetupOptions,
} from "../application/Setup.js";
import { runUninstall } from "../application/Uninstall.js";
import { runUpgrade, systemUpgradeHost } from "../application/Upgrade.js";
import {
@@ -16,11 +24,28 @@ import { createSystemDoctorHost } from "../doctorRuntime.js";
import { CLI_COMMANDS } from "../cliCommandNames.js";
import type { Logger } from "../logger.js";
import type { CliInstance } from "./types.js";
import { SUPPORTED_CLIENT_DEFINITIONS } from "../application/SupportedClients.js";
import { projectDoctorReport } from "../application/DoctorProjection.js";
const supportedClientIds = SUPPORTED_CLIENT_DEFINITIONS.map(({ name }) => name);
const supportedClientSchema = z
.string()
.refine(
(candidate) => supportedClientIds.some((name) => name === candidate),
"Unsupported agent integration",
);
/** Register setup, doctor, uninstall, and upgrade CLI commands. */
export const registerSetupCommands = (
cli: CliInstance,
logger: Logger,
): void => {
registerSetupCommand(cli, logger);
registerDoctorCommand(cli, logger);
registerMaintenanceCommands(cli, logger);
};
const registerSetupCommand = (cli: CliInstance, logger: Logger): void => {
cli.command(CLI_COMMANDS.setup, {
description: "Install requirements and configure agents",
outputPolicy: "agent-only",
@@ -34,16 +59,7 @@ export const registerSetupCommands = (
.default(false)
.describe("Also approve Hopper installation with --yes"),
client: z
.array(
z.enum([
"claude_code",
"claude_desktop",
"codex",
"cursor",
"gemini_cli",
"windsurf",
]),
)
.array(supportedClientSchema)
.default([])
.describe("Agent integration to configure; repeat for multiple agents"),
allDetected: z
@@ -64,23 +80,56 @@ export const registerSetupCommands = (
.boolean()
.default(false)
.describe("Use sequential accessible setup prompts"),
detail: z
.enum(["summary", "full"])
.default("summary")
.describe("Summary or complete setup and doctor diagnostics"),
}),
alias: { yes: "y" },
run: ({ options, formatExplicit, agent }) =>
run: ({ options, formatExplicit }) =>
logCliCommand(logger, "setup", () =>
runSetupCommand({ options, formatExplicit, agent }),
runSetupCommand({ options, formatExplicit }),
),
});
};
const registerDoctorCommand = (cli: CliInstance, logger: Logger): void => {
cli.command(CLI_COMMANDS.doctor, {
description: "Check whether REA is ready",
options: z.object({
target: z.string().optional().describe("Optional app path to check"),
client: z
.array(supportedClientSchema)
.default([])
.describe("Agent registration whose readiness is required; repeatable"),
provider: z
.array(z.enum(DOCTOR_PROVIDER_IDS))
.default([])
.describe("Deep-analysis provider whose readiness is required"),
skill: z
.boolean()
.optional()
.describe("Require the installed REA skill identity to be aligned"),
detail: z
.enum(["summary", "full"])
.default("summary")
.describe("Summary or complete doctor diagnostics"),
}),
run: ({ options }) =>
logCliCommand(logger, "doctor", () =>
runDoctor(options.target, createSystemDoctorHost()),
runDoctor(
options.target,
createSystemDoctorHost(),
doctorScope(options),
).then((report) => projectDoctorReport(report, options.detail)),
),
});
};
const registerMaintenanceCommands = (
cli: CliInstance,
logger: Logger,
): void => {
cli.command(CLI_COMMANDS.uninstall, {
description: "Remove REA-owned agent configuration and skill files",
options: z.object({
@@ -114,54 +163,92 @@ interface SetupCommandOptions {
readonly skill?: boolean | undefined;
readonly dryRun: boolean;
readonly accessible: boolean;
readonly detail: "summary" | "full";
}
const runSetupCommand = async (input: {
readonly options: SetupCommandOptions;
readonly formatExplicit: boolean;
readonly agent: boolean;
}) => {
const { options } = input;
const interactive =
!options.yes &&
!options.dryRun &&
!input.formatExplicit &&
process.stdin.isTTY === true &&
process.stderr.isTTY === true;
const interactive = setupIsInteractive(options, input.formatExplicit);
const hasExplicitScope = setupHasExplicitScope(options);
if (options.yes && !hasExplicitScope)
process.stderr.write(
"! Implicit `rea setup --yes` scope is deprecated; use `--all-detected` to retain it.\n",
);
const agentIntegrationSelected =
options.allDetected || options.client.length > 0;
const result = await runSetup(
{
approved: options.yes && !options.dryRun,
installHopper: options.installHopper,
structured: input.formatExplicit || options.dryRun,
proposeHopper: !hasExplicitScope || options.installHopper,
...(!hasExplicitScope || options.allDetected
? {}
: { clientIds: options.client }),
...(!hasExplicitScope
? {}
: {
installSkill: options.skill ?? agentIntegrationSelected,
}),
...(interactive ? { onProgress: renderSetupProgress } : {}),
},
setupRunOptions(input, interactive, hasExplicitScope),
systemSetupHost(createSystemDoctorHost()),
interactive
? (actions) => confirmInteractiveSetup(actions, options.accessible)
: undefined,
);
if (interactive) renderInteractiveSetupResult(result);
return input.formatExplicit ? result : conciseSetupResult(result);
return options.detail === "full" ? result : conciseSetupResult(result);
};
const setupRunOptions = (
input: {
readonly options: SetupCommandOptions;
readonly formatExplicit: boolean;
},
interactive: boolean,
hasExplicitScope: boolean,
): SetupOptions => {
const { options } = input;
const agentIntegrationSelected =
options.allDetected || options.client.length > 0;
const hasSelectedClients = hasExplicitScope && !options.allDetected;
return {
approved: options.yes && !options.dryRun,
installHopper: options.installHopper,
structured: input.formatExplicit || options.dryRun,
proposeHopper: !hasExplicitScope || options.installHopper,
...(hasSelectedClients ? { clientIds: options.client } : {}),
...(hasExplicitScope
? { installSkill: options.skill ?? agentIntegrationSelected }
: {}),
...(interactive ? { onProgress: renderSetupProgress } : {}),
...(hasSelectedClients
? {
readinessScope: {
clients: options.client,
providers: options.installHopper ? ["hopper"] : [],
skill: options.skill ?? agentIntegrationSelected,
},
}
: {}),
};
};
const setupIsInteractive = (
options: SetupCommandOptions,
formatExplicit: boolean,
): boolean =>
!options.yes &&
!options.dryRun &&
!formatExplicit &&
process.stdin.isTTY === true &&
process.stderr.isTTY === true;
const setupHasExplicitScope = (options: SetupCommandOptions): boolean =>
options.allDetected ||
options.client.length > 0 ||
options.skill !== undefined ||
options.installHopper;
const doctorScope = (options: {
readonly client: readonly string[];
readonly provider: readonly string[];
readonly skill?: boolean | undefined;
}): DoctorScope | undefined =>
options.client.length === 0 &&
options.provider.length === 0 &&
options.skill === undefined
? undefined
: {
clients: options.client,
providers: options.provider,
skill: options.skill === true,
};
+14 -2
View File
@@ -1,8 +1,9 @@
import { z } from "incur";
import {
runCapabilityStatus,
runProviderAnalysis,
runSessionStatus,
runProviderStatus,
} from "../application/DirectAnalysis.js";
import { importReferenceSource } from "../application/ReferenceSourceImport.js";
import { projectReferenceSourceImportError } from "../application/ReferenceSourceImportTypes.js";
@@ -38,7 +39,18 @@ const registerCapabilityCommands = (cli: CliInstance, logger: Logger): void => {
command === "capabilities"
? "List provider capabilities and side effects"
: "List configured analysis providers",
run: () => logCliCommand(logger, command, () => runSessionStatus(logger)),
options: z.object({
detail: z
.enum(["summary", "full"])
.default("summary")
.describe("Summary or complete provider descriptors"),
}),
run: ({ options }) =>
logCliCommand(logger, command, () =>
command === CLI_COMMANDS.providers
? runProviderStatus(logger, options.detail)
: runCapabilityStatus(logger, options.detail),
),
});
}
};