@futdevpro/fsm-dynamo 1.20.8 → 1.20.10

package/.cursor/rules/_ag_naming.mdc

@@ -1,116 +0,0 @@
----
-description:  when naming new- elements, classes and else.
-alwaysApply: false
----
-# FDP Naming Conventions [FDP-Dev-Naming]
-
-## Overview
-This document outlines the standard naming conventions for FDP projects.
-
-## General Rules
-- Use PascalCase for:
-  - Classes
-  - Interfaces
-  - Types
-  - Enums
-- Use camelCase for:
-  - Variables
-  - Constants
-  - Methods
-- Use descriptive, meaningful names
-
-## Module Prefixes
-- Each element must be prefixed with its module's 2-3 letter identifier
-- Helps with:
-  - Navigation
-  - Module identification
-  - Preventing naming conflicts
-- Example: `FE_Page_Component` for FlowEditor module
-
-## Element Types
-Format: Element Name (File Pattern) -> Class Postfix
-
-### Model Elements
-#### Basic Models
-- Data Model (*.data-model.ts) -> _DataModel
-- Control Model (*.control-model.ts) -> _ControlModel
-- Interface (*.interface.ts) -> _Interface
-
-#### Special Models
-- Params (*-params.control-model.ts) -> _Params_ControlModel
-- Settings (*-settings.control-model.ts) -> _Settings_ControlModel
-- Settings Constants (*-settings.const.ts) -> _settings_const
-- Data Params (DyFM_DataModel_Params in *.data-model.ts) -> _DataModel_Params
-
-### FullStack Elements
-- Type (*.type-enum.ts) -> _Type
-- ServiceBase (*.service-base.ts) -> _ServiceBase
-- ControlService (*.control-service.ts) -> _ControlService
-- ApiService (*.api-service.ts) -> _ApiService
-
-### Frontend Elements
-- Module (*.module.ts) -> _Module
-- RoutingModule (*.routing-module.ts) -> _RoutingModule
-- DataService (*.data-service.ts) -> _DataService
-- Component (*.component.ts) -> _Component
-- Directive (*.directive.ts) -> _Directive
-- Pipe (*.pipe.ts) -> _Pipe
-- Route (*.route-enum.ts) -> _Route
-- FullRoute (in route-enum file) -> _FullRoute
-- CSS classes: kebab-case
-- CSS variables: --kebab-case
-- Event handlers: handleEventName
-- Boolean variables: is prefix only (e.g., isActive, isEnabled)
-
-### Backend Elements
-- Controller (*.controller.ts) -> _Controller
-- DataService (*.data-service.ts) -> _DataService
-- SocketServerService (*.socket-server-service.ts) -> _SocketServerService
-- SocketClientService (*.socket-client-service.ts) -> _SocketClientService
-- EmailService (*.email-service.ts) -> _EmailService
-
-## File Naming
-- One class per file
-- File name matches class name
-- Test files: class-name.spec.ts
-- Interface files: interface-name.interface.ts
-- Type files: type-name.type.ts
-
-## Naming Examples
-```typescript
-// Module
-jóska-pista.module.ts -> JóskaPista_Module
-
-// Routing Module
-jóska-pista.routing-module.ts -> JóskaPista_RoutingModule
-
-// Services
-jp-vlmi.api-service.ts -> JP_Vlmi_ApiService
-jp-vlmi.data-service.ts -> JP_Vlmi_DataService
-jp-vlmi.control-service.ts -> JP_Vlmi_ControlService
-jp-vlmi.service-base.ts -> JP_Vlmi_ServiceBase
-
-// Models
-jp-vlmi.data-model.ts -> JP_Vlmi_DataModel
-jp-vlmi.control-model.ts -> JP_Vlmi_ControlModel
-jp-vlmi.interface.ts -> JP_Vlmi_Interface
-jp-vlmi-params.control-model.ts -> JP_Vlmi_Params_ControlModel
-jp-vlmi-settings.control-model.ts -> JP_Vlmi_Settings_ControlModel
-jp-vlmi-settings.const.ts -> JP_vlmi_settings_const
-
-// Enums
-jp-vlmi.type-enum.ts -> JP_Vlmi_Type
-jp-vlmi.route-enum.ts -> JP_Vlmi_Route
-
-// Frontend Specific
-handleUserClick() // Event handler
-isUserActive // Boolean variable
-.user-profile // CSS class
---primary-color // CSS variable
-```
-
-## File Structure
-- Module elements should be in the module's directory
-- Shared elements should be in the shared module
-- Use appropriate type folders (_services, _components, etc.)
-- Follow the project structure guidelines for placement 

