USER-ID-1: user identity resolution specification

[JarbasAl]

Closes #53

What this PR adds

spec/user-id/ovos-user-id-1.md — new specification for user identity resolution and authentication levels at the bus protocol layer.

Companion edit: ovos-session-1.md — seven new fields added to the §2.1 field registry.

Spec summary

Skills read session.user_id and session.auth_level from the message they receive on dispatch — no query round-trip, no race condition. The recognition plugin (transformer chain, standalone service, or bridge injection) populates the fields before the utterance enters the pipeline.

Four enrolled signals → four opaque session IDs:

• voice_id — voice-print match (audio transformer, pre-STT)
• face_id — face-print match (out-of-band camera plugin; site_id selects camera)
• name_id — self-declaration match ("I am Alice"; utterance transformer, post-STT)
• passphrase_id — secret-phrase match (utterance transformer, post-STT)

auth_level 0–5: anonymous → configured default → self-declared → single biometric → multi biometric → explicit credential.

Identity persists within a session — once established, auth_level carries forward without re-recognition; skills can prompt for an upgrade via CONVERSE-1 response_mode.

Layer-2 bridges may inject all fields directly (e.g. authenticated chat interface, single-user satellite terminal via default_user_id).

Files changed

File	Change
spec/user-id/ovos-user-id-1.md	New spec (~400 lines including non-normative examples)
ovos-session-1.md	+7 rows in §2.1 field registry

Related

• Builds on: MSG-1, SESSION-1, SESSION-2, TRANSFORM-1, BRIDGE-1, CONVERSE-1, AUDIO-IN-1
• AUDIO-IN-1 (PR OVOS-AUDIO-IN-1: Audio Input Service Specification #51) gets a companion cross-reference edit on its own branch

[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: fca3cdc0-650a-46c8-b111-c3bcf0b8a606

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/user-id

---

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

[JarbasAl]

Merge-ready (MERGEABLE, dev merged in). Template conformance: header present, RFC-2119 boilerplate present, sections numbered 1–9, See also section. Fixed: USER-ID-1 was absent from README spec table and CHANGELOG — both added. Cross-references to OVOS-SESSION-1, OVOS-TRANSFORM-1, OVOS-BRIDGE-1 are forward-pointing specs (correct for an in-review spec). Note: after #55 merges, GLOSSARY.md in this branch will need ovos-intent-*.md links updated.