8c6e7831e9
Major additions: - marketplace/: Agent template registry with FTS5 search, ratings, versioning - observability/: Prometheus metrics, distributed tracing, structured logging - ledger/migrations/: Database migration scripts for multi-tenant support - tests/governance/: 15 new test files for phases 6-12 (295 total tests) - bin/validate-phases: Full 12-phase validation script New features: - Multi-tenant support with tenant isolation and quota enforcement - Agent marketplace with semantic versioning and search - Observability with metrics, tracing, and log correlation - Tier-1 agent bootstrap scripts Updated components: - ledger/api.py: Extended API for tenants, marketplace, observability - ledger/schema.sql: Added tenant, project, marketplace tables - testing/framework.ts: Enhanced test framework - checkpoint/checkpoint.py: Improved checkpoint management Archived: - External integrations (Slack/GitHub/PagerDuty) moved to .archive/ - Old checkpoint files cleaned up Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
# Integrations
|
|
|
|
> Integration framework for external services (extensible, minimal footprint)
|
|
|
|
## Overview
|
|
|
|
This module provides base infrastructure for integrating with external services. Specific integrations (Slack, GitHub, PagerDuty) have been **deprecated** - they were not in active use and created phantom dependencies.
|
|
|
|
## Active Components
|
|
|
|
| Component | Description |
|
|
|-----------|-------------|
|
|
| `common/base.py` | BaseIntegration abstract class, IntegrationManager |
|
|
| `common/secrets.py` | SecretsManager for Vault/environment credentials |
|
|
| `common/redis_config.py` | DragonflyDB connection configuration |
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
integrations/
|
|
├── __init__.py # Module exports
|
|
├── common/
|
|
│ ├── base.py # BaseIntegration, IntegrationManager
|
|
│ ├── secrets.py # SecretsManager for Vault/env credentials
|
|
│ └── redis_config.py # Redis/DragonflyDB configuration
|
|
└── README.md
|
|
```
|
|
|
|
## Deprecated (Archived)
|
|
|
|
The following were moved to `.archive/integrations/`:
|
|
- `slack/` - Slack webhook/bot integration
|
|
- `github/` - GitHub webhook/PR integration
|
|
- `pagerduty/` - PagerDuty incident integration
|
|
|
|
Tests archived to `.archive/tests/`:
|
|
- `test_phase8_integrations.py`
|
|
- `test_phase9_integrations.py`
|
|
|
|
### Why Deprecated
|
|
|
|
- Not required for core governance functionality
|
|
- Created phantom dependencies blocking project completion
|
|
- Unused code paths = unnecessary attack surface
|
|
- Can be restored from `.archive/` if needed
|
|
|
|
## Usage
|
|
|
|
```python
|
|
from integrations.common.secrets import SecretsManager
|
|
from integrations.common.base import BaseIntegration, IntegrationEvent
|
|
|
|
# SecretsManager for credential access
|
|
secrets = SecretsManager()
|
|
api_key = secrets.get_secret("my_service", "api_key")
|
|
|
|
# Extend BaseIntegration for new services
|
|
class MyIntegration(BaseIntegration):
|
|
def test_connection(self) -> bool:
|
|
return True
|
|
|
|
def send_event(self, event: IntegrationEvent) -> bool:
|
|
# Implementation
|
|
pass
|
|
```
|
|
|
|
## Restoring Deprecated Integrations
|
|
|
|
If external integrations become needed:
|
|
|
|
```bash
|
|
# Restore from archive
|
|
mv .archive/integrations/slack integrations/
|
|
mv .archive/integrations/github integrations/
|
|
mv .archive/integrations/pagerduty integrations/
|
|
mv .archive/tests/test_phase*_integrations.py tests/governance/
|
|
|
|
# Set up credentials (see docs/CREDENTIALS_SETUP.md)
|
|
```
|
|
|
|
## Status
|
|
|
|
**Complete** - Framework operational, external services deprecated.
|
|
|
|
See [STATUS.md](./STATUS.md) for details.
|
|
|
|
---
|
|
*Last updated: 2026-01-24 UTC*
|