Skip to content

Maintenance & On-Call

SuperJS v1.0 uses a solo-path maintenance model until a co-maintainer is enrolled (see README solo-path gates). This document satisfies Stage 6 exit criterion R10 and references RELEASING.md (C8).

Scope

In scopeOut of scope
@superjsorg/cli, @superjsorg/compiler, LSP, published @superjs/* packagesApplication code compiled by SuperJS
Docs site, playground workernpm registry infrastructure
Security advisories per SECURITY.mdTrademark / legal

On-call rotation (solo path)

Until a co-maintainer is named:

  • Primary: repository maintainer (@hbarve1).
  • Backup triage: GitHub Discussions volunteers tagged help-wanted for non-critical issues.
  • Escalation: critical security → rotate credentials immediately; file GitHub Security Advisory.

When a co-maintainer joins, update this section with names and a weekly rotation schedule.

SLAs (v1.0.x)

Aligned with RELEASING.md:

SeverityTriagePatch target
Critical (RCE, data loss, publish compromise)< 48 h< 1 week
High (DoS compiler/LSP, sandbox escape)< 3 business daysNext patch release
Medium / lowBest effortScheduled minor

Security reports follow the 24 h triage / 7 day critical patch bar in SECURITY.md.

Triage labels

LabelMeaning
severity=blockerBlocks RC or GA; fix before next tag
severity=criticalSecurity or data-loss; on-call SLA
type=regressionWorked in previous release

RC cycle accepts blocker fixes only between rc.N tags (see RELEASING.md).

Patch release checklist

  1. Reproduce on main with minimal fixture.
  2. Fix + test (pnpm nx run-many -t test in superjs/).
  3. Changeset or changelog entry.
  4. Verify bench targets: node scripts/check-bench-results.mjs.
  5. Tag vX.Y.Zrelease-npm.yml publishes with provenance.
  6. GitHub Release + advisory if security-related.

Monitoring (first week post-GA)

  • npm download trend (npm view superjs version)
  • GitHub Issues opened/day, severity=* count
  • Playground smoke (if Worker deployed): scripts/smoke-playground-run.mjs

Last updated: 2026-06-24.

Documentation