Use release tag names instead of commit SHAs for extension updates and specific version installs

- Refactor the update mechanism to pass the release tag name instead of the commit SHA from the extension down to `install.sh` and `install.ps1`, updating the `UpdateInfo` type, `update_extension` function, both install scripts to run `git checkout <tag_name>`, and all associated VS Code commands to supply the tag.

├── .github
│   └── workflows
│       └── github-release.yml
├── apps
│   └── editor
│       ├── package.json
│       └── src
│           ├── commands
│           │   ├── check-for-updates-command.ts
│           │   └── install-specific-version-command.ts
│           ├── extension.ts
│           ├── utils
│           │   ├── check-for-updates.ts
│           │   └── update-extension.ts
│           └── views
│               └── prompt
│                   ├── backend
│                   │   ├── message-handlers
│                   │   │   └── handle-update-extension.ts
│                   │   └── prompt-view-provider.ts
│                   ├── frontend
│                   │   └── Home
│                   │       └── Home.tsx
│                   └── types
│                       └── messages.ts
├── install.ps1
└── install.sh

Author: robertpiosik

apps/editor/src/commands/check-for-updates-command.ts

@@ -17,9 +17,9 @@ export const check_for_updates_command = (
         )
 
         if (action === t('command.check-for-updates-command.action.update')) {
-          if (prompt_view_provider.update_info.latest_version_sha) {
+          if (prompt_view_provider.update_info.latest_version_tag) {
             update_extension({
-              commit_sha: prompt_view_provider.update_info.latest_version_sha
+              tag_name: prompt_view_provider.update_info.latest_version_tag
             })
           }
         }

apps/editor/src/commands/install-specific-version-command.ts

@@ -113,7 +113,6 @@ export const install_specific_version_command = () => {
           label: version,
           description,
           tag: tag.name,
-          sha: tag.commit?.sha,
           buttons: [
             {
               iconPath: new vscode.ThemeIcon('globe'),
@@ -126,7 +125,7 @@ export const install_specific_version_command = () => {
       })
 
       const quick_pick = vscode.window.createQuickPick<
-        vscode.QuickPickItem & { tag: string; sha?: string }
+        vscode.QuickPickItem & { tag: string }
       >()
       quick_pick.title = t('command.install-specific-version-command.title')
       quick_pick.placeholder = t(
@@ -159,9 +158,9 @@ export const install_specific_version_command = () => {
 
       quick_pick.onDidAccept(() => {
         const selected = quick_pick.selectedItems[0]
-        if (selected && selected.sha) {
+        if (selected && selected.tag) {
           quick_pick.hide()
-          update_extension({ commit_sha: selected.sha })
+          update_extension({ tag_name: selected.tag })
         }
       })
 

apps/editor/src/utils/check-for-updates.ts

@@ -56,7 +56,7 @@ export const check_for_updates = async (
           return {
             is_available: true,
             latest_version,
-            latest_version_sha: vscode_tag.commit?.sha,
+            latest_version_tag: vscode_tag.name,
             current_version_age_days: age_days
           }
         } else {

apps/editor/src/utils/update-extension.ts

@@ -1,7 +1,7 @@
 import * as vscode from 'vscode'
 import * as os from 'os'
 
-export const update_extension = (params: { commit_sha: string }) => {
+export const update_extension = (params: { tag_name: string }) => {
   const terminal = vscode.window.createTerminal('CWC Updater')
   terminal.show()
 
@@ -10,11 +10,11 @@ export const update_extension = (params: { commit_sha: string }) => {
 
   if (os.platform() === 'win32') {
     terminal.sendText(
-      `powershell -c "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/CodeWebChat/CWC/main/install.ps1))) '${uri_scheme}' '${lang}' '${params.commit_sha}'"`
+      `powershell -c "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/CodeWebChat/CWC/main/install.ps1))) '${uri_scheme}' '${lang}' '${params.tag_name}'"`
     )
   } else {
     terminal.sendText(
-      `curl -fsSL https://raw.githubusercontent.com/CodeWebChat/CWC/main/install.sh | bash -s -- "${uri_scheme}" "${lang}" "${params.commit_sha}"`
+      `curl -fsSL https://raw.githubusercontent.com/CodeWebChat/CWC/main/install.sh | bash -s -- "${uri_scheme}" "${lang}" "${params.tag_name}"`
     )
   }
 }

apps/editor/src/views/prompt/backend/message-handlers/handle-update-extension.ts

@@ -4,9 +4,9 @@ import { PromptViewProvider } from '../prompt-view-provider'
 export const handle_update_extension = (
   prompt_view_provider: PromptViewProvider
 ) => {
-  if (prompt_view_provider.update_info.latest_version_sha) {
+  if (prompt_view_provider.update_info.latest_version_tag) {
     update_extension({
-      commit_sha: prompt_view_provider.update_info.latest_version_sha
+      tag_name: prompt_view_provider.update_info.latest_version_tag
     })
   }
 }

apps/editor/src/views/prompt/types/messages.ts

@@ -458,7 +458,7 @@ export interface SaveTasksMessage extends BaseMessage {
 export type UpdateInfo = {
   is_available: boolean
   latest_version?: string
-  latest_version_sha?: string
+  latest_version_tag?: string
   current_version_age_days?: number
 }
 

install.ps1

@@ -2,7 +2,7 @@ $ErrorActionPreference = "Stop"
 $ProgressPreference = "SilentlyContinue"
 $targetScheme = $args[0]
 $lang = $args[1]
-$commitSha = $args[2]
+$tagName = $args[2]
 
 $msg_error="Error:"
 $msg_git_required="git is required but not installed."
@@ -486,8 +486,8 @@ foreach ($i in $indices) {
         $updated = Invoke-Step "$msg_step_cloning..." {
             git -C $repoDir fetch origin --quiet *>$null
             if ($LASTEXITCODE -ne 0) { throw "Failed to fetch" }
-            if ($commitSha) {
-                git -C $repoDir checkout $commitSha --quiet *>$null
+            if ($tagName) {
+                git -C $repoDir checkout $tagName --quiet *>$null
                 if ($LASTEXITCODE -ne 0) { throw "Failed to checkout" }
             } else {
                 git -C $repoDir reset --hard origin/main --quiet *>$null
@@ -505,8 +505,8 @@ foreach ($i in $indices) {
         $null = Invoke-Step "$msg_step_cloning..." {
             git clone -c core.longpaths=true --quiet https://github.com/CodeWebChat/CWC.git $repoDir *>$null
             if ($LASTEXITCODE -ne 0) { throw "Failed to clone" }
-            if ($commitSha) {
-                git -C $repoDir checkout $commitSha --quiet *>$null
+            if ($tagName) {
+                git -C $repoDir checkout $tagName --quiet *>$null
                 if ($LASTEXITCODE -ne 0) { throw "Failed to checkout" }
             }
         } $msg_step_cloning

install.sh

@@ -3,7 +3,7 @@ set -e
 
 TARGET_SCHEME="$1"
 LANGUAGE="${2:-en}"
-COMMIT_SHA="$3"
+TAG_NAME="$3"
 
 msg_error="Error:"
 msg_git_required="git is required but not installed."
@@ -489,8 +489,8 @@ chmod 700 "$CWC_DIR" 2>/dev/null || true
 
 update_repo() {
   git -C "$REPO_DIR" fetch origin --quiet && \
-  if [ -n "$COMMIT_SHA" ]; then
-    git -C "$REPO_DIR" checkout "$COMMIT_SHA" --quiet
+  if [ -n "$TAG_NAME" ]; then
+    git -C "$REPO_DIR" checkout "$TAG_NAME" --quiet
   else
     git -C "$REPO_DIR" reset --hard origin/main --quiet
   fi && \
@@ -499,8 +499,8 @@ update_repo() {
 
 clone_repo() {
   git clone -c core.longpaths=true --quiet https://github.com/CodeWebChat/CWC.git "$REPO_DIR" && \
-  if [ -n "$COMMIT_SHA" ]; then
-    git -C "$REPO_DIR" checkout "$COMMIT_SHA" --quiet
+  if [ -n "$TAG_NAME" ]; then
+    git -C "$REPO_DIR" checkout "$TAG_NAME" --quiet
   fi
 }