chore(release): cut 0.4.4

ChesterRa · ChesterRa · commit c921877dd000 · 2026-03-16T00:13:09.000+09:00
diff --git a/docs/guide/operations.md b/docs/guide/operations.md
@@ -43,7 +43,7 @@ When a group appears stuck:
 2. Check group state (`active/idle/paused/stopped`).
 3. Check actor runtime status.
 4. Check message obligations (reply-required/attention ack).
-5. Check automation and delivery throttling.
+5. Check automation and delivery policy.
 
 Useful commands:
 
diff --git a/docs/guide/web-ui.md b/docs/guide/web-ui.md
@@ -39,7 +39,7 @@ Click on a group in the sidebar to switch.
 2. Configure:
    - Group title
    - Guidance (preamble/help)
-   - Automation rules and engine policies
+   - Built-in automation, rules, and snippets
    - Delivery and messaging defaults
    - IM Bridge settings
 
@@ -108,13 +108,14 @@ Access via the gear icon:
 
 ### Automation
 
-- **Rules**: Create reminders with interval / recurring schedule / one-time schedule.
+- **Built-in Automation**: Configure system-managed follow-ups and collaboration health loops such as unread / reply-required / ACK follow-ups, actor idle alerts, keepalive, silence checks, and help nudges.
+- **Rules**: Create scheduled reminders with interval / recurring schedule / one-time schedule.
 - **Actions**:
   - `Send Reminder` (normal reminder delivery)
   - `Set Group Status` (operational, one-time only)
   - `Control Actor Runtimes` (operational, one-time only)
+- **Snippets**: Reusable message templates managed alongside rules.
 - **One-time behavior**: One-time rules auto-complete after firing, then can be cleaned up from completed list.
-- **Engine Policies**: Configure built-in nudges (reply-required, attention ACK, unread), actor idle, keepalive, quiet review, and help nudges.
 
 ### IM Bridge
 
diff --git a/docs/reference/features.md b/docs/reference/features.md
@@ -161,7 +161,11 @@ Ledger (complete memory)
 
 ## Automation
 
-Automation is now a rule engine (for reminders + operational actions), not only built-in nudges.
+Automation in CCCC combines built-in automation and user-defined rules.
+
+Built-in automation covers system-managed follow-ups and collaboration health loops.
+
+Rules cover scheduled reminders and operational actions, with snippets as reusable message templates.
 
 ### Rule Triggers
 
@@ -189,24 +193,26 @@ Notes:
 - Completed one-time rules are disabled (no repeated fire).
 - UI supports clearing completed items for cleanup.
 
-### Built-in Policies (separate from custom rules)
+### Built-in Automation
 
-| Policy | Config | Default | Description |
-|--------|--------|---------|-------------|
-| Nudge | `nudge_after_seconds` | 300s | Unread message timeout reminder |
+| Behavior | Config | Default | Description |
+|----------|--------|---------|-------------|
+| Nudge | `nudge_after_seconds` | 300s | Digest follow-up for pending unread or obligation items |
 | Reply-required nudge | `reply_required_nudge_after_seconds` | 300s | Follow-up for required-reply obligations |
 | Attention-ack nudge | `attention_ack_nudge_after_seconds` | 600s | Follow-up for attention messages lacking ACK |
-| Unread nudge | `unread_nudge_after_seconds` | 900s | Inbox still-unread reminder |
-| Actor idle | `actor_idle_timeout_seconds` | 600s | Actor idle notification to foreman |
-| Keepalive | `keepalive_delay_seconds` | 120s | Foreman keepalive reminder |
-| Quiet review | `silence_timeout_seconds` | 0s | Optional foreman review when the whole group stays quiet; `0` disables it |
-| Help nudge | `help_nudge_interval_seconds` / `help_nudge_min_messages` | 600s / 10 | Prompt actor to revisit `cccc_help` |
+| Unread nudge | `unread_nudge_after_seconds` | 900s | Reminder when unread backlog keeps accumulating |
+| Actor idle | `actor_idle_timeout_seconds` | 0s | Optional actor idle notification to foreman; `0` disables it by default |
+| Keepalive | `keepalive_delay_seconds` | 120s | Follow-up after an actor declares a next step and then goes quiet |
+| Silence check | `silence_timeout_seconds` | 0s | Optional group-level silence review and idle transition; `0` disables it |
+| Help nudge | `help_nudge_interval_seconds` / `help_nudge_min_messages` | 600s / 10 | Prompt actor to revisit `cccc_help` and refresh working context |
 
