geminize 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/.cursor/mcp.json +3 -0
  3. data/.cursor/rules/isolation_rules/Core/command-execution.mdc +235 -0
  4. data/.cursor/rules/isolation_rules/Core/complexity-decision-tree.mdc +187 -0
  5. data/.cursor/rules/isolation_rules/Core/creative-phase-enforcement.mdc +145 -0
  6. data/.cursor/rules/isolation_rules/Core/creative-phase-metrics.mdc +195 -0
  7. data/.cursor/rules/isolation_rules/Core/file-verification.mdc +198 -0
  8. data/.cursor/rules/isolation_rules/Core/platform-awareness.mdc +71 -0
  9. data/.cursor/rules/isolation_rules/Level3/planning-comprehensive.mdc +159 -0
  10. data/.cursor/rules/isolation_rules/Level3/task-tracking-intermediate.mdc +135 -0
  11. data/.cursor/rules/isolation_rules/Phases/CreativePhase/creative-phase-architecture.mdc +187 -0
  12. data/.cursor/rules/isolation_rules/main.mdc +123 -0
  13. data/.cursor/rules/isolation_rules/visual-maps/archive-mode-map.mdc +277 -0
  14. data/.cursor/rules/isolation_rules/visual-maps/creative-mode-map.mdc +224 -0
  15. data/.cursor/rules/isolation_rules/visual-maps/implement-mode-map.mdc +321 -0
  16. data/.cursor/rules/isolation_rules/visual-maps/plan-mode-map.mdc +269 -0
  17. data/.cursor/rules/isolation_rules/visual-maps/qa-mode-map.mdc +495 -0
  18. data/.cursor/rules/isolation_rules/visual-maps/reflect-mode-map.mdc +234 -0
  19. data/.cursor/rules/isolation_rules/visual-maps/van-mode-map.mdc +902 -0
  20. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-complexity-determination.mdc +60 -0
  21. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-file-verification.mdc +49 -0
  22. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-mode-map.mdc +49 -0
  23. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-platform-detection.mdc +50 -0
  24. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/build-test.mdc +117 -0
  25. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/config-check.mdc +103 -0
  26. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/dependency-check.mdc +147 -0
  27. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/environment-check.mdc +104 -0
  28. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/file-verification.mdc +1 -0
  29. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-main.mdc +142 -0
  30. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/common-fixes.mdc +92 -0
  31. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/mode-transitions.mdc +101 -0
  32. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/reports.mdc +149 -0
  33. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/rule-calling-guide.mdc +66 -0
  34. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/rule-calling-help.mdc +19 -0
  35. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-validation.md.old +363 -0
  36. data/.env.example +7 -0
  37. data/.memory_bank/activeContext.md +78 -0
  38. data/.memory_bank/progress.md +80 -0
  39. data/.memory_bank/projectbrief.md +29 -0
  40. data/.memory_bank/systemPatterns.md +90 -0
  41. data/.memory_bank/tasks.md +98 -0
  42. data/.memory_bank/techContext.md +73 -0
  43. data/.tool-versions +1 -0
  44. data/CHANGELOG.md +20 -0
  45. data/README.md +42 -5
  46. data/examples/models_api.rb +125 -0
  47. data/lib/geminize/configuration.rb +4 -4
  48. data/lib/geminize/model_info.rb +87 -8
  49. data/lib/geminize/models/model.rb +101 -109
  50. data/lib/geminize/models/model_list.rb +70 -28
  51. data/lib/geminize/request_builder.rb +29 -0
  52. data/lib/geminize/version.rb +1 -1
  53. data/lib/geminize.rb +71 -14
  54. metadata +45 -2
