@ohos-cpf/3rdloop 0.0.2 → 0.0.3

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 (393) hide show
  1. package/README.md +244 -244
  2. package/bin/3rdloop.mjs +46 -46
  3. package/lib/cli.js +781 -781
  4. package/lib/config-cmd.js +451 -451
  5. package/lib/config.js +318 -318
  6. package/lib/doctor.js +113 -113
  7. package/lib/exit-codes.js +30 -30
  8. package/lib/opencode.js +155 -155
  9. package/lib/orch.js +426 -426
  10. package/lib/queries.js +263 -263
  11. package/lib/step.js +325 -325
  12. package/lib/ui.js +222 -222
  13. package/lib/update.js +279 -279
  14. package/lib/workflow.js +308 -308
  15. package/lib/workflows.js +131 -131
  16. package/package.json +50 -50
  17. package/vendor/Server/Agent/SkillSelector/README.md +343 -343
  18. package/vendor/Server/Agent/SkillSelector/core/Agent.js +207 -207
  19. package/vendor/Server/Agent/SkillSelector/index.js +14 -14
  20. package/vendor/Server/Agent/SkillSelector/llm/llmClient.js +313 -313
  21. package/vendor/Server/Agent/SkillSelector/llm/prompts.js +161 -161
  22. package/vendor/Server/Agent/SkillSelector/llm/reactSteps.js +144 -144
  23. package/vendor/Server/Agent/SkillSelector/matcher/fuzzyMatcher.js +433 -433
  24. package/vendor/Server/Agent/SkillSelector/scanner/skillScanner.js +382 -382
  25. package/vendor/Server/Agent/SkillSelector/utils/actionWords.js +59 -59
  26. package/vendor/Server/Brain/AnalysisStrategies.js +422 -422
  27. package/vendor/Server/Brain/Brain.js +686 -686
  28. package/vendor/Server/Brain/DecompositionStrategies.js +621 -621
  29. package/vendor/Server/Brain/PlanPersistence.js +196 -196
  30. package/vendor/Server/Brain/SkillExecutor.js +251 -251
  31. package/vendor/Server/Brain/index.js +11 -11
  32. package/vendor/Server/CLI/cli.js +275 -275
  33. package/vendor/Server/CLI/deveco-code/index.js +71 -71
  34. package/vendor/Server/CLI/deveco-code.js +5 -5
  35. package/vendor/Server/CLI/opencode/index.js +817 -818
  36. package/vendor/Server/CLI/opencode.js +5 -5
  37. package/vendor/Server/DbUse/MessageArchive.js +61 -61
  38. package/vendor/Server/DbUse/StorageManager.js +107 -107
  39. package/vendor/Server/DbUse/adapters/BaseAdapter.js +94 -94
  40. package/vendor/Server/DbUse/adapters/FileAdapter.js +138 -138
  41. package/vendor/Server/DbUse/adapters/JsonAdapter.js +138 -138
  42. package/vendor/Server/DbUse/adapters/JsonlAdapter.js +114 -114
  43. package/vendor/Server/DbUse/adapters/SqliteAdapter.js +157 -157
  44. package/vendor/Server/DbUse/index.js +160 -160
  45. package/vendor/Server/DbUse/stores/SessionStore.js +279 -279
  46. package/vendor/Server/DbUse/stores/TaskExecutionStore.js +133 -133
  47. package/vendor/Server/DbUse/stores/TaskRegistryStore.js +262 -262
  48. package/vendor/Server/DbUse/stores/TaskStepStore.js +279 -279
  49. package/vendor/Server/FlexRunner/FlexRunner.js +1759 -1759
  50. package/vendor/Server/FlexRunner/index.js +12 -12
  51. package/vendor/Server/Knowledge/KnowledgeImporter.js +523 -523
  52. package/vendor/Server/Knowledge/KnowledgeManager.js +341 -341
  53. package/vendor/Server/Knowledge/index.js +33 -33
  54. package/vendor/Server/LoopEngine/LoopEngine.js +1133 -1133
  55. package/vendor/Server/LoopEngine/index.js +11 -11
  56. package/vendor/Server/Orchestrator/Orchestrator.js +0 -3
  57. package/vendor/Server/Orchestrator/StepNode.js +312 -312
  58. package/vendor/Server/Orchestrator/index.js +13 -13
  59. package/vendor/Server/Routes/controllers/BrainController.js +241 -241
  60. package/vendor/Server/Routes/controllers/FlexRunnerController.js +1125 -1125
  61. package/vendor/Server/Routes/controllers/HealthController.js +44 -44
  62. package/vendor/Server/Routes/controllers/KnowledgeImportController.js +355 -355
  63. package/vendor/Server/Routes/controllers/LoopEngineController.js +788 -788
  64. package/vendor/Server/Routes/controllers/StatsController.js +57 -57
  65. package/vendor/Server/Routes/controllers/StreamController.js +67 -67
  66. package/vendor/Server/Routes/library/logger.js +179 -179
  67. package/vendor/Server/Routes/library/zipArchive.js +172 -172
  68. package/vendor/Server/Routes/router/Router.js +204 -204
  69. package/vendor/Server/Routes/routes/brain.js +47 -47
  70. package/vendor/Server/Routes/routes/flexrunner.js +72 -72
  71. package/vendor/Server/Routes/routes/health.js +28 -28
  72. package/vendor/Server/Routes/routes/index.js +57 -57
  73. package/vendor/Server/Routes/routes/knowledge.js +55 -55
  74. package/vendor/Server/Routes/routes/loopengine.js +58 -58
  75. package/vendor/Server/Routes/routes/orchestrator.js +61 -61
  76. package/vendor/Server/Routes/routes/registry.js +97 -97
  77. package/vendor/Server/Routes/routes/stats.js +23 -23
  78. package/vendor/Server/Routes/routes/stream.js +30 -30
  79. package/vendor/Server/Routes/server.js +203 -203
  80. package/vendor/Server/Routes/sse/SseHub.js +308 -308
  81. package/vendor/Server/Skills/acceptance-check/SKILL.md +191 -191
  82. package/vendor/Server/Skills/acceptance-check/references/PHASE1_ARTIFACT_COLLECTION.md +52 -52
  83. package/vendor/Server/Skills/acceptance-check/references/PHASE2_CRITERIA_EVALUATION.md +77 -77
  84. package/vendor/Server/Skills/acceptance-check/references/PHASE2_EVIDENCE_VERIFICATION.md +70 -70
  85. package/vendor/Server/Skills/arkts-code-check/SKILL.md +320 -320
  86. package/vendor/Server/Skills/arkts-code-check/references/CODE_CHECK_GUIDE.md +210 -210
  87. package/vendor/Server/Skills/arkts-code-check/references/FILE_TYPE_GUIDE.md +28 -28
  88. package/vendor/Server/Skills/arkts-code-check/references/PHASE1_INFO_COLLECTION.md +233 -233
  89. package/vendor/Server/Skills/arkts-code-check/references/REPORT_TEMPLATE.md +219 -219
  90. package/vendor/Server/Skills/arkts-library-compile-validate/SKILL.md +328 -328
  91. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/build.ps1 +93 -93
  92. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/code-linter.cjs +432 -432
  93. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/migrate.cjs +851 -851
  94. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/ohpm-switch.cjs +788 -788
  95. package/vendor/Server/Skills/arkts-library-demo-code/SKILL.md +291 -291
  96. package/vendor/Server/Skills/arkts-library-demo-code/references/API_SIGNATURE_CHECKS.md +68 -68
  97. package/vendor/Server/Skills/arkts-library-demo-code/references/BUILD_VALIDATION.md +184 -184
  98. package/vendor/Server/Skills/arkts-library-demo-code/references/CODE_STANDARDS.md +337 -337
  99. package/vendor/Server/Skills/arkts-library-demo-code/references/EXAMPLES.md +400 -400
  100. package/vendor/Server/Skills/arkts-library-demo-code/references/SYSTEM_API_LOOKUP.md +98 -98
  101. package/vendor/Server/Skills/arkts-library-demo-code/references/TEMPLATE.md +544 -544
  102. package/vendor/Server/Skills/arkts-library-demo-code/scripts/build.ps1 +93 -93
  103. package/vendor/Server/Skills/arkts-library-demo-code/scripts/code-linter.cjs +432 -432
  104. package/vendor/Server/Skills/arkts-library-demo-code/scripts/migrate.cjs +851 -851
  105. package/vendor/Server/Skills/arkts-library-demo-code/scripts/ohpm-switch.cjs +788 -788
  106. package/vendor/Server/Skills/arkts-library-demo-coverage/SKILL.md +174 -174
  107. package/vendor/Server/Skills/arkts-library-demo-scenario/SKILL.md +321 -321
  108. package/vendor/Server/Skills/arkts-library-demo-scenario/references/EXAMPLES.md +100 -100
  109. package/vendor/Server/Skills/arkts-library-demo-scenario/references/TEMPLATE.md +185 -185
  110. package/vendor/Server/Skills/arkts-library-documentation-quality-check/SKILL.md +233 -233
  111. package/vendor/Server/Skills/arkts-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +102 -102
  112. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/CHECK_DIMENSIONS.md +89 -89
  113. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/COMPLIANCE_CHECKLIST.md +62 -62
  114. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/KB_QUERY_GUIDE.md +107 -107
  115. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/MCP_TOOL_DISCOVERY.md +124 -124
  116. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/REPORT_TEMPLATE.md +90 -90
  117. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/SCORING_FORMULA.md +57 -57
  118. package/vendor/Server/Skills/arkts-library-documentation-quality-check/scripts/validate-skill.cjs +259 -259
  119. package/vendor/Server/Skills/arkts-library-interface-spec/SKILL.md +97 -97
  120. package/vendor/Server/Skills/arkts-library-memory-leak-check/SKILL.md +391 -391
  121. package/vendor/Server/Skills/arkts-library-source-clone/SKILL.md +113 -113
  122. package/vendor/Server/Skills/arkts-library-stability-check/SKILL.md +312 -312
  123. package/vendor/Server/Skills/arkts-library-stability-check/assets/REPORT_TEMPLATE.md +154 -154
  124. package/vendor/Server/Skills/arkts-library-stability-check/references/CHECKLIST.md +165 -165
  125. package/vendor/Server/Skills/arkts-library-stability-check/references/CODE_EXAMPLES.md +308 -308
  126. package/vendor/Server/Skills/arkts-library-stability-check/references/SCORING_RULES.md +90 -90
  127. package/vendor/Server/Skills/arkts-library-stability-check/scripts/validate-skill.cjs +282 -282
  128. package/vendor/Server/Skills/arkts-library-test-coverage-check/SKILL.md +360 -360
  129. package/vendor/Server/Skills/arkts-library-test-coverage-check/assets/REPORT_TEMPLATE.md +145 -145
  130. package/vendor/Server/Skills/arkts-library-test-coverage-check/references/CHECKLIST.md +252 -252
  131. package/vendor/Server/Skills/arkts-library-test-coverage-check/references/MCP_TOOL_USAGE.md +114 -114
  132. package/vendor/Server/Skills/arkts-library-test-coverage-check/scripts/validate-skill.cjs +262 -262
  133. package/vendor/Server/Skills/arkts-library-xts-code/SKILL.md +455 -455
  134. package/vendor/Server/Skills/arkts-library-xts-code/assets/report-template.md +60 -60
  135. package/vendor/Server/Skills/arkts-library-xts-code/references/ACCESS_MODIFIER_PRECHECK.md +76 -76
  136. package/vendor/Server/Skills/arkts-library-xts-code/references/BUILD_VERIFICATION.md +200 -200
  137. package/vendor/Server/Skills/arkts-library-xts-code/references/CODE_STANDARDS.md +518 -518
  138. package/vendor/Server/Skills/arkts-library-xts-code/references/SUBAGENT_PROMPT_TEMPLATE.md +276 -276
  139. package/vendor/Server/Skills/arkts-library-xts-code/references/SYSTEM_API_LOOKUP.md +92 -92
  140. package/vendor/Server/Skills/arkts-library-xts-code/references/XTS_TEMPLATE.md +767 -767
  141. package/vendor/Server/Skills/arkts-library-xts-code/scripts/build.ps1 +93 -93
  142. package/vendor/Server/Skills/arkts-library-xts-code/scripts/code-linter.cjs +432 -432
  143. package/vendor/Server/Skills/arkts-library-xts-code/scripts/migrate.cjs +851 -851
  144. package/vendor/Server/Skills/arkts-library-xts-code/scripts/ohpm-switch.cjs +788 -788
  145. package/vendor/Server/Skills/arkts-library-xts-code/scripts/precheck-access-modifiers.cjs +221 -221
  146. package/vendor/Server/Skills/arkts-library-xts-code-fix/SKILL.md +228 -228
  147. package/vendor/Server/Skills/arkts-library-xts-coverage/SKILL.md +97 -97
  148. package/vendor/Server/Skills/arkts-library-xts-doc/SKILL.md +194 -194
  149. package/vendor/Server/Skills/arkts-library-xts-doc/references/EXAMPLES.md +575 -575
  150. package/vendor/Server/Skills/arkts-library-xts-doc/references/TEMPLATE.md +574 -574
  151. package/vendor/Server/Skills/arkts-library-xts-doc/references/TESTABILITY_GUIDE.md +182 -182
  152. package/vendor/Server/Skills/arkts-library-xts-execution/SKILL.md +490 -490
  153. package/vendor/Server/Skills/arkts-library-xts-execution/references/error-fixing-examples.md +217 -217
  154. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/build.ps1 +93 -93
  155. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/code-linter.cjs +432 -432
  156. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/migrate.cjs +851 -851
  157. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/ohpm-switch.cjs +788 -788
  158. package/vendor/Server/Skills/flutter-code-check/SKILL.md +299 -299
  159. package/vendor/Server/Skills/flutter-code-check/assets/OUTPUT_TEMPLATE.md +311 -311
  160. package/vendor/Server/Skills/flutter-code-check/references/CHECKLIST.md +190 -190
  161. package/vendor/Server/Skills/flutter-code-check/references/PLATFORMS.md +133 -133
  162. package/vendor/Server/Skills/flutter-code-check/scripts/validate-skill.cjs +259 -259
  163. package/vendor/Server/Skills/flutter-interface/README.md +75 -75
  164. package/vendor/Server/Skills/flutter-interface/SKILL.md +291 -291
  165. package/vendor/Server/Skills/flutter-interface/references/EXAMPLES.md +336 -336
  166. package/vendor/Server/Skills/flutter-interface/references/GIT_CLONE_GUIDE.md +190 -190
  167. package/vendor/Server/Skills/flutter-interface/references/SCRIPT_REFERENCE.md +258 -258
  168. package/vendor/Server/Skills/flutter-interface/references/TEMPLATE.md +254 -254
  169. package/vendor/Server/Skills/flutter-library-consistency-check/SKILL.md +517 -517
  170. package/vendor/Server/Skills/flutter-library-consistency-check/references/CHECKLIST.md +381 -381
  171. package/vendor/Server/Skills/flutter-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +341 -341
  172. package/vendor/Server/Skills/flutter-library-consistency-check/references/PLATFORM_LIMITATION_GUIDE.md +71 -71
  173. package/vendor/Server/Skills/flutter-library-documentation-quality-check/SKILL.md +518 -518
  174. package/vendor/Server/Skills/flutter-library-documentation-quality-check/references/CHECKLIST.md +406 -406
  175. package/vendor/Server/Skills/flutter-library-memory-leak-check/SKILL.md +652 -652
  176. package/vendor/Server/Skills/flutter-library-memory-leak-check/references/CHECKLIST.md +396 -396
  177. package/vendor/Server/Skills/flutter-library-stability-check/SKILL.md +744 -744
  178. package/vendor/Server/Skills/flutter-library-stability-check/references/CHECKLIST.md +720 -720
  179. package/vendor/Server/Skills/flutter-library-test-coverage-check/SKILL.md +414 -414
  180. package/vendor/Server/Skills/flutter-library-test-coverage-check/assets/REPORT_TEMPLATE.md +150 -150
  181. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/CHECKLIST.md +304 -304
  182. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCORING_RULES.md +265 -265
  183. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCRIPT_USAGE.md +286 -286
  184. package/vendor/Server/Skills/knowledge-import/SKILL.md +383 -383
  185. package/vendor/Server/Skills/knowledge-import/references/MCP_TOOL_USAGE.md +165 -165
  186. package/vendor/Server/Skills/knowledge-import/references/SKILL_LOCATOR_GUIDE.md +91 -91
  187. package/vendor/Server/Skills/knowledge-import/references/SKILL_OPTIMIZATION_GUIDE.md +127 -127
  188. package/vendor/Server/Skills/ohos-lib-pr-push/SKILL.md +453 -301
  189. package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_CHECKLIST.md +151 -0
  190. package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_ISSUE_TEMPLATE.md +257 -105
  191. package/vendor/Server/Skills/ohos-lib-pr-push/references/GITCODE_API.md +191 -127
  192. package/vendor/Server/Skills/ohos-lib-pr-push/scripts/gitcode-api.cjs +317 -208
  193. package/vendor/Server/Skills/rn-code-check/SKILL.md +320 -320
  194. package/vendor/Server/Skills/rn-code-check/references/API-GUIDE.md +234 -234
  195. package/vendor/Server/Skills/rn-code-check/references/CHECKLIST.md +188 -188
  196. package/vendor/Server/Skills/rn-code-check/references/REPORT-TEMPLATE.md +246 -246
  197. package/vendor/Server/Skills/rn-lib-add-example/SKILL.md +198 -198
  198. package/vendor/Server/Skills/rn-lib-add-example/references/APP_RENAME_GUIDE.md +40 -40
  199. package/vendor/Server/Skills/rn-lib-add-example/references/SHELL_ADAPTATION_CHECKLIST.md +78 -78
  200. package/vendor/Server/Skills/rn-lib-add-example/references/TEMPLATE_REPO_GUIDE.md +70 -70
  201. package/vendor/Server/Skills/rn-lib-add-example/references/VERIFICATION_GUIDE.md +47 -47
  202. package/vendor/Server/Skills/rn-lib-add-example/scripts/create-example.cjs +252 -252
  203. package/vendor/Server/Skills/rn-lib-update-doc/SKILL.md +176 -176
  204. package/vendor/Server/Skills/rn-lib-update-doc/config.json +5 -5
  205. package/vendor/Server/Skills/rn-lib-update-doc/references/changelog-template.md +35 -35
  206. package/vendor/Server/Skills/rn-lib-update-doc/references/format-diff.md +137 -137
  207. package/vendor/Server/Skills/rn-lib-update-doc/references/link-registry.json +33 -33
  208. package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2-overview.md +40 -40
  209. package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2.md +429 -429
  210. package/vendor/Server/Skills/rn-lib-update-doc/scripts/detect-readme-format.cjs +105 -105
  211. package/vendor/Server/Skills/rn-lib-update-doc/scripts/find-usage-doc.cjs +90 -90
  212. package/vendor/Server/Skills/rn-lib-update-doc/scripts/link-verify.cjs +213 -213
  213. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-changelog.cjs +73 -73
  214. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-package-meta.cjs +258 -258
  215. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-readme-links.cjs +341 -341
  216. package/vendor/Server/Skills/rn-lib-update-doc/scripts/resolve-usage-docs.cjs +67 -67
  217. package/vendor/Server/Skills/rn-library-consistency-check/SKILL.md +299 -299
  218. package/vendor/Server/Skills/rn-library-consistency-check/assets/REPORT_TEMPLATE.md +293 -293
  219. package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_COMPONENT_CHECK_GUIDE.md +857 -857
  220. package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_TURBOMODULE_CHECK_GUIDE.md +856 -856
  221. package/vendor/Server/Skills/rn-library-consistency-check/references/CHECKLIST.md +157 -157
  222. package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_COMPONENT_CHECK_GUIDE.md +801 -801
  223. package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_TURBOMODULE_CHECK_GUIDE.md +683 -683
  224. package/vendor/Server/Skills/rn-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +233 -233
  225. package/vendor/Server/Skills/rn-library-consistency-check/references/NATIVE_COMPONENT_IDENTIFICATION.md +1373 -1373
  226. package/vendor/Server/Skills/rn-library-consistency-check/references/SCORING_STANDARD.md +220 -220
  227. package/vendor/Server/Skills/rn-library-consistency-check/scripts/validate-skill.py +245 -245
  228. package/vendor/Server/Skills/rn-library-documentation-quality-check/SKILL.md +263 -263
  229. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL.md +414 -414
  230. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL_en.md +413 -413
  231. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +311 -311
  232. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CHECK_CHECKLIST.md +355 -355
  233. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CROSS_VALIDATION_GUIDE.md +115 -115
  234. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/DOC_COLLECTION_GUIDE.md +139 -139
  235. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/EXAMPLES.md +586 -586
  236. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/GOTCHAS.md +57 -57
  237. package/vendor/Server/Skills/rn-library-documentation-quality-check/scripts/validate-skill.py +259 -259
  238. package/vendor/Server/Skills/rn-library-interface-analyzer/SKILL.md +301 -301
  239. package/vendor/Server/Skills/rn-library-interface-analyzer/assets/REPORT_TEMPLATE.md +148 -148
  240. package/vendor/Server/Skills/rn-library-interface-analyzer/references/DOC_ANNOTATION_GUIDE.md +118 -118
  241. package/vendor/Server/Skills/rn-library-interface-analyzer/references/SCRIPT_USAGE_GUIDE.md +168 -168
  242. package/vendor/Server/Skills/rn-library-interface-analyzer/references/URL_PARSING_RULES.md +176 -176
  243. package/vendor/Server/Skills/rn-library-issue-generalizer/SKILL.md +274 -274
  244. package/vendor/Server/Skills/rn-library-issue-generalizer/assets/case-template.md +45 -45
  245. package/vendor/Server/Skills/rn-library-issue-generalizer/assets/rule-template.md +25 -25
  246. package/vendor/Server/Skills/rn-library-issue-generalizer/references/PR_FETCH_GUIDE.md +61 -61
  247. package/vendor/Server/Skills/rn-library-issue-generalizer/references/RULE_TEMPLATE_GUIDE.md +165 -165
  248. package/vendor/Server/Skills/rn-library-issue-generalizer/scripts/fetch-pr-info.py +239 -239
  249. package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md +263 -263
  250. package/vendor/Server/Skills/rn-library-known-issue-check/assets/REPORT_TEMPLATE.md +96 -96
  251. package/vendor/Server/Skills/rn-library-known-issue-check/references/COMPLIANCE_CHECKLIST.md +57 -57
  252. package/vendor/Server/Skills/rn-library-known-issue-check/references/INSPECTION_GUIDE.md +99 -99
  253. package/vendor/Server/Skills/rn-library-known-issue-check/references/PRESCREEN_GUIDE.md +64 -64
  254. package/vendor/Server/Skills/rn-library-known-issue-check/references/SOURCE_PREP_GUIDE.md +74 -74
  255. package/vendor/Server/Skills/rn-library-known-issue-check/scripts/validate-known-issue-report.py +164 -164
  256. package/vendor/Server/Skills/rn-library-memory-leak-check/SKILL.md +356 -339
  257. package/vendor/Server/Skills/rn-library-memory-leak-check/assets/REPORT_TEMPLATE.md +85 -83
  258. package/vendor/Server/Skills/rn-library-memory-leak-check/references/CHECKLIST.md +905 -859
  259. package/vendor/Server/Skills/rn-library-memory-leak-check/references/HARMONY_CODE_PATTERNS.md +124 -122
  260. package/vendor/Server/Skills/rn-library-memory-leak-check/scripts/scan_harmony_code.py +287 -279
  261. package/vendor/Server/Skills/rn-library-stability-check/SKILL.md +273 -273
  262. package/vendor/Server/Skills/rn-library-stability-check/assets/REPORT_TEMPLATE.md +129 -129
  263. package/vendor/Server/Skills/rn-library-stability-check/references/CHECKLIST.md +581 -581
  264. package/vendor/Server/Skills/rn-library-stability-check/references/SCORING_RULES.md +138 -138
  265. package/vendor/Server/Skills/rn-library-stability-check/scripts/scan-harmony-code.py +168 -168
  266. package/vendor/Server/Skills/rn-library-test-coverage-check/SKILL.md +526 -506
  267. package/vendor/Server/Skills/rn-library-test-coverage-check/references/CHECKLIST.md +321 -280
  268. package/vendor/Server/Skills/rn-library-test-coverage-check/references/DEMO_LOCATION.md +221 -221
  269. package/vendor/Server/Skills/rn-library-test-coverage-check/references/REPORT_TEMPLATE.md +220 -209
  270. package/vendor/Server/Skills/rn-library-test-coverage-check/references/SCRIPT_USAGE.md +325 -325
  271. package/vendor/Server/Skills/rn-ohos-xts-generator/SKILL.md +279 -279
  272. package/vendor/Server/Skills/rn-ohos-xts-generator/assets/TEST_FILE_TEMPLATES.md +404 -404
  273. package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_TROUBLESHOOTING.md +185 -185
  274. package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_WORKFLOW.md +265 -265
  275. package/vendor/Server/Skills/rn-ohos-xts-generator/references/COMMON_CONFIG.md +189 -189
  276. package/vendor/Server/Skills/rn-ohos-xts-generator/references/CONFIG_GUIDE.md +203 -203
  277. package/vendor/Server/Skills/rn-ohos-xts-generator/references/COVERAGE_ANALYZER.md +147 -147
  278. package/vendor/Server/Skills/rn-ohos-xts-generator/references/DESIGN_DOC_GUIDE.md +148 -148
  279. package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_FLOW.md +165 -165
  280. package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_STRATEGY.md +195 -195
  281. package/vendor/Server/Skills/rn-ohos-xts-generator/references/HARMONY_SCANNER.md +249 -249
  282. package/vendor/Server/Skills/rn-ohos-xts-generator/references/JEST_FRAMEWORK.md +235 -235
  283. package/vendor/Server/Skills/rn-ohos-xts-generator/references/PLATFORM_COMPAT.md +161 -161
  284. package/vendor/Server/Skills/rn-ohos-xts-generator/references/RN_TEST_PATTERNS.md +413 -413
  285. package/vendor/Server/Skills/rn-ohos-xts-generator/references/SOURCE_PARSER.md +235 -235
  286. package/vendor/Server/Skills/rn-ohos-xts-generator/references/TEST_CONVENTIONS.md +245 -245
  287. package/vendor/Server/Skills/rn-ohos-xts-generator/references/TROUBLESHOOTING.md +282 -282
  288. package/vendor/Server/Skills/rn-ohos-xts-generator/references/USAGE_GUIDE.md +251 -251
  289. package/vendor/Server/Skills/rnoh-cptf-api-test/SKILL.md +469 -469
  290. package/vendor/Server/Skills/rnoh-cptf-api-test/assets/CPTF_TEST_TEMPLATE.md +310 -310
  291. package/vendor/Server/Skills/rnoh-cptf-api-test/assets/DEMO_PAGE_TEMPLATE.md +303 -303
  292. package/vendor/Server/Skills/rnoh-cptf-api-test/references/CPTF_TEST_GENERATION_GUIDE.md +421 -421
  293. package/vendor/Server/Skills/rnoh-cptf-api-test/references/DEMO_GENERATION_GUIDE.md +358 -358
  294. package/vendor/Server/Skills/rnoh-cptf-api-test/references/QUALITY_CHECKLIST.md +114 -114
  295. package/vendor/Server/Skills/rnoh-cptf-api-test/references/SPEC_PARSING_GUIDE.md +274 -274
  296. package/vendor/Server/Skills/rnoh-cptf-api-test/scripts/validate-rnoh-cptf-api-test.sh +185 -185
  297. package/vendor/Server/Skills/rnoh-cptf-demo-test/SKILL.md +191 -191
  298. package/vendor/Server/Skills/rnoh-cptf-demo-test/assets/TEST_TEMPLATE.md +216 -216
  299. package/vendor/Server/Skills/rnoh-cptf-demo-test/references/CPTF_SETUP.md +107 -107
  300. package/vendor/Server/Skills/rnoh-cptf-demo-test/references/DEMO_ANALYSIS.md +120 -120
  301. package/vendor/Server/Skills/rnoh-cptf-demo-test/scripts/validate-rnoh-cptf-test.sh +108 -108
  302. package/vendor/Server/Skills/rnoh-cptf-test-run/SKILL.md +237 -237
  303. package/vendor/Server/Skills/rnoh-cptf-test-run/references/DEBUG_PLAYBOOK.md +261 -261
  304. package/vendor/Server/Skills/rnoh-cptf-test-run/scripts/validate-run-env.sh +112 -112
  305. package/vendor/Server/Skills/rnoh-lib-code-adapt/SKILL.md +497 -497
  306. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/adapt-checklist.md +270 -270
  307. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/api-migration-checklist.md +164 -164
  308. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/common-compile-errors.md +556 -556
  309. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/deveco-cli-tools.md +459 -459
  310. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/edge-cases.md +65 -65
  311. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/har-tgz-build.md +512 -512
  312. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/version-compat-matrix.md +132 -132
  313. package/vendor/Server/Skills/rnoh-lib-code-adapt/scripts/auto-integrate.sh +424 -424
  314. package/vendor/Server/Skills/rnoh-lib-demo-coverage/SKILL.md +137 -137
  315. package/vendor/Server/Skills/rnoh-lib-demo-create/SKILL.md +306 -306
  316. package/vendor/Server/Skills/rnoh-lib-demo-create/assets/DEMO_PAGE_TEMPLATE.md +485 -485
  317. package/vendor/Server/Skills/rnoh-lib-demo-create/assets/INDEX_TEMPLATE.md +172 -172
  318. package/vendor/Server/Skills/rnoh-lib-demo-create/references/DEMO_CODE_RULES.md +422 -422
  319. package/vendor/Server/Skills/rnoh-lib-demo-create/references/QUALITY_CHECKLIST.md +95 -95
  320. package/vendor/Server/Skills/rnoh-lib-demo-create/references/SOURCE_EXPLORATION.md +169 -169
  321. package/vendor/Server/Skills/rnoh-lib-demo-doc/SKILL.md +554 -554
  322. package/vendor/Server/Skills/rnoh-lib-demo-doc/assets/DEMO_DOC_TEMPLATE.md +106 -106
  323. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/COVERAGE_INCREMENTAL.md +216 -216
  324. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/DEMO_DESIGN_RULES.md +413 -413
  325. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/OUTPUT_FORMAT.md +269 -269
  326. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/QUALITY_CHECKLIST.md +98 -98
  327. package/vendor/Server/Skills/rnoh-lib-func-test/SKILL.md +337 -337
  328. package/vendor/Server/Skills/rnoh-lib-rnt-search/SKILL.md +722 -722
  329. package/vendor/Server/Skills/rnoh-lib-rnt-search/assets/PORT_REPORT_TEMPLATE.md +219 -219
  330. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/DEMO_PORTING_GUIDE.md +345 -345
  331. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/PORT_VERIFICATION.md +269 -269
  332. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/RNT_PROJECT_STRUCTURE.md +173 -173
  333. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/analyze-demo-deps.cjs +267 -267
  334. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/detect-rnoh-version.cjs +174 -174
  335. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/find-rnt-demo.sh +111 -111
  336. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/port-demo.sh +186 -186
  337. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/read-lib-meta.cjs +150 -150
  338. package/vendor/Server/Skills/rnoh-lib-test-align/SKILL.md +296 -296
  339. package/vendor/Server/Skills/rnoh-lib-test-align/references/jest-troubleshooting.md +371 -371
  340. package/vendor/Server/Skills/rnoh-lib-test-align/references/port-test-demo-guide.md +212 -212
  341. package/vendor/Server/Skills/rnoh-lib-test-align/references/runtime-troubleshooting.md +345 -345
  342. package/vendor/Server/Skills/rnoh-lib-test-align/references/unit-test-template.md +223 -223
  343. package/vendor/Server/Skills/rnoh-lib-test-align/scripts/port-test-demo.sh +1053 -1053
  344. package/vendor/Server/Skills/rnoh-lib-version-diff/SKILL.md +295 -255
  345. package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_ADAPTATION.md +82 -77
  346. package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_API_LOOKUP.md +224 -224
  347. package/vendor/Server/Skills/rnoh-lib-version-diff/references/script-reference.md +175 -174
  348. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/detect-upstream-version.js +967 -967
  349. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/generate-diff.js +1798 -1798
  350. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/package.json +5 -5
  351. package/vendor/Server/Skills/rnoh-lib-version-diff/templates/report-template.md +180 -137
  352. package/vendor/Server/Skills/rnoh-lib-xts-coverage/SKILL.md +145 -145
  353. package/vendor/Server/Skills/skill-generator/SKILL.md +365 -365
  354. package/vendor/Server/Skills/skill-generator/assets/SKILL_TEMPLATE.md +183 -183
  355. package/vendor/Server/Skills/skill-generator/references/COMPLIANCE_CHECKLIST.md +82 -82
  356. package/vendor/Server/Skills/skill-generator/references/KB_QUERY_GUIDE.md +110 -110
  357. package/vendor/Server/Skills/skill-generator/references/MCP_TOOL_DISCOVERY.md +122 -122
  358. package/vendor/Server/Skills/skill-generator/references/SKILL_SPEC.md +121 -121
  359. package/vendor/Server/Skills/skill-generator/scripts/validate-skill.cjs +259 -259
  360. package/vendor/Server/Skills/task-analysis/SKILL.md +234 -234
  361. package/vendor/Server/Skills/task-analysis/assets/OUTPUT_EXAMPLES.md +160 -160
  362. package/vendor/Server/Skills/task-analysis/references/ACCEPTANCE_CRITERIA_GUIDE.md +190 -190
  363. package/vendor/Server/Skills/task-analysis/references/ANALYSIS_SCHEMA.md +224 -224
  364. package/vendor/Server/Skills/task-analysis/references/INTEGRATION_CONTEXT.md +162 -162
  365. package/vendor/Server/Skills/task-analysis/references/LESSONS_LEARNED.md +55 -55
  366. package/vendor/Server/Skills/task-analysis/references/REPLAN_CONTEXT_GUIDE.md +126 -126
  367. package/vendor/Server/Skills/task-analysis/scripts/validate-analysis-output.sh +256 -256
  368. package/vendor/Server/Skills/task-decomposition/SKILL.md +528 -528
  369. package/vendor/Server/Skills/task-decomposition/assets/OUTPUT_EXAMPLES.md +451 -451
  370. package/vendor/Server/Skills/task-decomposition/references/ACCEPTANCE_CRITERIA_GUIDE.md +179 -179
  371. package/vendor/Server/Skills/task-decomposition/references/DEPENDENCY_GRAPH_GUIDE.md +152 -152
  372. package/vendor/Server/Skills/task-decomposition/references/INTEGRATION_CONTEXT.md +175 -175
  373. package/vendor/Server/Skills/task-decomposition/references/REPLAN_CONTEXT_GUIDE.md +195 -195
  374. package/vendor/Server/Skills/task-decomposition/references/TASK_DECOMPOSITION_TEMPLATES.md +226 -226
  375. package/vendor/Server/Skills/task-decomposition/scripts/list-available-skills.cjs +263 -263
  376. package/vendor/Server/Skills/task-decomposition/scripts/skill-blacklist.json +29 -29
  377. package/vendor/Server/Skills/task-decomposition/scripts/validate-decomposition-output.cjs +376 -376
  378. package/vendor/Server/Skills/task-decomposition/scripts/validate-param-consistency.cjs +259 -259
  379. package/vendor/Server/Skills/task-decomposition/scripts/validate-specified-skills.cjs +216 -216
  380. package/vendor/Server/Skills/task-decomposition/scripts/validate-step-graph.cjs +424 -424
  381. package/vendor/Server/Skills/tpc-cpp-check/SKILL.md +427 -427
  382. package/vendor/Server/Skills/tpc-cpp-check/references/CHECKLIST.md +214 -214
  383. package/vendor/Server/Skills/tpc-cpp-check/references/HPKBUILD_GUIDE.md +235 -235
  384. package/vendor/Server/Skills/tpc-cpp-check/references/REPORT_TEMPLATE.md +250 -250
  385. package/vendor/Server/TestCheck/TestCheck.js +775 -775
  386. package/vendor/Server/TestCheck/index.js +11 -11
  387. package/vendor/Server/library/McpToolGuide.js +280 -280
  388. package/vendor/Server/library/StatsService.js +126 -126
  389. package/vendor/Server/library/cstTime.js +16 -16
  390. package/vendor/VERSION +3 -3
  391. package/workflows/pr-check.mjs +105 -105
  392. package/workflows/pr-push.mjs +192 -192
  393. package/vendor/Server/Agent/SkillSelector/types.js +0 -63
