@futdevpro/ccap 1.1.2509 → 1.1.2585

package/server/build/src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal-runner-versions.control-service.spec.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * REQ-SYS-INSTALL-VERSION-CHECK-001 (cycle 781a): per-session runner version
+ * tracking a `cc:register` payload-ból (`runnerVersion` mező). A
+ * `CC_AdapterTerminal_ControlService.runnerVersions` Map ad data-source-ot
+ * a no-ACK error-context-hez (versionStatus: matches-server / mismatch /
+ * unknown-pre-cycle-781) és a `/api/cc-session/version-info` endpointnak
+ * (Settings → Version-info szekció táblázata).
+ *
+ * Pattern: Object.create + privát mezők kézi init (cycle 187 minta).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const cc_adapter_terminal_control_service_1 = require("./cc-adapter-terminal.control-service");
+describe('CC_AdapterTerminal_ControlService runner-versions (cycle 781a REQ-SYS-INSTALL-VERSION-CHECK-001 Slice A)', () => {
+    /** Object.create-vel létrehozott instance + üres `runnerVersions` Map. */
+    function buildSvc() {
+        const svc = Object.create(cc_adapter_terminal_control_service_1.CC_AdapterTerminal_ControlService.prototype);
+        svc.runnerVersions =
+            new Map();
+        return svc;
+    }
+    /** Privát Map elérés reflektíven (csak teszthez). */
+    function readVersionsMap(svc) {
+        return svc.runnerVersions;
+    }
+    describe('getRunnerVersion', () => {
+        it('| ismeretlen sessionId → undefined', () => {
+            const svc = buildSvc();
+            expect(svc.getRunnerVersion('ccs-not-registered')).toBeUndefined();
+        });
+        it('| ismert sessionId → eltárolt verzió-string', () => {
+            const svc = buildSvc();
+            readVersionsMap(svc).set('ccs-known', '1.1.2500');
+            expect(svc.getRunnerVersion('ccs-known')).toBe('1.1.2500');
+        });
+    });
+    describe('listAllRunnerVersions', () => {
+        it('| üres Map → üres tömb', () => {
+            const svc = buildSvc();
+            expect(svc.listAllRunnerVersions()).toEqual([]);
+        });
+        it('| egy regisztrált runner → 1-elemű tömb sessionId+runnerVersion mezőkkel', () => {
+            const svc = buildSvc();
+            readVersionsMap(svc).set('ccs-A', '1.1.2400');
+            const result = svc.listAllRunnerVersions();
+            expect(result).toEqual([{ sessionId: 'ccs-A', runnerVersion: '1.1.2400' }]);
+        });
+        it('| több regisztrált runner → minden entry külön tuple-ként', () => {
+            const svc = buildSvc();
+            readVersionsMap(svc).set('ccs-A', '1.1.2400');
+            readVersionsMap(svc).set('ccs-B', '1.1.2500');
+            readVersionsMap(svc).set('ccs-C', '1.1.2562');
+            const result = svc.listAllRunnerVersions();
+            expect(result.length).toBe(3);
+            // Map-iteration insertion-order garantált (Map spec) → stabil tömb.
+            expect(result).toContain({ sessionId: 'ccs-A', runnerVersion: '1.1.2400' });
+            expect(result).toContain({ sessionId: 'ccs-B', runnerVersion: '1.1.2500' });
+            expect(result).toContain({ sessionId: 'ccs-C', runnerVersion: '1.1.2562' });
+        });
+    });
+});
+//# sourceMappingURL=cc-adapter-terminal-runner-versions.control-service.spec.js.map

package/server/build/src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal-runner-versions.control-service.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-adapter-terminal-runner-versions.control-service.spec.js","sourceRoot":"","sources":["../../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal-runner-versions.control-service.spec.ts"],"names":[],"mappings":"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"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal.control-service.d.ts

