docs: refine user-facing wording for clarity and consistency

1 files changed, 14 insertions, 14 deletions

diff --git a/Taskfile.yaml b/Taskfile.yaml
index 9d6f6a7..585f3b0 100644
--- a/Taskfile.yaml
+++ b/Taskfile.yaml
@@ -5,14 +5,14 @@ vars:
   VERSION:
     sh: |
       if [ ! -f VERSION ]; then
-        echo "VERSION file is required" >&2
+        echo "VERSION file is required. Create VERSION and run the task again." >&2
         exit 1
       fi
       tr -d '\r\n' < VERSION
   VERSION_TAG:
     sh: |
       if [ ! -f VERSION ]; then
-        echo "VERSION file is required" >&2
+        echo "VERSION file is required. Create VERSION and run the task again." >&2
         exit 1
       fi
       v="$(tr -d '\r\n' < VERSION)"
@@ -20,11 +20,11 @@ vars:
   COMMIT:
     sh: |
       if ! command -v git >/dev/null 2>&1; then
-        echo "git is required to compute build metadata" >&2
+        echo "Git is required to compute build metadata." >&2
         exit 1
       fi
       if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-        echo "git repository context is required" >&2
+        echo "A Git repository context is required." >&2
         exit 1
       fi
       git rev-parse --short HEAD
@@ -44,7 +44,7 @@ tasks:
     desc: Ensure git metadata is available for version injection.
     preconditions:
       - sh: command -v git >/dev/null 2>&1
-        msg: git is required but was not found in PATH
+        msg: Git is required. Install Git and run the task again.
       - sh: git rev-parse --is-inside-work-tree >/dev/null 2>&1
         msg: task must run from inside the plutia git repository
     cmds:
@@ -124,7 +124,7 @@ tasks:
         if command -v staticcheck >/dev/null 2>&1; then
           staticcheck ./...
         else
-          echo "staticcheck not installed; skipping"
+          echo "staticcheck is not installed, so this step is skipped."
         fi
 
   verify:small:
@@ -147,7 +147,7 @@ tasks:
       - |
         checkpoint_count="$(find ./tmp-test-data/checkpoints -maxdepth 1 -type f -name '*.json' ! -name '*.state.json' | wc -l | awk '{print $1}')"
         if [ "${checkpoint_count}" -lt 1 ]; then
-          echo "verify:small failed: no checkpoint files generated" >&2
+          echo "verify:small failed: no checkpoint files were generated." >&2
           exit 1
         fi
         global_seq="$(awk '/replay complete at sequence/ {print $5}' ./tmp-test-data/verify-small.log | tail -n 1)"
@@ -208,7 +208,7 @@ tasks:
       - |
         echo "verify:1m checkpoint timing metrics"
         if ! grep -q 'checkpoint_metrics' ./scale-test-data-1m/verify-1m.log; then
-          echo "verify:1m failed: no checkpoint metrics emitted" >&2
+          echo "verify:1m failed: no checkpoint metrics were emitted." >&2
           exit 1
         fi
         grep 'checkpoint_metrics' ./scale-test-data-1m/verify-1m.log
@@ -228,7 +228,7 @@ tasks:
       - |
         block_files="$(find ./scale-test-data-resolver/ops -maxdepth 1 -type f -name '*.zst' | wc -l | awk '{print $1}')"
         if [ "${block_files}" -ne 0 ]; then
-          echo "verify:resolver failed: expected zero block files, found ${block_files}" >&2
+          echo "verify:resolver failed: expected zero block files, found ${block_files}." >&2
           exit 1
         fi
         echo "verify:resolver summary"
@@ -258,17 +258,17 @@ tasks:
       - |
         block_file="$(find ./tmp-test-data-corruption/ops -maxdepth 1 -type f -name '*.zst' | sort | head -n 1)"
         if [ -z "${block_file}" ]; then
-          echo "verify:corruption failed: no block file was created" >&2
+          echo "verify:corruption failed: no block file was created." >&2
           exit 1
         fi
         printf 'tamper' >> "${block_file}"
       - |
         if {{.BIN}} replay --config=config.default.yaml --max-ops=5000 > ./tmp-test-data-corruption/restart.log 2>&1; then
-          echo "verify:corruption failed: replay succeeded after tampering" >&2
+          echo "verify:corruption failed: replay succeeded after tampering." >&2
           exit 1
         fi
         if ! grep -qi 'corruption' ./tmp-test-data-corruption/restart.log; then
-          echo "verify:corruption failed: corruption was not reported" >&2
+          echo "verify:corruption failed: corruption was not reported." >&2
           cat ./tmp-test-data-corruption/restart.log
           exit 1
         fi
@@ -330,8 +330,8 @@ tasks:
       - sh: docker buildx version >/dev/null 2>&1
         msg: docker buildx is required for multi-architecture docker:build
     cmds:
-      - docker buildx build --platform linux/amd64 -t ghcr.io/fuwn/plutia:{{.VERSION_TAG}}-amd64 --load .
-      - docker buildx build --platform linux/arm64 -t ghcr.io/fuwn/plutia:{{.VERSION_TAG}}-arm64 --load .
+      - docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/fuwn/plutia:{{.VERSION_TAG}} --push .
+      - docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/fuwn/plutia:latest --push .
 
   docker:run:
     desc: Run Plutia container with mounted config and persistent data.