stdlib_coverage.json

{
  "schemaVersion": 1,
  "asOf": "2026-07-17",
  "supportMatrix": "lib/hxruby/support_matrix.json",
  "rubyBranches": [
    "3.3",
    "3.4",
    "4.0"
  ],
  "scope": {
    "unit": "Ruby library domain",
    "completeness": "curated-not-whole-stdlib",
    "statement": "Implemented means the listed RubyHx facade and evidence exist for a bounded domain; it never means every API in the Ruby library is typed."
  },
  "rbsGeneration": {
    "scope": "strict-precise-or-omitted-subset",
    "implementation": [
      "lib/hxruby/rbs/source_parser.rb",
      "lib/hxruby/rbs/haxe_extern_renderer.rb",
      "lib/hxruby/rbs/extern_generator.rb",
      "lib/hxruby/rbs/cli.rb"
    ],
    "command": "ruby -Ilib scripts/rbs/generate-extern.rb",
    "evidence": "npm run test:rbs-generator",
    "claim": "generator-infrastructure-not-library-coverage"
  },
  "distributionKinds": {
    "core": "Constants and methods available without a require or separate gem contract.",
    "standard-library": "Libraries shipped with Ruby but not represented by a RubyGems default or bundled gem specification.",
    "default-gem": "Libraries shipped as default gems that may be upgraded independently.",
    "bundled-gem": "Libraries installed with Ruby as ordinary gems and not guaranteed by a minimal Ruby installation outside the tested distribution.",
    "platform-specific": "Libraries whose availability depends on the operating system or architecture and is outside the canonical cross-platform facade promise."
  },
  "coverageStatuses": {
    "implemented-public": "A supported app-facing ruby.* facade exists with focused generated-shape and runtime evidence.",
    "implemented-internal": "A typed target primitive exists for RubyHx internals but is not marketed as an app-facing library facade.",
    "implemented-convenience": "A Haxe-owned opt-in convenience exists while the underlying Ruby contract remains separately available.",
    "planned": "The domain is prioritized but no supported facade is claimed yet.",
    "deferred": "The domain is deliberately outside the current portable or canonical-platform contract."
  },
  "domains": [
    {
      "id": "core.array-binary",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-internal",
      "surfaces": [
        "ruby.ArrayPacking",
        "ruby.BinaryFormat"
      ],
      "facadePaths": [
        "std/ruby/ArrayPacking.hx",
        "std/ruby/BinaryFormat.hx"
      ],
      "evidence": [
        "npm run test:unitstd-ruby",
        "npm run test:stdlib-mvp"
      ],
      "runtimeProbe": {
        "constants": [
          "Array"
        ]
      },
      "notes": "Typed pack directives and receiver contracts support Bytes, FPHelper, and compression without becoming a general Array facade."
    },
    {
      "id": "core.array-iteration",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-internal",
      "surfaces": [
        "ruby.NativeIterator"
      ],
      "facadePaths": [
        "std/ruby/NativeIterator.hx"
      ],
      "evidence": [
        "npm run test:unitstd-ruby"
      ],
      "runtimeProbe": {
        "constants": [
          "Array"
        ]
      },
      "notes": "The target-local iterator bridges Ruby arrays into Haxe iterator contracts and is not an app-facing Enumerable promise."
    },
    {
      "id": "core.directory",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Dir"
      ],
      "facadePaths": [
        "std/ruby/Dir.hx"
      ],
      "evidence": [
        "npm run test:dir-facade"
      ],
      "runtimeProbe": {
        "constants": [
          "Dir"
        ]
      },
      "notes": "The public facade covers a precise non-block, single-pattern subset of core Dir."
    },
    {
      "id": "core.exception",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.StandardError"
      ],
      "facadePaths": [
        "std/ruby/StandardError.hx"
      ],
      "evidence": [
        "npm run test:exception-flow",
        "npm run test:components"
      ],
      "runtimeProbe": {
        "constants": [
          "StandardError"
        ]
      },
      "notes": "The nominal constant supports typed exception references; it does not claim the full Ruby exception hierarchy."
    },
    {
      "id": "core.file-io",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.File"
      ],
      "facadePaths": [
        "std/ruby/File.hx"
      ],
      "evidence": [
        "npm run test:filesystem-parity",
        "npm run test:tempfile-facade"
      ],
      "runtimeProbe": {
        "constants": [
          "File"
        ]
      },
      "notes": "The public facade exposes bounded class and nominal instance IO while portable sys.io.File remains Haxe-owned."
    },
    {
      "id": "core.hash",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-internal",
      "surfaces": [
        "ruby.NativeHash",
        "ruby.NativeHashData",
        "ruby.NativeHashEntry"
      ],
      "facadePaths": [
        "std/ruby/NativeHash.hx",
        "std/ruby/NativeHashData.hx",
        "std/ruby/NativeHashEntry.hx"
      ],
      "evidence": [
        "npm run test:unitstd-ruby",
        "npm run test:stdlib-mvp"
      ],
      "runtimeProbe": {
        "constants": [
          "Hash"
        ]
      },
      "notes": "Typed Hash storage backs Haxe maps; raw operations remain local target seams rather than an app-facing Hash API."
    },
    {
      "id": "core.output",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-convenience",
      "surfaces": [
        "ruby.Kernel",
        "ruby.Prelude"
      ],
      "facadePaths": [
        "std/ruby/Kernel.hx",
        "std/ruby/Prelude.hx"
      ],
      "evidence": [
        "npm run test:hello-world",
        "npm run test:ruby-interop"
      ],
      "runtimeProbe": {
        "constants": [
          "Kernel"
        ]
      },
      "notes": "Kernel preserves Ruby conversion while Prelude is an explicit Haxe-stringification convenience; their semantics stay distinct."
    },
    {
      "id": "core.regexp",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.MatchData",
        "ruby.MatchOffset",
        "ruby.Regexp",
        "ruby.RegexpCompileOptions",
        "ruby.RegexpOptions"
      ],
      "facadePaths": [
        "std/ruby/MatchData.hx",
        "std/ruby/MatchOffset.hx",
        "std/ruby/Regexp.hx",
        "std/ruby/RegexpCompileOptions.hx",
        "std/ruby/RegexpOptions.hx"
      ],
      "evidence": [
        "npm run test:regexp-facade"
      ],
      "runtimeProbe": {
        "constants": [
          "Regexp",
          "MatchData"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-supported-ruby-sources",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "core/regexp-and-match-data",
        "sources": [
          {
            "path": "core/regexp.rbs",
            "sha256": "08802060f3dadb312c579d45c531e1839b86d3ba242f1d296f2498f32e70aa69"
          },
          {
            "path": "core/match_data.rbs",
            "sha256": "b7e331c5eaedc74905a78de8d75b47289453d20ded644282fc1c730b34ee7277"
          }
        ],
        "implementationSources": [
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_3_11",
            "path": "re.c",
            "sha256": "05950daa8c7e7bb2cceb2e1a36fbd5a05dcd772b38afaa2e8bfc4b70490e6e45"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_4_10",
            "path": "re.c",
            "sha256": "3842f4b60fce8e669acd607e8964f0c4e59cf694e22be97ccfe13ee1c86a9bae"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v4.0.0",
            "path": "re.c",
            "sha256": "e316d5a3835c48699c279a4ad67dcd07d397f6ae079849cadb4df8058938b112"
          }
        ],
        "curation": "Construction accepts String patterns and a closed composable set of IGNORECASE, EXTENDED, and MULTILINE options, with an optional per-instance Float timeout. Matching accepts String targets and character offsets; results expose indexed nullable captures, character-offset pairs, capture-name inventories, and read-only native metadata. Arbitrary option integers, encoding flags, unchecked named lookup, byte offsets, ranges, heterogeneous unions/value lists, block overloads, mutable class timeout, and global last-match access are omitted."
      },
      "notes": "The require-free core facades preserve direct Ruby Regexp and MatchData behavior. Haxe EReg remains a separate stateful Haxe-semantics wrapper and reuses only the exact typed escape and native match-result seams."
    },
    {
      "id": "core.string-binary",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-internal",
      "surfaces": [
        "ruby.BinaryString"
      ],
      "facadePaths": [
        "std/ruby/BinaryString.hx"
      ],
      "evidence": [
        "npm run test:unitstd-ruby",
        "npm run test:stdlib-mvp"
      ],
      "runtimeProbe": {
        "constants": [
          "String"
        ]
      },
      "notes": "Result-specific binary receiver contracts support exact bit and byte operations without exposing open unpack results."
    },
    {
      "id": "core.symbol",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Symbol"
      ],
      "facadePaths": [
        "std/ruby/Symbol.hx"
      ],
      "evidence": [
        "npm run test:ruby-interop"
      ],
      "runtimeProbe": {
        "constants": [
          "Symbol"
        ]
      },
      "notes": "The nominal abstract models Ruby symbol values used by typed interop calls."
    },
    {
      "id": "core.time",
      "distributionByRuby": {
        "3.3": "core",
        "3.4": "core",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Time"
      ],
      "facadePaths": [
        "std/ruby/Time.hx"
      ],
      "evidence": [
        "npm run test:time-date-facade"
      ],
      "runtimeProbe": {
        "constants": [
          "Time"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-supported-ruby-sources",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "core/time",
        "sources": [
          {
            "path": "core/time.rbs",
            "sha256": "9d92a72807f77b3e99dc6a2cc81af626020134a0502bc7ab2af73cb62932a448"
          }
        ],
        "implementationSources": [
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_3_11",
            "path": "time.c",
            "sha256": "93fb89a9ee88ad5c75ce3961e10c88cf5b7263d7fde1fa75a17327bd743c17e9"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_4_10",
            "path": "time.c",
            "sha256": "ddda824b9064bbd9369920c87fb16e3d3098409c982ec512b1af5159adce22fe"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v4.0.0",
            "path": "time.c",
            "sha256": "c873177ab42db9198e68b8fa84bdb14c718f8de1e6ec5934fb311f8697308558"
          }
        ],
        "curation": "Factories narrow open Numeric/month-name/timezone overloads to concrete Haxe Int and Float values. The facade exposes one-based calendar components, fixed-offset and local/UTC non-mutating copies, epoch conversion, formatting, and typed seconds arithmetic/difference. Subsecond-unit overloads, named timezone objects, mutation, parsing extensions, heterogeneous arrays, open coercions, and unchecked keywords are omitted."
      },
      "notes": "The public require-free core facade preserves native Ruby Time semantics and direct operator output; it is deliberately distinct from the Haxe-semantic std/ruby/_std/Date.hx wrapper."
    },
    {
      "id": "library.csv",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "bundled-gem",
        "4.0": "bundled-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.CSV",
        "ruby.CSVGenerateOptions",
        "ruby.CSVParseOptions",
        "ruby.CSVRow"
      ],
      "facadePaths": [
        "std/ruby/CSV.hx",
        "std/ruby/CSVGenerateOptions.hx",
        "std/ruby/CSVParseOptions.hx",
        "std/ruby/CSVRow.hx"
      ],
      "evidence": [
        "npm run test:csv-facade"
      ],
      "runtimeProbe": {
        "require": "csv",
        "gem": "csv",
        "constants": [
          "CSV"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-official-ruby-api",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "stdlib/csv/0",
        "sources": [
          {
            "path": "csv.rbs",
            "sha256": "2fbb9994a76341f58a075115c060e960156db2a8dacc575608741d701e398fcb"
          }
        ],
        "rubyDocumentation": "https://docs.ruby-lang.org/en/3.3/CSV.html",
        "curation": "Header and converter modes, IO inputs, open modes, encodings, arbitrary field objects, replacement values, and unchecked keyword splats are omitted. Header-free no-converter rows narrow to Array<Null<String>>. RBS v4.0.3 owns parse/read/foreach row types and documents generation; official Ruby CSV singleton documentation plus MRI runtime evidence owns generate_line/generate_lines, whose singleton signatures are absent from that RBS release."
      },
      "notes": "The bounded public facade covers nullable string rows, whole-string and file parsing, streaming file iteration, generation, and string-preserving typed options. CSV remains a default gem on Ruby 3.3 and a bundled gem on Ruby 3.4/4.0, so support does not imply availability in arbitrary minimal Ruby installations."
    },
    {
      "id": "library.date",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Date"
      ],
      "facadePaths": [
        "std/ruby/Date.hx"
      ],
      "evidence": [
        "npm run test:time-date-facade"
      ],
      "runtimeProbe": {
        "require": "date",
        "gem": "date",
        "constants": [
          "Date"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-supported-ruby-sources",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "stdlib/date/0",
        "sources": [
          {
            "path": "stdlib/date/0/date.rbs",
            "sha256": "76fda61f0f8930f799b597cbf6fb91c39e5df3cb9bca7ceed8ee20a55edc8cf6"
          }
        ],
        "implementationSources": [
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_3_11",
            "path": "ext/date/date_core.c",
            "sha256": "10448f4a2748f806a11b1587c6c5a0ffcda4badd852a923eaa48977958f7f8bd"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_4_10",
            "path": "ext/date/date_core.c",
            "sha256": "5a8850b04651721187810a0676a6203c0317aec483f6cff7dcdd7bcbd8ad6400"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v4.0.0",
            "path": "ext/date/date_core.c",
            "sha256": "c924c97b67cbe87cb1d1f48197547bfd5d0ecc2007bab5788505908a6b744aa5"
          }
        ],
        "curation": "Civil construction requires a concrete year and narrows optional month/day values to Int. Parsing is limited to strict iso8601 and explicit-format strptime. Calendar components, leap-year queries, formatting, and integer day/month/year movement remain direct. Permissive parse, reform-start arguments, Rational arithmetic and values, DateTime, conversion families, enumerators/blocks, and unchecked numerics are omitted."
      },
      "notes": "The public require-backed facade preserves Ruby civil-date and one-based-month semantics without claiming Haxe Date equivalence or the deprecated DateTime surface. Portable Haxe Date emits as HxDate in hx_date.rb so both contracts can coexist without shadowing Ruby's date feature."
    },
    {
      "id": "library.fileutils",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.FileUtils"
      ],
      "facadePaths": [
        "std/ruby/FileUtils.hx"
      ],
      "evidence": [
        "npm run test:fileutils-facade"
      ],
      "runtimeProbe": {
        "require": "fileutils",
        "gem": "fileutils",
        "constants": [
          "FileUtils"
        ]
      },
      "notes": "The bounded mutation facade uses direct FileUtils calls and security-explicit recursive removal."
    },
    {
      "id": "library.json",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Json"
      ],
      "facadePaths": [
        "std/ruby/Json.hx"
      ],
      "evidence": [
        "npm run test:json-parity",
        "npm run test:ruby-interop"
      ],
      "runtimeProbe": {
        "require": "json",
        "gem": "json",
        "constants": [
          "JSON"
        ]
      },
      "notes": "The current facade is an explicit open JSON interop boundary; app code must narrow values before field access."
    },
    {
      "id": "library.open3",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Open3",
        "ruby.Open3Capture",
        "ruby.Open3Executable",
        "ruby.Open3Status"
      ],
      "facadePaths": [
        "std/ruby/Open3.hx",
        "std/ruby/Open3Capture.hx",
        "std/ruby/Open3Executable.hx",
        "std/ruby/Open3Status.hx"
      ],
      "evidence": [
        "npm run test:open3-facade"
      ],
      "runtimeProbe": {
        "require": "open3",
        "gem": "open3",
        "constants": [
          "Open3"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-official-gem-source",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "stdlib/open3/0",
        "sources": [
          {
            "path": "open3.rbs",
            "sha256": "66457894b07516cf0df9f8abbc3ec5b0bd9d61f3ffc3f6c8f5c073aba16400c2"
          }
        ],
        "implementationRepository": "https://github.com/ruby/open3",
        "implementationRelease": "v0.2.1",
        "implementationSources": [
          {
            "path": "lib/open3.rb",
            "sha256": "551b8a2bc027d004fa38e4a8915e7ecffd80c8ab223ce79eb6335d8b91b8f27b"
          },
          {
            "path": "lib/open3/version.rb",
            "sha256": "1d225c4d3e005b543a9d2a3ea7c3dea2a18bdc06c9c649acae848a0cb3dc86cd"
          }
        ],
        "curation": "Only capture3 direct-exec argv is exposed. Ruby's fixed [String, String, Process::Status] tuple narrows to property-only Open3Capture through three private native Array reads. Shell command lines, environment/process option hashes, stdin_data/binmode keywords, capture2/capture2e, popen streams, pipelines, and unchecked argument bags are omitted."
      },
      "notes": "The bounded public facade captures stdout, stderr, and completed process status through Ruby's shell-free [path, argv0] executable form and native String rest arguments. Open3 remains a default gem on all tested Ruby branches; live stream and pipeline lifecycle APIs are not claimed."
    },
    {
      "id": "library.pathname",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Pathname"
      ],
      "facadePaths": [
        "std/ruby/Pathname.hx"
      ],
      "evidence": [
        "npm run test:pathname-facade"
      ],
      "runtimeProbe": {
        "require": "pathname",
        "gem": "pathname",
        "constants": [
          "Pathname"
        ]
      },
      "notes": "The public value facade covers typed path composition, decomposition, normalization, predicates, and bounded reads; Ruby 4.0 promotes Pathname from a default gem to a core class."
    },
    {
      "id": "library.rbconfig",
      "distributionByRuby": {
        "3.3": "standard-library",
        "3.4": "standard-library",
        "4.0": "standard-library"
      },
      "coverageStatus": "deferred",
      "surfaces": [],
      "facadePaths": [],
      "evidence": [],
      "runtimeProbe": {
        "require": "rbconfig",
        "constants": [
          "RbConfig"
        ]
      },
      "notes": "Build and installation metadata is available but has no current app-facing facade requirement."
    },
    {
      "id": "library.set",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "core"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Set<T>"
      ],
      "facadePaths": [
        "std/ruby/Set.hx"
      ],
      "evidence": [
        "npm run test:set-facade"
      ],
      "runtimeProbe": {
        "require": "set",
        "gem": "set",
        "constants": [
          "Set"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-supported-ruby-sources",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "core/set",
        "sources": [
          {
            "path": "core/set.rbs",
            "sha256": "afd74d61411991a0691e892152565593debbee304b3a25b792f208c4673dd79b"
          }
        ],
        "implementationSources": [
          {
            "repository": "https://github.com/ruby/set",
            "release": "v1.1.0",
            "path": "lib/set.rb",
            "sha256": "c77fd2da96b4556a5b6de722a829228df0eae9f87c2de3c972124593dd5956aa"
          },
          {
            "repository": "https://github.com/ruby/set",
            "release": "v1.1.1",
            "path": "lib/set.rb",
            "sha256": "bb376256e24b623381fa0098e4c3e6f46da9255244aca0d0076a0cded1d5b0b9"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v4.0.0",
            "path": "set.c",
            "sha256": "21b153cdf5b87facefadd8639fd10d5eb5c75652fa2dfb7f4f455a2fc77ff97f"
          }
        ],
        "curation": "The generic facade narrows construction to Array<T>, open Enumerable operands to same-element Set<T>, truthy filters to Bool callbacks, and iteration to an explicit native block. It exposes precise nullable add?/delete? results plus common algebra and relation methods. Variadic calls, type-changing transforms, classify/divide/flatten, identity mode, mutable-element reset, subclass/CoreSet contracts, implicit Haxe iteration, raw operators, and unchecked values are omitted."
      },
      "notes": "The bounded generic facade preserves Ruby eql?/hash membership semantics and direct native collection behavior without claiming portable haxe.ds equivalence. Ruby 4.0 promotes Set from a default gem to a core class."
    },
    {
      "id": "library.tempfile",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.Tempfile"
      ],
      "facadePaths": [
        "std/ruby/Tempfile.hx"
      ],
      "evidence": [
        "npm run test:tempfile-facade"
      ],
      "runtimeProbe": {
        "require": "tempfile",
        "gem": "tempfile",
        "constants": [
          "Tempfile"
        ]
      },
      "notes": "The public lifecycle facade prioritizes native block cleanup and explicit deterministic cleanup for retained values."
    },
    {
      "id": "library.time",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.TimeParsing"
      ],
      "facadePaths": [
        "std/ruby/TimeParsing.hx"
      ],
      "evidence": [
        "npm run test:time-date-facade"
      ],
      "runtimeProbe": {
        "require": "time",
        "gem": "time",
        "constants": [
          "Time"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs-plus-supported-ruby-sources",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "stdlib/time/0",
        "sources": [
          {
            "path": "stdlib/time/0/time.rbs",
            "sha256": "0d2d420624c57c34f9ecd3cb57b95fe2d80884edd3f281470d6f64619557667e"
          }
        ],
        "implementationSources": [
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_3_11",
            "path": "lib/time.rb",
            "sha256": "5ddbc34d3c06e73605708f7ecb2697791d9cb35d5090361b0499285013ce30f0"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v3_4_10",
            "path": "lib/time.rb",
            "sha256": "94e4c25b76c4b15fa86e9202365eb2bb9ffdeed956a76c4866c1c1f15d33d3e5"
          },
          {
            "repository": "https://github.com/ruby/ruby",
            "release": "v4.0.0",
            "path": "lib/time.rb",
            "sha256": "524e910df9d670cc0e60a4122b00a4c70dd27b6dd07bee406806d172a667570c"
          }
        ],
        "curation": "The require-backed native view exposes restricted ISO 8601/XML Schema parsing and explicit-format strptime with concrete String inputs. Heuristic Time.parse, parser blocks, open _TimeLike/Numeric inputs, HTTP/mail parsing, DateTime conversion, and unchecked options remain omitted."
      },
      "notes": "The public parsing facade opts into the time default gem without making core ruby.Time require-backed; it emits direct Time.iso8601 and Time.strptime calls and preserves the modern Time-over-DateTime recommendation."
    },
    {
      "id": "library.uri",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-public",
      "surfaces": [
        "ruby.URI",
        "ruby.URIValue"
      ],
      "facadePaths": [
        "std/ruby/URI.hx",
        "std/ruby/URIValue.hx"
      ],
      "evidence": [
        "npm run test:uri-facade"
      ],
      "runtimeProbe": {
        "require": "uri",
        "gem": "uri",
        "constants": [
          "URI",
          "URI::Generic"
        ]
      },
      "contractProvenance": {
        "kind": "reviewed-rbs",
        "repository": "https://github.com/ruby/rbs",
        "release": "v4.0.3",
        "library": "stdlib/uri/0",
        "sources": [
          {
            "path": "common.rbs",
            "sha256": "22fbbf40b6a65d7bd13bc14515aa57119b2f28dbe958ebe19956fccd0097fd6e"
          },
          {
            "path": "generic.rbs",
            "sha256": "75981b325699034d86d6ad4a529ea9dde187a0aaf216639b5ea3ac10dcaa803b"
          }
        ],
        "curation": "Open _ToS/_ToStr, encoding, enumerable, variadic, mutation, and scheme-specific signatures are omitted or narrowed to String; URI.parse's subclass union is represented by the sound URI::Generic base contract."
      },
      "notes": "The public facade covers parsing, two-part joining, component encoding, immutable composition, common nullable components, normalization, and relative routing without claiming every URI scheme API."
    },
    {
      "id": "library.zlib",
      "distributionByRuby": {
        "3.3": "default-gem",
        "3.4": "default-gem",
        "4.0": "default-gem"
      },
      "coverageStatus": "implemented-internal",
      "surfaces": [
        "ruby.Deflate",
        "ruby.Inflate"
      ],
      "facadePaths": [
        "std/ruby/Zlib.hx"
      ],
      "evidence": [
        "npm run test:unitstd-ruby",
        "npm run test:stdlib-mvp"
      ],
      "runtimeProbe": {
        "require": "zlib",
        "gem": "zlib",
        "constants": [
          "Zlib::Deflate",
          "Zlib::Inflate"
        ]
      },
      "notes": "Typed one-shot compression primitives support Haxe zip semantics; a general Ruby Zlib facade is not claimed."
    },
    {
      "id": "platform.win32ole",
      "distributionByRuby": {
        "3.3": "platform-specific",
        "3.4": "platform-specific",
        "4.0": "platform-specific"
      },
      "coverageStatus": "deferred",
      "surfaces": [],
      "facadePaths": [],
      "evidence": [],
      "runtimeProbe": {
        "require": "win32ole",
        "gem": "win32ole",
        "constants": [
          "WIN32OLE"
        ],
        "platforms": [
          "win32"
        ]
      },
      "notes": "Windows COM is outside the canonical Ubuntu evidence lane and cannot be inferred from cross-platform Ruby availability."
    }
  ]
}