feat: add tier and organizationId fields to dynamic policy types (#76)

* feat: add tier and organizationId fields to dynamic policy types

Add PolicyTier and organizationId support to DynamicPolicy and
CreateDynamicPolicyRequest to enable tiered policy scoping (system,
organization, tenant) for multi-tenant policy management.

* docs: add 3.2.0 changelog and bump version for tier field on dynamic policy requests

* fix: address code review issues for dynamic policy tier field

- Add tier and organizationId to UpdateDynamicPolicyRequest
- Add tier and organizationId filters to ListDynamicPoliciesOptions
- Update listDynamicPolicies to pass tier/org_id query params
- Add Javadoc to CreateDynamicPolicyRequest builder methods

* chore: align changelog format with cross-SDK conventions

Author: saurabhjain1592

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to the AxonFlow Java SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.0] - 2026-02-05
+
+### Added
+
+- **Dynamic policy tier support**: `tier` (`PolicyTier`) and `organizationId` fields on `CreateDynamicPolicyRequest`, `UpdateDynamicPolicyRequest`, and `DynamicPolicy` response. Defaults to `PolicyTier.TENANT` when not specified. Builder: `.tier(PolicyTier.ORGANIZATION).organizationId("org-123")`.
+- **`ListDynamicPoliciesOptions` filters**: Filter dynamic policies by `tier` and `organizationId`, matching `ListStaticPoliciesOptions` parity.
+
+---
+
 ## [3.1.0] - 2026-02-04
 
 ### Changed

README.md

@@ -45,14 +45,14 @@ If you're new to AxonFlow, this short video shows how the control plane and SDKs
 <dependency>
     <groupId>com.getaxonflow</groupId>
     <artifactId>axonflow-sdk</artifactId>
-    <version>3.1.0</version>
+    <version>3.2.0</version>
 </dependency>
 ```
 
 ### Gradle
 
 ```groovy
