hindsight-pg0-configurable 0.1.0__tar.gz

hindsight_pg0_configurable-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+.pytest_cache/
+.ruff_cache/
+__pycache__/
+dist/
+src/hindsight_pg0_configurable/data/*.zip
+src/hindsight_pg0_configurable/data/*.tar.gz

hindsight_pg0_configurable-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dark Light
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hindsight_pg0_configurable-0.1.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.5
+Name: hindsight-pg0-configurable
+Version: 0.1.0
+Summary: Configurable native PostgreSQL and pgvector launcher for Hindsight on Windows
+Author: Dark Light
+License-Expression: MIT
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+License-File: licenses/PostgreSQL.txt
+License-File: licenses/Theseus.txt
+License-File: licenses/pgvector.txt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database :: Database Engines/Servers
+Requires-Python: >=3.11
+Requires-Dist: filelock<4,>=3.20.1
+Requires-Dist: python-dotenv<2,>=1.2.1
+Provides-Extra: full
+Requires-Dist: hindsight-api<2,>=1.0.0; extra == 'full'
+Provides-Extra: slim
+Requires-Dist: hindsight-api-slim<2,>=1.0.0; extra == 'slim'
+Description-Content-Type: text/markdown
+
+# hindsight-pg0-configurable
+
+Run Hindsight with PostgreSQL and pgvector in an explicitly configured native
+installation directory. Database data, credentials, locks and logs live in a
+separate writable state directory. Intended for native Windows x86-64 setups
+where application-control policy prohibits executing PostgreSQL from a user
+profile. No Docker, service registration, symbolic links or runtime downloads.
+
+**Initial alpha release. The Python launcher and Windows archive layout are
+checked on macOS; execution of these binaries under Windows and any corporate
+policy is not yet validated.** This package does not grant execution rights.
+The selected executable directory and its EXE/DLL files must be permitted by IT.
+
+This is an independent launcher, not an official Hindsight or pg0 release. It
+does not replace the `pg0` Python module or satisfy a dependency named
+`pg0-embedded`. It uses Hindsight's supported `HINDSIGHT_API_DATABASE_URL`
+setting, so an installed original pg0 package can coexist without being used
+by this launcher. Launch through this package, rather than `hindsight-api`.
+
+## Install through PyPI or your Artifactory PyPI proxy
+
+Use Python 3.11 or newer and the same Python environment for all commands:
+
+```powershell
+python -m pip install "hindsight-pg0-configurable[full]==0.1.0"
+```
+
+For a slim Hindsight installation, use `[slim]` instead of `[full]`; configure
+your embedding and reranking providers as required by Hindsight. If Hindsight
+is already installed in this environment, the base package is sufficient:
+
+```powershell
+python -m pip install hindsight-pg0-configurable==0.1.0
+```
+
+The optional extras accept Hindsight 1.x. Actual availability of Hindsight's
+transitive dependencies depends on your Artifactory mirror and Python version.
+The launcher does not configure or download LLMs or embedding models.
+
+## Prepare PostgreSQL once
+
+Replace the example executable path with the directory approved by your IT.
+The installation root will contain `bin`, `lib`, and `share`. Preparation needs
+write access to the destination's parent directory; a destination may be absent
+or empty. A populated directory is never overwritten. An IT operator may
+prepare the directory and subsequently grant normal users read/execute access.
+
+```powershell
+$env:HINDSIGHT_PG_INSTALLATION_DIR = 'C:\Program Files\Firma\Hindsight\PostgreSQL-18.1'
+python -m hindsight_pg0_configurable prepare
+```
+
+The wheel and source distribution already contain PostgreSQL 18.1.0 and
+pgvector 0.8.5 Windows archives, the same versions used by pg0-embedded 0.15.2.
+Preparation checks their pinned SHA-256 digests and copies real files into the
+requested location. It does not execute the archives' contents. Runtime startup
+only reads this native installation and does not unpack or update it.
+
+Alternatively provision a compatible PostgreSQL installation with pgvector
+through IT and point the launcher at its installation root; `prepare` is then
+unnecessary. `prepare` bundles Windows x86-64 only. An explicitly supplied
+native installation also permits development checks on other operating systems.
+
+## Configure and run Hindsight
+
+Set these variables in every new terminal or persist them in your approved
+launcher configuration. No registry changes are made by this package.
+
+```powershell
+$env:HINDSIGHT_PG_INSTALLATION_DIR = 'C:\Program Files\Firma\Hindsight\PostgreSQL-18.1'
+$env:HINDSIGHT_PG_STATE_DIR = "$env:LOCALAPPDATA\Firma\HindsightPg0"
+
+# Add your normal HINDSIGHT_API_LLM_* / embeddings / reranker configuration.
+python -m hindsight_pg0_configurable run
+```
+
+Pass ordinary Hindsight foreground options after `--`, for example:
+
+```powershell
+python -m hindsight_pg0_configurable run -- --host 127.0.0.1 --port 8888
+```
+
+The launcher initializes a dedicated cluster on first start, binds PostgreSQL
+to `127.0.0.1:55439`, creates the database and enables pgvector, and supplies
+Hindsight's database URL. SCRAM authentication uses a generated password.
+Hindsight still requires your normal provider settings. The original
+`hindsight-api` command does not automatically adopt this configuration.
+
+Provider settings in a discovered `.env` are loaded first. The launcher then
+sets its own database URL and disables further dotenv reloads for the process
+and its workers. Existing read-replica and migration URL overrides are cleared
+for this dedicated local cluster. A stale `.env` therefore cannot switch it
+back to the original embedded pg0 or another database.
+
+The cluster started by `run` stops when foreground Hindsight exits normally.
+A cluster already running before `run` is borrowed and remains running.
+`--daemon` is unsupported. An abrupt process kill can leave PostgreSQL running;
+use `status` and `stop` to manage this dedicated instance.
+
+```powershell
+python -m hindsight_pg0_configurable status
+python -m hindsight_pg0_configurable start
+python -m hindsight_pg0_configurable stop
+```
+
+| Variable | Default / meaning |
+| --- | --- |
+| `HINDSIGHT_PG_INSTALLATION_DIR` | Required absolute native installation root |
+| `HINDSIGHT_PG_STATE_DIR` | `%LOCALAPPDATA%\HindsightPg0` on Windows |
+| `HINDSIGHT_PG_NAME` | `hindsight`; dedicated instance subdirectory |
+| `HINDSIGHT_PG_PORT` | `55439`; explicit port, no automatic switching |
+| `HINDSIGHT_PG_USERNAME` | `hindsight`; initial cluster owner |
+| `HINDSIGHT_PG_DATABASE` | `hindsight` |
+| `HINDSIGHT_PG_PASSWORD` | Optional initial password; otherwise generated |
+
+The state directory stores the password in `<name>\manager.json` and must
+remain private to the user. POSIX state files use mode 0600; Windows uses the
+directory's inherited ACLs. Public status output excludes passwords and URLs.
+This package never deletes clusters or imports existing pg0 data. A nonempty
+unmanaged data directory is refused. Existing instance settings must remain
+unchanged across restarts; choose another instance name for a separate setup.
+
+For a new PostgreSQL or pgvector release, prepare a new installation directory
+and plan any required database migration separately. Upgrading this Python
+package alone does not modify installed native files or existing databases.
+
+## Build and release
+
+```sh
+python scripts/fetch_bundles.py
+uv sync --group dev
+uv run pytest
+uv run ruff check .
+uv run ruff format --check .
+uv build
+uv run twine check dist/*
+```
+
+`scripts/fetch_bundles.py` downloads only the pinned upstream release archives,
+verifies their hashes and adds them to the distribution data directory. The
+archives are not versioned in Git. Both wheel and sdist must contain them;
+inspect built distributions before publication. Publishing uses a PyPI API token
+from the environment, never from this repository.
+
+Sources: [Hindsight configuration](https://hindsight.vectorize.io/developer/configuration),
+[pg0 0.15.2 versions](https://github.com/vectorize-io/pg0/blob/v0.15.2/versions.env),
+[PostgreSQL pg_ctl](https://www.postgresql.org/docs/current/app-pg-ctl.html).

hindsight_pg0_configurable-0.1.0/README.md

@@ -0,0 +1,147 @@
+# hindsight-pg0-configurable
+
+Run Hindsight with PostgreSQL and pgvector in an explicitly configured native
+installation directory. Database data, credentials, locks and logs live in a
+separate writable state directory. Intended for native Windows x86-64 setups
+where application-control policy prohibits executing PostgreSQL from a user
+profile. No Docker, service registration, symbolic links or runtime downloads.
+
+**Initial alpha release. The Python launcher and Windows archive layout are
+checked on macOS; execution of these binaries under Windows and any corporate
+policy is not yet validated.** This package does not grant execution rights.
+The selected executable directory and its EXE/DLL files must be permitted by IT.
+
+This is an independent launcher, not an official Hindsight or pg0 release. It
+does not replace the `pg0` Python module or satisfy a dependency named
+`pg0-embedded`. It uses Hindsight's supported `HINDSIGHT_API_DATABASE_URL`
+setting, so an installed original pg0 package can coexist without being used
+by this launcher. Launch through this package, rather than `hindsight-api`.
+
+## Install through PyPI or your Artifactory PyPI proxy
+
+Use Python 3.11 or newer and the same Python environment for all commands:
+
+```powershell
+python -m pip install "hindsight-pg0-configurable[full]==0.1.0"
+```
+
+For a slim Hindsight installation, use `[slim]` instead of `[full]`; configure
+your embedding and reranking providers as required by Hindsight. If Hindsight
+is already installed in this environment, the base package is sufficient:
+
+```powershell
+python -m pip install hindsight-pg0-configurable==0.1.0
+```
+
+The optional extras accept Hindsight 1.x. Actual availability of Hindsight's
+transitive dependencies depends on your Artifactory mirror and Python version.
+The launcher does not configure or download LLMs or embedding models.
+
+## Prepare PostgreSQL once
+
+Replace the example executable path with the directory approved by your IT.
+The installation root will contain `bin`, `lib`, and `share`. Preparation needs
+write access to the destination's parent directory; a destination may be absent
+or empty. A populated directory is never overwritten. An IT operator may
+prepare the directory and subsequently grant normal users read/execute access.
+
+```powershell
+$env:HINDSIGHT_PG_INSTALLATION_DIR = 'C:\Program Files\Firma\Hindsight\PostgreSQL-18.1'
+python -m hindsight_pg0_configurable prepare
+```
+
+The wheel and source distribution already contain PostgreSQL 18.1.0 and
+pgvector 0.8.5 Windows archives, the same versions used by pg0-embedded 0.15.2.
+Preparation checks their pinned SHA-256 digests and copies real files into the
+requested location. It does not execute the archives' contents. Runtime startup
+only reads this native installation and does not unpack or update it.
+
+Alternatively provision a compatible PostgreSQL installation with pgvector
+through IT and point the launcher at its installation root; `prepare` is then
+unnecessary. `prepare` bundles Windows x86-64 only. An explicitly supplied
+native installation also permits development checks on other operating systems.
+
+## Configure and run Hindsight
+
+Set these variables in every new terminal or persist them in your approved
+launcher configuration. No registry changes are made by this package.
+
+```powershell
+$env:HINDSIGHT_PG_INSTALLATION_DIR = 'C:\Program Files\Firma\Hindsight\PostgreSQL-18.1'
+$env:HINDSIGHT_PG_STATE_DIR = "$env:LOCALAPPDATA\Firma\HindsightPg0"
+
+# Add your normal HINDSIGHT_API_LLM_* / embeddings / reranker configuration.
+python -m hindsight_pg0_configurable run
+```
+
+Pass ordinary Hindsight foreground options after `--`, for example:
+
+```powershell
+python -m hindsight_pg0_configurable run -- --host 127.0.0.1 --port 8888
+```
+
+The launcher initializes a dedicated cluster on first start, binds PostgreSQL
+to `127.0.0.1:55439`, creates the database and enables pgvector, and supplies
+Hindsight's database URL. SCRAM authentication uses a generated password.
+Hindsight still requires your normal provider settings. The original
+`hindsight-api` command does not automatically adopt this configuration.
+
+Provider settings in a discovered `.env` are loaded first. The launcher then
+sets its own database URL and disables further dotenv reloads for the process
+and its workers. Existing read-replica and migration URL overrides are cleared
+for this dedicated local cluster. A stale `.env` therefore cannot switch it
+back to the original embedded pg0 or another database.
+
+The cluster started by `run` stops when foreground Hindsight exits normally.
+A cluster already running before `run` is borrowed and remains running.
+`--daemon` is unsupported. An abrupt process kill can leave PostgreSQL running;
+use `status` and `stop` to manage this dedicated instance.
+
+```powershell
+python -m hindsight_pg0_configurable status
+python -m hindsight_pg0_configurable start
+python -m hindsight_pg0_configurable stop
+```
+
+| Variable | Default / meaning |
+| --- | --- |
+| `HINDSIGHT_PG_INSTALLATION_DIR` | Required absolute native installation root |
+| `HINDSIGHT_PG_STATE_DIR` | `%LOCALAPPDATA%\HindsightPg0` on Windows |
+| `HINDSIGHT_PG_NAME` | `hindsight`; dedicated instance subdirectory |
+| `HINDSIGHT_PG_PORT` | `55439`; explicit port, no automatic switching |
+| `HINDSIGHT_PG_USERNAME` | `hindsight`; initial cluster owner |
+| `HINDSIGHT_PG_DATABASE` | `hindsight` |
+| `HINDSIGHT_PG_PASSWORD` | Optional initial password; otherwise generated |
+
+The state directory stores the password in `<name>\manager.json` and must
+remain private to the user. POSIX state files use mode 0600; Windows uses the
+directory's inherited ACLs. Public status output excludes passwords and URLs.
+This package never deletes clusters or imports existing pg0 data. A nonempty
+unmanaged data directory is refused. Existing instance settings must remain
+unchanged across restarts; choose another instance name for a separate setup.
+
+For a new PostgreSQL or pgvector release, prepare a new installation directory
+and plan any required database migration separately. Upgrading this Python
+package alone does not modify installed native files or existing databases.
+
+## Build and release
+
+```sh
+python scripts/fetch_bundles.py
+uv sync --group dev
+uv run pytest
+uv run ruff check .
+uv run ruff format --check .
+uv build
+uv run twine check dist/*
+```
+
+`scripts/fetch_bundles.py` downloads only the pinned upstream release archives,
+verifies their hashes and adds them to the distribution data directory. The
+archives are not versioned in Git. Both wheel and sdist must contain them;
+inspect built distributions before publication. Publishing uses a PyPI API token
+from the environment, never from this repository.
+
+Sources: [Hindsight configuration](https://hindsight.vectorize.io/developer/configuration),
+[pg0 0.15.2 versions](https://github.com/vectorize-io/pg0/blob/v0.15.2/versions.env),
+[PostgreSQL pg_ctl](https://www.postgresql.org/docs/current/app-pg-ctl.html).

hindsight_pg0_configurable-0.1.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,24 @@
+# Third-party notices
+
+The Python launcher is original code under the MIT license in LICENSE.
+This project is independent of Vectorize, Hindsight, and pg0. It does not
+bundle their Python application code. Optional Hindsight extras install the
+upstream distributions separately.
+
+The distribution includes unmodified native archives selected from the same
+release sources as pg0-embedded 0.15.2. Their URLs and SHA-256 digests are in
+`hindsight_pg0_configurable/data/bundles.json`.
+
+- PostgreSQL 18.1.0 Windows x86-64: theseus-rs/postgresql-binaries release
+  18.1.0, PostgreSQL license. The archive's own LICENSE is preserved. See also
+  `licenses/PostgreSQL.txt` and `licenses/Theseus.txt`.
+- pgvector 0.8.5 for PostgreSQL 18 Windows x86-64: nicoloboschi/pgvector_compiled
+  release v0.18.320, PostgreSQL license; source: pgvector/pgvector v0.8.5.
+  See `licenses/pgvector.txt`.
+
+The PostgreSQL archive also includes third-party native runtime libraries and
+tools. Its contents are preserved unchanged; the upstream source, build scripts
+and dependencies are available from https://github.com/theseus-rs/postgresql-binaries.
+This package's MIT license applies to the launcher only and does not relicense
+the native components. No corporate files, credentials, policy settings, or
+private model data are included in the release.

hindsight_pg0_configurable-0.1.0/licenses/PostgreSQL.txt

@@ -0,0 +1,23 @@
+PostgreSQL Database Management System
+(also known as Postgres, formerly known as Postgres95)
+
+Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
+
+Portions Copyright (c) 1994, The Regents of the University of California
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose, without fee, and without a written agreement
+is hereby granted, provided that the above copyright notice and this
+paragraph and the following two paragraphs appear in all copies.
+
+IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
+LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
+DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
+ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO
+PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

hindsight_pg0_configurable-0.1.0/licenses/Theseus.txt

@@ -0,0 +1,7 @@
+Copyright (c) 2024, Theseus
+
+Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.
+
+IN NO EVENT SHALL Theseus BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF Theseus HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Theseus SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN “AS IS” BASIS, AND Theseus HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

hindsight_pg0_configurable-0.1.0/licenses/pgvector.txt

@@ -0,0 +1,20 @@
+Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
+
+Portions Copyright (c) 1994, The Regents of the University of California
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose, without fee, and without a written agreement
+is hereby granted, provided that the above copyright notice and this
+paragraph and the following two paragraphs appear in all copies.
+
+IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
+LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
+DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
+ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO
+PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

hindsight_pg0_configurable-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hindsight-pg0-configurable"
+version = "0.1.0"
+description = "Configurable native PostgreSQL and pgvector launcher for Hindsight on Windows"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE", "THIRD_PARTY_NOTICES.md", "licenses/*"]
+authors = [{name = "Dark Light"}]
+dependencies = ["filelock>=3.20.1,<4", "python-dotenv>=1.2.1,<2"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Database :: Database Engines/Servers",
+]
+
+[project.optional-dependencies]
+slim = ["hindsight-api-slim>=1.0.0,<2"]
+full = ["hindsight-api>=1.0.0,<2"]
+
+[project.scripts]
+hindsight-pg0 = "hindsight_pg0_configurable.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff>=0.8", "build>=1.2", "twine>=6"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hindsight_pg0_configurable"]
+artifacts = ["src/hindsight_pg0_configurable/data/*"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "scripts", "licenses", "pyproject.toml", "README.md", "LICENSE", "THIRD_PARTY_NOTICES.md"]
+artifacts = ["src/hindsight_pg0_configurable/data/*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]

hindsight_pg0_configurable-0.1.0/scripts/fetch_bundles.py

@@ -0,0 +1,45 @@
+"""Fetch pinned native inputs for a reproducible offline-capable distribution."""
+
+import hashlib
+import json
+import shutil
+import tempfile
+import urllib.request
+from pathlib import Path
+
+DATA = Path(__file__).resolve().parents[1] / "src" / "hindsight_pg0_configurable" / "data"
+
+
+def main() -> None:
+    manifest = json.loads((DATA / "bundles.json").read_text())
+    for item in manifest["archives"]:
+        dest = DATA / item["filename"]
+        if dest.exists():
+            with dest.open("rb") as handle:
+                if hashlib.file_digest(handle, "sha256").hexdigest() == item["sha256"]:
+                    print("Verified:", dest.name)
+                    continue
+            raise RuntimeError(f"Existing archive hash mismatch: {dest}")
+        fd, name = tempfile.mkstemp(dir=DATA, suffix=".download")
+        import os
+
+        os.close(fd)
+        stage = Path(name)
+        try:
+            request = urllib.request.Request(
+                item["url"], headers={"User-Agent": "hindsight-pg0-build"}
+            )
+            with urllib.request.urlopen(request, timeout=120) as response, stage.open("wb") as out:
+                shutil.copyfileobj(response, out)
+            with stage.open("rb") as handle:
+                actual = hashlib.file_digest(handle, "sha256").hexdigest()
+            if actual != item["sha256"]:
+                raise RuntimeError(f"Download hash mismatch: {dest.name}")
+            stage.rename(dest)
+            print("Downloaded and verified:", dest.name)
+        finally:
+            stage.unlink(missing_ok=True)
+
+
+if __name__ == "__main__":
+    main()

hindsight_pg0_configurable-0.1.0/src/hindsight_pg0_configurable/__init__.py

@@ -0,0 +1,3 @@
+"""Native PostgreSQL with explicit installation and state directories."""
+
+__version__ = "0.1.0"

hindsight_pg0_configurable-0.1.0/src/hindsight_pg0_configurable/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())