Fix blueprint round-trip portable fields

Author: ChesterRa

docs/reference/features.md

@@ -229,7 +229,7 @@ cccc actor secrets <actor_id> --keys
 
 CCCC Web supports blueprint export/import for portable group setup.
 
-- Export captures actors, settings, automation rules/snippets, and guidance overrides.
+- Export captures actors, actor startup autoload baselines, group settings/feature toggles, automation rules/snippets, and guidance overrides.
 - Import uses replace semantics (applies the incoming configuration as the new group setup).
 - Ledger history is preserved (import does not rewrite historical events).
 - Environment secrets are intentionally excluded.

src/cccc/contracts/v1/group_template.py

@@ -26,6 +26,7 @@ class GroupTemplateActor(BaseModel):
     runner: RunnerKind = "pty"
     command: Union[str, List[str]] = Field(default_factory=list)
     submit: ActorSubmit = "enter"
+    capability_autoload: List[str] = Field(default_factory=list)
     enabled: bool = True
 
     model_config = ConfigDict(extra="ignore", populate_by_name=True)
@@ -54,6 +55,8 @@ class GroupTemplateSettings(BaseModel):
     terminal_transcript_visibility: TerminalTranscriptVisibility = "foreman"
     terminal_transcript_notify_tail: bool = True
     terminal_transcript_notify_lines: int = 20
+    panorama_enabled: bool = False
+    desktop_pet_enabled: bool = False
 
     model_config = ConfigDict(extra="ignore")
 

src/cccc/daemon/ops/template_ops.py

@@ -46,6 +46,21 @@ def _slug_filename(value: str) -> str:
     s = re.sub(r"[^a-zA-Z0-9]+", "-", str(value or "").strip()).strip("-").lower()
     return s or "group"
 
+
+def _normalize_capability_id_list(raw: Any) -> List[str]:
+    out: List[str] = []
+    if not isinstance(raw, list):
+        return out
+    seen: set[str] = set()
+    for item in raw:
+        cap_id = str(item or "").strip()
+        if not cap_id or cap_id in seen:
+            continue
+        seen.add(cap_id)
+        out.append(cap_id)
+    return out
+
+
 def _remove_runner_state_files(group_id: str, actor_id: str) -> None:
     home = ensure_home()
     gid = str(group_id or "").strip()
@@ -98,6 +113,14 @@ def group_template_export(args: Dict[str, Any]) -> DaemonResponse:
             actor_tpl.runner = str(profile.get("runner") or actor_tpl.runner)  # type: ignore[assignment]
             actor_tpl.command = list(profile.get("command") or [])
             actor_tpl.submit = str(profile.get("submit") or actor_tpl.submit)  # type: ignore[assignment]
+            actor_autoload = _normalize_capability_id_list(actor_doc.get("capability_autoload"))
+            defaults = profile.get("capability_defaults") if isinstance(profile.get("capability_defaults"), dict) else {}
+            profile_autoload = []
+            # Templates materialize linked actors as portable custom actors. Snapshot only
+            # actor-scoped profile defaults here; session-scoped autoload remains runtime-specific.
+            if str(defaults.get("default_scope") or "actor").strip().lower() == "actor":
+                profile_autoload = _normalize_capability_id_list(defaults.get("autoload_capabilities"))
+            actor_tpl.capability_autoload = [*profile_autoload, *[cap for cap in actor_autoload if cap not in profile_autoload]]
     except Exception as e:
         return _error("template_export_failed", str(e))
     text = dump_group_template(tpl)
@@ -151,6 +174,7 @@ def _prompt_preview(kind: str, limit: int = 2000) -> Dict[str, Any]:
             "runner": a.runner,
             "command": a.command,
             "submit": a.submit,
+            "capability_autoload": list(a.capability_autoload or []),
             "enabled": bool(a.enabled),
         }
         for a in tpl.actors
@@ -268,6 +292,12 @@ def _int(k: str, *, min_v: int = 0, max_v: Optional[int] = None) -> None:
             n = 20
         patch["terminal_transcript_notify_lines"] = max(1, min(80, n))
 
+    # Group feature toggles
+    if "panorama_enabled" in settings:
+        patch["panorama_enabled"] = coerce_bool(settings.get("panorama_enabled"), default=False)
+    if "desktop_pet_enabled" in settings:
+        patch["desktop_pet_enabled"] = coerce_bool(settings.get("desktop_pet_enabled"), default=False)
+
     delivery_keys = {"min_interval_seconds", "auto_mark_on_delivery"}
     automation_keys = {
         "nudge_after_seconds",
@@ -285,6 +315,7 @@ def _int(k: str, *, min_v: int = 0, max_v: Optional[int] = None) -> None:
         "help_nudge_min_messages",
     }
     messaging_keys = {"default_send_to"}
+    feature_keys = {"panorama_enabled", "desktop_pet_enabled"}
 
     delivery = group.doc.get("delivery") if isinstance(group.doc.get("delivery"), dict) else {}
     automation = group.doc.get("automation") if isinstance(group.doc.get("automation"), dict) else {}
@@ -304,6 +335,12 @@ def _int(k: str, *, min_v: int = 0, max_v: Optional[int] = None) -> None:
     group.doc["delivery"] = delivery
     group.doc["automation"] = automation
     group.doc["messaging"] = messaging
