feat(scaffold): create product workspace + Rust crates + Flutter app

Implements the canonical implementation directory layout adopted by DEC-022 (register v0.9.5). Closes the scaffolding phase; no PoC code has been promoted in yet (per proof-of-concept-plan.md §4 a PoC is not product code unless explicitly promoted). Rust workspace ============== Top-level Cargo.toml declares seven workspace members: core/chanora_core top-level Rust API + orchestration crates/chanora_protocol tsclientlib isolation (SAD-067, SysDes-011/029) crates/chanora_state state sync, reducers, deltas crates/chanora_audio capture, DSP, Opus, jitter, mixer, playback crates/chanora_storage non-secret DB + platform secure store crates/chanora_diagnostics logs, redaction, export crates/chanora_bridge typed Flutter/Rust DTOs Workspace-wide pins: license = "MIT OR Apache-2.0" (DEC-020) rust-version = "1.95" edition = "2021" The Flutter app (apps/chanora_flutter) is NOT a Cargo workspace member; it is owned by the Flutter / Gradle toolchain and is in the workspace exclude array along with every poc/* spike. Each crate ships: * a Cargo.toml referring to workspace.dependencies pins; * a lib.rs with #![forbid(unsafe_code)] + #![warn(missing_docs)], a typed Error enum, and the public types relevant to the subsystem's role per SAD §7.2; * minimal unit tests so running 1 test test tests::defaults_match_decisions ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 1 test test tests::it_compiles ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 1 test test tests::session_can_be_constructed ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 1 test test tests::marker_matches_poc ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 1 test test tests::it_compiles ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 1 test test tests::state_transitions_compile ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 1 test test tests::it_compiles ... ok test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s running 0 tests test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s is non-empty. chanora_core's CoreError type-wraps every subsystem error via #[from] so callers can match on origin without parsing strings. chanora_audio's AudioEffects struct defaults all four effects to true, matching DEC-007 (AEC), DEC-008 (AGC), DEC-009 (NS), DEC-010 (HPF). A unit test pins this so a future regression that flips a default fails immediately. chanora_diagnostics exports REDACTION_MARKER = "[REDACTED]", identical to the PoC's marker so audit grep patterns survive the promotion. chanora_bridge's BridgeError is Serialize + Deserialize so it can flow across the FRB 2.x boundary (DEC-014). Empirical verification: cargo check --workspace clean, cargo test --workspace clean (7 unit tests + 7 doc-test runners, all passing) against Rust 1.95.0 stable. Flutter app =========== apps/chanora_flutter created with . DEC-004 applied: minSdk overridden to 28 in android/app/build.gradle.kts with a comment that points back at the decision register and forbids lowering it without re-opening DEC-004. DEC-015 applied: shipped English + Simplified Chinese at MVP. - pubspec.yaml gains flutter_localizations + intl + generate:true. - l10n.yaml emits lib/l10n/generated/AppL10n (no synthetic package — that was removed in Flutter 3.41+). - lib/l10n/app_en.arb is the source of truth; lib/l10n/app_zh.arb mirrors the key set in zh-Hans. ARB metadata explicitly reaffirms ADR-008: server-provided content (channel names, nicknames, welcome banners) is preserved verbatim and never translated. lib/main.dart and test/widget_test.dart were rewritten from the template counter into a minimal localized scaffold that proves both locales render correctly. Empirical verification: reports no issues; runs the two locale smoke tests and both pass.
2026-05-14 21:01:59 +08:00
parent 0f418f1d7e
commit 974dda9601
57 changed files with 2292 additions and 0 deletions
@@ -0,0 +1,88 @@
+# This file controls Flutter-level build steps. It should not be edited.
+cmake_minimum_required(VERSION 3.10)
+
+set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")
+
+# Configuration provided via flutter tool.
+include(${EPHEMERAL_DIR}/generated_config.cmake)
+
+# TODO: Move the rest of this into files in ephemeral. See
+# https://github.com/flutter/flutter/issues/57146.
+
+# Serves the same purpose as list(TRANSFORM ... PREPEND ...),
+# which isn't available in 3.10.
+function(list_prepend LIST_NAME PREFIX)
+    set(NEW_LIST "")
+    foreach(element ${${LIST_NAME}})
+        list(APPEND NEW_LIST "${PREFIX}${element}")
+    endforeach(element)
+    set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE)
+endfunction()
+
+# === Flutter Library ===
+# System-level dependencies.
+find_package(PkgConfig REQUIRED)
+pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
+pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0)
+pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0)
+
+set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so")
+
+# Published to parent scope for install step.
+set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
+set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
+set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE)
+set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE)
+
+list(APPEND FLUTTER_LIBRARY_HEADERS
+  "fl_basic_message_channel.h"
+  "fl_binary_codec.h"
+  "fl_binary_messenger.h"
+  "fl_dart_project.h"
+  "fl_engine.h"
+  "fl_json_message_codec.h"
+  "fl_json_method_codec.h"
+  "fl_message_codec.h"
+  "fl_method_call.h"
+  "fl_method_channel.h"
+  "fl_method_codec.h"
+  "fl_method_response.h"
+  "fl_plugin_registrar.h"
+  "fl_plugin_registry.h"
+  "fl_standard_message_codec.h"
+  "fl_standard_method_codec.h"
+  "fl_string_codec.h"
+  "fl_value.h"
+  "fl_view.h"
+  "flutter_linux.h"
+)
+list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/")
+add_library(flutter INTERFACE)
+target_include_directories(flutter INTERFACE
+  "${EPHEMERAL_DIR}"
+)
+target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}")
+target_link_libraries(flutter INTERFACE
+  PkgConfig::GTK
+  PkgConfig::GLIB
+  PkgConfig::GIO
+)
+add_dependencies(flutter flutter_assemble)
+
+# === Flutter tool backend ===
+# _phony_ is a non-existent file to force this command to run every time,
+# since currently there's no way to get a full input/output list from the
+# flutter tool.
+add_custom_command(
+  OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS}
+    ${CMAKE_CURRENT_BINARY_DIR}/_phony_
+  COMMAND ${CMAKE_COMMAND} -E env
+    ${FLUTTER_TOOL_ENVIRONMENT}
+    "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh"
+      ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE}
+  VERBATIM
+)
+add_custom_target(flutter_assemble DEPENDS
+  "${FLUTTER_LIBRARY}"
+  ${FLUTTER_LIBRARY_HEADERS}
+)
@@ -0,0 +1,23 @@
+#
+# Generated file, do not edit.
+#
+
+list(APPEND FLUTTER_PLUGIN_LIST
+)
+
+list(APPEND FLUTTER_FFI_PLUGIN_LIST
+)
+
+set(PLUGIN_BUNDLED_LIBRARIES)
+
+foreach(plugin ${FLUTTER_PLUGIN_LIST})
+  add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/linux plugins/${plugin})
+  target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin)
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES $<TARGET_FILE:${plugin}_plugin>)
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries})
+endforeach(plugin)
+
+foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST})
+  add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/linux plugins/${ffi_plugin})
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries})
+endforeach(ffi_plugin)