Skip to content

[Change] Enterprise Policy Resolution Extension #527

@djm81

Description

@djm81

Why

SpecFact already resolves local policy from flags, project config, and profiles, but the enterprise tier needs two higher-priority layers for centrally pushed rules. This change adds those layers without altering the free-tier local-first experience.

What Changes

  • NEW: enterprise-policy-resolution capability adding org-mandatory and team-advisory layers above the existing local resolution chain.
  • NEW: Signed metadata fields for pushed rules (mandatory, override_allowed, effective_from, pushed_by, signed_by).
  • NEW: Client-side resolution behavior that gracefully no-ops when no enterprise policy source is configured.
  • EXTEND: Profile and policy resolution docs to describe enterprise precedence.
  • EXTEND: Future budget and audit flows so they can depend on a common resolution contract.

Acceptance Criteria

  • OpenSpec contracts for enterprise-01-policy-resolution-extension are complete and remain strict-validate clean.
  • The enterprise policy resolution extension 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 existing local resolution patterns from profile-01-config-layering and policy-engine.
  • Supplies the contract reused by all later enterprise changes and module-side policy clients.
  • Free-tier behavior remains unchanged when no enterprise adapter is configured.

Capability Notes

New Capabilities

  • enterprise-policy-resolution: Enterprise resolution-chain layers and signed pushed-rule metadata.

Modified Capabilities

  • profile-config-layering: Extend profile/config resolution so enterprise layers can precede project and profile values.

OpenSpec Change Proposal: enterprise-01-policy-resolution-extension

Metadata

Metadata

Assignees

No one assigned

    Labels

    change-proposalProposal for a new changeenhancementNew feature or requestenterpriseEnterprise governance, audit, and chargebackopenspec

    Projects

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions