@caelo-cms/shared 0.10.66 → 0.10.67

package/dist/cloud-shell-install.d.ts

@@ -5,15 +5,12 @@ export declare const CLOUD_SHELL_BUTTON_IMAGE = "https://gstatic.com/cloudssh/im
 /** Providers the Cloud Shell install covers (one tutorial each). */
 export type CloudShellProvider = "gcp" | "gcp-firebase";
 /**
- * The Cloud Shell install link for a stable release.
+ * The Cloud Shell install link: always the newest stable release.
  *
- * @throws for a pre-release or non-SemVer version — only stable releases
- *   get a `release-v<version>` branch in the install repository
- *
- * @example cloudShellInstallUrl("0.10.47", "gcp")
- *   // → "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=release-v0.10.47&cloudshell_tutorial=gcp.md"
+ * @example cloudShellInstallUrl("gcp")
+ *   // → "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=main&cloudshell_tutorial=gcp.md"
  */
-export declare function cloudShellInstallUrl(version: string, provider: CloudShellProvider): string;
+export declare function cloudShellInstallUrl(provider: CloudShellProvider): string;
 /**
  * The first release whose `release-v<version>` branch in the install
  * repository ships the break-glass upgrade (#816): `upgrade-gcp.md`,

package/dist/cloud-shell-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-shell-install.d.ts","sourceRoot":"","sources":["../src/cloud-shell-install.ts"],"names":[],"mappings":"AAeA,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,yCAAyC,CAAC;AAE/E,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,qDAAqD,CAAC;AAE3F,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,cAAc,CAAC;AAIxD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAa1F;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iCAAiC,YAAY,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAUjG;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAOT"}
+{"version":3,"file":"cloud-shell-install.d.ts","sourceRoot":"","sources":["../src/cloud-shell-install.ts"],"names":[],"mappings":"AAiBA,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,yCAAyC,CAAC;AAE/E,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,qDAAqD,CAAC;AAE3F,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,cAAc,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAOzE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iCAAiC,YAAY,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAUjG;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAOT"}

package/dist/cloud-shell-install.js

@@ -1,13 +1,15 @@
 // SPDX-License-Identifier: MPL-2.0
 /**
- * The "Open in Google Cloud Shell" install link (epic #696, Phase 3).
+ * The "Open in Google Cloud Shell" links (epic #696, Phase 3).
  *
- * The link opens github.com/caelo-cms/install on the `release-v<version>`
- * branch that repository's track-release workflow creates for every stable
- * release (and never moves), with the provider's walkthrough tutorial. Its
- * `run.sh` pins and verifies exactly that release of the provisioner. One
- * builder for every place that shows the link — README, docs, and the
- * admin's "run this release in Cloud Shell" hint — so they can't drift.
+ * The INSTALL link names no version: it opens github.com/caelo-cms/install
+ * on `main`, whose `run.sh` resolves the newest stable release itself (npm
+ * `latest`) and verifies it before anything runs, so the link is right for
+ * every release and never moves. The UPGRADE link names one target release:
+ * it opens that release's `release-v<version>` branch (created by the
+ * install repository's track-release workflow, never moved), and `run.sh`
+ * there takes the version from the branch name. One builder per link for
+ * every place that shows it, so they can't drift.
  */
 import { isNewerVersion } from "./version.js";
 /** The repository the Cloud Shell button clones. */
@@ -16,23 +18,16 @@ export const CLOUD_SHELL_INSTALL_REPO = "https://github.com/caelo-cms/install";
 export const CLOUD_SHELL_BUTTON_IMAGE = "https://gstatic.com/cloudssh/images/open-btn.svg";
 const STABLE = /^v?(\d+\.\d+\.\d+)$/;
 /**
- * The Cloud Shell install link for a stable release.
+ * The Cloud Shell install link: always the newest stable release.
  *
- * @throws for a pre-release or non-SemVer version — only stable releases
- *   get a `release-v<version>` branch in the install repository
- *
- * @example cloudShellInstallUrl("0.10.47", "gcp")
- *   // → "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=release-v0.10.47&cloudshell_tutorial=gcp.md"
+ * @example cloudShellInstallUrl("gcp")
+ *   // → "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=main&cloudshell_tutorial=gcp.md"
  */
