raindropio-mcp 0.1.1__tar.gz

raindropio_mcp-0.1.1/.coverage-ratchet.json

@@ -0,0 +1,16 @@
+{
+  "baseline": 81.87919463087249,
+  "current_minimum": 81.87919463087249,
+  "target": 100.0,
+  "last_updated": "2025-10-11T00:11:40.140419",
+  "history": [
+    {
+      "date": "2025-10-11T00:11:40.140469",
+      "coverage": 81.87919463087249,
+      "commit": "baseline",
+      "milestone": false
+    }
+  ],
+  "milestones_achieved": [],
+  "next_milestone": 90
+}

raindropio_mcp-0.1.1/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [lesleslie]

raindropio_mcp-0.1.1/.gitignore

@@ -0,0 +1,17 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+/.venv/
+/.envrc
+/.mcp.json
+/.python-version
+/.coverage
+/.claude/
+/htmlcov/
+/.benchmarks/

raindropio_mcp-0.1.1/.idea/copilot.data.migration.agent.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AgentMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

raindropio_mcp-0.1.1/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,29 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="JSHint" enabled="true" level="ERROR" enabled_by_default="true" />
+    <inspection_tool class="PyPep8NamingInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
+      <option name="ignoredErrors">
+        <list>
+          <option value="N802" />
+        </list>
+      </option>
+    </inspection_tool>
+    <inspection_tool class="PyUnresolvedReferencesInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredIdentifiers">
+        <list>
+          <option value="google.cloud.storage" />
+          <option value="firebase.ic" />
+          <option value="templates.ic" />
+          <option value="cloud_storage.ic" />
+          <option value="memorystore.ic" />
+          <option value="main.ic" />
+          <option value="models.ic" />
+          <option value="sys._getframe" />
+        </list>
+      </option>
+    </inspection_tool>
+    <inspection_tool class="PyprojectInspection" enabled="false" level="WARNING" enabled_by_default="false" />
+  </profile>
+</component>

raindropio_mcp-0.1.1/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

raindropio_mcp-0.1.1/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/raindropio-mcp.iml" filepath="$PROJECT_DIR$/.idea/raindropio-mcp.iml" />
+    </modules>
+  </component>
+</project>

raindropio_mcp-0.1.1/.idea/raindropio-mcp.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

raindropio_mcp-0.1.1/.idea/ruff.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RuffConfigService">
+    <option name="globalRuffExecutablePath" value="/usr/local/bin/ruff" />
+  </component>
+</project>

raindropio_mcp-0.1.1/.idea/vcs.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings" defaultProject="true" />
+</project>

raindropio_mcp-0.1.1/.idea/workspace.xml

