Skip to content

[Change] Enterprise Aggregation and Drift Analytics #529

@djm81

Description

@djm81

Why

Enterprise governance should learn across teams without flattening all local context into one generic ruleset. This change defines how client-side learning contributions and drift metrics are aggregated so organizations can spot stale rules, overused overrides, and repeat patterns.

What Changes

  • NEW: enterprise-drift-analytics capability defining aggregation payloads, contribution flags, and drift metrics.
  • NEW: contribute-to-org metadata so local learnings can opt into enterprise aggregation.
  • NEW: Drift metrics for override rate, stale distillation cycles, cross-team pattern reuse, and unresolved rule churn.
  • EXTEND: Enterprise audit and knowledge flows so promotions and overrides can be measured at the organization level.
  • EXTEND: Enterprise evidence/reporting surfaces so drift analytics can be published back into local review and planning loops.

Acceptance Criteria

  • OpenSpec contracts for enterprise-03-aggregation-and-drift-analytics are complete and remain strict-validate clean.
  • The enterprise aggregation and drift analytics scope is wired to its declared parent feature and dependent follow-up surfaces.
  • No undocumented breaking change is introduced into existing review, policy, telemetry, or enterprise flows.

Dependencies

Additional Context

  • Depends on knowledge-01-distillation-engine, enterprise-02-rbac-and-audit-trail, and knowledge-02-preflight-context-assembly.
  • Supplies the contract reused by future enterprise dashboards and analytics backends.
  • Free-tier users are unaffected unless enterprise aggregation is explicitly configured.

Capability Notes

New Capabilities

  • enterprise-drift-analytics: Aggregation payloads, contribution flags, and drift metrics for enterprise learning.

Modified Capabilities

  • enterprise-audit-trail: Extend audit events so drift analytics can correlate promotions, overrides, and approvals.

OpenSpec Change Proposal: enterprise-03-aggregation-and-drift-analytics

Metadata

Metadata

Assignees

No one assigned

    Labels

    change-proposalProposal for a new changeenhancementNew feature or requestenterpriseEnterprise governance, audit, and chargebackknowledgeKnowledge distillation and authoring contextopenspec

    Projects

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions