@foxden-app/foxclaw 0.5.15 → 0.5.17

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.5.17 - 2026-06-08
+
+### 中文
+- `foxclaw <subcommand> --help` / `-h` 现在只打印帮助，不再继续执行 `install-systemd`、`start`、`restart` 等带副作用的子命令，避免一次查帮助意外触发服务重启。
+
+### English
+- `foxclaw <subcommand> --help` / `-h` now prints usage and stops before running side-effecting subcommands such as `install-systemd`, `start`, or `restart`, preventing an accidental service restart while checking help.
+
+## 0.5.16 - 2026-06-08
+
+### 中文
+- FoxClaw 重启后会把仍在运行的桥接自有 Codex turn 恢复为可继续操作的活动态，状态卡继续刷新，后续 Telegram 输入会继续 steer 或按聊天设置排队，不再退化成需要用户重新发消息的只读观察态。
+- `/watch` 产生的观察态 turn 会在状态卡中持久化只读标记，重启恢复后仍保持只读，避免把旁观线程误恢复成可操作任务。
+
+### English
+- After a FoxClaw restart, bridge-owned live Codex turns are restored as actionable active turns: their status cards keep updating, and later Telegram messages keep steering or queueing according to the chat setting instead of degrading into read-only watch mode.
+- `/watch`-created observed turns now persist their read-only marker, so restart recovery keeps watched threads read-only and does not accidentally promote them into actionable tasks.
+
 ## 0.5.15 - 2026-06-08
 
 ### 中文

package/dist/controller/controller.js

@@ -2862,6 +2862,7 @@ export class BridgeSessionCore {
                 scopeId,
                 threadId,
                 messageId: previewMessageId,
+                isObserved: active.isObserved,
             });
         }
         this.updateStatus();
@@ -6946,7 +6947,7 @@ export class BridgeSessionCore {
             return this.interruptOrphanWaitingUserInput(preview);
         }
         await this.stopWatchingScopeThread(preview.scopeId, preview.threadId);
-        const active = this.createActiveTurnState(preview.scopeId, target.chatId, target.chatType, target.topicId, preview.threadId, preview.turnId, preview.messageId, true);
+        const active = this.createActiveTurnState(preview.scopeId, target.chatId, target.chatType, target.topicId, preview.threadId, preview.turnId, preview.messageId, preview.isObserved);
         this.setActiveTurn(preview.scopeId, preview.turnId, active);
         const watcher = {
             scopeId: preview.scopeId,
@@ -6973,6 +6974,7 @@ export class BridgeSessionCore {
             scopeId: preview.scopeId,
             threadId: preview.threadId,
             turnId: preview.turnId,
+            isObserved: preview.isObserved,
         });
         return true;
     }
@@ -7153,6 +7155,7 @@ export class BridgeSessionCore {
                     scopeId: active.scopeId,
                     threadId: active.threadId,
                     messageId,
+                    isObserved: active.isObserved,
                 });
             }
             catch (error) {

package/dist/main.js

@@ -66,7 +66,7 @@ async function main() {
         console.log(readPackageVersion());
         return;
     }
-    if (isHelpCommand(command)) {
+    if (isHelpCommand(command) || hasHelpFlag()) {
         printUsage();
         return;
     }
@@ -149,6 +149,9 @@ function isVersionCommand(value) {
 function isHelpCommand(value) {
     return value === 'help' || value === '--help' || value === '-h';
 }
+function hasHelpFlag() {
+    return process.argv.slice(3).some(isHelpCommand);
+}
 function readPackageVersion() {
     try {
         const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));

package/dist/store/database.d.ts

@@ -4,6 +4,7 @@ export interface ActiveTurnPreviewRecord {
     scopeId: string;
     threadId: string;
     messageId: number;
+    isObserved: boolean;
     createdAt: number;
     updatedAt: number;
 }
@@ -74,7 +75,9 @@ export declare class BridgeStore {
     getPendingApprovalByServerRequestId(serverRequestId: string): PendingApprovalRecord | null;
     markApprovalResolved(localId: string): void;
     countPendingApprovals(): number;
-    saveActiveTurnPreview(record: Pick<ActiveTurnPreviewRecord, 'turnId' | 'scopeId' | 'threadId' | 'messageId'>): void;
+    saveActiveTurnPreview(record: Pick<ActiveTurnPreviewRecord, 'turnId' | 'scopeId' | 'threadId' | 'messageId'> & {
+        isObserved?: boolean;
+    }): void;
     listActiveTurnPreviews(): ActiveTurnPreviewRecord[];
     removeActiveTurnPreview(turnId: string): void;
     removeActiveTurnPreviewByMessage(scopeId: string, messageId: number): void;

package/dist/store/database.js

@@ -70,6 +70,7 @@ export class BridgeStore {
         scope_id TEXT NOT NULL,
         thread_id TEXT NOT NULL,
         message_id INTEGER NOT NULL,
+        is_observed INTEGER NOT NULL DEFAULT 0,
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL
       );
@@ -209,6 +210,7 @@ export class BridgeStore {
         this.ensureColumn('pending_approvals', 'payload_json', 'TEXT');
         this.ensureColumn('pending_user_inputs', 'status', "TEXT NOT NULL DEFAULT 'pending'");
         this.ensureColumn('pending_user_inputs', 'submitted_at', 'INTEGER');
+        this.ensureColumn('active_turn_previews', 'is_observed', 'INTEGER NOT NULL DEFAULT 0');
         this.ensureColumn('codex_auth_candidates', 'state', "TEXT NOT NULL DEFAULT 'active'");
         this.ensureColumn('codex_auth_candidate_runtime', 'state', "TEXT NOT NULL DEFAULT 'active'");
         this.ensureColumn('codex_auth_quota_snapshots', 'plan_type', 'TEXT');
@@ -414,22 +416,23 @@ export class BridgeStore {
     saveActiveTurnPreview(record) {
         const now = Date.now();
         this.db.prepare('DELETE FROM active_turn_previews WHERE turn_id = ? OR scope_id = ?').run(record.turnId, record.scopeId);
-        this.db.prepare(`
-      INSERT INTO active_turn_previews (turn_id, scope_id, thread_id, message_id, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?)
-    `).run(record.turnId, record.scopeId, record.threadId, record.messageId, now, now);
+        this.db.prepare(`
+      INSERT INTO active_turn_previews (turn_id, scope_id, thread_id, message_id, is_observed, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(record.turnId, record.scopeId, record.threadId, record.messageId, record.isObserved ? 1 : 0, now, now);
     }
     listActiveTurnPreviews() {
-        const rows = this.db.prepare(`
-      SELECT turn_id, scope_id, thread_id, message_id, created_at, updated_at
-      FROM active_turn_previews
-      ORDER BY created_at ASC
+        const rows = this.db.prepare(`
+      SELECT turn_id, scope_id, thread_id, message_id, is_observed, created_at, updated_at
+      FROM active_turn_previews
+      ORDER BY created_at ASC
     `).all();
         return rows.map((row) => ({
             turnId: String(row.turn_id),
             scopeId: String(row.scope_id),
             threadId: String(row.thread_id),
             messageId: Number(row.message_id),
+            isObserved: Boolean(row.is_observed),
             createdAt: Number(row.created_at),
             updatedAt: Number(row.updated_at),
         }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",