chore/add commitlint workflow

.claude/rules/bitfinex-api.md

@@ -0,0 +1 @@
+../../../.claude/rules/bitfinex-api.md

.claude/rules/blazor-server.md

@@ -0,0 +1 @@
+../../../.claude/rules/blazor-server.md

.claude/rules/ci-deployment.md

@@ -0,0 +1 @@
+../../../.claude/rules/ci-deployment.md

.claude/rules/cloudflare-worker.md

@@ -0,0 +1 @@
+../../../.claude/rules/cloudflare-worker.md

.claude/rules/dotnet-auth.md

@@ -0,0 +1 @@
+../../../.claude/rules/dotnet-auth.md

.claude/rules/git-hooks.md

@@ -0,0 +1 @@
+../../../.claude/rules/git-hooks.md

.claude/rules/hono-cloudflare.md

@@ -0,0 +1 @@
+../../../.claude/rules/hono-cloudflare.md

.claude/rules/microsoft-graph.md

@@ -0,0 +1 @@
+../../../.claude/rules/microsoft-graph.md

.claude/rules/shared-packages.md

@@ -0,0 +1 @@
+../../../.claude/rules/shared-packages.md

.claude/rules/testing.md

@@ -0,0 +1 @@
+../../../.claude/rules/testing.md

.commitlintrc.json

@@ -0,0 +1,13 @@
+{
+  "extends": ["@commitlint/config-conventional"],
+  "rules": {
+    "type-enum": [
+      2,
+      "always",
+      ["feat", "fix", "docs", "style", "refactor", "perf", "test", "chore", "build", "ci", "revert"]
+    ],
+    "subject-case": [0, "always"],
+    "header-max-length": [1, "always", 100]
+  }
+}
+

.github/CODEOWNERS

@@ -0,0 +1,14 @@
+# Require owner review for CI/CD and security-sensitive files.
+# Prevents unauthorized workflow changes (supply chain attack vector).
+
+# Default owner — all files
+* @JCBauza
+
+# GitHub Actions workflows
+.github/workflows/ @JCBauza
+
+# Dependabot / security config
+dependabot.yml @JCBauza
+
+# This file itself
+CODEOWNERS @JCBauza

.github/copilot-instructions.md

@@ -0,0 +1,21 @@
+# Project Guidelines
+
+> **Primary reference:** Read the repo's `CLAUDE.md` first — it is the single source of truth. This file provides supplementary Copilot-specific context.
+
+
+## Build and Test
+
+- Use Python 3.12+. Install with `pip install -e ".[dev]"`. Test with `pytest` (coverage threshold 80%).
+- Lint/format with Ruff. Type check with mypy (strict mode).
+
+## Architecture
+
+- CloudIngenium fork of official Bitfinex Python API client (v2).
+- Published as `bitfinex-api-py` v6.0.0. Core library for BfxLendingBot.
+- REST + WebSocket communication with Bitfinex exchange.
+
+## Conventions
+
+- Build system: Hatchling. Pre-commit hooks via Ruff.
+- Always use `Decimal` for financial values — never `float`.
+- WebSocket-first, REST as fallback.

.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      all-security:
+        applies-to: security-updates
+        patterns: ["*"]
+      all-dependencies:
+        patterns: ["*"]
+    runs-on: "ubuntu-latest"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      all-security:
+        applies-to: security-updates
+        patterns: ["*"]
+      all-actions:
+        patterns: ["*"]
+    runs-on: "ubuntu-latest"

.github/workflows/build.yml

@@ -7,20 +7,39 @@ on:
   pull_request:
     branches:
       - master
+  workflow_dispatch:
 
 jobs:
-  build:
-    runs-on: ubuntu-latest
+  lint:
+    runs-on: [self-hosted, Linux, Build]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python 3.13
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.13"
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run ruff linter
+        run: ruff check bfxapi/
+      - name: Run ruff formatter check
+        run: ruff format --check bfxapi/
+      - name: Run mypy type checking
+        run: mypy bfxapi/
 
-    steps: 
-      - uses: actions/checkout@v3
-      - name: Set up Python 3.8
-        uses: actions/setup-python@v4
+  test:
+    runs-on: [self-hosted, Linux, Build]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up Python 3.13
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
-          python-version: '3.8'
-      - name: Install bitfinex-api-py's dependencies
-        run: python -m pip install -r dev-requirements.txt
-      - name: Run pre-commit hooks (see .pre-commit-config.yaml)
-        uses: pre-commit/action@v3.0.1
-      - name: Run mypy to ensure correct type hinting
-        run: python -m mypy bfxapi
+          python-version: "3.13"
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Verify import
+        run: python -c "import bfxapi; print('Import successful')"
+      - name: Run tests with coverage
+        run: python -m pytest tests/ -v
+      - name: Run mypy
+        run: mypy bfxapi/

.github/workflows/commitlint.yml

