pumuki 6.3.301 → 6.3.302

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

@@ -32,6 +32,7 @@ import {
   hasSwiftDispatchSemaphoreUsage,
   hasSwiftAdHocLoggingUsage,
   hasSwiftAlamofireUsage,
+  collectSwiftComposableArchitectureUsageLines,
   hasSwiftEmptyCatchUsage,
   collectSwiftNSErrorThrowLines,
   hasSwiftNSErrorThrowUsage,
@@ -155,6 +156,7 @@ import {
   hasSwiftStrongDelegateReferenceUsage,
   hasSwiftStrongSelfEscapingClosureUsage,
   hasSwiftSwinjectUsage,
+  hasSwiftComposableArchitectureUsage,
   hasSwiftTabItemUsage,
   hasSwiftTaskDetachedUsage,
   hasSwiftUnownedSelfCaptureUsage,
@@ -1296,6 +1298,55 @@ let text = "import Swinject"
   assert.equal(hasSwiftSwinjectUsage(ignored), false);
 });
 
+test('hasSwiftComposableArchitectureUsage detecta TCA y preserva arquitectura nativa', () => {
+  const source = `
+import SwiftUI
+import ComposableArchitecture
+
+struct CheckoutFeature: Reducer {
+  struct State: Equatable {}
+  enum Action {}
+  var body: some ReducerOf<Self> {
+    Reduce { state, action in .none }
+  }
+}
+
+struct CheckoutView: View {
+  let store: StoreOf<CheckoutFeature>
+  var body: some View {
+    WithViewStore(store, observe: { $0 }) { viewStore in
+      Text("Checkout")
+    }
+  }
+}
+`;
+  const native = `
+import SwiftUI
+
+@Observable
+final class CheckoutViewModel {
+  func submit() async {}
+}
+
+struct CheckoutView: View {
+  @State private var model = CheckoutViewModel()
+  var body: some View {
+    Button("Checkout") { Task { await model.submit() } }
+  }
+}
+`;
+  const ignored = `
+let sample = "import ComposableArchitecture"
+// let store: StoreOf<CheckoutFeature>
+`;
+
+  assert.equal(hasSwiftComposableArchitectureUsage(source), true);
+  assert.deepEqual(collectSwiftComposableArchitectureUsageLines(source), [3, 8, 14]);
+  assert.equal(hasSwiftComposableArchitectureUsage(native), false);
+  assert.equal(hasSwiftComposableArchitectureUsage(ignored), false);
+  assert.deepEqual(collectSwiftComposableArchitectureUsageLines(ignored), []);
+});
+
 test('hasSwiftMassiveViewControllerResponsibilityUsage detecta ViewControllers con acceso directo a infraestructura', () => {
   const source = `
 final class CheckoutViewController: UIViewController {

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

@@ -1154,6 +1154,18 @@ export const hasSwiftSwinjectUsage = (source: string): boolean => {
   );
 };
 
+export const collectSwiftComposableArchitectureUsageLines = (source: string): readonly number[] => {
+  return sortedUniqueLines([
+    ...collectSwiftRegexLines(source, /\bimport\s+ComposableArchitecture\b/),
+    ...collectSwiftRegexLines(source, /\b(?:StoreOf|ViewStore|WithViewStore|ReducerOf)\s*</),
+    ...collectSwiftRegexLines(source, /\b(?:Store|Reducer|Effect|TestStore)\s*</),
+  ]);
+};
+
+export const hasSwiftComposableArchitectureUsage = (source: string): boolean => {
+  return collectSwiftComposableArchitectureUsageLines(source).length > 0;
+};
+
 export const hasSwiftMassiveViewControllerResponsibilityUsage = (source: string): boolean => {
   const sanitized = sanitizeSwiftSourceForMultilineRegex(source);
   const viewControllerPattern =

package/core/facts/extractHeuristicFacts.ts

@@ -787,6 +787,7 @@ const textDetectorRegistry: ReadonlyArray<TextDetectorRegistryEntry> = [
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftWarningSuppressionUsage, locateLines: TextIOS.collectSwiftWarningSuppressionLines, primaryNode: (lines) => ({ kind: 'member', name: 'Swift warning or lint suppression directive', lines }), relatedNodes: (lines) => [{ kind: 'member', name: 'replacement: fix the warned code or configure the exception centrally', lines }], why: 'Local warning and lint suppressions hide code-quality failures from the normal compiler/tooling feedback loop.', impact: 'Suppressed diagnostics can turn into future errors or let unsafe production code bypass Pumuki and repository skills without a visible remediation path.', expected_fix: 'Remove local swiftlint/swiftformat/periphery disable directives and #warning markers by fixing the underlying code, or move a justified project-wide exception into policy/config with traceability.', ruleId: 'heuristics.ios.maintainability.warning-suppression.ast', code: 'HEURISTICS_IOS_MAINTAINABILITY_WARNING_SUPPRESSION_AST', message: 'AST heuristic detected local warning/lint suppression in iOS production code; fix the underlying issue instead of hiding diagnostics.' },
   { 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.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftSwinjectUsage, ruleId: 'heuristics.ios.architecture.swinject.ast', code: 'HEURISTICS_IOS_ARCHITECTURE_SWINJECT_AST', message: 'AST heuristic detected Swinject usage; manual dependency injection or SwiftUI Environment remain the preferred native baseline.' },
+  { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftComposableArchitectureUsage, locateLines: TextIOS.collectSwiftComposableArchitectureUsageLines, primaryNode: (lines) => ({ kind: 'call', name: 'Composable Architecture dependency node', lines }), relatedNodes: (lines) => [{ kind: 'call', name: 'replacement: native SwiftUI state, use case, actor or environment boundary', lines }], why: 'The iOS skill baseline prefers native SwiftUI, structured concurrency and explicit architecture boundaries over third-party TCA runtime primitives.', impact: 'TCA imports and Store/Reducer nodes introduce a non-native dependency model that can bypass the repository architecture contract and make remediation depend on framework-specific DSL semantics.', expected_fix: 'Replace ComposableArchitecture usage with native SwiftUI state, @Observable view models, use cases, actors and explicit Environment/dependency boundaries approved by the repo.', ruleId: 'heuristics.ios.architecture.tca-composable-architecture.ast', code: 'HEURISTICS_IOS_ARCHITECTURE_TCA_COMPOSABLE_ARCHITECTURE_AST', message: 'AST heuristic detected The Composable Architecture usage in iOS production code; use native SwiftUI and explicit architecture boundaries.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftMassiveViewControllerResponsibilityUsage, ruleId: 'heuristics.ios.architecture.massive-view-controller.ast', code: 'HEURISTICS_IOS_ARCHITECTURE_MASSIVE_VIEW_CONTROLLER_AST', message: 'AST heuristic detected a UIViewController with direct infrastructure/data access; move data access behind application/domain boundaries.' },
   { platform: 'ios', pathCheck: isIOSSwiftPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftNonIBOutletImplicitlyUnwrappedOptionalUsage, ruleId: 'heuristics.ios.safety.non-iboutlet-iuo.ast', code: 'HEURISTICS_IOS_SAFETY_NON_IBOUTLET_IUO_AST', message: 'AST heuristic detected an implicitly unwrapped optional outside IBOutlet wiring; explicit optionals or initialization guarantees remain the preferred baseline.' },
   { platform: 'ios', pathCheck: isIOSPresentationPath, excludePaths: [isSwiftTestPath], detect: TextIOS.hasSwiftMagicNumberLayoutUsage, locateLines: TextIOS.collectSwiftMagicNumberLayoutLines, primaryNode: (lines) => ({ kind: 'call', name: 'SwiftUI layout numeric literal', lines }), relatedNodes: (lines) => [{ kind: 'property', name: 'replacement: named metric constant or design token', lines }], why: 'Inline numeric layout literals hide design intent and make visual remediation dependent on scanning the whole view body.', impact: 'Pixel-perfect slices can be blocked without a concrete node unless the finding points to the exact spacing, frame or padding call to fix.', expected_fix: 'Move repeated or meaningful layout numbers into named constants or design tokens, or use relative layout APIs when the number encodes screen geometry.', ruleId: 'heuristics.ios.maintainability.magic-number-layout.ast', code: 'HEURISTICS_IOS_MAINTAINABILITY_MAGIC_NUMBER_LAYOUT_AST', message: 'AST heuristic detected SwiftUI layout magic numbers; named constants or design tokens remain the preferred baseline.' },

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, 117);
+  assert.equal(iosRules.length, 118);
 
   const ids = iosRules.map((rule) => rule.id);
   assert.deepEqual(ids, [
@@ -36,6 +36,7 @@ test('iosRules define reglas heurísticas locked para plataforma ios', () => {
     'heuristics.ios.maintainability.warning-suppression.ast',
     'heuristics.ios.architecture.custom-singleton.ast',
     'heuristics.ios.architecture.swinject.ast',
+    'heuristics.ios.architecture.tca-composable-architecture.ast',
     'heuristics.ios.architecture.massive-view-controller.ast',
     'heuristics.ios.maintainability.magic-number-layout.ast',
     'heuristics.ios.uikit.manual-frame-layout.ast',
@@ -235,6 +236,10 @@ test('iosRules define reglas heurísticas locked para plataforma ios', () => {
     byId.get('heuristics.ios.networking.alamofire.ast')?.then.code,
     'HEURISTICS_IOS_NETWORKING_ALAMOFIRE_AST'
   );
+  assert.equal(
+    byId.get('heuristics.ios.architecture.tca-composable-architecture.ast')?.then.code,
+    'HEURISTICS_IOS_ARCHITECTURE_TCA_COMPOSABLE_ARCHITECTURE_AST'
+  );
   assert.equal(
     byId.get('heuristics.ios.json.jsonserialization.ast')?.then.code,
     'HEURISTICS_IOS_JSON_JSONSERIALIZATION_AST'

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

@@ -539,6 +539,25 @@ export const iosRules: RuleSet = [
       code: 'HEURISTICS_IOS_ARCHITECTURE_SWINJECT_AST',
     },
   },
+  {
+    id: 'heuristics.ios.architecture.tca-composable-architecture.ast',
+    description: 'Detects The Composable Architecture usage in iOS production code.',
+    severity: 'WARN',
+    platform: 'ios',
+    locked: true,
+    when: {
+      kind: 'Heuristic',
+      where: {
+        ruleId: 'heuristics.ios.architecture.tca-composable-architecture.ast',
+      },
+    },
+    then: {
+      kind: 'Finding',
+      message:
+        'AST heuristic detected The Composable Architecture usage; native SwiftUI state, use cases, actors and explicit environment boundaries remain the preferred baseline.',
+      code: 'HEURISTICS_IOS_ARCHITECTURE_TCA_COMPOSABLE_ARCHITECTURE_AST',
+    },
+  },
   {
     id: 'heuristics.ios.architecture.massive-view-controller.ast',
     description: 'Detects UIViewController classes with direct infrastructure/data access.',

package/integrations/config/skillsDetectorRegistry.ts

@@ -176,6 +176,14 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
     'ios.architecture.swinject',
     ['heuristics.ios.architecture.swinject.ast']
   ),
+  'skills.ios.guideline.ios.tca-the-composable-architecture-para-apps-grandes-funcional':
+    heuristicDetector('ios.architecture.tca-composable-architecture', [
+      'heuristics.ios.architecture.tca-composable-architecture.ast',
+    ]),
+  'skills.ios.guideline.ios.navegacio-n-event-driven-estilo-tca-cuando-el-modelo-lo-requiera-event':
+    heuristicDetector('ios.navigation.event-driven-no-tca-runtime', [
+      'heuristics.ios.architecture.tca-composable-architecture.ast',
+    ]),
   'skills.ios.guideline.ios.magic-numbers-usar-constantes-con-nombres': heuristicDetector(
     'ios.maintainability.magic-number-layout',
     ['heuristics.ios.maintainability.magic-number-layout.ast']
@@ -246,6 +254,7 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
       'heuristics.ios.dependencies.cocoapods.ast',
       'heuristics.ios.dependencies.carthage.ast',
       'heuristics.ios.architecture.swinject.ast',
+      'heuristics.ios.architecture.tca-composable-architecture.ast',
     ]),
   'skills.ios.guideline.ios.libreri-as-de-terceros-usar-apis-nativas': heuristicDetector(
     'ios.dependencies.third-party-native-baseline',
@@ -254,6 +263,7 @@ const registryByRuleId: Record<string, SkillsDetectorBinding> = {
       'heuristics.ios.dependencies.cocoapods.ast',
       'heuristics.ios.dependencies.carthage.ast',
       'heuristics.ios.architecture.swinject.ast',
+      'heuristics.ios.architecture.tca-composable-architecture.ast',
     ]
   ),
   'skills.ios.guideline.ios.keychain-passwords-tokens-no-userdefaults': heuristicDetector(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.301",
+  "version": "6.3.302",
   "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-19T17:54:54.241Z",
+  "generatedAt": "2026-05-19T19:44:36.203Z",
   "bundles": [
     {
       "name": "android-guidelines",