release: v1.3.0 (#114)

* docs: add release process to AGENTS.md

* docs: add branch protection step to release process

* docs: enforce_admins true in branch protection command (#108)

* Pre-release QA manual testing checklist (#76)

* docs: pre-release QA checklist with manual test fixtures (#75)

* fix: add missing loop variable declaration in test_highlighting.st

* test: add logical operators, MOD, block comments, double-quoted strings to highlighting test

* fix: reorder number patterns to prevent splitting literals

Moved hex/binary/octal/float patterns before plain integer pattern.
Prevents: 16#ABCD matching '16' first, 1.23E-4 matching '1' and '4'.
Now full literals highlight correctly.

* fix: remove console.warn noise from ast-parser

Removed console.warn on missing END keywords. Diagnostics provider handles user-facing errors. Parser silently returns EOF on unmatched blocks.

* test: add FUNCTION_BLOCK declarations to syntax highlighting fixture

Replaced completion-focused content with proper FB declarations (VAR_INPUT/OUTPUT/IN_OUT, custom FBs). Tests FUNCTION_BLOCK/END_FUNCTION_BLOCK keyword highlighting.

* fix: diagnostics squiggles, missing commands, paren tracking, consistency

- missing semicolon squiggle at insert point (after last char, len 0)
- type mismatch squiggle on RHS expression only
- undefined var column accounts for line indent
- named param assigns (IN :=) no longer flagged as undefined
- typed literal prefixes (T#, DATE#, etc.) no longer flagged
- paren check per-line on statement lines; multi-line FB calls not flagged
- close-paren quick fix inserts before semicolon, not after
- showIndexStats and checkLspStatus commands registered and in package.json
- sendRequest helper exported from lsp-client
- configurationDefaults sets extension as default formatter
- format doc keybinding note updated for Linux (Ctrl+Shift+I)
- block terminator semicolons (END_IF; etc.) removed from all fixtures, samples, spec
- hover tooltips for primitive data types
- completion: FB call param suggestions, dedup, standard FBs + data types

* docs: clarify branch naming conventions and PR targets (#112)

* docs: enforce_admins true in branch protection command

* docs: clarify branch naming conventions and PR targets

* chore: bump version to 1.3.0, finalize changelog (#111)

* chore: bump version to 1.3.0, finalize changelog

* docs: add v1.3.0 release notes, update releases index

* fix: remove extra space in SR.st comment alignment

* docs: update README for v1.3.0 — fix version header, test count, keybinding

* docs: add demo video to README

* docs: replace MP4 with GIF for marketplace compatibility

* docs: demo GIF and demo.st sample (#113)

* docs: add demo video to README

* docs: replace MP4 with GIF for marketplace compatibility

* samples: add demo.st showcasing key IEC 61131-3 features

Author: michaeldistel

AGENTS.md

@@ -86,16 +86,50 @@ Add `Priority:` and `Effort:` labels manually per issue. No emoji/icons in title
 ```
 main                   ← stable, tagged releases only; never commit directly
 release-X.Y.0          ← integration branch per milestone; PRs merge here
-feature/issue-N-desc   ← short-lived; cut from the active release branch
+feature/issue-N-desc   ← new functionality
+fix/issue-N-desc       ← bug fixes
+chore/desc             ← tooling, config, deps
+docs/desc              ← documentation only
 ```
 
-- **Feature branches** cut from the active `release-X.Y.0` (matches issue milestone)
-- **PRs** target `release-X.Y.0`, never `main`
+- All branch types target the active `release-X.Y.0` via PR — no direct pushes, no exceptions
 - **`main`** updated only when releasing — merge `release-X.Y.0` → `main` via a release PR, then tag
 - **Hotfixes** branch off `main`, PR back to both `main` and the active release branch
 - Create `release-X.Y.0` at milestone start; delete after merge to `main`
 - Active release branch is the one matching the current in-progress milestone
 
+## Release Process
+
+**At milestone start — create release branch:**
+1. `git checkout main && git pull`
+2. `git checkout -b release-X.Y.0 && git push -u origin release-X.Y.0`
+3. Apply branch protection (require PR, no force push, no deletion):
+   ```bash
+   gh api repos/ControlForge-Systems/controlforge-structured-text/branches/release-X.Y.0/protection \
+     --method PUT --input - <<'EOF'
+   {
+     "required_pull_request_reviews": {"required_approving_review_count": 0},
+     "required_status_checks": null,
+     "enforce_admins": true,
+     "restrictions": null,
+     "allow_force_pushes": false,
+     "allow_deletions": false
+   }
+   EOF
+   ```
+
+**During milestone — tag pre-release when QA starts:**
+1. All milestone issues closed and merged into `release-X.Y.0`
+2. Tag `vX.Y.0-rc.1` on `release-X.Y.0`, publish as GitHub **pre-release** — signals QA in progress, not for production
+
+**When QA complete — ship:**
+1. Move `CHANGELOG.md` `[Unreleased]` entries to `[X.Y.0] - YYYY-MM-DD`
+2. Open PR `release-X.Y.0` → `main`
+3. Merge PR, tag `vX.Y.0` on `main`
+4. `vsce package && vsce publish`
+5. Close the milestone
+6. Delete `release-X.Y.0` branch
+
 ## Pull Requests
 
 Template at `.github/PULL_REQUEST_TEMPLATE.md`. Two sections:

CHANGELOG.md

@@ -2,14 +2,11 @@
 
 ## [Unreleased]
 
-### Changed
-- License changed from BUSL-1.1 to MIT (#78)
-
-### Fixed
-- Parser regex fails on multi-line variable declarations (#41)
-- Verbose console.log in definition provider polluting test and server output
+## [1.3.0] - 2026-02-20
 
 ### Added
+- Pre-release QA manual testing checklist covering all 14 feature categories (#75)
+- Manual test fixtures for rename symbol, find references, .iecst extension, commands, formatting settings (#75)
 - Rich hover tooltips for standard function blocks: parameter tables, behavior descriptions, usage examples (#22)
 - Advanced diagnostics and linting: missing semicolons, duplicate declarations, undefined variables, unused variables, type mismatches (#6)
 - Semantic analysis powered by AST parser symbols for deeper code inspection (#6)
@@ -31,10 +28,15 @@
 - Clean build steps for compile and webpack scripts
 
 ### Changed
+- License changed from BUSL-1.1 to MIT (#78)
 - Extracted `getExtensionPath` from server.ts into extension-path.ts for testability (#44)
 - Updated all npm dependencies (TypeScript 4.9→5.9, webpack 5.99→5.105, node types 16→20) (#50)
 - Removed legacy parser (`parser.ts`) and its tests
 
+### Fixed
+- Parser regex fails on multi-line variable declarations (#41)
+- Verbose console.log in definition provider polluting test and server output
+
 ### Removed
 - Stale documentation (FEATURES.md, MANUAL_TEST_GUIDE.md, RELEASE_PLAN.md, TESTING.md)
 - Dead scripts (pretest, compile-test, test:watch, test:pre-commit)

README.md

@@ -5,9 +5,11 @@
 
 Professional **Structured Text (IEC 61131-3)** development environment for **PLC programming** in Visual Studio Code.
 
+![ControlForge Structured Text Demo](images/demo.gif)
+
 ## Key Features
 
-- **Code Formatting**: Format Document (Shift+Alt+F), Format Selection, configurable keyword casing, operator spacing, VAR alignment
+- **Code Formatting**: Format Document, Format Selection, configurable keyword casing, operator spacing, VAR alignment
 - **Real-time Diagnostics**: Errors and warnings as you type — missing semicolons, type mismatches, undefined/unused variables, unmatched blocks
 - **Code Actions & Quick Fixes**: One-click fixes for missing END blocks, semicolons, duplicate/unused declarations, unclosed strings
 - **Rename Symbol (F2)**: Rename variables, functions, FBs, programs with IEC 61131-3 validation
@@ -18,12 +20,6 @@ Professional **Structured Text (IEC 61131-3)** development environment for **PLC
 - **Workspace Indexing**: Automatic cross-file symbol discovery and resolution
 - **Code Snippets**: Pre-built templates for common PLC patterns
 
-## Screenshots
-
-### Syntax Highlighting & IntelliSense
-![Syntax Highlighting](images/syntax-highlighting.png)
-*Rich syntax highlighting for all IEC 61131-3 constructs*
-
 ## Getting Started
 
 ### Installation
@@ -105,7 +101,7 @@ END_PROGRAM
 - **Light bulb menu**: Fixes appear via `Ctrl+.` or clicking the light bulb icon
 
 ### Code Formatting
-- **Format Document**: `Shift+Alt+F` to format entire file
+- **Format Document**: Format entire file via Command Palette (`Ctrl+Shift+P` > Format Document)
 - **Format Selection**: Format only selected code
 - **Keyword casing**: Configurable UPPER, lower, or preserve
 - **Operator spacing**: Automatic spaces around `:=`, `+`, `-`, `*`, `/`, `=`, `<>`, `<=`, `>=`
@@ -136,15 +132,15 @@ END_PROGRAM
 - **Visual Studio Code** 1.100.0 or higher
 - **Operating System**: Windows, macOS, or Linux
 
-## What's New (Unreleased)
+## What's New in v1.3.0
 - **Rich FB Hover Tooltips**: Standard function blocks show parameter tables, behavior descriptions, and usage examples on hover
 - **Advanced Diagnostics**: Missing semicolons, duplicate declarations, undefined variables, unused variables, type mismatches — all with quick fixes
-- **Code Formatting**: Format Document (Shift+Alt+F) and Format Selection with keyword casing, operator spacing, indentation, VAR alignment
+- **Code Formatting**: Format Document and Format Selection with keyword casing, operator spacing, indentation, VAR alignment
 - **Rename Symbol (F2)**: Rename variables, functions, FBs, programs with identifier validation and comment-awareness
 - **Code actions & quick fixes**: Auto-insert missing END blocks, close unclosed strings, fix unmatched parentheses via light bulb menu
 - **Real-time diagnostics**: Unmatched blocks, unclosed strings, unmatched parentheses shown in Problems panel as you type
 - **Multi-line declaration parsing**: Arrays, structs, and complex initializers now parse correctly
-- **353 unit tests**: Comprehensive coverage for all LSP providers, diagnostics, code actions, rename, and formatting
+- **366 unit tests**: Comprehensive coverage for all LSP providers, diagnostics, code actions, rename, and formatting
 
 ## What's New in v1.2.5
 - **Multi-line declaration parsing**: Arrays, structs, and complex initializers now parse correctly

docs/IEC61131_SPECIFICATION.md

@@ -265,7 +265,7 @@ MotorSpeed := SpeedSetpoint * ScalingFactor;
 ```
 IF ActualTemperature > HighTempAlarm THEN
     AlarmActive := TRUE;
-END_IF;
+END_IF
 ```
 
 **Logical operators (`AND`, `OR`, `NOT`)**: Critical for safety interlocks and condition evaluation:
@@ -381,8 +381,8 @@ IF StartButton.Q THEN
     StartDelay(IN := TRUE, PT := T#3s);
     IF StartDelay.Q THEN
         ProductCounter(CU := TRUE, PV := 100);
-    END_IF;
-END_IF;
+    END_IF
+END_IF
 ```
 
 ### Vendor Support Comparison