tg_geometry 0.1.0 → 0.3.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tg_geometry
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Roman Haydarov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-25 00:00:00.000000000 Z
+date: 2026-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -38,14 +38,35 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
 description: Defines TG::Geometry with immutable Geom parsing and constructor wrappers,
   expanded geometry predicates and accessors, Rect helpers, Hex/GeoBIN writers, raw
   extra_json access, read-only borrowed Line/Ring/Polygon and GeometryCollection child
   wrappers, value Segment wrappers, Registry reload sugar, optional ActiveRecord source
   helpers, and an immutable geofencing-oriented Index with owned and borrowed geometry
   ingestion, flat/rtree strategies, deterministic ordered id results, exact rtree
-  allocation accounting, and native-endian packed point batch queries over vendored
-  TG sources. Ractor support is not claimed.
+  allocation accounting, and native-endian packed point batch queries, and FeatureSource
+  GeoJSON FeatureCollection extraction/build paths over vendored C sources. Ractor
+  support is not claimed.
 email:
 - romnhajdarov@gmail.com
 executables: []
@@ -60,33 +81,37 @@ files:
 - Rakefile
 - benchmark/_support.rb
 - benchmark/batch_packed_vs_loop.rb
+- benchmark/ewkb_roundtrip.rb
 - benchmark/falcon_concurrency.rb
+- benchmark/feature_source.rb
 - benchmark/flat_vs_rtree.rb
+- benchmark/geom_query.rb
 - benchmark/gvl_threshold.rb
+- benchmark/nearest_segment.rb
 - benchmark/objectspace_memsize.rb
 - benchmark/parse_throughput.rb
 - benchmark/rss_stability.rb
-- docs/ACTIVE_RECORD.md
 - docs/ARCHITECTURE.md
-- docs/AUTO_STRATEGY.md
 - docs/BENCHMARKING.md
 - docs/CASUAL_EXAMPLE.md
 - docs/CONCURRENCY.md
 - docs/ERROR_HANDLING.md
-- docs/EXPANSION_E_TO_H_STATUS.md
-- docs/FORMAT_COVERAGE.md
-- docs/FULL_TG_API_COVERAGE.md
+- docs/FEATURE_SOURCE.md
+- docs/GEOMETRY_QUERIES.md
 - docs/LIMITATIONS.md
-- docs/LOW_LEVEL_GEOMETRY.md
 - docs/MEMORY_OWNERSHIP.md
-- docs/RACTOR.md
-- docs/REGISTRY.md
-- docs/RELEASE_CHECKLIST.md
+- docs/NEAREST_SEGMENT.md
+- docs/SRID_AND_EWKB.md
 - ext/tg_geometry/extconf.rb
 - ext/tg_geometry/tg_geometry_ext.c
+- ext/tg_geometry/tg_geometry_vendor_json.c
 - ext/tg_geometry/tg_geometry_vendor_rtree.c
 - ext/tg_geometry/tg_geometry_vendor_tg.c
 - ext/tg_geometry/vendor/.vendored
+- ext/tg_geometry/vendor/json/LICENSE
+- ext/tg_geometry/vendor/json/VERSION
+- ext/tg_geometry/vendor/json/json.c
+- ext/tg_geometry/vendor/json/json.h
 - ext/tg_geometry/vendor/rtree/LICENSE
 - ext/tg_geometry/vendor/rtree/README.md
 - ext/tg_geometry/vendor/rtree/VERSION
@@ -99,34 +124,58 @@ files:
 - ext/tg_geometry/vendor/tg/tg.h
 - lib/tg/geometry.rb
 - lib/tg/geometry/active_record_source.rb
+- lib/tg/geometry/active_record_type.rb
 - lib/tg/geometry/registry.rb
 - lib/tg/geometry/version.rb
 - lib/tg_geometry.rb
 - script/vendor_libs.rb
