@reskill/agent-aware-server 0.3.0 → 0.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kanyun-inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,67 +1,73 @@
 # @reskill/agent-aware-server
 
-Agent-aware Server 提供 HTTP API 来收集用户交互行为和页面报错信息，并通过智能检测器主动发现问题。
+Agent-aware Server provides HTTP APIs to collect user interaction behaviors and page errors, with intelligent detectors for proactive issue discovery.
 
-## 功能特性
+[简体中文](./README.zh-CN.md)
 
-### 1. 数据收集
+## Features
 
-- **行为数据收集**：从 `http://localhost:4100` 接收 SDK 上报的用户交互数据
-- **错误数据收集**：收集运行时错误、Promise 异常和 Console 错误
+### 1. Data Collection
 
-### 2. 智能检测器
+- **Behavior Data Collection**: Receives user interaction data from SDK at `http://localhost:4100`
+- **Error Data Collection**: Collects runtime errors, Promise rejections, and console errors
 
-重构后的架构包含两个独立的检测器：
+### 2. Intelligent Detectors
 
-#### BehaviorDetector（行为检测器）
-- 检测消极的用户交互行为
-- 触发条件：
-  - 挫折指数 >= 70（Critical）
-  - 挫折指数 50-70（Warning）
-  - 愤怒点击 >= 3 次（Warning）
-  - 死点击 >= 2 次（Warning）
-- 输出文件：`.agent-aware/behavior.json`
+The refactored architecture includes two independent detectors:
 
-#### AlertDetector（错误检测器）
-- 检测高危的运行时错误
-- 触发条件：
-  - 错误数 >= 1（Critical）
-- 输出文件：`.agent-aware/error.json`
+#### BehaviorDetector
+- Detects negative user interaction behaviors
+- Trigger conditions:
+  - Frustration score >= 70 (Critical)
+  - Frustration score 50-70 (Warning)
+  - Rage clicks >= 3 (Warning)
+  - Dead clicks >= 2 (Warning)
+- Output file: `.agent-aware/alert/behavior.json`
 
-### 3. 数据存储
+#### AlertDetector (Error Detector)
+- Detects high-risk runtime errors
+- Trigger conditions:
+  - Error count >= 1 (Critical)
+- Output file: `.agent-aware/alert/error.json`
 
-**详细数据存储在包根目录的 `data/` 目录**：
-- `data/behaviors.json`：所有行为详细数据（最多 1000 条）
-- `data/errors.json`：所有错误详细数据（最多 1000 条）
+### 3. Data Storage
 
-**检测文件输出到用户项目根目录的 `.agent-aware/` 目录**：
-- `.agent-aware/behavior.json`：行为检测结果
-- `.agent-aware/error.json`：错误检测结果
+**All data is stored in the `.agent-aware/` directory under the user's project root**:
 
-## 使用方式
+```
+.agent-aware/
+├── alert/               # Alert files (for Agent monitoring)
+│   ├── behavior.json    # Behavior detection alerts (max 100 history)
+│   └── error.json       # Error detection alerts (max 100 history)
+└── detail/              # Detail data files (for HTTP API queries)
+    ├── behaviors.json   # Behavior detail data (max 1000 entries)
+    └── errors.json      # Error detail data (max 1000 entries)
+```
+
+## Usage
 
-### 安装
+### Installation (Recommended as project dev dependency)
 
 ```bash
-npm install @reskill/agent-aware-server
+npm install --save-dev @reskill/agent-aware-server
 ```
 
-### 启动服务
+### Starting the Server
 
-#### 方式 1：使用 CLI（推荐）
+#### Method 1: Using CLI (Recommended)
 
 ```bash
-# 默认启动（输出到当前目录）
+# Default start (output to current directory)
 npx agent-aware-server start
 
-# 指定项目根目录
+# Specify project root directory
 npx agent-aware-server start --project-root /path/to/project
 
-# 使用环境变量（优先级最高）
+# Use environment variable (highest priority)
 USER_PROJECT_ROOT=/path/to/project npx agent-aware-server start
 ```
 
-#### 方式 2：编程方式
+#### Method 2: Programmatic
 
 ```typescript
 import { serve } from '@hono/node-server'
@@ -72,11 +78,11 @@ import { BehaviorDetector } from '@reskill/agent-aware-server/detector/behaviorD
 import { AlertDetector } from '@reskill/agent-aware-server/detector/alertDetector'
 
 const PORT = 4100
-const DATA_DIR = './data'
 const PROJECT_ROOT = process.env.USER_PROJECT_ROOT || process.cwd()
 
-const store = new BehaviorStore(DATA_DIR)
-const errorStore = new ErrorStore(DATA_DIR)
+// All components use PROJECT_ROOT, data stored in .agent-aware/ directory
+const store = new BehaviorStore(PROJECT_ROOT)
+const errorStore = new ErrorStore(PROJECT_ROOT)
 const behaviorDetector = new BehaviorDetector(PROJECT_ROOT)
 const alertDetector = new AlertDetector(PROJECT_ROOT)
 
@@ -92,106 +98,118 @@ console.log(`Server running on http://localhost:${PORT}`)
 
 ## HTTP API
 
-### 行为相关
+### Behavior Related
 
-- **POST /behaviors** - 接收行为数据（SDK 上报）
-- **GET /behaviors** - 查询行为数据
-  - 参数：`types`（可选）、`limit`（可选）
-- **GET /summary** - 获取行为摘要
-- **GET /hotspots** - 获取交互热点
-  - 参数：`limit`（可选）
-- **DELETE /behaviors** - 清空行为数据
+- **POST /behaviors** - Receive behavior data (SDK reports)
+- **GET /behaviors** - Query behavior data
+  - Parameters: `types` (optional), `limit` (optional)
+- **GET /behaviors/summary** - Get behavior summary
+- **GET /hotspots** - Get interaction hotspots
+  - Parameters: `limit` (optional)
+- **DELETE /behaviors** - Clear behavior data
 
-### 错误相关
+### Error Related
 
-- **POST /errors** - 接收错误数据（SDK 上报）
-- **GET /errors** - 查询错误数据
-  - 参数：`errorTypes`（可选）、`limit`（可选）
-- **GET /errors/summary** - 获取错误摘要
-- **DELETE /errors** - 清空错误数据
+- **POST /errors** - Receive error data (SDK reports)
+- **GET /errors** - Query error data
+  - Parameters: `errorTypes` (optional), `limit` (optional)
+- **GET /errors/summary** - Get error summary
+- **DELETE /errors** - Clear error data
 
