autosnippet 3.0.0 → 3.0.2

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 (290) hide show
  1. package/README.md +230 -324
  2. package/bin/api-server.js +1 -1
  3. package/bin/cli.js +204 -244
  4. package/bin/mcp-server.js +5 -3
  5. package/config/knowledge-base.config.js +132 -132
  6. package/dashboard/dist/assets/{icons-CEfgGaZi.js → icons-Cdq22n2i.js} +95 -100
  7. package/dashboard/dist/assets/index-ClkyPkDX.js +133 -0
  8. package/dashboard/dist/assets/index-t4QrJwv1.css +1 -0
  9. package/dashboard/dist/index.html +3 -3
  10. package/lib/bootstrap.js +8 -8
  11. package/lib/cli/AiScanService.js +86 -40
  12. package/lib/cli/KnowledgeSyncService.js +113 -74
  13. package/lib/cli/SetupService.js +439 -277
  14. package/lib/cli/UpgradeService.js +63 -100
  15. package/lib/core/AstAnalyzer.js +276 -597
  16. package/lib/core/ast/ProjectGraph.js +101 -40
  17. package/lib/core/ast/ensure-grammars.js +232 -0
  18. package/lib/core/ast/index.js +115 -0
  19. package/lib/core/ast/lang-dart.js +661 -0
  20. package/lib/core/ast/lang-go.js +530 -0
  21. package/lib/core/ast/lang-java.js +435 -0
  22. package/lib/core/ast/lang-javascript.js +272 -0
  23. package/lib/core/ast/lang-kotlin.js +423 -0
  24. package/lib/core/ast/lang-objc.js +388 -0
  25. package/lib/core/ast/lang-python.js +371 -0
  26. package/lib/core/ast/lang-swift.js +337 -0
  27. package/lib/core/ast/lang-typescript.js +503 -0
  28. package/lib/core/capability/CapabilityProbe.js +18 -9
  29. package/lib/core/constitution/Constitution.js +2 -3
  30. package/lib/core/constitution/ConstitutionValidator.js +65 -24
  31. package/lib/core/discovery/DartDiscoverer.js +534 -0
  32. package/lib/core/discovery/DiscovererRegistry.js +83 -0
  33. package/lib/core/discovery/GenericDiscoverer.js +225 -0
  34. package/lib/core/discovery/GoDiscoverer.js +541 -0
  35. package/lib/core/discovery/JvmDiscoverer.js +506 -0
  36. package/lib/core/discovery/NodeDiscoverer.js +466 -0
  37. package/lib/core/discovery/ProjectDiscoverer.js +93 -0
  38. package/lib/core/discovery/PythonDiscoverer.js +338 -0
  39. package/lib/core/discovery/SpmDiscoverer.js +5 -0
  40. package/lib/core/discovery/index.js +53 -0
  41. package/lib/core/enhancement/EnhancementPack.js +71 -0
  42. package/lib/core/enhancement/EnhancementRegistry.js +47 -0
  43. package/lib/core/enhancement/android-enhancement.js +102 -0
  44. package/lib/core/enhancement/django-enhancement.js +70 -0
  45. package/lib/core/enhancement/fastapi-enhancement.js +63 -0
  46. package/lib/core/enhancement/go-grpc-enhancement.js +152 -0
  47. package/lib/core/enhancement/go-web-enhancement.js +201 -0
  48. package/lib/core/enhancement/index.js +65 -0
  49. package/lib/core/enhancement/node-server-enhancement.js +88 -0
  50. package/lib/core/enhancement/react-enhancement.js +86 -0
  51. package/lib/core/enhancement/spring-enhancement.js +112 -0
  52. package/lib/core/enhancement/vue-enhancement.js +96 -0
  53. package/lib/core/gateway/Gateway.js +8 -9
  54. package/lib/core/gateway/GatewayActionRegistry.js +1 -1
  55. package/lib/core/permission/PermissionManager.js +12 -8
  56. package/lib/domain/index.js +13 -9
  57. package/lib/domain/knowledge/KnowledgeEntry.js +111 -101
  58. package/lib/domain/knowledge/KnowledgeRepository.js +0 -1
  59. package/lib/domain/knowledge/Lifecycle.js +22 -22
  60. package/lib/domain/knowledge/index.js +9 -12
  61. package/lib/domain/knowledge/values/Constraints.js +31 -21
  62. package/lib/domain/knowledge/values/Content.js +21 -13
  63. package/lib/domain/knowledge/values/Quality.js +31 -18
  64. package/lib/domain/knowledge/values/Reasoning.js +20 -12
  65. package/lib/domain/knowledge/values/Relations.js +37 -25
  66. package/lib/domain/knowledge/values/Stats.js +18 -12
  67. package/lib/domain/knowledge/values/index.js +4 -3
  68. package/lib/domain/snippet/Snippet.js +35 -10
  69. package/lib/external/ai/AiFactory.js +48 -16
  70. package/lib/external/ai/AiProvider.js +184 -90
  71. package/lib/external/ai/providers/ClaudeProvider.js +25 -12
  72. package/lib/external/ai/providers/GoogleGeminiProvider.js +59 -30
  73. package/lib/external/ai/providers/MockProvider.js +9 -3
  74. package/lib/external/ai/providers/OpenAiProvider.js +51 -29
  75. package/lib/external/mcp/McpServer.js +66 -36
  76. package/lib/external/mcp/errorHandler.js +23 -11
  77. package/lib/external/mcp/handlers/LanguageExtensions.js +138 -53
  78. package/lib/external/mcp/handlers/TargetClassifier.js +52 -16
  79. package/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.js +81 -20
  80. package/lib/external/mcp/handlers/bootstrap/pipeline/EpisodicMemory.js +71 -42
  81. package/lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.js +9 -17
  82. package/lib/external/mcp/handlers/bootstrap/pipeline/ToolResultCache.js +14 -9
  83. package/lib/external/mcp/handlers/bootstrap/pipeline/dimension-context.js +15 -7
  84. package/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js +352 -153
  85. package/lib/external/mcp/handlers/bootstrap/pipeline/tier-scheduler.js +52 -12
  86. package/lib/external/mcp/handlers/bootstrap/skills.js +143 -39
  87. package/lib/external/mcp/handlers/bootstrap.js +691 -168
  88. package/lib/external/mcp/handlers/browse.js +66 -22
  89. package/lib/external/mcp/handlers/candidate.js +118 -35
  90. package/lib/external/mcp/handlers/consolidated.js +49 -17
  91. package/lib/external/mcp/handlers/guard.js +104 -39
  92. package/lib/external/mcp/handlers/knowledge.js +60 -36
  93. package/lib/external/mcp/handlers/search.js +43 -14
  94. package/lib/external/mcp/handlers/skill.js +120 -45
  95. package/lib/external/mcp/handlers/structure.js +240 -86
  96. package/lib/external/mcp/handlers/system.js +42 -12
  97. package/lib/external/mcp/handlers/wiki.js +58 -33
  98. package/lib/external/mcp/tools.js +306 -123
  99. package/lib/http/HttpServer.js +72 -47
  100. package/lib/http/middleware/RateLimiter.js +5 -3
  101. package/lib/http/middleware/errorHandler.js +6 -1
  102. package/lib/http/middleware/requestLogger.js +14 -3
  103. package/lib/http/middleware/roleResolver.js +30 -23
  104. package/lib/http/routes/ai.js +387 -265
  105. package/lib/http/routes/auth.js +81 -61
  106. package/lib/http/routes/candidates.js +430 -320
  107. package/lib/http/routes/commands.js +289 -189
  108. package/lib/http/routes/extract.js +158 -125
  109. package/lib/http/routes/guardRules.js +309 -217
  110. package/lib/http/routes/knowledge.js +213 -154
  111. package/lib/http/routes/modules.js +578 -0
  112. package/lib/http/routes/monitoring.js +6 -6
  113. package/lib/http/routes/recipes.js +104 -93
  114. package/lib/http/routes/search.js +361 -305
  115. package/lib/http/routes/skills.js +145 -98
  116. package/lib/http/routes/snippets.js +42 -30
  117. package/lib/http/routes/spm.js +3 -405
  118. package/lib/http/routes/violations.js +113 -93
  119. package/lib/http/routes/wiki.js +211 -170
  120. package/lib/http/utils/routeHelpers.js +3 -1
  121. package/lib/http/utils/sse-sessions.js +16 -6
  122. package/lib/http/utils/sse.js +15 -5
  123. package/lib/infrastructure/audit/AuditLogger.js +5 -2
  124. package/lib/infrastructure/audit/AuditStore.js +10 -7
  125. package/lib/infrastructure/cache/CacheService.js +3 -1
  126. package/lib/infrastructure/cache/GraphCache.js +8 -4
  127. package/lib/infrastructure/cache/UnifiedCacheAdapter.js +1 -1
  128. package/lib/infrastructure/config/ConfigLoader.js +9 -5
  129. package/lib/infrastructure/config/Defaults.js +30 -10
  130. package/lib/infrastructure/config/Paths.js +28 -8
  131. package/lib/infrastructure/config/TriggerSymbol.js +22 -10
  132. package/lib/infrastructure/database/DatabaseConnection.js +15 -10
  133. package/lib/infrastructure/database/migrations/001_initial_schema.js +0 -1
  134. package/lib/infrastructure/external/ClipboardManager.js +6 -2
  135. package/lib/infrastructure/external/NativeUi.js +50 -43
  136. package/lib/infrastructure/external/OpenBrowser.js +14 -17
  137. package/lib/infrastructure/external/XcodeAutomation.js +14 -258
  138. package/lib/infrastructure/logging/Logger.js +46 -30
  139. package/lib/infrastructure/monitoring/ErrorTracker.js +7 -5
  140. package/lib/infrastructure/monitoring/PerformanceMonitor.js +12 -4
  141. package/lib/infrastructure/paths/HeaderResolver.js +25 -9
  142. package/lib/infrastructure/paths/PathFinder.js +34 -12
  143. package/lib/infrastructure/plugin/PluginManager.js +26 -8
  144. package/lib/infrastructure/realtime/RealtimeService.js +2 -2
  145. package/lib/infrastructure/vector/Chunker.js +22 -7
  146. package/lib/infrastructure/vector/IndexingPipeline.js +46 -22
  147. package/lib/infrastructure/vector/JsonVectorAdapter.js +90 -53
  148. package/lib/infrastructure/vector/VectorStore.js +28 -10
  149. package/lib/injection/ServiceContainer.js +247 -93
  150. package/lib/platform/ios/index.js +63 -0
  151. package/lib/platform/ios/routes/spm.js +437 -0
  152. package/lib/platform/ios/snippet/PlaceholderConverter.js +55 -0
  153. package/lib/platform/ios/snippet/XcodeCodec.js +112 -0
  154. package/lib/{service → platform/ios}/spm/DependencyGraph.js +41 -17
  155. package/lib/{service → platform/ios}/spm/PackageSwiftParser.js +41 -14
  156. package/lib/{service → platform/ios}/spm/PolicyEngine.js +9 -4
  157. package/lib/platform/ios/spm/SpmDiscoverer.js +122 -0
  158. package/lib/{service → platform/ios}/spm/SpmService.js +385 -127
  159. package/lib/{service/automation → platform/ios/xcode}/SaveEventFilter.js +8 -7
  160. package/lib/platform/ios/xcode/XcodeAutomation.js +350 -0
  161. package/lib/{service/automation → platform/ios/xcode}/XcodeIntegration.js +325 -145
  162. package/lib/repository/base/BaseRepository.js +7 -9
  163. package/lib/repository/knowledge/KnowledgeRepository.impl.js +98 -75
  164. package/lib/repository/token/TokenUsageStore.js +4 -2
  165. package/lib/service/automation/ActionPipeline.js +1 -1
  166. package/lib/service/automation/AutomationOrchestrator.js +8 -4
  167. package/lib/service/automation/ContextCollector.js +7 -5
  168. package/lib/service/automation/DirectiveDetector.js +23 -16
  169. package/lib/service/automation/FileWatcher.js +112 -56
  170. package/lib/service/automation/TriggerResolver.js +6 -4
  171. package/lib/service/automation/handlers/AlinkHandler.js +24 -12
  172. package/lib/service/automation/handlers/CreateHandler.js +19 -20
  173. package/lib/service/automation/handlers/DraftHandler.js +14 -8
  174. package/lib/service/automation/handlers/GuardHandler.js +93 -63
  175. package/lib/service/automation/handlers/HeaderHandler.js +1 -6
  176. package/lib/service/automation/handlers/SearchHandler.js +155 -88
  177. package/lib/service/bootstrap/BootstrapTaskManager.js +77 -35
  178. package/lib/service/candidate/SimilarityService.js +25 -9
  179. package/lib/service/chat/AnalystAgent.js +50 -24
  180. package/lib/service/chat/CandidateGuardrail.js +143 -17
  181. package/lib/service/chat/ChatAgent.js +759 -243
  182. package/lib/service/chat/ContextWindow.js +116 -71
  183. package/lib/service/chat/ConversationStore.js +77 -36
  184. package/lib/service/chat/EpisodicConsolidator.js +47 -23
  185. package/lib/service/chat/HandoffProtocol.js +98 -22
  186. package/lib/service/chat/Memory.js +34 -14
  187. package/lib/service/chat/ProducerAgent.js +40 -20
  188. package/lib/service/chat/ProjectSemanticMemory.js +109 -78
  189. package/lib/service/chat/ReasoningLayer.js +148 -70
  190. package/lib/service/chat/ReasoningTrace.js +44 -32
  191. package/lib/service/chat/TaskPipeline.js +39 -19
  192. package/lib/service/chat/ToolRegistry.js +48 -29
  193. package/lib/service/chat/WorkingMemory.js +44 -18
  194. package/lib/service/chat/tools.js +1096 -494
  195. package/lib/service/context/RecipeExtractor.js +132 -51
  196. package/lib/service/cursor/CursorDeliveryPipeline.js +82 -37
  197. package/lib/service/cursor/KnowledgeCompressor.js +25 -22
  198. package/lib/service/cursor/RulesGenerator.js +13 -7
  199. package/lib/service/cursor/SkillsSyncer.js +77 -27
  200. package/lib/service/cursor/TokenBudget.js +2 -2
  201. package/lib/service/cursor/TopicClassifier.js +54 -20
  202. package/lib/service/guard/ComplianceReporter.js +55 -43
  203. package/lib/service/guard/ExclusionManager.js +67 -29
  204. package/lib/service/guard/GuardCheckEngine.js +381 -86
  205. package/lib/service/guard/GuardFeedbackLoop.js +22 -10
  206. package/lib/service/guard/GuardService.js +29 -19
  207. package/lib/service/guard/RuleLearner.js +55 -23
  208. package/lib/service/guard/SourceFileCollector.js +27 -20
  209. package/lib/service/guard/ViolationsStore.js +43 -38
  210. package/lib/service/knowledge/CodeEntityGraph.js +147 -82
  211. package/lib/service/knowledge/ConfidenceRouter.js +12 -10
  212. package/lib/service/knowledge/KnowledgeFileWriter.js +147 -56
  213. package/lib/service/knowledge/KnowledgeGraphService.js +81 -34
  214. package/lib/service/knowledge/KnowledgeService.js +222 -112
  215. package/lib/service/module/ModuleService.js +969 -0
  216. package/lib/service/quality/FeedbackCollector.js +27 -15
  217. package/lib/service/quality/QualityScorer.js +78 -24
  218. package/lib/service/recipe/RecipeCandidateValidator.js +110 -44
  219. package/lib/service/recipe/RecipeParser.js +78 -45
  220. package/lib/service/search/CoarseRanker.js +43 -28
  221. package/lib/service/search/CrossEncoderReranker.js +32 -21
  222. package/lib/service/search/InvertedIndex.js +21 -7
  223. package/lib/service/search/MultiSignalRanker.js +90 -28
  224. package/lib/service/search/RetrievalFunnel.js +45 -24
  225. package/lib/service/search/SearchEngine.js +255 -103
  226. package/lib/service/skills/EventAggregator.js +32 -15
  227. package/lib/service/skills/SignalCollector.js +140 -64
  228. package/lib/service/skills/SkillAdvisor.js +79 -42
  229. package/lib/service/skills/SkillHooks.js +16 -14
  230. package/lib/service/snippet/PlaceholderConverter.js +5 -0
  231. package/lib/service/snippet/SnippetFactory.js +116 -99
  232. package/lib/service/snippet/SnippetInstaller.js +234 -62
  233. package/lib/service/snippet/codecs/SnippetCodec.js +67 -0
  234. package/lib/service/snippet/codecs/VSCodeCodec.js +102 -0
  235. package/lib/service/snippet/codecs/XcodeCodec.js +5 -0
  236. package/lib/service/wiki/WikiGenerator.js +637 -263
  237. package/lib/shared/DimensionCopyRegistry.js +472 -0
  238. package/lib/shared/LanguageService.js +399 -0
  239. package/lib/shared/PathGuard.js +45 -28
  240. package/lib/shared/RecipeReadinessChecker.js +72 -12
  241. package/lib/shared/constants.js +41 -41
  242. package/lib/shared/errors/BaseError.js +2 -2
  243. package/lib/shared/errors/index.js +4 -4
  244. package/lib/shared/similarity.js +25 -8
  245. package/lib/shared/token-utils.js +6 -2
  246. package/lib/shared/utils/common.js +12 -4
  247. package/package.json +49 -13
  248. package/scripts/bench-real-projects.mjs +256 -0
  249. package/scripts/build-native-ui.js +30 -30
  250. package/scripts/clear-old-vector-index.js +5 -35
  251. package/scripts/clear-vector-cache.js +7 -37
  252. package/scripts/collect-test-project-stats.mjs +160 -0
  253. package/scripts/diagnose-mcp.js +41 -32
  254. package/scripts/ensure-parse-package.js +6 -9
  255. package/scripts/generate-recipe-drafts.js +116 -77
  256. package/scripts/init-db.js +3 -20
  257. package/scripts/init-snippets.js +305 -0
  258. package/scripts/init-vector-db.js +173 -170
  259. package/scripts/install-cursor-skill.js +148 -104
  260. package/scripts/install-full.js +8 -21
  261. package/scripts/install-vscode-copilot.js +146 -145
  262. package/scripts/migrate-md-to-knowledge.mjs +139 -151
  263. package/scripts/postinstall-safe.js +5 -17
  264. package/scripts/recipe-audit.js +106 -82
  265. package/scripts/release.js +283 -323
  266. package/scripts/setup-mcp-config.js +60 -52
  267. package/scripts/verify-context-api.js +20 -20
  268. package/skills/autosnippet-analysis/SKILL.md +10 -6
  269. package/skills/autosnippet-candidates/SKILL.md +27 -26
  270. package/skills/autosnippet-coldstart/SKILL.md +555 -38
  271. package/skills/autosnippet-concepts/SKILL.md +349 -337
  272. package/skills/autosnippet-create/SKILL.md +5 -5
  273. package/skills/autosnippet-reference-dart/SKILL.md +543 -0
  274. package/skills/autosnippet-reference-go/SKILL.md +539 -0
  275. package/skills/autosnippet-reference-java/SKILL.md +534 -0
  276. package/skills/autosnippet-reference-jsts/SKILL.md +41 -9
  277. package/skills/autosnippet-reference-kotlin/SKILL.md +526 -0
  278. package/skills/autosnippet-reference-objc/SKILL.md +29 -6
  279. package/skills/autosnippet-reference-python/SKILL.md +800 -0
  280. package/skills/autosnippet-reference-swift/SKILL.md +70 -14
  281. package/skills/autosnippet-structure/SKILL.md +4 -4
  282. package/templates/cursor-rules/autosnippet-conventions.mdc +2 -2
  283. package/templates/recipes-setup/README.md +2 -2
  284. package/templates/recipes-setup/_template.md +1 -1
  285. package/dashboard/dist/assets/index-Bun3ld_J.css +0 -1
  286. package/dashboard/dist/assets/index-_Sk_Dmg3.js +0 -143
  287. package/resources/asd-entry/main.swift +0 -159
  288. package/scripts/build-asd-entry.js +0 -51
  289. package/scripts/init-xcode-snippets.js +0 -311
  290. package/template.json +0 -39