-- spec/block_10_rtree_strategy_spec.rb
-- spec/block_11_rtree_order_spec.rb
-- spec/block_12_batch_packed_spec.rb
-- spec/block_13_error_hardening_spec.rb
-- spec/block_14_memory_gc_hardening_spec.rb
-- spec/block_1_skeleton_spec.rb
-- spec/block_20_concurrency_spec.rb
-- spec/block_20_fuzz_spec.rb
-- spec/block_2_vendor_spec.rb
-- spec/block_3_geom_parse_spec.rb
-- spec/block_4_geom_api_spec.rb
-- spec/block_5_rect_api_spec.rb
-- spec/block_6_index_build_spec.rb
-- spec/block_7_index_owned_geometry_spec.rb
-- spec/block_8_index_borrowed_geometry_spec.rb
-- spec/block_9_flat_query_spec.rb
-- spec/expansion_a_auto_strategy_spec.rb
-- spec/expansion_b_registry_spec.rb
-- spec/expansion_c_active_record_source_spec.rb
-- spec/expansion_d_format_coverage_spec.rb
-- spec/expansion_e_low_level_geometry_spec.rb
-- spec/expansion_i_ractor_spec.rb
-- spec/expansion_j_full_tg_api_coverage_spec.rb
+- spec/active_record_source_spec.rb
+- spec/active_record_type_spec.rb
+- spec/auto_strategy_spec.rb
+- spec/batch_packed_spec.rb
+- spec/concurrency_spec.rb
+- spec/constructors_spec.rb
+- spec/error_hardening_spec.rb
+- spec/feature_source_nogvl_spec.rb
+- spec/feature_source_spec.rb
+- spec/fixtures/feature_source/invalid_geometry_middle.geojson
+- spec/fixtures/feature_source/malformed_json.geojson
+- spec/fixtures/feature_source/mixed_geometry_types.geojson
+- spec/fixtures/feature_source/osm_like_feature_collection.geojson
+- spec/fixtures/feature_source/properties_null_missing.geojson
+- spec/fixtures/feature_source/simple_feature_collection.geojson
+- spec/fixtures/postgis/README.md
+- spec/fixtures/postgis/boundary_point_cases.geojson
+- spec/fixtures/postgis/multipolygon_large.ewkb
+- spec/fixtures/postgis/point_4326.ewkb
+- spec/fixtures/postgis/polygon_3857.ewkb
+- spec/fixtures/postgis/polygon_4326_simple.ewkb
+- spec/fixtures/postgis/polygon_4326_with_hole.ewkb
+- spec/format_coverage_spec.rb
+- spec/fuzz_spec.rb
+- spec/geom_api_spec.rb
+- spec/geom_parse_spec.rb
+- spec/index_borrowed_geometry_spec.rb
+- spec/index_build_spec.rb
+- spec/index_flat_query_spec.rb
+- spec/index_geom_query_spec.rb
+- spec/index_owned_geometry_spec.rb
+- spec/index_rtree_accounting_spec.rb
+- spec/index_rtree_order_spec.rb
+- spec/keyword_validation_spec.rb
+- spec/load_and_errors_spec.rb
+- spec/low_level_geometry_spec.rb
+- spec/memory_gc_spec.rb
+- spec/nearest_segment_spec.rb
+- spec/postgis_fixtures_spec.rb
+- spec/ractor_spec.rb
+- spec/rect_api_spec.rb
+- spec/registry_spec.rb
 - spec/spec_helper.rb
+- spec/srid_spec.rb
+- spec/tg_api_coverage_spec.rb
+- spec/to_ewkb_spec.rb
+- spec/vendor_sources_spec.rb
 homepage: https://github.com/roman-haidarov/tg_geometry
 licenses:
 - MIT
@@ -142,7 +191,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -153,5 +202,5 @@ rubygems_version: 3.3.27
 signing_key:
 specification_version: 4
 summary: Native extension for TG::Geometry parsing, predicates, immutable indexes,
-  registries, low-level wrappers, and packed point batches
+  FeatureSource imports, registries, low-level wrappers, and packed point batches
 test_files: []

data/docs/ACTIVE_RECORD.md

