Skip to content

docs(portable): re-verify Cursor 3.18.25 Agent Plugins gaps, prepare vendor report, and record the spec watch (#426) - #443

Merged
ScriptedAlchemy merged 3 commits into
mainfrom
chore/426-portable-followups
Sep 3, 2026
Merged

docs(portable): re-verify Cursor 3.18.25 Agent Plugins gaps, prepare vendor report, and record the spec watch (#426)#443
ScriptedAlchemy merged 3 commits into
mainfrom
chore/426-portable-followups

Conversation

@ScriptedAlchemy

@ScriptedAlchemy ScriptedAlchemy commented Sep 3, 2026

Copy link
Copy Markdown
Owner

Summary

Delivers the from-this-side work for #426 (portable Agent Plugins follow-ups carried over from #307):

  • Cursor feedback prepared. docs/audits/2026-09-03-cursor-agent-plugins-feedback.md is a ready-to-submit Cursor bug report: spec citations (Agent Plugins 1.0.0 §7.2.1 / §9.1 / §9.2), observed payloads and paths, expected behaviour, a three-file minimal repro plugin, and the exact submission URLs (forum Bug Reports category / Feature Requests / hi@cursor.com). The maintainer submits it; this repo cannot post on their behalf.
  • Dogfood re-run on the current build. docs/audits/2026-09-03-agent-plugins-cursor-ide-proof.md records the portable-target IDE dogfood on the installed Cursor 3.18.25 (realCommit 280eca29…af3, the same build as the 2026-09-02 proof; no newer stable release is installed or listed in the rendered changelog) in an isolated instance (dedicated HOME/--user-data-dir, Xvfb, 1440×900 captures, none during loading). Install paths: emitted install.mjs (local: installed → already-installed), install.mjs --mode marketplace (fails closed for Agent Plugins packs, by design), agent-bundle install cursor --mode local|marketplace (AB7001: Cursor Plugin entry point only), Doctor (AB7320, 0 errors). Cursor discovers the plugin, its skill and its mcp.json, attributes no hooks to it (pack ships none; Hooks tab shows none), and still fails to launch the spec-shaped stdio server; with ${CURSOR_PLUGIN_ROOT} the same server reaches connect_success.
  • Gaps re-verified, three added. Five single-variable probe plugins reproduce gaps 1–3 byte-for-byte (spawn node ENOENT for cwd: "${PLUGIN_ROOT}", Cannot find module '<HOME>/${PLUGIN_ROOT}/…' for args, default cwd = HOME) and add: ${PLUGIN_ROOT}/${PLUGIN_DATA} unexpanded in env values (§9.2), reserved PLUGIN_ROOT/PLUGIN_DATA variables absent (§9.1), ./ commands resolved against the workspace folder (§7.2.1). Nothing is fixed, so no capability row moves to supported; portable-1.0.0.json mcp.evidence gains the dated line.
  • Spec watch. Live 1.0.0 schemas rehash to the pins (1805 / 3408 bytes); agentplugins/agent-plugins-spec main unchanged at ff8ab5e39, no tags or releases; spec/1.1.0.md is still "Working Draft" with in-repo schemas differing only in version strings and agent-plugins.org/schemas/1.1.0/* → 404. PROVENANCE.json re-verification dated 2026-09-03 (test pins follow), and a dated spec-watch row is added to the parked follow-ups ledger in docs/effect-conventions.md.

Evidence

  • Captures: docs/assets/agent-plugins-cursor-proof/2026-09-03-*.png (1440×900).
  • Log excerpts and the probe matrix: docs/audits/2026-09-03-agent-plugins-cursor-ide-proof.md §3.
  • Changeset: .changeset/426-portable-followups.md (patch; mcp evidence + provenance text; AB6038 now reads "re-verified 2026-09-03").

Test plan

  • pnpm typecheck — exit 0
  • pnpm lint — 0 errors, 0 warnings
  • pnpm rstest --config rstest.unit.config.ts adapter-metadata / portable-adapter / portable-plugin-validation — pass
  • pnpm test:unit — 3007 passed, 0 failed
  • pnpm test:host-install:build — 19 passed, 2 pre-existing opt-in skips (live Claude/Codex sessions)
  • pnpm docs:site:build — exit 0 (typecheck, build, dead-link and language-parity checks; generated hosts page consumes the capability JSON)

Review status

  • 45227980b: Codex opened 3 threads (name AB6038 in the changeset; qualify the "no server can start" claim; ship launch.sh in the repro) — fixed in fe6060b45, replied, resolved.
  • fe6060b45: Codex re-review, "Didn't find any major issues."
  • 736d63236 (rebase onto 10a98a0fb, fix(doctor): validate the Cursor hooks document the manifest names (#438) #442): Codex opened 1 thread (stale three-file count in the intro) — fixed in 927ee6a55, replied, resolved.
  • 927ee6a55 (head): Codex re-review, "Didn't find any major issues." No unreviewed SHAs; 0 unresolved threads.

@changeset-bot

changeset-bot Bot commented Sep 3, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 927ee6a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
agent-bundle Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@ScriptedAlchemy

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 3, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-03T20:28:09.020211Z 927ee6a Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@pkg-pr-new

pkg-pr-new Bot commented Sep 3, 2026

Copy link
Copy Markdown
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle@443
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/create-agent-bundle@443
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/@agent-bundle/runtime@443

commit: 927ee6a

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 45227980b0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .changeset/426-portable-followups.md Outdated
Comment thread docs/audits/2026-09-03-cursor-agent-plugins-feedback.md Outdated
Comment thread docs/audits/2026-09-03-cursor-agent-plugins-feedback.md Outdated
ScriptedAlchemy added a commit that referenced this pull request Sep 3, 2026
@ScriptedAlchemy

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. What shall we delve into next?

Reviewed commit: fe6060b45d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…vendor report, and record the spec watch (#426)

Re-run the portable-target Cursor IDE dogfood on the current installed build
in an isolated instance (dedicated HOME/user-data-dir, Xvfb, 1440x900):
the emitted pack installs through its own install.mjs (marketplace mode fails
closed for Agent Plugins packs; `agent-bundle install cursor` refuses them
with AB7001), Cursor discovers the plugin, its skill and its mcp.json, attributes
no hooks to it, and still fails to launch the spec-shaped stdio server. Five
single-variable probe plugins reproduce the cwd/args/default-cwd gaps and add
three observations (env values unexpanded, PLUGIN_ROOT/PLUGIN_DATA absent,
./ commands resolved against the workspace).

- docs/audits/2026-09-03-agent-plugins-cursor-ide-proof.md: dogfood re-run
  with captures and log excerpts; the 2026-09-02 note gains a dated
  re-verification section.
- docs/audits/2026-09-03-cursor-agent-plugins-feedback.md: ready-to-submit
  Cursor bug report (spec citations, payloads, expected behaviour, minimal
  repro plugin, submission URLs).
- portable-1.0.0.json mcp.evidence: dated 2026-09-03 line; no row changes
  state because nothing was fixed.
- schemas/portable/PROVENANCE.json: 2026-09-03 re-verification (live 1.0.0
  schemas rehash to the pins; spec repo HEAD unchanged, no tags/releases;
  1.1.0 remains an unpublished working draft), test pins updated.
- docs/effect-conventions.md: dated Agent Plugins spec-watch row in the
  parked follow-ups ledger.
@ScriptedAlchemy

Copy link
Copy Markdown
Owner Author

@codex review

@ScriptedAlchemy
ScriptedAlchemy force-pushed the chore/426-portable-followups branch from fe6060b to 736d632 Compare September 3, 2026 20:18

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 736d632369

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/audits/2026-09-03-cursor-agent-plugins-feedback.md Outdated
@ScriptedAlchemy

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Breezy!

Reviewed commit: 927ee6a558

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ScriptedAlchemy
ScriptedAlchemy merged commit 9bb5d0d into main Sep 3, 2026
13 checks passed
@ScriptedAlchemy
ScriptedAlchemy deleted the chore/426-portable-followups branch September 3, 2026 20:39
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