adapt sdk to current daemon ipc surfaces

Author: ChesterRa

README.ja.md

@@ -1,8 +1,8 @@
-# CCCC SDK 0.4.x — CCCC 公式クライアント SDK
+# CCCC SDK — CCCC 公式クライアント SDK
 
 [English](README.md) | [中文](README.zh-CN.md) | **日本語**
 
-> ステータス：**CCCC 0.4.x 向けに安定提供**。RC ビルドもプレビュー用途で継続提供します。
+> ステータス：現在の **CCCC Daemon IPC v1** 系列に合わせて継続保守しています。必要に応じて RC/プレビューも提供します。
 
 CCCC SDK は CCCC プラットフォーム向けの **クライアント SDK** です。
 
@@ -25,7 +25,7 @@ SDK と CCCC Web が同じ `CCCC_HOME` を参照していれば、書き込み
 主な用途：
 - リアルタイム更新が必要な Web/IDE プラグイン（`events_stream`）
 - Working Group を監視して自動応答する bot/service
-- group / actors / shared context をプログラムから管理する社内ツール
+- group / actors / shared context / capability ポリシー / Group Space をプログラムから管理する社内ツール
 
 言語別の詳細:
 - Python SDK: `python/README.md`
@@ -85,11 +85,7 @@ python python/examples/auto_ack_attention.py --group g_xxx --actor user
 
 ## バージョニングと互換性
 
-SDK は **CCCC 0.4.x** に major/minor を合わせ、パッチ/RC の進行は SDK 側で管理します：
-- 安定版例：`cccc-sdk==0.4.0` と `cccc==0.4.x`
-- RC プレビュー例：`cccc-sdk==0.4.1rc1` でも `cccc==0.4.x` と互換な場合があります
-
-互換性は “契約/能力” で保証し、バージョン文字列の厳密一致には依存しません：
+言語ごとのパッケージは個別の公開 cadence を取れます。互換性は “契約/能力” で保証し、バージョン文字列の厳密一致には依存しません：
 - IPC バージョン（`ipc_v`）
 - capability discovery（`capabilities`）
 - op probing（`unknown_op` を検出）
@@ -98,7 +94,7 @@ SDK は **CCCC 0.4.x** に major/minor を合わせ、パッチ/RC の進行は
 
 ## Specs（contracts）
 
-0.4.x 期間は、契約文書の “唯一の真源” は CCCC 本体リポジトリ側に置きます（daemon 実装と同期させるため）。
+現在の CCCC daemon 系列では、契約文書の “唯一の真源” は CCCC 本体リポジトリ側に置きます（daemon 実装と同期させるため）。
 このリポジトリでは `spec/` にミラーを置き、以下で同期できます：
 
 ```bash

README.md

@@ -1,8 +1,8 @@
-# CCCC SDK 0.4.x — Official Client SDKs for CCCC
+# CCCC SDK — Official Client SDKs for CCCC
 
 **English** | [中文](README.zh-CN.md) | [日本語](README.ja.md)
 
-> Status: **stable for CCCC 0.4.x**. RC builds remain available for preview testing.
+> Status: maintained against the current **CCCC Daemon IPC v1** line. Preview/RC builds remain available when needed.
 
 CCCC SDK provides **client SDKs** for building applications on top of the CCCC platform.
 
@@ -25,7 +25,7 @@ If SDK clients and CCCC Web use the same `CCCC_HOME`, all writes are shared imme
 Typical use cases:
 - Reactive UI / IDE plugins that need real-time updates (`events_stream`)
 - Bots/services that watch groups and respond automatically
-- Internal tools that create/manage groups, actors, and shared context programmatically
+- Internal tools that create/manage groups, actors, shared context, capability policy, and Group Space programmatically
 
 For language-specific details:
 - Python SDK: `python/README.md`
@@ -85,11 +85,7 @@ python python/examples/auto_ack_attention.py --group g_xxx --actor user
 
 ## Versioning and compatibility
 
-SDK versions track **CCCC major/minor** (`0.4.x`), while patch/RC cadence is SDK-owned:
-- Stable: `cccc-sdk==0.4.0` with `cccc==0.4.x`
-- RC preview: `cccc-sdk==0.4.1rc1` can still be compatible with `cccc==0.4.x`
-
-Compatibility is enforced by **contracts**, not by strict version string matching:
+Language packages can publish on different cadences. Compatibility is enforced by **contracts**, not by strict version string matching:
 - IPC version (`ipc_v`)
 - capability discovery (`capabilities`)
 - operation probing (reject `unknown_op`)
@@ -98,7 +94,7 @@ See `python/examples/compat_check.py`.
 
 ## Specs (contracts)
 
-For CCCC v0.4.x, the canonical contract documents live in the main CCCC repo (so spec and daemon evolve together).
+For the current CCCC daemon line, the canonical contract documents live in the main CCCC repo (so spec and daemon evolve together).
 This repo keeps a mirror under `spec/`:
 
 ```bash