-### Delivery Throttling
+### Delivery Policy
 
 | Config | Default | Description |
 |--------|---------|-------------|
-| `min_interval_seconds` | 0s | Minimum interval between consecutive deliveries (`0` disables throttling) |
+| `auto_mark_on_delivery` | `false` | Automatically advance the read cursor after a PTY delivery succeeds |
+
+Low-level delivery throttling via `min_interval_seconds` remains supported in daemon/API settings for compatibility, but it is no longer exposed in the default Web settings UI.
 
 ## Runtime-Only Actor Secrets
 
diff --git a/docs/release/v0.4.4_release_notes.md b/docs/release/v0.4.4_release_notes.md
@@ -0,0 +1,18 @@
+# CCCC v0.4.4 Release Notes
+
+`v0.4.4` is a small polish release over `v0.4.3`.
+It focuses on making the settings experience clearer, reducing UI/config friction, and aligning safer defaults with actual operator intent.
+
+## Highlights
+
+- Guidance is now the default first-open tab in group settings, matching the visible tab order instead of dropping users into Automation first.
+- Settings terminology now more clearly separates built-in automation from user-authored rules and snippets.
+- The Delivery panel was simplified around the only user-facing behavior that still matters there: whether successful PTY delivery should auto-advance the read cursor.
+- The Web settings UI no longer exposes `min_interval_seconds`, while daemon/API compatibility for that low-level delivery throttle remains intact.
+- Actor idle alerts now default to `0` (off) for new/default/reset paths, without silently changing existing group configs that already store a value.
+
+## Upgrade Notes
+
+- No data migration is required.
+- Existing groups keep their stored actor-idle and delivery-throttle values.
+- After upgrading, the most visible change is the cleaner group settings flow and the default-open Guidance tab.
diff --git a/docs/vnext/FEATURES.md b/docs/vnext/FEATURES.md
@@ -163,15 +163,15 @@ Ledger (完整记忆)
 | 机制 | 配置项 | 默认值 | 说明 |
 |------|--------|--------|------|
 | Nudge | `nudge_after_seconds` | 300s | 未读消息超时提醒 |
-| Actor idle | `actor_idle_timeout_seconds` | 600s | Actor 空闲通知 foreman |
+| Actor idle | `actor_idle_timeout_seconds` | 0s | 可选的 Actor 空闲通知 foreman，默认关闭 |
 | Keepalive | `keepalive_delay_seconds` | 120s | Next: 声明后提醒 |
 | 静默复核 | `silence_timeout_seconds` | 0s | 可选启发式检查；群组长时间静默时提醒 foreman 复核是否应转为空闲，`0` 表示关闭 |
 
-### 4.2 投递限流
+### 4.2 投递策略
 
 | 配置项 | 默认值 | 说明 |
 |--------|--------|------|
-| `min_interval_seconds` | 60s | 连续投递最小间隔 |
+| `auto_mark_on_delivery` | `false` | PTY 成功收到消息后是否自动推进已读光标 |
 
 ### 4.3 已移除的机制
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cccc-pair"
-version = "0.4.4rc1"
+version = "0.4.4"
 description = "Global multi-agent delivery kernel with working groups, scopes, and an append-only collaboration ledger"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.9"
diff --git a/src/cccc/contracts/v1/group_template.py b/src/cccc/contracts/v1/group_template.py
@@ -44,7 +44,7 @@ class GroupTemplateSettings(BaseModel):
     nudge_max_repeats_per_obligation: int = 3
     nudge_escalate_after_repeats: int = 2
     auto_mark_on_delivery: bool = False
-    actor_idle_timeout_seconds: int = 600
+    actor_idle_timeout_seconds: int = 0
     keepalive_delay_seconds: int = 120
     keepalive_max_per_actor: int = 3
     silence_timeout_seconds: int = 0
diff --git a/src/cccc/daemon/automation/engine.py b/src/cccc/daemon/automation/engine.py
@@ -83,7 +83,7 @@ def _int(key: str, default: int) -> int:
         nudge_max_repeats_per_obligation=_int("nudge_max_repeats_per_obligation", 3),
         nudge_escalate_after_repeats=_int("nudge_escalate_after_repeats", 2),
         # Level 2
