Skip to content

Skills link the Jams they make: resources and relations - #25

Merged
baransu merged 4 commits into
masterfrom
tomasz/jam-resources-relations
Oct 28, 2026
Merged

baransu merged 4 commits into
masterfrom
tomasz/jam-resources-relations

Conversation

@baransu

@baransu baransu commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Jam CLI 1.32.0 and the MCP server now ship resources (URLs on a Jam) and relations between Jams. The skills use them.

  • jam-proof: a new "Link" step after recording. It attaches the PR, ticket or CI run with jam update jam --resource and marks a fix Jam --mark-related <bug> --type fixes, or proves / relates_to. This replaces pasting the bug Jam's URL into a comment.
  • jam-fix: an "after" Jam is marked as fixes of the reported Jam. When posting on the Jam was requested, the PR goes on as a resource. CLI commands are in references/cli.md.
  • jam-to-e2e: the "after" Jam is marked fixes (bug) or proves (flow) of the source Jam, and the PR is attached.
  • jam-annotate: attaches the PR or ticket, and joins one-Jam-per-UI-state sets with relates_to.
  • jam-proof-table: marks a fix check as fixes of its original Jam only when its row says works; broken or unconfirmed rows get relates_to at most.
  • jam-to-ticket: offers a comment with the ticket link, and on a yes also attaches the ticket as a resource.

Comment and link where it helps. Every skill that works from a Jam (jam-fix, jam-proof, jam-to-e2e, jam-to-tasks, jam-to-ticket, jam-proof-table) offers one comment on that Jam when the run settled something a viewer should know (a cause found, a fix landed, a ticket filed, a test added, a check that failed), and posts it on a yes. Inconclusive or local-only runs skip the offer. Linking happens only when there is something to link: a pull request, ticket or CI run, or a verified fix.

  • docs/plugin.md and the CHANGELOG are updated.

Relations from a Jam the agent created run without asking and add a "fixed by" backlink to the bug Jam. Resources on someone else's Jam ride on the yes to the comment. Every step warns against attaching URLs that carry tokens, because share pages can be public.

jam-proof and jam-annotate changed, so the Jam CLI bundle needs a resync after merge.

node scripts/check.mjs passes.

jam-proof, jam-fix, jam-to-e2e and jam-annotate attach the PR, ticket or
CI run as a resource and mark a proof Jam as fixes/proves of the bug Jam,
via jam update jam --resource/--mark-related (CLI 1.32.0) or the
addResource/markRelated MCP tools.
@baransu
baransu force-pushed the tomasz/jam-resources-relations branch from cc100da to 92e7eba Compare October 27, 2026 22:49
devin-ai-integration[bot]

This comment was marked as resolved.

Addresses Devin review: fixes only for a fix check that works, jam-to-ticket
keeps the comment path, jam-annotate passes --type relates_to explicitly.
@baransu
baransu merged commit 9e0db32 into master Oct 28, 2026
1 of 2 checks passed
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