Merge pull request #7 from D-Naveenz/development

Integrate MindVault, enhance Dhara tooling, and update README

Author: D-Naveenz

.gitattributes

@@ -60,7 +60,7 @@
 ###############################################################################
 # Git LFS tracked file types
 #
-*.rpkg filter=lfs diff=lfs merge=lfs -text
+*.dhbin filter=lfs diff=lfs merge=lfs -text
 *.mp4 filter=lfs diff=lfs merge=lfs -text
 *.pdf filter=lfs diff=lfs merge=lfs -text
 *.png filter=lfs diff=lfs merge=lfs -text

.github/workflows/ci.yml

@@ -36,7 +36,7 @@ jobs:
         uses: Swatinem/rust-cache@v2
 
       - name: Verify CI
-        run: cargo run -p rheo_tool -- verify ci
+        run: cargo run -p dhara_tool -- verify ci
 
   docs:
     name: verify docs (windows)
@@ -58,5 +58,5 @@ jobs:
       - name: Cache Cargo dependencies
         uses: Swatinem/rust-cache@v2
 
-      - name: Build docs for Rheo crates
-        run: cargo run -p rheo_tool -- verify docs
+      - name: Build docs for Dhara crates
+        run: cargo run -p dhara_tool -- verify docs

.github/workflows/package-verify.yml

@@ -45,12 +45,12 @@ jobs:
         uses: Swatinem/rust-cache@v2
 
       - name: Verify package
-        run: cargo run -p rheo_tool -- verify package
+        run: cargo run -p dhara_tool -- verify package
 
       - name: Upload NuGet artifacts
         uses: actions/upload-artifact@v7
         with:
-          name: Rheo.Storage-package
+          name: Dhara.Storage-package
           path: |
