Skip to content

Make Relay briefs action-shaped#157

Merged
nahiyankhan merged 3 commits into
mainfrom
codex/relay-brief-now
Jun 18, 2026
Merged

Make Relay briefs action-shaped#157
nahiyankhan merged 3 commits into
mainfrom
codex/relay-brief-now

Conversation

@nahiyankhan

@nahiyankhan nahiyankhan commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

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 hook
  • pnpm test: passed manually and in pre-push hook, 375 tests
  • pnpm check: passed manually, in pre-commit, and in pre-push hook
  • node packages/ghost/dist/bin.js lint .ghost: passed, 0 errors / 0 warnings / 0 info
  • node packages/ghost/dist/bin.js verify .ghost --root .: passed, 0 errors / 0 warnings / 0 info
  • git diff --check origin/main...HEAD: passed

Changeset: 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 failures
  • node packages/ghost/dist/bin.js review --base origin/main --include-memory: advisory packet generated successfully
File 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.actionContract and 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.

@nahiyankhan nahiyankhan changed the title Polish Relay brief formatting Make Relay briefs action-shaped Jun 17, 2026
@nahiyankhan nahiyankhan force-pushed the codex/relay-brief-now branch from 0995e15 to 20b959f Compare June 18, 2026 05:34
@nahiyankhan nahiyankhan marked this pull request as ready for review June 18, 2026 13:13
@nahiyankhan nahiyankhan requested a review from chailandau June 18, 2026 13:13
@nahiyankhan nahiyankhan merged commit 2a64b76 into main Jun 18, 2026
6 checks passed
@github-actions github-actions Bot mentioned this pull request Jun 18, 2026
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