Skip to content

Retire the identity-field workaround - #60

Merged
amnotyoung merged 1 commit into
mainfrom
retire-identity-field-workaround
Aug 13, 2026
Merged

Retire the identity-field workaround#60
amnotyoung merged 1 commit into
mainfrom
retire-identity-field-workaround

Conversation

@amnotyoung

Copy link
Copy Markdown
Owner

Why

#59 told readers to put id and name in every fields array, because the gateway blocked any array without them. amnotyoung/io-mcp#61 has shipped and is verified against production — the gateway fills both in, and nothing blocks.

Instructions written against a defect outlive it badly. They read as requirements rather than as workarounds, and the next person spends effort satisfying one that no longer exists.

Change

The three Skill files return to their pre-#59 wording:

  • both blocked-response sections lose the fields step they gained
  • korean-oda-portfolio-lookup step 4 and the comparison workflow, and international-oda-data-lookup route 2, stop naming id and name beside description

Net diff against the pre-#59 baseline is a single added bullet:

+ - `id` and `name` arrive whether or not you list them. Every item has to carry both, so the
+   gateway fills them into any `fields` array before the call leaves. The response echoes the
+   applied set, which is why it can come back longer than what you asked for.

That one is kept because it is still true and was never documented: the echoed fields can be longer than the request, which is otherwise a surprise with no explanation anywhere in the Skill.

amnotyoung/io-mcp#62 (empty projections) needs no Skill change — it removed a false claim from responses rather than adding a rule for callers to follow.

Version 0.2.28 → 0.2.29; npm test 27/27.

🤖 Generated with Claude Code

#59 told readers to put id and name in every `fields` array because the
gateway blocked any array without them. amnotyoung/io-mcp#61 shipped, so
the gateway fills both in and nothing blocks. Instructions written
against a defect outlive it badly: they read as requirements, and the
next person spends time satisfying one that no longer exists.

Restores the three Skill files to their pre-#59 wording — the
blocked-response sections lose the fields step they gained, and the
callers that named id and name alongside description drop them again.

Keeps one line, because one thing #59 found is still true and was never
written down: every item carries id and name, so they come back whether
or not the caller lists them. That is why the response echo can be
longer than the request, which is otherwise a surprise with no
explanation anywhere.

The empty-projection fix (amnotyoung/io-mcp#62) needed no Skill change:
it removed a false claim from responses rather than adding a rule for
callers to follow.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@amnotyoung
amnotyoung merged commit dc43fff into main Aug 13, 2026
2 checks passed
@amnotyoung
amnotyoung deleted the retire-identity-field-workaround branch August 13, 2026 08:09
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