fix(release): publish agenter wrapper from bundle projection

Gaubee · Gaubee · commit 9293a5322f7e · 2026-06-04T21:24:18.000+08:00
diff --git a/packages/agenter-cli-darwin-arm64/package.json b/packages/agenter-cli-darwin-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-darwin-arm64",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for darwin arm64",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-darwin-x64/package.json b/packages/agenter-cli-darwin-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-darwin-x64",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for darwin x64",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-linux-arm64-gnu/package.json b/packages/agenter-cli-linux-arm64-gnu/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-linux-arm64-gnu",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for linux arm64 glibc",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-linux-arm64-musl/package.json b/packages/agenter-cli-linux-arm64-musl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-linux-arm64-musl",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for linux arm64 musl",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-linux-x64-gnu/package.json b/packages/agenter-cli-linux-x64-gnu/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-linux-x64-gnu",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for linux x64 glibc",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-linux-x64-musl/package.json b/packages/agenter-cli-linux-x64-musl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-linux-x64-musl",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for linux x64 musl",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-win32-arm64/package.json b/packages/agenter-cli-win32-arm64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-win32-arm64",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for win32 arm64",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter-cli-win32-x64/package.json b/packages/agenter-cli-win32-x64/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@jixoai/cli-win32-x64",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Prebuilt Agenter CLI for win32 x64",
   "license": "MIT",
   "repository": {
diff --git a/packages/agenter/CHANGELOG.md b/packages/agenter/CHANGELOG.md
@@ -1,5 +1,11 @@
 # agenter
 
+## 0.0.11
+
+### Patch Changes
+
+- Publish the public `agenter` wrapper from the generated release bundle projection so npm never receives `workspace:*`, and keep the release/archive/native package version truth aligned at `0.0.11`.
+
 ## 0.0.10
 
 ### Patch Changes
diff --git a/packages/agenter/package.json b/packages/agenter/package.json
@@ -1,6 +1,6 @@
 {
   "name": "agenter",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "type": "module",
   "repository": {
     "type": "git",
diff --git a/scripts/release/build-bundles.ts b/scripts/release/build-bundles.ts
@@ -172,6 +172,7 @@ const buildBundle = async (input: ReleaseBundlePackageSpec): Promise<void> => {
       ? normalizeWorkspaceDependencies(input.optionalDependencies)
       : undefined,
     peerDependencies: input.peerDependencies ?? sourcePkg.peerDependencies,
+    scripts: input.scripts,
     engines: sourcePkg.engines ?? { bun: ">=1.3.10" },
     os: sourcePkg.os,
     cpu: sourcePkg.cpu,
diff --git a/scripts/release/release-bundles.test.ts b/scripts/release/release-bundles.test.ts
@@ -72,6 +72,7 @@ describe("Feature: release bundle contract", () => {
 
     expect(specs).toEqual(createReleaseBundlePackageSpecs());
     expect(specs.map((spec) => spec.bundlePackageDir)).toEqual([
+      "bundle/agenter",
       "bundle/agenter-app-shell",
       "bundle/agenter-app-studio",
       "bundle/@jixo/ghostty-native",
@@ -90,13 +91,14 @@ describe("Feature: release bundle contract", () => {
       "bundle/@jixo/ghostty-native-win32-arm64-msvc",
       "bundle/@jixo/ghostty-native-win32-x64-msvc",
       "bundle/@jixo/ghostty-native",
+      "bundle/agenter",
       "bundle/agenter-app-shell",
       "bundle/agenter-app-studio",
     ]);
     expect(releasePackagePublishOrder).toEqual(releasePublishOrder);
     expect(releasePackagePublishOrder).toContain("packages/agenter-cli-darwin-arm64");
-    expect(releasePackagePublishOrder).toContain("packages/agenter");
-    expect(releasePackagePublishOrder).not.toContain("bundle/agenter");
+    expect(releasePackagePublishOrder).toContain("bundle/agenter");
+    expect(releasePackagePublishOrder).not.toContain("packages/agenter");
   });
 
   test("Scenario: Given a maintainer wants local release validation When host-only smoke is selected Then only the current host platform bundle is staged under a separate smoke root", () => {
@@ -113,6 +115,7 @@ describe("Feature: release bundle contract", () => {
       "bun run scripts/release/build-bundles.ts --host-only-smoke",
     );
     expect(bundleDirs).toEqual([
+      "bundle-host-smoke/agenter",
       "bundle-host-smoke/agenter-app-shell",
       "bundle-host-smoke/agenter-app-studio",
       "bundle-host-smoke/@jixo/ghostty-native",
@@ -140,14 +143,15 @@ describe("Feature: release bundle contract", () => {
     expect(buildScript).not.toContain('"@agenter/auth-service", "build:native"');
   });
 
-  test("Scenario: Given agenter shifted to wrapper-plus-platform binaries When inspecting release metadata Then no JS bundle pretends to be the public CLI runtime", () => {
+  test("Scenario: Given agenter shifted to wrapper-plus-platform binaries When inspecting release metadata Then the public npm wrapper is published from an explicit bundle projection", () => {
     const manifest = readRepoFile("scripts/release/release-manifest.ts");
     const packageJson = JSON.parse(readRepoFile("package.json")) as {
       scripts?: Record<string, string>;
     };
 
-    expect(createBundlePackageSpecs().find((spec) => spec.bundlePackageDir === "bundle/agenter")).toBeUndefined();
-    expect(releasePackagePublishOrder).toContain("packages/agenter");
+    expect(createBundlePackageSpecs().find((spec) => spec.bundlePackageDir === "bundle/agenter")).toBeDefined();
+    expect(releasePackagePublishOrder).toContain("bundle/agenter");
+    expect(releasePackagePublishOrder).not.toContain("packages/agenter");
     expect(releasePackagePublishOrder).toContain("packages/agenter-cli-win32-x64");
     expect(packageJson.scripts?.["release:build-native-cli-archives"]).toBe(
       "bun run scripts/release/build-agenter-release-archives.ts --input-dir native-artifacts --output-dir release-archives/agenter-cli",
@@ -162,6 +166,7 @@ describe("Feature: release bundle contract", () => {
       "bun run release:build-bundles && bun run release:prepare-native-cli-packages",
     );
     expect(manifest).not.toContain('"@duckdb/node-api"');
+    expect(manifest).toContain('bundlePackageDir: "bundle/agenter"');
   });
 
   test("Scenario: Given the public agenter package is wrapper-first When inspecting wrapper and launcher sources Then reflect metadata stays with the internal launcher path", () => {
@@ -188,6 +193,26 @@ describe("Feature: release bundle contract", () => {
     expect(cliPkg.dependencies?.["reflect-metadata"]).toBe("^0.2.2");
   });
 
+  test("Scenario: Given agenter publishes through the release bundle projection When inspecting release metadata Then workspace protocols are resolved before npm sees the wrapper package", () => {
+    const specs = createBundlePackageSpecs();
+    const agenterSpec = specs.find((spec) => spec.bundlePackageDir === "bundle/agenter");
+    const buildScript = readRepoFile("scripts/release/build-bundles.ts");
+
+    expect(agenterSpec?.sourcePackageDir).toBe("packages/agenter");
+    expect(agenterSpec?.scripts).toEqual({ postinstall: "node ./install.cjs" });
+    expect(agenterSpec?.optionalDependencies?.["@jixoai/cli-darwin-arm64"]).toBe("workspace:*");
+    expect(agenterSpec?.assets?.map((asset) => asset.to)).toEqual([
+      "CHANGELOG.md",
+      "SPEC.md",
+      "bin",
+      "cli-wrapper.cjs",
+      "install.cjs",
+      "native-platform.cjs",
+    ]);
+    expect(buildScript).toContain("scripts: input.scripts");
+    expect(buildScript).toContain("releaseBundleManifestFiles.filter");
+  });
+
   test("Scenario: Given npm daemon start forks a background child When inspecting the CLI source Then it reuses the current executable entrypoint", () => {
     const cliSource = readRepoFile("packages/cli/src/run-cli.ts");
     const selfExecSource = readRepoFile("packages/cli/src/self-exec.ts");
@@ -404,7 +429,9 @@ describe("Feature: release bundle contract", () => {
     expect(preflightScript).toContain("release:build-bundles");
     expect(preflightScript).not.toContain("audit-app-platform-vocabulary");
     expect(verifyScript).toContain("releasePublishOrder");
-    expect(verifyScript).toContain("npm");
+    expect(verifyScript).toContain('"npm"');
+    expect(verifyScript).toContain('"--json"');
+    expect(verifyScript).not.toContain('"version",');
     expect(verifyScript).toContain("peerDependencies");
     expect(verifyScript).toContain("optionalDependencies");
   });
diff --git a/scripts/release/release-manifest.ts b/scripts/release/release-manifest.ts
@@ -13,6 +13,7 @@ export interface ReleasePackageJson {
   dependencies?: Record<string, string>;
   optionalDependencies?: Record<string, string>;
   peerDependencies?: Record<string, string>;
+  scripts?: Record<string, string>;
   engines?: Record<string, string>;
   publishConfig?: Record<string, string>;
   os?: string[];
@@ -41,6 +42,7 @@ export interface ReleaseBundlePackageSpec {
   dependencies?: Record<string, string>;
   optionalDependencies?: Record<string, string>;
   peerDependencies?: Record<string, string>;
+  scripts?: Record<string, string>;
   external?: string[];
   assets?: ReleaseBundleAssetSpec[];
   bundledAssetsRoot?: boolean;
@@ -56,6 +58,11 @@ export const releaseRepositoryUrl = "git+https://github.com/jixoai/agenter.git";
 export const opentuiNativePackageVersion = "0.3.0";
 
 export const releaseBundleManifestFiles = [
+  "CHANGELOG.md",
+  "SPEC.md",
+  "cli-wrapper.cjs",
+  "install.cjs",
+  "native-platform.cjs",
   "bin",
   "dist",
   "assets",
@@ -93,6 +100,23 @@ export const createReleaseBundlePackageSpecs = (): ReleaseBundlePackageSpec[] =>
   }));
 
   return [
+    {
+      sourcePackageDir: "packages/agenter",
+      bundlePackageDir: "bundle/agenter",
+      // packages/agenter stays as workspace truth. The publish truth that npm
+      // sees is this generated bundle projection, so workspace:* never leaks
+      // into the public wrapper manifest.
+      scripts: { postinstall: "node ./install.cjs" },
+      optionalDependencies: Object.fromEntries(agenterCliTargets.map((target) => [target.packageName, "workspace:*"])),
+      assets: [
+        { from: "packages/agenter/CHANGELOG.md", to: "CHANGELOG.md" },
+        { from: "packages/agenter/SPEC.md", to: "SPEC.md" },
+        { from: "packages/agenter/bin", to: "bin" },
+        { from: "packages/agenter/cli-wrapper.cjs", to: "cli-wrapper.cjs" },
+        { from: "packages/agenter/install.cjs", to: "install.cjs" },
+        { from: "packages/agenter/native-platform.cjs", to: "native-platform.cjs" },
+      ],
+    },
     {
       sourcePackageDir: "apps/shell",
       bundlePackageDir: "bundle/agenter-app-shell",
@@ -145,6 +169,7 @@ export const releaseBundlePublishOrder = [
   "bundle/@jixo/ghostty-native-win32-arm64-msvc",
   "bundle/@jixo/ghostty-native-win32-x64-msvc",
   "bundle/@jixo/ghostty-native",
+  "bundle/agenter",
   "bundle/agenter-app-shell",
   "bundle/agenter-app-studio",
 ] as const;
@@ -158,7 +183,7 @@ export const releasePublishOrder: readonly string[] = [
   "bundle/@jixo/ghostty-native-win32-x64-msvc",
   "bundle/@jixo/ghostty-native",
   ...agenterCliTargets.map((target) => target.packageDir),
-  "packages/agenter",
+  "bundle/agenter",
   "bundle/agenter-app-shell",
   "bundle/agenter-app-studio",
 ];
diff --git a/scripts/release/verify-published.ts b/scripts/release/verify-published.ts
@@ -39,11 +39,6 @@ const runNpmView = async (name: string, version: string): Promise<NpmViewPayload
       "npm",
       "view",
       `${name}@${version}`,
-      "version",
-      "bin",
-      "dependencies",
-      "optionalDependencies",
-      "peerDependencies",
       "--json",
     ],
     stdout: "pipe",
@@ -57,7 +52,8 @@ const runNpmView = async (name: string, version: string): Promise<NpmViewPayload
   if (exitCode !== 0) {
     throw new Error(`npm view failed for ${name}@${version}: ${stderr.trim()}`);
   }
-  return JSON.parse(stdout) as NpmViewPayload;
+  const payload = JSON.parse(stdout) as NpmViewPayload | string;
+  return typeof payload === "string" ? { version: payload } : payload;
 };
 
 const verifyPackage = async (packageDir: string): Promise<void> => {

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-darwin-arm64",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for darwin arm64",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-darwin-x64",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for darwin x64",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-linux-arm64-gnu",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for linux arm64 glibc",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-linux-arm64-musl",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for linux arm64 musl",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-linux-x64-gnu",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for linux x64 glibc",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-linux-x64-musl",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for linux x64 musl",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-win32-arm64",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for win32 arm64",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@jixoai/cli-win32-x64",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"description": "Prebuilt Agenter CLI for win32 x64",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"repository": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "agenter",`
`3`		`- "version": "0.0.10",`
	`3`	`+ "version": "0.0.11",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"repository": {`
`6`	`6`	`"type": "git",`