@peers-app/peers-ui 0.18.3 → 0.18.4

package/dist/screens/packages/package-info.js

@@ -106,7 +106,7 @@ const PackageInfo = (props) => {
                                             peers_sdk_1.rpcServerCalls.openPackage(localPath || peers_sdk_1.packagesRootDir);
                                         }, children: "Open Local" })] })] }), (0, jsx_runtime_1.jsx)("input", { type: "text", className: "form-control mb-3 p-0 ps-2", placeholder: "~/peers/packages/my-package", value: localPath || "", onChange: (e) => setLocalPath(e.target.value) })] }), remoteRepoUrl ? ((0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Source URL:", (0, jsx_runtime_1.jsxs)("small", { children: [(0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: `The remote source of this package.  Often a github repository URL or a link to the Peers page for the package.` }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-link", onClick: () => {
                                             peers_sdk_1.rpcServerCalls.openLinkInBrowser(remoteRepoUrl);
-                                        }, children: "Open Remote" })] })] }), (0, jsx_runtime_1.jsx)(input_1.Input, { value: pkg.qs.remoteRepo, className: "form-control mb-3 p-0 ps-2", disabled: true })] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsx)("hr", {}), (0, jsx_runtime_1.jsxs)("small", { children: ["Version:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "The currently active version of this package. Manage versions in the Versions tab." })] }), activeVersion ? ((0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center mt-1 mb-3", children: [(0, jsx_runtime_1.jsxs)("strong", { className: "me-2", children: ["v", activeVersion.version] }), activeVersion.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ${activeVersion.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-info"} me-2`, children: activeVersion.versionTag })), (0, jsx_runtime_1.jsx)("code", { className: "text-muted small me-2", children: activeVersion.packageVersionHash?.substring(0, 8) }), newerLevel === "uptodate" ? ((0, jsx_runtime_1.jsx)("span", { className: "badge text-bg-success", children: "Up to date" })) : newerLevel ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge text-bg-${newerLevel === "major" ? "danger" : newerLevel === "minor" ? "warning" : "info"}`, children: ["Newer ", newerLevel, " version available"] })) : null] })) : ((0, jsx_runtime_1.jsx)("div", { className: "text-muted small mt-1 mb-3", children: "No active version" })), (0, jsx_runtime_1.jsxs)("div", { className: "mb-3", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Auto-Update Range:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "Controls which new versions are auto-activated. **Pinned** = never auto-update. **Patch** = same major.minor (e.g. 1.2.x). **Minor** = same major (e.g. 1.x.x). **Latest** = always auto-update to newest." })] }), (0, jsx_runtime_1.jsxs)("select", { className: "form-select form-select-sm", value: versionFollowRange || "latest", onChange: (e) => {
+                                        }, children: "Open Remote" })] })] }), (0, jsx_runtime_1.jsx)(input_1.Input, { value: pkg.qs.remoteRepo, className: "form-control mb-3 p-0 ps-2", disabled: true })] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsx)("hr", {}), (0, jsx_runtime_1.jsxs)("small", { children: ["Version:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "The currently active version of this package. Manage versions in the Versions tab." })] }), activeVersion ? ((0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center mt-1 mb-3", children: [(0, jsx_runtime_1.jsxs)("strong", { className: "me-2", children: ["v", activeVersion.version] }), activeVersion.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ${activeVersion.versionTag === "dev" ? "text-bg-danger" : activeVersion.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-success"} me-2`, children: activeVersion.versionTag })), (0, jsx_runtime_1.jsx)("code", { className: "text-muted small me-2", children: activeVersion.packageVersionHash?.substring(0, 8) }), newerLevel === "uptodate" ? ((0, jsx_runtime_1.jsx)("span", { className: "badge text-bg-success", children: "Up to date" })) : newerLevel ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge text-bg-${newerLevel === "major" ? "danger" : newerLevel === "minor" ? "warning" : "info"}`, children: ["Newer ", newerLevel, " version available"] })) : null] })) : ((0, jsx_runtime_1.jsx)("div", { className: "text-muted small mt-1 mb-3", children: "No active version" })), (0, jsx_runtime_1.jsxs)("div", { className: "mb-3", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Auto-Update Range:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "Controls which new versions are auto-activated. **Pinned** = never auto-update. **Patch** = same major.minor (e.g. 1.2.x). **Minor** = same major (e.g. 1.x.x). **Latest** = always auto-update to newest." })] }), (0, jsx_runtime_1.jsxs)("select", { className: "form-select form-select-sm", value: versionFollowRange || "latest", onChange: (e) => {
                                     const val = e.target.value;
                                     pkg.versionFollowRange = val === "latest" ? undefined : val;
                                 }, children: [(0, jsx_runtime_1.jsx)("option", { value: "latest", children: "Latest (auto-update to newest)" }), (0, jsx_runtime_1.jsx)("option", { value: "minor", children: "Minor (same major version)" }), (0, jsx_runtime_1.jsx)("option", { value: "patch", children: "Patch (same major.minor version)" }), (0, jsx_runtime_1.jsx)("option", { value: "pinned", children: "Pinned (no auto-updates)" })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: `mb-3 ${isPinned ? "opacity-50" : ""}`, children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Follow Version Tags:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "Which version tags to auto-activate. Leave empty for **current** (follows the active version's tag). Use `*` for any tag, or a comma-separated list like `stable,prod`." })] }), (0, jsx_runtime_1.jsx)(input_1.Input, { value: pkg.qs.followVersionTags, className: "form-control form-control-sm p-0 ps-2", placeholder: `Following "${activeVersion?.versionTag || "stable"}"`, disabled: isPinned })] }), (0, jsx_runtime_1.jsxs)("div", { className: "mb-2", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Device-Specific Version Tag:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "Override the tag policy for this device only. For example, set to `beta` to test pre-release versions on this device without affecting other devices or group members. This is not synced." })] }), (0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center gap-2", children: [(0, jsx_runtime_1.jsx)("input", { type: "text", className: "form-control form-control-sm p-0 ps-2", placeholder: "e.g. beta", value: deviceTagDraft, onChange: (e) => setDeviceTagDraft(e.target.value) }), deviceTagDraft && ((0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-secondary", title: "Clear device tag override", onClick: () => setDeviceTagDraft(""), children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-x-lg" }) }))] })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsx)("hr", {}), (0, jsx_runtime_1.jsxs)("small", { children: ["Description:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: `This should be edited in the package's README.md.  It will automatically update when you restart Peers or reload the package.` })] }), (0, jsx_runtime_1.jsx)(markdown_with_mentions_1.MarkdownWithMentions, { content: pkg.description || "" })] })] }));

