xfina 0.4.0__tar.gz

xfina-0.4.0/.cargo/config.toml

@@ -0,0 +1,2 @@
+[alias]
+xtask = "run --package xtask --"

xfina-0.4.0/.github/workflows/deploy-unreleased.yml

@@ -0,0 +1,43 @@
+name: Deploy Unreleased Docs
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  deploy_docs_unreleased:
+    name: Deploy Unreleased Docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - name: Configure Git User
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+      - name: Setup Node
+        uses: actions/setup-node@v7
+        with:
+          node-version: 22
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          target: wasm32-unknown-unknown
+      - name: Cache Cargo dependencies
+        uses: Swatinem/rust-cache@v2
+      - name: Install wasm-pack
+        run: |
+          if ! command -v wasm-pack &> /dev/null; then
+            curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+          fi
+      - name: Deploy Site via xtask
+        run: cargo run -p xtask -- deploy-site --unreleased

xfina-0.4.0/.github/workflows/publish.yml

@@ -0,0 +1,235 @@
+name: Multi-Ecosystem Publish
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      publish_crates:
+        description: 'Publish to crates.io'
+        type: boolean
+        default: true
+      publish_npm:
+        description: 'Publish to NPM'
+        type: boolean
+        default: true
+      publish_pypi:
+        description: 'Publish to PyPI'
+        type: boolean
+        default: true
+      deploy_docs:
+        description: 'Deploy Docs'
+        type: boolean
+        default: true
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  check_branch:
+    name: Verify Tag is on Main
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - name: Check if tag is on main
+        run: |
+          git fetch origin main
+          if ! git branch -r --contains ${{ github.sha }} | grep -E -q '(^|\s)origin/main$'; then
+            echo "Error: Tag ${{ github.ref_name }} is not on the main branch."
+            exit 1
+          fi
+
+  crates_io:
+    name: Publish to crates.io
+    if: github.event_name == 'push' || inputs.publish_crates != false
+    needs: check_branch
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      - name: Cache Cargo dependencies
+        uses: Swatinem/rust-cache@v2
+      - name: Authenticate with crates.io
+        uses: rust-lang/crates-io-auth-action@v1
+        id: auth
+      - name: Publish xfina crate
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}
+        run: cargo publish --package xfina --allow-dirty
+
+  npm:
+    name: Publish to NPM
+    if: github.event_name == 'push' || inputs.publish_npm != false
+    runs-on: ubuntu-latest
+    needs: check_branch
+    steps:
+      - uses: actions/checkout@v7
+      - name: Setup Node
+        uses: actions/setup-node@v7
+        with:
+          node-version: 22
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          target: wasm32-unknown-unknown
+      - name: Cache Cargo dependencies
+        uses: Swatinem/rust-cache@v2
+      - name: Install wasm-pack
+        run: |
+          if ! command -v wasm-pack &> /dev/null; then
+            curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+          fi
+      - name: Build WASM (Web Target)
+        working-directory: wasm
+        run: wasm-pack build --target web
+      - name: Publish to NPM
+        working-directory: wasm/pkg
+        run: |
+          npm install -g npm@latest
+          unset NODE_AUTH_TOKEN
+          npm publish --access public --provenance
+
+  wheels_linux:
+    name: Wheels (linux ${{ matrix.target }})
+    if: github.event_name == 'push' || inputs.publish_pypi != false
+    needs: check_branch
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v7
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: auto
+          sccache: 'true'
+          working-directory: python
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: python/dist
+
+  wheels_macos:
+    name: Wheels (macos ${{ matrix.target }})
+    if: github.event_name == 'push' || inputs.publish_pypi != false
+    needs: check_branch
+    # Both targets build on Apple Silicon: GitHub retired the macos-13 Intel
+    # runner, so x86_64 is cross-compiled. Xcode ships both SDKs, so this needs
+    # nothing beyond the extra rustup target that maturin-action installs.
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [x86_64-apple-darwin, aarch64-apple-darwin]
+    steps:
+      - uses: actions/checkout@v7
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          sccache: 'true'
+          working-directory: python
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: python/dist
+
+  wheels_windows:
+    name: Wheels (windows x64)
+    if: github.event_name == 'push' || inputs.publish_pypi != false
+    needs: check_branch
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: x64
+          args: --release --out dist
+          sccache: 'true'
+          working-directory: python
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-windows-x64
+          path: python/dist
+
+  sdist:
+    name: Source distribution
+    if: github.event_name == 'push' || inputs.publish_pypi != false
+    needs: check_branch
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+          working-directory: python
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-sdist
+          path: python/dist
+
+  pypi_publish:
+    name: Upload to PyPI
+    if: github.event_name == 'push' || inputs.publish_pypi != false
+    needs: [wheels_linux, wheels_macos, wheels_windows, sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v8
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+      - name: List artifacts
+        run: ls -l dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          skip-existing: true
+
+  deploy_docs_tag:
+    name: Deploy Tagged Docs
+    if: github.event_name == 'push' || inputs.deploy_docs != false
+    runs-on: ubuntu-latest
+    needs: [check_branch, npm]
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - name: Configure Git User
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+      - name: Extract Tag Name
+        id: extract_tag
+        run: echo "TAG_NAME=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+      - name: Setup Node
+        uses: actions/setup-node@v7
+        with:
+          node-version: 22
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+      - name: Cache Cargo dependencies
+        uses: Swatinem/rust-cache@v2
+      - name: Deploy Site via xtask
+        run: cargo run -p xtask -- deploy-site --tag ${{ env.TAG_NAME }}

xfina-0.4.0/.github/workflows/test.yml

@@ -0,0 +1,69 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches: [ "main" ]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: Approve PR
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      
+      - name: Check Changes and Changelog
+        id: check_changes
+        if: github.event_name == 'pull_request'
+        run: |
+          git fetch origin ${{ github.base_ref }}
+          
+          # Define the core paths that require a changelog update (excluding markdown files like README.md)
+          CORE_CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD -- src/ python/ wasm/ tests/ Cargo.toml | grep -v -i '\.md$' || true)
+          
+          if [ -n "$CORE_CHANGED" ]; then
+            echo "The following core files were modified:"
+            echo "$CORE_CHANGED"
+            echo "----------------------------------------"
+            
+            # Check if CHANGELOG.md is in the diff
+            if ! git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -q "^CHANGELOG.md$"; then
+              echo "::error::Core files were modified but CHANGELOG.md was not updated. Please document your changes."
+              exit 1
+            fi
+            echo "Success: CHANGELOG.md was updated!"
+            echo "run_tests=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "No core files modified. Changelog update not strictly required."
+            echo "run_tests=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install Rust
+        if: steps.check_changes.outputs.run_tests == 'true'
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Cache cargo registry and build
+        if: steps.check_changes.outputs.run_tests == 'true'
+        uses: Swatinem/rust-cache@v2
+
+      - name: Check formatting
+        if: steps.check_changes.outputs.run_tests == 'true'
+        run: cargo fmt --check
+
+      - name: Check for warnings
+        if: steps.check_changes.outputs.run_tests == 'true'
+        run: cargo clippy --workspace --all-targets --all-features -- -D warnings
+
+      - name: Run tests
+        if: steps.check_changes.outputs.run_tests == 'true'
+        run: cargo test --workspace --all-features
+        
+      - name: Build WASM
+        if: steps.check_changes.outputs.run_tests == 'true'
+        run: cargo build --target wasm32-unknown-unknown -p xfina-wasm

