Files
chanora/NOTICE
T
EdisonJwa 50768a8f48 feat(mvp): v1.0.0-rc.1 — keyring-backed DEK, encrypted bookmarks, MVP release-gate docs
Closes the v0.4 dual-file weakness in identity-at-rest and turns the
release into an MVP public release candidate. The remaining work
before `v1.0.0` is DEC-012 legal sign-off — see
`docs/governance/legal-review-readiness.md` — and the staged
platform promotions in `docs/governance/staged-release-plan.md`.
No decision rows in `product-decision-register.md` change; the
register's change-history advances to 0.9.8.

`chanora_storage`
-----------------

* New public `Crypto` trait + `IdentityFileStore::crypto()` give
  callers an encrypt / decrypt pair anchored on the per-install
  32-byte DEK without exposing the key material.
* `IdentityFileStore` keyring-first DEK retrieval (Linux Secret
  Service via D-Bus, macOS Keychain, Windows Credential Manager,
  iOS Keychain via the `keyring` crate). Pre-existing
  `identity.dek` files are opportunistically migrated into the
  keyring on first run; the on-disk DEK copy is removed once the
  keyring acknowledges. `CHANORA_DISABLE_KEYRING=1` forces the
  file-fallback path for tests and headless / CI hosts where a
  real keyring call would prompt the user or block on a missing
  D-Bus session.
* `BookmarkRepository::with_crypto(dir, crypto)` encrypts the
  server password into a new `password_blob` BLOB column under
  the same per-install DEK. Schema v2 migration is idempotent —
  legacy v0.4 rows with a plain `password TEXT` are read
  transparently and lifted into `password_blob` on the next
  `update()`. `BookmarkRepository::new` (no crypto) is preserved
  for tests and as a documented fallback when the DEK is
  unreachable.
* Storage tests rise from 8 to 10: encrypted bookmark password
  round-trip + legacy-plaintext-bookmark upgrade.

`chanora_core`
--------------

* `ChanoraSession::init_storage(dir)` wires the bookmark
  repository with crypto by default. On any crypto-derivation
  failure it falls back to the plain-password repository and
  logs the gap — better than hard-failing init.
* `supervisor_loop` now tracks a 64-bit `snapshot_signature` over
  channels (id + parent + order + name) and clients (id + channel
  + name) instead of the old `(channel_count, client_count)`
  tuple. Any in-channel client move, channel rename, or reorder
  now fires `SessionEvent::SnapshotChanged`. The signature sorts
  by id before hashing so it's stable under input-vector
  reordering.
* Two new unit tests cover the signature behaviour; new
  `tests/mvp_storage.rs` integration test drives
  `ChanoraSession::init_storage` end-to-end and verifies the
  bookmark `password_blob` does not contain the plaintext.
* Re-export `ChannelId` + `ClientId` from `chanora_protocol` so
  downstream callers and tests can construct DTOs directly.

Flutter
-------

* New About dialog (info icon in the AppBar) surfaces DEC-018
  (public name "Chanora"), DEC-019 (non-affiliation statement),
  and DEC-020 (Apache-2.0 OR MIT dual license). New ARB keys in
  `app_en.arb` and `app_zh.arb`: `aboutAction`, `aboutVersion`,
  `aboutNonAffiliation`, `aboutLicenseHeading`, `aboutLicenseBody`,
  `aboutThirdPartyHeading`, `aboutThirdPartyBody`.
* `pubspec.yaml` version bumps to `1.0.0-rc.1+5`.

Governance
----------

* `docs/governance/legal-review-readiness.md` — DEC-012 handoff
  package. Enumerates trademark / non-affiliation / license-text
  / third-party-attribution / `tsclientlib`-posture / crypto-
  export / data-handling items the legal reviewer must confirm,
  and lists the concrete engineering deliverables they block on
  (`cargo about generate`, `cargo deny check licenses`,
  Flutter `LicenseRegistry` dump).
* `docs/governance/staged-release-plan.md` — DEC-002 channel
  schedule. Linux + Android sideload promote to GA on DEC-012
  sign-off; Play Store / Windows / macOS / iOS gate on per-
  platform signed-build availability. Rollback policy included.
* `product-decision-register.md` change-history advances to
  0.9.8 with a single entry summarising v0.3, v0.4, and v1.0-rc.1
  progress against DEC-001. No decision rows mutate.

Build + ops
-----------

* `NOTICE` refreshed for the MVP product-code dependency set:
  adds `chacha20poly1305`, `rand`, `zeroize`, `base64`,
  `keyring`, `connectivity_plus`, `path_provider`,
  `freezed_annotation`; drops PoC-only entries.