@@ -1,26 +0,0 @@
-# ActiveRecord source helper
-
-`TG::Geometry::ActiveRecordSource` is an optional Ruby helper. It does not require Rails or ActiveRecord and is not loaded from a separate integration gem.
-
-It accepts any object that responds to `find_each`, or any Enumerable:
-
-```ruby
-entries = TG::Geometry::ActiveRecordSource.call(
-  Zone.where(active: true),
-  id: :id,
-  geometry: :geojson,
-  batch_size: 1_000
-)
-
-index = TG::Geometry::Index.build(entries, via: :geojson, strategy: :rtree)
-```
-
-It can also feed a Registry:
-
-```ruby
-class DeliveryZones < TG::Geometry::Registry
-  active_record_source Zone.where(active: true), id: :id, geometry: :geojson
-end
-```
-
-Field readers may be Symbols, Strings, or Procs. The helper only converts application records into `[[id, object], ...]`; it does not mutate records, keep database connections, create background jobs, install reload hooks, or add a Rails dependency to the native extension.

data/docs/AUTO_STRATEGY.md

@@ -1,15 +0,0 @@
-# Auto strategy status
-
-`strategy: :auto` is not exposed in the first public release.
-
-The release-core contract only enables explicit `strategy: :flat` and `strategy: :rtree`. Automatic threshold selection requires a complete project-owned benchmark matrix and explicit approval before it can become public API.
-
-Use `benchmark/flat_vs_rtree.rb` to compare strategies for a workload, then pass the chosen strategy explicitly:
-
-```ruby
-index = TG::Geometry::Index.build(entries, via: :geojson, strategy: :rtree)
-# or
-index = TG::Geometry::Index.build(entries, via: :geojson, strategy: :flat)
-```
-
-Do not infer a universal crossover from rtree internals or from a partial benchmark run.

data/docs/EXPANSION_E_TO_H_STATUS.md

@@ -1,51 +0,0 @@
-# Expansion Blocks E–H status
-
-## Expansion Block E — Low-level Ring / Line / Polygon APIs
-
-Implemented as read-only borrowed wrappers:
-
-- `TG::Geometry::Geom#point`
-- `TG::Geometry::Geom#line`
-- `TG::Geometry::Geom#polygon`
-- `TG::Geometry::Line`
-- `TG::Geometry::Ring`
-- `TG::Geometry::Polygon`
-
-Invariant satisfied: child pointers are borrowed from the parent TG geometry and the wrapper keeps the parent Ruby `TG::Geometry::Geom` alive through `geom_owner` with compaction-aware marking.
-
-Tests: `spec/expansion_e_low_level_geometry_spec.rb` covers accessors, private allocation, out-of-range errors, and parent survival after `GC.start` / `GC.compact`.
-
-## Expansion Block F — Callback/search APIs
-
-OPEN QUESTION: not implemented.
-
-Reason: the roadmap allows callback/search APIs only with a new callback safety contract. The current contract still forbids public callback/block APIs in the first release. No `geom.search`, `index.search`, or `each_match` method is exposed.
-
-Required before implementation:
-
-- explicit callback exception propagation semantics;
-- GVL behavior for Ruby callbacks inside C loops;
-- proof that borrowed pointers cannot be invalidated by callback reentrancy;
-- benchmark of callback overhead;
-- tests for exceptions raised from callbacks.
-
-## Expansion Block G — Fast no-allocation point query optimization
-
-OPEN QUESTION: not implemented.
-
-Reason: the current implementation intentionally constructs a temporary TG point geometry for `covers` / `contains` correctness. Replacing this with `tg_geom_intersects_xy` or a specialized helper requires proof of exact boundary semantics and a benchmark proving benefit.
-
-Current invariant: point query semantics remain exact and boundary behavior is covered by existing tests.
-
-## Expansion Block H — Geodesic helpers or projection integration
-
-OPEN QUESTION: not implemented.
-
-Reason: TG core remains planar XY. No optional geodesic/projection dependency has been approved. The gem continues to document that `length`, `area`, and `perimeter` are in input coordinate units, not meters for lon/lat.
-
-Required before implementation:
-
-- explicit optional dependency decision;
-- public API shape;
-- tests separating planar TG behavior from geodesic/projection helpers;
-- documentation that TG itself does not handle geodesics.

