Changelog #

All notable changes to cell_flow are documented in this file.

The format follows Keep a Changelog. Version numbers follow SemVer. Mitosis is the release codename; it is not part of the SemVer string.

[Mitosis (1.0.0-rc.6)] - Release Candidate #

Pub.dev WASM-compatibility release. No public API changes.

Fixed #

• WASM compatibility: Removed the unconditional dart:io dependency from the AI tissue-command domain by moving HttpInterpreter, AiConfig.fromJsonFile, and the live-demo environment lookup behind conditional imports (ai_tissue_command_domain_io.dart on native, ai_tissue_command_domain_stub.dart on web/WASM). The package now compiles to WebAssembly (dart compile wasm).

[Mitosis (1.0.0-rc.5)] - Release Candidate #

Pub.dev score remediation release. No public API changes.

Fixed #

• Dependency alignment: Tightened the cell constraint to ^1.0.0-rc.5.
• License detection: Replaced the custom dual-license notice with the canonical MIT and Apache-2.0 texts so pub.flutter-io.cn recognizes the OSI-approved license.
• Example detection: Added example/cell_flow_example.dart — a runnable quick start matching pub.flutter-io.cn's example file conventions.

Mitosis (1.0.0-rc.4) - Release Candidate #

This release introduces the AI Command Infrastructure, establishing a forensic gateway for AI-orchestrated state mutations. It aligns the orchestration topography with machine-driven logic while maintaining strict administrative oversight and causal integrity.

Added #

• AI Command Topography: Materialized the foundational infrastructure for AI-driven state evolution within the flow layer:
  • ai_tissue_command.dart: The command gateway implementation. It handles the execution of AI-generated instructions through governed apply and dispatch mechanics, ensuring transactions remain isolated and compensable.
  • ai_tissue_command_domain.dart: Formalized the forensic domain for machine commands. Defines the high-level interfaces for command schemas, authority tiers, and administrative mandates.
• AI Command Verification:
  • ai_tissue_command_test.dart: Exhaustive test suite for the new command infrastructure. Verifies that AI-generated pulses correctly inherit Context anchors and that the forensic Pulse.trace accurately captures machine-initiated mutations.
• Causal AI Anchoring: Integrated AI commands with the framework's Tiered Resolution Strategy, ensuring that machine-tier operations respect the administrative boundaries defined in the core layer.

Changed #

• Monorepo Synchronization: Aligned cell_flow with the core cell (1.0.0-rc.4) release, ensuring all orchestration operators support the refined Lifecycle Governance and Apoptosis (programmed cell death) mechanics.
• Orchestration Pedagogy: Updated the operator documentation to explicitly link how AI-orchestrated stimuli flow through terminal sinks and reactive aggregators.

Fixed #

• Dependency Scoping: Resolved linter warnings related to machine-tier examples by refining the dev_dependencies manifest to ensure forensic demos possess local workspace parity.

Tests #

• 1051 unit tests in 45 files, 465 groups (+13 tests for AI Command gateways).
• Last full run: +1051, exit 0.
• Line coverage (lib/): 96.9% (+0.1% improvement in command gateway edge-cases).

Mitosis (1.0.0-rc.3) - Release Candidate #

This release formalizes Topographical Integrity and Forensic Traceability within the orchestration layer, ensuring that causal anchors are preserved across complex asynchronous transformations and operator chains.

Added #

• Causal Anchor Propagation: Updated FlowInstruction and FlowHandle to respect the refined Context system. Orchestrators now maintain the forensic lineage of a Pulse as it traverses the topography, ensuring downstream observers can verify the original administrative authority.

Changed #

