Release 0.16.0 — integrate beta → main

.ai/decisions.yaml

@@ -54,7 +54,6 @@ decisions:
       - Memory usage
     references:
     - src/services/componentCacheManager.ts
-    - CACHE_MANAGEMENT.md
     title: Cache Components
   USE_SECRETSTORAGE_FOR_TOKENS:
     date: '2024'
@@ -367,7 +366,6 @@ decisions:
       - More complex implementation
     references:
     - src/services/componentService.ts
-    - PERFORMANCE_OPTIMIZATIONS.md
     title: Batch Api Requests
   MOCHA_OVER_JEST:
     date: '2024'

.ai/workflows.yaml

@@ -81,21 +81,20 @@ workflows:
       command: vsce package
       output: gitlab-component-helper-{version}.vsix
   release:
-    description: Create a new release
+    description: Cut and publish a release (two stages; NOT semantic-release)
     steps:
-    - action: commit_changes
-      command: 'git add . && git commit -m ''feat: description'''
-      note: Use conventional commits (feat, fix, chore, etc.)
-    - action: push_to_main
-      command: git push origin main
-    - action: automatic_release
-      note: semantic-release runs automatically on push to main
+    - action: land_changes
+      command: Merge PRs to beta (pre-release) or main (stable) via the normal PR flow
+      note: Use conventional commits so release-it can compute the next version
+    - action: automatic_versioning
+      note: 'On push to beta/main, ci.yml release job runs release-it (--config .release-it.beta.json or .release-it.json --ci)'
       creates:
-      - GitHub release
       - Version bump in package.json
       - Updated CHANGELOG.md
-      - VSIX artifact
-    reference: SEMANTIC_RELEASE.md
+      - 'chore(release): <version> [skip ci] commit and git tag'
+    - action: manual_publish
+      note: 'Manual workflow_dispatch: Actions -> Publish (main) or Publish Beta (beta), enter version matching package.json; guardrails enforce branch, version match, release-commit HEAD, tests, npm audit, gitleaks, and even(stable)/odd(pre-release) minor before vsce publish'
+    reference: RELEASING.md
   add_configuration_option:
     description: Add new user configuration setting
     steps:
@@ -179,25 +178,4 @@ git_workflow:
       - Runs commitlint to validate message format
       purpose: Enforce conventional commit message format
       format: 'type(scope): description'
-syntax_highlighting:
-  language_definition:
-    location: syntaxes/gitlab-ci.tmLanguage.json
-    language_id: gitlab-ci
-    scope: source.yaml.gitlab-ci
-    file_extensions:
-    - .gitlab-ci.yml
-    - .gitlab-ci.yaml
-  configuration:
-    location: language-configuration.json
-    features:
-    - Comment toggling
-    - Bracket matching
-    - Auto-closing pairs
-    - Folding markers
-  registration:
-    file: package.json
-    section: contributes.languages
-    grammar_path: syntaxes/gitlab-ci.tmLanguage.json
-    embedded_languages:
-      yaml: For base YAML syntax
 version: '2.0'

.github/workflows/ci.yml

@@ -54,7 +54,6 @@ jobs:
           path: |
             tests/
             out/
-            compile.txt
           retention-days: 30
 
   extension-host:

.gitignore

@@ -40,6 +40,7 @@ out-test
 junit.xml
 
 # Other
+compile.txt
 offline-search-index.*
 .gitlab-ci-local*
 *.vsix

.pre-commit-config.yaml

@@ -9,9 +9,11 @@ repos:
     rev: v6.0.0
     hooks:
       - id: trailing-whitespace
-        exclude: ^(docs)
+        # tests/fixtures/** are intentionally-crafted parser inputs (trailing
+        # whitespace / blank lines are part of the test scenario) — never rewrite them.
+        exclude: ^(docs|tests/fixtures)
       - id: end-of-file-fixer
-        exclude: ^(docs)
+        exclude: ^(docs|tests/fixtures)
       - id: check-ast
         exclude: ^(docs)
       # - id: check-yaml
@@ -24,7 +26,7 @@ repos:
       - id: detect-private-key
       - id: mixed-line-ending
         args: ["--fix=lf"]
-        exclude: \.md$
+        exclude: (\.md$|^tests/fixtures/)
       # - id: no-commit-to-branch
       #   args: [--branch, main]
       - id: pretty-format-json

.vscodeignore

@@ -35,7 +35,6 @@ commitlint.config.js
 .ai/**
 docs/**
 AGENTS.md
-CACHE_MANAGEMENT.md
 CLAUDE.md
 CONTRIBUTING.md
 DEVELOPERS.md
@@ -50,7 +49,6 @@ sync-changes.sh
 # Test and coverage
 .nyc_output
 coverage
-compile.txt
 
 # Build artifacts
 **/*.backup

.yamllint.yml

@@ -9,6 +9,12 @@ yaml-files:
   - ".yamllint"
 
 ignore:
+  # Test fixtures are intentionally-crafted GitLab CI parser inputs: flow-style
+  # braces ({ job_name: deploy }), empty values (region:), trailing whitespace
+  # and blank lines are the exact conditions the parser/completion tests exist to
+  # exercise. They represent arbitrary user files, so they must not be
+  # style-linted — the mocha suite validates their behaviour instead.
+  - "tests/fixtures/**"
   - "node_modules/**"
   - ".git/**"
   - ".github/**"

AGENTS.md

@@ -33,7 +33,7 @@ This project uses **AI Context as Code (AICaC)** - structured YAML documentation
 - TypeScript (strict mode)
 - esbuild (bundler)
 - Mocha (testing)
-- semantic-release (automated releases)
+- release-it (version + changelog automation; Marketplace publish is a manual workflow dispatch)
 
 ### Entry Points
 - Extension activation: [`src/extension.ts`](src/extension.ts)
@@ -90,7 +90,7 @@ gitlab-component-helper/
 
 **Branch naming:** `feature/description` or `fix/description`
 **Commit format:** `type(scope): description`
-**Release:** Automated via semantic-release on push to main
+**Release:** release-it bumps the version + CHANGELOG on push to `beta`/`main` (ci.yml `release` job); publishing to the Marketplace is a manual `workflow_dispatch` (Publish / Publish Beta). See [`docs/RELEASING.md`](docs/RELEASING.md)
 
 ### Commit Types
 - `feat:` New feature (triggers minor version bump)
@@ -143,9 +143,8 @@ API requests are batched (default 5 concurrent) to respect rate limits.
 
 - **Full specification:** See [`.ai/`](.ai/) directory
 - **User documentation:** See [`README.md`](README.md)
-- **Semantic release:** See [`SEMANTIC_RELEASE.md`](SEMANTIC_RELEASE.md)
-- **Cache management:** See [`CACHE_MANAGEMENT.md`](CACHE_MANAGEMENT.md)
-- **Performance:** See [`PERFORMANCE_OPTIMIZATIONS.md`](PERFORMANCE_OPTIMIZATIONS.md)
+- **Releasing:** See [`docs/RELEASING.md`](docs/RELEASING.md)
+- **Cache & performance architecture:** See [`.ai/architecture.yaml`](.ai/architecture.yaml)
 
 ## About AICaC