data/docs/FORMAT_COVERAGE.md

@@ -1,23 +0,0 @@
-# Format coverage
-
-Expansion Block D exposes additional TG format helpers without changing ownership rules.
-
-## Parse helpers
-
-- `TG::Geometry.parse_hex(str, index: :ystripes)`
-- `TG::Geometry.parse_geobin(bytes, index: :ystripes)`
-
-These are shortcuts over `TG::Geometry.parse(..., format: :hex)` and `TG::Geometry.parse(..., format: :geobin)`.
-
-## Writer helpers
-
-- `TG::Geometry::Geom#to_hex` -> UTF-8 String
-- `TG::Geometry::Geom#to_geobin` -> ASCII-8BIT String
-
-Writers use the same direct Ruby string buffer pattern as existing writers. Hex is text and GeoBIN is binary.
-
-## Raw extra_json
-
-- `TG::Geometry::Geom#extra_json` -> UTF-8 String or nil
-
-This returns a copied Ruby String from TG's raw extra JSON pointer. It does not parse JSON into Hashes and does not expose borrowed child wrappers. This follows the constraint that raw `extra_json` is safer than implicit `JSON.parse`.

data/docs/FULL_TG_API_COVERAGE.md

@@ -1,109 +0,0 @@
-# Full TG API coverage status
-
-This document covers Expansion Block J as implemented in grouped, safe increments.
-
-Block J does not mean exposing every upstream TG function in one change. The rule is: implement in groups, define ownership for each group, add tests, and avoid environment allocator overrides or global mutable settings.
-
-## Implemented group: predicates
-
-`TG::Geometry::Geom` now exposes additional read-only predicates:
-
-- `equals?(other)`
-- `disjoint?(other)`
-- `within?(other)`
-- `covers?(other)`
-- `covered_by?(other)`
-- `touches?(other)`
-- `intersects_xy?(x, y)`
-- `intersects_rect?(rect)`
-- `intersects_rect?(min_x, min_y, max_x, max_y)`
-
-Existing methods remain:
-
-- `contains?(other)`
-- `intersects?(other)`
-- `covers_xy?(x, y)`
-
-`equals?` intentionally does not change Ruby `==`, `eql?`, or `hash`. Ruby equality remains identity-based until that open API decision is explicitly made.
-
-## Implemented group: geometry accessors
-
-`TG::Geometry::Geom` now exposes safe read-only accessors for upstream geometry collections and coordinate metadata:
-
-- `feature?`
-- `feature_collection?`
-- `empty?`
-- `dims`
-- `has_z?`
-- `has_m?`
-- `z`
-- `m`
-- `extra_coords`
-- `num_points`
-- `point_at(index)`
-- `points`
-- `num_lines`
-- `line_at(index)`
-- `lines`
-- `num_polygons`
-- `polygon_at(index)`
-- `polygons`
-- `num_geometries`
-- `geometry_at(index)`
-- `geometries`
-
-`geometry_at` and `geometries` return borrowed immutable `TG::Geometry::Geom` wrappers. They keep the parent wrapper alive through `geom_owner`, mark it for GC, update it during compaction, and do not call `tg_geom_free` for the borrowed child pointer.
-
-## Implemented group: point and empty constructors
-
-Safe constructors are exposed only where ownership is simple and the returned object owns exactly one `struct tg_geom *`:
-
-- `TG::Geometry.point(x, y)`
-- `TG::Geometry.point_z(x, y, z)`
-- `TG::Geometry.point_m(x, y, m)`
-- `TG::Geometry.point_zm(x, y, z, m)`
-- `TG::Geometry.empty_point`
-- `TG::Geometry.empty_linestring`
-- `TG::Geometry.empty_polygon`
-- `TG::Geometry.empty_multipoint`
-- `TG::Geometry.empty_multilinestring`
-- `TG::Geometry.empty_multipolygon`
-- `TG::Geometry.empty_geometrycollection`
-
-Numeric coordinates are converted with `NUM2DBL` and rejected if NaN or Infinity.
-
-## Implemented group: segments
-
-`TG::Geometry::Segment` is a frozen value wrapper over one copied `struct tg_segment`.
-
-Created by:
-
-- `TG::Geometry::Line#segment_at(index)`
-- `TG::Geometry::Line#segments`
-- `TG::Geometry::Ring#segment_at(index)`
-- `TG::Geometry::Ring#segments`
-
-Methods:
-
-- `a -> [Float, Float]`
-- `b -> [Float, Float]`
-- `points -> [[Float, Float], [Float, Float]]`
-- `bbox -> TG::Geometry::Rect`
-- `intersects?(other_segment)`
-
-`TG::Geometry::Segment.allocate` is disabled. Segment wrappers do not borrow parent TG memory and do not call any TG free function.
-
-## Still not implemented
-
-The following remain outside this grouped implementation:
-
-- Line/Ring/Polygon public constructors from Ruby arrays;
-- MultiLineString / MultiPolygon constructors from low-level wrappers;
-- callback/search APIs;
-- nearest segment APIs;
-- environment configuration functions;
-- global allocator override;
-- mutable settings;
-- user callbacks inside C loops.
-
-Those require separate ownership and callback-safety contracts before implementation.

