@dizzlkheinz/ynab-mcpb 0.12.1

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@dizzlkheinz/ynab-mcpb",
+  "version": "0.12.1",
+  "description": "Model Context Protocol server for YNAB (You Need A Budget) integration",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "ynab-mcp-server": "bin/ynab-mcp-server.cjs"
+  },
+  "scripts": {
+    "prebuild": "npm run clean",
+    "build": "npm run build:prod",
+    "postbuild": "node scripts/run-generate-mcpb.js",
+    "build:dev": "npm run clean && tsc && npm run bundle",
+    "build:no-lint": "npm run clean && tsc && npm run bundle:prod",
+    "build:prod": "npm run lint:fix && npm run prebuild && tsc --project tsconfig.prod.json && npm run bundle:prod && npm run verify-build",
+    "clean": "rimraf dist",
+    "dev": "tsc --watch",
+    "start": "node -r dotenv/config dist/index.js",
+    "start:prod": "NODE_ENV=production node dist/index.js",
+    "start:mcp": "node dist/index.js",
+    "validate-env": "node scripts/validate-env.js",
+    "verify-build": "node scripts/verify-build.js",
+    "lint": "npm run lint:eslint && npm run format:check",
+    "lint:eslint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix && prettier --write .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --project unit && npm run filter-test-results",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "npm run test:integration:core",
+    "test:integration:core": "vitest run --project integration:core",
+    "test:integration:domain": "vitest run --project integration:domain",
+    "test:integration:full": "node scripts/run-throttled-integration-tests.js",
+    "test:integration:budgets": "node scripts/run-domain-integration-tests.js budgets",
+    "test:integration:accounts": "node scripts/run-domain-integration-tests.js accounts",
+    "test:integration:transactions": "node scripts/run-domain-integration-tests.js transactions",
+    "test:integration:categories": "node scripts/run-domain-integration-tests.js categories",
+    "test:integration:payees": "node scripts/run-domain-integration-tests.js payees",
+    "test:integration:months": "node scripts/run-domain-integration-tests.js months",
+    "test:integration:delta": "node scripts/run-domain-integration-tests.js delta",
+    "test:integration:reconciliation": "node scripts/run-domain-integration-tests.js reconciliation",
+    "test:e2e": "vitest run --project e2e",
+    "test:coverage": "vitest run --coverage --project unit",
+    "test:performance": "vitest run src/__tests__/performance.test.ts",
+    "test:comprehensive": "tsx src/__tests__/testRunner.ts",
+    "test:all": "npm run test:unit && npm run test:integration:core && npm run test:e2e && npm run test:performance",
+    "filter-test-results": "node -e \"const fs = require('fs'); try { const results = JSON.parse(fs.readFileSync('test-results.json', 'utf-8')); if (!results.quickStats || !results.quickStats.success) { console.warn('Tests failed. See test-results/failed-tests.json for details.'); } } catch (e) { console.warn('Could not read test results:', e.message); }\"",
+    "generate:mcpb": "node scripts/run-generate-mcpb.js",
+    "bundle": "node esbuild.config.mjs",
+    "bundle:prod": "node esbuild.config.mjs --production",
+    "package:mcpb": "npm run build:prod && npm run generate:mcpb",
+    "pr:description": "node scripts/create-pr-description.js",
+    "pr:create": "npm run pr:description && gh pr create --body-file .pr-description.md",
+    "prepare": "npm run build:prod",
+    "prepublishOnly": "npm run test:unit && npm run build:prod"
+  },
+  "keywords": [
+    "mcp",
+    "ynab",
+    "budget",
+    "finance"
+  ],
+  "author": "",
+  "license": "AGPL-3.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "csv-parse": "^6.1.0",
+    "d3-array": "^3.2.4",
+    "date-fns": "^4.1.0",
+    "dotenv": "^17.2.1",
+    "ynab": "^2.9.0",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "@types/d3-array": "^3.2.1",
+    "@types/node": "^24.5.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "esbuild": "^0.25.10",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.3.3",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.42.0",
+    "vitest": "^3.2.4"
+  },
+  "directories": {
+    "doc": "docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dizzlkheinz/ynab-mcpb.git"
+  },
+  "types": "./dist/index.d.ts",
+  "bugs": {
+    "url": "https://github.com/dizzlkheinz/ynab-mcpb/issues"
+  },
+  "homepage": "https://github.com/dizzlkheinz/ynab-mcpb#readme"
+}

package/package.json.tmp

@@ -0,0 +1,105 @@
+{
+  "name": "@dizzlkheinz/ynab-mcp-server",
+  "version": "0.12.0",
+  "description": "Model Context Protocol server for YNAB (You Need A Budget) integration",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "ynab-mcp-server": "bin/ynab-mcp-server.cjs"
+  },
+  "scripts": {
+    "prebuild": "npm run clean",
+    "build": "npm run build:prod",
+    "postbuild": "node scripts/run-generate-mcpb.js",
+    "build:dev": "npm run clean && tsc && npm run bundle",
+    "build:no-lint": "npm run clean && tsc && npm run bundle:prod",
+    "build:prod": "npm run lint:fix && npm run prebuild && tsc --project tsconfig.prod.json && npm run bundle:prod && npm run verify-build",
+    "clean": "rimraf dist",
+    "dev": "tsc --watch",
+    "start": "node -r dotenv/config dist/index.js",
+    "start:prod": "NODE_ENV=production node dist/index.js",
+    "start:mcp": "node dist/index.js",
+    "validate-env": "node scripts/validate-env.js",
+    "verify-build": "node scripts/verify-build.js",
+    "lint": "npm run lint:eslint && npm run format:check",
+    "lint:eslint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix && prettier --write .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --project unit && npm run filter-test-results",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "npm run test:integration:core",
+    "test:integration:core": "vitest run --project integration:core",
+    "test:integration:domain": "vitest run --project integration:domain",
+    "test:integration:full": "node scripts/run-throttled-integration-tests.js",
+    "test:integration:budgets": "node scripts/run-domain-integration-tests.js budgets",
+    "test:integration:accounts": "node scripts/run-domain-integration-tests.js accounts",
+    "test:integration:transactions": "node scripts/run-domain-integration-tests.js transactions",
+    "test:integration:categories": "node scripts/run-domain-integration-tests.js categories",
+    "test:integration:payees": "node scripts/run-domain-integration-tests.js payees",
+    "test:integration:months": "node scripts/run-domain-integration-tests.js months",
+    "test:integration:delta": "node scripts/run-domain-integration-tests.js delta",
+    "test:integration:reconciliation": "node scripts/run-domain-integration-tests.js reconciliation",
+    "test:e2e": "vitest run --project e2e",
+    "test:coverage": "vitest run --coverage --project unit",
+    "test:performance": "vitest run src/__tests__/performance.test.ts",
+    "test:comprehensive": "tsx src/__tests__/testRunner.ts",
+    "test:all": "npm run test:unit && npm run test:integration:core && npm run test:e2e && npm run test:performance",
+    "filter-test-results": "node -e \"const fs = require('fs'); try { const results = JSON.parse(fs.readFileSync('test-results.json', 'utf-8')); results.testResults = results.testResults.filter(r => r.status === 'fail'); fs.writeFileSync('test-results.json', JSON.stringify(results, null, 2)); } catch (e) { console.error('Failed to filter test results:', e); process.exit(1); }\"",
+    "generate:mcpb": "node scripts/run-generate-mcpb.js",
+    "bundle": "node esbuild.config.mjs",
+    "bundle:prod": "node esbuild.config.mjs --production",
+    "package:mcpb": "npm run build:prod && npm run generate:mcpb",
+    "pr:description": "node scripts/create-pr-description.js",
+    "pr:create": "npm run pr:description && gh pr create --body-file .pr-description.md",
+    "prepare": "npm run build:prod",
+    "prepublishOnly": "npm run test:unit && npm run build:prod"
+  },
+  "keywords": [
+    "mcp",
+    "ynab",
+    "budget",
+    "finance"
+  ],
+  "author": "",
+  "license": "AGPL-3.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "csv-parse": "^6.1.0",
+    "d3-array": "^3.2.4",
+    "date-fns": "^4.1.0",
+    "dotenv": "^17.2.1",
+    "ynab": "^2.9.0",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "@types/d3-array": "^3.2.1",
+    "@types/node": "^24.5.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "esbuild": "^0.25.10",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.3.3",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.42.0",
+    "vitest": "^3.2.4"
+  },
+  "directories": {
+    "doc": "docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dizzlkheinz/ynab-mcp-dxt.git"
+  },
+  "types": "./dist/index.d.ts",
+  "bugs": {
+    "url": "https://github.com/dizzlkheinz/ynab-mcp-dxt/issues"
+  },
+  "homepage": "https://github.com/dizzlkheinz/ynab-mcp-dxt#readme"
+}

package/scripts/analyze-bundle.mjs

@@ -0,0 +1,41 @@
+import fs from 'fs';
+
+let meta;
+try {
+  meta = JSON.parse(fs.readFileSync('meta.json', 'utf-8'));
+} catch (error) {
+  console.error('❌ Error reading meta.json:', error.message);
+  process.exit(1);
+}
+if (!meta.inputs || typeof meta.inputs !== 'object') {
+  console.error('❌ Error: meta.inputs is missing or invalid in meta.json');
+  process.exit(1);
+}
+
+const inputs = Object.entries(meta.inputs)
+  .map(([path, data]) => ({
+    path,
+    bytes: data.bytes,
+  }))
+  .sort((a, b) => b.bytes - a.bytes)
+  .slice(0, 20);
+
+const totalBytes = Object.values(meta.inputs).reduce((sum, item) => sum + item.bytes, 0);
+console.log(`\n📦 Total input size: ${(totalBytes / 1024 / 1024).toFixed(2)} MB`);
+const outputKey = 'dist/bundle/index.cjs';
+if (!meta.outputs || !meta.outputs[outputKey]) {
+  console.error(`❌ Error: meta.outputs['${outputKey}'] is missing in meta.json`);
+  process.exit(1);
+}
+console.log(`📦 Output size: ${(meta.outputs[outputKey].bytes / 1024 / 1024).toFixed(2)} MB`);
+console.log('\n📊 Top 20 largest inputs in bundle:\n');
+inputs.forEach((item) => {
+  const kb = (item.bytes / 1024).toFixed(1).padStart(8);
+  console.log(`${kb} KB  ${item.path}`);
+});  const kb = (item.bytes / 1024).toFixed(1).padStart(8);
+  console.log(`${kb} KB  ${item.path}`);
+});
+
+const totalBytes = Object.values(meta.inputs).reduce((sum, item) => sum + item.bytes, 0);
+console.log(`\n📦 Total input size: ${(totalBytes / 1024 / 1024).toFixed(2)} MB`);
+console.log(`📦 Output size: ${(meta.outputs['dist/bundle/index.cjs'].bytes / 1024 / 1024).toFixed(2)} MB`);

