Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 68 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
name: CI

on:
pull_request:
push:
branches:
- main
- release
workflow_dispatch:

permissions:
contents: read

concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true

jobs:
verify:
name: verify (${{ matrix.os }})
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
steps:
- name: Check out repository
uses: actions/checkout@v4

- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: 22
cache: npm

- name: Set up Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: latest

- name: Install dependencies
run: npm ci

- name: Typecheck
run: npm run typecheck

- name: Test
run: npm test

- name: Build extension and webviews
run: npm run build

- name: Package universal VSIX
run: npm run package:vsix

- name: Verify packaged VSIX
run: node scripts/verify-universal-vsix.mjs

- name: Audit production dependencies
run: npm audit --omit=dev --audit-level=low

- name: Upload VSIX
if: matrix.os == 'ubuntu-latest'
uses: actions/upload-artifact@v4
with:
name: atomic-sherpa-vsix
path: releases/*.vsix
if-no-files-found: error
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,6 @@ assets/
AGENTS.md
features.md
/.atomic

!vendor/nodeatomic/dist/
!vendor/nodeatomic/dist/**
79 changes: 79 additions & 0 deletions .vault/intents/01M6PC7K2SDM98K150VEA727WJ/intent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
---
author: bradley
created_by: bradley <bradley.hilton@atomic.dev>
goals: []
id: CATA::bradley::32
kind: chore
priority: medium
project: CATA
seq: 32
status: needs-review
title: Make Atomic Sherpa 1.0.0 production ready
uid: 01M6PC7K2SDM98K150VEA727WJ
view: dev
entry_type: intent
content_hash: EYEI2YOCKBJRBLHF2JJVR7NSMTREVNINVDENKLCWVHDFYXYSTXEQ
created_at: 2026-11-05T17:31:32.785585+00:00
updated_at: 2026-11-05T17:31:32.785585+00:00
---
:::why
Atomic Sherpa 1.0.0 is the first public release. It must build from a clean checkout without a sibling nodeatomic repository, ship no known production dependency vulnerabilities, expose complete release metadata, and verify typecheck, tests, build, universal VSIX packaging, and audit in CI on macOS, Linux, and Windows.
:::

:::acceptance-criterion{#01M6PC7K2SDM98K150VEA727WJ-ac-1 status=met verifiedBy="npm ci; npm run ci:verify; npm audit --omit=dev; Bun-built Node PDF smoke; installed VSIX manifest check" evidence="npm ci passed; typecheck, 213 tests, build, universal 1.0.0 VSIX packaging and archive verification passed; production audit reports 0 vulnerabilities; Puppeteer 25 PDF export produced /tmp/sherpa-1.0.0-export.pdf; installed VSIX is 1.0.0 with sherpaIntent/sherpaAtomic namespaces."}
The repository installs and builds from a clean checkout using the vendored nodeatomic consumer; the production dependency audit reports zero vulnerabilities; package.json declares version 1.0.0, no private flag, repository/homepage/bugs metadata, and the atomicdotdev publisher.
:::

:::acceptance-criterion{#01M6PC7K2SDM98K150VEA727WJ-ac-2 status=met verifiedBy="npm ci; npm run ci:verify; npm audit --omit=dev; Bun-built Node PDF smoke; installed VSIX manifest check" evidence="npm ci passed; typecheck, 213 tests, build, universal 1.0.0 VSIX packaging and archive verification passed; production audit reports 0 vulnerabilities; Puppeteer 25 PDF export produced /tmp/sherpa-1.0.0-export.pdf; installed VSIX is 1.0.0 with sherpaIntent/sherpaAtomic namespaces."}
The CI workflow runs typecheck, tests, build, universal VSIX packaging, archive verification, and production audit on macOS, Linux, and Windows; the generated 1.0.0 VSIX contains no stale Puppeteer runtime, native payload, vendor directory, or pinned platform target.
:::

:::acceptance-criterion{#01M6PC7K2SDM98K150VEA727WJ-ac-3 status=met verifiedBy="npm ci; npm run ci:verify; npm audit --omit=dev; Bun-built Node PDF smoke; installed VSIX manifest check" evidence="npm ci passed; typecheck, 213 tests, build, universal 1.0.0 VSIX packaging and archive verification passed; production audit reports 0 vulnerabilities; Puppeteer 25 PDF export produced /tmp/sherpa-1.0.0-export.pdf; installed VSIX is 1.0.0 with sherpaIntent/sherpaAtomic namespaces."}
PDF export still works through the Puppeteer 25 ESM runtime, and the installed VSIX exposes the Sherpa command/setting/editor namespaces.
:::

:::task{#01M6PC7K2SDM98K150VEA727WJ-1 status=done criteria=01M6PC7K2SDM98K150VEA727WJ-ac-1}
Upgrade and audit production dependencies, remove unused gRPC packages, and adapt the PDF runtime to Puppeteer 25 ESM.
::file-ref{path=package.json}
::file-ref{path=package-lock.json}
::file-ref{path=src/export/puppeteerRuntime.mts}
::file-ref{path=src/export/pdfRenderer.ts}
::file-ref{path=src/extension.ts}
:::

:::task{#01M6PC7K2SDM98K150VEA727WJ-2 status=done criteria=01M6PC7K2SDM98K150VEA727WJ-ac-1}
Vendor nodeatomic so a clean checkout can install and build without a sibling repository.
::file-ref{path=vendor/nodeatomic}
::file-ref{path=.gitignore}
::file-ref{path=.vscodeignore}
::file-ref{path=scripts/build-nodeatomic.mjs}
:::

:::task{#01M6PC7K2SDM98K150VEA727WJ-3 status=done criteria=01M6PC7K2SDM98K150VEA727WJ-ac-2}
Add cross-platform build scripts and CI for typecheck, tests, build, packaging, and audit.
::file-ref{path=scripts/build-webview.mjs}
::file-ref{path=scripts/build-graph.mjs}
::file-ref{path=scripts/clean-dist.mjs}
::file-ref{path=.github/workflows/ci.yml}
:::

:::task{#01M6PC7K2SDM98K150VEA727WJ-4 status=done criteria=01M6PC7K2SDM98K150VEA727WJ-ac-2}
Finalize 1.0.0 metadata, changelog, README, and security policy.
::file-ref{path=package.json}
::file-ref{path=CHANGELOG.md}
::file-ref{path=README.md}
::file-ref{path=SECURITY.md}
::file-ref{path=THIRD_PARTY_NOTICES.md}
:::

:::scope-in
Production release hardening, reproducible clean builds, CI, dependency security, release metadata, and cross-platform packaging.
:::

:::scope-out
No new editor features, no direct atomicd RPC dependency, and no Marketplace publication from CI.
:::

:::constraint
Keep the extension a universal JavaScript-only VSIX; do not bundle native Atomic libraries or require a sibling checkout.
:::
5 changes: 5 additions & 0 deletions .vscodeignore
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,8 @@ features.md
.github/**
.vault/**
examples/**

vendor/**
tsconfig.json
flask.png
logo.png
8 changes: 7 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
# Atomic Sherpa

## Unreleased
## 1.0.0 - 2026-11-05
- Rename the extension to Atomic Sherpa (`atomic-sherpa`) and use the backpack artwork as its icon.
- Rename command, setting, and custom-editor IDs from `catalyst*` to `sherpa*` for the public release.
- Fix blast-radius hop counting, webview message validation, evidence refresh/state, SCM path isolation, oversized-blame handling, and export/editor regressions from review intents 1–14.
- Remove inherited Git editor integration; Atomic remains the SCM provider.
- Add Atomic push, pull, insert-view, and add-remote commands through the installed Atomic CLI.
- Upgrade vulnerable production dependencies (markdown-it, mermaid, sanitize-html, katex, Puppeteer, cspell, highlight.js, Shiki) and remove unused gRPC packages; `npm audit --omit=dev` is clean.
- Load Puppeteer 25 as an ESM runtime and make webview/graph build steps cross-platform.
- Add CI for typecheck, tests, build, universal VSIX packaging, and production audit; set the public `atomicdotdev` publisher metadata and 1.0.0 version.

## 0.2.12
- Package one universal, JavaScript-only VSIX; Atomic's platform library is supplied by the separate Atomic installation on the extension host.
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ There is no daemon startup, socket, direct database access, or webview native ac

## Develop and package

Build requirements: Node.js 22+/npm (for VSCE 4), Bun, a VS Code-compatible editor, and a **previously built universal nodeatomic JavaScript consumer**. The current development dependency is `file:../nodeatomic`; build that project independently using its README first. Its compiled codecs/fingerprint are bundled, so the resulting VSIX does not need that checkout. Atomic Sherpa never builds Rust or searches for Atomic producer sources. Building/packaging does not require a native library unless an explicit runtime override requests the native smoke.
Build requirements: Node.js 22+/npm (for VSCE 4), Bun, and a VS Code-compatible editor. The universal nodeatomic JavaScript consumer and its generated codecs are vendored at `vendor/nodeatomic` from revision `6e50338c1d450cef8463113198d95c61e431a0b9`, so a clean checkout builds without a sibling repository. Refresh that directory from the nodeatomic producer when its descriptor or runtime loader changes. Its compiled codecs/fingerprint are bundled, so the resulting VSIX does not need the vendor directory. Atomic Sherpa never builds Rust or searches for Atomic producer sources. Building/packaging does not require a native library unless an explicit runtime override requests the native smoke.

```sh
npm ci
Expand Down Expand Up @@ -124,8 +124,8 @@ The presentation parser never serializes the whole Markdown or YAML document. Fi

Atomic CLI generation, JSON-LD lifting, SHACL validation, signing, and verification are not reimplemented. The version control panel and evidence inspector use the backend consumers; CLI-based intent workflows, signing, and ticket attestation badges remain separate work.

Full VS Code save/recovery and external CLI synchronization testing is still required. CodeMirror normalizes line endings internally, so exact CRLF round trips through the entire editor are not yet guaranteed, although targeted edit helpers preserve CRLF.
Platform-specific VS Code/Electron host smoke testing remains a release checklist; CI covers Node-level integration, typecheck, tests, build, and universal VSIX packaging on macOS, Linux, and Windows. CodeMirror normalizes line endings internally, so exact CRLF round trips through the entire editor are not yet guaranteed, although targeted edit helpers preserve CRLF.

**Local development build, not production-ready:** the inherited dependency tree reports 22 advisories, including one critical. Review `npm audit` and harden dependencies before distribution. `sherpa-local` is a local publisher placeholder, not a registered Marketplace identity.
**Production build:** production dependencies audit clean (`npm audit --omit=dev`); the publisher is `atomicdotdev`. CI runs typecheck, tests, build, packaging, and production audit on every pull request and release branch.

Upstream revision and attribution are documented in `docs/UPSTREAM.md`; the upstream README is retained in `docs/MEO-README.md`. The original MIT `LICENSE` is retained unchanged.
26 changes: 26 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Security policy

## Supported versions

Atomic Sherpa 1.x receives security fixes. Pre-1.0 builds are unsupported.

## Reporting a vulnerability

Report vulnerabilities through a private GitHub security advisory:

https://github.com/atomicdotdev/sherpa-vscode/security/advisories/new

Do not open a public issue for an unpatched vulnerability. Include the affected
version, platform, reproduction steps, and any relevant extension-host or Atomic
runtime logs. Do not include private repository contents, identities, or tokens.

## Dependency policy

Production dependencies must pass:

```sh
npm audit --omit=dev
```

CI enforces this on every pull request and release branch. Development-only
advisories are tracked separately and do not ship in the VSIX.
11 changes: 11 additions & 0 deletions THIRD_PARTY_NOTICES.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,3 +33,14 @@ INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
THIS SOFTWARE.


## nodeatomic

The bundled `dist/nodeatomic/index.mjs` consumer is generated from
[`atomicdotdev/nodeatomic`](https://github.com/atomicdotdev/nodeatomic), revision
`6e50338c1d450cef8463113198d95c61e431a0b9`. The vendored build under
`vendor/nodeatomic` is used only at build time and is excluded from the VSIX.

nodeatomic is licensed under MIT OR Apache-2.0. The repository MIT license is in
`LICENSE`; the Apache-2.0 text is in `THIRD_PARTY_APACHE_LICENSE.txt`.
Loading
Loading