@triflux/core 10.51.0 → 10.53.0

package/hub/hitl.mjs

@@ -1,202 +0,0 @@
-// hub/hitl.mjs — Human-in-the-Loop 매니저
-// 사용자 입력 요청/응답, 타임아웃 자동 처리
-
-/**
- * HITL 매니저 생성
- * @param {object} store — createStore() 반환 객체
- * @param {object} router — createRouter() 반환 객체
- */
-export function createHitlManager(store, router = null) {
-  function forwardHumanResponse({
-    requesterAgent,
-    requestId,
-    action,
-    content,
-    submittedBy,
-    correlationId,
-    traceId,
-    priority,
-  }) {
-    if (!router?.handlePublish) {
-      throw new Error("router.handlePublish is required for HITL forwarding");
-    }
-    return router.handlePublish({
-      from: "hub:hitl",
-      to: requesterAgent,
-      topic: "human.response",
-      priority,
-      ttl_ms: 300000,
-      payload: {
-        request_id: requestId,
-        action,
-        content,
-        submitted_by: submittedBy,
-      },
-      correlation_id: correlationId,
-      trace_id: traceId,
-      message_type: "human_response",
-    });
-  }
-
-  return {
-    /**
-     * 사용자에게 입력 요청 생성
-     * 터미널에 알림 출력 후 pending 상태로 저장
-     */
-    requestHumanInput({
-      requester_agent,
-      kind,
-      prompt,
-      requested_schema = {},
-      deadline_ms,
-      default_action,
-      channel_preference = "terminal",
-      correlation_id,
-      trace_id,
-    }) {
-      const result = store.insertHumanRequest({
-        requester_agent,
-        kind,
-        prompt,
-        requested_schema,
-        deadline_ms,
-        default_action,
-        correlation_id,
-        trace_id,
-      });
-
-      // 터미널 알림 (stderr — stdout은 MCP 용)
-      const kindLabel = {
-        captcha: "CAPTCHA",
-        approval: "승인",
-        credential: "자격증명",
-        choice: "선택",
-        text: "텍스트",
-      };
-      process.stderr.write(
-        `\n[tfx-hub] 사용자 입력 요청 (${kindLabel[kind] || kind})\n` +
-          `  요청자: ${requester_agent}\n` +
-          `  내용: ${prompt}\n` +
-          `  ID: ${result.request_id}\n` +
-          `  제한: ${Math.round(deadline_ms / 1000)}초\n\n`,
-      );
-
-      return { ok: true, data: result };
-    },
-
-    /**
-     * 사용자 입력 응답 제출
-     * 유효성 검증 → 상태 업데이트 → 요청자에게 응답 메시지 전달
-     */
-    submitHumanInput({
-      request_id,
-      action,
-      content = null,
-      submitted_by = "human",
-    }) {
-      // 요청 조회
-      const hr = store.getHumanRequest(request_id);
-      if (!hr) {
-        return {
-          ok: false,
-          error: { code: "NOT_FOUND", message: `요청 없음: ${request_id}` },
-        };
-      }
-      if (hr.state !== "pending") {
-        return {
-          ok: false,
-          error: {
-            code: "ALREADY_HANDLED",
-            message: `이미 처리됨: ${hr.state}`,
-          },
-        };
-      }
-
-      // 상태 매핑
-      const stateMap = {
-        accept: "accepted",
-        decline: "declined",
-        cancel: "cancelled",
-      };
-      const newState = stateMap[action];
-      if (!newState) {
-        return {
-          ok: false,
-          error: {
-            code: "INVALID_ACTION",
-            message: `잘못된 action: ${action}`,
-          },
-        };
-      }
-
-      // DB 업데이트
-      store.updateHumanRequest(request_id, newState, content);
-
-      // 요청자에게 응답 메시지 전달
-      let forwardedMessageId = null;
-      if (action === "accept" || action === "decline") {
-        const published = forwardHumanResponse({
-          requesterAgent: hr.requester_agent,
-          requestId: request_id,
-          action,
-          content,
-          submittedBy: submitted_by,
-          correlationId: hr.correlation_id,
-          traceId: hr.trace_id,
-          priority: 7,
-        });
-        forwardedMessageId = published.data?.message_id || null;
-      }
-
-      return {
-        ok: true,
-        data: {
-          request_id,
-          new_state: newState,
-          forwarded_message_id: forwardedMessageId,
-        },
-      };
-    },
-
-    /**
-     * 만료된 요청 자동 처리
-     * deadline 초과 시 default_action 적용
-     */
-    checkTimeouts() {
-      const pending = store.getPendingHumanRequests();
-      const now = Date.now();
-      const expired = pending.filter((hr) => hr.deadline_ms <= now);
-      if (!expired.length) return 0;
-
-      const expireRequests = () => {
-        for (const hr of expired) {
-          store.updateHumanRequest(hr.request_id, "timed_out", null);
-          if (hr.default_action === "timeout_continue") {
-            forwardHumanResponse({
-              requesterAgent: hr.requester_agent,
-              requestId: hr.request_id,
-              action: "timeout_continue",
-              content: null,
-              submittedBy: "system",
-              correlationId: hr.correlation_id,
-              traceId: hr.trace_id,
-              priority: 5,
-            });
-          }
-        }
-        return expired.length;
-      };
-
-      const processExpired = store.db?.transaction
-        ? store.db.transaction(expireRequests)
-        : expireRequests;
-
-      return processExpired();
-    },
-
-    /** 대기 중인 요청 목록 */
-    getPendingRequests() {
-      return store.getPendingHumanRequests();
-    },
-  };
-}

