Cline rules

1# Project: Hovimestari - Personal AI Butler Assistant
2 
3For detailed project information, refer to the documentation files in the `docs/` directory:
4 
5- `docs/01_overview.md`: Project overview and technology stack
6- `docs/02_architecture.md`: Directory structure, key files, and data flow
7- `docs/03_core_concepts.md`: Core concepts (memories, importers, briefs)
8- `docs/04_configuration.md`: Configuration and configuration file examples
9- `docs/05_database.md`: Database schema
10- `docs/06_llm.md`: LLM integration, providers, and prompt structure
11- `docs/07_cli.md`: CLI commands
12 
13## Language
14 
15- The name "Hovimestari" means "Butler" in Finnish.
16- All briefs and responses are generated in a language the user can configure.
17- Code comments and documentation are in English.
18- All log output and CLI messages should be in English.
19 
20### LLM Prompts
21 
22- Store LLM prompts in English in configuration files (e.g., `prompts.json`).
23- Use placeholders (e.g., `%LANG%`) for output language, which is specified in `config.json`.
24- Use placeholders (e.g., `%NOTES%`) for dynamic content like memories.
25- Keep prompts clear, concise, and focused on the specific task.
26 
27## Common Tasks
28 
29### Adding a New Importer
30 
311. Create a new package under `internal/importer/`.
322. Implement the importer with a similar interface to the calendar importer.
333. Add a new command in `cmd/hovimestari/main.go`.
344. Update the README.md with the new functionality.
35 
36### Modifying the Database Schema
37 
381. Update the `Initialize` function in `internal/store/store.go`.
392. Add any new methods needed to interact with the new schema.
403. Consider adding a migration mechanism if the change is not backward compatible.
41 
42### Adding a New Command
43 
441. Create a new command file in `cmd/hovimestari/commands/` (e.g., `new_command.go`).
452. Implement the command using the Cobra framework, following the pattern of existing commands.
463. Add the command to the root command in the `main.go` file.
474. Update the README.md with the new command.
48 
49Example of a new command file structure:
50 
51```go
52package commands
53 
54import (
55	"fmt"
56 
57	"github.com/lepinkainen/hovimestari/internal/config"
58	"github.com/spf13/cobra"
59)
60 
61// NewCommandCmd returns the new command
62func NewCommandCmd() *cobra.Command {
63	cmd := &cobra.Command{
64		Use:   "new-command",
65		Short: "Short description",
66		Long:  `Longer description of the command.`,
67		RunE: func(cmd *cobra.Command, args []string) error {
68			// Get the configuration
69			cfg, err := config.GetConfig()
70			if err != nil {
71				return fmt.Errorf("failed to get configuration: %w", err)
72			}
73 
74			// Implement command functionality
75			return runNewCommand(cmd.Context())
76		},
77	}
78 
79	// Add flags if needed
80	// cmd.Flags().StringVar(&flagVar, "flag-name", "", "Flag description")
81 
82	return cmd
83}
84 
85// runNewCommand implements the command functionality
86func runNewCommand(ctx context.Context) error {
87	// Implement the command logic here
88	return nil
89}
90```
91 
92### Working with the Configuration System
93 
94The application uses Spf13/Viper for configuration management. When working with configuration:
95 
961. Use `config.GetConfig()` to retrieve the current configuration.
972. Access configuration values through the returned struct.
983. For new configuration options:
99   - Add the field to the `Config` struct in `internal/config/viper.go`
100   - Add default values in the `InitViper` function if needed
101   - Add environment variable binding if appropriate
102   - Update validation functions if necessary
103   - Update the example configuration file
104 
105### Ollama Integration
106 
107When working with Ollama LLM integration:
108 
1091. The `docs/llm-ollama.md` file contains comprehensive documentation about Ollama integration.
1102. Configuration should support both Gemini and Ollama as LLM providers.
1113. The LLM interface should be provider-agnostic, allowing seamless switching between providers.
1124. Ensure prompts work well with both Gemini and Ollama models.
113