Spectral Wizard

Independent Spectral package for the backend-backed Wizard catalog and tools.

Install

npm install @aexol/wizard-spectral

Spectral loads the extension through package metadata:

{
  "spectral": {
    "extensions": ["./dist/extensions"]
  }
}

CLI auth

spectral-wizard login
spectral-wizard status
spectral-wizard logout

login starts a localhost PKCE browser login, exchanges the authorization code with the Wizard backend, and stores auth at ~/.config/wizard-spectral/config.json by default. status reports backend/config/auth state without exposing tokens. logout clears stored auth.

Environment overrides:

• SPECTRAL_WIZARD_BACKEND_ORIGIN — Wizard backend origin.
• SPECTRAL_WIZARD_WORKSPACE_SLUG — workspace slug override.
• SPECTRAL_WIZARD_AUTH_STATE_PATH — auth/config path override.
• SPECTRAL_WIZARD_SESSION_TOKEN — ephemeral session token override.
• OPENCODE_WIZARD_BACKEND_ORIGIN — optional backend-origin fallback only.

Release

@aexol/wizard-spectral is released separately and does not require another Wizard plugin package at runtime.

Run the package release check before tagging:

npm run wizard-spectral:release:check

Use tag format wizard-spectral-v<version> and the GitLab manual publish wizard spectral job for npm publication.

Tools

The extension registers Spectral tool names backed by Wizard GraphQL APIs:

• wizard_status
• wizard_catalog_fetch
• wizard_artifact_fetch
• wizard_artifact_preference_set
• wizard_published_skills_fetch
• wizard_published_skill_preference_set
• wizard_report_issue
• wizard_editor_update_report

Catalog/status metadata is discovery-only; fetch artifact or skill bodies before treating Wizard instructions as authoritative. Report tools submit source: SPECTRAL and submittedVia: wizard-spectral and only send explicitly supplied safe summary fields.