@@ -12,6 +12,12 @@ import { CC_OutputCallback_Type, CC_ProcessStateCallback_Type, CC_SessionConfig_
  */
 export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonService {
     static getInstance(): CC_AdapterTerminal_ControlService;
+    /**
+     * BUG-CC-TERM-HANG-001: server-restart grace iter cap a sendInputViaTerminal
+     * polling-hoz — `runnerGracePeriodSec * 2` formula 60-iter (30s) cap-pel,
+     * hogy a 1h idle-timeout grace ne 60 perces HTTP-hang-ot okozzon.
+     */
+    static computeServerRestartGraceIterations(runnerGracePeriodSec: number): number;
     /** Terminal mode: sessionId → runner Socket.IO connection. */
     private terminalSockets;
     /** Terminal mode: sessionId → terminalId (UUID). */
@@ -39,12 +45,7 @@ export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonSe
     /** Terminal mode: pending ack sequence per session — a throttle timer fire-kor ezt küldi.
      * Minden új output frissíti a legmagasabbra; a timer nem nulláza újra a throttle-t. */
     private pendingAckSequence;
-    /**
-     * Cycle 781 (REQ-SYS-INSTALL-VERSION-CHECK-001): per-session runner version
-     * a `cc:register` payload-ből. Ha a runner pre-cycle-781 build-ből van
-     * (nincs `runnerVersion` mező), a Map-ben nem szerepel a session.
-     * A verzió-info endpoint + no-ACK error context használja.
-     */
+    /** Cycle 781: per-session runner version a `cc:register`-ből. */
     private runnerVersions;
     /** Terminal mode enabled flag (settings alapján, a manager állítja be).
      * Default: true Windows-on (cmd.exe detached) — ha a settings lekérdezés sikertelen, is nyíljon
@@ -82,6 +83,12 @@ export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonSe
     /** Stop execution flag: session-ek amelyeknél a kill után waitingInput-ra váltunk (nem terminated).
      * A handleTerminalProcessExit-ben használjuk, az adapter stoppedSessions referencia-ját tükrözi. */
     private stoppedSessions;
+    /**
+     * REQ-CC-EXIT-REASON-001 — shared kill-ok map (az adapter pendingKillReasons referencia).
+     * A kill site-ok (terminal mode disconnect-all, restart, runner-evict) markPendingKill-szerűen
+     * írják, a handleTerminalProcessExit kiolvassa és törli, és átadja a classifyExitStatus-nak.
+     */
+    private pendingKillReasons;
     /**
      * Output callback beállítása (az adapter hívja bootstrap-kor).
      */
@@ -114,6 +121,12 @@ export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonSe
      * A handleTerminalProcessExit használja, hogy stop execution után waitingInput-ra váltson.
      */
     setStoppedSessions(stoppedSessions: Set<string>): void;
+    /**
+     * REQ-CC-EXIT-REASON-001 — pendingKillReasons map referencia beállítása (az adapter hívja
+     * bootstrap-kor). Shared map: ugyanaz az instance, amibe az adapter `markPendingKill`
+     * is ír. A handleTerminalProcessExit használja a kill ok kiolvasásához.
+     */
+    setPendingKillReasons(map: Map<string, string>): void;
     /**
      * Terminal mode bekapcsolt állapot lekérdezése.
      */
@@ -160,46 +173,21 @@ export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonSe
         sessionId: string;
     }): void;
     /**
-     * Összes terminal runner socket lecsatlakoztatása (graceful shutdown).
-     * Minden csatlakozott runner-nek cc:kill + disconnect-et küldünk — a runner az
-     * 'io server disconnect' reason miatt process.exit(0)-tal lép ki.
-     * Szükséges, mert a manager handleGracefulShutdown-ja a sessionConfigs map-ből
-     * iterál, de a momentán lecsatlakozott (reconnect-re váró) runner-ek ott nem
-     * feltétlenül szerepelnek. Ez a metódus szélesebb halmazt fed le.
+     * Összes terminal runner socket lecsatlakoztatása (graceful shutdown) — cc:kill +
+     * disconnect minden csatlakozott runner-nek. Szélesebb halmazt fed le mint a manager
+     * sessionConfigs alapú iterációja (lecsatlakozott / reconnect-re váró runner-ek is).
      */
     disconnectAllRunners(): void;
-    /**
-     * Cycle 781 (REQ-SYS-INSTALL-VERSION-CHECK-001): runner verzió lekérdezése
-     * a sessionId-hez. Undefined ha:
-     *   - a session-nek nincs aktív runner (nem regisztrált a futás során), VAGY
-     *   - a runner pre-cycle-781 build-ből, ami nem küldte a verzióját.
-     * Ezek megkülönböztetését a `hasActiveRunner` (terminalSockets-ben szerepel)
-     * + a Map jelenléte adja vissza.
-     */
+    /** Cycle 781: runner version sessionId-hez (undefined ha pre-781 / nincs registration). */
     getRunnerVersion(sessionId: string): string | undefined;
