openmatrix 0.2.3 → 0.2.4

package/dist/utils/logger.js

@@ -37,9 +37,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = void 0;
+exports.persistLog = persistLog;
 exports.createLogger = createLogger;
 exports.getLogger = getLogger;
 exports.setLogger = setLogger;
+exports.initLoggerWithRunId = initLoggerWithRunId;
 // src/utils/logger.ts
 const winston_1 = __importDefault(require("winston"));
 const path = __importStar(require("path"));
@@ -54,11 +56,28 @@ const fs = __importStar(require("fs"));
  * 4. 结构化 JSON 日志
  */
 let defaultLogger = null;
+/**
+ * 持久化日志到文件（追加模式）
+ * 用于关键操作的审计追踪
+ */
+function persistLog(log, omPath) {
+    try {
+        const logsDir = path.join(omPath, 'logs');
+        if (!fs.existsSync(logsDir)) {
+            fs.mkdirSync(logsDir, { recursive: true });
+        }
+        const logFile = path.join(logsDir, `${log.runId || 'default'}.log`);
+        fs.appendFileSync(logFile, JSON.stringify(log) + '\n', 'utf-8');
+    }
+    catch {
+        // 持久化失败不应影响主流程
+    }
+}
 /**
  * 创建或获取默认 Logger
  */
 function createLogger(options = {}) {
-    const { level = process.env.OPENMATRIX_LOG_LEVEL || 'info', logDir = '.openmatrix/logs', console: enableConsole = true } = options;
+    const { level = process.env.OPENMATRIX_LOG_LEVEL || 'info', logDir = '.openmatrix/logs', console: enableConsole = true, runId } = options;
     // 确保日志目录存在
     const absoluteLogDir = path.resolve(process.cwd(), logDir);
     if (!fs.existsSync(absoluteLogDir)) {
@@ -102,7 +121,7 @@ function createLogger(options = {}) {
     // 创建 logger
     const logger = winston_1.default.createLogger({
         level,
-        defaultMeta: { service: 'openmatrix' },
+        defaultMeta: { service: 'openmatrix', runId },
         transports
     });
     return logger;
@@ -122,6 +141,22 @@ function getLogger() {
 function setLogger(logger) {
     defaultLogger = logger;
 }
+/**
+ * 使用 runId 初始化 logger
+ */
+function initLoggerWithRunId(runId, omPath) {
+    defaultLogger = createLogger({ runId });
+    if (omPath) {
+        // 记录初始化日志
+        persistLog({
+            level: 'info',
+            runId,
+            operation: 'init',
+            message: 'Logger initialized',
+            timestamp: new Date().toISOString()
+        }, omPath);
+    }
+}
 /**
  * 便捷方法: 直接记录日志
  */
@@ -130,6 +165,45 @@ exports.logger = {
     error: (message, meta) => getLogger().error(message, meta),
     warn: (message, meta) => getLogger().warn(message, meta),
     debug: (message, meta) => getLogger().debug(message, meta),
+    // 结构化日志（带持久化）
+    structured: {
+        info: (operation, message, meta, omPath) => {
+            const log = {
+                level: 'info',
+                operation,
+                message,
+                metadata: meta,
+                timestamp: new Date().toISOString()
+            };
+            getLogger().info(message, { operation, ...meta });
+            if (omPath)
+                persistLog(log, omPath);
+        },
+        error: (operation, message, meta, omPath) => {
+            const log = {
+                level: 'error',
+                operation,
+                message,
+                metadata: meta,
+                timestamp: new Date().toISOString()
+            };
+            getLogger().error(message, { operation, ...meta });
+            if (omPath)
+                persistLog(log, omPath);
+        },
+        warn: (operation, message, meta, omPath) => {
+            const log = {
+                level: 'warn',
+                operation,
+                message,
+                metadata: meta,
+                timestamp: new Date().toISOString()
+            };
+            getLogger().warn(message, { operation, ...meta });
+            if (omPath)
+                persistLog(log, omPath);
+        }
+    },
     // 任务相关日志
     task: {
         start: (taskId, title) => {
@@ -143,6 +217,19 @@ exports.logger = {
         },
         retry: (taskId, attempt) => {
             getLogger().warn(`Task retry: ${taskId}`, { taskId, attempt });
+        },
+        timeout: (taskId, timeout, phase, omPath) => {
+            const log = {
+                level: 'error',
+                taskId,
+                operation: 'taskTimeout',
+                message: `Task timed out after ${timeout}s`,
+                metadata: { timeout, phase },
+                timestamp: new Date().toISOString()
+            };
+            getLogger().error(`Task timed out: ${taskId}`, { taskId, timeout, phase });
+            if (omPath)
+                persistLog(log, omPath);
         }
     },
     // Agent 相关日志
@@ -162,5 +249,26 @@ exports.logger = {
         decision: (approvalId, decision) => {
             getLogger().info(`Approval decision: ${approvalId}`, { approvalId, decision });
         }
+    },
+    // 任务编排日志
+    orchestration: {
+        breakdown: (moduleCount, moduleNames, omPath) => {
+            const log = {
+                level: 'info',
+                operation: 'breakdown',
+                message: `Parsed ${moduleCount} modules from plan`,
+                metadata: { moduleNames },
+                timestamp: new Date().toISOString()
+            };
+            getLogger().info(`Breakdown: ${moduleCount} modules`, { moduleNames });
+            if (omPath)
+                persistLog(log, omPath);
+        },
+        schedule: (taskId, dependencies) => {
+            getLogger().info(`Task scheduled: ${taskId}`, { taskId, dependencies });
+        },
+        dependencyResolved: (taskId) => {
+            getLogger().debug(`Dependencies resolved: ${taskId}`, { taskId });
+        }
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,6 +17,8 @@
     "build": "tsc",
     "dev": "tsx src/cli/index.ts",
     "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
     "postinstall": "node scripts/install-skills.js"
   },
   "keywords": [
@@ -47,6 +49,9 @@
     "winston": "^3.19.0"
   },
   "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
+    "eslint": "^10.2.0",
     "vitest": "^1.6.0"
   },
   "engines": {

package/skills/start.md

@@ -224,6 +224,38 @@ AskUserQuestion: `header: "执行模式"`, `multiSelect: false`
 
 **研究上下文集成**: 如果已加载研究领域，AI 应基于 `RESEARCH.md` 中的领域知识确认/补充 goals，而非从零提取。`plan` 字段应包含领域技术栈、架构模式等知识。
 
+**plan 字段格式要求（供系统解析模块）:**
+
+plan 中必须包含以下结构之一，系统将据此拆分为模块级任务：
+
+**中文格式（推荐）:**
+```
+## 架构设计
+1. 用户域：用户注册登录模块
+2. 订单域：订单处理模块
+3. 商品域：商品管理模块
+```
+
+或简洁格式：
+```
+3领域模块: 用户、订单、商品
+```
+
+**英文格式:**
+```
+## Modules
+- User module: authentication and profile
+- Order module: order processing
+- Product module: catalog management
+```
+
+或：
+```
+3 modules: User, Order, Product
+```
+
+> **重要**: 如果 plan 不包含可解析的模块结构，系统将从 goals 中推断模块（仅 `development` 类型 goal），或 fallback 到按 goal 拆分。包含模块结构可获得更精细的依赖分析和并行执行优化。
+
 **goalTypes 标注示例：**
 
 | Goal | Type | 理由 |