Merge pull request #5 from daltskin/bnf

BNF based grammar implementation

Author: daltskin

.github/RELEASE_CHECKLIST.md

@@ -0,0 +1,32 @@
+# Release Checklist
+
+Use this template when preparing a new release.
+
+## Before Tagging
+
+1. Update `CHANGELOG.md`:
+   - Move items from `[Unreleased]` into a new `## [x.y.z]` section
+   - Use subsections: `### Added`, `### Changed`, `### Deprecated`, `### Removed`, `### Fixed`, `### Security`
+2. Ensure all tests pass: `npm test`
+3. Verify extension compiles: `npm run compile`
+4. Test packaging locally: `npm run package`
+
+## Creating the Release
+
+```bash
+git tag v0.14.0
+git push origin v0.14.0
+```
+
+The [release workflow](../workflows/release.yml) will automatically:
+
+- Build and package the VSIX
+- Extract release notes from `CHANGELOG.md` for the tagged version
+- Create a GitHub Release with the notes and VSIX attached
+- Publish to the VS Code Marketplace (if token is configured)
+
+## After Release
+
+- Verify the [GitHub Release](https://github.com/daltskin/VSCode_SysML_Extension/releases) looks correct
+- Confirm the VSIX is downloadable
+- Add a new `## [Unreleased]` section to `CHANGELOG.md` if not already present

.github/workflows/build-and-release.yml

@@ -45,6 +45,33 @@ jobs:
       - name: Verify VSIX version
         run: test -f "sysml-v2-support-${{ steps.version.outputs.version }}.vsix"
 
+      - name: Extract release notes from CHANGELOG.md
+        id: changelog
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          # Extract the section for this version from CHANGELOG.md
+          # Matches from "## [<version>]" up to the next "## [" heading or end of file
+          NOTES=$(awk -v ver="$VERSION" '
+            BEGIN { found=0 }
+            /^## \[/ {
+              if (found) exit
+              if (index($0, "## [" ver "]")) { found=1; next }
+            }
+            found { print }
+          ' CHANGELOG.md)
+
+          if [ -z "$NOTES" ]; then
+            echo "::warning::No changelog entry found for version $VERSION, using fallback"
+            NOTES="No changelog entry for this version."
+          fi
+
+          # Write multiline output using delimiter
+          {
+            echo "notes<<CHANGELOG_EOF"
+            echo "$NOTES"
+            echo "CHANGELOG_EOF"
+          } >> "$GITHUB_OUTPUT"
+
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v1
         env:
@@ -55,6 +82,10 @@ jobs:
           body: |
             ## SysML v2.0 Extension v${{ steps.version.outputs.version }}
 
+            ${{ steps.changelog.outputs.notes }}
+
+            ---
+
             ### Installation
             Download the `.vsix` file and install using:
             ```bash

.github/workflows/release.yml

@@ -60,3 +60,13 @@ Thumbs.db
 sysml.library/
 
 docs
+
+# Grammar generation
+.grammar-cache/
+tools/*.jar
+__pycache__/
+
+# Test output
+test-output/
+
+samples/temp