Prepare Marketplace 0.2.5

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -10,7 +10,7 @@ body:
     id: extension-version
     attributes:
       label: Extension version
-      placeholder: 0.2.3
+      placeholder: 0.2.5
     validations:
       required: true
   - type: input

.github/workflows/marketplace.yml

@@ -6,7 +6,7 @@ on:
       release_tag:
         description: Checksummed GitHub release to verify before manual Marketplace upload
         required: true
-        default: v0.2.3
+        default: v0.2.5
         type: string
 
 permissions:

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.2.5 - 2026-08-17
+
+### Fixed
+
+- Removed stale `0.2.3` release-candidate copy from the Marketplace README and
+  feature contract so the installed extension no longer advertises an older
+  package than the one a user is running.
+- Updated the manual Marketplace package gate and bug-report template to the
+  current release version.
+- Clarified that the four target-specific VSIX files are platform variants of
+  one extension and Marketplace selects the matching package automatically.
+
+### Distribution
+
+- Kept the public `fyaic/Docferry-VSCode` repository as the sole review and
+  release source. The bundled runtime remains DocFerry Agent Kit `0.4.4`.
+
 ## 0.2.4 - 2026-08-14
 
 ### Fixed

README.md

@@ -3,8 +3,8 @@
 Bring useful links into your project and share Markdown without leaving VS Code.
 DocFerry works with ordinary folders and repositories; Obsidian is optional.
 
-> **Preview:** `0.2.3` is the current Marketplace release candidate.
-> Install and core features are free. Folder sharing and detailed notes from
+> **Preview:** Install the current build from the VS Code Marketplace.
+> Core features are free. Folder sharing and detailed notes from
 > supported web, audio, and video sources require an optional DocFerry Pro
 > subscription purchased outside the Marketplace.
 

docs/FEATURES.md

@@ -4,7 +4,7 @@ DocFerry for VS Code consumes the same product session, membership policy, and
 share/import APIs as the current DocFerry mainline. It does not maintain a
 separate entitlement model.
 
-| Product workflow | VS Code 0.2.3 | Boundary |
+| Product workflow | Current VS Code Preview | Boundary |
 | --- | --- | --- |
 | Bondie login | Complete | System-browser Device Code flow |
 | Product Dashboard | Complete | Short-lived DocFerry-only handoff |

docs/PUBLISHING.md

@@ -32,6 +32,11 @@ Release CI builds these targets on matching native runners:
 - `linux-x64`
 - `win32-x64`
 
+These are four platform variants of one `bondie.docferry` extension version,
+not four separate extensions. Marketplace records their target metadata and
+offers the matching package to each supported VS Code host. Upload every target
+for the version; a user installs DocFerry once.
+
 Do not rename one platform artifact to another target. Each VSIX contains a
 native helper and must pass `scripts/verify_vsix.py` on its build runner.
 

docs/operations/evidence/marketplace-0.2.5-release-candidate-2026-08-17.md

@@ -0,0 +1,47 @@
+# Marketplace 0.2.5 Release Candidate
+
+Date: 2026-08-17
+
+## Scope
+
+DocFerry for VS Code `0.2.5` is a documentation and release-metadata
+correction over `0.2.4`. It removes stale `0.2.3` copy from the packaged
+Marketplace README and feature contract, advances the manual package gate and
+bug template, and explains how Marketplace selects among the four
+target-specific packages.
+
+No extension runtime, command, login, Share, Import, membership, or entitlement
+behavior changed. The public `fyaic/Docferry-VSCode` repository remains the
+sole source and release authority. The bundled runtime remains DocFerry Agent
+Kit `0.4.4`.
+
+## Local Verification
+
+The release candidate passed from a clean dependency install:
+
+- npm audit at high severity: `0` vulnerabilities
+- public-source verifier: `56` source files; Agent Kit `0.4.4`
+- Marketplace verifier: `4` passed
+- TypeScript check and bundle: passed
+- extension contract tests: `18` passed
+- VS Code Extension Host smoke: exit code `0`
+- bundled helper build: `docferry 0.4.4`
+- native package verification: HTTPS health check passed
+
+The local Apple Silicon package was:
+
+- file: `docferry-vscode-0.2.5-darwin-arm64.vsix`
+- size: `14,647,989` bytes
+- SHA-256: `814783029b36d1a6047e1838abf3658234788d5a085054c6d598ac591901bde1`
+
+Release CI must independently rebuild and verify macOS arm64, macOS x64,
+Linux x64, and Windows x64 packages from the exact tagged commit. A successful
+local candidate does not claim that GitHub Release or Marketplace publication
+has already occurred.
+
+## Publication Boundary
+
+The four VSIX files are platform variants of one `bondie.docferry` extension
+version. They must all come from the same checksummed GitHub Release and be
+uploaded unchanged through the authenticated Bondie publisher page. This
+repository intentionally stores no Marketplace PAT or Microsoft credential.

package.json

@@ -2,7 +2,7 @@
   "name": "docferry",
   "displayName": "DocFerry",
   "description": "Save links, create detailed notes, and share Markdown files or folders from VS Code.",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "publisher": "bondie",
   "author": {
     "name": "Bondie",

src/test/suite/index.ts

@@ -29,7 +29,7 @@ export async function run(): Promise<void> {
   assert.ok(extension, "DocFerry extension was not discovered by Extension Host");
   await extension.activate();
   assert.equal(extension.isActive, true);
-  assert.equal(extension.packageJSON.version, "0.2.4");
+  assert.equal(extension.packageJSON.version, "0.2.5");
   assert.equal(extension.packageJSON.pricing, "Free");
   assert.equal(extension.packageJSON.preview, true);
   assert.equal(extension.packageJSON.capabilities.untrustedWorkspaces.supported, false);