-        actor_idle_timeout_seconds=_int("actor_idle_timeout_seconds", 600),
+        actor_idle_timeout_seconds=_int("actor_idle_timeout_seconds", 0),
         keepalive_delay_seconds=_int("keepalive_delay_seconds", 120),
         keepalive_max_per_actor=_int("keepalive_max_per_actor", 3),
         silence_timeout_seconds=_int("silence_timeout_seconds", 0),
diff --git a/src/cccc/daemon/group/group_settings_ops.py b/src/cccc/daemon/group/group_settings_ops.py
@@ -160,8 +160,8 @@ def handle_group_settings_update(args: Dict[str, Any]) -> DaemonResponse:
             min_value=0,
         ),
         "actor_idle_timeout_seconds": _safe_int(
-            automation.get("actor_idle_timeout_seconds", 600),
-            default=600,
+            automation.get("actor_idle_timeout_seconds", 0),
+            default=0,
             min_value=0,
         ),
         "keepalive_delay_seconds": _safe_int(automation.get("keepalive_delay_seconds", 120), default=120, min_value=0),
diff --git a/src/cccc/kernel/group_template.py b/src/cccc/kernel/group_template.py
@@ -115,7 +115,7 @@ def build_group_template_from_group(group: Group, *, cccc_version: str = "") ->
         "nudge_max_repeats_per_obligation": _as_int(automation.get("nudge_max_repeats_per_obligation", 3), 3),
         "nudge_escalate_after_repeats": _as_int(automation.get("nudge_escalate_after_repeats", 2), 2),
         "auto_mark_on_delivery": coerce_bool(delivery.get("auto_mark_on_delivery"), default=False),
-        "actor_idle_timeout_seconds": _as_int(automation.get("actor_idle_timeout_seconds", 600), 600),
+        "actor_idle_timeout_seconds": _as_int(automation.get("actor_idle_timeout_seconds", 0), 0),
         "keepalive_delay_seconds": _as_int(automation.get("keepalive_delay_seconds", 120), 120),
         "keepalive_max_per_actor": _as_int(automation.get("keepalive_max_per_actor", 3), 3),
         "silence_timeout_seconds": _as_int(automation.get("silence_timeout_seconds", 0), 0),
@@ -236,7 +236,7 @@ def preview_group_template_replace(group: Group, template: GroupTemplate) -> Gro
         "nudge_max_repeats_per_obligation": _as_int(automation.get("nudge_max_repeats_per_obligation", 3), 3),
         "nudge_escalate_after_repeats": _as_int(automation.get("nudge_escalate_after_repeats", 2), 2),
         "auto_mark_on_delivery": coerce_bool(delivery.get("auto_mark_on_delivery"), default=False),
-        "actor_idle_timeout_seconds": _as_int(automation.get("actor_idle_timeout_seconds", 600), 600),
+        "actor_idle_timeout_seconds": _as_int(automation.get("actor_idle_timeout_seconds", 0), 0),
         "keepalive_delay_seconds": _as_int(automation.get("keepalive_delay_seconds", 120), 120),
         "keepalive_max_per_actor": _as_int(automation.get("keepalive_max_per_actor", 3), 3),
         "silence_timeout_seconds": _as_int(automation.get("silence_timeout_seconds", 0), 0),
diff --git a/src/cccc/ports/web/routes/groups.py b/src/cccc/ports/web/routes/groups.py
@@ -672,7 +672,7 @@ async def group_settings_get(group_id: str) -> Dict[str, Any]:
                     "nudge_digest_min_interval_seconds": _safe_int(automation.get("nudge_digest_min_interval_seconds", 120), default=120, min_value=0),
                     "nudge_max_repeats_per_obligation": _safe_int(automation.get("nudge_max_repeats_per_obligation", 3), default=3, min_value=0),
                     "nudge_escalate_after_repeats": _safe_int(automation.get("nudge_escalate_after_repeats", 2), default=2, min_value=0),
-                    "actor_idle_timeout_seconds": _safe_int(automation.get("actor_idle_timeout_seconds", 600), default=600, min_value=0),
+                    "actor_idle_timeout_seconds": _safe_int(automation.get("actor_idle_timeout_seconds", 0), default=0, min_value=0),
                     "keepalive_delay_seconds": _safe_int(automation.get("keepalive_delay_seconds", 120), default=120, min_value=0),
                     "keepalive_max_per_actor": _safe_int(automation.get("keepalive_max_per_actor", 3), default=3, min_value=0),
                     "silence_timeout_seconds": _safe_int(automation.get("silence_timeout_seconds", 0), default=0, min_value=0),
