From: Svjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Date: Tue, 2 Dec 2025 19:12:22 +0000 (+0200)
Subject: Rename `task_directory` to `tasks_directory` across documentation and code for consis... 
X-Git-Url: http://www2.svjatoslav.eu/gitweb/?a=commitdiff_plain;h=3442d6333c2fc27f8a922ad7507cc4cd79de4ee6;p=alyverkko-cli.git

Rename `task_directory` to `tasks_directory` across documentation and code for consistency. Document more configuration parameters.
---

diff --git a/doc/index.org b/doc/index.org
index 00c33ec..027ccf5 100644
--- a/doc/index.org
+++ b/doc/index.org
@@ -349,17 +349,30 @@ Configuration file should be placed under current user home directory:
 *** Key Parameters Explained
 **** Core Directories
 
-- =mail_directory=: Where task files are placed for processing
-- =models_directory=: Contains GGUF model files
-- =skills_directory=: Contains YAML skill definition files
-- =llama_cli_path=: Path to llama.cpp's executable
+- =tasks_directory=: Where task files are placed for processing.
+
+- =models_directory=: Contains GGUF model files.
+
+- =skills_directory=: Contains YAML skill definition files.
+
+- =llama_cli_path=: Path to llama.cpp's executable.
 
 **** Generation Parameters
 
 - =default_temperature=: Creativity control (0-3, higher = more
-  creative)
+  creative).
+
 - =default_top_p=: Nucleus sampling threshold (0.0-1., higher = more
-  diverse)
+  diverse).
+
+- =default_top_k=: Restricts token selection to the K tokens with the
+  highest probabilities, regardless of their actual probability values
+  or the shape of the distribution.
+
+- =default_min_p=: Filters the vocabulary to include only tokens whose
+  probability is at least a certain fraction (Min P) of the
+  probability of the most likely token.
+
 - =default_repeat_penalty=: Penalty for repetition (>0.0, 1.0 = no
   penalty)
 
diff --git a/src/main/java/eu/svjatoslav/alyverkko_cli/commands/JoinFilesCommand.java b/src/main/java/eu/svjatoslav/alyverkko_cli/commands/JoinFilesCommand.java
index aa0ff69..700b853 100644
--- a/src/main/java/eu/svjatoslav/alyverkko_cli/commands/JoinFilesCommand.java
+++ b/src/main/java/eu/svjatoslav/alyverkko_cli/commands/JoinFilesCommand.java
@@ -107,7 +107,7 @@ public class JoinFilesCommand implements Command {
         }
 
         // Build the path to the target file that is relative to the mail directory
-        outputFile = configuration.getTaskDirectory().toPath().resolve(topic.getValue() + ".org").toFile();
+        outputFile = configuration.getTasksDirectory().toPath().resolve(topic.getValue() + ".org").toFile();
 
         if (patternOption.isPresent()) {
             fileNamePattern = patternOption.getValue();
diff --git a/src/main/java/eu/svjatoslav/alyverkko_cli/commands/WizardCommand.java b/src/main/java/eu/svjatoslav/alyverkko_cli/commands/WizardCommand.java
index 7808a62..56ce403 100644
--- a/src/main/java/eu/svjatoslav/alyverkko_cli/commands/WizardCommand.java
+++ b/src/main/java/eu/svjatoslav/alyverkko_cli/commands/WizardCommand.java
@@ -129,9 +129,9 @@ public class WizardCommand implements Command {
      * Step-by-step checking (and possibly fixing) of each main config parameter.
      */
     private void checkAndFixGeneralParameters() {
-        configuration.setTaskDirectory(
+        configuration.setTasksDirectory(
                 checkDirectory(
-                        configuration.getTaskDirectory(),
+                        configuration.getTasksDirectory(),
                         "Mail directory",
                         true,
                         "The mail directory is where the AI will look for tasks to solve. " +
diff --git a/src/main/java/eu/svjatoslav/alyverkko_cli/commands/task_processor/TaskProcessorCommand.java b/src/main/java/eu/svjatoslav/alyverkko_cli/commands/task_processor/TaskProcessorCommand.java
index acfbbf5..f8031f5 100644
--- a/src/main/java/eu/svjatoslav/alyverkko_cli/commands/task_processor/TaskProcessorCommand.java
+++ b/src/main/java/eu/svjatoslav/alyverkko_cli/commands/task_processor/TaskProcessorCommand.java
@@ -114,7 +114,7 @@ public class TaskProcessorCommand implements Command {
         }
 
         modelLibrary = new ModelLibrary(configuration.getModelsDirectory(), configuration.getModels());
-        taskDirectory = configuration.getTaskDirectory();
+        taskDirectory = configuration.getTasksDirectory();
 
         // Set up a directory watch service
         initializeFileWatcher();
diff --git a/src/main/java/eu/svjatoslav/alyverkko_cli/configuration/Configuration.java b/src/main/java/eu/svjatoslav/alyverkko_cli/configuration/Configuration.java
index 6872648..5d47c96 100644
--- a/src/main/java/eu/svjatoslav/alyverkko_cli/configuration/Configuration.java
+++ b/src/main/java/eu/svjatoslav/alyverkko_cli/configuration/Configuration.java
@@ -27,8 +27,8 @@ public class Configuration {
     /**
      * Directory where AI tasks (mail) are placed and discovered.
      */
-    @JsonProperty("task_directory")
-    private File taskDirectory;
+    @JsonProperty("tasks_directory")
+    private File tasksDirectory;
 
     /**
      * Directory that contains AI model files in GGUF format.