xfina-0.4.0/.gitignore

@@ -0,0 +1,47 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug
+target
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Generated by cargo mutants
+# Contains mutation testing data
+**/mutants.out*/
+
+# RustRover
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Build outputs
+docs/
+
+# Local test data and statements
+test_data/
+*.xls
+*.xlsx
+*.pdf
+*.csv
+
+# Scratch/debug test files
+parse_test
+parse_test[0-9]*
+*.rs.scratch
+test_out.txt
+parse_test*.rs
+*.py
+gh-pages-worktree/
+/web/public/versions.json
+.venv/
+
+# Scratch and debug files
+scratch/
+test_output.json
+*.txt

xfina-0.4.0/AGENTS.md

@@ -0,0 +1,39 @@
+# Xfina - Agent Context & Guidelines
+
+This document serves as a cheat sheet for AI agents working on the Xfina project to quickly understand the architecture, build processes, and specific domain rules.
+
+## Architecture Overview
+- **Backend (Rust + WASM):** Financial statements (PDFs, XLS, etc.) are parsed securely entirely within the browser using Rust compiled to WebAssembly. Parsers are split into domain-specific packages (`bank-accounts/`, `credit-cards/`, `mutual-funds/`, `intl-stocks/`).
+- **Frontend (Vue 3 + Vite):** The user interface is built with Vue 3, Tailwind CSS, and `shadcn-vue` style components. It takes the JSON output from the WASM parsers and renders standardized views.
+- **Models (`xfina-models`):** Shared Rust data structures used to serialize data. They adhere closely to the Sahamati Account Aggregator (AA) schema standards, with our own project-specific extensions nested inside `xfina` objects (e.g. `XfinaCreditCardAccount`).
+
+## Build & Run Instructions
+- **WASM Rebuild (CRITICAL):** Anytime a Rust parser or model is modified, the WASM package MUST be rebuilt and copied to the web directory for the frontend to see the changes. 
+  ```bash
+  cd wasm
+  wasm-pack build --target web && cp -r pkg/* ../web/src/wasm/
+  ```
+  *(Note: Vite aggressively caches WASM files. If UI doesn't update after rebuild, wipe `web/node_modules/.vite` and hard-refresh the browser).*
+- **Frontend Dev Server:**
+  ```bash
+  cd web
+  npm run dev
+  ```
+
+## Testing Workflow
+- **Integration Tests:** Each parser has an `integration.rs` which reads sample raw statements and asserts them against expected JSON snapshots.
+- **Test Data Repo:** Test data lives OUTSIDE this repository in a sibling folder at `../xfina-test-data/`.
+- **Updating Snapshots:** If a parser modification intentionally changes the JSON output shape, run tests with the `UPDATE_EXPECTED=1` environment variable to overwrite the expected snapshots.
+
+## Technical Rules & Conventions
+1. **Timezones & Dates:** 
+   - Use `NaiveDate` (from `chrono`) for fields that are strictly dates (e.g. statement start/end dates).
+   - Use `DateTime<Utc>` for timestamps (e.g. transaction exact times). When parsing local Indian dates from statements, parse them using `Asia/Kolkata` (IST `+05:30`) timezone offset before converting to `Utc`.
+2. **Standardized Naming:**
+   - Always use full institution names across parsers and UI: `"HDFC Bank"`, `"ICICI Bank"`, `"State Bank of India"`, `"Bank of Baroda"`.
+3. **Transaction Sorting:** Parsed transactions should generally be emitted in chronological (ascending) order.
+4. **Data Fallbacks & Safety:** Parsers should fail gracefully. Try to derive information when missing (e.g. deriving missing transaction years from the statement date).
+
+## UI/UX Rules
+- **Color & Styling:** Maintain consistency in financial coloring (green for deposits/payments, default colors for neutral balances). Use the predefined Tailwind semantic colors (e.g. `text-muted-foreground`, `text-primary`).
+- Ensure UI bindings exactly match the serialized JSON paths (e.g., watch out for `camelCase` conversions like `institution_name` becoming `institutionName` in JS).

xfina-0.4.0/CHANGELOG.md

@@ -0,0 +1,162 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.4.0] - 2026-09-02
+
+### Added
+- **Parsers (Axis CC):** The card variant printed in the statement title (e.g. `Neo`) is now extracted into `summary.xfina.cardProduct`.
+- **Web App:** Credit card statement details now show the card variant as `Product`, mirroring the bank account view.
+
+### Fixed
+- **Python wheels:** the PyPI job built a single wheel on `ubuntu-latest` with
+  CPython 3.11, so only that exact combination could `pip install xfina`
+  without a Rust toolchain — 0.2.4 shipped nothing but a
+  `manylinux_2_34_x86_64` CPython 3.11 wheel. Fixed on three fronts, mirroring
+  [sakthipriyan/xfingine](https://github.com/sakthipriyan/xfingine):
+  - The extension now builds against the **stable ABI** (`pyo3/abi3-py38`), so
+    one wheel per OS/arch covers CPython 3.8+ instead of needing one per
+    version — turning a ~25-build matrix into 5.
+  - Wheels are built for **linux x86_64 / aarch64, macOS x86_64 / arm64, and
+    windows x64** via `PyO3/maturin-action`, which cross-compiles properly. A
+    plain `maturin build` only ever targets the runner's own platform, which
+    was the root cause. Both macOS wheels build on `macos-latest` (Apple
+    Silicon), since GitHub has retired the `macos-13` Intel runner.
+  - An **sdist** is built and uploaded as its own job, giving pip a source
+    fallback on any platform without a prebuilt wheel.
+- **Python metadata:** `pyproject.toml` advertised PyPy support that an abi3
+  CPython extension cannot provide. Replaced with explicit CPython 3.8–3.13
+  classifiers, so the metadata matches what is actually shipped.
+- **CI:** bumped `actions/checkout` and `actions/setup-node` to v7 to move off
+  the deprecated Node 20 runtime; the new wheel jobs use `actions/upload-artifact`
+  v7 and `actions/download-artifact` v8. The `actions/setup-python` call site is
+  gone — `maturin-action` provides the interpreter.
+- **Parsers (HDFC BA):** Holder names starting with `MRS` were mangled into `S <name>` because the honorific was stripped by a plain substring replace. Honorifics are now removed as whole leading tokens.
+- **Parsers (SBI BA):** The honorific (`Mrs.`, `Mr.` ...) is now stripped from the holder name instead of being kept as part of it, and the column padding statements use is collapsed.
+
+## [0.3.0] - 2026-08-27
+
+### Added
+- **Parsers:** Added a new parser for Axis Bank credit card statements (`credit_cards/axis.rs`).
+- **Web App:** Integrated the Axis Bank credit card parser in the UI.
+- **Python / WASM:** Exposed the `parse_axis_cc` function in Python and WASM bindings.
+
+## [0.2.4] - 2026-08-15
+
+### Fixed
+- **Parsers (CAMS):** Fixed summary-level validation false failures on statements where CAMS' vertical document-generation watermark (rotated 90°, stamped along the page margin) coincidentally landed within the y-tolerance of an AMC heading line, fusing a stray character onto it and causing that AMC's holdings to be silently misattributed to the previous AMC. Non-upright glyphs are now dropped during character extraction so they can never fuse onto content lines, regardless of which line they happen to land near.
+- **Parsers (CAMS):** Fixed nondeterministic ordering of `summary_level` validation checks (backed by a `HashMap`, whose iteration order is randomized per process) by sorting by AMC name before emitting checks, so serialized output is stable across runs — the same class of issue already fixed for the IBKR parser in 0.2.0.
+- **Error Handling:** CAMS PDF decryption failures now surface as the typed `XfinaError::IncorrectPassword` / `XfinaError::PasswordRequired` variants instead of a generic string-wrapped `ParseError`.
+
+### Changed
+- **Testing:** The CAMS integration test's `passwords.json` lookup now accepts either a single password or an ordered list of candidate passwords per key (including `default`), trying each in turn until one succeeds. Supports CAMS rotating its PDF password over time without needing per-file or date-based entries.
+
+## [0.2.3] - 2026-08-09
+
+### Added
+- **Web App:** Added a privacy-first Analytics Consent modal with 3 tracking levels (Off, Page View, Parser Usage).
+
+### Fixed
+- **CI/CD:** Fixed publish workflow skipping jobs on tag push due to missing remote tracking branch in GitHub Actions checkout.
+
+## [0.2.2] - 2026-08-08
+
+### Added
+- **xtask:** Split release command into `prepare-release` and `tag-release` stages to support PR-based branch protection workflows.
+
+### Changed
+- Add `homepage` to package metadata pointing to `xfina.dev`
+- Fix page title to just `Xfina`
+
+## [0.2.1] - 2026-08-08
+
+### Added
+- **Parsers:** Added derived `computed_closing_balance` validation logic for Bank of Baroda statements.
+- **Parsers:** Added `overall_invested_match` and `overall_value_match` summary checks for Mutual Funds (CAS) by extracting portfolio summaries.
+
+### Changed
+- **Web App:** Standardized the UI header components across all statement types and added visual validation badges.
+
+### Fixed
+- **Web App:** Corrected UI alignment issues for IBKR transaction badges and properly greyed out non-applicable row-level validations for Credit Cards.
+
+## [0.2.0] - 2026-08-06
+
+### Added
+- **Validation Engine:** Added a comprehensive two-level validation engine (`src/models/validation.rs`) to detect parsing discrepancies.
+  - Row-level validation checks `opening balance + transaction amount = current balance`.
+  - Summary-level validation checks `computed_closing = declared_closing` and verifies total credits/debits against declared summaries in PDFs/XLS files.
+- **CI/CD:** Added GitHub Actions test pipeline (`.github/workflows/test.yml`) to automatically run `cargo test` and compile the WASM build on pushes and pull requests to `main`.
+- **Documentation:** Created a comprehensive `CONTRIBUTING.md` guide for adding new parsers and managing snapshots.
+- **Documentation:** Added an architectural diagram to the main `README.md` and added rich metadata (keywords, categories, readme) to `Cargo.toml`.
+
+### Changed
+- **Breaking API Change:** All parsers across all crates (`bank_accounts`, `credit_cards`, `mutual_funds`, `intl_stocks`) now return a wrapped `ParseResult<T>` struct containing the parsed `data: T` alongside a `validation: ValidationReport` object, instead of returning the raw account `T` directly.
+- **WASM / Python / CLI Output:** The output JSON schema is now wrapped in `{ "data": { ... }, "validation": { ... } }`.
+- **Error Handling:** Completely re-architected error handling across all parsers using the `thiserror` crate. Parsers now return a strongly-typed `XfinaError` enum instead of stringly-typed errors, enabling programmatic error matching.
+- **Bindings:** Updated FFI boundaries in `xfina-wasm` (JS) and `xfina-py` (Python) to properly propagate `XfinaError` types.
+- **Web App:** Updated the website header to explicitly link to `sakthipriyan.com/building-wealth` instead of linking generically to GitHub.
+
+### Fixed
+- **Code Cleanup:** Resolved hundreds of compiler and clippy warnings across the workspace, including unused variables, non-idiomatic default struct reassignments, and dead code.
+- **Testing:** Resolved integration test failures in CI by ensuring snapshot write/assertion tests are skipped via a `GITHUB_ACTIONS=true` environment check.
+- **Testing:** Replaced `HashMap` with `BTreeMap` and `HashSet` with `BTreeSet` in the IBKR parser to ensure deterministic serialization order for consistent snapshot tests.
+- **Code Cleanup:** Removed legacy, unused `f64`-based financial models (`Portfolio`, `Asset`, etc.) from `src/models/mod.rs`.
+- **Documentation:** Fixed an inaccuracy in `wasm/README.md` to correctly state that the default parser output format is `"xfina"`, not `"rebit"`.
+
+
+## [0.1.4] - 2026-08-05
+
+### Added
+- **Documentation:** Added package registry badges (Crates.io, PyPI, npm) to the `README.md`.
+- **Documentation:** Updated deployment instructions to reflect the new `xtask deploy-site` flow.
+
+### Fixed
+- **CI/CD:** Updated the release script in `xtask` to ensure `Cargo.lock` is correctly synced and to safely allow dirty publishing.
+
+## [0.1.3] - 2026-08-04
+
+### Added
+- **Deployment:** Re-architected website deployment pipeline via `cargo xtask deploy-site` to generate immutable, permanent archives for all minor releases in `gh-pages`.
+- **Infrastructure:** Updated `.github/workflows/publish.yml` to trigger orchestrated GitHub Actions deployments and handle safe concurrency locking.
+
+### Changed
+- **Web App:** Configured Vite with `base: './'` for path-agnostic artifact generation.
+- **Web App:** Transitioned from fetching version lists via GitHub API to a dynamically generated `versions.json` registry.
+
+### Fixed
+- **Web App:** Fixed Issue #23 where the version dropdown failed to properly display or navigate to the latest active version.
+
+## [0.1.2] - 2026-08-03
+
+## [0.1.1] - 2026-08-03
+
+### Added
+- **Parsers:** Added a new `format` parameter (`"rebit"` or `"xfina"`) to all WASM, Python, and CLI parsers to allow toggling between strict ReBIT AA schema compliance and extended Xfina schemas.
+- **Python:** Fully implemented PyO3 bindings for all statement parsers in the `xfina` PyPI package (the previous release accidentally omitted them).
+- **CLI:** Added the `--format` option to the CLI tool.
+
+### Fixed
+- **CI/CD:** Upgraded NPM in GitHub Actions to v11+ to fully support passwordless OIDC Trusted Publishing, fixing the `ENEEDAUTH` error.
+- **Documentation:** Updated all READMEs (Rust, WASM, Python) with correct function signatures, new format parameters, and accurate code examples.
+## [0.1.0] - 2026-08-03
+
+### Added
+- **Parsers:** Support for parsing PDF/XLS statements from major Indian financial institutions:
+  - Bank Accounts: HDFC, ICICI, SBI, Bank of Baroda, Axis Bank
+  - Credit Cards: HDFC, ICICI
+  - Mutual Funds: CAMS (CAS)
+  - International Stocks: Interactive Brokers (IBKR)
+- **Data Models:** Centralized `xfina-models` package standardizing financial schema based on RBI Account Aggregator specifications.
+- **CLI Tool:** Unified `xfina-cli` binary for parsing statements directly from the terminal and exporting to JSON.
+- **Language Bindings:** 
+  - `python`: Python bindings published to PyPI using PyO3/Maturin.
+  - `wasm`: WebAssembly module (`xfina-wasm`) published to NPM using `wasm-pack` for browser integration.
+- **Web App:** Vue 3 + Tailwind CSS frontend interface demonstrating local, privacy-preserving WASM parsing.
+- **CI/CD:** Automated GitHub Actions pipeline for testing and publishing to Crates.io, NPM, PyPI, and GitHub Pages.
+

xfina-0.4.0/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to Xfina
+
+Thank you for your interest in contributing to Xfina! This project thrives on community contributions, especially for adding new parsers for various Indian financial institutions.
+
+## Getting Started
+
+1. **Fork the Repository**
+2. **Install Rust**: Xfina is built in Rust. Install it via [rustup](https://rustup.rs/).
+3. **Run the Setup**:
+   ```bash
+   cargo build
+   cargo test
+   ```
+
+## Development Workflow
+
+### Adding a New Parser
+
+Xfina’s core parsing logic lives in the `xfina` crate, organized by domain:
+- `bank-accounts/`
+- `credit-cards/`
+- `mutual-funds/`
+- `intl-stocks/`
+
+1. **Create the Parser**: Create a new module in the appropriate directory (e.g., `bank-accounts/newbank.rs`).
+2. **Implement Error Handling**: All parsers must return `Result<T, crate::error::XfinaError>`. Use `?` for early returns.
+3. **Map to Models**: Parse the raw data directly into the shared models in `src/models/`. These models are designed to map closely to the Sahamati AA / ReBIT specifications.
+4. **Feature Flag**: Add your parser to `Cargo.toml` as a new feature flag and include it in the `all` feature list.
+5. **Update Targets**: 
+   - Export your parser in `src/lib.rs`
+   - Add it to the CLI in `src/main.rs`
+   - Add WASM bindings in `wasm/src/lib.rs`
+   - Add Python bindings in `python/src/lib.rs`
+   - Add UI support in `web/src/App.vue`
+
+### Testing Requirements
+
+Integration tests are mandatory for all parsers to ensure that future changes do not break existing snapshot outputs.
+
+1. Create a new integration test in the `tests/` directory (e.g., `tests/bank_accounts_newbank_integration.rs`).
+2. You will need sample financial statements (e.g., PDFs, Excel files, CSVs). Since these contain PII, **DO NOT commit test data to this repository.**
+3. Test data is expected to reside in a sibling directory: `../xfina-test-data/`.
+4. When writing your test, follow this strict snapshot pattern to ensure tests run reliably in CI and can be easily updated locally:
+
+```rust
+let update_expected = std::env::var("UPDATE_EXPECTED").unwrap_or_else(|_| "0".to_string());
+if update_expected == "1" {
+    // Write new snapshots
+    fs::write(&expected_xfina_path, &xfina_json).unwrap();
+    fs::write(&expected_rebit_path, &rebit_json).unwrap();
+} else {
+    // Assert against existing snapshots
+    let expected_xfina = fs::read_to_string(&expected_xfina_path).unwrap();
+    let expected_rebit = fs::read_to_string(&expected_rebit_path).unwrap();
+    assert_eq!(expected_xfina, xfina_json, "Xfina JSON mismatch");
+    assert_eq!(expected_rebit, rebit_json, "ReBIT JSON mismatch");
+}
+```
+
+To update snapshots locally, run:
+```bash
+UPDATE_EXPECTED=1 cargo test
+```
+
+## Pull Request Process
+
+1. Ensure your code passes all tests (`cargo test`).
+2. Ensure your code is properly formatted (`cargo fmt`).
+3. If modifying WASM interfaces, rebuild the WASM bundle (`cd wasm && wasm-pack build --target web`).
+4. Update the `README.md` and `task.md` if applicable.
+5. Submit a pull request to the `main` branch.
+
+## License
+
+By contributing to Xfina, you agree that your contributions will be licensed under the Apache 2.0 License.