Changelog — at_client_skills #

1.3.0 — 2026-07-31 #

Document RPC between atsigns — AtRpc / AtRpcClient request/response (new references/13-rpc.md).
Document headless agents and multi-instance coordination — CLIBase auth, per-process storage paths, the immutable-mutex pattern, and stateless scaling with ServiceFactoryWithNoOpSyncService (new references/14-multi-agent.md).
Document remote vs local atServer operations — client-wide remoteLocalPref, per-operation useRemoteAtServer, and bypassCache (new references/12-remote-atserver.md).
Document the rule to never pin at_client / at_client_flutter versions — install with dart pub add instead.
Clarify the macOS network.server entitlement is only needed when the app opens a listening socket (e.g. NoPorts tunnels).
Add noports_core and at_stream (pre-release) to the package map.
Document that at_onboarding_flutter is discontinued — use at_client_flutter.
Add evals covering the new content, and tighten the owner-writes-only and activation evals.
Document the skills CLI prerequisite and the full install steps in the README.

Document sync scoping (syncRegex) and the sync lifecycle (new references/11-sync.md).
Document the rule to hold watch() streams in State, never in build(), and fix the StreamBuilder snippets.
Document the owner-writes-only collaboration/ownership model.
Document the atSign activation / atDirectory prerequisite.

Add user-invocable: true so the skill registers as a slash command.
Document the required macOS entitlements in references/05-flutter-auth.md: network.client (connect to the atServer) and files.user-selected.read-only (the .atKeys file picker).
Fix the test-hooks import: the helpers come from at_client.dart, not the src/collections/... part of file (SKILL.md, references/09).
Add an eval covering the macOS entitlement fix.

Initial release.

AtCollection<T> — full CRUD, CItem<T>, Query<T>, sub-collections, read receipts, event streams
wherePath / PathField<T> typed predicates
watchWithTree / watchWithSub for deep multi-level hierarchies
at_client_flutter auth — all 4 dialog flows (CRAM, atKeys file, device keychain, APKAM)
AtClientManager post-auth setup
Package selection guide (at_client, at_client_flutter, at_auth, at_chops, at_cli_commons)
Domain-object patterns (toJson/fromJson, registerFactory, typeTag)
Unit testing without a live atServer (collections_test_hooks.dart)
Architecture decision guide: AtCollection<T> vs Notifications + SQLite
10 common pitfalls with fixes
Deprecation guide: AtCollectionModel, at_common_flutter, at_backupkey_flutter