From 058082bba8e4b17c55800b3d544745ed4d2cf11a Mon Sep 17 00:00:00 2001
From: Temrjan <omadgo@protonmail.com>
Date: Wed, 3 Jun 2026 17:36:10 +0500
Subject: [PATCH] docs(agents): add TypeScript + React Native rules (Codex
 Compact)

ci(dependabot): ignore major action updates
---
 .github/dependabot.yml | 10 +++++
 AGENTS.md              | 86 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 94 insertions(+), 2 deletions(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 4e134d7..a24bec3 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -16,3 +16,13 @@ updates:
     schedule:
       interval: "weekly"
       day: "monday"
+    ignore:
+      # Major action updates are deferred to dedicated CI maintenance sprints.
+      - dependency-name: "actions/checkout"
+        update-types: ["version-update:semver-major"]
+      - dependency-name: "codecov/codecov-action"
+        update-types: ["version-update:semver-major"]
+      - dependency-name: "actions/upload-artifact"
+        update-types: ["version-update:semver-major"]
+      - dependency-name: "actions/download-artifact"
+        update-types: ["version-update:semver-major"]
diff --git a/AGENTS.md b/AGENTS.md
index 9932b3a..51ddc4f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -7,12 +7,16 @@
 
 ## Stack
 
-- **Framework:** React Native 0.76+ (New Architecture)
+- **Framework:** React Native 0.76+ (New Architecture) — **stay on 0.76 until Phase 4 kickoff**, then evaluate latest stable
 - **Language:** TypeScript 5.6+, strict mode
 - **Navigation:** React Navigation v7 (native-stack + bottom-tabs)
 - **State:** Zustand 5 + MMKV persistence
 - **Styling:** NativeWind 4 + TailwindCSS 3
-- **Standards:** `~/Workspace/Codex/standards/react.md` + `typescript.md`
+- **Source of truth:** this file. **Fallback:** `~/Workspace/Codex/standards/react.md` + `typescript.md` for deep context.
+
+## Security Note
+
+Metro dev server (RN CLI) has a known dev-only vulnerability (CVE-2025-11953). **Mitigation:** always run Metro with `--host 127.0.0.1` (never expose to LAN). This does **not** affect production builds.
 
 ---
 
@@ -66,6 +70,84 @@ Use `useShallow` selectors. No Redux.
 
 ---
 
+## TypeScript Rules (Codex Compact)
+
+Active rules from Codex typescript/react, inlined for token efficiency.
+
+### TS-001: Strict mode
+- **DO:** `strict: true` + `noUncheckedIndexedAccess` + `exactOptionalPropertyTypes`
+- **DONT:** `any`, `@ts-ignore`
+- **WHY:** Type safety is non-negotiable
+
+### TS-002: Types
+- **DO:** `interface` for objects, `type` for unions/aliases, `satisfies` for configs
+- **DONT:** `type` for object shapes, `I` prefix on interfaces
+- **WHY:** Consistency with ecosystem
+
+### TS-003: Error handling
+- **DO:** `catch (error: unknown)` + `instanceof Error` narrowing
+- **DONT:** `catch (e: any)`
+- **WHY:** `any` infects everything it touches
+
+### TS-004: Exports
+- **DO:** Named exports only
+- **DONT:** `export default`
+- **WHY:** Refactor-friendly, explicit imports
+
+### TS-005: Async
+- **DO:** `Promise.all` for independent parallel ops
+- **DONT:** Sequential `await` when order does not matter
+- **WHY:** Latency
+
+### TS-006: Type assertions
+- **DO:** `@ts-expect-error` with explanation if truly unavoidable
+- **DONT:** `@ts-ignore`, non-null `!` without guarantee
+- **WHY:** Masked bugs
+
+---
+
+## React Native Rules (Codex Compact)
+
+### RN-001: Hooks
+- **DO:** Only at top level, unconditionally
+- **DONT:** Hooks in conditions, loops, nested functions
+- **WHY:** React rules of hooks
+
+### RN-002: State
+- **DO:** Max 4 stores (wallet, chat, ui, settings), `useShallow` for multi-field selects
+- **DONT:** Redux, god stores
+- **WHY:** Zustand + MMKV is project standard
+
+### RN-003: Metro security
+- **DO:** `npx react-native start --host 127.0.0.1`
+- **DONT:** Expose Metro to LAN
+- **WHY:** CVE-2025-11953 (dev-only, but serious)
+
+### RN-004: Platform
+- **DO:** `Platform.OS` or `.ios.tsx` / `.android.tsx` extensions
+- **DONT:** Inline platform checks scattered in logic
+- **WHY:** Maintainability
+
+### RN-005: SafeArea
+- **DO:** Wrap screens with `SafeAreaView` or `react-native-safe-area-context`
+- **WHY:** Notch / home indicator handling
+
+### RN-006: E2E
+- **DO:** `testID` on interactive elements
+- **WHY:** E2E testing infrastructure
+
+### RN-007: Crypto
+- **DO:** All crypto via `react-native-rustok-bridge` (uniffi)
+- **DONT:** Any JS crypto library
+- **WHY:** Security boundary; Rust handles all secret material
+
+### RN-008: Effects
+- **DO:** Effects only for external sync (subscriptions, timers)
+- **DONT:** Effects for data transformation or derived state
+- **WHY:** `useMemo` for derived values
+
+---
+
 ## CI Gates
 
 ```bash