-export function cloudShellInstallUrl(version, provider) {
-    const m = STABLE.exec(version);
-    if (!m) {
-        throw new Error(`no Cloud Shell install link for "${version}": only stable releases are pinned in ${CLOUD_SHELL_INSTALL_REPO}`);
-    }
+export function cloudShellInstallUrl(provider) {
     return [
         "https://shell.cloud.google.com/cloudshell/editor",
         `?cloudshell_git_repo=${CLOUD_SHELL_INSTALL_REPO}`,
-        `&cloudshell_git_branch=release-v${m[1]}`,
+        "&cloudshell_git_branch=main",
         `&cloudshell_tutorial=${provider}.md`,
     ].join("");
 }

package/dist/cloud-shell-install.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-shell-install.js","sourceRoot":"","sources":["../src/cloud-shell-install.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,sCAAsC,CAAC;AAE/E,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,kDAAkD,CAAC;AAK3F,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,QAA4B;IAChF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,oCAAoC,OAAO,yCAAyC,wBAAwB,EAAE,CAC/G,CAAC;IACJ,CAAC;IACD,OAAO;QACL,kDAAkD;QAClD,wBAAwB,wBAAwB,EAAE;QAClD,mCAAmC,CAAC,CAAC,CAAC,CAAC,EAAE;QACzC,wBAAwB,QAAQ,KAAK;KACtC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,QAA4B;IAChF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,cAAc,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO;QACL,kDAAkD;QAClD,wBAAwB,wBAAwB,EAAE;QAClD,mCAAmC,CAAC,CAAC,CAAC,CAAC,EAAE;QACzC,gCAAgC,QAAQ,KAAK;KAC9C,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAGxC;IACC,OAAO;QACL,kBAAkB;QAClB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,WAAW;QACX,MAAM,CAAC,OAAO;KACf,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"cloud-shell-install.js","sourceRoot":"","sources":["../src/cloud-shell-install.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,sCAAsC,CAAC;AAE/E,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,kDAAkD,CAAC;AAK3F,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAA4B;IAC/D,OAAO;QACL,kDAAkD;QAClD,wBAAwB,wBAAwB,EAAE;QAClD,6BAA6B;QAC7B,wBAAwB,QAAQ,KAAK;KACtC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,QAA4B;IAChF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,cAAc,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO;QACL,kDAAkD;QAClD,wBAAwB,wBAAwB,EAAE;QAClD,mCAAmC,CAAC,CAAC,CAAC,CAAC,EAAE;QACzC,gCAAgC,QAAQ,KAAK;KAC9C,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAGxC;IACC,OAAO;QACL,kBAAkB;QAClB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,WAAW;QACX,MAAM,CAAC,OAAO;KACf,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}

package/dist/version.d.ts

@@ -19,7 +19,7 @@
  * Format: SemVer 2.0.0. Pre-1.0 minor bumps are breaking; post-1.0
  * follow standard SemVer.
  */
-export declare const CAELO_VERSION = "0.10.66";
+export declare const CAELO_VERSION = "0.10.67";
 /**
  * Deprecated alias for back-compat — early P17 work spelled this
  * `CALEO_VERSION` (typo of "Caelo"). New code should import
@@ -31,7 +31,7 @@ export declare const CAELO_VERSION = "0.10.66";
  *
  * @deprecated use CAELO_VERSION
  */
-export declare const CALEO_VERSION = "0.10.66";
+export declare const CALEO_VERSION = "0.10.67";
 /**
  * Parsed shape — major/minor/patch + optional pre-release tag.
  * Stable interface for callers that need to feature-gate (rare —

package/dist/version.js

@@ -20,7 +20,7 @@
  * Format: SemVer 2.0.0. Pre-1.0 minor bumps are breaking; post-1.0
  * follow standard SemVer.
  */
-export const CAELO_VERSION = "0.10.66";
+export const CAELO_VERSION = "0.10.67";
 /**
  * Deprecated alias for back-compat — early P17 work spelled this
  * `CALEO_VERSION` (typo of "Caelo"). New code should import

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caelo-cms/shared",
-  "version": "0.10.66",
+  "version": "0.10.67",
   "private": false,
   "license": "MPL-2.0",
   "description": "Shared Zod schemas + types + the two-pass HTML composer used by every Caelo CMS workspace package. Stable enough for plugin authors and embedders to depend on directly.",

package/src/cloud-shell-install.test.ts

@@ -9,19 +9,14 @@ import {
 } from "./cloud-shell-install.js";
 
 describe("cloudShellInstallUrl", () => {
-  it("pins the release branch of the install repo and the provider's tutorial", () => {
-    expect(cloudShellInstallUrl("0.10.47", "gcp")).toBe(
-      "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=release-v0.10.47&cloudshell_tutorial=gcp.md",
+  it("names no version: the install repo's main installs the newest release", () => {
+    expect(cloudShellInstallUrl("gcp")).toBe(
+      "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=main&cloudshell_tutorial=gcp.md",
     );
-    expect(cloudShellInstallUrl("v1.2.3", "gcp-firebase")).toContain(
-      "cloudshell_git_branch=release-v1.2.3&cloudshell_tutorial=gcp-firebase.md",
+    expect(cloudShellInstallUrl("gcp-firebase")).toContain(
+      "cloudshell_git_branch=main&cloudshell_tutorial=gcp-firebase.md",
     );
   });
-
-  it("refuses pre-releases and garbage: they have no pinned branch", () => {
-    expect(() => cloudShellInstallUrl("0.11.0-rc.1", "gcp")).toThrow(/only stable releases/);
-    expect(() => cloudShellInstallUrl("latest", "gcp")).toThrow();
-  });
 });
 
 describe("cloudShellUpgradeUrl (#816)", () => {

package/src/cloud-shell-install.ts

@@ -1,14 +1,16 @@
 // SPDX-License-Identifier: MPL-2.0
 
 /**
- * The "Open in Google Cloud Shell" install link (epic #696, Phase 3).
+ * The "Open in Google Cloud Shell" links (epic #696, Phase 3).
  *
- * The link opens github.com/caelo-cms/install on the `release-v<version>`
- * branch that repository's track-release workflow creates for every stable
- * release (and never moves), with the provider's walkthrough tutorial. Its
- * `run.sh` pins and verifies exactly that release of the provisioner. One
- * builder for every place that shows the link — README, docs, and the
- * admin's "run this release in Cloud Shell" hint — so they can't drift.
+ * The INSTALL link names no version: it opens github.com/caelo-cms/install
+ * on `main`, whose `run.sh` resolves the newest stable release itself (npm
+ * `latest`) and verifies it before anything runs, so the link is right for
+ * every release and never moves. The UPGRADE link names one target release:
+ * it opens that release's `release-v<version>` branch (created by the
+ * install repository's track-release workflow, never moved), and `run.sh`
+ * there takes the version from the branch name. One builder per link for
+ * every place that shows it, so they can't drift.
  */
 
 import { isNewerVersion } from "./version.js";
@@ -25,25 +27,16 @@ export type CloudShellProvider = "gcp" | "gcp-firebase";
 const STABLE = /^v?(\d+\.\d+\.\d+)$/;
 
 /**
- * The Cloud Shell install link for a stable release.
+ * The Cloud Shell install link: always the newest stable release.
  *
- * @throws for a pre-release or non-SemVer version — only stable releases
- *   get a `release-v<version>` branch in the install repository
- *
- * @example cloudShellInstallUrl("0.10.47", "gcp")
- *   // → "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=release-v0.10.47&cloudshell_tutorial=gcp.md"
+ * @example cloudShellInstallUrl("gcp")
+ *   // → "https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/caelo-cms/install&cloudshell_git_branch=main&cloudshell_tutorial=gcp.md"
  */
-export function cloudShellInstallUrl(version: string, provider: CloudShellProvider): string {
-  const m = STABLE.exec(version);
-  if (!m) {
-    throw new Error(
-      `no Cloud Shell install link for "${version}": only stable releases are pinned in ${CLOUD_SHELL_INSTALL_REPO}`,
-    );
-  }
+export function cloudShellInstallUrl(provider: CloudShellProvider): string {
   return [
     "https://shell.cloud.google.com/cloudshell/editor",
     `?cloudshell_git_repo=${CLOUD_SHELL_INSTALL_REPO}`,
-    `&cloudshell_git_branch=release-v${m[1]}`,
+    "&cloudshell_git_branch=main",
     `&cloudshell_tutorial=${provider}.md`,
   ].join("");
 }

package/src/version.ts

@@ -22,7 +22,7 @@
  * follow standard SemVer.
  */
 
-export const CAELO_VERSION = "0.10.66";
+export const CAELO_VERSION = "0.10.67";
 
 /**
  * Deprecated alias for back-compat — early P17 work spelled this