pumuki 6.3.240 → 6.3.242

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [6.3.242] - 2026-05-14
+
+### Added
+
+- **SwiftUI Observable shared-state parity:** `skills.ios.guideline.ios-swiftui-expert.use-observable-for-shared-state-with-mainactor-if-not-using-default-ac` now maps to the existing AUTO `ObservableObject` heuristic, converting the shared-state migration guideline into runtime evidence without introducing actor-isolation false positives.
+
+## [6.3.241] - 2026-05-14
+
+### Added
+
+- **SwiftUI `.task(id:)` parity:** `skills.ios.guideline.ios-swiftui-expert.use-task-id-for-value-dependent-tasks` now maps to an AUTO heuristic that detects `Task` launched from SwiftUI `onChange`, while preserving `.task(id:)` as the clean lifecycle-aware pattern.
+
 ## [6.3.127] - 2026-04-28
 
 ### Fixed

package/core/facts/detectors/text/ios.test.ts

@@ -54,6 +54,7 @@ import {
   hasSwiftNonPrivateStateOwnershipUsage,
   hasSwiftNonIBOutletImplicitlyUnwrappedOptionalUsage,
   hasSwiftObservableObjectUsage,
+  hasSwiftOnChangeTaskUsage,
   hasSwiftOnAppearTaskUsage,
   hasSwiftOnTapGestureUsage,
   hasSwiftOperationQueueUsage,
@@ -507,6 +508,43 @@ struct FeedView: View {
   assert.equal(hasSwiftOnAppearTaskUsage(safe), false);
 });
 