-            .artifacts/rheo_tool/nuget/*.nupkg
-            .artifacts/rheo_tool/nuget/*.snupkg
+            .artifacts/dhara_tool/nuget/*.nupkg
+            .artifacts/dhara_tool/nuget/*.snupkg

.github/workflows/publish-nuget.yml

@@ -26,7 +26,7 @@ concurrency:
 
 jobs:
   publish:
-    name: publish Rheo.Storage (windows)
+    name: publish Dhara.Storage (windows)
     runs-on: windows-latest
     environment: nuget-production
 
@@ -59,7 +59,7 @@ jobs:
           INPUT_DRY_RUN: ${{ inputs.dry_run }}
           NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
         run: |
-          $arguments = @("run", "-p", "rheo_tool", "--", "release", "publish")
+          $arguments = @("run", "-p", "dhara_tool", "--", "release", "publish")
 
           if ($env:INPUT_VERSION) {
             $arguments += @("--version", $env:INPUT_VERSION)

.github/workflows/release-rust.yml

@@ -89,12 +89,12 @@ jobs:
 
       - name: Validate workspace before release
         run: |
-          cargo run -p rheo_tool -- verify release-config
-          cargo test -p rheo_storage --all-features
-          cargo test -p rheo_storage_ffi
-          cargo test -p rheo_tool_rheo_storage
-          cargo test -p rheo_tool
-          dotnet test --configuration Release bindings/dotnet/Rheo.Storage.Tests/Rheo.Storage.Tests.csproj
+          cargo run -p dhara_tool -- verify release-config
+          cargo test -p dhara_storage --all-features
+          cargo test -p dhara_storage_native
+          cargo test -p dhara_tool_dhara_storage
+          cargo test -p dhara_tool
+          dotnet test --configuration Release bindings/dotnet/Dhara.Storage.Tests/Dhara.Storage.Tests.csproj
 
       - name: Ensure crates.io token is present
         if: ${{ inputs.execute }}

AGENTS.md

@@ -1,41 +1,21 @@
-# Rheo Storage Agents
+# Dhara Storage Agents
 
 ## Purpose
-- This repository is the Rust-first rewrite of `Rheo.Storage`.
-- The rewrite prioritizes secure, idiomatic Rust APIs over C# surface compatibility.
-- The current repo already includes the core runtime, the reusable `rheo_tool` platform, and the .NET/native FFI delivery layers.
+- `dhara_storage` is the Rust-first rewrite of `Dhara.Storage`.
+- The workspace now includes the core runtime, the reusable `dhara_tool` platform, and the active .NET/FFI delivery layers.
+- Canonical AI-operational knowledge for this workspace lives in MindVault, not in repo-local notes.
 
-## Read Order
-1. `docs/ai/index.md`
-2. `docs/ai/project-guidelines.md`
-3. `docs/adr/ADR-001-rust-first-rewrite.md`
-4. `docs/reference/legacy-rheo-storage.md`
-5. `docs/ai/continuous-learning.md`
-
-## Guardrails
-- Keep the public API Rust-native. Do not recreate `FileObject` or `DirectoryObject` class shapes unless an ADR changes that decision.
-- Treat Windows as the primary runtime target for now, but keep pure analysis logic portable when it naturally can be.
-- Keep ABI-layer constraints out of the Rust core. Solve WinRT-specific shape issues in `rheo_storage_winrt`.
-- Prefer typed errors, deterministic test fixtures, and explicit handling of file-sharing semantics on Windows.
-- Keep project-specific AI guidance in this repo, not in a global skill.
-- Keep durable repo guidance in `AGENTS.md` and `docs/ai/`; use `.codex/` only for Codex app setup and project-scoped Codex configuration.
+## Vault Location
+- `%USERPROFILE%\OneDrive\Documents\MindVault`
 
-## Current Milestone
-- `rheo_storage` owns analysis, immutable metadata, file and directory operations, navigation, debounced watching, typed errors, and filedefs package deserialization/loading.
-- The operations layer should keep the simple path fast: do not force info or analysis loading for plain copy, move, read, write, or delete calls.
-- `rheo_rpkg` owns the generic MessagePack-based `RPKG` v2 container format, package purposes, compression, section layout, and integrity framing.
-- `rheo_tool_rheo_storage` owns package inspection, normalization, filedefs package serialization, vendored MIME validation, floodgate reduction, interactive shell flows, and TrID XML source ingestion from `.xml`, extracted directories, and `.7z` archives.
-- `filedefs.rpkg` is now a single `RPKG` v2 filedefs package; backward-compatibility readers for older ad hoc package formats are intentionally out of scope.
-- `rheo_storage_ffi` and `bindings/dotnet/Rheo.Storage` are the active ABI and managed wrapper layers over the Rust core and should keep ABI-specific concerns out of `rheo_storage`.
-- CI, docs, and release automation should assume Windows as the primary build/test/doc platform.
-- `filedefs.rpkg` and other large runtime fixtures may be tracked with Git LFS, so CI and release workflows must explicitly enable LFS checkout when those assets are needed.
-
-## Working Rhythm
-- Update `docs/ai/continuous-learning.md` whenever a repeated implementation lesson appears.
-- Record durable architecture decisions under `docs/adr/`.
-- If a change shifts scope across milestones, update both `docs/ai/project-guidelines.md` and the relevant ADR in the same change.
+## Read Order
+1. `%USERPROFILE%\OneDrive\Documents\MindVault\AI\Workspaces\rheo-storage\Home.md`
+2. `%USERPROFILE%\OneDrive\Documents\MindVault\AI\Workspaces\rheo-storage\Overview.md`
+3. `%USERPROFILE%\OneDrive\Documents\MindVault\AI\Workspaces\rheo-storage\Guardrails.md`
 
-## Where To Look Next
-- Use `docs/ai/index.md` as the entrypoint for detailed repo guidance.
-- Use `docs/ai/runbooks/` for operational runbooks that are too detailed for this file.
-- Use `.codex/environments/environment.toml` only for Codex app worktree setup, cleanup, and app actions.
+## Local Caveats
+- Treat repo code, manifests, tests, and workflow files as the source of truth if a vault note drifts.
+- Keep `dhara_storage` Rust-native; solve .NET interop constraints in `dhara_storage_native` and `bindings/dotnet/Dhara.Storage`.
+- Keep `dhara_tool` and `dhara.config.toml` as the supported operator surface for config sync, verification, packaging, and publishing flows.
+- Treat Windows as the primary runtime and CI target unless a concrete portability goal says otherwise.
+- Avoid rebuilding repo-local AI docs unless a non-AI publishing or tooling requirement explicitly depends on them.

Cargo.toml

@@ -1,25 +1,25 @@
 [workspace]
 members = [
-    "rheo_rpkg",
-    "rheo_storage",
-    "rheo_storage_ffi",
-    "tooling/rheo_tool",
-    "tooling/rheo_tool_rheo_storage",
+    "dhara_dhbin",
+    "dhara_storage",
+    "dhara_storage_native",
+    "tooling/dhara_tool",
+    "tooling/dhara_tool_dhara_storage",
 ]
 resolver = "3"
 
 [workspace.package]
-version = "0.3.0"
+version = "0.4.0"
 edition = "2024"
 authors = ["Naveen Dharmathunga <dasheenaveen@outlook.com>"]
 license = "Apache-2.0"
 repository = "https://github.com/D-Naveenz/rheo_storage"
 homepage = "https://github.com/D-Naveenz/rheo_storage"
 
 [workspace.dependencies]
-rheo_rpkg = { version = "0.3.0", path = "rheo_rpkg" }
-rheo_storage = { version = "0.3.0", path = "rheo_storage" }
-rheo_tool_rheo_storage = { version = "0.3.0", path = "tooling/rheo_tool_rheo_storage" }
+dhara_dhbin = { version = "0.4.0", path = "dhara_dhbin" }
+dhara_storage = { version = "0.4.0", path = "dhara_storage" }
+dhara_tool_dhara_storage = { version = "0.4.0", path = "tooling/dhara_tool_dhara_storage" }
 
 # Read the optimization guideline for more details: https://ratatui.rs/recipes/apps/release-your-app/#optimizations
 [profile.release]

Dhara.Storage.slnx

@@ -0,0 +1,11 @@
+<Solution>
+  <Folder Name="/Bindings/" />
+  <Folder Name="/Bindings/Dotnet/">
+    <Project Path="Bindings/Dotnet/Dhara.Storage.Tests/Dhara.Storage.Tests.csproj" />
+    <Project Path="Bindings/Dotnet/Dhara.Storage/Dhara.Storage.csproj" />
+  </Folder>
+  <Folder Name="/Solution Items/">
+    <File Path=".editorconfig" />
+  </Folder>
+  <Project Path="bindings/dotnet/Dhara.Storage.ConsumerSmoke/Dhara.Storage.ConsumerSmoke.csproj" />
+</Solution>

README.md

@@ -1,95 +1,98 @@
-# Rheo Storage
+# Dhara Storage
 
-Rheo Storage is a Rust-first storage runtime with a Windows-first delivery story.
+![Crates.io Version](https://img.shields.io/crates/v/:crate)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE.txt)
+
+Dhara Storage is a Rust-first storage runtime with a Windows-first delivery story.
 It combines definition-driven file analysis, path-based file and directory operations,
-debounced watching, a reusable `RPKG` package format, and a managed .NET wrapper over
+debounced watching, a reusable `DHBIN` package format, and a managed .NET wrapper over
 the native core.
 
 ## Workspace
 
-| Project | Purpose |
-| --- | --- |
-| `rheo_rpkg` | Shared `RPKG` v2 container crate for MessagePack payloads, optional metadata, and integrity sections |
-| `rheo_storage` | Rust-native runtime for analysis, metadata, operations, navigation, and watching |
-| `rheo_storage_ffi` | Thin C ABI over `rheo_storage` for managed and native hosts |
-| `bindings/dotnet/Rheo.Storage` | `net10.0` wrapper over `rheo_storage_ffi` |
-| `tooling/rheo_tool` | Operator CLI for verification, packaging, release, and defs workflows |
-| `tooling/rheo_tool_rheo_storage` | Repository-specific capability pack used by `rheo_tool` |
+| Project                            | Purpose                                                                                               |
+| ---------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `dhara_dhbin`                      | Shared `DHBIN` v2 container crate for MessagePack payloads, optional metadata, and integrity sections |
+| `dhara_storage`                    | Rust-native runtime for analysis, metadata, operations, navigation, and watching                      |
+| `dhara_storage_native`             | Thin C ABI over `dhara_storage` for managed and native hosts                                          |
+| `bindings/dotnet/Dhara.Storage`    | `net10.0` wrapper over `dhara_storage_native`                                                         |
+| `tooling/dhara_tool`               | Operator CLI for verification, packaging, release, and defs workflows                                 |
+| `tooling/dhara_tool_dhara_storage` | Repository-specific capability pack used by `dhara_tool`                                              |
 
 ## Highlights
 
-- Rust-native public API in `rheo_storage`, not a class-for-class port of the legacy C# model
-- Bundled `filedefs.rpkg` runtime package for content-based file analysis
+- Rust-native public API in `dhara_storage`, not a class-for-class port of the legacy C# model
+- Bundled `filedefs.dhbin` runtime package for content-based file analysis
 - File and directory operations that keep the simple path fast and opt into progress only when needed
 - Debounced directory watching for stable change notifications
-- Structured logging with `tracing` in Rust, native log forwarding through `rheo_storage_ffi`, and host integration through `Microsoft.Extensions.Logging`
+- Structured logging with `tracing` in Rust, native log forwarding through `dhara_storage_native`, and host integration through `Microsoft.Extensions.Logging`
 - Multi-runtime NuGet packaging for Windows `win-x64` and `win-arm64`
 
 ## Quick Start
 
 Rust runtime:
 
 ```rust
-use rheo_storage::{FileStorage, analyze_path};
+use dhara_storage::{FileStorage, analyze_path};
 
 let report = analyze_path("sample.pdf")?;
 let bytes = FileStorage::from_existing("sample.pdf")?.read()?;
-# Ok::<(), rheo_storage::StorageError>(())
+# Ok::<(), dhara_storage::StorageError>(())
 ```
 
 .NET wrapper:
 
 ```csharp
 using Microsoft.Extensions.Logging;
-using Rheo.Storage;
+using Dhara.Storage;
 
 using var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());
-RheoStorage.UseLoggerFactory(loggerFactory);
+DharaStorage.UseLoggerFactory(loggerFactory);
 
-var file = RheoStorage.File(@"C:\data\sample.pdf");
+var file = DharaStorage.File(@"C:\data\sample.pdf");
 var analysis = file.Analyze();
 var bytes = await file.ReadBytesAsync();
 ```
 
 Tooling:
 
 ```powershell
-cargo run -p rheo_tool -- verify ci
-cargo run -p rheo_tool -- package verify
+cargo run -p dhara_tool -- verify ci
+cargo run -p dhara_tool -- verify package
 ```
 
 ## Support Matrix
 
-| Surface | Status |
-| --- | --- |
-| `rheo_rpkg` | Portable Rust crate |
-| `rheo_storage` | Windows-first runtime; portable where the underlying functionality naturally is |
-| `rheo_storage_ffi` | Windows-first native ABI |
-| `Rheo.Storage` NuGet package | Windows `win-x64` and `win-arm64` only |
+| Surface                       | Status                                                                          |
+| ----------------------------- | ------------------------------------------------------------------------------- |
+| `dhara_dhbin`                 | Portable Rust crate                                                             |
+| `dhara_storage`               | Windows-first runtime; portable where the underlying functionality naturally is |
+| `dhara_storage_native`        | Windows-first native ABI                                                        |
+| `Dhara.Storage` NuGet package | Windows `win-x64` and `win-arm64` only                                          |
 
 The NuGet package now fails clearly during package consumption for unsupported RIDs such as `win-x86`,
 and the managed wrapper also throws a `PlatformNotSupportedException` when loaded outside Windows `x64` or `arm64`.
 
 ## Logging
 
 - Rust crates emit structured `tracing` events for analysis, metadata loading, operations, watching, package verification, and release flows.
-- `rheo_storage_ffi` exposes a native logger registration API that forwards JSON log records across the ABI.
-- `Rheo.Storage` forwards both managed wrapper logs and native runtime logs into a host `ILoggerFactory`.
-- `rheo_tool` and `rheo_tool_rheo_storage` now emit richer command, configuration, transfer, and verification logs for release diagnostics.
+- `dhara_storage_native` exposes a native logger registration API that forwards JSON log records across the ABI.
+- `Dhara.Storage` forwards both managed wrapper logs and native runtime logs into a host `ILoggerFactory`.
+- `dhara_tool` and `dhara_tool_dhara_storage` now emit richer command, configuration, transfer, and verification logs for release diagnostics.
 
 ## Release Flow
 
-- Shared release metadata lives in [rheo.config.toml](./rheo.config.toml).
+- Shared release metadata lives in [dhara.config.toml](./dhara.config.toml).
 - Local secrets belong in [.env.local](./.env.example), created from the example file.
-- [tooling/rheo_tool](./tooling/rheo_tool/README.md) is the supported operator surface for config sync, verification, packaging, and publish flows.
-- NuGet verification checks that both `runtimes/win-x64/native/rheo_storage_ffi.dll` and `runtimes/win-arm64/native/rheo_storage_ffi.dll` are present in the package.
+- [tooling/dhara_tool](./tooling/dhara_tool/README.md) is the supported operator surface for config sync, verification, packaging, and publish flows.
+- NuGet verification checks that both `runtimes/win-x64/native/dhara_storage_native.dll` and `runtimes/win-arm64/native/dhara_storage_native.dll` are present in the package.
 
 ## Docs
 
-- [Rust consumer guide](./docs/reference/rust-consumer.md)
-- [.NET consumer guide](./docs/reference/dotnet-consumer.md)
-- [.NET release guide](./docs/reference/releasing-rheo-storage-dotnet.md)
-- [rheo_rpkg README](./rheo_rpkg/README.md)
-- [rheo_storage README](./rheo_storage/README.md)
-- [rheo_storage_ffi README](./rheo_storage_ffi/README.md)
-- [Rheo.Storage README](./bindings/dotnet/Rheo.Storage/README.md)
+- Rust consumer guide: `%USERPROFILE%\OneDrive\Documents\MindVault\AI\Workspaces\rheo-storage\References\Rust Consumer.md`
+- .NET consumer guide: `%USERPROFILE%\OneDrive\Documents\MindVault\AI\Workspaces\rheo-storage\References\DotNET Consumer.md`
+- .NET release guide: `%USERPROFILE%\OneDrive\Documents\MindVault\AI\Workspaces\rheo-storage\References\Releasing Rheo.Storage for DotNET.md`
+- [dhara_dhbin README](./dhara_dhbin/README.md)
+- [dhara_storage README](./dhara_storage/README.md)
+- [dhara_storage_native README](./dhara_storage_native/README.md)
+- [Dhara.Storage README](./bindings/dotnet/Dhara.Storage/README.md)