data/docs/LOW_LEVEL_GEOMETRY.md

@@ -1,121 +0,0 @@
-# Low-level geometry wrappers
-
-This document covers Expansion Block E.
-
-## Scope
-
-The first low-level API exposes borrowed read-only views over TG child types:
-
-- `TG::Geometry::Line`
-- `TG::Geometry::Ring`
-- `TG::Geometry::Polygon`
-- `TG::Geometry::Segment`
-
-These wrappers are created only from `TG::Geometry::Geom`, `TG::Geometry::Polygon`, `TG::Geometry::Line`, and `TG::Geometry::Ring` methods. Public `.allocate` is disabled for all four classes.
-
-## Ownership model
-
-TG child accessors return borrowed pointers owned by the parent `struct tg_geom`. The Line/Ring/Polygon Ruby wrappers therefore store:
-
-- `geom_owner`: the original `TG::Geometry::Geom` Ruby object;
-- a borrowed `const struct tg_line *`, `const struct tg_ring *`, or `const struct tg_poly *` pointer.
-
-The wrappers mark `geom_owner` with `rb_gc_mark_movable` and update it in `dcompact` with `rb_gc_location`. They do not call `tg_line_free`, `tg_ring_free`, or `tg_poly_free` for borrowed children.
-
-`TG::Geometry::Segment` is a value wrapper over a copied `struct tg_segment`, so it does not store `geom_owner` and does not free any TG-owned pointer.
-
-Allocator pairs:
-
-Resource | Allocator | Deallocator | Owner | Notes
---- | --- | --- | --- | ---
-`tg_line_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | borrowed pointer, marks parent `geom_owner`
-`tg_ring_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | borrowed pointer, marks parent `geom_owner`
-`tg_polygon_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | borrowed pointer, marks parent `geom_owner`
-`tg_segment_wrapper_t` | `TypedData_Make_Struct` / Ruby allocator | `ruby_xfree` | Ruby object | owns copied `struct tg_segment` value
-TG child pointers | parent `struct tg_geom` | parent `TG::Geometry::Geom` dfree | parent geometry | never freed by child wrappers
-
-## Public API
-
-### `TG::Geometry::Geom#point`
-
-Returns `[x, y]` for point geometries. Returns `nil` for non-point geometries.
-
-### `TG::Geometry::Geom#line`
-
-Returns a frozen `TG::Geometry::Line` for LineString geometries. Returns `nil` otherwise.
-
-### `TG::Geometry::Geom#polygon`
-
-Returns a frozen `TG::Geometry::Polygon` for Polygon geometries. Returns `nil` otherwise.
-
-### `TG::Geometry::Line`
-
-Methods:
-
-- `bbox -> TG::Geometry::Rect`
-- `num_points -> Integer`
-- `point_at(index) -> [Float, Float]`
-- `points -> Array<[Float, Float]>`
-- `num_segments -> Integer`
-- `segment_at(index) -> TG::Geometry::Segment`
-- `segments -> Array<TG::Geometry::Segment>`
-- `length -> Float`
-- `clockwise? -> Boolean`
-
-`length` is measured in input coordinate units. For lon/lat data this is not meters.
-
-### `TG::Geometry::Ring`
-
-Methods:
-
-- `bbox -> TG::Geometry::Rect`
-- `num_points -> Integer`
-- `point_at(index) -> [Float, Float]`
-- `points -> Array<[Float, Float]>`
-- `num_segments -> Integer`
-- `segment_at(index) -> TG::Geometry::Segment`
-- `segments -> Array<TG::Geometry::Segment>`
-- `area -> Float`
-- `perimeter -> Float`
-- `clockwise? -> Boolean`
-- `convex? -> Boolean`
-
-`area` and `perimeter` are measured in input coordinate units. For lon/lat data these are not square meters or meters.
-
-### `TG::Geometry::Polygon`
-
-Methods:
-
-- `bbox -> TG::Geometry::Rect`
-- `exterior_ring -> TG::Geometry::Ring`
-- `num_holes -> Integer`
-- `hole_at(index) -> TG::Geometry::Ring`
-- `holes -> Array<TG::Geometry::Ring>`
-- `clockwise? -> Boolean`
-
-`hole_at` rejects out-of-range indexes with `TG::Geometry::ArgumentError`.
-
-### `TG::Geometry::Segment`
-
-Methods:
-
-- `a -> [Float, Float]`
-- `b -> [Float, Float]`
-- `points -> [[Float, Float], [Float, Float]]`
-- `bbox -> TG::Geometry::Rect`
-- `intersects?(other_segment) -> Boolean`
-
-Segments are copied by value from a line or ring. They do not keep or free borrowed TG pointers.
-
-## Error paths
-
-- Wrong wrapper type is handled by `TypedData_Get_Struct` and raises `TypeError`.
-- Out-of-range child indexes raise `TG::Geometry::ArgumentError`.
-- Child wrappers are immutable and cannot be constructed directly from Ruby.
-
-## Not implemented in this block
-
-- Low-level constructors for Ring, Line, or Polygon.
-- Mutable coordinate access.
-- Polygon `area` / `perimeter` convenience aggregation. Ring-level values are exposed first to avoid undocumented assumptions about hole orientation and aggregation semantics.
-- Geodesic length/area.

