128 lines
4.1 KiB
ReStructuredText
128 lines
4.1 KiB
ReStructuredText
=====================================================
|
|
CCC Rust Milestone 2 — Session State (Planning)
|
|
=====================================================
|
|
|
|
:Status: Not started
|
|
:Date: 2026-02-26
|
|
:Repository target: ``ccc_cryptography`` (plugin repo)
|
|
:Depends on: ``ccc_rust`` Milestone 1 complete
|
|
|
|
Related Documents
|
|
=================
|
|
|
|
* Milestone 1 completion record:
|
|
``docs/ccc_rust_milestone1.rst``
|
|
|
|
Overview
|
|
========
|
|
|
|
This document tracks Milestone 2 execution state for Flutter plugin + bridge work.
|
|
Milestone 2 begins with Milestone 1 already verified and complete.
|
|
|
|
Current Gate Preconditions
|
|
==========================
|
|
|
|
* ``[x]`` Milestone 1 verification gate passed.
|
|
* ``[x]`` Conformance vectors passed in Rust workspace.
|
|
* ``[x]`` Rust target builds validated (iOS + Android).
|
|
|
|
Milestone 2 Work Checklist
|
|
==========================
|
|
|
|
Phase 1 — Repository + Scaffold
|
|
-------------------------------
|
|
|
|
* ``[ ]`` Create/confirm ``ccc_cryptography`` repository and branch strategy.
|
|
* ``[ ]`` Create Flutter plugin scaffold (``pubspec.yaml``, ``ios/``, ``android/``, ``macos/``).
|
|
* ``[ ]`` Add Rust bridge crate with ``crate-type = ["cdylib", "staticlib"]``.
|
|
* ``[ ]`` Wire dependency on ``ccc_rust`` pinned tag/revision.
|
|
|
|
Phase 2 — Bridge API Surface
|
|
----------------------------
|
|
|
|
* ``[ ]`` Define DTOs:
|
|
|
|
* ``CapabilitiesDto``
|
|
* ``KemKeyPairDto``
|
|
* ``KemEncapDto``
|
|
* ``SelfTestDto``
|
|
* ``AlgoTestResultDto``
|
|
|
|
* ``[ ]`` Implement bridge entry points:
|
|
|
|
* ``ccc_init``
|
|
* ``ccc_list_providers``
|
|
* ``ccc_capabilities`` / ``ccc_available_algorithms``
|
|
* ``ccc_aead_encrypt`` / ``ccc_aead_decrypt``
|
|
* ``ccc_kdf_derive``
|
|
* ``ccc_mac_compute`` / ``ccc_mac_verify``
|
|
* ``ccc_hash``
|
|
* ``ccc_kem_generate_keypair``
|
|
* ``ccc_kem_encapsulate`` / ``ccc_kem_decapsulate``
|
|
* ``ccc_self_test``
|
|
|
|
Phase 3 — FRB Codegen + Build Integration
|
|
-----------------------------------------
|
|
|
|
* ``[ ]`` Add ``flutter_rust_bridge`` configuration + codegen scripts.
|
|
* ``[ ]`` Run FRB codegen and commit generated artifacts.
|
|
* ``[ ]`` Verify plugin compiles for iOS.
|
|
* ``[ ]`` Verify plugin compiles for Android.
|
|
* ``[ ]`` Verify plugin compiles for macOS.
|
|
|
|
Phase 4 — Dart API Layer
|
|
------------------------
|
|
|
|
* ``[ ]`` Implement ``CccCrypto`` service API wrapper.
|
|
* ``[ ]`` Implement ``CccSelfTest`` wrapper.
|
|
* ``[ ]`` Implement runtime ``CccProviderCatalog`` population.
|
|
* ``[ ]`` Ensure algorithm ID mapping remains 1:1 with Rust discriminants.
|
|
|
|
Phase 5 — Integration + Validation
|
|
----------------------------------
|
|
|
|
* ``[ ]`` Add integration tests for AEAD roundtrip (at least AES-GCM and ChaCha20).
|
|
* ``[ ]`` Add integration tests for KEM keygen/encap/decap flow.
|
|
* ``[ ]`` Add integration tests for self-test API.
|
|
* ``[ ]`` Run on iOS simulator.
|
|
* ``[ ]`` Run on Android emulator/device.
|
|
|
|
Milestone 2 TODO Queue
|
|
======================
|
|
|
|
Immediate TODOs (next session)
|
|
------------------------------
|
|
|
|
* ``[ ]`` Decide exact Milestone 2 repository location/URL and baseline branch.
|
|
* ``[ ]`` Pin ``ccc_rust`` dependency to a reproducible reference (tag or commit hash).
|
|
* ``[ ]`` Define FRB module layout and generated file commit policy.
|
|
* ``[ ]`` Draft DTO type mapping table (Rust type -> bridge DTO -> Dart model).
|
|
|
|
Backlog TODOs
|
|
-------------
|
|
|
|
* ``[ ]`` Add CI job matrix for iOS/macOS/Android plugin builds.
|
|
* ``[ ]`` Add versioning/release policy for plugin package.
|
|
* ``[ ]`` Add troubleshooting notes for NDK/Xcode toolchains.
|
|
|
|
Milestone 2 Verification Gate
|
|
=============================
|
|
|
|
All of the following must pass before declaring Milestone 2 complete:
|
|
|
|
* ``[ ]`` FRB bridge API compiles and loads in Flutter plugin.
|
|
* ``[ ]`` Generated Dart bindings are committed and reproducible.
|
|
* ``[ ]`` ``flutter build ios`` succeeds.
|
|
* ``[ ]`` ``flutter build apk`` succeeds.
|
|
* ``[ ]`` ``flutter build macos`` succeeds.
|
|
* ``[ ]`` Integration test suite passes on iOS simulator.
|
|
* ``[ ]`` Integration test suite passes on Android emulator/device.
|
|
* ``[ ]`` Plugin package is tagged/released at ``v0.1.0`` (or agreed target version).
|
|
|
|
Notes
|
|
=====
|
|
|
|
* Milestone 2 is the first place where ``flutter_rust_bridge`` is allowed.
|
|
* Milestone 1 Rust workspace remains bridge-free and should not be modified
|
|
for Dart/plugin scaffolding.
|