pumuki 6.3.201 → 6.3.203

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

@@ -27,6 +27,7 @@ import {
   hasSwiftLegacyOnChangeUsage,
   hasSwiftLegacyExpectationDescriptionUsage,
   hasSwiftLegacySwiftUiObservableWrapperUsage,
+  hasSwiftMainThreadBlockingSleepUsage,
   hasSwiftMixedTestingFrameworksUsage,
   hasSwiftLegacyXCTestImportUsage,
   hasSwiftModernizableXCTestSuiteUsage,
@@ -43,6 +44,7 @@ import {
   hasSwiftOperationQueueUsage,
   hasSwiftContainsUserFilterUsage,
   hasSwiftPassedValueStateWrapperUsage,
+  hasSwiftPhysicalTextAlignmentUsage,
   hasSwiftPreconcurrencyUsage,
   hasSwiftSheetIsPresentedUsage,
   hasSwiftScrollViewShowsIndicatorsUsage,
@@ -335,6 +337,46 @@ let text = "UIFont.systemFont(ofSize: 16)"
   assert.equal(hasSwiftFixedFontSizeUsage(ignored), false);
 });
 
+test('detector iOS de localización detecta alineación física sin confundir leading/trailing', () => {
+  const source = `
+Text("Name").multilineTextAlignment(.left)
+Text("Price").frame(maxWidth: .infinity, alignment: .right)
+let textAlignment = TextAlignment.right
+label.textAlignment = NSTextAlignment.left
+`;
+  const ignored = `
+Text("Name").multilineTextAlignment(.leading)
+Text("Price").frame(maxWidth: .infinity, alignment: .trailing)
+let sample = "TextAlignment.right"
+// Text("Name").multilineTextAlignment(.left)
+`;
+
+  assert.equal(hasSwiftPhysicalTextAlignmentUsage(source), true);
+  assert.equal(hasSwiftPhysicalTextAlignmentUsage(ignored), false);
+});
+
+test('detector iOS de performance detecta sleeps bloqueantes sin confundir Task.sleep', () => {
+  const source = `
+final class SplashDelay {
+  func wait() {
+    Thread.sleep(forTimeInterval: 0.25)
+    sleep(1)
+    usleep(100)
+  }
+}
+`;
+  const ignored = `
+func wait() async throws {
+  try await Task.sleep(for: .seconds(1))
+  let text = "Thread.sleep(forTimeInterval: 1)"
+  // sleep(1)
+}
+`;
+
+  assert.equal(hasSwiftMainThreadBlockingSleepUsage(source), true);
+  assert.equal(hasSwiftMainThreadBlockingSleepUsage(ignored), false);
+});
+
 test('hasSwiftUncheckedSendableUsage detecta @unchecked Sendable', () => {
   const source = `
 final class LegacyBox: @unchecked Sendable {}

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

@@ -577,6 +577,37 @@ export const hasSwiftFixedFontSizeUsage = (source: string): boolean => {
   });
 };
 
+export const hasSwiftPhysicalTextAlignmentUsage = (source: string): boolean => {
+  const withoutBlockComments = source.replace(/\/\*[\s\S]*?\*\//g, '\n');
+  return withoutBlockComments.split(/\r?\n/).some((line) => {
+    if (/^\s*\/\//.test(line)) {
+      return false;
+    }
+    const sanitized = stripSwiftLineForSemanticScan(line);
+    return (
+      /\.\s*multilineTextAlignment\s*\(\s*\.\s*(?:left|right)\s*\)/.test(sanitized) ||
+      /\.\s*frame\s*\([^)]*alignment\s*:\s*\.\s*(?:left|right)\b/.test(sanitized) ||
+      /\bTextAlignment\s*\.\s*(?:left|right)\b/.test(sanitized) ||
+      /\bNSTextAlignment\s*\.\s*(?:left|right)\b/.test(sanitized)
+    );
+  });
+};
+
+export const hasSwiftMainThreadBlockingSleepUsage = (source: string): boolean => {
+  const withoutBlockComments = source.replace(/\/\*[\s\S]*?\*\//g, '\n');
+  return withoutBlockComments.split(/\r?\n/).some((line) => {
+    if (/^\s*\/\//.test(line)) {
+      return false;
+    }
+    const sanitized = stripSwiftLineForSemanticScan(line);
+    return (
+      /\bThread\s*\.\s*sleep\s*\(/.test(sanitized) ||
+      /(^|[^\w.])sleep\s*\(/.test(sanitized) ||
+      /(^|[^\w.])usleep\s*\(/.test(sanitized)
+    );
+  });
+};
+
 export const hasSwiftUncheckedSendableUsage = (source: string): boolean => {
   return scanCodeLikeSource(source, ({ source: swiftSource, index, current }) => {
     if (current !== '@' || !swiftSource.startsWith('@unchecked', index)) {

package/core/facts/extractHeuristicFacts.ts

@@ -657,6 +657,8 @@ const textDetectorRegistry: ReadonlyArray<TextDetectorRegistryEntry> = [
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftHardcodedUiStringUsage, ruleId: 'heuristics.ios.localization.hardcoded-ui-string.ast', code: 'HEURISTICS_IOS_LOCALIZATION_HARDCODED_UI_STRING_AST', message: 'AST heuristic detected hardcoded user-facing SwiftUI text; String(localized:) and String Catalogs remain the preferred baseline.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftLooseAssetResourceUsage, ruleId: 'heuristics.ios.assets.loose-resource.ast', code: 'HEURISTICS_IOS_ASSETS_LOOSE_RESOURCE_AST', message: 'AST heuristic detected loose image resource loading in iOS production code; Asset Catalogs remain the preferred baseline.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftFixedFontSizeUsage, ruleId: 'heuristics.ios.accessibility.fixed-font-size.ast', code: 'HEURISTICS_IOS_ACCESSIBILITY_FIXED_FONT_SIZE_AST', message: 'AST heuristic detected fixed font sizing in iOS production code; Dynamic Type semantic text styles remain the preferred baseline.' },
+  { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftPhysicalTextAlignmentUsage, ruleId: 'heuristics.ios.localization.physical-text-alignment.ast', code: 'HEURISTICS_IOS_LOCALIZATION_PHYSICAL_TEXT_ALIGNMENT_AST', message: 'AST heuristic detected physical left/right text alignment in iOS production code; leading/trailing remain the preferred RTL-safe baseline.' },
+  { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftMainThreadBlockingSleepUsage, ruleId: 'heuristics.ios.performance.blocking-sleep.ast', code: 'HEURISTICS_IOS_PERFORMANCE_BLOCKING_SLEEP_AST', message: 'AST heuristic detected blocking sleep usage in iOS production code; async clocks, suspension or cancellable scheduling remain the preferred baseline.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftUncheckedSendableUsage, ruleId: 'heuristics.ios.unchecked-sendable.ast', code: 'HEURISTICS_IOS_UNCHECKED_SENDABLE_AST', message: 'AST heuristic detected @unchecked Sendable usage.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftPreconcurrencyUsage, ruleId: 'heuristics.ios.preconcurrency.ast', code: 'HEURISTICS_IOS_PRECONCURRENCY_AST', message: 'AST heuristic detected @preconcurrency usage.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftNonisolatedUnsafeUsage, ruleId: 'heuristics.ios.nonisolated-unsafe.ast', code: 'HEURISTICS_IOS_NONISOLATED_UNSAFE_AST', message: 'AST heuristic detected nonisolated(unsafe) usage.' },

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, 55);
+  assert.equal(iosRules.length, 57);
 
   const ids = iosRules.map((rule) => rule.id);
   assert.deepEqual(ids, [
@@ -29,6 +29,8 @@ test('iosRules define reglas heurísticas locked para plataforma ios', () => {
     'heuristics.ios.localization.hardcoded-ui-string.ast',
     'heuristics.ios.assets.loose-resource.ast',
     'heuristics.ios.accessibility.fixed-font-size.ast',
+    'heuristics.ios.localization.physical-text-alignment.ast',
+    'heuristics.ios.performance.blocking-sleep.ast',
     'heuristics.ios.unchecked-sendable.ast',
     'heuristics.ios.preconcurrency.ast',
     'heuristics.ios.nonisolated-unsafe.ast',
@@ -121,6 +123,14 @@ test('iosRules define reglas heurísticas locked para plataforma ios', () => {
     byId.get('heuristics.ios.accessibility.fixed-font-size.ast')?.then.code,
     'HEURISTICS_IOS_ACCESSIBILITY_FIXED_FONT_SIZE_AST'
   );
+  assert.equal(
+    byId.get('heuristics.ios.localization.physical-text-alignment.ast')?.then.code,
+    'HEURISTICS_IOS_LOCALIZATION_PHYSICAL_TEXT_ALIGNMENT_AST'
+  );
+  assert.equal(
+    byId.get('heuristics.ios.performance.blocking-sleep.ast')?.then.code,
+    'HEURISTICS_IOS_PERFORMANCE_BLOCKING_SLEEP_AST'
+  );
   assert.equal(
     byId.get('heuristics.ios.preconcurrency.ast')?.then.code,
     'HEURISTICS_IOS_PRECONCURRENCY_AST'

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

@@ -397,6 +397,42 @@ export const iosRules: RuleSet = [
       code: 'HEURISTICS_IOS_ACCESSIBILITY_FIXED_FONT_SIZE_AST',
     },
   },
+  {
+    id: 'heuristics.ios.localization.physical-text-alignment.ast',
+    description: 'Detects physical left/right text alignment where leading/trailing are the preferred RTL-safe iOS baseline.',
+    severity: 'WARN',
+    platform: 'ios',
+    locked: true,
+    when: {
+      kind: 'Heuristic',
+      where: {
+        ruleId: 'heuristics.ios.localization.physical-text-alignment.ast',
+      },
+    },
+    then: {
+      kind: 'Finding',
+      message: 'AST heuristic detected physical left/right text alignment in iOS production code; leading/trailing remain the preferred RTL-safe baseline.',
+      code: 'HEURISTICS_IOS_LOCALIZATION_PHYSICAL_TEXT_ALIGNMENT_AST',
+    },
+  },
+  {
+    id: 'heuristics.ios.performance.blocking-sleep.ast',
+    description: 'Detects blocking sleep calls where cancellable async scheduling is the preferred iOS baseline.',
+    severity: 'WARN',
+    platform: 'ios',
+    locked: true,
+    when: {
+      kind: 'Heuristic',
+      where: {
+        ruleId: 'heuristics.ios.performance.blocking-sleep.ast',
+      },
+    },
+    then: {
+      kind: 'Finding',
+      message: 'AST heuristic detected blocking sleep usage in iOS production code; async clocks, suspension or cancellable scheduling remain the preferred baseline.',
+      code: 'HEURISTICS_IOS_PERFORMANCE_BLOCKING_SLEEP_AST',
+    },
+  },
   {
     id: 'heuristics.ios.unchecked-sendable.ast',
     description: 'Detects @unchecked Sendable usage in iOS production code.',

package/docs/codex-skills/ios-enterprise-rules.md

@@ -628,6 +628,16 @@ struct APIEndpoint: Sendable {
 - `skills.ios.guideline.ios.dynamic-type-fuentes-escalables-y-layouts-adaptativos` se mapea a `heuristics.ios.accessibility.fixed-font-size.ast`.
 - En `PROJECT MODE: brownfield`, este hallazgo detecta tamaños de fuente fijos (`.font(.system(size:))`, `Font.system(size:)`, `UIFont.systemFont(ofSize:)`) como señal de adopción hacia Dynamic Type y estilos semánticos. No marca `.font(.headline)`, `.font(.body)` ni otros estilos semánticos.
 
+### Enforcement AST inicial de RTL iOS
+
+- `skills.ios.guideline.ios.rtl-support-right-to-left-para-a-rabe-hebreo` se mapea a `heuristics.ios.localization.physical-text-alignment.ast`.
+- En `PROJECT MODE: brownfield`, este hallazgo detecta alineaciones físicas `.left`/`.right` en texto y frames (`multilineTextAlignment`, `frame(alignment:)`, `TextAlignment`, `NSTextAlignment`) como señal de adopción hacia `.leading`/`.trailing`. No marca `.leading` ni `.trailing`.
+
+### Enforcement AST inicial de bloqueo de thread iOS
+
+- `skills.ios.guideline.ios.background-threads-no-bloquear-main-thread` se mapea a `heuristics.ios.performance.blocking-sleep.ast`.
+- En `PROJECT MODE: brownfield`, este hallazgo detecta sleeps bloqueantes (`Thread.sleep`, `sleep`, `usleep`) en Swift production como señal de adopción hacia scheduling cancellable, clocks o suspensión asíncrona. No marca `Task.sleep`.
+
 ### Combine (Reactive):
 ✅ **Publishers** - AsyncSequence para async, Combine para streams complejos
 ✅ **@Published** - En ViewModels para binding con Views

package/integrations/config/skillsDetectorRegistry.ts

@@ -123,6 +123,14 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
     'ios.accessibility.fixed-font-size',
     ['heuristics.ios.accessibility.fixed-font-size.ast']
   ),
+  'skills.ios.guideline.ios.rtl-support-right-to-left-para-a-rabe-hebreo': heuristicDetector(
+    'ios.localization.physical-text-alignment',
+    ['heuristics.ios.localization.physical-text-alignment.ast']
+  ),
+  'skills.ios.guideline.ios.background-threads-no-bloquear-main-thread': heuristicDetector(
+    'ios.performance.blocking-sleep',
+    ['heuristics.ios.performance.blocking-sleep.ast']
+  ),
   'skills.ios.no-unchecked-sendable': heuristicDetector('ios.unchecked-sendable', [
     'heuristics.ios.unchecked-sendable.ast',
   ]),

package/integrations/config/skillsMarkdownRules.ts

@@ -404,6 +404,18 @@ const normalizeKnownRuleTarget = (
     if (includes('dynamic type')) {
       return 'skills.ios.guideline.ios.dynamic-type-font-scaling-automa-tico';
     }
+    if (includes('rtl support') || includes('right to left')) {
+      return 'skills.ios.guideline.ios.rtl-support-right-to-left-para-a-rabe-hebreo';
+    }
+    if (
+      includes('background threads') ||
+      includes('bloquear main thread') ||
+      includes('no bloquear main thread') ||
+      includes('thread.sleep') ||
+      includes('blocking sleep')
+    ) {
+      return 'skills.ios.guideline.ios.background-threads-no-bloquear-main-thread';
+    }
     if (
       includes('mixing legacy xctest style') ||
       includes('mixed xctest and swift testing') ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.201",
+  "version": "6.3.203",
   "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-13T11:41:29.067Z",
+  "generatedAt": "2026-05-13T11:57:22.186Z",
   "bundles": [
     {
       "name": "android-guidelines",
@@ -5764,7 +5764,7 @@
       "name": "ios-guidelines",
       "version": "1.0.0",
       "source": "file:vendor/skills/ios-enterprise-rules/SKILL.md",
-      "hash": "d38a68e751fd699460fb183c20c6d950e6e3d728e66d6d9e9de06a2f564cd574",
+      "hash": "54d70e010210d043da474f55a1031af4f0d897b30082dd522be5d85c44ba27ab",
       "rules": [
         {
           "id": "skills.ios.guideline.ios.accessibility-identifiers-para-localizar-elementos",
@@ -5967,7 +5967,7 @@
           "sourcePath": "vendor/skills/ios-enterprise-rules/SKILL.md",
           "confidence": "MEDIUM",
           "locked": true,
-          "evaluationMode": "DECLARATIVE",
+          "evaluationMode": "AUTO",
           "origin": "core"
         },
         {
@@ -7624,7 +7624,7 @@
           "sourcePath": "vendor/skills/ios-enterprise-rules/SKILL.md",
           "confidence": "MEDIUM",
           "locked": true,
-          "evaluationMode": "DECLARATIVE",
+          "evaluationMode": "AUTO",
           "origin": "core"
         },
         {