-    /**
-     * Cycle 781e (REQ-SYS-INSTALL-VERSION-CHECK-001 Slice E): runner kill +
-     * respawn egy hívásban. A user UI-ról triggereli, ha verzió-mismatch van
-     * vagy a runner nem reagál (pl. konzisztens no-ACK fire-pattern).
-     *
-     * Lépések:
-     * 1. Ha van aktív socket: `cc:kill` SIGTERM + disconnect → a runner
-     *    process.exit(0)-tal kilép, a CMD/terminál ablak bezárul.
-     * 2. In-memory state cleanup (sockets, terminalIds, runnerVersions).
-     * 3. `spawnTerminalRunner` új ablakot nyit a friss npm-installed
-     *    runner-rel — az új cycle 769+ ACK protokoll-tudó verzióval, ha a
-     *    user közben `npm i -g @futdevpro/ccap@latest`-tel frissítette.
-     */
+    /** Cycle 781e: runner kill + respawn egy hívásban (UI-button trigger). */
     restartRunner(params: {
         sessionId: string;
         workspacePath: string;
     }): Promise<{
         terminalId: string;
     }>;
-    /**
-     * Cycle 781: az összes ismert (sessionId → runnerVersion) párt listázza.
-     * A version-info endpoint használja a /errors page UI-on / Settings-ben.
-     */
+    /** Cycle 781: összes (sessionId → runnerVersion) pair (version-info endpoint). */
     listAllRunnerVersions(): {
         sessionId: string;
         runnerVersion: string;
@@ -313,14 +301,10 @@ export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonSe
      */
     private handleTerminalProcessExit;
     /**
-     * Terminal runner buffered output kezelése (cc:buffered-output — reconnect után flush).
-     * A runner a reconnect pillanatában flush-öli a buffert, de a manager runtimeState-e
-     * még nem feltétlenül létezik (a recovery nem futott le). Az output-ot a normál
-     * handleOutput-on átadjuk (ha van runtimeState, azonnal feldolgozódik), ÉS
-     * a pendingBufferedOutputs-ba is mentjük — a manager a runtimeState létrehozása után
-     * consumePendingBufferedOutput()-tal lekéri és újra feldolgozza.
-     * Sequence dedup (REQ-CCSESS-TR-002): a már feldolgozott sequence-ű item-eket eldobjuk.
-     * Batch végén azonnali `cc:ack` megy vissza a legmagasabb feldolgozott sequence-szel.
+     * Terminal runner buffered output (cc:buffered-output — reconnect flush). Az
+     * output-ot a normál handleOutput-ra adjuk + pendingBufferedOutputs-ba mentjük (a
+     * manager recovery után consumePendingBufferedOutput-tal replay-eli). Sequence dedup
+     * REQ-CCSESS-TR-002; batch végén azonnali cc:ack a legmagasabb feldolgozott sequence-re.
      */
     private handleTerminalBufferedOutput;
     /**
@@ -362,14 +346,10 @@ export declare class CC_AdapterTerminal_ControlService extends DyNTS_SingletonSe
      */
     private handleProcessStateChange;
     /**
-     * Session lezárás guard: aszinkron DB ellenőrzés — ha a session már lezárt
-     * (completed/terminated/errored) vagy nem létezik, a runner-t kiutasítjuk
-     * (cc:kill + disconnect). Fire-and-forget — a regisztrációt nem blokkolja.
-     *
-     * Tipikus eset: szerver restart → recovery lezárja a session-t (grace period lejárt,
-     * runner nem csatlakozott időben) → a runner CMD ablak túlélte és később mégis
-     * visszacsatlakozik. Enélkül a runner a lifecycle idle timeout-ig (10 perc)
-     * feleslegesen nyitva maradna, pipeline restart-onként halmozódva.
+     * Session lezárás guard: ha a session DB-állapota completed/terminated/errored vagy
+     * törölt, a runner-t cc:kill + disconnect-tel kiutasítjuk (fire-and-forget).
+     * Tipikus eset: server restart → recovery lezárta a session-t, de a runner CMD ablak
+     * túlélte és reconnect-elt — enélkül idle-timeout-ig nyitva maradna.
      */
     private rejectRunnerIfSessionClosed;
     /**

package/server/build/src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal.control-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cc-adapter-terminal.control-service.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal.control-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cc-adapter-terminal.control-service.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal.control-service.ts"],"names":[],"mappings":"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"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_services/core/terminal/cc-adapter-terminal.control-service.js

@@ -17,7 +17,10 @@ const instance_id_service_1 = require("../../../../../_services/instance-id.serv
 const cc_status_enum_1 = require("../../../_enums/cc-status.enum");
 const cc_cli_args_util_1 = require("../../../_collections/utils/cc-cli-args.util");
 const cc_process_exit_util_1 = require("../../../_collections/utils/lifecycle/cc-process-exit.util");
+const cc_kill_reasons_const_1 = require("../../../_collections/consts/cc-kill-reasons.const");
 const tls_linux_terminal_spawn_util_1 = require("../../../../../../ccap-agent/_modules/tools/_collections/utils/exec/tls-linux-terminal-spawn.util");
+const sq_session_type_enum_1 = require("../../../../../../session-queue/_enums/sq-session-type.enum");
+const session_queue_control_service_1 = require("../../../../../../session-queue/_services/control-services/session-queue.control-service");
 const claude_code_data_service_1 = require("../claude-code.data-service");
 const cc_terminal_data_service_1 = require("./cc-terminal.data-service");
 const cc_terminal_lifecycle_control_service_1 = require("./cc-terminal-lifecycle.control-service");
@@ -35,6 +38,16 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
     static getInstance() {
         return CC_AdapterTerminal_ControlService.getSingletonInstance();
     }
+    /**
+     * BUG-CC-TERM-HANG-001: server-restart grace iter cap a sendInputViaTerminal
+     * polling-hoz — `runnerGracePeriodSec * 2` formula 60-iter (30s) cap-pel,
+     * hogy a 1h idle-timeout grace ne 60 perces HTTP-hang-ot okozzon.
+     */
+    static computeServerRestartGraceIterations(runnerGracePeriodSec) {
+        const desired = Math.max(0, Math.floor(runnerGracePeriodSec)) * 2;
+        const cap = 60;
+        return Math.min(desired, cap);
+    }
     // ── Terminal mode fields ──────────────────────────────────────
     /** Terminal mode: sessionId → runner Socket.IO connection. */
     terminalSockets = new Map();
@@ -63,12 +76,7 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
     /** Terminal mode: pending ack sequence per session — a throttle timer fire-kor ezt küldi.
      * Minden új output frissíti a legmagasabbra; a timer nem nulláza újra a throttle-t. */
     pendingAckSequence = new Map();
-    /**
-     * Cycle 781 (REQ-SYS-INSTALL-VERSION-CHECK-001): per-session runner version
-     * a `cc:register` payload-ből. Ha a runner pre-cycle-781 build-ből van
-     * (nincs `runnerVersion` mező), a Map-ben nem szerepel a session.
-     * A verzió-info endpoint + no-ACK error context használja.
-     */
+    /** Cycle 781: per-session runner version a `cc:register`-ből. */
     runnerVersions = new Map();
     /** Terminal mode enabled flag (settings alapján, a manager állítja be).
      * Default: true Windows-on (cmd.exe detached) — ha a settings lekérdezés sikertelen, is nyíljon
@@ -107,6 +115,12 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
     /** Stop execution flag: session-ek amelyeknél a kill után waitingInput-ra váltunk (nem terminated).
      * A handleTerminalProcessExit-ben használjuk, az adapter stoppedSessions referencia-ját tükrözi. */
     stoppedSessions = new Set();
+    /**
+     * REQ-CC-EXIT-REASON-001 — shared kill-ok map (az adapter pendingKillReasons referencia).
+     * A kill site-ok (terminal mode disconnect-all, restart, runner-evict) markPendingKill-szerűen
+     * írják, a handleTerminalProcessExit kiolvassa és törli, és átadja a classifyExitStatus-nak.
+     */
+    pendingKillReasons = new Map();
     // ── Callback setters ───────────────────────────────────────
     /**
      * Output callback beállítása (az adapter hívja bootstrap-kor).
@@ -155,6 +169,14 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
     setStoppedSessions(stoppedSessions) {
         this.stoppedSessions = stoppedSessions;
     }
+    /**
+     * REQ-CC-EXIT-REASON-001 — pendingKillReasons map referencia beállítása (az adapter hívja
+     * bootstrap-kor). Shared map: ugyanaz az instance, amibe az adapter `markPendingKill`
+     * is ír. A handleTerminalProcessExit használja a kill ok kiolvasásához.
+     */
+    setPendingKillReasons(map) {
+        this.pendingKillReasons = map;
+    }
     // ── Public accessor methods ──────────────────────────────────
     /**
      * Terminal mode bekapcsolt állapot lekérdezése.
@@ -211,12 +233,9 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         });
     }
     /**
-     * Összes terminal runner socket lecsatlakoztatása (graceful shutdown).
-     * Minden csatlakozott runner-nek cc:kill + disconnect-et küldünk — a runner az
-     * 'io server disconnect' reason miatt process.exit(0)-tal lép ki.
-     * Szükséges, mert a manager handleGracefulShutdown-ja a sessionConfigs map-ből
-     * iterál, de a momentán lecsatlakozott (reconnect-re váró) runner-ek ott nem
-     * feltétlenül szerepelnek. Ez a metódus szélesebb halmazt fed le.
+     * Összes terminal runner socket lecsatlakoztatása (graceful shutdown) — cc:kill +
+     * disconnect minden csatlakozott runner-nek. Szélesebb halmazt fed le mint a manager
+     * sessionConfigs alapú iterációja (lecsatlakozott / reconnect-re váró runner-ek is).
      */
     disconnectAllRunners() {
         const count = this.terminalSockets.size;
@@ -225,6 +244,7 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         }
         fsm_dynamo_1.DyFM_Log.info(`CC_AdapterTerminal | disconnectAllRunners | count: ${count}`);
         for (const [sessionId, socket] of this.terminalSockets.entries()) {
+            this.pendingKillReasons.set(sessionId, cc_kill_reasons_const_1.CC_KILL_REASONS.serverShutdown);
             try {
                 socket.emit('cc:kill', { signal: 'SIGTERM' });
             }
@@ -245,35 +265,17 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         this.terminalIds.clear();
     }
     // ── Terminal mode: public API ────────────────────────────────
-    /**
-     * Cycle 781 (REQ-SYS-INSTALL-VERSION-CHECK-001): runner verzió lekérdezése
-     * a sessionId-hez. Undefined ha:
-     *   - a session-nek nincs aktív runner (nem regisztrált a futás során), VAGY
-     *   - a runner pre-cycle-781 build-ből, ami nem küldte a verzióját.
-     * Ezek megkülönböztetését a `hasActiveRunner` (terminalSockets-ben szerepel)
-     * + a Map jelenléte adja vissza.
-     */
+    /** Cycle 781: runner version sessionId-hez (undefined ha pre-781 / nincs registration). */
     getRunnerVersion(sessionId) {
         return this.runnerVersions.get(sessionId);
     }
-    /**
-     * Cycle 781e (REQ-SYS-INSTALL-VERSION-CHECK-001 Slice E): runner kill +
-     * respawn egy hívásban. A user UI-ról triggereli, ha verzió-mismatch van
-     * vagy a runner nem reagál (pl. konzisztens no-ACK fire-pattern).
-     *
-     * Lépések:
-     * 1. Ha van aktív socket: `cc:kill` SIGTERM + disconnect → a runner
-     *    process.exit(0)-tal kilép, a CMD/terminál ablak bezárul.
-     * 2. In-memory state cleanup (sockets, terminalIds, runnerVersions).
-     * 3. `spawnTerminalRunner` új ablakot nyit a friss npm-installed
-     *    runner-rel — az új cycle 769+ ACK protokoll-tudó verzióval, ha a
-     *    user közben `npm i -g @futdevpro/ccap@latest`-tel frissítette.
-     */
+    /** Cycle 781e: runner kill + respawn egy hívásban (UI-button trigger). */
     async restartRunner(params) {
         const sessionId = params.sessionId;
         // 1. Aktív socket killing.
         const existingSocket = this.terminalSockets.get(sessionId);
         if (existingSocket) {
+            this.pendingKillReasons.set(sessionId, cc_kill_reasons_const_1.CC_KILL_REASONS.runnerRestart);
             try {
                 existingSocket.emit('cc:kill', { signal: 'SIGTERM' });
             }
@@ -304,10 +306,7 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
             workspacePath: params.workspacePath,
         });
     }
