Skip to content

Port upstream pstack 0.15.42 - #66

Merged
caelaxie merged 2 commits into
mainfrom
cursor/port-pstack-0-15-42-00a0
Nov 16, 2026
Merged

caelaxie merged 2 commits into
mainfrom
cursor/port-pstack-0-15-42-00a0

Conversation

@caelaxie

@caelaxie caelaxie commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

summary

Ports upstream cursor/plugins#1236 (pstack/ only) from 0.15.36 at c742dd61706fbacc1b95f1a20b7b988cf096ce6c to 0.15.42 at bf0c7cd80abdbf7fe47b634978a7d1b4071f71a7.

The monorepo range also contains commits outside pstack/. Those are not in this port. harness/pstack/claude-code/ is not ported. This repo does not ship docs/harness/, so the Claude Code adapter edit in #1236 has no file here.

what landed

  • why is one short file. Its references, investigators, synthesizer, and model roles are gone. recall starts its own investigator per source. blast-radius and teach no longer point at parts why no longer has.
  • how is one file and one read-only subagent. Poteto-mode no longer runs how on the nontrivial-change trigger. Investigation, Feature, Bug fix, Hillclimb, Perf issue, Refactoring, architect, no-comments, and comment-sicko trace the code themselves. Benny traces directly and no longer requires how. teach and poteto-help still catalog how.
  • sharpen asks the rewritten prompt to prototype any choice an experiment can settle. reflect's drifting-detail example is a function rename.
  • Statechart: when SANY XML fails, check() reruns SANY in plain mode and reports that run's error section, capped at 40 lines. Mermaid arrows from outside a parent state end at the parent's border. The start marker still continues to the inner state.
  • Version 0.15.42.

antigravity-only adaptations

  • Version bump is only in .antigravity-plugin/plugin.json. This port has no root plugin.json and no .cursor-plugin manifest.
  • how spawns invoke_subagent with TypeName: "research" (read-only). recall's per-source investigators use TypeName: "self", because research has no MCP tools. Existing path, tool, and transcript adaptations stay.
  • invoke_subagent still takes pro, flash, flash_lite, or inherit, so the new slugs map onto those tiers. Code delegates (feature, refactoring, bug-fix, perf-issue, hillclimb), prose, and judgment are pro. The hardest-tasks role stays pro: Antigravity has no tier above pro, so claude-fable-5-2-max and claude-opus-5-5-xhigh are the same tier. Swarm workers and reflect tooling stay flash. Review and design panels stay pro, flash. There is no third tier for the upstream fable / opus / gemini panel.
  • Budgets move each role from its own default on flash_lite < flash < pro. large keeps the default. unlimited raises one step, capped at pro. medium lowers one step. small lowers two. inherit, inherit-parent, and auto stay. setup-pstack writes # defaults: 2. A rule without that line is an older setup. It names grok-* once as an old slug. Old flash defaults on the code-delegate roles take pro. Other chosen values stay. The how and why roles are dropped.
  • arena, swarm, and reflect already stated those tiers, so their default lines did not need new wording. The reflect synthesizer example did change.

harness proof

Head 210afbe6c9a7b1732946a5c4e882d4ecf6bf66be. agy 1.5.9. Commands ran on this commit. Statechart sources are unchanged from d045f325ce86b8eaf68ca40a38e84395e448e1cb, where the suite was 340 tests, 270 pass, 0 fail, 70 skipped (TLC corpus runs skip without TLA2TOOLS).

$ agy --version
1.5.9

$ agy plugin validate --strict .
Validating pstack (.antigravity-plugin/plugin.json)
  skills 61 · agents 2 · rules 0 · hooks 0 · mcpServers 0 · sidecars 0
✔ Validation passed

$ agy plugin install https://github.com/pstack-ports/agy-pstack/tree/cursor/port-pstack-0-15-42-00a0
Cloning plugin from https://github.com/pstack-ports/agy-pstack.git...
  [ok]    pstack
          ✔ skills      : 61 installed
          ✔ agents      : 2 installed (comment-sicko, poteto-agent)

$ agy plugin list
Installed plugins:
- pstack (enabled, 0.15.42)
    Source:     antigravity
    Components: 61 skills, 2 agents

$ git -C "$AGY_HOME/.gemini/config/plugins/pstack" rev-parse HEAD
210afbe6c9a7b1732946a5c4e882d4ecf6bf66be

Loaded skills include how, why, recall, setup-pstack, sharpen, reflect, poteto-mode, poteto-help, statechart, teach, blast-radius, architect, arena, no-comments, and swarm. Benny's three skills are in the installed tree under automations/benny/skills/ with valid frontmatter. They are not registered slash skills. Strict validate of the installed copy passed. The repo CI structural check printed Validated 61 skills, 2 agents, and 23 playbooks.

$ bash -n skills/poteto-mode/scripts/worktree-audit.sh
$ bash -n skills/show-me-your-work/scripts/log.sh

$ bun run typecheck   # skills/poteto-mode/scripts, bun 1.4.4
$ bun run test        # 62 pass, 0 fail
Open in Web Open in Cursor 

Bring in cursor/plugins#1236 (bf0c7cd) for the pstack tree: one-file why and how, new default model tiers, statechart SANY and Mermaid fixes, and the sharpen and reflect text. Antigravity paths and model tiers stay.

Co-authored-by: Kaitian Xie <caelaxie@users.noreply.github.com>

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changes requested.

three minimum-parity issues on head d045f325 against upstream bf0c7cd. the rest of the port holds: sanctioned antigravity layout, .antigravity-plugin/plugin.json 0.15.42, embedded skills identical, no cursor-team-kit, why/how collapse and statechart parity pass, and green ci plus agy 1.5.9 install/list on this head.

  1. skills/setup-pstack/SKILL.md step 3(b) still assigns every role flash at medium and every role flash_lite at small, instead of lowering each role from its own default on flash_lite < flash < pro. large keeps; unlimited raises one capped; medium lowers one (pro→flash, flash→flash_lite, each panel entry too); small lowers two; inherit / inherit-parent / auto stay. docs/guide/01-setup.md needs the same per-role rule, and should drop the added verification/trivial-edits wording that is not upstream.
  2. skills/poteto-help/SKILL.md rewrites the close-call line without a harness need. restore exactly: /how explains what the code does. /why explains the reasons. /teach runs one or both and explains the result plainly.
  3. the README model paragraph adds swarm workers, verification, and trivial edits go to flash. which is absent upstream. delete that sentence and keep the required tier substitutions in the remaining clauses.

please fix these and ping for re-review. no merge until they land.

Comment thread skills/setup-pstack/SKILL.md Outdated
- `small - flash_lite reasoning`

**(b) Apply it.** Build the working table from the skill defaults, and on a re-run keep any role you changed by tier, list, or alias (`inherit`, `inherit-parent`, `auto`). `unlimited` upgrades `flash` roles to `pro`. `large` keeps the skill defaults (`pro` for judgment, prose, and hardest tasks; `flash` for fast code, explorer, investigator, and worker roles). `medium` sets every role to `flash`. `small` sets every role to `flash_lite`. `inherit`, `inherit-parent`, and `auto` do not change.
**(b) Apply it.** Build the working table from the skill defaults, and on a re-run keep any role you changed by tier, list, or alias (`inherit`, `inherit-parent`, `auto`). `unlimited` upgrades `flash` roles to `pro`. `large` keeps the skill defaults (`pro` for code delegates, judgment, prose, and hardest tasks; `flash` for swarm workers, reflect tooling, verification, and trivial mechanical edits). `medium` sets every role to `flash`. `small` sets every role to `flash_lite`. `inherit`, `inherit-parent`, and `auto` do not change.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this still flattens every role to flash at medium and flash_lite at small. budget relative to each role's own default on flash_lite < flash < pro: large keeps; unlimited raises one capped; medium lowers one (pro→flash, flash→flash_lite, each panel entry too); small lowers two; inherit / inherit-parent / auto stay. also drop the added "verification, and trivial mechanical edits" wording from the large-default list; it is not upstream.

Comment thread docs/guide/01-setup.md Outdated
[`/setup-pstack`](../../skills/setup-pstack/SKILL.md) detects the model tiers you want to use, asks for a reasoning budget, shows you each role (code delegates, judgment, the review panels), and asks what you want. Answer the questions. It writes `~/.gemini/config/rules/pstack-models.md`, a small rule every pstack skill reads.