@@ -0,0 +1,20 @@
+name: Commit Lint
+on:
+  pull_request:
+    branches: [main, master]
+permissions:
+  contents: read
+jobs:
+  commitlint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Lint commits in PR
+        uses: wagoid/commitlint-github-action@v6
+        with:
+          configFile: ".commitlintrc.json"
+          failOnWarnings: false
+          firstParent: false
+

.github/workflows/copilot-reviewer.yml

@@ -0,0 +1,12 @@
+name: Copilot Reviewer
+on:
+  pull_request:
+    types: [opened, reopened, ready_for_review]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  request:
+    uses: CloudIngenium/.github/.github/workflows/request-copilot-review.yml@main
+    secrets: inherit

.gitignore

@@ -1,16 +1,33 @@
 .venv
+venv/
 .DS_Store
+Thumbs.db
 .vscode
+.idea
+.vim
+*.swp
+*.swo
 .python-version
 __pycache__
 
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build / packaging
 bitfinex_api_py.egg-info
 bitfinex_api_py.dist-info
 build/
 dist/
 pip-wheel-metadata/
 .eggs
 
-.idea
+# Test / lint caches
+.coverage
+htmlcov/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
 
-venv/
+*.log

.pre-commit-config.yaml

@@ -1,17 +1,7 @@
 repos:
-  - repo: https://github.com/PyCQA/isort
-    rev: 5.13.2
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.1
     hooks:
-      - id: isort
-  - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.2.0
-    hooks:
-      - id: black
-  - repo: https://github.com/PyCQA/flake8
-    rev: 7.0.0
-    hooks:
-      - id: flake8
-
-        additional_dependencies: [
-          flake8-bugbear
-        ]
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

CLAUDE.md

@@ -0,0 +1,77 @@
+# CLAUDE.md — bitfinex-api-py
+
+## Project Purpose
+
+CloudIngenium fork of the official Bitfinex Python API client (v2). Published as `bitfinex-api-py` v6.0.0. This is the core library used by BfxLendingBot for all Bitfinex REST and WebSocket communication.
+
+## Stack
+
+- **Language:** Python 3.12+ (targets 3.13)
+- **Build system:** Hatchling
+- **Lint/Format:** Ruff (line-length 80, pycodestyle + pyflakes + bugbear + pyupgrade + isort)
+- **Type checking:** mypy (strict mode)
+- **Test:** pytest + pytest-asyncio + pytest-cov (coverage threshold: 80%)
+- **Pre-commit:** Ruff linting and formatting hooks
+
+## Build & Dev
+
+```bash
+pip install -e ".[dev]"           # Install in editable mode with dev deps
+pytest                            # Run tests with coverage
+mypy bfxapi/                      # Type checking (strict)
+ruff check bfxapi/                # Lint
+ruff format bfxapi/               # Format
+pre-commit run --all-files        # Run all pre-commit hooks
+```
+
+## Structure
+
+```
+bfxapi/
+  __init__.py           # Package entry — exports Client, host constants
+  _client.py            # Main Client class (REST + WebSocket)
+  _version.py           # Version string
+  _utils/               # Internal utilities
+  exceptions.py         # Package-level exceptions
+  rest/
+    __init__.py
+    _bfx_rest_interface.py     # REST interface base
+    _interface/
+      interface.py             # Low-level HTTP interface
+      middleware.py            # Request middleware (auth, etc.)
+    _interfaces/
+      rest_auth_endpoints.py   # Authenticated REST endpoints
+      rest_public_endpoints.py # Public REST endpoints
+    exceptions.py              # REST-specific exceptions
+  types/
+    __init__.py
+    dataclasses.py      # All Bitfinex data types (Order, Trade, Candle, etc.)
+    labeler.py          # Field labeling utilities
+    notification.py     # Notification type
+    serializers.py      # Type serialization
+  websocket/
+    __init__.py
+    _connection.py      # WebSocket connection management
+    subscriptions.py    # Subscription types and management
+    exceptions.py       # WebSocket-specific exceptions
+    _client/
+      bfx_websocket_client.py   # Main WebSocket client
+      bfx_websocket_bucket.py   # Connection bucketing
+      bfx_websocket_inputs.py   # WebSocket input operations
+    _event_emitter/
+      bfx_event_emitter.py      # Event system
+    _handlers/
+      auth_events_handler.py    # Authenticated event handling
+      public_channels_handler.py # Public channel handling
+tests/                  # pytest test suites
+examples/               # Usage examples (REST + WebSocket)
+```
+
+## Conventions
+
+- Import types from `bfxapi.types.dataclasses` (never `bfxapi.models` — removed in v4)
+- Use `Decimal` for monetary values, never `float`
+- WebSocket preferred over REST for real-time data (no rate limits)
+- REST rate limit: 90 req/5min on private endpoints
+- Never hardcode API keys — use environment variables
+- asyncio-based WebSocket client; use `bfx.wss.run()` or `await bfx.wss.start()`