@futdevpro/ccap 1.1.2956 → 1.1.2960

package/cli/build/_commands/logs.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_LogsCommand_Util = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/** Home + log paths. */
+const HOME_DIR = process.env.HOME ?? process.env.USERPROFILE ?? '.';
+const SERVER_LOG_PATH = path.join(HOME_DIR, '.ccap', 'server.log');
+const CLIENT_LOG_PATH = path.join(HOME_DIR, '.ccap', 'client.log');
+/** Default kezdeti sor-darabszám. */
+const DEFAULT_INITIAL_LINES = 50;
+/** Polling interval a tail-loop-hoz (ms). `fs.watchFile` pollold (no inotify dependency). */
+const TAIL_POLL_INTERVAL_MS = 1000;
+/** Egy időbélyeg-detektálás regex — log sorok elején `[2026-05-09T...]` formátum. */
+const TIMESTAMP_PREFIX_REGEX = /\[(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z?)\]/;
+/**
+ * REQ-CLI-LOGS-001 — `ccap logs` parancs. Kiírja a server (vagy `--client`)
+ * log fájl utolsó N sorát, opcionálisan filter / since szűréssel, majd
+ * tail-mode-ban (default) live-stream-eli a növekedést SIGINT-ig.
+ *
+ * Használat:
+ *   ccap logs                       # default: server log, last 50 lines, follow
+ *   ccap logs --client              # client log
+ *   ccap logs --no-follow           # csak a kezdeti sorok, nincs tail
+ *   ccap logs --lines 200           # több kezdeti sor
+ *   ccap logs --filter ERROR        # csak `ERROR` regex-illeszkedés
+ *   ccap logs --since 1h            # utolsó 1 óra
+ *   ccap logs --since 30m --filter "user-flow"
+ */
+class CCAP_LogsCommand_Util {
+    /**
+     * `ccap logs` parancs main entry-point.
+     */
+    static async c_ccapLogs(opts) {
+        const logPath = opts.client === true ? CLIENT_LOG_PATH : SERVER_LOG_PATH;
+        const lines = opts.lines && opts.lines > 0 ? opts.lines : DEFAULT_INITIAL_LINES;
+        const follow = opts.follow !== false;
+        const sinceMs = opts.since ? CCAP_LogsCommand_Util.parseSinceToMs(opts.since) : null;
+        const filterRegex = opts.filter ? CCAP_LogsCommand_Util.compileFilter(opts.filter) : null;
+        if (!fs.existsSync(logPath)) {
+            fsm_dynamo_1.DyFM_Log.warn(`Log fájl nem található: ${logPath} — még nem indult el a ${opts.client === true ? 'client' : 'server'}?`);
+            return;
+        }
+        fsm_dynamo_1.DyFM_Log.info(`📜 Log fájl: ${logPath}${follow ? ' (tail mode — Ctrl+C kilépés)' : ' (no-follow)'}`);
+        if (filterRegex)
+            fsm_dynamo_1.DyFM_Log.info(`🔍 Filter: ${filterRegex.source}`);
+        if (sinceMs !== null)
+            fsm_dynamo_1.DyFM_Log.info(`⏱  Since: ${opts.since} (${new Date(sinceMs).toISOString()})`);
+        // 1. Kezdeti N sor kiírása (filter + since alkalmazva)
+        const initialContent = fs.readFileSync(logPath, 'utf-8');
+        const allLines = initialContent.split('\n');
+        const lastN = allLines.slice(-lines);
+        for (const line of lastN) {
+            CCAP_LogsCommand_Util.printIfMatch(line, filterRegex, sinceMs);
+        }
+        // 2. Tail mód — `fs.watchFile` polling (cross-platform, no inotify dependency)
+        if (follow) {
+            let lastSize = fs.statSync(logPath).size;
+            let lastBuffer = ''; // partial-line carry-over
+            const onChange = (curr) => {
+                if (curr.size <= lastSize) {
+                    // truncated or no growth — skip
+                    if (curr.size < lastSize) {
+                        fsm_dynamo_1.DyFM_Log.warn('⚠ Log fájl truncate-elve / lerövidítve — tail folytatása az új tartalomtól.');
+                        lastBuffer = '';
+                    }
+                    lastSize = curr.size;
+                    return;
+                }
+                const fd = fs.openSync(logPath, 'r');
+                try {
+                    const bytesToRead = curr.size - lastSize;
+                    const buffer = Buffer.alloc(bytesToRead);
+                    fs.readSync(fd, buffer, 0, bytesToRead, lastSize);
+                    lastSize = curr.size;
+                    const chunk = lastBuffer + buffer.toString('utf-8');
+                    const newLines = chunk.split('\n');
+                    lastBuffer = newLines.pop() ?? '';
+                    for (const line of newLines) {
+                        CCAP_LogsCommand_Util.printIfMatch(line, filterRegex, sinceMs);
+                    }
+                }
+                finally {
+                    fs.closeSync(fd);
+                }
+            };
+            fs.watchFile(logPath, { interval: TAIL_POLL_INTERVAL_MS }, onChange);
+            // SIGINT handler — clean exit
+            await new Promise((resolve) => {
+                const cleanup = () => {
+                    fs.unwatchFile(logPath, onChange);
+                    fsm_dynamo_1.DyFM_Log.info('\n🛑 Tail leállítva.');
+                    resolve();
+                };
+                process.once('SIGINT', cleanup);
+                process.once('SIGTERM', cleanup);
+            });
+        }
+    }
+    /**
+     * Egy sor printelése ha a filter + since (mindkettő) átengedi.
+     * Üres sorokat skip-eli.
+     */
+    static printIfMatch(line, filterRegex, sinceMs) {
+        if (!line || !line.trim()) {
+            return;
+        }
+        if (filterRegex && !filterRegex.test(line)) {
+            return;
+        }
+        if (sinceMs !== null) {
+            const lineMs = CCAP_LogsCommand_Util.extractTimestampMs(line);
+            // Ha nincs felismerhető időbélyeg, a sort átengedjük (a separator-block
+            // és a multi-line stack-trace sorok tipikusan ilyenek — egy filter-es
+            // user csak a filter-t akarja igazából, a since-t laza heurisztikának)
+            if (lineMs !== null && lineMs < sinceMs) {
+                return;
+            }
+        }
+        // Raw stdout — log-tail kimenet pipe-olható (grep, less); DyFM_Log prefix
+        // korrumpálná. A `no-console-log` review-szabály csak `console.log`-ra
+        // vonatkozik, `process.stdout.write` engedélyezett.
+        process.stdout.write(line + '\n');
+    }
+    /**
+     * `1h`, `30m`, `2d`, `45s` → milliszekundum-kü szám (vissza-szorzott a since-time-stamp-et).
+     * Hibás formátumra null (a since szűrés ekkor nem aktív).
+     */
+    static parseSinceToMs(since) {
+        const trimmed = since.trim();
+        const m = trimmed.match(/^(\d+)\s*(s|m|h|d)$/i);
+        if (!m) {
+            fsm_dynamo_1.DyFM_Log.warn(`⚠ Érvénytelen --since formátum: "${since}". Várt: 30s | 5m | 2h | 1d. Filter mellőzve.`);
+            return null;
+        }
+        const n = parseInt(m[1], 10);
+        const unit = m[2].toLowerCase();
+        const unitMs = {
+            s: 1000,
+            m: 60 * 1000,
+            h: 60 * 60 * 1000,
+            d: 24 * 60 * 60 * 1000,
+        };
+        const cutoffAgo = n * (unitMs[unit] ?? 1000);
+        return Date.now() - cutoffAgo;
+    }
+    /**
+     * Filter regex kompilálás. Hibára null + warn.
+     */
+    static compileFilter(pattern) {
+        try {
+            return new RegExp(pattern);
+        }
+        catch (err) {
+            fsm_dynamo_1.DyFM_Log.warn(`⚠ Érvénytelen --filter regex: "${pattern}" — ${err instanceof Error ? err.message : String(err)}. Filter mellőzve.`);
+            return null;
+        }
+    }
+    /**
+     * Sor első időbélyeg-prefixéből milliszekundum-érték. Null ha nincs felismerhető timestamp.
+     * (Több sor a CCAP server log-ban prefix nélkül jön — separator-blokkok, stack-trace sorok.)
+     */
+    static extractTimestampMs(line) {
+        const m = line.match(TIMESTAMP_PREFIX_REGEX);
+        if (!m) {
+            return null;
+        }
+        const ms = Date.parse(m[1]);
+        return Number.isFinite(ms) ? ms : null;
+    }
+}
+exports.CCAP_LogsCommand_Util = CCAP_LogsCommand_Util;
+//# sourceMappingURL=logs.js.map

