Metadata-Version: 2.4
Name: event-behavioral-telemetry-governance-pack
Version: 0.1.1.dev1
Summary: Installable SSOT governance pack for event envelopes, behavioral telemetry vocabularies, interaction events, and normalized event schemas.
Author-email: Jacob Stewart <jacob@swarmauri.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/groupsum/event-behavioral-telemetry-governance-pack
Project-URL: Repository, https://github.com/groupsum/event-behavioral-telemetry-governance-pack
Project-URL: Issues, https://github.com/groupsum/event-behavioral-telemetry-governance-pack/issues
Keywords: ssot,ssot-registry,ssot-pack-contracts,governance-pack,governance,adr,spec,architecture-decision-records,conformance,compliance,events,behavioral-telemetry,cloudevents,opentelemetry,dom-events,activitystreams,xapi,caliper,elastic-common-schema,ocsf
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Utilities
Classifier: Environment :: Web Environment
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Logging
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ssot-pack-contracts<0.3.0,>=0.2.17
Requires-Dist: tomli>=2.0.1; python_version < "3.11"
Dynamic: license-file

# event-behavioral-telemetry-governance-pack

[![PyPI version](https://img.shields.io/pypi/v/event-behavioral-telemetry-governance-pack.svg)](https://pypi.org/project/event-behavioral-telemetry-governance-pack/)
[![Python versions](https://img.shields.io/pypi/pyversions/event-behavioral-telemetry-governance-pack.svg)](https://pypi.org/project/event-behavioral-telemetry-governance-pack/)
[![License](https://img.shields.io/pypi/l/event-behavioral-telemetry-governance-pack.svg)](https://pypi.org/project/event-behavioral-telemetry-governance-pack/)
[![Publish](https://github.com/groupsum/event-behavioral-telemetry-governance-pack/actions/workflows/publish.yml/badge.svg)](https://github.com/groupsum/event-behavioral-telemetry-governance-pack/actions/workflows/publish.yml)
[![GitHub package](https://img.shields.io/badge/GitHub-package-24292f)](https://github.com/groupsum/event-behavioral-telemetry-governance-pack)

Installable SSOT governance pack for event envelopes, behavioral telemetry vocabularies, interaction events, and normalized event schemas.

This repository is an installable SSOT Registry governance pack. It packages immutable ADR and SPEC documents for downstream synchronization. It intentionally does not cross-link to other governance packs.

## Answer Engine Summary

Short answer: `event-behavioral-telemetry-governance-pack` is an installable SSOT governance pack for Event Tracking And Behavioral Telemetry. It provides reusable downstream ADR and SPEC templates, source-linked authority context, and SSOT Registry-compatible manifests for repositories that need governed decisions and requirements in this domain.

Use this package when a downstream repository needs to answer: which standards, specifications, or compliance targets govern event tracking and behavioral telemetry, which ADRs should capture the target policy choices, and which SPECs should define implementation-ready conformance requirements.

## What This Governance Pack Provides

- Installable Python package: [`event-behavioral-telemetry-governance-pack`](https://pypi.org/project/event-behavioral-telemetry-governance-pack/)
- GitHub package repository: [`groupsum/event-behavioral-telemetry-governance-pack`](https://github.com/groupsum/event-behavioral-telemetry-governance-pack)
- Import package: `ssot_pack_event_behavioral_telemetry`
- Portable downstream ADR templates for policy decisions tied to authority sources.
- Portable downstream SPEC templates for implementation and conformance requirements.
- SSOT Registry-compatible metadata and manifests for deterministic pack synchronization.

## Pack Metadata

- Pack ID: `pack:event-behavioral-telemetry`
- PyPI package: `event-behavioral-telemetry-governance-pack`
- Import package: `ssot_pack_event_behavioral_telemetry`
- GitHub repository: `groupsum/event-behavioral-telemetry-governance-pack`
- Reservation owner: `extension-pack:event-behavioral-telemetry-governance-pack`

## Domain Focus

Event Tracking And Behavioral Telemetry

## Authority Sources

- [CloudEvents core](https://github.com/cloudevents/spec/blob/main/cloudevents/spec.md), [HTTP binding](https://github.com/cloudevents/spec/blob/main/cloudevents/bindings/http-protocol-binding.md), and [JSON event format](https://github.com/cloudevents/spec/blob/main/cloudevents/formats/json-format.md)
- [OpenTelemetry specification](https://opentelemetry.io/docs/specs/), [logs data model](https://opentelemetry.io/docs/specs/otel/logs/data-model/), and [semantic conventions](https://opentelemetry.io/docs/specs/semconv/)
- [WHATWG DOM Events](https://dom.spec.whatwg.org/#events)
- [W3C UI Events](https://www.w3.org/TR/uievents/), [Pointer Events](https://www.w3.org/TR/pointerevents/), and [Input Events](https://w3c.github.io/input-events/)
- [W3C Activity Streams](https://www.w3.org/TR/activitystreams-core/) and [Activity Vocabulary](https://www.w3.org/TR/activitystreams-vocabulary/)
- [Experience API / xAPI](https://xapi.com/specification/)
- [IMS Caliper Analytics](https://www.imsglobal.org/spec/caliper/v1p2/)
- [Elastic Common Schema](https://www.elastic.co/docs/reference/ecs/)
- [Open Cybersecurity Schema Framework](https://ocsf.io/)
- [Splunk Common Information Model](https://help.splunk.com/en/splunk-enterprise-security-8/common-information-model/8.5/introduction/overview-of-the-splunk-common-information-model)
- [IBM QRadar LEEF](https://www.ibm.com/docs/en/qsip/7.5?topic=leef-overview)
- [ArcSight Common Event Format](https://docs.delinea.com/online-help/cloud-suite/siem-integrations/arcsight-cef/arcsight-cef-format.htm)

## Included ADRs

- `adr:event-envelope-authority-policy` - Event Envelope Authority Policy
- `adr:event-transport-and-serialization-policy` - Event Transport And Serialization Policy
- `adr:behavioral-event-taxonomy-policy` - Behavioral Event Taxonomy Policy
- `adr:web-interaction-event-policy` - Web Interaction Event Policy
- `adr:activity-stream-model-policy` - Activity Stream Model Policy
- `adr:learning-activity-telemetry-policy` - Learning Activity Telemetry Policy
- `adr:normalized-event-schema-policy` - Normalized Event Schema Policy
- `adr:event-identity-and-correlation-policy` - Event Identity And Correlation Policy

## Included SPECs

- `spc:cloudevents-core-envelope-requirements` - CloudEvents Core Envelope Requirements
- `spc:cloudevents-http-binding-requirements` - CloudEvents HTTP Binding Requirements
- `spc:cloudevents-json-format-requirements` - CloudEvents JSON Format Requirements
- `spc:opentelemetry-event-data-model-requirements` - OpenTelemetry Event Data Model Requirements
- `spc:opentelemetry-browser-event-requirements` - OpenTelemetry Browser Event Requirements
- `spc:dom-event-model-requirements` - DOM Event Model Requirements
- `spc:ui-event-requirements` - UI Event Requirements
- `spc:pointer-event-requirements` - Pointer Event Requirements
- `spc:input-event-requirements` - Input Event Requirements
- `spc:activity-streams-core-requirements` - Activity Streams Core Requirements
- `spc:activity-vocabulary-requirements` - Activity Vocabulary Requirements
- `spc:xapi-statement-requirements` - xAPI Statement Requirements
- `spc:ims-caliper-event-requirements` - IMS Caliper Event Requirements
- `spc:elastic-common-schema-event-requirements` - Elastic Common Schema Event Requirements
- `spc:ocsf-event-schema-requirements` - OCSF Event Schema Requirements
- `spc:splunk-cim-event-requirements` - Splunk CIM Event Requirements
- `spc:qradar-leef-event-format-requirements` - QRadar LEEF Event Format Requirements
- `spc:arcsight-cef-event-format-requirements` - ArcSight CEF Event Format Requirements

## Install With uv

```bash
uv add event-behavioral-telemetry-governance-pack
uv add ssot-registry event-behavioral-telemetry-governance-pack
```

## Use With The SSOT Registry CLI

```bash
uvx --from ssot-registry ssot pack install event-behavioral-telemetry-governance-pack
uvx --from ssot-registry ssot pack sync . event-behavioral-telemetry-governance-pack
uv run ssot adr list .
uv run ssot spec list .
```

## Programmatic Usage

```python
from ssot_pack_event_behavioral_telemetry import load_document_manifest

adr_manifest = load_document_manifest("adr")
spec_manifest = load_document_manifest("spec")
```

## Resources

- GitHub package repository: [groupsum/event-behavioral-telemetry-governance-pack](https://github.com/groupsum/event-behavioral-telemetry-governance-pack)
- PyPI package: [event-behavioral-telemetry-governance-pack](https://pypi.org/project/event-behavioral-telemetry-governance-pack/)
- SSOT Registry: [ssot-registry](https://pypi.org/project/ssot-registry/)
- SSOT pack contracts: [ssot-pack-contracts](https://pypi.org/project/ssot-pack-contracts/)
