gobbo 2.0.0__tar.gz

gobbo-2.0.0/ATTRIBUTION.md

@@ -0,0 +1,32 @@
+# Attribution — gobbo (Python)
+
+## Who owns and originated this work
+
+- **Copyright:** Gobbo Datum Labs (2026). Licensed under **Apache License 2.0** (see `LICENSE`).
+- **Inventor / original technical authorship:** **Adam Gobbo**.
+- **Scope:** **Gobbo 9D Voxel Datum** (octree / voxel path positioning), **STAMP** ingestion and interaction math, and related tooling in this package (including optional HTTP client surfaces for Secure Envelope–compatible APIs).
+
+## What you must do when you use or redistribute this SDK
+
+1. Retain **`LICENSE`** and **`NOTICE`** (or equivalent notices) with distributions, per Apache 2.0.
+2. Where you document dependencies, **credit Gobbo Datum Labs** and **Adam Gobbo** as above.
+3. Do **not** strip notices in a way that hides the **true origin** of Gobbo Datum / STAMP technology.
+
+## What you must not do (good-faith reading; consult counsel for your jurisdiction)
+
+- Do **not** claim **copyright ownership** over this SDK or the **Gobbo / STAMP** technology lineage **as a whole**.
+- Do **not** represent yourself as **inventor or sole author** of Gobbo 9D Voxel Datum or STAMP in place of **Adam Gobbo** and **Gobbo Datum Labs**.
+- Use **Gobbo** / **Gobbo Datum** naming accurately; do not imply endorsement where none exists.
+
+## Supplemental EULA (marks & STAMP naming)
+
+**`EULA.md`** in this package adds **contractual** rules on **which Gobbo terms** you may use in public-facing references and how you must name **STAMP** / **STAMP Format**. It **supplements** Apache-2.0 (copyright). Read it before redistribution.
+
+## Suggested short citation (copy/paste)
+
+> This product uses the **gobbo** Python package from **Gobbo Datum Labs**, implementing the **Gobbo 9D Voxel Datum** and **STAMP** technology (**Adam Gobbo**, inventor). Licensed under Apache 2.0.
+
+## Canonical links
+
+- Public repository: https://github.com/gobbo-datum-labs/gobbo  
+- Maintained by: **Gobbo Datum Labs** (inventor: **Adam Gobbo**)

gobbo-2.0.0/CITATION.cff

@@ -0,0 +1,22 @@
+cff-version: 1.2.0
+title: "gobbo — Gobbo 9D Voxel Datum with STAMP Technology"
+message: "If you use this software, cite Gobbo Datum Labs and inventor Adam Gobbo; see ATTRIBUTION.md."
+type: software
+authors:
+  - family-names: Gobbo
+    given-names: Adam
+    affiliation: Gobbo Datum Labs
+  - name: Gobbo Datum Labs
+repository-code: "https://github.com/gobbo-datum-labs/gobbo"
+url: "https://github.com/gobbo-datum-labs/gobbo"
+license: "Apache-2.0"
+version: "2.0.0"
+date-released: "2026-07-14"
+keywords:
+  - gobbo
+  - gobbo-9d-voxel-datum
+  - ecef
+  - octree
+  - voxel
+  - stamp
+  - estamp

gobbo-2.0.0/EULA.md