The defaults use `flash` for code-writing and exploration delegates and `pro` for deep reasoning and judgment. `unlimited` and `large` use `pro` for judgment and `flash` for fast execution; `medium` and `small` shift roles down toward `flash` and `flash_lite` to spend fewer tokens.
The defaults are the same as the `large` budget. Code delegates, prose, and judgment use `pro`, and the hardest changes do too. Swarm workers, verification, and trivial edits use `flash`. `unlimited` upgrades `flash` roles to `pro`. `large` keeps that split. `medium` and `small` shift roles toward `flash` and `flash_lite` and spend fewer tokens.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this needs the same per-role budget rule as setup-pstack step 3(b), not a vague shift toward flash and flash_lite. also delete the added "Swarm workers, verification, and trivial edits use flash." wording; it is not upstream. keep the required tier substitutions in the remaining clauses.

Comment thread skills/poteto-help/SKILL.md Outdated
Close calls:

- `/how` explains what the code does. `/why` explains the reasons. `/teach` runs one or both and explains the result plainly.
- `/how` explains what the code does, with one read-only subagent. `/why` answers from the record, not the code. `/teach` runs one or both and explains the result plainly.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this rewrites the upstream close-call line without a harness need. restore exactly:

/how explains what the code does. /why explains the reasons. /teach runs one or both and explains the result plainly.

Comment thread README.md Outdated
new here? the [pstack guide](./docs/guide/README.md) walks you through a first real task, from setup and prompting through verification and overnight runs. stuck, or unsure which skill fits? ask [`/poteto-help`](./skills/poteto-help/SKILL.md).

that's it. the other skills are situational, and the mode skill uses them for you as needed. out of the box the mode splits work by model strength: code delegates (feature, refactoring, bug fix, perf, hillclimb) go to flash, while the hardest changes, prose, and judgment go to pro. the default panel is pro / flash. [`/setup-pstack`](./skills/setup-pstack/SKILL.md) changes any of it.
that's it. the other skills are situational, and the mode skill uses them for you as needed. out of the box the mode splits work by model strength: code delegates (feature, refactoring, bug fix, perf, hillclimb), prose, and judgment go to pro, and the hardest changes do too. swarm workers, verification, and trivial edits go to flash. the default panel is pro / flash. [`/setup-pstack`](./skills/setup-pstack/SKILL.md) changes any of it.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

delete the added sentence swarm workers, verification, and trivial edits go to flash. it is absent upstream. keep the required tier substitutions in the remaining clauses.

Medium and small move each role from its own default on the tier ladder. Restore the poteto-help close call and drop the README and guide sentences that were not in upstream.

Co-authored-by: Kaitian Xie <caelaxie@users.noreply.github.com>
@cursor

cursor Bot commented Nov 16, 2026

Copy link
Copy Markdown

The three notes are in 210afbe6c9a7b1732946a5c4e882d4ecf6bf66be. Ready for re-review. Not merged.

  1. setup-pstack step 3(b) and docs/guide/01-setup.md now move each role from its own default on flash_lite < flash < pro. large keeps the default. unlimited raises one step, capped at pro. medium lowers one (pro to flash, flash to flash_lite, each panel entry too). small lowers two. inherit, inherit-parent, and auto stay. The extra verification and trivial-edits wording is gone.
  2. The poteto-help close call is restored exactly: /how explains what the code does. /why explains the reasons. /teach runs one or both and explains the result plainly.
  3. The README sentence about swarm workers, verification, and trivial edits is deleted. The remaining clauses keep the tier substitutions.

Harness proof on this head: agy 1.5.9, strict validate passed, install of this branch lists pstack 0.15.42 with 61 skills and 2 agents, installed SHA 210afbe6c9a7b1732946a5c4e882d4ecf6bf66be. poteto-mode typecheck and 62 tests passed. Statechart sources are unchanged from the previous run (340 tests, 270 pass, 0 fail, 70 TLC skips).

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pass.

the four notes are fixed on head 210afbe. setup-pstack 3(b) and the setup guide now move each role from its own default on flash_lite < flash < pro (large keeps, unlimited raises one capped at pro, medium lowers one including each panel entry, small lowers two; inherit / inherit-parent / auto stay), and the extra verification/trivial-edits wording is gone. the poteto-help close-call is restored verbatim. the added readme sentence is deleted, with the required tier substitutions kept. the follow-up is +4/-4 on just those four files. validate plugin is green on this head, and the pr body has agy 1.5.9 install/list/validate with the installed sha 210afbe. not a draft. merging.

@caelaxie
caelaxie merged commit 004c5e9 into main Nov 16, 2026
1 check passed
@caelaxie
caelaxie deleted the cursor/port-pstack-0-15-42-00a0 branch November 16, 2026 02:03
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.

2 participants