diff --git a/tests/test_daemon_group_settings_dirty_tolerance.py b/tests/test_daemon_group_settings_dirty_tolerance.py
@@ -74,7 +74,7 @@ def test_group_settings_update_tolerates_dirty_numeric_values(self) -> None:
                 self.assertEqual(settings.get("nudge_digest_min_interval_seconds"), 120)
                 self.assertEqual(settings.get("nudge_max_repeats_per_obligation"), 3)
                 self.assertEqual(settings.get("nudge_escalate_after_repeats"), 0)
-                self.assertEqual(settings.get("actor_idle_timeout_seconds"), 600)
+                self.assertEqual(settings.get("actor_idle_timeout_seconds"), 0)
                 self.assertEqual(settings.get("keepalive_delay_seconds"), 120)
                 self.assertEqual(settings.get("keepalive_max_per_actor"), 0)
                 self.assertEqual(settings.get("silence_timeout_seconds"), 0)
diff --git a/tests/test_web_group_settings_dirty_tolerance.py b/tests/test_web_group_settings_dirty_tolerance.py
@@ -76,7 +76,7 @@ def test_group_settings_get_tolerates_dirty_numeric_values(self) -> None:
             self.assertEqual(settings.get("nudge_digest_min_interval_seconds"), 120)
             self.assertEqual(settings.get("nudge_max_repeats_per_obligation"), 3)
             self.assertEqual(settings.get("nudge_escalate_after_repeats"), 0)
-            self.assertEqual(settings.get("actor_idle_timeout_seconds"), 600)
+            self.assertEqual(settings.get("actor_idle_timeout_seconds"), 0)
             self.assertEqual(settings.get("keepalive_delay_seconds"), 120)
             self.assertEqual(settings.get("keepalive_max_per_actor"), 0)
             self.assertEqual(settings.get("silence_timeout_seconds"), 0)
