Codex
293 lines
12 KiB
TypeScript
293 lines
12 KiB
TypeScript
import { existsSync, readFileSync } from "node:fs";
|
|
import { extname } from "node:path";
|
|
import { runCommand } from "./command";
|
|
import { type UniDeskConfig, repoRoot, rootPath } from "./config";
|
|
import { composeConfig } from "./docker";
|
|
|
|
interface CheckItem {
|
|
name: string;
|
|
ok: boolean;
|
|
detail: unknown;
|
|
}
|
|
|
|
const syntaxFiles = [
|
|
"scripts/cli.ts",
|
|
"scripts/src/check.ts",
|
|
"scripts/src/artifact-registry.ts",
|
|
"scripts/src/code-queue.ts",
|
|
"scripts/src/command.ts",
|
|
"scripts/src/decision-center.ts",
|
|
"scripts/src/dev-env.ts",
|
|
"scripts/src/deploy.ts",
|
|
"scripts/src/docker.ts",
|
|
"scripts/src/e2e.ts",
|
|
"scripts/src/help.ts",
|
|
"scripts/src/remote.ts",
|
|
"src/components/frontend/src/index.ts",
|
|
"src/components/frontend/src/app.tsx",
|
|
"src/components/frontend/src/decision-center.tsx",
|
|
"src/components/provider-gateway/src/index.ts",
|
|
"src/components/microservices/oa-event-flow/src/index.ts",
|
|
"src/components/microservices/k3sctl-adapter/src/index.ts",
|
|
"src/components/microservices/mdtodo/src/index.ts",
|
|
"src/components/microservices/decision-center/src/index.ts",
|
|
"src/components/microservices/code-queue-mgr/src/index.ts",
|
|
];
|
|
|
|
export interface CheckOptions {
|
|
full: boolean;
|
|
files: boolean;
|
|
scriptsTypecheck: boolean;
|
|
components: boolean;
|
|
compose: boolean;
|
|
logs: boolean;
|
|
rust: boolean;
|
|
}
|
|
|
|
const defaultCheckOptions: CheckOptions = {
|
|
full: false,
|
|
files: false,
|
|
scriptsTypecheck: false,
|
|
components: false,
|
|
compose: false,
|
|
logs: false,
|
|
rust: false,
|
|
};
|
|
|
|
export function checkHelp(): Record<string, unknown> {
|
|
return {
|
|
ok: true,
|
|
command: "check",
|
|
usage: "bun scripts/cli.ts check [--syntax-only|--full|--files|--scripts-typecheck|--components|--compose|--logs|--rust]",
|
|
defaultMode: "syntax/config only; Rust is never compiled on the master server by default",
|
|
options: [
|
|
{ name: "--syntax-only|--basic", description: "Run only config validation, Bun version and TypeScript syntax transpile." },
|
|
{ name: "--full", description: "Enable all local checks except Rust compilation." },
|
|
{ name: "--files", description: "Verify required entrypoint files, including backend-core Cargo files." },
|
|
{ name: "--scripts-typecheck", description: "Run scripts TypeScript typecheck." },
|
|
{ name: "--components", description: "Run component TypeScript typecheck." },
|
|
{ name: "--compose", description: "Render Docker Compose config." },
|
|
{ name: "--logs", description: "Check unified log rotation policy." },
|
|
{ name: "--rust", description: "Run cargo check only when UNIDESK_D601_RUST_CHECK=1 is set inside D601 CI/dev execution." },
|
|
],
|
|
rustBoundary: {
|
|
masterServer: "do not run cargo check/build here",
|
|
d601: "use deploy apply --env dev --service backend-core and CI with UNIDESK_D601_RUST_CHECK=1",
|
|
},
|
|
};
|
|
}
|
|
|
|
export function parseCheckOptions(args: string[]): CheckOptions {
|
|
const options = { ...defaultCheckOptions };
|
|
for (const arg of args) {
|
|
if (arg === "--full") {
|
|
options.full = true;
|
|
options.files = true;
|
|
options.scriptsTypecheck = true;
|
|
options.components = true;
|
|
options.compose = true;
|
|
options.logs = true;
|
|
} else if (arg === "--files") {
|
|
options.files = true;
|
|
} else if (arg === "--scripts-typecheck") {
|
|
options.scriptsTypecheck = true;
|
|
} else if (arg === "--components") {
|
|
options.components = true;
|
|
} else if (arg === "--compose") {
|
|
options.compose = true;
|
|
} else if (arg === "--logs") {
|
|
options.logs = true;
|
|
} else if (arg === "--rust") {
|
|
options.rust = true;
|
|
} else if (arg === "--basic" || arg === "--syntax-only") {
|
|
Object.assign(options, defaultCheckOptions);
|
|
} else {
|
|
throw new Error(`unknown check option: ${arg}`);
|
|
}
|
|
}
|
|
return options;
|
|
}
|
|
|
|
function fileItem(path: string): CheckItem {
|
|
const absolute = rootPath(path);
|
|
return { name: `file:${path}`, ok: existsSync(absolute), detail: absolute };
|
|
}
|
|
|
|
function commandItem(name: string, command: string[], timeoutMs = 30_000, env: NodeJS.ProcessEnv = process.env): CheckItem {
|
|
const result = runCommand(command, repoRoot, { timeoutMs, env });
|
|
return {
|
|
name,
|
|
ok: result.exitCode === 0,
|
|
detail: {
|
|
command,
|
|
exitCode: result.exitCode,
|
|
signal: result.signal,
|
|
timedOut: result.timedOut,
|
|
stdoutTail: result.stdout.slice(-4000),
|
|
stderrTail: result.stderr.slice(-4000),
|
|
},
|
|
};
|
|
}
|
|
|
|
function syntaxItem(): CheckItem {
|
|
const failures: Array<{ path: string; error: string }> = [];
|
|
const checked: string[] = [];
|
|
const ts = new Bun.Transpiler({ loader: "ts" });
|
|
const tsx = new Bun.Transpiler({ loader: "tsx" });
|
|
for (const path of syntaxFiles) {
|
|
const absolute = rootPath(path);
|
|
try {
|
|
const source = readFileSync(absolute, "utf8");
|
|
const loader = extname(path) === ".tsx" ? tsx : ts;
|
|
loader.transformSync(source);
|
|
checked.push(path);
|
|
} catch (error) {
|
|
failures.push({ path, error: error instanceof Error ? error.message : String(error) });
|
|
}
|
|
}
|
|
return {
|
|
name: "syntax:transpile",
|
|
ok: failures.length === 0,
|
|
detail: { checked, failures },
|
|
};
|
|
}
|
|
|
|
function unifiedLogRotationItem(): CheckItem {
|
|
const serviceFiles = [
|
|
"src/components/frontend/src/index.ts",
|
|
"src/components/provider-gateway/src/index.ts",
|
|
"src/components/microservices/code-queue-mgr/src/index.ts",
|
|
"src/components/microservices/code-queue/src/index.ts",
|
|
"src/components/microservices/k3sctl-adapter/src/index.ts",
|
|
"src/components/microservices/mdtodo/src/index.ts",
|
|
"src/components/microservices/project-manager/src/index.ts",
|
|
"src/components/microservices/baidu-netdisk/src/index.ts",
|
|
"src/components/microservices/oa-event-flow/src/index.ts",
|
|
"src/components/microservices/decision-center/src/index.ts",
|
|
];
|
|
const offenders = serviceFiles.flatMap((path) => {
|
|
const text = readFileSync(rootPath(path), "utf8");
|
|
const directLogAppend = /appendFileSync\(\s*(?:config\.)?logFile\b/u.test(text) || /appendFileSync\(\s*process\.env\.LOG_FILE\b/u.test(text);
|
|
const missingWriter = !text.includes("createHourlyJsonlWriter");
|
|
return directLogAppend || missingWriter ? [{ path, directLogAppend, missingWriter }] : [];
|
|
});
|
|
const backendLogger = readFileSync(rootPath("src/components/backend-core/src/logger.rs"), "utf8");
|
|
const backendMissingRotation = !backendLogger.includes("current_path") || !backendLogger.includes("prune");
|
|
const backendDirectUnboundedAppend = backendLogger.includes("appendFileSync");
|
|
if (backendMissingRotation || backendDirectUnboundedAppend) {
|
|
offenders.push({ path: "src/components/backend-core/src/logger.rs", directLogAppend: backendDirectUnboundedAppend, missingWriter: backendMissingRotation });
|
|
}
|
|
return {
|
|
name: "logs:unified-hourly-rotation",
|
|
ok: offenders.length === 0,
|
|
detail: {
|
|
sharedWriter: "src/components/shared/src/rotating-jsonl.ts",
|
|
checkedFiles: ["src/components/backend-core/src/logger.rs", ...serviceFiles],
|
|
offenders,
|
|
},
|
|
};
|
|
}
|
|
|
|
function rustCheckItem(): CheckItem {
|
|
if (process.env.UNIDESK_D601_RUST_CHECK !== "1") {
|
|
return {
|
|
name: "rust:backend-core",
|
|
ok: false,
|
|
detail: {
|
|
skipped: true,
|
|
reason: "Rust compilation is intentionally not allowed on the master server; run it from D601 CI/dev deploy.",
|
|
enableOnD601: "UNIDESK_D601_RUST_CHECK=1 bun scripts/cli.ts check --rust",
|
|
deployPath: "bun scripts/cli.ts deploy apply --env dev --service backend-core",
|
|
},
|
|
};
|
|
}
|
|
const envPath = process.env.HOME ? `${process.env.HOME}/.cargo/bin:${process.env.PATH ?? ""}` : process.env.PATH;
|
|
const env = envPath ? { ...process.env, PATH: envPath } : process.env;
|
|
return commandItem("rust:backend-core", ["cargo", "check", "--manifest-path", "src/components/backend-core/Cargo.toml"], 180_000, env);
|
|
}
|
|
|
|
function skippedItem(name: string, reason: string, enableWith: string): CheckItem {
|
|
return { name, ok: true, detail: { skipped: true, reason, enableWith } };
|
|
}
|
|
|
|
export function runChecks(config: UniDeskConfig, options: CheckOptions = defaultCheckOptions): { ok: boolean; mode: string; options: CheckOptions; items: CheckItem[] } {
|
|
const items: CheckItem[] = [
|
|
{ name: "config:validated", ok: true, detail: { project: config.project.name, runtime: config.runtime } },
|
|
commandItem("bun:version", ["bun", "--version"]),
|
|
syntaxItem(),
|
|
];
|
|
if (options.files) {
|
|
items.push(
|
|
fileItem("scripts/cli.ts"),
|
|
fileItem("AGENTS.md"),
|
|
fileItem("TEST.md"),
|
|
fileItem("docs/reference/artifact-registry.md"),
|
|
fileItem("docker-compose.yml"),
|
|
fileItem("src/components/backend-core/Cargo.toml"),
|
|
fileItem("src/components/backend-core/Cargo.lock"),
|
|
fileItem("src/components/backend-core/src/main.rs"),
|
|
fileItem("src/components/backend-core/src/http.rs"),
|
|
fileItem("src/components/frontend/src/index.ts"),
|
|
fileItem("src/components/provider-gateway/src/index.ts"),
|
|
fileItem("src/components/microservices/oa-event-flow/src/index.ts"),
|
|
fileItem("src/components/microservices/k3sctl-adapter/src/index.ts"),
|
|
fileItem("src/components/microservices/mdtodo/src/index.ts"),
|
|
fileItem("src/components/microservices/decision-center/src/index.ts"),
|
|
fileItem("src/components/microservices/code-queue-mgr/src/index.ts"),
|
|
fileItem("src/components/microservices/code-queue-mgr/src/prompt-observation.ts"),
|
|
fileItem("scripts/src/deploy.ts"),
|
|
fileItem("scripts/code-queue-issue3-regression-test.ts"),
|
|
fileItem("scripts/src/ci.ts"),
|
|
fileItem("scripts/src/e2e.ts"),
|
|
fileItem("scripts/code-queue-prompt-observation-test.ts"),
|
|
fileItem("scripts/src/artifact-registry.ts"),
|
|
fileItem("src/components/microservices/k3sctl-adapter/k3s/ci/unidesk-ci.pipeline.yaml"),
|
|
);
|
|
} else {
|
|
items.push(skippedItem("files:required-entrypoints", "required file presence scan is opt-in", "--files or --full"));
|
|
}
|
|
if (options.scriptsTypecheck) {
|
|
items.push(commandItem("typescript:scripts", ["bunx", "tsc", "-p", "scripts/tsconfig.json", "--noEmit", "--pretty", "false"], 120_000));
|
|
items.push(commandItem("code-queue:prompt-observation-contract", ["bun", "scripts/code-queue-prompt-observation-test.ts"], 30_000));
|
|
items.push(commandItem("code-queue:issue3-diagnostics-and-image-preflight", ["bun", "scripts/code-queue-issue3-regression-test.ts"], 30_000));
|
|
} else {
|
|
items.push(skippedItem("typescript:scripts", "scripts TypeScript typecheck is opt-in", "--scripts-typecheck or --full"));
|
|
items.push(skippedItem("code-queue:prompt-observation-contract", "prompt observation contract is opt-in with script checks", "--scripts-typecheck or --full"));
|
|
items.push(skippedItem("code-queue:issue3-diagnostics-and-image-preflight", "Code Queue issue #3 regression fixtures are opt-in with script checks", "--scripts-typecheck or --full"));
|
|
}
|
|
if (options.logs) {
|
|
items.push(unifiedLogRotationItem());
|
|
} else {
|
|
items.push(skippedItem("logs:unified-hourly-rotation", "policy scan is opt-in", "--logs or --full"));
|
|
}
|
|
if (options.components) {
|
|
items.push(commandItem("typescript:components", ["bunx", "tsc", "-p", "src/tsconfig.check.json", "--pretty", "false"], 180_000));
|
|
} else {
|
|
items.push(skippedItem("typescript:components", "component TypeScript check is opt-in", "--components or --full"));
|
|
}
|
|
if (options.compose) {
|
|
const compose = composeConfig(config);
|
|
items.push({
|
|
name: "docker-compose:config",
|
|
ok: compose.result.exitCode === 0,
|
|
detail: {
|
|
command: compose.command,
|
|
exitCode: compose.result.exitCode,
|
|
signal: compose.result.signal,
|
|
timedOut: compose.result.timedOut,
|
|
stdoutTail: compose.result.stdout.slice(-4000),
|
|
stderrTail: compose.result.stderr.slice(-4000),
|
|
runtimeEnv: compose.runtimeEnv,
|
|
},
|
|
});
|
|
} else {
|
|
items.push(skippedItem("docker-compose:config", "Docker Compose config rendering is opt-in", "--compose or --full"));
|
|
}
|
|
if (options.rust) {
|
|
items.push(rustCheckItem());
|
|
} else {
|
|
items.push(skippedItem("rust:backend-core", "Rust check/build must run on D601 dev deploy or CI, not on the master server", "--rust inside D601 CI with UNIDESK_D601_RUST_CHECK=1"));
|
|
}
|
|
return { ok: items.every((item) => item.ok), mode: options.full ? "full" : "basic", options, items };
|
|
}
|