README.zh-CN.md

@@ -1,8 +1,8 @@
-# CCCC SDK 0.4.x — CCCC 官方客户端 SDK
+# CCCC SDK — CCCC 官方客户端 SDK
 
 [English](README.md) | **中文** | [日本語](README.ja.md)
 
-> 状态：**已稳定支持 CCCC 0.4.x**。同时保留 RC 构建用于预览测试。
+> 状态：面向当前 **CCCC Daemon IPC v1** 主线持续维护；必要时仍会提供 RC/预览构建。
 
 CCCC SDK 是一套用于 CCCC 平台的**客户端 SDK**。
 
@@ -25,7 +25,7 @@ CCCC SDK 是一套用于 CCCC 平台的**客户端 SDK**。
 典型场景：
 - 需要实时更新的 Web/IDE 插件（`events_stream`）
 - 监听工作组并自动响应的 bot/service
-- 以编程方式创建/管理 group、actors、共享 context 的内部工具
+- 以编程方式创建/管理 group、actors、共享 context、capability 策略与 Group Space 的内部工具
 
 语言细分文档：
 - Python SDK：`python/README.md`
@@ -85,11 +85,7 @@ python python/examples/auto_ack_attention.py --group g_xxx --actor user
 
 ## 版本策略与兼容性
 
-SDK 的 major/minor 对齐 **CCCC 0.4.x**，但补丁/RC 节奏由 SDK 自身维护：
-- 稳定版示例：`cccc-sdk==0.4.0` 搭配 `cccc==0.4.x`
-- RC 预览示例：`cccc-sdk==0.4.1rc1` 也可能兼容 `cccc==0.4.x`
-
-我们保证兼容性的手段是“契约/能力”，而不是字符串版本号硬匹配：
+不同语言包可以按各自节奏发布。我们保证兼容性的手段是“契约/能力”，而不是字符串版本号硬匹配：
 - IPC 版本（`ipc_v`）
 - capability discovery（`capabilities`）
 - op probing（拒绝 `unknown_op`）
@@ -98,7 +94,7 @@ SDK 的 major/minor 对齐 **CCCC 0.4.x**，但补丁/RC 节奏由 SDK 自身维
 
 ## 合约文档（contracts）
 
-在 0.4.x 期间，合约文档的“唯一真源”在 CCCC 主仓库（保证 spec 与 daemon 同步演进）。
+当前 CCCC daemon 主线上，合约文档的“唯一真源”在 CCCC 主仓库（保证 spec 与 daemon 同步演进）。
 本仓库的 `spec/` 是镜像，可用脚本刷新：
 
 ```bash

python/README.md

@@ -12,9 +12,7 @@ It requires a running CCCC daemon. The SDK does **not** ship a daemon.
 
 ## Versioning
 
-This SDK tracks **CCCC major/minor** (`0.4.x`), while patch/RC cadence is SDK-owned:
-- Stable example: `cccc-sdk==0.4.0` with `cccc==0.4.x`
-- RC preview example: `cccc-sdk==0.4.1rc1` with `cccc==0.4.x`
+Compatibility is determined by Daemon IPC v1 contracts and operation probing, not by strict string matching of package versions. Different language packages may publish on different cadences.
 
 ## Daemon endpoint discovery
 
@@ -85,10 +83,10 @@ Auto-ACK attention messages (as a recipient):
 python examples/auto_ack_attention.py --group g_xxx --actor user
 ```
 