data/docs/RACTOR.md

@@ -1,40 +0,0 @@
-# Ractor investigation
-
-This document covers Expansion Block I.
-
-## Current result
-
-`tg_geometry` does not claim Ractor support.
-
-The current native wrappers are frozen and immutable for normal Ruby thread reads, but they are not Ractor-shareable Ruby objects. The test suite records this boundary with `Ractor.shareable?` and `Ractor.make_shareable` checks for:
-
-- `TG::Geometry::Geom`
-- `TG::Geometry::Rect`
-- `TG::Geometry::Index`
-
-This is an explicit unsupported boundary, not a partial support claim.
-
-## Shareability rules
-
-Current rule for public docs and code comments:
-
-- Normal Ruby thread read-only use is supported by immutable object design and tests.
-- Ractor support is not supported and not advertised.
-- Do not use `TG::Geometry::Geom`, `TG::Geometry::Rect`, `TG::Geometry::Index`, or borrowed low-level wrappers as cross-Ractor shareable objects.
-- Do not add Ractor-specific code paths without a new explicit design and tests.
-
-## Why no support claim is made
-
-The extension stores native pointers and Ruby `VALUE` references inside TypedData wrappers. The current contract validates GC marking, compaction, ownership, and normal thread read-only access. It does not define or validate cross-Ractor transfer/share semantics for those wrappers.
-
-## Required before changing this status
-
-Before any future Ractor support claim:
-
-1. Define shareability rules for owned and borrowed `TG::Geometry::Geom` wrappers.
-2. Define shareability rules for `TG::Geometry::Index` entries and id `VALUE`s.
-3. Define behavior for borrowed Line/Ring/Polygon/Segment wrappers.
-4. Add Ractor tests that pass on the supported Ruby matrix.
-5. Document whether objects are shareable directly, require duplication, or are unsupported.
-
-Until those items exist, Ractor remains unsupported.