-### 健康检查
+### Health Check
 
-- **GET /health** - 健康检查
+- **GET /health** - Health check
 
-## 项目根目录配置
+## Project Root Configuration
 
-检测器输出文件的位置由以下优先级决定：
+The output file location is determined by the following priority:
 
-1. **环境变量** `USER_PROJECT_ROOT`（优先级最高）
-2. **启动参数** `--project-root`
-3. **默认值** `process.cwd()`（当前工作目录）
+1. **Environment variable** `USER_PROJECT_ROOT` (highest priority)
+2. **Startup parameter** `--project-root`
+3. **Default** `process.cwd()` (current working directory)
 
-## 输出文件示例
+## Output File Examples
 
-### behavior.json
+Alert files retain history (max 100 entries) in the following format:
+
+### alert/behavior.json
 
 ```json
 {
-  "timestamp": "2026-01-30T10:30:00.000Z",
-  "severity": "critical",
-  "type": "frustration",
-  "summary": "检测到用户挫折行为",
-  "details": {
-    "frustrationScore": 75,
-    "rageClickCount": 5,
-    "deadClickCount": 3,
-    "totalInteractions": 50
-  }
+  "version": "1.0",
+  "alerts": [
+    {
+      "timestamp": "2026-01-30T10:30:00.000Z",
+      "severity": "critical",
+      "type": "frustration",
+      "summary": "检测到用户挫折行为（挫折指数: 75）",
+      "details": {
+        "frustrationScore": 75,
+        "rageClickCount": 5,
+        "deadClickCount": 3,
+        "totalInteractions": 50
+      }
+    }
+  ]
 }
 ```
 
-### error.json
+### alert/error.json
 
 ```json
 {
-  "timestamp": "2026-01-30T10:30:00.000Z",
-  "severity": "critical",
-  "type": "error",
-  "summary": "检测到 3 个运行时错误",
-  "details": {
-    "totalErrors": 3,
-    "runtimeErrorCount": 2,
-    "unhandledRejectionCount": 1,
-    "consoleErrorCount": 0,
-    "recentErrors": [
-      {
-        "id": "uuid-1",
-        "timestamp": 1738233000000,
-        "errorType": "runtime",
-        "message": "Cannot read property 'foo' of undefined"
+  "version": "1.0",
+  "alerts": [
+    {
+      "timestamp": "2026-01-30T10:30:00.000Z",
+      "severity": "critical",
+      "type": "error",
+      "summary": "检测到 3 个运行时错误",
+      "details": {
+        "totalErrors": 3,
+        "runtimeErrorCount": 2,
+        "unhandledRejectionCount": 1,
+        "consoleErrorCount": 0,
+        "recentErrors": [
+          {
+            "id": "uuid-1",
+            "timestamp": 1738233000000,
+            "errorType": "runtime",
+            "message": "Cannot read property 'foo' of undefined"
+          }
+        ]
       }
-    ]
-  }
+    }
+  ]
 }
 ```
 
-## 冷却期机制
+## Cooldown Mechanism
 
-为避免告警风暴，每个检测器都有 10 秒的冷却期：
-- 同一检测器的文件写入间隔至少 10 秒
-- 冷却期内的新问题会累积到下次写入
+To prevent alert storms, each detector has a 10-second cooldown period:
+- Minimum 10 seconds between file writes for the same detector
+- New issues during cooldown are accumulated for the next write
 
-## 架构说明
+## Architecture
 
-基于 [SPEC-SRV-005: Detector 架构重构](../../specs/server/005-detector-refactor.md)
+Based on [SPEC-SRV-005: Detector Architecture Refactor](../../specs/server/005-detector-refactor.md)
 
-### 设计原则
+### Design Principles
 
-1. **职责分离**：BehaviorDetector 和 AlertDetector 各司其职
-2. **异步检测**：检测逻辑不阻塞 API 响应
-3. **容错设计**：文件写入失败不影响数据接收
-4. **独立工作**：每个检测器独立工作，互不干扰
+1. **Separation of Concerns**: BehaviorDetector and AlertDetector have distinct responsibilities
+2. **Asynchronous Detection**: Detection logic doesn't block API responses
+3. **Fault Tolerant**: File write failures don't affect data reception
+4. **Independent Operation**: Each detector works independently without interference
 
-## 开发
+## Development
 
-### 运行测试
+### Run Tests
 
 ```bash
 npm test
 ```
 
