docs(README): rewrite adapter READMEs for clarity and alignment

README.md

@@ -17,9 +17,11 @@ language:
 
 ## 🧠 Model Details
 
-This is a parameter-efficient fine-tuning (PEFT) LoRA adapter trained on a custom DSL for temporal reasoning, such as interpreting expressions like "next Friday" or "on the last day of August". It translates natural language into structured function calls using that DSL (e.g., `OFFSET(...)`, `DATE_FROM_YEAR_MONTH_DAY(...)`).
+This model is a parameter-efficient fine-tuning (PEFT) LoRA adapter, designed as a **demonstration and testbed** for the [Mini Date Converter DSL module](https://github.com/gh9869827/fifo-dev-dsl/tree/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl).
 
-This adapter is designed as a **demonstration and testbed** for structured temporal parsing using the custom DSL.
+It is provided for demonstration and experimentation purposes only.
+
+It translates English natural language date and time references, such as "next Friday" or "last day of August", into structured function calls using that custom DSL.
 
 - **Model type:** LoRA adapter (PEFT)  
 - **Language(s):** English  
@@ -28,30 +30,26 @@ This adapter is designed as a **demonstration and testbed** for structured tempo
 
 ## 🚀 Uses
 
-This adapter fine-tunes Phi-4-mini-instruct for parsing natural date expressions into DSL format.
+This adapter fine-tunes `Phi-4-mini-instruct` for parsing natural language date and time references into DSL format. It supports the DSL functions defined
+in the [Mini Date Converter DSL module](https://github.com/gh9869827/fifo-dev-dsl/tree/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl).
 
 Example prompt:
 
 ```
-$ You are a precise temporal parser. Your only job is to translate natural language date expressions into structured DSL function calls.  
+$ You are a precise temporal parser. Your only job is to translate natural language date expressions into structured DSL function calls such as OFFSET(...) or DATE_FROM_MONTH_DAY(...). Do not explain or elaborate. Only return the code.
 > on the last day of next month  
 < SET_MONTH_DAY(OFFSET(TODAY, 1, MONTH), -1)
 ```
 
-It is a useful starting point for prototyping DSL-based schedulers, assistants, or natural language interfaces requiring structured temporal interpretation.
-
-The DSL produced by this model is defined and executed by the [Mini Date Converter DSL module](https://github.com/gh9869827/fifo-dev-dsl/tree/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl).
-
-
 ## ⚠️ Out-of-Scope Use
 
-This model has been fine-tuned specifically for date conversion DSL as a demonstration and testbed. It is not intended for general-purpose dialogue or unrelated tasks.
+This adapter has been fine-tuned specifically as a demonstration and testbed for the [Mini Date Converter DSL module](https://github.com/gh9869827/fifo-dev-dsl/tree/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl). It is not intended for general-purpose dialogue or unrelated tasks.
 
 ## 🏗️ Training Details
 
-Trained on [a6188466/mini-date-converter-dsl-dataset](https://huggingface.co/datasets/a6188466/mini-date-converter-dsl-dataset) using the `dsl` adapter from [`fifo-tool-datasets`](https://github.com/gh9869827/fifo-tool-datasets) and [`fine_tune.py`](https://github.com/gh9869827/fifo-tool-airlock-model-env).
+Trained on [a6188466/mini-date-converter-dsl-dataset](https://huggingface.co/datasets/a6188466/mini-date-converter-dsl-dataset) using the `dsl` adapter from [`fifo-tool-datasets`](https://github.com/gh9869827/fifo-tool-datasets) and [`fine_tune.py`](https://github.com/gh9869827/fifo-tool-airlock-model-env/blob/main/fifo_tool_airlock_model_env/fine_tuning/phi_4/fine_tune.py).
 
-- **Dataset:** 137 hand-curated examples mapping natural language to DSL commands  
+- **Dataset:** 137 hand-curated examples mapping English natural language date and time references to DSL commands  
 - **Epochs:** 15  
 - **Batch size:** 1  
 - **Precision:** bf16  
@@ -88,19 +86,28 @@ Trained on [a6188466/mini-date-converter-dsl-dataset](https://huggingface.co/dat
 ## ✅ Evaluation
 
 - **Eval set:** Natural language queries similar in structure and intent to the training examples  
-- **Metric:** Functional equivalence — two DSL expressions are considered correct when they evaluate to the same result  
+- **Metric:** Functional equivalence — two DSL expressions are considered correct if they evaluate to the same result  
 - **Results:**  
+  - **90%** on held-out [test set](https://huggingface.co/datasets/a6188466/mini-date-converter-dsl-dataset) (**45/50** passed)  
   - **Test, variation 1:** **334/336** passed (**99.40%**)  
   - **Test, variation 2:** **308/336** passed (**91.67%**)
 
-The two variations represent different types of generalization:  
-- **Variation 1:** Alternate phrasings of template-based date expressions (e.g., "the second Tuesday in March")  
-- **Variation 2:** Compositional expressions involving offsets from reference dates used in Variation 1 (e.g., "two weeks after the second Tuesday in March")
+The two variations target different generalization behaviors:  
+- **Variation 1:** Alternate phrasings of the template-based date expression `"the nth weekday of month"` (e.g., "the second Tuesday in March")  
+- **Variation 2:** Compositional expressions involving an offset from Variation 1 outputs, following the pattern `"two weeks after the nth weekday in month"` (e.g., "two weeks after the second Tuesday in March")
 
-These results demonstrate strong accuracy on tested queries, but performance should be carefully evaluated in each individual use case.
+These results demonstrate acceptable performance on evaluated queries. However, as this is a demonstration adapter trained on a narrow dataset, performance should be carefully and independently evaluated in each individual use case.
 
 Evaluation script: [`evaluate_mini_date_converter_dsl_model.py`](https://github.com/gh9869827/fifo-dev-dsl/blob/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl/evaluate_mini_date_converter_dsl_model.py)
 
+## ⚠️ Limitations
+
+This adapter is intended solely as a **demonstration and testbed** for the [Mini Date Converter DSL module](https://github.com/gh9869827/fifo-dev-dsl/tree/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl). It should not be used beyond that scope.
+
+It does not cover all phrasings or edge cases of English **date and time references**. Instead, it focuses on illustrative examples that are supported by the module's [DSL functions](https://github.com/gh9869827/fifo-dev-dsl/tree/main/fifo_dev_dsl/domain_specific/mini_date_converter_dsl#-supported-dsl-functions).
+
+This adapter is provided *as is*, without warranties or guarantees of any kind. It is intended for demonstration and experimentation only.
+
 ## 🪪 License
 
 MIT License. See [LICENSE](LICENSE) for details.