@@ -0,0 +1,125 @@
+# Supplemental End User License Agreement — Gobbo SDK Marks, Nomenclature, and STAMP Format
+
+**Effective:** 2026-04-27  
+**Licensor:** Gobbo Datum Labs (“**GDL**”)  
+**Contact:** support@gobbodatumlabs.com  
+
+---
+
+## IMPORTANT — READ BEFORE DOWNLOADING OR USING THE SDKs
+
+**Not legal advice.** This document is a **draft** contractual template. **Gobbo Datum Labs must have it reviewed and finalized by qualified counsel** licensed in the **State of Delaware** (and elsewhere as needed) before relying on it. **No warranty** is made that any clause will be enforced as written by the **Court of Chancery of the State of Delaware**, any other Delaware court, or any court in the United States. **Enforceability** depends on facts, procedure, unconscionability, consumer protection law, federal preemption, and other doctrines.
+
+**Relationship to Apache License 2.0.** The software in `gobbo-stamp-sdk`, `gobbo-datum-sdk`, and related materials (the “**Licensed Materials**”) is **also** licensed under the **Apache License, Version 2.0** (“**Apache-2.0**”) for purposes of **copyright in the code**. **Nothing in Apache-2.0 grants** rights to use **GDL’s names, brands, or nomenclature** except as stated in Apache-2.0 §6 (trademarks). **This Agreement supplements** Apache-2.0 and imposes **additional, independent obligations** regarding **trademarks, nomenclature, and the STAMP Format** when you **download, install, access, reproduce, distribute, or otherwise use** the Licensed Materials. If you **do not accept** this Agreement, **do not download or use** the Licensed Materials.
+
+**Electronic acceptance.** By **downloading, installing, cloning, or using** any Licensed Materials—**including through a paid or membership-gated channel such as [www.secure-envelope.com](https://www.secure-envelope.com)**—you (“**Licensee**”) **acknowledge receipt** of this Agreement and, if acting on behalf of an entity, represent that you have authority to bind that entity.
+
+---
+
+## 1. Definitions
+
+1.1 **“Covered Gobbo References”** means any **public-facing** or **redistributed** statement (including documentation, marketing, product UI, press, packaging, training, and SDK READMEs **bundled with a derivative work**) that **names or describes the proprietary spatial datum / voxel framework** originated by GDL and Adam Gobbo—the technology commonly identified as the **nine-dimensional Gobbo voxel path / octree positioning system** and its **datum rules**, as described in GDL’s published specifications.
+
+1.2 **“Permitted Gobbo Designations”** means **only** the following **exact strings** (including spacing and capitalization as shown), used **substantially as a proper noun or defined term** when making Covered Gobbo References (the **formal name** of the framework):
+
+- `Gobbo 9D Voxel Datum`
+- `Gobbo 9D Voxel`
+- `Gobbo 9D`
+- `Gobbo Voxel`
+- `Gobbo Datum`
+
+**No other word, phrase, abbreviation, portmanteau, translated equivalent, or “fanciful substitute”** may be used **in place of** the Permitted Gobbo Designations when making a Covered Gobbo Reference. Examples of **prohibited substitutes** (non-exhaustive): “Gobbo nine-dimensional grid,” “G-9D datum,” “Gobbo octree format” **as the formal name of the datum**, “GDV datum,” or any new coinage not listed above.
+
+**Descriptive language** (e.g. “octree path,” “voxel,” “ECEF,” “subdivision”) may appear **in explanatory prose** **if and only if** the **formal designation** of the proprietary datum framework, when stated, uses **only** the strings in §1.2.
+
+1.3 **“STAMP”** means the **specific ingestion and interchange format**, **record structure**, and **related protocol surfaces** designated by GDL as **STAMP** in official documentation and OpenAPI contracts—not a generic “data point,” “observation,” “message,” “row,” or “event” **when referring to that format by name**.
+
+1.4 **“STAMP Format”** means the **canonical, specified** STAMP representation required for interoperability within the **Gobbo / Secure Envelope** ecosystem for STAMP ingestion and reads.
+
+1.5 **“E-STAMP”** means the **derived / refined STAMP-class outputs** designated by GDL as **E-STAMP** in official documentation (companion mark to STAMP).
+
+---
+
+## 2. Nomenclature covenant (Gobbo datum / voxel framework)
+
+2.1 **Exclusive permitted designations.** For all Covered Gobbo References, Licensee **shall use only** the Permitted Gobbo Designations in §1.2.
+
+2.2 **No degradation or substitution.** Licensee **shall not** **alter, abbreviate, blend, translate, or replace** the Permitted Gobbo Designations with **any** terminology not expressly listed in §1.2 for Covered Gobbo References.
+
+2.3 **Generic descriptors.** Licensee may use ordinary English words such as “software,” “library,” “SDK,” “package,” “client,” or “API” **without** repeating a Permitted Gobbo Designation in every sentence, **provided that** whenever Licensee **names the proprietary spatial datum / voxel framework** (Covered Gobbo References), Licensee **uses only** §1.2 terms.
+
+---
+
+## 3. STAMP and STAMP Format covenant
+
+3.1 **Proper noun.** Licensee **shall refer** to the STAMP interchange format **as “STAMP”** (all capitals in Latin script) or **“STAMP Format”** when specifying the **format name** in technical documentation, schemas, UI labels, and marketing that describe **STAMP compatibility** or **STAMP ingestion**.
+
+3.2 **Not a generic thing.** Licensee **shall not** treat or describe **STAMP** as a **generic** “thing,” “item,” “blob,” or undifferentiated “data point” **where the reference is to the STAMP format or STAMP record type** in the Gobbo system. Ordinary descriptive language about payload contents is permitted **if** the **format designation** remains **STAMP** / **STAMP Format** as applicable.
+
+3.3 **Canonical format.** Licensee **acknowledges** that, within the Gobbo system, **STAMP Format** is the **specified** interchange form for STAMP-class records **as defined by GDL**; Licensee **shall not** publicly represent a **non-GDL format** as **“STAMP,”** **“STAMP-compatible,”** or **equivalent** without **prior written permission** from GDL.
+
+3.4 **E-STAMP.** Where official materials identify **E-STAMP**, Licensee **shall use** that designation **consistent with** GDL documentation when referring to those artifacts **by name**.
+
+---
+
+## 4. No ownership / authorship misrepresentation
+
+4.1 Licensee **shall not** remove or falsify **copyright notices, NOTICE files, ATTRIBUTION.md, or SPDX headers** required by Apache-2.0 and GDL’s published notices.
+
+4.2 Licensee **shall not** state or imply that Licensee **owns** the **Gobbo 9D Voxel Datum**, **STAMP**, **STAMP Format**, or **E-STAMP** **as intellectual property of Licensee**, or that Licensee is the **inventor** in place of **Adam Gobbo** or **GDL**, except to describe Licensee’s **own independent implementations** **clearly separated** from GDL’s official formats and marks.
+
+---
+
+## 5. Term, breach, suspension
+
+5.1 **Term.** This Agreement begins on first use of Licensed Materials and continues until terminated.
+
+5.2 **Material breach.** Failure to comply with §§2–4 is a **material breach** of **this Agreement** (independent of Apache-2.0 compliance).
+
+5.3 **Remedies.** Subject to applicable law and **procedural** requirements, GDL may seek **injunctive and equitable relief**, **actual damages**, **enhanced damages** where permitted by statute, **recovery of attorneys’ fees and costs** to the extent awarded by a court, and **any other relief** available for **breach of contract**, **false designation of origin**, **unfair competition**, or **trademark misuse**, as applicable.
+
+5.4 **No waiver.** Failure to enforce a provision is not a waiver.
+
+---
+
+## 6. Governing law; jurisdiction; venue
+
+6.1 **Governing law.** This Agreement is governed by the **laws of the State of Delaware**, **without regard to** conflict-of-law rules that would apply another jurisdiction’s law.
+
+6.2 **Jurisdiction and venue.** Subject to applicable federal law, Licensee **consents** to the **personal jurisdiction** of the **state courts of the State of Delaware** and the **United States District Court for the District of Delaware** for any action **arising out of or relating to** this Agreement or Licensee’s use of the Licensed Materials **in connection with** the obligations in §§2–4. Licensee **waives** any objection to venue in those courts **except** where **validly prohibited** by applicable statute or public policy.
+
+6.3 **Court of Chancery.** To the extent a claim seeks **equitable relief** (including **injunctive relief**) and the **Court of Chancery of the State of Delaware** has **subject-matter jurisdiction**, Licensee **consents** to suit there **for such equitable claims**. **GDL acknowledges** that Chancery **does not** hear all categories of disputes; §6.2 remains **operative** for damages and other claims **outside** Chancery’s jurisdiction.
+
+---
+
+## 7. Miscellaneous
+
+7.1 **Severability.** If a provision is invalid, the remainder remains in effect to the maximum extent permitted.
+
+7.2 **Assignment.** GDL may assign; Licensee may not assign without GDL’s consent except as part of a **bona fide** merger or sale of substantially all assets with notice.
+
+7.3 **Entire agreement (marks/nomenclature).** For **marks and nomenclature obligations** in §§2–4, this document is the **entire agreement** between the parties **on those subjects** as delivered with the Licensed Materials, **subject to** Apache-2.0 for **copyright license** scope.
+
+7.4 **Export.** Licensee complies with **U.S. export** and sanctions laws.
+
+---
+
+## Exhibit A — Permitted Gobbo Designations (copy/paste)
+
+Use **only** these strings for **Covered Gobbo References**:
+
+1. Gobbo 9D Voxel Datum  
+2. Gobbo 9D Voxel  
+3. Gobbo 9D  
+4. Gobbo Voxel  
+5. Gobbo Datum  
+
+## Exhibit B — STAMP naming (copy/paste)
+
+- **STAMP**  
+- **STAMP Format**  
+- **E-STAMP** (where referring to E-STAMP outputs per GDL documentation)  
+
+---
+
+*Draft for counsel review. Gobbo Datum Labs. Copyright 2026 Gobbo Datum Labs.*

gobbo-2.0.0/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following
+boilerplate notice, with the fields enclosed by brackets "[]"
+replaced with your own identifying information. (Don't include
+the brackets!)  The text should be enclosed in the appropriate
+comment syntax for the file format. We also recommend that a
+file or class name and description of purpose be included on the
+same "printed page" as the copyright notice for easier
+identification within third-party archives.
+
+Copyright 2026 Gobbo Datum Labs
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

gobbo-2.0.0/MANIFEST.in

@@ -0,0 +1,14 @@
+include README.md
+include LICENSE
+include NOTICE
+include ATTRIBUTION.md
+include EULA.md
+include TRADEMARKS.md
+include CITATION.cff
+recursive-include docs *.md
+include gobbo/PRD.md
+recursive-include gobbo/docs *.md
+recursive-include gobbo/examples *.py
+recursive-include gobbo/core/local_voxels *.json
+recursive-include us_cities *.geojson
+recursive-include tests *.py *.json

gobbo-2.0.0/NOTICE

@@ -0,0 +1,22 @@
+Gobbo Datum SDK — Gobbo 9D Voxel Datum with STAMP Technology
+Copyright 2026 Gobbo Datum Labs. All rights reserved.
+
+Original technical authorship and invention: Adam Gobbo (founder / inventor).
+
+This product includes software developed by Gobbo Datum Labs and contributors.
+
+Project attribution:
+- Name: Gobbo Datum SDK (Python package: gobbo — installed via `pip install gobbo`)
+- Technology: Gobbo 9D Voxel Datum; STAMP and E-STAMP interaction surfaces
+- Origin: Gobbo Datum Labs
+- Repository: https://github.com/gobbo-datum-labs/gobbo
+
+The names “Gobbo”, “Gobbo Datum”, “Gobbo 9D Voxel Datum”, “STAMP”, and “E-STAMP”
+refer to technologies originated by Gobbo Datum Labs and Adam Gobbo.
+
+If you redistribute this software or derivative works under Apache-2.0, retain
+this NOTICE (or equivalent attribution notices) as described in the Apache
+License, Version 2.0. Do not misrepresent the authorship or ownership of the
+underlying Gobbo / STAMP technology.
+
+Integrator citation guidance: see ATTRIBUTION.md in this package.

gobbo-2.0.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: gobbo
+Version: 2.0.0
+Summary: Gobbo 9D Voxel Datum and STAMP Technology — universal positioning (octree paths), pairwise STAMP / E-STAMP helpers, and optional HTTP client for Secure Envelope APIs. Copyright Gobbo Datum Labs; inventor: Adam Gobbo.
+Author: Adam Gobbo
+Author-email: Gobbo Datum Labs <support@gobbodatumlabs.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/gobbo-datum-labs/gobbo
+Project-URL: Documentation, https://github.com/gobbo-datum-labs/gobbo
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Provides-Extra: http
+Requires-Dist: requests>=2.28.0; extra == "http"
+Provides-Extra: http-strict
+Requires-Dist: requests>=2.28.0; extra == "http-strict"
+Requires-Dist: pydantic>=2.4.0; extra == "http-strict"
+Provides-Extra: geospatial
+Requires-Dist: pyproj; extra == "geospatial"
+Requires-Dist: mgrs; extra == "geospatial"
+Requires-Dist: packaging; extra == "geospatial"
+Requires-Dist: laspy; extra == "geospatial"
+Requires-Dist: rasterio; extra == "geospatial"
+Requires-Dist: shapely; extra == "geospatial"
+Requires-Dist: mpmath; extra == "geospatial"
+Provides-Extra: gnss
+Requires-Dist: numpy>=1.19; extra == "gnss"
+Provides-Extra: nav
+Requires-Dist: numpy>=1.19; extra == "nav"
+Requires-Dist: ultralytics; extra == "nav"
+Requires-Dist: opencv-python-headless; extra == "nav"
+Dynamic: license-file
+
+# gobbo — Gobbo 9D Voxel Datum + STAMP Technology
+
+**Copyright 2026 Gobbo Datum Labs.** **Gobbo 9D Voxel Datum** with **STAMP Technology** — **inventor: Adam Gobbo.** Licensed under **Apache-2.0**; retain `LICENSE`, `NOTICE`, `ATTRIBUTION.md`, and **`EULA.md`** when redistributing. See `ATTRIBUTION.md` for citation text and goodwill rules.
+
+**Binding supplemental terms:** By **downloading, installing, or using** this package, you agree to **`EULA.md`** (marks, **Permitted Gobbo Designations**, **STAMP** / **STAMP Format** naming). *Delaware counsel should finalize before enforcement.*
+
+**Open source:** install from PyPI with `pip install gobbo`. Source and issues live at **[github.com/gobbo-datum-labs/gobbo](https://github.com/gobbo-datum-labs/gobbo)**. Writing STAMPs with this SDK is free; **reading/querying** the hosted Secure Envelope collection remains a paid service on [www.secure-envelope.com](https://www.secure-envelope.com).
+
+Universal positioning framework for converting spatial data to Gobbo octree paths. "The one datum to rule them all."
+
+## Installation
+
+```bash
+pip install gobbo
+```
+
+```python
+import gobbo
+```
+
+That is the only install line and the only import name. The core package is
+dependency-free standard-library Python.
+
+**Optional dependency groups:**
+
+```bash
+pip install "gobbo[geospatial]"   # pyproj, laspy, rasterio, shapely, mpmath, mgrs — UTM/MGRS + file parsers
+pip install "gobbo[gnss]"         # NumPy — PPP helpers in gobbo.core.gnss
+pip install "gobbo[nav]"          # YOLO / OpenCV — map-scene and nav da3_yolo
+pip install "gobbo[http]"         # requests — GobboClient for hosted /api/stamps/*
+pip install "gobbo[http-strict]"  # requests + pydantic — typed HTTP responses
+```
+
+## Learn it (training course ships in the package)
+
+A complete beginner-to-formal course is bundled inside the wheel:
+
+- **`gobbo/docs/training/README.md`** — Lessons 0–8: why Gobbo, the nine
+  dimensions, G-Line / H-Plane / N-Line, depth + Sphere-in-Cube, STAMP
+  Technology, a hands-on first-stamp tutorial, 2TD vs GHN angles, the
+  identity epoch, and collections.
+- **`gobbo/docs/formal/PRIMER.md`** — faithful condensed formal primer with
+  pointers to the frozen normative specifications.
+- **`gobbo/examples/`** — runnable scripts (`01_lla_to_voxel.py`,
+  `02_create_stamp.py`, `03_ghn_and_2td.py`).
+
+Locate them after install:
+
+```python
+import gobbo, pathlib
+print(pathlib.Path(gobbo.__file__).parent / "docs" / "training")
+```
+
+## Quick start
+
+```python
+import gobbo
+
+# Position → voxel identity (identity epoch v2, exact on every platform)
+path_int, depth = gobbo.gobbo_from_lla(40.6413, -73.7781, 4.0, depth=30)
+print(gobbo.path_int_to_path_oct(path_int, depth))
+
+# Honest depth from GPS precision (Sphere-in-Cube rule)
+d = gobbo.gobbo_depth_for_precision_lla(40.6413, -73.7781, 4.0, 5.0)
+
+# Mint an immutable STAMP fact (stampv:2 content-addressed id + frozen sentence)
+stamp = gobbo.create_stamp(
+    lat=40.6413, lon=-73.7781, alt=4.0, depth=30,
+    temporal=1752444000, assignment="sensor:jfk-roof-1",
+    metric="temperature_c", point=22.5, source="quickstart",
+)
+print(stamp.stamp_id)
+print(stamp.sentence)
+```
+
+## Features
+
+- Convert ECEF, LLA, UTM, MGRS to Gobbo paths; decode paths back to
+  centers/bounds (LBF lattice doctrine).
+- **Exact identity core** (`gobbo.core.gobbo_exact`): BigInt fixed-point
+  WGS-84 transform, picometer voxel grid, deterministic trig — bit-identical
+  voxel identity across Python / TypeScript / Kotlin / Swift (identity
+  epoch v2).
+- **STAMP minting** (`gobbo.create_stamp`) with the frozen `stampv:2`
+  canonical serialization and SHA-256 `stamp_id`.
+- **GHN frame** (`gobbo.gobbo_ghn_basis`): G-Line / H-Plane / N-Line local
+  NED basis at any voxel center.
+- **Pairwise STAMP interaction math:** line counts C(n,2), Gobbo Azimuth /
+  Tilt / distance (2TD) from ECEF deltas, linear E-STAMP along a segment,
+  1/8 parent mean and partial-n mean over children (see
+  `docs/PAIRWISE_LINES_AND_ENRICHMENTS.md`).
+- Parse LAS, GeoJSON, SRTM to voxel lists when the `geospatial` extra is
+  installed.
+- Spatial ops: overlap, diff, fuse, distance.
+- CLI entry point: `gobbo` (see `gobbo/core/cli.py`).
+
+## HTTP client (Secure Envelope STAMP API)
+
+For calling a deployed API (`/api/stamps/push`, `by-voxel`, E-STAMP routes),
+install the **`http`** extra and use `gobbo.http_client.GobboClient`:
+
+```python
+from gobbo.http_client import GobboClient
+
+client = GobboClient(
+    "https://your-deployment.example",
+    bearer_token="...",  # optional for public routes
+    api_key="...",       # optional if the server enables x-api-key
+)
+rows = client.get_stamps_by_voxel(path_int="123", depth=23)
+```
+
+Strict response parsing (Pydantic):
+
+```python
+from gobbo.http_client import GobboClient
+from gobbo.stamp_http_models import parse_by_voxel_response
+
+client = GobboClient("https://example.com", bearer_token="…")
+data = client.get_stamps_by_voxel(path_int="1", depth=10)
+typed = parse_by_voxel_response(data)
+```
+
+TypeScript equivalents: npm **`gobbo-stamp-sdk`** (HTTP) and
+**`gobbo-datum-ts-sdk`** (canonical `path_int` / STAMP math). Method parity
+is checked in CI (`scripts/sdk-http-surface.json`, `npm run check:sdk-parity`).
+
+## Deterministic STAMP utilities
+
+**`fact_kind` (B.12)** must be one of: `raw_measurement`,
+`derived_measurement`, `estimate`, `label`, `correction` — same as the hosted
+API schema. Defaults use `raw_measurement`.
+
+- `gobbo.core.stamp_models` — `StampSpatial`, `StampFact`,
+  `StampInteractionRow`, `FACT_KIND_*` literals
+- `gobbo.core.stamp_sentence` — frozen canonical sentence builder
+  (`At {voxel}@{depth} at {timeIso}, {assignment}'s {metric} of {value}.`)
+- `gobbo.core.stamp_canonical` — frozen `stampv:2` serialization +
+  `compute_stamp_id_v2`
+- `gobbo.core.stamp_interactions` — `compute_delta_t_seconds`,
+  `compute_delta_v`, `compute_interaction_metrics`, `build_interaction_row`
+
+CLI access for non-developers:
+
+```bash
+gobbo stamp-sentence --path-int 123 --depth 10 --temporal "2026-04-12T10:11:12Z" --assignment "sensor.alpha" --metric "temperature_c" --point 23.5
+```
+
+## Tests and conformance
+
+Golden-vector conformance (identity epoch v2 + `stampv:2`) and the full test
+suite:
+
+```bash
+python3 -m unittest discover -s tests
+```
+
+TypeScript parity checks require the geospatial extra
+(`pip install "gobbo[geospatial]"`).
+
+## Documentation in this bundle
+
+| Path | Contents |
+|------|----------|
+| `gobbo/docs/training/` | Lessons 0–8 — full beginner-to-formal course |
+| `gobbo/docs/formal/PRIMER.md` | Formal primer → frozen specs bridge |
+| `gobbo/examples/` | Runnable training example scripts |
+| `docs/PAIRWISE_LINES_AND_ENRICHMENTS.md` | Pairwise lines, §7 encoding, E-STAMP linear model, parent/child means |
+| `gobbo/PRD.md` | Product requirements (historical MVP scope) |
+| `gobbo/core/gobbo.py` | Octree path generation, converters, spatial ops |
+| `gobbo/core/gobbo_exact.py` | Exact fixed-point identity core (epoch v2) |
+| `gobbo/core/requirements.txt` | Optional geospatial stack |
+
+## License and attribution
+
+- License: **Apache-2.0** (`LICENSE`)
+- Required attribution notices: `NOTICE`
+- Branding/trademark usage guidance: `TRADEMARKS.md`
+- Suggested software citation metadata: `CITATION.cff`
+
+The Apache-2.0 license keeps the SDK open source and broadly adoptable, while
+`NOTICE` and `TRADEMARKS.md` preserve clear attribution to Gobbo Datum and
+Gobbo Datum Labs and protect against misleading branding.
+
+## Pro download
+
+Subscribers can also download this SDK from the Secure Envelope dashboard
+(authenticated **Download ZIP**). The archive matches the tracked
+`content/sdk/gobbo-datum-sdk` tree in the product repository.