refactor: rename fluxel to dataref

Package, import, CLI, fsspec scheme, layout dir (.dataref), class names, docs, CI, and env vars now use the dataref name. Distribution name on PyPI will be dataref; import stays dataref.

Author: Lundez

.fluxel/config.json .dataref/config.json.fluxel/config.json renamed to .dataref/config.json

@@ -34,7 +34,7 @@ jobs:
               run: uv run pytest tests -m "not integration"
 
             - name: Smoke-test CLI help
-              run: uv run fluxel --help
+              run: uv run dataref --help
 
             - name: Build package
               run: uv build
@@ -98,14 +98,14 @@ jobs:
                   WHEEL=$(ls dist/*.whl | head -1)
                   python -m venv /tmp/smoke-venv
                   /tmp/smoke-venv/bin/pip install "$WHEEL"
-                  echo "=== fluxel --help ==="
-                  /tmp/smoke-venv/bin/fluxel --help
-                  echo "=== fluxel --version ==="
-                  /tmp/smoke-venv/bin/fluxel --version 2>/dev/null || true
+                  echo "=== dataref --help ==="
+                  /tmp/smoke-venv/bin/dataref --help
+                  echo "=== dataref --version ==="
+                  /tmp/smoke-venv/bin/dataref --version 2>/dev/null || true
                   echo "=== basic commit smoke ==="
                   TMPDIR=$(mktemp -d)
                   echo "smoke-test-content" > "$TMPDIR/smoke.txt"
-                  /tmp/smoke-venv/bin/fluxel commit --repo "$TMPDIR" -m "smoke" > /dev/null
+                  /tmp/smoke-venv/bin/dataref commit --repo "$TMPDIR" -m "smoke" > /dev/null
                   echo "Isolated install smoke test passed."
 
     release-gate:

.fluxel/refs/HEAD .dataref/refs/HEAD.fluxel/refs/HEAD renamed to .dataref/refs/HEAD

@@ -2,13 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
-The format is based on Keep a Changelog, and Fluxel currently tracks changes before its first public beta release.
+The format is based on Keep a Changelog, and Dataref currently tracks changes before its first public beta release.
 
 ## Unreleased
 
 ### Added
 
-- **Footer-stats pruning engine (rev. 3, docs/architecture.md §4)**: `fluxel query
+- **Footer-stats pruning engine (rev. 3, docs/architecture.md §4)**: `dataref query
   prune <ref> <path> --where "col >= x"` selects the parquet row groups that may
   match an AND-composed predicate (`= != < <= > >= IS NULL IS NOT NULL`) using only
   the compact `footers/<hash>` stats objects — no data bytes are read. Exposed as
@@ -26,7 +26,7 @@ The format is based on Keep a Changelog, and Fluxel currently tracks changes bef
   under `footers/<hash>` and referenced from new `bp`/`mp` tree entries —
   enabling row-group pruning without reading object bytes. Unchanged files are
   backfilled on the next commit; `verify`-style re-scan can backfill later.
-- `fluxel cat <ref> <path>` prints a file's bytes from a ref; `list`, `cat`,
+- `dataref cat <ref> <path>` prints a file's bytes from a ref; `list`, `cat`,
   `diff`, `log`, and `query` work on virtual refs (S3 URIs) without a local
   worktree.
 - Streaming S3 import with metadata identity mode and repeatable path filters.
@@ -57,8 +57,8 @@ The format is based on Keep a Changelog, and Fluxel currently tracks changes bef
   changed side, drop double-removals), and creates a merge commit with two
   parents when histories diverge; conflicting paths raise
   `MergeConflictError` with the offending paths.
-- `fluxel reflog` (P3): every successful ref update is recorded per-branch in
-  client state (old → new commit, operation, timestamp); `fluxel catalog`
+- `dataref reflog` (P3): every successful ref update is recorded per-branch in
+  client state (old → new commit, operation, timestamp); `dataref catalog`
   lists branches with their heads and messages.
 - **Plan-then-batch sync (P2, §7)**: `push`/`pull`/`fetch` now compute the exact
   missing-object set (commits, trees, footers, blobs) as a transfer plan and
@@ -67,9 +67,9 @@ The format is based on Keep a Changelog, and Fluxel currently tracks changes bef
   footer stats objects now sync too.
 - **Adapter error translation (P2, §8)**: the S3 adapters raise domain errors
   (`ObjectMissingError`, `PreconditionFailedError`, `StorageUnavailableError`,
-  all `FluxelError` subclasses) instead of raw botocore exceptions; the CLI no
+  all `DatarefError` subclasses) instead of raw botocore exceptions; the CLI no
   longer special-cases `BotoCoreError`/`ClientError`.
-- `fluxel gc` (P2, §11): audit-only by default — computes the reachable set
+- `dataref gc` (P2, §11): audit-only by default — computes the reachable set
   from all refs (commit DAG → trees → blobs/footers) and reports orphans;
   `--prune` deletes them.
 - `filesystem.py` moved to the `core/vfs/` package; `index.py` moved to the
@@ -109,15 +109,15 @@ The format is based on Keep a Changelog, and Fluxel currently tracks changes bef
 - Commit creation no longer relies on `_last_manifest_index` instance state; the manifest index is threaded explicitly through manifest writing and commit creation.
 - S3 blob writes via streams (`push`/`pull`/`fetch`) now honor the configured blob transfer backend, so `s5cmd` accelerates sync transfers.
 - The in-process commit cache is now bounded (LRU-style) instead of growing without limit.
-- `FluxelRepository` is now a facade over four focused collaborator services (`RefManager`, `SnapshotWriter`, `StagingArea`, `EntryFactory` in `core/services/`); the god-object class was split from ~1650 to ~790 lines and `repository_ops.py` no longer reaches into repository internals.
+- `DatarefRepository` is now a facade over four focused collaborator services (`RefManager`, `SnapshotWriter`, `StagingArea`, `EntryFactory` in `core/services/`); the god-object class was split from ~1650 to ~790 lines and `repository_ops.py` no longer reaches into repository internals.
 
 ### Removed
 
-- Removed the `fluxel import` command; S3 ingress is now staged via `fluxel add ... s3://... [--identity meta --as ...]` followed by `fluxel commit --staged`.
-- Removed `--identity` from `fluxel commit`; the commit identity mode is now configured with `fluxel config set identity meta`, or set per stage with `fluxel add --identity ...`.
-- Removed the direct-commit `-m/--message` flag from `fluxel rm` and `fluxel mv`; metadata-only mutations are staged and committed with `fluxel commit --staged`.
-- Removed `--ref` from `fluxel verify` and `fluxel index build`; both now target the current branch.
-- Removed `fluxel index query` and `fluxel index drop`; `fluxel index build` remains and the produced DuckDB database can be queried with the DuckDB CLI.
+- Removed the `dataref import` command; S3 ingress is now staged via `dataref add ... s3://... [--identity meta --as ...]` followed by `dataref commit --staged`.
+- Removed `--identity` from `dataref commit`; the commit identity mode is now configured with `dataref config set identity meta`, or set per stage with `dataref add --identity ...`.
+- Removed the direct-commit `-m/--message` flag from `dataref rm` and `dataref mv`; metadata-only mutations are staged and committed with `dataref commit --staged`.
+- Removed `--ref` from `dataref verify` and `dataref index build`; both now target the current branch.
+- Removed `dataref index query` and `dataref index drop`; `dataref index build` remains and the produced DuckDB database can be queried with the DuckDB CLI.
 
 ### Fixed
 

.fluxel/refs/heads/main .dataref/refs/heads/main.fluxel/refs/heads/main renamed to .dataref/refs/heads/main

@@ -2,11 +2,11 @@
 
 ## Development Setup
 
-Fluxel uses `uv` for dependency management and local commands.
+Dataref uses `uv` for dependency management and local commands.
 
 ```bash
 uv sync --group dev
-uv run fluxel --help
+uv run dataref --help
 ```
 
 ## Local Validation
@@ -20,25 +20,25 @@ uv run pytest tests
 Run only the real S3 integration tests against Ministack:
 
 ```bash
-export FLUXEL_MINISTACK_ENDPOINT=http://127.0.0.1:9000
-export FLUXEL_MINISTACK_ACCESS_KEY=ministack
-export FLUXEL_MINISTACK_SECRET_KEY=ministack123
-export FLUXEL_MINISTACK_REGION=us-east-1
+export DATAREF_MINISTACK_ENDPOINT=http://127.0.0.1:9000
+export DATAREF_MINISTACK_ACCESS_KEY=ministack
+export DATAREF_MINISTACK_SECRET_KEY=ministack123
+export DATAREF_MINISTACK_REGION=us-east-1
 
 uv run pytest tests/test_s3_integration.py -m integration
 ```
 
-If `FLUXEL_MINISTACK_ENDPOINT` is unset or unreachable, the integration tests skip automatically.
+If `DATAREF_MINISTACK_ENDPOINT` is unset or unreachable, the integration tests skip automatically.
 
 ## Project Expectations
 
-- Fluxel is licensed under AGPL-3.0-or-later; preserve the license and notice files in redistributions.
+- Dataref is licensed under AGPL-3.0-or-later; preserve the license and notice files in redistributions.
 - Prefer Python type hints by default.
-- Keep Fluxel client-first: no server, daemon, or central database.
+- Keep Dataref client-first: no server, daemon, or central database.
 - Keep canonical blob storage simple and immutable.
 - Metadata-only operations must not read blob payloads.
 - Prefer stream-safe, O(1)-memory patterns when working with manifests and large imports.
-- Use Blake3 for Fluxel content and identity hashing.
+- Use Blake3 for Dataref content and identity hashing.
 
 ## Pull Requests
 

.fluxel/refs/heads/main.json .dataref/refs/heads/main.json.fluxel/refs/heads/main.json renamed to .dataref/refs/heads/main.json

@@ -1,10 +1,10 @@
-Fluxel
+Dataref
 Copyright (C) 2026 Hampus Londögård
 
-Fluxel is distributed under the GNU Affero General Public License v3.0 or later.
+Dataref is distributed under the GNU Affero General Public License v3.0 or later.
 Please preserve this notice, the LICENSE file, and the project copyright notices
-when redistributing Fluxel or modified versions of it.
+when redistributing Dataref or modified versions of it.
 
-Organizations that depend on Fluxel are encouraged to sponsor ongoing
+Organizations that depend on Dataref are encouraged to sponsor ongoing
 maintenance and development:
 https://github.com/sponsors/londogard