package/hub/lib/known-errors.json

@@ -1,72 +0,0 @@
-{
-  "$schema": "Neural Memory 에러 시그니처 시드 — 자동 학습 전 수동 등록 패턴",
-  "version": 1,
-  "signatures": {
-    "ssh-powershell-devnull": {
-      "pattern": "Could not find a part of the path.*dev.null",
-      "tool": "Bash",
-      "context": "SSH 명령 실행",
-      "root_cause": "원격 호스트가 PowerShell인데 bash 문법(2>/dev/null)을 사용",
-      "dna_factor": "remote.os",
-      "rule_template": "원격 호스트 {host}는 PowerShell 기본 셸. 2>/dev/null 대신 2>$null, && 대신 ;, $(cmd) 대신 $(cmd) PowerShell 구문 사용.",
-      "fix": "PowerShell 호스트에서는 2>/dev/null 대신 2>$null 사용",
-      "confidence_base": 0.95,
-      "severity": "high"
-    },
-    "ssh-powershell-ampamp": {
-      "pattern": "The token '&&' is not a valid statement separator",
-      "tool": "Bash",
-      "context": "SSH 명령 실행",
-      "root_cause": "원격 호스트가 PowerShell인데 bash의 && 연결자를 사용",
-      "dna_factor": "remote.os",
-      "rule_template": "원격 호스트 {host}는 PowerShell 기본 셸. && 대신 ; 사용.",
-      "fix": "PowerShell 호스트에서는 && 대신 ; 사용",
-      "confidence_base": 0.95,
-      "severity": "high"
-    },
-    "codex-sandbox-duplicate": {
-      "pattern": "cannot be used multiple times",
-      "tool": "Bash",
-      "context": "codex exec 실행",
-      "root_cause": "config.toml sandbox 설정과 CLI 플래그(--full-auto) 중복",
-      "dna_factor": "cli.codex.config.sandbox",
-      "rule_template": "Codex config.toml에 sandbox=\"{value}\" 설정이 있으므로 CLI에서 --full-auto 플래그 사용 금지",
-      "fix": "config.toml에 기본값을 두고, CLI에서는 --profile만 선택",
-      "confidence_base": 0.95,
-      "severity": "critical"
-    },
-    "codex-exec-approval-stall": {
-      "pattern": "Reading additional input from stdin",
-      "tool": "Bash",
-      "context": "codex exec 비대화형 실행",
-      "root_cause": "codex exec이 config.toml approval_mode를 무시하여 무한 대기",
-      "dna_factor": null,
-      "rule_template": "codex exec은 config.toml approval_mode를 무시함. 반드시 --dangerously-bypass-approvals-and-sandbox 명시적 추가 필수",
-      "fix": "codex exec 호출 시 항상 --dangerously-bypass-approvals-and-sandbox 플래그 포함",
-      "confidence_base": 1.0,
-      "severity": "critical"
-    },
-    "ssh-stdin-hang": {
-      "pattern": "Reading additional input from stdin|Pseudo-terminal will not be allocated",
-      "tool": "Bash",
-      "context": "SSH 원격 CLI 실행",
-      "root_cause": "SSH 세션에서 stdin이 리다이렉트되지 않음",
-      "dna_factor": null,
-      "rule_template": "SSH 원격 실행 시 ssh -n 또는 stdin: 'ignore' 옵션으로 stdin 리다이렉트 필수",
-      "fix": "execFileSync('ssh', [...], { stdio: ['ignore', 'pipe', 'pipe'] })",
-      "confidence_base": 0.9,
-      "severity": "high"
-    },
-    "psmux-node-not-found": {
-      "pattern": "node: not found|node: command not found",
-      "tool": "Bash",
-      "context": "psmux 세션에서 node 실행",
-      "root_cause": "psmux 세션이 PowerShell 7인데 bash 경로의 node를 참조",
-      "dna_factor": "multiplexer.name",
-      "rule_template": "psmux pane은 PowerShell 7 환경. bash PATH의 node 경로가 아닌 PowerShell PATH를 사용해야 함. wrapCliForBash 래핑 금지.",
-      "fix": "PowerShell 네이티브 명령 사용, bash 래핑 금지",
-      "confidence_base": 0.9,
-      "severity": "high"
-    }
-  }
-}