Table of Contents generated with DocToc

• spec-status-index
  • Prerequisites
  • Usage
  • Statuses
  • Run tests

spec-status-index

Capability: substrate:framework-dev + substrate:analytics

Harness: agnostic

A deterministic uv tool that reads spec-loop specs from tools/spec-loop/specs/ and prints them grouped by status, so build iterations can choose the next work item mechanically.

Prerequisites

• Runtime: Python 3.11+ run via uv; stdlib-only (no runtime dependencies). The dev group pulls pytest.
• CLIs: None beyond the runtime.
• Credentials / auth: None.
• Network: Runs fully offline; reads spec files from tools/spec-loop/specs/ on the local filesystem.

Usage

# All specs, grouped by status
uv run --project tools/spec-status-index spec-status

# Only actionable items (proposed + experimental)
uv run --project tools/spec-status-index spec-status --ready

# Filter to a specific status
uv run --project tools/spec-status-index spec-status --status proposed

# Machine-readable JSON output
uv run --project tools/spec-status-index spec-status --json
uv run --project tools/spec-status-index spec-status --ready --json

Statuses

--ready surfaces proposed and experimental specs — the ones with actionable build work remaining.

Run tests

uv run --project tools/spec-status-index --group dev pytest