docs(oracle-parser): document the two parse_type_phrase grammars

[JacobWoodson]

Summary

Splits the .claude/skills/oracle-parser/SKILL.md change out of #7396, per the
maintainer review on that PR: .agents/pr-review-policy.toml classifies
.claude/skills/** as a [hard_stops] path, so agent-instruction changes must
not ride along with an implementation PR.

#7396 has been force-pushed with this hunk removed and is now hard-stop clear.

What this documents

oracle_nom::target::parse_type_phrase and oracle_target::parse_type_phrase
are two different readers with the same name, and picking the wrong one silently
changes which cards a characteristic head accepts:

	Strict — oracle_nom::target	Legacy — oracle_target
Return	OracleResult<'_, TargetFilter> = (remainder, filter)	(TargetFilter, &str) = (filter, remainder)
Failure	Err	Infallible — empty TypedFilter + whole input (not TargetFilter::Any, so an Any guard does not catch it)
Type-list join	" or " only	" or ", " and ", " and/or " and comma forms
Ownership / token / combat-relation grammar	no	yes

Both signatures verified against current main:
crates/engine/src/parser/oracle_nom/target.rs:41 and
crates/engine/src/parser/oracle_target.rs:2135.

Ordering constraint

Merge this after #7396. The closing paragraph references
TypePhraseGrammar, the typed parameter #7396 introduces in
oracle_nom/quantity.rs. That symbol does not exist on main today
(git grep TypePhraseGrammar origin/main -- crates/ is empty), so landing this
first would leave a dangling reference. Opened as a draft for that reason.

Verification

Documentation only — no code, no build surface. The two-grammar facts in the
table were re-read against origin/main rather than carried over from #7396.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 62382fcd-0372-4150-adc1-0aacb9fb6c11

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[matthewevans]

Changes requested — explicit human maintainer review required.

At current head 9710204f5c4c3980b209f665eb27dddbbbe4f610, this external-contributor PR changes protected instruction path .claude/skills/oracle-parser/SKILL.md. Repository policy classifies .claude/skills/** as a hard-stop path. I have not implementation-reviewed or approved this change. Please obtain an explicit human maintainer review before any further automated handling.