+    if feature_keys & set(patch.keys()):
+        features = group.doc.get("features") if isinstance(group.doc.get("features"), dict) else {}
+        for k in feature_keys:
+            if k in patch:
+                features[k] = coerce_bool(patch.get(k), default=False)
+        group.doc["features"] = features
 
     tt_patch: Dict[str, Any] = {}
     if "terminal_transcript_visibility" in patch:
@@ -462,6 +499,7 @@ def group_template_import_replace(args: Dict[str, Any]) -> DaemonResponse:
             "enabled": bool(actor_tpl.enabled),
             "submit": str(actor_tpl.submit or "enter"),
             "command": _normalize_template_actor_command(actor_tpl),
+            "capability_autoload": _normalize_capability_id_list(actor_tpl.capability_autoload),
         }
 
         existing = find_actor(group, aid)
@@ -484,6 +522,7 @@ def group_template_import_replace(args: Dict[str, Any]) -> DaemonResponse:
                     env={},
                     default_scope_key="",
                     submit=str(patch.get("submit") or "enter"),  # type: ignore[arg-type]
+                    capability_autoload=list(patch.get("capability_autoload") or []),
                     enabled=bool(patch.get("enabled", True)),
                     runner=str(patch.get("runner") or "pty"),  # type: ignore[arg-type]
                     runtime=str(patch.get("runtime") or "codex"),  # type: ignore[arg-type]

src/cccc/kernel/group_template.py

@@ -40,6 +40,20 @@ def _as_int(v: Any, default: int) -> int:
         return int(default)
 
 
+def _normalize_capability_id_list(raw: Any) -> List[str]:
+    out: List[str] = []
+    if not isinstance(raw, list):
+        return out
+    seen: set[str] = set()
+    for item in raw:
+        cap_id = str(item or "").strip()
+        if not cap_id or cap_id in seen:
+            continue
+        seen.add(cap_id)
+        out.append(cap_id)
+    return out
+
+
 def parse_group_template(text: str) -> GroupTemplate:
     raw = str(text or "").strip()
     if not raw:
@@ -80,12 +94,14 @@ def build_group_template_from_group(group: Group, *, cccc_version: str = "") ->
                 "runner": str(a.get("runner") or "pty"),
                 "command": list(a.get("command") or []) if isinstance(a.get("command"), list) else [],
                 "submit": str(a.get("submit") or "enter"),
+                "capability_autoload": _normalize_capability_id_list(a.get("capability_autoload")),
                 "enabled": coerce_bool(a.get("enabled"), default=True),
             }
         )
 
     automation = group.doc.get("automation") if isinstance(group.doc.get("automation"), dict) else {}
     delivery = group.doc.get("delivery") if isinstance(group.doc.get("delivery"), dict) else {}
+    features = group.doc.get("features") if isinstance(group.doc.get("features"), dict) else {}
     tt = get_terminal_transcript_settings(group.doc)
     default_send_to = get_default_send_to(group.doc)
 
@@ -109,6 +125,8 @@ def build_group_template_from_group(group: Group, *, cccc_version: str = "") ->
         "terminal_transcript_visibility": str(tt.get("visibility") or "foreman"),
         "terminal_transcript_notify_tail": coerce_bool(tt.get("notify_tail"), default=True),
         "terminal_transcript_notify_lines": _as_int(tt.get("notify_lines", 20), 20),
+        "panorama_enabled": coerce_bool(features.get("panorama_enabled"), default=False),
+        "desktop_pet_enabled": coerce_bool(features.get("desktop_pet_enabled"), default=False),
     }
 
     def _prompt_value(filename: str) -> Optional[str]:
@@ -190,6 +208,10 @@ def preview_group_template_replace(group: Group, template: GroupTemplate) -> Gro
             changed = True
         if str(cur.get("submit") or "enter") != str(a.submit or "enter"):
             changed = True
+        cur_autoload = _normalize_capability_id_list(cur.get("capability_autoload"))
+        new_autoload = _normalize_capability_id_list(a.capability_autoload)
+        if cur_autoload != new_autoload:
+            changed = True
         cur_cmd = cur.get("command")
         cur_cmd_list = [str(x).strip() for x in cur_cmd] if isinstance(cur_cmd, list) else []
         new_cmd_list = _normalize_command(a.command)
@@ -201,6 +223,7 @@ def preview_group_template_replace(group: Group, template: GroupTemplate) -> Gro
     # Settings diff (we only compare keys we export/import).
     automation = group.doc.get("automation") if isinstance(group.doc.get("automation"), dict) else {}
     delivery = group.doc.get("delivery") if isinstance(group.doc.get("delivery"), dict) else {}
+    features = group.doc.get("features") if isinstance(group.doc.get("features"), dict) else {}
     tt = get_terminal_transcript_settings(group.doc)
     default_send_to = get_default_send_to(group.doc)
     current_settings: Dict[str, Any] = {
@@ -223,6 +246,8 @@ def preview_group_template_replace(group: Group, template: GroupTemplate) -> Gro
         "terminal_transcript_visibility": str(tt.get("visibility") or "foreman"),
         "terminal_transcript_notify_tail": coerce_bool(tt.get("notify_tail"), default=True),
         "terminal_transcript_notify_lines": _as_int(tt.get("notify_lines", 20), 20),
+        "panorama_enabled": coerce_bool(features.get("panorama_enabled"), default=False),
+        "desktop_pet_enabled": coerce_bool(features.get("desktop_pet_enabled"), default=False),
     }
     desired_settings = template.settings.model_dump()
     settings_changed: Dict[str, Tuple[Any, Any]] = {}