@@ -0,0 +1,193 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="833cfa98-3bf1-4d40-99c6-fb0b48fec22d" name="Changes" comment="">
+      <change afterPath="$PROJECT_DIR$/.idea/raindropio-mcp.iml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/LICENSE" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/QWEN.md" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/mypy.ini" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.dockerignore" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.env.example" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gitignore" beforeDir="false" afterPath="$PROJECT_DIR$/.gitignore" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/.gitignore" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/vcs.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/vcs.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.pre-commit-config.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/.pre-commit-config.yaml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/AGENTS.md" beforeDir="false" afterPath="$PROJECT_DIR$/AGENTS.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/CLAUDE.md" beforeDir="false" afterPath="$PROJECT_DIR$/CLAUDE.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/Dockerfile" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/docker-compose.yml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/base-client-implementation.md" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/implementation-plan.md" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/phase5-summary.md" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/production-monitoring.md" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/docs/security-implementation.md" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/example.mcp.dev.json" beforeDir="false" afterPath="$PROJECT_DIR$/example.mcp.dev.json" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/example.mcp.json" beforeDir="false" afterPath="$PROJECT_DIR$/example.mcp.json" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/examples/auth_example.py" beforeDir="false" afterPath="$PROJECT_DIR$/examples/auth_example.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/examples/base_client_usage.py" beforeDir="false" afterPath="$PROJECT_DIR$/examples/base_client_usage.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/monitoring/alert_rules.yml" beforeDir="false" afterPath="$PROJECT_DIR$/monitoring/alert_rules.yml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/monitoring/prometheus.yml" beforeDir="false" afterPath="$PROJECT_DIR$/monitoring/prometheus.yml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/__main__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/auth/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/auth/audit_logger.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/auth/oauth_handler.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/auth/secure_oauth_handler.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/auth/security_enhancements.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/auth/security_middleware.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/activities.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/block.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/cashiering.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/crm.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/front_office.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/housekeeping.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/inventory.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/rates.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/api_clients/reservations.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/base_client.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/clients/client_factory.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/config/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/config/security_settings.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/config/settings.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/main.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/models/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/models/common.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/models/financial.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/models/guest.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/models/reservation.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/models/room.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/resources/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/resources/api_specs.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/resources/health_check.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/server.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/financial_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/guest_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/operation_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/reservation_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/room_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/tools/tool_registry.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/cache_manager.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/client_factory.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/connection_optimizer.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/exceptions.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/formatters.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/observability.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/resilience_manager.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/opera_cloud_mcp/utils/validators.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/requirements.txt" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/__init__.py" beforeDir="false" afterPath="$PROJECT_DIR$/tests/__init__.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/conftest.py" beforeDir="false" afterPath="$PROJECT_DIR$/tests/conftest.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/fixtures/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/fixtures/mock_responses.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/integration/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/integration/test_main_integration.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/integration/test_reservation_integration.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/integration/test_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/integration/test_workflows.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/performance/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/performance/load_test.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/performance/test_performance.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/test_oauth_integration.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/__init__.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_activities_client.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_api_specs.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_auth.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_clients.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_crm_client.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_enhanced_oauth_integration.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_financial_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_front_office_client.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_guest_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_models.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_operation_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_reservation_models.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_reservation_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_reservation_tools_simple.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_reservations_client.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/unit/test_room_tools.py" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/uv.lock" beforeDir="false" afterPath="$PROJECT_DIR$/uv.lock" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitLabMergeRequestFiltersHistory"><![CDATA[{
+  "lastFilter": {
+    "state": "OPENED",
+    "assignee": {
+      "type": "org.jetbrains.plugins.gitlab.mergerequest.ui.filters.GitLabMergeRequestsFiltersValue.MergeRequestsMemberFilterValue.MergeRequestsAssigneeFilterValue",
+      "username": "lesleslie",
+      "fullname": "Les Leslie"
+    }
+  }
+}]]></component>
+  <component name="GitLabMergeRequestsSettings"><![CDATA[{
+  "selectedUrlAndAccountId": {
+    "first": "https://gitlab.com/lesleslie/opera-cloud-mcp.git",
+    "second": "97b5872b-7573-42a7-9547-7db3d03839d1"
+  }
+}]]></component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 5
+}]]></component>
+  <component name="ProjectId" id="33u08LqPPfDUSlV76SPmGCKpiIW" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ASKED_MARK_IGNORED_FILES_AS_EXCLUDED": "true",
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "com.google.cloudcode.ide_session_index": "20251010_0001",
+    "dart.analysis.tool.window.visible": "false",
+    "git-widget-placeholder": "main",
+    "last_opened_file_path": "/Users/les/Projects/raindropio-mcp",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "settings.editor.selected.configurable": "com.augmentcode.intellij.settings",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-3aa1da707db6-JavaScript-PY-252.26830.99" />
+        <option value="bundled-python-sdk-164cda30dcd9-0af03a5fa574-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-252.26830.99" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="833cfa98-3bf1-4d40-99c6-fb0b48fec22d" name="Changes" comment="" />
+      <created>1760151488736</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1760151488736</updated>
+      <workItem from="1760151490728" duration="4558000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

