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,261 @@
1
+ const { SyntaxKind } = require('../../ast-core');
2
+
3
+ const FORBIDDEN_STRING_LITERALS = [
4
+ 'unknown',
5
+ 'null',
6
+ 'undefined',
7
+ 'any',
8
+ 'void',
9
+ 'never',
10
+ ];
11
+
12
+ const FORBIDDEN_STATUS_LITERALS = [
13
+ 'active',
14
+ 'inactive',
15
+ 'pending',
16
+ 'completed',
17
+ 'failed',
18
+ 'success',
19
+ 'error',
20
+ ];
21
+
22
+ const MAGIC_NUMBERS = [0, 1];
23
+
24
+ class AndroidForbiddenLiteralsAnalyzer {
25
+ analyze(sf, findings, pushFinding) {
26
+ if (!sf || typeof sf.getFilePath !== 'function') {
27
+ return;
28
+ }
29
+ const stringLiterals = sf.getDescendantsOfKind(SyntaxKind.StringLiteral);
30
+ const numericLiterals = sf.getDescendantsOfKind(SyntaxKind.NumericLiteral);
31
+ const asExpressions = sf.getDescendantsOfKind(SyntaxKind.AsExpression);
32
+ const nullishCoalescing = sf.getDescendantsOfKind(SyntaxKind.NullishCoalescingExpression);
33
+ const conditionalExpressions = sf.getDescendantsOfKind(SyntaxKind.ConditionalExpression);
34
+ const objectLiteralExpressions = sf.getDescendantsOfKind(SyntaxKind.ObjectLiteralExpression);
35
+
36
+ this.analyzeStringLiterals(stringLiterals, sf, findings, pushFinding);
37
+ this.analyzeNumericLiterals(numericLiterals, sf, findings, pushFinding);
38
+ this.analyzeTypeCasts(asExpressions, sf, findings, pushFinding);
39
+ this.analyzeNullishCoalescing(nullishCoalescing, sf, findings, pushFinding);
40
+ this.analyzeConditionalExpressions(conditionalExpressions, sf, findings, pushFinding);
41
+ this.analyzeObjectLiterals(objectLiteralExpressions, sf, findings, pushFinding);
42
+ }
43
+
44
+ analyzeStringLiterals(stringLiterals, sf, findings, pushFinding) {
45
+ stringLiterals.forEach((literal) => {
46
+ const value = literal.getLiteralValue();
47
+ const parent = literal.getParent();
48
+
49
+ if (!parent) return;
50
+
51
+ const isInTypeDefinition = parent.getKind && (
52
+ parent.getKind() === SyntaxKind.UnionType ||
53
+ parent.getKind() === SyntaxKind.TypeLiteral ||
54
+ parent.getKind() === SyntaxKind.PropertySignature
55
+ );
56
+
57
+ if (isInTypeDefinition) return;
58
+
59
+ const isInImport = parent.getKind && (
60
+ parent.getKind() === SyntaxKind.ImportDeclaration ||
61
+ parent.getKind() === SyntaxKind.ImportSpecifier
62
+ );
63
+
64
+ if (isInImport) return;
65
+
66
+ const isInComment = parent.getKind && parent.getKind() === SyntaxKind.JSDocComment;
67
+ if (isInComment) return;
68
+
69
+ const fullText = sf.getFullText();
70
+ const literalText = literal.getText();
71
+ const literalIndex = literal.getStart();
72
+ const lineStart = fullText.lastIndexOf('\n', literalIndex) + 1;
73
+ const lineEnd = fullText.indexOf('\n', literalIndex);
74
+ const fullLine = fullText.substring(lineStart, lineEnd === -1 ? undefined : lineEnd);
75
+
76
+ const isInStringTemplate = /`[^`]*${literalText}[^`]*`/.test(fullLine);
77
+ const isInConsoleLog = /console\.(log|error|warn|info)/i.test(fullLine);
78
+ const isInTestFile = /\.(spec|test)\.(kt|java)$/i.test(sf.getFilePath());
79
+
80
+ if (isInStringTemplate || isInConsoleLog || isInTestFile) return;
81
+
82
+ if (FORBIDDEN_STRING_LITERALS.includes(value)) {
83
+ pushFinding(
84
+ 'android.types.forbidden_literal',
85
+ 'critical',
86
+ literal,
87
+ sf,
88
+ `Forbidden string literal '${value}' detected. Use enums, constants, or type-safe alternatives instead of magic strings.`,
89
+ findings
90
+ );
91
+ }
92
+
93
+ const isStatusContext = /status|state|role|type|kind|category/i.test(fullLine) &&
94
+ !/enum|const|type|interface|Record<.*Status/i.test(fullLine);
95
+
96
+ if (isStatusContext && FORBIDDEN_STATUS_LITERALS.includes(value)) {
97
+ pushFinding(
98
+ 'android.types.forbidden_status_literal',
99
+ 'high',
100
+ literal,
101
+ sf,
102
+ `Forbidden status literal '${value}' detected. Use enums or constants instead of string literals for status/state values.`,
103
+ findings
104
+ );
105
+ }
106
+ });
107
+ }
108
+
109
+ analyzeNumericLiterals(numericLiterals, sf, findings, pushFinding) {
110
+ numericLiterals.forEach((literal) => {
111
+ const value = parseFloat(literal.getText());
112
+ const parent = literal.getParent();
113
+
114
+ if (!parent) return;
115
+
116
+ const isInTypeDefinition = parent.getKind && (
117
+ parent.getKind() === SyntaxKind.UnionType ||
118
+ parent.getKind() === SyntaxKind.TypeLiteral ||
119
+ parent.getKind() === SyntaxKind.PropertySignature
120
+ );
121
+
122
+ if (isInTypeDefinition) return;
123
+
124
+ const fullText = sf.getFullText();
125
+ const literalIndex = literal.getStart();
126
+ const lineStart = fullText.lastIndexOf('\n', literalIndex) + 1;
127
+ const lineEnd = fullText.indexOf('\n', literalIndex);
128
+ const fullLine = fullText.substring(lineStart, lineEnd === -1 ? undefined : lineEnd);
129
+
130
+ const isInArrayIndex = /\[\s*\d+\s*\]/.test(fullLine);
131
+ const isInTestFile = /\.(spec|test)\.(kt|java)$/i.test(sf.getFilePath());
132
+ const isInEnumValue = /=\s*\d+/.test(fullLine) && /enum/.test(fullText.substring(0, literalIndex));
133
+
134
+ if (isInArrayIndex || isInTestFile || isInEnumValue) return;
135
+
136
+ if (MAGIC_NUMBERS.includes(value) && !isInEnumValue) {
137
+ const context = fullLine.trim();
138
+ const isIncrement = /\+\+\s*$|=\s*\w+\s*\+\s*1|=\s*\w+\s*\+\s*\d+\s*\+/.test(context);
139
+ const isInitialization = /=\s*0\s*[,;]/.test(context);
140
+
141
+ if (isIncrement || isInitialization) {
142
+ pushFinding(
143
+ 'android.types.magic_number',
144
+ 'high',
145
+ literal,
146
+ sf,
147
+ `Magic number ${value} detected. Use named constants (e.g., INITIAL_COUNT, INCREMENT_VALUE) instead of magic numbers.`,
148
+ findings
149
+ );
150
+ }
151
+ }
152
+ });
153
+ }
154
+
155
+ analyzeTypeCasts(asExpressions, sf, findings, pushFinding) {
156
+ if (!sf || typeof sf.getFilePath !== 'function') return;
157
+ asExpressions.forEach((expr) => {
158
+ const fullText = sf.getFullText();
159
+ const exprIndex = expr.getStart();
160
+ const lineStart = fullText.lastIndexOf('\n', exprIndex) + 1;
161
+ const lineEnd = fullText.indexOf('\n', exprIndex);
162
+ const fullLine = fullText.substring(lineStart, lineEnd === -1 ? undefined : lineEnd);
163
+
164
+ const isInTestFile = /\.(spec|test)\.(kt|java)$/i.test(sf.getFilePath());
165
+ const isTypeAssertion = /as\s+(UserRole|OrderStatus|UserStatus|AlertStatus)/i.test(fullLine);
166
+
167
+ if (isInTestFile || isTypeAssertion) return;
168
+
169
+ pushFinding(
170
+ 'android.types.forbidden_type_cast',
171
+ 'high',
172
+ sf,
173
+ expr,
174
+ `Type casting with 'as' detected. Use type guards, mappers, or proper type narrowing instead of type assertions.`,
175
+ findings
176
+ );
177
+ });
178
+ }
179
+
180
+ analyzeNullishCoalescing(nullishCoalescing, sf, findings, pushFinding) {
181
+ nullishCoalescing.forEach((expr) => {
182
+ const fullText = sf.getFullText();
183
+ const exprIndex = expr.getStart();
184
+ const lineStart = fullText.lastIndexOf('\n', exprIndex) + 1;
185
+ const lineEnd = fullText.indexOf('\n', exprIndex);
186
+ const fullLine = fullText.substring(lineStart, lineEnd === -1 ? undefined : lineEnd);
187
+
188
+ const isInTestFile = /\.(spec|test)\.(kt|java)$/i.test(sf.getFilePath());
189
+ const hasNull = /null/.test(fullLine);
190
+ const hasUndefined = /undefined/.test(fullLine);
191
+
192
+ if (isInTestFile) return;
193
+
194
+ if (hasNull || hasUndefined) {
195
+ pushFinding(
196
+ 'android.types.forbidden_nullish_coalescing',
197
+ 'critical',
198
+ expr,
199
+ sf,
200
+ `Nullish coalescing with null/undefined detected. Use optional properties (name?: String) instead of nullable types (name: String?). Eliminate null/undefined from codebase.`,
201
+ findings
202
+ );
203
+ }
204
+ });
205
+ }
206
+
207
+ analyzeConditionalExpressions(conditionalExpressions, sf, findings, pushFinding) {
208
+ conditionalExpressions.forEach((expr) => {
209
+ const fullText = sf.getFullText();
210
+ const exprIndex = expr.getStart();
211
+ const lineStart = fullText.lastIndexOf('\n', exprIndex) + 1;
212
+ const lineEnd = fullText.indexOf('\n', exprIndex);
213
+ const fullLine = fullText.substring(lineStart, lineEnd === -1 ? undefined : lineEnd);
214
+
215
+ const isInTestFile = /\.(spec|test)\.(kt|java)$/i.test(sf.getFilePath());
216
+ const hasNull = /\?\s*null\s*:/.test(fullLine);
217
+ const hasUndefined = /\?\s*undefined\s*:/.test(fullLine);
218
+
219
+ if (isInTestFile) return;
220
+
221
+ if (hasNull || hasUndefined) {
222
+ pushFinding(
223
+ 'android.types.forbidden_ternary_null_undefined',
224
+ 'critical',
225
+ expr,
226
+ sf,
227
+ `Ternary operator with null detected. Use optional properties (prop: String?) and conditional spread pattern. Only include properties when they have values. Use data class with optional parameters.`,
228
+ findings
229
+ );
230
+ }
231
+ });
232
+ }
233
+
234
+ analyzeObjectLiterals(objectLiteralExpressions, sf, findings, pushFinding) {
235
+ objectLiteralExpressions.forEach((obj) => {
236
+ const fullText = sf.getFullText();
237
+ const objIndex = obj.getStart();
238
+ const lineStart = fullText.lastIndexOf('\n', objIndex) + 1;
239
+ const lineEnd = fullText.indexOf('\n', objIndex);
240
+ const fullLine = fullText.substring(lineStart, lineEnd === -1 ? undefined : lineEnd);
241
+
242
+ const isInTestFile = /\.(spec|test)\.(kt|java)$/i.test(sf.getFilePath());
243
+ const hasNullAssignment = /:\s*null/.test(fullLine);
244
+
245
+ if (isInTestFile) return;
246
+
247
+ if (hasNullAssignment) {
248
+ pushFinding(
249
+ 'android.types.forbidden_null_assignment',
250
+ 'critical',
251
+ obj,
252
+ sf,
253
+ `Direct null assignment in object detected. Use optional properties and conditional spread pattern. Only include properties when they have values. Use data class with optional parameters (prop: String?).`,
254
+ findings
255
+ );
256
+ }
257
+ });
258
+ }
259
+ }
260
+
261
+ module.exports = { AndroidForbiddenLiteralsAnalyzer };
@@ -0,0 +1,287 @@
1
+
2
+ const path = require('path');
3
+ const { pushFinding, SyntaxKind } = require(path.join(__dirname, '../../ast-core'));
4
+
5
+ /**
6
+ * AndroidSOLIDAnalyzer
7
+ * Enterprise-grade SOLID principles analyzer for Android/Kotlin
8
+ * Uses TypeScript AST (ts-morph) for dynamic node-based analysis
9
+ *
10
+ * @class AndroidSOLIDAnalyzer
11
+ */
12
+ class AndroidSOLIDAnalyzer {
13
+ constructor() {
14
+ this.findings = [];
15
+ }
16
+
17
+ /**
18
+ * Analyze source file for SOLID violations
19
+ * @param {SourceFile} sf - TypeScript morph source file
20
+ * @param {Array} findings - Global findings array
21
+ * @param {Function} pushFinding - Push finding function
22
+ */
23
+ analyze(sf, findings, pushFinding) {
24
+ if (!sf || typeof sf.getFilePath !== 'function') {
25
+ return;
26
+ }
27
+ this.findings = findings;
28
+ this.pushFinding = pushFinding;
29
+
30
+ this.analyzeOCP(sf);
31
+ this.analyzeDIP(sf);
32
+ this.analyzeSRP(sf);
33
+ this.analyzeISP(sf);
34
+ }
35
+
36
+
37
+ analyzeOCP(sf) {
38
+ const filePath = sf.getFilePath();
39
+ const fileName = filePath.split('/').pop() || 'unknown';
40
+
41
+ const functions = sf.getFunctions();
42
+ const arrowFunctions = sf.getVariableDeclarations().filter(vd => {
43
+ const init = vd.getInitializer();
44
+ return init && init.getKind() === SyntaxKind.ArrowFunction;
45
+ });
46
+
47
+ const classes = sf.getClasses();
48
+
49
+ const allNodes = [
50
+ ...functions.map(f => ({ type: 'function', node: f, name: f.getName() || 'anonymous' })),
51
+ ...arrowFunctions.map(af => ({ type: 'arrow', node: af, name: af.getName() || 'anonymous' })),
52
+ ...classes.map(c => ({ type: 'class', node: c, name: c.getName() || 'AnonymousClass' })),
53
+ ];
54
+
55
+ allNodes.forEach(({ type, node, name }) => {
56
+ this.analyzeNodeForOCP(node, name, fileName, sf);
57
+ });
58
+ }
59
+
60
+ analyzeNodeForOCP(node, nodeName, fileName, sf) {
61
+ let body;
62
+
63
+ if (node.getKind() === SyntaxKind.FunctionDeclaration ||
64
+ node.getKind() === SyntaxKind.FunctionExpression) {
65
+ body = node.getBody();
66
+ } else if (node.getKind() === SyntaxKind.VariableDeclaration) {
67
+ const init = node.getInitializer();
68
+ if (init && init.getKind() === SyntaxKind.ArrowFunction) {
69
+ body = init.getBody();
70
+ }
71
+ } else if (node.getKind() === SyntaxKind.ClassDeclaration) {
72
+ const methods = node.getMethods();
73
+ methods.forEach(method => {
74
+ const methodBody = method.getBody();
75
+ if (methodBody) {
76
+ this.analyzeBodyForOCP(methodBody, `${nodeName}.${method.getName()}`, fileName, sf);
77
+ }
78
+ });
79
+ return;
80
+ } else {
81
+ return;
82
+ }
83
+
84
+ if (!body) return;
85
+ this.analyzeBodyForOCP(body, nodeName, fileName, sf);
86
+ }
87
+
88
+ analyzeBodyForOCP(body, nodeName, fileName, sf) {
89
+ const switches = body.getDescendantsOfKind(SyntaxKind.SwitchStatement);
90
+
91
+ switches.forEach(switchStmt => {
92
+ const switchExpr = switchStmt.getExpression();
93
+ const exprText = switchExpr.getText();
94
+ const cases = switchStmt.getCaseClauses();
95
+
96
+ if (cases.length >= 3) {
97
+ const isDomainValue = /status|type|priority|role|kind|category|state|mode/i.test(exprText);
98
+
99
+ if (isDomainValue) {
100
+ const message = `OCP VIOLATION in ${fileName}::${nodeName}: switch on '${exprText}' with ${cases.length} cases - use Strategy/Map pattern with centralized constants`;
101
+ this.pushFinding('solid.ocp.switch_statement', 'critical', sf, switchStmt, message, this.findings);
102
+ } else if (cases.length >= 5) {
103
+ const message = `OCP VIOLATION in ${fileName}::${nodeName}: large switch (${cases.length} cases) on '${exprText}' - consider Strategy/Factory pattern`;
104
+ this.pushFinding('solid.ocp.switch_statement', 'high', sf, switchStmt, message, this.findings);
105
+ }
106
+ }
107
+ });
108
+
109
+ const ifStatements = body.getDescendantsOfKind(SyntaxKind.IfStatement);
110
+ const typeIfChains = this.detectTypeIfChains(ifStatements);
111
+
112
+ if (typeIfChains.length >= 3) {
113
+ const chainVars = new Set(typeIfChains.map(chain => chain.variable));
114
+ if (chainVars.size === 1) {
115
+ const varName = Array.from(chainVars)[0];
116
+ const message = `OCP VIOLATION in ${fileName}::${nodeName}: ${typeIfChains.length} if-else checking '${varName}' - use Strategy pattern or polymorphism`;
117
+ this.pushFinding('solid.ocp.if_type_chain', 'critical', sf, typeIfChains[0].node, message, this.findings);
118
+ }
119
+ }
120
+
121
+ switches.forEach(switchStmt => {
122
+ const nestedSwitches = switchStmt.getDescendantsOfKind(SyntaxKind.SwitchStatement);
123
+ if (nestedSwitches.length > 0) {
124
+ const message = `OCP VIOLATION in ${fileName}::${nodeName}: nested switch statements - use Strategy/Map pattern with composition`;
125
+ this.pushFinding('solid.ocp.nested_switch', 'critical', sf, switchStmt, message, this.findings);
126
+ }
127
+ });
128
+ }
129
+
130
+ detectTypeIfChains(ifStatements) {
131
+ const chains = [];
132
+
133
+ ifStatements.forEach(ifStmt => {
134
+ const condition = ifStmt.getExpression();
135
+ const conditionText = condition.getText();
136
+
137
+ const typeCheckPattern = /(\w+)\s*(===|==|!==|!=)\s*['"]([\w\s]+)['"]|typeof\s+(\w+)|(\w+)\s+instanceof/i;
138
+ const match = conditionText.match(typeCheckPattern);
139
+
140
+ if (match) {
141
+ const variable = match[1] || match[4] || match[5];
142
+ chains.push({ variable, node: ifStmt });
143
+ }
144
+ });
145
+
146
+ return chains;
147
+ }
148
+
149
+
150
+ analyzeDIP(sf) {
151
+ const filePath = sf.getFilePath();
152
+ const fileName = filePath.split('/').pop() || 'unknown';
153
+
154
+ const isDomain = /\/domain\//i.test(filePath);
155
+
156
+ if (isDomain) {
157
+ const imports = sf.getImportDeclarations();
158
+
159
+ imports.forEach(imp => {
160
+ const importPath = imp.getModuleSpecifierValue();
161
+
162
+ if (/\/infrastructure\//i.test(importPath) ||
163
+ /androidx|kotlinx|retrofit|room|hilt/i.test(importPath)) {
164
+ const message = `DIP VIOLATION in ${fileName}: Domain layer importing from Infrastructure/Framework: ${importPath} - Domain should depend only on abstractions`;
165
+ this.pushFinding('solid.dip.domain_depends_infrastructure', 'critical', sf, imp, message, this.findings);
166
+ }
167
+ });
168
+ }
169
+
170
+ const isPresentation = /\/presentation\//i.test(filePath);
171
+
172
+ if (isPresentation) {
173
+ const imports = sf.getImportDeclarations();
174
+
175
+ imports.forEach(imp => {
176
+ const importPath = imp.getModuleSpecifierValue();
177
+
178
+ if (/\/infrastructure\//i.test(importPath) &&
179
+ !/\/infrastructure\/repositories\/|\/infrastructure\/config\//i.test(importPath)) {
180
+ const message = `DIP VIOLATION in ${fileName}: Presentation layer importing from Infrastructure: ${importPath} - use repository interfaces or abstractions`;
181
+ this.pushFinding('solid.dip.presentation_infrastructure', 'critical', sf, imp, message, this.findings);
182
+ }
183
+ });
184
+ }
185
+
186
+ const classes = sf.getClasses();
187
+ classes.forEach(cls => {
188
+ const className = cls.getName() || 'AnonymousClass';
189
+
190
+ if (/ViewModel|UseCase/i.test(className)) {
191
+ const imports = sf.getImportDeclarations();
192
+
193
+ imports.forEach(imp => {
194
+ const importPath = imp.getModuleSpecifierValue();
195
+
196
+ if (/Repository|Service|Client/i.test(importPath) &&
197
+ !/interface|protocol|Repository.*Protocol/i.test(importPath)) {
198
+ const message = `DIP VIOLATION in ${fileName}::${className}: depends on concrete implementation '${importPath}' - inject interface/abstraction`;
199
+ this.pushFinding('solid.dip.concrete_dependency', 'critical', sf, imp, message, this.findings);
200
+ }
201
+ });
202
+ }
203
+ });
204
+ }
205
+
206
+
207
+ analyzeSRP(sf) {
208
+ const filePath = sf.getFilePath();
209
+ const fileName = filePath.split('/').pop() || 'unknown';
210
+
211
+ const functions = sf.getFunctions();
212
+ const arrowFunctions = sf.getVariableDeclarations().filter(vd => {
213
+ const init = vd.getInitializer();
214
+ return init && init.getKind() === SyntaxKind.ArrowFunction;
215
+ });
216
+
217
+ [...functions, ...arrowFunctions].forEach(func => {
218
+ const funcName = func.getName?.() || 'anonymous';
219
+ const body = func.getBody?.() || func.getInitializer()?.getBody();
220
+
221
+ if (!body) return;
222
+
223
+ const statements = body.getStatements();
224
+ const ifStatements = body.getDescendantsOfKind(SyntaxKind.IfStatement);
225
+ const switchStatements = body.getDescendantsOfKind(SyntaxKind.SwitchStatement);
226
+ const loops = body.getDescendantsOfKind(SyntaxKind.ForStatement)
227
+ .concat(body.getDescendantsOfKind(SyntaxKind.ForInStatement))
228
+ .concat(body.getDescendantsOfKind(SyntaxKind.WhileStatement));
229
+
230
+ if (statements.length > 30 || ifStatements.length > 10 || switchStatements.length > 2 || loops.length > 5) {
231
+ const message = `SRP VIOLATION in ${fileName}::${funcName}: high complexity (${statements.length} statements, ${ifStatements.length} ifs, ${switchStatements.length} switches) - extract responsibilities`;
232
+ this.pushFinding('solid.srp.high_complexity', 'critical', sf, func, message, this.findings);
233
+ }
234
+ });
235
+
236
+ const classes = sf.getClasses();
237
+ classes.forEach(cls => {
238
+ const className = cls.getName() || 'AnonymousClass';
239
+ const methods = cls.getMethods();
240
+
241
+ if (methods.length > 20) {
242
+ const message = `SRP VIOLATION in ${fileName}::${className}: God class with ${methods.length} methods - split into focused classes`;
243
+ this.pushFinding('solid.srp.god_class', 'critical', sf, cls, message, this.findings);
244
+ }
245
+ });
246
+ }
247
+
248
+
249
+ analyzeISP(sf) {
250
+ const interfaces = sf.getInterfaces();
251
+
252
+ interfaces.forEach(iface => {
253
+ const interfaceName = iface.getName();
254
+ const properties = iface.getProperties();
255
+ const methods = iface.getMethods();
256
+
257
+ if (properties.length > 10) {
258
+ const message = `ISP VIOLATION: ${interfaceName} has ${properties.length} properties - split into focused interfaces`;
259
+ this.pushFinding('solid.isp.fat_interface', 'critical', sf, iface, message, this.findings);
260
+ }
261
+
262
+ if (methods.length > 0) {
263
+ const methodConcerns = methods.map(m => this.detectMethodConcern(m.getName()));
264
+ const uniqueConcerns = new Set(methodConcerns.filter(c => c !== 'unknown'));
265
+
266
+ if (uniqueConcerns.size >= 3) {
267
+ const message = `ISP VIOLATION: ${interfaceName} mixes ${uniqueConcerns.size} concerns (${Array.from(uniqueConcerns).join(', ')}) - segregate into focused interfaces`;
268
+ this.pushFinding('solid.isp.multiple_concerns', 'critical', sf, iface, message, this.findings);
269
+ }
270
+ }
271
+ });
272
+ }
273
+
274
+ detectMethodConcern(methodName) {
275
+ const name = methodName.toLowerCase();
276
+
277
+ if (/get|fetch|load|read|find|query/i.test(name)) return 'data-access';
278
+ if (/set|save|create|update|delete|remove/i.test(name)) return 'data-mutation';
279
+ if (/validate|check|verify/i.test(name)) return 'validation';
280
+ if (/format|parse|transform/i.test(name)) return 'transformation';
281
+ if (/render|display|show/i.test(name)) return 'rendering';
282
+
283
+ return 'unknown';
284
+ }
285
+ }
286
+
287
+ module.exports = { AndroidSOLIDAnalyzer };
@@ -0,0 +1,58 @@
1
+ const { AndroidForbiddenLiteralsAnalyzer } = require('../AndroidForbiddenLiteralsAnalyzer');
2
+
3
+ describe('AndroidForbiddenLiteralsAnalyzer', () => {
4
+ let analyzer;
5
+
6
+ beforeEach(() => {
7
+ analyzer = new AndroidForbiddenLiteralsAnalyzer();
8
+ });
9
+
10
+ describe('analyze', () => {
11
+ it('should be a method', () => {
12
+ expect(typeof analyzer.analyze).toBe('function');
13
+ });
14
+ });
15
+
16
+ describe('analyzeStringLiterals', () => {
17
+ it('should be a method', () => {
18
+ expect(typeof analyzer.analyzeStringLiterals).toBe('function');
19
+ });
20
+ });
21
+
22
+ describe('analyzeNumericLiterals', () => {
23
+ it('should be a method', () => {
24
+ expect(typeof analyzer.analyzeNumericLiterals).toBe('function');
25
+ });
26
+ });
27
+
28
+ describe('analyzeTypeCasts', () => {
29
+ it('should be a method', () => {
30
+ expect(typeof analyzer.analyzeTypeCasts).toBe('function');
31
+ });
32
+ });
33
+
34
+ describe('analyzeNullishCoalescing', () => {
35
+ it('should be a method', () => {
36
+ expect(typeof analyzer.analyzeNullishCoalescing).toBe('function');
37
+ });
38
+ });
39
+
40
+ describe('analyzeConditionalExpressions', () => {
41
+ it('should be a method', () => {
42
+ expect(typeof analyzer.analyzeConditionalExpressions).toBe('function');
43
+ });
44
+ });
45
+
46
+ describe('analyzeObjectLiterals', () => {
47
+ it('should be a method', () => {
48
+ expect(typeof analyzer.analyzeObjectLiterals).toBe('function');
49
+ });
50
+ });
51
+
52
+ describe('exports', () => {
53
+ it('should export AndroidForbiddenLiteralsAnalyzer', () => {
54
+ const mod = require('../AndroidForbiddenLiteralsAnalyzer');
55
+ expect(mod.AndroidForbiddenLiteralsAnalyzer).toBeDefined();
56
+ });
57
+ });
58
+ });
@@ -0,0 +1,84 @@
1
+ const { AndroidSOLIDAnalyzer } = require('../AndroidSOLIDAnalyzer');
2
+
3
+ describe('AndroidSOLIDAnalyzer', () => {
4
+ let analyzer;
5
+
6
+ beforeEach(() => {
7
+ analyzer = new AndroidSOLIDAnalyzer();
8
+ });
9
+
10
+ describe('constructor', () => {
11
+ it('should create instance', () => {
12
+ expect(analyzer).toBeInstanceOf(AndroidSOLIDAnalyzer);
13
+ });
14
+
15
+ it('should initialize findings array', () => {
16
+ expect(analyzer.findings).toEqual([]);
17
+ });
18
+ });
19
+
20
+ describe('analyze', () => {
21
+ it('should be a method', () => {
22
+ expect(typeof analyzer.analyze).toBe('function');
23
+ });
24
+ });
25
+
26
+ describe('analyzeOCP', () => {
27
+ it('should be a method', () => {
28
+ expect(typeof analyzer.analyzeOCP).toBe('function');
29
+ });
30
+ });
31
+
32
+ describe('analyzeDIP', () => {
33
+ it('should be a method', () => {
34
+ expect(typeof analyzer.analyzeDIP).toBe('function');
35
+ });
36
+ });
37
+
38
+ describe('analyzeSRP', () => {
39
+ it('should be a method', () => {
40
+ expect(typeof analyzer.analyzeSRP).toBe('function');
41
+ });
42
+ });
43
+
44
+ describe('analyzeISP', () => {
45
+ it('should be a method', () => {
46
+ expect(typeof analyzer.analyzeISP).toBe('function');
47
+ });
48
+ });
49
+
50
+ describe('detectMethodConcern', () => {
51
+ it('should detect data-access concern', () => {
52
+ expect(analyzer.detectMethodConcern('getUser')).toBe('data-access');
53
+ expect(analyzer.detectMethodConcern('fetchData')).toBe('data-access');
54
+ });
55
+
56
+ it('should detect data-mutation concern', () => {
57
+ expect(analyzer.detectMethodConcern('setUser')).toBe('data-mutation');
58
+ expect(analyzer.detectMethodConcern('deleteItem')).toBe('data-mutation');
59
+ });
60
+
61
+ it('should detect validation concern', () => {
62
+ expect(analyzer.detectMethodConcern('validateEmail')).toBe('validation');
63
+ });
64
+
65
+ it('should detect transformation concern', () => {
66
+ expect(analyzer.detectMethodConcern('formatDate')).toBe('transformation');
67
+ });
68
+
69
+ it('should detect rendering concern', () => {
70
+ expect(analyzer.detectMethodConcern('renderItem')).toBe('rendering');
71
+ });
72
+
73
+ it('should return unknown for unrecognized methods', () => {
74
+ expect(analyzer.detectMethodConcern('doSomething')).toBe('unknown');
75
+ });
76
+ });
77
+
78
+ describe('exports', () => {
79
+ it('should export AndroidSOLIDAnalyzer', () => {
80
+ const mod = require('../AndroidSOLIDAnalyzer');
81
+ expect(mod.AndroidSOLIDAnalyzer).toBeDefined();
82
+ });
83
+ });
84
+ });