Artifact [27950a92fe]

Artifact 27950a92fe0d5bc88bbbfcc2194ea96cc2cb3f6b7f3314db043ca1152e96eb87:

• File Makefile — part of check-in [fb2f393a1e] at 2026-08-15 23:02:23 on branch trunk — docs: API reference generated from the registry; staleness gate

  quarry docs + make docs; TestDocsCurrent fails when docs/api.md drifts (0003: documentation is a phase exit criterion). (user: dmestas, size: 944) [annotate] [blame] [check-ins using]

# Local gates — run before every commit. CI (dagnats, later) runs the same.
.PHONY: check test vet build fixtures fixtures-real spec-lint docs

check: vet test build

# Spec correctness gate (0003 §2): lint the generated OpenAPI document with
# an off-the-shelf validator. Dev/CI tool only — never a runtime dep.
spec-lint:
	go run ./cmd/quarry spec > /tmp/quarry-spec.json
	go run github.com/daveshanley/[email protected] lint --no-banner --no-style --fail-severity error /tmp/quarry-spec.json

# API reference, generated from the op registry (0003: docs are a phase
# exit criterion). TestDocsCurrent fails the build when this is stale.
docs:
	go run ./cmd/quarry docs > docs/api.md

# Synthetic disposability fixture (fast; the CI corpus).
fixtures:
	fixtures/build-synthetic.sh

# Real corpus (sqlite, tcl) — large clones, opt-in.
fixtures-real:
	fixtures/build-real.sh

test:
	go test ./...

vet:
	go vet ./...

build:
	go build ./...