harness: fleet-wide functional-error + correction + friction logging
Add .claude/scripts/log-skill-error.sh — the canonical agent error log helper (writes errorlog.md in DATE | MACHINE | skill | [type] error format, soft-fails). Three categories: execution failures (default), user corrections (--correction), and preventable self-inflicted friction (--friction; cite ref= when it repeats a documented gotcha). Goal: stop paying tokens twice for the same avoidable mistake. - CLAUDE.md: make logging mandatory for all skills + corrections + friction. - skill-creator: new skills must wire in the helper (guidance + checklist). - Retrofit every skill script's genuine failure branches to call the helper (b2/bitdefender/mailprotector/packetdial/coord python CLIs; remediation-tool + onboard365 bash; vault, rmm-auth, post-bot-alert, agy, grok, 1password, run-onboarding-diagnostic). Handled conditions + self-tests left alone. - errorlog.md: broaden header to cover skills + harness + corrections; seed this session's corrections (INKY, Mail.Send token-audience, omnibox-strictness) and friction (git-bash /tmp, env-persistence, argv-limit, PowerShell var-case). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -25,6 +25,12 @@
|
||||
# Anything you put OUTSIDE those keys is committed in PLAINTEXT — never do that.
|
||||
set -euo pipefail
|
||||
|
||||
# ── Functional-error logger ───────────────────────────────────────────────────
|
||||
# errorlog.md + log-skill-error.sh live in the ClaudeTools repo (4 levels up from
|
||||
# .claude/skills/vault/scripts/), NOT the SOPS vault repo (VAULT_DIR below).
|
||||
CLAUDETOOLS_ROOT="${CLAUDETOOLS_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../../../.." && pwd)}"
|
||||
_logerr() { bash "$CLAUDETOOLS_ROOT/.claude/scripts/log-skill-error.sh" "vault" "$@" >/dev/null 2>&1 || true; }
|
||||
|
||||
# ── Resolve vault root (the #1 thing sessions get wrong) ──────────────────────
|
||||
# Order: $VAULT_PATH override → the repo we're standing in (correct identity) →
|
||||
# $HOME identity vault_path → $HOME identity claudetools_root → that repo's identity.
|
||||
@@ -84,7 +90,7 @@ cmd_verify() {
|
||||
local f; f=$(abspath "${1:?usage: verify <path>}")
|
||||
[[ -f "$f" ]] || { echo "[ERROR] not found: $f" >&2; exit 1; }
|
||||
if ! _is_encrypted "$f"; then echo "[FAIL] $1 — NO encrypted values found (plaintext?)"; exit 1; fi
|
||||
if ! ( cd "$VAULT_DIR" && sops -d "$f" >/dev/null 2>&1 ); then echo "[FAIL] $1 — encrypted but does not decrypt (key mismatch?)"; exit 1; fi
|
||||
if ! ( cd "$VAULT_DIR" && sops -d "$f" >/dev/null 2>&1 ); then echo "[FAIL] $1 — encrypted but does not decrypt (key mismatch?)"; _logerr "sops decrypt failed (key mismatch?)" --context "op=verify path=$1"; exit 1; fi
|
||||
echo "[OK] $1 — encrypted and decrypts cleanly"
|
||||
}
|
||||
|
||||
@@ -129,7 +135,7 @@ doc["notes"]=""
|
||||
with open(f,"w",encoding="utf-8",newline="\n") as fh:
|
||||
yaml.safe_dump(doc,fh,default_flow_style=False,sort_keys=False,allow_unicode=True)
|
||||
PY
|
||||
( cd "$VAULT_DIR" && sops --encrypt --in-place "$f" ) || { echo "[ERROR] sops encrypt failed; removing plaintext" >&2; rm -f "$f"; exit 1; }
|
||||
( cd "$VAULT_DIR" && sops --encrypt --in-place "$f" ) || { echo "[ERROR] sops encrypt failed; removing plaintext" >&2; _logerr "sops encrypt failed (new entry)" --context "op=new path=$path"; rm -f "$f"; exit 1; }
|
||||
cmd_verify "$path"
|
||||
echo "[INFO] Created ${f#$VAULT_DIR/}. Publish with: bash .claude/scripts/sync.sh (Phase 6 commits+pushes the vault)"
|
||||
}
|
||||
@@ -142,7 +148,7 @@ cmd_set() {
|
||||
local f; f=$(abspath "$path")
|
||||
[[ -f "$f" ]] || { echo "[ERROR] not found: ${f#$VAULT_DIR/} (use 'new' to create)" >&2; exit 1; }
|
||||
local tmp; tmp=$(mktemp)
|
||||
( cd "$VAULT_DIR" && sops -d "$f" ) > "$tmp" 2>/dev/null || { echo "[ERROR] decrypt failed" >&2; rm -f "$tmp"; exit 1; }
|
||||
( cd "$VAULT_DIR" && sops -d "$f" ) > "$tmp" 2>/dev/null || { echo "[ERROR] decrypt failed" >&2; _logerr "sops decrypt failed (set)" --context "op=set path=$path"; rm -f "$tmp"; exit 1; }
|
||||
SETS="$(printf '%s\n' "${sets[@]}")" "$PY" - "$tmp" <<'PY'
|
||||
import os,sys,yaml
|
||||
f=sys.argv[1]
|
||||
@@ -154,7 +160,7 @@ for kv in os.environ["SETS"].splitlines():
|
||||
yaml.safe_dump(doc,open(f,"w",encoding="utf-8",newline="\n"),default_flow_style=False,sort_keys=False,allow_unicode=True)
|
||||
PY
|
||||
cp "$tmp" "$f"; rm -f "$tmp"
|
||||
( cd "$VAULT_DIR" && sops --encrypt --in-place "$f" ) || { echo "[ERROR] re-encrypt failed" >&2; exit 1; }
|
||||
( cd "$VAULT_DIR" && sops --encrypt --in-place "$f" ) || { echo "[ERROR] re-encrypt failed" >&2; _logerr "sops re-encrypt failed (set)" --context "op=set path=$path"; exit 1; }
|
||||
cmd_verify "$path"
|
||||
echo "[INFO] Updated ${f#$VAULT_DIR/}. Publish with: bash .claude/scripts/sync.sh"
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user