@@ -0,0 +1,388 @@
1
+ /**
2
+ * @module lang-objc
3
+ * @description ObjC AST Walker 插件 — 从 AstAnalyzer.js 迁移
4
+ */
5
+
6
+ import { createRequire } from 'node:module';
7
+
8
+ const require = createRequire(import.meta.url);
9
+
10
+ // ── ObjC AST 遍历 ──
11
+
12
+ function walkObjC(root, ctx) {
13
+ for (let i = 0; i < root.namedChildCount; i++) {
14
+ const node = root.namedChild(i);
15
+
16
+ switch (node.type) {
17
+ case 'preproc_include': {
18
+ const pathNode = node.namedChildren.find(
19
+ (c) => c.type === 'string_literal' || c.type === 'system_lib_string'
20
+ );
21
+ if (pathNode) {
22
+ ctx.imports.push(pathNode.text.replace(/^["<]|[">]$/g, ''));
23
+ }
24
+ break;
25
+ }
26
+
27
+ case 'class_interface': {
28
+ const classInfo = _parseObjCInterface(node);
29
+ if (classInfo.isCategory) {
30
+ ctx.categories.push(classInfo);
31
+ } else {
32
+ ctx.classes.push(classInfo);
33
+ }
34
+ for (const child of node.namedChildren) {
35
+ if (child.type === 'method_declaration') {
36
+ ctx.methods.push(_parseObjCMethodDecl(child, classInfo.name));
37
+ } else if (child.type === 'property_declaration') {
38
+ ctx.properties.push(_parseObjCProperty(child, classInfo.name));
39
+ }
40
+ }
41
+ break;
42
+ }
43
+
44
+ case 'protocol_declaration': {
45
+ ctx.protocols.push(_parseObjCProtocol(node));
46
+ break;
47
+ }
48
+
49
+ case 'class_implementation': {
50
+ const implName = _findIdentifier(node);
51
+ for (const child of node.namedChildren) {
52
+ if (child.type === 'implementation_definition') {
53
+ for (const implChild of child.namedChildren) {
54
+ if (implChild.type === 'method_definition') {
55
+ const m = _parseObjCMethodDef(implChild, implName);
56
+ ctx.methods.push(m);
57
+ }
58
+ }
59
+ }
60
+ }
61
+ break;
62
+ }
63
+
64
+ case 'category_implementation': {
65
+ const catImplName = _findIdentifier(node);
66
+ for (const child of node.namedChildren) {
67
+ if (child.type === 'implementation_definition') {
68
+ for (const implChild of child.namedChildren) {
69
+ if (implChild.type === 'method_definition') {
70
+ ctx.methods.push(_parseObjCMethodDef(implChild, catImplName));
71
+ }
72
+ }
73
+ }
74
+ }
75
+ break;
76
+ }
77
+ }
78
+ }
79
+ }
80
+
81
+ function _parseObjCInterface(node) {
82
+ const identifiers = node.namedChildren.filter((c) => c.type === 'identifier');
83
+ const name = identifiers[0]?.text || 'Unknown';
84
+
85
+ const isCategory =
86
+ node.text.includes('(') &&
87
+ identifiers.length >= 2 &&
88
+ node.text.indexOf('(') < node.text.indexOf(identifiers[1].text);
89
+
90
+ let superclass = null;
91
+ let categoryName = null;
92
+ if (isCategory) {
93
+ categoryName = identifiers[1]?.text;
94
+ } else if (identifiers.length >= 2) {
95
+ superclass = identifiers[1]?.text;
96
+ }
97
+
98
+ const protocols = [];
99
+ const protoList = node.namedChildren.find((c) => c.type === 'parameterized_arguments');
100
+ if (protoList) {
101
+ for (const child of protoList.namedChildren) {
102
+ if (child.type === 'type_name') {
103
+ const ti = child.namedChildren.find((c) => c.type === 'type_identifier');
104
+ if (ti) {
105
+ protocols.push(ti.text);
106
+ }
107
+ }
108
+ }
109
+ }
110
+
111
+ const methods = [];
112
+ for (const child of node.namedChildren) {
113
+ if (child.type === 'method_declaration') {
114
+ methods.push(_parseObjCMethodDecl(child, name));
115
+ }
116
+ }
117
+
118
+ const result = {
119
+ name,
120
+ superclass,
121
+ protocols,
122
+ isCategory,
123
+ line: node.startPosition.row + 1,
124
+ endLine: node.endPosition.row + 1,
125
+ };
126
+ if (isCategory) {
127
+ result.className = name;
128
+ result.categoryName = categoryName;
129
+ result.methods = methods;
130
+ }
131
+ return result;
132
+ }
133
+
134
+ function _parseObjCProtocol(node) {
135
+ const name = _findIdentifier(node) || 'Unknown';
136
+ const inherits = [];
137
+ const protoRef = node.namedChildren.find((c) => c.type === 'protocol_reference_list');
138
+ if (protoRef) {
139
+ for (const child of protoRef.namedChildren) {
140
+ if (child.type === 'identifier') {
141
+ inherits.push(child.text);
142
+ }
143
+ }
144
+ }
145
+
146
+ const methods = [];
147
+ let isOptional = false;
148
+ for (const child of node.namedChildren) {
149
+ if (child.type === 'qualified_protocol_interface_declaration') {
150
+ isOptional = true;
151
+ for (const sub of child.namedChildren) {
152
+ if (sub.type === 'method_declaration') {
153
+ const m = _parseObjCMethodDecl(sub, name);
154
+ m.isOptional = true;
155
+ methods.push(m);
156
+ }
157
+ }
158
+ } else if (child.type === 'method_declaration') {
159
+ const m = _parseObjCMethodDecl(child, name);
160
+ m.isOptional = isOptional;
161
+ methods.push(m);
162
+ }
163
+ }
164
+
165
+ return { name, inherits, methods, line: node.startPosition.row + 1 };
166
+ }
167
+
168
+ function _parseObjCMethodDecl(node, className) {
169
+ const isClassMethod = node.text.trimStart().startsWith('+');
170
+ const name = _findIdentifier(node) || 'unknown';
171
+
172
+ const params = [];
173
+ for (const child of node.namedChildren) {
174
+ if (child.type === 'method_parameter') {
175
+ const paramName = _findIdentifier(child);
176
+ params.push(paramName || '?');
177
+ }
178
+ }
179
+
180
+ let returnType = 'void';
181
+ const methodType = node.namedChildren.find((c) => c.type === 'method_type');
182
+ if (methodType) {
183
+ const tn = methodType.namedChildren.find((c) => c.type === 'type_name');
184
+ if (tn) {
185
+ const ti = tn.namedChildren.find(
186
+ (c) => c.type === 'type_identifier' || c.type === 'primitive_type'
187
+ );
188
+ if (ti) {
189
+ returnType = ti.text;
190
+ }
191
+ }
192
+ }
193
+
194
+ const selector =
195
+ params.length > 0
196
+ ? `${name}:${params
197
+ .slice(1)
198
+ .map((p) => `${p}:`)
199
+ .join('')}`
200
+ : name;
201
+
202
+ return {
203
+ name,
204
+ selector,
205
+ className,
206
+ isClassMethod,
207
+ returnType,
208
+ paramCount: params.length,
209
+ line: node.startPosition.row + 1,
210
+ kind: 'declaration',
211
+ };
212
+ }
213
+
214
+ function _parseObjCMethodDef(node, className) {
215
+ const isClassMethod = node.text.trimStart().startsWith('+');
216
+ const name = _findIdentifier(node) || 'unknown';
217
+
218
+ const params = [];
219
+ for (const child of node.namedChildren) {
220
+ if (child.type === 'method_parameter') {
221
+ const paramName = _findIdentifier(child);
222
+ params.push(paramName || '?');
223
+ }
224
+ }
225
+
226
+ const body = node.namedChildren.find((c) => c.type === 'compound_statement');
227
+ const bodyLines = body ? body.endPosition.row - body.startPosition.row + 1 : 0;
228
+ const complexity = body ? _estimateComplexity(body) : 1;
229
+ const nestingDepth = body ? _maxNesting(body, 0) : 0;
230
+
231
+ return {
232
+ name,
233
+ className,
234
+ isClassMethod,
235
+ paramCount: params.length,
236
+ bodyLines,
237
+ complexity,
238
+ nestingDepth,
239
+ line: node.startPosition.row + 1,
240
+ kind: 'definition',
241
+ };
242
+ }
243
+
244
+ function _parseObjCProperty(node, className) {
245
+ const attrs = [];
246
+ const attrDecl = node.namedChildren.find((c) => c.type === 'property_attributes_declaration');
247
+ if (attrDecl) {
248
+ for (const attr of attrDecl.namedChildren) {
249
+ if (attr.type === 'property_attribute') {
250
+ const id = attr.namedChildren.find((c) => c.type === 'identifier');
251
+ if (id) {
252
+ attrs.push(id.text);
253
+ }
254
+ }
255
+ }
256
+ }
257
+
258
+ let propName = 'unknown';
259
+ let propType = 'id';
260
+ const structDecl = node.namedChildren.find((c) => c.type === 'struct_declaration');
261
+ if (structDecl) {
262
+ const ti = structDecl.namedChildren.find((c) => c.type === 'type_identifier');
263
+ if (ti) {
264
+ propType = ti.text;
265
+ }
266
+
267
+ const sd = structDecl.namedChildren.find((c) => c.type === 'struct_declarator');
268
+ if (sd) {
269
+ const findName = (n) => {
270
+ if (n.type === 'identifier') {
271
+ return n.text;
272
+ }
273
+ for (let j = 0; j < n.namedChildCount; j++) {
274
+ const r = findName(n.namedChild(j));
275
+ if (r) {
276
+ return r;
277
+ }
278
+ }
279
+ return null;
280
+ };
281
+ propName = findName(sd) || propName;
282
+ }
283
+ }
284
+
285
+ return {
286
+ name: propName,
287
+ type: propType,
288
+ attributes: attrs,
289
+ className,
290
+ line: node.startPosition.row + 1,
291
+ };
292
+ }
293
+
294
+ // ── ObjC 模式检测 ──
295
+
296
+ function detectObjCPatterns(root, lang, methods, properties, classes) {
297
+ // ObjC 特有的模式检测交由 AstAnalyzer 内的通用 _detectPatterns 处理
298
+ // 此函数可扩展 ObjC 特有模式(如 Category 模式)
299
+ return [];
300
+ }
301
+
302
+ // ── 工具函数 ──
303
+
304
+ function _findIdentifier(node) {
305
+ for (let i = 0; i < node.namedChildCount; i++) {
306
+ const child = node.namedChild(i);
307
+ if (
308
+ child.type === 'identifier' ||
309
+ child.type === 'simple_identifier' ||
310
+ child.type === 'type_identifier'
311
+ ) {
312
+ return child.text;
313
+ }
314
+ }
315
+ return null;
316
+ }
317
+
318
+ function _estimateComplexity(node) {
319
+ let complexity = 1;
320
+ const BRANCH_TYPES = new Set([
321
+ 'if_statement',
322
+ 'for_statement',
323
+ 'for_in_statement',
324
+ 'while_statement',
325
+ 'switch_statement',
326
+ 'case_statement',
327
+ 'catch_clause',
328
+ 'conditional_expression',
329
+ 'ternary_expression',
330
+ 'guard_statement',
331
+ 'for_in_expression',
332
+ ]);
333
+ function walk(n) {
334
+ if (BRANCH_TYPES.has(n.type)) {
335
+ complexity++;
336
+ }
337
+ if (n.type === 'binary_expression') {
338
+ const op = n.children?.find(
339
+ (c) => c.type === '&&' || c.type === '||' || c.text === '&&' || c.text === '||'
340
+ );
341
+ if (op) {
342
+ complexity++;
343
+ }
344
+ }
345
+ for (let i = 0; i < n.namedChildCount; i++) {
346
+ walk(n.namedChild(i));
347
+ }
348
+ }
349
+ walk(node);
350
+ return complexity;
351
+ }
352
+
353
+ function _maxNesting(node, depth) {
354
+ const NESTING_TYPES = new Set([
355
+ 'if_statement',
356
+ 'for_statement',
357
+ 'for_in_statement',
358
+ 'while_statement',
359
+ 'switch_statement',
360
+ 'compound_statement',
361
+ ]);
362
+ let max = depth;
363
+ const nextDepth = NESTING_TYPES.has(node.type) ? depth + 1 : depth;
364
+ for (let i = 0; i < node.namedChildCount; i++) {
365
+ const childMax = _maxNesting(node.namedChild(i), nextDepth);
366
+ if (childMax > max) {
367
+ max = childMax;
368
+ }
369
+ }
370
+ return max;
371
+ }
372
+
373
+ // ── 插件导出 ──
374
+
375
+ let _grammar = null;
376
+ function getGrammar() {
377
+ if (!_grammar) {
378
+ _grammar = require('tree-sitter-objc');
379
+ }
380
+ return _grammar;
381
+ }
382
+
383
+ export const plugin = {
384
+ getGrammar,
385
+ walk: walkObjC,
386
+ detectPatterns: detectObjCPatterns,
387
+ extensions: ['.m', '.h', '.mm'],
388
+ };