diff --git a/tests/test_web_group_settings_partial_update.py b/tests/test_web_group_settings_partial_update.py
@@ -0,0 +1,79 @@
+import os
+import tempfile
+import unittest
+from unittest.mock import patch
+
+from fastapi.testclient import TestClient
+
+
+class TestWebGroupSettingsPartialUpdate(unittest.TestCase):
+    def _with_home(self):
+        old_home = os.environ.get("CCCC_HOME")
+        td_ctx = tempfile.TemporaryDirectory()
+        td = td_ctx.__enter__()
+        os.environ["CCCC_HOME"] = td
+
+        def cleanup() -> None:
+            td_ctx.__exit__(None, None, None)
+            if old_home is None:
+                os.environ.pop("CCCC_HOME", None)
+            else:
+                os.environ["CCCC_HOME"] = old_home
+
+        return td, cleanup
+
+    def _local_call_daemon(self, req: dict):
+        from cccc.contracts.v1 import DaemonRequest
+        from cccc.daemon.server import handle_request
+
+        request = DaemonRequest.model_validate(req)
+        resp, _ = handle_request(request)
+        return resp.model_dump(exclude_none=True)
+
+    def test_delivery_partial_update_preserves_hidden_min_interval(self) -> None:
+        from cccc.kernel.group import create_group, load_group
+        from cccc.kernel.registry import load_registry
+        from cccc.ports.web.app import create_app
+
+        _, cleanup = self._with_home()
+        try:
+            reg = load_registry()
+            group = create_group(reg, title="delivery-partial", topic="")
+            group_id = group.group_id
+
+            loaded = load_group(group_id)
+            self.assertIsNotNone(loaded)
+            assert loaded is not None
+            loaded.doc["delivery"] = {
+                "min_interval_seconds": 37,
+                "auto_mark_on_delivery": False,
+            }
+            loaded.save()
+
+            with patch("cccc.ports.web.app.call_daemon", side_effect=self._local_call_daemon):
+                app = create_app()
+                client = TestClient(app)
+                resp = client.put(
+                    f"/api/v1/groups/{group_id}/settings",
+                    json={"auto_mark_on_delivery": True},
+                )
+                self.assertEqual(resp.status_code, 200)
+                body = resp.json()
+                self.assertTrue(body.get("ok"))
+                settings = ((body.get("result") or {}).get("settings") or {})
+
+                self.assertEqual(settings.get("min_interval_seconds"), 37)
+                self.assertTrue(bool(settings.get("auto_mark_on_delivery")))
+
+            reloaded = load_group(group_id)
+            self.assertIsNotNone(reloaded)
+            assert reloaded is not None
+            delivery = reloaded.doc.get("delivery") if isinstance(reloaded.doc.get("delivery"), dict) else {}
+            self.assertEqual(int(delivery.get("min_interval_seconds", -1)), 37)
+            self.assertTrue(bool(delivery.get("auto_mark_on_delivery")))
+        finally:
+            cleanup()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/web/src/components/SettingsModal.tsx b/web/src/components/SettingsModal.tsx
@@ -51,7 +51,7 @@ export function SettingsModal({
   const { t } = useTranslation("settings");
   const { modalRef } = useModalA11y(isOpen, onClose);
   const [scope, setScope] = useState<SettingsScope>(groupId ? "group" : "global");
-  const [groupTab, setGroupTab] = useState<GroupTabId>("automation");
+  const [groupTab, setGroupTab] = useState<GroupTabId>("guidance");
   const [globalTab, setGlobalTab] = useState<GlobalTabId>("capabilities");
   const [canAccessGlobalSettings, setCanAccessGlobalSettings] = useState<boolean | null>(null);
   const [webAccessSession, setWebAccessSession] = useState<WebAccessSession | null>(null);
@@ -64,13 +64,12 @@ export function SettingsModal({
   const [nudgeDigestMinIntervalSeconds, setNudgeDigestMinIntervalSeconds] = useState(120);
   const [nudgeMaxRepeatsPerObligation, setNudgeMaxRepeatsPerObligation] = useState(3);
   const [nudgeEscalateAfterRepeats, setNudgeEscalateAfterRepeats] = useState(2);
-  const [idleSeconds, setIdleSeconds] = useState(600);
+  const [idleSeconds, setIdleSeconds] = useState(0);
   const [keepaliveSeconds, setKeepaliveSeconds] = useState(120);
   const [keepaliveMax, setKeepaliveMax] = useState(3);
   const [silenceSeconds, setSilenceSeconds] = useState(600);
   const [helpNudgeIntervalSeconds, setHelpNudgeIntervalSeconds] = useState(600);
   const [helpNudgeMinMessages, setHelpNudgeMinMessages] = useState(10);
-  const [deliveryInterval, setDeliveryInterval] = useState(0);
   const [autoMarkOnDelivery, setAutoMarkOnDelivery] = useState(false);
 
   // Messaging policy
@@ -162,7 +161,6 @@ export function SettingsModal({
       setSilenceSeconds(settings.silence_timeout_seconds);
       setHelpNudgeIntervalSeconds(settings.help_nudge_interval_seconds ?? 600);
       setHelpNudgeMinMessages(settings.help_nudge_min_messages ?? 10);
-      setDeliveryInterval(settings.min_interval_seconds);
       setAutoMarkOnDelivery(Boolean(settings.auto_mark_on_delivery));
       setDefaultSendTo(settings.default_send_to || "foreman");
       setTerminalVisibility(settings.terminal_transcript_visibility || "foreman");
@@ -325,7 +323,6 @@ export function SettingsModal({
 
   const handleSaveDeliverySettings = async () => {
     await onUpdateSettings({
-      min_interval_seconds: deliveryInterval,
       auto_mark_on_delivery: autoMarkOnDelivery,
     });
   };
@@ -853,8 +850,6 @@ export function SettingsModal({
                 <DeliveryTab
                   isDark={isDark}
                   busy={busy}
-                  deliveryInterval={deliveryInterval}
-                  setDeliveryInterval={setDeliveryInterval}
                   autoMarkOnDelivery={autoMarkOnDelivery}
                   setAutoMarkOnDelivery={setAutoMarkOnDelivery}
                   onSave={handleSaveDeliverySettings}
diff --git a/web/src/components/modals/settings/AutomationTab.tsx b/web/src/components/modals/settings/AutomationTab.tsx
diff --git a/web/src/components/modals/settings/DeliveryTab.tsx b/web/src/components/modals/settings/DeliveryTab.tsx
diff --git a/web/src/i18n/locales/en/settings.json b/web/src/i18n/locales/en/settings.json
diff --git a/web/src/i18n/locales/ja/settings.json b/web/src/i18n/locales/ja/settings.json
diff --git a/web/src/i18n/locales/zh/settings.json b/web/src/i18n/locales/zh/settings.json