data/docs/REGISTRY.md

@@ -1,37 +0,0 @@
-# Registry
-
-`TG::Geometry::Registry` is Ruby-side application sugar over immutable `TG::Geometry::Index`.
-
-It does not add a mutable native index. `reload!` always builds a new Index and then swaps a Ruby reference:
-
-```ruby
-class DeliveryZones < TG::Geometry::Registry
-  source do
-    [
-      [:zone_a, '{"type":"Polygon","coordinates":[[[0,0],[10,0],[10,10],[0,10],[0,0]]]}']
-    ]
-  end
-end
-
-registry = DeliveryZones.new(via: :geojson, strategy: :rtree)
-registry.reload!
-registry.find_covering(5, 5)
-```
-
-Readers capture the current immutable Index. An active reader can continue using the old Index while `reload!` builds and swaps a new one.
-
-## API
-
-- `source { ... }` on a subclass defines the entry source.
-- `index_options(...)` on a subclass sets default Index options.
-- `reload!` builds and swaps a new Index.
-- `find_covering`, `covering_ids`, `intersecting_rect`, and `covering_ids_batch_packed` delegate to the current Index.
-- `index`, `size`, `bbox`, and `loaded?` expose current state.
-
-The source must return the strict first-release entry format:
-
-```ruby
-[[id, object], [id, object], ...]
-```
-
-No Redis dependency, no Rails dependency, no global native singleton, and no in-place Index mutation are introduced.

data/docs/RELEASE_CHECKLIST.md

@@ -1,39 +0,0 @@
-# First public release checklist
-
-This checklist is intentionally conservative. Do not publish until every required item is satisfied.
-
-## Required state before release
-
-- [ ] All release-core specs pass locally.
-- [ ] GC.stress specs pass.
-- [ ] GC.compact specs pass.
-- [ ] ASAN status is documented.
-- [ ] Valgrind status is documented.
-- [ ] Benchmark scripts exist and have been run for the full scenario matrix.
-- [ ] README and docs are complete.
-- [ ] Gem metadata is final:
-  - gem name: `tg_geometry`;
-  - author: `Roman Haydarov`;
-  - email: `romnhajdarov@gmail.com`;
-  - repository: `https://github.com/roman-haidarov/tg_geometry`.
-- [ ] Vendored TG and rtree versions are pinned in `VERSION` files.
-- [ ] Upstream license files are included under `ext/tg_geometry/vendor/*/LICENSE`.
-- [ ] `CHANGELOG.md` exists.
-
-## Do not release if any of these are true
-
-- [ ] Any OPEN QUESTION affects correctness.
-- [ ] Any memory accounting path is approximate.
-- [ ] Any failed build path waits for GC instead of immediate dispose.
-- [ ] `strategy: :auto` is enabled without benchmark-derived threshold.
-- [ ] Public API differs from the contract without Roman approval.
-- [ ] Ractor support is claimed.
-- [ ] Performance claims are present without project-owned benchmark output.
-
-## OPEN QUESTION: ASAN setup
-
-ASAN setup is not fully specified in the contract and the worker must not research it independently. The repository contains a placeholder CI job that fails with an explicit message until Roman approves the exact ASAN approach.
-
-## OPEN QUESTION: Valgrind setup
-
-Valgrind setup can vary by CI image and Ruby build. The repository contains a placeholder CI job that installs/runs nothing by default and asks for approval before adding a final Valgrind configuration.