* `CHANGELOG.md` restructured: explicit version sections for
  v0.3.0-beta.1, v0.4.0-beta.2, v1.0.0-rc.1. Previous "Unreleased"
  contents migrated into their respective milestone sections.
* `.github/workflows/ci.yml` exports `CHANORA_DISABLE_KEYRING=1`
  for the cargo-test job — CI runners have no D-Bus session and
  the keyring crate would otherwise block.
* `run-chanora.sh` reads `CHANORA_BUNDLE_FLAVOUR` (default
  `release`) and self-copies the latest cdylib into the bundle's
  `lib/` if missing.

Verification
------------

* `cargo test --workspace` with `CHANORA_DISABLE_KEYRING=1`: all
  green (49 unit tests across the workspace; up from 36 at
  v0.4.0-beta.2).
* `cargo test -p chanora_core --release -- --ignored alpha_smoke`
  passes against the live `cn.teamspeak.app` (DNS → connect →
  snapshot → disconnect in ~2.5 s).
* `flutter analyze`: clean.
* `cargo build -p chanora_bridge --release` + `flutter build
  linux --release` produce a working Linux x86_64 bundle.

No Android live test in this commit per the user's note that the
physical device was removed; the Android arm64-v8a build path is
mechanically identical to v0.4.0-beta.2.
2026-05-15 02:24:42 +08:00

86 lines
3.4 KiB
Plaintext

Chanora Notices
Copyright (c) 2026 The Chanora Project Contributors.
Chanora is dual-licensed under the Apache License, Version 2.0 (see
LICENSE-APACHE) or the MIT license (see LICENSE-MIT) at your option.
The Apache-2.0 portion of the license requires this NOTICE file to be
preserved in redistributions; see LICENSE-APACHE §4(d).
Chanora is an independent project and is not affiliated with, endorsed
by, sponsored by, or officially associated with TeamSpeak.
------------------------------------------------------------------------
Third-party software and attributions
This NOTICE file enumerates third-party software that Chanora links to
or bundles, together with the upstream license that applies. The full
license texts for each dependency must ship alongside released
artefacts; production-build packaging is responsible for generating
those bundles. The legal review of the complete dependency tree is
tracked by DEC-012 in
docs/governance/product-decision-register.md and must complete before
any public/store release.
Direct Rust dependencies of the MVP product code (as of v1.0.0-rc.1):
Protocol + audio
* tsclientlib — MIT OR Apache-2.0
https://github.com/ReSpeak/tsclientlib
* tsproto / tsproto-packets — MIT OR Apache-2.0 (workspace of tsclientlib)
* cpal — Apache-2.0
https://github.com/RustAudio/cpal
* audiopus — MIT OR Apache-2.0
Bridge + framework glue
* flutter_rust_bridge — MIT
https://github.com/fzyzcjy/flutter_rust_bridge
* tokio — MIT
* futures — MIT OR Apache-2.0
* thiserror — MIT OR Apache-2.0
* tracing / tracing-subscriber / tracing-android — MIT
* serde — MIT OR Apache-2.0
Storage + secure storage
* rusqlite (bundled) — MIT
https://github.com/rusqlite/rusqlite
* libsqlite3-sys — MIT
* chacha20poly1305 — Apache-2.0 OR MIT
* rand — MIT OR Apache-2.0
* zeroize — MIT OR Apache-2.0
* base64 — MIT OR Apache-2.0
* keyring — MIT OR Apache-2.0
https://github.com/hwchen/keyring-rs
Android JNI
* jni — MIT OR Apache-2.0
* ndk-context — MIT OR Apache-2.0
Direct Flutter / Dart dependencies of the MVP product code:
* Flutter framework — BSD-3-Clause
* flutter_rust_bridge — MIT (Dart side mirrors the Rust side)
* connectivity_plus — BSD-3-Clause
* path_provider — BSD-3-Clause
* intl — BSD-3-Clause
* cupertino_icons — MIT
* freezed_annotation — MIT
* flutter_lints (dev) — BSD-3-Clause
* build_runner (dev) — BSD-3-Clause
Direct Android-app dependencies (apps/chanora_flutter/android/):
* androidx.core:core-ktx, androidx.appcompat:appcompat — Apache-2.0
* Android NDK r26.x runtime libraries — Apache-2.0 / per-component licences
* Kotlin stdlib — Apache-2.0
* Gradle wrapper — Apache-2.0
Transitive dependencies are not enumerated here. The full machine-
generated license inventory for a release build can be produced with
`cargo about generate` (Rust) and Flutter's `LicenseRegistry` (Dart);
that output must be shipped with each released artefact. See
docs/security/dependency-and-supply-chain-report.md for the supply-
chain audit record and docs/governance/legal-review-readiness.md for
the DEC-012 sign-off checklist.