From 194e80f30ce1d437cae77e44528975a79205e2bf Mon Sep 17 00:00:00 2001
From: Lewis <lewis@tangled.org>
Date: Thu, 7 May 2026 18:54:35 +0300
Subject: [PATCH] appview,knotserver: 1.14 deploy prep

Lewis: May this revision serve well! <lewis@tangled.org>
---
 appview/db/db.go                               |  7 +++++++
 appview/pages/templates/repo/needsUpgrade.html |  5 +++++
 .../pages/templates/repo/settings/general.html |  4 ++--
 docs/DOCS.md                                   | 16 ++++++++++++++++
 knotserver/xrpc/version.go                     | 18 +++++-------------
 nix/pkgs/knot-unwrapped.nix                    |  2 +-
 6 files changed, 36 insertions(+), 16 deletions(-)

diff --git a/appview/db/db.go b/appview/db/db.go
index 9b817989..ba0ed3cd 100644
--- a/appview/db/db.go
+++ b/appview/db/db.go
@@ -1949,6 +1949,13 @@ func Make(ctx context.Context, dbPath string) (*DB, error) {
 	})
 	conn.ExecContext(ctx, "pragma foreign_keys = on;")
 
+	orm.RunMigration(conn, logger, "migrate-knots-to-repo-did-rename", func(tx *sql.Tx) error {
+		_, err := tx.Exec(`
+			update registrations set needs_upgrade = 1;
+		`)
+		return err
+	})
+
 	return &DB{
 		db,
 		logger,
diff --git a/appview/pages/templates/repo/needsUpgrade.html b/appview/pages/templates/repo/needsUpgrade.html
index f905967b..c1679598 100644
--- a/appview/pages/templates/repo/needsUpgrade.html
+++ b/appview/pages/templates/repo/needsUpgrade.html
@@ -53,6 +53,11 @@
         <div class="text-center">
           {{ i "triangle-alert" "size-5 inline-flex items-center align-middle" }}
           The knot hosting this repository needs an upgrade. This repository is currently unavailable.
+          <div class="mt-2">
+            <a class="underline" href="https://docs.tangled.org/migrating-knots-and-spindles.html">
+              Read the upgrade guide
+            </a>
+          </div>
         </div>
       </div>
     </div>
diff --git a/appview/pages/templates/repo/settings/general.html b/appview/pages/templates/repo/settings/general.html
index b7bb8a94..3a410f51 100644
--- a/appview/pages/templates/repo/settings/general.html
+++ b/appview/pages/templates/repo/settings/general.html
@@ -217,7 +217,7 @@
 
 {{ define "renameRepo" }}
   {{ if and .RepoInfo.Roles.IsOwner .RepoInfo.RepoDid }}
-  <form hx-post="/{{ $.RepoInfo.FullName }}/settings/rename" hx-swap="none">
+  <form hx-post="/{{ $.RepoInfo.FullName }}/settings/rename" hx-swap="none" class="group">
     <h2 class="text-sm pb-2 uppercase font-bold">Rename Repository</h2>
     <p class="text-gray-500 dark:text-gray-400 mb-2">
       Existing git remotes that use the old name will break. Use the
@@ -239,7 +239,7 @@
     <div class="flex justify-end pt-2">
       <button
         type="submit"
-        class="btn flex items-center gap-2 group"
+        class="btn flex items-center gap-2"
       >
         {{ i "pencil" "w-4 h-4" }}
         rename
diff --git a/docs/DOCS.md b/docs/DOCS.md
index 9ca100b1..f17f3fa8 100644
--- a/docs/DOCS.md
+++ b/docs/DOCS.md
@@ -1500,6 +1500,22 @@ This document is laid out in reverse-chronological order.
 Newer migration guides are listed first, and older guides
 are further down the page.
 
+## Upgrading to v1.14.0-alpha
+
+Starting with v1.14.0-alpha, the fully knot uses the repoDID as its
+canonical handle for repositories. This unlocks repository
+renames from the appview UI and changes the wire format for
+the following lexicons (`sh.tangled.repo.pull`, `sh.tangled.repo.collaborator`,
+`sh.tangled.repo.issue`, `sh.tangled.git.refUpdate`).
+
+Knots that have not been upgraded may silently drop new push
+events, pull requests, issues, and collaborator invites for
+repositories they host until upgraded. So upgrade please!!!
+
+- Upgrade to the latest tag (v1.14.0 or above)
+- Head to the [knot dashboard](https://tangled.org/settings/knots) and
+  hit the "retry" button to verify your knot
+
 ## Upgrading to v1.13.0-alpha
 
 Starting with v1.13.0-alpha, every repository on a knot is
diff --git a/knotserver/xrpc/version.go b/knotserver/xrpc/version.go
index 89fa9623..2e4c6591 100644
--- a/knotserver/xrpc/version.go
+++ b/knotserver/xrpc/version.go
@@ -19,17 +19,13 @@ func (x *Xrpc) Version(w http.ResponseWriter, r *http.Request) {
 			return
 		}
 
-		var modVer string
-		var sha string
-		var modified bool
-
-		for _, mod := range info.Deps {
-			if mod.Path == "tangled.org/tangled.org/knotserver/xrpc" {
-				modVer = mod.Version
-				break
-			}
+		modVer := info.Main.Version
+		if modVer == "" || modVer == "(devel)" {
+			modVer = "(devel)"
 		}
 
+		var sha string
+		var modified bool
 		for _, setting := range info.Settings {
 			switch setting.Key {
 			case "vcs.revision":
@@ -39,10 +35,6 @@ func (x *Xrpc) Version(w http.ResponseWriter, r *http.Request) {
 			}
 		}
 
-		if modVer == "" {
-			modVer = "unknown"
-		}
-
 		if sha == "" {
 			version = modVer
 		} else if modified {
diff --git a/nix/pkgs/knot-unwrapped.nix b/nix/pkgs/knot-unwrapped.nix
index 36837244..f9101a42 100644
--- a/nix/pkgs/knot-unwrapped.nix
+++ b/nix/pkgs/knot-unwrapped.nix
@@ -4,7 +4,7 @@
   sqlite-lib,
   src,
 }: let
-  version = "1.13.0-alpha";
+  version = "1.14.0-alpha";
 in
   buildGoApplication {
     pname = "knot";
-- 
2.51.2