@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Routes/routes/brain.js

@@ -0,0 +1,47 @@
+import { Router } from '../router/Router.js';
+import BrainController from '../controllers/BrainController.js';
+
+/**
+ * Brain 路由注册
+ *
+ * 挂载点：/api/brain/*
+ *
+ * 路由列表：
+ *  POST   /plan              — 提交自然语言任务，返回拆解后的任务 JSON
+ *  POST   /plan-and-execute  — 拆解并直接提交 Orchestrator 执行
+ *  GET    /plans             — 列出所有拆解计划
+ *  GET    /plan              — 获取指定计划详情
+ *  GET    /status            — 获取 Brain 当前状态
+ *
+ * @param {object} dependencies - 共享依赖
+ * @param {object} [dependencies.sseHub]
+ * @param {object} [dependencies.storage]
+ * @param {object} [dependencies.orchestratorController]
+ * @param {BrainController} [dependencies.brainController] - 已有实例
+ * @returns {Router}
+ */
+export function createBrainRouter(dependencies) {
+    const controller =
+        dependencies.brainController ||
+        new BrainController({
+            sseHub: dependencies.sseHub,
+            storage: dependencies.storage,
+            orchestratorController: dependencies.orchestratorController,
+            skillDirectory: dependencies.skillDirectory
+        });
+
+    const router = new Router();
+
+    // ── 任务拆解 ──
+    router.post('/plan',             controller.plan.bind(controller));
+    router.post('/plan-and-execute', controller.planAndExecute.bind(controller));
+
+    // ── 查询 ──
+    router.get('/plans',             controller.plans.bind(controller));
+    router.get('/plan',              controller.planDetail.bind(controller));
+    router.get('/status',            controller.status.bind(controller));
+
+    return router;
+}
+
+export default createBrainRouter;

package/vendor/Server/Routes/routes/flexrunner.js

@@ -0,0 +1,72 @@
+import { Router } from '../router/Router.js';
+import FlexRunnerController from '../controllers/FlexRunnerController.js';
+
+/**
+ * FlexRunner 路由注册
+ *
+ * 挂载点：/api/flexrunner/*
+ *
+ * 路由列表：
+ *  POST   /init              — 初始化 FlexRunner 实例
+ *  POST   /execute           — 执行单次 executeStart
+ *  POST   /execute-loop      — 自动循环执行直到成功/不可重试
+ *  POST   /start-single      — 启动单次执行（创建单步骤编排任务，不走 Brain/LoopEngine）
+ *  GET    /status            — 查询实例状态
+ *  GET    /live-messages     — 获取实时对话消息
+ *  GET    /session           — 获取会话归档内容
+ *  POST   /control           — 控制执行（暂停/继续/终止）
+ *  POST   /check-result      — 检查结果文件状态
+ *  POST   /inject-prompt     — 向会话注入提示词（不触发 AI 回复）
+ *  POST   /send-and-wait     — 发送消息并同步等待 AI 回复
+ *  GET    /steps             — 列出任务步骤和文件
+ *  GET    /file              — 读取指定文件内容
+ *  GET    /archive           — 打包下载任务目录下全部 .md 报告（ZIP）
+ *  GET    /runners           — 列出所有已注册实例
+ *  DELETE /runner            — 移除一个实例
+ *
+ * @param {object} dependencies - 共享依赖
+ * @returns {Router}
+ */
+export function createFlexRunnerRouter(dependencies) {
+    // FlexRunnerController 是有状态的（管理多个实例），
+    // 使用 dependencies 中的共享实例，或自行创建单例。
+    // 传入 orchestratorController 以支持从编排器查找 FlexRunner 实例。
+    const controller = dependencies.flexRunnerController || new FlexRunnerController({
+        orchestratorController: dependencies.orchestratorController || null,
+        storage: dependencies.storage || null
+    });
+
+    const router = new Router();
+
+    // ── 初始化与执行 ──
+    router.post('/init',          controller.init.bind(controller));
+    router.post('/execute',       controller.execute.bind(controller));
+    router.post('/execute-loop',  controller.executeLoop.bind(controller));
+    router.post('/start-single',  controller.startSingle.bind(controller));
+
+    // ── 查询 ──
+    router.get('/status',         controller.status.bind(controller));
+    router.get('/live-messages',  controller.liveMessages.bind(controller));
+    router.get('/session',        controller.session.bind(controller));
+    router.get('/steps',          controller.steps.bind(controller));
+    router.get('/file',           controller.file.bind(controller));
+    router.get('/archive',        controller.archive.bind(controller));
+    router.get('/runners',        controller.runners.bind(controller));
+
+    // ── 控制与检查 ──
+    router.post('/control',       controller.control.bind(controller));
+    router.post('/check-result',  controller.checkResult.bind(controller));
+
+    // ── 会话注入 ──
+    router.post('/inject-prompt', controller.injectPrompt.bind(controller));
+
+    // ── 会话交互 ──
+    router.post('/send-and-wait', controller.sendAndWaitMessage.bind(controller));
+
+    // ── 实例管理 ──
+    router.delete('/runner',      controller.removeRunner.bind(controller));
+
+    return router;
+}
+
+export default createFlexRunnerRouter;

