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"
echo "### Refresh Arguments"
echo "ARGS=$_RAW"

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

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

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

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