+test('hasSwiftOnChangeTaskUsage detecta Task dentro de onChange y preserva task id', () => {
+  const source = `
+struct SearchView: View {
+  @State private var query = ""
+
+  var body: some View {
+    TextField("Search", text: $query)
+      .onChange(of: query) { _, newValue in
+        Task {
+          await viewModel.search(newValue)
+        }
+      }
+  }
+}
+`;
+  const safe = `
+struct SearchView: View {
+  @State private var query = ""
+
+  var body: some View {
+    TextField("Search", text: $query)
+      .task(id: query) {
+        await viewModel.search(query)
+      }
+      .onChange(of: query) { _, newValue in
+        analytics.trackSearch(newValue)
+      }
+      let text = ".onChange(of: query) { Task { await search() } }"
+      // .onChange(of: query) { Task { await search() } }
+  }
+}
+`;
+
+  assert.equal(hasSwiftOnChangeTaskUsage(source), true);
+  assert.equal(hasSwiftOnChangeTaskUsage(safe), false);
+});
+
 test('hasSwiftStrongDelegateReferenceUsage detecta delegates fuertes y preserva weak delegates', () => {
   const positive = `
 final class CheckoutCoordinator {

package/core/facts/detectors/text/ios.ts

@@ -481,6 +481,13 @@ export const hasSwiftOnAppearTaskUsage = (source: string): boolean => {
   return /\.onAppear\s*\{[\s\S]{0,500}?\bTask\s*(?:\([^)]*\))?\s*\{/.test(sanitized);
 };
 
+export const hasSwiftOnChangeTaskUsage = (source: string): boolean => {
+  const sanitized = sanitizeSwiftSourceForMultilineRegex(source);
+  return /\.onChange\s*\([^)]*\)\s*\{[\s\S]{0,500}?\bTask\s*(?:\([^)]*\))?\s*\{/.test(
+    sanitized
+  );
+};
+
 export const hasSwiftStrongDelegateReferenceUsage = (source: string): boolean => {
   const delegatePropertyPattern =
     /\b(?:var|let)\s+(?:[A-Za-z_][A-Za-z0-9_]*(?:Delegate|DataSource)|delegate|dataSource)\s*:\s*(?:any\s+)?[A-Za-z_][A-Za-z0-9_]*(?:Delegate|DataSource)\b/;

package/core/facts/extractHeuristicFacts.ts

@@ -647,6 +647,7 @@ const textDetectorRegistry: ReadonlyArray<TextDetectorRegistryEntry> = [
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftOperationQueueUsage, ruleId: 'heuristics.ios.operation-queue.ast', code: 'HEURISTICS_IOS_OPERATION_QUEUE_AST', message: 'AST heuristic detected OperationQueue usage.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftTaskDetachedUsage, ruleId: 'heuristics.ios.task-detached.ast', code: 'HEURISTICS_IOS_TASK_DETACHED_AST', message: 'AST heuristic detected Task.detached usage.' },
   { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftOnAppearTaskUsage, ruleId: 'heuristics.ios.swiftui.onappear-task.ast', code: 'HEURISTICS_IOS_SWIFTUI_ONAPPEAR_TASK_AST', message: 'AST heuristic detected Task launched from SwiftUI onAppear; .task/.task(id:) provides lifecycle-aware cancellation.' },
+  { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftOnChangeTaskUsage, ruleId: 'heuristics.ios.swiftui.onchange-task.ast', code: 'HEURISTICS_IOS_SWIFTUI_ONCHANGE_TASK_AST', message: 'AST heuristic detected Task launched from SwiftUI onChange; .task(id:) provides lifecycle-aware cancellation for value-dependent async work.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftStrongDelegateReferenceUsage, ruleId: 'heuristics.ios.memory.strong-delegate.ast', code: 'HEURISTICS_IOS_MEMORY_STRONG_DELEGATE_AST', message: 'AST heuristic detected a strong delegate/dataSource reference; weak delegates remain the preferred baseline to avoid retain cycles.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftStrongSelfEscapingClosureUsage, ruleId: 'heuristics.ios.memory.strong-self-escaping-closure.ast', code: 'HEURISTICS_IOS_MEMORY_STRONG_SELF_ESCAPING_CLOSURE_AST', message: 'AST heuristic detected strong self capture in an escaping iOS closure; weak or unowned captures remain the preferred baseline when ownership is not explicit.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftCustomSingletonUsage, ruleId: 'heuristics.ios.architecture.custom-singleton.ast', code: 'HEURISTICS_IOS_ARCHITECTURE_CUSTOM_SINGLETON_AST', message: 'AST heuristic detected a custom static shared singleton in iOS production code; dependency injection remains the preferred baseline for app-owned services.' },

package/core/rules/presets/heuristics/ios.test.ts

@@ -3,7 +3,7 @@ import test from 'node:test';
 import { iosRules } from './ios';
 
 test('iosRules define reglas heurísticas locked para plataforma ios', () => {
-  assert.equal(iosRules.length, 82);
+  assert.equal(iosRules.length, 83);
 
   const ids = iosRules.map((rule) => rule.id);
   assert.deepEqual(ids, [
@@ -18,6 +18,7 @@ test('iosRules define reglas heurísticas locked para plataforma ios', () => {
     'heuristics.ios.operation-queue.ast',
     'heuristics.ios.task-detached.ast',
     'heuristics.ios.swiftui.onappear-task.ast',
+    'heuristics.ios.swiftui.onchange-task.ast',
     'heuristics.ios.memory.strong-delegate.ast',
     'heuristics.ios.memory.strong-self-escaping-closure.ast',
     'heuristics.ios.architecture.custom-singleton.ast',
@@ -100,6 +101,10 @@ test('iosRules define reglas heurísticas locked para plataforma ios', () => {
     byId.get('heuristics.ios.task-detached.ast')?.then.code,
     'HEURISTICS_IOS_TASK_DETACHED_AST'
   );
+  assert.equal(
+    byId.get('heuristics.ios.swiftui.onchange-task.ast')?.then.code,
+    'HEURISTICS_IOS_SWIFTUI_ONCHANGE_TASK_AST'
+  );
   assert.equal(
     byId.get('heuristics.ios.logging.adhoc-print.ast')?.then.code,
     'HEURISTICS_IOS_LOGGING_ADHOC_PRINT_AST'

package/core/rules/presets/heuristics/ios.ts

@@ -200,6 +200,26 @@ export const iosRules: RuleSet = [
       code: 'HEURISTICS_IOS_SWIFTUI_ONAPPEAR_TASK_AST',
     },
   },
+  {
+    id: 'heuristics.ios.swiftui.onchange-task.ast',
+    description:
+      'Detects Task launches from SwiftUI onChange where .task(id:) should own value-dependent cancellation.',
+    severity: 'WARN',
+    platform: 'ios',
+    locked: true,
+    when: {
+      kind: 'Heuristic',
+      where: {
+        ruleId: 'heuristics.ios.swiftui.onchange-task.ast',
+      },
+    },
+    then: {
+      kind: 'Finding',
+      message:
+        'AST heuristic detected Task launched from SwiftUI onChange; .task(id:) should own value-dependent cancellation.',
+      code: 'HEURISTICS_IOS_SWIFTUI_ONCHANGE_TASK_AST',
+    },
+  },
   {
     id: 'heuristics.ios.memory.strong-delegate.ast',
     description: 'Detects strong delegate/dataSource references in iOS production code.',

package/integrations/config/skillsDetectorRegistry.ts

@@ -201,6 +201,8 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
   'skills.ios.no-observable-object': heuristicDetector('ios.observable-object', [
     'heuristics.ios.observable-object.ast',
   ]),
+  'skills.ios.guideline.ios-swiftui-expert.use-observable-for-shared-state-with-mainactor-if-not-using-default-ac':
+    heuristicDetector('ios.observable-object', ['heuristics.ios.observable-object.ast']),
   'skills.ios.no-legacy-swiftui-observable-wrapper': heuristicDetector(
     'ios.legacy-swiftui-observable-wrapper',
     ['heuristics.ios.legacy-swiftui-observable-wrapper.ast']
@@ -312,6 +314,10 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
     'ios.swiftui.onappear-task',
     ['heuristics.ios.swiftui.onappear-task.ast']
   ),
+  'skills.ios.guideline.ios-swiftui-expert.use-task-id-for-value-dependent-tasks': heuristicDetector(
+    'ios.swiftui.onchange-task',
+    ['heuristics.ios.swiftui.onchange-task.ast']
+  ),
   'skills.ios.no-uiscreen-main-bounds': heuristicDetector('ios.uiscreen-main-bounds', [
     'heuristics.ios.uiscreen-main-bounds.ast',
   ]),

package/integrations/config/skillsMarkdownRules.ts

@@ -253,6 +253,13 @@ const normalizeKnownRuleTarget = (
     if (includes('observableobject') || includes('observable object')) {
       return 'skills.ios.no-observable-object';
     }
+    if (
+      (includes('@observable') || includes('observable')) &&
+      includes('shared state') &&
+      includes('mainactor')
+    ) {
+      return 'skills.ios.guideline.ios-swiftui-expert.use-observable-for-shared-state-with-mainactor-if-not-using-default-ac';
+    }
     if (
       includes('observedobject') ||
       (includes('legacy') && includes('stateobject')) ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.240",
+  "version": "6.3.242",
   "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
   "main": "index.js",
   "bin": {

package/skills.lock.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0",
   "compilerVersion": "1.0.0",
-  "generatedAt": "2026-05-13T18:33:35.600Z",
+  "generatedAt": "2026-05-14T07:00:57.248Z",
   "bundles": [
     {
       "name": "android-guidelines",
@@ -8620,7 +8620,7 @@
       "name": "ios-swiftui-expert-guidelines",
       "version": "1.0.0",
       "source": "file:vendor/skills/swiftui-expert-skill/SKILL.md",
-      "hash": "4ea50faf9594602eefa6711b818cf4badeb2014ca64eaf00cb2f98f3e11a55f0",
+      "hash": "eec9633ddf388ee680cf4bd74c4e52f9112d1925bea59f50d482c47d1aba59f4",
       "rules": [
         {
           "id": "skills.ios.guideline.ios-swiftui-expert.action-handlers-should-reference-methods-not-contain-inline-logic",
@@ -8895,7 +8895,7 @@
           "sourcePath": "vendor/skills/swiftui-expert-skill/SKILL.md",
           "confidence": "MEDIUM",
           "locked": true,
-          "evaluationMode": "DECLARATIVE",
+          "evaluationMode": "AUTO",
           "origin": "core"
         },
         {