devendra-skill-package 1.0.2

package/.github/skills/feature-generator/assets/fingerprint-schema.json

@@ -0,0 +1,385 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "feature-generator/fingerprint",
+  "title": "Architecture Fingerprint",
+  "description": "Produced by Phase 0 of feature-generator. Every field marked required must be resolved before Phases 1-7 run. Fields marked [INFERRED] must be visually flagged in output.",
+  "type": "object",
+  "required": [
+    "repoRoot",
+    "appRoot",
+    "appRootRelative",
+    "featureStyle",
+    "featuresRoot",
+    "layerMap",
+    "maxLayerDepth",
+    "importPrefixToAppRoot",
+    "sharedRoot",
+    "apiLib",
+    "apiClientFile",
+    "apiClientImport",
+    "envelopeStyle",
+    "mockSystem",
+    "stateLib",
+    "thunkPattern",
+    "storeConfigFile",
+    "rootStateTypeFile",
+    "rootStateImport",
+    "navLib",
+    "tsStrict",
+    "quoteStyle",
+    "semi",
+    "tabWidth",
+    "fileNameStyle",
+    "classStyle",
+    "interfacePrefix",
+    "featureFolderStyle",
+    "diStyle",
+    "returnTypeStyle"
+  ],
+  "properties": {
+    "repoRoot": {
+      "type": "string",
+      "description": "Absolute path to the repository root (directory containing package.json with react-native dependency)."
+    },
+    "appRoot": {
+      "type": "string",
+      "description": "Absolute path to the React Native app source root (where App.tsx / index.js lives)."
+    },
+    "appRootRelative": {
+      "type": "string",
+      "description": "Path of appRoot relative to repoRoot. Example: 'src/' or '' if equal.",
+      "examples": ["src/", "app/", ""]
+    },
+
+    "featureStyle": {
+      "type": "string",
+      "enum": ["feature-first", "layer-first", "expo-router", "domain-driven", "atomic", "monorepo"],
+      "description": "Dominant organisation style detected in Phase 0.B."
+    },
+    "featureStyleSecondary": {
+      "type": ["string", "null"],
+      "description": "Secondary style if mixed. Null if clean single-style."
+    },
+    "featuresRoot": {
+      "type": "string",
+      "description": "Path relative to appRoot where feature directories live. Example: 'features/', 'modules/', 'pages/'."
+    },
+    "featureDirSample": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1,
+      "description": "3-5 example feature directory names found under featuresRoot."
+    },
+
+    "layerMap": {
+      "type": "object",
+      "description": "Actual folder name segments for each architectural layer, detected from the sample feature directory. Null means the layer does not exist in this project — skip generation for that layer.",
+      "required": ["domain", "data", "state", "presentation"],
+      "properties": {
+        "domain":       { "type": ["string", "null"] },
+        "domainModels": { "type": ["string", "null"], "description": "Relative path from feature root to domain models. Example: 'domain/models'" },
+        "domainRepo":   { "type": ["string", "null"], "description": "Relative path from feature root to domain repository interfaces." },
+        "useCases":     { "type": ["string", "null"], "description": "Relative path from feature root to use case files." },
+        "data":         { "type": ["string", "null"] },
+        "dataSource":   { "type": ["string", "null"], "description": "Relative path from feature root to API datasource files." },
+        "repoImpl":     { "type": ["string", "null"], "description": "Relative path from feature root to repository implementation files. Example: 'data/repositories'" },
+        "dtos":         { "type": ["string", "null"], "description": "Relative path from feature root to DTO files. Null = inline DTOs in mapper." },
+        "mappers":      { "type": ["string", "null"] },
+        "mocks":        { "type": ["string", "null"], "description": "Relative path from feature root to mock JSON files." },
+        "state":        { "type": ["string", "null"] },
+        "stateStore":   { "type": ["string", "null"], "description": "Relative path from feature root to slice/store files." },
+        "selectors":    { "type": ["string", "null"], "description": "Relative path from feature root to selector files. Null = inline selectors in slice." },
+        "presentation": { "type": ["string", "null"] },
+        "screens":      { "type": ["string", "null"], "description": "Relative path from feature root to screen components." },
+        "di":           { "type": ["string", "null"], "description": "Relative path from feature root to DI container directory. Example: 'di'. Null if diStyle is not per-feature-container." }
+      }
+    },
+
+    "maxLayerDepth": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Number of directory segments from appRoot to the deepest layer file. Used to compute import prefixes."
+    },
+    "importPrefixToAppRoot": {
+      "type": "string",
+      "pattern": "^(\\.\\./)+$",
+      "description": "Relative prefix to climb back to appRoot from the deepest layer. Example: '../../../../'."
+    },
+
+    "sharedRoot": {
+      "type": "string",
+      "description": "Path relative to appRoot for the shared/common utilities directory. Example: 'shared/', 'common/', 'core/'."
+    },
+    "sharedRootAlias": {
+      "type": ["string", "null"],
+      "description": "Import alias for sharedRoot if one exists. Example: '@shared'. Null if no alias."
+    },
+    "sharedApiDir": {
+      "type": ["string", "null"],
+      "description": "Path relative to appRoot for the shared API client file's directory."
+    },
+    "sharedTypesDir": {
+      "type": ["string", "null"],
+      "description": "Path relative to appRoot for shared TypeScript types."
+    },
+    "sharedStoreDir": {
+      "type": ["string", "null"],
+      "description": "Path relative to appRoot for the Redux store config (or equivalent)."
+    },
+
+    "aliasesDetected": {
+      "type": "boolean",
+      "description": "True if tsconfig/babel/metro defines path aliases."
+    },
+    "aliasMap": {
+      "type": "object",
+      "description": "Map of alias prefix to resolved path relative to repoRoot. Example: { '@': 'src/', '@shared': 'src/shared/' }.",
+      "additionalProperties": { "type": "string" }
+    },
+    "preferAliases": {
+      "type": "boolean",
+      "description": "True if existing feature files actually use aliases in their imports. If false, use relative paths even when aliases are defined."
+    },
+
+    "apiLib": {
+      "type": "string",
+      "enum": ["axios", "fetch", "rtk-query", "react-query", "apollo", "other"],
+      "description": "HTTP client library detected across the codebase."
+    },
+    "apiClientFile": {
+      "type": "string",
+      "description": "Absolute path to the shared API client instance file."
+    },
+    "apiClientImport": {
+      "type": "string",
+      "description": "Exact import string used by existing feature datasource files to import the client. Example: '../../../../shared/api/apiClient'."
+    },
+    "envelopeStyle": {
+      "type": "string",
+      "enum": ["mb-operationId", "mb-operationid-lowercase", "none", "graphql", "other"],
+      "description": "Request body envelope pattern detected from existing API calls. See references/api-envelope-patterns.md."
+    },
+    "envelopeBuilder": {
+      "type": ["string", "null"],
+      "description": "Name of the buildEnvelope helper function and its source file if one exists. 'inline' if envelope is constructed inline. Null if no envelope."
+    },
+    "mockSystem": {
+      "type": "string",
+      "enum": ["mockConfig", "msw", "none"],
+      "description": "Mock data strategy detected in the project."
+    },
+    "mockConfigFile": {
+      "type": ["string", "null"],
+      "description": "Absolute path to mockConfig.ts (or equivalent). Null if mockSystem is 'none'."
+    },
+    "mockGlobalFlag": {
+      "type": ["string", "null"],
+      "description": "Exact field name for the global mock toggle in mockConfig. Example: 'globalMockEnabled'."
+    },
+    "mockDelayField": {
+      "type": ["string", "null"],
+      "description": "Exact field name for the simulated delay value in mockConfig. Example: 'simulatedDelayMs'."
+    },
+    "mockJsonFolder": {
+      "type": ["string", "null"],
+      "description": "Path pattern for mock JSON files, relative to the datasource file. Example: './__mocks__/'."
+    },
+
+    "stateLib": {
+      "type": "string",
+      "enum": ["redux-toolkit", "zustand", "mobx", "context-api", "react-query", "jotai", "recoil", "other"],
+      "description": "Dominant state management library detected."
+    },
+    "thunkPattern": {
+      "type": "string",
+      "enum": ["thunk-extra", "direct-import", "rtk-query", "n/a"],
+      "description": "How Redux async thunks receive their dependencies. 'n/a' for non-RTK state libs."
+    },
+    "storeConfigFile": {
+      "type": ["string", "null"],
+      "description": "Absolute path to the file containing configureStore() call."
+    },
+    "rootStateTypeFile": {
+      "type": ["string", "null"],
+      "description": "Absolute path to the file that exports the RootState type."
+    },
+    "rootStateImport": {
+      "type": ["string", "null"],
+      "description": "Exact import string to reach RootState from a selector file at maxLayerDepth. Example: '../../../../app/store'."
+    },
+    "sliceNameStyle": {
+      "type": "string",
+      "enum": ["camelCase", "kebab-case"],
+      "description": "Naming style used for the Redux slice 'name' string. Derived from existing slices."
+    },
+    "reducerMapKeys": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Existing reducer keys in the store's reducer map. New feature key must not collide."
+    },
+    "reducerKey": {
+      "type": ["string", "null"],
+      "description": "Single-mode only: the reducer key derived in Phase 1.4 for the one screen being generated. In module mode this is null — each screen's reducerKey is computed per-screen in Phase 1.4 and is NOT stored in the fingerprint."
+    },
+
+    "navLib": {
+      "type": "string",
+      "enum": ["react-navigation", "expo-router", "wix-navigation", "none"],
+      "description": "Navigation library detected."
+    },
+    "navVersion": {
+      "type": ["string", "null"],
+      "enum": ["5", "6", "7", "n/a", null],
+      "description": "React Navigation major version. 'n/a' or null for other libs."
+    },
+    "navStackType": {
+      "type": ["string", "null"],
+      "enum": ["native-stack", "stack", "bottom-tab", "n/a", null],
+      "description": "Stack type used by the existing navigator that the new screen will be added to."
+    },
+    "navScreenFile": {
+      "type": ["string", "null"],
+      "description": "Absolute path to the navigator file where screens are registered."
+    },
+    "navParamsPattern": {
+      "type": ["string", "null"],
+      "description": "Name of the params list type used for screen params. Example: 'PortfolioStackParamList'."
+    },
+
+    "tsStrict": {
+      "type": "boolean",
+      "description": "Whether tsconfig compilerOptions.strict is true. When true, all entity fields must be readonly."
+    },
+    "noImplicitAny": {
+      "type": "boolean",
+      "description": "Whether tsconfig compilerOptions.noImplicitAny is true."
+    },
+    "strictNullChecks": {
+      "type": "boolean",
+      "description": "Whether tsconfig compilerOptions.strictNullChecks is true."
+    },
+    "explicitReturnType": {
+      "type": "boolean",
+      "description": "Whether ESLint enforces explicit function return types. When true, add return types to all functions."
+    },
+    "quoteStyle": {
+      "type": "string",
+      "enum": ["single", "double"],
+      "description": "Quote style from Prettier config."
+    },
+    "trailingComma": {
+      "type": "string",
+      "enum": ["es5", "all", "none"],
+      "description": "Trailing comma style from Prettier config."
+    },
+    "semi": {
+      "type": "boolean",
+      "description": "Whether Prettier adds semicolons."
+    },
+    "tabWidth": {
+      "type": "integer",
+      "enum": [2, 4],
+      "description": "Indentation width from Prettier config."
+    },
+    "testRunner": {
+      "type": ["string", "null"],
+      "enum": ["jest", "vitest", "mocha", "none", null]
+    },
+    "testFilePattern": {
+      "type": ["string", "null"],
+      "description": "Test file naming pattern. Example: '*.test.ts', '*.spec.ts', '__tests__/'."
+    },
+
+    "fileNameStyle": {
+      "type": "string",
+      "enum": ["camelCase", "kebab-case", "PascalCase"],
+      "description": "Naming style for TypeScript source files (excluding screen components which are always PascalCase)."
+    },
+    "classStyle": {
+      "type": "string",
+      "enum": ["PascalCase"],
+      "description": "Always PascalCase for class names."
+    },
+    "interfacePrefix": {
+      "type": "string",
+      "enum": ["I", "none"],
+      "description": "Whether repository interfaces are prefixed with 'I'. Detected from existing domain files."
+    },
+    "operationIdStyle": {
+      "type": "string",
+      "enum": ["PascalCase-Get", "path-style", "camelCase"],
+      "description": "Casing style for operationId strings in envelope calls."
+    },
+    "mockJsonStyle": {
+      "type": "string",
+      "description": "File name pattern for mock JSON files. Example: 'camelCase.mock.json', 'PascalCase.mock.json'."
+    },
+    "featureFolderStyle": {
+      "type": "string",
+      "enum": ["camelCase", "kebab-case", "PascalCase"],
+      "description": "Naming style for feature directory names."
+    },
+
+    "diStyle": {
+      "type": "string",
+      "enum": ["per-feature-bootstrap", "per-feature-container", "global", "none"],
+      "description": "DI wiring pattern detected across feature directories. See Phase 6 in SKILL.MD for generation templates per style."
+    },
+    "diBootstrapFile": {
+      "type": ["string", "null"],
+      "description": "Path relative to feature root for the per-feature-bootstrap file (e.g. 'diBootstrap.ts'). Null when diStyle is not per-feature-bootstrap."
+    },
+    "diContainerFile": {
+      "type": ["string", "null"],
+      "description": "Path relative to feature root for the per-feature-container file (e.g. 'di/container.ts'). Null when diStyle is not per-feature-container."
+    },
+    "diContainerClass": {
+      "type": ["string", "null"],
+      "description": "Class name used in the existing DI container (e.g. 'ReportsContainer'). Null when diStyle is not per-feature-container."
+    },
+
+    "returnTypeStyle": {
+      "type": "string",
+      "enum": ["result-wrapper", "custom-type", "direct-promise"],
+      "description": "How domain repository methods return values. Controls Phase 3.2, 4.7, and 5.1 code generation. result-wrapper = Promise<{ ok, data?, error? }>; custom-type = Promise<NamedType>; direct-promise = Promise<T[]> throws on error."
+    },
+    "resultTypeImport": {
+      "type": ["string", "null"],
+      "description": "Exact import string for the shared Result<T> type when returnTypeStyle is 'result-wrapper'. Null otherwise."
+    },
+    "repoReturnWrapper": {
+      "type": ["string", "null"],
+      "description": "Name of the custom return type when returnTypeStyle is 'custom-type' (e.g. 'PortfolioSummaryResult'). Null otherwise."
+    },
+
+    "layerMapVariants": {
+      "type": "object",
+      "description": "Records all alternative folder name variants found across feature directories for layers that differ. Key = layerMap property name; value = array of all observed path strings.",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string" },
+        "minItems": 1
+      }
+    },
+
+    "screenRefPatterns": {
+      "type": "array",
+      "description": "Populated in Phase 0.L when SCREEN_REF_PATHS are provided. Each entry describes the UI conventions extracted from one reference screen file.",
+      "items": {
+        "type": "object",
+        "required": ["file"],
+        "properties": {
+          "file":             { "type": "string", "description": "Relative path to the reference screen file." },
+          "scrollContainer": { "type": "string", "enum": ["FlatList", "ScrollView", "FlashList", "other"] },
+          "styleNames":      { "type": "array", "items": { "type": "string" } },
+          "sharedComponents":{ "type": "array", "items": { "type": "string" } },
+          "navHook":         { "type": "string", "enum": ["useNavigation", "useRouter", "none"] },
+          "stateHooks":      { "type": "array", "items": { "type": "string" } },
+          "earlyReturnOrder":{ "type": "array", "items": { "type": "string" } },
+          "listItemLayout":  { "type": "string" }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/.github/skills/feature-generator/assets/spec-template.md

@@ -0,0 +1,172 @@
+# Feature Spec: <ScreenName>
+
+<!-- INSTRUCTIONS
+  - Replace <ScreenName> in the heading above with a PascalCase name (e.g. TransactionHistory).
+  - Fill in every section below. Sections marked REQUIRED will cause a FATAL if missing.
+  - Sections marked OPTIONAL will produce a WARN if missing but generation will continue.
+  - Sections marked INTERVIEW map to the 5 mandatory questions in PHASE -1.
+    If you fill them here, they are treated as your answers to those questions.
+  - Delete all HTML comments before using this file as input.
+
+  USAGE MODES:
+  ─────────────────────────────────────────────────────────────────
+  Single screen:
+    Fill ONE copy of this template. Provide it as the spec for one screen.
+
+  Module (multiple screens):
+    Create ONE copy of this template per screen. Name them clearly, e.g.:
+      fdBooking-fdDetails-spec.md
+      fdBooking-payment-spec.md
+      fdBooking-confirmation-spec.md
+    During the PHASE -1 interview, provide all file paths when asked for design sources.
+    The skill generates all screens under one shared module folder and creates a single
+    diBootstrap.ts for the whole module.
+  ─────────────────────────────────────────────────────────────────
+-->
+
+---
+
+## Screen Name
+<!-- INTERVIEW Q1 — REQUIRED. PascalCase. Used to derive all file names, class names, and operation IDs.
+     If you filled the Screen Name in the PHASE -1 Q1 interview, it overrides this field.
+     Examples: TransactionHistory  FundDetail  UserProfile  ReportDownload -->
+
+
+---
+
+## User Stories
+<!-- INTERVIEW Q2 — OPTIONAL. One story per bullet.
+     Format: As a <role>, I want to <action> so that <benefit>.
+     These drive screen logic completeness and post-generation user story coverage checks.
+     If not provided, screen logic will be derived from the Screen Logic section below.
+
+     Examples:
+     - As a user, I want to see my transaction history so that I can track my investments
+     - As a user, I want to pull to refresh so that I get the latest data
+     - As a user, I want to tap a transaction to see its full details
+-->
+-
+
+---
+
+## Test Cases
+<!-- INTERVIEW Q3 — OPTIONAL. One case per bullet.
+     Format: Given <state>, when <action>, then <expected outcome>.
+     Label type at the end: [happy] [edge] [error]
+     These drive post-generation test case coverage checks.
+
+     Examples:
+     - Given data is available, when screen loads, then list renders all transactions [happy]
+     - Given list is empty, when screen loads, then empty state message is shown [edge]
+     - Given API returns Status != "success", when screen loads, then error message is shown [error]
+     - Given user is unauthenticated, when screen loads, then logout prompt is shown [error]
+-->
+-
+
+---
+
+## API URL
+<!-- REQUIRED. Endpoint path as it appears in the API contract.
+     Include the full path from the service root (no base URL).
+     Examples:
+       /api/v1/portfolio/transactions
+       /api/v1/boreports/fund-exposure
+       /GetPortfolioSummary  -->
+
+
+---
+
+## HTTP Method
+<!-- REQUIRED. One of: GET  POST  PUT  PATCH  DELETE -->
+POST
+
+---
+
+## Request Body
+<!-- OPTIONAL (default: {}). JSON object sent to the server.
+     Use EXACT field names and casing as expected by the API.
+     The skill will map camelCase params to these names in the datasource.
+     For GET requests write: {} -->
+```json
+{
+}
+```
+
+---
+
+## Response Shape
+<!-- OPTIONAL. Example JSON response from the API.
+     Include all fields that appear in Response Mapping below.
+     Use realistic placeholder values, not nulls.
+     If the response is an array at the root, wrap it in an object:
+       { "Data": [ { ... } ] }
+-->
+```json
+{
+  "Status": "success",
+  "Data": []
+}
+```
+
+---
+
+## Business Logic
+<!-- OPTIONAL. One rule per bullet. Pure domain logic only.
+     Domain rules = validation, derived values, thresholds, status interpretation.
+     These become guard clauses in the UseCase.execute() method.
+     Do NOT include UI behaviour here (goes in Screen Logic).
+
+     Examples:
+     - Only show items where Amount > 0
+     - If Status is not "success", treat the response as an error
+     - Items older than 7 years should be marked as "Archived"
+     - XIRR below -100 should be clamped to -100
+-->
+-
+
+---
+
+## Screen Logic
+<!-- INTERVIEW Q5E — OPTIONAL. One rule per bullet. UI behaviour only.
+     Maps to PHASE -1 Question 5E. If filled here, treated as your Q5E answer.
+     Screen logic = what happens on mount, user gestures, navigation, state changes.
+     These become useEffect / callback / conditional render in the Screen component.
+     Do NOT include domain validation here (goes in Business Logic).
+
+     Examples:
+     - Fetch data on screen mount
+     - Support pull-to-refresh
+     - Navigate to DetailScreen when user taps a row
+     - Show empty state message "No items found" when list is empty
+     - Filter by category using a tab bar
+     - Show loading skeleton while data is fetching
+     - Display auth error message and logout button if session expires
+-->
+-
+
+---
+
+## Response Mapping
+<!-- OPTIONAL but strongly recommended. One line per field.
+     Format: `response.field.path` → description of where and how it appears in the UI
+
+     Apply transform keywords inline after the description:
+       formatted as Indian currency       →  ₹1,23,456.78
+       formatted as date DD MMM YYYY      →  15 Jan 2024
+       formatted as percentage            →  12.34%
+       formatted as boolean badge         →  green/red coloured label
+
+     Other transforms (see assets/transform-rules.json for full list):
+       formatted as compact number        →  1.2 Cr, 45 L
+       formatted as units                 →  12.345 units
+
+     Examples:
+     - `Data[].TransactionID`   → unique key for each row (not visible)
+     - `Data[].FundName`        → primary title of each list row
+     - `Data[].Amount`          → below title, formatted as Indian currency
+     - `Data[].TransactionDate` → subtitle, formatted as date DD MMM YYYY
+     - `Data[].TransactionType` → badge: green for "Purchase", red for "Redemption", formatted as boolean badge
+     - `Data[].Units`           → detail row: "Units: <value>"
+     - `Data[].NAV`             → detail row, formatted as Indian currency
+-->
+-

package/.github/skills/feature-generator/assets/transform-rules.json

@@ -0,0 +1,82 @@
+{
+  "_comment": "Response mapping transform rules. Keys are lowercase keywords matched against the transform string in spec responseMappings. {value} is replaced with the actual TypeScript expression at code-generation time.",
+
+  "transforms": {
+    "formatted as indian currency": {
+      "tsExpression": "{value}.toLocaleString('en-IN', { style: 'currency', currency: 'INR', minimumFractionDigits: 2, maximumFractionDigits: 2 })",
+      "nullSafe": "typeof {value} === 'number' ? {value}.toLocaleString('en-IN', { style: 'currency', currency: 'INR', minimumFractionDigits: 2, maximumFractionDigits: 2 }) : '--'",
+      "description": "Formats a number as Indian currency with Rupee symbol and two decimal places."
+    },
+    "formatted as currency": {
+      "tsExpression": "{value}.toLocaleString('en-IN', { style: 'currency', currency: 'INR', minimumFractionDigits: 2, maximumFractionDigits: 2 })",
+      "nullSafe": "typeof {value} === 'number' ? {value}.toLocaleString('en-IN', { style: 'currency', currency: 'INR', minimumFractionDigits: 2, maximumFractionDigits: 2 }) : '--'",
+      "description": "Alias for 'formatted as indian currency'."
+    },
+    "formatted as percentage": {
+      "tsExpression": "`${((({value}) ?? 0) * 100).toFixed(2)}%`",
+      "nullSafe": "typeof {value} === 'number' ? `${({value} * 100).toFixed(2)}%` : '--'",
+      "description": "Multiplies a decimal fraction by 100 and appends %. Input 0.1234 → '12.34%'."
+    },
+    "show as percentage": {
+      "tsExpression": "`${((({value}) ?? 0) * 100).toFixed(2)}%`",
+      "nullSafe": "typeof {value} === 'number' ? `${({value} * 100).toFixed(2)}%` : '--'",
+      "description": "Alias for 'formatted as percentage'."
+    },
+    "formatted as date dd mmm yyyy": {
+      "tsExpression": "new Date({value}).toLocaleDateString('en-IN', { day: '2-digit', month: 'short', year: 'numeric' })",
+      "nullSafe": "{value} ? new Date({value}).toLocaleDateString('en-IN', { day: '2-digit', month: 'short', year: 'numeric' }) : '--'",
+      "description": "Formats an ISO date string or timestamp as '15 Jan 2024'."
+    },
+    "formatted as date": {
+      "tsExpression": "new Date({value}).toLocaleDateString('en-IN', { day: '2-digit', month: 'short', year: 'numeric' })",
+      "nullSafe": "{value} ? new Date({value}).toLocaleDateString('en-IN', { day: '2-digit', month: 'short', year: 'numeric' }) : '--'",
+      "description": "Alias for 'formatted as date dd mmm yyyy'."
+    },
+    "formatted as boolean badge": {
+      "tsExpression": null,
+      "jsxPattern": "<Text style={{ color: {value} ? '#008675' : '#971b2f', fontWeight: '600' }}>{value} ? 'Yes' : 'No'</Text>",
+      "description": "Renders a green/red colored Text badge based on truthy/falsy value. Customize the true/false labels in the spec mapping description."
+    },
+    "formatted as compact number": {
+      "tsExpression": "{value} >= 10_000_000 ? `${({value} / 10_000_000).toFixed(2)} Cr` : {value} >= 100_000 ? `${({value} / 100_000).toFixed(2)} L` : {value}.toLocaleString('en-IN')",
+      "nullSafe": "typeof {value} === 'number' ? ({value} >= 10_000_000 ? `${({value} / 10_000_000).toFixed(2)} Cr` : {value} >= 100_000 ? `${({value} / 100_000).toFixed(2)} L` : {value}.toLocaleString('en-IN')) : '--'",
+      "description": "Abbreviates large numbers to Indian units: Cr (crore) above 10M, L (lakh) above 100K."
+    },
+    "formatted as units": {
+      "tsExpression": "`${({value} ?? 0).toFixed(3)} units`",
+      "nullSafe": "typeof {value} === 'number' ? `${{value}.toFixed(3)} units` : '--'",
+      "description": "Formats a number as mutual fund units with 3 decimal places."
+    },
+    "formatted as nav": {
+      "tsExpression": "`\u20b9${({value} ?? 0).toFixed(4)}`",
+      "nullSafe": "typeof {value} === 'number' ? `\u20b9${({value}).toFixed(4)}` : '--'",
+      "description": "Formats a Net Asset Value with Rupee symbol and 4 decimal places."
+    },
+    "hidden": {
+      "tsExpression": null,
+      "jsxPattern": null,
+      "description": "Field is used as a key or internal identifier only. Not rendered in JSX. Add as a property on the item object but omit from JSX."
+    },
+    "unique key": {
+      "tsExpression": null,
+      "jsxPattern": null,
+      "description": "Same as 'hidden' — used as the FlatList keyExtractor key. Not rendered."
+    }
+  },
+
+  "badgeLabelOverrides": {
+    "_comment": "When spec uses 'badge: green for X, red for Y', extract the label pair. Format: { trueLabel: string, falseLabel: string }.",
+    "examples": [
+      { "pattern": "green for Purchase, red for Redemption",  "trueLabel": "Purchase",   "falseLabel": "Redemption" },
+      { "pattern": "green for Active, red for Inactive",      "trueLabel": "Active",      "falseLabel": "Inactive" },
+      { "pattern": "green for Credit, red for Debit",         "trueLabel": "Credit",      "falseLabel": "Debit" }
+    ]
+  },
+
+  "matchingRules": {
+    "_comment": "How the skill matches transform keywords against spec mapping text.",
+    "caseSensitive": false,
+    "strategy": "substring-match",
+    "fallback": "If no keyword matches, render the raw value as a string with no transform. Log a WARN."
+  }
+}