spec: INTENT-3 — dual-method registrations, method-keyed replacement, precise required-slot semantics

[JarbasAl]

Internal-purity refinement of OVOS-INTENT-3, aligning the intent model with the OVOS-INTENT-4 wire contract.

Changes

• Dual-method intents (§2): an intent is defined by one or both of the two methods. Each individual registration still uses exactly one method — the shapes are never mixed within one registration — and an intent MAY carry one registration per method, as two training-data representations of the same handler (INTENT-4 §3.2). This removes the contradiction where INTENT-3 said "exactly one method" while INTENT-4 keys registration and replacement by method.
• Method-keyed replacement (§6.1): replacement is keyed on the (skill id, intent name, language, method) quadruple; registering one method leaves the other method's registration for the same triple untouched.
• Required-slot failure (§5.3): stated precisely — when a required slot is absent from the match result, the engine MUST treat the intent as unmatched for that utterance; it MAY internally consider other templates of the same intent before concluding the intent is unmatched.
• Wording hygiene: "slots map" normalized to "slot map" throughout; the slot-typing deferral restated as out of scope alongside the normalization it depends on (matching the INTENT-1 companion change); the "this one — the last —" dependency-order aside dropped.

CHANGELOG entry appended under the spec's current class. Version field unchanged: per VERSIONING.md it is a V1/V2 compatibility class, and these refinements do not change class.

🤖 Generated with Claude Code

[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: defaults

Review profile: CHILL

Plan: Pro

Run ID: c02831cc-afda-4967-b787-b89cbffd2539

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch spec/intent-3

---

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.}