Improve action documentation and branding

- Updated action description to mention both action and command modes
- Added branding icon and color
- Updated README to reflect the current witness version (0.8.1)
- Added clearer documentation about input forwarding
- Improved action reference description
- Enhanced input-* parameter description for clarity

Author: cole-rgb

README.md

@@ -1,6 +1,6 @@
 # TestifySec Action Wrapper with Witness
 
-A GitHub Action that downloads and executes another GitHub Action with Witness attestation.
+A GitHub Action that downloads and executes another GitHub Action or direct command with Witness attestation for supply chain security.
 
 ## Usage
 
@@ -67,6 +67,14 @@ This action combines the functionality of a GitHub Action wrapper with Witness a
 3. **Runs with Attestation**: The action is executed through Witness, which creates attestations
 4. **Stores Results**: Attestations are stored (optionally in Archivista) and GitOIDs are returned
 
+### Input Forwarding
+
+The action wrapper passes inputs to the nested action with a special prefix convention:
+
+- Any input parameter starting with `input-` will have the prefix removed and be passed to the nested action
+- For example, `input-who-to-greet: "World"` becomes `who-to-greet: "World"` for the nested action
+- This allows you to clearly separate inputs meant for the wrapper action from those meant for the nested action
+
 ## Key Features
 
 - **GitHub Action Execution**: Run any JavaScript GitHub Action
@@ -90,7 +98,7 @@ This action combines the functionality of a GitHub Action wrapper with Witness a
 
 | Input | Description | Required | Default |
 |-------|-------------|----------|---------|
-| `witness-version` | Version of Witness to use | No | `0.2.11` |
+| `witness-version` | Version of Witness to use | No | `0.8.1` |
 | `witness-install-dir` | Directory to install Witness | No | `./` |
 
 ### Witness Core Options
@@ -159,7 +167,7 @@ This action combines the functionality of a GitHub Action wrapper with Witness a
 
 | Input | Description | Required | Default |
 |-------|-------------|----------|---------|
-| `input-*` | Any input with the prefix `input-` will be passed to the nested action | No | |
+| `input-*` | Any input with the prefix `input-` will be passed to the nested action without the prefix (e.g., input-who-to-greet becomes who-to-greet) | No | |
 | `extra-args` | Extra arguments to pass to the nested action (deprecated, use `input-*` instead) | No | |
 
 ## Outputs

action.yml

@@ -1,9 +1,9 @@
 name: "TestifySec Action Wrapper with Witness"
-description: "Downloads and executes another GitHub Action with Witness attestation"
+description: "Downloads and executes another GitHub Action or direct command with Witness attestation for supply chain security"
 inputs:
-  # Action or Command
+  # Action or Command (one is required)
   action-ref:
-    description: "Reference to the nested action (e.g., owner/repo@ref)"
+    description: "Reference to the nested action (e.g., owner/repo@ref or owner/repo@v1)"
     required: false
   command:
     description: "Command to run with Witness (use this or action-ref)"
@@ -108,9 +108,9 @@ inputs:
     description: "Path to Maven POM file"
     required: false
 
-  # For backward compatibility - will pass these to the nested action
+  # Input Passing to Nested Actions
   input-*:
-    description: "Any input with the prefix 'input-' will be passed to the nested action"
+    description: "Any input with the prefix 'input-' will be passed to the nested action without the prefix (e.g., input-who-to-greet becomes who-to-greet)"
     required: false
   extra-args:
     description: "Extra arguments to pass to the nested action (deprecated, use input-* instead)"
@@ -122,3 +122,7 @@ outputs:
 runs:
   using: "node16"
   main: "index.js"
+
+branding:
+  icon: 'lock'
+  color: 'blue'