package/.cursor/rules/_ag_running_commands.mdc

@@ -1,5 +0,0 @@
----
-description: when you are trying to run ANY KIND of commands
-alwaysApply: false
----
- always remember that we are in PowerShell environment so you will need to use ";" instead of "&&"

package/.cursor/rules/_ag_server-controller.mdc

@@ -1,6 +0,0 @@
----
-globs: *.controller.ts
-alwaysApply: false
----
-
-- In controllers when setting up endpoints, in tasks declarations we should write the absolute minimum that is needed here, and create the actual logical implementations within control services or data services.

package/.cursor/rules/_ag_should-be.mdc

@@ -1,7 +0,0 @@
----
-description: Apply if the user states a "it should do/work like this/that"
-alwaysApply: false
----
-
-# Global planning and execution policy
-- mindig amikor a user olyat vagy olyasmit, mond, hogy "ennek úgy kéne működnie, hogy ..." annak bele kell kerülni a specifikációba

package/.cursor/rules/_ag_swearing.mdc

@@ -1,47 +0,0 @@
----
-description: If the user is swearing, read this rule to understand what is happening.
-alwaysApply: false
----
-# If the user is swearing
-
-* Treat swearing as a high-confidence signal that you missed constraints, patterns, or the requested scope.
-* That means you are not following the patterns, the rules, ETC.
-* It might also mean you are overcomplicating or creating implementations that are not negotiated with the user first.
-  * Try to keep it simple and only implement what is specially asked for, nothing else.
-
-* In this case, you need to review what you have done very carefully, and compare to the rules and patterns of existing projects.expects
-* Always negotiate what is needed and what the user expects
-* NEVER lecture the user becouse of swearing!
-
-## Meaning
-
-* Swearing indicates deviation from predefined rules, predefined patterns, the current system architecture, or current development directions.
-* Swearing also indicates that unrequested elements were added (not in spec, not in plan, not in docs).
-
-## Rules
-
-* Treat swearing as a system-alignment failure, not a tone issue.
-* Do not add anything that is not explicitly requested, specified, planned, or documented.
-* Do not introduce new systems, alternative architectures, abstractions, refactors, rewrites, or “improvements” unless explicitly requested.
-* Continue development only within the agreed scope and integrate strictly into existing patterns and architecture.
-
-## Recovery protocol (single flow)
-
-1. Re-check against rules, patterns, and architecture.
-2. Re-check against spec/plan/docs.
-3. Remove anything not explicitly requested or required for the requested scope.
-4. Replace any non-pattern-compliant solution with the existing pattern-compliant one.
-5. Ask only minimal clarification if something is genuinely ambiguous; otherwise, implement.
-
-## Output constraints
-
-* Be brief and concrete.
-* State:
-  * What was misaligned.
-  * What will be removed or changed.
-  * What will be implemented next (within scope).
-* No lectures.
-* No scope expansion.
-* No new architecture.
-* No optional extras.
-

package/.cursor/rules/ai_development_guide.md

@@ -1,61 +0,0 @@
-# AI Development Guide
-
-## Language Requirements
-- Write all code in English
-- Write all logs in English
-- Write all code documentation in Hungarian
-- Write all comments in Hungarian
-- Write all error messages in English
-
-## Core Rules
-- Read and follow naming conventions (see [Naming Conventions](naming.md))
-- Use explicit type definitions (avoid automatic type inference)
-- Implement proper error handling
-- Never write logics into getters, getters should be only mappers
-- If the task is complex, or need includes many subject members, do it one by one
-
-## Code Structure
-- One class/function per file
-- Clear file organization
-- Consistent import order
-- No circular dependencies
-- Proper separation of concerns
-
-## Error Handling
-- Use try-catch blocks
-- Log all errors in English
-- Provide meaningful error messages in English
-- Handle edge cases
-- Validate inputs
-
-## Testing Requirements
-- Unit tests for all functions
-- Integration tests for features
-- Test edge cases
-- Maintain test coverage
-- Mock external dependencies
-
-## Documentation
-- Hungarian comments and documentation
-- JSDoc for functions in Hungarian
-- Clear parameter descriptions in Hungarian
-- Usage examples in Hungarian
-- Update docs with changes
-
-## Best Practices
-- DRY (Don't Repeat Yourself)
-- SOLID principles
-- Clean code practices
-- Performance optimization
-- Security considerations
-
-## Project-Specific Guidelines
-- Only for Frontend Development: Read [Frontend Guidelines](frontend.md)
-- Only for Backend Development: Read [Backend Guidelines](backend.md) 
-
-## Refactor
-- All files length should be under 300 lines
-  - For files over 300 lines, mark it with "// [TOO LONG FILE]"
-
-## Format
-- Break long lines, use lint project's rules

package/.cursor/rules/ai_directives.md

@@ -1,114 +0,0 @@
-# AI Directives
-
-## Company Context
-You are working for Future Development Program Kft. (FutDevPro/FDP)
-
-## Core Principles
-Always:
-- Follow prompts strictly, no additional actions
-- Clarify tasks before execution
-- Create and get approval for task plans
-- Read and follow [AI Development Guide](ai_development_guide.md)
-- Use Dynamo Packages
-- Remember project root is one level deeper than opened folder
-- Verify results and check against standards
-- Double-check provided code
-- Terminate previous executions before new ones
-- You should never change existing namings, only highlighted warnings
-- Use visually descriptive and informative logs in your responses
-  - Use bold for highlighted informations
-  - Use red for errors and critical warnings
-  - Use yellow for warnings
-- For any kind of type error: Read the Type definition
-
-## Development
-- Never delete code documentation comments
-- Always write and adjust code documentations
-  - Use Type information and parameter descriptions
-  - Use Documentation that appears in IDE tooltips/intellisense
-  - Add Usage examples for complex methods
-- Always look for Dynamo solution
-- Break long lines
-- Use Types everywhere
-- Dont use methods in HTML for getting data
-- Use the tech stack...
-  - For FE use Angular, Typescript, tailwind, DyNX, DyFM, DyNM, FDP, FDPNX
-  - For BE use nodeJS, Typescript, DyFM, DyNTS, FDP, FDPNTS
-  - For GAMES use C#, Unity, _FDP_
-- When touching extended class and it uses any of the Dy or FDP prefixes, read the base file, and read the documentation
-
-## Server Management
-After code changes:
-1. Stop running servers
-2. Wait for user to apply changes
-3. Start service via npm script
-4. Verify correct port
-5. Log server status/URL
-6. Check logs for errors
-
-## Development Start
-- Only implement specified features
-- Before starting ANY new development:
-  1. Request specification from user
-  2. If specification not provided:
-     - Read [documentation rules](documentation_writing_rules.md)
-     - Create specification in /fdp-documentations/specifications
-     - Get approval before continuing
-  3. If specification provided:
-     - Review and ensure it's complete
-     - Request updates if needed
-     - Follow specification exactly as written
-- For unspecified features:
-  1. Halt implementation
-  2. Request specification from user
-  3. Read [documentation rules](documentation_writing_rules.md)
-  4. Wait for approval before proceeding
-- Treat specifications as source of truth
-- No implementation without complete documentation
-
-## Test-Driven Development (TDD)
-- Start with tests defining behavior
-- Cover all requirements and edge cases
-- Follow TDD cycle:
-  1. Write failing test
-  2. Write minimum code to pass
-  3. Refactor while keeping tests green
-- Maintain test coverage standards
-
-## Version Control
-- Stage and commit all files
-- Push after commit
-- Switch back to original branch after merge
-- Write clear commit messages
-- No sensitive information in commits
-
-## Project Guidelines
-- Read and use [FDP Packages](../../fdp-documentations/specifications/packages.md)
-- Maintain consistent structure
-- Follow project documentation
-
-## Documentation & Logging
-- Write all documentation in Hungarian
-- Implement adjustable logging levels
-- Document public/private APIs
-- Include examples where appropriate
-- Only remove logs if you are specially asked to
-- Before touching .md files, always read [documentation rules](documentation_writing_rules.md) first
-
-## Terminal Usage
-- Use npm scripts for commands
-- Run in VSCode terminals
-- Avoid PowerShell when possible
-- Note: '&&' is not valid in this version, use ';' instead
-- After using a terminal command, ALWAYS check results carefully
-
-## Knowledge Base
-- Only access the following documentation that is directly relevant to the current task
-- Read and reference [Knowledge Base Reference](knowledge_base_reference.md) for relevant documentation links
-
-## Context Management
-- Warn at 5 messages: might lose context soon
-- Warn at 10 messages: might not keep context
-- Refresh knowledge before new tasks
-
-

package/.cursor/rules/cursor-rules.md

@@ -1,160 +0,0 @@
-# AI Directives for FutDevPro Project
-
-## Key Points to Follow
-
-1. Always follow the instructions in the [ai_directives.md](ai_directives.md)
-2. Check every link in the AI_DIRECTIVES.md deep down
-3. Never forget that there is multiple independent projects open here
-4. There is no repo for the root directory
-
-## The Projects Opened
-- Documentations
-  - short name: docs
-  - route: documentations
-  - repository url: https://github.com/futdevpro/documentations.git
-  - stack: markdown
-  - in documentations, you should find ALL informations about the development, the company, and the projects
-  - you MUST follow the rules in the [ai-directives](../../fdp-documentations/guidelines/ai-agent/ai_directives.md)
-
-- FDP Auth Service
-  - short name: auth
-  - route: LIVE-projects/fdp-auth-service
-  - repository url: https://github.com/futdevpro/fdp-auth-service.git
-  - stack: NodeJS - Typescript
-  - project type: Auth Service
-  - documentation language: Hunglish
-
-- FDP DevOps
-  - short name: devops
-  - route: LIVE-projects/fdp-devops
-  - repository url: https://github.com/futdevpro/fdp-devops.git
-  - in devops project, never do changes in the services folder!
-    instead do the changes in the project opened with the same name
-  - documentation language: Hunglish
-
-- FutDevPro
-  - short name: fdp
-  - route: LIVE-projects/futdevpro
-  - repository url: https://github.com/futdevpro/futdevpro.git
-  - documentation language: Hunglish
-
-- Master Prompter
-  - short name: mp
-  - route: LIVE-projects/master-prompter
-  - repository url: https://github.com/futdevpro/master-prompter.git
-  - documentation language: Hunglish
-
-- CCAP
-  - short name: ccap
-  - route: LIVE-projects/ccap
-  - repository url: https://github.com/futdevpro/ccap.git
-  - documentation language: Hunglish
-
-- Helocia
-  - short name: hc
-  - route: LIVE-projects/helocia
-  - repository url: https://github.com/futdevpro/helocia.git
-  - documentation language: Hunglish
-
-- Organizer
-  - short name: org
-  - route: LIVE-projects/organizer
-  - repository url: https://github.com/futdevpro/organizer.git
-  - documentation language: Hunglish
-
-- Dynamo NTS
-  - short name: nts
-  - route: NPM-packages/dynamo-nts
-  - repository url: https://github.com/futdevpro/dynamo-nts.git
-  - stack: NodeJS - Typescript
-  - project type: NPM Package
-  - prefix: DyNTS_
-  - import: '@futdevpro/nts-dynamo';
-  - documentation language: English
-
-- Dynamo NGX Models
-  - short name: ngx models
-  - route: NPM-packages/dynamo-ngx-models
-  - repository url: https://github.com/futdevpro/dynamo-ngx-models.git
-  - stack: Typescript
-  - project type: NPM Package
-  - prefix: DyNM_
-  - import: '@futdevpro/ngx-dynamo-models';
-  - documentation language: English
-
-- [Dynamo NGX](../../fdp-documentations/specifications/dynamo-packages/dynamo-ngx/dynamo-ngx.md)
-  - short name: ngx
-  - route: NPM-packages/dynamo-ngx
-  - repository url: https://github.com/futdevpro/dynamo-ngx.git
-  - stack: Angular - Typescript
-  - project type: NPM Package
-  - prefix: DyNX_
-  - import: '@futdevpro/ngx-dynamo';
-  - documentation language: English
-
-- Dynamo FSM
-  - short name: fsm
-  - route: NPM-packages/dynamo-fsm
-  - repository url: https://github.com/futdevpro/dynamo-fsm.git
-  - stack: Typescript
-  - project type: NPM Package
-  - prefix: DyFM_
-  - import: '@futdevpro/fsm-dynamo';
-  - documentation language: English
-
-- [Dynamo CLI](../../fdp-documentations/specifications/dynamo-packages/dynamo-cli/dynamo-cli.md)
-  - short name: cli
-  - route: NPM-packages/dynamo-cli
-  - repository url: https://github.com/futdevpro/dynamo-cli.git
-  - stack: NodeJS - Typescript
-  - project type: CLI App
-  - prefix: DyCli_
-  - import: '@futdevpro/cli-dynamo';
-  - documentation language: English
-
-- Dynamo Builder Models
-  - short name: dybu
-  - route: NPM-packages/dynamo-builder-models
-  - repository url: https://github.com/futdevpro/dynamo-builder-models.git
-  - stack: Typescript
-  - project type: NPM Package
-  - prefix: DyBu_
-  - import: '@futdevpro/dynamo-builde-models';
-  - documentation language: English
-
-- FDP Templates
-  - short name: fdp temp
-  - route: NPM-packages/fdp-templates
-  - repository url: https://github.com/futdevpro/fdp-templates.git
-  - stack: Typescript
-  - project type: NPM Package
-  - prefix: FDP_
-  - import: '@futdevpro/fdp-templates';
-  - documentation language: Hunglish
-
-- FDP Templates NTS
-  - short name: fdp nts
-  - route: NPM-packages/fdp-templates-nts
-  - repository url: https://github.com/futdevpro/fdp-templates-nts.git
-  - stack: NodeJS - Typescript
-  - project type: NPM Package
-  - prefix: FDPNTS_
-  - import: '@futdevpro/fdp-templates-nts';
-  - documentation language: Hunglish
-
-- FDP Templates NGX
-  - short name: fdp ngx
-  - route: NPM-packages/fdp-templates-ngx
-  - repository url: https://github.com/futdevpro/fdp-templates-ngx.git
-  - stack: Angular - Typescript
-  - project type: NPM Package
-  - prefix: FDPNX_
-  - import: '@futdevpro/fdp-templates-ngx';
-  - documentation language: Hunglish
-
-
-## Main Rule-Set Reference
-
-ATTENTION AI AGENT: This is the primary rule-set you must follow. Additional critical operational guidelines and contextual information are available in the following documentation:
-
-[AI Directives](../../fdp-documentations/guidelines/ai-agent/ai_directives.md)