refresh

Refresh Documentation: $ARGUMENTS

Targeted refresh. Updates what changed and what depends on it — not the whole package.

Required Skills

• engagement-scoping — resolve scope and confirm the delivery mode is targeted
• evidence-ledger — re-observe changed evidence; supersede stale rows rather than editing them
• project-modeling — re-validate the model when the blast radius touches components, interfaces, data, or infrastructure
• doc-package-contract — per-document contracts and the last-verified rule
• prose-clarity — Phase 4: self-lint re-drafted prose before returning each document
• gap-and-contradiction-register — record contradictions the refresh surfaces
• disclosure-gating — re-derive public documents when a consumed claim changed

References

• change-triggers-and-blast-radius.md
• evidence-ledger-schema.md
• document-headers.md

Phase 0 — Resolve the range

_RAW="$ARGUMENTS"
printf '%s\n' "### Refresh Arguments"
printf '%s\n' "ARGS=$_RAW"

__dr="${CLAUDE_PLUGIN_ROOT:-}"
[ -x "$__dr/bin/dossier-evidence.sh" ] || __dr=$({ printf '%s\n' plugins/dossier; ls -d "$HOME"/.claude/plugins/cache/synapti-marketplace/dossier/*/ 2>/dev/null | sort -Vr; printf '%s\n' "$HOME/.claude/plugins/marketplaces/synapti-marketplace/plugins/dossier"; } | while read -r __p; do [ -x "${__p%/}/bin/dossier-evidence.sh" ] && { printf '%s\n' "${__p%/}"; break; }; done)

printf '%s\n' "### Preflight"
if [ ! -x "$__dr/bin/dossier-evidence.sh" ]; then
  printf '%s\n' "REFRESH_STATE=blocked"
  printf '%s\n' "REFRESH_ERROR=dossier plugin scripts not found — reinstall or upgrade the plugin"
  true; exit 0
fi
printf '%s\n' "DOSSIER_ROOT=$__dr"

OUTPUT_ROOT=$("$__dr/bin/dossier-resolve-config.sh" --default "docs/dossier" dossier.project.outputRoot 2>/dev/null)
printf '%s\n' "OUTPUT_ROOT=$OUTPUT_ROOT"
printf '%s\n' "PACKAGE_EXISTS=$([ -d "$OUTPUT_ROOT/00-control" ] && printf '%s\n' true || printf '%s\n' false)"

printf '%s\n' "### Evidence"
case "$_RAW" in
  *--evidence*)
    MANIFEST=$(printf '%s' "$_RAW" | sed -n 's/.*--evidence[[:space:]]\{1,\}\([^[:space:]]*\).*/\1/p')
    if [ -f "$MANIFEST" ]; then
      printf '%s\n' "EVIDENCE_SOURCE=prebuilt"
      printf '%s\n' "EVIDENCE_MANIFEST=$MANIFEST"
    else
      printf '%s\n' "REFRESH_STATE=blocked"
      printf '%s\n' "REFRESH_ERROR=--evidence given but no manifest at $MANIFEST"
    fi
    ;;
  *)
    printf '%s\n' "EVIDENCE_SOURCE=local"
    printf '%s\n' "CURSOR=$(jq -r '.last_documented_sha // empty' "$OUTPUT_ROOT/.dossier-state.json" 2>/dev/null || printf '%s\n' none)"
    printf '%s\n' "HEAD=$(git rev-parse HEAD 2>/dev/null || printf '%s\n' unknown)"
    ;;
esac
true