Adding build_version to the manifest

Author: edwinyjlim

.github/workflows/build-release.yml

@@ -37,12 +37,6 @@ jobs:
       - name: Install dependencies
         run: npm install
 
-      - name: Build markdown documentation
-        run: npm run build:docs
-
-      - name: List build artifacts
-        run: ls -lh dist/
-
       - name: Determine version
         id: version
         run: |
@@ -107,6 +101,14 @@ jobs:
           echo "tag=v${VERSION}" >> $GITHUB_OUTPUT
           echo "Building version: ${VERSION}"
 
+      - name: Build markdown documentation
+        run: npm run build:docs
+        env:
+          BUILD_VERSION: ${{ steps.version.outputs.version }}
+
+      - name: List build artifacts
+        run: ls -lh dist/
+
       - name: Create Release
         id: create_release
         uses: actions/create-release@v1
@@ -157,5 +159,10 @@ jobs:
           echo "- **Tag:** ${{ steps.version.outputs.tag }}" >> $GITHUB_STEP_SUMMARY
           echo "- **Artifact:** examples-mcp-resources.zip" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Manifest Metadata" >> $GITHUB_STEP_SUMMARY
+          echo '```json' >> $GITHUB_STEP_SUMMARY
+          cat dist/manifest.json | jq '{version, buildVersion, buildTimestamp}' >> $GITHUB_STEP_SUMMARY
+          echo '```' >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
           echo "### Files Generated" >> $GITHUB_STEP_SUMMARY
           ls -lh dist/ >> $GITHUB_STEP_SUMMARY

scripts/build-examples-mcp-resources.js

@@ -26,8 +26,13 @@ const { composePlugins, ignoreLinePlugin, ignoreFilePlugin, ignoreBlockPlugin }
 
 /**
  * Manifest configuration constants
+ *
+ * - MANIFEST_VERSION: Schema version for manifest structure
+ * - BUILD_VERSION: Git release version (set by CI, defaults to 'dev' locally)
+ * - URI_SCHEME: Base scheme for all resource URIs
  */
 const MANIFEST_VERSION = '1.0';
+const BUILD_VERSION = process.env.BUILD_VERSION || 'dev';
 const URI_SCHEME = 'posthog://';
 
 /**
@@ -637,6 +642,8 @@ function generateManifest(discoveredWorkflows, exampleIds, discoveredPrompts) {
 
     return {
         version: MANIFEST_VERSION,
+        buildVersion: BUILD_VERSION,
+        buildTimestamp: new Date().toISOString(),
         resources: {
             workflows,
             docs,
@@ -696,7 +703,9 @@ function processWorkflowFiles(discoveredWorkflows, outputDir) {
  * 5. Create ZIP archive
  */
 async function build() {
-    console.log('Building markdown documentation from example projects...\n');
+    console.log('Building markdown documentation from example projects...');
+    console.log(`Build Version: ${BUILD_VERSION}`);
+    console.log('');
 
     const outputDir = path.join(__dirname, '..', 'dist');