arodonata 2.2.0__tar.gz → 2.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {arodonata-2.2.0 → arodonata-2.3.0}/CHANGELOG.md +30 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/PKG-INFO +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/CAPABILITIES.md +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/architecture/cpcrud.md +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/01_basic_queries.py +2 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/02_search_and_query.py +2 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/03_gateway_relationships.py +2 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/04_smart_refresh.py +13 -6
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/05_rulebase_queries.py +2 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/11_otel_tracing.py +2 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/12_mcp_embedded.py +2 -2
- arodonata-2.3.0/examples/13_gateway_topology_matching.py +91 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/README.md +25 -1
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/.openspec.yaml +2 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/design.md +85 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/proposal.md +36 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/specs/api-reference/spec.md +38 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/specs/client-and-facade/spec.md +10 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/specs/mcp-server/spec.md +10 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-api-reference-index-and-tool/tasks.md +20 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-cpcrud-application-site-support/.openspec.yaml +2 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-cpcrud-application-site-support/design.md +62 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-cpcrud-application-site-support/proposal.md +43 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-cpcrud-application-site-support/specs/cache-and-sync/spec.md +17 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-cpcrud-application-site-support/specs/cpcrud/spec.md +32 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-02-cpcrud-application-site-support/tasks.md +20 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/.openspec.yaml +2 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/design.md +161 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/proposal.md +63 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/specs/cache-and-sync/spec.md +21 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/specs/client-and-facade/spec.md +12 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/specs/gateway-topology/spec.md +68 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/specs/mcp-server/spec.md +12 -0
- arodonata-2.3.0/openspec/changes/archive/2026-11-03-gateway-topology-and-candidate-matching/tasks.md +37 -0
- arodonata-2.3.0/openspec/specs/api-reference/spec.md +44 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/cache-and-sync/spec.md +32 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/change-reports/spec.md +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/client-and-facade/spec.md +18 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/cpcrud/spec.md +32 -3
- arodonata-2.3.0/openspec/specs/gateway-topology/spec.md +72 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/integration-testing-and-examples/spec.md +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/mcp-server/spec.md +18 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/pyproject.toml +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/__init__.py +37 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/sessions.py +117 -19
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/storage/__init__.py +2 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/storage/cache_adapter.py +159 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/storage/tables.py +36 -1
- arodonata-2.3.0/src/arodonata/api_reference/__init__.py +24 -0
- arodonata-2.3.0/src/arodonata/api_reference/data/__init__.py +1 -0
- arodonata-2.3.0/src/arodonata/api_reference/data/cp_api_index.json.gz +0 -0
- arodonata-2.3.0/src/arodonata/api_reference/engine.py +680 -0
- arodonata-2.3.0/src/arodonata/api_reference/models.py +48 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/client.py +413 -91
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/config.py +17 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/__init__.py +16 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/common.py +3 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/objects.py +21 -0
- arodonata-2.3.0/src/arodonata/core/models/topology.py +133 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/ports/__init__.py +34 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/__init__.py +10 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/asset_service.py +302 -4
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/object_service.py +7 -4
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/search_service.py +144 -23
- arodonata-2.3.0/src/arodonata/core/services/topology_service.py +1598 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/checkpoint_ops_schema.json +113 -2
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/differ.py +92 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/executor.py +124 -5
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/inverse.py +12 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/models.py +1 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/planner.py +114 -5
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/service.py +12 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/state_reader.py +56 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/validator.py +41 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/prompts.py +23 -4
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/tools.py +245 -15
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/reports/collector.py +10 -12
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/reports/placement.py +19 -10
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b2/test_cpcrud_live.py +162 -0
- arodonata-2.3.0/tests/unit/test_api_reference.py +314 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_asset_service.py +153 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_change_reports.py +119 -4
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_client.py +38 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_client_facade.py +53 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_cpcrud_executor.py +203 -5
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_cpcrud_inverse.py +122 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_cpcrud_planner.py +223 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_cpcrud_state_reader.py +72 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_cpcrud_validator.py +80 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_mcp_tools.py +242 -6
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_models.py +29 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_object_service.py +28 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_sessions.py +65 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_smoke.py +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_storage.py +140 -2
- arodonata-2.3.0/tests/unit/test_topology_service.py +856 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/uv.lock +1 -1
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/rules/git-workflow.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/rules/linting-on-save.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/.openspec-target +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/openspec-apply-change/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/openspec-archive-change/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/openspec-explore/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/openspec-propose/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/openspec-sync-specs/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/skills/openspec-update-change/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/workflows/archive-task.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/workflows/audit.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/workflows/git-workflow.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.agents/workflows/save-plan.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/commands/archive-task.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/commands/audit.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/commands/git-workflow.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/commands/save-plan.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/skills/openspec-apply-change/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/skills/openspec-archive-change/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/skills/openspec-explore/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/skills/openspec-propose/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/skills/openspec-sync-specs/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.claude/skills/openspec-update-change/SKILL.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.env.example +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.github/workflows/docs.yml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.gitignore +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.markdownlint.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.markdownlintignore +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.python-version +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.ruff.toml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/.vscode/settings.json +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/AGENTS.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/README.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/CHANGELOG.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/LICENSE +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/_html/arodonata-v2-docs.html +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/architecture/caching-and-sync.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/architecture/database-schema.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/architecture/index.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/architecture/ports-and-adapters.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/architecture/sessions-and-mdm.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/configuration/index.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/configuration/multi-server.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/configuration/tls-verification.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/development/testing.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/01-basic-queries.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/02-search-and-query.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/03-gateway-relationships.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/04-smart-refresh.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/05-rulebase-queries.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/06-session-basics.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/07-context-and-overlay.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/08-cpcrud-operations.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/09-cpcrud-inverse.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/10-change-report-evidence.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/11-otel-tracing.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/12-mcp-embedded.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/examples/index.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/extra.css +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/getting-started/cpcrud.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/getting-started/first-script.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/getting-started/index.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/20261002_104508.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo-bw_sketch.jpeg +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo-bw_sketch.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo-bw_sketch.svg +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo-bw_sketch_thick.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo-bw_sketch_thick.svg +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo_tr.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/arodonata_logo_tr_sq.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/img/logo_arodonata_nt.png +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/index.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/mcp/index.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/scripts/build_notebooklm_docs.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/scripts/gen_ref_pages.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/user-guide/change-report.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs/user-guide/cpcrud.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs-notebooklm/01-guide-and-concepts.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs-notebooklm/02-api-reference.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs-notebooklm/03-examples-and-recipes.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/docs-notebooklm/04-capabilities-db-mcp-and-openspec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/06_session_basics.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/07_context_and_overlay.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/08_cpcrud_operations.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/09_cpcrud_inverse.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/10_change_report_evidence.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/README_CRUD.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/_session_guard.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/examples/crud_example.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/mkdocs.yml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/.gitkeep +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-1-core-and-storage/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-1-core-and-storage/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-1-core-and-storage/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-1-core-and-storage/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-2-transport-and-sessions/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-2-transport-and-sessions/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-2-transport-and-sessions/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-2-transport-and-sessions/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-3-sync-and-search/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-3-sync-and-search/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-3-sync-and-search/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-milestone-3-sync-and-search/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/cache-and-sync/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/client-and-facade/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/configuration/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/cpcrud/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/mcp-server/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/rulebase-and-numbering/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/sessions-and-mdm/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/specs/transport-and-tls/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-23-revise-v2-architecture-specs/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-4-rulebase-and-reports/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-4-rulebase-and-reports/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-4-rulebase-and-reports/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-4-rulebase-and-reports/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-5-cpcrud-engine/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-5-cpcrud-engine/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-5-cpcrud-engine/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-5-cpcrud-engine/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-6-mcp-server/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-6-mcp-server/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-6-mcp-server/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-24-milestone-6-mcp-server/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/cache-and-sync/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/client-and-facade/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/configuration/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/cpcrud/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/integration-testing-and-examples/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/mcp-server/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/rulebase-and-numbering/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/sessions-and-mdm/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/specs/transport-and-tls/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-audit-remediation-261025/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/specs/cache-and-sync/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/specs/cpcrud/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/specs/rulebase-and-numbering/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-host-app-integration-hardening/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-live-integration-tests-and-examples/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-live-integration-tests-and-examples/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-live-integration-tests-and-examples/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-live-integration-tests-and-examples/specs/integration-testing-and-examples/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-25-live-integration-tests-and-examples/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-human-readable-composite-ids/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-human-readable-composite-ids/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-human-readable-composite-ids/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-human-readable-composite-ids/specs/cache-and-sync/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-human-readable-composite-ids/specs/client-and-facade/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-human-readable-composite-ids/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-mcp-tool-consolidation/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-mcp-tool-consolidation/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-mcp-tool-consolidation/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-mcp-tool-consolidation/specs/client-and-facade/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-mcp-tool-consolidation/specs/mcp-server/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-26-mcp-tool-consolidation/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/specs/cache-and-sync/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/specs/change-reports/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/specs/client-and-facade/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/specs/cpcrud/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/specs/mcp-server/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/specs/sessions-and-mdm/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-audit-remediation-261030/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-post-publish-owned-session-and-placement/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-post-publish-owned-session-and-placement/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-post-publish-owned-session-and-placement/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-post-publish-owned-session-and-placement/specs/change-reports/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-30-post-publish-owned-session-and-placement/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-31-improve-change-report-object-and-rule-diffs/.openspec.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-31-improve-change-report-object-and-rule-diffs/design.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-31-improve-change-report-object-and-rule-diffs/proposal.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-31-improve-change-report-object-and-rule-diffs/specs/change-reports/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/changes/archive/2026-10-31-improve-change-report-object-and-rule-diffs/tasks.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/config.yaml +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/.gitkeep +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/configuration/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/rulebase-and-numbering/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/sessions-and-mdm/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/openspec/specs/transport-and-tls/spec.md +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/pytest.sh +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/client.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/pager.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/rate_limiter.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/task_waiter.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/tls.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/checkpoint/transport.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/sse/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/storage/database.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/adapters/storage/lock_adapter.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/context.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/errors.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/events.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/assets.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/domains.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/rulebase.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/models/services.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/domain_service.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/service_cache.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/services/sync_coordinator.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/core/telemetry.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/position_helper.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/cpcrud/rule_identity.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/cli.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/config.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/errors.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/security.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/mcp/server.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/py.typed +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/reports/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/reports/models.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/reports/renderer.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/filter.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/models.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/numbering.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/pager.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/refresh.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/src/arodonata/rulebase/source.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_auth.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_change_report_reads.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_concurrent_admins.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_harness_smoke.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_rate_limiting.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_reads_and_search.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_rulebase_reads.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_session_lifecycle.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b1/test_session_names.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b2/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b2/test_cache_build.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b3/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b3/test_publish_revert.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b3/test_throttling.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b4/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b4/test_cache_mode_matrix.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b4/test_multi_domain.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b5/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b5/test_change_report_session.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b5/test_full_rebuild.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b5/test_large_layer.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b5/test_publish_matrix.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b5/test_rulebase_session_refresh.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b6/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b6/test_soak.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b7/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b7/test_mcp_server.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/b7/test_mcp_tools.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/conftest.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/cp_revision.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/lab_build.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/lab_env.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/lab_ready.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/probe_lab_domains.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/probe_login_throttle.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/restore_baseline.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/integration/run_lock.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/__init__.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_config.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_context_and_models.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_domain_service.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_errors_and_telemetry.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_integration_harness.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_locks.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_mcp_config_and_cli.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_mcp_security.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_pager.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_rate_limiter.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_rulebase_numbering.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_rulebase_pager.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_rulebase_refresh.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_search_service.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_service_cache.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_sse_and_events.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_sync_coordinator.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_task_waiter.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_tls.py +0 -0
- {arodonata-2.2.0 → arodonata-2.3.0}/tests/unit/test_transport.py +0 -0
|
@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [Unreleased]
|
|
9
|
+
|
|
10
|
+
## v2.3.0 (2026-11-03)
|
|
11
|
+
|
|
12
|
+
### Feat
|
|
13
|
+
|
|
14
|
+
- **topology**: add gateway interface topology cache and candidate matching (#65)
|
|
15
|
+
- **cpcrud,cache**: support Check Point application-site objects and access-rule negate flags (#62)
|
|
16
|
+
- **api-reference,mcp**: bundle multi-version API schema index and unified api_reference tool (#61)
|
|
17
|
+
|
|
18
|
+
### Fix
|
|
19
|
+
|
|
20
|
+
- **audit**: remediate findings R1-R10 from audit 2611022007 (#64)
|
|
21
|
+
- **cpcrud**: allow same-creator WEB_API staged session adoption and discard adopt helper session (#63)
|
|
22
|
+
- **reports**: log system_objects_filtered at DEBUG instead of emitting ReportWarning (#60)
|
|
23
|
+
|
|
24
|
+
### Added
|
|
25
|
+
|
|
26
|
+
- Gateway Interface Topology Cache & Candidate Policy-Enforcing Gateway Matching (`arodonata.core.models.topology`, `arodonata.core.services.topology_service`, `arodonata.core.services.asset_service`, `arodonata.adapters.storage`, `ArodonataClient`, `arodonata.mcp.tools`, `examples/13_gateway_topology_matching.py`): SQL-backed `arodonata_gateway_topology` table (`GatewayTopologyRecord` / `GatewayTopologyEntry` with 64-bit integer IPv4 bounds `ip_first_int` / `ip_last_int`), cross-domain VSX slot reconciliation (`CpmiVsxSlotObj` and `CpmiVsSlotObj` linking tenant `CpmiVsNetobj` Virtual Systems via `targetCustomer` to their physical VSX parent gateway/cluster and merging `interfaces_installed` and `routes_installed`), `TopologyService` (`refresh_topology()`, `stream_refresh_topology()`, `get_gateway_topology()`, `summarize_gateway_interfaces()`, and `find_affected_gateways()`), `ArodonataClient` facade methods, and MCP `locate_gateways` tool and `cache_control(scope="topology")` support — resolving IPv4 addresses, CIDRs, ranges, and domain-scoped Check Point object/group names across connected subnets, recursive `specific-network` groups, VS static routes, and external interfaces while excluding physical cluster members, VS0 chassis, non-firewall hosts, `external_to_external` transits, and same-interface (`src_interface == dst_interface`) flows.
|
|
27
|
+
- Check Point `application-site` (`application-site`, `application-site-category`, `application-site-group`) support across `ServiceCacheService`, `HybridStateReader`, `SearchService`, `CachedRulebaseSource`, `CPCRUD`, and MCP tools (`arodonata.core.services.service_cache_service`, `arodonata.cpcrud`, `arodonata.rulebase`, `arodonata.mcp.tools`), plus `source-negate`, `destination-negate`, and `service-negate` boolean flags on CPCRUD `access-rule` operations (`checkpoint_ops_schema.json`, `Planner`, `Differ`, `Executor`, `inverse()`).
|
|
28
|
+
- Bundled multi-version Check Point API Reference & Offline Payload Validation Engine (`arodonata.api_reference`, `ArodonataClient`, `arodonata.mcp.tools`): packaged `cp_api_index.json.gz` (~395 KB compressed, covering 1,161 Management `v1.9`..`v2.2` and Gaia `v2.0.1` commands, 724 shared nested objects, and 430 enums) with lazy in-memory `ApiReferenceEngine` (`get_api_reference()`, `search_api_commands()`, `describe_api_command()` for single or batch command names with dynamic version filtering, and `validate_api_payload()` checking unknown/version-unsupported commands and fields, required parameters, mutually exclusive `field_alternatives`, types, and enum `valid_values`), `ArodonataClient` facade helpers with automatic `api_version` inference per `mgmt_name`, and the unified MCP `api_reference(action="search" | "describe" | "validate")` tool and `lookup_api_command` prompt.
|
|
29
|
+
|
|
30
|
+
### Changed
|
|
31
|
+
|
|
32
|
+
- Replaced the user-facing `system_objects_filtered` `ReportWarning` in `collect_change_report()` with a structured `DEBUG`-level log entry via `arlogi` (`src/arodonata/reports/collector.py`, `openspec/specs/change-reports/spec.md`) so routine filtering of background Check Point `"System"` maintenance objects does not clutter rendered HTML/Markdown evidence reports.
|
|
33
|
+
|
|
34
|
+
### Fixed
|
|
35
|
+
|
|
36
|
+
- CPCRUD staged-session cross-process adoption provenance and detached `arodonata-cpcrud-adopt` helper session cleanup (`arodonata.cpcrud.executor`, `arodonata.cpcrud.service`, `arodonata.client`): `Executor._adopt_staged_session()` now inspects `show-session {}` on the fresh helper session before takeover to obtain both `initial_uid` and the authenticated administrator's `user-name`, permits adopting custom-named `WEB_API` staged sessions (such as MMP `[ant]-MMP_Rules-...`) owned by the same administrator after a process restart or across workers/CLI while still refusing human `SmartConsole` GUI sessions and other administrators' sessions by default, accepts optional `expected_session_name: str | None = None` (`403 session_name_mismatch` on mismatch) and `allow_foreign: bool = False` across `publish_staged_session()`, `stream_publish_staged_session()`, and `discard_staged_session()`, and immediately calls `discard {"uid": initial_uid}` after `take-over-session` / `switch-session` so no empty `arodonata-cpcrud-adopt` helper session remains open on Check Point.
|
|
37
|
+
|
|
8
38
|
## v2.2.0 (2026-10-31)
|
|
9
39
|
|
|
10
40
|
### Feat
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: arodonata
|
|
3
|
-
Version: 2.
|
|
3
|
+
Version: 2.3.0
|
|
4
4
|
Summary: Async-first Python 3.13+ library and SDK for Check Point Security Management and MDSM operations
|
|
5
5
|
Project-URL: Homepage, https://github.com/chkp-antonr/arodonata
|
|
6
6
|
Project-URL: Repository, https://github.com/chkp-antonr/arodonata
|
|
@@ -12,7 +12,7 @@ In the enterprise automation ecosystem (such as **FPCR v2**, web portals, CLIs,
|
|
|
12
12
|
- Database-backed caching across **15 `arodonata_*`-prefixed SQLModel tables** (PostgreSQL `asyncpg` and SQLite `aiosqlite`) with SHA-256 schema hash auto-migration, naive UTC timestamp uniformity (`tzinfo=None`), and distributed locks (`arodonata_distributed_locks`).
|
|
13
13
|
- Incremental (`show-changes`) and full synchronization across domains, objects, services, assets (gateways/clusters/VSX), and rulebases with typed streaming progress events (`SyncProgressEvent`).
|
|
14
14
|
- Isolated write sessions (`WriteSession`) with `contextvars`-bound `SessionOverlay` for read-your-own-writes isolation prior to `publish`.
|
|
15
|
-
- Declarative Policy-as-Code (`CPCRUDService`): offline JSON Schema validation, `HybridStateReader`, two-axis conflict policies (`NameConflictPolicy` × `IpConflictPolicy`), pre-publish staleness verification (`DomainStamp`), staged session handoff (`take-over-session`),
|
|
15
|
+
- Declarative Policy-as-Code (`CPCRUDService`): offline JSON Schema validation, `HybridStateReader`, two-axis conflict policies (`NameConflictPolicy` × `IpConflictPolicy`), pre-publish staleness verification (`DomainStamp`), staged session handoff (`take-over-session`), compensating rollback generation (`inverse`), and full lifecycle support for network objects, services, `application-site` custom URL/regex objects, groups, and rules.
|
|
16
16
|
- Normalized 6-table rulebase cache with exact SmartConsole hierarchical rule numbering (`1`, `2.1`, `3`), reverse UID lookup (`locate_rules`), and local rulebase filtering (`filter_rulebase`, including `output_format="cpcrud"`).
|
|
17
17
|
- Auditable change evidence collection and offline multi-format rendering (`HTML`, `Markdown`, `JSON`).
|
|
18
18
|
- Consolidated Model Context Protocol (`arodonata.mcp`) server with 13 cache-aligned core tools and 5 tamper-proof HMAC-signed CPCRUD tools.
|
|
@@ -28,7 +28,7 @@ Before inspecting any objects or rules, `Planner` queries `show-last-published-s
|
|
|
28
28
|
|
|
29
29
|
`HybridStateReader` then serves object and service lookups using a two-tier strategy:
|
|
30
30
|
|
|
31
|
-
- **Cache Hit (Fast Path)**: If `arodonata_domain_sync_state` for `(mgmt_name, domain, scope, item_type)` matches the planner's `DomainStamp` (`last_published_at` and `last_session_uid`), lookups (`host`, `network`, `address-range`, `group`, `dns-domain`, `service-tcp`, `service-udp`, etc.) are resolved directly from `arodonata_objects` and `arodonata_services` in local SQL.
|
|
31
|
+
- **Cache Hit (Fast Path)**: If `arodonata_domain_sync_state` for `(mgmt_name, domain, scope, item_type)` matches the planner's `DomainStamp` (`last_published_at` and `last_session_uid`), lookups (`host`, `network`, `address-range`, `group`, `dns-domain`, `application-site`, `service-tcp`, `service-udp`, etc.) are resolved directly from `arodonata_objects` and `arodonata_services` in local SQL.
|
|
32
32
|
- **Live API Fallback**: If the domain cache is absent or older than the `DomainStamp`, `HybridStateReader` falls back transparently to live Check Point API queries.
|
|
33
33
|
- **Intra-Plan Virtual State Overlay**: Each `plan()` call instantiates a fresh `HybridStateReader` whose virtual overlay tracks objects, services, and groups planned earlier in the same template so downstream groups and rules see newly planned members immediately.
|
|
34
34
|
- **Fail-Closed Lookup Errors**: Transport or API errors during state lookup raise `StateLookupError` and produce `Outcome.ERROR` (plus `Outcome.SKIPPED_DEPENDENCY` on dependent groups/rules) rather than falsely assuming an object is missing and planning a duplicate `CREATE`.
|
|
@@ -16,8 +16,8 @@ import time
|
|
|
16
16
|
|
|
17
17
|
from dotenv import load_dotenv
|
|
18
18
|
|
|
19
|
-
load_dotenv(".env.lib", override=
|
|
20
|
-
load_dotenv(".env.secrets", override=
|
|
19
|
+
load_dotenv(".env.lib", override=False)
|
|
20
|
+
load_dotenv(".env.secrets", override=False)
|
|
21
21
|
|
|
22
22
|
from arodonata import ArodonataClient, ArodonataSettings # noqa: E402
|
|
23
23
|
|
|
@@ -20,8 +20,8 @@ import time
|
|
|
20
20
|
|
|
21
21
|
from dotenv import load_dotenv
|
|
22
22
|
|
|
23
|
-
load_dotenv(".env.lib", override=
|
|
24
|
-
load_dotenv(".env.secrets", override=
|
|
23
|
+
load_dotenv(".env.lib", override=False)
|
|
24
|
+
load_dotenv(".env.secrets", override=False)
|
|
25
25
|
|
|
26
26
|
from arodonata import ArodonataClient, ArodonataSettings # noqa: E402
|
|
27
27
|
|
|
@@ -17,8 +17,8 @@ from collections import defaultdict
|
|
|
17
17
|
|
|
18
18
|
from dotenv import load_dotenv
|
|
19
19
|
|
|
20
|
-
load_dotenv(".env.lib", override=
|
|
21
|
-
load_dotenv(".env.secrets", override=
|
|
20
|
+
load_dotenv(".env.lib", override=False)
|
|
21
|
+
load_dotenv(".env.secrets", override=False)
|
|
22
22
|
|
|
23
23
|
from arodonata import ArodonataClient, ArodonataSettings, Asset # noqa: E402
|
|
24
24
|
|
|
@@ -16,8 +16,8 @@ import time
|
|
|
16
16
|
|
|
17
17
|
from dotenv import load_dotenv
|
|
18
18
|
|
|
19
|
-
load_dotenv(".env.lib", override=
|
|
20
|
-
load_dotenv(".env.secrets", override=
|
|
19
|
+
load_dotenv(".env.lib", override=False)
|
|
20
|
+
load_dotenv(".env.secrets", override=False)
|
|
21
21
|
|
|
22
22
|
from arodonata import ArodonataClient, ArodonataSettings # noqa: E402
|
|
23
23
|
from arodonata.adapters.sse import to_sse_event # noqa: E402
|
|
@@ -30,32 +30,39 @@ async def main() -> None:
|
|
|
30
30
|
t0 = time.perf_counter()
|
|
31
31
|
|
|
32
32
|
async with ArodonataClient(settings=settings) as client:
|
|
33
|
-
print("[Step 1/
|
|
33
|
+
print("[Step 1/5] Streaming asset synchronization (gateways, clusters, VSX)...", flush=True)
|
|
34
34
|
async for ev in client.stream_refresh_assets(domains=target_domains, mode="smart"):
|
|
35
35
|
if ev.phase in ("started", "completed", "skipped", "failed"):
|
|
36
36
|
print(f" [{ev.phase}] {ev.message or f'{ev.mgmt_name}:{ev.domain} ({ev.item_type})'}")
|
|
37
37
|
|
|
38
|
-
print("\n[Step 2/
|
|
38
|
+
print("\n[Step 2/5] Streaming network object synchronization (hosts, networks, ranges, groups)...", flush=True)
|
|
39
39
|
async for ev in client.stream_refresh_objects(domains=target_domains, mode="smart"):
|
|
40
40
|
if ev.phase in ("started", "completed", "skipped", "failed"):
|
|
41
41
|
print(f" [{ev.phase}] {ev.message or f'{ev.mgmt_name}:{ev.domain} ({ev.item_type})'}")
|
|
42
42
|
# Example of converting a domain event to an SSE frame for web endpoints:
|
|
43
43
|
_sse_frame = to_sse_event(ev).encode()
|
|
44
44
|
|
|
45
|
-
print("\n[Step 3/
|
|
45
|
+
print("\n[Step 3/5] Batch refreshing services...", flush=True)
|
|
46
46
|
svc_outcome = await client.refresh_services(domains=target_domains, mode="smart")
|
|
47
47
|
print(
|
|
48
48
|
f" Services sync: refreshed={len(svc_outcome.refreshed_domains)}, "
|
|
49
49
|
f"skipped={len(svc_outcome.skipped_domains)}, items={svc_outcome.total_items}"
|
|
50
50
|
)
|
|
51
51
|
|
|
52
|
-
print("\n[Step 4/
|
|
52
|
+
print("\n[Step 4/5] Batch refreshing policy rulebases...", flush=True)
|
|
53
53
|
rb_outcome = await client.refresh_rulebases(domains=target_domains, mode="smart")
|
|
54
54
|
print(
|
|
55
55
|
f" Rulebases sync: refreshed={len(rb_outcome.refreshed_domains)}, "
|
|
56
56
|
f"skipped={len(rb_outcome.skipped_domains)}, items={rb_outcome.total_items}"
|
|
57
57
|
)
|
|
58
58
|
|
|
59
|
+
print("\n[Step 5/5] Batch refreshing gateway interface topology...", flush=True)
|
|
60
|
+
topo_outcome = await client.refresh_topology(domains=target_domains, mode="smart")
|
|
61
|
+
print(
|
|
62
|
+
f" Topology sync: refreshed={len(topo_outcome.refreshed_domains)}, "
|
|
63
|
+
f"skipped={len(topo_outcome.skipped_domains)}, items={topo_outcome.total_items}"
|
|
64
|
+
)
|
|
65
|
+
|
|
59
66
|
print(f"\nCache warm-up completed in {time.perf_counter() - t0:.2f}s")
|
|
60
67
|
|
|
61
68
|
|
|
@@ -21,8 +21,8 @@ import time
|
|
|
21
21
|
|
|
22
22
|
from dotenv import load_dotenv
|
|
23
23
|
|
|
24
|
-
load_dotenv(".env.lib", override=
|
|
25
|
-
load_dotenv(".env.secrets", override=
|
|
24
|
+
load_dotenv(".env.lib", override=False)
|
|
25
|
+
load_dotenv(".env.secrets", override=False)
|
|
26
26
|
|
|
27
27
|
from arodonata import ArodonataClient, ArodonataSettings # noqa: E402
|
|
28
28
|
|
|
@@ -23,8 +23,8 @@ from typing import Any
|
|
|
23
23
|
|
|
24
24
|
from dotenv import load_dotenv
|
|
25
25
|
|
|
26
|
-
load_dotenv(".env.lib", override=
|
|
27
|
-
load_dotenv(".env.secrets", override=
|
|
26
|
+
load_dotenv(".env.lib", override=False)
|
|
27
|
+
load_dotenv(".env.secrets", override=False)
|
|
28
28
|
|
|
29
29
|
from arlogi.otel import setup_tracing, shutdown_tracing # noqa: E402
|
|
30
30
|
|
|
@@ -18,8 +18,8 @@ from contextlib import asynccontextmanager
|
|
|
18
18
|
|
|
19
19
|
from dotenv import load_dotenv
|
|
20
20
|
|
|
21
|
-
load_dotenv(".env.lib", override=
|
|
22
|
-
load_dotenv(".env.secrets", override=
|
|
21
|
+
load_dotenv(".env.lib", override=False)
|
|
22
|
+
load_dotenv(".env.secrets", override=False)
|
|
23
23
|
|
|
24
24
|
import uvicorn # noqa: E402
|
|
25
25
|
from fastapi import FastAPI, Request, Response # noqa: E402
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
"""Example 13 — Gateway interface topology caching & affected gateway candidate matching (`get_gateway_topology`, `find_affected_gateways`).
|
|
2
|
+
|
|
3
|
+
Run:
|
|
4
|
+
uv run examples/13_gateway_topology_matching.py
|
|
5
|
+
|
|
6
|
+
Demonstrates:
|
|
7
|
+
1. Synchronizing and querying the gateway interface topology cache (`arodonata_gateway_topology`) via
|
|
8
|
+
`client.get_gateway_topology(...)`.
|
|
9
|
+
2. Summarizing flat topology intervals per gateway interface (`TopologyService.summarize_gateway_interfaces`).
|
|
10
|
+
3. Discovering which policy-enforcing gateways (simple gateways, clusters, and VSX Virtual Systems),
|
|
11
|
+
domains, policy packages, and access layers are affected by traffic between `sources` and `destinations`
|
|
12
|
+
via `client.find_affected_gateways(sources, destinations, ...)`, excluding gateways where both endpoints
|
|
13
|
+
reside behind the same interface (`src_interface == dst_interface`).
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
from __future__ import annotations
|
|
17
|
+
|
|
18
|
+
import asyncio
|
|
19
|
+
import os
|
|
20
|
+
import time
|
|
21
|
+
|
|
22
|
+
from dotenv import load_dotenv
|
|
23
|
+
|
|
24
|
+
load_dotenv(".env.lib", override=False)
|
|
25
|
+
load_dotenv(".env.secrets", override=False)
|
|
26
|
+
|
|
27
|
+
from arodonata import ArodonataClient, ArodonataSettings, TopologyService # noqa: E402
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
async def main() -> None:
|
|
31
|
+
"""Inspect cached gateway interface topology and locate candidate gateways for sample traffic flows."""
|
|
32
|
+
settings = ArodonataSettings()
|
|
33
|
+
raw_domain = os.getenv("EXAMPLE_DOMAIN")
|
|
34
|
+
target_domain = raw_domain.strip() if raw_domain and raw_domain.strip() else None
|
|
35
|
+
sample_sources = [
|
|
36
|
+
s.strip() for s in os.getenv("EXAMPLE_FLOW_SOURCES", "10.0.0.0/8, 192.168.0.0/16").split(",") if s.strip()
|
|
37
|
+
]
|
|
38
|
+
sample_destinations = [
|
|
39
|
+
d.strip() for d in os.getenv("EXAMPLE_FLOW_DESTINATIONS", "172.16.0.0/12, 8.8.8.8").split(",") if d.strip()
|
|
40
|
+
]
|
|
41
|
+
t0 = time.perf_counter()
|
|
42
|
+
|
|
43
|
+
async with ArodonataClient(settings=settings) as client:
|
|
44
|
+
print(
|
|
45
|
+
f"[Step 1/3] Fetching gateway topology entries for domain={target_domain!r} (get_gateway_topology)...",
|
|
46
|
+
flush=True,
|
|
47
|
+
)
|
|
48
|
+
entries = await client.get_gateway_topology(domain=target_domain, cache_mode="smart")
|
|
49
|
+
print(f" Cached topology intervals: {len(entries)}")
|
|
50
|
+
|
|
51
|
+
print("\n[Step 2/3] Summarizing topology per gateway interface...", flush=True)
|
|
52
|
+
summaries = TopologyService.summarize_gateway_interfaces(entries)
|
|
53
|
+
print(f" Policy-enforcing gateway interfaces: {len(summaries)}")
|
|
54
|
+
for summary in summaries[:10]:
|
|
55
|
+
cidrs_preview = ", ".join(summary.cidrs_and_ranges[:4])
|
|
56
|
+
if len(summary.cidrs_and_ranges) > 4:
|
|
57
|
+
cidrs_preview += f", ... (+{len(summary.cidrs_and_ranges) - 4} more)"
|
|
58
|
+
dmz_tag = " [DMZ]" if summary.leads_to_dmz else ""
|
|
59
|
+
print(
|
|
60
|
+
f" - {summary.gateway_asset_id} :: {summary.interface_name} "
|
|
61
|
+
f"({summary.topology_zone}{dmz_tag}, sources={summary.source_types}): {cidrs_preview}"
|
|
62
|
+
)
|
|
63
|
+
|
|
64
|
+
print(
|
|
65
|
+
f"\n[Step 3/3] Finding affected gateways for sources={sample_sources} -> destinations={sample_destinations}...",
|
|
66
|
+
flush=True,
|
|
67
|
+
)
|
|
68
|
+
candidates = await client.find_affected_gateways(
|
|
69
|
+
sources=sample_sources,
|
|
70
|
+
destinations=sample_destinations,
|
|
71
|
+
domain=target_domain,
|
|
72
|
+
cache_mode="cache",
|
|
73
|
+
)
|
|
74
|
+
print(f" Affected policy-enforcing gateways found: {len(candidates)}")
|
|
75
|
+
for cand in candidates:
|
|
76
|
+
print(
|
|
77
|
+
f" * {cand.gateway_asset_id} ({cand.gateway_type}, ip={cand.ipv4_address}) "
|
|
78
|
+
f"policy={cand.installed_access_policy!r} packages={cand.policy_packages} layers={cand.access_layers}"
|
|
79
|
+
)
|
|
80
|
+
for flow in cand.matched_flows[:5]:
|
|
81
|
+
print(
|
|
82
|
+
f" {flow.source_query} ({flow.src_interface} [{flow.src_topology_zone}: {flow.src_matched_cidr}]) "
|
|
83
|
+
f"-> {flow.destination_query} ({flow.dst_interface} [{flow.dst_topology_zone}: {flow.dst_matched_cidr}]) "
|
|
84
|
+
f"[{flow.match_type}]"
|
|
85
|
+
)
|
|
86
|
+
|
|
87
|
+
print(f"\nCompleted in {time.perf_counter() - t0:.2f}s")
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
if __name__ == "__main__":
|
|
91
|
+
asyncio.run(main())
|
|
@@ -9,7 +9,7 @@ Progressive runnable scripts demonstrating `ArodonataClient` usage from basic ca
|
|
|
9
9
|
| `01_basic_queries.py` | Discovers domains (`get_domains`) and queries cached hosts, networks, and services (`get_hosts`, `get_networks`, `get_services`) | No |
|
|
10
10
|
| `02_search_and_query.py` | Multi-term object search with recursive group memberships (`search_objects`), progressive disclosure (`describe_objects`), structured cross-domain aggregation (`query_objects`), and cache freshness (`get_cache_status`) | No |
|
|
11
11
|
| `03_gateway_relationships.py` | Gateway, cluster, and VSX asset topology (`get_gateways`) linking cluster members and virtual systems via `parent_uid` and `member_uids` | No |
|
|
12
|
-
| `04_smart_refresh.py` | Paired streaming (`stream_refresh_*`) and batch (`refresh_*`) cache synchronization across assets, objects, services, and
|
|
12
|
+
| `04_smart_refresh.py` | Paired streaming (`stream_refresh_*`) and batch (`refresh_*`) cache synchronization across assets, objects, services, rulebases, and gateway topology — **run this first to warm a persistent DB** | No |
|
|
13
13
|
| `05_rulebase_queries.py` | Policy package discovery (`get_policy_packages`), hierarchical SmartConsole numbering (`get_package_rulebase`), reverse UID lookup (`locate_rules`), and local rule filtering (`filter_rulebase`) | No |
|
|
14
14
|
| `06_session_basics.py` | Low-level session lifecycle: capture baseline (`show-last-published-session`), `create_dedicated_session`, `add-host`, `publish`, and `revert-to-revision` | Yes (auto-reverted via `_session_guard.py`) |
|
|
15
15
|
| `07_context_and_overlay.py` | Dynamic `auth_context`, `user_context`, and `write_session` with `SessionOverlay` read-your-own-writes isolation (discards on exit without publishing) | No (discards uncommitted session) |
|
|
@@ -18,6 +18,7 @@ Progressive runnable scripts demonstrating `ArodonataClient` usage from basic ca
|
|
|
18
18
|
| `10_change_report_evidence.py` | Auditable `ChangeReport` evidence: live unpublished numbering via `OwnedSession` vs published cached numbering rendered to HTML, Markdown, and JSON in `examples/_tmp/` | Yes (auto-reverted via `_session_guard.py`) |
|
|
19
19
|
| `11_otel_tracing.py` | Provider-agnostic OpenTelemetry instrumentation (`arlogi.otel.setup_tracing`) with a per-span timing breakdown from exported JSONL traces | No |
|
|
20
20
|
| `12_mcp_embedded.py` | Embedding Arodonata's MCP server (`create_mcp_server`, `create_asgi_app`) inside a FastAPI application with custom tools | No |
|
|
21
|
+
| `13_gateway_topology_matching.py` | Gateway interface topology caching (`get_gateway_topology`, `summarize_gateway_interfaces`) and affected gateway / policy package candidate matching (`find_affected_gateways`) | No |
|
|
21
22
|
| `_session_guard.py` | Crash-safe baseline snapshot/restore context manager (`guarded_session`) and standalone CLI tool for manual testing | Helper / CLI |
|
|
22
23
|
|
|
23
24
|
## Setup & Execution
|
|
@@ -39,6 +40,7 @@ uv run examples/03_gateway_relationships.py
|
|
|
39
40
|
uv run examples/05_rulebase_queries.py
|
|
40
41
|
uv run examples/07_context_and_overlay.py
|
|
41
42
|
uv run examples/11_otel_tracing.py
|
|
43
|
+
uv run examples/13_gateway_topology_matching.py
|
|
42
44
|
|
|
43
45
|
# 5. Run mutating lab examples (automatically snapshot and revert Domain4/Domain5 baseline)
|
|
44
46
|
ARODONATA_LAB=home uv run examples/06_session_basics.py
|
|
@@ -50,6 +52,28 @@ ARODONATA_LAB=home uv run examples/10_change_report_evidence.py
|
|
|
50
52
|
uv run examples/12_mcp_embedded.py
|
|
51
53
|
```
|
|
52
54
|
|
|
55
|
+
## Overriding Target Server & Domain via CLI Environment Variables
|
|
56
|
+
|
|
57
|
+
Example scripts load `.env.lib` and `.env.secrets` with `override=False`, so you can point any example at another Management Server or domain directly from the command line without editing `.env.lib`:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
# Query gateway topology across ALL domains on an alternate MDS (EXAMPLE_DOMAIN="" means all domains)
|
|
61
|
+
MGMT_NAMES=mdsNP2.np.cparch.in \
|
|
62
|
+
MGMT_SERVERS=10.192.11.140 \
|
|
63
|
+
API_KEY_VARS=CPIL_API_KEY \
|
|
64
|
+
EXAMPLE_DOMAIN="" \
|
|
65
|
+
uv run examples/13_gateway_topology_matching.py
|
|
66
|
+
|
|
67
|
+
# Query a specific domain and custom traffic flow endpoints
|
|
68
|
+
MGMT_NAMES=mdsNP2.np.cparch.in \
|
|
69
|
+
MGMT_SERVERS=10.192.11.140 \
|
|
70
|
+
API_KEY_VARS=CPIL_API_KEY \
|
|
71
|
+
EXAMPLE_DOMAIN="General" \
|
|
72
|
+
EXAMPLE_FLOW_SOURCES="10.0.0.0/8" \
|
|
73
|
+
EXAMPLE_FLOW_DESTINATIONS="172.16.0.0/12, 8.8.8.8" \
|
|
74
|
+
uv run examples/13_gateway_topology_matching.py
|
|
75
|
+
```
|
|
76
|
+
|
|
53
77
|
## Crash-Safe Manual Testing with `_session_guard.py`
|
|
54
78
|
|
|
55
79
|
When experimenting manually in SmartConsole or with ad-hoc scripts against a lab domain:
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Design: Bundled Multi-Version Check Point API Reference Engine & Unified MCP Tool
|
|
2
|
+
|
|
3
|
+
## Context
|
|
4
|
+
|
|
5
|
+
See `proposal.md` for motivation and scope. `~/Code/2026/CP_API` now compiles Check Point's official `v1.9`, `v2`, `v2.1`, and `v2.2` dynamic documentation datasets (`apis.json`, `content.json`, `examples.json`, `changes.json`) plus Gaia `v2.0.1` and Management `v2.1` Postman collections into a single normalized, deduplicated gzip bundle (`dist/cp_api_index.json.gz`, ~395 KB compressed, containing 1,161 commands, 724 shared nested objects, and 430 shared enums).
|
|
6
|
+
|
|
7
|
+
`arodonata` needs to embed this bundle so both Python SDK consumers (e.g., MMP) and MCP agents can perform fast, offline, version-aware two-step API introspection (`search` -> `describe`) and pre-flight payload validation (`validate`) without loading multi-megabyte schemas into LLM contexts or making network calls.
|
|
8
|
+
|
|
9
|
+
## Goals / Non-Goals
|
|
10
|
+
|
|
11
|
+
**Goals:**
|
|
12
|
+
|
|
13
|
+
- Embed `cp_api_index.json.gz` (~395 KB) inside `src/arodonata/api_reference/data/cp_api_index.json.gz` and load it lazily on first use.
|
|
14
|
+
- Provide a clean, synchronous (in-memory) `ApiReferenceEngine` in `arodonata.api_reference` usable both standalone (`from arodonata import search_api_commands, describe_api_command, validate_api_payload`) and via `ArodonataClient`.
|
|
15
|
+
- Automatically infer the target Check Point API `version` from `ArodonataClient` management server settings (`MgmtServerConfig.api_version`) when `mgmt_name` is provided or a single management server is configured.
|
|
16
|
+
- Expose a single consolidated MCP tool `api_reference(action="search" | "describe" | "validate", ...)` in `arodonata.mcp.tools`.
|
|
17
|
+
|
|
18
|
+
**Non-Goals:**
|
|
19
|
+
|
|
20
|
+
- Re-implementing the raw HTML/JSON compiler inside `arodonata` (`~/Code/2026/CP_API` remains the upstream compiler that produces `cp_api_index.json.gz`).
|
|
21
|
+
- Making live network requests to `sc1.checkpoint.com` from `arodonata` at runtime.
|
|
22
|
+
|
|
23
|
+
## Decisions
|
|
24
|
+
|
|
25
|
+
### 1. Package Layout & Lazy Singleton Loading (`src/arodonata/api_reference/`)
|
|
26
|
+
|
|
27
|
+
```text
|
|
28
|
+
src/arodonata/api_reference/
|
|
29
|
+
├── __init__.py
|
|
30
|
+
├── data/
|
|
31
|
+
│ └── cp_api_index.json.gz # ~395 KB bundled multi-version schema index
|
|
32
|
+
├── models.py # Typed Pydantic v2 / TypedDict response models
|
|
33
|
+
└── engine.py # ApiReferenceEngine (search, describe, validate)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
- **Why bundle `.json.gz` inside `src/arodonata/api_reference/data/`?**
|
|
37
|
+
At 395 KB, `cp_api_index.json.gz` adds negligible wheel size while guaranteeing zero external file path dependencies when `arodonata` is installed in downstream virtualenvs or containers. Decompressing 395 KB in memory takes ~15 ms and occurs lazily on the first call to `get_api_reference()`.
|
|
38
|
+
- **Custom Path Override**: `ApiReferenceEngine.from_path(path)` allows loading a custom or newly generated `cp_api_index.json` / `.json.gz` without reinstalling the package.
|
|
39
|
+
|
|
40
|
+
### 2. Version Normalization & Management Server Inference
|
|
41
|
+
|
|
42
|
+
Check Point API versions appear in multiple formats across configurations (`"1.9"`, `"v1.9"`, `"1.9.1"`, `"2"`, `"2.0"`, `"v2.0.1"`, `"2.1"`, `"v2.2"`).
|
|
43
|
+
|
|
44
|
+
- `normalize_api_version(version)` maps:
|
|
45
|
+
- `"1.9"`, `"v1.9"`, `"1.9.1"`, `"v1.9.1"` → `"v1.9"`
|
|
46
|
+
- `"2"`, `"v2"`, `"2.0"`, `"v2.0"`, `"2.0.1"`, `"v2.0.1"` → `"v2"`
|
|
47
|
+
- `"2.1"`, `"v2.1"` → `"v2.1"`
|
|
48
|
+
- `"2.2"`, `"v2.2"` → `"v2.2"`
|
|
49
|
+
- When called via `ArodonataClient` or the MCP `api_reference` tool with `version=None`:
|
|
50
|
+
- If `mgmt_name` is provided (or if `client.settings.mgmt_servers` has a single entry), inspect `mgmt_cfg.api_version`. If set, normalize and use it as the target `version`; otherwise default to `"v2.2"` (`meta["latest"]`).
|
|
51
|
+
|
|
52
|
+
### 3. Offline Payload Validation (`validate_payload`)
|
|
53
|
+
|
|
54
|
+
To help both LLMs and `cpcrud` / `api_call` callers catch schema mistakes before opening a Check Point session, `engine.validate_payload(command, payload, version=...)` performs fast structural checks against the resolved command schema:
|
|
55
|
+
|
|
56
|
+
1. **Command existence & version check**: If `command` does not exist in the index, return `valid=False` with top similar command suggestions via `search_commands`. If `command` exists but is not in `supported_versions` for `version`, report the exact versions where it is supported (`added_in` / `supported_versions`).
|
|
57
|
+
2. **Unknown or version-mismatched fields**: If a top-level key in `payload` is not in the command's `fields` for `version`, check whether the field exists in another version of the same command (e.g., `"Field 'gateway-owner' is only supported in ['v1.9'], not in target version 'v2.2'"` or `"Field 'xyz' was added in v2.2; target version is v2.0"`) or is completely unknown.
|
|
58
|
+
3. **Required fields & `field_alternatives`**:
|
|
59
|
+
- Check unconditionally `required=True` fields that are not part of an alternative group.
|
|
60
|
+
- For each group in `field_alternatives` (e.g., `["uid", "name"]` or `["ip-address", "ipv4-address", "ipv6-address"]`), if none of the alternatives is present and the command requires an identifier/address (or one of the group fields is marked required), report the alternative group clearly.
|
|
61
|
+
4. **Type & Enum Value Checks**:
|
|
62
|
+
- Verify field values match at least one declared `ApiFieldType` (`string`, `integer`, `boolean`, `list`, `object`), and when `enum_ref` / `valid_values` is present on a string field (and no non-enum string type is allowed), verify the value is in `valid_values`.
|
|
63
|
+
|
|
64
|
+
### 4. Consolidated MCP Tool (`api_reference`)
|
|
65
|
+
|
|
66
|
+
Following the progressive-disclosure pattern established by `query_objects` and `cache_control`:
|
|
67
|
+
|
|
68
|
+
- Register a single MCP tool `api_reference` in `src/arodonata/mcp/tools.py` (always available, read-only, zero network/DB side effects):
|
|
69
|
+
- `action: Literal["search", "describe", "validate"] = "search"`
|
|
70
|
+
- `query: str | None = None` (for `action="search"`)
|
|
71
|
+
- `command: str | list[str] | None = None` (for `action="describe"` or `"validate"`)
|
|
72
|
+
- `payload: dict[str, Any] | None = None` (for `action="validate"`)
|
|
73
|
+
- `category: str | None = None`
|
|
74
|
+
- `crud_type: Literal["add", "set", "show", "delete", "action"] | None = None`
|
|
75
|
+
- `api_family: Literal["management", "gaia"] | None = None`
|
|
76
|
+
- `version: str | None = None`
|
|
77
|
+
- `mgmt_name: str | None = None`
|
|
78
|
+
- `resolve_nested: bool = True`
|
|
79
|
+
- `include_examples: bool = True`
|
|
80
|
+
- `limit: int = 15`
|
|
81
|
+
|
|
82
|
+
## Risks / Trade-offs
|
|
83
|
+
|
|
84
|
+
- **[Risk] Check Point fields with union types (e.g., a field accepting either a `string` name, a `list[str]`, or an `object` with `add`/`remove`)** → **Mitigation**: `validate_payload` checks whether the provided Python value matches *any* of the entries in `field["types"]`, avoiding false-positive rejections on polymorphic Check Point parameters.
|
|
85
|
+
- **[Risk] Wheel packaging omitting `.json.gz` data files** → **Mitigation**: Place `cp_api_index.json.gz` inside `src/arodonata/api_reference/data/` (with an `__init__.py` or Hatchling wheel inclusion) and verify loading via `importlib.resources` in unit tests.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Proposal: Bundled Multi-Version Check Point API Reference Engine & Unified MCP Tool
|
|
2
|
+
|
|
3
|
+
## Why
|
|
4
|
+
|
|
5
|
+
Downstream applications (such as MMP), AI agents, and `arodonata` users frequently need to discover the exact Check Point Management or Gaia API command for a task, inspect its request parameters and nested object schemas for a specific Check Point API version (`v1.9` through `v2.2`), or validate a JSON payload before sending a live `api_call`. Loading raw multi-megabyte API documentation into an LLM context window is prohibitively expensive, while querying external documentation servers requires network access and lacks version-aware filtering matched to the connected Management Server's `api_version`.
|
|
6
|
+
|
|
7
|
+
## What Changes
|
|
8
|
+
|
|
9
|
+
- **Bundle Compact Multi-Version API Schema Index (`cp_api_index.json.gz`)**:
|
|
10
|
+
- Package the normalized, deduplicated multi-version schema bundle (~395 KB gzip, produced by `~/Code/2026/CP_API` from official Check Point `v1.9`, `v2`, `v2.1`, `v2.2` dynamic datasets and Gaia `v2.0.1` Postman collections) inside `src/arodonata/api_reference/data/cp_api_index.json.gz`.
|
|
11
|
+
- **Add Offline Two-Step API Reference Engine (`arodonata.api_reference`)**:
|
|
12
|
+
- Provide a lazy, thread-safe in-memory query and validation service (`ApiReferenceEngine` / `get_api_reference()`) supporting:
|
|
13
|
+
1. **Step 1 — `search_commands`**: Fast keyword, category, `crud_type` (`add`, `set`, `show`, `delete`, `action`), `api_family` (`management`, `gaia`), and `version` search returning lightweight command summaries (~300–500 bytes).
|
|
14
|
+
2. **Step 2 — `describe_command`**: Detailed command schema lookup (accepting a single command name or a list of command names) dynamically filtering top-level fields, mutually exclusive `field_alternatives`, and recursive `nested_objects` / `enums` to the caller's target API version (`v1.9`, `v2`, `v2.1`, `v2.2`), plus official request/CLI examples.
|
|
15
|
+
3. **Step 3 — `validate_payload`**: Offline pre-flight validation of a request payload dict against a command's version-specific schema (checking unknown fields, fields unsupported in the target API version, missing `required` fields, mutually exclusive `field_alternatives`, primitive/list/object types, and enum `valid_values`).
|
|
16
|
+
- **Expose Facade Helpers on `ArodonataClient` and Top-Level Package**:
|
|
17
|
+
- Expose `client.api_reference` and convenience methods `client.search_api_commands(...)`, `client.describe_api_command(...)`, and `client.validate_api_payload(...)` on `ArodonataClient`, automatically resolving the default `version` from the configured management server's `api_version` when `mgmt_name` is provided (or defaulting to the single configured server).
|
|
18
|
+
- **Add Consolidated `api_reference` MCP Tool**:
|
|
19
|
+
- Register a single progressive-disclosure MCP tool `api_reference(action="search" | "describe" | "validate", ...)` on `arodonata-mcp` so MCP clients and agents can perform two-step command discovery, inspect version-specific nested schemas, and pre-validate `api_call` payloads offline.
|
|
20
|
+
|
|
21
|
+
## Capabilities
|
|
22
|
+
|
|
23
|
+
### New Capabilities
|
|
24
|
+
|
|
25
|
+
- `api-reference`: Bundled multi-version Check Point API schema index (`cp_api_index.json.gz`), lazy in-memory `ApiReferenceEngine`, two-step command discovery (`search_commands`, `describe_command` with dynamic version filtering), and offline request payload validation (`validate_payload`).
|
|
26
|
+
|
|
27
|
+
### Modified Capabilities
|
|
28
|
+
|
|
29
|
+
- `client-and-facade`: Expose `api_reference` property and `search_api_commands`, `describe_api_command`, and `validate_api_payload` methods on `ArodonataClient` (with automatic `api_version` inference from configured `mgmt_name`) and top-level `arodonata` exports.
|
|
30
|
+
- `mcp-server`: Expose the unified `api_reference(action="search" | "describe" | "validate")` tool in `arodonata.mcp`.
|
|
31
|
+
|
|
32
|
+
## Impact
|
|
33
|
+
|
|
34
|
+
- **New Package**: `src/arodonata/api_reference/` (`__init__.py`, `engine.py`, `models.py`, `data/cp_api_index.json.gz`).
|
|
35
|
+
- **Updated Files**: `src/arodonata/client.py`, `src/arodonata/__init__.py`, `src/arodonata/mcp/tools.py`, `src/arodonata/mcp/prompts.py`, `pyproject.toml` (package data inclusion if needed).
|
|
36
|
+
- **Dependencies**: Zero new external dependencies (uses Python stdlib `gzip`, `json`, `importlib.resources` and existing `pydantic`).
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
## ADDED Requirements
|
|
2
|
+
|
|
3
|
+
### Requirement: Bundled Multi-Version API Schema Index and Lazy Loading
|
|
4
|
+
|
|
5
|
+
`arodonata.api_reference` SHALL package the compressed multi-version Check Point API schema bundle (`cp_api_index.json.gz`, covering Management API `v1.9`, `v2`, `v2.1`, `v2.2` and Gaia API `v2.0.1`) inside the installed distribution, load and decompress it lazily in memory on first query (with optional custom `index_path` override), and perform zero network or database calls.
|
|
6
|
+
|
|
7
|
+
#### Scenario: Default bundled index loads lazily without network or database access
|
|
8
|
+
|
|
9
|
+
- **WHEN** `get_api_reference()` or `ApiReferenceEngine.default()` is called in an offline process with no `ArodonataClient` or database configured
|
|
10
|
+
- **THEN** it SHALL decompress the bundled `cp_api_index.json.gz` into memory once, cache the singleton instance for subsequent calls, and expose `meta` (`versions`, `latest`, `commands_count`, `shared_objects_count`, `enums_count`)
|
|
11
|
+
|
|
12
|
+
### Requirement: Two-Step Version-Aware Command Discovery (Search and Describe)
|
|
13
|
+
|
|
14
|
+
`ApiReferenceEngine` (and top-level helpers `search_api_commands` / `describe_api_command`) SHALL provide a two-step lookup contract: `search_commands` returning ranked lightweight command summaries filtered by version, category, `crud_type`, and `api_family`, and `describe_command` accepting one or more command names and returning resolved schemas (`fields`, `field_alternatives`, `nested_objects`, `enums`, `example`) dynamically filtered to the target API version.
|
|
15
|
+
|
|
16
|
+
#### Scenario: Step 1 search filters by API version, CRUD type, and category
|
|
17
|
+
|
|
18
|
+
- **WHEN** `search_commands("export-access-rulebase", version="v1.9")` and `search_commands("export-access-rulebase", version="v2.2")` are called
|
|
19
|
+
- **THEN** the `v1.9` search SHALL exclude commands added after `v1.9`, while the `v2.2` search SHALL return the matching command summary with `added_in`, `supported_versions`, and `short_description`
|
|
20
|
+
|
|
21
|
+
#### Scenario: Step 2 describe dynamically filters fields and nested objects by target version
|
|
22
|
+
|
|
23
|
+
- **WHEN** `describe_command("add-interface", version="v1.9")` and `describe_command("add-interface", version="v2.2")` are called
|
|
24
|
+
- **THEN** the `v1.9` schema SHALL include `v1.9`-only fields (such as `gateway-owner` and `anti-spoofing-enabled`) and omit `v2+`-only fields, while the `v2.2` schema SHALL include only fields and nested objects valid in `v2.2`
|
|
25
|
+
|
|
26
|
+
#### Scenario: Batch describe accepts multiple command names in a single call
|
|
27
|
+
|
|
28
|
+
- **WHEN** `describe_command(["add-host", "set-host"], version="v2.2")` is called with a list of command names
|
|
29
|
+
- **THEN** it SHALL return a mapping or list of resolved command descriptions for each requested command (and report any unknown or version-unsupported command names clearly)
|
|
30
|
+
|
|
31
|
+
### Requirement: Offline Request Payload Validation Against Versioned Schema
|
|
32
|
+
|
|
33
|
+
`ApiReferenceEngine.validate_payload(command, payload, *, version="v2.2")` (and `validate_api_payload`) SHALL validate a candidate request `payload` dictionary offline against the command's schema for `version`, reporting structured validation errors for unknown or version-unsupported commands and fields, missing `required` fields, unsatisfied or conflicting `field_alternatives`, invalid types, and enum `valid_values` mismatches.
|
|
34
|
+
|
|
35
|
+
#### Scenario: Payload validation catches missing required fields and version-unsupported parameters
|
|
36
|
+
|
|
37
|
+
- **WHEN** `validate_payload("add-host", {"color": "invalid-color"}, version="v2.2")` is called
|
|
38
|
+
- **THEN** it SHALL return `valid=False` with actionable errors identifying missing required fields (`name` and `ip-address` / `ipv4-address` / `ipv6-address`) and the invalid enum value for `color`
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
## ADDED Requirements
|
|
2
|
+
|
|
3
|
+
### Requirement: Client Facade API Reference Introspection with Management Version Inference
|
|
4
|
+
|
|
5
|
+
`ArodonataClient` SHALL expose `api_reference` (`ApiReferenceEngine`) and convenience methods `search_api_commands(...)`, `describe_api_command(...)`, and `validate_api_payload(...)` that automatically infer the default target API `version` from the configured management server's `api_version` when `version=None` (using `mgmt_name` or the sole configured management server, and falling back to the index's `latest` version `"v2.2"` when no server version is configured).
|
|
6
|
+
|
|
7
|
+
#### Scenario: Client facade infers target API version from configured management server
|
|
8
|
+
|
|
9
|
+
- **WHEN** `client.describe_api_command("add-interface", mgmt_name="corp-mds")` is called with `version=None` on a client where `"corp-mds"` is configured with `api_version="1.9"`
|
|
10
|
+
- **THEN** `ArodonataClient` SHALL resolve `version="v1.9"` automatically from `"corp-mds"` settings and return the `v1.9`-filtered schema for `add-interface`
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
## ADDED Requirements
|
|
2
|
+
|
|
3
|
+
### Requirement: Unified Progressive-Disclosure MCP API Reference Tool
|
|
4
|
+
|
|
5
|
+
The `arodonata[mcp]` server SHALL expose a single consolidated `api_reference` tool supporting `action="search" | "describe" | "validate"` (with automatic `version` inference from `mgmt_name` when `version` is omitted), enabling MCP clients and agents to search Check Point commands (`action="search"`), inspect version-filtered command parameters, nested objects, and examples (`action="describe"`), and validate candidate request payloads offline before calling `api_call` (`action="validate"`).
|
|
6
|
+
|
|
7
|
+
#### Scenario: Two-step MCP discovery and payload validation via api_reference tool
|
|
8
|
+
|
|
9
|
+
- **WHEN** an MCP client calls `api_reference(action="search", query="host", crud_type="add")`, then `api_reference(action="describe", command="add-host", version="v2.2")`, and finally `api_reference(action="validate", command="add-host", payload={"name": "web-01", "ip-address": "192.0.2.10"})`
|
|
10
|
+
- **THEN** `action="search"` SHALL return compact matching command summaries, `action="describe"` SHALL return the full `v2.2` field schema, `field_alternatives`, `nested_objects`, and canonical example for `add-host`, and `action="validate"` SHALL return `valid=True` with `errors=[]`
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Tasks: Bundled Multi-Version Check Point API Reference Engine & Unified MCP Tool
|
|
2
|
+
|
|
3
|
+
## 1. Bundled Index & Offline API Reference Engine (`src/arodonata/api_reference/`)
|
|
4
|
+
|
|
5
|
+
- [x] 1.1 Copy `~/Code/2026/CP_API/dist/cp_api_index.json.gz` into `src/arodonata/api_reference/data/cp_api_index.json.gz` (with `__init__.py` so Hatchling includes it in wheels) and implement `src/arodonata/api_reference/models.py` and `src/arodonata/api_reference/engine.py` (`ApiReferenceEngine`, `get_api_reference`, `normalize_api_version`, `search_api_commands`, `describe_api_command`, `validate_api_payload`).
|
|
6
|
+
- [x] 1.2 Add unit tests in `tests/unit/test_api_reference.py` verifying lazy loading, two-step search/describe across versions (`v1.9` vs `v2.2`), batch command describe (`list[str]`), and offline payload validation (`validate_payload` for missing required fields, `field_alternatives`, enum `valid_values`, and version-specific fields), and verify `uv run pytest tests/unit/test_api_reference.py` passes.
|
|
7
|
+
|
|
8
|
+
## 2. `ArodonataClient` Facade & Package Exports
|
|
9
|
+
|
|
10
|
+
- [x] 2.1 Expose `api_reference`, `search_api_commands`, `describe_api_command`, and `validate_api_payload` on `ArodonataClient` (`src/arodonata/client.py`) with automatic target `version` resolution from `mgmt_name` settings (`api_version`), and export top-level symbols in `src/arodonata/__init__.py`.
|
|
11
|
+
- [x] 2.2 Add unit tests in `tests/unit/test_api_reference.py` verifying `ArodonataClient` automatic `api_version` inference per `mgmt_name` and fallback to `"v2.2"`, and verify `uv run pytest tests/unit/test_api_reference.py` passes.
|
|
12
|
+
|
|
13
|
+
## 3. Unified `api_reference` MCP Tool (`src/arodonata/mcp/`)
|
|
14
|
+
|
|
15
|
+
- [x] 3.1 Register the unified `api_reference(action="search" | "describe" | "validate", ...)` tool in `src/arodonata/mcp/tools.py` and update MCP prompt guidance in `src/arodonata/mcp/prompts.py`.
|
|
16
|
+
- [x] 3.2 Add MCP unit tests in `tests/unit/test_mcp_server.py` (or `tests/unit/test_api_reference.py`) covering `api_reference` tool calls (`action="search"`, `action="describe"` single and batch, `action="validate"`, and `mgmt_name` version inference), and verify `uv run pytest`, `uv run ruff check .`, and `uv run mypy src` pass.
|
|
17
|
+
|
|
18
|
+
## Workflow follow-up
|
|
19
|
+
|
|
20
|
+
- Run `/openspec-archive-change` and `/archive-task` once implementation and verification are complete.
|