@@ -0,0 +1,135 @@
1
+ ---
2
+ description: task tracking intermediate
3
+ globs: task-tracking-intermediate.mdc
4
+ alwaysApply: false
5
+ ---
6
+ # LEVEL 3 INTERMEDIATE TASK TRACKING
7
+
8
+ > **TL;DR:** This document provides structured task tracking guidelines for Level 3 (Intermediate Feature) tasks, using visual tracking elements and clear checkpoints.
9
+
10
+ ## 🔍 TASK TRACKING WORKFLOW
11
+
12
+ ```mermaid
13
+ graph TD
14
+ Start["Task Start"] --> Init["📋 Initialize<br>Task Entry"]
15
+ Init --> Struct["🏗️ Create Task<br>Structure"]
16
+ Struct --> Track["📊 Progress<br>Tracking"]
17
+ Track --> Update["🔄 Regular<br>Updates"]
18
+ Update --> Complete["✅ Task<br>Completion"]
19
+
20
+ Struct --> Components["Components:"]
21
+ Components --> Req["Requirements"]
22
+ Components --> Steps["Implementation<br>Steps"]
23
+ Components --> Creative["Creative Phase<br>Markers"]
24
+ Components --> Check["Checkpoints"]
25
+
26
+ Track --> Status["Track Status:"]
27
+ Status --> InProg["🔄 In Progress"]
28
+ Status --> Block["⛔ Blocked"]
29
+ Status --> Done["✅ Complete"]
30
+ Status --> Skip["⏭️ Skipped"]
31
+
32
+ style Start fill:#4da6ff,stroke:#0066cc,color:white
33
+ style Init fill:#ffa64d,stroke:#cc7a30,color:white
34
+ style Struct fill:#4dbb5f,stroke:#36873f,color:white
35
+ style Track fill:#d94dbb,stroke:#a3378a,color:white
36
+ style Update fill:#4dbbbb,stroke:#368787,color:white
37
+ style Complete fill:#d971ff,stroke:#a33bc2,color:white
38
+ ```
39
+
40
+ ## 📋 TASK ENTRY TEMPLATE
41
+
42
+ ```markdown
43
+ # [Task Title]
44
+
45
+ ## Requirements
46
+ - [ ] Requirement 1
47
+ - [ ] Requirement 2
48
+ - [ ] Requirement 3
49
+
50
+ ## Components Affected
51
+ - Component 1
52
+ - Component 2
53
+ - Component 3
54
+
55
+ ## Implementation Steps
56
+ 1. [ ] Step 1
57
+ 2. [ ] Step 2
58
+ 3. [ ] Step 3
59
+
60
+ ## Creative Phases Required
61
+ - [ ] 🎨 UI/UX Design
62
+ - [ ] 🏗️ Architecture Design
63
+ - [ ] ⚙️ Algorithm Design
64
+
65
+ ## Checkpoints
66
+ - [ ] Requirements verified
67
+ - [ ] Creative phases completed
68
+ - [ ] Implementation tested
69
+ - [ ] Documentation updated
70
+
71
+ ## Current Status
72
+ - Phase: [Current Phase]
73
+ - Status: [In Progress/Blocked/Complete]
74
+ - Blockers: [If any]
75
+ ```
76
+
77
+ ## 🔄 PROGRESS TRACKING VISUALIZATION
78
+
79
+ ```mermaid
80
+ graph TD
81
+ subgraph "TASK PROGRESS"
82
+ P1["✓ Requirements<br>Defined"]
83
+ P2["✓ Components<br>Identified"]
84
+ P3["→ Creative Phase<br>In Progress"]
85
+ P4["□ Implementation"]
86
+ P5["□ Testing"]
87
+ P6["□ Documentation"]
88
+ end
89
+
90
+ style P1 fill:#4dbb5f,stroke:#36873f,color:white
91
+ style P2 fill:#4dbb5f,stroke:#36873f,color:white
92
+ style P3 fill:#ffa64d,stroke:#cc7a30,color:white
93
+ style P4 fill:#d94dbb,stroke:#a3378a,color:white
94
+ style P5 fill:#4dbbbb,stroke:#368787,color:white
95
+ style P6 fill:#d971ff,stroke:#a33bc2,color:white
96
+ ```
97
+
98
+ ## ✅ UPDATE PROTOCOL
99
+
100
+ ```mermaid
101
+ sequenceDiagram
102
+ participant Task as Task Entry
103
+ participant Status as Status Update
104
+ participant Creative as Creative Phase
105
+ participant Implementation as Implementation
106
+
107
+ Task->>Status: Update Progress
108
+ Status->>Creative: Flag for Creative Phase
109
+ Creative->>Implementation: Complete Design
110
+ Implementation->>Status: Update Status
111
+ Status->>Task: Mark Complete
112
+ ```
113
+
114
+ ## 🎯 CHECKPOINT VERIFICATION
115
+
116
+ | Phase | Verification Items | Status |
117
+ |-------|-------------------|--------|
118
+ | Requirements | All requirements documented | [ ] |
119
+ | Components | Affected components listed | [ ] |
120
+ | Creative | Design decisions documented | [ ] |
121
+ | Implementation | Code changes tracked | [ ] |
122
+ | Testing | Test results recorded | [ ] |
123
+ | Documentation | Updates completed | [ ] |
124
+
125
+ ## 🔄 DOCUMENT MANAGEMENT
126
+
127
+ ```mermaid
128
+ graph TD
129
+ Current["Current Documents"] --> Active["Active:<br>- task-tracking-intermediate.md<br>- planning-comprehensive.md"]
130
+ Current --> Required["Required Next:<br>- creative-phase-enforcement.md<br>- implementation-phase-reference.md"]
131
+
132
+ style Current fill:#4da6ff,stroke:#0066cc,color:white
133
+ style Active fill:#4dbb5f,stroke:#36873f,color:white
134
+ style Required fill:#ffa64d,stroke:#cc7a30,color:white
135
+ ```
@@ -0,0 +1,187 @@
1
+ ---
2
+ description: creative phase architecture
3
+ globs: creative-phase-architecture.md
4
+ alwaysApply: false
5
+ ---
6
+
7
+ # CREATIVE PHASE: ARCHITECTURE DESIGN
8
+
9
+ > **TL;DR:** This document provides structured guidance for architectural design decisions during creative phases, ensuring comprehensive evaluation of options and clear documentation of architectural choices.
10
+
11
+ ## 🏗️ ARCHITECTURE DESIGN WORKFLOW
12
+
13
+ ```mermaid
14
+ graph TD
15
+ Start["Architecture<br>Design Start"] --> Req["1. Requirements<br>Analysis"]
16
+ Req --> Comp["2. Component<br>Identification"]
17
+ Comp --> Options["3. Architecture<br>Options"]
18
+ Options --> Eval["4. Option<br>Evaluation"]
19
+ Eval --> Decision["5. Decision &<br>Documentation"]
20
+ Decision --> Valid["6. Validation &<br>Verification"]
21
+
22
+ style Start fill:#4da6ff,stroke:#0066cc,color:white
23
+ style Req fill:#ffa64d,stroke:#cc7a30,color:white
24
+ style Comp fill:#4dbb5f,stroke:#36873f,color:white
25
+ style Options fill:#d94dbb,stroke:#a3378a,color:white
26
+ style Eval fill:#4dbbbb,stroke:#368787,color:white
27
+ style Decision fill:#d971ff,stroke:#a33bc2,color:white
28
+ style Valid fill:#ff71c2,stroke:#c23b8a,color:white
29
+ ```
30
+
31
+ ## 📋 ARCHITECTURE DECISION TEMPLATE
32
+
33
+ ```markdown
34
+ # Architecture Decision Record
35
+
36
+ ## Context
37
+ - System Requirements:
38
+ - [Requirement 1]
39
+ - [Requirement 2]
40
+ - Technical Constraints:
41
+ - [Constraint 1]
42
+ - [Constraint 2]
43
+
44
+ ## Component Analysis
45
+ - Core Components:
46
+ - [Component 1]: [Purpose/Role]
47
+ - [Component 2]: [Purpose/Role]
48
+ - Interactions:
49
+ - [Interaction 1]
50
+ - [Interaction 2]
51
+
52
+ ## Architecture Options
53
+ ### Option 1: [Name]
54
+ - Description: [Brief description]
55
+ - Pros:
56
+ - [Pro 1]
57
+ - [Pro 2]
58
+ - Cons:
59
+ - [Con 1]
60
+ - [Con 2]
61
+ - Technical Fit: [High/Medium/Low]
62
+ - Complexity: [High/Medium/Low]
63
+ - Scalability: [High/Medium/Low]
64
+
65
+ ### Option 2: [Name]
66
+ [Same structure as Option 1]
67
+
68
+ ## Decision
69
+ - Chosen Option: [Option name]
70
+ - Rationale: [Explanation]
71
+ - Implementation Considerations:
72
+ - [Consideration 1]
73
+ - [Consideration 2]
74
+
75
+ ## Validation
76
+ - Requirements Met:
77
+ - [✓] Requirement 1
78
+ - [✓] Requirement 2
79
+ - Technical Feasibility: [Assessment]
80
+ - Risk Assessment: [Evaluation]
81
+ ```
82
+
83
+ ## 🎯 ARCHITECTURE EVALUATION CRITERIA
84
+
85
+ ```mermaid
86
+ graph TD
87
+ subgraph "EVALUATION CRITERIA"
88
+ C1["Scalability"]
89
+ C2["Maintainability"]
90
+ C3["Performance"]
91
+ C4["Security"]
92
+ C5["Cost"]
93
+ C6["Time to Market"]
94
+ end
95
+
96
+ style C1 fill:#4dbb5f,stroke:#36873f,color:white
97
+ style C2 fill:#ffa64d,stroke:#cc7a30,color:white
98
+ style C3 fill:#d94dbb,stroke:#a3378a,color:white
99
+ style C4 fill:#4dbbbb,stroke:#368787,color:white
100
+ style C5 fill:#d971ff,stroke:#a33bc2,color:white
101
+ style C6 fill:#ff71c2,stroke:#c23b8a,color:white
102
+ ```
103
+
104
+ ## 📊 ARCHITECTURE VISUALIZATION TEMPLATES
105
+
106
+ ### Component Diagram Template
107
+ ```mermaid
108
+ graph TD
109
+ subgraph "SYSTEM ARCHITECTURE"
110
+ C1["Component 1"]
111
+ C2["Component 2"]
112
+ C3["Component 3"]
113
+
114
+ C1 -->|"Interface 1"| C2
115
+ C2 -->|"Interface 2"| C3
116
+ end
117
+
118
+ style C1 fill:#4dbb5f,stroke:#36873f,color:white
119
+ style C2 fill:#ffa64d,stroke:#cc7a30,color:white
120
+ style C3 fill:#d94dbb,stroke:#a3378a,color:white
121
+ ```
122
+
123
+ ### Data Flow Template
124
+ ```mermaid
125
+ sequenceDiagram
126
+ participant C1 as Component 1
127
+ participant C2 as Component 2
128
+ participant C3 as Component 3
129
+
130
+ C1->>C2: Request
131
+ C2->>C3: Process
132
+ C3-->>C2: Response
133
+ C2-->>C1: Result
134
+ ```
135
+
136
+ ## ✅ VERIFICATION CHECKLIST
137
+
138
+ ```markdown
139
+ ## Architecture Design Verification
140
+ - [ ] All system requirements addressed
141
+ - [ ] Component responsibilities defined
142
+ - [ ] Interfaces specified
143
+ - [ ] Data flows documented
144
+ - [ ] Security considerations addressed
145
+ - [ ] Scalability requirements met
146
+ - [ ] Performance requirements met
147
+ - [ ] Maintenance approach defined
148
+
149
+ ## Implementation Readiness
150
+ - [ ] All components identified
151
+ - [ ] Dependencies mapped
152
+ - [ ] Technical constraints documented
153
+ - [ ] Risk assessment completed
154
+ - [ ] Resource requirements defined
155
+ - [ ] Timeline estimates provided
156
+ ```
157
+
158
+ ## 🔄 ARCHITECTURE REVIEW PROCESS
159
+
160
+ ```mermaid
161
+ graph TD
162
+ subgraph "REVIEW PROCESS"
163
+ R1["Technical<br>Review"]
164
+ R2["Security<br>Review"]
165
+ R3["Performance<br>Review"]
166
+ R4["Final<br>Approval"]
167
+ end
168
+
169
+ R1 --> R2 --> R3 --> R4
170
+
171
+ style R1 fill:#4dbb5f,stroke:#36873f,color:white
172
+ style R2 fill:#ffa64d,stroke:#cc7a30,color:white
173
+ style R3 fill:#d94dbb,stroke:#a3378a,color:white
174
+ style R4 fill:#4dbbbb,stroke:#368787,color:white
175
+ ```
176
+
177
+ ## 🔄 DOCUMENT MANAGEMENT
178
+
179
+ ```mermaid
180
+ graph TD
181
+ Current["Current Document"] --> Active["Active:<br>- creative-phase-architecture.md"]
182
+ Current --> Related["Related:<br>- creative-phase-enforcement.md<br>- planning-comprehensive.md"]
183
+
184
+ style Current fill:#4da6ff,stroke:#0066cc,color:white
185
+ style Active fill:#4dbb5f,stroke:#36873f,color:white
186
+ style Related fill:#ffa64d,stroke:#cc7a30,color:white
187
+ ```
@@ -0,0 +1,123 @@
1
+ ---
2
+ description: main rule
3
+ globs: main.mdc
4
+ alwaysApply: false
5
+ ---
6
+
7
+ # 🔍 ISOLATION-FOCUSED MEMORY BANK SYSTEM
8
+
9
+ > **TL;DR:** This system is designed to work with Cursor custom modes, where each mode loads only the rules it needs. The system uses visual Mermaid diagrams and selective document loading to optimize context usage.
10
+
11
+ ## 🧭 MODE-SPECIFIC VISUAL MAPS
12
+
13
+ ```mermaid
14
+ graph TD
15
+ subgraph Modes["Cursor Custom Modes"]
16
+ VAN["VAN MODE<br>Initialization"] --> PLAN["PLAN MODE<br>Task Planning"]
17
+ PLAN --> Creative["CREATIVE MODE<br>Design Decisions"]
18
+ Creative --> Implement["IMPLEMENT MODE<br>Code Implementation"]
19
+ Implement --> Reflect["REFLECT MODE<br>Task Review"]
20
+ Reflect --> Archive["ARCHIVE MODE<br>Documentation"]
21
+ end
22
+
23
+ VAN -.->|"Loads"| VANRules["• main.md<br>• platform-awareness.md<br>• file-verification.md<br>• workflow-init.md"]
24
+ PLAN -.->|"Loads"| PLANRules["• main.md<br>• task-tracking.md<br>• planning-process.md"]
25
+ Creative -.->|"Loads"| CreativeRules["• main.md<br>• creative-phase.md<br>• design-patterns.md"]
26
+ Implement -.->|"Loads"| ImplementRules["• main.md<br>• command-execution.md<br>• implementation-guide.md"]
27
+ Reflect -.->|"Loads"| ReflectRules["• main.md<br>• reflection-format.md"]
28
+ Archive -.->|"Loads"| ArchiveRules["• main.md<br>• archiving-guide.md"]
29
+ ```
30
+
31
+ ## 📚 VISUAL PROCESS MAPS
32
+
33
+ Each mode has its own visual process map:
34
+
35
+ - [VAN Mode Map](mdc:visual-maps/van-mode-map.md)
36
+ - [PLAN Mode Map](mdc:visual-maps/plan-mode-map.md)
37
+ - [CREATIVE Mode Map](mdc:visual-maps/creative-mode-map.md)
38
+ - [IMPLEMENT Mode Map](mdc:visual-maps/implement-mode-map.md)
39
+ - [REFLECT Mode Map](mdc:visual-maps/reflect-mode-map.md)
40
+ - [ARCHIVE Mode Map](mdc:visual-maps/archive-mode-map.md)
41
+
42
+ ## 🔄 FILE STATE VERIFICATION
43
+
44
+ In this isolation-focused approach, Memory Bank files maintain continuity between modes:
45
+
46
+ ```mermaid
47
+ graph TD
48
+ subgraph "Memory Bank Files"
49
+ tasks["tasks.md<br>Source of Truth"]
50
+ active["activeContext.md<br>Current Focus"]
51
+ creative["creative-*.md<br>Design Decisions"]
52
+ progress["progress.md<br>Implementation Status"]
53
+ end
54
+
55
+ VAN["VAN MODE"] -->|"Creates/Updates"| tasks
56
+ VAN -->|"Creates/Updates"| active
57
+
58
+ PLAN["PLAN MODE"] -->|"Reads"| tasks
59
+ PLAN -->|"Reads"| active
60
+ PLAN -->|"Updates"| tasks
61
+
62
+ Creative["CREATIVE MODE"] -->|"Reads"| tasks
63
+ Creative -->|"Creates"| creative
64
+ Creative -->|"Updates"| tasks
65
+
66
+ Implement["IMPLEMENT MODE"] -->|"Reads"| tasks
67
+ Implement -->|"Reads"| creative
68
+ Implement -->|"Updates"| tasks
69
+ Implement -->|"Updates"| progress
70
+
71
+ Reflect["REFLECT MODE"] -->|"Reads"| tasks
72
+ Reflect -->|"Reads"| progress
73
+ Reflect -->|"Updates"| tasks
74
+
75
+ Archive["ARCHIVE MODE"] -->|"Reads"| tasks
76
+ Archive -->|"Reads"| progress
77
+ Archive -->|"Archives"| creative
78
+ ```
79
+
80
+ ## 📋 MODE TRANSITION PROTOCOL
81
+
82
+ ```mermaid
83
+ sequenceDiagram
84
+ participant User
85
+ participant CurrentMode
86
+ participant NextMode
87
+
88
+ CurrentMode->>CurrentMode: Complete Phase Requirements
89
+ CurrentMode->>User: "Phase complete. NEXT MODE: [mode name]"
90
+ User->>CurrentMode: End Current Mode
91
+ User->>NextMode: Start Next Mode
92
+ NextMode->>NextMode: Verify Required File State
93
+
94
+ alt File State Valid
95
+ NextMode->>User: "Continuing from previous mode..."
96
+ else File State Invalid
97
+ NextMode->>User: "Required files not in expected state"
98
+ NextMode->>User: "Return to [previous mode] to complete requirements"
99
+ end
100
+ ```
101
+
102
+ ## 💻 PLATFORM-SPECIFIC COMMANDS
103
+
104
+ | Action | Windows | Mac/Linux |
105
+ |--------|---------|-----------|
106
+ | Create file | `echo. > file.ext` | `touch file.ext` |
107
+ | Create directory | `mkdir directory` | `mkdir -p directory` |
108
+ | Change directory | `cd directory` | `cd directory` |
109
+ | List files | `dir` | `ls` |
110
+ | Show file content | `type file.ext` | `cat file.ext` |
111
+
112
+ ## ⚠️ COMMAND EFFICIENCY GUIDANCE
113
+
114
+ For optimal performance, use efficient command chaining when appropriate:
115
+
116
+ ```
117
+ # Efficient command chaining examples:
118
+ mkdir -p project/{src,tests,docs} && cd project
119
+ grep "TODO" $(find . -name "*.js")
120
+ npm install && npm start
121
+ ```
122
+
123
+ Refer to [command-execution.md](mdc:Core/command-execution.md) for detailed guidance.