Publishing & Development

Publishing & Development Guide

Reference guide for building, testing, and distributing the Antigravity Usage Intelligence extension.

---

🛠️ Local Development Setup

1. Prerequisites

• Node.js: v18.0.0 or higher
• npm: v9.0.0 or higher
• Python: v3.8 or higher
• VS Code or Antigravity IDE

2. Clone & Install

git clone https://github.com/Nir-Bhay/antigravity-usage-intelligence.git
cd antigravity-usage-intelligence
npm install

3. Running Prepublish Verification Tests

npm test

This tests:

1. extension.js Node syntax (node -c).
2. src/quota_detector.js Node syntax (node -c).
3. collector.py Python bytecode compilation (python -m py_compile).

---

📦 Packaging VSIX

To build a standalone .vsix distribution package:

npx @vscode/vsce package --no-git-tag-version

This produces antigravity-usage-intelligence-<version>.vsix containing only production assets:

• extension.js
• collector.py
• package.json
• README.md
• CHANGELOG.md
• LICENSE
• assets/icon.png (128x128px icon)
• assets/icon.svg
• assets/demo.png
• src/quota_detector.js
• src/ui/dashboard.html

---

🚀 Publishing to Registries

1. Open VSX Registry (Eclipse Foundation)

Open VSX powers alternative editors including Cursor, VSCodium, Windsurf, Trae, Gitpod, and Theia.

• Namespace: nirbhay-hiwse
• CLI Publish Command:

  npx ovsx publish antigravity-usage-intelligence-<version>.vsix -p <OPEN_VSX_PAT>

• Web Listing: https://open-vsx.org/extension/nirbhay-hiwse/antigravity-usage-intelligence

2. Visual Studio Code Marketplace (Microsoft)

• Publisher ID: nirbhay-hiwse
• Web Management Portal: marketplace.visualstudio.com/manage
• Drag & drop upload: Direct .vsix upload under publisher nirbhay-hiwse.
• CLI Publish Command:

  npx @vscode/vsce publish -p <AZURE_DEVOPS_PAT>

---

🤖 Automated CI/CD Publishing Pipeline

The repository includes an automated GitHub Actions pipeline (.github/workflows/publish.yml):

• Triggers:
  • On GitHub Release published
  • On Git tag pushed (v*)
  • Manual dispatch via GitHub Actions tab
• Automated Steps:
  1. Runs cross-platform syntax and compilation tests.
  2. Packages the clean .vsix.
  3. Publishes to Open VSX using secrets.OVSX_PAT.
  4. Publishes to Visual Studio Marketplace if secrets.VSCE_PAT is configured.
  5. Uploads the .vsix asset directly to the GitHub Release.