• Workspace Governance: Migrated to resolution: workspace. Removed manual dependency_overrides for local package links in pubspec.yaml, aligning with Dart's modern monorepo standards and resolving build conflicts in Melos environments.
• Pedagogical KDocs: Regenerated public API documentation for all operators using the forensic standard (### When to use, ### How it works, ### Non‑obvious).
• Metadata Standardization: Synchronized pubspec.yaml metadata, including repository, issue_tracker, and platform support declarations, to ensure high-integrity discovery on pub.flutter-io.cn.

Fixed #

• Trace Integrity: Resolved a specialized case where the Pulse.trace could be fragmented or lost during high-frequency Debounce or Throttle operations.
• Documentation Hygiene: Fixed unresolved doc references to generic type parameters [C] and inherited references to [Tissue] across the operator family.

Tests #

• 1038 unit tests in 44 files, 452 groups (+13 tests covering context propagation and workspace resolution).
• Last full run: +1038, exit 0.
• Line coverage (lib/): 96.8% (+0.3% improvement in operator edge-cases).

Mitosis (1.0.0-rc.2.0.2) - Release Candidate #

Patch focused on topographical integrity, path hygiene, and guidance expansion.

Fixed #

• Path Hygiene: Repaired a malformed Synapse (import URL) in test/merge_test.dart that utilized an invalid double-slash (//) syntax, resolving a terminal ingress error during pub publish.
• Topographical Anchor Resolution: Fixed a dartdoc warning in fluent_operator.dart where [FlowHandle.cell] failed to resolve; updated documentation to explicitly reference the Anchor Node via the cell record field.
• Asynchronous Pulse Materialization: Resolved an unresolved [result] reference in the FlowInstructionBase.future constructor by standardizing on the term Evolved Pulse.

Added #

• Pedagogical Guidance: Materialized the HowTo-Start.md guide, providing a comprehensive "Transcription Orchestrator" walkthrough for developers to grasp Stimulus, Pulse, and Evolution mechanics.
• Blueprint Templates: Expanded the README.md with a structured table of Topographical Walkthroughs, linking clinical and search demos to their respective architectural patterns.

Tests #

• 1025 unit tests in 42 files, 442 groups (+3 tests covering path resolution).
• Last full run: +1025, exit 0.
• Line coverage (lib/): 96.5% (+0.2% improvement in edge-case error paths).

Mitosis (1.0.0-rc.2.0.1) - Release Candidate #

Patch on the RC2 line. This release focuses on architectural documentation, topographical terminology alignment, and library hygiene.

Changed #

• Pedagogical Alignment: Regenerated all public API documentation across flow_core.dart, fluent_operator.dart, and the instruction/ family using the Transcription Orchestrator style.
• Topographical Terminology: Standardized terminology throughout the library. Documentation now formally refers to the graph as the Topography, inputs as Stimuli, event containers as Pulses, transformations as Evolutions, and results as Materializations.
• Orchestration Roles: Refined documentation for specific logic gates to clarify their role in the topography:
  • Bridges: Temporal operators governing shift and cadence (Delay, Interval).
  • Gates: Integrity and control operators (Filter, Debounce, Timeout).
  • Flatteners: Structural transformation operators (Map, ConcatMap, SwitchMap).
  • Anchors: Foundational graph nodes (Cell).

Added #

• Quick Start Guide: Introduced HowTo-Start.md, providing a comprehensive entry point for developers to grasp the Mitosis mental model.
• Topographical Walkthroughs: Formally linked clinical and reactive search demos in the README.md and dartdoc_options.yaml as Blueprint Templates.
• fluent_operator_test.dart: Exhaustive test coverage for CellFlowOperators and FlowOperators ensuring chains correctly anchor to the IngressHandle.cell.
• Topographical Auditing Tools: Enhanced PowerShell-native auditing scripts for identifying files missing provenance metadata (Copyright headers).

Fixed #

• Documentation Hygiene: Resolved all dartdoc warnings regarding unresolved references including [result], [FlowHandle.cell], and generic type parameters.
• Receptor Integrity: Fixed an issue where FlowInstructionBase.future evolution logic failed to correctly gate unhandled Future.error events.
• Pulse Emission Logic: Corrected the AsyncFold orchestrator to prevent triple-emit inflation during high-frequency ingress.
• Error Propagation: Refined ConcatAll to ensure synchronous inner-throwing iterables correctly route StateError to the appropriate onError orchestrator.

Tests #

• 1022 unit tests in 42 files, 440 groups (+77 tests, +1 file since RC2).
• Last full run: +1022, exit 0.
• Line coverage (lib/): 96.3% (5557 / 5768).
  • fluent_operator.dart: 94.2% (+2.5% coverage).
  • flow_core.dart: 100% materialization coverage.

Legal #

• Copyright headers and authorship metadata aligned with the Mitosis topography standards.
• LICENSE coverage confirmed for MIT OR Apache-2.0.

Mitosis (1.0.0-rc.2) - Release Candidate #

Added #

• Async map variants: AsyncMapConcurrent, AsyncMapLatest, AsyncMapSequential, AsyncMapWithRetry, AsyncMapWithTimeout, AsyncMapWithFallback, AsyncMapWithIndex.
• Async fold variants: AsyncFoldLatest, AsyncFoldExhaust, AsyncReduce. Flow.asyncFoldLatest / Flow.asyncFoldExhaust on the static facade.
• Enhanced demos and walkthroughs:
  • ICU-alarm-pipeline(enhanced)-Demo.dart + WalkThrough
  • domain-cells-txApply(enhanced)-Demo.dart + WalkThrough
• DEMO_GUIDE.md, expanded FEATURES-Flow.md.

Changed #

• Receptor scrutiny and PulseShell defensive proxies on async paths.
• Dartdoc: ### When to use / ### How it works / ### Non-obvious on Flow and FlowInstruction. Unresolved [ref] warnings cleared (qualified names, backtick generics).
• analysis_options.yaml: public_member_api_docs, stricter inference.
• dartdoc_options.yaml links walkthroughs into the API reference.

Mitosis (1.0.0-rc.1) - Release Candidate #

First public release candidate. Operators are FlowInstructions on the same graph as package:cell 1.0.0-rc.1.

Added #

• Flow facade: static factories return FlowHandle.
• Fluent extensions on Cell and FlowHandle (fluent_operator.dart, part of flow.dart).
• FlowInstruction + operator + → InstructionChain → one Receptor via toHandle.

Create

• Of, FromIterable, Range, Repeat
• FromFuture, DeferFuture, FromFutureOr, concat/merge/switch/exhaust from-future, FromFutures, FromFuturesInOrder, ForkJoinFutures, RaceFutures, retry / timeout / fallback, MapToFuture
• FromStream, DeferStream, ConcatFromStream, MergeFromStream, SwitchFromStream, MapToStream

Transform

• MapValue, MapTo, MapWithIndex, MapNotNull, MapWhen
• Pluck, PluckOr, PluckAll, PluckPath
• Scan, Reduce, Pairwise

Async transform

• AsyncMap and concurrent / latest / index / retry / timeout / fallback
• AsyncExpand and concurrent / latest / exhaust
• AsyncFold, AsyncFoldLatest, AsyncFoldExhaust, AsyncReduce

Filter / take / skip / distinct

• Filter, async filter family, FilterNotNull, FilterType, FilterAllowed, FilterBlocked, FilterByTime
• Take, TakeWhile, TakeUntil
• Skip, SkipWhile, SkipUntil, SkipFirst, SkipLast, SkipRepeated, SkipWhen
• Distinct and variants in distinct.dart

Flatten

• ConcatMap, Concat, ConcatAll, ConcatFirst, ConcatLatest
• MergeMap, SwitchMap, ExhaustMap

Combine

• MergeWith, Merge, MergeAll
• ZipWith, Zip, ZipAll
• CombineLatestWith, CombineLatest, WithLatestFrom
• Race

Time

• Delay, DelayWithSelector, DelayWhen, DelayLatest, DelayWithTrailing, DelayWithTimeout
• Debounce family
• Throttle, ThrottleLeading, ThrottleTrailing
• Sample, SampleTime, Audit, AuditTime
• Timeout family
• Interval, IntervalWithValue, IntervalWithState, TimerPulse

Collect / route / control

• BufferCount, BufferTime, BufferWhen, BufferWithPredicate, BufferWithTimeAndCount
• WindowCount, WindowTime
• GroupBy, GroupCollect, GroupByCount
• Partition, PartitionMap, PartitionOnly, Iif
• StartWith, Share, ShareReplay, Retry, Tap / TapAll / TapWithIndex

Notes #

• Cells do not complete. Concatenate inners, not Cell-then-Cell.
• reduce / scan are running folds, not terminal Rx reduce.
• MapValue is used instead of Map so it does not clash with dart:core.
• filter.dart no longer owns Debounce, Throttle, Take, Skip, or Distinct.
• Application import is package:cell_flow/cell_flow.dart only.

Docs #

• README.md, ARCHITECTURE-Flow.md, FEATURES-Flow.md
• HowTo-Fluent_Operator.md, HowTo-FlowInstruction-Receptor.md
• Example gates: example_*.dart