mirror of
https://github.com/hanzoai/insights.git
synced 2026-11-02 14:32:45 +00:00
zeekay
1b367e2b62
The tree was a debranded snapshot of upstream taken around 2026-02-20, and upstream has moved about five months since. This replaces it with upstream master, mechanically re-derived: bin/debrand does the rename, and the pipeline and squashed migrations are restored from the shipped tree. Not a merge. The previous import replaced the tree wholesale in a single commit, so there is no shared content history to merge against. Reproducing the rename on the new tree is what actually converges. What survives: .hanzo/workflows, the Dockerfiles and bin/docker* entrypoints, compose files, LLM.md, and insights/migrations. The squashed initial migration is load-bearing — the live database records it by name, so upstream's ~918 individual migrations cannot come back. Nine products are dropped as unreferenced. Twenty-one more that we do not run are kept anyway because the core app still imports them; unpicking those is a refactor and does not belong in a rebase. This base does not build yet, and the reasons are not in the rename: upstream now wants Python 3.13.13 against our 3.12.12 and Django 5.2 against our 4.2, and the dependency manifests still name upstream packages that we republish under our own names. Those are decisions, not renames.
549 lines
33 KiB
JSON
549 lines
33 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"properties": {
|
|
"active": {
|
|
"description": "Whether the feature flag is active.",
|
|
"type": "boolean"
|
|
},
|
|
"bucketing_identifier": {
|
|
"anyOf": [
|
|
{
|
|
"description": "* `distinct_id` - User ID (default)\n* `device_id` - Device ID",
|
|
"enum": ["distinct_id", "device_id"],
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Identifier used to bucket users into rollout percentages and variants — `distinct_id` (user ID, the default) or `device_id`. Using `device_id` is incompatible with `ensure_experience_continuity=true`."
|
|
},
|
|
"ensure_experience_continuity": {
|
|
"anyOf": [
|
|
{
|
|
"type": "boolean"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Whether to persist the flag's value for a user across the anonymous-to-identified transition (the \"persist across authentication steps\" option in the UI). Keeps a user's evaluated value stable once they log in. Incompatible with `device_id` bucketing."
|
|
},
|
|
"evaluation_contexts": {
|
|
"description": "Evaluation contexts that control where this flag evaluates at runtime.",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"evaluation_runtime": {
|
|
"anyOf": [
|
|
{
|
|
"description": "* `server` - Server\n* `client` - Client\n* `all` - All",
|
|
"enum": ["server", "client", "all"],
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Where this flag is allowed to evaluate — `server` (server-side SDKs only), `client` (client-side SDKs only), or `all` (both). Defaults to `all`."
|
|
},
|
|
"filters": {
|
|
"description": "Feature flag targeting configuration.",
|
|
"properties": {
|
|
"aggregation_group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index for group-based feature flags."
|
|
},
|
|
"early_exit": {
|
|
"default": false,
|
|
"description": "When true, condition evaluation stops at the first matching condition set rather than continuing to evaluate subsequent groups.",
|
|
"type": "boolean"
|
|
},
|
|
"feature_enrollment": {
|
|
"anyOf": [
|
|
{
|
|
"type": "boolean"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Whether this flag has early access feature enrollment enabled. When true, the flag is evaluated against the person property $feature_enrollment/{flag_key}."
|
|
},
|
|
"groups": {
|
|
"description": "Release condition groups for the feature flag.",
|
|
"items": {
|
|
"properties": {
|
|
"aggregation_group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index for this condition set. None means person-level aggregation."
|
|
},
|
|
"properties": {
|
|
"description": "Property conditions for this release condition group.",
|
|
"items": {
|
|
"anyOf": [
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Operator used to compare the property value.\n\n* `exact` - exact\n* `is_not` - is_not\n* `icontains` - icontains\n* `not_icontains` - not_icontains\n* `starts_with` - starts_with\n* `not_starts_with` - not_starts_with\n* `ends_with` - ends_with\n* `not_ends_with` - not_ends_with\n* `regex` - regex\n* `not_regex` - not_regex\n* `gt` - gt\n* `gte` - gte\n* `lt` - lt\n* `lte` - lte",
|
|
"enum": [
|
|
"exact",
|
|
"is_not",
|
|
"icontains",
|
|
"not_icontains",
|
|
"starts_with",
|
|
"not_starts_with",
|
|
"ends_with",
|
|
"not_ends_with",
|
|
"regex",
|
|
"not_regex",
|
|
"gt",
|
|
"gte",
|
|
"lt",
|
|
"lte"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Property filter type. Common values are 'person' and 'cohort'.\n\n* `cohort` - cohort\n* `person` - person\n* `group` - group",
|
|
"enum": ["cohort", "person", "group"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "Comparison value for the property filter. Supports strings, numbers, booleans, and arrays."
|
|
}
|
|
},
|
|
"required": ["key", "value", "operator"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Existence operator.\n\n* `is_set` - is_set\n* `is_not_set` - is_not_set",
|
|
"enum": ["is_set", "is_not_set"],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Property filter type. Common values are 'person' and 'cohort'.\n\n* `cohort` - cohort\n* `person` - person\n* `group` - group",
|
|
"enum": ["cohort", "person", "group"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "Optional value. Runtime behavior determines whether this is ignored."
|
|
}
|
|
},
|
|
"required": ["key", "operator"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Date comparison operator.\n\n* `is_date_exact` - is_date_exact\n* `is_date_after` - is_date_after\n* `is_date_before` - is_date_before",
|
|
"enum": ["is_date_exact", "is_date_before", "is_date_after"],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Property filter type. Common values are 'person' and 'cohort'.\n\n* `cohort` - cohort\n* `person` - person\n* `group` - group",
|
|
"enum": ["cohort", "person", "group"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "Date value in ISO format or relative date expression.",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": ["key", "operator", "value"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Semantic version comparison operator.\n\n* `semver_gt` - semver_gt\n* `semver_gte` - semver_gte\n* `semver_lt` - semver_lt\n* `semver_lte` - semver_lte\n* `semver_eq` - semver_eq\n* `semver_neq` - semver_neq\n* `semver_tilde` - semver_tilde\n* `semver_caret` - semver_caret\n* `semver_wildcard` - semver_wildcard",
|
|
"enum": [
|
|
"semver_gt",
|
|
"semver_gte",
|
|
"semver_lt",
|
|
"semver_lte",
|
|
"semver_eq",
|
|
"semver_neq",
|
|
"semver_tilde",
|
|
"semver_caret",
|
|
"semver_wildcard"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Property filter type. Common values are 'person' and 'cohort'.\n\n* `cohort` - cohort\n* `person` - person\n* `group` - group",
|
|
"enum": ["cohort", "person", "group"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "Semantic version string.",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": ["key", "operator", "value"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Multi-contains operator.\n\n* `icontains_multi` - icontains_multi\n* `not_icontains_multi` - not_icontains_multi",
|
|
"enum": ["icontains_multi", "not_icontains_multi"],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Property filter type. Common values are 'person' and 'cohort'.\n\n* `cohort` - cohort\n* `person` - person\n* `group` - group",
|
|
"enum": ["cohort", "person", "group"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "List of strings to evaluate against.",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": ["key", "operator", "value"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Membership operator for cohort properties.\n\n* `in` - in\n* `not_in` - not_in",
|
|
"enum": ["in", "not_in"],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Cohort property type required for in/not_in operators.\n\n* `cohort` - cohort",
|
|
"enum": ["cohort"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "Cohort comparison value (single or list, depending on usage)."
|
|
}
|
|
},
|
|
"required": ["key", "type", "operator", "value"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"properties": {
|
|
"cohort_name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Resolved cohort name for cohort-type filters."
|
|
},
|
|
"group_type_index": {
|
|
"anyOf": [
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Group type index when using group-based filters."
|
|
},
|
|
"key": {
|
|
"description": "Property key used in this feature flag condition.",
|
|
"type": "string"
|
|
},
|
|
"operator": {
|
|
"description": "Operator for feature flag dependency evaluation.\n\n* `flag_evaluates_to` - flag_evaluates_to",
|
|
"enum": ["flag_evaluates_to"],
|
|
"type": "string"
|
|
},
|
|
"type": {
|
|
"description": "Flag property type required for flag dependency checks.\n\n* `flag` - flag",
|
|
"enum": ["flag"],
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"description": "Value to compare flag evaluation against."
|
|
}
|
|
},
|
|
"required": ["key", "type", "operator", "value"],
|
|
"type": "object"
|
|
}
|
|
]
|
|
},
|
|
"type": "array"
|
|
},
|
|
"rollout_percentage": {
|
|
"description": "Rollout percentage for this release condition group.",
|
|
"type": "number"
|
|
},
|
|
"variant": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Variant key override for multivariate flags."
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"multivariate": {
|
|
"anyOf": [
|
|
{
|
|
"properties": {
|
|
"variants": {
|
|
"description": "Variant definitions for multivariate feature flags.",
|
|
"items": {
|
|
"properties": {
|
|
"key": {
|
|
"description": "Unique key for this variant.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "Human-readable name for this variant.",
|
|
"type": "string"
|
|
},
|
|
"rollout_percentage": {
|
|
"description": "Variant rollout percentage.",
|
|
"type": "number"
|
|
}
|
|
},
|
|
"required": ["key", "rollout_percentage"],
|
|
"type": "object"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": ["variants"],
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Multivariate configuration for variant-based rollouts."
|
|
},
|
|
"payloads": {
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"description": "Optional payload values keyed by variant key.",
|
|
"propertyNames": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"is_remote_configuration": {
|
|
"anyOf": [
|
|
{
|
|
"type": "boolean"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"description": "Whether this flag delivers a payload instead of gating a feature (Remote Config mode). When true, set the delivered payload through the `filters` param under `filters.payloads.true` as a JSON-encoded string. There is no dedicated payload parameter."
|
|
},
|
|
"key": {
|
|
"description": "Feature flag key.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "Feature flag description (stored in the `name` field for backwards compatibility).",
|
|
"type": "string"
|
|
},
|
|
"tags": {
|
|
"description": "Organizational tags for this feature flag.",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"type": "object"
|
|
}
|