{"slug":"strategy/business-strategy/31-evolution-strategy","title":"31 — Evolution Strategy","section":"strategy","sectionLabel":"Strategy","status":"unclassified","type":"document","path":"strategy/business-strategy/31-evolution-strategy.mdx","bytes":2190,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n> **Extracted from:** IntegrateWise Platform Specification Suite\n> **Region:** third_region\n> **Original line:** 3460\n> **Lines:** 36 | **Chars:** 1,914\n> **Status:** Raw extraction — requires review and canonicalization\n\n31 — Evolution Strategy\n31.1 Responsibilities\nDefine safe evolution of Schema, Capability, Connector, Persona, API, Memory, and Migration strategy.\n31.2 Evolution areas\nArea Reference Strategy\nSchema 12 + 02 additive-first; bump schema_version; reversible\nCapability 05 new cap_id per major change; deprecate old by status\nConnector 08 version bump; certified path; admin opt-in for breaking changes\nPersona (existing spec, 12×11) new sub-role or industry requires Steering Committee\nAPI 19 URI versioning; 6-mo deprecation; parallel-run\nMemory 07 versioning of pipeline layer logic; data is append-only\nMigration 15.4 + 21 reversible; dry-run; bump schema_version\n31.3 Inputs\nSchema change PRs, Capability change PRs, authored Connector changes.\nAdmin-initiated migrations.\n31.4 Outputs\nRollout plan + flag flips (15.3).\nMigration artifact (id, scope, dry-run result, reversal procedure).\n31.5 Events produced\nEvolutionStarted, EvolutionFlagged, EvolutionRolledBack, EvolutionCompleted, SchemaVersionBumped, CapabilityDeprecated, ConnectorDeprecated, ApiDeprecated, MemoryLayerDeprecated.\n31.6 Events consumed\nCapabilityRegistered, CapabilityDeprecated, ConnectorInstalled, ConnectorRetired, SchemaVersionBumped.\n31.7 APIs\nPOST /evolution/migrations, POST /evolution/migrations/{mig_id}/dry-run, POST /evolution/migrations/{mig_id}/apply, POST /evolution/migrations/{mig_id}/rollback.\n31.8 State transitions\ndraft → tested → dark_launch → canary → progressive → stable → deprecated → removed.\n\n31.9 Principles\nAdditive-first, never destructive by default.\nEvery deprecation publishes a Sun-Set banner 6 months in advance (19.1).\nBackwards compatibility is preserved for ≥ 1 prior schema_version.\n31.10 Failure handling\nDark launch metric regression → automatic flag rollback.\nMigration apply failure → automated reversal; admin notified.\n31.11 Extension points\nNew evolution channels via EVOLUTION_CHANNEL(name).\n"}