fix(build): preserve fresh startup metadata across rebuilds · openclaw/openclaw@ef9e9bf

Recent Commits to openclaw:main

vincentkoc · 2026-05-31 · via Recent Commits to openclaw:main

Original file line number	Diff line number	Diff line change
`@@ -180,9 +180,15 @@ export const BUILD_ALL_PROFILES = {`
`180`	`180`	`};`
`181`	`181`
`182`	`182`	`export const BUILD_ALL_PROFILE_STEP_ENV = {`
	`183`	`+full: {`
	`184`	`+tsdown: {`
	`185`	`+OPENCLAW_PRESERVE_CLI_STARTUP_METADATA: "1",`
	`186`	`+},`
	`187`	`+},`
`183`	`188`	`ciArtifacts: {`
`184`	`189`	`tsdown: {`
`185`	`190`	`OPENCLAW_RUN_NODE_SKIP_DTS_BUILD: "1",`
	`191`	`+OPENCLAW_PRESERVE_CLI_STARTUP_METADATA: "1",`
`186`	`192`	`},`
`187`	`193`	`},`
`188`	`194`	`gatewayWatch: {`
`@@ -201,6 +207,7 @@ export const BUILD_ALL_PROFILE_STEP_ENV = {`
`201`	`207`	`cliStartup: {`
`202`	`208`	`tsdown: {`
`203`	`209`	`OPENCLAW_RUN_NODE_SKIP_DTS_BUILD: "1",`
	`210`	`+OPENCLAW_PRESERVE_CLI_STARTUP_METADATA: "1",`
`204`	`211`	`},`
`205`	`212`	`"runtime-postbuild": {`
`206`	`213`	`OPENCLAW_RUNTIME_POSTBUILD_STATIC_ASSETS: "0",`

Original file line number	Diff line number	Diff line change
`@@ -30,6 +30,8 @@ const CGROUP_MEMORY_LIMIT_PATHS = [`
`30`	`30`	`const PROC_MEMINFO_PATH = "/proc/meminfo";`
`31`	`31`	`const TERMINATION_GRACE_MS = 5_000;`
`32`	`32`	`const ROOT_TSDOWN_OUTPUT_ROOTS = ["dist", "dist-runtime"];`
	`33`	`+const PRESERVED_TSDOWN_OUTPUT_FILES = ["dist/cli-startup-metadata.json"];`
	`34`	`+const PRESERVE_CLI_STARTUP_METADATA_ENV = "OPENCLAW_PRESERVE_CLI_STARTUP_METADATA";`
`33`	`35`	`const GENERATED_SOURCE_DECLARATION_PATHSPEC = ":(glob)extensions/*/.d.ts";`
`34`	`36`	`const DECLARATION_EXTENSIONS = [".d.ts", ".d.mts", ".d.cts"];`
`35`	`37`	`const SOURCE_DECLARATION_SOURCE_EXTENSIONS = [".ts", ".tsx", ".mts", ".cts", ".js", ".mjs", ".cjs"];`
`@@ -78,11 +80,15 @@ export function cleanTsdownOutputRoots(params = {}) {`
`78`	`80`	`roots,`
`79`	`81`	`})`
`80`	`82`	`: new Set();`
	`83`	`+const protectedPaths = new Set([`
	`84`	`+ ...protectedDeclarationPaths,`
	`85`	`+ ...listExistingPreservedOutputPaths({ cwd, env, fs: fsImpl }),`
	`86`	`+]);`
`81`	`87`	`for (const root of roots) {`
`82`	`88`	`const rootPath = path.join(cwd, root);`
`83`	`89`	`try {`
`84`		`-if (hasProtectedChild({ rootPath, protectedPaths: protectedDeclarationPaths })) {`
`85`		`-cleanOutputRootExcept(rootPath, protectedDeclarationPaths, fsImpl);`
	`90`	`+if (hasProtectedChild({ rootPath, protectedPaths })) {`
	`91`	`+cleanOutputRootExcept(rootPath, protectedPaths, fsImpl);`
`86`	`92`	`} else {`
`87`	`93`	`fsImpl.rmSync(rootPath, { force: true, recursive: true });`
`88`	`94`	`}`
`@@ -137,6 +143,24 @@ function listExistingDeclarationOutputPaths({ cwd, fs: fsImpl, roots }) {`
`137`	`143`	`return protectedPaths;`
`138`	`144`	`}`
`139`	`145`
	`146`	`+function listExistingPreservedOutputPaths({ cwd, env, fs: fsImpl }) {`
	`147`	`+const protectedPaths = new Set();`
	`148`	`+if (env[PRESERVE_CLI_STARTUP_METADATA_ENV] !== "1") {`
	`149`	`+return protectedPaths;`
	`150`	`+}`
	`151`	`+for (const relativePath of PRESERVED_TSDOWN_OUTPUT_FILES) {`
	`152`	`+const absolutePath = path.resolve(cwd, relativePath);`
	`153`	`+try {`
	`154`	`+if (fsImpl.statSync(absolutePath).isFile()) {`
	`155`	`+protectedPaths.add(absolutePath);`
	`156`	`+}`
	`157`	`+} catch {`
	`158`	`+// Missing preserved outputs are normal on first build.`
	`159`	`+}`
	`160`	`+}`
	`161`	`+return protectedPaths;`
	`162`	`+}`
	`163`	`+`
`140`	`164`	`function collectDeclarationOutputPaths(rootPath, protectedPaths, fsImpl) {`
`141`	`165`	`let entries = [];`
`142`	`166`	`try {`

Original file line number	Diff line number	Diff line change
`@@ -39,6 +39,7 @@ const CORE_CHANNEL_ORDER = [`
`39`	`39`	`"signal",`
`40`	`40`	`"imessage",`
`41`	`41`	`] as const;`
	`42`	`+const generatorSignature = createHash("sha1").update(readFileSync(scriptPath)).digest("hex");`
`42`	`43`
`43`	`44`	`type ExtensionChannelEntry = {`
`44`	`45`	`id: string;`
`@@ -467,6 +468,7 @@ export async function writeCliStartupMetadata(options?: {`
`467`	`468`	`try {`
`468`	`469`	`const existing = JSON.parse(readFileSync(resolvedOutputPath, "utf8")) as {`
`469`	`470`	`rootHelpBundleSignature?: unknown;`
	`471`	`+generatorSignature?: unknown;`
`470`	`472`	`browserHelpSourceSignature?: unknown;`
`471`	`473`	`secretsHelpSourceSignature?: unknown;`
`472`	`474`	`nodesHelpSourceSignature?: unknown;`
`@@ -480,6 +482,7 @@ export async function writeCliStartupMetadata(options?: {`
`480`	`482`	`if (`
`481`	`483`	`bundleIdentity &&`
`482`	`484`	`existing.rootHelpBundleSignature === bundleIdentity.signature &&`
	`485`	`+existing.generatorSignature === generatorSignature &&`
