Merge branch 'main' into check-links

soumeh01 · web-flow · commit 709d83ecf19a · 2026-03-31T12:28:37.000+02:00
diff --git a/.devcontainer/ubuntu-24.04/.npmrc b/.devcontainer/ubuntu-24.04/.npmrc
@@ -1,2 +1,2 @@
-@arm-debug:registry=https://npm.pkg.github.com
+@open-cmsis-pack:registry=https://npm.pkg.github.com
 //npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -1,44 +1,20 @@
 name: Bug Report
-description: Report a bug
-title: "[Bug]: "
+description: File a bug/issue
+title: "<title>"
 type: "Bug"
-projects: ""
-labels: []
-assignees: []
+projects:
+  - Open-CMSIS-Pack/24
 
 body:
-  - type: markdown
-    attributes:
-      value: "### Thank you for reporting a problem!"
-
   - type: textarea
     id: description
     attributes:
-      label: "Description"
+      label: "Current behavior, Steps to reproduce and Expected behavior"
       description: "Provide details about the bug."
-      placeholder: "Explain the unexpected behavior in detail."
+      placeholder: "Explain the unexpected behavior, steps to reproduce and expected behavior..."
     validations:
       required: true
 
-  - type: textarea
-    id: steps
-    attributes:
-      label: "Steps to Reproduce"
-      description: "List the steps to reproduce the bug."
-      placeholder: |
-        1. Go to '...'
-        2. Click on '...'
-        3. See error"
-    validations:
-      required: false
-
-  - type: textarea
-    id: expected_behavior
-    attributes:
-      label: "Expected Behavior"
-      description: "What should happen instead?"
-      placeholder: "Describe what you expected to happen."
-
   - type: textarea
     id: additional_info
     attributes:
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -77,6 +77,7 @@ jobs:
         run: npm run build
 
       - name: Update current version
+        if: github.event_name != 'release'
         run: |
           # Increment patch version by 1 (e.g. 1.64.1 -> 1.64.2)
           BASE_VERSION=$(node -p "require('./package.json').version.split('-')[0]")
@@ -102,12 +103,12 @@ jobs:
           # Get short commit SHA
           SHORT_SHA=$(git rev-parse --short HEAD)
 
-          # Create nightly version: 1.64.2-12-abc1234
-          NIGHTLY_VERSION="${NEXT_PATCH_VERSION}-${COMMIT_COUNT}-${SHORT_SHA}"
-          echo "Setting version to ${NIGHTLY_VERSION}"
+          # Create PR version: 1.64.2-12-abc1234
+          PR_VERSION="${NEXT_PATCH_VERSION}-${COMMIT_COUNT}-${SHORT_SHA}"
+          echo "Setting version to ${PR_VERSION}"
 
           # Update package.json
-          npm version "${NIGHTLY_VERSION}" --no-git-tag-version
+          npm version "${PR_VERSION}" --no-git-tag-version
 
       - name: Remove badges
         run: |
@@ -314,20 +315,6 @@ jobs:
           pattern: unit-test-coverage
           path: test-coverage
 
-      - name: Download test report
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          pattern: test-report-linux
-          path: test-report-linux
-
-      - name: Zip test report
-        run: zip -r test-report.zip *
-        working-directory: test-report-linux
-
-      - name: Zip test coverage
-        run: zip -r test-coverage.zip *
-        working-directory: test-coverage
-         
       - name: Attach packages
         uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2.6.1
         with:
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,21 @@
 # Change Log
 
