aiwf 0.3.22 → 0.4.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 (456) hide show
  1. package/.claude-plugin/marketplace.json +146 -0
  2. package/CHANGELOG.md +49 -1
  3. package/README.ko.md +118 -309
  4. package/README.md +68 -254
  5. package/docs/modernization/BROWNFIELD-GREENFIELD.ko.md +105 -0
  6. package/docs/modernization/CLAUDE-PLAN-REVIEW-2026-10-03.ko.md +77 -0
  7. package/docs/modernization/CLI-PRODUCTIVITY-REVIEWED-2026-10-03.ko.md +177 -0
  8. package/docs/modernization/CLI-PRODUCTIVITY.ko.md +193 -0
  9. package/docs/modernization/CORE-PACKAGE-PLAN.md +7 -0
  10. package/docs/modernization/DEEP-REVERSE-ENGINEERING.ko.md +88 -0
  11. package/docs/modernization/DELEGATION-OPTIONAL.ko.md +57 -0
  12. package/docs/modernization/DIRECTION.ko.md +56 -0
  13. package/docs/modernization/FULL-TEST-2026-10-03.md +49 -0
  14. package/docs/modernization/LEGACY-REMOVAL-PLAN.md +9 -0
  15. package/docs/modernization/PILOT-RESULT-2026-10-03.ko.md +85 -0
  16. package/docs/modernization/PILOT-UC-001.ko.md +79 -0
  17. package/docs/modernization/PLAN.md +28 -0
  18. package/docs/modernization/SKILLS.ko.md +105 -0
  19. package/docs/modernization/SPRINTABLE.ko.md +47 -0
  20. package/docs/modernization/SYNC-DOCS-VALIDATION-2026-10-04.ko.md +38 -0
  21. package/docs/modernization/VALIDATION.md +79 -0
  22. package/docs/modernization/evidence/example-review-packet.json +115 -0
  23. package/docs/modernization/evidence/example-spec-pin.json +48 -0
  24. package/docs/modernization/evidence/full-test-20261003/claude-lint.md +22 -0
  25. package/docs/modernization/evidence/full-test-20261003/claude-review-retry.md +56 -0
  26. package/docs/modernization/evidence/full-test-20261003/codex-review-packet.json +159 -0
  27. package/docs/modernization/evidence/full-test-20261003/src/expense.mjs +40 -0
  28. package/docs/modernization/evidence/full-test-20261003/summary.json +106 -0
  29. package/docs/modernization/evidence/full-test-20261003/tests/expense.test.mjs +61 -0
  30. package/docs/modernization/evidence/local-pilot-20261003/README.ko.md +40 -0
  31. package/docs/modernization/evidence/local-pilot-20261003/execution.json +1055 -0
  32. package/docs/modernization/evidence/local-pilot-20261003/maintenance/dependencies.json +24 -0
  33. package/docs/modernization/evidence/local-pilot-20261003/maintenance/dependencies.stderr.txt +0 -0
  34. package/docs/modernization/evidence/local-pilot-20261003/maintenance/dependencies.stdout.txt +5 -0
  35. package/docs/modernization/evidence/local-pilot-20261003/maintenance/docs.json +24 -0
  36. package/docs/modernization/evidence/local-pilot-20261003/maintenance/docs.stderr.txt +0 -0
  37. package/docs/modernization/evidence/local-pilot-20261003/maintenance/docs.stdout.txt +6 -0
  38. package/docs/modernization/evidence/local-pilot-20261003/maintenance/example.json +24 -0
  39. package/docs/modernization/evidence/local-pilot-20261003/maintenance/example.stderr.txt +0 -0
  40. package/docs/modernization/evidence/local-pilot-20261003/maintenance/example.stdout.txt +5 -0
  41. package/docs/modernization/evidence/local-pilot-20261003/maintenance/local-docs.json +24 -0
  42. package/docs/modernization/evidence/local-pilot-20261003/maintenance/local-docs.stderr.txt +0 -0
  43. package/docs/modernization/evidence/local-pilot-20261003/maintenance/local-docs.stdout.txt +6 -0
  44. package/docs/modernization/evidence/local-pilot-20261003/maintenance/node.json +23 -0
  45. package/docs/modernization/evidence/local-pilot-20261003/maintenance/node.stderr.txt +0 -0
  46. package/docs/modernization/evidence/local-pilot-20261003/maintenance/node.stdout.txt +535 -0
  47. package/docs/modernization/evidence/local-pilot-20261003/maintenance/provenance.json +24 -0
  48. package/docs/modernization/evidence/local-pilot-20261003/maintenance/provenance.stderr.txt +0 -0
  49. package/docs/modernization/evidence/local-pilot-20261003/maintenance/provenance.stdout.txt +5 -0
  50. package/docs/modernization/evidence/local-pilot-20261003/maintenance/readme-replay.json +24 -0
  51. package/docs/modernization/evidence/local-pilot-20261003/maintenance/readme-replay.stderr.txt +0 -0
  52. package/docs/modernization/evidence/local-pilot-20261003/maintenance/readme-replay.stdout.txt +273 -0
  53. package/docs/modernization/evidence/local-pilot-20261003/maintenance/upstream.json +24 -0
  54. package/docs/modernization/evidence/local-pilot-20261003/maintenance/upstream.stderr.txt +0 -0
  55. package/docs/modernization/evidence/local-pilot-20261003/maintenance/upstream.stdout.txt +7 -0
  56. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/archive-service.stderr.txt +0 -0
  57. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/archive-service.stdout.txt +148 -0
  58. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/archive-structure.stderr.txt +0 -0
  59. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/archive-structure.stdout.txt +9 -0
  60. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-check.stderr.txt +0 -0
  61. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-check.stdout.txt +67 -0
  62. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-evidence.json +34 -0
  63. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-packet.json +128 -0
  64. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-packet.stderr.txt +0 -0
  65. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-packet.stdout.txt +128 -0
  66. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-pin.json +54 -0
  67. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-pin.stderr.txt +0 -0
  68. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-pin.stdout.txt +60 -0
  69. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-readback.json +15 -0
  70. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-service.stderr.txt +0 -0
  71. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-service.stdout.txt +82 -0
  72. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-structure.stderr.txt +0 -0
  73. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/baseline-structure.stdout.txt +9 -0
  74. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-check.stderr.txt +0 -0
  75. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-check.stdout.txt +79 -0
  76. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-packet-refused.stderr.txt +0 -0
  77. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-packet-refused.stdout.txt +7 -0
  78. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-pin-refresh.stderr.txt +0 -0
  79. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-pin-refresh.stdout.txt +66 -0
  80. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-pin.json +60 -0
  81. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-structure.stderr.txt +0 -0
  82. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/changed-structure.stdout.txt +9 -0
  83. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-check.stderr.txt +0 -0
  84. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-check.stdout.txt +73 -0
  85. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-evidence.json +34 -0
  86. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-packet.json +134 -0
  87. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-packet.stderr.txt +0 -0
  88. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-packet.stdout.txt +134 -0
  89. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-readback.json +15 -0
  90. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-service.stderr.txt +0 -0
  91. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-service.stdout.txt +148 -0
  92. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-structure.stderr.txt +0 -0
  93. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/final-structure.stdout.txt +9 -0
  94. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/node-version.stderr.txt +0 -0
  95. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/node-version.stdout.txt +1 -0
  96. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/python-version.stderr.txt +0 -0
  97. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/python-version.stdout.txt +1 -0
  98. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-evidence.json +34 -0
  99. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-packet.json +134 -0
  100. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-packet.stderr.txt +0 -0
  101. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-packet.stdout.txt +134 -0
  102. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-readback.json +15 -0
  103. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-service.stderr.txt +0 -0
  104. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-service.stdout.txt +266 -0
  105. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-structure.stderr.txt +0 -0
  106. package/docs/modernization/evidence/local-pilot-20261003/project/artifacts/red-structure.stdout.txt +9 -0
  107. package/docs/modernization/evidence/local-pilot-20261003/project/docs/entity_model.md +33 -0
  108. package/docs/modernization/evidence/local-pilot-20261003/project/docs/glossary.md +9 -0
  109. package/docs/modernization/evidence/local-pilot-20261003/project/docs/plans/UC-001.md +20 -0
  110. package/docs/modernization/evidence/local-pilot-20261003/project/docs/requirements.md +10 -0
  111. package/docs/modernization/evidence/local-pilot-20261003/project/docs/test_cases/TC-001-submit-expense.md +37 -0
  112. package/docs/modernization/evidence/local-pilot-20261003/project/docs/test_cases/TC-002-description-limit.md +42 -0
  113. package/docs/modernization/evidence/local-pilot-20261003/project/docs/use_cases/UC-001-submit-expense.md +76 -0
  114. package/docs/modernization/evidence/local-pilot-20261003/project/docs/use_cases.puml +12 -0
  115. package/docs/modernization/evidence/local-pilot-20261003/project/docs/vision.md +21 -0
  116. package/docs/modernization/evidence/local-pilot-20261003/project/src/expense.mjs +48 -0
  117. package/docs/modernization/evidence/local-pilot-20261003/project/tests/expense.test.mjs +116 -0
  118. package/docs/modernization/evidence/local-pilot-20261003/scope.json +31 -0
  119. package/docs/modernization/reviews/2026-10-03-claude-cli/CONTRACTS.ko.md +122 -0
  120. package/docs/modernization/reviews/2026-10-03-claude-cli/DIRECTION.ko.md +84 -0
  121. package/examples/spec-workflow/README.md +54 -0
  122. package/examples/spec-workflow/docs/entity_model.md +33 -0
  123. package/examples/spec-workflow/docs/glossary.md +9 -0
  124. package/examples/spec-workflow/docs/requirements.md +10 -0
  125. package/examples/spec-workflow/docs/test_cases/TC-001-submit-expense.md +37 -0
  126. package/examples/spec-workflow/docs/use_cases/UC-001-submit-expense.md +63 -0
  127. package/examples/spec-workflow/docs/use_cases.puml +12 -0
  128. package/examples/spec-workflow/docs/vision.md +21 -0
  129. package/package.json +37 -104
  130. package/plugins/aiwf-angular-jpa/.claude-plugin/plugin.json +11 -0
  131. package/plugins/aiwf-angular-jpa/LICENSE +201 -0
  132. package/plugins/aiwf-angular-jpa/NOTICE +16 -0
  133. package/plugins/aiwf-angular-jpa/README.md +54 -0
  134. package/plugins/aiwf-angular-jpa/UPSTREAM.json +35 -0
  135. package/plugins/aiwf-angular-jpa/agents/uc-coverage.md +263 -0
  136. package/plugins/aiwf-angular-jpa/rules/mcp-servers.md +64 -0
  137. package/plugins/aiwf-angular-jpa/skills/coverage-check/SKILL.md +190 -0
  138. package/plugins/aiwf-angular-jpa/skills/flyway-migration/SKILL.md +119 -0
  139. package/plugins/aiwf-angular-jpa/skills/implement/SKILL.md +528 -0
  140. package/plugins/aiwf-angular-jpa/skills/implement/references/module-layout.md +95 -0
  141. package/plugins/aiwf-angular-jpa/skills/playwright-test/SKILL.md +360 -0
  142. package/plugins/aiwf-angular-jpa/skills/spring-boot-test/SKILL.md +504 -0
  143. package/plugins/aiwf-angular-jpa/skills/vitest-test/SKILL.md +309 -0
  144. package/plugins/aiwf-blazor-dotnet/.claude-plugin/plugin.json +11 -0
  145. package/plugins/aiwf-blazor-dotnet/LICENSE +201 -0
  146. package/plugins/aiwf-blazor-dotnet/NOTICE +16 -0
  147. package/plugins/aiwf-blazor-dotnet/README.md +53 -0
  148. package/plugins/aiwf-blazor-dotnet/UPSTREAM.json +31 -0
  149. package/plugins/aiwf-blazor-dotnet/rules/mcp-servers.md +25 -0
  150. package/plugins/aiwf-blazor-dotnet/skills/bunit-test/SKILL.md +110 -0
  151. package/plugins/aiwf-blazor-dotnet/skills/dotnet-test/SKILL.md +108 -0
  152. package/plugins/aiwf-blazor-dotnet/skills/ef-migration/SKILL.md +43 -0
  153. package/plugins/aiwf-blazor-dotnet/skills/implement/SKILL.md +149 -0
  154. package/plugins/aiwf-blazor-dotnet/skills/playwright-test/SKILL.md +130 -0
  155. package/plugins/aiwf-core/.claude-plugin/plugin.json +11 -0
  156. package/plugins/aiwf-core/LICENSE +201 -0
  157. package/plugins/aiwf-core/NOTICE +20 -0
  158. package/plugins/aiwf-core/README.md +38 -0
  159. package/plugins/aiwf-core/UPSTREAM.json +50 -0
  160. package/plugins/aiwf-core/skills/entity-model/SKILL.md +160 -0
  161. package/plugins/aiwf-core/skills/entity-model/references/REFERENCE.md +36 -0
  162. package/plugins/aiwf-core/skills/requirements/SKILL.md +157 -0
  163. package/plugins/aiwf-core/skills/requirements/references/REFERENCE.md +70 -0
  164. package/plugins/aiwf-core/skills/requirements/references/glossary.md +7 -0
  165. package/plugins/aiwf-core/skills/reverse-engineer/SKILL.md +509 -0
  166. package/plugins/aiwf-core/skills/reverse-engineer/references/stack-signals.md +210 -0
  167. package/plugins/aiwf-core/skills/spec-review/SKILL.md +197 -0
  168. package/plugins/aiwf-core/skills/spec-review/references/lint-codes.md +63 -0
  169. package/plugins/aiwf-core/skills/spec-review/references/review-checklist.md +189 -0
  170. package/plugins/aiwf-core/skills/spec-review/scripts/spec_lint.py +1216 -0
  171. package/plugins/aiwf-core/skills/test-case/SKILL.md +138 -0
  172. package/plugins/aiwf-core/skills/test-case/references/example-process.bpmn +118 -0
  173. package/plugins/aiwf-core/skills/test-case/references/example.md +38 -0
  174. package/plugins/aiwf-core/skills/test-case/references/test-case.md +35 -0
  175. package/plugins/aiwf-core/skills/test-case/scripts/bpmn_paths.py +542 -0
  176. package/plugins/aiwf-core/skills/use-case-diagram/SKILL.md +99 -0
  177. package/plugins/aiwf-core/skills/use-case-spec/SKILL.md +257 -0
  178. package/plugins/aiwf-core/skills/use-case-spec/references/clarify-checklist.md +70 -0
  179. package/plugins/aiwf-core/skills/use-case-spec/references/example.md +88 -0
  180. package/plugins/aiwf-core/skills/use-case-spec/references/format-spec.md +246 -0
  181. package/plugins/aiwf-core/skills/use-case-spec/references/use-case.md +50 -0
  182. package/plugins/aiwf-core/skills/use-case-spec/scripts/validate_use_case.py +941 -0
  183. package/plugins/aiwf-delegate-claude/.claude-plugin/plugin.json +9 -0
  184. package/{src/lib/resources/templates/npm-library/template → plugins/aiwf-delegate-claude}/LICENSE +2 -2
  185. package/plugins/aiwf-delegate-claude/NOTICE +4 -0
  186. package/plugins/aiwf-delegate-claude/README.md +10 -0
  187. package/plugins/aiwf-delegate-claude/plugin.json +13 -0
  188. package/plugins/aiwf-delegate-claude/skills/delegate-claude/LICENSE +21 -0
  189. package/plugins/aiwf-delegate-claude/skills/delegate-claude/NOTICE +4 -0
  190. package/plugins/aiwf-delegate-claude/skills/delegate-claude/SKILL.md +49 -0
  191. package/plugins/aiwf-delegate-claude/skills/delegate-claude/agents/openai.yaml +2 -0
  192. package/plugins/aiwf-delegate-codex/.claude-plugin/plugin.json +9 -0
  193. package/plugins/aiwf-delegate-codex/LICENSE +21 -0
  194. package/plugins/aiwf-delegate-codex/NOTICE +4 -0
  195. package/plugins/aiwf-delegate-codex/README.md +10 -0
  196. package/plugins/aiwf-delegate-codex/plugin.json +13 -0
  197. package/plugins/aiwf-delegate-codex/skills/delegate-codex/LICENSE +21 -0
  198. package/plugins/aiwf-delegate-codex/skills/delegate-codex/NOTICE +4 -0
  199. package/plugins/aiwf-delegate-codex/skills/delegate-codex/SKILL.md +47 -0
  200. package/plugins/aiwf-delegate-codex/skills/delegate-codex/agents/openai.yaml +2 -0
  201. package/plugins/aiwf-nestjs-nextjs/.claude-plugin/plugin.json +11 -0
  202. package/plugins/aiwf-nestjs-nextjs/LICENSE +201 -0
  203. package/plugins/aiwf-nestjs-nextjs/NOTICE +16 -0
  204. package/plugins/aiwf-nestjs-nextjs/README.md +53 -0
  205. package/plugins/aiwf-nestjs-nextjs/UPSTREAM.json +32 -0
  206. package/plugins/aiwf-nestjs-nextjs/rules/mcp-servers.md +59 -0
  207. package/plugins/aiwf-nestjs-nextjs/skills/drizzle-migration/SKILL.md +222 -0
  208. package/plugins/aiwf-nestjs-nextjs/skills/implement/SKILL.md +393 -0
  209. package/plugins/aiwf-nestjs-nextjs/skills/implement/references/project-layout.md +158 -0
  210. package/plugins/aiwf-nestjs-nextjs/skills/nest-test/SKILL.md +300 -0
  211. package/plugins/aiwf-nestjs-nextjs/skills/playwright-test/SKILL.md +245 -0
  212. package/plugins/aiwf-nestjs-nextjs/skills/react-test/SKILL.md +217 -0
  213. package/plugins/aiwf-spec/.claude-plugin/plugin.json +9 -0
  214. package/plugins/aiwf-spec/LICENSE +201 -0
  215. package/plugins/aiwf-spec/NOTICE +20 -0
  216. package/plugins/aiwf-spec/README.md +36 -0
  217. package/plugins/aiwf-spec/skills/sync-docs/SKILL.md +47 -0
  218. package/plugins/aiwf-spec/skills/workflow/SKILL.md +42 -0
  219. package/plugins/aiwf-vaadin-jooq/.claude-plugin/plugin.json +11 -0
  220. package/plugins/aiwf-vaadin-jooq/LICENSE +201 -0
  221. package/plugins/aiwf-vaadin-jooq/NOTICE +16 -0
  222. package/plugins/aiwf-vaadin-jooq/README.md +56 -0
  223. package/plugins/aiwf-vaadin-jooq/UPSTREAM.json +43 -0
  224. package/plugins/aiwf-vaadin-jooq/agents/uc-coverage.md +260 -0
  225. package/plugins/aiwf-vaadin-jooq/rules/mcp-servers.md +44 -0
  226. package/plugins/aiwf-vaadin-jooq/skills/browserless-test/SKILL.md +407 -0
  227. package/plugins/aiwf-vaadin-jooq/skills/browserless-test/references/UC001ManagePersonsTest.java +111 -0
  228. package/plugins/aiwf-vaadin-jooq/skills/coverage-check/SKILL.md +190 -0
  229. package/plugins/aiwf-vaadin-jooq/skills/flyway-migration/SKILL.md +70 -0
  230. package/plugins/aiwf-vaadin-jooq/skills/hilla-test/SKILL.md +350 -0
  231. package/plugins/aiwf-vaadin-jooq/skills/hilla-test/references/UC001ManagePersonsServiceTest.java +81 -0
  232. package/plugins/aiwf-vaadin-jooq/skills/hilla-test/references/UC001ManagePersonsViewTest.tsx +87 -0
  233. package/plugins/aiwf-vaadin-jooq/skills/implement/SKILL.md +196 -0
  234. package/plugins/aiwf-vaadin-jooq/skills/implement-hilla/SKILL.md +216 -0
  235. package/plugins/aiwf-vaadin-jooq/skills/karibu-test/SKILL.md +298 -0
  236. package/plugins/aiwf-vaadin-jooq/skills/karibu-test/references/UC001ManagePersonsTest.java +93 -0
  237. package/plugins/aiwf-vaadin-jooq/skills/playwright-test/SKILL.md +237 -0
  238. package/plugins/aiwf-vaadin-jooq/skills/playwright-test/references/ExampleViewIT.java +143 -0
  239. package/plugins/aiwf-vaadin-jooq/skills/playwright-test/references/TC001CustomerOnboardingIT.java +144 -0
  240. package/plugins/aiwf-vaadin-jooq/skills/playwright-test/references/dramafinder-api.md +190 -0
  241. package/scripts/check-dependencies.js +26 -96
  242. package/scripts/install-spec-skills.mjs +126 -0
  243. package/scripts/validate-spec-plugin.mjs +145 -0
  244. package/src/cli/spec-cli.js +292 -0
  245. package/src/lib/spec-workflow.js +982 -0
  246. package/docs/ADR_MANAGEMENT_GUIDE.ko.md +0 -602
  247. package/docs/ADR_MANAGEMENT_GUIDE.md +0 -602
  248. package/docs/AI-WORKFLOW.ko.md +0 -299
  249. package/docs/AI-WORKFLOW.md +0 -401
  250. package/docs/API_REFERENCE_FULL.ko.md +0 -1135
  251. package/docs/API_REFERENCE_FULL.md +0 -1135
  252. package/docs/ARCHITECTURE.ko.md +0 -314
  253. package/docs/ARCHITECTURE.md +0 -314
  254. package/docs/CLI_USAGE_GUIDE.ko.md +0 -634
  255. package/docs/CLI_USAGE_GUIDE.md +0 -640
  256. package/docs/CODE_CLEANUP_GUIDE.ko.md +0 -415
  257. package/docs/CODE_CLEANUP_GUIDE.md +0 -415
  258. package/docs/COMMANDS_GUIDE.ko.md +0 -1037
  259. package/docs/COMMANDS_GUIDE.md +0 -1037
  260. package/docs/CONTRIBUTING.ko.md +0 -408
  261. package/docs/CONTRIBUTING.md +0 -408
  262. package/docs/DEVELOPMENT_GUIDE.ko.md +0 -440
  263. package/docs/DEVELOPMENT_GUIDE.md +0 -727
  264. package/docs/EXAMPLES.ko.md +0 -695
  265. package/docs/EXAMPLES.md +0 -693
  266. package/docs/GETTING_STARTED.ko.md +0 -219
  267. package/docs/GETTING_STARTED.md +0 -476
  268. package/docs/MODULE_MANAGEMENT_GUIDE.ko.md +0 -289
  269. package/docs/MODULE_MANAGEMENT_GUIDE.md +0 -289
  270. package/docs/PERFORMANCE_ARCHITECTURE.md +0 -494
  271. package/docs/PERFORMANCE_GUIDELINES.ko.md +0 -388
  272. package/docs/PERFORMANCE_GUIDELINES.md +0 -553
  273. package/docs/PRD.ko.md +0 -148
  274. package/docs/PRD.md +0 -150
  275. package/docs/ROADMAP_v0.4.0.md +0 -286
  276. package/docs/STATE_MANAGEMENT_GUIDE.ko.md +0 -278
  277. package/docs/STATE_MANAGEMENT_GUIDE.md +0 -278
  278. package/docs/TROUBLESHOOTING.ko.md +0 -366
  279. package/docs/TROUBLESHOOTING.md +0 -722
  280. package/docs/VALIDATOR_API.ko.md +0 -324
  281. package/docs/VALIDATOR_API.md +0 -324
  282. package/docs/YOLO_SYSTEM_GUIDE.ko.md +0 -542
  283. package/docs/YOLO_SYSTEM_GUIDE.md +0 -542
  284. package/docs/designs/AI_PERSONA_SYSTEM_DESIGN.md +0 -516
  285. package/docs/designs/API_DOCUMENTATION.md +0 -932
  286. package/docs/designs/API_REFERENCE.md +0 -979
  287. package/docs/designs/Enhanced_Installation_Flow_Design.md +0 -498
  288. package/docs/designs/aiwf-metadata-system-prd.md +0 -127
  289. package/docs/designs/offline-template-cache.md +0 -323
  290. package/docs/designs/persona-aware-compression.md +0 -168
  291. package/docs/guides/ai-personas-guide-ko.md +0 -239
  292. package/docs/guides/ai-personas-guide.md +0 -239
  293. package/docs/guides/checkpoint-system-guide-ko.md +0 -356
  294. package/docs/guides/checkpoint-system-guide.md +0 -356
  295. package/docs/guides/context-compression-guide-ko.md +0 -313
  296. package/docs/guides/context-compression-guide.md +0 -313
  297. package/docs/guides/independent-sprint-guide-ko.md +0 -321
  298. package/docs/guides/independent-sprint-guide.md +0 -321
  299. package/rules/global/aiwf-code-style-guide.md +0 -30
  300. package/rules/global/aiwf-coding-principles.md +0 -33
  301. package/rules/global/aiwf-development-process.md +0 -41
  302. package/rules/global/aiwf-global-rules.md +0 -84
  303. package/rules/manual/aiwf-generate-plan-docs.md +0 -280
  304. package/scripts/run-integration-tests.js +0 -317
  305. package/scripts/update-file-lists.js +0 -267
  306. package/scripts/validate-commands.js +0 -254
  307. package/src/DEPENDENCY_MAP.md +0 -90
  308. package/src/cli/cache-cli.js +0 -459
  309. package/src/cli/checkpoint-cli.js +0 -417
  310. package/src/cli/index.js +0 -481
  311. package/src/cli/language-cli.js +0 -286
  312. package/src/cli/sprint-cli.js +0 -287
  313. package/src/commands/ai-tool.js +0 -383
  314. package/src/commands/compress.js +0 -60
  315. package/src/commands/create-project.js +0 -160
  316. package/src/commands/evaluate.js +0 -459
  317. package/src/commands/persona.js +0 -309
  318. package/src/commands/sprint-independent.js +0 -393
  319. package/src/commands/sprint-task.js +0 -262
  320. package/src/commands/state.js +0 -1164
  321. package/src/commands/token.js +0 -312
  322. package/src/commands/yolo-config.js +0 -502
  323. package/src/config/file-lists.js +0 -147
  324. package/src/config/yolo-config-template.yaml +0 -168
  325. package/src/lib/ai-persona-manager.js +0 -711
  326. package/src/lib/backup-manager.js +0 -271
  327. package/src/lib/cache-system.js +0 -332
  328. package/src/lib/context-engine.js +0 -568
  329. package/src/lib/file-downloader.js +0 -304
  330. package/src/lib/github-integration.js +0 -402
  331. package/src/lib/installer.js +0 -1066
  332. package/src/lib/memory-profiler.js +0 -471
  333. package/src/lib/metrics-collector.js +0 -885
  334. package/src/lib/offline-detector.js +0 -386
  335. package/src/lib/resource-loader-enhanced.js +0 -399
  336. package/src/lib/resource-loader.js +0 -250
  337. package/src/lib/resources/commands/ai-persona.js +0 -602
  338. package/src/lib/resources/commands/compress-context.js +0 -389
  339. package/src/lib/resources/commands/evaluate.js +0 -246
  340. package/src/lib/resources/commands/persona-context-apply.js +0 -562
  341. package/src/lib/resources/commands/token-tracking.js +0 -443
  342. package/src/lib/resources/config/commit-patterns.js +0 -103
  343. package/src/lib/resources/config/language.json +0 -6
  344. package/src/lib/resources/personas/PERSONA_INDEX.md +0 -57
  345. package/src/lib/resources/personas/analyst.json +0 -44
  346. package/src/lib/resources/personas/architect/best_practices.md +0 -136
  347. package/src/lib/resources/personas/architect/knowledge_base.md +0 -377
  348. package/src/lib/resources/personas/architect.json +0 -44
  349. package/src/lib/resources/personas/backend/best_practices.md +0 -766
  350. package/src/lib/resources/personas/backend/knowledge_base.md +0 -1070
  351. package/src/lib/resources/personas/data_analyst/best_practices.md +0 -594
  352. package/src/lib/resources/personas/data_analyst/knowledge_base.md +0 -1057
  353. package/src/lib/resources/personas/developer.json +0 -44
  354. package/src/lib/resources/personas/developer.md +0 -37
  355. package/src/lib/resources/personas/evaluation_criteria.json +0 -137
  356. package/src/lib/resources/personas/frontend/best_practices.md +0 -445
  357. package/src/lib/resources/personas/frontend/knowledge_base.md +0 -729
  358. package/src/lib/resources/personas/persona-index.json +0 -31
  359. package/src/lib/resources/personas/reviewer.json +0 -44
  360. package/src/lib/resources/personas/security/best_practices.md +0 -307
  361. package/src/lib/resources/personas/security/knowledge_base.md +0 -498
  362. package/src/lib/resources/personas/tester.json +0 -44
  363. package/src/lib/resources/templates/README.md +0 -78
  364. package/src/lib/resources/templates/api-server/config.json +0 -64
  365. package/src/lib/resources/templates/api-server/template/.aiwf/config.json +0 -56
  366. package/src/lib/resources/templates/api-server/template/.aiwf/feature-ledger.json +0 -42
  367. package/src/lib/resources/templates/api-server/template/.aiwf/personas/backend-engineer.json +0 -40
  368. package/src/lib/resources/templates/api-server/template/.aiwf/scripts/cli.js +0 -111
  369. package/src/lib/resources/templates/api-server/template/.env.example +0 -29
  370. package/src/lib/resources/templates/api-server/template/.eslintrc.json +0 -23
  371. package/src/lib/resources/templates/api-server/template/README.md +0 -171
  372. package/src/lib/resources/templates/api-server/template/jest.config.js +0 -26
  373. package/src/lib/resources/templates/api-server/template/nodemon.json +0 -9
  374. package/src/lib/resources/templates/api-server/template/package.json +0 -61
  375. package/src/lib/resources/templates/api-server/template/src/app.ts +0 -60
  376. package/src/lib/resources/templates/api-server/template/src/config/swagger.ts +0 -38
  377. package/src/lib/resources/templates/api-server/template/src/controllers/aiwfController.ts +0 -54
  378. package/src/lib/resources/templates/api-server/template/src/controllers/authController.ts +0 -128
  379. package/src/lib/resources/templates/api-server/template/src/controllers/statusController.ts +0 -28
  380. package/src/lib/resources/templates/api-server/template/src/index.ts +0 -28
  381. package/src/lib/resources/templates/api-server/template/src/middleware/aiwfMiddleware.ts +0 -50
  382. package/src/lib/resources/templates/api-server/template/src/middleware/authMiddleware.ts +0 -41
  383. package/src/lib/resources/templates/api-server/template/src/middleware/errorHandler.ts +0 -42
  384. package/src/lib/resources/templates/api-server/template/src/middleware/notFoundHandler.ts +0 -14
  385. package/src/lib/resources/templates/api-server/template/src/middleware/requestLogger.ts +0 -20
  386. package/src/lib/resources/templates/api-server/template/src/routes/aiwf.ts +0 -31
  387. package/src/lib/resources/templates/api-server/template/src/routes/index.ts +0 -13
  388. package/src/lib/resources/templates/api-server/template/src/routes/v1/index.ts +0 -67
  389. package/src/lib/resources/templates/api-server/template/src/utils/logger.ts +0 -37
  390. package/src/lib/resources/templates/api-server/template/tests/app.test.ts +0 -40
  391. package/src/lib/resources/templates/api-server/template/tsconfig.json +0 -43
  392. package/src/lib/resources/templates/npm-library/config.json +0 -61
  393. package/src/lib/resources/templates/npm-library/template/README.md +0 -201
  394. package/src/lib/resources/templates/npm-library/template/package.json +0 -78
  395. package/src/lib/resources/templates/web-app/config.json +0 -53
  396. package/src/lib/resources/templates/web-app/template/.aiwf/config.json +0 -54
  397. package/src/lib/resources/templates/web-app/template/.aiwf/feature-ledger.json +0 -37
  398. package/src/lib/resources/templates/web-app/template/.aiwf/personas/fullstack-developer.json +0 -40
  399. package/src/lib/resources/templates/web-app/template/.aiwf/scripts/cli.js +0 -110
  400. package/src/lib/resources/templates/web-app/template/.eslintrc.cjs +0 -20
  401. package/src/lib/resources/templates/web-app/template/README.md +0 -151
  402. package/src/lib/resources/templates/web-app/template/index.html +0 -14
  403. package/src/lib/resources/templates/web-app/template/package.json +0 -44
  404. package/src/lib/resources/templates/web-app/template/postcss.config.js +0 -6
  405. package/src/lib/resources/templates/web-app/template/public/vite.svg +0 -1
  406. package/src/lib/resources/templates/web-app/template/src/App.tsx +0 -21
  407. package/src/lib/resources/templates/web-app/template/src/components/Layout.tsx +0 -57
  408. package/src/lib/resources/templates/web-app/template/src/components/aiwf/ContextStatus.tsx +0 -107
  409. package/src/lib/resources/templates/web-app/template/src/components/aiwf/TokenUsage.tsx +0 -71
  410. package/src/lib/resources/templates/web-app/template/src/index.css +0 -60
  411. package/src/lib/resources/templates/web-app/template/src/main.tsx +0 -10
  412. package/src/lib/resources/templates/web-app/template/src/pages/AiwfDashboard.tsx +0 -57
  413. package/src/lib/resources/templates/web-app/template/src/pages/HomePage.tsx +0 -89
  414. package/src/lib/resources/templates/web-app/template/src/pages/NotFound.tsx +0 -25
  415. package/src/lib/resources/templates/web-app/template/src/stores/aiwfStore.ts +0 -126
  416. package/src/lib/resources/templates/web-app/template/src/types/global.d.ts +0 -9
  417. package/src/lib/resources/templates/web-app/template/src/vite-env.d.ts +0 -1
  418. package/src/lib/resources/templates/web-app/template/tailwind.config.js +0 -30
  419. package/src/lib/resources/templates/web-app/template/tsconfig.json +0 -37
  420. package/src/lib/resources/templates/web-app/template/tsconfig.node.json +0 -10
  421. package/src/lib/resources/templates/web-app/template/vite.config.ts +0 -23
  422. package/src/lib/resources/utils/background-monitor.js +0 -223
  423. package/src/lib/resources/utils/compression-metrics.js +0 -1031
  424. package/src/lib/resources/utils/compression-strategies.js +0 -557
  425. package/src/lib/resources/utils/content-normalizer.js +0 -455
  426. package/src/lib/resources/utils/context-compressor.js +0 -583
  427. package/src/lib/resources/utils/context-rule-parser.js +0 -180
  428. package/src/lib/resources/utils/context-token-monitor.js +0 -463
  429. package/src/lib/resources/utils/context-update-manager.js +0 -502
  430. package/src/lib/resources/utils/git-utils.js +0 -220
  431. package/src/lib/resources/utils/importance-classifier.js +0 -645
  432. package/src/lib/resources/utils/information-filter.js +0 -710
  433. package/src/lib/resources/utils/persona-aware-compressor.js +0 -598
  434. package/src/lib/resources/utils/prompt-injector.js +0 -242
  435. package/src/lib/resources/utils/simplified-evaluator.js +0 -119
  436. package/src/lib/resources/utils/text-summarizer.js +0 -492
  437. package/src/lib/resources/utils/token-counter.js +0 -177
  438. package/src/lib/resources/utils/token-monitor.js +0 -484
  439. package/src/lib/resources/utils/token-reporter.js +0 -452
  440. package/src/lib/resources/utils/token-storage.js +0 -433
  441. package/src/lib/resources/utils/token-tracker.js +0 -283
  442. package/src/lib/rollback-manager.js +0 -418
  443. package/src/lib/state/priority-calculator.js +0 -217
  444. package/src/lib/state/state-index.js +0 -155
  445. package/src/lib/state/task-scanner.js +0 -328
  446. package/src/lib/task-analyzer.js +0 -599
  447. package/src/lib/template-cache-system.js +0 -559
  448. package/src/lib/template-downloader.js +0 -467
  449. package/src/lib/template-version-manager.js +0 -491
  450. package/src/lib/token-optimizer.js +0 -517
  451. package/src/lib/validator.js +0 -376
  452. package/src/utils/checkpoint-manager.js +0 -435
  453. package/src/utils/engineering-guard.js +0 -399
  454. package/src/utils/language-utils.js +0 -331
  455. package/src/utils/messages.js +0 -166
  456. package/src/utils/paths.js +0 -112
@@ -1,389 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- import { ContextCompressor } from '../utils/context-compressor.js';
4
- import { PersonaAwareCompressor } from '../utils/persona-aware-compressor.js';
5
- import { getBackgroundMonitor } from '../utils/background-monitor.js';
6
- import { TokenCounter } from '../utils/token-counter.js';
7
- import { CompressionMetrics } from '../utils/compression-metrics.js';
8
- import fs from 'fs/promises';
9
- import path from 'path';
10
- import chalk from 'chalk';
11
- import ora from 'ora';
12
- import { fileURLToPath } from 'url';
13
- import { dirname } from 'path';
14
-
15
- const __filename = fileURLToPath(import.meta.url);
16
- const __dirname = dirname(__filename);
17
-
18
- /**
19
- * compress-context 명령어 실행
20
- */
21
- export async function executeCompressContext(args = []) {
22
- const spinner = ora('Context 압축 준비 중...').start();
23
-
24
- try {
25
- // 파라미터 파싱
26
- const { mode, targetPath, usePersona } = parseArguments(args);
27
-
28
- spinner.text = '압축 대상 분석 중...';
29
-
30
- // 대상 경로 결정
31
- const resolvedPath = await resolveTargetPath(targetPath);
32
- const files = await collectMarkdownFiles(resolvedPath);
33
-
34
- if (files.length === 0) {
35
- spinner.fail('압축할 마크다운 파일이 없습니다.');
36
- return;
37
- }
38
-
39
- // 압축 전 통계
40
- spinner.text = '원본 토큰 수 계산 중...';
41
- const beforeStats = await calculateStats(files);
42
-
43
- // 압축 시작
44
- console.log('');
45
- console.log(chalk.cyan('🗜️ Context 압축 시작'));
46
- console.log(chalk.gray('━'.repeat(50)));
47
- console.log(`압축 모드: ${chalk.yellow(mode)}`);
48
- console.log(`대상: ${chalk.yellow(resolvedPath)}`);
49
- console.log(`페르소나 연동: ${chalk.yellow(usePersona ? '활성화' : '비활성화')}`);
50
- console.log('');
51
-
52
- console.log(chalk.cyan('📊 압축 전 통계:'));
53
- console.log(`- 총 파일 수: ${files.length}`);
54
- console.log(`- 원본 토큰: ${chalk.red(beforeStats.totalTokens.toLocaleString())}`);
55
- console.log(`- 원본 크기: ${(beforeStats.totalSize / 1024).toFixed(1)} KB`);
56
- console.log('');
57
-
58
- spinner.text = '압축 진행 중...';
59
-
60
- // 압축 수행
61
- const compressor = usePersona
62
- ? new PersonaAwareCompressor(mode)
63
- : new ContextCompressor(mode);
64
- const compressionResults = [];
65
- const startTime = Date.now();
66
-
67
- console.log(chalk.cyan('⚙️ 압축 진행 중...'));
68
-
69
- for (const file of files) {
70
- const fileName = path.basename(file);
71
- const content = await fs.readFile(file, 'utf8');
72
-
73
- const result = await compressor.compress(content, {
74
- strategy: mode,
75
- preserveStructure: true,
76
- enableSummarization: mode === 'aggressive',
77
- enableNormalization: true,
78
- enableFiltering: mode !== 'minimal'
79
- });
80
-
81
- if (result.success) {
82
- const savedTokens = result.originalTokens - result.compressedTokens;
83
- const ratio = result.compressionRatio.toFixed(1);
84
-
85
- console.log(chalk.green(`✓ ${fileName} (${result.originalTokens.toLocaleString()} → ${result.compressedTokens.toLocaleString()} 토큰, -${ratio}%)`));
86
-
87
- compressionResults.push({
88
- filePath: file,
89
- fileName,
90
- ...result
91
- });
92
- } else {
93
- console.log(chalk.red(`✗ ${fileName} (압축 실패: ${result.error})`));
94
- }
95
- }
96
-
97
- const processingTime = Date.now() - startTime;
98
-
99
- // 압축 후 통계
100
- const afterStats = calculateCompressedStats(compressionResults);
101
- const totalSaved = beforeStats.totalTokens - afterStats.totalTokens;
102
- const overallRatio = ((totalSaved / beforeStats.totalTokens) * 100).toFixed(1);
103
-
104
- // 압축된 파일 저장
105
- spinner.text = '압축된 파일 저장 중...';
106
- const outputDir = await saveCompressedFiles(compressionResults, resolvedPath);
107
-
108
- // 압축 보고서 생성
109
- await generateReport(compressionResults, {
110
- mode,
111
- targetPath: resolvedPath,
112
- outputDir,
113
- beforeStats,
114
- afterStats,
115
- processingTime
116
- });
117
-
118
- spinner.stop();
119
-
120
- // 결과 출력
121
- console.log('');
122
- console.log(chalk.cyan('📊 압축 후 통계:'));
123
- console.log(`- 압축된 토큰: ${chalk.green(afterStats.totalTokens.toLocaleString())}`);
124
- console.log(`- 절약된 토큰: ${chalk.green(totalSaved.toLocaleString())}`);
125
- console.log(`- 토큰 절약률: ${chalk.green(overallRatio + '%')}`);
126
- console.log(`- 압축 시간: ${(processingTime / 1000).toFixed(1)}초`);
127
-
128
- // 평균 품질 점수 계산
129
- const avgQuality = compressionResults.reduce((sum, r) => {
130
- return sum + (r.metadata?.validation?.qualityScore || 0);
131
- }, 0) / compressionResults.length;
132
-
133
- console.log(`- 품질 점수: ${chalk.green(avgQuality.toFixed(0) + '/100')}`);
134
-
135
- // 페르소나 정보 출력
136
- if (usePersona && compressor.currentPersona) {
137
- console.log(`- 활성 페르소나: ${chalk.cyan(compressor.currentPersona)}`);
138
- }
139
-
140
- console.log('');
141
-
142
- console.log(chalk.green('✅ 압축 완료!'));
143
- console.log(`압축된 파일 위치: ${chalk.yellow(outputDir)}`);
144
-
145
- // 페르소나 인식 압축인 경우 백그라운드 품질 체크
146
- if (usePersona && compressor.currentPersona) {
147
- const monitor = getBackgroundMonitor();
148
-
149
- // 압축된 내용의 샘플로 품질 체크 (비차단)
150
- const sampleResult = compressionResults[0];
151
- if (sampleResult) {
152
- monitor.monitorResponse(
153
- sampleResult.compressed.substring(0, 1000), // 샘플만
154
- compressor.currentPersona,
155
- { silent: false }
156
- ).then(feedback => {
157
- if (feedback && feedback.feedback) {
158
- console.log('');
159
- console.log(feedback.feedback);
160
- }
161
- }).catch(() => {}); // 에러 무시
162
- }
163
- }
164
-
165
- // 목표 달성 여부 확인
166
- const targetRange = getTargetRange(mode);
167
- if (parseFloat(overallRatio) < targetRange.min) {
168
- console.log('');
169
- console.log(chalk.yellow(`⚠️ 경고: 압축률이 목표 범위(${targetRange.min}-${targetRange.max}%)에 미달했습니다.`));
170
- console.log('더 높은 압축률이 필요하면 aggressive 모드를 시도해보세요.');
171
- }
172
-
173
- // 리소스 정리
174
- compressor.cleanup();
175
-
176
- } catch (error) {
177
- spinner.fail(`압축 실패: ${error.message}`);
178
- console.error(error);
179
- }
180
- }
181
-
182
- /**
183
- * 명령어 인자를 파싱합니다
184
- * @param {Array<string>} args - 인자 배열
185
- * @returns {Object} 파싱된 옵션
186
- */
187
- function parseArguments(args) {
188
- let mode = 'balanced';
189
- let targetPath = null;
190
- let usePersona = false;
191
-
192
- for (const arg of args) {
193
- if (['aggressive', 'balanced', 'minimal'].includes(arg)) {
194
- mode = arg;
195
- } else if (arg === '--persona' || arg === '-p') {
196
- usePersona = true;
197
- } else if (arg && !arg.startsWith('-')) {
198
- targetPath = arg;
199
- }
200
- }
201
-
202
- return { mode, targetPath, usePersona };
203
- }
204
-
205
- /**
206
- * 대상 경로를 결정합니다
207
- * @param {string} targetPath - 사용자 지정 경로
208
- * @returns {string} 결정된 경로
209
- */
210
- async function resolveTargetPath(targetPath) {
211
- if (targetPath) {
212
- // 절대 경로가 아니면 현재 디렉토리 기준으로 변환
213
- if (!path.isAbsolute(targetPath)) {
214
- targetPath = path.join(process.cwd(), targetPath);
215
- }
216
- return targetPath;
217
- }
218
-
219
- // 기본값: 프로젝트의 .aiwf 디렉토리
220
- const aiwfPath = path.join(process.cwd(), '.aiwf');
221
- try {
222
- await fs.access(aiwfPath);
223
- return aiwfPath;
224
- } catch {
225
- // .aiwf가 없으면 현재 디렉토리
226
- return process.cwd();
227
- }
228
- }
229
-
230
- /**
231
- * 마크다운 파일들을 수집합니다
232
- * @param {string} targetPath - 대상 경로
233
- * @returns {Array<string>} 파일 경로 배열
234
- */
235
- async function collectMarkdownFiles(targetPath) {
236
- const files = [];
237
-
238
- try {
239
- const stats = await fs.stat(targetPath);
240
-
241
- if (stats.isFile() && targetPath.endsWith('.md')) {
242
- files.push(targetPath);
243
- } else if (stats.isDirectory()) {
244
- await collectFromDirectory(targetPath, files);
245
- }
246
- } catch (error) {
247
- console.error(`경로 접근 오류: ${targetPath}`);
248
- }
249
-
250
- return files;
251
- }
252
-
253
- /**
254
- * 디렉토리에서 마크다운 파일을 재귀적으로 수집합니다
255
- * @param {string} dirPath - 디렉토리 경로
256
- * @param {Array<string>} files - 파일 배열
257
- */
258
- async function collectFromDirectory(dirPath, files) {
259
- const entries = await fs.readdir(dirPath, { withFileTypes: true });
260
-
261
- for (const entry of entries) {
262
- const fullPath = path.join(dirPath, entry.name);
263
-
264
- if (entry.isDirectory() && !entry.name.startsWith('.')) {
265
- await collectFromDirectory(fullPath, files);
266
- } else if (entry.isFile() && entry.name.endsWith('.md')) {
267
- files.push(fullPath);
268
- }
269
- }
270
- }
271
-
272
- /**
273
- * 파일 통계를 계산합니다
274
- * @param {Array<string>} files - 파일 경로 배열
275
- * @returns {Object} 통계 정보
276
- */
277
- async function calculateStats(files) {
278
- const tokenCounter = new TokenCounter();
279
- let totalTokens = 0;
280
- let totalSize = 0;
281
-
282
- for (const file of files) {
283
- const content = await fs.readFile(file, 'utf8');
284
- totalTokens += tokenCounter.countTokens(content);
285
- totalSize += Buffer.byteLength(content, 'utf8');
286
- }
287
-
288
- tokenCounter.cleanup();
289
-
290
- return { totalTokens, totalSize };
291
- }
292
-
293
- /**
294
- * 압축된 통계를 계산합니다
295
- * @param {Array<Object>} results - 압축 결과 배열
296
- * @returns {Object} 통계 정보
297
- */
298
- function calculateCompressedStats(results) {
299
- const totalTokens = results.reduce((sum, r) => sum + r.compressedTokens, 0);
300
- const totalSize = results.reduce((sum, r) => sum + Buffer.byteLength(r.compressed, 'utf8'), 0);
301
-
302
- return { totalTokens, totalSize };
303
- }
304
-
305
- /**
306
- * 압축된 파일들을 저장합니다
307
- * @param {Array<Object>} results - 압축 결과 배열
308
- * @param {string} targetPath - 원본 경로
309
- * @returns {string} 출력 디렉토리
310
- */
311
- async function saveCompressedFiles(results, targetPath) {
312
- const timestamp = new Date().toISOString().slice(0, 19).replace(/:/g, '-');
313
- const outputDir = path.join(path.dirname(targetPath), `.aiwf_compressed`, timestamp);
314
-
315
- await fs.mkdir(outputDir, { recursive: true });
316
-
317
- for (const result of results) {
318
- const outputPath = path.join(outputDir, result.fileName);
319
- await fs.writeFile(outputPath, result.compressed);
320
- }
321
-
322
- return outputDir;
323
- }
324
-
325
- /**
326
- * 압축 보고서를 생성합니다
327
- * @param {Array<Object>} results - 압축 결과 배열
328
- * @param {Object} stats - 통계 정보
329
- */
330
- async function generateReport(results, stats) {
331
- const report = [];
332
-
333
- report.push('# Context 압축 보고서');
334
- report.push('');
335
- report.push(`**생성 시간**: ${new Date().toISOString()}`);
336
- report.push(`**압축 모드**: ${stats.mode}`);
337
- report.push(`**대상 경로**: ${stats.targetPath}`);
338
- report.push(`**출력 경로**: ${stats.outputDir}`);
339
- report.push('');
340
-
341
- report.push('## 전체 통계');
342
- report.push(`- **파일 수**: ${results.length}`);
343
- report.push(`- **원본 토큰**: ${stats.beforeStats.totalTokens.toLocaleString()}`);
344
- report.push(`- **압축 토큰**: ${stats.afterStats.totalTokens.toLocaleString()}`);
345
- report.push(`- **절약 토큰**: ${(stats.beforeStats.totalTokens - stats.afterStats.totalTokens).toLocaleString()}`);
346
- report.push(`- **전체 압축률**: ${((stats.beforeStats.totalTokens - stats.afterStats.totalTokens) / stats.beforeStats.totalTokens * 100).toFixed(1)}%`);
347
- report.push(`- **처리 시간**: ${(stats.processingTime / 1000).toFixed(1)}초`);
348
- report.push('');
349
-
350
- report.push('## 파일별 상세');
351
- report.push('');
352
- report.push('| 파일명 | 원본 토큰 | 압축 토큰 | 압축률 | 품질 점수 |');
353
- report.push('|--------|-----------|-----------|--------|-----------|');
354
-
355
- for (const result of results) {
356
- const qualityScore = result.metadata?.validation?.qualityScore || 0;
357
- report.push(
358
- `| ${result.fileName} | ${result.originalTokens.toLocaleString()} | ` +
359
- `${result.compressedTokens.toLocaleString()} | ${result.compressionRatio}% | ` +
360
- `${qualityScore}/100 |`
361
- );
362
- }
363
-
364
- const reportPath = path.join(stats.outputDir, 'compression-report.md');
365
- await fs.writeFile(reportPath, report.join('\n'));
366
- }
367
-
368
- /**
369
- * 압축 모드별 목표 범위를 반환합니다
370
- * @param {string} mode - 압축 모드
371
- * @returns {Object} 목표 범위
372
- */
373
- function getTargetRange(mode) {
374
- const ranges = {
375
- aggressive: { min: 50, max: 70 },
376
- balanced: { min: 30, max: 50 },
377
- minimal: { min: 10, max: 30 }
378
- };
379
-
380
- return ranges[mode] || { min: 0, max: 100 };
381
- }
382
-
383
- // CLI로 직접 실행하는 경우
384
- if (import.meta.url === `file://${process.argv[1]}`) {
385
- const args = process.argv.slice(2);
386
- executeCompressContext(args);
387
- }
388
-
389
- export default executeCompressContext;
@@ -1,246 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * 경량화된 평가 명령어
5
- * 선택적으로 사용할 수 있는 간단한 평가 도구
6
- */
7
-
8
- import { SimplifiedEvaluator } from '../utils/simplified-evaluator.js';
9
- import { getBackgroundMonitor } from '../utils/background-monitor.js';
10
- import fs from 'fs/promises';
11
- import path from 'path';
12
- import chalk from 'chalk';
13
- import { fileURLToPath } from 'url';
14
-
15
- const __filename = fileURLToPath(import.meta.url);
16
- const __dirname = path.dirname(__filename);
17
-
18
- /**
19
- * evaluate 명령어 실행
20
- */
21
- export async function executeEvaluate(args = []) {
22
- const option = args[0];
23
-
24
- try {
25
- switch (option) {
26
- case '--detailed':
27
- case '-d':
28
- return await detailedEvaluation();
29
-
30
- case '--history':
31
- case '-h':
32
- return await showHistory();
33
-
34
- case '--stats':
35
- case '-s':
36
- return await showStats();
37
-
38
- default:
39
- return await quickEvaluation();
40
- }
41
- } catch (error) {
42
- console.error(chalk.red('오류:'), error.message);
43
- }
44
- }
45
-
46
- /**
47
- * 빠른 평가 (기본)
48
- */
49
- async function quickEvaluation() {
50
- console.log(chalk.cyan('🔍 최근 응답 평가'));
51
- console.log(chalk.gray('━'.repeat(50)));
52
-
53
- // 현재 페르소나 확인
54
- const currentPersona = await getCurrentPersona();
55
- if (!currentPersona) {
56
- console.log(chalk.yellow('활성화된 페르소나가 없습니다.'));
57
- console.log('페르소나를 먼저 활성화하세요: aiwf persona [architect|security|frontend|backend|data_analyst]');
58
- return;
59
- }
60
-
61
- console.log(`현재 페르소나: ${chalk.yellow(currentPersona)}`);
62
-
63
- // 최근 통계 표시
64
- const monitor = getBackgroundMonitor();
65
- const stats = monitor.getRecentStats(currentPersona);
66
-
67
- if (stats.message) {
68
- console.log(stats.message);
69
- return;
70
- }
71
-
72
- console.log(`평균 점수: ${chalk.green(stats.averageScore)}`);
73
- console.log(`평가 횟수: ${stats.totalEvaluations}`);
74
- console.log(`추세: ${getTrendEmoji(stats.trend)} ${getKoreanTrend(stats.trend)}`);
75
-
76
- // 간단한 팁
77
- if (parseFloat(stats.averageScore) < 0.6) {
78
- console.log('');
79
- console.log(chalk.yellow('💡 팁: 페르소나 특성을 더 활용해보세요!'));
80
- } else if (parseFloat(stats.averageScore) > 0.8) {
81
- console.log('');
82
- console.log(chalk.green('🎉 훌륭해요! 페르소나를 잘 활용하고 있습니다.'));
83
- }
84
- }
85
-
86
- /**
87
- * 상세 평가
88
- */
89
- async function detailedEvaluation() {
90
- console.log(chalk.cyan('📊 상세 평가 분석'));
91
- console.log(chalk.gray('━'.repeat(50)));
92
-
93
- const monitor = getBackgroundMonitor();
94
- const stats = monitor.getRecentStats();
95
-
96
- if (stats.message) {
97
- console.log(stats.message);
98
- return;
99
- }
100
-
101
- console.log(chalk.white('전체 통계:'));
102
- console.log(`- 총 평가: ${stats.totalEvaluations}회`);
103
- console.log(`- 평균 점수: ${stats.averageScore}`);
104
- console.log(`- 추세: ${getTrendEmoji(stats.trend)} ${getKoreanTrend(stats.trend)}`);
105
-
106
- console.log('');
107
- console.log(chalk.white('페르소나별 성과:'));
108
-
109
- Object.entries(stats.personaStats).forEach(([persona, data]) => {
110
- const score = parseFloat(data.avgScore);
111
- const scoreColor = score >= 0.8 ? 'green' : score >= 0.6 ? 'yellow' : 'red';
112
-
113
- console.log(`- ${getKoreanPersonaName(persona)}: ${chalk[scoreColor](data.avgScore)} (${data.count}회)`);
114
- });
115
-
116
- // 개선 제안
117
- console.log('');
118
- console.log(chalk.white('개선 제안:'));
119
-
120
- Object.entries(stats.personaStats).forEach(([persona, data]) => {
121
- if (parseFloat(data.avgScore) < 0.6) {
122
- const evaluator = new SimplifiedEvaluator();
123
- const feedback = evaluator.getGentleFeedback(persona, parseFloat(data.avgScore));
124
- if (feedback) {
125
- console.log(feedback);
126
- }
127
- }
128
- });
129
- }
130
-
131
- /**
132
- * 평가 히스토리
133
- */
134
- async function showHistory() {
135
- console.log(chalk.cyan('📈 평가 히스토리'));
136
- console.log(chalk.gray('━'.repeat(50)));
137
-
138
- const monitor = getBackgroundMonitor();
139
- const history = monitor.recentEvaluations.slice(-10); // 최근 10개
140
-
141
- if (history.length === 0) {
142
- console.log('평가 기록이 없습니다.');
143
- return;
144
- }
145
-
146
- history.forEach((eval, index) => {
147
- const date = new Date(eval.timestamp);
148
- const timeStr = `${date.getHours()}:${date.getMinutes().toString().padStart(2, '0')}`;
149
- const scoreColor = eval.score >= 0.8 ? 'green' : eval.score >= 0.6 ? 'yellow' : 'red';
150
-
151
- console.log(`${timeStr} | ${getKoreanPersonaName(eval.persona)} | ${chalk[scoreColor](eval.score.toFixed(2))}`);
152
- });
153
- }
154
-
155
- /**
156
- * 주간 통계
157
- */
158
- async function showStats() {
159
- console.log(chalk.cyan('📊 주간 통계'));
160
- console.log(chalk.gray('━'.repeat(50)));
161
-
162
- const monitor = getBackgroundMonitor();
163
- const summary = monitor.getWeeklySummary();
164
-
165
- if (summary.message) {
166
- console.log(summary.message);
167
- return;
168
- }
169
-
170
- console.log(`평가 횟수: ${summary.evaluationCount}회`);
171
- console.log(`평균 점수: ${summary.averageScore}`);
172
- console.log(`추세: ${getTrendEmoji(summary.trend)} ${getKoreanTrend(summary.trend)}`);
173
-
174
- if (summary.personaStats) {
175
- console.log('');
176
- console.log('페르소나별 활용도:');
177
-
178
- const sorted = Object.entries(summary.personaStats)
179
- .sort((a, b) => b[1].count - a[1].count);
180
-
181
- sorted.forEach(([persona, data]) => {
182
- const bar = '█'.repeat(Math.floor(data.count / 2));
183
- console.log(`${getKoreanPersonaName(persona).padEnd(10)} ${bar} ${data.count}회`);
184
- });
185
- }
186
- }
187
-
188
- /**
189
- * 현재 페르소나 가져오기
190
- */
191
- async function getCurrentPersona() {
192
- try {
193
- const personaPath = path.join(process.cwd(), '.aiwf', 'current_persona.json');
194
- const data = await fs.readFile(personaPath, 'utf8');
195
- const personaData = JSON.parse(data);
196
- return personaData.persona;
197
- } catch {
198
- return null;
199
- }
200
- }
201
-
202
- /**
203
- * 페르소나 이름 한글화
204
- */
205
- function getKoreanPersonaName(persona) {
206
- const names = {
207
- architect: '아키텍트',
208
- security: '보안 전문가',
209
- frontend: '프론트엔드',
210
- backend: '백엔드',
211
- data_analyst: '데이터 분석가'
212
- };
213
- return names[persona] || persona;
214
- }
215
-
216
- /**
217
- * 추세 이모지
218
- */
219
- function getTrendEmoji(trend) {
220
- const emojis = {
221
- improving: '📈',
222
- declining: '📉',
223
- stable: '➡️'
224
- };
225
- return emojis[trend] || '❓';
226
- }
227
-
228
- /**
229
- * 추세 한글화
230
- */
231
- function getKoreanTrend(trend) {
232
- const trends = {
233
- improving: '개선 중',
234
- declining: '하락 중',
235
- stable: '안정적'
236
- };
237
- return trends[trend] || trend;
238
- }
239
-
240
- // CLI로 직접 실행하는 경우
241
- if (import.meta.url === `file://${process.argv[1]}`) {
242
- const args = process.argv.slice(2);
243
- executeEvaluate(args);
244
- }
245
-
246
- export default executeEvaluate;