package/vendor/Server/Routes/routes/health.js

@@ -0,0 +1,28 @@
+import { Router } from '../router/Router.js';
+import HealthController from '../controllers/HealthController.js';
+
+/**
+ * 健康检查路由注册
+ *
+ * 挂载点：/api/health/*
+ *
+ * 路由列表：
+ *  GET /api/health         — 大模型 CLI 健康检查
+ *  GET /api/health/ping    — 后端轻量探活
+ *  GET /api/health/check   — 健康检查（语义化别名）
+ *
+ * @param {object} dependencies - 共享依赖
+ * @returns {Router}
+ */
+export function createHealthRouter(dependencies) {
+    const { cli } = dependencies;
+    const controller = new HealthController(cli);
+
+    const router = new Router();
+    router.get('',        controller.check.bind(controller));
+    router.get('/ping',   controller.ping.bind(controller));
+    router.get('/check',  controller.check.bind(controller));
+    return router;
+}
+
+export default createHealthRouter;

package/vendor/Server/Routes/routes/index.js

@@ -0,0 +1,57 @@
+import { createHealthRouter } from './health.js';
+import { createStreamRouter } from './stream.js';
+import { createFlexRunnerRouter } from './flexrunner.js';
+import { createOrchestratorRouter } from './orchestrator.js';
+import { createBrainRouter } from './brain.js';
+import { createLoopEngineRouter } from './loopengine.js';
+import { createKnowledgeRouter } from './knowledge.js';
+import { createRegistryRouter } from './registry.js';
+import { createStatsRouter } from './stats.js';
+
+/**
+ * 路由组装器 — 将各业务域路由组合到主路由器
+ *
+ * 设计参考：每域一个注册文件（routes/xxx.js），此文件只做组装。
+ * 新增业务模块时：
+ *   1. 创建 routes/xxx.js，导出 createXxxRouter(dependencies)
+ *   2. 在此 import 并追加 router.use()
+ *
+ * 各域路由文件职责：实例化 Controller、定义路径 → handler 映射。
+ * Controller 职责：封装业务逻辑，不感知 HTTP 层。
+ *
+ * @param {Router} router       - 主路由器
+ * @param {object} dependencies - 共享依赖（CLIController / TaskStepStore / SseHub）
+ */
+export function registerRoutes(router, dependencies) {
+    // ─── 健康检查 ──────────────────────────────────────────────────────
+    router.use('/api/health', createHealthRouter(dependencies));
+
+    // ─── 任务管理（未来）──────────────────────────────────────────────
+    // router.use('/api/tasks', createTaskRouter(dependencies));
+
+    // ─── SSE 实时推送 ──────────────────────────────────────────────────
+    router.use('/stream', createStreamRouter(dependencies));
+
+    // ─── FlexRunner 测试 ─────────────────────────────────────────────
+    router.use('/api/flexrunner', createFlexRunnerRouter(dependencies));
+
+    // ─── Orchestrator 编排器 ──────────────────────────────────────────
+    router.use('/api/orchestrator', createOrchestratorRouter(dependencies));
+
+    // ─── Brain 任务拆解 ──────────────────────────────────────────────
+    router.use('/api/brain', createBrainRouter(dependencies));
+
+    // ─── LoopEngine 大循环协调引擎 ────────────────────────────────────
+    router.use('/api/loopengine', createLoopEngineRouter(dependencies));
+
+    // ─── Knowledge 知识导入与查询 ─────────────────────────────────────
+    router.use('/api/knowledge', createKnowledgeRouter(dependencies));
+
+    // ─── 任务注册表统一查询（分页历史列表）───────────────────────────────
+    router.use('/api/registry', createRegistryRouter(dependencies));
+
+    // ─── 统计服务（访问计数 / Session 调用计数）──────────────────────────
+    router.use('/api/stats', createStatsRouter(dependencies));
+}
+
+export default registerRoutes;

