space-lint

What problem does it solve?

Validates Anteroom space YAML files before registration to catch schema, URL, pack, pack_source, instruction, and config issues early, preventing failed loads, accidental commits of machine-specific settings, and insecure or inconsistent team-shared spaces.

Core Features & Use Cases

• Comprehensive Schema Validation: Parses YAML and reports schema errors, missing version, and malformed fields.
• Repository and URL Checks: Ensures repo and pack_source URLs use allowed schemes, appear to be valid git URLs, and flags duplicates.
• Pack and Config Reviews: Verifies pack reference formats, branch and refresh_interval constraints, and warns about misplaced top-level config keys and instruction length problems.
• Git Context Awareness: Detects whether the space file is inside a git repo and warns if .local.yaml is not gitignored to avoid committing machine-specific data.
• Use Case: Run before committing or loading a team or personal space file to surface errors and warnings so you can fix them prior to registration.

Quick Start

Validate the space YAML file at ~/.anteroom/spaces/example.yaml to report schema problems and configuration warnings before loading it.