@dommaker/harness 1.1.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (348) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +2 -4
  3. package/bin/harness.js +12 -37
  4. package/dist/cli/commands/check.d.ts +2 -2
  5. package/dist/cli/commands/check.d.ts.map +1 -1
  6. package/dist/cli/commands/check.js +7 -32
  7. package/dist/cli/commands/check.js.map +1 -1
  8. package/dist/cli/commands/definitions.d.ts +2 -0
  9. package/dist/cli/commands/definitions.d.ts.map +1 -1
  10. package/dist/cli/commands/definitions.js.map +1 -1
  11. package/dist/cli/commands/init.d.ts.map +1 -1
  12. package/dist/cli/commands/init.js +6 -37
  13. package/dist/cli/commands/init.js.map +1 -1
  14. package/dist/cli/commands/knowledge.d.ts.map +1 -1
  15. package/dist/cli/commands/knowledge.js +1 -12
  16. package/dist/cli/commands/knowledge.js.map +1 -1
  17. package/dist/cli/commands/report.d.ts.map +1 -1
  18. package/dist/cli/commands/report.js +0 -2
  19. package/dist/cli/commands/report.js.map +1 -1
  20. package/dist/cli/commands/status.js +2 -2
  21. package/dist/cli/commands/status.js.map +1 -1
  22. package/dist/context/index.d.ts +9 -6
  23. package/dist/context/index.d.ts.map +1 -1
  24. package/dist/context/index.js +18 -20
  25. package/dist/context/index.js.map +1 -1
  26. package/dist/core/constraints/capabilities-parser.d.ts +3 -2
  27. package/dist/core/constraints/capabilities-parser.d.ts.map +1 -1
  28. package/dist/core/constraints/capabilities-parser.js +25 -47
  29. package/dist/core/constraints/capabilities-parser.js.map +1 -1
  30. package/dist/core/constraints/checker.d.ts +29 -32
  31. package/dist/core/constraints/checker.d.ts.map +1 -1
  32. package/dist/core/constraints/checker.js +34 -126
  33. package/dist/core/constraints/checker.js.map +1 -1
  34. package/dist/core/constraints/checkers/index.d.ts +2 -1
  35. package/dist/core/constraints/checkers/index.d.ts.map +1 -1
  36. package/dist/core/constraints/checkers/index.js +3 -0
  37. package/dist/core/constraints/checkers/index.js.map +1 -1
  38. package/dist/core/constraints/checkers/types.d.ts +25 -0
  39. package/dist/core/constraints/checkers/types.d.ts.map +1 -1
  40. package/dist/core/constraints/checkers/types.js +24 -0
  41. package/dist/core/constraints/checkers/types.js.map +1 -1
  42. package/dist/core/constraints/definitions/guidelines.d.ts.map +1 -1
  43. package/dist/core/constraints/definitions/guidelines.js +0 -2
  44. package/dist/core/constraints/definitions/guidelines.js.map +1 -1
  45. package/dist/core/constraints/definitions/prompts.d.ts.map +1 -1
  46. package/dist/core/constraints/definitions/prompts.js +0 -5
  47. package/dist/core/constraints/definitions/prompts.js.map +1 -1
  48. package/dist/core/constraints/index.d.ts +1 -2
  49. package/dist/core/constraints/index.d.ts.map +1 -1
  50. package/dist/core/constraints/index.js +1 -7
  51. package/dist/core/constraints/index.js.map +1 -1
  52. package/dist/core/constraints/usage-report.d.ts +1 -2
  53. package/dist/core/constraints/usage-report.d.ts.map +1 -1
  54. package/dist/core/constraints/usage-report.js +2 -5
  55. package/dist/core/constraints/usage-report.js.map +1 -1
  56. package/dist/core/effective-constraints.d.ts +24 -4
  57. package/dist/core/effective-constraints.d.ts.map +1 -1
  58. package/dist/core/effective-constraints.js +28 -7
  59. package/dist/core/effective-constraints.js.map +1 -1
  60. package/dist/core/effective-set.d.ts +30 -0
  61. package/dist/core/effective-set.d.ts.map +1 -0
  62. package/dist/core/effective-set.js +35 -0
  63. package/dist/core/effective-set.js.map +1 -0
  64. package/dist/core/index.d.ts +13 -6
  65. package/dist/core/index.d.ts.map +1 -1
  66. package/dist/core/index.js +44 -21
  67. package/dist/core/index.js.map +1 -1
  68. package/dist/core/project-config-loader.d.ts +3 -6
  69. package/dist/core/project-config-loader.d.ts.map +1 -1
  70. package/dist/core/project-config-loader.js +47 -61
  71. package/dist/core/project-config-loader.js.map +1 -1
  72. package/dist/failure/constraint-handler.d.ts +1 -1
  73. package/dist/failure/constraint-handler.js +1 -1
  74. package/dist/gates/checker-gate.d.ts +1 -4
  75. package/dist/gates/checker-gate.d.ts.map +1 -1
  76. package/dist/gates/checker-gate.js +3 -11
  77. package/dist/gates/checker-gate.js.map +1 -1
  78. package/dist/gates/definitions.d.ts +9 -38
  79. package/dist/gates/definitions.d.ts.map +1 -1
  80. package/dist/gates/definitions.js +24 -13
  81. package/dist/gates/definitions.js.map +1 -1
  82. package/dist/gates/effective-gates.d.ts.map +1 -1
  83. package/dist/gates/effective-gates.js +14 -18
  84. package/dist/gates/effective-gates.js.map +1 -1
  85. package/dist/gates/index.d.ts +1 -1
  86. package/dist/gates/index.d.ts.map +1 -1
  87. package/dist/gates/index.js.map +1 -1
  88. package/dist/hooks/bootstrap.d.ts.map +1 -1
  89. package/dist/hooks/bootstrap.js +0 -3
  90. package/dist/hooks/bootstrap.js.map +1 -1
  91. package/dist/index.d.ts +43 -60
  92. package/dist/index.d.ts.map +1 -1
  93. package/dist/index.js +180 -143
  94. package/dist/index.js.map +1 -1
  95. package/dist/knowledge/query.d.ts +15 -0
  96. package/dist/knowledge/query.d.ts.map +1 -1
  97. package/dist/knowledge/query.js +23 -0
  98. package/dist/knowledge/query.js.map +1 -1
  99. package/dist/monitoring/analyzer-base.d.ts +0 -4
  100. package/dist/monitoring/analyzer-base.d.ts.map +1 -1
  101. package/dist/monitoring/analyzer-base.js +0 -21
  102. package/dist/monitoring/analyzer-base.js.map +1 -1
  103. package/dist/monitoring/index.d.ts +6 -12
  104. package/dist/monitoring/index.d.ts.map +1 -1
  105. package/dist/monitoring/index.js +13 -29
  106. package/dist/monitoring/index.js.map +1 -1
  107. package/dist/monitoring/trace-analyzer.d.ts.map +1 -1
  108. package/dist/monitoring/trace-analyzer.js +2 -68
  109. package/dist/monitoring/trace-analyzer.js.map +1 -1
  110. package/dist/monitoring/traces.d.ts +0 -4
  111. package/dist/monitoring/traces.d.ts.map +1 -1
  112. package/dist/monitoring/traces.js +0 -14
  113. package/dist/monitoring/traces.js.map +1 -1
  114. package/dist/presets/index.d.ts +2 -2
  115. package/dist/presets/index.d.ts.map +1 -1
  116. package/dist/presets/index.js +3 -4
  117. package/dist/presets/index.js.map +1 -1
  118. package/dist/presets/standard.d.ts +10 -22
  119. package/dist/presets/standard.d.ts.map +1 -1
  120. package/dist/presets/standard.js +15 -75
  121. package/dist/presets/standard.js.map +1 -1
  122. package/dist/types/constraint.d.ts +1 -29
  123. package/dist/types/constraint.d.ts.map +1 -1
  124. package/dist/types/constraint.js +1 -1
  125. package/dist/types/constraint.js.map +1 -1
  126. package/dist/types/index.d.ts +0 -3
  127. package/dist/types/index.d.ts.map +1 -1
  128. package/dist/types/index.js +0 -4
  129. package/dist/types/index.js.map +1 -1
  130. package/dist/types/project-config.d.ts +4 -8
  131. package/dist/types/project-config.d.ts.map +1 -1
  132. package/dist/types/trace.d.ts +5 -18
  133. package/dist/types/trace.d.ts.map +1 -1
  134. package/package.json +2 -2
  135. package/src/CONTEXT.md +4 -5
  136. package/src/__tests__/checker-extra.test.ts +33 -139
  137. package/src/__tests__/checker.test.ts +0 -376
  138. package/src/__tests__/project-config-loader-extra.test.ts +42 -29
  139. package/src/__tests__/public-exports.test.ts +138 -0
  140. package/src/__tests__/trace-analyzer-extra.test.ts +6 -86
  141. package/src/__tests__/trace-analyzer.test.ts +4 -5
  142. package/src/__tests__/trace-collector.test.ts +0 -11
  143. package/src/__tests__/traces.test.ts +3 -22
  144. package/src/cli/commands/CONTEXT.md +2 -2
  145. package/src/cli/commands/__tests__/check-skip-output.test.ts +10 -7
  146. package/src/cli/commands/__tests__/check.test.ts +29 -69
  147. package/src/cli/commands/__tests__/constraints-report.test.ts +1 -1
  148. package/src/cli/commands/__tests__/knowledge.test.ts +90 -1
  149. package/src/cli/commands/__tests__/registry.test.ts +8 -6
  150. package/src/cli/commands/__tests__/status-extra.test.ts +6 -6
  151. package/src/cli/commands/__tests__/status.test.ts +6 -6
  152. package/src/cli/commands/check.ts +8 -34
  153. package/src/cli/commands/definitions.ts +2 -0
  154. package/src/cli/commands/init.ts +6 -37
  155. package/src/cli/commands/knowledge.ts +1 -16
  156. package/src/cli/commands/report.ts +0 -2
  157. package/src/cli/commands/status.ts +2 -2
  158. package/src/context/index.ts +29 -6
  159. package/src/core/CONTEXT.md +4 -3
  160. package/src/core/__tests__/effective-set.test.ts +80 -0
  161. package/src/core/constraints/capabilities-parser.ts +43 -49
  162. package/src/core/constraints/checker.ts +51 -145
  163. package/src/core/constraints/checkers/index.ts +2 -1
  164. package/src/core/constraints/checkers/types.ts +42 -0
  165. package/src/core/constraints/definitions/guidelines.ts +0 -2
  166. package/src/core/constraints/definitions/prompts.ts +0 -5
  167. package/src/core/constraints/index.ts +2 -17
  168. package/src/core/constraints/usage-report.ts +5 -8
  169. package/src/core/effective-constraints.ts +35 -7
  170. package/src/core/effective-set.ts +56 -0
  171. package/src/core/index.ts +80 -6
  172. package/src/core/project-config-loader.ts +53 -68
  173. package/src/failure/CONTEXT.md +1 -1
  174. package/src/failure/constraint-handler.ts +1 -1
  175. package/src/gates/CONTEXT.md +3 -3
  176. package/src/gates/checker-gate.ts +4 -12
  177. package/src/gates/definitions.ts +27 -50
  178. package/src/gates/effective-gates.ts +14 -21
  179. package/src/gates/index.ts +1 -1
  180. package/src/hooks/bootstrap.ts +0 -3
  181. package/src/index.ts +384 -148
  182. package/src/knowledge/CONTEXT.md +2 -2
  183. package/src/knowledge/__tests__/query.test.ts +64 -0
  184. package/src/knowledge/query.ts +28 -0
  185. package/src/monitoring/CONTEXT.md +7 -13
  186. package/src/monitoring/__tests__/traces.test.ts +0 -10
  187. package/src/monitoring/analyzer-base.ts +0 -22
  188. package/src/monitoring/index.ts +6 -12
  189. package/src/monitoring/trace-analyzer.ts +2 -73
  190. package/src/monitoring/traces.ts +0 -20
  191. package/src/presets/__tests__/standard.test.ts +48 -69
  192. package/src/presets/index.ts +3 -5
  193. package/src/presets/standard.ts +14 -79
  194. package/src/spec/CONTEXT.md +5 -13
  195. package/src/types/constraint.ts +1 -51
  196. package/src/types/index.ts +0 -12
  197. package/src/types/project-config.ts +4 -10
  198. package/src/types/trace.ts +5 -30
  199. package/dist/core/constraints/interceptor.d.ts +0 -39
  200. package/dist/core/constraints/interceptor.d.ts.map +0 -1
  201. package/dist/core/constraints/interceptor.js +0 -166
  202. package/dist/core/constraints/interceptor.js.map +0 -1
  203. package/dist/dashboard/data.d.ts +0 -31
  204. package/dist/dashboard/data.d.ts.map +0 -1
  205. package/dist/dashboard/data.js +0 -81
  206. package/dist/dashboard/data.js.map +0 -1
  207. package/dist/dashboard/index.d.ts +0 -4
  208. package/dist/dashboard/index.d.ts.map +0 -1
  209. package/dist/dashboard/index.js +0 -20
  210. package/dist/dashboard/index.js.map +0 -1
  211. package/dist/dashboard/stats.d.ts +0 -20
  212. package/dist/dashboard/stats.d.ts.map +0 -1
  213. package/dist/dashboard/stats.js +0 -115
  214. package/dist/dashboard/stats.js.map +0 -1
  215. package/dist/dashboard/types.d.ts +0 -110
  216. package/dist/dashboard/types.d.ts.map +0 -1
  217. package/dist/dashboard/types.js +0 -8
  218. package/dist/dashboard/types.js.map +0 -1
  219. package/dist/monitoring/constraint-doctor.d.ts +0 -76
  220. package/dist/monitoring/constraint-doctor.d.ts.map +0 -1
  221. package/dist/monitoring/constraint-doctor.js +0 -189
  222. package/dist/monitoring/constraint-doctor.js.map +0 -1
  223. package/dist/monitoring/diagnosis-rules.d.ts +0 -18
  224. package/dist/monitoring/diagnosis-rules.d.ts.map +0 -1
  225. package/dist/monitoring/diagnosis-rules.js +0 -119
  226. package/dist/monitoring/diagnosis-rules.js.map +0 -1
  227. package/dist/monitoring/knowledge-doctor.d.ts +0 -78
  228. package/dist/monitoring/knowledge-doctor.d.ts.map +0 -1
  229. package/dist/monitoring/knowledge-doctor.js +0 -266
  230. package/dist/monitoring/knowledge-doctor.js.map +0 -1
  231. package/dist/monitoring/knowledge-evolver.d.ts +0 -72
  232. package/dist/monitoring/knowledge-evolver.d.ts.map +0 -1
  233. package/dist/monitoring/knowledge-evolver.js +0 -205
  234. package/dist/monitoring/knowledge-evolver.js.map +0 -1
  235. package/dist/monitoring/performance-analyzer.d.ts +0 -92
  236. package/dist/monitoring/performance-analyzer.d.ts.map +0 -1
  237. package/dist/monitoring/performance-analyzer.js +0 -343
  238. package/dist/monitoring/performance-analyzer.js.map +0 -1
  239. package/dist/monitoring/performance-collector.d.ts +0 -103
  240. package/dist/monitoring/performance-collector.d.ts.map +0 -1
  241. package/dist/monitoring/performance-collector.js +0 -298
  242. package/dist/monitoring/performance-collector.js.map +0 -1
  243. package/dist/safety/index.d.ts +0 -6
  244. package/dist/safety/index.d.ts.map +0 -1
  245. package/dist/safety/index.js +0 -22
  246. package/dist/safety/index.js.map +0 -1
  247. package/dist/safety/input-guardrail.d.ts +0 -36
  248. package/dist/safety/input-guardrail.d.ts.map +0 -1
  249. package/dist/safety/input-guardrail.js +0 -118
  250. package/dist/safety/input-guardrail.js.map +0 -1
  251. package/dist/safety/output-guardrail.d.ts +0 -39
  252. package/dist/safety/output-guardrail.d.ts.map +0 -1
  253. package/dist/safety/output-guardrail.js +0 -147
  254. package/dist/safety/output-guardrail.js.map +0 -1
  255. package/dist/safety/sandbox.d.ts +0 -45
  256. package/dist/safety/sandbox.d.ts.map +0 -1
  257. package/dist/safety/sandbox.js +0 -134
  258. package/dist/safety/sandbox.js.map +0 -1
  259. package/dist/safety/tool-guardrail.d.ts +0 -51
  260. package/dist/safety/tool-guardrail.d.ts.map +0 -1
  261. package/dist/safety/tool-guardrail.js +0 -147
  262. package/dist/safety/tool-guardrail.js.map +0 -1
  263. package/dist/safety/types.d.ts +0 -104
  264. package/dist/safety/types.d.ts.map +0 -1
  265. package/dist/safety/types.js +0 -6
  266. package/dist/safety/types.js.map +0 -1
  267. package/dist/spec/annotation-checker.d.ts +0 -47
  268. package/dist/spec/annotation-checker.d.ts.map +0 -1
  269. package/dist/spec/annotation-checker.js +0 -279
  270. package/dist/spec/annotation-checker.js.map +0 -1
  271. package/dist/types/enforcement.d.ts +0 -42
  272. package/dist/types/enforcement.d.ts.map +0 -1
  273. package/dist/types/enforcement.js +0 -6
  274. package/dist/types/enforcement.js.map +0 -1
  275. package/dist/types/monitoring-types.d.ts +0 -53
  276. package/dist/types/monitoring-types.d.ts.map +0 -1
  277. package/dist/types/monitoring-types.js +0 -10
  278. package/dist/types/monitoring-types.js.map +0 -1
  279. package/dist/types/performance.d.ts +0 -204
  280. package/dist/types/performance.d.ts.map +0 -1
  281. package/dist/types/performance.js +0 -12
  282. package/dist/types/performance.js.map +0 -1
  283. package/dist/verification/index.d.ts +0 -4
  284. package/dist/verification/index.d.ts.map +0 -1
  285. package/dist/verification/index.js +0 -20
  286. package/dist/verification/index.js.map +0 -1
  287. package/dist/verification/loop.d.ts +0 -30
  288. package/dist/verification/loop.d.ts.map +0 -1
  289. package/dist/verification/loop.js +0 -114
  290. package/dist/verification/loop.js.map +0 -1
  291. package/dist/verification/rules-based.d.ts +0 -40
  292. package/dist/verification/rules-based.d.ts.map +0 -1
  293. package/dist/verification/rules-based.js +0 -130
  294. package/dist/verification/rules-based.js.map +0 -1
  295. package/dist/verification/types.d.ts +0 -69
  296. package/dist/verification/types.d.ts.map +0 -1
  297. package/dist/verification/types.js +0 -6
  298. package/dist/verification/types.js.map +0 -1
  299. package/src/__tests__/annotation-checker.test.ts +0 -183
  300. package/src/__tests__/constraint-doctor.test.ts +0 -271
  301. package/src/__tests__/doctor-extra.test.ts +0 -155
  302. package/src/__tests__/extend-exceptions.test.ts +0 -149
  303. package/src/__tests__/interceptor.test.ts +0 -89
  304. package/src/__tests__/performance-analyzer.test.ts +0 -499
  305. package/src/__tests__/performance-collector.test.ts +0 -276
  306. package/src/__tests__/presets.test.ts +0 -65
  307. package/src/core/constraints/__tests__/interceptor.test.ts +0 -267
  308. package/src/core/constraints/interceptor.ts +0 -217
  309. package/src/dashboard/CONTEXT.md +0 -21
  310. package/src/dashboard/__tests__/data.test.ts +0 -111
  311. package/src/dashboard/__tests__/stats.test.ts +0 -159
  312. package/src/dashboard/data.ts +0 -103
  313. package/src/dashboard/index.ts +0 -3
  314. package/src/dashboard/stats.ts +0 -127
  315. package/src/dashboard/types.ts +0 -130
  316. package/src/monitoring/__tests__/knowledge-doctor.test.ts +0 -278
  317. package/src/monitoring/__tests__/knowledge-evolver.test.ts +0 -368
  318. package/src/monitoring/__tests__/performance-analyzer.test.ts +0 -137
  319. package/src/monitoring/__tests__/performance-collector.test.ts +0 -331
  320. package/src/monitoring/constraint-doctor.ts +0 -228
  321. package/src/monitoring/diagnosis-rules.ts +0 -132
  322. package/src/monitoring/knowledge-doctor.ts +0 -322
  323. package/src/monitoring/knowledge-evolver.ts +0 -289
  324. package/src/monitoring/performance-analyzer.ts +0 -400
  325. package/src/monitoring/performance-collector.ts +0 -326
  326. package/src/safety/CONTEXT.md +0 -23
  327. package/src/safety/__tests__/input-guardrail.test.ts +0 -105
  328. package/src/safety/__tests__/output-guardrail.test.ts +0 -108
  329. package/src/safety/__tests__/sandbox.test.ts +0 -158
  330. package/src/safety/__tests__/tool-guardrail.test.ts +0 -127
  331. package/src/safety/index.ts +0 -5
  332. package/src/safety/input-guardrail.ts +0 -133
  333. package/src/safety/output-guardrail.ts +0 -170
  334. package/src/safety/sandbox.ts +0 -148
  335. package/src/safety/tool-guardrail.ts +0 -176
  336. package/src/safety/types.ts +0 -124
  337. package/src/spec/__tests__/annotation-checker.test.ts +0 -294
  338. package/src/spec/annotation-checker.ts +0 -320
  339. package/src/types/enforcement.ts +0 -48
  340. package/src/types/monitoring-types.ts +0 -68
  341. package/src/types/performance.ts +0 -295
  342. package/src/verification/CONTEXT.md +0 -23
  343. package/src/verification/__tests__/loop.test.ts +0 -303
  344. package/src/verification/__tests__/rules-based.test.ts +0 -240
  345. package/src/verification/index.ts +0 -3
  346. package/src/verification/loop.ts +0 -137
  347. package/src/verification/rules-based.ts +0 -152
  348. package/src/verification/types.ts +0 -81
