Public Target and Menu Selection Contracts

Purpose

Public target providers let Menu Manager offer real addon-owned destinations without hardcoding every addon into menu forms.

Owners

The target owner provides target records. Menu Manager stores menu items and renders navigation. It does not become the target owner.

Provider shape

A provider should declare:

• provider key and label
• surface
• target type
• kind label
• list function
• resolve function

Target shape

A target record should include:

• target identifier
• target label
• target description
• resolved route
• URL preview
• target state
• availability
• metadata
• access metadata when restricted

Good behavior

Only expose targets that are real and resolvable. If a page is archived, a space inactive, or a feature disabled, the target record should not pretend everything is fine.

Verification

After adding a target provider, verify Menu Manager can list the target and the resolved route returns HTTP 200.