package/dist/screens/packages/package-list.js

@@ -55,7 +55,7 @@ const PackageVersionBadge = ({ activePackageVersionId, packageId, followVersionT
     if (!data)
         return null;
     const { pv, newerLevel } = data;
-    return ((0, jsx_runtime_1.jsxs)("span", { className: "ms-2", children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["v", pv.version] }), pv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ms-1 ${pv.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-info"}`, style: { fontSize: "0.65em" }, children: pv.versionTag })), newerLevel ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge ms-1 text-bg-${newerLevel === "major" ? "danger" : newerLevel === "minor" ? "warning" : "info"}`, style: { fontSize: "0.65em" }, children: [newerLevel, " update"] })) : ((0, jsx_runtime_1.jsx)("span", { className: "badge ms-1 text-bg-success", style: { fontSize: "0.65em" }, children: "up to date" }))] }));
+    return ((0, jsx_runtime_1.jsxs)("span", { className: "ms-2", children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["v", pv.version] }), pv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ms-1 ${pv.versionTag === "dev" ? "text-bg-danger" : pv.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-success"}`, style: { fontSize: "0.65em" }, children: pv.versionTag })), newerLevel ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge ms-1 text-bg-${newerLevel === "major" ? "danger" : newerLevel === "minor" ? "warning" : "info"}`, style: { fontSize: "0.65em" }, children: [newerLevel, " update"] })) : ((0, jsx_runtime_1.jsx)("span", { className: "badge ms-1 text-bg-success", style: { fontSize: "0.65em" }, children: "up to date" }))] }));
 };
 const PackageList = () => {
     const [searchTextObs] = (0, react_1.useState)(() => (0, peers_sdk_1.observable)(""));

package/dist/screens/packages/package-versions.js

@@ -30,10 +30,12 @@ function formatDate(iso) {
 function tagBadgeClass(tag) {
     if (!tag)
         return "text-bg-secondary";
+    if (tag === "dev")
+        return "text-bg-danger";
     if (tag.startsWith("beta"))
         return "text-bg-warning";
     if (tag === "stable")
-        return "text-bg-info";
+        return "text-bg-success";
     return "text-bg-secondary";
 }
 const PackageVersionsList = (props) => {
@@ -106,8 +108,16 @@ const PackageVersionsList = (props) => {
     }
     async function promoteVersion(pv, newTag) {
         try {
+            const me = await (0, peers_sdk_1.getMe)();
+            const history = [...(pv.history ?? [])];
+            history.push({
+                action: `promoted:${newTag}`,
+                by: me.userId,
+                at: new Date().toISOString(),
+                signature: "",
+            });
             const pvHash = (0, peers_sdk_1.computePackageVersionHash)(pv.version, newTag, pv.packageBundleFileHash, pv.routesBundleFileHash, pv.uiBundleFileHash);
-            const updated = { ...pv, versionTag: newTag, packageVersionHash: pvHash };
+            const updated = { ...pv, versionTag: newTag, packageVersionHash: pvHash, history };
             await (0, peers_sdk_1.PackageVersions)().signAndSave(updated, { saveAsSnapshot: true });
             refreshKey(refreshKey() + 1);
         }
@@ -117,7 +127,7 @@ const PackageVersionsList = (props) => {
     }
     async function updateVersion(pv, newSemver) {
         try {
-            const pvHash = (0, peers_sdk_1.computePackageVersionHash)(newSemver, pv.versionTag || "beta", pv.packageBundleFileHash, pv.routesBundleFileHash, pv.uiBundleFileHash);
+            const pvHash = (0, peers_sdk_1.computePackageVersionHash)(newSemver, pv.versionTag || "dev", pv.packageBundleFileHash, pv.routesBundleFileHash, pv.uiBundleFileHash);
             const updated = { ...pv, version: newSemver, packageVersionHash: pvHash };
             await (0, peers_sdk_1.PackageVersions)().signAndSave(updated, { saveAsSnapshot: true });
             refreshKey(refreshKey() + 1);
@@ -153,7 +163,20 @@ const PackageVersionsList = (props) => {
     return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: [sorted.length, " version", sorted.length !== 1 ? "s" : ""] }), (0, jsx_runtime_1.jsx)("div", { className: "list-group mt-2", children: sorted.map((pv) => ((0, jsx_runtime_1.jsx)(VersionRow, { pv: pv, isActive: pv.packageVersionId === activeVersionId, isPinned: isPinned, pinning: pinning, activating: activating, deleting: deleting, userMap: userMap, onActivate: activateVersion, onDelete: deleteVersion, onPin: pinVersion, onPromote: promoteVersion, onUpdateVersion: updateVersion }, pv.packageVersionId))) })] }));
 };
 exports.PackageVersionsList = PackageVersionsList;
-const TAG_OPTIONS = ["beta", "stable"];
+/**
+ * Valid promotion targets for each version tag. Promotion only moves forward:
+ * dev -> beta -> stable. No demotions allowed.
+ */
+function getPromoteTargets(currentTag) {
+    switch (currentTag) {
+        case "dev":
+            return ["beta", "stable"];
+        case "beta":
+            return ["stable"];
+        default:
+            return [];
+    }
+}
 function VersionRow(props) {
     const { pv, isActive, isPinned, pinning, activating, deleting, userMap } = props;
     const creatorName = userMap.get(pv.createdBy);
@@ -170,12 +193,12 @@ function VersionRow(props) {
         }
         setEditingVersion(false);
     }
-    const currentTag = pv.versionTag || "beta";
-    const promoteTargets = TAG_OPTIONS.filter((t) => t !== currentTag);
+    const currentTag = pv.versionTag || "dev";
+    const promoteTargets = getPromoteTargets(currentTag);
     return ((0, jsx_runtime_1.jsx)("div", { className: `list-group-item ${isActive ? "list-group-item-success" : ""}`, children: (0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center justify-content-between", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center flex-wrap", children: [editingVersion ? ((0, jsx_runtime_1.jsx)("input", { type: "text", className: "form-control form-control-sm me-2", style: { width: "7em" }, value: versionDraft, onChange: (e) => setVersionDraft(e.target.value), onBlur: commitVersion, onKeyDown: (e) => {
                                 if (e.key === "Enter")
                                     commitVersion();
                                 if (e.key === "Escape")
                                     setEditingVersion(false);
-                            } })) : ((0, jsx_runtime_1.jsxs)("strong", { className: "me-2", style: { cursor: "pointer" }, onClick: startEditing, title: "Click to edit version", children: ["v", pv.version] })), pv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ${tagBadgeClass(pv.versionTag)} me-2`, children: pv.versionTag })), (0, jsx_runtime_1.jsx)("code", { className: "text-muted small me-2", children: pv.packageVersionHash?.substring(0, 8) }), (0, jsx_runtime_1.jsx)("small", { className: "text-muted me-2", children: formatDate(pv.createdAt) }), creatorName && (0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["by ", creatorName] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "d-flex gap-1 align-items-center", children: [promoteTargets.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "dropdown", children: [(0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-info dropdown-toggle", "data-bs-toggle": "dropdown", title: "Change version tag", children: "Promote" }), (0, jsx_runtime_1.jsx)("ul", { className: "dropdown-menu dropdown-menu-end", children: promoteTargets.map((tag) => ((0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsxs)("button", { className: "dropdown-item", onClick: () => props.onPromote(pv, tag), children: [currentTag, " \u2192 ", tag] }) }, tag))) })] })), isActive ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-secondary", disabled: isPinned || pinning, onClick: () => props.onPin(), title: isPinned ? "Already pinned" : "Pin to this version (disable auto-updates)", children: [pinning ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-pin-fill" })), isPinned ? " Pinned" : " Pin"] }), (0, jsx_runtime_1.jsx)("span", { className: "badge text-bg-success align-self-center", children: "active" })] })) : ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-primary", disabled: activating === pv.packageVersionId, onClick: () => props.onActivate(pv), children: [activating === pv.packageVersionId ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-check2-circle me-1" })), "Activate"] })), !isActive && ((0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-danger", disabled: deleting === pv.packageVersionId, onClick: () => props.onDelete(pv), children: deleting === pv.packageVersionId ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-trash" })) }))] })] }) }));
+                            } })) : ((0, jsx_runtime_1.jsxs)("strong", { className: "me-2", style: { cursor: "pointer" }, onClick: startEditing, title: "Click to edit version", children: ["v", pv.version] })), pv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ${tagBadgeClass(pv.versionTag)} me-2`, children: pv.versionTag })), (0, jsx_runtime_1.jsx)("code", { className: "text-muted small me-2", children: pv.packageVersionHash?.substring(0, 8) }), (0, jsx_runtime_1.jsx)("small", { className: "text-muted me-2", children: formatDate(pv.createdAt) }), creatorName && (0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["by ", creatorName] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "d-flex gap-1 align-items-center", children: [promoteTargets.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "dropdown", children: [(0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-info dropdown-toggle", "data-bs-toggle": "dropdown", title: "Change version tag", children: "Promote" }), (0, jsx_runtime_1.jsx)("ul", { className: "dropdown-menu dropdown-menu-end", children: promoteTargets.map((tag) => ((0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsxs)("button", { className: "dropdown-item", onClick: () => props.onPromote(pv, tag), children: [currentTag, " \u2192 ", tag] }) }, tag))) })] })), isActive ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-secondary", disabled: isPinned || pinning, onClick: () => props.onPin(), title: isPinned ? "Already pinned" : "Pin to this version (disable auto-updates)", children: [pinning ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-pin-fill" })), isPinned ? " Pinned" : " Pin"] }), (0, jsx_runtime_1.jsx)("span", { className: "badge text-bg-info align-self-center", children: "active" })] })) : ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-primary", disabled: activating === pv.packageVersionId, onClick: () => props.onActivate(pv), children: [activating === pv.packageVersionId ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-check2-circle me-1" })), "Activate"] })), !isActive && ((0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-danger", disabled: deleting === pv.packageVersionId, onClick: () => props.onDelete(pv), children: deleting === pv.packageVersionId ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-trash" })) }))] })] }) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-ui",
-  "version": "0.18.3",
+  "version": "0.18.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-ui.git"
@@ -28,7 +28,7 @@
     "lint:fix": "biome check --write ."
   },
   "peerDependencies": {
-    "@peers-app/peers-sdk": "^0.18.3",
+    "@peers-app/peers-sdk": "^0.18.4",
     "bootstrap": "^5.3.3",
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
@@ -39,7 +39,7 @@
     "@babel/preset-env": "^7.24.5",
     "@babel/preset-react": "^7.24.1",
     "@babel/preset-typescript": "^7.27.1",
-    "@peers-app/peers-sdk": "0.18.3",
+    "@peers-app/peers-sdk": "0.18.4",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",

package/src/screens/packages/package-info.tsx

@@ -189,7 +189,7 @@ export const PackageInfo = (props: {
             <strong className="me-2">v{activeVersion.version}</strong>
             {activeVersion.versionTag && (
               <span
-                className={`badge ${activeVersion.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-info"} me-2`}
+                className={`badge ${activeVersion.versionTag === "dev" ? "text-bg-danger" : activeVersion.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-success"} me-2`}
               >
                 {activeVersion.versionTag}
               </span>

package/src/screens/packages/package-list.tsx

@@ -80,7 +80,7 @@ const PackageVersionBadge = ({
       <small className="text-muted">v{pv.version}</small>
       {pv.versionTag && (
         <span
-          className={`badge ms-1 ${pv.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-info"}`}
+          className={`badge ms-1 ${pv.versionTag === "dev" ? "text-bg-danger" : pv.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-success"}`}
           style={{ fontSize: "0.65em" }}
         >
           {pv.versionTag}

package/src/screens/packages/package-versions.tsx

@@ -1,5 +1,6 @@
 import {
   computePackageVersionHash,
+  getMe,
   type IDoc,
   type IPackage,
   type IPackageVersion,
@@ -30,8 +31,9 @@ function formatDate(iso: string): string {
 
 function tagBadgeClass(tag?: string): string {
   if (!tag) return "text-bg-secondary";
+  if (tag === "dev") return "text-bg-danger";
   if (tag.startsWith("beta")) return "text-bg-warning";
-  if (tag === "stable") return "text-bg-info";
+  if (tag === "stable") return "text-bg-success";
   return "text-bg-secondary";
 }
 
@@ -106,6 +108,14 @@ export const PackageVersionsList = (props: { pkg: IDoc<IPackage> }) => {
 
   async function promoteVersion(pv: IPackageVersion, newTag: string) {
     try {
+      const me = await getMe();
+      const history = [...(pv.history ?? [])];
+      history.push({
+        action: `promoted:${newTag}`,
+        by: me.userId,
+        at: new Date().toISOString(),
+        signature: "",
+      });
       const pvHash = computePackageVersionHash(
         pv.version,
         newTag,
@@ -113,7 +123,7 @@ export const PackageVersionsList = (props: { pkg: IDoc<IPackage> }) => {
         pv.routesBundleFileHash,
         pv.uiBundleFileHash,
       );
-      const updated = { ...pv, versionTag: newTag, packageVersionHash: pvHash };
+      const updated = { ...pv, versionTag: newTag, packageVersionHash: pvHash, history };
       await PackageVersions().signAndSave(updated, { saveAsSnapshot: true });
       refreshKey(refreshKey() + 1);
     } catch (err) {
@@ -125,7 +135,7 @@ export const PackageVersionsList = (props: { pkg: IDoc<IPackage> }) => {
     try {
       const pvHash = computePackageVersionHash(
         newSemver,
-        pv.versionTag || "beta",
+        pv.versionTag || "dev",
         pv.packageBundleFileHash,
         pv.routesBundleFileHash,
         pv.uiBundleFileHash,
@@ -201,7 +211,20 @@ export const PackageVersionsList = (props: { pkg: IDoc<IPackage> }) => {
   );
 };
 
-const TAG_OPTIONS = ["beta", "stable"];
+/**
+ * Valid promotion targets for each version tag. Promotion only moves forward:
+ * dev -> beta -> stable. No demotions allowed.
+ */
+function getPromoteTargets(currentTag?: string): string[] {
+  switch (currentTag) {
+    case "dev":
+      return ["beta", "stable"];
+    case "beta":
+      return ["stable"];
+    default:
+      return [];
+  }
+}
 
 function VersionRow(props: {
   pv: IPackageVersion;
@@ -235,8 +258,8 @@ function VersionRow(props: {
     setEditingVersion(false);
   }
 
-  const currentTag = pv.versionTag || "beta";
-  const promoteTargets = TAG_OPTIONS.filter((t) => t !== currentTag);
+  const currentTag = pv.versionTag || "dev";
+  const promoteTargets = getPromoteTargets(currentTag);
 
   return (
     <div className={`list-group-item ${isActive ? "list-group-item-success" : ""}`}>
@@ -308,7 +331,7 @@ function VersionRow(props: {
                 )}
                 {isPinned ? " Pinned" : " Pin"}
               </button>
-              <span className="badge text-bg-success align-self-center">active</span>
+              <span className="badge text-bg-info align-self-center">active</span>
             </>
           ) : (
             <button