Make Relay briefs action-shaped#157
Merged
Merged
Conversation
0995e15 to
20b959f
Compare
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Category: improvement
User Impact: Agents get clearer, action-oriented Relay briefs before generating or reviewing product-surface work.
Problem: Relay selected useful fingerprint refs, but the brief still made host agents infer the immediate actions from contextual detail. When multiple applicable refs were selected, the capped shortlist could also lean on canonical order instead of the most target-relevant anchors.
Solution: Add a deterministic Task Contract to Relay gather output with preserve, inspect, avoid, and validate actions. The PR also improves identity-list readability, relevance-ranks selected refs for path-matched Relay briefs, and refreshes Ghost's own fingerprint anchors so exemplars point at live source files.
Validation:
pnpm build: passed manually after rebase and in pre-push hookpnpm test: passed manually and in pre-push hook, 375 testspnpm check: passed manually, in pre-commit, and in pre-push hooknode packages/ghost/dist/bin.js lint .ghost: passed, 0 errors / 0 warnings / 0 infonode packages/ghost/dist/bin.js verify .ghost --root .: passed, 0 errors / 0 warnings / 0 infogit diff --check origin/main...HEAD: passedChangeset: added minor changeset for the public Relay Task Contract addition and patch changesets for Relay readability, fingerprint anchor cleanup, and relevance-aware shortlisting.
Ghost Review:
node packages/ghost/dist/bin.js check --base origin/main: PASS, no active deterministic check failuresnode packages/ghost/dist/bin.js review --base origin/main --include-memory: advisory packet generated successfullyFile changes
.changeset/action-shaped-relay-briefs.md
Adds a minor release note for the new Relay Task Contract output.
.changeset/bright-relay-shortlists.md
Adds a patch release note for relevance-aware Relay selected-ref ordering.
.changeset/clean-relay-briefs.md
Adds a patch release note for Relay brief readability and refreshed fingerprint anchors.
.ghost/fingerprint/composition.yml
Updates the compact-agent-handoff evidence path to the current context module location.
.ghost/fingerprint/inventory.yml
Refreshes Ghost inventory building blocks and exemplar paths for the Relay/context modules.
.ghost/fingerprint/prose.yml
Updates evidence paths that moved out of the old scan/context folder.
packages/ghost/src/context/entrypoint-markdown.ts
Renders readable identity bullets and inserts the Task Contract before detailed selected refs.
packages/ghost/src/context/entrypoint.ts
Adds
entrypoint.actionContractand relevance-aware selected-ref ordering for path-matched Relay context.packages/ghost/test/cli.test.ts
Covers Relay Markdown and JSON output for the new Task Contract shape.
packages/ghost/test/context-entrypoint.test.ts
Covers action contract derivation, Markdown placement, readable identity formatting, proposed-check exclusion, and relevance ranking.
packages/ghost/test/dogfood-fingerprint.test.ts
Adds dogfood coverage that Ghost's own fingerprint verifies cleanly.
Screenshots/Demos: N/A, CLI/JSON behavior only.