tuyoo-devflow 0.1.29 → 0.1.30

package/dist/commands/agent/index.js

@@ -1,10 +1,12 @@
 import { registerDoctorCommand } from "./doctor.js";
 import { registerInstallCommand } from "./install.js";
+import { registerReadmeCommand } from "./readme.js";
 import { registerUninstallCommand } from "./uninstall.js";
 export function registerAgentCommand(program) {
     const agentCommand = program.command("agent").description("Jenkins Agent 安装与运维命令");
     registerDoctorCommand(agentCommand);
     registerInstallCommand(agentCommand);
+    registerReadmeCommand(agentCommand);
     registerUninstallCommand(agentCommand);
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IACnF,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACpC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACrC,wBAAwB,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IACnF,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACpC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACrC,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACpC,wBAAwB,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC"}

package/dist/commands/agent/readme.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+import { AgentMaintenanceReadmeInput } from "../../core/store/installReadme.js";
+import { AgentInstallMetadata, AgentProfile } from "../../types.js";
+interface ReadmeOptions {
+    workDir?: string;
+    profile?: string;
+}
+export declare function buildReadmeInputFromInstallState(metadata: AgentInstallMetadata | null | undefined, profile: AgentProfile | undefined): AgentMaintenanceReadmeInput;
+export declare function refreshAgentReadme(options: ReadmeOptions): Promise<string>;
+export declare function registerReadmeCommand(agentCommand: Command): void;
+export {};

package/dist/commands/agent/readme.js

@@ -0,0 +1,111 @@
+import path from "node:path";
+import { VERSION_POLICY } from "../../constants/versionPolicy.js";
+import { buildJavaArgs } from "../../core/jenkins/launchArgs.js";
+import { safeErrorMessage } from "../../core/log/redact.js";
+import { getSupportedPlatform } from "../../core/platform.js";
+import { readInstallMetadata } from "../../core/store/installMetadataStore.js";
+import { DEFAULT_CLI_GITLAB_URL, writeAgentMaintenanceReadme, } from "../../core/store/installReadme.js";
+import { findProfileByWorkDir, getProfile, listProfiles } from "../../core/store/profileStore.js";
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function displayArg(value) {
+    if (value === "***" || /^[A-Za-z0-9_./:@=-]+$/.test(value)) {
+        return value;
+    }
+    return shellQuote(value);
+}
+function defaultStartupScriptPath(platform, workDir) {
+    if (platform === "windows") {
+        return path.join(workDir, "start_jenkins_agent.bat");
+    }
+    return path.join(workDir, "start_jenkins_agent.sh");
+}
+function buildJavaLine(profile, startupScriptPath) {
+    if (!profile) {
+        return `未记录；可查看启动脚本 ${startupScriptPath}`;
+    }
+    return `java ${buildJavaArgs(profile, "***").map((item) => displayArg(item)).join(" ")}`;
+}
+function buildCurlLine(profile) {
+    if (!profile?.jarDownloadUrl) {
+        return "未记录";
+    }
+    return `curl -sO ${profile.jarDownloadUrl}`;
+}
+export function buildReadmeInputFromInstallState(metadata, profile) {
+    const platform = metadata?.platform ?? profile?.platform ?? getSupportedPlatform();
+    const workDir = metadata?.workDir ?? profile?.workDir;
+    if (!workDir) {
+        throw new Error("缺少 workDir，无法生成 README。请通过 --work-dir 指定已安装 Agent 的工作目录。");
+    }
+    const startupScriptPath = metadata?.startupScriptPath ?? profile?.startupScriptPath ?? defaultStartupScriptPath(platform, workDir);
+    return {
+        platform,
+        linuxRunUser: metadata?.linuxRunUser ?? profile?.linuxRunUser,
+        macStartMode: metadata?.macStartMode ?? profile?.macStartMode,
+        workDir,
+        startupScriptPath,
+        serviceName: metadata?.serviceName ?? profile?.serviceName,
+        serviceFileName: metadata?.serviceFileName,
+        systemUnitPath: metadata?.systemUnitPath,
+        localUnitPath: metadata?.localUnitPath,
+        profileId: metadata?.profileId ?? profile?.id,
+        installedAt: metadata?.installedAt ?? profile?.createdAt ?? "未记录",
+        condaEnvName: VERSION_POLICY.conda.envName,
+        cliGitlabUrl: DEFAULT_CLI_GITLAB_URL,
+        nodeName: profile?.nodeName,
+        jenkinsBaseUrl: profile?.jenkinsBaseUrl ?? "未记录",
+        jarDownloadUrl: profile?.jarDownloadUrl ?? "未记录",
+        curlLine: buildCurlLine(profile),
+        javaLine: buildJavaLine(profile, startupScriptPath),
+    };
+}
+async function resolveProfileForReadme(options) {
+    if (options.profile) {
+        const profile = await getProfile(options.profile);
+        if (!profile) {
+            throw new Error(`未找到 profile: ${options.profile}`);
+        }
+        return profile;
+    }
+    if (options.workDir) {
+        return await findProfileByWorkDir(getSupportedPlatform(), options.workDir);
+    }
+    const profiles = await listProfiles();
+    if (profiles.length === 1) {
+        return profiles[0];
+    }
+    if (profiles.length > 1) {
+        throw new Error("存在多个 profile，请通过 --profile 或 --work-dir 指定要更新的 Agent。");
+    }
+    return undefined;
+}
+export async function refreshAgentReadme(options) {
+    const profile = await resolveProfileForReadme(options);
+    const workDir = options.workDir ?? profile?.workDir;
+    if (!workDir) {
+        throw new Error("未找到已安装 Agent，请通过 --work-dir 指定工作目录。");
+    }
+    const metadata = await readInstallMetadata(workDir);
+    const input = buildReadmeInputFromInstallState(metadata, profile);
+    return await writeAgentMaintenanceReadme(input);
+}
+export function registerReadmeCommand(agentCommand) {
+    agentCommand
+        .command("readme")
+        .description("为已安装 Jenkins Agent 生成/更新工作目录 README 维护说明")
+        .option("--work-dir <dir>", "Agent workDir（安装命令中的 -workDir）")
+        .option("--profile <id>", "profile ID")
+        .action(async (options) => {
+        try {
+            const readmePath = await refreshAgentReadme(options);
+            console.log(`README 已更新: ${readmePath}`);
+        }
+        catch (error) {
+            process.exitCode = 1;
+            console.error(`agent readme 失败: ${safeErrorMessage(error)}`);
+        }
+    });
+}
+//# sourceMappingURL=readme.js.map

package/dist/commands/agent/readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../../src/commands/agent/readme.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuyoo-devflow",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Tuyoo DevFlow CLI for Jenkins and pipeline automation",
   "private": false,
   "type": "module",