triflux 9.7.13 → 9.8.0

package/hub/schema.sql

@@ -1,146 +1,146 @@
--- tfx-hub 상태 저장소 스키마
--- SQLite WAL 모드 기반 메시지 버스
-
--- 에이전트 등록 테이블
-CREATE TABLE IF NOT EXISTS agents (
-  agent_id TEXT PRIMARY KEY,
-  cli TEXT NOT NULL CHECK (cli IN ('codex','gemini','claude','other')),
-  pid INTEGER,
-  capabilities_json TEXT NOT NULL DEFAULT '[]',
-  topics_json TEXT NOT NULL DEFAULT '[]',
-  last_seen_ms INTEGER NOT NULL,
-  lease_expires_ms INTEGER NOT NULL,
-  status TEXT NOT NULL CHECK (status IN ('online','stale','offline')),
-  metadata_json TEXT NOT NULL DEFAULT '{}'
-);
-
--- 메시지 테이블
-CREATE TABLE IF NOT EXISTS messages (
-  id TEXT PRIMARY KEY,
-  type TEXT NOT NULL CHECK (type IN ('request','response','event','handoff','human_request','human_response','system')),
-  from_agent TEXT NOT NULL,
-  to_agent TEXT NOT NULL,
-  topic TEXT NOT NULL,
-  priority INTEGER NOT NULL CHECK (priority BETWEEN 1 AND 9),
-  ttl_ms INTEGER NOT NULL,
-  created_at_ms INTEGER NOT NULL,
-  expires_at_ms INTEGER NOT NULL,
-  correlation_id TEXT NOT NULL,
-  trace_id TEXT NOT NULL,
-  payload_json TEXT NOT NULL DEFAULT '{}',
-  status TEXT NOT NULL CHECK (status IN ('queued','delivered','acked','expired','dead_letter'))
-);
-
--- 메시지 수신함 (배달 추적)
-CREATE TABLE IF NOT EXISTS message_inbox (
-  delivery_id INTEGER PRIMARY KEY AUTOINCREMENT,
-  message_id TEXT NOT NULL,
-  agent_id TEXT NOT NULL,
-  delivered_at_ms INTEGER,
-  acked_at_ms INTEGER,
-  attempts INTEGER NOT NULL DEFAULT 0,
-  UNIQUE(message_id, agent_id),
-  FOREIGN KEY(message_id) REFERENCES messages(id) ON DELETE CASCADE
-);
-
--- 사용자 입력 요청 테이블
-CREATE TABLE IF NOT EXISTS human_requests (
-  request_id TEXT PRIMARY KEY,
-  requester_agent TEXT NOT NULL,
-  kind TEXT NOT NULL CHECK (kind IN ('captcha','approval','credential','choice','text')),
-  prompt TEXT NOT NULL,
-  schema_json TEXT NOT NULL DEFAULT '{}',
-  state TEXT NOT NULL CHECK (state IN ('pending','accepted','declined','cancelled','timed_out')),
-  deadline_ms INTEGER NOT NULL,
-  default_action TEXT NOT NULL CHECK (default_action IN ('decline','cancel','timeout_continue')),
-  correlation_id TEXT NOT NULL,
-  trace_id TEXT NOT NULL,
-  response_json TEXT
-);
-
--- 데드 레터 큐
-CREATE TABLE IF NOT EXISTS dead_letters (
-  message_id TEXT PRIMARY KEY,
-  reason TEXT NOT NULL,
-  failed_at_ms INTEGER NOT NULL,
-  last_error TEXT
-);
-
--- 인덱스
-CREATE INDEX IF NOT EXISTS idx_messages_status ON messages(status);
-CREATE INDEX IF NOT EXISTS idx_messages_to_agent ON messages(to_agent, status);
-CREATE INDEX IF NOT EXISTS idx_messages_correlation ON messages(correlation_id);
-CREATE INDEX IF NOT EXISTS idx_messages_trace ON messages(trace_id);
-CREATE INDEX IF NOT EXISTS idx_messages_expires ON messages(expires_at_ms);
-CREATE INDEX IF NOT EXISTS idx_messages_priority ON messages(priority DESC, created_at_ms ASC);
-CREATE INDEX IF NOT EXISTS idx_inbox_agent ON message_inbox(agent_id, delivered_at_ms);
-CREATE INDEX IF NOT EXISTS idx_inbox_message ON message_inbox(message_id);
-CREATE INDEX IF NOT EXISTS idx_human_requests_state ON human_requests(state);
-CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
-CREATE INDEX IF NOT EXISTS idx_agents_lease ON agents(lease_expires_ms);
-
--- Assign Job 테이블
-CREATE TABLE IF NOT EXISTS assign_jobs (
-  job_id TEXT PRIMARY KEY,
-  supervisor_agent TEXT NOT NULL,
-  worker_agent TEXT NOT NULL,
-  topic TEXT NOT NULL DEFAULT 'assign.job',
-  task TEXT NOT NULL DEFAULT '',
-  payload_json TEXT NOT NULL DEFAULT '{}',
-  status TEXT NOT NULL CHECK (status IN ('queued','running','succeeded','failed','timed_out')),
-  attempt INTEGER NOT NULL DEFAULT 1,
-  retry_count INTEGER NOT NULL DEFAULT 0,
-  max_retries INTEGER NOT NULL DEFAULT 0,
-  priority INTEGER NOT NULL DEFAULT 5 CHECK (priority BETWEEN 1 AND 9),
-  ttl_ms INTEGER NOT NULL DEFAULT 600000,
-  timeout_ms INTEGER NOT NULL DEFAULT 600000,
-  deadline_ms INTEGER,
-  trace_id TEXT NOT NULL,
-  correlation_id TEXT NOT NULL,
-  last_message_id TEXT,
-  result_json TEXT,
-  error_json TEXT,
-  created_at_ms INTEGER NOT NULL,
-  updated_at_ms INTEGER NOT NULL,
-  started_at_ms INTEGER,
-  completed_at_ms INTEGER,
-  last_retry_at_ms INTEGER
-);
-
-CREATE INDEX IF NOT EXISTS idx_assign_jobs_status ON assign_jobs(status, updated_at_ms DESC);
-CREATE INDEX IF NOT EXISTS idx_assign_jobs_supervisor ON assign_jobs(supervisor_agent, updated_at_ms DESC);
-CREATE INDEX IF NOT EXISTS idx_assign_jobs_worker ON assign_jobs(worker_agent, updated_at_ms DESC);
-CREATE INDEX IF NOT EXISTS idx_assign_jobs_deadline ON assign_jobs(deadline_ms, status);
-
--- 파이프라인 상태 테이블 (Phase 2)
-CREATE TABLE IF NOT EXISTS pipeline_state (
-  team_name TEXT PRIMARY KEY,
-  phase TEXT NOT NULL DEFAULT 'plan',
-  fix_attempt INTEGER DEFAULT 0,
-  fix_max INTEGER DEFAULT 3,
-  ralph_iteration INTEGER DEFAULT 0,
-  ralph_max INTEGER DEFAULT 10,
-  artifacts TEXT DEFAULT '{}',
-  phase_history TEXT DEFAULT '[]',
-  created_at INTEGER,
-  updated_at INTEGER
-);
-
--- Reflexion 에러 학습 테이블
-CREATE TABLE IF NOT EXISTS reflexion_entries (
-  id TEXT PRIMARY KEY,
-  error_pattern TEXT NOT NULL,          -- 에러 시그니처 (정규화)
-  error_message TEXT NOT NULL,          -- 원본 에러 메시지
-  context_json TEXT NOT NULL DEFAULT '{}', -- { file, function, cli, agent }
-  solution TEXT NOT NULL,               -- 해결책 설명
-  solution_code TEXT,                   -- 해결 코드 스니펫 (있으면)
-  confidence REAL NOT NULL DEFAULT 0.5, -- 솔루션 신뢰도 (0-1)
-  hit_count INTEGER NOT NULL DEFAULT 1, -- 매칭 횟수
-  success_count INTEGER NOT NULL DEFAULT 0, -- 성공 횟수
-  last_hit_ms INTEGER NOT NULL,
-  created_at_ms INTEGER NOT NULL,
-  updated_at_ms INTEGER NOT NULL
-);
-
-CREATE INDEX IF NOT EXISTS idx_reflexion_pattern ON reflexion_entries(error_pattern);
-CREATE INDEX IF NOT EXISTS idx_reflexion_confidence ON reflexion_entries(confidence DESC);
+-- tfx-hub 상태 저장소 스키마
+-- SQLite WAL 모드 기반 메시지 버스
+
+-- 에이전트 등록 테이블
+CREATE TABLE IF NOT EXISTS agents (
+  agent_id TEXT PRIMARY KEY,
+  cli TEXT NOT NULL CHECK (cli IN ('codex','gemini','claude','other')),
+  pid INTEGER,
+  capabilities_json TEXT NOT NULL DEFAULT '[]',
+  topics_json TEXT NOT NULL DEFAULT '[]',
+  last_seen_ms INTEGER NOT NULL,
+  lease_expires_ms INTEGER NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('online','stale','offline')),
+  metadata_json TEXT NOT NULL DEFAULT '{}'
+);
+
+-- 메시지 테이블
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK (type IN ('request','response','event','handoff','human_request','human_response','system')),
+  from_agent TEXT NOT NULL,
+  to_agent TEXT NOT NULL,
+  topic TEXT NOT NULL,
+  priority INTEGER NOT NULL CHECK (priority BETWEEN 1 AND 9),
+  ttl_ms INTEGER NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  expires_at_ms INTEGER NOT NULL,
+  correlation_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  payload_json TEXT NOT NULL DEFAULT '{}',
+  status TEXT NOT NULL CHECK (status IN ('queued','delivered','acked','expired','dead_letter'))
+);
+
+-- 메시지 수신함 (배달 추적)
+CREATE TABLE IF NOT EXISTS message_inbox (
+  delivery_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  message_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  delivered_at_ms INTEGER,
+  acked_at_ms INTEGER,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  UNIQUE(message_id, agent_id),
+  FOREIGN KEY(message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+-- 사용자 입력 요청 테이블
+CREATE TABLE IF NOT EXISTS human_requests (
+  request_id TEXT PRIMARY KEY,
+  requester_agent TEXT NOT NULL,
+  kind TEXT NOT NULL CHECK (kind IN ('captcha','approval','credential','choice','text')),
+  prompt TEXT NOT NULL,
+  schema_json TEXT NOT NULL DEFAULT '{}',
+  state TEXT NOT NULL CHECK (state IN ('pending','accepted','declined','cancelled','timed_out')),
+  deadline_ms INTEGER NOT NULL,
+  default_action TEXT NOT NULL CHECK (default_action IN ('decline','cancel','timeout_continue')),
+  correlation_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  response_json TEXT
+);
+
+-- 데드 레터 큐
+CREATE TABLE IF NOT EXISTS dead_letters (
+  message_id TEXT PRIMARY KEY,
+  reason TEXT NOT NULL,
+  failed_at_ms INTEGER NOT NULL,
+  last_error TEXT
+);
+
+-- 인덱스
+CREATE INDEX IF NOT EXISTS idx_messages_status ON messages(status);
+CREATE INDEX IF NOT EXISTS idx_messages_to_agent ON messages(to_agent, status);
+CREATE INDEX IF NOT EXISTS idx_messages_correlation ON messages(correlation_id);
+CREATE INDEX IF NOT EXISTS idx_messages_trace ON messages(trace_id);
+CREATE INDEX IF NOT EXISTS idx_messages_expires ON messages(expires_at_ms);
+CREATE INDEX IF NOT EXISTS idx_messages_priority ON messages(priority DESC, created_at_ms ASC);
+CREATE INDEX IF NOT EXISTS idx_inbox_agent ON message_inbox(agent_id, delivered_at_ms);
+CREATE INDEX IF NOT EXISTS idx_inbox_message ON message_inbox(message_id);
+CREATE INDEX IF NOT EXISTS idx_human_requests_state ON human_requests(state);
+CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
+CREATE INDEX IF NOT EXISTS idx_agents_lease ON agents(lease_expires_ms);
+
+-- Assign Job 테이블
+CREATE TABLE IF NOT EXISTS assign_jobs (
+  job_id TEXT PRIMARY KEY,
+  supervisor_agent TEXT NOT NULL,
+  worker_agent TEXT NOT NULL,
+  topic TEXT NOT NULL DEFAULT 'assign.job',
+  task TEXT NOT NULL DEFAULT '',
+  payload_json TEXT NOT NULL DEFAULT '{}',
+  status TEXT NOT NULL CHECK (status IN ('queued','running','succeeded','failed','timed_out')),
+  attempt INTEGER NOT NULL DEFAULT 1,
+  retry_count INTEGER NOT NULL DEFAULT 0,
+  max_retries INTEGER NOT NULL DEFAULT 0,
+  priority INTEGER NOT NULL DEFAULT 5 CHECK (priority BETWEEN 1 AND 9),
+  ttl_ms INTEGER NOT NULL DEFAULT 600000,
+  timeout_ms INTEGER NOT NULL DEFAULT 600000,
+  deadline_ms INTEGER,
+  trace_id TEXT NOT NULL,
+  correlation_id TEXT NOT NULL,
+  last_message_id TEXT,
+  result_json TEXT,
+  error_json TEXT,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL,
+  started_at_ms INTEGER,
+  completed_at_ms INTEGER,
+  last_retry_at_ms INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_status ON assign_jobs(status, updated_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_supervisor ON assign_jobs(supervisor_agent, updated_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_worker ON assign_jobs(worker_agent, updated_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_deadline ON assign_jobs(deadline_ms, status);
+
+-- 파이프라인 상태 테이블 (Phase 2)
+CREATE TABLE IF NOT EXISTS pipeline_state (
+  team_name TEXT PRIMARY KEY,
+  phase TEXT NOT NULL DEFAULT 'plan',
+  fix_attempt INTEGER DEFAULT 0,
+  fix_max INTEGER DEFAULT 3,
+  ralph_iteration INTEGER DEFAULT 0,
+  ralph_max INTEGER DEFAULT 10,
+  artifacts TEXT DEFAULT '{}',
+  phase_history TEXT DEFAULT '[]',
+  created_at INTEGER,
+  updated_at INTEGER
+);
+
+-- Reflexion 에러 학습 테이블
+CREATE TABLE IF NOT EXISTS reflexion_entries (
+  id TEXT PRIMARY KEY,
+  error_pattern TEXT NOT NULL,          -- 에러 시그니처 (정규화)
+  error_message TEXT NOT NULL,          -- 원본 에러 메시지
+  context_json TEXT NOT NULL DEFAULT '{}', -- { file, function, cli, agent }
+  solution TEXT NOT NULL,               -- 해결책 설명
+  solution_code TEXT,                   -- 해결 코드 스니펫 (있으면)
+  confidence REAL NOT NULL DEFAULT 0.5, -- 솔루션 신뢰도 (0-1)
+  hit_count INTEGER NOT NULL DEFAULT 1, -- 매칭 횟수
+  success_count INTEGER NOT NULL DEFAULT 0, -- 성공 횟수
+  last_hit_ms INTEGER NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_reflexion_pattern ON reflexion_entries(error_pattern);
+CREATE INDEX IF NOT EXISTS idx_reflexion_confidence ON reflexion_entries(confidence DESC);

package/hub/team/cli/commands/kill.mjs

@@ -1,37 +1,37 @@
-import { closeWtSession, killSession, listSessions } from "../../session.mjs";
-import { DIM, RESET } from "../../shared.mjs";
-import { nativeRequest } from "../services/native-control.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
-import { clearTeamState, loadTeamState } from "../services/state-store.mjs";
-import { ok } from "../render.mjs";
-
-export async function teamKill() {
-  const state = loadTeamState();
-  if (state && isNativeMode(state) && isTeamAlive(state)) {
-    await nativeRequest(state, "/stop", {});
-    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
-    clearTeamState(state.sessionId);
-    ok(`종료: ${state.sessionName}`);
-    console.log("");
-    return;
-  }
-  if (state && isWtMode(state)) {
-    const closed = closeWtSession({ layout: state?.wt?.layout || state?.layout || "1xN", paneCount: state?.wt?.paneCount ?? (state.members || []).length });
-    clearTeamState(state.sessionId);
-    ok(`종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
-    console.log("");
-    return;
-  }
-
-  const sessions = listSessions();
-  if (!sessions.length) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-  for (const session of sessions) {
-    killSession(session);
-    ok(`종료: ${session}`);
-  }
-  clearTeamState(state?.sessionId);
-  console.log("");
-}
+import { closeWtSession, killSession, listSessions } from "../../session.mjs";
+import { DIM, RESET } from "../../shared.mjs";
+import { nativeRequest } from "../services/native-control.mjs";
+import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import { clearTeamState, loadTeamState } from "../services/state-store.mjs";
+import { ok } from "../render.mjs";
+
+export async function teamKill() {
+  const state = loadTeamState();
+  if (state && isNativeMode(state) && isTeamAlive(state)) {
+    await nativeRequest(state, "/stop", {});
+    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
+    clearTeamState(state.sessionId);
+    ok(`종료: ${state.sessionName}`);
+    console.log("");
+    return;
+  }
+  if (state && isWtMode(state)) {
+    const closed = closeWtSession({ layout: state?.wt?.layout || state?.layout || "1xN", paneCount: state?.wt?.paneCount ?? (state.members || []).length });
+    clearTeamState(state.sessionId);
+    ok(`종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+    console.log("");
+    return;
+  }
+
+  const sessions = listSessions();
+  if (!sessions.length) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  for (const session of sessions) {
+    killSession(session);
+    ok(`종료: ${session}`);
+  }
+  clearTeamState(state?.sessionId);
+  console.log("");
+}

package/hub/team/cli/commands/stop.mjs

@@ -1,31 +1,31 @@
-import { closeWtSession, killSession, sessionExists } from "../../session.mjs";
-import { DIM, RESET } from "../../shared.mjs";
-import { nativeRequest } from "../services/native-control.mjs";
-import { isNativeMode, isWtMode } from "../services/runtime-mode.mjs";
-import { clearTeamState, loadTeamState } from "../services/state-store.mjs";
-import { ok } from "../render.mjs";
-
-export async function teamStop() {
-  const state = loadTeamState();
-  if (!state) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-
-  if (isNativeMode(state)) {
-    await nativeRequest(state, "/stop", {});
-    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
-    ok(`세션 종료: ${state.sessionName}`);
-  } else if (isWtMode(state)) {
-    const closed = closeWtSession({ layout: state?.wt?.layout || state?.layout || "1xN", paneCount: state?.wt?.paneCount ?? (state.members || []).length });
-    ok(`세션 종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
-  } else if (sessionExists(state.sessionName)) {
-    killSession(state.sessionName);
-    ok(`세션 종료: ${state.sessionName}`);
-  } else {
-    console.log(`  ${DIM}세션 이미 종료됨${RESET}`);
-  }
-
-  clearTeamState(state.sessionId);
-  console.log("");
-}
+import { closeWtSession, killSession, sessionExists } from "../../session.mjs";
+import { DIM, RESET } from "../../shared.mjs";
+import { nativeRequest } from "../services/native-control.mjs";
+import { isNativeMode, isWtMode } from "../services/runtime-mode.mjs";
+import { clearTeamState, loadTeamState } from "../services/state-store.mjs";
+import { ok } from "../render.mjs";
+
+export async function teamStop() {
+  const state = loadTeamState();
+  if (!state) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  if (isNativeMode(state)) {
+    await nativeRequest(state, "/stop", {});
+    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
+    ok(`세션 종료: ${state.sessionName}`);
+  } else if (isWtMode(state)) {
+    const closed = closeWtSession({ layout: state?.wt?.layout || state?.layout || "1xN", paneCount: state?.wt?.paneCount ?? (state.members || []).length });
+    ok(`세션 종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+  } else if (sessionExists(state.sessionName)) {
+    killSession(state.sessionName);
+    ok(`세션 종료: ${state.sessionName}`);
+  } else {
+    console.log(`  ${DIM}세션 이미 종료됨${RESET}`);
+  }
+
+  clearTeamState(state.sessionId);
+  console.log("");
+}

package/hub/team/cli/commands/task.mjs

@@ -1,30 +1,30 @@
-import { DIM, RESET, WHITE } from "../../shared.mjs";
-import { isTeamAlive } from "../services/runtime-mode.mjs";
-import { loadTeamState, saveTeamState } from "../services/state-store.mjs";
-import { normalizeTaskStatus, updateTaskStatus } from "../services/task-model.mjs";
-import { ok } from "../render.mjs";
-
-export function teamTaskUpdate(args = []) {
-  const state = loadTeamState();
-  if (!state || !isTeamAlive(state)) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-
-  const nextStatus = normalizeTaskStatus(args[0]);
-  const taskId = String(args[1] || "").toUpperCase();
-  if (!nextStatus || !taskId) {
-    console.log(`\n  사용법: ${WHITE}tfx multi task <pending|progress|done> <T1>${RESET}\n`);
-    return;
-  }
-
-  const updated = updateTaskStatus(state.tasks || [], taskId, nextStatus);
-  if (!updated.target) {
-    console.log(`\n  ${DIM}태스크를 찾을 수 없음: ${taskId}${RESET}\n`);
-    return;
-  }
-
-  saveTeamState({ ...state, tasks: updated.tasks }, state.sessionId);
-  ok(`${updated.target.id} 상태 갱신: ${nextStatus}`);
-  console.log("");
-}
+import { DIM, RESET, WHITE } from "../../shared.mjs";
+import { isTeamAlive } from "../services/runtime-mode.mjs";
+import { loadTeamState, saveTeamState } from "../services/state-store.mjs";
+import { normalizeTaskStatus, updateTaskStatus } from "../services/task-model.mjs";
+import { ok } from "../render.mjs";
+
+export function teamTaskUpdate(args = []) {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  const nextStatus = normalizeTaskStatus(args[0]);
+  const taskId = String(args[1] || "").toUpperCase();
+  if (!nextStatus || !taskId) {
+    console.log(`\n  사용법: ${WHITE}tfx multi task <pending|progress|done> <T1>${RESET}\n`);
+    return;
+  }
+
+  const updated = updateTaskStatus(state.tasks || [], taskId, nextStatus);
+  if (!updated.target) {
+    console.log(`\n  ${DIM}태스크를 찾을 수 없음: ${taskId}${RESET}\n`);
+    return;
+  }
+
+  saveTeamState({ ...state, tasks: updated.tasks }, state.sessionId);
+  ok(`${updated.target.id} 상태 갱신: ${nextStatus}`);
+  console.log("");
+}