update rules for apps

Author: freacatt

.trae/rules/apps/context-documents.md

@@ -21,3 +21,22 @@ export interface ContextDocument {
   directoryId?: string | null;
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/contextDocumentService.ts](file:///home/pouria/projects/pyramid-solver/src/services/contextDocumentService.ts).
+
+### Core Functions
+- **Document Management**:
+  - `createContextDocument`: Initializes a document with empty content and type 'text'.
+  - `getUserContextDocuments`: Fetches documents filtered by `userId` and optionally `workspaceId`.
+  - `updateContextDocument`: Supports partial updates (patch) for title, content, type, etc.
+- **Directory Management**: (Implemented in [src/services/directoryService.ts](file:///home/pouria/projects/pyramid-solver/src/services/directoryService.ts))
+  - `createDirectory`: Creates a new folder to organize documents.
+  - `deleteDirectory`: Deletes a directory and moves all contained documents to the root (sets `directoryId` to null).
+  - `getDirectoryDocuments`: Fetches documents within a specific directory (or root if `directoryId` is null).
+
+### Invariants
+- Documents must always be associated with a `userId`.
+- The `type` field defaults to "text" but can support other formats.
+- When a directory is deleted, its documents are preserved but moved to the root level.

.trae/rules/apps/diagrams.md

@@ -25,3 +25,15 @@ export interface Diagram {
   edges: any[];
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/diagramService.ts](file:///home/pouria/projects/pyramid-solver/src/services/diagramService.ts).
+
+### Core Functions
+- **CRUD**: Standard `createDiagram`, `getDiagram`, `updateDiagram`, `deleteDiagram` operations.
+- **Initialization**: New diagrams start with empty `nodes` and `edges` arrays.
+- **Timestamps**: `updateDiagram` automatically updates the `lastModified` timestamp.
+
+### Invariants
+- `nodes` and `edges` default to empty arrays if undefined in storage.

.trae/rules/apps/product-definition.md

@@ -30,3 +30,19 @@ export interface ProductDefinition {
   data: Record<string, ProductDefinitionNode>;
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/productDefinitionService.ts](file:///home/pouria/projects/pyramid-solver/src/services/productDefinitionService.ts).
+
+### Core Functions
+- **Template Initialization**: `createProductDefinition` creates a new definition with a pre-defined tree structure:
+  1. **Problem & Goals**: (Problem Statement, Investment Limits, Baseline Comparison)
+  2. **Solution Concepts**: (Key Flows, Rough Sketches, Scope Boundaries)
+  3. **Risks & Unknowns**: (Technical Risks, Design Challenges, Risk Mitigation)
+  4. **Implementation Strategy**: (Components, Complexity Analysis, Milestones)
+- **Data Normalization**: `mapDefinitionFromStorage` ensures that database snake_case fields are correctly mapped to TypeScript camelCase properties.
+
+### Invariants
+- New definitions always start with the standard 4-section template.
+- The `root` node always has ID "root".

.trae/rules/apps/pyramid-solver.md

@@ -22,3 +22,17 @@ export interface Pyramid {
   contextSources?: ContextSource[];
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/pyramidService.ts](file:///home/pouria/projects/pyramid-solver/src/services/pyramidService.ts).
+
+### Core Functions
+- **Initialization**: `createPyramid` initializes a new pyramid with a standard 8x8 grid (64 blocks) of type 'question'.
+- **Duplication**: `duplicatePyramid` creates a deep copy of a pyramid, appending "(Copy)" to the title, but resetting the ID and timestamps.
+- **Sorting**: `getUserPyramids` returns pyramids sorted by `lastModified` descending (newest first).
+- **Real-time Sync**: `subscribeToPyramid` provides real-time updates via the storage adapter's subscription mechanism.
+
+### Invariants
+- Every pyramid MUST have exactly 64 blocks initialized upon creation.
+- Deleting a pyramid (`deletePyramid`) permanently removes it from storage.

.trae/rules/apps/technical-architecture.md

@@ -113,3 +113,20 @@ export interface TechnicalArchitecture {
   };
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/technicalArchitectureService.ts](file:///home/pouria/projects/pyramid-solver/src/services/technicalArchitectureService.ts).
+
+### Core Functions
+- **Template Initialization**: `createTechnicalArchitecture` initializes a comprehensive schema with empty placeholders for all major architectural sections:
+  - System Architecture
+  - Technology Stack
+  - Code Organization
+  - Design Patterns
+  - API Standards
+  - Security Standards
+- **Data Mapping**: `mapArchitectureFromStorage` handles the conversion from storage format to the TypeScript interface.
+
+### Invariants
+- New architectures are always initialized with the full, deep structure to ensure UI components don't crash on missing nested fields.

.trae/rules/apps/technical-tasks.md

@@ -33,3 +33,18 @@ export interface TechnicalTaskData {
     preservation_rules: Section<PreservationRulesMain, PreservationRulesAdvanced>;
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/technicalTaskService.ts](file:///home/pouria/projects/pyramid-solver/src/services/technicalTaskService.ts).
+
+### Core Functions
+- **Pipeline Management**: `getPipelines` fetches task pipelines and automatically deduplicates "Backlog" pipelines if multiple are found (merging tasks into one).
+- **Batch Updates**: 
+  - `batchUpdatePipelines`: Updates the order of pipelines.
+  - `batchUpdateTasks`: Updates the order and pipeline assignment of tasks (drag-and-drop).
+- **Dual Write**: `batchUpdateTasks` updates both `technicalTasks` (local/app context) and `globalTasks` (global context) to ensure visibility.
+
+### Invariants
+- A "Backlog" pipeline is automatically created if no pipelines exist.
+- Tasks must always belong to a `pipelineId`.

.trae/rules/apps/ui-ux-architecture.md

@@ -22,3 +22,17 @@ export interface UiUxArchitecture {
   ux_patterns: UxPatterns;
 }
 ```
+
+## Logic & Rules
+
+The core business logic is implemented in [src/services/uiUxArchitectureService.ts](file:///home/pouria/projects/pyramid-solver/src/services/uiUxArchitectureService.ts).
+
+### Core Functions
+- **Template Initialization**: `createUiUxArchitecture` initializes a structure with:
+  - **Theme Specification**: Colors, typography, spacing, border radius.
+  - **UX Patterns**: Loading states, error states, empty states.
+  - Empty lists for `base_components` and `pages`.
+- **Data Mapping**: `mapArchitectureFromStorage` converts storage timestamps (Firestore `Timestamp` or string) to ISO strings.
+
+### Invariants
+- Timestamps (`createdAt`, `updatedAt`) are always returned as ISO strings.