pumuki 6.3.229 → 6.3.231

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

@@ -15,6 +15,7 @@ import {
   hasSwiftAdHocLoggingUsage,
   hasSwiftAlamofireUsage,
   hasSwiftForEachIndicesUsage,
+  hasSwiftForEachSelfIdentityUsage,
   hasSwiftForceCastUsage,
   hasSwiftFontWeightBoldUsage,
   hasSwiftFixedFontSizeUsage,
@@ -64,6 +65,7 @@ import {
   hasSwiftSheetIsPresentedUsage,
   hasSwiftScrollViewShowsIndicatorsUsage,
   hasSwiftSensitiveLoggingUsage,
+  hasSwiftSelfPrintChangesUsage,
   hasSwiftSensitiveUserDefaultsStorageUsage,
   hasSwiftInsecureTransportUsage,
   hasSwiftJSONSerializationUsage,
@@ -292,6 +294,59 @@ struct CheckoutView: View {
   assert.equal(hasSwiftUiInlineActionLogicUsage(safe), false);
 });
 
+test('hasSwiftForEachSelfIdentityUsage detecta id self y preserva ids estables', () => {
+  const source = `
+struct FeedView: View {
+  let items: [Item]
+
+  var body: some View {
+    ForEach(items, id: \\.self) { item in
+      FeedRow(item: item)
+    }
+  }
+}
+`;
+  const safe = `
+struct FeedView: View {
+  let items: [Item]
+
+  var body: some View {
+    ForEach(items, id: \\.id) { item in
+      FeedRow(item: item)
+    }
+    let sample = "ForEach(items, id: \\.self) { item in FeedRow(item: item) }"
+    // ForEach(items, id: \.self) { item in FeedRow(item: item) }
+  }
+}
+`;
+
+  assert.equal(hasSwiftForEachSelfIdentityUsage(source), true);
+  assert.equal(hasSwiftForEachSelfIdentityUsage(safe), false);
+});
+
+test('hasSwiftSelfPrintChangesUsage detecta Self._printChanges y preserva strings y comentarios', () => {
+  const source = `
+struct FeedView: View {
+  var body: some View {
+    Self._printChanges()
+    Text("Feed")
+  }
+}
+`;
+  const safe = `
+struct FeedView: View {
+  var body: some View {
+    Text("Feed")
+    let sample = "Self._printChanges()"
+    // Self._printChanges()
+  }
+}
+`;
+
+  assert.equal(hasSwiftSelfPrintChangesUsage(source), true);
+  assert.equal(hasSwiftSelfPrintChangesUsage(safe), false);
+});
+
 test('hasSwiftUntypedNavigationLinkDestinationUsage detecta NavigationLink no tipado y preserva value navigation', () => {
   const source = `
 struct FeedView: View {

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

@@ -849,6 +849,14 @@ export const hasSwiftForEachIndicesUsage = (source: string): boolean => {
   );
 };
 
+export const hasSwiftForEachSelfIdentityUsage = (source: string): boolean => {
+  return hasSwiftSanitizedRegexMatch(source, /\bForEach\s*\([^)]*\bid\s*:\s*\\\.self\b/g);
+};
+
+export const hasSwiftSelfPrintChangesUsage = (source: string): boolean => {
+  return hasSwiftSanitizedRegexMatch(source, /\bSelf\s*\.\s*_printChanges\s*\(/g);
+};
+
 export const hasSwiftInlineForEachTransformUsage = (source: string): boolean => {
   const sanitized = sanitizeSwiftSourceForMultilineRegex(source);
   return /\bForEach\s*\(\s*(?:Array\s*\(\s*)?[A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)*\s*\.\s*(?:filter|map|compactMap|sorted)\s*(?:\{|\()/g.test(

package/core/facts/extractHeuristicFacts.ts

@@ -678,6 +678,8 @@ const textDetectorRegistry: ReadonlyArray<TextDetectorRegistryEntry> = [
   { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftNonPrivateStateOwnershipUsage, ruleId: 'heuristics.ios.swiftui.non-private-state-ownership.ast', code: 'HEURISTICS_IOS_SWIFTUI_NON_PRIVATE_STATE_OWNERSHIP_AST', message: 'AST heuristic detected @State/@StateObject without private visibility; SwiftUI owned state should be private.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftPassedValueStateWrapperUsage, ruleId: 'heuristics.ios.passed-value-state-wrapper.ast', code: 'HEURISTICS_IOS_PASSED_VALUE_STATE_WRAPPER_AST', message: 'AST heuristic detected a passed value stored as @State/@StateObject via init wrapper ownership.' },
   { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftForEachIndicesUsage, ruleId: 'heuristics.ios.foreach-indices.ast', code: 'HEURISTICS_IOS_FOREACH_INDICES_AST', message: 'AST heuristic detected ForEach(...indices...) usage where stable element identity may be preferred.' },
+  { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftForEachSelfIdentityUsage, ruleId: 'heuristics.ios.swiftui.foreach-self-identity.ast', code: 'HEURISTICS_IOS_SWIFTUI_FOREACH_SELF_IDENTITY_AST', message: 'AST heuristic detected ForEach(..., id: \.self) usage; prefer a stable domain identity such as id: \.id or Identifiable models.' },
+  { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftSelfPrintChangesUsage, ruleId: 'heuristics.ios.swiftui.self-print-changes.ast', code: 'HEURISTICS_IOS_SWIFTUI_SELF_PRINT_CHANGES_AST', message: 'AST heuristic detected Self._printChanges() in SwiftUI presentation; keep this debugging helper out of production view code.' },
   { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftInlineForEachTransformUsage, ruleId: 'heuristics.ios.swiftui.inline-foreach-transform.ast', code: 'HEURISTICS_IOS_SWIFTUI_INLINE_FOREACH_TRANSFORM_AST', message: 'AST heuristic detected inline filter/map/sort work inside ForEach; prefiltered or cached collections remain the preferred baseline.' },
   { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftUiForEachConditionalViewCountUsage, ruleId: 'heuristics.ios.swiftui.foreach-conditional-view-count.ast', code: 'HEURISTICS_IOS_SWIFTUI_FOREACH_CONDITIONAL_VIEW_COUNT_AST', message: 'AST heuristic detected conditional view count inside ForEach; keep a constant number of views per element by moving branching into row views or modifiers.' },
   { platform: 'ios', pathCheck: isIOSApplicationOrPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftContainsUserFilterUsage, ruleId: 'heuristics.ios.contains-user-filter.ast', code: 'HEURISTICS_IOS_CONTAINS_USER_FILTER_AST', message: 'AST heuristic detected contains() in a user-facing filter where localizedStandardContains() may be preferred.' },

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

@@ -785,6 +785,25 @@ export const iosRules: RuleSet = [
       code: 'HEURISTICS_IOS_FOREACH_INDICES_AST',
     },
   },
+  {
+    id: 'heuristics.ios.swiftui.foreach-self-identity.ast',
+    description: 'Detects SwiftUI ForEach usage with id: \.self instead of stable domain identity.',
+    severity: 'WARN',
+    platform: 'ios',
+    locked: true,
+    when: {
+      kind: 'Heuristic',
+      where: {
+        ruleId: 'heuristics.ios.swiftui.foreach-self-identity.ast',
+      },
+    },
+    then: {
+      kind: 'Finding',
+      message:
+        'AST heuristic detected ForEach(..., id: \.self) usage; prefer a stable domain identity such as id: \.id or Identifiable models.',
+      code: 'HEURISTICS_IOS_SWIFTUI_FOREACH_SELF_IDENTITY_AST',
+    },
+  },
   {
     id: 'heuristics.ios.swiftui.inline-foreach-transform.ast',
     description: 'Detects inline filter/map/sort transformations inside SwiftUI ForEach calls.',
@@ -803,6 +822,25 @@ export const iosRules: RuleSet = [
       code: 'HEURISTICS_IOS_SWIFTUI_INLINE_FOREACH_TRANSFORM_AST',
     },
   },
+  {
+    id: 'heuristics.ios.swiftui.self-print-changes.ast',
+    description: 'Detects SwiftUI Self._printChanges() debugging helpers in production views.',
+    severity: 'WARN',
+    platform: 'ios',
+    locked: true,
+    when: {
+      kind: 'Heuristic',
+      where: {
+        ruleId: 'heuristics.ios.swiftui.self-print-changes.ast',
+      },
+    },
+    then: {
+      kind: 'Finding',
+      message:
+        'AST heuristic detected Self._printChanges() in SwiftUI presentation code; remove debug-only render diagnostics from production views.',
+      code: 'HEURISTICS_IOS_SWIFTUI_SELF_PRINT_CHANGES_AST',
+    },
+  },
   {
     id: 'heuristics.ios.swiftui.foreach-conditional-view-count.ast',
     description: 'Detects conditional view counts inside SwiftUI ForEach rows.',

package/integrations/config/skillsDetectorRegistry.ts

@@ -233,6 +233,18 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
   'skills.ios.no-foreach-indices': heuristicDetector('ios.foreach-indices', [
     'heuristics.ios.foreach-indices.ast',
   ]),
+  'skills.ios.guideline.ios-swiftui-expert.ensure-foreach-uses-stable-identity-see-references-list-patterns-md':
+    heuristicDetector('ios.swiftui.foreach-self-identity', [
+      'heuristics.ios.swiftui.foreach-self-identity.ast',
+    ]),
+  'skills.ios.guideline.ios-swiftui-expert.verify-list-patterns-use-stable-identity-see-references-list-patterns-':
+    heuristicDetector('ios.swiftui.foreach-self-identity', [
+      'heuristics.ios.swiftui.foreach-self-identity.ast',
+    ]),
+  'skills.ios.guideline.ios-swiftui-expert.use-self-printchanges-to-debug-unexpected-view-updates':
+    heuristicDetector('ios.swiftui.self-print-changes', [
+      'heuristics.ios.swiftui.self-print-changes.ast',
+    ]),
   'skills.ios.guideline.ios-swiftui-expert.avoid-inline-filtering-in-foreach-prefilter-and-cache':
     heuristicDetector('ios.swiftui.inline-foreach-transform', [
       'heuristics.ios.swiftui.inline-foreach-transform.ast',

package/integrations/config/skillsMarkdownRules.ts

@@ -316,6 +316,18 @@ const normalizeKnownRuleTarget = (
     ) {
       return 'skills.ios.no-foreach-indices';
     }
+    if (
+      (includes('foreach') && includes('stable identity')) ||
+      (includes('list patterns') && includes('stable identity'))
+    ) {
+      if (includes('verify list patterns')) {
+        return 'skills.ios.guideline.ios-swiftui-expert.verify-list-patterns-use-stable-identity-see-references-list-patterns-';
+      }
+      return 'skills.ios.guideline.ios-swiftui-expert.ensure-foreach-uses-stable-identity-see-references-list-patterns-md';
+    }
+    if (includes('self.printchanges') || includes('unexpected view updates')) {
+      return 'skills.ios.guideline.ios-swiftui-expert.use-self-printchanges-to-debug-unexpected-view-updates';
+    }
     if (
       (includes('inline filtering') && includes('foreach')) ||
       (includes('no inline filtering') && includes('foreach')) ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.229",
+  "version": "6.3.231",
   "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-13T16:44:08.385Z",
+  "generatedAt": "2026-05-13T16:57:01.364Z",
   "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": "92aa9bdb43b5641206e53aaba4647a5c88b88a7aca83dc00eea373d5e70b7080",
+      "hash": "4ea50faf9594602eefa6711b818cf4badeb2014ca64eaf00cb2f98f3e11a55f0",
       "rules": [
         {
           "id": "skills.ios.guideline.ios-swiftui-expert.action-handlers-should-reference-methods-not-contain-inline-logic",
@@ -8691,7 +8691,7 @@
           "sourcePath": "vendor/skills/swiftui-expert-skill/SKILL.md",
           "confidence": "MEDIUM",
           "locked": true,
-          "evaluationMode": "DECLARATIVE",
+          "evaluationMode": "AUTO",
           "origin": "core"
         },
         {
@@ -8931,7 +8931,7 @@
           "sourcePath": "vendor/skills/swiftui-expert-skill/SKILL.md",
           "confidence": "MEDIUM",
           "locked": true,
-          "evaluationMode": "DECLARATIVE",
+          "evaluationMode": "AUTO",
           "origin": "core"
         },
         {
@@ -8979,7 +8979,7 @@
           "sourcePath": "vendor/skills/swiftui-expert-skill/SKILL.md",
           "confidence": "MEDIUM",
           "locked": true,
-          "evaluationMode": "DECLARATIVE",
+          "evaluationMode": "AUTO",
           "origin": "core"
         },
         {