-implementation 'com.getaxonflow:axonflow-sdk:3.1.0'
+implementation 'com.getaxonflow:axonflow-sdk:3.2.0'
 ```
 
 ## Quick Start

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.getaxonflow</groupId>
     <artifactId>axonflow-sdk</artifactId>
-    <version>3.1.0</version>
+    <version>3.2.0</version>
     <packaging>jar</packaging>
 
     <name>AxonFlow Java SDK</name>

src/main/java/com/getaxonflow/sdk/AxonFlow.java

@@ -1877,6 +1877,12 @@ private String buildDynamicPolicyQueryString(String basePath, ListDynamicPolicie
         if (options.getType() != null) {
             appendQueryParam(query, "type", options.getType());
         }
+        if (options.getTier() != null) {
+            appendQueryParam(query, "tier", options.getTier().getValue());
+        }
+        if (options.getOrganizationId() != null) {
+            appendQueryParam(query, "organization_id", options.getOrganizationId());
+        }
         if (options.getEnabled() != null) {
             appendQueryParam(query, "enabled", options.getEnabled().toString());
         }

src/main/java/com/getaxonflow/sdk/types/policies/PolicyTypes.java

@@ -631,6 +631,9 @@ public static class DynamicPolicy {
         private String description;
         private String type;  // "risk", "content", "user", "cost"
         private String category;  // "dynamic-risk", "dynamic-compliance", etc.
+        private PolicyTier tier;
+        @JsonProperty("organization_id")
+        private String organizationId;
         private List<DynamicPolicyCondition> conditions;
         private List<DynamicPolicyAction> actions;
         private int priority;
@@ -651,6 +654,10 @@ public static class DynamicPolicy {
         public void setType(String type) { this.type = type; }
         public String getCategory() { return category; }
         public void setCategory(String category) { this.category = category; }
+        public PolicyTier getTier() { return tier; }
+        public void setTier(PolicyTier tier) { this.tier = tier; }
+        public String getOrganizationId() { return organizationId; }
+        public void setOrganizationId(String organizationId) { this.organizationId = organizationId; }
         public List<DynamicPolicyCondition> getConditions() { return conditions; }
         public void setConditions(List<DynamicPolicyCondition> conditions) { this.conditions = conditions; }
         public List<DynamicPolicyAction> getActions() { return actions; }
@@ -670,6 +677,8 @@ public static class DynamicPolicy {
      */
     public static class ListDynamicPoliciesOptions {
         private String type;  // Filter by policy type: "risk", "content", "user", "cost"
+        private PolicyTier tier;
+        private String organizationId;
         private Boolean enabled;
         private Integer limit;
         private Integer offset;
@@ -682,6 +691,8 @@ public static Builder builder() {
         }
 
         public String getType() { return type; }
+        public PolicyTier getTier() { return tier; }
+        public String getOrganizationId() { return organizationId; }
         public Boolean getEnabled() { return enabled; }
         public Integer getLimit() { return limit; }
         public Integer getOffset() { return offset; }
@@ -703,6 +714,28 @@ public Builder type(String type) {
                 return this;
             }
 
+            /**
+             * Filters policies by tier.
+             *
+             * @param tier the policy tier
+             * @return this builder
+             */
+            public Builder tier(PolicyTier tier) {
+                options.tier = tier;
+                return this;
+            }
+
+            /**
+             * Filters policies by organization ID (Enterprise).
+             *
+             * @param organizationId the organization ID
+             * @return this builder
+             */
+            public Builder organizationId(String organizationId) {
+                options.organizationId = organizationId;
+                return this;
+            }
+
             public Builder enabled(Boolean enabled) {
                 options.enabled = enabled;
                 return this;
@@ -754,6 +787,9 @@ public static class CreateDynamicPolicyRequest {
         private String description;
         private String type;  // "risk", "content", "user", "cost"
         private String category;  // "dynamic-risk", "dynamic-compliance", etc.
+        private PolicyTier tier = PolicyTier.TENANT;
+        @JsonProperty("organization_id")
+        private String organizationId;
         private List<DynamicPolicyCondition> conditions;
         private List<DynamicPolicyAction> actions;
         private int priority;
@@ -767,6 +803,8 @@ public static Builder builder() {
         public String getDescription() { return description; }
         public String getType() { return type; }
         public String getCategory() { return category; }
+        public PolicyTier getTier() { return tier; }
+        public String getOrganizationId() { return organizationId; }
         public List<DynamicPolicyCondition> getConditions() { return conditions; }
         public List<DynamicPolicyAction> getActions() { return actions; }
         public int getPriority() { return priority; }
@@ -808,6 +846,28 @@ public Builder category(String category) {
                 return this;
             }
 
+            /**
+             * Sets the policy tier. Defaults to {@link PolicyTier#TENANT}.
+             *
+             * @param tier the policy tier
+             * @return this builder
+             */
+            public Builder tier(PolicyTier tier) {
+                request.tier = tier;
+                return this;
+            }
+
+            /**
+             * Sets the organization ID for organization-tier policies (Enterprise).
+             *
+             * @param organizationId the organization ID
+             * @return this builder
+             */
+            public Builder organizationId(String organizationId) {
+                request.organizationId = organizationId;
+                return this;
+            }
+
             public Builder conditions(List<DynamicPolicyCondition> conditions) {
                 request.conditions = conditions;
                 return this;
@@ -849,6 +909,9 @@ public static class UpdateDynamicPolicyRequest {
         private String description;
         private String type;
         private String category;
+        private PolicyTier tier;
+        @JsonProperty("organization_id")
+        private String organizationId;
         private List<DynamicPolicyCondition> conditions;
         private List<DynamicPolicyAction> actions;
         private Integer priority;
@@ -862,6 +925,8 @@ public static Builder builder() {
         public String getDescription() { return description; }
         public String getType() { return type; }
         public String getCategory() { return category; }
+        public PolicyTier getTier() { return tier; }
+        public String getOrganizationId() { return organizationId; }
         public List<DynamicPolicyCondition> getConditions() { return conditions; }
         public List<DynamicPolicyAction> getActions() { return actions; }
         public Integer getPriority() { return priority; }
@@ -896,6 +961,28 @@ public Builder category(String category) {
                 return this;
             }
 
+            /**
+             * Sets the policy tier.
+             *
+             * @param tier the policy tier
+             * @return this builder
+             */
+            public Builder tier(PolicyTier tier) {
+                request.tier = tier;
+                return this;
+            }
+
+            /**
+             * Sets the organization ID for organization-tier policies (Enterprise).
+             *
+             * @param organizationId the organization ID
+             * @return this builder
+             */
+            public Builder organizationId(String organizationId) {
+                request.organizationId = organizationId;
+                return this;
+            }
+
             public Builder conditions(List<DynamicPolicyCondition> conditions) {
                 request.conditions = conditions;
                 return this;