any2heliosdb 0.9.1__tar.gz

any2heliosdb-0.9.1/.github/workflows/publish.yml

@@ -0,0 +1,60 @@
+name: Publish to PyPI
+
+# Publishes any2heliosdb to PyPI via Trusted Publishing (OpenID Connect) — no
+# API token or stored secret. PyPI is configured with a Trusted Publisher for
+# HeliosDatabase/Any2HeliosDB, workflow `publish.yml`, environment `pypi`.
+#
+# Triggers:
+#   * a published GitHub Release (the normal path — tag a release, it publishes)
+#   * manual dispatch from the Actions tab (for the first release / re-runs)
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build & verify distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install package + run unit tests
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .[dev]
+          python -m pytest tests/unit -q
+      - name: Build sdist + wheel and check metadata
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+          python -m twine check dist/*
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/any2heliosdb
+    permissions:
+      id-token: write        # REQUIRED: mints the OIDC token Trusted Publishing uses
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

any2heliosdb-0.9.1/.gitignore

@@ -0,0 +1,34 @@
+# Runtime data for local test targets (HeliosDB data dirs, server logs)
+.runtime/
+# Migration working output (schema/data/reports/logs + run manifests)
+migration_output/
+*.hdb
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Secrets must never be committed; config references env vars instead.
+*.secret
+.env
+
+# Stray HeliosDB server runtime dirs (if a target is pointed at the repo root)
+heliosdb-data/
+data/
+# CDC + resume state written under a project output dir
+*.db
+trail/
+
+# Claude Code agent worktrees / local session state
+.claude/

any2heliosdb-0.9.1/CHANGELOG.md

@@ -0,0 +1,206 @@
+# Changelog
+
+All notable changes to Any2HeliosDB are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [0.9.1] — 2026-06-24
+
+### Added
+- **`a2h monitor` — live full-screen migration dashboard.** A new command that
+  reads the run manifest READ-ONLY (sqlite WAL allows a concurrent reader) and
+  renders a Rich full-screen view of an in-progress (or finished) run: per-table
+  status, chunks loaded/total, rows loaded, a progress bar, and **volume left**,
+  plus roll-up totals (tables done, overall %, aggregate volume left, elapsed,
+  ETA). `a2h monitor -c <cfg>` attaches to the exact run a concurrent
+  `a2h migrate -c <cfg>` is writing; `--once` renders a single frame for
+  non-TTY/CI. The loader now records a source row estimate (one `count(*)` per
+  table at plan time, guarded) so volume-left and ETA are meaningful.
+  Demonstrated live on a 49,636-row PostgreSQL → PostgreSQL Pagila migration
+  (done-counter climbing, volume-left counting down, in-flight tables shown).
+- **Stock PostgreSQL as a first-class target.** The `psycopg` driver already
+  speaks the PostgreSQL wire protocol, so pointing `[target]` at a real
+  PostgreSQL server migrates Oracle/MySQL/SQL-Server → PostgreSQL (a2h as a
+  straight Ora2Pg replacement, not only → HeliosDB). The capability probe now
+  recognises a stock-PostgreSQL banner (`Edition.POSTGRES`) instead of
+  `unknown`, and the wizard names PostgreSQL as a valid target. Validated
+  **Oracle → PostgreSQL 16** end-to-end (migrate + test-count + test-data,
+  including the Oracle sequence — which real PostgreSQL creates natively).
+- **View translation on the PG-wire path** (#36). A source view's body is run
+  through the dialect rewriter (NVL/DECODE/SYSDATE/ROWNUM/seq.NEXTVAL/`(+)`) so an
+  Oracle/MySQL view doesn't reach the target as raw source SQL (native-Oracle and
+  MySQL targets keep the source body).
+
+### Fixed (hardening against stock PostgreSQL — HeliosDB's leniency had masked these)
+- **BOOLEAN column defaults** translate to boolean literals: a MySQL
+  `TINYINT(1)`→`BOOLEAN` column with `DEFAULT 1/0` was emitted as `BOOLEAN
+  DEFAULT 1`, which strict PostgreSQL rejects → now `DEFAULT true/false`.
+- **Boolean comparisons in views** (`WHERE <boolcol> = 1`) are normalized to
+  `= true/false` for the schema's actual BOOLEAN columns, so a MySQL view migrates
+  to strict PostgreSQL.
+- **Schema-unique index names**: Oracle/MySQL allow the same index name on
+  different tables; PostgreSQL-family targets require it unique, so the second
+  index was skipped — now deduped (table-prefixed, then a counter).
+- **Sequence idempotency**: `drop_existing` now drops sequences too, so a re-run
+  re-creates them cleanly instead of warning "already exists".
+- **Silent data loss on `drop_existing` re-migrate** (data correctness): a
+  re-migration recreated the tables empty, but the resume manifest still marked
+  the chunks `LOADED`, so the loader skipped them and reported stale success.
+  `drop_existing` now resets the run's chunk state (while `resume` still
+  continues from the manifest), so the recreated tables are always reloaded.
+- **CDC Nano gate → 3.58.3** (the `E'…'` literal fix makes bytea `ON CONFLICT`
+  upserts correct).
+
+### Validated
+- **The HeliosDB-Full target gaps surfaced in v0.9.0 are now fixed in Full
+  `main` and confirmed end-to-end through a2h** (Full rebuilt from `main`,
+  PG-wire): an Oracle sequence (`EMP_SEQ`) migrates as a real `CREATE SEQUENCE`
+  with its value preserved — `nextval` returns 100, no degrade-to-warning
+  (**#44**); `sum(<const>)` is correct on a multi-row table — `sum(1)` = row
+  count, `sum(5)` = 5×rows (**#42**); and the psycopg3 extended-protocol path
+  (PK-sampled parameterized `TEST_DATA`) runs with no SELECT desync (**#22**).
+  Oracle HR → Full end-to-end: `TEST_COUNT` 3/3 matched, `TEST_DATA` 0
+  mismatches across all tables.
+
+## [0.9.0] — 2026-06-23
+
+Migration-correctness milestone: the HeliosDB-Full composite-PK count bug is
+fixed (so row-count validation is trustworthy), a full adversarial review
+hardened the tool end-to-end, and AI-agent administration (MCP) shipped.
+
+### Added
+- **Log-based CDC — MySQL binlog**: a `mysql-replication` ROW-binlog capture
+  source producing real `I`/`U`/`D` change records (**including deletes**) with
+  the binlog coordinate as the cursor; new `[mysql-cdc]` extra. The CDC engine
+  dispatches capture by source dialect (Oracle SCN-watermark vs MySQL binlog).
+- **MCP server** (`a2h mcp serve`): JSON-RPC server exposing 16 engine tools for
+  AI-agent administration, with Bearer-token auth + viewer/operator/admin RBAC
+  over HTTP and stdio (stdlib JSON-RPC fallback on Python 3.9). New `[mcp]` extra.
+- **CLI reference + worked-examples** docs (`docs/reference/cli.md`,
+  `docs/guides/examples.md`).
+
+### Fixed (correctness — from the v0.9.0 adversarial review)
+- **Identifier quoting unified** across DDL / loader / validators via
+  `core.identifiers`: reserved words and `preserve_case` render byte-identically,
+  so a reserved/mixed-case table or column can no longer be created under one
+  name and then loaded/validated under another.
+- **TEST_DATA** no longer false-fails on `timestamptz` (compares the UTC instant
+  regardless of tz-aware vs naive wire form) or `ARRAY` columns (serializes a
+  source list to the exact PG array literal the target stores).
+- **PostgreSQL source**: pins `search_path` to the source schema (unqualified
+  reads can't hit a same-named table in another schema); reserved-aware reads;
+  composite-FK columns paired by ordinal via `pg_catalog` conkey/confkey;
+  `numeric_pk_bounds` floors so a negative fractional PK can't skip rows.
+- **Declarative-partition children** excluded from the PostgreSQL source (no
+  duplicate data; parent table carries all rows).
+- **Chunking** range-DELETE predicate uses the shared quoter (reserved/mixed PK).
+- **`a2h resume`** exits non-zero on remaining failed chunks, like `migrate`.
+- **CDC apply** preserves trail order (a `DELETE`→`INSERT` leaves the row present).
+- **CDC MySQL binlog** fails closed unless `binlog_format=ROW`,
+  `binlog_row_metadata=FULL`, and `binlog_row_image=FULL`.
+- **Type map**: `timestamp without time zone` no longer promoted to timestamptz;
+  bare Oracle `NUMBER` → `NUMERIC`; PG `USER-DEFINED`/`ARRAY`/tsvector/… → `TEXT`.
+- **Oracle source**: FK referenced columns read from the referenced constraint;
+  sequence `START WITH` from `LAST_NUMBER`; floor()-based PK bounds.
+
+### Validated
+- End-to-end against **HeliosDB-Full rebuilt with the composite-PK count fix**
+  (issue #37, merged to Full `main`): **Pagila (real PostgreSQL — 65k rows with
+  `timestamptz`, arrays, composite PKs, declarative partitions), Oracle, and
+  MySQL → Full** all green (migrate + `test-count` + `test-data`, 0 mismatches).
+  SQL Server 2022 → Full validated previously. HeliosDB-Lite (PG-compat batch)
+  and Nano 3.58.2 (`ON CONFLICT`) validated when those target fixes were
+  committed; a fresh Lite/Nano re-run is deferred (a `heliosdb-lite start`
+  headless-daemon defect, tracked target-side).
+
+### Target gaps surfaced (fix-in-HeliosDB, not tool bugs)
+- HeliosDB-Full: `CREATE SEQUENCE` / `nextval` unimplemented over PG-wire (a2h
+  emits standard PG sequence DDL and degrades to a warning); `sum(<const>)`
+  wrong on composite-PK tables (the count(*)/count(1) sibling of #37).
+
+## [0.9.0-rc2] — 2026-06-23
+
+Heterogeneous targets, migrate-back, and CDC deletes — the engine is now
+any-to-any, not just any-to-HeliosDB.
+
+### Added
+- **MySQL target driver** (`[target] driver="mysql"`, PyMySQL; `INSERT` +
+  `ON DUPLICATE KEY UPDATE`) and a **PostgreSQL-wire source adapter** (read a
+  HeliosDB/PostgreSQL server *out*), plus an orchestrator **dialect dispatch**
+  (postgres / oracle / mysql) for DDL + identifiers. Validated **Oracle→MySQL**
+  and **HeliosDB→MySQL** (migrate-back, the GoldenGate-reverse direction).
+- **CDC delete reconciliation** (`replicat --reconcile-deletes/--no-deletes`):
+  a source/target key-set diff removes rows deleted at the source; battle-tested
+  and CI-asserted.
+- Validation normalization (numeric trailing-zero, boolean, bytea-hex) so row
+  checksums agree across drivers, editions, and heterogeneous targets.
+
+### Found (filed against HeliosDB, per the governing principle)
+- **#35** — PG-wire catalog/introspection gaps (no PK/FK/index or precision
+  metadata; catalog queries reject bind parameters) that limit HeliosDB as a
+  *source*; the tool works around them (`test-count` gates migrate-back).
+
+### Suites
+- 76 unit + 7 integration tests green: Oracle/MySQL → Lite/Full/Nano,
+  Oracle → MySQL, HeliosDB → MySQL, CDC snapshot + incremental + deletes.
+
+## [0.9.0-rc1] — 2026-06-23
+
+First public-shaped release candidate. **Oracle and MySQL → HeliosDB** (Lite,
+Full, Nano) via the `psycopg` driver, validated end-to-end against live servers,
+plus a full documentation set with a compatibility matrix.
+
+### Added in 0.9.0-rc1
+- **MySQL source adapter** — `information_schema` introspection to the canonical
+  IR, `SSCursor` streaming, `TINYINT(1)`→`BOOLEAN`; validated migrate + validate
+  on Lite, Full, and Nano (Oracle-parity).
+- **Native (Oracle-wire) driver** — `NativeOracleDriver` + Oracle-dialect DDL +
+  orchestrator integration; code-complete and unit-tested (live parity test
+  gated on a HeliosDB TNS-version fix).
+- **Documentation** — README compatibility matrix, getting-started + configuration
+  guides, per-target migration guides, CDC guide, CLI + type-mapping reference,
+  troubleshooting.
+- Validation hardening: boolean and BYTEA-hex-string normalization so checksums
+  agree across drivers/editions.
+
+### Carried from the pre-v2 core
+- **CLI `a2h`** (Typer + Rich): `doctor`, `wizard`, `assess`, `export`,
+  `migrate`, `load`, `status`, `resume`, `test`/`test-count`/`test-data`,
+  `report`, `extract`/`replicat`/`extracts`.
+- **Oracle source adapter** — `ALL_*` introspection to a canonical IR; streamed
+  extraction with tuned arraysize; LOB/NULL/empty-string fidelity.
+- **Type map + DDL emitters** — data-driven, `DATA_TYPE`/`MODIFY_TYPE`
+  overridable; FKs emitted after data; idempotent views.
+- **Target drivers** — portable `psycopg` driver with an edition/version
+  capability probe (Nano/Lite/Full); `native` (Oracle TNS) on the roadmap.
+- **Data engine** — PK-range chunking, parallel `ThreadPoolExecutor` load, and a
+  durable SQLite-WAL manifest. Chunks are idempotent (DELETE-range + load in one
+  transaction); `resume` continues an interrupted load with no duplicates. A
+  serial-retry pass lets parallel loads converge even when a target can't run
+  concurrent transactions.
+- **Validation** — TEST (structure), TEST_COUNT (row counts), TEST_DATA
+  (PK-sampled value + checksum); non-zero exit for CI gating.
+- **Wizard + smoke test** — connect both ends, detect edition, probe
+  capabilities, and round-trip a tiny COPY to prove NULL-vs-empty-string fidelity.
+- **CDC spine (v1)** — Oracle SCN-watermark capture → durable append-only trail
+  → idempotent replicat; independent capture watermark and apply cursor.
+  Battle-tested end-to-end against HeliosDB-Full (snapshot + incremental capture,
+  UPDATE/INSERT propagation, idempotent re-apply).
+- **PL/SQL rewrite + gap report** and **assessment** (SHOW_*/SHOW_REPORT) with
+  cost scoring.
+
+### Fixed (HeliosDB, via the target-gap workflow)
+- Lite: `version()`/`current_setting()`, COPY-FROM-STDIN permission + quoted
+  identifiers.
+- Full: trust auth without SASL, COPY-FROM-STDIN parsing, binary-param null-byte
+  check.
+
+### Known gaps (resolved in current builds)
+- Lite (rc1-era): NUMERIC/DECIMAL columns created as type `unknown` (breaks
+  numeric comparison), parameterized WHERE matched nothing, ON CONFLICT ignored
+  with bind params, concurrent transactions rejected. The tool worked around
+  these (literal SQL, serial-retry) and CDC apply is proven on Full; **all are
+  resolved in the current Lite build** — see
+  [HeliosDB compatibility](docs/heliosdb-compatibility.md).
+
+### Notes
+- Python 3.9+. Apache-2.0. Clean-room implementation.

any2heliosdb-0.9.1/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 The Any2HeliosDB Authors
+
+   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.