-### 构建
+### Build
 
 ```bash
 npm run build

package/README.zh-CN.md

@@ -0,0 +1,220 @@
+# @reskill/agent-aware-server
+
+Agent-aware Server 提供 HTTP API 来收集用户交互行为和页面报错信息，并通过智能检测器主动发现问题。
+
+[English](./README.md)
+
+## 功能特性
+
+### 1. 数据收集
+
+- **行为数据收集**：从 `http://localhost:4100` 接收 SDK 上报的用户交互数据
+- **错误数据收集**：收集运行时错误、Promise 异常和 Console 错误
+
+### 2. 智能检测器
+
+重构后的架构包含两个独立的检测器：
+
+#### BehaviorDetector（行为检测器）
+- 检测消极的用户交互行为
+- 触发条件：
+  - 挫折指数 >= 70（Critical）
+  - 挫折指数 50-70（Warning）
+  - 愤怒点击 >= 3 次（Warning）
+  - 死点击 >= 2 次（Warning）
+- 输出文件：`.agent-aware/alert/behavior.json`
+
+#### AlertDetector（错误检测器）
+- 检测高危的运行时错误
+- 触发条件：
+  - 错误数 >= 1（Critical）
+- 输出文件：`.agent-aware/alert/error.json`
+
+### 3. 数据存储
+
+**所有数据统一存储到用户项目根目录的 `.agent-aware/` 目录**：
+
+```
+.agent-aware/
+├── alert/               # 检测告警文件（供 Agent 监控）
+│   ├── behavior.json    # 行为检测告警（最多 100 条历史）
+│   └── error.json       # 错误检测告警（最多 100 条历史）
+└── detail/              # 详细数据文件（供 HTTP API 查询）
+    ├── behaviors.json   # 行为详细数据（最多 1000 条）
+    └── errors.json      # 错误详细数据（最多 1000 条）
+```
+
+## 使用方式
+
+### 安装（推荐项目级别开发依赖）
+
+```bash
+npm install --save-dev @reskill/agent-aware-server
+```
+
+### 启动服务
+
+#### 方式 1：使用 CLI（推荐）
+
+```bash
+# 默认启动（输出到当前目录）
+npx agent-aware-server start
+
+# 指定项目根目录
+npx agent-aware-server start --project-root /path/to/project
+
+# 使用环境变量（优先级最高）
+USER_PROJECT_ROOT=/path/to/project npx agent-aware-server start
+```
+
+#### 方式 2：编程方式
+
+```typescript
+import { serve } from '@hono/node-server'
+import { createHttpApi } from '@reskill/agent-aware-server/httpApi'
+import { BehaviorStore } from '@reskill/agent-aware-server/store/behaviorStore'
+import { ErrorStore } from '@reskill/agent-aware-server/store/errorStore'
+import { BehaviorDetector } from '@reskill/agent-aware-server/detector/behaviorDetector'
+import { AlertDetector } from '@reskill/agent-aware-server/detector/alertDetector'
+
+const PORT = 4100
+const PROJECT_ROOT = process.env.USER_PROJECT_ROOT || process.cwd()
+
+// 所有组件统一使用 PROJECT_ROOT，数据存储在 .agent-aware/ 目录下
+const store = new BehaviorStore(PROJECT_ROOT)
+const errorStore = new ErrorStore(PROJECT_ROOT)
+const behaviorDetector = new BehaviorDetector(PROJECT_ROOT)
+const alertDetector = new AlertDetector(PROJECT_ROOT)
+
+const app = createHttpApi(store, errorStore, behaviorDetector, alertDetector)
+
+serve({
+  fetch: app.fetch,
+  port: PORT,
+})
+
+console.log(`Server running on http://localhost:${PORT}`)
+```
+
+## HTTP API
+
+### 行为相关
+
+- **POST /behaviors** - 接收行为数据（SDK 上报）
+- **GET /behaviors** - 查询行为数据
+  - 参数：`types`（可选）、`limit`（可选）
+- **GET /behaviors/summary** - 获取行为摘要
+- **GET /hotspots** - 获取交互热点
+  - 参数：`limit`（可选）
+- **DELETE /behaviors** - 清空行为数据
+
+### 错误相关
+
+- **POST /errors** - 接收错误数据（SDK 上报）
+- **GET /errors** - 查询错误数据
+  - 参数：`errorTypes`（可选）、`limit`（可选）
+- **GET /errors/summary** - 获取错误摘要
+- **DELETE /errors** - 清空错误数据
+
+### 健康检查
+
+- **GET /health** - 健康检查
+
+## 项目根目录配置
+
+检测器输出文件的位置由以下优先级决定：
+
+1. **环境变量** `USER_PROJECT_ROOT`（优先级最高）
+2. **启动参数** `--project-root`
+3. **默认值** `process.cwd()`（当前工作目录）
+
+## 输出文件示例
+
+告警文件保留历史记录（最多 100 条），新格式如下：
+
+### alert/behavior.json
+
+```json
+{
+  "version": "1.0",
+  "alerts": [
+    {
+      "timestamp": "2026-01-30T10:30:00.000Z",
+      "severity": "critical",
+      "type": "frustration",
+      "summary": "检测到用户挫折行为",
+      "details": {
+        "frustrationScore": 75,
+        "rageClickCount": 5,
+        "deadClickCount": 3,
+        "totalInteractions": 50
+      }
+    }
+  ]
+}
+```
+
+### alert/error.json
+
+```json
+{
+  "version": "1.0",
+  "alerts": [
+    {
+      "timestamp": "2026-01-30T10:30:00.000Z",
+      "severity": "critical",
+      "type": "error",
+      "summary": "检测到 3 个运行时错误",
+      "details": {
+        "totalErrors": 3,
+        "runtimeErrorCount": 2,
+        "unhandledRejectionCount": 1,
+        "consoleErrorCount": 0,
+        "recentErrors": [
+          {
+            "id": "uuid-1",
+            "timestamp": 1738233000000,
+            "errorType": "runtime",
+            "message": "Cannot read property 'foo' of undefined"
+          }
+        ]
+      }
+    }
+  ]
+}
+```
+
+## 冷却期机制
+
+为避免告警风暴，每个检测器都有 10 秒的冷却期：
+- 同一检测器的文件写入间隔至少 10 秒
+- 冷却期内的新问题会累积到下次写入
+
+## 架构说明
+
+基于 [SPEC-SRV-005: Detector 架构重构](../../specs/server/005-detector-refactor.md)
+
+### 设计原则
+
+1. **职责分离**：BehaviorDetector 和 AlertDetector 各司其职
+2. **异步检测**：检测逻辑不阻塞 API 响应
+3. **容错设计**：文件写入失败不影响数据接收
+4. **独立工作**：每个检测器独立工作，互不干扰
+
+## 开发
+
+### 运行测试
+
+```bash
+npm test
+```
+
+### 构建
+
+```bash
+npm run build
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -6,6 +6,10 @@
  *
  * 使用方式：
  * npx agent-aware-server start [--project-root <path>]
+ *
+ * 所有输出文件统一到 <project-root>/.agent-aware/ 目录：
+ * - .agent-aware/alert/ - 检测告警文件
+ * - .agent-aware/detail/ - 详细数据文件
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/cli.js

@@ -6,6 +6,10 @@
  *
  * 使用方式：
  * npx agent-aware-server start [--project-root <path>]
+ *
+ * 所有输出文件统一到 <project-root>/.agent-aware/ 目录：
+ * - .agent-aware/alert/ - 检测告警文件
+ * - .agent-aware/detail/ - 详细数据文件
  */
 import { serve } from '@hono/node-server';
 import { createHttpApi } from './httpApi.js';
@@ -14,7 +18,6 @@ import { ErrorStore } from './store/errorStore.js';
 import { BehaviorDetector } from './detector/behaviorDetector.js';
 import { AlertDetector } from './detector/alertDetector.js';
 const HTTP_PORT = 4100;