-    /**
-     * Cycle 781: az összes ismert (sessionId → runnerVersion) párt listázza.
-     * A version-info endpoint használja a /errors page UI-on / Settings-ben.
-     */
+    /** Cycle 781: összes (sessionId → runnerVersion) pair (version-info endpoint). */
     listAllRunnerVersions() {
         const out = [];
         for (const [sessionId, runnerVersion] of this.runnerVersions.entries()) {
@@ -563,10 +562,15 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
                 }),
             });
         }
-        // Várakozás a register event-re (max 15 másodperc).
+        // Várakozás a register event-re (BUG-CC-TERM-CLOSE-PREMATURE-001: 15s → 30s,
+        // npm-cache-miss / első spawn cover; queue-fallback safety net marad).
+        const REGISTER_TIMEOUT_MS = 30000;
         this.terminalIds.set(params.sessionId, terminalId);
         try {
-            await this.waitForTerminalRegister({ sessionId: params.sessionId, timeoutMs: 15000 });
+            await this.waitForTerminalRegister({
+                sessionId: params.sessionId,
+                timeoutMs: REGISTER_TIMEOUT_MS,
+            });
         }
         catch (err) {
             // Cleanup: a runner nem regisztrált időben — orphaned state eltávolítása.
@@ -612,14 +616,20 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
             && (this.hadRunnerSet.has(params.sessionId) || isServerRestartWindow);
         if (graceWillRun) {
             // graceIterations:
-            //  - server-restart window: full grace (runnerGracePeriodSec * 2 iter, 500ms each)
-            //  - had-runner-disconnected: rövidített grace (4 iter = 2s) — user-closed window,
-            //    runner nem fog visszajönni, ne blokkoljuk a HTTP request-et 30s-ig
+            //  - server-restart window: capped grace (max 60 iter = 30s, 500ms each).
+            //    BUG-CC-TERM-HANG-001 (2026-05-07): a `runnerGracePeriodSec * 2` formula
+            //    a default 3600s lifecycle-érték miatt 7200 iter = 60min HTTP-blokkolást
+            //    okozott (user-bug: „üzenet küldéskor csak teker és teker, és el is
+            //    tűnik az üzenet"). A `runnerGracePeriodSec` lifecycle-célra (idle-timeout)
+            //    van, NEM HTTP-send-blokkra. 30s bőven elég ahhoz, hogy egy érvényesen
+            //    reconnect-elő runner befigyeljen; utána fail-fast → spawnTerminalRunner.
+            //  - had-runner-disconnected: rövidített grace (4 iter = 2s) — user-closed
+            //    window, runner nem fog visszajönni, ne blokkoljuk a HTTP request-et 30s-ig
             const graceCase = isServerRestartWindow
                 ? 'server-restart'
                 : 'had-runner-disconnected';
             const graceIterations = isServerRestartWindow
-                ? this.runnerGracePeriodSec * 2
+                ? CC_AdapterTerminal_ControlService.computeServerRestartGraceIterations(this.runnerGracePeriodSec)
                 : 4;
             fsm_dynamo_1.DyFM_Log.info(`CC_AdapterTerminal | grace-period-enter`
                 + ` | session: ${params.sessionId}`
@@ -693,16 +703,9 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         cc_terminal_lifecycle_control_service_1.CC_TerminalLifecycle_ControlService.getInstance().touchRunnerActivity({
             sessionId: params.sessionId,
         });
-        // REQ-SYS-SILENT-001 Slice 1A (cycle 769): Socket.IO ACK pattern + timeout
-        // watchdog. Korábban `socket.emit('cc:spawn-prompt', payload)` fire-and-forget
-        // volt — HTTP 200 ment a kliensnek, DE a Socket.IO packet a hálózati pufferben
-        // elveszhetett, runner SOHA nem kapta meg a prompt-ot. SILENT FAIL.
-        //
-        // Most a Socket.IO `socket.timeout(N).emit(event, payload, callback)` API-val:
-        // - Ha runner ACK-ol N ms-en belül → callback(null, ackData) → info-log
-        // - Ha timeout / error → callback(err, null) → DyFM_Error rögzítés
-        //   `errorCode='CCAP-CC-PROMPT-NO-ACK'` a /errors page-en a user lássa
-        //
+        // REQ-SYS-SILENT-001 Slice 1A (cycle 769): Socket.IO ACK + timeout watchdog.
+        // Korábban fire-and-forget — silent fail ha a runner nem kapta meg.
+        // Most: timeout/error → CCAP-CC-PROMPT-NO-ACK errorCode a /errors-be.
         // Backward compat: a régi runner (ACK-mentes) timeout-tal jelez; az updated
         // runner (cycle 769 cc-terminal-runner.ts) ACK-ol — gradient kompatibilitás.
         const ACK_TIMEOUT_MS = 8000;
@@ -714,18 +717,9 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         }, (ackErr, ackData) => {
             const elapsedMs = Date.now() - promptStartMs;
             if (ackErr) {
-                // REQ-SYS-SILENT-001 Slice 2A (cycle 772): User-visible bubble + status
-                // revert. A cycle 769 ACK-detektálás a /errors page-re tette a hibát, DE
-                // a felhasználó az aktuális chat-ben SEMMIT nem látott (HTTP 200 már
-                // visszament; státusz `running`-ban ragadt; output sosem érkezett).
-                // User-panasz: „el-el nyelődnek üzenetek mindenféle resolve és error
-                // nélkül". Most:
-                //   (a) stderr-marker chat-bubble (`[CC_PROMPT_DELIVERY_FAILED]`) az
-                //       overflow-mintát követve — handleOutput → CC_Event persist +
-                //       socket broadcast → UI timeline.
-                //   (b) status revert `waitingInput`-ra: a user azonnal újra-küldhet
-                //       a frozen `running` helyett.
-                //   (c) /errors page-re továbbra is rögzítjük (globalErrorHandler).
+                // Cycle 772: user-visible bubble (`[CC_PROMPT_DELIVERY_FAILED]` stderr
+                // marker → CC_Event + socket broadcast) + status revert waitingInput-ra
+                // + /errors page record (globalErrorHandler). Silent-fail vége.
                 this.handleOutput({
                     sessionId: params.sessionId,
                     type: 'stderr',
@@ -749,15 +743,8 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
                     statusMessage: `Prompt delivery failed — runner did not acknowledge within ${ACK_TIMEOUT_MS}ms`
                         + ` (this may indicate an older runner without ACK protocol support — check version)`,
                 });
-                // Cycle 781 (REQ-SYS-INSTALL-VERSION-CHECK-001): runner-version aware
-                // diagnostics. Ha a runner nem küldte a verzióját (pre-cycle-781 build,
-                // tipikusan a cycle 769 ACK-protokoll-mentes runner is), explicit
-                // jelezzük a /errors page-en, hogy `npm i -g @futdevpro/ccap@latest`
-                // kell. A regression-detect a cycle 780 fix-annotation registry-vel
-                // megy: a CCAP-CC-PROMPT-NO-ACK errorCode v1.1.2473+ build-ből
-                // automatikusan REGRESSION-ként jelölődik (azaz valódi probléma) —
-                // ELLENBEN ha a runnerVersion régi, akkor a runner az ok és nem
-                // a server-side regression.
+                // Cycle 781: runner-version aware diagnostics — ha outdated runner
+                // a no-ACK oka, a /errors-en explicit látszik a `npm i -g` hint.
                 const runnerVersion = this.runnerVersions.get(params.sessionId);
                 const runnerVersionStatus = !runnerVersion ? 'unknown-pre-cycle-781'
                     : runnerVersion === version_const_1.CCAP_VERSION ? 'matches-server'
@@ -990,6 +977,22 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
             socket: params.socket,
             terminalId: terminalId,
         });
+        // BUG-CC-TERM-HANG-001 (2026-05-07): queue drain on register. Ha a route
+        // előzőleg `CCAP-CCS-TERMINAL-NOT-CONNECTED` / `CCAP-CCS-TERMINAL-REG-TIMEOUT`
+        // miatt enqueue-olta a user prompt-ot, most amikor a runner megérkezik,
+        // azonnal próbáljuk delivery-zni. A queue belső `canReceiveInput` USS-check
+        // dönti el, hogy ténylegesen kiküldhető-e — ha még nem (pl. status starting),
+        // a queue saját debounce-szal próbálkozik újra. Fire-and-forget: nem blokkolja
+        // a regisztrációt, error → warn-log.
+        session_queue_control_service_1.SessionQueue_ControlService.getInstance().tryDeliverNext({
+            sessionType: sq_session_type_enum_1.SQ_SessionType_Type.ccSession,
+            sessionId: sessionId,
+            skipDebounce: true,
+        }).catch((err) => {
+            fsm_dynamo_1.DyFM_Log.warn(`CC_AdapterTerminal | tryDeliverNext on register failed`
+                + ` | session: ${sessionId}`
+                + ` | error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(err)}`);
+        });
     }
     /**
      * Terminal runner output event kezelése (cc:output).
@@ -1102,6 +1105,9 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         const signal = typeof data.signal === 'string' ? data.signal : null;
         const isStopExecution = this.stoppedSessions.has(sessionId);
         this.stoppedSessions.delete(sessionId);
+        // REQ-CC-EXIT-REASON-001 — kill ok kiolvasása + törlése (egyszeri használat).
+        const killReason = this.pendingKillReasons.get(sessionId);
+        this.pendingKillReasons.delete(sessionId);
         // Cycle 231: a duplikált inline status-klasszifikáció kiemelve
         // CC_ProcessExit_Util.classifyExitStatus-be (cc-adapter direct mode is ezt
         // használja). Cycle 227 signal-kill detekció + cycle 230 statusMessage
@@ -1110,6 +1116,7 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
             code: code,
             signal: signal,
             isStopExecution: isStopExecution,
+            killReason: killReason,
         });
         this.handleProcessStateChange({
             sessionId: sessionId,
@@ -1120,14 +1127,10 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
         });
     }
     /**
-     * Terminal runner buffered output kezelése (cc:buffered-output — reconnect után flush).
-     * A runner a reconnect pillanatában flush-öli a buffert, de a manager runtimeState-e
-     * még nem feltétlenül létezik (a recovery nem futott le). Az output-ot a normál
-     * handleOutput-on átadjuk (ha van runtimeState, azonnal feldolgozódik), ÉS
-     * a pendingBufferedOutputs-ba is mentjük — a manager a runtimeState létrehozása után
-     * consumePendingBufferedOutput()-tal lekéri és újra feldolgozza.
-     * Sequence dedup (REQ-CCSESS-TR-002): a már feldolgozott sequence-ű item-eket eldobjuk.
-     * Batch végén azonnali `cc:ack` megy vissza a legmagasabb feldolgozott sequence-szel.
+     * Terminal runner buffered output (cc:buffered-output — reconnect flush). Az
+     * output-ot a normál handleOutput-ra adjuk + pendingBufferedOutputs-ba mentjük (a
+     * manager recovery után consumePendingBufferedOutput-tal replay-eli). Sequence dedup
+     * REQ-CCSESS-TR-002; batch végén azonnali cc:ack a legmagasabb feldolgozott sequence-re.
      */
     handleTerminalBufferedOutput(params) {
         const data = params.data;
@@ -1398,14 +1401,10 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
     }
     // ── Private: session completion guard ─────────────────────────
     /**
-     * Session lezárás guard: aszinkron DB ellenőrzés — ha a session már lezárt
-     * (completed/terminated/errored) vagy nem létezik, a runner-t kiutasítjuk
-     * (cc:kill + disconnect). Fire-and-forget — a regisztrációt nem blokkolja.
-     *
-     * Tipikus eset: szerver restart → recovery lezárja a session-t (grace period lejárt,
-     * runner nem csatlakozott időben) → a runner CMD ablak túlélte és később mégis
-     * visszacsatlakozik. Enélkül a runner a lifecycle idle timeout-ig (10 perc)
-     * feleslegesen nyitva maradna, pipeline restart-onként halmozódva.
+     * Session lezárás guard: ha a session DB-állapota completed/terminated/errored vagy
+     * törölt, a runner-t cc:kill + disconnect-tel kiutasítjuk (fire-and-forget).
+     * Tipikus eset: server restart → recovery lezárta a session-t, de a runner CMD ablak
+     * túlélte és reconnect-elt — enélkül idle-timeout-ig nyitva maradna.
      */
     rejectRunnerIfSessionClosed(params) {
         const localCcapId = instance_id_service_1.ExS_InstanceId_Service.getInstance().getInstanceId();
@@ -1518,6 +1517,10 @@ class CC_AdapterTerminal_ControlService extends nts_dynamo_1.DyNTS_SingletonServ
      * + lifecycle deregisztráció + hadRunnerSet törlés.
      */
     killAndDisconnectRunner(params) {
+        // REQ-CC-EXIT-REASON-001 — a kiutasítás okát (`completion-guard`, `verify-mismatch`,
+        // stb.) `runner-evict:<reason>` formában rögzítjük, hogy a process-exit handler
+        // a statusMessage-ben részletes okot tudjon adni.
+        this.pendingKillReasons.set(params.sessionId, `${cc_kill_reasons_const_1.CC_KILL_REASONS.runnerEvict}:${params.reason}`);
         try {
             params.socket.emit('cc:kill', { signal: 'SIGTERM' });
         }