@@ -1,298 +0,0 @@
1
- "use strict";
2
- /**
3
- * Performance Collector
4
- *
5
- * 轻量设计,零 Token 成本
6
- *
7
- * 功能:
8
- * - 记录操作耗时(追加写入)
9
- * - 批量读取 traces(按时间范围过滤)
10
- * - 文件滚动(防止文件过大)
11
- *
12
- * 与 TraceCollector 的区别:
13
- * - TraceCollector: 记录约束检查结果
14
- * - PerformanceCollector: 记录操作耗时
15
- */
16
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
17
- if (k2 === undefined) k2 = k;
18
- var desc = Object.getOwnPropertyDescriptor(m, k);
19
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
20
- desc = { enumerable: true, get: function() { return m[k]; } };
21
- }
22
- Object.defineProperty(o, k2, desc);
23
- }) : (function(o, m, k, k2) {
24
- if (k2 === undefined) k2 = k;
25
- o[k2] = m[k];
26
- }));
27
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
28
- Object.defineProperty(o, "default", { enumerable: true, value: v });
29
- }) : function(o, v) {
30
- o["default"] = v;
31
- });
32
- var __importStar = (this && this.__importStar) || (function () {
33
- var ownKeys = function(o) {
34
- ownKeys = Object.getOwnPropertyNames || function (o) {
35
- var ar = [];
36
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
37
- return ar;
38
- };
39
- return ownKeys(o);
40
- };
41
- return function (mod) {
42
- if (mod && mod.__esModule) return mod;
43
- var result = {};
44
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
45
- __setModuleDefault(result, mod);
46
- return result;
47
- };
48
- })();
49
- Object.defineProperty(exports, "__esModule", { value: true });
50
- exports.PerformanceCollector = void 0;
51
- const fs = __importStar(require("fs"));
52
- const path = __importStar(require("path"));
53
- /**
54
- * 默认配置
55
- */
56
- const DEFAULT_CONFIG = {
57
- logFile: '.harness/logs/performance.log',
58
- maxFileSize: 10 * 1024 * 1024, // 10MB
59
- enabled: true,
60
- };
61
- /**
62
- * Performance Collector
63
- *
64
- * 使用方式:
65
- * ```typescript
66
- * const collector = new PerformanceCollector();
67
- * collector.recordOk('extract', 150);
68
- * collector.recordExceeded('invokeSkillAgent', 35000, 30000);
69
- * ```
70
- */
71
- class PerformanceCollector {
72
- config;
73
- logFile;
74
- constructor(config) {
75
- this.config = { ...DEFAULT_CONFIG, ...config };
76
- this.logFile = this.config.logFile;
77
- this.ensureDirectory();
78
- }
79
- /**
80
- * 确保日志目录存在
81
- */
82
- ensureDirectory() {
83
- const dir = path.dirname(this.logFile);
84
- if (!fs.existsSync(dir)) {
85
- fs.mkdirSync(dir, { recursive: true });
86
- }
87
- }
88
- /**
89
- * 记录一条性能数据
90
- *
91
- * 轻量操作:
92
- * - 追加写入(不读取现有内容)
93
- * - 单行 JSON(便于批量处理)
94
- * - 零 Token 成本
95
- */
96
- record(trace) {
97
- if (!this.config.enabled)
98
- return;
99
- // 检查文件大小,必要时滚动
100
- this.checkFileSize();
101
- // 追加写入
102
- const line = JSON.stringify(trace);
103
- fs.appendFileSync(this.logFile, line + '\n', 'utf-8');
104
- }
105
- /**
106
- * 快捷方法:记录正常执行
107
- */
108
- recordOk(operation, duration, metadata) {
109
- this.record({
110
- operation,
111
- timestamp: Date.now(),
112
- duration,
113
- result: 'ok',
114
- metadata,
115
- });
116
- }
117
- /**
118
- * 快捷方法:记录超阈值
119
- */
120
- recordExceeded(operation, duration, threshold, metadata) {
121
- this.record({
122
- operation,
123
- timestamp: Date.now(),
124
- duration,
125
- result: 'exceeded',
126
- threshold,
127
- metadata,
128
- });
129
- }
130
- /**
131
- * 快捷方法:记录错误
132
- */
133
- recordError(operation, duration, error, metadata) {
134
- this.record({
135
- operation,
136
- timestamp: Date.now(),
137
- duration,
138
- result: 'error',
139
- metadata: {
140
- ...metadata,
141
- error: error instanceof Error ? error.message : error,
142
- },
143
- });
144
- }
145
- /**
146
- * 批量读取 traces
147
- *
148
- * 支持过滤条件:
149
- * - 时间范围
150
- * - 操作类型
151
- * - 结果类型
152
- */
153
- read(filter) {
154
- if (!fs.existsSync(this.logFile)) {
155
- return [];
156
- }
157
- const content = fs.readFileSync(this.logFile, 'utf-8');
158
- const lines = content.split('\n').filter(l => l.trim());
159
- let traces = lines.map(line => JSON.parse(line));
160
- // 应用过滤条件
161
- if (filter) {
162
- traces = this.applyFilter(traces, filter);
163
- }
164
- return traces;
165
- }
166
- /**
167
- * 读取最近 N 小时的 traces
168
- */
169
- readRecent(hours) {
170
- const start = Date.now() - hours * 3600 * 1000;
171
- return this.read({ timeRange: { start, end: Date.now() } });
172
- }
173
- /**
174
- * 读取特定操作的 traces
175
- */
176
- readByOperation(operation) {
177
- return this.read({ operation });
178
- }
179
- /**
180
- * 应用过滤条件
181
- */
182
- applyFilter(traces, filter) {
183
- return traces.filter(trace => {
184
- // 操作类型
185
- if (filter.operation && trace.operation !== filter.operation) {
186
- return false;
187
- }
188
- // 结果
189
- if (filter.result && trace.result !== filter.result) {
190
- return false;
191
- }
192
- // 时间范围
193
- if (filter.timeRange) {
194
- if (trace.timestamp < filter.timeRange.start) {
195
- return false;
196
- }
197
- if (filter.timeRange.end && trace.timestamp > filter.timeRange.end) {
198
- return false;
199
- }
200
- }
201
- // 项目路径
202
- if (filter.projectPath && trace.projectPath !== filter.projectPath) {
203
- return false;
204
- }
205
- // 会话 ID
206
- if (filter.sessionId && trace.sessionId !== filter.sessionId) {
207
- return false;
208
- }
209
- // 任务 ID
210
- if (filter.taskId && trace.taskId !== filter.taskId) {
211
- return false;
212
- }
213
- // 角色 ID
214
- if (filter.roleId && trace.roleId !== filter.roleId) {
215
- return false;
216
- }
217
- return true;
218
- });
219
- }
220
- /**
221
- * 检查文件大小,必要时滚动
222
- */
223
- checkFileSize() {
224
- if (!fs.existsSync(this.logFile)) {
225
- return;
226
- }
227
- const stats = fs.statSync(this.logFile);
228
- if (stats.size >= this.config.maxFileSize) {
229
- this.rotateFile();
230
- }
231
- }
232
- /**
233
- * 滚动文件
234
- *
235
- * 将当前文件重命名为带时间戳的备份
236
- */
237
- rotateFile() {
238
- const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
239
- const backupFile = this.logFile.replace('.log', `-${timestamp}.log`);
240
- // 重命名当前文件
241
- fs.renameSync(this.logFile, backupFile);
242
- // 创建新文件
243
- fs.writeFileSync(this.logFile, '', 'utf-8');
244
- }
245
- /**
246
- * 清理旧备份文件
247
- *
248
- * 删除超过 maxAge 天的备份文件
249
- */
250
- cleanupOldFiles(maxAgeDays = 30) {
251
- const dir = path.dirname(this.logFile);
252
- if (!fs.existsSync(dir)) {
253
- return 0;
254
- }
255
- const files = fs.readdirSync(dir);
256
- const baseName = path.basename(this.logFile);
257
- const backupFiles = files.filter(f => f.endsWith('.log') && f !== baseName);
258
- const cutoffTime = Date.now() - maxAgeDays * 24 * 3600 * 1000;
259
- let deletedCount = 0;
260
- for (const file of backupFiles) {
261
- const filePath = path.join(dir, file);
262
- const stats = fs.statSync(filePath);
263
- if (stats.mtimeMs < cutoffTime) {
264
- fs.unlinkSync(filePath);
265
- deletedCount++;
266
- }
267
- }
268
- return deletedCount;
269
- }
270
- /**
271
- * 获取日志文件统计信息
272
- */
273
- getStats() {
274
- if (!fs.existsSync(this.logFile)) {
275
- return { fileExists: false, fileSize: 0, totalRecords: 0 };
276
- }
277
- const stats = fs.statSync(this.logFile);
278
- const content = fs.readFileSync(this.logFile, 'utf-8');
279
- const lines = content.split('\n').filter(l => l.trim());
280
- let oldest;
281
- let newest;
282
- if (lines.length > 0) {
283
- const firstTrace = JSON.parse(lines[0]);
284
- const lastTrace = JSON.parse(lines[lines.length - 1]);
285
- oldest = firstTrace.timestamp;
286
- newest = lastTrace.timestamp;
287
- }
288
- return {
289
- fileExists: true,
290
- fileSize: stats.size,
291
- totalRecords: lines.length,
292
- oldestRecord: oldest,
293
- newestRecord: newest,
294
- };
295
- }
296
- }
297
- exports.PerformanceCollector = PerformanceCollector;
298
- //# sourceMappingURL=performance-collector.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"performance-collector.js","sourceRoot":"","sources":["../../src/monitoring/performance-collector.ts"],"names":[],"mappings":"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"}
@@ -1,6 +0,0 @@
1
- export * from './types';
2
- export * from './sandbox';
3
- export * from './input-guardrail';
4
- export * from './output-guardrail';
5
- export * from './tool-guardrail';
6
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safety/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
@@ -1,22 +0,0 @@
1
- "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
- };
16
- Object.defineProperty(exports, "__esModule", { value: true });
17
- __exportStar(require("./types"), exports);
18
- __exportStar(require("./sandbox"), exports);
19
- __exportStar(require("./input-guardrail"), exports);
20
- __exportStar(require("./output-guardrail"), exports);
21
- __exportStar(require("./tool-guardrail"), exports);
22
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safety/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,4CAA0B;AAC1B,oDAAkC;AAClC,qDAAmC;AACnC,mDAAiC"}
@@ -1,36 +0,0 @@
1
- /**
2
- * 输入护栏
3
- *
4
- * 在首个 Agent 执行前检查输入:
5
- * - 注入防御(prompt injection)
6
- * - 意图校验
7
- * - 权限验证
8
- */
9
- import type { InputCheckResult, InputGuardrailConfig } from './types';
10
- export declare class InputGuardrail {
11
- private patterns;
12
- private blockedIntents;
13
- private maxInputLength;
14
- constructor(config?: InputGuardrailConfig);
15
- /**
16
- * 检查输入安全性
17
- */
18
- check(input: string): InputCheckResult;
19
- /**
20
- * 检查 prompt injection 模式
21
- */
22
- private checkInjection;
23
- /**
24
- * 检查恶意意图
25
- */
26
- private checkIntent;
27
- /**
28
- * 添加注入检测模式
29
- */
30
- addPattern(pattern: RegExp): void;
31
- /**
32
- * 添加阻止意图
33
- */
34
- addBlockedIntent(intent: string): void;
35
- }
36
- //# sourceMappingURL=input-guardrail.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"input-guardrail.d.ts","sourceRoot":"","sources":["../../src/safety/input-guardrail.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA+BtF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,CAAC,EAAE,oBAAoB;IAMzC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAwBtC;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGvC"}
@@ -1,118 +0,0 @@
1
- "use strict";
2
- /**
3
- * 输入护栏
4
- *
5
- * 在首个 Agent 执行前检查输入:
6
- * - 注入防御(prompt injection)
7
- * - 意图校验
8
- * - 权限验证
9
- */
10
- Object.defineProperty(exports, "__esModule", { value: true });
11
- exports.InputGuardrail = void 0;
12
- const DEFAULT_INJECTION_PATTERNS = [
13
- /ignore\s+(all\s+)?previous\s+instructions/i,
14
- /forget\s+(all\s+)?(previous|above)/i,
15
- /you\s+are\s+now\s+(a|an)\s+/i,
16
- /system\s*:\s*/i,
17
- /<\|im_start\|>/i,
18
- /\[INST\]/i,
19
- /<<SYS>>/i,
20
- /human\s*:\s*/i,
21
- /assistant\s*:\s*/i,
22
- /override\s+(all\s+)?safety/i,
23
- /disregard\s+(all\s+)?rules/i,
24
- /act\s+as\s+if\s+you\s+(are|were)/i,
25
- /pretend\s+you\s+(are|were|have\s+no)/i,
26
- /do\s+anything\s+now/i,
27
- /DAN\s+mode/i,
28
- ];
29
- const DEFAULT_BLOCKED_INTENTS = [
30
- 'delete all files',
31
- 'rm -rf /',
32
- 'format disk',
33
- 'drop table',
34
- 'shutdown',
35
- 'exfiltrate',
36
- ];
37
- const DEFAULT_MAX_INPUT_LENGTH = 50000;
38
- class InputGuardrail {
39
- patterns;
40
- blockedIntents;
41
- maxInputLength;
42
- constructor(config) {
43
- this.patterns = config?.injectionPatterns ?? DEFAULT_INJECTION_PATTERNS;
44
- this.blockedIntents = config?.blockedIntents ?? DEFAULT_BLOCKED_INTENTS;
45
- this.maxInputLength = config?.maxInputLength ?? DEFAULT_MAX_INPUT_LENGTH;
46
- }
47
- /**
48
- * 检查输入安全性
49
- */
50
- check(input) {
51
- const violations = [];
52
- // 长度检查
53
- if (input.length > this.maxInputLength) {
54
- violations.push({
55
- type: 'injection',
56
- severity: 'medium',
57
- description: `输入长度 ${input.length} 超过限制 ${this.maxInputLength}`,
58
- });
59
- }
60
- // 注入检测
61
- violations.push(...this.checkInjection(input));
62
- // 意图校验
63
- violations.push(...this.checkIntent(input));
64
- return {
65
- safe: violations.length === 0,
66
- violations,
67
- };
68
- }
69
- /**
70
- * 检查 prompt injection 模式
71
- */
72
- checkInjection(input) {
73
- const violations = [];
74
- for (const pattern of this.patterns) {
75
- const match = input.match(pattern);
76
- if (match) {
77
- violations.push({
78
- type: 'injection',
79
- severity: 'high',
80
- description: `检测到潜在注入模式: ${match[0]}`,
81
- matchedPattern: pattern.source,
82
- });
83
- }
84
- }
85
- return violations;
86
- }
87
- /**
88
- * 检查恶意意图
89
- */
90
- checkIntent(input) {
91
- const violations = [];
92
- const lower = input.toLowerCase();
93
- for (const intent of this.blockedIntents) {
94
- if (lower.includes(intent.toLowerCase())) {
95
- violations.push({
96
- type: 'intent',
97
- severity: 'high',
98
- description: `检测到被阻止的意图: ${intent}`,
99
- });
100
- }
101
- }
102
- return violations;
103
- }
104
- /**
105
- * 添加注入检测模式
106
- */
107
- addPattern(pattern) {
108
- this.patterns.push(pattern);
109
- }
110
- /**
111
- * 添加阻止意图
112
- */
113
- addBlockedIntent(intent) {
114
- this.blockedIntents.push(intent);
115
- }
116
- }
117
- exports.InputGuardrail = InputGuardrail;
118
- //# sourceMappingURL=input-guardrail.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"input-guardrail.js","sourceRoot":"","sources":["../../src/safety/input-guardrail.ts"],"names":[],"mappings":"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"}
@@ -1,39 +0,0 @@
1
- /**
2
- * 输出护栏
3
- *
4
- * 在最终输出前检查:
5
- * - 敏感信息审查(API keys, passwords, tokens)
6
- * - 代码质量检查
7
- * - 知识引用完整性
8
- */
9
- import type { OutputSafetyCheckResult, OutputGuardrailConfig } from './types';
10
- export declare class OutputGuardrail {
11
- private sensitivePatterns;
12
- private checkKnowledgeRefs;
13
- constructor(config?: OutputGuardrailConfig);
14
- /**
15
- * 检查输出安全性
16
- */
17
- check(content: string, knowledgeRefIds?: string[]): OutputSafetyCheckResult;
18
- /**
19
- * 检测敏感信息
20
- */
21
- private checkSensitiveInfo;
22
- /**
23
- * 代码质量检查(简单启发式)
24
- */
25
- private checkQuality;
26
- /**
27
- * 检查知识引用完整性
28
- */
29
- private checkKnowledgeRefs_;
30
- /**
31
- * 清理敏感信息
32
- */
33
- private sanitize;
34
- /**
35
- * 获取行号
36
- */
37
- private getLineNumber;
38
- }
39
- //# sourceMappingURL=output-guardrail.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"output-guardrail.d.ts","sourceRoot":"","sources":["../../src/safety/output-guardrail.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAmB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAmB/F,qBAAa,eAAe;IAC1B,OAAO,CAAC,iBAAiB,CAAW;IACpC,OAAO,CAAC,kBAAkB,CAAU;gBAExB,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,uBAAuB;IA4B3E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA+BpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAchB;;OAEG;IACH,OAAO,CAAC,aAAa;CAGtB"}