# Collective Unconscious Mapping

Collective unconscious maps trace archetypal activity emerging across global
dream fields, mythic narratives, and cultural rituals. Each blueprint identifies
how symbols propagate, where shadow dynamics surface, and which guardians
steward the integration process.

## API Endpoints

- `GET /v1/consciousness/collective-unconscious` — Catalogue of archetypal
  clusters with resonance windows, dominant symbols, and shadow dynamics.
- `GET /v1/consciousness/collective-unconscious/{slug}` — Detailed map including
  cartography layers, cultural signatures, field research methodologies, and
  integration protocols.

The BFF mirrors these responses and provides a parity fallback dataset so
clients remain responsive even if the content service is offline. Observability
headers (`x-correlation-id`, `x-trace-id`, etc.) propagate through both primary
and fallback paths.

## Blueprint Anatomy

Collective unconscious map details include:

- **Cartography Layers**: Multi-dimensional visualizations (mythic imaginal,
  neuro-phenomenological, shadow ecology) showing how archetypes surface.
- **Shadow Dynamics**: Patterns, trigger signals, and suggested integration
  practices to alchemize collective projections.
- **Resonance Peaks**: Time windows (new moon, eclipses, equinox thresholds)
  with resonance scores and recurring symbol clusters.
- **Cultural Signatures**: Mythic references and modern expressions that
  illustrate cross-cultural embodiments of the archetype field.
- **Integration Protocols**: Journaling prompts, somatic rituals, community
  practices, and protective measures that keep facilitators and participants
  grounded.
- **Field Research Toolkit**: Biometric, qualitative, dreamwork, and analytics
  instruments used by research councils to validate collective data.

## SDK Usage

```ts
const client = new APIClient({ baseUrl, token });
const catalogue = await client.listCollectiveUnconsciousMaps();
const detail = await client.getCollectiveUnconsciousMap('dream-weavers-atlas');
```

Both helpers forward authentication headers and raise structured errors if a map
slug is unknown or the upstream service is unavailable.