`483`	`486`	`existing.browserHelpSourceSignature === browserHelpSourceSignature &&`
`484`	`487`	`existing.secretsHelpSourceSignature === secretsHelpSourceSignature &&`
`485`	`488`	`existing.nodesHelpSourceSignature === nodesHelpSourceSignature &&`
`@@ -527,6 +530,7 @@ export async function writeCliStartupMetadata(options?: {`
`527`	`530`	`${JSON.stringify(
`528`	`531`	`{`
`529`	`532`	`generatedBy: "scripts/write-cli-startup-metadata.ts",`
	`533`	`+ generatorSignature,`
`530`	`534`	`channelOptions,`
`531`	`535`	`channelCatalogSignature: channelCatalog.signature,`
`532`	`536`	`rootHelpBundleSignature: bundleIdentity?.signature ?? null,`

Original file line number	Diff line number	Diff line change
`@@ -214,7 +214,9 @@ describe("resolveBuildAllSteps", () => {`
`214`	`214`	`});`
`215`	`215`
`216`	`216`	`it("keeps the full profile aligned with the declared steps", () => {`
`217`		`-expect(resolveBuildAllSteps("full")).toEqual(BUILD_ALL_STEPS);`
	`217`	`+expect(resolveBuildAllSteps("full").map((step) => step.label)).toEqual(`
	`218`	`+BUILD_ALL_STEPS.map((step) => step.label),`
	`219`	`+);`
`218`	`220`	`expect(BUILD_ALL_PROFILES.full).toEqual(BUILD_ALL_STEPS.map((step) => step.label));`
`219`	`221`	`});`
`220`	`222`
`@@ -246,7 +248,7 @@ describe("resolveBuildAllSteps", () => {`
`246`	`248`	throw new Error(`Missing ${profile} tsdown step`);
`247`	`249`	`}`
`248`	`250`
`249`		`-expect(BUILD_ALL_PROFILE_STEP_ENV[profile].tsdown).toEqual({`
	`251`	`+expect(BUILD_ALL_PROFILE_STEP_ENV[profile].tsdown).toMatchObject({`
`250`	`252`	`OPENCLAW_RUN_NODE_SKIP_DTS_BUILD: "1",`
`251`	`253`	`});`
`252`	`254`	`expect(`
`@@ -257,6 +259,30 @@ describe("resolveBuildAllSteps", () => {`
`257`	`259`	`}`
`258`	`260`	`});`
`259`	`261`
	`262`	`+it("preserves startup metadata only for profiles that regenerate it", () => {`
	`263`	`+for (const profile of ["full", "ciArtifacts", "cliStartup"]) {`
	`264`	`+const tsdown = resolveBuildAllSteps(profile).find((step) => step.label === "tsdown");`
	`265`	`+if (!tsdown) {`
	`266`	+throw new Error(`Missing ${profile} tsdown step`);
	`267`	`+}`
	`268`	`+`
	`269`	`+expect(resolveBuildAllStep(tsdown, { env: {} }).options.env).toMatchObject({`
	`270`	`+OPENCLAW_PRESERVE_CLI_STARTUP_METADATA: "1",`
	`271`	`+});`
	`272`	`+}`
	`273`	`+`
	`274`	`+for (const profile of ["gatewayWatch", "qaRuntime"]) {`
	`275`	`+const tsdown = resolveBuildAllSteps(profile).find((step) => step.label === "tsdown");`
	`276`	`+if (!tsdown) {`
	`277`	+throw new Error(`Missing ${profile} tsdown step`);
	`278`	`+}`
	`279`	`+`
	`280`	`+expect(resolveBuildAllStep(tsdown, { env: {} }).options.env).not.toHaveProperty(`
	`281`	`+"OPENCLAW_PRESERVE_CLI_STARTUP_METADATA",`
	`282`	`+);`
	`283`	`+}`
	`284`	`+});`
	`285`	`+`
`260`	`286`	`it("uses a minimal built runtime profile for gateway watch regression", () => {`
`261`	`287`	`expect(resolveBuildAllSteps("gatewayWatch").map((step) => step.label)).toEqual([`
`262`	`288`	`"tsdown",`

Original file line number	Diff line number	Diff line change
`@@ -320,6 +320,39 @@ describe("resolveTsdownBuildInvocation", () => {`
`320`	`320`	`await expect(fsPromises.readFile(unrelatedFile, "utf8")).resolves.toBe("keep\n");`
`321`	`321`	`});`
`322`	`322`
	`323`	`+it("removes CLI startup metadata during default tsdown clean", async () => {`
	`324`	`+const rootDir = createTempDir("openclaw-tsdown-clean-metadata-default-");`
	`325`	`+const metadataFile = path.join(rootDir, "dist", "cli-startup-metadata.json");`
	`326`	`+await fsPromises.mkdir(path.dirname(metadataFile), { recursive: true });`
	`327`	`+await fsPromises.writeFile(metadataFile, '{"generatedBy":"test"}\n');`
	`328`	`+`
	`329`	`+cleanTsdownOutputRoots({ cwd: rootDir });`
	`330`	`+`
	`331`	`+await expectPathMissing(metadataFile);`
	`332`	`+});`
	`333`	`+`
	`334`	`+it("preserves CLI startup metadata across opted-in build-all tsdown clean", async () => {`
	`335`	`+const rootDir = createTempDir("openclaw-tsdown-clean-metadata-");`
	`336`	`+const metadataFile = path.join(rootDir, "dist", "cli-startup-metadata.json");`
	`337`	`+const staleFile = path.join(rootDir, "dist", "stale.js");`
	`338`	`+const nestedStaleFile = path.join(rootDir, "dist", "nested", "stale.js");`
	`339`	`+await fsPromises.mkdir(path.dirname(nestedStaleFile), { recursive: true });`
	`340`	`+await fsPromises.writeFile(metadataFile, '{"generatedBy":"test"}\n');`
	`341`	`+await fsPromises.writeFile(staleFile, "stale\n");`
	`342`	`+await fsPromises.writeFile(nestedStaleFile, "stale\n");`
	`343`	`+`
	`344`	`+cleanTsdownOutputRoots({`
	`345`	`+cwd: rootDir,`
	`346`	`+env: { OPENCLAW_PRESERVE_CLI_STARTUP_METADATA: "1" },`
	`347`	`+});`
	`348`	`+`
	`349`	`+await expect(fsPromises.readFile(metadataFile, "utf8")).resolves.toBe(`
	`350`	`+'{"generatedBy":"test"}\n',`
	`351`	`+);`
	`352`	`+await expectPathMissing(staleFile);`
	`353`	`+await expectPathMissing(nestedStaleFile);`
	`354`	`+});`
	`355`	`+`
`323`	`356`	`it("preserves existing package declarations when tsdown DTS output is skipped", async () => {`
`324`	`357`	`const rootDir = createTempDir("openclaw-tsdown-clean-skip-dts-");`
`325`	`358`	`const declarationFile = path.join(`

Original file line number	Diff line number	Diff line change
`@@ -93,6 +93,7 @@ describe("write-cli-startup-metadata", () => {`
`93`	`93`	`const written = JSON.parse(readFileSync(outputPath, "utf8")) as {`
`94`	`94`	`browserHelpText: string;`
`95`	`95`	`channelOptions: string[];`
	`96`	`+generatorSignature: string;`
`96`	`97`	`nodesHelpText: string;`
`97`	`98`	`rootHelpText: string;`
`98`	`99`	`secretsHelpText: string;`
`@@ -104,6 +105,7 @@ describe("write-cli-startup-metadata", () => {`
`104`	`105`	`};`
`105`	`106`	`};`
`106`	`107`	`expect(written.channelOptions).toContain("matrix");`
	`108`	`+expect(written.generatorSignature).toMatch(/^[a-f0-9]{40}$/u);`
`107`	`109`	`expect(written.browserHelpText).toContain("Usage:");`
`108`	`110`	`expect(written.browserHelpText).toContain("openclaw browser");`
`109`	`111`	`expect(written.secretsHelpText).toContain("Usage:");`
`@@ -154,6 +156,16 @@ describe("write-cli-startup-metadata", () => {`
`154`	`156`	`await writeMetadata();`
`155`	`157`	`expect(nodesRenderCount).toBe(1);`
`156`	`158`
	`159`	`+const staleGeneratorMetadata = JSON.parse(readFileSync(outputPath, "utf8")) as Record<`
	`160`	`+string,`
	`161`	`+unknown`
	`162`	`+>;`
	`163`	`+staleGeneratorMetadata.generatorSignature = "stale-generator";`
	`164`	+writeFileSync(outputPath, `${JSON.stringify(staleGeneratorMetadata, null, 2)}\n`, "utf8");
	`165`	`+`
	`166`	`+await writeMetadata();`
	`167`	`+expect(nodesRenderCount).toBe(2);`
	`168`	`+`
`157`	`169`	`writeFixtureFile(`
`158`	`170`	`tempRoot,`
`159`	`171`	`"extensions/canvas/src/cli.ts",`
`@@ -165,7 +177,7 @@ describe("write-cli-startup-metadata", () => {`
`165`	`177`	`const written = JSON.parse(readFileSync(outputPath, "utf8")) as {`
`166`	`178`	`nodesHelpText: string;`
`167`	`179`	`};`
`168`		`-expect(nodesRenderCount).toBe(2);`
`169`		`-expect(written.nodesHelpText).toContain("openclaw nodes 2");`
	`180`	`+expect(nodesRenderCount).toBe(3);`
	`181`	`+expect(written.nodesHelpText).toContain("openclaw nodes 3");`
`170`	`182`	`});`
`171`	`183`	`});`

此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。原文来自 — 版权归原作者所有。

推荐订阅源

Recent Commits to openclaw:main