Skip to content

Stop promising not_found for a topic_id passed to seen, unseen or move - #426

Merged
jeremy merged 4 commits into
mainfrom
fanB-396
Sep 10, 2026
Merged

Stop promising not_found for a topic_id passed to seen, unseen or move#426
jeremy merged 4 commits into
mainfrom
fanB-396

Conversation

@jeremy

@jeremy jeremy commented Sep 9, 2026

Copy link
Copy Markdown
Member

Refs #396 (does not close it — the fix that issue asks for is on HEY's side)

What is wrong

The skill says a topic_id passed to hey move answers not_found, and that passing the wrong kind of id to any posting command answers not_found. Neither is true for hey seen, hey unseen or hey move: HEY's /postings/seen, /postings/unseen and /postings/moves endpoints scope the requested ids to the identity's postings and answer success whatever matched, and there is no per-posting read the CLI could check against. hey trash, hey spam and the label/folder commands do 404 when nothing matches, which is where the general claim came from. That false promise is what let an agent trust several days of silently no-op'd marks in #396.

Change

Documentation only: the two ID notes in skills/hey/SKILL.md now say which commands cannot report a non-match yet and how to confirm one (hey box view --json). No client-side pre-check is added — that is a server change (a 404 when none of the ids belong to the identity, and a per-id result for a partial batch), recorded against the API separately; once it lands the CLI surfaces it as not_found unchanged.


Summary by cubic

Updates skills/hey/SKILL.md to stop promising not_found for a topic_id passed to hey seen, hey unseen, or hey move. Those commands ignore unmatched ids, act on any that do match, and answer success regardless, so a mixed batch is a partial success reported as whole. Docs now show confirming a mark with hey box view <box> --json --all, reading every page (including the cursor and notice) so a posting past the first page isn't mistaken for a non-match. Docs only, no behavior change; cleans up the misleading promise that let an agent trust no-op'd marks (refs #396, does not close it).

Written for commit 5c50e3d. Summary will update on new commits.

Review in cubic

Copilot AI balanced review requested due to automatic review settings September 9, 2026 23:26
@jeremy
jeremy requested a review from a team as a code owner September 9, 2026 23:26
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 9, 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-10T18:54:51.017319Z 5c50e3d New commits
ℹ️ 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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The recommended verification command omits its required box argument and only displays help.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates agent guidance to accurately describe silent no-ops when incorrect IDs are passed to posting commands.

Changes:

  • Documents affected commands and verification guidance.
  • Clarifies which commands still return not_found.

[!TIP]
If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

File summaries
File Description
skills/hey/SKILL.md Corrects ID-error behavior guidance.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread skills/hey/SKILL.md Outdated

@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: 04c6e4f83f

ℹ️ 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 skills/hey/SKILL.md Outdated
Comment thread skills/hey/SKILL.md Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The verification recipe can still misclassify capped listings and ID collisions.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Balanced

Comment thread skills/hey/SKILL.md Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

The documentation accurately reflects the command behavior and handles pagination ambiguity.

Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 0 new
  • Review effort level: Balanced

HEY's seen, unseen and moves endpoints scope the requested ids to the
identity's postings and answer success whatever matched, and there is no
per-posting read to check against, so the CLI cannot answer not_found
for a wrong-kind id there. The skill said it does, which is what let an
agent trust a week of no-op marks (hey-cli#396). Say what actually
happens and how to confirm, until HEY reports the non-match.
@jeremy
jeremy merged commit f3cd88f into main Sep 10, 2026
23 checks passed
@jeremy
jeremy deleted the fanB-396 branch September 10, 2026 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants