@ohos-cpf/3rdloop 0.0.1 → 0.0.3

package/vendor/Server/Routes/controllers/StatsController.js

@@ -1,57 +1,57 @@
-import { StatsService } from '../../library/StatsService.js';
-import { getSessionSemaphoreStats } from '../../Orchestrator/Orchestrator.js';
-
-/**
- * StatsController —— 统计控制器
- *
- * 职责：提供访问计数、Session 调用计数、Session 并发占用的查询接口。
- */
-class StatsController {
-
-    /**
-     * GET /api/stats/visit
-     * 获取页面访问计数，并自增（每次页面加载调用一次）
-     */
-    async visit(req, res) {
-        try {
-            const count = await StatsService.incrementVisitCount();
-            res.json({ success: true, data: { visitCount: count } });
-        } catch (err) {
-            res.json({ success: false, data: { visitCount: 0 }, error: err.message });
-        }
-    }
-
-    /**
-     * GET /api/stats/session/count
-     * 获取 Session 调用计数（只读，不自增）
-     */
-    async sessionCount(req, res) {
-        try {
-            const count = await StatsService.getSessionCount();
-            res.json({ success: true, data: { sessionCount: count } });
-        } catch (err) {
-            res.json({ success: false, data: { sessionCount: 0 }, error: err.message });
-        }
-    }
-
-    /**
-     * GET /api/stats/session/concurrency
-     * 获取全局 Session 并发占用快照（Orchestrator 进程级信号量）。
-     *
-     * 返回：
-     *   active   - 当前活跃 Session 数（正在执行的编排步骤数）
-     *   limit    - 并发上限（MAX_CONCURRENT_SESSIONS，默认 50）
-     *   waiting  - 排队等待槽位的步骤数
-     *   utilization - 占用率（0-100）
-     */
-    async sessionConcurrency(req, res) {
-        try {
-            const stats = getSessionSemaphoreStats();
-            res.json({ success: true, data: stats });
-        } catch (err) {
-            res.json({ success: false, data: null, error: err.message });
-        }
-    }
-}
-
-export default StatsController;
+import { StatsService } from '../../library/StatsService.js';
+import { getSessionSemaphoreStats } from '../../Orchestrator/Orchestrator.js';
+
+/**
+ * StatsController —— 统计控制器
+ *
+ * 职责：提供访问计数、Session 调用计数、Session 并发占用的查询接口。
+ */
+class StatsController {
+
+    /**
+     * GET /api/stats/visit
+     * 获取页面访问计数，并自增（每次页面加载调用一次）
+     */
+    async visit(req, res) {
+        try {
+            const count = await StatsService.incrementVisitCount();
+            res.json({ success: true, data: { visitCount: count } });
+        } catch (err) {
+            res.json({ success: false, data: { visitCount: 0 }, error: err.message });
+        }
+    }
+
+    /**
+     * GET /api/stats/session/count
+     * 获取 Session 调用计数（只读，不自增）
+     */
+    async sessionCount(req, res) {
+        try {
+            const count = await StatsService.getSessionCount();
+            res.json({ success: true, data: { sessionCount: count } });
+        } catch (err) {
+            res.json({ success: false, data: { sessionCount: 0 }, error: err.message });
+        }
+    }
+
+    /**
+     * GET /api/stats/session/concurrency
+     * 获取全局 Session 并发占用快照（Orchestrator 进程级信号量）。
+     *
+     * 返回：
+     *   active   - 当前活跃 Session 数（正在执行的编排步骤数）
+     *   limit    - 并发上限（MAX_CONCURRENT_SESSIONS，默认 50）
+     *   waiting  - 排队等待槽位的步骤数
+     *   utilization - 占用率（0-100）
+     */
+    async sessionConcurrency(req, res) {
+        try {
+            const stats = getSessionSemaphoreStats();
+            res.json({ success: true, data: stats });
+        } catch (err) {
+            res.json({ success: false, data: null, error: err.message });
+        }
+    }
+}
+
+export default StatsController;

package/vendor/Server/Routes/controllers/StreamController.js

