HCS v0.2.0 — Initial Public Release

The first public release of the Holistic Code Specification (HCS) Interpreter's Guide and Fact ABI.

What's included

25 core fact types covering code structure, API routes, security boundaries, data models, SQL, events, integrations, infrastructure, and testing
9 COBOL extension fact types for mainframe systems: copybook resolution, record layouts, JCL jobs, CICS transactions, file resources, EXEC blocks, program metadata, compile directives, and confidence reporting
100 canonical patterns across 5 groups (UI, API, Security, Data, Reliability & Ops) with full expansion contracts
5 reference documents: Overview, Language Reference, Intermediate Model, Fact Types, Patterns

Fact ABI highlights

Deterministic factId generation via SHA-256 of canonical key fields
Three reproducibility levels: Compiler-grade (A), Cross-referenced (B), Heuristic (C)
NDJSON streaming format — one fact per line, append-safe, resilient to partial failures