-Add a note to shared context:
+Add a coordination note to shared context:
 
 ```bash
-python examples/context_add_note.py --group g_xxx --content "remember to do X"
+python examples/context_add_note.py --group g_xxx --kind decision --content "Promote this path"
 ```
 
 Cross-group send:
@@ -99,7 +97,7 @@ python examples/send_cross_group.py --src g_src --dst g_dst --text "hello from s
 
 ## Actor Profiles (global reusable runtime presets)
 
-`cccc` 0.4.x supports global Actor Profiles so you can reuse runtime/runner/command/env across groups.
+`cccc` supports global Actor Profiles so you can reuse runtime/runner/command/env across groups.
 
 ```python
 from cccc_sdk import CCCCClient
@@ -118,6 +116,10 @@ profile = c.actor_profile_upsert(
         "command": ["codex", "exec"],
         "submit": "enter",
         "env": {"CODEX_MODEL": "gpt-5"},
+        "capability_defaults": {
+            "autoload_capabilities": ["pack:space"],
+            "default_scope": "actor",
+        },
     }
 )
 profile_id = str((profile.get("profile") or {}).get("id") or "")
@@ -128,3 +130,33 @@ c.actor_add(group_id="g_xxx", actor_id="reviewer", profile_id=profile_id)
 # profile secrets (write-only values)
 c.actor_profile_secret_update(profile_id=profile_id, set={"OPENAI_API_KEY": "..."})
 ```
+
+## Current high-value surfaces
+
+```python
+from cccc_sdk import CCCCClient
+
+c = CCCCClient()
+
+# Capability exposure for one caller scope
+caps = c.capability_state(group_id="g_xxx", actor_id="foreman")
+
+# Capability policy / allowlist overlay
+policy = c.capability_allowlist_get()
+preview = c.capability_allowlist_validate(
+    mode="patch",
+    patch={"defaults": {"source_level": {"skillsmp_remote": "indexed"}}},
+)
+
+# Group Space / Notebook status
+space = c.group_space_status(group_id="g_xxx")
+
+# Context v3: add a compact shared decision or handoff
+c.context_sync(
+    group_id="g_xxx",
+    by="user",
+    ops=[{"op": "coordination.note.add", "kind": "decision", "summary": "Use the simpler path"}],
+)
+```
+
+If you need an op that does not have a dedicated helper yet, use `call()` / `call_raw()`.

python/examples/context_add_note.py

@@ -7,18 +7,22 @@
 
 
 def main() -> int:
-    ap = argparse.ArgumentParser(description="Add a note to group context via context_sync.")
+    ap = argparse.ArgumentParser(description="Add a coordination note to group context via context_sync.")
     ap.add_argument("--group", required=True, help="group_id")
-    ap.add_argument("--content", required=True, help="note content")
+    ap.add_argument("--content", required=True, help="note summary")
+    ap.add_argument("--kind", choices=("decision", "handoff"), default="decision", help="coordination note kind")
     ap.add_argument("--by", default="system", help="principal id used for the context.sync ledger signal")
     args = ap.parse_args()
 
     c = CCCCClient()
-    res = c.context_sync(group_id=args.group, by=args.by, ops=[{"op": "note.add", "content": args.content}])
+    res = c.context_sync(
+        group_id=args.group,
+        by=args.by,
+        ops=[{"op": "coordination.note.add", "kind": args.kind, "summary": args.content}],
+    )
     print(json.dumps(res, ensure_ascii=False))
     return 0
 
 
 if __name__ == "__main__":
     raise SystemExit(main())
-