Merge branch 'main' into yhcnk1-codex/fix-taskgist-word-separation-issue

Author: ngirard

README.md

@@ -119,11 +119,6 @@ Taskgist requires a Google AI API key to interact with the Gemini LLM.
 
 Once installed and configured, you can use the `taskgist` CLI. Ensure your virtual environment is activated if you're not using `just run` or `uv run`.
 
-**Check the installed version:**
-```bash
-taskgist --version
-```
-
 **Basic usage with a string input:**
 ```bash
 taskgist "Create a new user authentication system with email verification and password reset capabilities"

src/taskgist/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.1"
+__version__ = "0.2.2"

src/taskgist/baml_src/keywords.baml

@@ -1,16 +1,16 @@
 class KeywordPhrase {
   actionVerb string @description("The leading verb that describes the main action")
-  phrase string[] @description("Complete keyword phrase with essential terms only")
+  phrase string[] @description("Rest of the keyword phrase with essential terms only")
 }
 
 function ExtractKeywords(taskDescription: string) -> KeywordPhrase {
   client FlashLite
   prompt #"
     Extract a concise keyword phrase from the given software engineering task description.
     Guidelines:
-    - Return at most five keywords.
+    - Return at most 5 keywords.
     - The first keyword must be a single-word action verb summarizing the task.
-    - Each keyword must be a single word with no spaces.
+    - Each keyword MUST be a single word with NO SPACES.
     - Omit articles (the, a, an), common prepositions (in, on, to, for), and pronouns (it, this, that, etc.).
     - Keep only essential terms representing the core task.
 

src/taskgist/main.py

@@ -135,17 +135,18 @@ def create_gist(keyword_phrase_obj: KeywordPhrase) -> str:
 def main_cli():
     """Command-line interface for taskgist."""
     parser = argparse.ArgumentParser(
+        prog="taskgist",
         description="Generates a concise gist from a software engineering task description using BAML.",
         formatter_class=argparse.RawTextHelpFormatter,
     )
     parser.add_argument(
-        "-v",
         "--version",
         action="version",
         version=f"%(prog)s {__version__}",
     )
     parser.add_argument(
         "task",
+        nargs="?",
         type=str,
         help="The task description string, or a file path prefixed with '@:' (e.g., '@:path/to/task.txt').\n"
         'Example: taskgist "Create a new user authentication system"\n'
@@ -154,6 +155,13 @@ def main_cli():
 
     args = parser.parse_args()
 
+    if args.version:
+        print(f"{parser.prog} {__version__}")
+        return
+
+    if args.task is None:
+        parser.error("the following arguments are required: task")
+
     try:
         task_description_content = get_task_description(args.task)
     except FileNotFoundError as e:

tests/test_version.py

@@ -1,5 +1,4 @@
 import subprocess
-import sys
 import unittest
 
 import taskgist
@@ -8,7 +7,7 @@
 class TestVersionCLI(unittest.TestCase):
     def test_cli_version(self):
         result = subprocess.run(
-            [sys.executable, "-m", "taskgist.main", "--version"],
+            ["taskgist", "--version"],
             capture_output=True,
             text=True,
         )