package/vendor/Server/Routes/routes/knowledge.js

@@ -0,0 +1,55 @@
+import { Router } from '../router/Router.js';
+import KnowledgeImportController from '../controllers/KnowledgeImportController.js';
+
+/**
+ * Knowledge 路由注册
+ *
+ * 挂载点：/api/knowledge/*
+ *
+ * 路由列表：
+ *  POST   /import            — 同步导入知识经验（等待完成）
+ *  POST   /import-async      — 异步导入知识经验（立即返回，通过 /import-status 查询）
+ *  GET    /import-status      — 查询异步导入任务状态
+ *  GET    /list               — 列出所有知识经验
+ *  GET    /experience         — 获取单条知识经验详情
+ *  GET    /doc                — 读取经验文档（.md）原文内容
+ *  DELETE /delete             — 删除一条知识经验（硬删除：物理删除 JSON 文件并从索引移除）
+ *
+ * @param {object} dependencies - 共享依赖
+ * @param {object} [dependencies.cli]               - CLIController 实例
+ * @param {object} [dependencies.storage]           - 存储门面
+ * @param {string} [dependencies.skillDirectory]    - SKILL 根目录路径
+ * @param {object} [dependencies.knowledgeManager]  - KnowledgeManager 实例
+ * @param {object} [dependencies.sseHub]            - SseHub 实例
+ * @returns {Router}
+ */
+export function createKnowledgeRouter(dependencies) {
+    const controller =
+        dependencies.knowledgeImportController ||
+        new KnowledgeImportController({
+            cli: dependencies.cli,
+            storage: dependencies.storage,
+            skillDirectory: dependencies.skillDirectory,
+            knowledgeManager: dependencies.knowledgeManager,
+            sseHub: dependencies.sseHub,
+        });
+
+    const router = new Router();
+
+    // ── 知识导入 ──
+    router.post('/import',         controller.importKnowledge.bind(controller));
+    router.post('/import-async',   controller.importKnowledgeAsync.bind(controller));
+    router.get('/import-status',   controller.importStatus.bind(controller));
+
+    // ── 知识查询 ──
+    router.get('/list',            controller.listExperiences.bind(controller));
+    router.get('/experience',      controller.getExperience.bind(controller));
+    router.get('/doc',             controller.getDocContent.bind(controller));
+
+    // ── 知识删除 ──
+    router.delete('/delete',       controller.deleteExperience.bind(controller));
+
+    return router;
+}
+
+export default createKnowledgeRouter;

package/vendor/Server/Routes/routes/loopengine.js

@@ -0,0 +1,58 @@
+/**
+ * LoopEngine 路由注册
+ *
+ * 挂载点：/api/loopengine/*
+ *
+ * 路由列表：
+ *  POST   /start          — 启动大循环（Brain → Orchestrator → TestCheck 闭环）
+ *  GET    /progress       — 查询大循环进度
+ *  GET    /list           — 列出所有大循环任务
+ *  POST   /abort          — 终止大循环
+ *  POST   /restore        — 从持久化恢复大循环状态
+ *  GET    /status         — 获取 LoopEngineController 状态
+ *  GET    /check-session  — 获取指定轮次 TestCheck 的 session 对话归档
+ */
+
+import { Router } from '../router/Router.js';
+import LoopEngineController from '../controllers/LoopEngineController.js';
+
+/**
+ * @param {object} dependencies - 共享依赖
+ * @param {object} [dependencies.sseHub]
+ * @param {object} [dependencies.storage]
+ * @param {object} [dependencies.brainController]        - BrainController 实例
+ * @param {object} [dependencies.orchestratorController] - OrchestratorController 实例
+ * @param {object} [dependencies.testCheck]              - TestCheck 实例
+ * @param {LoopEngineController} [dependencies.loopEngineController] - 已有实例
+ * @param {string} [dependencies.skillDirectory]
+ * @returns {Router}
+ */
+export function createLoopEngineRouter(dependencies) {
+    const controller =
+        dependencies.loopEngineController ||
+        new LoopEngineController({
+            sseHub: dependencies.sseHub,
+            storage: dependencies.storage,
+            brainController: dependencies.brainController,
+            orchestratorController: dependencies.orchestratorController,
+            testCheck: dependencies.testCheck,
+            skillDirectory: dependencies.skillDirectory
+        });
+
+    const router = new Router();
+
+    // ── 大循环控制 ──
+    router.post('/start',    controller.start.bind(controller));
+    router.post('/abort',    controller.abort.bind(controller));
+    router.post('/restore',  controller.restore.bind(controller));
+
+    // ── 查询 ──
+    router.get('/progress',      controller.progress.bind(controller));
+    router.get('/list',          controller.list.bind(controller));
+    router.get('/status',        controller.status.bind(controller));
+    router.get('/check-session', controller.checkSession.bind(controller));
+
+    return router;
+}
+
+export default createLoopEngineRouter;

package/vendor/Server/Routes/routes/orchestrator.js

@@ -0,0 +1,61 @@
+import { Router } from '../router/Router.js';
+import OrchestratorController from '../controllers/OrchestratorController.js';
+
+/**
+ * Orchestrator 路由注册
+ *
+ * 挂载点：/api/orchestrator/*
+ *
+ * 路由列表：
+ *  POST   /load          — 加载任务定义，创建编排器
+ *  POST   /start         — 启动编排执行
+ *  POST   /pause         — 暂停编排
+ *  POST   /resume        — 恢复编排
+ *  POST   /abort         — 终止编排
+ *  GET    /progress      — 查询编排进度
+ *  GET    /step-detail   — 查询步骤执行细节
+ *  GET    /step-history  — 查询步骤执行历史（SQLite，重启后完整保留）
+ *  GET    /tasks         — 列出所有编排任务
+ *  DELETE /task          — 移除编排任务
+ *
+ * @param {object} dependencies - 共享依赖
+ * @param {object} [dependencies.sseHub]              - SseHub 实例
+ * @param {object} [dependencies.storage]             - 存储门面
+ * @param {function} [dependencies.flexRunnerFactory]  - FlexRunner 工厂
+ * @param {OrchestratorController} [dependencies.orchestratorController] - 已有实例
+ * @returns {Router}
+ */
+export function createOrchestratorRouter(dependencies) {
+    const controller =
+        dependencies.orchestratorController ||
+        new OrchestratorController({
+            sseHub: dependencies.sseHub,
+            storage: dependencies.storage,
+            flexRunnerFactory: dependencies.flexRunnerFactory
+        });
+
+    const router = new Router();
+
+    // ── 任务加载与执行 ──
+    router.post('/load',        controller.load.bind(controller));
+    router.post('/start',       controller.start.bind(controller));
+    router.post('/pause',       controller.pause.bind(controller));
+    router.post('/resume',      controller.resume.bind(controller));
+    router.post('/abort',       controller.abort.bind(controller));
+
+    // ── 查询 ──
+    router.get('/progress',     controller.progress.bind(controller));
+    router.get('/step-detail',  controller.stepDetail.bind(controller));
+    router.get('/step-history', controller.stepHistory.bind(controller));
+    router.get('/tasks',        controller.tasks.bind(controller));
+
+    // ── 步骤配置修改 ──
+    router.post('/update-step', controller.updateStep.bind(controller));
+
+    // ── 任务管理 ──
+    router.delete('/task',      controller.removeTask.bind(controller));
+
+    return router;
+}
+
+export default createOrchestratorRouter;

package/vendor/Server/Routes/routes/registry.js