package/scripts/create-pr-description.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+/**
+ * Generates a PR description from template with smart defaults
+ * Usage: node scripts/create-pr-description.js [options]
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Read the PR template
+const templatePath = path.join(__dirname, '..', '.github', 'pull_request_template.md');
+const template = fs.readFileSync(templatePath, 'utf-8');
+
+// Function to detect the repository's default branch
+function getDefaultBranch() {
+  try {
+    // Try to get the default branch from origin/HEAD
+    const defaultBranch = execSync('git symbolic-ref refs/remotes/origin/HEAD', {
+      encoding: 'utf-8',
+    })
+      .trim()
+      .replace('refs/remotes/origin/', '');
+    return defaultBranch;
+  } catch (err) {
+    // Fallback: try common branch names
+    try {
+      execSync('git rev-parse --verify origin/main', { encoding: 'utf-8', stdio: 'ignore' });
+      return 'main';
+    } catch {
+      try {
+        execSync('git rev-parse --verify origin/master', { encoding: 'utf-8', stdio: 'ignore' });
+        return 'master';
+      } catch {
+        console.warn('Could not detect default branch, using "main" as fallback');
+        return 'main';
+      }
+    }
+  }
+}
+
+// Read package.json for version info
+const packageJson = JSON.parse(
+  fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'),
+);
+
+// Read CHANGELOG.md if it exists
+let changelogEntries = '';
+try {
+  const changelog = fs.readFileSync(path.join(__dirname, '..', 'CHANGELOG.md'), 'utf-8');
+  // Extract the latest version entries
+  const latestSection = changelog.split('##')[1];
+  changelogEntries = latestSection ? `## Latest Changes\n\n${latestSection}` : '';
+} catch (err) {
+  // No changelog
+}
+
+// Detect the default branch
+const defaultBranch = getDefaultBranch();
+
+// Get git info
+let commitMessages = '';
+try {
+  const branch = execSync('git branch --show-current', { encoding: 'utf-8' }).trim();
+
+  // Get commit messages since branching from default branch
+  const commits = execSync(`git log ${defaultBranch}..${branch} --pretty=format:"- %s"`, {
+    encoding: 'utf-8',
+  }).trim();
+
+  if (commits) {
+    commitMessages = `## Commits\n\n${commits}\n\n`;
+  }
+} catch (err) {
+  console.warn('Could not get git commit info');
+}
+
+// Get file change stats
+let changeStats = '';
+try {
+  const stats = execSync(`git diff --shortstat ${defaultBranch}...HEAD`, {
+    encoding: 'utf-8',
+  }).trim();
+
+  if (stats) {
+    changeStats = `**Changes**: ${stats}\n\n`;
+  }
+} catch (err) {
+  console.warn('Could not get change stats');
+}
+
+// Get previous version from default branch
+function getPreviousVersion() {
+  try {
+    // Try to get package.json from default branch
+    const previousPackageJson = execSync(`git show origin/${defaultBranch}:package.json`, {
+      encoding: 'utf-8',
+    });
+    const previousPkg = JSON.parse(previousPackageJson);
+    return previousPkg.version;
+  } catch (err) {
+    // Fallback: try to get the latest git tag
+    try {
+      const latestTag = execSync('git describe --tags --abbrev=0', {
+        encoding: 'utf-8',
+      }).trim();
+      // Remove 'v' prefix if present
+      return latestTag.replace(/^v/, '');
+    } catch {
+      // Fallback: try to get tags sorted by version
+      try {
+        const tags = execSync('git tag --sort=-v:refname', {
+          encoding: 'utf-8',
+        }).trim();
+        const latestTag = tags.split('\n')[0];
+        if (latestTag) {
+          return latestTag.replace(/^v/, '');
+        }
+      } catch {
+        console.warn('Could not determine previous version, using current version as fallback');
+        return packageJson.version;
+      }
+    }
+  }
+  return packageJson.version;
+}
+
+// Smart defaults based on branch name and commits
+function detectChangeType(branchName, commits) {
+  const name = branchName.toLowerCase();
+  const commitText = commits.toLowerCase();
+
+  if (name.includes('major') || commitText.includes('breaking') || commitText.includes('major:')) {
+    return 'Major';
+  } else if (name.includes('minor') || name.includes('feature') || name.includes('feat')) {
+    return 'Minor';
+  } else if (name.includes('patch') || name.includes('fix') || name.includes('hotfix')) {
+    return 'Patch';
+  }
+
+  return 'Unknown';
+}
+
+const branch = execSync('git branch --show-current', { encoding: 'utf-8' }).trim();
+const changeType = detectChangeType(branch, commitMessages);
+
+// Build the description
+let description = template;
+
+// Add summary if we have commits
+if (commitMessages) {
+  const summarySection = commitMessages.split('\n').slice(0, 5).join('\n');
+  description = description.replace(
+    'Describe the change and its motivation.',
+    `Describe the change and its motivation.\n\n${summarySection}`,
+  );
+}
+
+// Pre-check the type of change if we detected it
+if (changeType === 'Major') {
+  description = description.replace('- [ ] Major', '- [x] Major');
+} else if (changeType === 'Minor') {
+  description = description.replace('- [ ] Minor', '- [x] Minor');
+} else if (changeType === 'Patch') {
+  description = description.replace('- [ ] Patch', '- [x] Patch');
+}
+
+// Add version info
+const currentVersion = packageJson.version;
+const previousVersion = getPreviousVersion();
+description = description.replace(
+  '`X.Y.Z` → `X.Y.Z`',
+  `\`${previousVersion}\` → \`${currentVersion}\``,
+);
+
+// Add changelog entries if available
+if (changelogEntries) {
+  description += `\n\n---\n\n${changelogEntries}`;
+}
+
+// Add change stats if available
+if (changeStats) {
+  description += `\n\n${changeStats}`;
+}
+
+// Add commit history
+if (commitMessages) {
+  description += `\n${commitMessages}`;
+}
+
+// Output the description
+console.log(description);
+
+// Optionally write to file
+const outputPath = path.join(__dirname, '..', '.pr-description.md');
+fs.writeFileSync(outputPath, description);
+console.error(`\n✅ PR description written to: ${outputPath}`);
+console.error('\nTo create PR with this description:');
+console.error(`  gh pr create --body-file .pr-description.md --title "Your PR title"`);

package/scripts/generate-mcpb.ps1

@@ -0,0 +1,96 @@
+# PowerShell script to generate a .mcpb file using the official Anthropic MCPB CLI
+
+param(
+    [string]$OutputDir = "dist"
+)
+
+Write-Host "Generating YNAB MCP Server .mcpb package using official CLI..." -ForegroundColor Green
+
+# Configuration
+$PackageJson = Get-Content "package.json" | ConvertFrom-Json
+$PackageName = $PackageJson.name
+$Version = $PackageJson.version
+
+# Ensure we have a built version
+if (-not (Test-Path "dist/index.js")) {
+    Write-Host "Build not found. Running build first..." -ForegroundColor Red
+    npm run build
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "Build failed!" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# Check if official MCPB CLI is installed
+try {
+    $mcpbVersion = & mcpb --version
+    Write-Host "Using MCPB CLI version: $mcpbVersion" -ForegroundColor Green
+} catch {
+    Write-Host "MCPB CLI not found. Installing..." -ForegroundColor Yellow
+    npm install -g @anthropic-ai/mcpb
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "Failed to install MCPB CLI!" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# Ensure manifest.json exists and is valid
+if (-not (Test-Path "manifest.json")) {
+    Write-Host "manifest.json not found. Creating one..." -ForegroundColor Yellow
+    & mcpb init -y
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "Failed to create manifest!" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# Sync version from package.json to manifest.json
+Write-Host "Syncing version from package.json to manifest.json..." -ForegroundColor Yellow
+$ManifestPath = "manifest.json"
+$ManifestContent = Get-Content $ManifestPath -Raw
+$Manifest = $ManifestContent | ConvertFrom-Json
+
+if ($Manifest.version -ne $Version) {
+    Write-Host "Updating manifest version from $($Manifest.version) to $Version" -ForegroundColor Cyan
+    # Use regex to update version while preserving formatting
+    $UpdatedContent = $ManifestContent -replace '("version"\s*:\s*)"[^"]*"', "`$1`"$Version`""
+    $UpdatedContent | Set-Content $ManifestPath -NoNewline
+}
+
+# Validate the manifest
+Write-Host "Validating manifest..." -ForegroundColor Yellow
+& mcpb validate manifest.json
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "Manifest validation failed!" -ForegroundColor Red
+    exit 1
+}
+
+# Pack the MCPB using official CLI
+Write-Host "Packing MCPB file..." -ForegroundColor Yellow
+$DxtFile = "$PackageName-$Version.mcpb"
+$OutputPath = Join-Path $OutputDir $DxtFile
+
+& mcpb pack . $OutputPath
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "MCPB packing failed!" -ForegroundColor Red
+    exit 1
+}
+
+# Get file size
+if (Test-Path $OutputPath) {
+    $FileSize = (Get-Item $OutputPath).Length
+    $FileSizeKB = [math]::Round($FileSize / 1KB, 1)
+    $FileSizeMB = [math]::Round($FileSize / 1MB, 1)
+    
+    Write-Host "Created $OutputPath" -ForegroundColor Green
+    Write-Host "Size: $FileSizeKB KB ($FileSizeMB MB)" -ForegroundColor Cyan
+} else {
+    Write-Host "MCPB file was not created!" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host ""
+Write-Host "Installation Instructions:" -ForegroundColor Yellow
+Write-Host "1. Drag and drop the .mcpb file into Claude Desktop" -ForegroundColor White
+Write-Host "2. Set YNAB_ACCESS_TOKEN environment variable" -ForegroundColor White
+Write-Host "3. Restart Claude Desktop" -ForegroundColor White

package/scripts/run-domain-integration-tests.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * Runs domain-scoped integration tests with tier filtering.
+ */
+import { spawn } from 'node:child_process';
+
+const rawArgs = process.argv.slice(2);
+const separatorIndex = rawArgs.indexOf('--');
+const domainArgs = separatorIndex === -1 ? rawArgs : rawArgs.slice(0, separatorIndex);
+const passthroughArgs = separatorIndex === -1 ? [] : rawArgs.slice(separatorIndex + 1);
+
+if (domainArgs.length === 0) {
+  console.error('Usage: node scripts/run-domain-integration-tests.js <domain> [domain ...]');
+  process.exit(1);
+}
+
+const domains = domainArgs.join(',');
+const env = {
+  ...process.env,
+  INTEGRATION_TEST_TIER: 'domain',
+  INTEGRATION_TEST_DOMAINS: domains,
+};
+
+const vitestArgs = ['vitest', 'run', '--project', 'integration:domain', ...passthroughArgs];
+const runner = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+const child = spawn(runner, vitestArgs, {
+  stdio: 'inherit',
+  env,
+});
+
+child.on('close', (code) => {
+  process.exit(code ?? 1);
+});

package/scripts/run-generate-mcpb.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import process from 'node:process';
+
+if (process.env['SKIP_MCPB'] === '1') {
+  console.log('Skipping MCPB generation because SKIP_MCPB=1');
+  process.exit(0);
+}
+
+const commands = [];
+if (process.platform === 'win32') {
+  commands.push([
+    'powershell',
+    ['-ExecutionPolicy', 'Bypass', '-File', 'scripts/generate-mcpb.ps1'],
+  ]);
+  commands.push(['pwsh', ['-File', 'scripts/generate-mcpb.ps1']]);
+} else {
+  commands.push(['pwsh', ['-File', 'scripts/generate-mcpb.ps1']]);
+}
+
+for (const [cmd, args] of commands) {
+  const result = spawnSync(cmd, args, { stdio: 'inherit' });
+  if (result.status === 0) {
+    process.exit(0);
+  }
+}
+
+console.log('PowerShell is not available on this runner; skipping MCPB generation.');
+process.exit(0);