Configure named VOSpace services for Science Platform Servers

[shinybrar]

Part of Integrate upstream vosfs and fsspec-cli as canfar data.

Summary

Add the configuration model that associates one or more named VOSpace services with each Science Platform Server. This ticket owns the domain/configuration shape only.

Required changes

• Add VOSpaceService with:
  • uri: AnyUrl — registry resource identifier;
  • url: AnyHttpUrl — VOSpace base endpoint without /capabilities.
• Add Server.storage: dict[str, VOSpaceService] with an empty default.
• Keep Configuration schema version 1; existing files without storage must load unchanged.
• Treat each nested key as a globally unique Storage Name.
• Reserve local.
• Apply upstream source-name constraints: non-empty; no colon, NUL, or newline; not starting with -.
• Reject duplicate Storage Names across different servers.
• Do not duplicate the mapping key as a required field inside VOSpaceService.
• Add VOSpace Service and Storage Name to CONTEXT.md.

Acceptance criteria

• Existing v1 configurations deserialize without migration or data loss.
• Configuration JSON/YAML serialization includes stable nested storage mappings.
• Multiple storage services may belong to one server and inherit its IDP.
• Duplicate, reserved, and malformed Storage Names fail with actionable validation errors.
• Built-in/default configuration can carry a primary service without changing Server Selection semantics.
• Focused model/config tests cover round trips and every validation boundary.
• Lint and deterministic tests pass; the type check adds no diagnostics beyond the explicitly accepted 22-warning main baseline.

Out of scope

Registry discovery, credential resolution, filesystem construction, CLI registration, storage-management commands, VOSpace protocol code, and public Python storage helpers.

Delivery

Implemented through ticket PR #216 on feat/vosfs-support. Configuration head: 5f75b131. The earlier optional-extra packaging decision is superseded by parent #150: #154 will promote vosfs and fsspec-cli to normal dependencies and remove canfar[data] before landing the full epic.

---

Amended 2026-07-25

The acceptance criteria above are preserved as originally written. The items
below changed after this issue was filed, at the maintainer's request, and
shipped in #217.

• Existing configurations are healed on load. This qualifies "existing
  files without storage must load unchanged". Configuration restores the
  default CADC Storage Identifiers when a saved Server carries a legacy
  Server-Name key or no storage at all, so canfar data ls arc:/ works for
  installs predating arc/vault. The heal is scoped to the default Servers,
  leaves deliberate Storage Identifiers untouched, and normalizes in memory
  only; the file is rewritten when something independently calls save().

[shinybrar]

In flight on branch issue-151-vospace-config, based on epic branch feat/vosfs-support. Implementation scope: configuration/domain model, global Storage Name validation, focused tests, CONTEXT.md glossary entries, and the explicitly requested optional canfar[data] Git dependencies pinned to v0.6.0 and fsspec-cli-v0.5.0. The 22 existing unused-ignore type diagnostics on clean main are an accepted baseline exception and will not be changed.

[shinybrar]

Implemented on issue-151-vospace-config and opened PR #216 targeting feat/vosfs-support.

Validation:

• ruff and format checks passed
• deterministic non-slow suite passed: 759 tests
• ty matched the fixed-base result exactly: 22 pre-existing unused-ignore diagnostics, no new diagnostics
• MkDocs built successfully; contributor lookup encountered a non-fatal GitHub API rate-limit warning
• package wheel metadata contains both requested data-extra Git references
• uv.lock resolves vosfs v0.6.0 to 200eae23 and fsspec-cli v0.5.0 to ddef461b

Required fixed-base review completed along both axes. Standards found glossary implementation detail and a misleading validator name; Spec found missing URI/required-field boundary tests. All findings were fixed in 9c51603.

Commits: 1271ff8, 9c51603.