@@ -0,0 +1,98 @@
+/**
+ * 任务注册表通用路由
+ *
+ * 挂载点：/api/registry/*
+ *
+ * 提供统一的"历史任务列表"分页查询接口。
+ * 后端所有模块（LoopEngine、Orchestrator、FlexRunner 等）在创建任务时，
+ * 通过 TaskRegistryStore 注册摘要；前端通过此路由统一查询。
+ *
+ * 路由列表：
+ *  GET /api/registry/tasks  — 分页查询所有任务
+ *  GET /api/registry/tasks/:taskId — 查询单个任务摘要
+ *
+ * 响应格式：
+ *   GET /api/registry/tasks?page=1&pageSize=20&status=running&taskType=loop
+ *   → { status: 'ok', tasks: [...], total, page, pageSize, totalPages }
+ */
+
+import { Router } from '../router/Router.js';
+
+/**
+ * @param {object} dependencies - 共享依赖
+ * @param {object} [dependencies.storage] - 存储门面
+ * @returns {Router}
+ */
+export function createRegistryRouter(dependencies) {
+    const { storage } = dependencies;
+
+    const router = new Router();
+
+    /**
+     * GET /api/registry/tasks
+     * 分页查询所有任务摘要。
+     *
+     * Query 参数：
+     *   page     - 页码，从 1 开始（默认 1）
+     *   pageSize - 每页条数（默认 20，最大 100）
+     *   status   - 可选，按状态过滤（running / completed / failed / ...）
+     *   taskType - 可选，按任务类型过滤（loop / orchestrator / ...）
+     */
+    router.get('/tasks', async (req, res) => {
+        try {
+            if (!storage) {
+                return res.error(500, 'storage 未初始化');
+            }
+
+            const registry = storage.taskRegistryStore();
+            const query = req.query || {};
+            const page = Math.max(1, parseInt(query.page, 10) || 1);
+            const pageSize = Math.min(100, Math.max(1, parseInt(query.pageSize, 10) || 20));
+
+            const result = await registry.listPage({
+                page,
+                pageSize,
+                status: query.status || null,
+                taskType: query.taskType || null
+            });
+
+            res.json({
+                status: 'ok',
+                ...result
+            });
+        } catch (err) {
+            res.error(500, `查询任务列表失败: ${err.message}`);
+        }
+    });
+
+    /**
+     * GET /api/registry/tasks/:taskId
+     * 查询单个任务摘要。
+     */
+    router.get('/tasks/:taskId', async (req, res) => {
+        try {
+            if (!storage) {
+                return res.error(500, 'storage 未初始化');
+            }
+
+            const registry = storage.taskRegistryStore();
+            const { taskId } = req.params;
+            const entry = await registry.get(taskId);
+
+            if (!entry) {
+                return res.json({ status: 'ok', task: null });
+            }
+
+            res.json({
+                status: 'ok',
+                task: entry
+            });
+        } catch (err) {
+            res.error(500, `查询任务详情失败: ${err.message}`);
+        }
+    });
+
+    return router;
+}
+
+export default createRegistryRouter;

package/vendor/Server/Routes/routes/stats.js

@@ -0,0 +1,23 @@
+import { Router } from '../router/Router.js';
+import StatsController from '../controllers/StatsController.js';
+
+/**
+ * 统计路由注册
+ *
+ * 挂载点：/api/stats/*
+ *
+ * 路由列表：
+ *  GET /api/stats/visit               — 页面访问计数（自增）
+ *  GET /api/stats/session/count       — Session 调用计数（只读）
+ *  GET /api/stats/session/concurrency — Session 并发占用快照（active/limit/waiting）
+ */
+export function createStatsRouter(dependencies) {
+    const controller = new StatsController();
+    const router = new Router();
+    router.get('/visit',                    controller.visit.bind(controller));
+    router.get('/session/count',            controller.sessionCount.bind(controller));
+    router.get('/session/concurrency',      controller.sessionConcurrency.bind(controller));
+    return router;
+}
+
+export default createStatsRouter;

package/vendor/Server/Routes/routes/stream.js

@@ -0,0 +1,30 @@
+import { Router } from '../router/Router.js';
+import StreamController from '../controllers/StreamController.js';
+
+/**
+ * SSE 实时推送路由
+ *
+ * 挂载点：/stream/*
+ *
+ * 路由列表：
+ *  GET /stream/tasks/:taskId - 订阅指定任务的实时事件流（SSE）
+ *  GET /stream/stats         - SSE Hub 全局统计（REST）
+ *
+ * 前端订阅示例：
+ *   const es = new EventSource('/stream/tasks/task-xxx');
+ *   es.addEventListener('step:status', (e) => console.log(JSON.parse(e.data)));
+ *
+ * @param {object} dependencies - 共享依赖
+ * @returns {Router}
+ */
+export function createStreamRouter(dependencies) {
+    const { sseHub } = dependencies;
+    const controller = new StreamController(sseHub);
+
+    const router = new Router();
+    router.get('/tasks/:taskId', controller.subscribeTask.bind(controller));
+    router.get('/stats',         controller.stats.bind(controller));
+    return router;
+}
+
+export default createStreamRouter;