@@ -1,67 +1,67 @@
-import SseHub from '../sse/SseHub.js';
-
-/**
- * StreamController —— SSE 实时推送控制器
- *
- * 职责：处理 SSE 订阅请求，将 HTTP 响应注册到 SseHub。
- * 不感知具体业务事件（步骤状态等），只负责连接管理。
- *
- * 事件由业务层（Agent Loop）通过 sseHub.emit() 推送，本控制器不产生事件。
- */
-class StreamController {
-    /**
-     * @param {SseHub} sseHub
-     */
-    constructor(sseHub) {
-        this.sseHub = sseHub;
-    }
-
-    /**
-     * GET /stream/tasks/:taskId
-     * 订阅指定任务的实时事件流
-     *
-     * 前端用法：
-     *   const es = new EventSource('/stream/tasks/task-xxx');
-     *   es.addEventListener('step:status', (e) => { ... });
-     *   es.addEventListener('step:completed', (e) => { ... });
-     */
-    async subscribeTask(req, res) {
-        const { taskId } = req.params;
-        const userId = req.query.userId || 'anonymous';
-
-        // 响应头已在 ResponseContext.stream() 中设置
-        res.stream();
-
-        const result = this.sseHub.subscribe(taskId, res.raw, {
-            userId,
-            initialData: {
-                taskId,
-                message: 'SSE 连接已建立',
-                timestamp: new Date().toISOString()
-            }
-        });
-
-        if (!result.ok) {
-            // 订阅被拒（限流等），已写入流头无法改 HTTP 状态码，
-            // 通过 SSE 事件通知客户端后关闭连接
-            this.sseHub.emit(taskId, 'error', {
-                code: result.errorCode,
-                message: result.message
-            });
-            res.raw.end();
-        }
-    }
-
-    /**
-     * GET /stream/stats
-     * 返回 SSE Hub 全局统计信息（REST 接口，非 SSE 流）
-     */
-    async stats(req, res) {
-        res.json({
-            ...this.sseHub.getStats(),
-            timestamp: new Date().toISOString()
-        });
-    }
-}
-
-export default StreamController;
+import SseHub from '../sse/SseHub.js';
+
+/**
+ * StreamController —— SSE 实时推送控制器
+ *
+ * 职责：处理 SSE 订阅请求，将 HTTP 响应注册到 SseHub。
+ * 不感知具体业务事件（步骤状态等），只负责连接管理。
+ *
+ * 事件由业务层（Agent Loop）通过 sseHub.emit() 推送，本控制器不产生事件。
+ */
+class StreamController {
+    /**
+     * @param {SseHub} sseHub
+     */
+    constructor(sseHub) {
+        this.sseHub = sseHub;
+    }
+
+    /**
+     * GET /stream/tasks/:taskId
+     * 订阅指定任务的实时事件流
+     *
+     * 前端用法：
+     *   const es = new EventSource('/stream/tasks/task-xxx');
+     *   es.addEventListener('step:status', (e) => { ... });
+     *   es.addEventListener('step:completed', (e) => { ... });
+     */
+    async subscribeTask(req, res) {
+        const { taskId } = req.params;
+        const userId = req.query.userId || 'anonymous';
+
+        // 响应头已在 ResponseContext.stream() 中设置
+        res.stream();
+
+        const result = this.sseHub.subscribe(taskId, res.raw, {
+            userId,
+            initialData: {
+                taskId,
+                message: 'SSE 连接已建立',
+                timestamp: new Date().toISOString()
+            }
+        });
+
+        if (!result.ok) {
+            // 订阅被拒（限流等），已写入流头无法改 HTTP 状态码，
+            // 通过 SSE 事件通知客户端后关闭连接
+            this.sseHub.emit(taskId, 'error', {
+                code: result.errorCode,
+                message: result.message
+            });
+            res.raw.end();
+        }
+    }
+
+    /**
+     * GET /stream/stats
+     * 返回 SSE Hub 全局统计信息（REST 接口，非 SSE 流）
+     */
+    async stats(req, res) {
+        res.json({
+            ...this.sseHub.getStats(),
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+
+export default StreamController;

package/vendor/Server/Routes/library/logger.js

@@ -1,179 +1,179 @@
-/**
- * 轻量日志工具（支持文件持久化）
- *
- * 为 Routes 层提供统一日志接口。
- * - 控制台：带 ANSI 颜色的高亮输出
- * - 文件：纯文本（去除颜色码），按天轮转写入 db/log/app-YYYY-MM-DD.log
- *
- * 环境变量：
- *   LOG_LEVEL          日志级别（debug/info/warn/error），默认 info
- *   LOG_FILE_ENABLED   是否启用文件持久化（true/false），默认 true
- *   LOG_RETENTION_DAYS 日志保留天数，超过自动清理，默认 30
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
-const MIN_LEVEL = LEVELS[process.env.LOG_LEVEL ?? 'info'] ?? LEVELS.info;
-
-const COLORS = {
-    debug: '\x1b[90m',
-    info:  '\x1b[36m',
-    warn:  '\x1b[33m',
-    error: '\x1b[31m',
-    reset: '\x1b[0m'
-};
-
-// ─── 文件持久化配置 ──────────────────────────────────────────────────
-const FILE_ENABLED = process.env.LOG_FILE_ENABLED !== 'false';
-const RETENTION_DAYS = parseInt(process.env.LOG_RETENTION_DAYS ?? '30', 10);
-
-// 解析 db/ 根目录：从 Server/Routes/library/ 上溯 4 层到 workspace 根
-const DB_ROOT = path.resolve(__dirname, '..', '..', '..', '..', 'db');
-const LOG_DIR = path.join(DB_ROOT, 'log');
-
-/** @type {import('node:fs').WriteStream | null} */
-let _stream = null;
-let _streamDate = '';
-
-/**
- * 获取当天日期字符串 (YYYY-MM-DD)。
- */
-function _today() {
-    return new Date().toISOString().slice(0, 10);
-}
-
-/**
- * 获取（或轮转）当前日志文件的 WriteStream。
- * 日期变化时自动关闭旧流、创建新流，实现按天轮转。
- * @returns {import('node:fs').WriteStream | null}
- */
-function _getStream() {
-    if (!FILE_ENABLED) return null;
-
-    const today = _today();
-    if (_stream && _streamDate === today) {
-        return _stream;
-    }
-
-    // 日期变化 → 关闭旧流
-    if (_stream) {
-        _stream.end();
-        _stream = null;
-    }
-
-    try {
-        fs.mkdirSync(LOG_DIR, { recursive: true });
-        const file = path.join(LOG_DIR, `app-${today}.log`);
-        _stream = fs.createWriteStream(file, { flags: 'a', encoding: 'utf8' });
-        _streamDate = today;
-        _stream.on('error', (err) => {
-            console.error(`[Logger] 文件写入失败，降级为仅控制台输出: ${err.message}`);
-            _stream = null;
-        });
-        // 启动时清理过期日志
-        _cleanupOldLogs();
-    } catch (err) {
-        console.error(`[Logger] 无法创建日志文件: ${err.message}`);
-        _stream = null;
-    }
-
-    return _stream;
-}
-
-/**
- * 清理超过保留天数的旧日志文件（幂等，失败静默）。
- */
-function _cleanupOldLogs() {
-    try {
-        const files = fs.readdirSync(LOG_DIR);
-        const now = Date.now();
-        const maxAgeMs = RETENTION_DAYS * 24 * 60 * 60 * 1000;
-        for (const file of files) {
-            if (!file.startsWith('app-') || !file.endsWith('.log')) continue;
-            const filePath = path.join(LOG_DIR, file);
-            const stat = fs.statSync(filePath);
-            if (now - stat.mtimeMs > maxAgeMs) {
-                fs.unlinkSync(filePath);
-                console.debug(`[Logger] 已清理过期日志: ${file}`);
-            }
-        }
-    } catch {
-        // 清理失败不影响主流程
-    }
-}
-
-// 进程退出时刷新写入流
-process.on('exit', () => {
-    if (_stream) {
-        _stream.end();
-    }
-});
-
-/**
- * 格式化日志行（带 ANSI 颜色，用于控制台）。
- */
-function format(level, tag, message, meta) {
-    const time = new Date().toISOString();
-    const prefix = `${COLORS[level]}${time} [${tag}] ${level.toUpperCase()}${COLORS.reset} ${message}`;
-    if (meta && Object.keys(meta).length > 0) {
-        return `${prefix} ${JSON.stringify(meta)}`;
-    }
-    return prefix;
-}
-
-/**
- * 格式化日志行（纯文本，用于文件写入）。
- */
-function formatPlain(level, tag, message, meta) {
-    const time = new Date().toISOString();
-    const prefix = `${time} [${tag}] ${level.toUpperCase()} ${message}`;
-    if (meta && Object.keys(meta).length > 0) {
-        return `${prefix} ${JSON.stringify(meta)}`;
-    }
-    return prefix;
-}
-
-/**
- * 将一行日志异步写入文件（非阻塞）。
- * @param {string} line
- */
-function _writeFile(line) {
-    const stream = _getStream();
-    if (stream) {
-        stream.write(line + '\n');
-    }
-}
-
-export function createLogger(tag) {
-    return {
-        debug: (msg, meta) => {
-            // debug 始终写入文件，但不打印到控制台
-            _writeFile(formatPlain('debug', tag, msg, meta));
-        },
-        info: (msg, meta) => {
-            if (LEVELS.info >= MIN_LEVEL) {
-                console.log(format('info', tag, msg, meta));
-                _writeFile(formatPlain('info', tag, msg, meta));
-            }
-        },
-        warn: (msg, meta) => {
-            if (LEVELS.warn >= MIN_LEVEL) {
-                console.warn(format('warn', tag, msg, meta));
-                _writeFile(formatPlain('warn', tag, msg, meta));
-            }
-        },
-        error: (msg, meta) => {
-            if (LEVELS.error >= MIN_LEVEL) {
-                console.error(format('error', tag, msg, meta));
-                _writeFile(formatPlain('error', tag, msg, meta));
-            }
-        }
-    };
-}
-
-export default createLogger;
+/**
+ * 轻量日志工具（支持文件持久化）
+ *
+ * 为 Routes 层提供统一日志接口。
+ * - 控制台：带 ANSI 颜色的高亮输出
+ * - 文件：纯文本（去除颜色码），按天轮转写入 db/log/app-YYYY-MM-DD.log
+ *
+ * 环境变量：
+ *   LOG_LEVEL          日志级别（debug/info/warn/error），默认 info
+ *   LOG_FILE_ENABLED   是否启用文件持久化（true/false），默认 true
+ *   LOG_RETENTION_DAYS 日志保留天数，超过自动清理，默认 30
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
+const MIN_LEVEL = LEVELS[process.env.LOG_LEVEL ?? 'info'] ?? LEVELS.info;
+
+const COLORS = {
+    debug: '\x1b[90m',
+    info:  '\x1b[36m',
+    warn:  '\x1b[33m',
+    error: '\x1b[31m',
+    reset: '\x1b[0m'
+};
+
+// ─── 文件持久化配置 ──────────────────────────────────────────────────
+const FILE_ENABLED = process.env.LOG_FILE_ENABLED !== 'false';
+const RETENTION_DAYS = parseInt(process.env.LOG_RETENTION_DAYS ?? '30', 10);
+
+// 解析 db/ 根目录：从 Server/Routes/library/ 上溯 4 层到 workspace 根
+const DB_ROOT = path.resolve(__dirname, '..', '..', '..', '..', 'db');
+const LOG_DIR = path.join(DB_ROOT, 'log');
+
+/** @type {import('node:fs').WriteStream | null} */
+let _stream = null;
+let _streamDate = '';
+
+/**
+ * 获取当天日期字符串 (YYYY-MM-DD)。
+ */
+function _today() {
+    return new Date().toISOString().slice(0, 10);
+}
+
+/**
+ * 获取（或轮转）当前日志文件的 WriteStream。
+ * 日期变化时自动关闭旧流、创建新流，实现按天轮转。
+ * @returns {import('node:fs').WriteStream | null}
+ */
+function _getStream() {
+    if (!FILE_ENABLED) return null;
+
+    const today = _today();
+    if (_stream && _streamDate === today) {
+        return _stream;
+    }
+
+    // 日期变化 → 关闭旧流
+    if (_stream) {
+        _stream.end();
+        _stream = null;
+    }
+
+    try {
+        fs.mkdirSync(LOG_DIR, { recursive: true });
+        const file = path.join(LOG_DIR, `app-${today}.log`);
+        _stream = fs.createWriteStream(file, { flags: 'a', encoding: 'utf8' });
+        _streamDate = today;
+        _stream.on('error', (err) => {
+            console.error(`[Logger] 文件写入失败，降级为仅控制台输出: ${err.message}`);
+            _stream = null;
+        });
+        // 启动时清理过期日志
+        _cleanupOldLogs();
+    } catch (err) {
+        console.error(`[Logger] 无法创建日志文件: ${err.message}`);
+        _stream = null;
+    }
+
+    return _stream;
+}
+
+/**
+ * 清理超过保留天数的旧日志文件（幂等，失败静默）。
+ */
+function _cleanupOldLogs() {
+    try {
+        const files = fs.readdirSync(LOG_DIR);
+        const now = Date.now();
+        const maxAgeMs = RETENTION_DAYS * 24 * 60 * 60 * 1000;
+        for (const file of files) {
+            if (!file.startsWith('app-') || !file.endsWith('.log')) continue;
+            const filePath = path.join(LOG_DIR, file);
+            const stat = fs.statSync(filePath);
+            if (now - stat.mtimeMs > maxAgeMs) {
+                fs.unlinkSync(filePath);
+                console.debug(`[Logger] 已清理过期日志: ${file}`);
+            }
+        }
+    } catch {
+        // 清理失败不影响主流程
+    }
+}
+
+// 进程退出时刷新写入流
+process.on('exit', () => {
+    if (_stream) {
+        _stream.end();
+    }
+});
+
+/**
+ * 格式化日志行（带 ANSI 颜色，用于控制台）。
+ */
+function format(level, tag, message, meta) {
+    const time = new Date().toISOString();
+    const prefix = `${COLORS[level]}${time} [${tag}] ${level.toUpperCase()}${COLORS.reset} ${message}`;
+    if (meta && Object.keys(meta).length > 0) {
+        return `${prefix} ${JSON.stringify(meta)}`;
+    }
+    return prefix;
+}
+
+/**
+ * 格式化日志行（纯文本，用于文件写入）。
+ */
+function formatPlain(level, tag, message, meta) {
+    const time = new Date().toISOString();
+    const prefix = `${time} [${tag}] ${level.toUpperCase()} ${message}`;
+    if (meta && Object.keys(meta).length > 0) {
+        return `${prefix} ${JSON.stringify(meta)}`;
+    }
+    return prefix;
+}
+
+/**
+ * 将一行日志异步写入文件（非阻塞）。
+ * @param {string} line
+ */
+function _writeFile(line) {
+    const stream = _getStream();
+    if (stream) {
+        stream.write(line + '\n');
+    }
+}
+
+export function createLogger(tag) {
+    return {
+        debug: (msg, meta) => {
+            // debug 始终写入文件，但不打印到控制台
+            _writeFile(formatPlain('debug', tag, msg, meta));
+        },
+        info: (msg, meta) => {
+            if (LEVELS.info >= MIN_LEVEL) {
+                console.log(format('info', tag, msg, meta));
+                _writeFile(formatPlain('info', tag, msg, meta));
+            }
+        },
+        warn: (msg, meta) => {
+            if (LEVELS.warn >= MIN_LEVEL) {
+                console.warn(format('warn', tag, msg, meta));
+                _writeFile(formatPlain('warn', tag, msg, meta));
+            }
+        },
+        error: (msg, meta) => {
+            if (LEVELS.error >= MIN_LEVEL) {
+                console.error(format('error', tag, msg, meta));
+                _writeFile(formatPlain('error', tag, msg, meta));
+            }
+        }
+    };
+}
+
+export default createLogger;