# Workspace Metadata Template
# This file tracks workspace version, compatibility, and migration history

# Workspace identification
workspace:
  name: "{{ workspace_name }}"
  path: "{{ workspace_path }}"

# Version information
version:
  # Provisioning system version when workspace was created/updated
  provisioning: "{{ system_version }}"

  # Schema version for KCL definitions
  schema: "1.0.0"

  # Workspace directory structure format version
  workspace_format: "2.0.0"

# Timestamps
created: "{{ created_timestamp }}"
last_updated: "{{ updated_timestamp }}"

# Migration history
# Records all migrations applied to this workspace
migration_history: []
# Example migration record:
# - from_version: "2.0.0"
#   to_version: "2.0.5"
#   migration_type: "metadata_initialization"
#   timestamp: "2025-10-06T12:00:00Z"
#   success: true
#   notes: "Initial metadata creation"

# Compatibility requirements
compatibility:
  # Minimum provisioning version required to use this workspace
  min_provisioning_version: "2.0.0"

  # Minimum schema version required
  min_schema_version: "1.0.0"

  # Maximum supported provisioning version (optional)
  # max_provisioning_version: "3.0.0"

# Workspace features
features:
  # Workspace switching support
  workspace_switching: true

  # Version tracking support
  version_tracking: true

  # Migration framework support
  migration_framework: true

# Custom metadata (optional)
# Add workspace-specific metadata here
custom: {}