@@ -1,312 +1,312 @@
1
- /**
2
- * StepNode —— 编排器中的步骤节点模型
3
- *
4
- * 封装单个 FlexRunner 步骤的元信息与运行时状态,
5
- * 供 Orchestrator 进行拓扑分析、依赖调度、进度追踪。
6
- *
7
- * 高内聚:所有与单个步骤相关的状态和查询方法集中在此类。
8
- * 低耦合:不直接依赖 FlexRunner 实例,只持有配置和运行时结果。
9
- */
10
-
11
- import { nowCST } from '../library/cstTime.js';
12
-
13
- // ─── 步骤状态常量 ────────────────────────────────────────────────────────────
14
-
15
- /** 编排器层面步骤状态(与 FlexRunner.StepStatus 对齐,额外增加编排层语义) */
16
- export const NodeStatus = Object.freeze({
17
- PENDING: 'pending', // 等待执行(未满足依赖条件)
18
- READY: 'ready', // 依赖已满足,可执行
19
- RUNNING: 'running', // 正在执行
20
- COMPLETED: 'completed', // 执行成功
21
- FAILED: 'failed', // 执行失败(已用完重试)
22
- SKIPPED: 'skipped', // 被跳过(如前置失败导致无法执行)
23
- BLOCKED: 'blocked' // 被阻塞(循环检测或死锁)
24
- });
25
-
26
- /**
27
- * @typedef {object} StepConfig
28
- * @property {number|string} stepId - 步骤 ID(唯一标识)
29
- * @property {string} taskDescription - 任务描述
30
- * @property {number|string|Array<number|string>} [dependId=0] - 依赖步骤 ID,支持单值或数组(fan-in 聚合)
31
- * @property {number|string} [nextStepId=0]- 成功后下一步骤 ID(0 = 无后续,结束)
32
- * @property {number|string} [failStepId=0]- 失败后指向步骤 ID(0 = 失败即终止)
33
- * @property {number} [maxRetries=3]- 最大重试次数
34
- * @property {string} [skillDirectory] - SKILL 目录路径
35
- * @property {string} [specifiedSkill] - 指定 SKILL(name 或目录名);非空时跳过自动匹配
36
- * @property {string} [taskDir] - 工作目录
37
- * @property {string} [inputReport] - 输入报告路径
38
- * @property {string} [taskDescription] - 任务描述
39
- */
40
-
41
- /**
42
- * 归一化 dependId 为字符串前置 ID 数组。
43
- * - 单值(number/string)→ 非 0 时包装为 [id],0/null/-1 → []
44
- * - 数组 → 过滤掉 0/空/-1,逐项转字符串
45
- * 其中 -1 是"修复步骤哨兵":表示该步骤仅由 failStepId 触发,不是真实依赖 ID,
46
- * 因此不进入 _dependIds(避免 fan-in 聚合误判),同时真实依赖为 0 时仍保留 -1 原值(见构造/updateConfig)。
47
- * @param {number|string|Array<number|string>|null|undefined} value
48
- * @returns {string[]}
49
- */
50
- function normalizeDependIds(value) {
51
- if (Array.isArray(value)) {
52
- return value
53
- .map(v => String(v))
54
- .filter(v => v !== '0' && v !== '' && v !== '-1');
55
- }
56
- if (value == null) return [];
57
- const s = String(value);
58
- return s === '0' || s === '' || s === '-1' ? [] : [s];
59
- }
60
-
61
- /** 原始 dependId 中是否含 -1 哨兵(单值或数组任一项) */
62
- function hasSentinel(value) {
63
- if (Array.isArray(value)) {
64
- return value.some(v => String(v) === '-1');
65
- }
66
- return String(value ?? '') === '-1';
67
- }
68
-
69
- /**
70
- * @typedef {object} ExecutionRecord
71
- * @property {number} attempt - 第几次执行(从 1 开始)
72
- * @property {string} startTime - 开始时间
73
- * @property {string} [endTime] - 结束时间
74
- * @property {boolean} success - 是否成功
75
- * @property {string} resultPath - 结果文件路径
76
- * @property {string} [sessionId] - 会话 ID
77
- * @property {string} [error] - 错误信息
78
- */
79
-
80
- class StepNode {
81
- /**
82
- * @param {StepConfig} config
83
- */
84
- constructor(config) {
85
- if (!config || config.stepId == null) {
86
- throw new Error('StepNode: stepId 为必填项');
87
- }
88
-
89
- // ── 元信息(可修改,仅 PENDING 状态时允许) ──
90
- this.stepId = String(config.stepId);
91
- this.taskDescription = config.taskDescription || '';
92
- // dependId 支持 number | number[]:内部统一归一化为字符串前置 ID 数组(_dependIds)。
93
- // 对外暴露 dependId 便于兼容——单依赖时为其第一个元素,多依赖时为数组。
94
- // 修复步骤哨兵 -1 不算真实依赖:_dependIds 为空,但 dependId 保留 -1 原值作为图数据自解释标记。
95
- this._dependIds = normalizeDependIds(config.dependId);
96
- this.dependId = hasSentinel(config.dependId)
97
- ? '-1'
98
- : (this._dependIds.length === 1 ? this._dependIds[0] : this._dependIds);
99
- this.nextStepId = config.nextStepId != null ? String(config.nextStepId) : '0';
100
- this.failStepId = config.failStepId != null ? String(config.failStepId) : '0';
101
- this.maxRetries = typeof config.maxRetries === 'number' ? config.maxRetries : 3;
102
- this.skillDirectory = config.skillDirectory || '';
103
- this.specifiedSkill = String(config.specifiedSkill || '').trim();
104
- this.taskDir = config.taskDir || '';
105
- this.inputReport = config.inputReport || '';
106
-
107
- // ── 运行时状态 ──
108
- /** @type {string} */
109
- this.status = NodeStatus.PENDING;
110
- /** @type {number} 当前重试次数(0 = 尚未执行) */
111
- this.retryCount = 0;
112
- /** @type {string|null} 当前开始时间 */
113
- this.startTime = null;
114
- /** @type {string|null} 当前结束时间 */
115
- this.endTime = null;
116
- /** @type {string} 最新结果报告路径 */
117
- this.resultPath = '';
118
- /** @type {string} 最新会话 ID */
119
- this.sessionId = '';
120
- /** @type {ExecutionRecord[]} 历史执行记录 */
121
- this.history = [];
122
- /** @type {object|null} 结构化指标(SKILL 约定的键值对,如 mergeLevel / score;无则 null) */
123
- this.metrics = null;
124
- /** @type {string|null} 失败原因 */
125
- this.error = null;
126
- /** @type {FlexRunner|null} 关联的 FlexRunner 实例(运行时注入) */
127
- this._runner = null;
128
- }
129
-
130
- // ─── 状态查询 ──────────────────────────────────────────────────────
131
-
132
- /**
133
- * 归一化后的前置依赖步骤 ID 数组。
134
- * 调度层统一使用此数组判断 fan-in 聚合条件(所有依赖完成才激活)。
135
- * @returns {string[]}
136
- */
137
- get dependencies() {
138
- return this._dependIds;
139
- }
140
-
141
- /** 是否有前置依赖(非入口步骤) */
142
- get hasDependencies() {
143
- return this._dependIds.length > 0;
144
- }
145
-
146
- /** 是否尚未执行 */
147
- get isPending() {
148
- return this.status === NodeStatus.PENDING || this.status === NodeStatus.READY;
149
- }
150
-
151
- /** 是否正在执行 */
152
- get isRunning() {
153
- return this.status === NodeStatus.RUNNING;
154
- }
155
-
156
- /** 是否已结束(成功 / 失败 / 跳过 / 阻塞) */
157
- get isFinished() {
158
- return (
159
- this.status === NodeStatus.COMPLETED ||
160
- this.status === NodeStatus.FAILED ||
161
- this.status === NodeStatus.SKIPPED ||
162
- this.status === NodeStatus.BLOCKED
163
- );
164
- }
165
-
166
- /** 是否成功 */
167
- get isCompleted() {
168
- return this.status === NodeStatus.COMPLETED;
169
- }
170
-
171
- /** 是否还能重试 */
172
- get canRetry() {
173
- return this.retryCount < this.maxRetries && !this.isFinished;
174
- }
175
-
176
- // ─── 状态变更 ──────────────────────────────────────────────────────
177
-
178
- /** 标记为就绪(依赖已满足)。
179
- * 允许从 PENDING(初始)/ COMPLETED(成功)/ FAILED(失败)重新进入 READY,
180
- * 以支持 failStepId 修复步骤被重复执行(不清空历史结果,由 markRunning/markFinished 自然更新)。 */
181
- markReady() {
182
- if (this.status === NodeStatus.PENDING ||
183
- this.status === NodeStatus.COMPLETED ||
184
- this.status === NodeStatus.FAILED) {
185
- this.status = NodeStatus.READY;
186
- }
187
- }
188
-
189
- /** 标记为执行中 */
190
- markRunning() {
191
- this.status = NodeStatus.RUNNING;
192
- this.retryCount++;
193
- this.startTime = nowCST();
194
- this.endTime = null;
195
- this.error = null;
196
- }
197
-
198
- /**
199
- * 标记执行完成
200
- * @param {{success: boolean, resultPath: string, sessionId?: string, error?: string, metrics?: object|null}} result
201
- */
202
- markFinished(result) {
203
- this.endTime = nowCST();
204
- this.resultPath = result.resultPath || '';
205
- this.sessionId = result.sessionId || '';
206
- this.error = result.error || null;
207
- // 结构化指标(SKILL 约定的键值对,如 mergeLevel / score;无则 null)
208
- this.metrics = result.metrics || null;
209
-
210
- this.history.push({
211
- attempt: this.retryCount,
212
- startTime: this.startTime,
213
- endTime: this.endTime,
214
- success: result.success,
215
- resultPath: this.resultPath,
216
- sessionId: this.sessionId,
217
- error: this.error,
218
- metrics: this.metrics
219
- });
220
-
221
- this.status = result.success ? NodeStatus.COMPLETED : NodeStatus.FAILED;
222
- }
223
-
224
- /** 标记为跳过 */
225
- markSkipped(reason) {
226
- this.status = NodeStatus.SKIPPED;
227
- this.error = reason;
228
- }
229
-
230
- /** 标记为阻塞 */
231
- markBlocked(reason) {
232
- this.status = NodeStatus.BLOCKED;
233
- this.error = reason;
234
- }
235
-
236
- /**
237
- * 释放关联的 FlexRunner 实例及其重型引用(CLIController / SkillSelector / LLMClient / Storage)。
238
- *
239
- * 编排结束后调用,使 FlexRunner 及其内嵌依赖可被 GC 回收。
240
- * 仅置空 `_runner`,保留 `sessionId` / `resultPath` / `history` 等序列化元信息,
241
- * 前端仍可通过 `toJSON()` 与本地归档查看历史。
242
- */
243
- releaseRunner() {
244
- this._runner = null;
245
- }
246
-
247
- // ─── 配置修改 ──────────────────────────────────────────────────────
248
-
249
- /**
250
- * 修改步骤配置(仅 PENDING 状态允许)。
251
- *
252
- * @param {Partial<StepConfig>} patch - 要修改的字段
253
- * @returns {boolean} 是否修改成功
254
- */
255
- updateConfig(patch) {
256
- if (!this.isPending) {
257
- return false;
258
- }
259
- if (!patch || typeof patch !== 'object') return false;
260
-
261
- if (patch.taskDescription !== undefined) this.taskDescription = patch.taskDescription;
262
- if (patch.dependId !== undefined) {
263
- this._dependIds = normalizeDependIds(patch.dependId);
264
- this.dependId = hasSentinel(patch.dependId)
265
- ? '-1'
266
- : (this._dependIds.length === 1 ? this._dependIds[0] : this._dependIds);
267
- }
268
- if (patch.nextStepId !== undefined) this.nextStepId = String(patch.nextStepId);
269
- if (patch.failStepId !== undefined) this.failStepId = String(patch.failStepId);
270
- if (patch.maxRetries !== undefined) this.maxRetries = Number(patch.maxRetries);
271
- if (patch.skillDirectory !== undefined) this.skillDirectory = patch.skillDirectory;
272
- if (patch.specifiedSkill !== undefined) this.specifiedSkill = String(patch.specifiedSkill || '').trim();
273
- if (patch.taskDir !== undefined) this.taskDir = patch.taskDir;
274
- if (patch.inputReport !== undefined) this.inputReport = patch.inputReport;
275
-
276
- return true;
277
- }
278
-
279
- // ─── 序列化 ────────────────────────────────────────────────────────
280
-
281
- /**
282
- * 序列化为 JSON(供前端展示和持久化)。
283
- * @returns {object}
284
- */
285
- toJSON() {
286
- return {
287
- stepId: this.stepId,
288
- taskDescription: this.taskDescription,
289
- dependId: this.dependId,
290
- nextStepId: this.nextStepId,
291
- failStepId: this.failStepId,
292
- maxRetries: this.maxRetries,
293
- skillDirectory: this.skillDirectory,
294
- specifiedSkill: this.specifiedSkill,
295
- taskDir: this.taskDir,
296
- inputReport: this.inputReport,
297
- status: this.status,
298
- retryCount: this.retryCount,
299
- startTime: this.startTime,
300
- endTime: this.endTime,
301
- resultPath: this.resultPath,
302
- sessionId: this.sessionId,
303
- error: this.error,
304
- metrics: this.metrics,
305
- canRetry: this.canRetry,
306
- history: this.history
307
- };
308
- }
309
- }
310
-
311
- export { StepNode };
312
- export default StepNode;
1
+ /**
2
+ * StepNode —— 编排器中的步骤节点模型
3
+ *
4
+ * 封装单个 FlexRunner 步骤的元信息与运行时状态,
5
+ * 供 Orchestrator 进行拓扑分析、依赖调度、进度追踪。
6
+ *
7
+ * 高内聚:所有与单个步骤相关的状态和查询方法集中在此类。
8
+ * 低耦合:不直接依赖 FlexRunner 实例,只持有配置和运行时结果。
9
+ */
10
+
11
+ import { nowCST } from '../library/cstTime.js';
12
+
13
+ // ─── 步骤状态常量 ────────────────────────────────────────────────────────────
14
+
15
+ /** 编排器层面步骤状态(与 FlexRunner.StepStatus 对齐,额外增加编排层语义) */
16
+ export const NodeStatus = Object.freeze({
17
+ PENDING: 'pending', // 等待执行(未满足依赖条件)
18
+ READY: 'ready', // 依赖已满足,可执行
19
+ RUNNING: 'running', // 正在执行
20
+ COMPLETED: 'completed', // 执行成功
21
+ FAILED: 'failed', // 执行失败(已用完重试)
22
+ SKIPPED: 'skipped', // 被跳过(如前置失败导致无法执行)
23
+ BLOCKED: 'blocked' // 被阻塞(循环检测或死锁)
24
+ });
25
+
26
+ /**
27
+ * @typedef {object} StepConfig
28
+ * @property {number|string} stepId - 步骤 ID(唯一标识)
29
+ * @property {string} taskDescription - 任务描述
30
+ * @property {number|string|Array<number|string>} [dependId=0] - 依赖步骤 ID,支持单值或数组(fan-in 聚合)
31
+ * @property {number|string} [nextStepId=0]- 成功后下一步骤 ID(0 = 无后续,结束)
32
+ * @property {number|string} [failStepId=0]- 失败后指向步骤 ID(0 = 失败即终止)
33
+ * @property {number} [maxRetries=3]- 最大重试次数
34
+ * @property {string} [skillDirectory] - SKILL 目录路径
35
+ * @property {string} [specifiedSkill] - 指定 SKILL(name 或目录名);非空时跳过自动匹配
36
+ * @property {string} [taskDir] - 工作目录
37
+ * @property {string} [inputReport] - 输入报告路径
38
+ * @property {string} [taskDescription] - 任务描述
39
+ */
40
+
41
+ /**
42
+ * 归一化 dependId 为字符串前置 ID 数组。
43
+ * - 单值(number/string)→ 非 0 时包装为 [id],0/null/-1 → []
44
+ * - 数组 → 过滤掉 0/空/-1,逐项转字符串
45
+ * 其中 -1 是"修复步骤哨兵":表示该步骤仅由 failStepId 触发,不是真实依赖 ID,
46
+ * 因此不进入 _dependIds(避免 fan-in 聚合误判),同时真实依赖为 0 时仍保留 -1 原值(见构造/updateConfig)。
47
+ * @param {number|string|Array<number|string>|null|undefined} value
48
+ * @returns {string[]}
49
+ */
50
+ function normalizeDependIds(value) {
51
+ if (Array.isArray(value)) {
52
+ return value
53
+ .map(v => String(v))
54
+ .filter(v => v !== '0' && v !== '' && v !== '-1');
55
+ }
56
+ if (value == null) return [];
57
+ const s = String(value);
58
+ return s === '0' || s === '' || s === '-1' ? [] : [s];
59
+ }
60
+
61
+ /** 原始 dependId 中是否含 -1 哨兵(单值或数组任一项) */
62
+ function hasSentinel(value) {
63
+ if (Array.isArray(value)) {
64
+ return value.some(v => String(v) === '-1');
65
+ }
66
+ return String(value ?? '') === '-1';
67
+ }
68
+
69
+ /**
70
+ * @typedef {object} ExecutionRecord
71
+ * @property {number} attempt - 第几次执行(从 1 开始)
72
+ * @property {string} startTime - 开始时间
73
+ * @property {string} [endTime] - 结束时间
74
+ * @property {boolean} success - 是否成功
75
+ * @property {string} resultPath - 结果文件路径
76
+ * @property {string} [sessionId] - 会话 ID
77
+ * @property {string} [error] - 错误信息
78
+ */
79
+
80
+ class StepNode {
81
+ /**
82
+ * @param {StepConfig} config
83
+ */
84
+ constructor(config) {
85
+ if (!config || config.stepId == null) {
86
+ throw new Error('StepNode: stepId 为必填项');
87
+ }
88
+
89
+ // ── 元信息(可修改,仅 PENDING 状态时允许) ──
90
+ this.stepId = String(config.stepId);
91
+ this.taskDescription = config.taskDescription || '';
92
+ // dependId 支持 number | number[]:内部统一归一化为字符串前置 ID 数组(_dependIds)。
93
+ // 对外暴露 dependId 便于兼容——单依赖时为其第一个元素,多依赖时为数组。
94
+ // 修复步骤哨兵 -1 不算真实依赖:_dependIds 为空,但 dependId 保留 -1 原值作为图数据自解释标记。
95
+ this._dependIds = normalizeDependIds(config.dependId);
96
+ this.dependId = hasSentinel(config.dependId)
97
+ ? '-1'
98
+ : (this._dependIds.length === 1 ? this._dependIds[0] : this._dependIds);
99
+ this.nextStepId = config.nextStepId != null ? String(config.nextStepId) : '0';
100
+ this.failStepId = config.failStepId != null ? String(config.failStepId) : '0';
101
+ this.maxRetries = typeof config.maxRetries === 'number' ? config.maxRetries : 3;
102
+ this.skillDirectory = config.skillDirectory || '';
103
+ this.specifiedSkill = String(config.specifiedSkill || '').trim();
104
+ this.taskDir = config.taskDir || '';
105
+ this.inputReport = config.inputReport || '';
106
+
107
+ // ── 运行时状态 ──
108
+ /** @type {string} */
109
+ this.status = NodeStatus.PENDING;
110
+ /** @type {number} 当前重试次数(0 = 尚未执行) */
111
+ this.retryCount = 0;
112
+ /** @type {string|null} 当前开始时间 */
113
+ this.startTime = null;
114
+ /** @type {string|null} 当前结束时间 */
115
+ this.endTime = null;
116
+ /** @type {string} 最新结果报告路径 */
117
+ this.resultPath = '';
118
+ /** @type {string} 最新会话 ID */
119
+ this.sessionId = '';
120
+ /** @type {ExecutionRecord[]} 历史执行记录 */
121
+ this.history = [];
122
+ /** @type {object|null} 结构化指标(SKILL 约定的键值对,如 mergeLevel / score;无则 null) */
123
+ this.metrics = null;
124
+ /** @type {string|null} 失败原因 */
125
+ this.error = null;
126
+ /** @type {FlexRunner|null} 关联的 FlexRunner 实例(运行时注入) */
127
+ this._runner = null;
128
+ }
129
+
130
+ // ─── 状态查询 ──────────────────────────────────────────────────────
131
+
132
+ /**
133
+ * 归一化后的前置依赖步骤 ID 数组。
134
+ * 调度层统一使用此数组判断 fan-in 聚合条件(所有依赖完成才激活)。
135
+ * @returns {string[]}
136
+ */
137
+ get dependencies() {
138
+ return this._dependIds;
139
+ }
140
+
141
+ /** 是否有前置依赖(非入口步骤) */
142
+ get hasDependencies() {
143
+ return this._dependIds.length > 0;
144
+ }
145
+
146
+ /** 是否尚未执行 */
147
+ get isPending() {
148
+ return this.status === NodeStatus.PENDING || this.status === NodeStatus.READY;
149
+ }
150
+
151
+ /** 是否正在执行 */
152
+ get isRunning() {
153
+ return this.status === NodeStatus.RUNNING;
154
+ }
155
+
156
+ /** 是否已结束(成功 / 失败 / 跳过 / 阻塞) */
157
+ get isFinished() {
158
+ return (
159
+ this.status === NodeStatus.COMPLETED ||
160
+ this.status === NodeStatus.FAILED ||
161
+ this.status === NodeStatus.SKIPPED ||
162
+ this.status === NodeStatus.BLOCKED
163
+ );
164
+ }
165
+
166
+ /** 是否成功 */
167
+ get isCompleted() {
168
+ return this.status === NodeStatus.COMPLETED;
169
+ }
170
+
171
+ /** 是否还能重试 */
172
+ get canRetry() {
173
+ return this.retryCount < this.maxRetries && !this.isFinished;
174
+ }
175
+
176
+ // ─── 状态变更 ──────────────────────────────────────────────────────
177
+
178
+ /** 标记为就绪(依赖已满足)。
179
+ * 允许从 PENDING(初始)/ COMPLETED(成功)/ FAILED(失败)重新进入 READY,
180
+ * 以支持 failStepId 修复步骤被重复执行(不清空历史结果,由 markRunning/markFinished 自然更新)。 */
181
+ markReady() {
182
+ if (this.status === NodeStatus.PENDING ||
183
+ this.status === NodeStatus.COMPLETED ||
184
+ this.status === NodeStatus.FAILED) {
185
+ this.status = NodeStatus.READY;
186
+ }
187
+ }
188
+
189
+ /** 标记为执行中 */
190
+ markRunning() {
191
+ this.status = NodeStatus.RUNNING;
192
+ this.retryCount++;
193
+ this.startTime = nowCST();
194
+ this.endTime = null;
195
+ this.error = null;
196
+ }
197
+
198
+ /**
199
+ * 标记执行完成
200
+ * @param {{success: boolean, resultPath: string, sessionId?: string, error?: string, metrics?: object|null}} result
201
+ */
202
+ markFinished(result) {
203
+ this.endTime = nowCST();
204
+ this.resultPath = result.resultPath || '';
205
+ this.sessionId = result.sessionId || '';
206
+ this.error = result.error || null;
207
+ // 结构化指标(SKILL 约定的键值对,如 mergeLevel / score;无则 null)
208
+ this.metrics = result.metrics || null;
209
+
210
+ this.history.push({
211
+ attempt: this.retryCount,
212
+ startTime: this.startTime,
213
+ endTime: this.endTime,
214
+ success: result.success,
215
+ resultPath: this.resultPath,
216
+ sessionId: this.sessionId,
217
+ error: this.error,
218
+ metrics: this.metrics
219
+ });
220
+
221
+ this.status = result.success ? NodeStatus.COMPLETED : NodeStatus.FAILED;
222
+ }
223
+
224
+ /** 标记为跳过 */
225
+ markSkipped(reason) {
226
+ this.status = NodeStatus.SKIPPED;
227
+ this.error = reason;
228
+ }
229
+
230
+ /** 标记为阻塞 */
231
+ markBlocked(reason) {
232
+ this.status = NodeStatus.BLOCKED;
233
+ this.error = reason;
234
+ }
235
+
236
+ /**
237
+ * 释放关联的 FlexRunner 实例及其重型引用(CLIController / SkillSelector / LLMClient / Storage)。
238
+ *
239
+ * 编排结束后调用,使 FlexRunner 及其内嵌依赖可被 GC 回收。
240
+ * 仅置空 `_runner`,保留 `sessionId` / `resultPath` / `history` 等序列化元信息,
241
+ * 前端仍可通过 `toJSON()` 与本地归档查看历史。
242
+ */
243
+ releaseRunner() {
244
+ this._runner = null;
245
+ }
246
+
247
+ // ─── 配置修改 ──────────────────────────────────────────────────────
248
+
249
+ /**
250
+ * 修改步骤配置(仅 PENDING 状态允许)。
251
+ *
252
+ * @param {Partial<StepConfig>} patch - 要修改的字段
253
+ * @returns {boolean} 是否修改成功
254
+ */
255
+ updateConfig(patch) {
256
+ if (!this.isPending) {
257
+ return false;
258
+ }
259
+ if (!patch || typeof patch !== 'object') return false;
260
+
261
+ if (patch.taskDescription !== undefined) this.taskDescription = patch.taskDescription;
262
+ if (patch.dependId !== undefined) {
263
+ this._dependIds = normalizeDependIds(patch.dependId);
264
+ this.dependId = hasSentinel(patch.dependId)
265
+ ? '-1'
266
+ : (this._dependIds.length === 1 ? this._dependIds[0] : this._dependIds);
267
+ }
268
+ if (patch.nextStepId !== undefined) this.nextStepId = String(patch.nextStepId);
269
+ if (patch.failStepId !== undefined) this.failStepId = String(patch.failStepId);
270
+ if (patch.maxRetries !== undefined) this.maxRetries = Number(patch.maxRetries);
271
+ if (patch.skillDirectory !== undefined) this.skillDirectory = patch.skillDirectory;
272
+ if (patch.specifiedSkill !== undefined) this.specifiedSkill = String(patch.specifiedSkill || '').trim();
273
+ if (patch.taskDir !== undefined) this.taskDir = patch.taskDir;
274
+ if (patch.inputReport !== undefined) this.inputReport = patch.inputReport;
275
+
276
+ return true;
277
+ }
278
+
279
+ // ─── 序列化 ────────────────────────────────────────────────────────
280
+
281
+ /**
282
+ * 序列化为 JSON(供前端展示和持久化)。
283
+ * @returns {object}
284
+ */
285
+ toJSON() {
286
+ return {
287
+ stepId: this.stepId,
288
+ taskDescription: this.taskDescription,
289
+ dependId: this.dependId,
290
+ nextStepId: this.nextStepId,
291
+ failStepId: this.failStepId,
292
+ maxRetries: this.maxRetries,
293
+ skillDirectory: this.skillDirectory,
294
+ specifiedSkill: this.specifiedSkill,
295
+ taskDir: this.taskDir,
296
+ inputReport: this.inputReport,
297
+ status: this.status,
298
+ retryCount: this.retryCount,
299
+ startTime: this.startTime,
300
+ endTime: this.endTime,
301
+ resultPath: this.resultPath,
302
+ sessionId: this.sessionId,
303
+ error: this.error,
304
+ metrics: this.metrics,
305
+ canRetry: this.canRetry,
306
+ history: this.history
307
+ };
308
+ }
309
+ }
310
+
311
+ export { StepNode };
312
+ export default StepNode;
@@ -1,13 +1,13 @@
1
- /**
2
- * Orchestrator 模块统一导出
3
- *
4
- * 外部使用:
5
- * import { Orchestrator } from './Orchestrator/index.js';
6
- * const orch = new Orchestrator({ sseHub, storage });
7
- * await orch.loadTask(taskDef);
8
- * await orch.start();
9
- */
10
-
11
- export { Orchestrator, OrchestratorStatus } from './Orchestrator.js';
12
- export { StepNode, NodeStatus } from './StepNode.js';
13
- export { default } from './Orchestrator.js';
1
+ /**
2
+ * Orchestrator 模块统一导出
3
+ *
4
+ * 外部使用:
5
+ * import { Orchestrator } from './Orchestrator/index.js';
6
+ * const orch = new Orchestrator({ sseHub, storage });
7
+ * await orch.loadTask(taskDef);
8
+ * await orch.start();
9
+ */
10
+
11
+ export { Orchestrator, OrchestratorStatus } from './Orchestrator.js';
12
+ export { StepNode, NodeStatus } from './StepNode.js';
13
+ export { default } from './Orchestrator.js';