raindropio_mcp-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,102 @@
+repos:
+  - repo: local
+    hooks:
+      - id: validate-regex-patterns
+        name: validate-regex-patterns
+        entry: uv run python -m crackerjack.tools.validate_regex_patterns
+        language: system
+        files: \.py$
+        exclude: ^\.venv/|^src/
+      - id: skylos
+        name: skylos-dead-code-detection
+        entry: skylos
+        language: system
+        args: ["raindropio_mcp", "--exclude", "tests"]
+        pass_filenames: false
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]
+      - id: zuban
+        name: zuban-type-checking
+        entry: uv run zuban check
+        language: system
+        args: ["--config-file", "mypy.ini", "./raindropio_mcp"]
+        pass_filenames: false
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+        name: trailing-whitespace
+        exclude: ^\.venv/|^src/
+      - id: end-of-file-fixer
+        name: end-of-file-fixer
+        exclude: ^\.venv/|^src/
+      - id: check-yaml
+        name: check-yaml
+        exclude: ^\.venv/|^src/
+      - id: check-toml
+        name: check-toml
+        exclude: ^\.venv/|^src/
+      - id: check-added-large-files
+        name: check-added-large-files
+        exclude: ^\.venv/|^src/
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.9.0
+    hooks:
+      - id: uv-lock
+        files: ^ pyproject\.toml$
+        exclude: ^src/
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.28.0
+    hooks:
+      - id: gitleaks
+        exclude: uv\.lock|pyproject\.toml|tests/.*|docs/.*|\.claude/.*|.*\.md|^src/
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.6
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml", "-r", "-ll"]
+        files: ^raindropio_mcp/.*\.py$
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
+        exclude: ^\.venv/|^src/
+        additional_dependencies: ["tomli"]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.0
+    hooks:
+      - id: ruff-check
+        exclude: ^\.venv/|^src/
+      - id: ruff-format
+        exclude: ^\.venv/|^src/
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.22
+    hooks:
+      - id: mdformat
+        exclude: ^\.venv/|^src/
+        additional_dependencies: ["mdformat-ruff"]
+  - repo: https://github.com/fredrikaverpil/creosote
+    rev: v4.1.0
+    hooks:
+      - id: creosote
+        exclude: ^\.venv/|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/rohaquinlop/complexipy-pre-commit
+    rev: v3.3.0
+    hooks:
+      - id: complexipy
+        args: ["-d", "low", "--max-complexity-allowed", "15"]
+        files: ^raindropio_mcp/.*\.py$
+        exclude: ^(\.venv/|tests/)|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/dosisod/refurb
+    rev: v2.2.0
+    hooks:
+      - id: refurb
+        files: ^raindropio_mcp/.*\.py$
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]

raindropio_mcp-0.1.1/AGENTS.md

@@ -0,0 +1,25 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+Core MCP code lives in `raindropio_mcp/`, with functional domains under `auth/`, `clients/`, `tools/`, `config/`, and `utils/`. `server.py` hosts the FastMCP entrypoint, while `main.py` and `__main__.py` wire configuration, tool registration, and observability. Tests mirror the package layout in `tests/`, `docs/` holds shared references, `monitoring/` stores dashboards, and runnable samples sit in `examples/`. Coverage output from pytest lands in `htmlcov/`.
+
+## Build, Test, and Development Commands
+
+Install dependencies with `uv sync`. Use `uv run python -m raindropio_mcp` (or `uv run raindropio-mcp`) to start the server locally. Run the full quality suite via `uv run crackerjack`; it chains Ruff, mypy, pytest, and Bandit. For targeted checks: `uv run ruff check --fix` formats and lints, `uv run mypy .` enforces typing, and `uv run pytest --cov=. --cov-report=html` regenerates coverage reports.
+
+## Coding Style & Naming Conventions
+
+Target Python 3.13 with 4-space indentation and Ruff-enforced 88-character lines. Keep functions and modules in `snake_case`, classes in `PascalCase`, and constants in `SCREAMING_SNAKE_CASE`. Maintain strict typing (`disallow_untyped_defs = true`) by annotating functions and preferring typed dataclasses or Pydantic models for payloads. Normalise imports with `uv run ruff check --select I --fix` before committing.
+
+## Testing Guidelines
+
+Pytest discovers `test_*.py` and `*_test.py` modules; test functions must start with `test_`. Shared fixtures belong in `tests/conftest.py`. Maintain ≥80% coverage by running `uv run pytest --cov=. --cov-report=html` and reviewing `htmlcov/index.html` for gaps. Write integration tests when adding MCP tools to exercise end-to-end flows.
+
+## Commit & Pull Request Guidelines
+
+Use imperative commit subjects (e.g., `Add Raindrop task sync`) and keep each commit scoped to one concern. Before opening a PR, run `uv run crackerjack` and include the output in the description. Link relevant issues, call out configuration or schema changes, and attach screenshots or sample MCP transcripts when behaviour shifts. Highlight new environment variables so reviewers can update `.env.example`.
+
+## Security & Configuration Tips
+
+Copy `.env.example` when bootstrapping and populate it with your Raindrop.io token locally—never commit secrets. Rotate personal tokens used for testing and rely on the structured logger for tool telemetry to preserve PII masking. Review `docs/` before altering authentication or observability flows to stay aligned with platform requirements.