package/cli/build/_commands/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/_commands/logs.ts"],"names":[],"mappings":"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"}

package/cli/build/_commands/logs.spec.d.ts

@@ -0,0 +1,7 @@
+/**
+ * REQ-CLI-LOGS-001 — `ccap logs` parancs unit-tesztek a tiszta helper-ekre
+ * (since parser, filter compile, timestamp extract, printIfMatch szűrés).
+ * A tail-mode-ot (fs.watchFile + SIGINT) nem teszteljük itt — integrációs.
+ */
+export {};
+//# sourceMappingURL=logs.spec.d.ts.map

package/cli/build/_commands/logs.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.spec.d.ts","sourceRoot":"","sources":["../../src/_commands/logs.spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/cli/build/_commands/logs.spec.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * REQ-CLI-LOGS-001 — `ccap logs` parancs unit-tesztek a tiszta helper-ekre
+ * (since parser, filter compile, timestamp extract, printIfMatch szűrés).
+ * A tail-mode-ot (fs.watchFile + SIGINT) nem teszteljük itt — integrációs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const logs_1 = require("./logs");
+describe('CCAP_LogsCommand_Util.parseSinceToMs', () => {
+    it('| `30s` → most - 30s', () => {
+        const before = Date.now();
+        const result = logs_1.CCAP_LogsCommand_Util.parseSinceToMs('30s');
+        const after = Date.now();
+        expect(result).not.toBeNull();
+        expect(result).toBeGreaterThanOrEqual(before - 30_000);
+        expect(result).toBeLessThanOrEqual(after - 30_000 + 100);
+    });
+    it('| `5m` → most - 5*60*1000', () => {
+        const before = Date.now();
+        const result = logs_1.CCAP_LogsCommand_Util.parseSinceToMs('5m');
+        expect(result).toBeLessThanOrEqual(before - 5 * 60_000 + 100);
+    });
+    it('| `2h` → most - 2*60*60*1000', () => {
+        const before = Date.now();
+        const result = logs_1.CCAP_LogsCommand_Util.parseSinceToMs('2h');
+        expect(result).toBeLessThanOrEqual(before - 2 * 60 * 60_000 + 100);
+    });
+    it('| `1d` → most - 24*60*60*1000', () => {
+        const before = Date.now();
+        const result = logs_1.CCAP_LogsCommand_Util.parseSinceToMs('1d');
+        expect(result).toBeLessThanOrEqual(before - 24 * 60 * 60_000 + 100);
+    });
+    it('| whitespace toleráns', () => {
+        expect(logs_1.CCAP_LogsCommand_Util.parseSinceToMs('  30 s  ')).not.toBeNull();
+    });
+    it('| érvénytelen formátum → null', () => {
+        expect(logs_1.CCAP_LogsCommand_Util.parseSinceToMs('garbage')).toBeNull();
+        expect(logs_1.CCAP_LogsCommand_Util.parseSinceToMs('30')).toBeNull(); // egység nélkül
+        expect(logs_1.CCAP_LogsCommand_Util.parseSinceToMs('5z')).toBeNull(); // ismeretlen egység
+    });
+});
+describe('CCAP_LogsCommand_Util.compileFilter', () => {
+    it('| valid regex → RegExp objektum', () => {
+        const r = logs_1.CCAP_LogsCommand_Util.compileFilter('ERROR|WARN');
+        expect(r).not.toBeNull();
+        expect(r.test('this is an ERROR')).toBeTrue();
+        expect(r.test('this is OK')).toBeFalse();
+    });
+    it('| invalid regex → null', () => {
+        const r = logs_1.CCAP_LogsCommand_Util.compileFilter('[unclosed');
+        expect(r).toBeNull();
+    });
+});
+describe('CCAP_LogsCommand_Util.extractTimestampMs', () => {
+    it('| ISO timestamp prefix → ms', () => {
+        const line = '[2026-05-09T18:30:00.000Z] some log content';
+        const ms = logs_1.CCAP_LogsCommand_Util.extractTimestampMs(line);
+        expect(ms).toBe(Date.parse('2026-05-09T18:30:00.000Z'));
+    });
+    it('| ISO timestamp Z nélkül is parsolja', () => {
+        const line = '[2026-05-09T18:30:00] no Z';
+        expect(logs_1.CCAP_LogsCommand_Util.extractTimestampMs(line)).not.toBeNull();
+    });
+    it('| nincs timestamp → null', () => {
+        expect(logs_1.CCAP_LogsCommand_Util.extractTimestampMs('plain log line')).toBeNull();
+    });
+    it('| szöveg közepén levő bracket-tartalom is illeszkedik (heurisztikus)', () => {
+        const line = '   ERROR: at [2026-05-09T18:30:00.000Z] something happened';
+        expect(logs_1.CCAP_LogsCommand_Util.extractTimestampMs(line)).not.toBeNull();
+    });
+});
+describe('CCAP_LogsCommand_Util.printIfMatch', () => {
+    let stdoutSpy;
+    beforeEach(() => {
+        // A logs.ts `process.stdout.write`-t használ a raw kimenethez (NEM
+        // `console.log`-ot, mert a `no-console-log` review-szabály tiltja és
+        // mert a JSON / log-tail output pipe-olható kell legyen).
+        stdoutSpy = spyOn(process.stdout, 'write').and.returnValue(true);
+    });
+    it('| üres / whitespace sor → nem print', () => {
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('', null, null);
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('   ', null, null);
+        expect(stdoutSpy).not.toHaveBeenCalled();
+    });
+    it('| filter nélkül + since nélkül → mindig print', () => {
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('any line', null, null);
+        expect(stdoutSpy).toHaveBeenCalledOnceWith('any line\n');
+    });
+    it('| filter regex illeszkedés → print', () => {
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('hello ERROR world', /ERROR/, null);
+        expect(stdoutSpy).toHaveBeenCalledOnceWith('hello ERROR world\n');
+    });
+    it('| filter regex NEM illeszkedik → nem print', () => {
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('hello world', /ERROR/, null);
+        expect(stdoutSpy).not.toHaveBeenCalled();
+    });
+    it('| since-cutoff előtt timestamp → nem print', () => {
+        const sinceMs = Date.parse('2026-05-09T18:30:00.000Z');
+        const oldLine = '[2026-05-09T18:00:00.000Z] old line';
+        logs_1.CCAP_LogsCommand_Util.printIfMatch(oldLine, null, sinceMs);
+        expect(stdoutSpy).not.toHaveBeenCalled();
+    });
+    it('| since-cutoff után timestamp → print', () => {
+        const sinceMs = Date.parse('2026-05-09T18:30:00.000Z');
+        const recentLine = '[2026-05-09T19:00:00.000Z] recent line';
+        logs_1.CCAP_LogsCommand_Util.printIfMatch(recentLine, null, sinceMs);
+        expect(stdoutSpy).toHaveBeenCalledOnceWith(recentLine + '\n');
+    });
+    it('| since aktív + nincs felismerhető timestamp → print (lazy heurisztika)', () => {
+        const sinceMs = Date.parse('2026-05-09T18:30:00.000Z');
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('plain line, no timestamp', null, sinceMs);
+        expect(stdoutSpy).toHaveBeenCalled();
+    });
+    it('| filter + since együtt — mindkettőnek pass-olnia kell', () => {
+        const sinceMs = Date.parse('2026-05-09T18:30:00.000Z');
+        logs_1.CCAP_LogsCommand_Util.printIfMatch('[2026-05-09T19:00:00.000Z] ERROR: oh no', /ERROR/, sinceMs);
+        expect(stdoutSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=logs.spec.js.map

package/cli/build/_commands/logs.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.spec.js","sourceRoot":"","sources":["../../src/_commands/logs.spec.ts"],"names":[],"mappings":"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"}

package/cli/build/_commands/update.d.ts

@@ -1,22 +1,26 @@
 /**
- * CCAP update parancs util: npm update -g a csomagra, majd rendszer újraindítás.
+ * CCAP update parancs util: globális csomag-frissítés + rendszer újraindítás.
  * Globális NPM telepítés ellenőrzéssel (figyelmeztetés, ha nem globális; --force flag skip-eli).
  *
- * BUG-CLI-RESTART-UPDATE-001 Pillar C Slice 1 (cycle 725): visible-status output
- * minden szakaszhoz — a user explicit kérése volt: „we should add more logs".
- *
- * BUG-CLI-UPDATE-NPM-VISIBILITY-001 (cycle 745): a user reprodukálta hogy a 725-ös
- * vizuális javítás KEVÉS — `npm update -g` execSync(stdio: inherit) néha láthatóan
- * beragad-szerűen viselkedik (npm registry-tartalom-letöltés ~1-2 perc, közben semmi
- * output). Cycle 745 kibővít: (a) start ÉS end szakaszban kiírja a LOCAL futó +
- * GLOBAL telepített + REMOTE registry-elérhető verziót egymás mellett; (b) az npm
- * execSync helyett spawn-based runner heartbeat-tel (30s-enként eltelt-idő üzenet);
- * (c) post-update elapsed-time kiírása a vége-blokkba.
+ * BUG-CLI-UPDATE-AUTO-STOP-001 (cycle a user-bug-report alapján): három javítás.
+ *  1. Auto-stop a npm-step ELŐTT — a user korábban manuálisan kellett `ccap stop`-ot
+ *     futtasson, különben az npm install néha fájlt foglalt a futó server miatt.
+ *     Most a flow: stop → npm install -g @latest → start. Ha eleve nem futott
+ *     semmi, a stop no-op.
+ *  2. Skip-if-already-latest guard — pre-check: ha `globalVersion === remoteLatest`,
+ *     a npm-step + restart kihagyva (a flow exit-el „már naprakész" üzenettel).
+ *     `--force`-szal forszírozható (pl. újratelepítés sérült install-on).
+ *  3. `npm update -g` → `npm install -g <pkg>@latest` váltás a runner-ben — az
+ *     `update -g` csak a meglévő semver range-en belül mozog (gyakran nem ugrik
+ *     új minor/major-ra), így a user gyakran azt látta hogy a pre/post verzió
+ *     ugyanaz, hiába volt új release. Az `install -g <pkg>@latest` mindig a
+ *     registry-tip-re ugrik. (Spec: REQ-CLI-UPDATE-INSTALL-LATEST-001.)
  */
 export declare class CCAP_UpdateCommand_Util {
     /**
-     * CCAP update parancs: npm update -g a csomagra, majd rendszer újraindítás.
-     * @param params.force Ha true, nem globális NPM telepítés esetén is tovább megy.
+     * CCAP update parancs: stop → npm install -g @latest → start. Skip-if-latest guard.
+     * @param params.force Ha true, nem globális NPM telepítés esetén is tovább megy,
+     *   és skip-if-latest guardot is felüldarálja.
      */
     static c_ccapUpdate(params: {
         force?: boolean;

package/cli/build/_commands/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/_commands/update.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAuB;IAClC;;;OAGG;WACU,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+EtE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/_commands/update.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAuB;IAClC;;;;OAIG;WACU,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAwHtE"}

package/cli/build/_commands/update.js

@@ -4,30 +4,35 @@ exports.CCAP_UpdateCommand_Util = void 0;
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
 const process_control_util_1 = require("../_collections/process-control.util");
 const install_context_util_1 = require("../_collections/install-context.util");
+const update_error_buffer_util_1 = require("../_collections/update/update-error-buffer.util");
 const update_runner_util_1 = require("../_collections/update/update-runner.util");
 const update_version_check_util_1 = require("../_collections/update/update-version-check.util");
 const version_const_1 = require("../_collections/version.const");
 /** NPM csomagnév a globális frissítéshez. */
 const CCAP_NPM_PACKAGE_NAME = '@futdevpro/ccap';
 /**
- * CCAP update parancs util: npm update -g a csomagra, majd rendszer újraindítás.
+ * CCAP update parancs util: globális csomag-frissítés + rendszer újraindítás.
  * Globális NPM telepítés ellenőrzéssel (figyelmeztetés, ha nem globális; --force flag skip-eli).
  *
- * BUG-CLI-RESTART-UPDATE-001 Pillar C Slice 1 (cycle 725): visible-status output
- * minden szakaszhoz — a user explicit kérése volt: „we should add more logs".
- *
- * BUG-CLI-UPDATE-NPM-VISIBILITY-001 (cycle 745): a user reprodukálta hogy a 725-ös
- * vizuális javítás KEVÉS — `npm update -g` execSync(stdio: inherit) néha láthatóan
- * beragad-szerűen viselkedik (npm registry-tartalom-letöltés ~1-2 perc, közben semmi
- * output). Cycle 745 kibővít: (a) start ÉS end szakaszban kiírja a LOCAL futó +
- * GLOBAL telepített + REMOTE registry-elérhető verziót egymás mellett; (b) az npm
- * execSync helyett spawn-based runner heartbeat-tel (30s-enként eltelt-idő üzenet);
- * (c) post-update elapsed-time kiírása a vége-blokkba.
+ * BUG-CLI-UPDATE-AUTO-STOP-001 (cycle a user-bug-report alapján): három javítás.
+ *  1. Auto-stop a npm-step ELŐTT — a user korábban manuálisan kellett `ccap stop`-ot
+ *     futtasson, különben az npm install néha fájlt foglalt a futó server miatt.
+ *     Most a flow: stop → npm install -g @latest → start. Ha eleve nem futott
+ *     semmi, a stop no-op.
+ *  2. Skip-if-already-latest guard — pre-check: ha `globalVersion === remoteLatest`,
+ *     a npm-step + restart kihagyva (a flow exit-el „már naprakész" üzenettel).
+ *     `--force`-szal forszírozható (pl. újratelepítés sérült install-on).
+ *  3. `npm update -g` → `npm install -g <pkg>@latest` váltás a runner-ben — az
+ *     `update -g` csak a meglévő semver range-en belül mozog (gyakran nem ugrik
+ *     új minor/major-ra), így a user gyakran azt látta hogy a pre/post verzió
+ *     ugyanaz, hiába volt új release. Az `install -g <pkg>@latest` mindig a
+ *     registry-tip-re ugrik. (Spec: REQ-CLI-UPDATE-INSTALL-LATEST-001.)
  */
 class CCAP_UpdateCommand_Util {
     /**
-     * CCAP update parancs: npm update -g a csomagra, majd rendszer újraindítás.
-     * @param params.force Ha true, nem globális NPM telepítés esetén is tovább megy.
+     * CCAP update parancs: stop → npm install -g @latest → start. Skip-if-latest guard.
+     * @param params.force Ha true, nem globális NPM telepítés esetén is tovább megy,
+     *   és skip-if-latest guardot is felüldarálja.
      */
     static async c_ccapUpdate(params) {
         fsm_dynamo_1.DyFM_Log.info('===== CCAP frissítés =====');
@@ -47,26 +52,57 @@ class CCAP_UpdateCommand_Util {
         fsm_dynamo_1.DyFM_Log.info('   • Registry (remote) lekérés…');
         const preRemoteVersion = update_version_check_util_1.CCAP_UpdateVersionCheck_Util.getRemoteVersion(CCAP_NPM_PACKAGE_NAME);
         fsm_dynamo_1.DyFM_Log.info(`   • Registry (remote) elérhető:  ${preRemoteVersion || '(nem elérhető)'}`);
-        if (preGlobalVersion && preRemoteVersion && preGlobalVersion === preRemoteVersion) {
-            fsm_dynamo_1.DyFM_Log.info('ℹ️ A globálisan telepített verzió már megegyezik a registry-beli legfrissebbel.');
+        // BUG-CLI-UPDATE-AUTO-STOP-001 Pillar 2: skip-if-already-latest guard.
+        // Ha `--force` van, mindig megy az install (újratelepítés sérült install-on).
+        if (!params.force
+            && preGlobalVersion
+            && preRemoteVersion
+            && preGlobalVersion === preRemoteVersion) {
+            fsm_dynamo_1.DyFM_Log.info('');
+            fsm_dynamo_1.DyFM_Log.success(`✓ Már a legfrissebb verzió van telepítve (${preGlobalVersion}). Nincs teendő.`);
+            fsm_dynamo_1.DyFM_Log.info('ℹ️ Ha mégis újra akarod telepíteni (pl. sérült install), futtasd: `ccap update --force`.');
+            return;
         }
-        else if (preGlobalVersion && preRemoteVersion) {
+        if (preGlobalVersion && preRemoteVersion && preGlobalVersion !== preRemoteVersion) {
             fsm_dynamo_1.DyFM_Log.info(`📈 Várható frissítés: ${preGlobalVersion} → ${preRemoteVersion}`);
         }
-        // npm update -g — spawn + heartbeat.
+        // BUG-CLI-UPDATE-AUTO-STOP-001 Pillar 1: stop a npm-step előtt.
+        // A user korábban manuálisan kellett `ccap stop`-ot futtasson — most automata.
+        // A `stopServerAndClientAsync` no-op ha nincs futó process (PID fájl hiány).
+        fsm_dynamo_1.DyFM_Log.info('');
+        fsm_dynamo_1.DyFM_Log.info('🛑 Futó CCAP server / client leállítása az npm install előtt…');
+        await process_control_util_1.CCAP_ProcessControl_Util.stopServerAndClientAsync();
+        // BUG-CLI-UPDATE-AUTO-STOP-001 Pillar 3: install -g @latest (runner-ben).
         fsm_dynamo_1.DyFM_Log.info('');
-        fsm_dynamo_1.DyFM_Log.info(`📦 npm update -g ${CCAP_NPM_PACKAGE_NAME} futtatása (heartbeat 30s-enként)…`);
+        fsm_dynamo_1.DyFM_Log.info(`📦 npm install -g ${CCAP_NPM_PACKAGE_NAME}@latest futtatása (heartbeat 30s-enként)…`);
         const runResult = await update_runner_util_1.CCAP_UpdateRunner_Util.runNpmUpdate({
             packageName: CCAP_NPM_PACKAGE_NAME,
         });
         const elapsedRounded = Math.round(runResult.elapsedSec * 10) / 10;
         if (runResult.success) {
-            fsm_dynamo_1.DyFM_Log.success(`✓ npm update sikeres (${elapsedRounded}s).`);
+            fsm_dynamo_1.DyFM_Log.success(`✓ npm install sikeres (${elapsedRounded}s).`);
         }
         else {
-            fsm_dynamo_1.DyFM_Log.warn(`✗ npm update sikertelen (${elapsedRounded}s, exit=${runResult.exitCode}): ${runResult.errorMessage}`);
+            fsm_dynamo_1.DyFM_Log.warn(`✗ npm install sikertelen (${elapsedRounded}s, exit=${runResult.exitCode}): ${runResult.errorMessage}`);
             fsm_dynamo_1.DyFM_Log.warn('A frissítés nem futott le, de a server újraindítás folytatódik a jelenlegi verzióval. '
-                + 'Manuális recovery: `ccap repair` (BUG-CLI-RESTART-UPDATE-001 cycle 722) ha staging-stuck állapot.');
+                + 'Manuális recovery: `ccap repair` ha staging-stuck állapot.');
+            // REQ-UPD-ERROR-HANDLING-001: lokális JSONL buffer-be append, hogy a
+            // server bootstrap-jakor a `/errors` táblába is bekerüljön (a server
+            // most még nem fut — direkt persist nem lehetséges).
+            update_error_buffer_util_1.CCAP_UpdateErrorBuffer_Util.append({
+                errorCode: 'CCAP-CLI-UPDATE-NPM-FAIL-001',
+                message: `npm install -g ${CCAP_NPM_PACKAGE_NAME}@latest sikertelen: ${runResult.errorMessage}`,
+                source: 'cli-update',
+                additionalContent: {
+                    packageName: CCAP_NPM_PACKAGE_NAME,
+                    exitCode: runResult.exitCode,
+                    elapsedSec: elapsedRounded,
+                    preGlobalVersion: preGlobalVersion,
+                    preRemoteVersion: preRemoteVersion,
+                    runningCliVersion: version_const_1.CCAP_VERSION,
+                    force: params.force === true,
+                },
+            });
         }
         // Post-update version snapshot: local + global + remote újra.
         fsm_dynamo_1.DyFM_Log.info('');
@@ -80,12 +116,12 @@ class CCAP_UpdateCommand_Util {
             fsm_dynamo_1.DyFM_Log.success(`✓ Verzió-emelkedés detektálva: ${preGlobalVersion} → ${postGlobalVersion}`);
         }
         else if (postGlobalVersion && preGlobalVersion === postGlobalVersion) {
-            fsm_dynamo_1.DyFM_Log.info(`ℹ️ Globális verzió változatlan (${postGlobalVersion}) — már a legfrissebb, vagy az npm update nem talált új verziót.`);
+            fsm_dynamo_1.DyFM_Log.info(`ℹ️ Globális verzió változatlan (${postGlobalVersion}) — már a legfrissebb, vagy az npm install nem talált új verziót.`);
         }
-        // Restart
+        // Start (a stop már megtörtént — itt a friss kódból indítunk).
         fsm_dynamo_1.DyFM_Log.info('');
-        fsm_dynamo_1.DyFM_Log.info('🔁 Server újraindítása…');
-        await process_control_util_1.CCAP_ProcessControl_Util.restartServerAndClient();
+        fsm_dynamo_1.DyFM_Log.info('🔁 Server újraindítása (frissített kódból)…');
+        await process_control_util_1.CCAP_ProcessControl_Util.startServerAndClient();
         fsm_dynamo_1.DyFM_Log.info('');
         fsm_dynamo_1.DyFM_Log.success('✅ CCAP update flow lezárva.');
         fsm_dynamo_1.DyFM_Log.info('🔍 Ellenőrzés: `ccap --version` → friss verzió kiírja '

package/cli/build/_commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/_commands/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/_commands/update.ts"],"names":[],"mappings":"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"}

package/cli/build/program.js

@@ -21,6 +21,8 @@ const explore_1 = require("./_commands/explore");
 const review_1 = require("./_commands/review");
 const notify_1 = require("./_commands/notify");
 const repair_1 = require("./_commands/repair");
+const info_1 = require("./_commands/info");
+const logs_1 = require("./_commands/logs");
 const server_health_util_1 = require("./_collections/server-health.util");
 const ensure_setup_util_1 = require("./_collections/setup/ensure-setup.util");
 const version_const_1 = require("./_collections/version.const");
@@ -241,11 +243,48 @@ commander_1.program
     .action(() => {
     version_1.CCAP_VersionCommand_Util.c_ccapVersion();
 });
+// REQ-CLI-INFO-001 — `ccap info` diagnosztikai snapshot.
+commander_1.program
+    .command('info')
+    .description('Diagnosztikai snapshot: identity, server runtime, client runtime, config, '
+    + 'update-állapot, workspace. Bug-jelentésnél küldd el a kimenetet a `--json` '
+    + 'flag-gel együtt.')
+    .option('--json', 'Machine-readable JSON output (különben pretty)', false)
+    .action((opts) => {
+    info_1.CCAP_InfoCommand_Util.c_ccapInfo(opts).catch((err) => {
+        fsm_dynamo_1.DyFM_Error.logSimple('ccap info failed', err);
+        process.exit(1);
+    });
+});
+// REQ-CLI-LOGS-001 — `ccap logs` log tail + filter.
+commander_1.program
+    .command('logs')
+    .description('CCAP server (default) vagy client log live-tail-je. Kezdeti N sor + tail '
+    + '(`--no-follow`-val csak a kezdeti sorok). Filter regex és since (`30s|5m|2h|1d`) '
+    + 'támogatva.')
+    .option('--lines <n>', 'Kezdeti sorok száma a tail előtt (default: 50)', '50')
+    .option('--filter <pattern>', 'Regex filter — csak az illeszkedő sorokat mutatja')
+    .option('--since <duration>', 'Időszak szűrő pl. 30s | 5m | 2h | 1d')
+    .option('--client', 'Server log helyett a client log fájlt mutatja', false)
+    .option('--no-follow', 'Nem fut tail-loop, csak a kezdeti sorok kiírása')
+    .action((opts) => {
+    const normalized = {
+        lines: opts.lines ? parseInt(opts.lines, 10) : undefined,
+        filter: opts.filter,
+        since: opts.since,
+        client: opts.client === true,
+        follow: opts.follow !== false,
+    };
+    logs_1.CCAP_LogsCommand_Util.c_ccapLogs(normalized).catch((err) => {
+        fsm_dynamo_1.DyFM_Error.logSimple('ccap logs failed', err);
+        process.exit(1);
+    });
+});
 commander_1.program.parse();
 // Ha nincs alparancs: segédlet
 if (!process.argv.slice(2).length) {
     fsm_dynamo_1.DyFM_Log.info('CCAP Revisioned CLI – használat:'
-        + ' ccap <start|stop|restart|update|chat|config|init|status|sessions|palette|explore|review|vault-key|ver>');
+        + ' ccap <start|stop|restart|update|chat|config|init|status|sessions|palette|explore|review|vault-key|ver|info|logs>');
     commander_1.program.outputHelp();
 }
 //# sourceMappingURL=program.js.map