dfd

cmdlet/add_note.py

@@ -12,6 +12,7 @@ from . import _shared as sh
 
 Cmdlet = sh.Cmdlet
 CmdletArg = sh.CmdletArg
+QueryArg = sh.QueryArg
 SharedArgs = sh.SharedArgs
 normalize_hash = sh.normalize_hash
 parse_cmdlet_args = sh.parse_cmdlet_args
@@ -26,11 +27,21 @@ class Add_Note(Cmdlet):
         super().__init__(
             name="add-note",
             summary="Add file store note",
-            usage="add-note (-query \"title:<title>,text:<text>\") [ -store <store> -hash <sha256> | <piped> ]",
+            usage="add-note (-query \"title:<title>,text:<text>[,store:<store>][,hash:<sha256>]\") [ -store <store> | <piped> ]",
             alias=[""],
             arg=[
                 SharedArgs.STORE,
-                CmdletArg("hash", type="string", required=False, description="Target file hash (sha256). When omitted, uses piped item hash."),
+
+                QueryArg(
+                    "hash",
+                    key="hash",
+                    aliases=["sha256"],
+                    type="string",
+                    required=False,
+                    handler=normalize_hash,
+                    description="(Optional) Specific file hash target, provided via -query as hash:<sha256>. When omitted, uses piped item hash.",
+                    query_only=True,
+                ),
                 SharedArgs.QUERY,
             ],
             detail=[
@@ -141,7 +152,7 @@ class Add_Note(Cmdlet):
             return 1
 
         if hash_override and not store_override:
-            log("[add_note] Error: -hash requires -store <store>", file=sys.stderr)
+            log("[add_note] Error: hash:<sha256> requires store:<store> in -query or -store <store>", file=sys.stderr)
             return 1
 
         explicit_target = bool(hash_override and store_override)
@@ -169,7 +180,7 @@ class Add_Note(Cmdlet):
                 # Allow standalone use (no piped input) and enable piping the target forward.
                 results = [{"store": str(store_override), "hash": hash_override}]
             else:
-                log("[add_note] Error: Requires piped item(s) from add-file, or explicit -store <store> and -hash <sha256>", file=sys.stderr)
+                log("[add_note] Error: Requires piped item(s) from add-file, or explicit targeting via store/hash (e.g., -query \"store:<store> hash:<sha256> ...\")", file=sys.stderr)
                 return 1
 
         store_registry = Store(config)