orcaflex-spec-audit

name	orcaflex-spec-audit
description	Audit, classify, and score OrcaFlex spec.yml files across the model library for quality, schema validity, and structure type categorization.
type	reference
version	1.0.0
updated	"2026-02-11T00:00:00.000Z"
category	engineering
triggers	["audit spec library","classify OrcaFlex specs","spec quality score","categorize models","template catalog"]
capabilities	[]
requires	[]
see_also	[]
tags	[]

OrcaFlex Spec Library Audit

Audit and classify all spec.yml files in the OrcaFlex library. Scores quality (0-100), validates against ProjectInputSpec schema, and infers structural category from path and content signals.

Usage

# Basic audit (YAML output)
uv run python scripts/audit_spec_library.py

# With HTML report
uv run python scripts/audit_spec_library.py --html benchmark_output/spec_audit.html

# Custom root directory
uv run python scripts/audit_spec_library.py --root docs/modules/orcaflex/library/templates

Quality Scoring (0-100)

Criterion	Points	Check
Schema valid	+30	ProjectInputSpec(**data) passes
Has comments	+20	Lines starting with #
Meaningful name	+15	Not temp/single-char/digits-only
Meaningful description	+10	Not "Extracted from...", not "generic", len >= 10
No raw_properties	+15	environment.raw_properties absent
Compact file	+10	< 1000 lines

Category Inference

Priority order:

1. Schema key: riser: key -> riser, pipeline: key -> pipeline
2. Path parts: tier2_fast -> riser, jumper -> jumper, training -> training
3. Model library prefix: a=riser, b=drilling, c=mooring, d-g=installation, h=heavy_lift, k=wind_turbine, l=vessel, m=pipeline
4. Metadata fallback: metadata.structure field value

Output

YAML (audit_results.yaml)

summary:
   
   
   
   { ,  ,  , }