-const DATA_DIR = './data';
 function parseArgs() {
     const args = process.argv.slice(2);
     let projectRoot = process.env.USER_PROJECT_ROOT || process.cwd();
@@ -27,8 +30,9 @@ function parseArgs() {
 }
 function start() {
     const { projectRoot } = parseArgs();
-    const store = new BehaviorStore(DATA_DIR);
-    const errorStore = new ErrorStore(DATA_DIR);
+    // 所有组件统一使用 projectRoot，输出到 .agent-aware/ 目录
+    const store = new BehaviorStore(projectRoot);
+    const errorStore = new ErrorStore(projectRoot);
     const behaviorDetector = new BehaviorDetector(projectRoot);
     const alertDetector = new AlertDetector(projectRoot);
     const app = createHttpApi(store, errorStore, behaviorDetector, alertDetector);
@@ -39,12 +43,15 @@ function start() {
 ║                                                           ║
 ║   HTTP API: http://localhost:${HTTP_PORT}                      ║
 ║   Project Root: ${projectRoot.slice(0, 38).padEnd(38)}║
-║   Output: ${(projectRoot + '/.agent-aware/').slice(0, 47).padEnd(47)}║
+║                                                           ║
+║   Output:                                                 ║
+║     Alert:  .agent-aware/alert/                           ║
+║     Detail: .agent-aware/detail/                          ║
 ║                                                           ║
 ║   Endpoints:                                              ║
 ║     POST   /behaviors       - SDK 上报行为数据            ║
 ║     GET    /behaviors       - 查询行为列表                ║
-║     GET    /summary         - 获取行为摘要                ║
+║     GET    /behaviors/summary - 获取行为摘要              ║
 ║     GET    /hotspots        - 获取交互热点                ║
 ║     DELETE /behaviors       - 清空行为数据                ║
 ║     POST   /errors          - SDK 上报错误数据            ║
@@ -76,6 +83,15 @@ Agent-aware CLI
 环境变量:
   USER_PROJECT_ROOT        用户项目根目录（优先级高于 --project-root）
 
+输出目录结构:
+  <project-root>/.agent-aware/
+  ├── alert/               # 检测告警文件（供 Agent 监控）
+  │   ├── behavior.json    # 行为检测告警
+  │   └── error.json       # 错误检测告警
+  └── detail/              # 详细数据文件（供 HTTP API 查询）
+      ├── behaviors.json   # 行为详细数据
+      └── errors.json      # 错误详细数据
+
 示例:
   npx agent-aware-server start
   npx agent-aware-server start --project-root /path/to/project

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAE3D,MAAM,SAAS,GAAG,IAAI,CAAA;AACtB,MAAM,QAAQ,GAAG,QAAQ,CAAA;AAEzB,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClC,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAEhE,uBAAuB;IACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACvD,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC;QAC1D,WAAW,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,CAAA;AACxB,CAAC;AAED,SAAS,KAAK;IACZ,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAA;IAEnC,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAA;IACzC,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC3C,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC1D,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAA;IACpD,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;IAE7E,OAAO,CAAC,GAAG,CAAC;;;;;iCAKmB,SAAS;oBACtB,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;cACzC,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;;;;;CAcrE,CAAC,CAAA;IAEA,KAAK,CAAC;QACJ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,SAAS;KAChB,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;AAC5C,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmBb,CAAC,CAAA;AACF,CAAC;AAED,MAAM;AACN,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAE/B,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,OAAO,CAAC;IACb,KAAK,SAAS;QACZ,KAAK,EAAE,CAAA;QACP,MAAK;IACP,KAAK,QAAQ,CAAC;IACd,KAAK,IAAI;QACP,QAAQ,EAAE,CAAA;QACV,MAAK;IACP;QACE,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;QACjC,QAAQ,EAAE,CAAA;QACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAE3D,MAAM,SAAS,GAAG,IAAI,CAAA;AAEtB,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClC,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAEhE,uBAAuB;IACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACvD,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC;QAC1D,WAAW,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,CAAA;AACxB,CAAC;AAED,SAAS,KAAK;IACZ,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAAA;IAEnC,4CAA4C;IAC5C,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAA;IAC5C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC1D,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAA;IACpD,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;IAE7E,OAAO,CAAC,GAAG,CAAC;;;;;iCAKmB,SAAS;oBACtB,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;CAkBtD,CAAC,CAAA;IAEA,KAAK,CAAC;QACJ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,SAAS;KAChB,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;AAC5C,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Bb,CAAC,CAAA;AACF,CAAC;AAED,MAAM;AACN,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAE/B,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,OAAO,CAAC;IACb,KAAK,SAAS;QACZ,KAAK,EAAE,CAAA;QACP,MAAK;IACP,KAAK,QAAQ,CAAC;IACd,KAAK,IAAI;QACP,QAAQ,EAAE,CAAA;QACV,MAAK;IACP;QACE,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;QACjC,QAAQ,EAAE,CAAA;QACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}

package/dist/detector/alertDetector.d.ts

@@ -7,10 +7,14 @@
 import type { ErrorSummary } from '../types';
 export type IssueSeverity = 'critical' | 'warning' | 'info';
 export declare class AlertDetector {
-    private agentAwareDir;
+    private alertDir;
     private errorPath;
     private lastAlertTime;
-    constructor(outputDir?: string);
+    /**
+     * @param projectRoot 用户项目根目录，告警将写入 <projectRoot>/.agent-aware/alert/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot?: string);
     /**
      * 计算严重级别
      */
@@ -20,7 +24,11 @@ export declare class AlertDetector {
      */
     checkAndAlert(errorSummary: ErrorSummary): Promise<void>;
     /**
-     * 写入 error.json
+     * 读取现有的告警数据
+     */
+    private readAlerts;
+    /**
+     * 写入 error.json（保留历史记录，最多 100 条）
      */
     private writeAlert;
     /**

package/dist/detector/alertDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alertDetector.d.ts","sourceRoot":"","sources":["../../src/detector/alertDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAM5C,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAqB3D,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAY;gBAErB,SAAS,GAAE,MAAsB;IAK7C;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa;IAS5D;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC9D;;OAEG;YACW,UAAU;IASxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAG5B"}
+{"version":3,"file":"alertDetector.d.ts","sourceRoot":"","sources":["../../src/detector/alertDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAiB5C,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AA0B3D,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAY;IAEjC;;;OAGG;gBACS,WAAW,GAAE,MAAgC;IAKzD;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa;IAS5D;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC9D;;OAEG;YACW,UAAU;IAUxB;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAG5B"}

package/dist/detector/alertDetector.js

@@ -4,16 +4,30 @@
  *
  * 职责：检测高危的运行时错误
  */
-import { writeFile, mkdir } from 'node:fs/promises';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 const AGENT_AWARE_DIR = '.agent-aware';
+const ALERT_DIR = 'alert';
 const ERROR_FILE = 'error.json';
 const ALERT_COOLDOWN_MS = 10000; // 10 秒冷却期
+const MAX_ALERTS = 100; // 最多保留 100 条历史记录
+const STORAGE_VERSION = '1.0';
+/**
+ * 获取默认的项目根目录
+ * 优先级：环境变量 USER_PROJECT_ROOT > process.cwd()
+ */
+function getDefaultProjectRoot() {
+    return process.env.USER_PROJECT_ROOT || process.cwd();
+}
 export class AlertDetector {
-    constructor(outputDir = process.cwd()) {
+    /**
+     * @param projectRoot 用户项目根目录，告警将写入 <projectRoot>/.agent-aware/alert/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot = getDefaultProjectRoot()) {
         this.lastAlertTime = 0;
-        this.agentAwareDir = join(outputDir, AGENT_AWARE_DIR);
-        this.errorPath = join(this.agentAwareDir, ERROR_FILE);
+        this.alertDir = join(projectRoot, AGENT_AWARE_DIR, ALERT_DIR);
+        this.errorPath = join(this.alertDir, ERROR_FILE);
     }
     /**
      * 计算严重级别
@@ -61,12 +75,33 @@ export class AlertDetector {
         this.lastAlertTime = now;
     }
     /**
-     * 写入 error.json
+     * 读取现有的告警数据
+     */
+    async readAlerts() {
+        try {
+            const content = await readFile(this.errorPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // 文件不存在或损坏，返回空数据
+            return { version: STORAGE_VERSION, alerts: [] };
+        }
+    }
+    /**
+     * 写入 error.json（保留历史记录，最多 100 条）
      */
     async writeAlert(alert) {
         try {
-            await mkdir(this.agentAwareDir, { recursive: true });
-            await writeFile(this.errorPath, JSON.stringify(alert, null, 2), 'utf-8');
+            await mkdir(this.alertDir, { recursive: true });
+            // 读取现有数据
+            const data = await this.readAlerts();
+            // 追加新告警
+            data.alerts.push(alert);
+            // 限制数量（FIFO）
+            while (data.alerts.length > MAX_ALERTS) {
+                data.alerts.shift();
+            }
+            await writeFile(this.errorPath, JSON.stringify(data, null, 2), 'utf-8');
         }
         catch (error) {
             console.error('Failed to write error alert:', error);

package/dist/detector/alertDetector.js.map

@@ -1 +1 @@
-{"version":3,"file":"alertDetector.js","sourceRoot":"","sources":["../../src/detector/alertDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,MAAM,eAAe,GAAG,cAAc,CAAA;AACtC,MAAM,UAAU,GAAG,YAAY,CAAA;AAC/B,MAAM,iBAAiB,GAAG,KAAK,CAAA,CAAC,UAAU;AAuB1C,MAAM,OAAO,aAAa;IAKxB,YAAY,YAAoB,OAAO,CAAC,GAAG,EAAE;QAFrC,kBAAa,GAAW,CAAC,CAAA;QAG/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,YAA0B;QAC1C,gBAAgB;QAChB,IAAI,YAAY,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,UAAU,CAAA;QACnB,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,YAA0B;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAA;QAErD,aAAa;QACb,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAM;QACR,CAAC;QAED,QAAQ;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,IAAI,CAAC,aAAa,GAAG,iBAAiB,EAAE,CAAC;YACjD,OAAM;QACR,CAAC;QAED,gBAAgB;QAChB,MAAM,IAAI,CAAC,UAAU,CAAC;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;YACR,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC;YAC/C,OAAO,EAAE;gBACP,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,iBAAiB,EAAE,YAAY,CAAC,iBAAiB;gBACjD,uBAAuB,EAAE,YAAY,CAAC,uBAAuB;gBAC7D,iBAAiB,EAAE,YAAY,CAAC,iBAAiB;gBACjD,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACtD,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;iBAC7B,CAAC,CAAC;aACJ;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,aAAa,GAAG,GAAG,CAAA;IAC1B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CAAC,KAAiB;QACxC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACpD,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,YAA0B;QACpD,OAAO,OAAO,YAAY,CAAC,WAAW,SAAS,CAAA;IACjD,CAAC;CACF"}
+{"version":3,"file":"alertDetector.js","sourceRoot":"","sources":["../../src/detector/alertDetector.ts"],"names":[],"mappings":"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"}

package/dist/detector/behaviorDetector.d.ts

@@ -7,10 +7,14 @@
 import type { Summary } from '../types';
 export type IssueSeverity = 'critical' | 'warning' | 'info';
 export declare class BehaviorDetector {
-    private agentAwareDir;
+    private alertDir;
     private behaviorPath;
     private lastAlertTime;
-    constructor(outputDir?: string);
+    /**
+     * @param projectRoot 用户项目根目录，告警将写入 <projectRoot>/.agent-aware/alert/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot?: string);
     /**
      * 计算严重级别
      */
@@ -20,7 +24,11 @@ export declare class BehaviorDetector {
      */
     checkAndAlert(summary: Summary): Promise<void>;
     /**
-     * 写入 behavior.json
+     * 读取现有的告警数据
+     */
+    private readAlerts;
+    /**
+     * 写入 behavior.json（保留历史记录，最多 100 条）
      */
     private writeAlert;
     /**

package/dist/detector/behaviorDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behaviorDetector.d.ts","sourceRoot":"","sources":["../../src/detector/behaviorDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAMvC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAe3D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAY;gBAErB,SAAS,GAAE,MAAsB;IAK7C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAoBlD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BpD;;OAEG;YACW,UAAU;IASxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAM5B"}
+{"version":3,"file":"behaviorDetector.d.ts","sourceRoot":"","sources":["../../src/detector/behaviorDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAiBvC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAoB3D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAY;IAEjC;;;OAGG;gBACS,WAAW,GAAE,MAAgC;IAKzD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAoBlD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BpD;;OAEG;YACW,UAAU;IAUxB;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist/detector/behaviorDetector.js

@@ -4,16 +4,30 @@
  *
  * 职责：检测消极的用户交互行为
  */
-import { writeFile, mkdir } from 'node:fs/promises';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 const AGENT_AWARE_DIR = '.agent-aware';
+const ALERT_DIR = 'alert';
 const BEHAVIOR_FILE = 'behavior.json';
 const ALERT_COOLDOWN_MS = 10000; // 10 秒冷却期
+const MAX_ALERTS = 100; // 最多保留 100 条历史记录
+const STORAGE_VERSION = '1.0';
+/**
+ * 获取默认的项目根目录
+ * 优先级：环境变量 USER_PROJECT_ROOT > process.cwd()
+ */
+function getDefaultProjectRoot() {
+    return process.env.USER_PROJECT_ROOT || process.cwd();
+}
 export class BehaviorDetector {
-    constructor(outputDir = process.cwd()) {
+    /**
+     * @param projectRoot 用户项目根目录，告警将写入 <projectRoot>/.agent-aware/alert/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot = getDefaultProjectRoot()) {
         this.lastAlertTime = 0;
-        this.agentAwareDir = join(outputDir, AGENT_AWARE_DIR);
-        this.behaviorPath = join(this.agentAwareDir, BEHAVIOR_FILE);
+        this.alertDir = join(projectRoot, AGENT_AWARE_DIR, ALERT_DIR);
+        this.behaviorPath = join(this.alertDir, BEHAVIOR_FILE);
     }
     /**
      * 计算严重级别
@@ -65,12 +79,33 @@ export class BehaviorDetector {
         this.lastAlertTime = now;
     }
     /**
-     * 写入 behavior.json
+     * 读取现有的告警数据
+     */
+    async readAlerts() {
+        try {
+            const content = await readFile(this.behaviorPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // 文件不存在或损坏，返回空数据
+            return { version: STORAGE_VERSION, alerts: [] };
+        }
+    }
+    /**
+     * 写入 behavior.json（保留历史记录，最多 100 条）
      */
     async writeAlert(alert) {
         try {
-            await mkdir(this.agentAwareDir, { recursive: true });
-            await writeFile(this.behaviorPath, JSON.stringify(alert, null, 2), 'utf-8');
+            await mkdir(this.alertDir, { recursive: true });
+            // 读取现有数据
+            const data = await this.readAlerts();
+            // 追加新告警
+            data.alerts.push(alert);
+            // 限制数量（FIFO）
+            while (data.alerts.length > MAX_ALERTS) {
+                data.alerts.shift();
+            }
+            await writeFile(this.behaviorPath, JSON.stringify(data, null, 2), 'utf-8');
         }
         catch (error) {
             console.error('Failed to write behavior alert:', error);

package/dist/detector/behaviorDetector.js.map

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

package/dist/httpApi.js

@@ -52,8 +52,8 @@ export function createHttpApi(store, errorStore, behaviorDetector, alertDetector
         const behaviors = await store.query({ types, limit });
         return c.json(behaviors);
     });
-    // GET /summary - 获取行为摘要
-    app.get('/summary', async (c) => {
+    // GET /behaviors/summary - 获取行为摘要
+    app.get('/behaviors/summary', async (c) => {
         const summary = await store.getSummary();
         return c.json(summary);
     });

package/dist/httpApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"httpApi.js","sourceRoot":"","sources":["../src/httpApi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAehC,MAAM,UAAU,aAAa,CAC3B,KAAoB,EACpB,UAAuB,EACvB,gBAAmC,EACnC,aAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IAEtB,yBAAyB;IACzB,8CAA8C;IAC9C,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;QACjB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,GAAG,EAAE,wBAAwB;QAC3D,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;QAClD,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,aAAa,EAAE,CAAC,gBAAgB,CAAC;QACjC,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,IAAI,EAAE,cAAc;KAClC,CAAC,CAAC,CAAA;IAEH,mCAAmC;IAEnC,2BAA2B;IAC3B,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAoB,CAAA;YACjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAA;YAEtC,MAAM,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;YAE/B,gBAAgB;YAChB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAA;gBACxC,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACpD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;gBAClD,CAAC,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,QAAQ,GAAsB;gBAClC,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,SAAS,CAAC,MAAM;aACxB,CAAA;YAED,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,kCAAkC;IAElC,0BAA0B;IAC1B,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAEvC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC,CAAC,CAAC,SAAS,CAAA;QAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAE/D,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACrD,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAA;QACxC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAE/D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC/C,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,qBAAqB;IACrB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAA;QAExC,MAAM,QAAQ,GAAmB;YAC/B,MAAM,EAAE,IAAI;YACZ,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAA;QAED,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,2BAA2B;IAC3B,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACnC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;QACnB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,uCAAuC;IAEvC,IAAI,UAAU,EAAE,CAAC;QACf,wBAAwB;QACxB,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAiB,CAAA;gBAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAA;gBAEhC,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBAEjC,gBAAgB;gBAChB,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAA;oBAClD,aAAa,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;wBACtD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAA;oBAC/C,CAAC,CAAC,CAAA;gBACJ,CAAC;gBAED,MAAM,QAAQ,GAAmB;oBAC/B,EAAE,EAAE,IAAI;oBACR,KAAK,EAAE,MAAM,CAAC,MAAM;iBACrB,CAAA;gBAED,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,CAAA;YAC1D,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,uBAAuB;QACvB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC7B,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;YACjD,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAEvC,MAAM,UAAU,GAAG,eAAe;gBAChC,CAAC,CAAE,eAAe,CAAC,KAAK,CAAC,GAAG,CAAiB;gBAC7C,CAAC,CAAC,SAAS,CAAA;YACb,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAE/D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;YAC5D,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;QAEF,+BAA+B;QAC/B,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAA;YAC7C,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;QAEF,0BAA0B;QAC1B,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAChC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAA;YACxB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"httpApi.js","sourceRoot":"","sources":["../src/httpApi.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,14 @@
 /**
- * Agent-aware Server 入口
- * HTTP Server (Hono)
- * 基于 SPEC-SRV-005: Detector 架构重构
+ * Agent-aware Server 包入口
+ * 基于 SPEC-SRV-006: Package Entry Architecture
+ *
+ * 此文件只导出公共 API，不执行任何代码（无副作用）
+ * 服务器启动入口请使用 cli.ts
  */
-export {};
+export { createHttpApi } from './httpApi';
+export { BehaviorStore } from './store/behaviorStore';
+export { ErrorStore } from './store/errorStore';
+export { BehaviorDetector } from './detector/behaviorDetector';
+export { AlertDetector } from './detector/alertDetector';
+export type { Behavior, Summary, Hotspot, ErrorRecord, ErrorSummary } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAGxD,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -1,41 +1,16 @@
 /**
- * Agent-aware Server 入口
- * HTTP Server (Hono)
- * 基于 SPEC-SRV-005: Detector 架构重构
+ * Agent-aware Server 包入口
+ * 基于 SPEC-SRV-006: Package Entry Architecture
+ *
+ * 此文件只导出公共 API，不执行任何代码（无副作用）
+ * 服务器启动入口请使用 cli.ts
  */
-import { serve } from '@hono/node-server';
-import { createHttpApi } from './httpApi';
-import { BehaviorStore } from './store/behaviorStore';
-import { ErrorStore } from './store/errorStore';
-import { BehaviorDetector } from './detector/behaviorDetector';
-import { AlertDetector } from './detector/alertDetector';
-const PORT = 4100;
-const DATA_DIR = './data';
-// 检测器输出到用户项目根目录
-// 优先级：环境变量 > process.cwd()
-const PROJECT_ROOT = process.env.USER_PROJECT_ROOT || process.cwd();
-const store = new BehaviorStore(DATA_DIR);
-const errorStore = new ErrorStore(DATA_DIR);
-const behaviorDetector = new BehaviorDetector(PROJECT_ROOT);
-const alertDetector = new AlertDetector(PROJECT_ROOT);
-const app = createHttpApi(store, errorStore, behaviorDetector, alertDetector);
-console.log(`[AgentAware Server] Starting on port ${PORT}...`);
-console.log(`[AgentAware Server] Project root: ${PROJECT_ROOT}`);
-console.log(`[AgentAware Server] Output directory: ${PROJECT_ROOT}/.agent-aware/`);
-serve({
-    fetch: app.fetch,
-    port: PORT,
-});
-console.log(`[AgentAware Server] HTTP API listening on http://localhost:${PORT}`);
-console.log(`[AgentAware Server] Endpoints:`);
-console.log(`  POST   /behaviors       - 接收行为数据`);
-console.log(`  GET    /behaviors       - 查询行为数据`);
-console.log(`  GET    /summary         - 获取行为摘要`);
-console.log(`  GET    /hotspots        - 获取交互热点`);
-console.log(`  GET    /health          - 健康检查`);
-console.log(`  DELETE /behaviors       - 清空行为数据`);
-console.log(`  POST   /errors          - 接收错误数据`);
-console.log(`  GET    /errors          - 查询错误数据`);
-console.log(`  GET    /errors/summary  - 获取错误摘要`);
-console.log(`  DELETE /errors          - 清空错误数据`);
+// 核心函数
+export { createHttpApi } from './httpApi';
+// 存储
+export { BehaviorStore } from './store/behaviorStore';
+export { ErrorStore } from './store/errorStore';
+// 检测器
+export { BehaviorDetector } from './detector/behaviorDetector';
+export { AlertDetector } from './detector/alertDetector';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,IAAI,GAAG,IAAI,CAAA;AACjB,MAAM,QAAQ,GAAG,QAAQ,CAAA;AACzB,gBAAgB;AAChB,2BAA2B;AAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;AAEnE,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAA;AACzC,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAA;AAC3C,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAA;AAC3D,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;AACrD,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAA;AAE7E,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,KAAK,CAAC,CAAA;AAC9D,OAAO,CAAC,GAAG,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAA;AAChE,OAAO,CAAC,GAAG,CAAC,yCAAyC,YAAY,gBAAgB,CAAC,CAAA;AAElF,KAAK,CAAC;IACJ,KAAK,EAAE,GAAG,CAAC,KAAK;IAChB,IAAI,EAAE,IAAI;CACX,CAAC,CAAA;AAEF,OAAO,CAAC,GAAG,CAAC,8DAA8D,IAAI,EAAE,CAAC,CAAA;AACjF,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;AAC7C,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;AAC/C,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AACjD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACP,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,KAAK;AACL,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM;AACN,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/store/behaviorStore.d.ts

@@ -1,12 +1,18 @@
 /**
  * BehaviorStore - 行为数据存储
  * 基于 SPEC-SRV-002
+ *
+ * 更新：存储路径统一到 .agent-aware/detail/ 目录
  */
 import type { Behavior, QueryOptions, Summary, Hotspot } from '../types';
 export declare class BehaviorStore {
-    private dataDir;
+    private detailDir;
     private filePath;
-    constructor(dataDir?: string);
+    /**
+     * @param projectRoot 用户项目根目录，数据将存储在 <projectRoot>/.agent-aware/detail/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot?: string);
     /**
      * 添加单条行为
      */

package/dist/store/behaviorStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behaviorStore.d.ts","sourceRoot":"","sources":["../../src/store/behaviorStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,QAAQ,EAER,YAAY,EACZ,OAAO,EACP,OAAO,EACR,MAAM,UAAU,CAAA;AAMjB,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,OAAO,GAAE,MAAiB;IAKtC;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAe5D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAwBpC;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiCxD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;YACW,IAAI;IAUlB;;OAEG;YACW,KAAK;CAKpB"}
+{"version":3,"file":"behaviorStore.d.ts","sourceRoot":"","sources":["../../src/store/behaviorStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,QAAQ,EAER,YAAY,EACZ,OAAO,EACP,OAAO,EACR,MAAM,UAAU,CAAA;AAgBjB,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAQ;IAExB;;;OAGG;gBACS,WAAW,GAAE,MAAgC;IAKzD;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAe5D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAwBpC;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiCxD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;YACW,IAAI;IAUlB;;OAEG;YACW,KAAK;CAKpB"}

package/dist/store/behaviorStore.js

@@ -1,16 +1,31 @@
 /**
  * BehaviorStore - 行为数据存储
  * 基于 SPEC-SRV-002
+ *
+ * 更新：存储路径统一到 .agent-aware/detail/ 目录
  */
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
+const AGENT_AWARE_DIR = '.agent-aware';
+const DETAIL_DIR = 'detail';
 const DATA_FILE = 'behaviors.json';
 const MAX_BEHAVIORS = 1000;
 const STORAGE_VERSION = '1.0';
+/**
+ * 获取默认的项目根目录
+ * 优先级：环境变量 USER_PROJECT_ROOT > process.cwd()
+ */
+function getDefaultProjectRoot() {
+    return process.env.USER_PROJECT_ROOT || process.cwd();
+}
 export class BehaviorStore {
-    constructor(dataDir = './data') {
-        this.dataDir = dataDir;
-        this.filePath = join(dataDir, DATA_FILE);
+    /**
+     * @param projectRoot 用户项目根目录，数据将存储在 <projectRoot>/.agent-aware/detail/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot = getDefaultProjectRoot()) {
+        this.detailDir = join(projectRoot, AGENT_AWARE_DIR, DETAIL_DIR);
+        this.filePath = join(this.detailDir, DATA_FILE);
     }
     /**
      * 添加单条行为
@@ -119,7 +134,7 @@ export class BehaviorStore {
      */
     async write(data) {
         // 确保目录存在
-        await mkdir(this.dataDir, { recursive: true });
+        await mkdir(this.detailDir, { recursive: true });
         await writeFile(this.filePath, JSON.stringify(data, null, 2), 'utf-8');
     }
 }

package/dist/store/behaviorStore.js.map

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

package/dist/store/errorStore.d.ts

@@ -1,12 +1,18 @@
 /**
  * ErrorStore - 错误数据存储
  * 基于 SPEC-SRV-003: Errors API
+ *
+ * 更新：存储路径统一到 .agent-aware/detail/ 目录
  */
 import type { ErrorRecord, ErrorQueryOptions, ErrorSummary } from '../types';
 export declare class ErrorStore {
-    private dataDir;
+    private detailDir;
     private filePath;
-    constructor(dataDir?: string);
+    /**
+     * @param projectRoot 用户项目根目录，数据将存储在 <projectRoot>/.agent-aware/detail/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot?: string);
     /**
      * 添加单条错误
      */

package/dist/store/errorStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorStore.d.ts","sourceRoot":"","sources":["../../src/store/errorStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,YAAY,EACb,MAAM,UAAU,CAAA;AAMjB,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,OAAO,GAAE,MAAiB;IAKtC;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAepE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAuBzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;YACW,IAAI;IAUlB;;OAEG;YACW,KAAK;CAKpB"}
+{"version":3,"file":"errorStore.d.ts","sourceRoot":"","sources":["../../src/store/errorStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,YAAY,EACb,MAAM,UAAU,CAAA;AAgBjB,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAQ;IAExB;;;OAGG;gBACS,WAAW,GAAE,MAAgC;IAKzD;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAepE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAuBzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;YACW,IAAI;IAUlB;;OAEG;YACW,KAAK;CAKpB"}

package/dist/store/errorStore.js

@@ -1,16 +1,31 @@
 /**
  * ErrorStore - 错误数据存储
  * 基于 SPEC-SRV-003: Errors API
+ *
+ * 更新：存储路径统一到 .agent-aware/detail/ 目录
  */
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
+const AGENT_AWARE_DIR = '.agent-aware';
+const DETAIL_DIR = 'detail';
 const DATA_FILE = 'errors.json';
 const MAX_ERRORS = 1000;
 const STORAGE_VERSION = '1.0';
+/**
+ * 获取默认的项目根目录
+ * 优先级：环境变量 USER_PROJECT_ROOT > process.cwd()
+ */
+function getDefaultProjectRoot() {
+    return process.env.USER_PROJECT_ROOT || process.cwd();
+}
 export class ErrorStore {
-    constructor(dataDir = './data') {
-        this.dataDir = dataDir;
-        this.filePath = join(dataDir, DATA_FILE);
+    /**
+     * @param projectRoot 用户项目根目录，数据将存储在 <projectRoot>/.agent-aware/detail/
+     *                    默认从环境变量 USER_PROJECT_ROOT 读取，如果未设置则使用 process.cwd()
+     */
+    constructor(projectRoot = getDefaultProjectRoot()) {
+        this.detailDir = join(projectRoot, AGENT_AWARE_DIR, DETAIL_DIR);
+        this.filePath = join(this.detailDir, DATA_FILE);
     }
     /**
      * 添加单条错误
@@ -88,7 +103,7 @@ export class ErrorStore {
      */
     async write(data) {
         // 确保目录存在
-        await mkdir(this.dataDir, { recursive: true });
+        await mkdir(this.detailDir, { recursive: true });
         await writeFile(this.filePath, JSON.stringify(data, null, 2), 'utf-8');
     }
 }

package/dist/store/errorStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"errorStore.js","sourceRoot":"","sources":["../../src/store/errorStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAQhC,MAAM,SAAS,GAAG,aAAa,CAAA;AAC/B,MAAM,UAAU,GAAG,IAAI,CAAA;AACvB,MAAM,eAAe,GAAG,KAAK,CAAA;AAE7B,MAAM,OAAO,UAAU;IAIrB,YAAY,UAAkB,QAAQ;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAAkB;QAC1B,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAwB;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;QAE9B,OAAO;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,UAA6B,EAAE;QACzC,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAE9B,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAA;QAEzB,QAAQ;QACR,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;QACnE,CAAC;QAED,YAAY;QACZ,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAA;QACjC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,MAAM,CAAA;QAChF,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,qBAAqB,CAC7C,CAAC,MAAM,CAAA;QACR,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,MAAM,CAAA;QAEhF,WAAW;QACX,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAErC,OAAO;YACL,WAAW;YACX,iBAAiB;YACjB,uBAAuB;YACvB,iBAAiB;YACjB,YAAY;SACb,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;YACjB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,KAAK,CAAC,IAAsB;QACxC,SAAS;QACT,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9C,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACxE,CAAC;CACF"}
+{"version":3,"file":"errorStore.js","sourceRoot":"","sources":["../../src/store/errorStore.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reskill/agent-aware-server",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Agent-aware RUM Server - HTTP API for user behavior tracking",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,8 +43,8 @@
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsx watch src/index.ts",
-    "start": "node dist/index.js",
+    "dev": "tsx watch src/cli.ts start",
+    "start": "node dist/cli.js start",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"