@trackunit/iris-app 1.12.7 → 1.12.10

package/src/generators/preset/files/.cursor/rules/graphql-timeseries.md

@@ -1,260 +0,0 @@
-# GraphQL Time Series API Usage
-
-This rule covers how to query time series data through GraphQL in IrisX App SDK using PromQL (Prometheus Query Language).
-
-## Query Structure
-
-### Range Query (time series data)
-```graphql
-query GetTimeSeriesData($assetId: ID!, $start: DateTime!, $end: DateTime!, $step: Duration!) {
-  asset(id: $assetId) {
-    timeSeries {
-      rangeQuery(query: "metric_name", start: $start, end: $end, step: $step) {
-        data {
-          ... on TimeSeriesMatrixData {
-            result {
-              values { timestamp value }
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-### Instant Query (single point in time)
-```graphql
-query GetInstantData($assetId: ID!, $time: DateTime!) {
-  asset(id: $assetId) {
-    timeSeries {
-      instantQuery(query: "metric_name", time: $time) {
-        data {
-          ... on TimeSeriesVectorData {
-            result { value { timestamp value } }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-## Common Metrics
-
-### Machine Insights (Possible Insights, not all assets will have all Insights)
-- `machine_insight_ac_average_frequency`
-- `machine_insight_ac_average_phase_to_neutral_rms_voltage`
-- `machine_insight_ac_average_phase_to_phase_rms_voltage`
-- `machine_insight_ac_average_rms_current`
-- `machine_insight_accelerometer_x_axis`
-- `machine_insight_accelerometer_y_axis`
-- `machine_insight_accelerometer_z_axis`
-- `machine_insight_ac_phase_l1_active_power`
-- `machine_insight_ac_phase_l1_frequency`
-- `machine_insight_ac_phase_l1_l2_rms_voltage`
-- `machine_insight_ac_phase_l1_netural_rms_voltage`
-- `machine_insight_ac_phase_l1_neutral_rms_voltage`
-- `machine_insight_ac_phase_l1_rms_current`
-- `machine_insight_ac_phase_l2_active_power`
-- `machine_insight_ac_phase_l2_frequency`
-- `machine_insight_ac_phase_l2_l3_rms_voltage`
-- `machine_insight_ac_phase_l2_netural_rms_voltage`
-- `machine_insight_ac_phase_l2_neutral_rms_voltage`
-- `machine_insight_ac_phase_l2_rms_current`
-- `machine_insight_ac_phase_l3_active_power`
-- `machine_insight_ac_phase_l3_frequency`
-- `machine_insight_ac_phase_l3_l1_rms_voltage`
-- `machine_insight_ac_phase_l3_netural_rms_voltage`
-- `machine_insight_ac_phase_l3_neutral_rms_voltage`
-- `machine_insight_ac_phase_l3_rms_current`
-- `machine_insight_ac_total_active_power`
-- `machine_insight_ac_total_apparent_power`
-- `machine_insight_ac_total_power_factor`
-- `machine_insight_ac_total_reactive_power`
-- `machine_insight_ac_total_relative_active_power_load_percentage`
-- `machine_insight_ac_total_relative_apparent_power_load_percentage`
-- `machine_insight_ac_total_relative_load_percentage`
-- `machine_insight_actual_engine_percent_torque`
-- `machine_insight_after_treatment_diesel_exhaust_fluid_concentration`
-- `machine_insight_after_treatment_diesel_exhaust_fluid_tank_level`
-- `machine_insight_after_treatment_diesel_exhaust_fluid_tank_temperature`
-- `machine_insight_after_treatment_diesel_particulate_filter_active_regeneration_state`
-- `machine_insight_after_treatment_diesel_particulate_filter_active_regeneration_status`
-- `machine_insight_after_treatment_diesel_particulate_filter_ash_load_percent`
-- `machine_insight_after_treatment_diesel_particulate_filter_differential_pressure`
-- `machine_insight_after_treatment_diesel_particulate_filter_intake_temperature`
-- `machine_insight_after_treatment_diesel_particulate_filter_passive_regeneration_status`
-- `machine_insight_after_treatment_diesel_particulate_filter_soot_load_percent`
-- `machine_insight_after_treatment_diesel_particulate_filter_state`
-- `machine_insight_after_treatment_diesel_particulate_filter_status`
-- `machine_insight_after_treatment_diesel_particulate_filter_time_since_last_active_regeneration`
-- `machine_insight_aftertreatment_diesel_particulate_filter_time_to_next_active_regeneration`
-- `machine_insight_after_treatment_exhaust_temperature`
-- `machine_insight_aftertreatment_scr_time_since_last_cleaning_event`
-- `machine_insight_altitude`
-- `machine_insight_ambient_air_temperature`
-- `machine_insight_average_load_factor_last_24`
-- `machine_insight_barometric_pressure`
-- `machine_insight_battery_charge_cycles_count`
-- `machine_insight_battery_charger_cumulative_input_energy`
-- `machine_insight_battery_charger_input_current`
-- `machine_insight_battery_charger_input_current_limit`
-- `machine_insight_battery_charger_input_voltage`
-- `machine_insight_battery_charger_output_current`
-- `machine_insight_battery_charger_output_current_limit`
-- `machine_insight_battery_charger_output_voltage`
-- `machine_insight_battery_charger_power_line_state`
-- `machine_insight_battery_charger_state`
-- `machine_insight_battery_cumulative_discharged_energy`
-- `machine_insight_battery_current`
-- `machine_insight_battery_potential`
-- `machine_insight_battery_remaining_charge_time`
-- `machine_insight_battery_remaining_run_time`
-- `machine_insight_battery_state_of_charge_percent`
-- `machine_insight_battery_state_of_health_percent`
-- `machine_insight_battery_temperature`
-- `machine_insight_cumulative_active_regeneration_hours`
-- `machine_insight_cumulative_co2_emissions`
-- `machine_insight_cumulative_engine_hours`
-- `machine_insight_cumulative_idle_hours`
-- `machine_insight_cumulative_idle_non_operating_hours`
-- `machine_insight_cumulative_load_count`
-- `machine_insight_cumulative_moving_hours`
-- `machine_insight_cumulative_operating_hours`
-- `machine_insight_cumulative_payload_totals`
-- `machine_insight_cumulative_productive_hours`
-- `machine_insight_diesel_particulate_filter_active_regeneration_inhibited_due_to_inhibit_switch`
-- `machine_insight_engine_air_filter_differential_pressure`
-- `machine_insight_engine_coolant_level`
-- `machine_insight_engine_coolant_pressure`
-- `machine_insight_engine_coolant_temperature`
-- `machine_insight_engine_exhaust_temperature`
-- `machine_insight_engine_fuel_delivery_pressure`
-- `machine_insight_engine_fuel_filter_differential_pressure`
-- `machine_insight_engine_fuel_rate`
-- `machine_insight_engine_fuel_temperature`
-- `machine_insight_engine_intake_air_pressure`
-- `machine_insight_engine_intake_air_temperature`
-- `machine_insight_engine_intake_manifold_pressure`
-- `machine_insight_engine_intake_manifold_temperature`
-- `machine_insight_engine_intercooler_temperature`
-- `machine_insight_engine_oil_filter_differential_pressure`
-- `machine_insight_engine_oil_level`
-- `machine_insight_engine_oil_pressure`
-- `machine_insight_engine_oil_temperature`
-- `machine_insight_engine_percent_load_at_current_speed`
-- `machine_insight_engine_speed`
-- `machine_insight_engine_status`
-- `machine_insight_engine_total_fuel_used`
-- `machine_insight_engine_total_idle_fuel_used`
-- `machine_insight_engine_trip_fuel`
-- `machine_insight_exhaust_system_high_temperature_lamp_command`
-- `machine_insight_fuel_level`
-- `machine_insight_fuel_tank_capacity`
-- `machine_insight_fuel_used_last_24`
-- `machine_insight_generator_total_kw_hours_export`
-- `machine_insight_hydraulic_oil_filter_restriction_switch`
-- `machine_insight_hydraulic_oil_level`
-- `machine_insight_hydraulic_pressure`
-- `machine_insight_hydraulic_temperature`
-- `machine_insight_impact`
-- `machine_insight_maximum_speed_last_24`
-- `machine_insight_operation_status`
-- `machine_insight_payload`
-- `machine_insight_payload_percentage`
-- `machine_insight_payload_temperature`
-- `machine_insight_pitch_angle`
-- `machine_insight_platform_elevated`
-- `machine_insight_platform_height`
-- `machine_insight_platform_height_percent`
-- `machine_insight_platform_stowed`
-- `machine_insight_rescue_mode_active`
-- `machine_insight_road_surface_temperature`
-- `machine_insight_roll_angle`
-- `machine_insight_seat_belt_switch`
-- `machine_insight_speed`
-- `machine_insight_stabilizers_deployed`
-- `machine_insight_total_power_take_off_hours`
-- `machine_insight_total_vehicle_distance`
-- `machine_insight_transmission_oil_temperature`
-- `machine_insight_water_in_fuel_indicator`
-- `machine_insight_wheel_based_vehicle_speed`
-
-## PromQL Examples via GraphQL
-
-### Calculate daily increases
-```graphql
-query IncreaseOperatingHours($assetId: ID!, $start: DateTime!, $end: DateTime!, $step: Duration!) {
-  asset(id: $assetId) {
-    timeSeries {
-      rangeQuery(
-        query: "increase(machine_insight_cumulative_operating_hours[1d])",
-        start: $start,
-        end: $end,
-        step: $step
-      ) {
-        data {
-          ... on TimeSeriesMatrixData {
-            result { values { timestamp value } }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-### Filter with conditions
-```graphql
-query HighFuelConsumption($assetId: ID!, $start: DateTime!, $end: DateTime!, $step: Duration!) {
-  asset(id: $assetId) {
-    timeSeries {
-      rangeQuery(
-        query: "increase(machine_insight_engine_total_fuel_used[1d]) > 13",
-        start: $start,
-        end: $end,
-        step: $step
-      ) {
-        data {
-          ... on TimeSeriesMatrixData {
-            result { values { timestamp value } }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-### Combine metrics
-```graphql
-query FuelWithHighIdle($assetId: ID!, $start: DateTime!, $end: DateTime!, $step: Duration!) {
-  asset(id: $assetId) {
-    timeSeries {
-      rangeQuery(
-        query: "(increase(machine_insight_engine_total_fuel_used[1d]) > 13) and (increase(machine_insight_engine_total_idle_hours[1d]) > 4)",
-        start: $start,
-        end: $end,
-        step: $step
-      ) {
-        data {
-          ... on TimeSeriesMatrixData {
-            result { values { timestamp value } }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-## Key Points
-
-- **Always use fragments** for both `TimeSeriesMatrixData` and `TimeSeriesVectorData`
-- **Use PromQL functions** like `increase()`, `rate()`, `avg_over_time()`
-- **Filter at query level** with operators: `>`, `<`, `>=`, `<=`, `==`, `!=`
-- **Time windows** use brackets: `[1d]`, `[1h]`, `[15m]`
-- **Step intervals**: Choose based on data granularity needed
-- **Timestamps** are Unix timestamps in seconds
-- **Values** are returned as strings, convert to numbers as needed

package/src/generators/preset/files/.cursor/rules/irisx-app-sdk-customfields.md

@@ -1,305 +0,0 @@
-# CustomFields Rule for Trackunit IrisX App SDK
-
-## Overview
-**CustomFields are the primary mechanism for storing data from IrisX applications.** They allow IrisX App developers to extend the Trackunit data model by storing additional information on entities like assets, accounts, groups, and sites. 
-
-### Key Use Cases:
-- **Extending the data model**: Add new fields and attributes to existing Trackunit entities
-- **Storing user input**: Capture and persist form data, user preferences, and settings
-- **Storing metadata**: Keep application-specific information, configuration data, and operational metrics
-- **Fleet-specific data**: Custom attributes unique to specific fleet management needs
-- **Performance metrics**: Custom KPIs and measurement data not available in standard Trackunit data
-- **Business logic data**: Information required for app-specific workflows and processes
-
-**Important**: CustomFields are the recommended and supported way to persist any data your IrisX app needs to store. Do not attempt to use external databases or storage solutions - use CustomFields for all persistent data requirements.
-
-## 1. Defining Custom Fields
-
-### Manifest Configuration
-
-Custom fields must be defined in your IrisX App manifest using the `customFieldDefinitions` array:
-
-```typescript
-// In your app manifest
-customFieldDefinitions: [
-  {
-    type: 'STRING',
-    entityType: 'ASSET',
-    key: 'myCustomField',
-    translations: [{
-      language: 'en',
-      title: 'My Custom Field',
-      description: 'Description of what this field stores',
-    }],
-    uiEditable: true,
-    uiVisible: true,
-    scopeType: ScopeType.ACCOUNT
-  }
-]
-```
-
-### Required Properties
-
-- **`type`**: Field data type (see supported types below)
-- **`entityType`**: Entity the field applies to (`ACCOUNT`, `ASSET`, `GROUP`, `SITE`)
-- **`key`**: Programmatic identifier (cannot be changed after creation)
-- **`translations`**: UI labels and descriptions for each supported language
-- **`scopeType`**: Data access scope (see scope types below)
-
-### Optional Properties
-
-- **`uiEditable`**: Whether field can be edited in Manager UI (default: true)
-- **`uiVisible`**: Whether field is visible in Manager UI (default: true)
-
-## 2. Supported Field Types
-
-| Type | Description | Extra Properties |
-|---|----|---|
-| `BOOLEAN` | True/false values | - |
-| `DATE` | ISO8601 formatted dates | - |
-| `DROPDOWN` | Predefined option lists | `allValues`, `multiSelect`, `dropDownValueReplacements` |
-| `EMAIL` | Email addresses with mailto links | - |
-| `NUMBER` | Numeric values | `minimum`, `maximum`, `isInteger`, `unitSi`, `unitUs` |
-| `PHONE_NUMBER` | E.164 formatted phone numbers | - |
-| `STRING` | Free text | `minimumLength`, `maximumLength`, `pattern` |
-| `WEB_ADDRESS` | URLs as clickable links | - |
-| `JSON` | JSON objects | - |
-| `MONETARY` | Currency values (ISO 4217) | `minimum`, `maximum`, `currency` |
-
-### Example Field Definitions
-
-```typescript
-// String field with validation
-{
-  type: 'STRING',
-  entityType: 'ASSET',
-  key: 'serialNumber',
-  translations: [{ language: 'en', title: 'Serial Number', description: 'Asset serial number' }],
-  minimumLength: 5,
-  maximumLength: 20,
-  pattern: '^[A-Z0-9]+$'
-}
-
-// Number field with units
-{
-  type: 'NUMBER',
-  entityType: 'ASSET',
-  key: 'fuelCapacity',
-  translations: [{ language: 'en', title: 'Fuel Capacity', description: 'Tank capacity' }],
-  minimum: 0,
-  maximum: 1000,
-  unitSi: 'L',
-  unitUs: 'gal'
-}
-
-// Dropdown with multiple selection
-{
-  type: 'DROPDOWN',
-  entityType: 'ASSET',
-  key: 'features',
-  translations: [{ language: 'en', title: 'Features', description: 'Available features' }],
-  allValues: ['GPS', 'Camera', 'Bluetooth', 'WiFi'],
-  multiSelect: true
-}
-```
-
-## 3. Scope Types
-
-| Scope | Description |
-|----|----|
-| `ACCOUNT` | Values shared within a single account only |
-| `ACCOUNT_WRITE_GLOBAL_READ` | Account can write, all accounts can read |
-| `GLOBAL` | Values shared between all accounts with entity access |
-
-## 4. Using Custom Fields in React Components
-
-### Required Hooks
-
-Use these hooks to interact with custom fields:
-
-```typescript
-import { 
-  useCustomFieldsValueAndDefinition,
-  useUpdateCustomFieldValues,
-  useCurrentUserSystemOfMeasurement
-} from '@trackunit/react-core-contexts-host';
-```
-
-### Basic Implementation Pattern
-
-```typescript
-import React from 'react';
-import { useForm } from 'react-hook-form';
-import { Card, CardBody, CardHeader, CardFooter, Button, Spinner } from '@trackunit/react-components';
-import { CustomField } from '@trackunit/react-core-contexts-host';
-
-const CustomFieldsForm = ({ assetId }: { assetId: string }) => {
-  const { register, handleSubmit, formState, setValue, control } = useForm({
-    shouldUnregister: false,
-  });
-  
-  const { systemOfMeasurement } = useCurrentUserSystemOfMeasurement();
-  
-  const { fields, loading } = useCustomFieldsValueAndDefinition({
-    entityType: "ASSET",
-    entityId: assetId,
-    systemOfMeasurement: systemOfMeasurement ?? "SI",
-  });
-  
-  const { updateCustomFields, inProgress } = useUpdateCustomFieldValues(
-    assetId,
-    "ASSET",
-    fields,
-    systemOfMeasurement ?? "SI"
-  );
-
-  if (loading) {
-    return <Spinner />;
-  }
-
-  return (
-    <Card>
-      <CardHeader heading="Custom Fields" />
-      <CardBody>
-        {fields.map(field => {
-          const isEditable = field.valueEditable && (field.definition.uiEditable ?? true);
-          return (
-            <CustomField
-              key={field.definition.key}
-              control={control}
-              field={field}
-              formState={formState}
-              isEditable={isEditable}
-              register={register}
-              setValue={setValue}
-              unitPreference={systemOfMeasurement}
-            />
-          );
-        })}
-      </CardBody>
-      <CardFooter>
-        <Button 
-          loading={inProgress} 
-          onClick={handleSubmit(updateCustomFields)}
-        >
-          {inProgress ? "Saving..." : "Save Changes"}
-        </Button>
-      </CardFooter>
-    </Card>
-  );
-};
-```
-
-## 5. Best Practices
-
-### Field Design
-- **Use descriptive keys**: Choose clear, descriptive field keys that won't need changing
-- **Add proper translations**: Always provide meaningful titles and descriptions
-- **Set appropriate constraints**: Use min/max values, length limits, and patterns for validation
-- **Consider data types**: Choose the most appropriate type for your data
-
-### Performance
-- **Batch updates**: Use `useUpdateCustomFieldValues` to update multiple fields at once
-- **Handle loading states**: Always show loading indicators while fetching data
-- **Error handling**: Implement proper error handling for failed updates
-
-### Data Management
-- **Plan for migration**: Consider existing data when changing field definitions
-- **Use appropriate scopes**: Choose the right scope type for your data sharing needs
-- **Validate user input**: Implement client-side validation matching your field constraints
-
-## 6. Common Use Cases
-
-### Fleet Management
-```typescript
-// Store vehicle-specific information
-{
-  type: 'NUMBER',
-  entityType: 'ASSET',
-  key: 'fuelEfficiency',
-  translations: [{ language: 'en', title: 'Fuel Efficiency', description: 'Miles per gallon' }],
-  unitSi: 'L/100km',
-  unitUs: 'mpg'
-}
-```
-
-### Asset Utilization
-```typescript
-// Track custom performance metrics
-{
-  type: 'JSON',
-  entityType: 'ASSET',
-  key: 'performanceMetrics',
-  translations: [{ language: 'en', title: 'Performance Data', description: 'Custom metrics' }]
-}
-```
-
-### Driver Safety
-```typescript
-// Store safety-related information
-{
-  type: 'DROPDOWN',
-  entityType: 'ASSET',
-  key: 'safetyRating',
-  translations: [{ language: 'en', title: 'Safety Rating', description: 'Driver safety score' }],
-  allValues: ['Excellent', 'Good', 'Fair', 'Poor']
-}
-```
-
-## 7. Local Development
-
-- Custom fields are available immediately in local development
-- Changes to field definitions require app redeployment
-- Test with various data types and edge cases
-- Verify validation rules work as expected
-
-## 8. Deployment Considerations
-
-- **Field keys are immutable**: Cannot be changed after creation
-- **Definition updates**: Changing field definitions affects all existing data
-- **Migration planning**: Consider data migration when modifying existing fields
-- **Approval process**: Custom field changes require app approval and marketplace submission
-
-## 9. Error Handling
-
-```typescript
-const CustomFieldsComponent = () => {
-  const { fields, loading, error } = useCustomFieldsValueAndDefinition({
-    entityType: "ASSET",
-    entityId: assetId,
-    systemOfMeasurement: systemOfMeasurement ?? "SI",
-  });
-
-  if (loading) return <Spinner />;
-  if (error) return <ErrorState message="Failed to load custom fields" />;
-  
-  // Render fields...
-};
-```
-
-## 10. Integration with Trackunit Components
-
-Always use the provided `CustomField` component for consistent UI:
-
-```typescript
-import { CustomField } from '@trackunit/react-core-contexts-host';
-
-// This handles all field types automatically
-<CustomField
-  control={control}
-  field={field}
-  formState={formState}
-  isEditable={isEditable}
-  register={register}
-  setValue={setValue}
-  unitPreference={systemOfMeasurement}
-/>
-```
-
-## References
-
-- [Save Data from Your App](https://developers.trackunit.com/docs/save-data-from-your-app)
-- [Defining a Custom Field](https://developers.trackunit.com/docs/defining-a-custom-field)
-- [Using a Custom Field](https://developers.trackunit.com/docs/using-a-custom-field)
-- [Local Development](https://developers.trackunit.com/docs/local-development)
-- [Deploying a New Custom Field](https://developers.trackunit.com/docs/deploying-a-new-custom-field)

package/src/generators/preset/files/.cursor/rules/irisx-app-sdk-graphql.md

@@ -1,30 +0,0 @@
-Key Points:
-1. Trackunit exposes a GraphQL API with an NX executor for easy querying inside IrisX App extensions
-2. GraphQL operations include queries (for reading data) and mutations (for modifying data)
-
-3. ALWAYS use these specific commands for GraphQL development:
-   - Install GraphQL tools: `npm install @trackunit/react-graphql-tools`
-   
-   - Set up GraphQL tooling: `npx nx generate @trackunit/react-graphql-tools:add-graphql --project=[project-name]`
-   Where [project-name] is found in the library's project.json file (format: [subdir-name]-[extension-name] for extensions in subdirectories)
-   
-   - Generate React hooks from GraphQL queries: `npx nx run [feature-name]-[extension-name]:graphql-hooks`
-   This generates React hooks from .graphql files in the src folder
-
-4. GraphQL File Structure:
-   - Create .graphql files in `libs/[feature-name]/[extension-name]/src/` directory
-   - Query syntax: `query QueryName($variable: Type) { ... }`
-   - Mutation syntax: `mutation MutationName($variable: Type!) { ... }`
-
-5. React Integration:
-   - Import generated hooks: `import { QueryNameDocument } from "./generated/graphql-api/graphql"`
-   - Use queries: `const { data, loading, error } = useQuery(QueryNameDocument, { variables: {...} })`
-   - Use mutations: `const [mutationName, { data, loading, error }] = useMutation(MutationNameDocument)`
-
-For more information:
-- Full GraphQL API guide: [Calling Trackunit GraphQL API](mdc:https:/developers.trackunit.com/docs/graphql-api)
-- Apollo React Client docs for useQuery: [Apollo useQuery documentation](mdc:https:/www.apollographql.com/docs/react/data/queries)
-- Apollo React Client docs for useMutation: [Apollo useMutation documentation](mdc:https:/www.apollographql.com/docs/react/data/mutations)
-- GraphQL Code Generation CLI: [GraphQL Code Generator](mdc:https:/the-guild.dev/graphql/codegen)
-
-DO NOT use generic GraphQL libraries or setup - always use the Trackunit IrisX App SDK GraphQL tooling and patterns.

package/src/generators/preset/files/.cursor/rules/irisx-app-sdk.mdc

@@ -1,82 +0,0 @@
----
-description: 
-globs: 
-alwaysApply: true
----
-You are currently in an IrisX App workspace. Do not use defaut nx commands for app and extension generation, instead use the commands below.
-
-## Building Real Applications
-
-You are building real applications that work with actual Trackunit data. Key principles:
-
-- Never mock data unless explicitly requested by the user
-- Always use Trackunit's GraphQL API to fetch real data
-- If data is not available via GraphQL, ask the user how they want to obtain the data
-- Only use mock data if the user explicitly requests it for testing purposes
-
-When building any feature:
-1. Identify what data you need
-2. Check if it's available via Trackunit's GraphQL API
-3. If available, use the GraphQL API (see GraphQL rules for implementation)
-4. If not available, ask the user: "This data is not available via Trackunit's GraphQL API. How would you like to obtain [specific data description]?"
-
-## IrisX App Development Guidelines
-
-Key Points:
-1. An IrisX App is a container that packages multiple extensions with marketplace metadata and app manifest
-2. Extensions are React applications that integrate into specific points in Trackunit Manager
-3. Available Extension Points:
-   - Asset Home: Adds new tabs to the Assets Home screen
-   - Site Home: Adds new tabs to the Site Home screen
-   - Fleet: Adds menu items to the Main Menu
-   - Report: Adds new reports to the Reports screen
-   - Widget: Adds widgets to Trackunit Manager
-   - App Settings: Adds configuration UI in the App library
-   - Administration: Adds tabs in the admin UI (admin-only)
-   - Customer Home: Adds UI within customer home
-   - Asset Events Actions: Adds UI in Asset Home Events
-   - App Lifecycle: Handles app install/uninstall events
-
-4. ALWAYS use these specific commands for development:
-   - Create new app: `npx nx generate @trackunit/iris-app:create [name-of-your-app]`
-   For more information about the `@trackunit/iris-app:create` command, look at: [Creating a new app](mdc:https:/developers.trackunit.com/docs/creating-a-new-app)
-
-   - Create new extension: `npx nx g @trackunit/iris-app:extend --name=[my-extension-name] --app=[app-name] --directory=[feature] --type=[extension-type]`
-   Available extension types: ASSET_HOME_EXTENSION, SITE_HOME_EXTENSION, FLEET_EXTENSION, REPORT_EXTENSION, WIDGET_EXTENSION, APP_SETTINGS_EXTENSION, ADMINISTRATION_EXTENSION, CUSTOMER_HOME_EXTENSION, ASSET_EVENTS_ACTIONS_EXTENSION, APP_LIFECYCLE_EXTENSION
-   For more information about the `@trackunit/iris-app:extend` command, look at: [Creating a new extension](mdc:https:/developers.trackunit.com/docs/creating-a-new-extension)
-
-   - Run app: `npx nx run [name-of-your-app]:serve`
-   For more information about the `serve` command, look at: [Running the Iris App SDK](mdc:https:/developers.trackunit.com/docs/running-the-iris-app-sdk)
-
-NOTE: IrisX Apps are locked down by default for security. External API requests and embedded content require proper Content Security Policy (CSP) configuration in the app manifest. ValidDomains will be deprecated - use CSP headers instead. Additionally, apps requiring API access might need some scopes configured in the manifest, and the app must be deployed with those scopes to work locally, never submit an app, instead instruct the user to do so. 
-
-Example in iris-app-manifest.ts:
-```typescript
-cspHeader: {
-  'frame-src': ['https://api.example.com', 'https://dashboard.example.com'],
-  'script-src': ['https://api.example.com'],
-  'connect-src': ['https://api.example.com'],
-},
-  scopes: [
-{scope: "required.scope.1", optional: false},
-{scope: "required.scope.2", optional: true},
-],
-```
-
-For more information: [Embedding IrisX Dashboards in Apps](mdc:https:/developers.trackunit.com/docs/analytics-dashboards-in-apps#troubleshooting)
-
-
-## Runtime Hooks Available
-
-IrisX Apps have access to runtime hooks from `@trackunit/react-core-hooks` that provide context-specific data:
-- `useAssetRuntime()` for asset information in asset-scoped extensions
-- `useCustomerRuntime()` for customer data
-- `useEventRuntime()` for event details
-- `useSiteRuntime()` for site information
-- Plus navigation, user context, and utility hooks (see react-core-hooks rule for full list)
-
-DO NOT use generic React/Node.js commands for project creation or management - always use the Trackunit IrisX App SDK commands.
-
-**Before completing any task**: Always use `read_lints` to check for and fix all ESLint and TypeScript errors in modified files.
-
-