chatlog: add --subject and --open; tasks prompt subject and open file; pre-push clipboard guard (CID + preview containment); keep clipboard auto-append off by default

Author: arnabwahid

.githooks/pre-push

@@ -32,8 +32,42 @@ append_from_file() {
 
 append_from_clipboard() {
   if command -v pbpaste >/dev/null 2>&1 || command -v xclip >/dev/null 2>&1 || command -v xsel >/dev/null 2>&1; then
-    bash "$APPENDER" --from-clipboard --label "$LABEL (Clipboard)" || true
-    git add "$CHAT_FILE" || true
+    TMP_CLIP=$(mktemp)
+    # capture clipboard and normalize
+    if command -v pbpaste >/dev/null 2>&1; then
+      pbpaste | tr -d '\r' > "$TMP_CLIP"
+    elif command -v xclip >/dev/null 2>&1; then
+      xclip -o -selection clipboard | tr -d '\r' > "$TMP_CLIP"
+    else
+      xsel --clipboard --output | tr -d '\r' > "$TMP_CLIP"
+    fi
+
+    if [[ -s "$TMP_CLIP" ]]; then
+      # Skip if exact CID already present (idempotent path)
+      if command -v shasum >/dev/null 2>&1; then
+        CID=$(shasum -a 256 "$TMP_CLIP" | awk '{print $1}')
+      elif command -v openssl >/dev/null 2>&1; then
+        CID=$(openssl dgst -sha256 -r "$TMP_CLIP" | awk '{print $1}')
+      else
+        CID=""
+      fi
+      if [[ -n "$CID" && -f "$CHAT_FILE" ]] && grep -q "^\[CID:$CID\]$" "$CHAT_FILE"; then
+        echo "[pre-push] Clipboard content already recorded (CID:$CID); skipping."
+        rm -f "$TMP_CLIP"; return
+      fi
+      # Tail containment check: if a preview chunk is already in chatlog, skip
+      if [[ -f "$CHAT_FILE" ]]; then
+        PREVIEW=$(head -c 256 "$TMP_CLIP")
+        if [[ -n "$PREVIEW" ]] && grep -Fq -- "$PREVIEW" "$CHAT_FILE"; then
+          echo "[pre-push] Clipboard content appears already present in chatlog; skipping."
+          rm -f "$TMP_CLIP"; return
+        fi
+      fi
+      # Append from file to avoid re-reading clipboard in appender
+      bash "$APPENDER" --from-file "$TMP_CLIP" --label "$LABEL (Clipboard)" || true
+      git add "$CHAT_FILE" || true
+    fi
+    rm -f "$TMP_CLIP" || true
   fi
 }
 

.vscode/tasks.json

@@ -6,14 +6,25 @@
       "label": "Append Chatlog (Clipboard)",
       "type": "shell",
       "command": "bash",
-      "args": ["tools/append-chatlog.sh", "--from-clipboard", "--commit"],
+      "args": [
+        "tools/append-chatlog.sh",
+        "--from-clipboard",
+        "--label",
+        "${input:chatlogLabel}",
+        "--subject",
+        "${input:chatlogSubject}",
+        "--open"
+      ],
       "problemMatcher": []
     },
     {
       "label": "Append Chatlog (Stdin)",
       "type": "shell",
       "command": "bash",
-      "args": ["-lc", "tools/append-chatlog.sh --commit"],
+      "args": [
+        "-lc",
+        "tools/append-chatlog.sh --label '${input:chatlogLabel}' --subject '${input:chatlogSubject}' --open"
+      ],
       "options": {
         "presentation": {
           "reveal": "always",
@@ -46,7 +57,8 @@
         "--label",
         "${input:chatlogLabel}",
         "--subject",
-        "${input:chatlogSubject}"
+        "${input:chatlogSubject}",
+        "--open"
       ],
       "problemMatcher": []
     },
@@ -61,7 +73,8 @@
         "--label",
         "${input:chatlogLabel}",
         "--subject",
-        "${input:chatlogSubject}"
+        "${input:chatlogSubject}",
+        "--open"
       ],
       "problemMatcher": []
     },
@@ -71,7 +84,7 @@
       "command": "bash",
       "args": [
         "-lc",
-        "tools/append-chatlog.sh --from-clipboard --label '${input:chatlogLabel}' --subject '${input:chatlogSubject}' && (command -v code >/dev/null && code -r docs/chatlog.md || open docs/chatlog.md)"
+        "tools/append-chatlog.sh --from-clipboard --label '${input:chatlogLabel}' --subject '${input:chatlogSubject}' --open"
       ],
       "problemMatcher": []
     },

tools/CHATLOG_USAGE.md

@@ -38,6 +38,7 @@ Each append block adds:
 
 Appended on 2025-09-06 16:55:00 UTC
 [CID:<sha256>] [LABEL:<optional>]
+Subject: <optional subject when provided>
 
 <pasted content>
 ```
@@ -67,12 +68,15 @@ bash tools/install-hooks.sh
 
 Behavior:
 - If `docs/pending_chat_append.txt` exists and has content, it is appended (label “Pre-push”) and then removed.
-- If `AUTO_APPEND_CLIPBOARD=1` is set in `.chatlogrc` (repo root) or env, the clipboard is appended (label “Pre-push (Clipboard)”).
+- If `AUTO_APPEND_CLIPBOARD=1` is set in `.chatlogrc` (repo root) or env, the clipboard is appended (label “Pre-push (Clipboard)”) with safety checks:
+  - Skips if the clipboard content’s CID already exists in the chatlog.
+  - Skips if a 256‑char preview is already present in the chatlog (tail containment check).
 - After appending, the hook stages `docs/chatlog.md` so it’s included in your push if committed.
 
 Notes:
 - Hooks are local; they don’t travel with pushes. The installer sets `core.hooksPath=.githooks` in your local repo config.
 - The hook is non-interactive and safe to ignore if you don’t use the pending/clipboard features.
+- Recommended defaults: Use queued file appends or the VS Code tasks; keep clipboard auto‑append disabled unless you need it.
 
 ## Notes & Recommendations
 

tools/append-chatlog.sh

@@ -13,10 +13,11 @@ TITLE="iAvro Forgiving Typing Project — Chat Log"
 FORCE_APPEND=0
 LABEL=""
 SUBJECT=""
+OPEN_AFTER=0
 
 usage() {
   cat <<EOF
-Usage: $0 [--from-file <path> | --from-clipboard] [--label <text>] [--subject <text>] [--commit] [--force]
+Usage: $0 [--from-file <path> | --from-clipboard] [--label <text>] [--subject <text>] [--open] [--commit] [--force]
 
 Examples:
   # Append from clipboard (copy chat text first)
@@ -44,6 +45,8 @@ while [[ $# -gt 0 ]]; do
       LABEL="${2:-}"; shift 2;;
     --subject)
       SUBJECT="${2:-}"; shift 2;;
+    --open)
+      OPEN_AFTER=1; shift;;
     --help|-h)
       usage; exit 0;;
     *)
@@ -138,3 +141,12 @@ if [[ $DO_COMMIT -eq 1 ]]; then
     echo "Not a git repo; skipping commit." >&2
   fi
 fi
+
+# Optionally open the chatlog for review (interactive flows only)
+if [[ $OPEN_AFTER -eq 1 ]]; then
+  if command -v code >/dev/null 2>&1; then
+    code -r "$FILE" || true
+  elif [[ "$OSTYPE" == darwin* ]]; then
+    open "$FILE" || true
+  fi
+fi