Feature/vscode extension build (#171)

* VSCode extension detects and uses emulator executable installed in system path (via package manager).

* In VSCode extension, if emulator and/or cc65 tool chain are not available in system path, extension no shows notification with instruction.

* Build and relase VSCode extension to the VSCode Marketplace.

* Update VSCode extension doc

Author: highbyte

.github/workflows/dotnet-avalonia-app-publish-to-gh-pages.yml

@@ -9,7 +9,7 @@ on:
   #Trigger when tag is created
   push:
     tags:
-        - 'v*.*.*'
+        - 'v[0-9]*.[0-9]*.[0-9]*'
 
 # Prevent concurrent deployments to GitHub Pages
 concurrency:

.github/workflows/dotnet-blazor-app-publish-to-gh-pages.yml

@@ -9,7 +9,7 @@ on:
   #Trigger when tag is created
   push:
     tags:
-        - 'v*.*.*'
+        - 'v[0-9]*.[0-9]*.[0-9]*'
 
 # Prevent concurrent deployments to GitHub Pages
 concurrency:

.github/workflows/dotnet-push-package.yml

@@ -4,7 +4,7 @@ on:
   #Trigger when tag is created
   push:
       tags:
-          - 'v*.*.*'
+          - 'v[0-9]*.[0-9]*.[0-9]*'
 env:
    PROJECT_FILE: "src/libraries/Highbyte.DotNet6502/Highbyte.DotNet6502.csproj"
   #  PROJECT_FILE2: "src/libraries/Highbyte.DotNet6502.Systems/Highbyte.DotNet6502.Systems.csproj"

.github/workflows/release-desktop-apps.yml

@@ -12,6 +12,7 @@ on:
 jobs:
   build-and-upload:
     runs-on: ubuntu-latest
+    if: ${{ !startsWith(github.ref, 'refs/tags/vscode-') }}
     permissions:
       contents: write
 

.github/workflows/release-vscode-extension.yml

@@ -0,0 +1,66 @@
+# Triggered when a git tag matching vscode-v* is pushed (e.g. vscode-v1.0.0 or vscode-v1.0.0-beta).
+# Extracts the version from the tag, patches package.json, and publishes to the VSCode Marketplace.
+# Any tag version with a pre-release suffix (e.g. -alpha, -beta) is published as a pre-release.
+# The VSCode Marketplace only accepts major.minor.patch, so the suffix is stripped from package.json
+# but used to determine whether to pass --pre-release to vsce.
+#
+# Requires a VSCE_PAT secret configured in GitHub repo settings:
+#   Azure DevOps -> User Settings -> Personal Access Tokens -> scope: Marketplace (Manage)
+name: Release VSCode Extension
+
+on:
+  push:
+    tags:
+      - 'vscode-v*'
+
+  # Allow manual triggering for testing (will publish with the provided version)
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g. 1.0.0 or 1.0.0-beta)'
+        required: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Extract version from tag or input
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "VERSION=${{ github.event.inputs.version }}" >> $GITHUB_ENV
+          else
+            echo "VERSION=${GITHUB_REF#refs/tags/vscode-v}" >> $GITHUB_ENV
+          fi
+
+      - name: Determine if pre-release and strip suffix for package.json
+        run: |
+          if [[ "${{ env.VERSION }}" == *"-"* ]]; then
+            echo "PRE_RELEASE=--pre-release" >> $GITHUB_ENV
+            echo "PACKAGE_VERSION=$(echo "${{ env.VERSION }}" | cut -d'-' -f1)" >> $GITHUB_ENV
+          else
+            echo "PRE_RELEASE=" >> $GITHUB_ENV
+            echo "PACKAGE_VERSION=${{ env.VERSION }}" >> $GITHUB_ENV
+          fi
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        working-directory: tools/vscode-extension
+        run: npm install --ignore-scripts
+
+      - name: Set version in package.json
+        working-directory: tools/vscode-extension
+        run: npm version ${{ env.PACKAGE_VERSION }} --no-git-tag-version
+
+      - name: Publish to VSCode Marketplace
+        working-directory: tools/vscode-extension
+        run: npx vsce publish ${{ env.PRE_RELEASE }} --no-git-tag-version
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Highbyte
+Copyright (c) 2021 - 2026 Highbyte
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

tools/vscode-extension-test/samples/smooth_scroller_and_raster2.dbg

@@ -1,8 +1,8 @@
 version	major=2,minor=0
 info	csym=0,file=698,lib=1,line=289,mod=2,scope=5,seg=7,span=537,sym=80,type=4
-file	id=0,name="smooth_scroller_and_raster2.asm",size=10681,mtime=0x699C5A08,mod=0
-file	id=1,name="smooth_scroller_and_raster2_init.asm",size=509,mtime=0x698F0C33,mod=0
-file	id=2,name="smooth_scroller_and_raster2_data.asm",size=3099,mtime=0x6995A297,mod=0
+file	id=0,name="smooth_scroller_and_raster2.asm",size=10681,mtime=0x69B41818,mod=0
+file	id=1,name="smooth_scroller_and_raster2_init.asm",size=509,mtime=0x69B41818,mod=0
+file	id=2,name="smooth_scroller_and_raster2_data.asm",size=3099,mtime=0x69B41818,mod=0
 file	id=3,name="cbm/loadaddr.s",size=399,mtime=0x5ED2ADF3,mod=1
 lib	id=0,name="/opt/homebrew/Cellar/cc65/2.19/share/cc65/lib/c64.lib"
 line	id=0,file=0,line=204

tools/vscode-extension-test/samples/smooth_scroller_and_raster2.o

@@ -8,3 +8,11 @@ vsc-extension-quickstart.md
 **/.eslintrc.json
 **/*.map
 **/*.ts
+publish.sh
+publish.ps1
+publish/
+PUBLISH.md
+IMPLEMENTATION.md
+GENERATE_BUILD_TASK.md
+node_modules/@vscode/debugadapter/lib/tests/
+KNOWN-ISSUES.md

tools/vscode-extension/.vscodeignore

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to the **6502 Debugger for dotnet-6502** VSCode extension will be documented here.
+
+## [Unreleased]
+
+## [0.1.2] - 2026-03-28
+No extension change, release workflow updated.
+
+## [0.1.1] - 2026-03-28
+
+### Changed
+- First automated release via GitHub workflow
+- Tweaks to README.md and extensions .vsix contents.
+ 
+## [0.1.0] - 2026-03-27
+
+### Added
+- Initial release of the VSCode extension
+- Debug adapter integration for debugging 6502 assembly programs using the dotnet-6502 emulator
+- Support for launch (minimal and emulator modes) and attach debug configurations
+- Source-level debugging for ca65 `.dbg` files, including multi-component `.dbg` file merging
+- Memory viewer panel during debug sessions
+- Jump to Line (Set PC) command via editor line number context menu
+- Auto-detection of program file from pre-launch task output
+- Skip-over-interrupt support when stepping (IRQ/NMI handlers)
+- Generate build task and launch config commands via explorer context menu for `.asm` and `.prg` files
+- Assembly language configuration for `.asm` files (syntax, breakpoints)
+- Dependency checking for cc65 and dotnet-6502 executables in PATH, with install instructions