# 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*