Skip to content

UPSTREAM.md

Latest commit

 

History

History
44 lines (31 loc) · 2.3 KB

UPSTREAM.md

File metadata and controls

44 lines (31 loc) · 2.3 KB
Raw

Upstream synchronization

open-pstack tracks Cursor's pstack while adapting Cursor-specific primitives for Claude Code and Codex.

Current sync point

Source Value
Repository https://github.com/cursor/plugins.git
Path pstack/
Commit bdf7aa355337897f167153e05069aca505dae17c
Upstream version 0.14.3
open-pstack version 1.2.0

The table above is the current Cursor sync point. Open Pstack 1.2.0 consolidates this 0.14.3 sync. README-UPSTREAM.md preserves its pstack README verbatim. CHANGES.md and NOTICE.md describe the adaptations and provenance.

Check for changes

The repository already names Cursor's repository as the cursor remote in the maintainer checkout. A fresh clone can add it once:

git remote add cursor https://github.com/cursor/plugins.git

Fetch and inspect only commits that touched pstack after the recorded sync point:

git fetch cursor main
git log --oneline bdf7aa355337897f167153e05069aca505dae17c..cursor/main -- pstack
git diff --stat bdf7aa355337897f167153e05069aca505dae17c..cursor/main -- pstack

No output means the tracked pstack tree has not changed. This comparison does not need a polling service or generated mirror branch.

Incorporate a change

  1. Create or update a GitHub issue in ericlitman/open-pstack and branch from current main.
  2. Read each upstream pstack commit in order. Bring over its intent and content, then apply only the Claude Code and Codex substitutions documented in CHANGES.md.
  3. Keep one shared plugins/pstack/skills/ tree. Put harness translation in the existing codex-tools.md and provider routing in provider-dispatch.md; do not fork a skill per harness.
  4. Update the commit and version in this file, the affected provenance rows in NOTICE.md, and README-UPSTREAM.md when upstream changes it.
  5. Run CI-equivalent checks locally, then run the installed Claude Code and Codex behavioral lanes required by the changed surface. Unit tests alone are not a release gate.
  6. Merge the reviewed PR before tagging the next open-pstack release.

Cursor's version and open-pstack's version are independent. Cursor's version identifies the imported content; open-pstack's version identifies the cross-harness distribution.