From 14c8f38f36a94e6fe02b420dee07bbbe3b210cfe Mon Sep 17 00:00:00 2001
From: flemming-it <stefan.a.flemming@googlemail.com>
Date: Tue, 16 Jun 2026 17:39:12 +0200
Subject: [PATCH] refactor: rename package fai_client_sdk -> chain_client_sdk
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The SDK belongs to the Ch∆In product, not the F∆I vendor namespace
(a future Brain client SDK would otherwise collide). Rename the Dart
package, entry library, test + example files. Also drop a private
project name from a doc comment. dart analyze: clean.

Dependents must update their dependency name + package: imports.

Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
---
 README.md                                              | 10 +++++-----
 ..._sdk_example.dart => chain_client_sdk_example.dart} |  4 ++--
 lib/{fai_client_sdk.dart => chain_client_sdk.dart}     |  4 ++--
 pubspec.yaml                                           |  2 +-
 ...client_sdk_test.dart => chain_client_sdk_test.dart} |  2 +-
 5 files changed, 11 insertions(+), 11 deletions(-)
 rename example/{fai_client_sdk_example.dart => chain_client_sdk_example.dart} (75%)
 rename lib/{fai_client_sdk.dart => chain_client_sdk.dart} (73%)
 rename test/{fai_client_sdk_test.dart => chain_client_sdk_test.dart} (93%)

diff --git a/README.md b/README.md
index 575d921..86338a9 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# fai_client_sdk (Dart)
+# chain_client_sdk (Dart)
 
 gRPC client SDK for the Ch∆In hub. Used by F∆I Studio
 (Tier-2 generic GUI) and any Tier-3 Dart/Flutter domain app
@@ -9,10 +9,10 @@ One of the three SDK families documented in
 
   * `fai-module-sdk` (Rust) — flow modules
   * `fai-plugin-sdk` (Rust) — Studio plugins
-  * `fai_client_sdk`  (Dart) — clients ← this package
+  * `chain_client_sdk`  (Dart) — clients ← this package
 
 Dir / repo carries the `_dart` / `-dart` language suffix
-(`fai_client_sdk_dart` / `client-sdk-dart`); the Dart package
+(`chain_client_sdk_dart` / `client-sdk-dart`); the Dart package
 name itself does not (Dart-land doesn't need the suffix).
 
 > **Status (2026-05-05):** scaffold. Public surface (`HubClient`,
@@ -35,9 +35,9 @@ boilerplate. This package centralises that work:
 ## Layout
 
 ```
-fai_client_sdk_dart/
+chain_client_sdk_dart/
 ├── lib/
-│   ├── fai_client_sdk.dart        # Public API
+│   ├── chain_client_sdk.dart        # Public API
 │   └── src/
 │       ├── hub_client.dart        # Typed client wrapper
 │       ├── channel_factory_io.dart   # Native ClientChannel (HTTP/2)
diff --git a/example/fai_client_sdk_example.dart b/example/chain_client_sdk_example.dart
similarity index 75%
rename from example/fai_client_sdk_example.dart
rename to example/chain_client_sdk_example.dart
index d5af03e..cd99fd9 100644
--- a/example/fai_client_sdk_example.dart
+++ b/example/chain_client_sdk_example.dart
@@ -1,8 +1,8 @@
 // Example: connect to a locally-running F∆I hub.
 //
-// Run with `dart run example/fai_client_sdk_example.dart`.
+// Run with `dart run example/chain_client_sdk_example.dart`.
 
-import 'package:fai_client_sdk/fai_client_sdk.dart';
+import 'package:chain_client_sdk/chain_client_sdk.dart';
 
 Future<void> main() async {
   final client = HubClient(
diff --git a/lib/fai_client_sdk.dart b/lib/chain_client_sdk.dart
similarity index 73%
rename from lib/fai_client_sdk.dart
rename to lib/chain_client_sdk.dart
index 92faae8..ecc3f95 100644
--- a/lib/fai_client_sdk.dart
+++ b/lib/chain_client_sdk.dart
@@ -2,8 +2,8 @@
 ///
 /// Provides a typed Dart wrapper around the hub's gRPC services
 /// (Hub, HubAdmin) defined in `fai/chain`'s `proto/chain/v1/`
-/// directory. Used by F∆I Studio and any Tier-3 Dart/Flutter
-/// app (DigiScout, J∆I, Scout, …) that wants to talk to a hub.
+/// directory. Used by Ch∆In Studio and any Tier-3 Dart/Flutter
+/// app that wants to talk to a hub.
 ///
 /// The generated protobuf bindings live under
 /// `lib/src/generated/`. Re-run `tools/generate.sh` whenever the
diff --git a/pubspec.yaml b/pubspec.yaml
index b0112dd..1e34240 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,4 +1,4 @@
-name: fai_client_sdk
+name: chain_client_sdk
 description: gRPC client SDK for the Ch∆In hub. Used by F∆I Studio and Tier-3 domain apps.
 version: 0.18.0
 publish_to: 'none'
diff --git a/test/fai_client_sdk_test.dart b/test/chain_client_sdk_test.dart
similarity index 93%
rename from test/fai_client_sdk_test.dart
rename to test/chain_client_sdk_test.dart
index 31e82bf..7e01d13 100644
--- a/test/fai_client_sdk_test.dart
+++ b/test/chain_client_sdk_test.dart
@@ -1,4 +1,4 @@
-import 'package:fai_client_sdk/fai_client_sdk.dart';
+import 'package:chain_client_sdk/chain_client_sdk.dart';
 import 'package:test/test.dart';
 
 void main() {