-## [Unreleased]
+## 1.67.0
+
+- Updates:
+  - Minimum required version of VS Code for using this extension is **^1.108.1**.
+  - **CMSIS View** resolves [access sequences](https://open-cmsis-pack.github.io/cmsis-toolbox/YML-Input-Format/#access-sequences) used in file references and opens the corresponding physical file on click.
+  - Extended support for file links in editor windows for [CMSIS Solution Project](https://open-cmsis-pack.github.io/cmsis-toolbox/YML-Input-Format/#project-file-structure) and [build information](https://open-cmsis-pack.github.io/cmsis-toolbox/YML-CBuild-Format) files.
+  - Extended solution conversion diagnostics to collect and surface errors and warnings from orchestrated tools (cpackget, cbuild, cbuild2cmake, csolution) in the VS Code Problems view. Messages are removed from the status bar tooltip.
+  - Solution conversion is now skipped if missing packs are detected but cannot be downloaded and installed by the pack installer `cpackget`.
+  - Added `Config File` option in Debug Adapter for Arm-FVP to open the specified file.
+
+- Solved issues:
+  - **CMSIS View** does not load and display CMSIS Solution files without `projects:` node which is the case for debug only setups.
+  - **Software Components** does not reliably open the initial view for the selected layer.
+  - **Manage Solution** dialog target-type handling breaks in case the corresponding node is changed in `*.csolution.yml` on disk.
+  - `uVision option` in Debug Adapter for Keil uVision stores absolute filepath.
+  
 
 ## 1.66.0
 
diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
@@ -33,22 +33,20 @@ In short, run this command from the extracted directory on the Arm network:
 ## Running the extension in development
 
 1. To download the tools, you must have a `GITHUB_TOKEN` environment variable containing a
-   personal access token. This must have the `repo` scope and SSO enabled for the Arm-Debug
-   organization.
+   personal access token.
 
-2. In order to install dependencies, you must have npm configured to access the Arm-Debug registry
-   for packages that are scoped with `@arm-debug`. Edit your global .npmrc file, and add the
+2. In order to install dependencies, Edit your global .npmrc file, and add the
    following to it:
 
     ```txt
-    @arm-debug:registry=https://npm.pkg.github.com
+    @open-cmsis-pack:registry=https://npm.pkg.github.com
     //npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
     ```
 
     This assumes a `GITHUB_TOKEN` environment variable is exported in your environment. This needs
     to be a GitHub personal access token with the `read:packages` scope set on it.
 
-3. Install NPM dependencies, Core Tools and build the TypeScript
+3. Install NPM dependencies and build the TypeScript
 
     ```sh
     npm install
@@ -171,18 +169,6 @@ when running in development mode.
 Before running a release, check the following:
 
 1. Tools and schemas integrated into the extension packages according to `package.json`
-   - CoreTools version referenced by the dependency (see `dependencies` section)
-
-     `"@arm-debug/cmsis-core-tools-client": "<version>"`
-
-     `version` must match a [CoreTools release](https://github.com/Arm-Debug/cmsis-core-tools/tags)
-
-   - uv2csolution version referenced in `csolution` section
-
-     `"uv2csolutionVersion": "<version>"`
-
-     `<version>` must match a [uvprojx-converter release](https://github.com/Arm-Debug/uvprojx-converter/releases)
-
    - schema version referenced in `csolution` section
 
      `"schemaVersion": "<version>"`
@@ -198,59 +184,32 @@ Before running a release, check the following:
 
 4. [Release Assessment](https://armh.sharepoint.com/sites/pwa/PJ1000480/SitePages/Assessments.aspx) for `CMSIS Solution Extension` is approved.
 
-### Release workflow
+## Release versioning
 
-Use GitHub Actions workflow dispatch to trigger a release:
+This repository follows the VS Code Marketplace pre-release recommendation:
 
-1. Navigate to <https://github.com/Arm-Debug/vscode-cmsis-csolution/actions/workflows/ci.yml>,
-   then click "Run workflow"
-2. Select the main branch
-3. Select type of new version, e.g. 'Minor'
-4. Select "Skip public publishing jobs' if the version should be created on GitHub but NOT being
-   published to Marketplace
-5. Click "Run workflow"
+- **Odd** minor versions (`x.1.z`, `x.3.z`, ...) are pre-releases.
+- **Even** minor versions (`x.0.z`, `x.2.z`, ...) are full releases.
 
-Notes
+To enforce this consistently, both packaging and publishing use `scripts/package.ts`, which:
 
-- When 'Pre-release' is selected, the version is either:
-  - incremented according the latest published pre-release (patch +1), if it is greater than the current version
-  - incremented according the the current version, newMinorVersion is always an odd number (including 0), e.g. 0,1,3,...
-- When 'Major', 'Minor' or 'Patch' is selected, the version will be increased and the new version
-  number will be committed to package.json. If a second release is triggered, it will also be
-  increased, regardless of being pushed to marketplace or not.
-- 'Major' increments major version
-- 'Minor' increments to an even number, e.g. 0,2,4,...
-- 'Patch' increments patch version
-- see [vscode-actions](https://github.com/Arm-Debug/vscode-actions/blob/main/calculate-new-version/src/bump-version.ts)
+- checks the current `package.json` version minor value.
+- automatically adds `--pre-release` to `vsce package` for odd minor versions.
 
-Github actions will then
+Use the following commands:
 
-- Bump the versions in the package.json files
-- Add the new version to the CHANGELOG.md, and move all changes listed under "Unreleased" to the new version.
-- Commit and push the version and changelog updates
-- Build the VSIX package
-- Create a GitHub release with the VSIX package
-- Publish the package on [Open VSX](https://open-vsx.org/extension/arm/cmsis-csolution) and [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Arm.cmsis-csolution)
-- Publish the API types to the Arm-Debug GitHub Packages npm registry
-- Sync the docs to [ARM-software/vscode-cmsis-csolution](https://github.com/ARM-software/vscode-cmsis-csolution)
-
-After publishing, check that the new version is installable in VSCode and docs for the new version
-have been synced to Arm-Software.
-
-### Publishing to VS Code Marketplace
-
-The marketplace access token is controlled by the [DSG-OTG](https://dev.azure.com/DSG-OTG)
-organization in Azure. It is available in CI as an Arm-Debug GitHub organization secret. This must
-be rotated every 90 days.
-
-See the documentation for publishing extensions:
-<https://code.visualstudio.com/api/working-with-extensions/publishing-extension>
+```sh
+> npm run package [--target <target>]
+```
 
-### Publishing Open-VSX
+### Release Workflow
 
-The arm namespace Open-VSX is accessible from your [user settings](https://open-vsx.org/user-settings)
-when your GitHub account has been linked to the arm namespace. An access token is stored as an
-Arm-Debug GitHub organization secret.
+1. Ensure the version in `package.json` is up to date.
+2. Update the `CHANGELOG` with the latest changes.
+3. Open a pull request with these updates and merge it into `main`.
+4. Create a new release at: https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/releases
+   - This will trigger the `CI.yml` workflow.  
+   - Once the workflow completes successfully, the release artifacts will be generated automatically.
 
 ## Debugging in KSC
 
diff --git a/README.md b/README.md
@@ -53,7 +53,7 @@ Action buttons allow you to build, run, and debug your application, [edit *csolu
 
 The **CMSIS** view displays the name of the current *csolution project* and offers several action buttons.
 
-![Action buttons](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/ActionButtons.png)
+![Action buttons](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/ActionButtons.png)
 
 | Action | Description |
 |--------|-------------|
@@ -69,7 +69,7 @@ The **CMSIS** view displays the name of the current *csolution project* and offe
 
 ## Create Solution view
 
-![Create Solution](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/CreateNewSolution.png)
+![Create Solution](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/CreateNewSolution.png)
 
 To start a new *csolution project*, select a [board](https://www.keil.arm.com/boards/) or [device](https://www.keil.arm.com/devices/) and choose from the following project types:
 
@@ -82,33 +82,33 @@ Then create the *csolution project* on the selected folder on your Host computer
 
 ## Configure Solution view
 
-![Configure Solution](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/ConfigureSolution.png)
+![Configure Solution](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/ConfigureSolution.png)
 
 When using a [reference application](https://open-cmsis-pack.github.io/cmsis-toolbox/ReferenceApplications/) select compatible software layers for your solution from this view.
 
 ## Software Components view
 
-![Software Components](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/SoftwareComponents.png)
+![Software Components](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/SoftwareComponents.png)
 
 Select reusable software components for your application from this view.
 
 [CMSIS-Packs](https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/index.html) provide software components with other optional items such as configuration files, documentation, and user code templates. A software component typically interfaces with other software components or with device peripherals. The list of software components depends on the device or board selected.
 
 ## Manage Solution view
 
-![Manage Solution](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/ManageSolution.png)
+![Manage Solution](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/ManageSolution.png)
 
 Select the [target](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#target-production-hardware) and configure [related projects](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#configure-related-projects) for your application from this view. A Target Set stores settings for projects, images and debug adapter. You might need different build types or load settings, for example to reduce the debug overhead. Refer also to [Run and Debug](#run-and-debug) below.
 
 ## Configuration Wizard
 
-![Configuration Wizard](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/ConfigWizard.png)
+![Configuration Wizard](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/ConfigWizard.png)
 
 Many configuration files have annotations for the [CMSIS Configuration Wizard](https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/configWizard.html). Using the **Open Preview** button in the editor allows you to modify options in a graphical view.
 
 ## YML Editor Support
 
-![YML Editor Support](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/SyntaxYML.png)
+![YML Editor Support](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/raw/main/docs/images/SyntaxYML.png)
 
 The YML syntax support in the editor detects errors, provides auto completion, and documentation links on hover over.
 
@@ -138,4 +138,4 @@ The [Run and Debug configuration](https://mdk-packs.github.io/vscode-cmsis-solut
 
 ## Submit feedback or report issues
 
-To submit feedback or report issues on the Arm CMSIS Solution extension, please use [GitHub issues](https://github.com/ARM-software/vscode-cmsis-csolution/issues) in the extension repository.
+To submit feedback or report issues on the Arm CMSIS Solution extension, please use [GitHub issues](https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/issues) in the extension repository.
diff --git a/docs/third-party-licenses.md b/docs/third-party-licenses.md
@@ -1,4 +1,4 @@
-# TPIP Report for vscode-cmsis-csolution
+# TPIP Report for vscode-cmsis-solution
 
 Report prepared at: 03/03/2026, 10:51:48
 
diff --git a/docs/tpip-header.md b/docs/tpip-header.md
@@ -1 +1 @@
-# TPIP Report for vscode-cmsis-csolution
+# TPIP Report for vscode-cmsis-solution
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -2,16 +2,16 @@
   "name": "cmsis-csolution",
   "displayName": "Arm CMSIS Solution",
   "description": "Create embedded and Edge AI projects for Arm Cortex-M based devices using the Common Microcontroller Software Interface Standard (CMSIS) and csolution format",
-  "version": "1.66.0",
+  "version": "1.67.1",
   "preview": false,
   "publisher": "Arm",
-  "author": "Rob Moran <rob.moran@arm.com>",
+  "author": "Jens Reinecke <jens.reinecke@arm.com>",
   "license": "SEE LICENSE IN LICENSE",
   "main": "dist/extension.js",
-  "repository": "https://github.com/ARM-software/vscode-cmsis-csolution",
-  "qna": "https://github.com/ARM-software/vscode-cmsis-csolution/issues/new/choose",
+  "repository": "https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution",
+  "qna": "https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/issues/new/choose",
   "bugs": {
-    "url": "https://github.com/ARM-software/vscode-cmsis-csolution/issues"
+    "url": "https://github.com/Open-CMSIS-Pack/vscode-cmsis-solution/issues"
   },
   "icon": "media/arm.png",
   "galleryBanner": {
diff --git a/scripts/package.ts b/scripts/package.ts
@@ -22,9 +22,20 @@ import * as path from 'path';
 import { glob } from 'glob';
 import { fileURLToPath } from 'url';
 import { execSync } from 'child_process';
+import { parse as parseSemver } from 'semver';
 
 const argv = process.argv.slice(2);
 
+function isOddMinorVersion(version: string): boolean {
+    const parsedVersion = parseSemver(version);
+
+    if (!parsedVersion) {
+        throw new Error(`Invalid package version: ${version}`);
+    }
+
+    return parsedVersion.minor % 2 === 1;
+}
+
 // default target: host OS and architecture
 let target = `${os.platform()}-${os.arch()}`;
 
@@ -38,6 +49,18 @@ if (targetFlag !== -1) {
 // copy pre-downloaded node-pty for the target platform
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const packageJsonPath = path.resolve(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { version?: string };
+const version = packageJson.version;
+
+if (!version) {
+    throw new Error(`Missing version in ${packageJsonPath}`);
+}
+
+if (isOddMinorVersion(version) && !argv.includes('--pre-release')) {
+    argv.push('--pre-release');
+}
+
 const src = path.resolve(__dirname, '..','tools', 'node-pty');
 if (fs.existsSync(src)) {
     const dst = path.resolve(__dirname, '..', 'node_modules', '@lydell');
diff --git a/src/data-manager/DESIGN.md b/src/data-manager/DESIGN.md
diff --git a/src/solutions/files/cbuild-idx-file.test.ts b/src/solutions/files/cbuild-idx-file.test.ts
diff --git a/src/solutions/files/cbuild-idx-file.ts b/src/solutions/files/cbuild-idx-file.ts

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`		`-@arm-debug:registry=https://npm.pkg.github.com`
	`1`	`+@open-cmsis-pack:registry=https://npm.pkg.github.com`
`2`	`2`	`//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# TPIP Report for vscode-cmsis-csolution`
	`1`	`+# TPIP Report for vscode-cmsis-solution`
`2`	`2`
`3`	`3`	`Report prepared at: 03/03/2026, 10:51:48`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-# TPIP Report for vscode-cmsis-csolution`
	`1`	`+# TPIP Report for vscode-cmsis-solution`