Skip to content

Prepare Atomic Sherpa 1.0.0 production release - #5

Merged
graywolf336 merged 5 commits into
fix/review-findings-intents-1-9from
production-readiness
Nov 5, 2026
Merged

graywolf336 merged 5 commits into
fix/review-findings-intents-1-9from
production-readiness

Conversation

@graywolf336

@graywolf336 graywolf336 commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Stacked on #4 (fix/review-findings-intents-1-9). Merge #4 first, then this branch into release (or retarget this PR to release after #4 lands).

Summary

Production-readiness pass for the first public Atomic Sherpa release, version 1.0.0.

Reproducible clean builds

  • Vendored the nodeatomic JavaScript consumer and generated codecs at vendor/nodeatomic from revision 6e50338c1d450cef8463113198d95c61e431a0b9.
  • Changed the dependency from file:../nodeatomic to file:vendor/nodeatomic, so npm ci works from a clean checkout without a sibling repository.
  • Added the vendored package notice and third-party attribution.
  • Vendor files are excluded from the VSIX; only the bundled dist/nodeatomic/index.mjs ships.

Dependency security

  • Upgraded vulnerable production dependencies: markdown-it, mermaid, sanitize-html, katex, Puppeteer, cspell, highlight.js, and Shiki.
  • Added transitive katex and uuid overrides.
  • Removed unused @grpc/grpc-js and @grpc/proto-loader packages.
  • npm audit --omit=dev now reports 0 vulnerabilities (was 26, including one critical).

Build and packaging

  • Moved the Puppeteer runtime to ESM for Puppeteer 25; the PDF export path now loads dist/puppeteer-runtime.mjs.
  • Added cross-platform Node-based webview and graph build scripts; removed a stale CJS Puppeteer bundle from packaging.
  • Added a clean dist step before extension builds.
  • VSIX is 5.79 MB, 110 files, universal JavaScript-only.

Release metadata

  • Version 1.0.0, removed private, added repository/homepage/bugs metadata.
  • Finalized CHANGELOG.md for 1.0.0.
  • Replaced the “not production-ready” README warning with the production audit/CI statement.
  • Added SECURITY.md.

CI

New .github/workflows/ci.yml runs on macOS, Linux, and Windows:

  • npm ci
  • typecheck
  • 213 tests
  • build
  • universal VSIX packaging and archive verification
  • npm audit --omit=dev

Verification

Check Result
Clean npm ci pass
npm run typecheck pass
npm test 213 pass, 0 fail
npm run build pass
npm run package:vsix pass; 1.0.0 universal VSIX
node scripts/verify-universal-vsix.mjs pass
npm audit --omit=dev 0 vulnerabilities
Puppeteer 25 PDF smoke pass (/tmp/sherpa-1.0.0-export.pdf)
Installed VSIX 1.0.0; sherpaIntent.* / sherpaAtomic.*; no catalyst identifiers

CI

All three checks pass on macOS, Linux, and Windows at daf89c6. The workflow runs once per pull request; push is limited to main and release to avoid duplicate PR-branch runs.

  • typecheck
  • 213 tests
  • build
  • universal VSIX packaging
  • archive verification
  • npm audit --omit=dev

Known release checklist

  • Platform-specific VS Code/Electron host smoke remains manual; CI exercises Node, build, and packaging on all three OS targets.
  • CI does not publish to the Marketplace. Publishing still requires the atomicdotdev Marketplace identity and a VSIX upload.

Intent

CATA::bradley::32

@graywolf336
graywolf336 added this pull request to stack #6 November 5, 2026 17:47
@graywolf336
graywolf336 merged commit 4715a5e into release Nov 5, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant