pumuki-ast-hooks 5.3.1

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 (567) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1105 -0
  3. package/bin/__tests__/auto-fix-violations.spec.js +132 -0
  4. package/bin/__tests__/auto-restart-guards.spec.js +11 -0
  5. package/bin/__tests__/check-doc-drift.spec.js +11 -0
  6. package/bin/__tests__/check-version.spec.js +240 -0
  7. package/bin/__tests__/cli.spec.js +11 -0
  8. package/bin/__tests__/guard-auto-manager.spec.js +11 -0
  9. package/bin/__tests__/guard-supervisor.spec.js +11 -0
  10. package/bin/__tests__/hook-status.spec.js +11 -0
  11. package/bin/__tests__/install.spec.js +11 -0
  12. package/bin/__tests__/nightly-metrics-report.spec.js +94 -0
  13. package/bin/__tests__/plan-review.spec.js +11 -0
  14. package/bin/__tests__/predictive-hooks.spec.js +11 -0
  15. package/bin/__tests__/run-ast-adapter.spec.js +11 -0
  16. package/bin/__tests__/run-orchestrator.spec.js +11 -0
  17. package/bin/__tests__/run-playbook.spec.js +11 -0
  18. package/bin/__tests__/setup-eslint.spec.js +11 -0
  19. package/bin/__tests__/violations-api.spec.js +11 -0
  20. package/bin/__tests__/watch-hooks.spec.js +11 -0
  21. package/bin/ai-commit.sh +5 -0
  22. package/bin/audit +5 -0
  23. package/bin/audit-library.js +6 -0
  24. package/bin/auto-fix-violations.js +19 -0
  25. package/bin/auto-restart-guards.js +6 -0
  26. package/bin/check-doc-drift.js +6 -0
  27. package/bin/check-version.js +19 -0
  28. package/bin/cleanup-branches.sh +5 -0
  29. package/bin/cli.js +6 -0
  30. package/bin/demo-recording.sh +5 -0
  31. package/bin/demo-violations +5 -0
  32. package/bin/fix-enforcer +5 -0
  33. package/bin/fix-gitflow-enforcement.sh +5 -0
  34. package/bin/generate-progress-report.sh +5 -0
  35. package/bin/git-analyze-pairs.sh +5 -0
  36. package/bin/git-leave-branch-check.sh +5 -0
  37. package/bin/gitflow +5 -0
  38. package/bin/gitflow-shell-integration.sh +5 -0
  39. package/bin/guard-auto-manager.js +6 -0
  40. package/bin/guard-autostart.sh +5 -0
  41. package/bin/guard-env.sh +5 -0
  42. package/bin/guard-supervisor.js +6 -0
  43. package/bin/hook-status.js +6 -0
  44. package/bin/install-git-wrapper.sh +5 -0
  45. package/bin/install.js +6 -0
  46. package/bin/kill-mcp-zombies.sh +5 -0
  47. package/bin/nightly-metrics-report.js +8 -0
  48. package/bin/plan-review.js +6 -0
  49. package/bin/predictive-hooks.js +6 -0
  50. package/bin/pumuki-audit.js +6 -0
  51. package/bin/pumuki-init.js +19 -0
  52. package/bin/pumuki-mcp-server.js +13 -0
  53. package/bin/pumuki-mcp.js +6 -0
  54. package/bin/pumuki-rules.js +6 -0
  55. package/bin/request-no-verify-approval.sh +5 -0
  56. package/bin/run-ast-adapter.js +6 -0
  57. package/bin/run-intelligent-audit.sh +5 -0
  58. package/bin/run-orchestrator.js +6 -0
  59. package/bin/run-playbook.js +6 -0
  60. package/bin/session-loader.sh +5 -0
  61. package/bin/setup-eslint.js +6 -0
  62. package/bin/start-guards.sh +5 -0
  63. package/bin/sync-autonomous-orchestrator.sh +5 -0
  64. package/bin/sync-to-library.sh +5 -0
  65. package/bin/update-evidence.sh +5 -0
  66. package/bin/update-session-context.sh +5 -0
  67. package/bin/verify-no-verify.sh +5 -0
  68. package/bin/violations +5 -0
  69. package/bin/violations-api.js +6 -0
  70. package/bin/watch-hooks.js +6 -0
  71. package/docs/API_REFERENCE.md +161 -0
  72. package/docs/ARCHITECTURE.md +236 -0
  73. package/docs/ARCHITECTURE_DETAILED.md +499 -0
  74. package/docs/BRANCH_PROTECTION_GUIDE.md +236 -0
  75. package/docs/CODE_STANDARDS.md +440 -0
  76. package/docs/CONTRIBUTING.md +246 -0
  77. package/docs/DEPENDENCIES.md +541 -0
  78. package/docs/HOW_IT_WORKS.md +716 -0
  79. package/docs/INSTALLATION.md +784 -0
  80. package/docs/MCP_SERVERS.md +786 -0
  81. package/docs/TESTING.md +423 -0
  82. package/docs/USAGE.md +856 -0
  83. package/docs/images/ast_intelligence_01.png +0 -0
  84. package/docs/images/ast_intelligence_02.png +0 -0
  85. package/docs/images/ast_intelligence_03.png +0 -0
  86. package/docs/images/ast_intelligence_04.png +0 -0
  87. package/docs/images/ast_intelligence_05.png +0 -0
  88. package/hooks/getSkillRulesPath.ts +52 -0
  89. package/hooks/git-status-monitor.ts +160 -0
  90. package/hooks/index.js +5 -0
  91. package/hooks/notify-macos.ts +42 -0
  92. package/hooks/package.json +16 -0
  93. package/hooks/post-tool-use-tracker.sh +89 -0
  94. package/hooks/pre-tool-use-evidence-validator.ts +252 -0
  95. package/hooks/pre-tool-use-guard.ts +151 -0
  96. package/hooks/skill-activation-prompt.sh +8 -0
  97. package/hooks/skill-activation-prompt.ts +307 -0
  98. package/index.js +49 -0
  99. package/package.json +117 -0
  100. package/presentation/cli/audit.sh +24 -0
  101. package/presentation/cli/autonomous-status.sh +92 -0
  102. package/presentation/cli/categorize-violations.sh +179 -0
  103. package/presentation/cli/direct-audit-option2.sh +23 -0
  104. package/presentation/cli/direct-audit.sh +33 -0
  105. package/scripts/hooks-system/.AI_TOKEN_STATUS.txt +16 -0
  106. package/scripts/hooks-system/.audit-reports/auto-recovery.log +1 -0
  107. package/scripts/hooks-system/.audit-reports/install-wizard.log +4 -0
  108. package/scripts/hooks-system/.audit-reports/notifications.log +425 -0
  109. package/scripts/hooks-system/.audit-reports/token-monitor.log +1275 -0
  110. package/scripts/hooks-system/.audit_tmp/intelligent-report.json +44953 -0
  111. package/scripts/hooks-system/.audit_tmp/intelligent-report.txt +1338 -0
  112. package/scripts/hooks-system/.audit_tmp/severity-history.jsonl +1 -0
  113. package/scripts/hooks-system/.audit_tmp/token-usage.jsonl +1 -0
  114. package/scripts/hooks-system/.hook-system/config.json +8 -0
  115. package/scripts/hooks-system/application/CompositionRoot.js +325 -0
  116. package/scripts/hooks-system/application/__tests__/CompositionRoot.spec.js +84 -0
  117. package/scripts/hooks-system/application/commands/index.js +64 -0
  118. package/scripts/hooks-system/application/queries/index.js +60 -0
  119. package/scripts/hooks-system/application/services/AutonomousOrchestrator.js +130 -0
  120. package/scripts/hooks-system/application/services/ContextDetectionEngine.js +181 -0
  121. package/scripts/hooks-system/application/services/DynamicRulesLoader.js +182 -0
  122. package/scripts/hooks-system/application/services/GitFlowService.js +156 -0
  123. package/scripts/hooks-system/application/services/GitTreeState.js +140 -0
  124. package/scripts/hooks-system/application/services/HookSystemScheduler.js +77 -0
  125. package/scripts/hooks-system/application/services/IntelligentCommitAnalyzer.js +151 -0
  126. package/scripts/hooks-system/application/services/IntelligentGitTreeMonitor.js +118 -0
  127. package/scripts/hooks-system/application/services/PlatformAnalysisService.js +173 -0
  128. package/scripts/hooks-system/application/services/PlatformDetectionService.js +168 -0
  129. package/scripts/hooks-system/application/services/PlaybookRunner.js +39 -0
  130. package/scripts/hooks-system/application/services/PredictiveHookAdvisor.js +56 -0
  131. package/scripts/hooks-system/application/services/RealtimeGuardPlugin.js +62 -0
  132. package/scripts/hooks-system/application/services/RealtimeGuardService.js +374 -0
  133. package/scripts/hooks-system/application/services/SmartDirtyTreeAnalyzer.js +63 -0
  134. package/scripts/hooks-system/application/services/__tests__/AutonomousOrchestrator.spec.js +36 -0
  135. package/scripts/hooks-system/application/services/__tests__/ContextDetectionEngine.spec.js +33 -0
  136. package/scripts/hooks-system/application/services/__tests__/DynamicRulesLoader.spec.js +43 -0
  137. package/scripts/hooks-system/application/services/__tests__/GitTreeState.spec.js +163 -0
  138. package/scripts/hooks-system/application/services/__tests__/HookSystemScheduler.spec.js +207 -0
  139. package/scripts/hooks-system/application/services/__tests__/IntelligentCommitAnalyzer.spec.js +365 -0
  140. package/scripts/hooks-system/application/services/__tests__/IntelligentGitTreeMonitor.spec.js +188 -0
  141. package/scripts/hooks-system/application/services/__tests__/PlatformDetectionService.spec.js +28 -0
  142. package/scripts/hooks-system/application/services/__tests__/PlaybookRunner.spec.js +143 -0
  143. package/scripts/hooks-system/application/services/__tests__/PredictiveHookAdvisor.spec.js +181 -0
  144. package/scripts/hooks-system/application/services/__tests__/RealtimeGuardPlugin.spec.js +45 -0
  145. package/scripts/hooks-system/application/services/__tests__/RealtimeGuardService.critical.spec.js +401 -0
  146. package/scripts/hooks-system/application/services/commit/CommitMessageGenerator.js +34 -0
  147. package/scripts/hooks-system/application/services/commit/FeatureDetector.js +101 -0
  148. package/scripts/hooks-system/application/services/evidence/EvidenceContextManager.js +163 -0
  149. package/scripts/hooks-system/application/services/evidence/__tests__/EvidenceContextManager.spec.js +98 -0
  150. package/scripts/hooks-system/application/services/guard/GuardAutoManagerService.js +169 -0
  151. package/scripts/hooks-system/application/services/guard/GuardConfig.js +15 -0
  152. package/scripts/hooks-system/application/services/guard/GuardEventLogger.js +70 -0
  153. package/scripts/hooks-system/application/services/guard/GuardHealthReminder.js +54 -0
  154. package/scripts/hooks-system/application/services/guard/GuardHeartbeatMonitor.js +94 -0
  155. package/scripts/hooks-system/application/services/guard/GuardLockManager.js +72 -0
  156. package/scripts/hooks-system/application/services/guard/GuardMonitorLoop.js +29 -0
  157. package/scripts/hooks-system/application/services/guard/GuardNotificationHandler.js +36 -0
  158. package/scripts/hooks-system/application/services/guard/GuardProcessManager.js +113 -0
  159. package/scripts/hooks-system/application/services/guard/GuardRecoveryService.js +90 -0
  160. package/scripts/hooks-system/application/services/guard/__tests__/GuardAutoManagerService.spec.js +77 -0
  161. package/scripts/hooks-system/application/services/installation/ConfigurationGeneratorService.js +123 -0
  162. package/scripts/hooks-system/application/services/installation/FileSystemInstallerService.js +112 -0
  163. package/scripts/hooks-system/application/services/installation/GitEnvironmentService.js +166 -0
  164. package/scripts/hooks-system/application/services/installation/HookInstaller.js +197 -0
  165. package/scripts/hooks-system/application/services/installation/IdeIntegrationService.js +37 -0
  166. package/scripts/hooks-system/application/services/installation/InstallService.js +130 -0
  167. package/scripts/hooks-system/application/services/installation/McpConfigurator.js +172 -0
  168. package/scripts/hooks-system/application/services/installation/PlatformDetectorService.js +36 -0
  169. package/scripts/hooks-system/application/services/installation/VSCodeTaskConfigurator.js +97 -0
  170. package/scripts/hooks-system/application/services/logging/UnifiedLogger.js +142 -0
  171. package/scripts/hooks-system/application/services/logging/__tests__/UnifiedLogger.spec.js +66 -0
  172. package/scripts/hooks-system/application/services/monitoring/ActivityMonitor.js +80 -0
  173. package/scripts/hooks-system/application/services/monitoring/AstMonitor.js +140 -0
  174. package/scripts/hooks-system/application/services/monitoring/DevDocsMonitor.js +85 -0
  175. package/scripts/hooks-system/application/services/monitoring/EvidenceMonitor.js +103 -0
  176. package/scripts/hooks-system/application/services/monitoring/EvidenceMonitorService.js +162 -0
  177. package/scripts/hooks-system/application/services/monitoring/GitTreeMonitor.js +123 -0
  178. package/scripts/hooks-system/application/services/monitoring/GitTreeMonitorService.js +114 -0
  179. package/scripts/hooks-system/application/services/monitoring/HealthCheckProviders.js +153 -0
  180. package/scripts/hooks-system/application/services/monitoring/HealthCheckService.js +118 -0
  181. package/scripts/hooks-system/application/services/monitoring/HeartbeatMonitorService.js +61 -0
  182. package/scripts/hooks-system/application/services/monitoring/TokenMonitor.js +60 -0
  183. package/scripts/hooks-system/application/services/monitoring/__tests__/EvidenceMonitorService.spec.js +107 -0
  184. package/scripts/hooks-system/application/services/monitoring/__tests__/GitTreeMonitorService.spec.js +27 -0
  185. package/scripts/hooks-system/application/services/monitoring/__tests__/HealthCheckProviders.spec.js +68 -0
  186. package/scripts/hooks-system/application/services/monitoring/__tests__/HealthCheckService.spec.js +69 -0
  187. package/scripts/hooks-system/application/services/monitoring/__tests__/HeartbeatMonitorService.spec.js +35 -0
  188. package/scripts/hooks-system/application/services/notification/MacNotificationSender.js +106 -0
  189. package/scripts/hooks-system/application/services/notification/NotificationCenterService.js +221 -0
  190. package/scripts/hooks-system/application/services/notification/NotificationDispatcher.js +42 -0
  191. package/scripts/hooks-system/application/services/notification/__tests__/NotificationCenterService.spec.js +40 -0
  192. package/scripts/hooks-system/application/services/notification/components/NotificationCooldownManager.js +62 -0
  193. package/scripts/hooks-system/application/services/notification/components/NotificationDeduplicator.js +67 -0
  194. package/scripts/hooks-system/application/services/notification/components/NotificationQueue.js +36 -0
  195. package/scripts/hooks-system/application/services/notification/components/NotificationRetryExecutor.js +58 -0
  196. package/scripts/hooks-system/application/services/platform/PlatformHeuristics.js +144 -0
  197. package/scripts/hooks-system/application/services/recovery/AutoRecoveryManager.js +137 -0
  198. package/scripts/hooks-system/application/services/recovery/__tests__/AutoRecoveryManager.spec.js +62 -0
  199. package/scripts/hooks-system/application/services/smart-commit/CommitMessageSuggester.js +97 -0
  200. package/scripts/hooks-system/application/services/smart-commit/FileContextGrouper.js +114 -0
  201. package/scripts/hooks-system/application/services/smart-commit/SmartCommitSummaryBuilder.js +53 -0
  202. package/scripts/hooks-system/application/services/token/CursorTokenService.js +44 -0
  203. package/scripts/hooks-system/application/services/token/TokenMetricsService.js +109 -0
  204. package/scripts/hooks-system/application/services/token/TokenMonitorService.js +160 -0
  205. package/scripts/hooks-system/application/services/token/TokenStatusReporter.js +56 -0
  206. package/scripts/hooks-system/application/services/token/__tests__/CursorTokenService.spec.js +69 -0
  207. package/scripts/hooks-system/application/services/token/__tests__/TokenMonitorService.spec.js +185 -0
  208. package/scripts/hooks-system/application/state/HookSystemStateMachine.js +59 -0
  209. package/scripts/hooks-system/application/state/__tests__/HookSystemStateMachine.spec.js +115 -0
  210. package/scripts/hooks-system/application/use-cases/AnalyzeCodebaseUseCase.js +54 -0
  211. package/scripts/hooks-system/application/use-cases/AnalyzeStagedFilesUseCase.js +61 -0
  212. package/scripts/hooks-system/application/use-cases/AutoExecuteAIStartUseCase.js +123 -0
  213. package/scripts/hooks-system/application/use-cases/BlockCommitUseCase.js +90 -0
  214. package/scripts/hooks-system/application/use-cases/GenerateAuditReportUseCase.js +184 -0
  215. package/scripts/hooks-system/application/use-cases/__tests__/AnalyzeCodebaseUseCase.spec.js +156 -0
  216. package/scripts/hooks-system/application/use-cases/__tests__/AnalyzeStagedFilesUseCase.spec.js +146 -0
  217. package/scripts/hooks-system/application/use-cases/__tests__/AutoExecuteAIStartUseCase.spec.js +89 -0
  218. package/scripts/hooks-system/application/use-cases/__tests__/BlockCommitUseCase.spec.js +171 -0
  219. package/scripts/hooks-system/application/use-cases/__tests__/GenerateAuditReportUseCase.spec.js +207 -0
  220. package/scripts/hooks-system/bin/__tests__/auto-fix-violations.spec.js +132 -0
  221. package/scripts/hooks-system/bin/__tests__/auto-restart-guards.spec.js +11 -0
  222. package/scripts/hooks-system/bin/__tests__/check-doc-drift.spec.js +11 -0
  223. package/scripts/hooks-system/bin/__tests__/check-version.spec.js +240 -0
  224. package/scripts/hooks-system/bin/__tests__/cli.spec.js +11 -0
  225. package/scripts/hooks-system/bin/__tests__/guard-auto-manager.spec.js +11 -0
  226. package/scripts/hooks-system/bin/__tests__/guard-supervisor.spec.js +11 -0
  227. package/scripts/hooks-system/bin/__tests__/hook-status.spec.js +11 -0
  228. package/scripts/hooks-system/bin/__tests__/install.spec.js +11 -0
  229. package/scripts/hooks-system/bin/__tests__/nightly-metrics-report.spec.js +94 -0
  230. package/scripts/hooks-system/bin/__tests__/plan-review.spec.js +11 -0
  231. package/scripts/hooks-system/bin/__tests__/predictive-hooks.spec.js +11 -0
  232. package/scripts/hooks-system/bin/__tests__/run-ast-adapter.spec.js +11 -0
  233. package/scripts/hooks-system/bin/__tests__/run-orchestrator.spec.js +11 -0
  234. package/scripts/hooks-system/bin/__tests__/run-playbook.spec.js +11 -0
  235. package/scripts/hooks-system/bin/__tests__/setup-eslint.spec.js +11 -0
  236. package/scripts/hooks-system/bin/__tests__/violations-api.spec.js +11 -0
  237. package/scripts/hooks-system/bin/__tests__/watch-hooks.spec.js +11 -0
  238. package/scripts/hooks-system/bin/ai-commit.sh +63 -0
  239. package/scripts/hooks-system/bin/audit +463 -0
  240. package/scripts/hooks-system/bin/audit-library.js +54 -0
  241. package/scripts/hooks-system/bin/auto-fix-violations.js +130 -0
  242. package/scripts/hooks-system/bin/auto-restart-guards.js +93 -0
  243. package/scripts/hooks-system/bin/check-doc-drift.js +35 -0
  244. package/scripts/hooks-system/bin/check-version.js +201 -0
  245. package/scripts/hooks-system/bin/cleanup-branches.sh +106 -0
  246. package/scripts/hooks-system/bin/cli.js +208 -0
  247. package/scripts/hooks-system/bin/demo-recording.sh +57 -0
  248. package/scripts/hooks-system/bin/demo-violations +44 -0
  249. package/scripts/hooks-system/bin/fix-enforcer +27 -0
  250. package/scripts/hooks-system/bin/fix-gitflow-enforcement.sh +68 -0
  251. package/scripts/hooks-system/bin/generate-progress-report.sh +129 -0
  252. package/scripts/hooks-system/bin/git-analyze-pairs.sh +0 -0
  253. package/scripts/hooks-system/bin/git-leave-branch-check.sh +73 -0
  254. package/scripts/hooks-system/bin/gitflow +17 -0
  255. package/scripts/hooks-system/bin/gitflow-shell-integration.sh +64 -0
  256. package/scripts/hooks-system/bin/guard-auto-manager.js +44 -0
  257. package/scripts/hooks-system/bin/guard-autostart.sh +158 -0
  258. package/scripts/hooks-system/bin/guard-env.sh +40 -0
  259. package/scripts/hooks-system/bin/guard-supervisor.js +516 -0
  260. package/scripts/hooks-system/bin/hook-status.js +41 -0
  261. package/scripts/hooks-system/bin/install-git-wrapper.sh +53 -0
  262. package/scripts/hooks-system/bin/install.js +10 -0
  263. package/scripts/hooks-system/bin/kill-mcp-zombies.sh +48 -0
  264. package/scripts/hooks-system/bin/nightly-metrics-report.js +138 -0
  265. package/scripts/hooks-system/bin/plan-review.js +31 -0
  266. package/scripts/hooks-system/bin/predictive-hooks.js +18 -0
  267. package/scripts/hooks-system/bin/pumuki-audit.js +113 -0
  268. package/scripts/hooks-system/bin/pumuki-init.js +104 -0
  269. package/scripts/hooks-system/bin/pumuki-mcp.js +74 -0
  270. package/scripts/hooks-system/bin/pumuki-rules.js +74 -0
  271. package/scripts/hooks-system/bin/request-no-verify-approval.sh +116 -0
  272. package/scripts/hooks-system/bin/run-ast-adapter.js +86 -0
  273. package/scripts/hooks-system/bin/run-intelligent-audit.sh +67 -0
  274. package/scripts/hooks-system/bin/run-orchestrator.js +27 -0
  275. package/scripts/hooks-system/bin/run-playbook.js +23 -0
  276. package/scripts/hooks-system/bin/session-loader.sh +264 -0
  277. package/scripts/hooks-system/bin/setup-eslint.js +110 -0
  278. package/scripts/hooks-system/bin/start-guards.sh +190 -0
  279. package/scripts/hooks-system/bin/sync-autonomous-orchestrator.sh +32 -0
  280. package/scripts/hooks-system/bin/sync-to-library.sh +46 -0
  281. package/scripts/hooks-system/bin/update-evidence.sh +1167 -0
  282. package/scripts/hooks-system/bin/update-session-context.sh +261 -0
  283. package/scripts/hooks-system/bin/verify-no-verify.sh +68 -0
  284. package/scripts/hooks-system/bin/violations +20 -0
  285. package/scripts/hooks-system/bin/violations-api.js +345 -0
  286. package/scripts/hooks-system/bin/watch-hooks.js +20 -0
  287. package/scripts/hooks-system/config/project.config.json +36 -0
  288. package/scripts/hooks-system/config/state-map.json +12 -0
  289. package/scripts/hooks-system/domain/entities/AuditResult.js +139 -0
  290. package/scripts/hooks-system/domain/entities/Finding.js +116 -0
  291. package/scripts/hooks-system/domain/entities/SeverityConfig.js +73 -0
  292. package/scripts/hooks-system/domain/entities/SeverityConfig.ts +90 -0
  293. package/scripts/hooks-system/domain/entities/__tests__/AuditResult.spec.js +450 -0
  294. package/scripts/hooks-system/domain/entities/__tests__/Finding.spec.js +335 -0
  295. package/scripts/hooks-system/domain/entities/__tests__/SeverityConfig.spec.js +240 -0
  296. package/scripts/hooks-system/domain/entities/__tests__/entities.spec.js +29 -0
  297. package/scripts/hooks-system/domain/errors/__tests__/DomainErrors.spec.js +59 -0
  298. package/scripts/hooks-system/domain/errors/index.js +169 -0
  299. package/scripts/hooks-system/domain/events/__tests__/DomainEvents.spec.js +60 -0
  300. package/scripts/hooks-system/domain/events/index.js +121 -0
  301. package/scripts/hooks-system/domain/ports/IAstPort.js +67 -0
  302. package/scripts/hooks-system/domain/ports/IEvidencePort.js +86 -0
  303. package/scripts/hooks-system/domain/ports/IGitCommandPort.js +110 -0
  304. package/scripts/hooks-system/domain/ports/IGitPort.js +114 -0
  305. package/scripts/hooks-system/domain/ports/IGitQueryPort.js +93 -0
  306. package/scripts/hooks-system/domain/ports/INotificationPort.js +35 -0
  307. package/scripts/hooks-system/domain/ports/__tests__/ports.spec.js +36 -0
  308. package/scripts/hooks-system/domain/ports/index.js +14 -0
  309. package/scripts/hooks-system/domain/repositories/ICursorTokenRepository.js +13 -0
  310. package/scripts/hooks-system/domain/repositories/IFindingsRepository.js +30 -0
  311. package/scripts/hooks-system/domain/repositories/__tests__/IFindingsRepository.spec.js +18 -0
  312. package/scripts/hooks-system/domain/rules/CommitBlockingRules.js +142 -0
  313. package/scripts/hooks-system/domain/rules/__tests__/CommitBlockingRules.spec.js +18 -0
  314. package/scripts/hooks-system/domain/services/AuditAnalyzer.js +103 -0
  315. package/scripts/hooks-system/domain/services/AuditFilter.js +26 -0
  316. package/scripts/hooks-system/domain/services/AuditResultSerializer.js +35 -0
  317. package/scripts/hooks-system/domain/services/AuditScorer.js +38 -0
  318. package/scripts/hooks-system/domain/values/Severity.js +93 -0
  319. package/scripts/hooks-system/index.js +49 -0
  320. package/scripts/hooks-system/infrastructure/adapters/AstAnalyzerAdapter.js +150 -0
  321. package/scripts/hooks-system/infrastructure/adapters/FileEvidenceAdapter.js +140 -0
  322. package/scripts/hooks-system/infrastructure/adapters/GitCliAdapter.js +16 -0
  323. package/scripts/hooks-system/infrastructure/adapters/GitCommandAdapter.js +68 -0
  324. package/scripts/hooks-system/infrastructure/adapters/GitHubCliAdapter.js +85 -0
  325. package/scripts/hooks-system/infrastructure/adapters/GitQueryAdapter.js +58 -0
  326. package/scripts/hooks-system/infrastructure/adapters/LegacyAnalyzerAdapter.js +61 -0
  327. package/scripts/hooks-system/infrastructure/adapters/MacOSNotificationAdapter.js +99 -0
  328. package/scripts/hooks-system/infrastructure/adapters/__tests__/AstAnalyzerAdapter.spec.js +32 -0
  329. package/scripts/hooks-system/infrastructure/adapters/__tests__/FileEvidenceAdapter.spec.js +31 -0
  330. package/scripts/hooks-system/infrastructure/adapters/__tests__/GitCliAdapter.spec.js +39 -0
  331. package/scripts/hooks-system/infrastructure/adapters/__tests__/MacOSNotificationAdapter.spec.js +33 -0
  332. package/scripts/hooks-system/infrastructure/adapters/git/GitCommandRunner.js +78 -0
  333. package/scripts/hooks-system/infrastructure/adapters/git/GitCommandService.js +67 -0
  334. package/scripts/hooks-system/infrastructure/adapters/git/GitQueryService.js +50 -0
  335. package/scripts/hooks-system/infrastructure/adapters/index.js +14 -0
  336. package/scripts/hooks-system/infrastructure/ast/README.md +198 -0
  337. package/scripts/hooks-system/infrastructure/ast/__tests__/ast-core.spec.js +160 -0
  338. package/scripts/hooks-system/infrastructure/ast/__tests__/ast-intelligence.spec.js +20 -0
  339. package/scripts/hooks-system/infrastructure/ast/android/__tests__/ast-android.spec.js +33 -0
  340. package/scripts/hooks-system/infrastructure/ast/android/__tests__/clean-architecture-analyzer.spec.js +96 -0
  341. package/scripts/hooks-system/infrastructure/ast/android/__tests__/ddd-analyzer.spec.js +113 -0
  342. package/scripts/hooks-system/infrastructure/ast/android/__tests__/detekt-runner.spec.js +36 -0
  343. package/scripts/hooks-system/infrastructure/ast/android/__tests__/feature-first-analyzer.spec.js +80 -0
  344. package/scripts/hooks-system/infrastructure/ast/android/__tests__/native-bridge.spec.js +31 -0
  345. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidASTIntelligentAnalyzer.js +15 -0
  346. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidASTParser.js +157 -0
  347. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidAnalysisOrchestrator.js +164 -0
  348. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidArchitectureDetector.js +334 -0
  349. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidClassAnalyzer.js +162 -0
  350. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidForbiddenLiteralsAnalyzer.js +261 -0
  351. package/scripts/hooks-system/infrastructure/ast/android/analyzers/AndroidSOLIDAnalyzer.js +287 -0
  352. package/scripts/hooks-system/infrastructure/ast/android/analyzers/__tests__/AndroidForbiddenLiteralsAnalyzer.spec.js +58 -0
  353. package/scripts/hooks-system/infrastructure/ast/android/analyzers/__tests__/AndroidSOLIDAnalyzer.spec.js +84 -0
  354. package/scripts/hooks-system/infrastructure/ast/android/ast-android.js +1785 -0
  355. package/scripts/hooks-system/infrastructure/ast/android/clean-architecture-analyzer.js +115 -0
  356. package/scripts/hooks-system/infrastructure/ast/android/ddd-analyzer.js +70 -0
  357. package/scripts/hooks-system/infrastructure/ast/android/detekt-runner.js +81 -0
  358. package/scripts/hooks-system/infrastructure/ast/android/feature-first-analyzer.js +53 -0
  359. package/scripts/hooks-system/infrastructure/ast/android/native-bridge.js +119 -0
  360. package/scripts/hooks-system/infrastructure/ast/archive/README.md +18 -0
  361. package/scripts/hooks-system/infrastructure/ast/archive/ast-intelligence.ts +276 -0
  362. package/scripts/hooks-system/infrastructure/ast/archive/ios-rules.js +329 -0
  363. package/scripts/hooks-system/infrastructure/ast/archive/kotlin-analyzer.js +332 -0
  364. package/scripts/hooks-system/infrastructure/ast/archive/kotlin-parser.js +303 -0
  365. package/scripts/hooks-system/infrastructure/ast/archive/swift-analyzer.js +390 -0
  366. package/scripts/hooks-system/infrastructure/ast/ast-core.js +594 -0
  367. package/scripts/hooks-system/infrastructure/ast/ast-intelligence.js +617 -0
  368. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/ast-backend.spec.js +20 -0
  369. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/clean-architecture-analyzer.spec.js +151 -0
  370. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/ddd-analyzer.spec.js +124 -0
  371. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/feature-first-analyzer.spec.js +128 -0
  372. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/forbidden-literals-analyzer.spec.js +95 -0
  373. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/nestjs-patterns-analyzer.spec.js +59 -0
  374. package/scripts/hooks-system/infrastructure/ast/backend/__tests__/solid-analyzer.spec.js +114 -0
  375. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/BackendArchitectureDetector.js +141 -0
  376. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/BackendPatternDetector.js +23 -0
  377. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/__tests__/BackendArchitectureDetector.spec.js +239 -0
  378. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/__tests__/BackendPatternDetector.spec.js +58 -0
  379. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/detectors/CQRSDetector.js +41 -0
  380. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/detectors/CleanArchitectureDetector.js +52 -0
  381. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/detectors/FeatureFirstCleanDetector.js +74 -0
  382. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/detectors/LayeredArchitectureDetector.js +25 -0
  383. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/detectors/MVCDetector.js +32 -0
  384. package/scripts/hooks-system/infrastructure/ast/backend/analyzers/detectors/OnionArchitectureDetector.js +32 -0
  385. package/scripts/hooks-system/infrastructure/ast/backend/ast-backend-clean.js +44 -0
  386. package/scripts/hooks-system/infrastructure/ast/backend/ast-backend.js +2048 -0
  387. package/scripts/hooks-system/infrastructure/ast/backend/clean-architecture-analyzer.js +142 -0
  388. package/scripts/hooks-system/infrastructure/ast/backend/ddd-analyzer.js +256 -0
  389. package/scripts/hooks-system/infrastructure/ast/backend/feature-first-analyzer.js +70 -0
  390. package/scripts/hooks-system/infrastructure/ast/backend/forbidden-literals-analyzer.js +236 -0
  391. package/scripts/hooks-system/infrastructure/ast/backend/nestjs-patterns-analyzer.js +11 -0
  392. package/scripts/hooks-system/infrastructure/ast/backend/solid-analyzer.js +392 -0
  393. package/scripts/hooks-system/infrastructure/ast/common/BDDTDDWorkflowRules.js +52 -0
  394. package/scripts/hooks-system/infrastructure/ast/common/__tests__/BDDTDDWorkflowRules.spec.js +133 -0
  395. package/scripts/hooks-system/infrastructure/ast/common/__tests__/ast-common.spec.js +20 -0
  396. package/scripts/hooks-system/infrastructure/ast/common/__tests__/documentation-analyzer.spec.js +120 -0
  397. package/scripts/hooks-system/infrastructure/ast/common/__tests__/images-backend-analyzer.spec.js +123 -0
  398. package/scripts/hooks-system/infrastructure/ast/common/__tests__/monorepo-health-analyzer.spec.js +118 -0
  399. package/scripts/hooks-system/infrastructure/ast/common/__tests__/network-resilience-analyzer.spec.js +180 -0
  400. package/scripts/hooks-system/infrastructure/ast/common/__tests__/offline-backend-analyzer.spec.js +111 -0
  401. package/scripts/hooks-system/infrastructure/ast/common/__tests__/push-backend-analyzer.spec.js +124 -0
  402. package/scripts/hooks-system/infrastructure/ast/common/ast-common.js +345 -0
  403. package/scripts/hooks-system/infrastructure/ast/common/documentation-analyzer.js +217 -0
  404. package/scripts/hooks-system/infrastructure/ast/common/images-backend-analyzer.js +36 -0
  405. package/scripts/hooks-system/infrastructure/ast/common/monorepo-health-analyzer.js +452 -0
  406. package/scripts/hooks-system/infrastructure/ast/common/network-resilience-analyzer.js +178 -0
  407. package/scripts/hooks-system/infrastructure/ast/common/offline-backend-analyzer.js +53 -0
  408. package/scripts/hooks-system/infrastructure/ast/common/push-backend-analyzer.js +42 -0
  409. package/scripts/hooks-system/infrastructure/ast/common/rules/BDDRules.js +87 -0
  410. package/scripts/hooks-system/infrastructure/ast/common/rules/ImplementationRules.js +83 -0
  411. package/scripts/hooks-system/infrastructure/ast/common/rules/TDDRules.js +109 -0
  412. package/scripts/hooks-system/infrastructure/ast/common/rules/WorkflowRules.js +137 -0
  413. package/scripts/hooks-system/infrastructure/ast/frontend/__tests__/ast-frontend.spec.js +20 -0
  414. package/scripts/hooks-system/infrastructure/ast/frontend/analyzers/FrontendArchitectureDetector.js +289 -0
  415. package/scripts/hooks-system/infrastructure/ast/frontend/analyzers/FrontendForbiddenLiteralsAnalyzer.js +257 -0
  416. package/scripts/hooks-system/infrastructure/ast/frontend/analyzers/FrontendSOLIDAnalyzer.js +274 -0
  417. package/scripts/hooks-system/infrastructure/ast/frontend/analyzers/__tests__/FrontendArchitectureDetector.spec.js +151 -0
  418. package/scripts/hooks-system/infrastructure/ast/frontend/analyzers/__tests__/FrontendForbiddenLiteralsAnalyzer.spec.js +20 -0
  419. package/scripts/hooks-system/infrastructure/ast/frontend/analyzers/__tests__/FrontendSOLIDAnalyzer.spec.js +108 -0
  420. package/scripts/hooks-system/infrastructure/ast/frontend/ast-frontend-clean.js +42 -0
  421. package/scripts/hooks-system/infrastructure/ast/frontend/ast-frontend.js +2094 -0
  422. package/scripts/hooks-system/infrastructure/ast/frontend/clean-architecture-analyzer.js +88 -0
  423. package/scripts/hooks-system/infrastructure/ast/frontend/ddd-analyzer.js +94 -0
  424. package/scripts/hooks-system/infrastructure/ast/frontend/feature-first-analyzer.js +51 -0
  425. package/scripts/hooks-system/infrastructure/ast/ios/__tests__/ast-ios.spec.js +40 -0
  426. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSArchitectureDetector.spec.js +20 -0
  427. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSArchitectureRules.spec.js +61 -0
  428. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSCICDRules.spec.js +10 -0
  429. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSEnterpriseAnalyzer.spec.js +36 -0
  430. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSForbiddenLiteralsAnalyzer.spec.js +64 -0
  431. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSNetworkingAdvancedRules.spec.js +10 -0
  432. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSPerformanceRules.spec.js +34 -0
  433. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSSPMRules.spec.js +10 -0
  434. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/__tests__/iOSSwiftUIAdvancedRules.spec.js +10 -0
  435. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSASTIntelligentAnalyzer.js +894 -0
  436. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSArchitectureDetector.js +445 -0
  437. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSArchitectureRules.js +700 -0
  438. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSCICDRules.js +431 -0
  439. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSEnterpriseAnalyzer.js +580 -0
  440. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSForbiddenLiteralsAnalyzer.js +261 -0
  441. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSNetworkingAdvancedRules.js +177 -0
  442. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSPerformanceRules.js +11 -0
  443. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSSPMRules.js +496 -0
  444. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSSwiftUIAdvancedRules.js +333 -0
  445. package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSTestingAdvancedRules.js +225 -0
  446. package/scripts/hooks-system/infrastructure/ast/ios/ast-ios.js +2176 -0
  447. package/scripts/hooks-system/infrastructure/ast/ios/native-bridge.js +92 -0
  448. package/scripts/hooks-system/infrastructure/ast/ios/parsers/SourceKittenParser.js +471 -0
  449. package/scripts/hooks-system/infrastructure/ast/ios/parsers/__tests__/SourceKittenParser.spec.js +41 -0
  450. package/scripts/hooks-system/infrastructure/ast/text/__tests__/text-scanner.spec.js +20 -0
  451. package/scripts/hooks-system/infrastructure/ast/text/text-scanner.js +1120 -0
  452. package/scripts/hooks-system/infrastructure/cache/CacheService.js +160 -0
  453. package/scripts/hooks-system/infrastructure/cli/__tests__/install-wizard.spec.js +16 -0
  454. package/scripts/hooks-system/infrastructure/cli/install-wizard.js +74 -0
  455. package/scripts/hooks-system/infrastructure/core/GitOperations.js +50 -0
  456. package/scripts/hooks-system/infrastructure/core/GitOperations.ts +112 -0
  457. package/scripts/hooks-system/infrastructure/core/__tests__/GitOperations.spec.js +146 -0
  458. package/scripts/hooks-system/infrastructure/eslint/eslint-integration.sh +75 -0
  459. package/scripts/hooks-system/infrastructure/events/EventListeners.js +143 -0
  460. package/scripts/hooks-system/infrastructure/events/__tests__/events.spec.js +14 -0
  461. package/scripts/hooks-system/infrastructure/external-tools/GitOperations.js +54 -0
  462. package/scripts/hooks-system/infrastructure/external-tools/eslint/backend.config.template.mjs +58 -0
  463. package/scripts/hooks-system/infrastructure/git-hooks/pre-push +35 -0
  464. package/scripts/hooks-system/infrastructure/git-server/pre-receive-hook +253 -0
  465. package/scripts/hooks-system/infrastructure/guards/git-wrapper.sh +32 -0
  466. package/scripts/hooks-system/infrastructure/guards/master-validator.sh +247 -0
  467. package/scripts/hooks-system/infrastructure/guards/prevent-no-verify.sh +34 -0
  468. package/scripts/hooks-system/infrastructure/hooks/__tests__/skill-activation-prompt.spec.js +11 -0
  469. package/scripts/hooks-system/infrastructure/hooks/pre-tool-use-intelligent-enforcer.sh +489 -0
  470. package/scripts/hooks-system/infrastructure/hooks/skill-activation-prompt.js +244 -0
  471. package/scripts/hooks-system/infrastructure/logging/UnifiedLoggerFactory.js +40 -0
  472. package/scripts/hooks-system/infrastructure/logging/__tests__/logging.spec.js +9 -0
  473. package/scripts/hooks-system/infrastructure/mcp/README.md +116 -0
  474. package/scripts/hooks-system/infrastructure/mcp/__tests__/ast-intelligence-automation.spec.js +38 -0
  475. package/scripts/hooks-system/infrastructure/mcp/__tests__/evidence-watcher.spec.js +38 -0
  476. package/scripts/hooks-system/infrastructure/mcp/ast-intelligence-automation.js +1097 -0
  477. package/scripts/hooks-system/infrastructure/mcp/evidence-watcher.js +128 -0
  478. package/scripts/hooks-system/infrastructure/mcp/package.json +17 -0
  479. package/scripts/hooks-system/infrastructure/mcp/services/EvidenceService.js +87 -0
  480. package/scripts/hooks-system/infrastructure/mcp/services/McpProtocolHandler.js +166 -0
  481. package/scripts/hooks-system/infrastructure/orchestration/__tests__/intelligent-audit.spec.js +11 -0
  482. package/scripts/hooks-system/infrastructure/orchestration/intelligent-audit.js +353 -0
  483. package/scripts/hooks-system/infrastructure/patterns/pattern-checks.sh +98 -0
  484. package/scripts/hooks-system/infrastructure/reporting/ReportImpactAnalyzer.js +109 -0
  485. package/scripts/hooks-system/infrastructure/reporting/ReportMetricsCalculator.js +114 -0
  486. package/scripts/hooks-system/infrastructure/reporting/ReportPresenter.js +86 -0
  487. package/scripts/hooks-system/infrastructure/reporting/__tests__/reporting.spec.js +15 -0
  488. package/scripts/hooks-system/infrastructure/reporting/report-generator.js +130 -0
  489. package/scripts/hooks-system/infrastructure/reporting/severity-tracker.js +105 -0
  490. package/scripts/hooks-system/infrastructure/repositories/CursorTokenRepository.js +76 -0
  491. package/scripts/hooks-system/infrastructure/repositories/FileFindingsRepository.js +88 -0
  492. package/scripts/hooks-system/infrastructure/repositories/__tests__/repositories.spec.js +20 -0
  493. package/scripts/hooks-system/infrastructure/repositories/datasources/CursorApiDataSource.js +73 -0
  494. package/scripts/hooks-system/infrastructure/repositories/datasources/CursorFileDataSource.js +55 -0
  495. package/scripts/hooks-system/infrastructure/severity/__tests__/severity-evaluator.spec.js +18 -0
  496. package/scripts/hooks-system/infrastructure/severity/analyzers/__tests__/maintainability-analyzer.spec.js +170 -0
  497. package/scripts/hooks-system/infrastructure/severity/analyzers/__tests__/performance-analyzer.spec.js +186 -0
  498. package/scripts/hooks-system/infrastructure/severity/analyzers/__tests__/security-analyzer.spec.js +151 -0
  499. package/scripts/hooks-system/infrastructure/severity/analyzers/__tests__/stability-analyzer.spec.js +143 -0
  500. package/scripts/hooks-system/infrastructure/severity/analyzers/maintainability-analyzer.js +100 -0
  501. package/scripts/hooks-system/infrastructure/severity/analyzers/performance-analyzer.js +109 -0
  502. package/scripts/hooks-system/infrastructure/severity/analyzers/security-analyzer.js +104 -0
  503. package/scripts/hooks-system/infrastructure/severity/analyzers/stability-analyzer.js +85 -0
  504. package/scripts/hooks-system/infrastructure/severity/context/analyzers/CodeClassificationAnalyzer.js +71 -0
  505. package/scripts/hooks-system/infrastructure/severity/context/analyzers/DataAnalyzer.js +64 -0
  506. package/scripts/hooks-system/infrastructure/severity/context/analyzers/ImpactAnalyzer.js +68 -0
  507. package/scripts/hooks-system/infrastructure/severity/context/analyzers/SafetyAnalyzer.js +82 -0
  508. package/scripts/hooks-system/infrastructure/severity/context/context-builder.js +88 -0
  509. package/scripts/hooks-system/infrastructure/severity/generators/RecommendationGenerator.js +153 -0
  510. package/scripts/hooks-system/infrastructure/severity/mappers/SeverityMapper.js +10 -0
  511. package/scripts/hooks-system/infrastructure/severity/policies/gate-policies.js +136 -0
  512. package/scripts/hooks-system/infrastructure/severity/policies/severity-policies.json +206 -0
  513. package/scripts/hooks-system/infrastructure/severity/scorers/ContextMultiplier.js +49 -0
  514. package/scripts/hooks-system/infrastructure/severity/severity-evaluator.js +117 -0
  515. package/scripts/hooks-system/infrastructure/shell/core/constants.sh +26 -0
  516. package/scripts/hooks-system/infrastructure/shell/core/utils.sh +45 -0
  517. package/scripts/hooks-system/infrastructure/shell/gitflow/git-wrapper.sh +646 -0
  518. package/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh +620 -0
  519. package/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-state-manager.sh +235 -0
  520. package/scripts/hooks-system/infrastructure/shell/gitflow-state-manager.sh +225 -0
  521. package/scripts/hooks-system/infrastructure/shell/orchestrators/audit-orchestrator.sh +1106 -0
  522. package/scripts/hooks-system/infrastructure/shell/security/detect-secrets.sh +26 -0
  523. package/scripts/hooks-system/infrastructure/shell/security/detect_secrets.py +182 -0
  524. package/scripts/hooks-system/infrastructure/shell/validate-clean-architecture.sh +254 -0
  525. package/scripts/hooks-system/infrastructure/shell/validators/check-doc-structure.sh +62 -0
  526. package/scripts/hooks-system/infrastructure/shell/validators/ensure-critical-docs.sh +26 -0
  527. package/scripts/hooks-system/infrastructure/shell/validators/validate-ai-protocol.sh +474 -0
  528. package/scripts/hooks-system/infrastructure/shell/validators/validate-clean-architecture.sh +303 -0
  529. package/scripts/hooks-system/infrastructure/shell/validators/validate-conventional-commit.sh +42 -0
  530. package/scripts/hooks-system/infrastructure/storage/file-operations.sh +31 -0
  531. package/scripts/hooks-system/infrastructure/telemetry/TelemetryService.js +165 -0
  532. package/scripts/hooks-system/infrastructure/telemetry/__tests__/telemetry.spec.js +15 -0
  533. package/scripts/hooks-system/infrastructure/telemetry/metrics-logger.js +66 -0
  534. package/scripts/hooks-system/infrastructure/telemetry/metrics-server.js +61 -0
  535. package/scripts/hooks-system/infrastructure/utils/__tests__/utils.spec.js +8 -0
  536. package/scripts/hooks-system/infrastructure/utils/error-utils.js +28 -0
  537. package/scripts/hooks-system/infrastructure/utils/timestamp-helper.sh +106 -0
  538. package/scripts/hooks-system/infrastructure/utils/token-manager.js +121 -0
  539. package/scripts/hooks-system/infrastructure/validators/__tests__/detect-commit-language.spec.js +16 -0
  540. package/scripts/hooks-system/infrastructure/validators/__tests__/enforce-english-literals.spec.js +67 -0
  541. package/scripts/hooks-system/infrastructure/validators/detect-commit-language.js +145 -0
  542. package/scripts/hooks-system/infrastructure/validators/enforce-english-literals.js +202 -0
  543. package/scripts/hooks-system/infrastructure/watchdog/__tests__/.audit-reports/token-monitor.log +18 -0
  544. package/scripts/hooks-system/infrastructure/watchdog/__tests__/auto-recovery.spec.js +14 -0
  545. package/scripts/hooks-system/infrastructure/watchdog/__tests__/token-monitor.spec.js +67 -0
  546. package/scripts/hooks-system/infrastructure/watchdog/__tests__/watchdog.spec.js +22 -0
  547. package/scripts/hooks-system/infrastructure/watchdog/ai-watchdog.sh +278 -0
  548. package/scripts/hooks-system/infrastructure/watchdog/auto-recovery.js +32 -0
  549. package/scripts/hooks-system/infrastructure/watchdog/health-check.js +58 -0
  550. package/scripts/hooks-system/infrastructure/watchdog/token-monitor-loop.sh +20 -0
  551. package/scripts/hooks-system/infrastructure/watchdog/token-monitor.js +69 -0
  552. package/scripts/hooks-system/infrastructure/watchdog/token-tracker.sh +208 -0
  553. package/scripts/hooks-system/presentation/cli/audit.sh +32 -0
  554. package/scripts/hooks-system/presentation/cli/autonomous-status.sh +92 -0
  555. package/scripts/hooks-system/presentation/cli/categorize-violations.sh +179 -0
  556. package/scripts/hooks-system/presentation/cli/direct-audit-option2.sh +23 -0
  557. package/scripts/hooks-system/presentation/cli/direct-audit.sh +33 -0
  558. package/skills/android-guidelines/SKILL.md +475 -0
  559. package/skills/android-guidelines/resources/advanced-topics.md +44 -0
  560. package/skills/android-guidelines/resources/architecture-overview.md +44 -0
  561. package/skills/backend-guidelines/SKILL.md +335 -0
  562. package/skills/backend-guidelines/resources/architecture-overview.md +48 -0
  563. package/skills/frontend-guidelines/SKILL.md +367 -0
  564. package/skills/frontend-guidelines/resources/architecture-overview.md +44 -0
  565. package/skills/ios-guidelines/SKILL.md +406 -0
  566. package/skills/ios-guidelines/resources/architecture-overview.md +47 -0
  567. package/skills/skill-rules.json +334 -0
@@ -0,0 +1,77 @@
1
+ const { recordMetric } = require('../../infrastructure/telemetry/metrics-logger');
2
+ const HookSystemStateMachine = require('../state/HookSystemStateMachine');
3
+
4
+ class HookSystemScheduler {
5
+ constructor({ orchestrator, contextEngine, intervalMs = 30000 }) {
6
+ this.orchestrator = orchestrator;
7
+ this.contextEngine = contextEngine;
8
+ this.intervalMs = intervalMs;
9
+ this.stateMachine = new HookSystemStateMachine();
10
+ this.timer = null;
11
+ }
12
+
13
+ start() {
14
+ if (this.timer) return;
15
+ this.timer = setInterval(() => this.tick(), this.intervalMs);
16
+ }
17
+
18
+ stop() {
19
+ if (this.timer) {
20
+ clearInterval(this.timer);
21
+ this.timer = null;
22
+ }
23
+ }
24
+
25
+ async tick() {
26
+ try {
27
+ if (this.stateMachine.getState() !== 'idle') {
28
+ return;
29
+ }
30
+
31
+ if (!this.orchestrator.shouldReanalyze()) {
32
+ return;
33
+ }
34
+
35
+ this.stateMachine.transition('analyze');
36
+ const start = Date.now();
37
+
38
+ const action = await this.orchestrator.analyzeContext();
39
+ this.stateMachine.transition('decide');
40
+
41
+ await this.executeAction(action);
42
+
43
+ this.stateMachine.transition('complete');
44
+ recordMetric({
45
+ hook: 'autonomous-orchestrator',
46
+ status: 'success',
47
+ durationMs: Date.now() - start,
48
+ action,
49
+ });
50
+ } catch (error) {
51
+ this.stateMachine.transition('error');
52
+ recordMetric({
53
+ hook: 'autonomous-orchestrator',
54
+ status: 'failure',
55
+ message: error.message,
56
+ });
57
+ this.stateMachine.transition('reset');
58
+ throw error;
59
+ }
60
+ }
61
+
62
+ async executeAction(action) {
63
+ if (!action || !action.action) {
64
+ return;
65
+ }
66
+
67
+ if (action.action === 'auto-execute') {
68
+ return;
69
+ }
70
+
71
+ if (action.action === 'ask') {
72
+ return;
73
+ }
74
+ }
75
+ }
76
+
77
+ module.exports = HookSystemScheduler;
@@ -0,0 +1,151 @@
1
+ const { execSync } = require('child_process');
2
+ const path = require('path');
3
+ const fs = require('fs');
4
+ const FeatureDetector = require('./commit/FeatureDetector');
5
+ const CommitMessageGenerator = require('./commit/CommitMessageGenerator');
6
+ const UnifiedLogger = require('./logging/UnifiedLogger');
7
+
8
+ class IntelligentCommitAnalyzer {
9
+ constructor({ repoRoot = process.cwd(), logger = null } = {}) {
10
+ this.repoRoot = repoRoot;
11
+ this.logger = logger || console;
12
+ this.featureDetector = new FeatureDetector(this.logger);
13
+ this.messageGenerator = new CommitMessageGenerator(this.logger);
14
+ }
15
+
16
+ detectFeature(filePath) {
17
+ return this.featureDetector.detectFeature(filePath);
18
+ }
19
+
20
+ detectModule(filePath) {
21
+ return this.featureDetector.detectModule(filePath);
22
+ }
23
+
24
+ detectPlatform(filePath) {
25
+ return this.featureDetector.detectPlatform(filePath);
26
+ }
27
+
28
+ isTestFile(filePath) {
29
+ return this.featureDetector.isTestFile(filePath);
30
+ }
31
+
32
+ generateCommitMessage(group) {
33
+ return this.messageGenerator.generate(group);
34
+ }
35
+
36
+ /**
37
+ * Group files by feature/module using intelligent analysis
38
+ * Only groups related files - ignores unrelated/config files
39
+ */
40
+ groupFilesByFeature(files) {
41
+ this.logger.debug('ANALYZING_FILES', { count: files.length });
42
+ const groups = new Map();
43
+ const ungrouped = [];
44
+
45
+ for (const file of files) {
46
+ const feature = this.featureDetector.detectFeature(file);
47
+
48
+ if (feature === null) {
49
+ ungrouped.push(file);
50
+ continue;
51
+ }
52
+
53
+ const module = this.featureDetector.detectModule(file);
54
+ const key = `${feature}:${module}`;
55
+
56
+ if (!groups.has(key)) {
57
+ groups.set(key, {
58
+ feature,
59
+ module,
60
+ files: [],
61
+ platform: this.featureDetector.detectPlatform(file),
62
+ hasTests: false,
63
+ hasImplementation: false
64
+ });
65
+ }
66
+
67
+ const group = groups.get(key);
68
+ group.files.push(file);
69
+
70
+ if (this.featureDetector.isTestFile(file)) {
71
+ group.hasTests = true;
72
+ } else {
73
+ group.hasImplementation = true;
74
+ }
75
+ }
76
+
77
+ const result = Array.from(groups.values());
78
+ const filtered = result.filter(g => g.files.length >= 2);
79
+
80
+ this.logger.info('ANALYSIS_COMPLETE', {
81
+ totalFiles: files.length,
82
+ groupsFound: filtered.length,
83
+ ungroupedCount: ungrouped.length
84
+ });
85
+
86
+ return filtered;
87
+ }
88
+
89
+ /**
90
+ * Verify tests pass for a feature group
91
+ * DISABLED: Too expensive and prone to false positives
92
+ * Only enable when explicitly requested
93
+ */
94
+ async verifyTests(group) {
95
+ return { passed: null, reason: 'test verification disabled' };
96
+ }
97
+
98
+ /**
99
+ * Verify project builds
100
+ * DISABLED: Too expensive and prone to false positives
101
+ * Only enable when explicitly requested
102
+ */
103
+ async verifyBuild(group) {
104
+ return { built: null, reason: 'build check disabled' };
105
+ }
106
+
107
+ /**
108
+ * Analyze files and suggest atomic commits
109
+ * Only groups related files - no build/test verification
110
+ */
111
+ async analyzeAndSuggestCommits(files) {
112
+ const groups = this.groupFilesByFeature(files);
113
+ const suggestions = [];
114
+
115
+ for (const group of groups) {
116
+ if (group.files.length < 2) {
117
+ continue;
118
+ }
119
+
120
+ const suggestion = {
121
+ feature: group.feature,
122
+ module: group.module,
123
+ platform: group.platform,
124
+ files: group.files,
125
+ fileCount: group.files.length,
126
+ hasTests: group.hasTests,
127
+ commitMessage: this.messageGenerator.generate(group)
128
+ };
129
+
130
+ suggestions.push(suggestion);
131
+ }
132
+
133
+ return suggestions;
134
+ }
135
+
136
+ /**
137
+ * Get ready-to-commit groups (all groups are ready - no verification)
138
+ */
139
+ getReadyCommits(suggestions) {
140
+ return suggestions;
141
+ }
142
+
143
+ /**
144
+ * Get groups that need attention (none - we don't verify)
145
+ */
146
+ getNeedsAttention(suggestions) {
147
+ return [];
148
+ }
149
+ }
150
+
151
+ module.exports = IntelligentCommitAnalyzer;
@@ -0,0 +1,118 @@
1
+ const IntelligentCommitAnalyzer = require('./IntelligentCommitAnalyzer');
2
+ const { getGitTreeState } = require('./GitTreeState');
3
+
4
+ class IntelligentGitTreeMonitor {
5
+ constructor({
6
+ repoRoot = process.cwd(),
7
+ notifier = console,
8
+ logger = console,
9
+ autoCommitEnabled = false
10
+ } = {}) {
11
+ this.repoRoot = repoRoot;
12
+ this.notifier = notifier;
13
+ this.logger = logger;
14
+ this.autoCommitEnabled = autoCommitEnabled;
15
+ this.analyzer = new IntelligentCommitAnalyzer({ repoRoot, logger });
16
+ }
17
+
18
+ /**
19
+ * Analyze git tree and suggest intelligent actions
20
+ */
21
+ async analyze() {
22
+ const state = getGitTreeState({ repoRoot: this.repoRoot });
23
+
24
+ if (state.uniqueCount === 0) {
25
+ return { action: 'clean', message: 'Git tree is clean' };
26
+ }
27
+
28
+ const allFiles = [...state.stagedFiles, ...state.workingFiles];
29
+
30
+ const suggestions = await this.analyzer.analyzeAndSuggestCommits(allFiles);
31
+ const readyCommits = this.analyzer.getReadyCommits(suggestions);
32
+ const needsAttention = this.analyzer.getNeedsAttention(suggestions);
33
+
34
+ if (readyCommits.length > 0) {
35
+ return {
36
+ action: 'suggest_commit',
37
+ readyCommits,
38
+ message: `Found ${readyCommits.length} feature(s) ready to commit`,
39
+ suggestions: readyCommits.map(c => ({
40
+ files: c.files,
41
+ fileCount: c.fileCount || c.files.length,
42
+ message: c.commitMessage,
43
+ feature: c.feature,
44
+ module: c.module,
45
+ platform: c.platform
46
+ }))
47
+ };
48
+ }
49
+
50
+ if (suggestions.length > 10) {
51
+ return {
52
+ action: 'too_many_features',
53
+ suggestions,
54
+ message: `Found ${suggestions.length} different features/modules. Consider splitting into separate commits.`,
55
+ groups: suggestions.map(s => ({
56
+ feature: s.feature,
57
+ fileCount: s.fileCount,
58
+ files: s.files.slice(0, 3)
59
+ }))
60
+ };
61
+ }
62
+
63
+ return {
64
+ action: 'info',
65
+ suggestions,
66
+ message: `Analyzed ${state.uniqueCount} files, found ${suggestions.length} feature groups`,
67
+ groups: suggestions
68
+ };
69
+ }
70
+
71
+ /**
72
+ * Notify user with intelligent suggestions
73
+ */
74
+ async notify() {
75
+ const analysis = await this.analyze();
76
+
77
+ switch (analysis.action) {
78
+ case 'clean':
79
+ break;
80
+
81
+ case 'suggest_commit':
82
+ const featureList = analysis.suggestions
83
+ .slice(0, 3)
84
+ .map(s => {
85
+ const count = s.fileCount || (s.files ? s.files.length : 0);
86
+ return `${s.feature || 'unknown'} (${count} files)`;
87
+ })
88
+ .join(', ');
89
+ const moreText = analysis.suggestions.length > 3 ? ` +${analysis.suggestions.length - 3} more` : '';
90
+
91
+ this.notifier({
92
+ title: '📦 Atomic Commit Suggestions',
93
+ subtitle: `${analysis.readyCommits.length} feature group(s) detected`,
94
+ message: `${featureList}${moreText}`,
95
+ sound: 'Ping',
96
+ action: 'suggest_commit',
97
+ data: analysis.suggestions
98
+ });
99
+ break;
100
+
101
+ case 'too_many_features':
102
+ this.notifier({
103
+ title: '📦 Multiple Features Detected',
104
+ subtitle: `${analysis.suggestions.length} different features`,
105
+ message: 'Consider splitting into separate atomic commits',
106
+ sound: 'Submarine',
107
+ action: 'too_many_features',
108
+ data: analysis.groups
109
+ });
110
+ break;
111
+
112
+ default:
113
+ this.logger.info('Git tree analysis:', analysis);
114
+ }
115
+ }
116
+ }
117
+
118
+ module.exports = IntelligentGitTreeMonitor;
@@ -0,0 +1,173 @@
1
+ const path = require('path');
2
+ const fs = require('fs');
3
+ const PlatformHeuristics = require('./platform/PlatformHeuristics');
4
+
5
+ class PlatformAnalysisService {
6
+ constructor(platformDetector) {
7
+ this.platformDetector = platformDetector;
8
+ this.heuristics = new PlatformHeuristics(platformDetector);
9
+ }
10
+
11
+ /**
12
+ * Identifies potential platforms based on the current context
13
+ * @param {Object} context - The context object from ContextDetectionEngine
14
+ * @returns {string[]} Array of detected platform names
15
+ */
16
+ identifyPotentialPlatforms(context) {
17
+ const detectedPlatforms = new Set();
18
+
19
+ if (context.stagedFiles && context.stagedFiles.length > 0) {
20
+ context.stagedFiles.forEach(file => {
21
+ const platform = this.platformDetector.detectPlatformFromFile(file);
22
+ if (platform && platform !== 'other') {
23
+ detectedPlatforms.add(platform);
24
+ }
25
+ });
26
+ }
27
+
28
+ const platforms = this.heuristics.detectPlatforms(context);
29
+ platforms.forEach(p => detectedPlatforms.add(p));
30
+
31
+ if (context.stagedFiles && context.stagedFiles.includes('.AI_EVIDENCE.json')) {
32
+ const evidencePlatforms = this.heuristics.detectFromEvidenceFile();
33
+ evidencePlatforms.forEach(p => detectedPlatforms.add(p));
34
+ }
35
+
36
+ if (detectedPlatforms.size === 0 && context.recentFiles) {
37
+ context.recentFiles.forEach(file => {
38
+ const platform = this.platformDetector.detectPlatformFromFile(file);
39
+ if (platform && platform !== 'other') {
40
+ detectedPlatforms.add(platform);
41
+ }
42
+ });
43
+ }
44
+
45
+ return Array.from(detectedPlatforms);
46
+ }
47
+
48
+ /**
49
+ * Analyzes confidence scores for each platform
50
+ * @param {string[]} platforms - List of potential platforms
51
+ * @param {Object} context - The context object
52
+ * @returns {Object[]} Array of score objects { platform, confidence, reasons }
53
+ */
54
+ analyzeConfidence(platforms, context) {
55
+ const scores = [];
56
+
57
+ for (const platform of platforms) {
58
+ const score = this.calculatePlatformScore(platform, context);
59
+ scores.push({
60
+ platform,
61
+ confidence: score,
62
+ reasons: this.getScoreReasons(platform, context)
63
+ });
64
+ }
65
+
66
+ return scores.sort((a, b) => b.confidence - a.confidence);
67
+ }
68
+
69
+ calculatePlatformScore(platform, context) {
70
+ let score = 0;
71
+ const weights = {
72
+ stagedFilesMatch: 25,
73
+ directoryUnambiguous: 20,
74
+ extensionSpecific: 15,
75
+ branchNameMatch: 5,
76
+ recentHistoryConsistent: 5,
77
+ astSystemFiles: 30,
78
+ branchKeywords: 20,
79
+ evidenceContent: 15
80
+ };
81
+
82
+ const neutralFilenames = new Set(['.AI_EVIDENCE.json', 'README.md']);
83
+ const relevantStagedFiles = (context.stagedFiles || []).filter(file => !neutralFilenames.has(file));
84
+
85
+ if (relevantStagedFiles.length > 0) {
86
+ const matchingFiles = relevantStagedFiles.filter(file =>
87
+ this.platformDetector.detectPlatformFromFile(file) === platform
88
+ );
89
+ const matchRatio = matchingFiles.length / relevantStagedFiles.length;
90
+ score += weights.stagedFilesMatch * matchRatio;
91
+ }
92
+
93
+ const isUnambiguous = this.heuristics.isDirectoryUnambiguous(context.stagedFiles, platform);
94
+ if (isUnambiguous) {
95
+ score += weights.directoryUnambiguous;
96
+ }
97
+
98
+ const hasSpecificExtension = this.heuristics.hasSpecificExtension(context.stagedFiles, platform);
99
+ if (hasSpecificExtension) {
100
+ score += weights.extensionSpecific;
101
+ }
102
+
103
+ if (context.branchName && context.branchName.includes(platform)) {
104
+ score += weights.branchNameMatch;
105
+ }
106
+
107
+ if (context.recentCommits) {
108
+ const platformFrequency = this.heuristics.getPlatformFrequencyInHistory(platform, context.recentCommits);
109
+ if (platformFrequency > 0.7) {
110
+ score += weights.recentHistoryConsistent;
111
+ }
112
+ }
113
+
114
+ if (this.heuristics.platformDetectedInASTSystemFiles(context.stagedFiles, platform)) {
115
+ score += weights.astSystemFiles;
116
+ }
117
+
118
+ if (this.heuristics.platformDetectedInBranchKeywords(context.branchName, platform)) {
119
+ score += weights.branchKeywords;
120
+ }
121
+
122
+ if (context.stagedFiles && context.stagedFiles.includes('.AI_EVIDENCE.json')) {
123
+ const evidencePlatforms = this.heuristics.detectFromEvidenceFile();
124
+ if (evidencePlatforms.includes(platform)) {
125
+ score += weights.evidenceContent;
126
+ }
127
+ }
128
+
129
+ return Math.min(100, Math.round(score));
130
+ }
131
+
132
+ getScoreReasons(platform, context) {
133
+ const reasons = [];
134
+
135
+ if (context.stagedFiles && context.stagedFiles.length > 0) {
136
+ const matchCount = context.stagedFiles.filter(f =>
137
+ this.platformDetector.detectPlatformFromFile(f) === platform
138
+ ).length;
139
+ if (matchCount > 0) {
140
+ reasons.push(`${matchCount}/${context.stagedFiles.length} staged files match`);
141
+ }
142
+ }
143
+
144
+ if (this.heuristics.isDirectoryUnambiguous(context.stagedFiles, platform)) {
145
+ reasons.push('Directory path unambiguous');
146
+ }
147
+
148
+ if (context.branchName && context.branchName.includes(platform)) {
149
+ reasons.push(`Branch name contains '${platform}'`);
150
+ }
151
+
152
+ const astPlatforms = this.heuristics.detectFromASTSystemFiles(context.stagedFiles);
153
+ if (astPlatforms.includes(platform)) {
154
+ reasons.push('AST system files detected');
155
+ }
156
+
157
+ const branchPlatforms = this.heuristics.detectFromBranchKeywords(context.branchName);
158
+ if (branchPlatforms.includes(platform)) {
159
+ reasons.push(`Branch keywords match '${platform}'`);
160
+ }
161
+
162
+ if (context.stagedFiles && context.stagedFiles.includes('.AI_EVIDENCE.json')) {
163
+ const evidencePlatforms = this.heuristics.detectFromEvidenceFile();
164
+ if (evidencePlatforms.includes(platform)) {
165
+ reasons.push('Evidence file references platform rules');
166
+ }
167
+ }
168
+
169
+ return reasons;
170
+ }
171
+ }
172
+
173
+ module.exports = PlatformAnalysisService;
@@ -0,0 +1,168 @@
1
+
2
+ const fs = require('fs').promises;
3
+ const path = require('path');
4
+
5
+ class PlatformDetectionService {
6
+ constructor() {
7
+ this.cache = {
8
+ detections: new Map(),
9
+ timestamp: 0,
10
+ ttl: 30000
11
+ };
12
+
13
+ this.platformIndicators = {
14
+ backend: [
15
+ 'nest-cli.json',
16
+ 'tsconfig.server.json',
17
+ '/apps/backend/',
18
+ '/services/',
19
+ '/functions/',
20
+ ],
21
+ frontend: [
22
+ 'next.config.js',
23
+ 'next.config.ts',
24
+ '/apps/web-app/',
25
+ '/apps/admin-dashboard/',
26
+ '/apps/admin/',
27
+ 'package.json',
28
+ ],
29
+ ios: [
30
+ '.xcodeproj',
31
+ '.xcworkspace',
32
+ 'Podfile',
33
+ 'Package.swift',
34
+ '/apps/ios/',
35
+ '*.swift',
36
+ ],
37
+ android: [
38
+ 'build.gradle',
39
+ 'settings.gradle',
40
+ 'AndroidManifest.xml',
41
+ '/apps/android/',
42
+ '*.kt',
43
+ '*.java',
44
+ ],
45
+ };
46
+ }
47
+
48
+ async detectPlatforms(targetPath) {
49
+ const platforms = new Set();
50
+
51
+ try {
52
+ for (const [platform, indicators] of Object.entries(this.platformIndicators)) {
53
+ for (const indicator of indicators) {
54
+ if (await this.checkIndicator(targetPath, indicator)) {
55
+ platforms.add(platform);
56
+ break;
57
+ }
58
+ }
59
+ }
60
+
61
+ return Array.from(platforms);
62
+
63
+ } catch (error) {
64
+ return [];
65
+ }
66
+ }
67
+
68
+ async checkIndicator(targetPath, indicator) {
69
+ try {
70
+ if (indicator.startsWith('/')) {
71
+ const dirPath = path.join(targetPath, indicator);
72
+ const stat = await fs.stat(dirPath);
73
+ return stat.isDirectory();
74
+ } else if (indicator.includes('*')) {
75
+ const ext = indicator.replace('*', '');
76
+ return await this.hasFilesWithExtension(targetPath, ext);
77
+ } else {
78
+ const filePath = path.join(targetPath, indicator);
79
+ await fs.access(filePath);
80
+ return true;
81
+ }
82
+ } catch (error) {
83
+ return false;
84
+ }
85
+ }
86
+
87
+ async hasFilesWithExtension(targetPath, extension) {
88
+ try {
89
+ const files = await fs.readdir(targetPath);
90
+ return files.some(file => file.endsWith(extension));
91
+ } catch (error) {
92
+ return false;
93
+ }
94
+ }
95
+
96
+ detectPlatformFromFile(filePath) {
97
+ if (this.cache.detections.has(filePath)) {
98
+ const cached = this.cache.detections.get(filePath);
99
+ if (Date.now() - cached.timestamp < this.cache.ttl) {
100
+ return cached.platform;
101
+ }
102
+ }
103
+
104
+ const platform = this._detectPlatformUncached(filePath);
105
+
106
+ this.cache.detections.set(filePath, {
107
+ platform,
108
+ timestamp: Date.now()
109
+ });
110
+
111
+ return platform;
112
+ }
113
+
114
+ _detectPlatformUncached(filePath) {
115
+ const lowerPath = filePath.toLowerCase();
116
+
117
+ if (lowerPath.includes('apps/backend/') || lowerPath.includes('scripts/hooks-system/') || lowerPath.includes('/services/') || lowerPath.includes('services/') || lowerPath.includes('/functions/') || lowerPath.includes('functions/')) {
118
+ return 'backend';
119
+ }
120
+ if (lowerPath.includes('apps/web-app/') || lowerPath.includes('apps/admin')) {
121
+ return 'frontend';
122
+ }
123
+ if (lowerPath.includes('apps/ios/') || filePath.endsWith('.swift')) {
124
+ return 'ios';
125
+ }
126
+ if (lowerPath.includes('apps/android/') || filePath.endsWith('.kt') || filePath.endsWith('.java')) {
127
+ return 'android';
128
+ }
129
+
130
+ const ext = path.extname(filePath);
131
+
132
+ if (ext === '.swift') return 'ios';
133
+ if (ext === '.kt' || ext === '.java') return 'android';
134
+ if (ext === '.ts' || ext === '.tsx') {
135
+ if (lowerPath.includes('server') || lowerPath.includes('api') || lowerPath.includes('backend')) {
136
+ return 'backend';
137
+ }
138
+ return 'frontend';
139
+ }
140
+
141
+ return 'other';
142
+ }
143
+
144
+ getAmbiguityScore(filePath) {
145
+ const platform = this._detectPlatformUncached(filePath);
146
+ const lowerPath = filePath.toLowerCase();
147
+ const ext = path.extname(filePath);
148
+
149
+ if (ext === '.swift') return 0;
150
+ if (ext === '.kt' || ext === '.kts') return 0;
151
+
152
+ if (lowerPath.includes('/apps/backend/')) return 10;
153
+ if (lowerPath.includes('/apps/ios/')) return 10;
154
+ if (lowerPath.includes('/apps/android/')) return 10;
155
+
156
+ if (ext === '.ts' || ext === '.tsx') return 60;
157
+ if (ext === '.js' || ext === '.jsx') return 70;
158
+
159
+ return 100;
160
+ }
161
+
162
+ clearCache() {
163
+ this.cache.detections.clear();
164
+ this.cache.timestamp = Date.now();
165
+ }
166
+ }
167
+
168
+ module.exports = PlatformDetectionService;