agent-knowledge-cli 0.1.2__py3-none-any.whl

agent_knowledge/assets/scripts/ship.sh

@@ -0,0 +1,256 @@
+#!/bin/bash
+#
+# Project ship flow: validate, sync knowledge, commit, push, optionally open a PR.
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+# shellcheck source=/dev/null
+. "$SCRIPT_DIR/lib/knowledge-common.sh"
+
+usage() {
+    cat <<'EOF'
+Usage:
+  scripts/ship.sh [project-dir]
+  scripts/ship.sh --project <dir> [--message <commit-message>] [--open-pr] [--open-pr=auto] [--dry-run] [--json] [--summary-file <file>]
+EOF
+}
+
+TARGET_PROJECT_ARG="."
+POSITIONAL=()
+COMMIT_MESSAGE=""
+OPEN_PR_MODE="no"
+VALIDATION_LABELS=()
+VALIDATION_RESULTS=()
+WARNINGS=()
+
+while [ "$#" -gt 0 ]; do
+    if kc_parse_common_flag "$@" ; then
+        shift
+        continue
+    fi
+    flag_status=$?
+    if [ "$flag_status" -eq 2 ]; then
+        shift 2
+        continue
+    fi
+
+    case "$1" in
+        --project)
+            TARGET_PROJECT_ARG="${2:-.}"
+            shift 2
+            ;;
+        --message)
+            COMMIT_MESSAGE="${2:-}"
+            shift 2
+            ;;
+        --open-pr)
+            OPEN_PR_MODE="yes"
+            shift
+            ;;
+        --open-pr=auto)
+            OPEN_PR_MODE="auto"
+            shift
+            ;;
+        *)
+            POSITIONAL+=("$1")
+            shift
+            ;;
+    esac
+done
+
+if [ "$SHOW_HELP" -eq 1 ]; then
+    usage
+    exit 0
+fi
+
+if [ ${#POSITIONAL[@]} -ge 1 ]; then
+    TARGET_PROJECT_ARG="${POSITIONAL[0]}"
+fi
+
+kc_load_project_context "$TARGET_PROJECT_ARG"
+kc_git_available || kc_fail "Ship requires a git repo."
+
+branch="$(git -C "$TARGET_PROJECT" rev-parse --abbrev-ref HEAD)"
+[ "$branch" != "HEAD" ] || kc_fail "Refusing to ship from a detached HEAD."
+
+if [ -n "$(git -C "$TARGET_PROJECT" ls-files -u)" ]; then
+    kc_fail "Refusing to ship with unresolved merge conflicts."
+fi
+
+detect_validation_commands() {
+    if [ -f "$TARGET_PROJECT/Makefile" ] && grep -qE '^(test|check):' "$TARGET_PROJECT/Makefile" 2>/dev/null; then
+        if grep -q '^test:' "$TARGET_PROJECT/Makefile" 2>/dev/null; then
+            printf '%s\n' "make test"
+        else
+            printf '%s\n' "make check"
+        fi
+    fi
+
+    if [ -f "$TARGET_PROJECT/package.json" ]; then
+        if grep -q '"lint"' "$TARGET_PROJECT/package.json" 2>/dev/null; then
+            if [ -f "$TARGET_PROJECT/pnpm-lock.yaml" ]; then
+                printf '%s\n' "pnpm run lint"
+            elif [ -f "$TARGET_PROJECT/yarn.lock" ]; then
+                printf '%s\n' "yarn lint"
+            else
+                printf '%s\n' "npm run lint --if-present"
+            fi
+        fi
+        if grep -q '"test"' "$TARGET_PROJECT/package.json" 2>/dev/null; then
+            if [ -f "$TARGET_PROJECT/pnpm-lock.yaml" ]; then
+                printf '%s\n' "pnpm test"
+            elif [ -f "$TARGET_PROJECT/yarn.lock" ]; then
+                printf '%s\n' "yarn test"
+            else
+                printf '%s\n' "npm test --if-present"
+            fi
+        fi
+    fi
+
+    if [ -f "$TARGET_PROJECT/Cargo.toml" ]; then
+        printf '%s\n' "cargo test"
+    fi
+
+    if [ -f "$TARGET_PROJECT/go.mod" ]; then
+        printf '%s\n' "go test ./..."
+    fi
+
+    if [ -f "$TARGET_PROJECT/pyproject.toml" ] || [ -f "$TARGET_PROJECT/requirements.txt" ]; then
+        if [ -d "$TARGET_PROJECT/tests" ] || [ -f "$TARGET_PROJECT/pytest.ini" ]; then
+            printf '%s\n' "python -m pytest -q"
+        fi
+    fi
+}
+
+run_validation() {
+    local label="$1"
+    local command="$2"
+
+    VALIDATION_LABELS+=("$label")
+    kc_run_shell_command "$label" "$command" "$TARGET_PROJECT"
+    VALIDATION_RESULTS+=("$label:$KC_COMMAND_STATUS")
+    if [ "$KC_COMMAND_STATUS" = "failed" ]; then
+        kc_err "$KC_COMMAND_OUTPUT"
+        kc_fail "Validation failed: $label"
+    fi
+}
+
+validation_commands="$(detect_validation_commands | awk 'NF && !seen[$0]++ { print $0 }')"
+if [ -n "$validation_commands" ]; then
+    while IFS= read -r command; do
+        [ -n "$command" ] || continue
+        run_validation "$command" "$command"
+    done <<EOF
+$validation_commands
+EOF
+else
+    WARNINGS+=("No standard validation commands were detected.")
+fi
+
+validate_args=(--project "$TARGET_PROJECT")
+if [ "$DRY_RUN" -eq 1 ]; then
+    validate_args+=(--dry-run)
+fi
+kc_run_child_script "$SCRIPT_DIR/validate-knowledge.sh" "${validate_args[@]}"
+
+sync_args=(--project "$TARGET_PROJECT" --compact)
+if [ "$DRY_RUN" -eq 1 ]; then
+    sync_args+=(--dry-run)
+fi
+kc_run_child_script "$SCRIPT_DIR/update-knowledge.sh" "${sync_args[@]}"
+
+status_lines="$(git -C "$TARGET_PROJECT" status --short)"
+changed_files="$(kc_git_changed_files || true)"
+
+if [ -z "$status_lines" ]; then
+    WARNINGS+=("No repo changes to commit after validation and knowledge sync.")
+fi
+
+if [ -z "$COMMIT_MESSAGE" ]; then
+    scope="$(printf '%s\n' "$changed_files" | awk -F/ 'NF { print $1 }' | grep -v '^agent-knowledge$' | awk '!seen[$0]++' | head -3 | paste -sd ', ' -)"
+    if [ -n "$scope" ]; then
+        COMMIT_MESSAGE="chore: ship $scope updates"
+    else
+        COMMIT_MESSAGE="chore: sync project knowledge"
+    fi
+fi
+
+knowledge_external=0
+case "$KNOWLEDGE_REAL_DIR" in
+    "$TARGET_PROJECT"/*)
+        knowledge_external=0
+        ;;
+    *)
+        knowledge_external=1
+        WARNINGS+=("Knowledge source of truth lives outside the repo and is not staged here: $KNOWLEDGE_REAL_DIR")
+        ;;
+esac
+
+if [ -n "$status_lines" ]; then
+    kc_run_shell_command "git add" "git add -A" "$TARGET_PROJECT"
+    [ "$KC_COMMAND_STATUS" != "failed" ] || kc_fail "git add failed."
+
+    kc_run_shell_command "git commit" "git commit -m \"$(printf '%s' "$COMMIT_MESSAGE" | sed 's/"/\\"/g')\"" "$TARGET_PROJECT"
+    if [ "$KC_COMMAND_STATUS" = "failed" ]; then
+        if printf '%s' "$KC_COMMAND_OUTPUT" | grep -qi 'nothing to commit'; then
+            WARNINGS+=("git commit reported nothing to commit.")
+        else
+            kc_err "$KC_COMMAND_OUTPUT"
+            kc_fail "git commit failed."
+        fi
+    fi
+fi
+
+if git -C "$TARGET_PROJECT" remote get-url origin >/dev/null 2>&1; then
+    upstream="$(git -C "$TARGET_PROJECT" rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null || true)"
+    if [ -n "$upstream" ]; then
+        kc_run_shell_command "git push" "git push" "$TARGET_PROJECT"
+    else
+        kc_run_shell_command "git push -u" "git push -u origin $branch" "$TARGET_PROJECT"
+    fi
+else
+    WARNINGS+=("No origin remote configured; push skipped.")
+fi
+
+should_open_pr=0
+if [ "$OPEN_PR_MODE" = "yes" ]; then
+    should_open_pr=1
+elif [ "$OPEN_PR_MODE" = "auto" ] && command -v gh >/dev/null 2>&1 && [ "$branch" != "main" ] && [ "$branch" != "master" ]; then
+    should_open_pr=1
+fi
+
+if [ "$should_open_pr" -eq 1 ]; then
+    if command -v gh >/dev/null 2>&1; then
+        kc_run_shell_command "gh pr create" "gh pr create --fill" "$TARGET_PROJECT"
+    else
+        WARNINGS+=("GitHub CLI is unavailable; PR creation skipped.")
+    fi
+fi
+
+json_summary="{"
+json_summary="$json_summary\"script\":\"ship\","
+json_summary="$json_summary\"project_root\":\"$(kc_json_escape "$TARGET_PROJECT")\","
+json_summary="$json_summary\"branch\":\"$(kc_json_escape "$branch")\","
+json_summary="$json_summary\"commit_message\":\"$(kc_json_escape "$COMMIT_MESSAGE")\","
+json_summary="$json_summary\"dry_run\":$(kc_json_bool "$DRY_RUN"),"
+json_summary="$json_summary\"knowledge_external\":$(kc_json_bool "$knowledge_external"),"
+json_summary="$json_summary\"validations\":$(kc_json_array "${VALIDATION_RESULTS[@]+"${VALIDATION_RESULTS[@]}"}"),"
+json_summary="$json_summary\"warnings\":$(kc_json_array "${WARNINGS[@]+"${WARNINGS[@]}"}")"
+json_summary="$json_summary}"
+kc_write_json_output "$json_summary"
+
+if [ "$JSON_MODE" -ne 1 ]; then
+    kc_log "Ship summary: $TARGET_PROJECT"
+    kc_log "  branch: $branch"
+    kc_log "  commit message: $COMMIT_MESSAGE"
+    if [ ${#VALIDATION_RESULTS[@]} -gt 0 ]; then
+        kc_log "  validations:"
+        printf '    %s\n' "${VALIDATION_RESULTS[@]+"${VALIDATION_RESULTS[@]}"}"
+    fi
+    if [ ${#WARNINGS[@]} -gt 0 ]; then
+        kc_log "  warnings:"
+        printf '    %s\n' "${WARNINGS[@]+"${WARNINGS[@]}"}"
+    fi
+fi

agent_knowledge/assets/scripts/update-knowledge.sh

@@ -0,0 +1,341 @@
+#!/bin/bash
+#
+# Project-level knowledge refresh.
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+AGENTS_RULES_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+DECISION_TEMPLATE="$AGENTS_RULES_DIR/templates/memory/decision.template.md"
+# shellcheck source=/dev/null
+. "$SCRIPT_DIR/lib/knowledge-common.sh"
+
+usage() {
+    cat <<'EOF'
+Usage:
+  scripts/update-knowledge.sh [project-dir]
+  scripts/update-knowledge.sh --project <dir> [--decision-title <title>] [--decision-why <text>] [--compact] [--dry-run] [--json] [--summary-file <file>]
+EOF
+}
+
+TARGET_PROJECT_ARG="."
+POSITIONAL=()
+DECISION_TITLE=""
+DECISION_WHY=""
+DECISION_SLUG=""
+RUN_COMPACTION=0
+UPDATED_NOTES=()
+SKIPPED=()
+WARNINGS=()
+
+while [ "$#" -gt 0 ]; do
+    if kc_parse_common_flag "$@" ; then
+        shift
+        continue
+    fi
+    flag_status=$?
+    if [ "$flag_status" -eq 2 ]; then
+        shift 2
+        continue
+    fi
+
+    case "$1" in
+        --project)
+            TARGET_PROJECT_ARG="${2:-.}"
+            shift 2
+            ;;
+        --decision-title)
+            DECISION_TITLE="${2:-}"
+            shift 2
+            ;;
+        --decision-why)
+            DECISION_WHY="${2:-}"
+            shift 2
+            ;;
+        --decision-slug)
+            DECISION_SLUG="${2:-}"
+            shift 2
+            ;;
+        --compact)
+            RUN_COMPACTION=1
+            shift
+            ;;
+        *)
+            POSITIONAL+=("$1")
+            shift
+            ;;
+    esac
+done
+
+if [ "$SHOW_HELP" -eq 1 ]; then
+    usage
+    exit 0
+fi
+
+if [ ${#POSITIONAL[@]} -ge 1 ]; then
+    TARGET_PROJECT_ARG="${POSITIONAL[0]}"
+fi
+
+kc_load_project_context "$TARGET_PROJECT_ARG"
+
+if [ ! -e "$KNOWLEDGE_POINTER_PATH" ]; then
+    kc_fail "Missing ./agent-knowledge pointer. Run: agent-knowledge init"
+fi
+
+kc_require_knowledge_pointer
+
+if [ ! -f "$MEMORY_ROOT" ] || [ ! -f "$STATUS_FILE" ]; then
+    bootstrap_args=(--project "$TARGET_PROJECT")
+    if [ "$DRY_RUN" -eq 1 ]; then
+        bootstrap_args+=(--dry-run)
+    fi
+    "$SCRIPT_DIR/bootstrap-memory-tree.sh" "${bootstrap_args[@]}"
+    kc_load_project_context "$TARGET_PROJECT"
+    kc_require_knowledge_pointer
+fi
+
+changed_files="$(kc_git_changed_files || true)"
+
+format_paths_inline() {
+    local paths_text="$1"
+    local limit="$2"
+    local count=0
+    local line=""
+    local output=""
+
+    while IFS= read -r line; do
+        [ -n "$line" ] || continue
+        count=$((count + 1))
+        if [ "$count" -le "$limit" ]; then
+            if [ -n "$output" ]; then
+                output="$output, "
+            fi
+            output="$output\`$line\`"
+        fi
+    done <<EOF
+$paths_text
+EOF
+
+    if [ "$count" -gt "$limit" ]; then
+        output="$output, ..."
+    fi
+    printf '%s' "$output"
+}
+
+classify_path() {
+    local path="$1"
+    local candidates=""
+    local existing=""
+
+    case "$path" in
+        agent-knowledge/*)
+            return 0
+            ;;
+        .github/workflows/*|deploy/*|deployment/*|infra/*)
+            candidates="deployments architecture"
+            ;;
+        package.json|package-lock.json|pnpm-lock.yaml|yarn.lock|pnpm-workspace.yaml|nx.json|turbo.json|pyproject.toml|requirements.txt|Cargo.toml|go.mod|CMakeLists.txt|package.xml|Makefile)
+            candidates="stack"
+            ;;
+        *.eslintrc|*.eslintrc.js|*.eslintrc.cjs|eslint.config.js|eslint.config.mjs|eslint.config.cjs|.editorconfig|.prettierrc|.prettierrc.json|.prettierrc.yaml|tsconfig.json|tsconfig.base.json|pytest.ini|mypy.ini|ruff.toml|.clang-format|.clang-tidy|.pre-commit-config.yaml)
+            candidates="conventions"
+            ;;
+        README.md|README.rst|AGENTS.md|CLAUDE.md|docs/*|src/*|app/*|apps/*|services/*|packages/*)
+            candidates="architecture"
+            ;;
+        *)
+            candidates="architecture"
+            ;;
+    esac
+
+    # Check each candidate against actually existing branch notes.
+    # A branch exists as either Memory/<name>.md or Memory/<name>/<name>.md.
+    for existing in $candidates; do
+        if [ -f "$MEMORY_DIR/$existing.md" ] || [ -f "$MEMORY_DIR/$existing/$existing.md" ]; then
+            printf '%s\n' "$existing"
+        fi
+    done
+}
+
+append_note_change() {
+    local file="$1"
+    local bullet="$2"
+    local rel
+    rel="$(kc_rel_knowledge_path "$file")"
+    kc_append_unique_bullet "$file" "Recent Changes" "$bullet" "$rel"
+    case "$KC_LAST_ACTION" in
+        updated|would-update)
+            UPDATED_NOTES+=("$rel")
+            ;;
+    esac
+}
+
+render_decision_note() {
+    local title="$1"
+    local why="$2"
+    local slug="$3"
+    local dst="$DECISIONS_DIR/$slug.md"
+    local tmp_file
+
+    tmp_file="$(mktemp)"
+    TEMPLATE_PROJECT_NAME="$PROJECT_NAME" \
+    TEMPLATE_PROFILE="$PROJECT_PROFILE" \
+    TEMPLATE_DATE="$(kc_today)" \
+    TEMPLATE_DECISION_SLUG="$slug" \
+    TEMPLATE_SHORT_TITLE="$title" \
+    TEMPLATE_WHAT_LINES="- Triggered by project knowledge sync for changed files." \
+    TEMPLATE_WHY_LINES="- ${why:-Durable understanding changed enough to justify a recorded note.}" \
+    TEMPLATE_ALTERNATIVES_LINES="- Record the change only in recent-change bullets." \
+    TEMPLATE_CONSEQUENCES_LINES="- Future sessions can link a concrete decision instead of inferring intent from evidence alone." \
+    TEMPLATE_SUPERSEDED_LINES="- None." \
+    awk '
+        BEGIN {
+            project = ENVIRON["TEMPLATE_PROJECT_NAME"]
+            profile = ENVIRON["TEMPLATE_PROFILE"]
+            date = ENVIRON["TEMPLATE_DATE"]
+            decision_slug = ENVIRON["TEMPLATE_DECISION_SLUG"]
+            short_title = ENVIRON["TEMPLATE_SHORT_TITLE"]
+            what_lines = ENVIRON["TEMPLATE_WHAT_LINES"]
+            why_lines = ENVIRON["TEMPLATE_WHY_LINES"]
+            alternatives_lines = ENVIRON["TEMPLATE_ALTERNATIVES_LINES"]
+            consequences_lines = ENVIRON["TEMPLATE_CONSEQUENCES_LINES"]
+            superseded_lines = ENVIRON["TEMPLATE_SUPERSEDED_LINES"]
+        }
+        {
+            gsub(/<project-name>/, project)
+            gsub(/<profile-type>/, profile)
+            gsub(/<date>/, date)
+            gsub(/<decision-slug>/, decision_slug)
+            gsub(/<short-title>/, short_title)
+            if ($0 == "<what-lines>") { print what_lines; next }
+            if ($0 == "<why-lines>") { print why_lines; next }
+            if ($0 == "<alternatives-lines>") { print alternatives_lines; next }
+            if ($0 == "<consequences-lines>") { print consequences_lines; next }
+            if ($0 == "<superseded-lines>") { print superseded_lines; next }
+            print
+        }
+    ' "$DECISION_TEMPLATE" > "$tmp_file"
+
+    kc_apply_temp_file "$tmp_file" "$dst" "Memory/decisions/$slug.md"
+    case "$KC_LAST_ACTION" in
+        created|updated|would-create|would-update)
+            UPDATED_NOTES+=("Memory/decisions/$slug.md")
+            ;;
+    esac
+
+    # Update decisions log (decisions.md, with fallback to legacy INDEX.md)
+    local decisions_log="$DECISIONS_DIR/decisions.md"
+    [ -f "$decisions_log" ] || decisions_log="$DECISIONS_DIR/INDEX.md"
+    local decisions_label="Memory/decisions/$(basename "$decisions_log")"
+    kc_append_unique_bullet "$decisions_log" "Current State" "- [$title]($slug.md) - Recorded from project sync." "$decisions_label"
+    kc_append_unique_bullet "$decisions_log" "Recent Changes" "- $(kc_today) - Updated decision note [$title]($slug.md)." "$decisions_label"
+}
+
+affected_areas_raw=""
+if [ -n "$changed_files" ]; then
+    while IFS= read -r path; do
+        [ -n "$path" ] || continue
+        area_lines="$(classify_path "$path")"
+        if [ -n "$area_lines" ]; then
+            affected_areas_raw="${affected_areas_raw}${area_lines}"$'\n'
+        else
+            SKIPPED+=("$path")
+        fi
+    done <<EOF
+$changed_files
+EOF
+else
+    WARNINGS+=("No git-tracked project changes detected; evidence refresh still ran.")
+fi
+
+affected_areas="$(printf '%s\n' "$affected_areas_raw" | awk 'NF && !seen[$0]++ { print $0 }')"
+changed_paths_summary="$(format_paths_inline "$changed_files" 5)"
+
+if [ -n "$affected_areas" ]; then
+    while IFS= read -r area; do
+        [ -n "$area" ] || continue
+        note_path="$MEMORY_DIR/$area.md"
+        if [ -f "$note_path" ]; then
+            append_note_change "$note_path" "- $(kc_today) - Synced after changes in $changed_paths_summary."
+        else
+            WARNINGS+=("Skipped missing area note for $area")
+        fi
+    done <<EOF
+$affected_areas
+EOF
+
+    areas_summary="$(printf '%s\n' "$affected_areas" | awk 'NF { items[++count]=$0 } END { for (i=1;i<=count;i++) { printf "`%s`", items[i]; if (i < count) printf ", " } }')"
+    append_note_change "$MEMORY_ROOT" "- $(kc_today) - Knowledge sync touched $areas_summary from $changed_paths_summary."
+else
+    append_note_change "$MEMORY_ROOT" "- $(kc_today) - Knowledge sync ran with no new durable branch updates."
+fi
+
+if [ -n "$DECISION_TITLE" ]; then
+    if [ -z "$DECISION_SLUG" ]; then
+        DECISION_SLUG="$(kc_slugify "$DECISION_TITLE")"
+    fi
+    render_decision_note "$DECISION_TITLE" "$DECISION_WHY" "$DECISION_SLUG"
+else
+    WARNINGS+=("No decision note update requested.")
+fi
+
+import_args=(--project "$TARGET_PROJECT")
+if [ "$DRY_RUN" -eq 1 ]; then
+    import_args+=(--dry-run)
+fi
+kc_run_child_script "$SCRIPT_DIR/import-agent-history.sh" "${import_args[@]}"
+
+if [ "$RUN_COMPACTION" -eq 1 ]; then
+    compact_args=(--project "$TARGET_PROJECT")
+    if [ "$DRY_RUN" -eq 1 ]; then
+        compact_args+=(--dry-run)
+    fi
+    kc_run_child_script "$SCRIPT_DIR/compact-memory.sh" "${compact_args[@]}"
+fi
+
+kc_status_load
+if [ "${DRY_RUN:-0}" -eq 0 ]; then
+    STATUS_LAST_PROJECT_SYNC="$(kc_now_utc)"
+fi
+STATUS_WARNING_LINES="$(printf '%s\n' "${WARNINGS[@]+"${WARNINGS[@]}"}")"
+kc_status_write "$STATUS_WARNING_LINES"
+
+json_summary="{"
+json_summary="$json_summary\"script\":\"update-knowledge\","
+json_summary="$json_summary\"project_root\":\"$(kc_json_escape "$TARGET_PROJECT")\","
+json_summary="$json_summary\"dry_run\":$(kc_json_bool "$DRY_RUN"),"
+json_summary="$json_summary\"changed_files\":$(kc_json_array_from_lines "$changed_files"),"
+json_summary="$json_summary\"affected_areas\":$(kc_json_array_from_lines "$affected_areas"),"
+json_summary="$json_summary\"updated_notes\":$(kc_json_array "${UPDATED_NOTES[@]+"${UPDATED_NOTES[@]}"}"),"
+json_summary="$json_summary\"skipped\":$(kc_json_array "${SKIPPED[@]+"${SKIPPED[@]}"}"),"
+json_summary="$json_summary\"warnings\":$(kc_json_array "${WARNINGS[@]+"${WARNINGS[@]}"}")"
+json_summary="$json_summary}"
+kc_write_json_output "$json_summary"
+
+if [ "$JSON_MODE" -ne 1 ]; then
+    kc_log "Knowledge sync: $TARGET_PROJECT"
+    if [ -n "$changed_files" ]; then
+        kc_log "Changed files:"
+        while IFS= read -r path; do
+            [ -n "$path" ] || continue
+            kc_log "  $path"
+        done <<EOF
+$changed_files
+EOF
+    fi
+
+    kc_log ""
+    if [ ${#UPDATED_NOTES[@]} -gt 0 ]; then
+        kc_log "Updated memory notes:"
+        printf '  %s\n' "${UPDATED_NOTES[@]+"${UPDATED_NOTES[@]}"}"
+    else
+        kc_log "No durable memory note changes were required."
+    fi
+
+    if [ ${#SKIPPED[@]} -gt 0 ]; then
+        kc_log ""
+        kc_log "Skipped:"
+        printf '  %s\n' "${SKIPPED[@]+"${SKIPPED[@]}"}"
+    fi
+fi