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,580 @@
1
+ const path = require('path');
2
+ const fs = require('fs').promises;
3
+ const { SourceKittenParser } = require('../parsers/SourceKittenParser');
4
+ const { pushFinding, mapToLevel } = require(path.join(__dirname, '../../ast-core'));
5
+
6
+ class iOSEnterpriseAnalyzer {
7
+ constructor() {
8
+ this.parser = new SourceKittenParser();
9
+ this.findings = [];
10
+ }
11
+
12
+ async analyzeFile(filePath, findings) {
13
+ this.findings = findings;
14
+
15
+ try {
16
+ const ast = await this.parser.parseFile(filePath);
17
+
18
+ if (!ast.parsed) {
19
+ console.warn(`[iOS Enterprise] Could not parse ${filePath}: ${ast.error}`);
20
+ return;
21
+ }
22
+
23
+ const content = await fs.readFile(filePath, 'utf-8');
24
+
25
+ const classes = this.parser.extractClasses(ast);
26
+ const functions = this.parser.extractFunctions(ast);
27
+ const properties = this.parser.extractProperties(ast);
28
+ const protocols = this.parser.extractProtocols(ast);
29
+
30
+ await this.analyzeSwiftModerno(ast, content, filePath);
31
+ await this.analyzeSwiftUI(ast, classes, filePath);
32
+ await this.analyzeUIKit(ast, classes, filePath);
33
+ await this.analyzeProtocolOriented(protocols, filePath);
34
+ await this.analyzeValueTypes(classes, filePath);
35
+ await this.analyzeMemoryManagement(content, filePath);
36
+ await this.analyzeOptionals(content, filePath);
37
+ await this.analyzeDependencyInjection(classes, filePath);
38
+ await this.analyzeNetworking(content, filePath);
39
+ await this.analyzePersistence(content, filePath);
40
+ await this.analyzeCombine(content, filePath);
41
+ await this.analyzeConcurrency(content, filePath);
42
+ await this.analyzeTesting(content, filePath);
43
+ await this.analyzeUITesting(content, filePath);
44
+ await this.analyzeSecurity(content, filePath);
45
+ await this.analyzeAccessibility(content, filePath);
46
+ await this.analyzeLocalization(content, filePath);
47
+ await this.analyzeArchitecturePatterns(classes, functions, filePath);
48
+ await this.analyzePerformance(functions, content, filePath);
49
+ await this.analyzeCodeOrganization(filePath, content);
50
+
51
+ } catch (error) {
52
+ console.error(`[iOS Enterprise] Error analyzing ${filePath}:`, error.message);
53
+ }
54
+ }
55
+
56
+ async analyzeSwiftModerno(ast, content, filePath) {
57
+ if (content.includes('completion:') && !content.includes('async ')) {
58
+ this.addFinding('ios.async_await_missing', 'medium', filePath, 1,
59
+ 'Using completion handlers instead of async/await (Swift 5.9+ required)');
60
+ }
61
+
62
+ const taskCount = (content.match(/\bTask\s*\{/g) || []).length;
63
+ if (taskCount > 3 && !content.includes('TaskGroup')) {
64
+ this.addFinding('ios.structured_concurrency_missing', 'medium', filePath, 1,
65
+ `Multiple Task blocks (${taskCount}) without TaskGroup - use structured concurrency`);
66
+ }
67
+
68
+ if (content.includes('actor ') && !content.includes(': Sendable')) {
69
+ this.addFinding('ios.sendable_missing', 'low', filePath, 1,
70
+ 'Actor should conform to Sendable protocol for thread-safe types');
71
+ }
72
+
73
+ if (content.includes('func ') && content.includes('-> View') && !content.includes('some View')) {
74
+ this.addFinding('ios.opaque_types_missing', 'low', filePath, 1,
75
+ 'Use "some View" instead of explicit View protocol return');
76
+ }
77
+
78
+ if (content.includes('UIViewController') && !content.includes('@State') && !content.includes('@Binding')) {
79
+ this.addFinding('ios.property_wrappers_missing', 'info', filePath, 1,
80
+ 'Consider using SwiftUI property wrappers (@State, @Binding) for state management');
81
+ }
82
+
83
+ const functions = this.parser.extractFunctions(ast);
84
+ functions.forEach(fn => {
85
+ if (fn.name.includes('Array') || fn.name.includes('Collection')) {
86
+ if (!content.includes('<T>') && !content.includes('<Element>')) {
87
+ this.addFinding('ios.generics_missing', 'low', filePath, fn.line,
88
+ `Function ${fn.name} should use generics for type safety`);
89
+ }
90
+ }
91
+ });
92
+ }
93
+
94
+ async analyzeSwiftUI(ast, classes, filePath) {
95
+ const content = await fs.readFile(filePath, 'utf-8');
96
+ const usesSwiftUI = this.parser.usesSwiftUI(ast);
97
+ const usesUIKit = this.parser.usesUIKit(ast);
98
+
99
+ if (usesUIKit && !usesSwiftUI) {
100
+ this.addFinding('ios.swiftui_first', 'medium', filePath, 1,
101
+ 'Consider migrating to SwiftUI for new views (UIKit only when strictly necessary)');
102
+ }
103
+
104
+ if (usesSwiftUI) {
105
+ if (!content.includes('@State')) {
106
+ this.addFinding('ios.state_local_missing', 'info', filePath, 1,
107
+ 'SwiftUI view without @State - consider if local state is needed');
108
+ }
109
+
110
+ if (content.includes('ObservableObject') && !content.includes('@StateObject')) {
111
+ this.addFinding('ios.stateobject_missing', 'high', filePath, 1,
112
+ 'ObservableObject should be owned with @StateObject, not @ObservedObject');
113
+ }
114
+
115
+ if (content.includes('class') && content.includes('ObservableObject') && !content.includes('@EnvironmentObject')) {
116
+ this.addFinding('ios.environmentobject_missing', 'info', filePath, 1,
117
+ 'Consider using @EnvironmentObject for dependency injection in SwiftUI');
118
+ }
119
+
120
+ if (content.includes('.frame(') && content.includes('CGRect(')) {
121
+ this.addFinding('ios.declarativo_missing', 'medium', filePath, 1,
122
+ 'Using imperative CGRect in SwiftUI - use declarative .frame() modifiers');
123
+ }
124
+
125
+ const geometryReaderCount = (content.match(/GeometryReader/g) || []).length;
126
+ if (geometryReaderCount > 2) {
127
+ this.addFinding('ios.geometryreader_moderation', 'medium', filePath, 1,
128
+ `Excessive GeometryReader usage (${geometryReaderCount}x) - use only when necessary`);
129
+ }
130
+ }
131
+ }
132
+
133
+ async analyzeUIKit(ast, classes, filePath) {
134
+ const content = await fs.readFile(filePath, 'utf-8');
135
+
136
+ classes.forEach(cls => {
137
+ if (cls.name.includes('ViewController')) {
138
+ const linesCount = cls.substructure.length * 10;
139
+ if (linesCount > 300) {
140
+ this.addFinding('ios.massive_viewcontrollers', 'high', filePath, cls.line,
141
+ `Massive ViewController ${cls.name} (~${linesCount} lines) - break down into smaller components`);
142
+ }
143
+
144
+ if (!content.includes('ViewModel')) {
145
+ this.addFinding('ios.uikit.viewmodel_delegation', 'medium', filePath, cls.line,
146
+ `ViewController ${cls.name} should delegate logic to ViewModel (MVVM pattern)`);
147
+ }
148
+ }
149
+ });
150
+
151
+ if (filePath.endsWith('.swift') && !filePath.includes('analyzer') && !filePath.includes('detector')) {
152
+ if (content.includes('storyboard') || content.includes('.xib') || content.includes('.nib')) {
153
+ this.addFinding('ios.storyboards', 'high', filePath, 1,
154
+ 'Storyboard/XIB detected - use programmatic UI for better version control');
155
+ }
156
+ }
157
+ }
158
+
159
+ async analyzeProtocolOriented(protocols, filePath) {
160
+ const content = await fs.readFile(filePath, 'utf-8');
161
+
162
+ if (protocols.length > 0 && !content.includes('extension ')) {
163
+ this.addFinding('ios.pop.missing_extensions', 'low', filePath, 1,
164
+ 'Protocols detected but no extensions - consider protocol extensions for default implementations');
165
+ }
166
+
167
+ if (content.includes('class ') && content.includes(': ')) {
168
+ const inheritanceCount = (content.match(/class\s+\w+\s*:\s*\w+/g) || []).length;
169
+ if (inheritanceCount > 2) {
170
+ this.addFinding('ios.pop.missing_composition_over_inheritance', 'medium', filePath, 1,
171
+ `Excessive class inheritance (${inheritanceCount}x) - prefer protocol composition`);
172
+ }
173
+ }
174
+ }
175
+
176
+ async analyzeValueTypes(classes, filePath) {
177
+ const content = await fs.readFile(filePath, 'utf-8');
178
+
179
+ classes.forEach(cls => {
180
+ if (!cls.inheritedTypes.length && !content.includes('ObservableObject')) {
181
+ this.addFinding('ios.values.classes_instead_structs', 'medium', filePath, cls.line,
182
+ `Class ${cls.name} without inheritance - consider struct for value semantics`);
183
+ }
184
+ });
185
+
186
+ const varCount = (content.match(/\bvar\s+/g) || []).length;
187
+ const letCount = (content.match(/\blet\s+/g) || []).length;
188
+ if (varCount > letCount) {
189
+ this.addFinding('ios.values.mutability', 'low', filePath, 1,
190
+ `More var (${varCount}) than let (${letCount}) - prefer immutability`);
191
+ }
192
+ }
193
+
194
+ async analyzeMemoryManagement(content, filePath) {
195
+ const closureMatches = content.match(/\{\s*\[/g);
196
+ const weakSelfMatches = content.match(/\[weak self\]/g);
197
+ if (closureMatches && closureMatches.length > (weakSelfMatches?.length || 0)) {
198
+ this.addFinding('ios.memory.missing_weak_self', 'high', filePath, 1,
199
+ 'Closures without [weak self] - potential retain cycles');
200
+ }
201
+
202
+ if (content.includes('self.') && content.includes('{') && !content.includes('[weak self]')) {
203
+ this.addFinding('ios.memory.retain_cycles', 'high', filePath, 1,
204
+ 'Potential retain cycle - closure captures self without [weak self]');
205
+ }
206
+
207
+ if (content.includes('class ') && !content.includes('deinit')) {
208
+ this.addFinding('ios.memory.missing_deinit', 'low', filePath, 1,
209
+ 'Class without deinit - consider adding for cleanup verification');
210
+ }
211
+ }
212
+
213
+ async analyzeOptionals(content, filePath) {
214
+ const forceUnwraps = content.match(/(\w+)\s*!/g);
215
+ if (forceUnwraps && forceUnwraps.length > 0) {
216
+ const nonIBOutlets = forceUnwraps.filter(match => !content.includes(`@IBOutlet`));
217
+ if (nonIBOutlets.length > 0) {
218
+ this.addFinding('ios.force_unwrapping', 'high', filePath, 1,
219
+ `Force unwrapping (!) detected ${nonIBOutlets.length}x - use if let or guard let`);
220
+ }
221
+ }
222
+
223
+ const ifLetCount = (content.match(/if\s+let\s+/g) || []).length;
224
+ const guardLetCount = (content.match(/guard\s+let\s+/g) || []).length;
225
+ if (ifLetCount === 0 && guardLetCount === 0 && content.includes('?')) {
226
+ this.addFinding('ios.optionals.optional_binding', 'medium', filePath, 1,
227
+ 'Optionals present but no optional binding - use if let or guard let');
228
+ }
229
+
230
+ if (content.includes('?') && !content.includes('??')) {
231
+ this.addFinding('ios.optionals.missing_nil_coalescing', 'info', filePath, 1,
232
+ 'Consider using nil coalescing operator (??) for default values');
233
+ }
234
+ }
235
+
236
+ addFinding(ruleId, severity, filePath, line, message) {
237
+ this.findings.push({
238
+ ruleId,
239
+ severity,
240
+ message,
241
+ filePath,
242
+ line,
243
+ platform: 'ios',
244
+ });
245
+ }
246
+
247
+ async analyzeDependencyInjection(classes, filePath) {
248
+ const content = await fs.readFile(filePath, 'utf-8');
249
+
250
+ if (content.includes('.shared') || content.includes('static let shared')) {
251
+ this.addFinding('ios.di.singleton_usage', 'high', filePath, 1,
252
+ 'Singleton detected - use dependency injection instead');
253
+ }
254
+
255
+ classes.forEach(cls => {
256
+ if (cls.name.includes('ViewModel') || cls.name.includes('Service')) {
257
+ const hasInit = content.includes(`init(`);
258
+ if (!hasInit) {
259
+ this.addFinding('ios.di.missing_protocol_injection', 'medium', filePath, cls.line,
260
+ `${cls.name} should inject dependencies via initializer`);
261
+ }
262
+ }
263
+ });
264
+
265
+ if (content.includes('init(') && content.match(/init\([^)]{50,}\)/)) {
266
+ this.addFinding('ios.di.missing_factory', 'low', filePath, 1,
267
+ 'Complex initialization - consider factory pattern');
268
+ }
269
+ }
270
+
271
+ async analyzeNetworking(content, filePath) {
272
+ if (!content.includes('URLSession') && !content.includes('Alamofire')) {
273
+ if (content.includes('http://') || content.includes('https://')) {
274
+ this.addFinding('ios.networking.missing_urlsession', 'high', filePath, 1,
275
+ 'Network URLs detected but no URLSession/Alamofire usage');
276
+ }
277
+ }
278
+
279
+ if (content.includes('URLSession') && content.includes('completionHandler:') && !content.includes('async')) {
280
+ this.addFinding('ios.networking.completion_handlers_instead_async', 'medium', filePath, 1,
281
+ 'Using completion handlers with URLSession - migrate to async/await');
282
+ }
283
+
284
+ if (content.includes('JSONSerialization') && !content.includes('Codable')) {
285
+ this.addFinding('ios.networking.missing_codable', 'medium', filePath, 1,
286
+ 'Manual JSON parsing - use Codable for type safety');
287
+ }
288
+
289
+ if (content.includes('URLSession') && !content.includes('NetworkError')) {
290
+ this.addFinding('ios.networking.missing_error_handling', 'high', filePath, 1,
291
+ 'Network code without custom NetworkError enum');
292
+ }
293
+
294
+ if (content.includes('URLSession') && !content.includes('serverTrustPolicy') && !content.includes('pinning')) {
295
+ this.addFinding('ios.networking.missing_ssl_pinning', 'medium', filePath, 1,
296
+ 'Consider SSL pinning for high-security apps');
297
+ }
298
+
299
+ if (content.includes('URLSession') && !content.includes('retry')) {
300
+ this.addFinding('ios.networking.missing_retry', 'low', filePath, 1,
301
+ 'Network requests without retry logic');
302
+ }
303
+ }
304
+
305
+ async analyzePersistence(content, filePath) {
306
+ if (content.includes('UserDefaults') && (content.includes('password') || content.includes('token') || content.includes('auth'))) {
307
+ this.addFinding('ios.persistence.userdefaults_sensitive', 'critical', filePath, 1,
308
+ 'Sensitive data in UserDefaults - use Keychain instead');
309
+ }
310
+
311
+ if ((content.includes('password') || content.includes('token')) && !content.includes('Keychain') && !content.includes('Security')) {
312
+ this.addFinding('ios.persistence.missing_keychain', 'critical', filePath, 1,
313
+ 'Sensitive data detected but no Keychain usage');
314
+ }
315
+
316
+ if (content.includes('NSManagedObjectContext') && content.includes('.main')) {
317
+ this.addFinding('ios.persistence.core_data_on_main', 'high', filePath, 1,
318
+ 'Core Data operations on main thread - use background context');
319
+ }
320
+
321
+ if (content.includes('NSPersistentContainer') && !content.includes('NSMigrationManager')) {
322
+ this.addFinding('ios.persistence.missing_migration', 'medium', filePath, 1,
323
+ 'Core Data without migration strategy');
324
+ }
325
+ }
326
+
327
+ async analyzeCombine(content, filePath) {
328
+ if (content.includes('.sink(') && !content.includes('AnyCancellable')) {
329
+ this.addFinding('ios.combine.missing_cancellables', 'high', filePath, 1,
330
+ 'Combine sink without storing AnyCancellable - memory leak');
331
+ }
332
+
333
+ if (content.includes('@Published') && !content.includes('import Combine')) {
334
+ this.addFinding('ios.combine.published_without_combine', 'high', filePath, 1,
335
+ '@Published used but Combine not imported');
336
+ }
337
+
338
+ if (content.includes('.sink(') && !content.includes('receiveCompletion')) {
339
+ this.addFinding('ios.combine.error_handling', 'medium', filePath, 1,
340
+ 'Combine subscriber without error handling (receiveCompletion)');
341
+ }
342
+
343
+ if (content.includes('Future<') && !content.includes('async')) {
344
+ this.addFinding('ios.combine.prefer_async_await', 'low', filePath, 1,
345
+ 'Combine Future for single value - consider async/await instead');
346
+ }
347
+ }
348
+
349
+ async analyzeConcurrency(content, filePath) {
350
+ if (content.includes('DispatchQueue') && !content.includes('async func')) {
351
+ this.addFinding('ios.concurrency.dispatchqueue_old', 'medium', filePath, 1,
352
+ 'Using DispatchQueue - prefer async/await for new code');
353
+ }
354
+
355
+ if (content.includes('DispatchQueue.main') && content.includes('UI')) {
356
+ this.addFinding('ios.concurrency.missing_mainactor', 'medium', filePath, 1,
357
+ 'Manual main thread dispatch - use @MainActor annotation');
358
+ }
359
+
360
+ if (content.includes('Task {') && !content.includes('.cancel()') && !content.includes('Task.isCancelled')) {
361
+ this.addFinding('ios.concurrency.task_cancellation', 'low', filePath, 1,
362
+ 'Task without cancellation handling');
363
+ }
364
+
365
+ if (content.includes('var ') && content.includes('queue') && !content.includes('actor')) {
366
+ this.addFinding('ios.concurrency.actor_missing', 'medium', filePath, 1,
367
+ 'Manual synchronization with queue - consider actor for thread safety');
368
+ }
369
+ }
370
+
371
+ async analyzeTesting(content, filePath) {
372
+ if (filePath.includes('Test') && !content.includes('XCTest') && !content.includes('Quick')) {
373
+ this.addFinding('ios.testing.missing_xctest', 'high', filePath, 1,
374
+ 'Test file without XCTest or Quick import');
375
+ }
376
+
377
+ if (filePath.includes('Test') && !content.includes('makeSUT') && content.includes('func test')) {
378
+ this.addFinding('ios.testing.missing_makesut', 'medium', filePath, 1,
379
+ 'Test without makeSUT pattern - centralize system under test creation');
380
+ }
381
+
382
+ if (filePath.includes('Test') && !content.includes('trackForMemoryLeaks') && content.includes('class')) {
383
+ this.addFinding('ios.testing.missing_memory_leak_tracking', 'medium', filePath, 1,
384
+ 'Test without trackForMemoryLeaks helper');
385
+ }
386
+
387
+ if (filePath.includes('Test') && content.includes('init(') && !content.includes('Protocol')) {
388
+ this.addFinding('ios.testing.concrete_dependencies', 'medium', filePath, 1,
389
+ 'Test using concrete dependencies - inject protocols for testability');
390
+ }
391
+ }
392
+
393
+ async analyzeUITesting(content, filePath) {
394
+ if (filePath.includes('UITest') && !content.includes('XCUIApplication')) {
395
+ this.addFinding('ios.uitesting.missing_xcuitest', 'high', filePath, 1,
396
+ 'UI test file without XCUIApplication');
397
+ }
398
+
399
+ if (filePath.includes('UITest') && !content.includes('accessibilityIdentifier')) {
400
+ this.addFinding('ios.uitesting.missing_accessibility', 'medium', filePath, 1,
401
+ 'UI test without accessibility identifiers for element location');
402
+ }
403
+
404
+ if (filePath.includes('UITest') && content.includes('XCUIElement') && !content.includes('Page')) {
405
+ this.addFinding('ios.uitesting.missing_page_object', 'low', filePath, 1,
406
+ 'UI test without Page Object pattern for encapsulation');
407
+ }
408
+
409
+ if (filePath.includes('UITest') && content.includes('.tap()') && !content.includes('waitForExistence')) {
410
+ this.addFinding('ios.uitesting.missing_wait', 'high', filePath, 1,
411
+ 'UI test tapping without waitForExistence - flaky test');
412
+ }
413
+ }
414
+
415
+ async analyzeSecurity(content, filePath) {
416
+ if (content.includes('http://') && !content.includes('NSAppTransportSecurity')) {
417
+ this.addFinding('ios.security.missing_ats', 'critical', filePath, 1,
418
+ 'HTTP URLs without App Transport Security exception');
419
+ }
420
+
421
+ if ((content.includes('password') || content.includes('auth')) && !content.includes('LAContext') && !content.includes('biometric')) {
422
+ this.addFinding('ios.security.missing_biometric', 'medium', filePath, 1,
423
+ 'Authentication without biometric option (Face ID/Touch ID)');
424
+ }
425
+
426
+ if (content.includes('Security') && !content.includes('jailbreak') && !content.includes('Cydia')) {
427
+ this.addFinding('ios.security.missing_jailbreak', 'low', filePath, 1,
428
+ 'Consider jailbreak detection for security-critical apps');
429
+ }
430
+
431
+ if (content.includes('SecKey') && !content.includes('kSecAttrTokenIDSecureEnclave')) {
432
+ this.addFinding('ios.security.missing_secure_enclave', 'medium', filePath, 1,
433
+ 'Cryptographic keys without Secure Enclave storage');
434
+ }
435
+
436
+ const secretPatterns = /(api[_-]?key|secret|password|token)\s*=\s*["'][^"']{8,}["']/gi;
437
+ if (secretPatterns.test(content)) {
438
+ this.addFinding('ios.security.hardcoded_secrets', 'critical', filePath, 1,
439
+ 'Hardcoded secrets detected in code - use environment/keychain');
440
+ }
441
+ }
442
+
443
+ async analyzeAccessibility(content, filePath) {
444
+ if (content.includes('UIButton') && !content.includes('accessibilityLabel')) {
445
+ this.addFinding('ios.accessibility.missing_labels', 'high', filePath, 1,
446
+ 'UIButton without accessibilityLabel for VoiceOver');
447
+ }
448
+
449
+ if (content.includes('UIFont') && !content.includes('preferredFont')) {
450
+ this.addFinding('ios.accessibility.missing_dynamic_type', 'medium', filePath, 1,
451
+ 'UIFont without Dynamic Type support - use preferredFont');
452
+ }
453
+
454
+ if (content.includes('accessibilityLabel') && !content.includes('accessibilityTraits')) {
455
+ this.addFinding('ios.accessibility.missing_traits', 'medium', filePath, 1,
456
+ 'Accessibility label without traits (.isButton, .isHeader)');
457
+ }
458
+
459
+ if (content.includes('UIView.animate') && !content.includes('isReduceMotionEnabled')) {
460
+ this.addFinding('ios.accessibility.missing_reduce_motion', 'low', filePath, 1,
461
+ 'Animations without respecting Reduce Motion setting');
462
+ }
463
+
464
+ if (content.includes('UIColor') && content.includes('.gray') && content.includes('Text')) {
465
+ this.addFinding('ios.accessibility.color_contrast', 'medium', filePath, 1,
466
+ 'Gray text color - verify WCAG AA contrast ratio (4.5:1 minimum)');
467
+ }
468
+ }
469
+
470
+ async analyzeLocalization(content, filePath) {
471
+ const textMatches = content.match(/(Text|UILabel)\(["\'][^"\']+["\']\)/g);
472
+ if (textMatches && textMatches.length > 0 && !content.includes('NSLocalizedString')) {
473
+ this.addFinding('ios.i18n.hardcoded_strings', 'medium', filePath, 1,
474
+ `Hardcoded UI strings (${textMatches.length}x) - use NSLocalizedString`);
475
+ }
476
+
477
+ if (content.includes('NSLocalizedString') && !filePath.includes('Localizable.strings')) {
478
+ this.addFinding('ios.i18n.missing_localizable', 'low', filePath, 1,
479
+ 'NSLocalizedString used - ensure Localizable.strings exists');
480
+ }
481
+
482
+ if (content.includes('String(') && content.match(/\d+\.\d+/)) {
483
+ this.addFinding('ios.i18n.missing_number_formatter', 'medium', filePath, 1,
484
+ 'Manual number formatting - use NumberFormatter for locale support');
485
+ }
486
+
487
+ if (content.includes('Date') && content.includes('String') && !content.includes('DateFormatter')) {
488
+ this.addFinding('ios.i18n.missing_date_formatter', 'medium', filePath, 1,
489
+ 'Manual date formatting - use DateFormatter for locale support');
490
+ }
491
+
492
+ if (content.includes('leading') || content.includes('trailing')) {
493
+ } else if (content.includes('.left') || content.includes('.right')) {
494
+ this.addFinding('ios.i18n.missing_rtl', 'medium', filePath, 1,
495
+ 'Using left/right instead of leading/trailing - breaks RTL languages');
496
+ }
497
+ }
498
+
499
+ async analyzeArchitecturePatterns(classes, functions, filePath) {
500
+ const content = await fs.readFile(filePath, 'utf-8');
501
+
502
+ const viewControllerClasses = classes.filter(c => c.name.includes('ViewController'));
503
+ viewControllerClasses.forEach(vc => {
504
+ const methodsInVC = functions.filter(f => content.substring(vc.line, vc.line + 1000).includes(f.name));
505
+ if (methodsInVC.length > 20) {
506
+ this.addFinding('ios.architecture.mvc_pattern', 'high', filePath, vc.line,
507
+ `Massive View Controller ${vc.name} (${methodsInVC.length} methods) - migrate to MVVM`);
508
+ }
509
+ });
510
+
511
+ if (classes.some(c => c.name.includes('ViewController')) && !classes.some(c => c.name.includes('ViewModel'))) {
512
+ this.addFinding('ios.architecture.missing_mvvm', 'medium', filePath, 1,
513
+ 'ViewController without ViewModel - consider MVVM pattern');
514
+ }
515
+
516
+ if (content.includes('navigationController') && !content.includes('Coordinator')) {
517
+ this.addFinding('ios.architecture.missing_coordinator', 'low', filePath, 1,
518
+ 'Manual navigation - consider Coordinator pattern (MVVM-C)');
519
+ }
520
+ }
521
+
522
+ async analyzePerformance(functions, content, filePath) {
523
+ if (content.includes('URLSession') && !content.includes('DispatchQueue') && !content.includes('async')) {
524
+ this.addFinding('ios.performance.blocking_main_thread', 'high', filePath, 1,
525
+ 'Network call potentially on main thread - use async or background queue');
526
+ }
527
+
528
+ if (content.includes('UITableView') && !content.includes('cellForRowAt') && !content.includes('dequeueReusableCell')) {
529
+ this.addFinding('ios.performance.missing_lazy_loading', 'high', filePath, 1,
530
+ 'UITableView without cell reuse - memory issue with large datasets');
531
+ }
532
+
533
+ if (content.includes('UIImage(named:') && !content.includes('UIImage.SymbolConfiguration')) {
534
+ this.addFinding('ios.performance.image_not_optimized', 'low', filePath, 1,
535
+ 'Consider SF Symbols or optimized image assets');
536
+ }
537
+
538
+ functions.forEach(fn => {
539
+ if (fn.bodyLength > 100 && content.includes('@MainActor')) {
540
+ this.addFinding('ios.performance.heavy_computation_main', 'high', filePath, fn.line,
541
+ `Heavy function ${fn.name} on main thread - move to background`);
542
+ }
543
+ });
544
+
545
+ if (content.includes('expensive') || content.includes('calculate')) {
546
+ if (!content.includes('cache') && !content.includes('memoized')) {
547
+ this.addFinding('ios.performance.missing_memoization', 'low', filePath, 1,
548
+ 'Expensive calculations without caching/memoization');
549
+ }
550
+ }
551
+ }
552
+
553
+ async analyzeCodeOrganization(filePath, content) {
554
+ if (content.length > 200 && !content.includes('// MARK:')) {
555
+ this.addFinding('ios.organization.missing_mark', 'low', filePath, 1,
556
+ 'Large file without MARK comments for organization');
557
+ }
558
+
559
+ const lineCount = content.split('\n').length;
560
+ if (lineCount > 400) {
561
+ this.addFinding('ios.organization.file_too_large', 'medium', filePath, 1,
562
+ `File too large (${lineCount} lines) - break into smaller files`);
563
+ }
564
+
565
+ if (content.includes('extension ') && filePath.includes('+')) {
566
+ this.addFinding('ios.organization.missing_extensions', 'low', filePath, 1,
567
+ 'Extension file without + extension - split into separate files (Type+Extension.swift)');
568
+ } else if (content.split('extension ').length > 3) {
569
+ this.addFinding('ios.organization.missing_extensions', 'low', filePath, 1,
570
+ 'Multiple extensions in single file - split into separate files (Type+Extension.swift)');
571
+ }
572
+
573
+ if (filePath.includes('/Sources/') && !content.includes('import PackageDescription')) {
574
+ this.addFinding('ios.organization.missing_spm', 'info', filePath, 1,
575
+ 'Consider Swift Package Manager for modularization');
576
+ }
577
+ }
578
+ }
579
+
580
+ module.exports = { iOSEnterpriseAnalyzer };