feat: 远程群控 (#243)

* feat: restore pipe IPC, LAN pipes, monitor tool, and PR-package features

Core IPC system (UDS_INBOX):
- PipeServer/PipeClient with UDS + TCP dual transport, NDJSON protocol
- PipeRegistry: machineId-based role assignment, file locking
- Master/slave attach, prompt relay, permission forwarding
- Heartbeat lifecycle with parallel isPipeAlive probes
- Commands: /pipes, /attach, /detach, /send, /claim-main, /pipe-status

LAN Pipes (LAN_PIPES):
- UDP multicast beacon (224.0.71.67:7101) for zero-config LAN discovery
- PipeServer TCP listener, PipeClient TCP connect mode
- Heartbeat auto-attaches LAN peers via TCP
- Cross-machine attach allowed regardless of role
- /pipes shows [LAN] peers with role + hostname/IP
- SendMessageTool supports tcp: scheme with user consent

Architecture — extracted hooks from REPL.tsx (~830 lines → ~20 lines):
- usePipeIpc: lifecycle (bootstrap, handlers, heartbeat, cleanup)
- usePipeRelay: slave→master message relay via module singleton
- usePipePermissionForward: permission request/cancel forwarding
- usePipeRouter: selected pipe input routing with role+IP labels
- Shared ndjsonFramer.ts replaces 3 duplicate NDJSON parsers

Key fixes applied during development:
- Multicast binds to correct LAN interface (not WSL/Docker)
- Beacon ref stored as module singleton (not Zustand state mutation)
- Heartbeat preserves LAN peers in discoveredPipes and selectedPipes
- Disconnect handler calls removeSlaveClient (fixes listener leak)
- cleanupStaleEntries probes without lock, writes briefly under lock
- getMachineId uses async execFile (not blocking execSync)
- globalThis.__pipeSendToMaster replaced with setPipeRelay singleton
- M key only toggles route mode when selector panel is expanded
- User prompt displayed in message list on pipe broadcast
- Broadcast notifications show [role] + hostname/IP for LAN peers

Other restored features:
- Monitor tool: /monitor command, MonitorTool, MonitorMcpTask lifecycle
- Daemon supervisor and remoteControlServer command
- Tools: SnipTool, SleepTool, ListPeersTool, SendUserFileTool,
  WebBrowserTool, WorkflowTool, and 10+ stub→implementation rewrites
- Feature flags: UDS_INBOX, LAN_PIPES, MONITOR_TOOL, FORK_SUBAGENT,
  KAIROS, COORDINATOR_MODE, WORKFLOW_SCRIPTS, HISTORY_SNIP

Tests: 2190 pass / 0 fail (15 new: lanBeacon 7, peerAddress 8)

* fix: resolve merge conflicts and fix all tsc/test errors after main merge

- Export ToolResultBlockParam from Tool.ts (14 tool files fixed)
- Migrate ink imports from ../../ink.js to @anthropic/ink (7 files)
- Fix toolUseID → toolUseId typo in monitor.ts and MonitorTool.tsx
- Add fallback values for string|undefined type errors (8 locations)
- Fix AppState type in assistant.ts, add NewInstallWizard stubs
- Fix ParsedRepository.repo → .name in subscribe-pr.ts
- Fix AgentId/string type mismatch in BackgroundTasksDialog.tsx
- Fix PipeRelayFn return type in pipePermissionRelay.ts
- Use PipeMessage type in usePipeRelay.ts
- Fix lanBeacon.test.ts mock type assertions
- Create missing MouseActionEvent class for ink package
- Use ansi: color format instead of bare "green"/"red"
- Resolve theme.permission access via getTheme()

Result: 0 tsc errors, 2496 tests pass, 0 fail

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: 恢复 /poor 的说明

---------

Co-authored-by: unraid <local@unraid.local>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
claude-code-best
2026-04-11 23:22:55 +08:00
committed by GitHub
parent 2fea429dc6
commit 09fc515edb
124 changed files with 10958 additions and 577 deletions

View File

@@ -0,0 +1,116 @@
import { afterEach, describe, expect, test } from 'bun:test'
import {
addSlaveClient,
applyPipeEntryToSlaveState,
getConnectedSlaveTargets,
resetSlaveClientsForTesting,
subscribePipeEntries,
} from '../useMasterMonitor.js'
afterEach(() => {
resetSlaveClientsForTesting()
})
describe('useMasterMonitor registry helpers', () => {
test('returns only attached and connected targets from a selection list', () => {
addSlaveClient('cli-a', { connected: true } as any)
addSlaveClient('cli-b', { connected: false } as any)
const targets = getConnectedSlaveTargets(['cli-a', 'cli-b', 'cli-c'])
expect(targets).toHaveLength(1)
expect(targets[0]?.name).toBe('cli-a')
expect(targets[0]?.client.connected).toBe(true)
})
test('returns an empty array when no selected targets are connected', () => {
addSlaveClient('cli-a', { connected: false } as any)
expect(getConnectedSlaveTargets(['cli-a', 'cli-missing'])).toEqual([])
})
test('applies prompt_ack as busy activity with a summary', () => {
const next = applyPipeEntryToSlaveState(
{
name: 'cli-a',
connectedAt: '2026-04-08T00:00:00.000Z',
status: 'idle',
unreadCount: 0,
history: [],
},
{
type: 'prompt_ack',
content: 'accepted',
from: 'cli-a',
timestamp: '2026-04-08T00:00:01.000Z',
},
)
expect(next.status).toBe('busy')
expect(next.lastEventType).toBe('prompt_ack')
expect(next.lastSummary).toBe('accepted')
expect(next.unreadCount).toBe(1)
})
test('applies done and error entries to terminal slave states', () => {
const doneState = applyPipeEntryToSlaveState(
{
name: 'cli-a',
connectedAt: '2026-04-08T00:00:00.000Z',
status: 'busy',
unreadCount: 1,
history: [],
},
{
type: 'done',
content: 'completed',
from: 'cli-a',
timestamp: '2026-04-08T00:00:02.000Z',
},
)
expect(doneState.status).toBe('idle')
expect(doneState.lastSummary).toBe('completed')
const errorState = applyPipeEntryToSlaveState(doneState, {
type: 'error',
content: 'failed',
from: 'cli-a',
timestamp: '2026-04-08T00:00:03.000Z',
})
expect(errorState.status).toBe('error')
expect(errorState.lastEventType).toBe('error')
expect(errorState.lastSummary).toBe('failed')
expect(errorState.unreadCount).toBe(3)
})
test('emits pipe entries immediately when connected clients receive messages', () => {
const handlers = new Map<string, (msg: any) => void>()
const client = {
connected: true,
on(event: string, handler: (msg: any) => void) {
handlers.set(event, handler)
},
removeListener(event: string) {
handlers.delete(event)
},
}
const seen: Array<{ name: string; type: string; content: string }> = []
const unsubscribe = subscribePipeEntries((name, entry) => {
seen.push({ name, type: entry.type, content: entry.content })
})
addSlaveClient('cli-a', client as any)
handlers.get('message')?.({
type: 'stream',
data: 'hello',
from: 'cli-a',
ts: '2026-04-08T00:00:04.000Z',
})
expect(seen).toEqual([{ name: 'cli-a', type: 'stream', content: 'hello' }])
unsubscribe()
})
})